artemkalinovsky
diff --git a/‎.github/workflows/swift.yml‎
Lines changed: 1 addition & 1 deletion b/‎.github/workflows/swift.yml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎README.md‎
Lines changed: 115 additions & 4 deletions b/‎README.md‎
Lines changed: 115 additions & 4 deletions
diff --git a/‎Sources/Kite/APIClient.swift‎
Lines changed: 17 additions & 9 deletions b/‎Sources/Kite/APIClient.swift‎
Lines changed: 17 additions & 9 deletions
diff --git a/‎Sources/Kite/Deserializers/DataTransformer.swift‎
Lines changed: 38 additions & 0 deletions b/‎Sources/Kite/Deserializers/DataTransformer.swift‎
Lines changed: 38 additions & 0 deletions
diff --git a/‎Sources/Kite/Deserializers/JSONDeserializer/JSONDeserializer.swift‎
Lines changed: 48 additions & 36 deletions b/‎Sources/Kite/Deserializers/JSONDeserializer/JSONDeserializer.swift‎
Lines changed: 48 additions & 36 deletions
diff --git a/‎Sources/Kite/Deserializers/ResponseDataDeserializer.swift‎
Lines changed: 35 additions & 0 deletions b/‎Sources/Kite/Deserializers/ResponseDataDeserializer.swift‎
Lines changed: 35 additions & 0 deletions
diff --git a/‎Sources/Kite/Deserializers/ResponseDeserializer.swift‎
Lines changed: 0 additions & 26 deletions b/‎Sources/Kite/Deserializers/ResponseDeserializer.swift‎
Lines changed: 0 additions & 26 deletions
@@ -14,7 +14,7 @@ jobs:
         with:
           xcode-version: latest-stable
 
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Build
         run: swift build -v
 
