Merge branch 'vkuttyp:main' into TestOptimisation

Author: FoxClock

.github/workflows/swift.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    name: Build & Test
+    runs-on: macos-14        # Apple Silicon runner, Xcode 15+
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode_15.4.app
+
+      - name: Install FreeTDS
+        run: brew install freetds
+
+      - name: Build
+        run: swift build -v
+
+      - name: Test
+        run: swift test -v
+        env:
+          # Integration tests are skipped automatically when these are not set.
+          # To run them, add HOST / USERNAME / PASSWORD / DATABASE as
+          # GitHub Actions secrets (Settings → Secrets → Actions).
+          HOST:     ${{ secrets.DB_HOST }}
+          USERNAME: ${{ secrets.DB_USERNAME }}
+          PASSWORD: ${{ secrets.DB_PASSWORD }}
+          DATABASE: ${{ secrets.DB_DATABASE }}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Veeran Kutty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Sources/SQLClientSwift/SQLRowDecoder.swift

@@ -149,8 +149,13 @@ private struct SQLRowKeyedContainer<Key: CodingKey>: KeyedDecodingContainerProto
     }
 
     private func cast<T>(_ key: Key) throws -> T {
+        // Validate key is in columns
         let value = try requireValue(for: key)
+
+        // Direct cast as type 
         if let v = value as? T { return v }
+        
+        // If type is NSNumber supported
         if let n = value as? NSNumber {
             switch T.self {
             case is Bool.Type:   return (n.boolValue)   as! T
@@ -169,14 +174,40 @@ private struct SQLRowKeyedContainer<Key: CodingKey>: KeyedDecodingContainerProto
             default: break
             }
         }
+       // String → primitive conversions.
         if let s = value as? String {
             switch T.self {
-            case is Int.Type:    if let i = Int(s)    { return i as! T }
-            case is Double.Type: if let d = Double(s) { return d as! T }
-            case is Bool.Type:   return (["true","1","yes"].contains(s.lowercased())) as! T
+            case is Int.Type:
+                guard let i = Int(s) else {
+                    throw DecodingError.typeMismatch(T.self, .init(
+                        codingPath: codingPath + [key],
+                        debugDescription: "Cannot convert '\(s)' to Int for column '\(key.stringValue)'."))
+                }
+                return i as! T
+
+            case is Double.Type:
+                guard let d = Double(s) else {
+                    throw DecodingError.typeMismatch(T.self, .init(
+                        codingPath: codingPath + [key],
+                        debugDescription: "Cannot convert '\(s)' to Double for column '\(key.stringValue)'."))
+                }
+                return d as! T
+
+            case is Bool.Type:
+                switch s.lowercased() {
+                case "true",  "1", "yes": return true  as! T
+                case "false", "0", "no":  return false as! T
+                default:
+                    throw DecodingError.typeMismatch(T.self, .init(
+                        codingPath: codingPath + [key],
+                        debugDescription: "Cannot convert '\(s)' to Bool for column '\(key.stringValue)'. "
+                            + "Expected one of: true, false, 1, 0, yes, no."))
+                }
+
             default: break
             }
         }
+        // No Conversion path succeeded
         throw DecodingError.typeMismatch(T.self, .init(
             codingPath: codingPath + [key],
             debugDescription: "Expected \(T.self), got \(type(of: value)) for column '\(key.stringValue)'"))