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-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-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-swift/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-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)
 
@@ -33,7 +33,7 @@ Add the package to your `Package.swift` dependencies:
 
 ```swift
     dependencies: [
-        .package(url: "[email protected]:appwrite/sdk-for-swift.git", from: "0.4.0"),
+        .package(url: "[email protected]:appwrite/sdk-for-swift.git", from: "0.5.0"),
     ],
 ```
 
@@ -44,9 +44,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-swift")
+                .product(name: "", package: "sdk-for-swift")
             ]
         ),
 ```

Sources/Appwrite/Client.swift

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

Sources/Appwrite/Services/Account.swift

@@ -31,32 +31,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
     ///
@@ -169,7 +143,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
@@ -437,6 +411,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
@@ -496,6 +474,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
     ///
@@ -602,33 +609,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
     ///
@@ -726,7 +706,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
@@ -960,6 +940,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
@@ -1010,6 +994,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
@@ -50,6 +55,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
@@ -116,6 +127,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
@@ -156,6 +173,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
@@ -196,6 +219,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
@@ -234,6 +263,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
@@ -269,9 +299,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
@@ -309,6 +344,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
@@ -374,6 +415,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
@@ -412,6 +459,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
@@ -453,6 +506,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
@@ -492,6 +551,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

@@ -896,9 +896,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
@@ -1821,9 +1819,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