@@ -1,10 +1,121 @@
 ![swift workflow](https://github.com/artemkalinovsky/Kite/actions/workflows/swift.yml/badge.svg) 
 
-🚧 WIP 🚧
-I'm still fine-tuning the code—hang tight! 🔧⚙️
-More updates coming soon! 🚀
+# Kite 
 
-## Apps using 📱
+Kite is named after the kite bird, known for its lightness, speed, and agile flight. This Swift Package aims to embody those qualities—offering a lightweight, fast, and flexible networking layer that soars across Apple platforms.
+
+### Features:
+
+* ***Swift Concurrency (async/await)***: Easily manage asynchronous networking operations.
+* Lightweight API Client: A simple APIClient class lets you execute requests that conform to HTTPRequestProtocol or DeserializeableRequest.
+* JSON & XML Deserialization: Built-in JSONDeserializer and XMLDeserializer types for decoding server responses.
+
+## Project Status
+
+This project is considered production-ready. Contributions—whether pull requests, questions, or suggestions—are always welcome! 😃
+
+## Installation 📦 
+
+* #### Swift Package Manager
+
+You can use Xcode SPM GUI: *File -> Swift Packages -> Add Package Dependency -> Pick "Up to Next Major Version 3.0.0"*.
+
+Or add the following to your `Package.swift` file:
+
+``` swift
+.package(url: "https://github.com/artemkalinovsky/Kite.git", from: "3.0.0")
+
+```
+
+and then specify `"Kite"` as a dependency of the Target in which you wish to use Legatus.
+Here's an example `PackageDescription` :
+
+``` swift
+// swift-tools-version:6.0
+import PackageDescription
+
+let package = Package(
+    name: "MyPackage",
+    products: [
+        .library(
+            name: "MyPackage",
+            targets: ["MyPackage"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/artemkalinovsky/Kite.git", from: "3.0.0")
+    ],
+    targets: [
+        .target(
+            name: "MyPackage",
+            dependencies: ["Kite"])
+    ]
+)
+```
+## Usage 🧑‍💻
+
+Let's suppose we want to fetch list of users from JSON and response is look like this:
+
+``` json
+{ 
+   "results":[ 
+      { 
+         "name":{ 
+            "first":"brad",
+            "last":"gibson"
+         },
+         "email":"brad.gibson@example.com"
+      }
+   ]
+}
+```
+
+* #### Setup
+
+1. Create `APIClient` :
+
+``` swift
+    let apiClient = APIClient()
+```
+
+2. Create response model:
+
+``` swift
+struct User: Decodable {
+    struct Name: Decodable {
+        let first: String
+        let last: String
+    }
+    
+    let name: Name
+    let email: String
+}
+```
+
+3. Create request with endpoint path and desired reponse deserializer:
+
+``` swift
+import Foundation
+import Kite
+
+struct FetchRandomUsersRequest: DeserializeableRequest {
+    var baseURL: URL { URL(string: "https://randomuser.me")! }
+    var path: String {"api"}
+
+    var deserializer: ResponseDeserializer<[User]> {
+        JSONDeserializer<User>.collectionDeserializer(keyPath: "results")
+    }
+}
+```
+
+* #### Perfrom created request
+
+``` swift
+   let users = try await apiClient.execute(request: FetchRandomUsersRequest())
+```
+
+Voilà!🧑‍🎨
+
+## Apps using Kite
 
 - [PinPlace](https://apps.apple.com/ua/app/pinplace/id1571349149)
 
 
@@ -1,21 +1,21 @@
 import Foundation
 
-public final class APIClient {
-    private let urlSesion: URLSession
+public class APIClient {
+    private let urlSession: URLSession
 
-    public init(urlSesion: URLSession = URLSession.shared) {
-        self.urlSesion = urlSesion
+    public init(urlSession: URLSession = URLSession.shared) {
+        self.urlSession = urlSession
     }
 
-    public func execute<T>(request: HTTPRequestProtocol, deserializer: ResponseDeserializer<T>) async throws -> T {
-        guard let url = URL(string: request.fullPath ?? request.path) else {
+    public func execute<T>(request: HTTPRequestProtocol, deserializer: ResponseDataDeserializer<T> = VoidDeserializer()) async throws -> T {
+        guard let url = request.url else {
             throw URLError(.badURL)
         }
+
         var urlRequest = URLRequest(url: url)
         urlRequest.httpMethod = request.method.rawValue
 
-        let headers = try request.headers()
-        for (field, value) in headers {
+        for (field, value) in request.headers {
             urlRequest.setValue(value, forHTTPHeaderField: field)
         }
 
@@ -38,12 +38,20 @@ public final class APIClient {
             throw URLError(.unsupportedURL)
         }
 
-        let (data, _) = try await urlSesion.data(for: urlRequest)
+        let (data, _) = try await urlSession.data(for: urlRequest)
 
         return try await deserializer.deserialize(data: data)
     }
 
     public func execute<R: DeserializeableRequest>(request: R) async throws -> R.ResponseType {
         try await execute(request: request, deserializer: request.deserializer)
     }
+
+    public func execute<R: AuthRequestProtocol & DeserializeableRequest>(request: R) async throws -> R.ResponseType {
+        guard let authorizationHeader = request.headers["Authorization"], !authorizationHeader.isEmpty else {
+            throw URLError(.userAuthenticationRequired)
+        }
+
+        return try await execute(request: request, deserializer: request.deserializer)
+    }
 }
@@ -0,0 +1,38 @@
+//
+//  DataTransformer.swift
+//  Kite
+//
+//  Created by Artem Kalinovsky on 11.03.2025.
+//
+
+import Foundation
+
+public struct DataTransformer<O>: DataTransformerProtocol {
+    public let transform: (Data) throws -> O
+
+    public init(transform: @escaping (Data) throws -> O) {
+        self.transform = transform
+    }
+}
+
+extension DataTransformer where O == Void {
+    public init() {
+        self.transform = { _ in }
+    }
+
+    @available(*, unavailable, message: "Use the default initializer instead")
+    public init(transform: @escaping (Data) throws -> O) {
+        fatalError("This initializer is unavailable. Use the default initializer instead.")
+    }
+}
+
+extension DataTransformer where O == Data {
+    public init() {
+        self.transform = { $0 }
+    }
+
+    @available(*, unavailable, message: "Use the default initializer instead")
+    public init(transform: @escaping (Data) throws -> O) {
+        fatalError("This initializer is unavailable. Use the default initializer instead.")
+    }
+}
@@ -4,52 +4,64 @@ public enum JSONDeserializerError: Error {
     case jsonDeserializableInitFailed(String)
 }
 
-open class JSONDeserializer<T>: ResponseDeserializer<T> {
+public class JSONDeserializer<T>: ResponseDataDeserializer<T> {
     public convenience init() {
-        self.init(transform: { data -> T in
-            let jsonObject = try JSONSerialization.jsonObject(with: data)
-            guard let object = jsonObject as? T else {
-                throw JSONDeserializerError.jsonDeserializableInitFailed(
-                    "Wrong result type: \(type(of: jsonObject)). Expected \(T.self)"
-                )
-            }
-            return object
-        })
+        self.init(
+            transformer: DataTransformer(
+                transform: { data -> T in
+                    let jsonObject = try JSONSerialization.jsonObject(with: data)
+                    guard let object = jsonObject as? T else {
+                        throw JSONDeserializerError.jsonDeserializableInitFailed(
+                            "Wrong result type: \(type(of: jsonObject)). Expected \(T.self)"
+                        )
+                    }
+                    return object
+                }
+            )
+        )
     }
 }
 
 extension JSONDeserializer where T: Decodable {
     public class func singleObjectDeserializer(keyPath path: String...) -> JSONDeserializer<T> {
-        return JSONDeserializer<T>(transform: { data in
-            let jsonDecoder = JSONDecoder()
-            do {
-                if path.isEmpty {
-                    return try jsonDecoder.decode(T.self, from: data)
-                } else {
-                    return try jsonDecoder.decode(T.self, from: data, keyPath: path.joined(separator: "."))
+        JSONDeserializer<T>(
+            transformer: DataTransformer(
+                transform: { data in
+                    let jsonDecoder = JSONDecoder()
+                    do {
+                        if path.isEmpty {
+                            return try jsonDecoder.decode(T.self, from: data)
+                        } else {
+                            return try jsonDecoder.decode(T.self, from: data, keyPath: path.joined(separator: "."))
+                        }
+                    } catch {
+                        throw JSONDeserializerError.jsonDeserializableInitFailed(
+                            "Failed to create \(T.self) object from path \(path)."
+                        )
+                    }
                 }
-            } catch {
-                throw JSONDeserializerError.jsonDeserializableInitFailed(
-                    "Failed to create \(T.self) object from path \(path)."
-                )
-            }
-        })
+            )
+        )
     }
 
     public class func collectionDeserializer(keyPath path: String...) -> JSONDeserializer<[T]> {
-        return JSONDeserializer<[T]>(transform: { data in
-            let jsonDecoder = JSONDecoder()
-            do {
-                if path.isEmpty {
-                    return try jsonDecoder.decode([T].self, from: data)
-                } else {
-                    return try jsonDecoder.decode([T].self, from: data, keyPath: path.joined(separator: "."))
+        JSONDeserializer<[T]>(
+            transformer: DataTransformer(
+                transform: { data in
+                    let jsonDecoder = JSONDecoder()
+                    do {
+                        if path.isEmpty {
+                            return try jsonDecoder.decode([T].self, from: data)
+                        } else {
+                            return try jsonDecoder.decode([T].self, from: data, keyPath: path.joined(separator: "."))
+                        }
+                    } catch {
+                        throw JSONDeserializerError.jsonDeserializableInitFailed(
+                            "Failed to create array of \(T.self) objects."
+                        )
+                    }
                 }
-            } catch {
-                throw JSONDeserializerError.jsonDeserializableInitFailed(
-                    "Failed to create array of \(T.self) objects."
-                )
-            }
-        })
+            )
+        )
     }
 }
@@ -0,0 +1,35 @@
+import Foundation
+
+public class ResponseDataDeserializer<T> {
+    private let transformer: DataTransformer<T>
+
+    public init(transformer: DataTransformer<T>) {
+        self.transformer = transformer
+    }
+
+    public func deserialize(data: Data) async throws -> T {
+        return try transformer.transform(data)
+    }
+}
+
+public class VoidDeserializer: ResponseDataDeserializer<Void> {
+    public init() {
+        super.init(transformer: DataTransformer())
+    }
+
+    @available(*, unavailable, message: "Use the default initializer instead")
+    override public init(transformer: DataTransformer<Void> = .init()) {
+        fatalError("This initializer is unavailable. Use the default initializer instead.")
+    }
+}
+
+public class RawDataDeserializer: ResponseDataDeserializer<Data> {
+    public init() {
+        super.init(transformer: DataTransformer())
+    }
+
+    @available(*, unavailable, message: "Use the default initializer instead")
+    override public init(transformer: DataTransformer<Data> = .init()) {
+        fatalError("This initializer is unavailable. Use the default initializer instead.")
+    }
+}