feat: 1.6.x

Author: TorstenDittmann

README.md

@@ -2,12 +2,12 @@
 
 ![Swift Package Manager](https://img.shields.io/github/v/release/appwrite/sdk-for-swift.svg?color=green&style=flat-square)
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-swift.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.5.6-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.5.7-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version 1.5.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-swift/releases).**
+**This SDK is compatible with Appwrite server version 1.6.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-swift/releases).**
 
  > This is the Swift SDK for integrating with Appwrite from your Swift server-side code. If you're looking for the Apple SDK you should check [appwrite/sdk-for-apple](https://github.com/appwrite/sdk-for-apple)
 

Sources/Appwrite/Client.swift

@@ -386,6 +386,12 @@ open class Client {
             timeout: .seconds(30)
         )
 
+        if let warning = response.headers["x-appwrite-warning"].first {
+            warning.split(separator: ";").forEach { warning in
+                print("Warning: \(warning)")
+            }
+        }
+
         switch response.status.code {
         case 0..<400:
             switch T.self {

Sources/Appwrite/Services/Account.swift

@@ -290,7 +290,7 @@ open class Account: Service {
     ///
     open func createJWT(
     ) async throws -> AppwriteModels.Jwt {
-        let apiPath: String = "/account/jwt"
+        let apiPath: String = "/account/jwts"
 
         let apiParams: [String: Any] = [:]
 
@@ -443,7 +443,7 @@ open class Account: Service {
     ///
     /// Verify an authenticator app after adding it using the [add
     /// authenticator](/docs/references/cloud/client-web/account#createMfaAuthenticator)
-    /// method. add 
+    /// method.
     ///
     /// @param AppwriteEnums.AuthenticatorType type
     /// @param String otp
@@ -484,7 +484,7 @@ open class Account: Service {
     ///
     /// Verify an authenticator app after adding it using the [add
     /// authenticator](/docs/references/cloud/client-web/account#createMfaAuthenticator)
-    /// method. add 
+    /// method.
     ///
     /// @param AppwriteEnums.AuthenticatorType type
     /// @param String otp

Sources/Appwrite/Services/Functions.swift

@@ -66,6 +66,7 @@ open class Functions: Service {
     /// @param Bool logging
     /// @param String entrypoint
     /// @param String commands
+    /// @param [String] scopes
     /// @param String installationId
     /// @param String providerRepositoryId
     /// @param String providerBranch
@@ -90,6 +91,7 @@ open class Functions: Service {
         logging: Bool? = nil,
         entrypoint: String? = nil,
         commands: String? = nil,
+        scopes: [String]? = nil,
         installationId: String? = nil,
         providerRepositoryId: String? = nil,
         providerBranch: String? = nil,
@@ -114,6 +116,7 @@ open class Functions: Service {
             "logging": logging,
             "entrypoint": entrypoint,
             "commands": commands,
+            "scopes": scopes,
             "installationId": installationId,
             "providerRepositoryId": providerRepositoryId,
             "providerBranch": providerBranch,
@@ -223,6 +226,7 @@ open class Functions: Service {
     /// @param Bool logging
     /// @param String entrypoint
     /// @param String commands
+    /// @param [String] scopes
     /// @param String installationId
     /// @param String providerRepositoryId
     /// @param String providerBranch
@@ -243,6 +247,7 @@ open class Functions: Service {
         logging: Bool? = nil,
         entrypoint: String? = nil,
         commands: String? = nil,
+        scopes: [String]? = nil,
         installationId: String? = nil,
         providerRepositoryId: String? = nil,
         providerBranch: String? = nil,
@@ -263,6 +268,7 @@ open class Functions: Service {
             "logging": logging,
             "entrypoint": entrypoint,
             "commands": commands,
+            "scopes": scopes,
             "installationId": installationId,
             "providerRepositoryId": providerRepositoryId,
             "providerBranch": providerBranch,
@@ -526,10 +532,7 @@ open class Functions: Service {
     }
 
     ///
-    /// Create build
-    ///
-    /// Create a new build for an Appwrite Function deployment. This endpoint can
-    /// be used to retry a failed build.
+    /// Rebuild deployment
     ///
     /// @param String functionId
     /// @param String deploymentId
@@ -540,14 +543,15 @@ open class Functions: Service {
     open func createBuild(
         functionId: String,
         deploymentId: String,
-        buildId: String
+        buildId: String? = nil
     ) async throws -> Any {
-        let apiPath: String = "/functions/{functionId}/deployments/{deploymentId}/builds/{buildId}"
+        let apiPath: String = "/functions/{functionId}/deployments/{deploymentId}/build"
             .replacingOccurrences(of: "{functionId}", with: functionId)
             .replacingOccurrences(of: "{deploymentId}", with: deploymentId)
-            .replacingOccurrences(of: "{buildId}", with: buildId)
 
-        let apiParams: [String: Any] = [:]
+        let apiParams: [String: Any?] = [
+            "buildId": buildId
+        ]
 
         let apiHeaders: [String: String] = [
             "content-type": "application/json"
@@ -560,6 +564,41 @@ open class Functions: Service {
             params: apiParams        )
     }
 
+    ///
+    /// Cancel deployment
+    ///
+    /// @param String functionId
+    /// @param String deploymentId
+    /// @throws Exception
+    /// @return array
+    ///
+    open func updateDeploymentBuild(
+        functionId: String,
+        deploymentId: String
+    ) async throws -> AppwriteModels.Build {
+        let apiPath: String = "/functions/{functionId}/deployments/{deploymentId}/build"
+            .replacingOccurrences(of: "{functionId}", with: functionId)
+            .replacingOccurrences(of: "{deploymentId}", with: deploymentId)
+
+        let apiParams: [String: Any] = [:]
+
+        let apiHeaders: [String: String] = [
+            "content-type": "application/json"
+        ]
+
+        let converter: (Any) -> AppwriteModels.Build = { response in
+            return AppwriteModels.Build.from(map: response as! [String: Any])
+        }
+
+        return try await client.call(
+            method: "PATCH",
+            path: apiPath,
+            headers: apiHeaders,
+            params: apiParams,
+            converter: converter
+        )
+    }
+
     ///
     /// Download Deployment
     ///
@@ -648,6 +687,7 @@ open class Functions: Service {
     /// @param String path
     /// @param AppwriteEnums.ExecutionMethod method
     /// @param Any headers
+    /// @param String scheduledAt
     /// @throws Exception
     /// @return array
     ///
@@ -657,7 +697,8 @@ open class Functions: Service {
         async: Bool? = nil,
         path: String? = nil,
         method: AppwriteEnums.ExecutionMethod? = nil,
-        headers: Any? = nil
+        headers: Any? = nil,
+        scheduledAt: String? = nil
     ) async throws -> AppwriteModels.Execution {
         let apiPath: String = "/functions/{functionId}/executions"
             .replacingOccurrences(of: "{functionId}", with: functionId)
@@ -667,7 +708,8 @@ open class Functions: Service {
             "async": async,
             "path": path,
             "method": method,
-            "headers": headers
+            "headers": headers,
+            "scheduledAt": scheduledAt
         ]
 
         let apiHeaders: [String: String] = [
@@ -724,6 +766,38 @@ open class Functions: Service {
         )
     }
 
+    ///
+    /// Delete execution
+    ///
+    /// Delete a function execution by its unique ID.
+    /// 
+    ///
+    /// @param String functionId
+    /// @param String executionId
+    /// @throws Exception
+    /// @return array
+    ///
+    open func deleteExecution(
+        functionId: String,
+        executionId: String
+    ) async throws -> Any {
+        let apiPath: String = "/functions/{functionId}/executions/{executionId}"
+            .replacingOccurrences(of: "{functionId}", with: functionId)
+            .replacingOccurrences(of: "{executionId}", with: executionId)
+
+        let apiParams: [String: Any] = [:]
+
+        let apiHeaders: [String: String] = [
+            "content-type": "application/json"
+        ]
+
+        return try await client.call(
+            method: "DELETE",
+            path: apiPath,
+            headers: apiHeaders,
+            params: apiParams        )
+    }
+
     ///
     /// List variables
     ///

Sources/Appwrite/Services/Users.swift

@@ -962,6 +962,49 @@ open class Users: Service {
         )
     }
 
+    ///
+    /// Create user JWT
+    ///
+    /// Use this endpoint to create a JSON Web Token for user by its unique ID. You
+    /// can use the resulting JWT to authenticate on behalf of the user. The JWT
+    /// secret will become invalid if the session it uses gets deleted.
+    ///
+    /// @param String userId
+    /// @param String sessionId
+    /// @param Int duration
+    /// @throws Exception
+    /// @return array
+    ///
+    open func createJWT(
+        userId: String,
+        sessionId: String? = nil,
+        duration: Int? = nil
+    ) async throws -> AppwriteModels.Jwt {
+        let apiPath: String = "/users/{userId}/jwts"
+            .replacingOccurrences(of: "{userId}", with: userId)
+
+        let apiParams: [String: Any?] = [
+            "sessionId": sessionId,
+            "duration": duration
+        ]
+
+        let apiHeaders: [String: String] = [
+            "content-type": "application/json"
+        ]
+
+        let converter: (Any) -> AppwriteModels.Jwt = { response in
+            return AppwriteModels.Jwt.from(map: response as! [String: Any])
+        }
+
+        return try await client.call(
+            method: "POST",
+            path: apiPath,
+            headers: apiHeaders,
+            params: apiParams,
+            converter: converter
+        )
+    }
+
     ///
     /// Update user labels
     ///

Sources/AppwriteEnums/Name.swift

@@ -8,7 +8,7 @@ public enum Name: String, Codable {
     case v1Functions = "v1-functions"
     case v1Usage = "v1-usage"
     case v1UsageDump = "v1-usage-dump"
-    case webhooksv1 = "webhooksv1"
+    case v1Webhooks = "v1-webhooks"
     case v1Certificates = "v1-certificates"
     case v1Builds = "v1-builds"
     case v1Messaging = "v1-messaging"

Sources/AppwriteEnums/Runtime.swift

@@ -46,6 +46,7 @@ public enum Runtime: String, Codable {
     case cpp17 = "cpp-17"
     case cpp20 = "cpp-20"
     case bun10 = "bun-1.0"
+    case go122 = "go-1.22"
 
     public func encode(to encoder: Encoder) throws {
         var container = encoder.singleValueContainer()

Sources/AppwriteModels/Build.swift

@@ -0,0 +1,84 @@
+import Foundation
+import JSONCodable
+
+/// Build
+public class Build {
+
+    /// Build ID.
+    public let id: String
+
+    /// The deployment that created this build.
+    public let deploymentId: String
+
+    /// The build status. There are a few different types and each one means something different. \nFailed - The deployment build has failed. More details can usually be found in buildStderr\nReady - The deployment build was successful and the deployment is ready to be deployed\nProcessing - The deployment is currently waiting to have a build triggered\nBuilding - The deployment is currently being built
+    public let status: String
+
+    /// The stdout of the build.
+    public let stdout: String
+
+    /// The stderr of the build.
+    public let stderr: String
+
+    /// The deployment creation date in ISO 8601 format.
+    public let startTime: String
+
+    /// The time the build was finished in ISO 8601 format.
+    public let endTime: String
+
+    /// The build duration in seconds.
+    public let duration: Int
+
+    /// The code size in bytes.
+    public let size: Int
+
+
+    init(
+        id: String,
+        deploymentId: String,
+        status: String,
+        stdout: String,
+        stderr: String,
+        startTime: String,
+        endTime: String,
+        duration: Int,
+        size: Int
+    ) {
+        self.id = id
+        self.deploymentId = deploymentId
+        self.status = status
+        self.stdout = stdout
+        self.stderr = stderr
+        self.startTime = startTime
+        self.endTime = endTime
+        self.duration = duration
+        self.size = size
+    }
+
+    public func toMap() -> [String: Any] {
+        return [
+            "$id": id as Any,
+            "deploymentId": deploymentId as Any,
+            "status": status as Any,
+            "stdout": stdout as Any,
+            "stderr": stderr as Any,
+            "startTime": startTime as Any,
+            "endTime": endTime as Any,
+            "duration": duration as Any,
+            "size": size as Any
+        ]
+    }
+
+    public static func from(map: [String: Any] ) -> Build {
+        return Build(
+            id: map["$id"] as! String,
+            deploymentId: map["deploymentId"] as! String,
+            status: map["status"] as! String,
+            stdout: map["stdout"] as! String,
+            stderr: map["stderr"] as! String,
+            startTime: map["startTime"] as! String,
+            endTime: map["endTime"] as! String,
+            duration: map["duration"] as! Int,
+            size: map["size"] as! Int
+        )
+    }
+}