Merge pull request #68 from appwrite/dev

fix: pong response & chunked upload

Author: abnegate

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Appwrite (https://appwrite.io) and individual contributors.
+Copyright (c) 2025 Appwrite (https://appwrite.io) and individual contributors.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

README.md

@@ -2,7 +2,7 @@
 
 ![Swift Package Manager](https://img.shields.io/github/v/release/appwrite/sdk-for-apple.svg?color=green&style=flat-square)
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-apple.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.6.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.6.1-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)
@@ -31,7 +31,7 @@ Add the package to your `Package.swift` dependencies:
 
 ```swift
     dependencies: [
-        .package(url: "[email protected]:appwrite/sdk-for-apple.git", from: "7.1.0"),
+        .package(url: "[email protected]:appwrite/sdk-for-apple.git", from: "8.0.0"),
     ],
 ```
 

Sources/Appwrite/Client.swift

@@ -23,7 +23,7 @@ open class Client {
         "x-sdk-name": "Apple",
         "x-sdk-platform": "client",
         "x-sdk-language": "apple",
-        "x-sdk-version": "7.1.0",
+        "x-sdk-version": "8.0.0",
         "x-appwrite-response-format": "1.6.0"
     ]
 
@@ -249,6 +249,26 @@ open class Client {
        ) ?? ""
    }
 
+    ///
+    /// Sends a "ping" request to Appwrite to verify connectivity.
+    ///
+    /// @return String
+    /// @throws Exception
+    ///
+   open func ping() async throws -> String {
+       let apiPath: String = "/ping"
+
+       let apiHeaders: [String: String] = [
+           "content-type": "application/json"
+       ]
+
+       return try await call(
+           method: "GET",
+           path: apiPath,
+           headers: apiHeaders
+       )
+    }
+
     ///
     /// Make an API call
     ///
@@ -319,6 +339,8 @@ open class Client {
             }
         }
 
+        var data = try await response.body.collect(upTo: Int.max)
+
         switch response.status.code {
         case 0..<400:
             if response.headers["Set-Cookie"].count > 0 {
@@ -331,10 +353,11 @@ open class Client {
             switch T.self {
             case is Bool.Type:
                 return true as! T
+            case is String.Type:
+                return (data.readString(length: data.readableBytes) ?? "") as! T
             case is ByteBuffer.Type:
-                return try await response.body.collect(upTo: Int.max) as! T
+                return data as! T
             default:
-                let data = try await response.body.collect(upTo: Int.max)
                 if data.readableBytes == 0 {
                     return true as! T
                 }
@@ -344,7 +367,6 @@ open class Client {
             }
         default:
             var message = ""
-            var data = try await response.body.collect(upTo: Int.max)
             var type = ""
 
             do {
@@ -400,7 +422,7 @@ open class Client {
         var offset = 0
         var result = [String:Any]()
 
-        if idParamName != nil && params[idParamName!] as! String != "unique()" {
+        if idParamName != nil {
             // Make a request to check if a file already exists
             do {
                 let map = try await call(

Sources/Appwrite/Services/Account.swift

@@ -584,7 +584,7 @@ open class Account: Service {
     open func updateMfaChallenge(
         challengeId: String,
         otp: String
-    ) async throws -> Any {
+    ) async throws -> AppwriteModels.Session {
         let apiPath: String = "/account/mfa/challenge"
 
         let apiParams: [String: Any?] = [
@@ -596,11 +596,17 @@ open class Account: Service {
             "content-type": "application/json"
         ]
 
+        let converter: (Any) -> AppwriteModels.Session = { response in
+            return AppwriteModels.Session.from(map: response as! [String: Any])
+        }
+
         return try await client.call(
             method: "PUT",
             path: apiPath,
             headers: apiHeaders,
-            params: apiParams        )
+            params: apiParams,
+            converter: converter
+        )
     }
 
     ///
@@ -1599,6 +1605,12 @@ open class Account: Service {
     ///
     /// Create push target
     ///
+    /// Use this endpoint to register a device for push notifications. Provide a
+    /// target ID (custom or generated using ID.unique()), a device identifier
+    /// (usually a device token), and optionally specify which provider should send
+    /// notifications to this target. The target is automatically linked to the
+    /// current session and includes device information like brand and model.
+    ///
     /// @param String targetId
     /// @param String identifier
     /// @param String providerId
@@ -1638,6 +1650,12 @@ open class Account: Service {
     ///
     /// Update push target
     ///
+    /// Update the currently logged in user's push notification target. You can
+    /// modify the target's identifier (device token) and provider ID (token,
+    /// email, phone etc.). The target must exist and belong to the current user.
+    /// If you change the provider ID, notifications will be sent through the new
+    /// messaging provider instead.
+    ///
     /// @param String targetId
     /// @param String identifier
     /// @throws Exception
@@ -1674,6 +1692,10 @@ open class Account: Service {
     ///
     /// Delete push target
     ///
+    /// Delete a push notification target for the currently logged in user. After
+    /// deletion, the device will no longer receive push notifications. The target
+    /// must exist and belong to the current user.
+    ///
     /// @param String targetId
     /// @throws Exception
     /// @return array
@@ -1758,9 +1780,7 @@ open class Account: Service {
     /// [POST
     /// /v1/account/sessions/token](https://appwrite.io/docs/references/cloud/client-web/account#createSession)
     /// endpoint to complete the login process. The link sent to the user's email
-    /// address is valid for 1 hour. If you are on a mobile device you can leave
-    /// the URL parameter empty, so that the login completion will be handled by
-    /// your Appwrite instance by default.
+    /// address is valid for 1 hour.
     /// 
     /// A user is limited to 10 active sessions at a time by default. [Learn more
     /// about session

Sources/AppwriteEnums/ImageFormat.swift

@@ -6,6 +6,7 @@ public enum ImageFormat: String, CustomStringConvertible {
     case gif = "gif"
     case png = "png"
     case webp = "webp"
+    case heic = "heic"
     case avif = "avif"
 
     public var description: String {

docs/examples/account/update-mfa-challenge.md

@@ -6,7 +6,7 @@ let client = Client()
 
 let account = Account(client)
 
-let result = try await account.updateMfaChallenge(
+let session = try await account.updateMfaChallenge(
     challengeId: "<CHALLENGE_ID>",
     otp: "<OTP>"
 )