feat: support for 0.14.x

Author: TorstenDittmann

README.md

@@ -2,12 +2,12 @@
 
 ![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-0.13.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-0.14.0-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 0.13.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-apple/releases).**
+**This SDK is compatible with Appwrite server version 0.14.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-apple/releases).**
 
 Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Apple SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 
@@ -31,7 +31,7 @@ Add the package to your `Package.swift` dependencies:
 
 ```swift
     dependencies: [
-        .package(url: "[email protected]:appwrite/sdk-for-apple.git", from: "0.4.0"),
+        .package(url: "[email protected]:appwrite/sdk-for-apple.git", from: "0.5.0"),
     ],
 ```
 
@@ -42,9 +42,7 @@ Then add it to your target:
         .target(
             name: "YourAppTarget",
             dependencies: [
-                .product(name: "
-Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated in /home/dlohani/Documents/projects/appwrite/appwrite_src/vendor/appwrite/sdk-generator/src/SDK/SDK.php on line 746
-", package: "sdk-for-apple")
+                .product(name: "", package: "sdk-for-apple")
             ]
         ),
 ```

Sources/Appwrite/Client.swift

@@ -20,7 +20,7 @@ open class Client {
 
     open var headers: [String: String] = [
         "content-type": "",
-        "x-sdk-version": "appwrite:swiftclient:0.4.0",
+        "x-sdk-version": "appwrite:swiftclient:0.5.0",
         "X-Appwrite-Response-Format": "0.13.0"
     ]
 

Sources/Appwrite/Services/Account.swift

@@ -76,32 +76,6 @@ open class Account: Service {
         )
     }
 
-    ///
-    /// Delete Account
-    ///
-    /// Delete a currently logged in user account. Behind the scene, the user
-    /// record is not deleted but permanently blocked from any access. This is done
-    /// to avoid deleted accounts being overtaken by new users with the same email
-    /// address. Any user-related resources like documents or storage files should
-    /// be deleted separately.
-    ///
-    /// @throws Exception
-    /// @return array
-    ///
-    open func delete(
-    ) async throws -> Any {
-        let path: String = "/account"
-        let params: [String: Any?] = [:]
-        let headers: [String: String] = [
-            "content-type": "application/json"
-        ]
-        return try await client.call(
-            method: "DELETE",
-            path: path,
-            headers: headers,
-            params: params        )
-    }
-
     ///
     /// Update Account Email
     ///
@@ -245,7 +219,7 @@ open class Account: Service {
     ///
     /// Update currently logged in user password. For validation, user is required
     /// to pass in the new password, and the old password. For users created with
-    /// OAuth and Team Invites, oldPassword is optional.
+    /// OAuth, Team Invites and Magic URL, oldPassword is optional.
     ///
     /// @param String password
     /// @param String oldPassword
@@ -725,6 +699,10 @@ open class Account: Service {
     ///
     /// Update Session (Refresh Tokens)
     ///
+    /// Access tokens have limited lifespan and expire to mitigate security risks.
+    /// If session was created using an OAuth provider, this route can be used to
+    /// "refresh" the access token.
+    ///
     /// @param String sessionId
     /// @throws Exception
     /// @return array
@@ -784,6 +762,35 @@ open class Account: Service {
             params: params        )
     }
 
+    ///
+    /// Update Account Status
+    ///
+    /// Block the currently logged in user account. Behind the scene, the user
+    /// record is not deleted but permanently blocked from any access. To
+    /// completely delete a user, use the Users API instead.
+    ///
+    /// @throws Exception
+    /// @return array
+    ///
+    open func updateStatus(
+    ) async throws -> AppwriteModels.User {
+        let path: String = "/account/status"
+        let params: [String: Any?] = [:]
+        let headers: [String: String] = [
+            "content-type": "application/json"
+        ]
+        let converter: ([String: Any]) -> AppwriteModels.User = { dict in
+            return AppwriteModels.User.from(map: dict)
+        }
+        return try await client.call(
+            method: "PATCH",
+            path: path,
+            headers: headers,
+            params: params,
+            converter: converter
+        )
+    }
+
     ///
     /// Create Email Verification
     ///
@@ -930,33 +937,6 @@ open class Account: Service {
         }
     }
 
-    ///
-    /// Delete Account
-    ///
-    /// Delete a currently logged in user account. Behind the scene, the user
-    /// record is not deleted but permanently blocked from any access. This is done
-    /// to avoid deleted accounts being overtaken by new users with the same email
-    /// address. Any user-related resources like documents or storage files should
-    /// be deleted separately.
-    ///
-    /// @throws Exception
-    /// @return array
-    ///
-    @available(*, deprecated, message: "Use the async overload instead")
-    open func delete(
-        completion: ((Result<Any, AppwriteError>) -> Void)? = nil
-    ) {
-        Task {
-            do {
-                let result = try await delete(
-                )
-                completion?(.success(result))
-            } catch {
-                completion?(.failure(error as! AppwriteError))
-            }
-        }
-    }
-
     ///
     /// Update Account Email
     ///
@@ -1081,7 +1061,7 @@ open class Account: Service {
     ///
     /// Update currently logged in user password. For validation, user is required
     /// to pass in the new password, and the old password. For users created with
-    /// OAuth and Team Invites, oldPassword is optional.
+    /// OAuth, Team Invites and Magic URL, oldPassword is optional.
     ///
     /// @param String password
     /// @param String oldPassword
@@ -1500,6 +1480,10 @@ open class Account: Service {
     ///
     /// Update Session (Refresh Tokens)
     ///
+    /// Access tokens have limited lifespan and expire to mitigate security risks.
+    /// If session was created using an OAuth provider, this route can be used to
+    /// "refresh" the access token.
+    ///
     /// @param String sessionId
     /// @throws Exception
     /// @return array
@@ -1550,6 +1534,31 @@ open class Account: Service {
         }
     }
 
+    ///
+    /// Update Account Status
+    ///
+    /// Block the currently logged in user account. Behind the scene, the user
+    /// record is not deleted but permanently blocked from any access. To
+    /// completely delete a user, use the Users API instead.
+    ///
+    /// @throws Exception
+    /// @return array
+    ///
+    @available(*, deprecated, message: "Use the async overload instead")
+    open func updateStatus(
+        completion: ((Result<AppwriteModels.User, AppwriteError>) -> Void)? = nil
+    ) {
+        Task {
+            do {
+                let result = try await updateStatus(
+                )
+                completion?(.success(result))
+            } catch {
+                completion?(.failure(error as! AppwriteError))
+            }
+        }
+    }
+
     ///
     /// Create Email Verification
     ///

Sources/Appwrite/Services/Avatars.swift

@@ -8,9 +8,14 @@ open class Avatars: Service {
     /// Get Browser Icon
     ///
     /// You can use this endpoint to show different browser icons to your users.
-    /// The code argument receives the browser code as it appears in your user
-    /// /account/sessions endpoint. Use width, height and quality arguments to
-    /// change the output settings.
+    /// The code argument receives the browser code as it appears in your user [GET
+    /// /account/sessions](/docs/client/account#accountGetSessions) endpoint. Use
+    /// width, height and quality arguments to change the output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
     ///
     /// @param String code
     /// @param Int width
@@ -49,6 +54,12 @@ open class Avatars: Service {
     /// The credit card endpoint will return you the icon of the credit card
     /// provider you need. Use width, height and quality arguments to change the
     /// output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String code
     /// @param Int width
@@ -113,6 +124,12 @@ open class Avatars: Service {
     /// You can use this endpoint to show different country flags icons to your
     /// users. The code argument receives the 2 letter country code. Use width,
     /// height and quality arguments to change the output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String code
     /// @param Int width
@@ -152,6 +169,12 @@ open class Avatars: Service {
     /// you want. This endpoint is very useful if you need to crop and display
     /// remote images in your app or in case you want to make sure a 3rd party
     /// image is properly served using a TLS protocol.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 400x400px.
+    /// 
     ///
     /// @param String url
     /// @param Int width
@@ -191,6 +214,12 @@ open class Avatars: Service {
     /// default, a random theme will be selected. The random theme will persist for
     /// the user's initials when reloading the same theme will always return for
     /// the same initials.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String name
     /// @param Int width
@@ -228,6 +257,7 @@ open class Avatars: Service {
     ///
     /// Converts a given plain text to a QR code image. You can use the query
     /// parameters to change the size and style of the resulting image.
+    /// 
     ///
     /// @param String text
     /// @param Int size
@@ -262,9 +292,14 @@ open class Avatars: Service {
     /// Get Browser Icon
     ///
     /// You can use this endpoint to show different browser icons to your users.
-    /// The code argument receives the browser code as it appears in your user
-    /// /account/sessions endpoint. Use width, height and quality arguments to
-    /// change the output settings.
+    /// The code argument receives the browser code as it appears in your user [GET
+    /// /account/sessions](/docs/client/account#accountGetSessions) endpoint. Use
+    /// width, height and quality arguments to change the output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
     ///
     /// @param String code
     /// @param Int width
@@ -302,6 +337,12 @@ open class Avatars: Service {
     /// The credit card endpoint will return you the icon of the credit card
     /// provider you need. Use width, height and quality arguments to change the
     /// output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String code
     /// @param Int width
@@ -367,6 +408,12 @@ open class Avatars: Service {
     /// You can use this endpoint to show different country flags icons to your
     /// users. The code argument receives the 2 letter country code. Use width,
     /// height and quality arguments to change the output settings.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String code
     /// @param Int width
@@ -405,6 +452,12 @@ open class Avatars: Service {
     /// you want. This endpoint is very useful if you need to crop and display
     /// remote images in your app or in case you want to make sure a 3rd party
     /// image is properly served using a TLS protocol.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 400x400px.
+    /// 
     ///
     /// @param String url
     /// @param Int width
@@ -446,6 +499,12 @@ open class Avatars: Service {
     /// default, a random theme will be selected. The random theme will persist for
     /// the user's initials when reloading the same theme will always return for
     /// the same initials.
+    /// 
+    /// When one dimension is specified and the other is 0, the image is scaled
+    /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+    /// image at source quality. If dimensions are not specified, the default size
+    /// of image returned is 100x100px.
+    /// 
     ///
     /// @param String name
     /// @param Int width
@@ -485,6 +544,7 @@ open class Avatars: Service {
     ///
     /// Converts a given plain text to a QR code image. You can use the query
     /// parameters to change the size and style of the resulting image.
+    /// 
     ///
     /// @param String text
     /// @param Int size

Sources/Appwrite/Services/Database.swift

@@ -204,9 +204,7 @@ open class Database: Service {
     ///
     /// Delete Document
     ///
-    /// Delete a document by its unique ID. This endpoint deletes only the parent
-    /// documents, its attributes and relations to other documents. Child documents
-    /// **will not** be deleted.
+    /// Delete a document by its unique ID.
     ///
     /// @param String collectionId
     /// @param String documentId
@@ -401,9 +399,7 @@ open class Database: Service {
     ///
     /// Delete Document
     ///
-    /// Delete a document by its unique ID. This endpoint deletes only the parent
-    /// documents, its attributes and relations to other documents. Child documents
-    /// **will not** be deleted.
+    /// Delete a document by its unique ID.
     ///
     /// @param String collectionId
     /// @param String documentId