feat: support for 0.14.x

Author: TorstenDittmann

README.md

@@ -2,11 +2,11 @@
 
 ![Maven Central](https://img.shields.io/maven-central/v/io.appwrite/sdk-for-kotlin.svg?color=green&style=flat-square)
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-kotlin.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)
 [![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-kotlin/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-kotlin/releases).**
 
  > This is the Kotlin SDK for integrating with Appwrite from your Kotlin server-side code. If you're looking for the Android SDK you should check [appwrite/sdk-for-android](https://github.com/appwrite/sdk-for-android)
 
@@ -39,7 +39,7 @@ repositories {
 Next, add the dependency to your project's `build.gradle(.kts)` file:
 
 ```groovy
-implementation("io.appwrite:sdk-for-kotlin:0.4.0")
+implementation("io.appwrite:sdk-for-kotlin:0.5.0")
 ```
 
 ### Maven
@@ -50,7 +50,7 @@ Add this to your project's `pom.xml` file:
     <dependency>
         <groupId>io.appwrite</groupId>
         <artifactId>sdk-for-kotlin</artifactId>
-        <version>0.4.0</version>
+        <version>0.5.0</version>
     </dependency>
 </dependencies>
 ```

docs/examples/java/account/delete.md renamed to docs/examples/java/account/update-status.md

@@ -8,7 +8,7 @@ public void main() {
         .setJWT("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ..."); // Your secret JSON Web Token
 
     Account account = new Account(client);
-    account.delete(new Continuation<Response>() {
+    account.updateStatus(new Continuation<Response>() {
         @NotNull
         @Override
         public CoroutineContext getContext() {

docs/examples/java/health/get-queue-usage.md

@@ -0,0 +1,36 @@
+import io.appwrite.Client
+import io.appwrite.services.Users
+
+public void main() {
+    Client client = Client(context)
+        .setEndpoint("https://[HOSTNAME_OR_IP]/v1") // Your API Endpoint
+        .setProject("5df5acd0d48c2") // Your project ID
+        .setKey("919c2d18fb5d4...a2ae413da83346ad2"); // Your secret API key
+
+    Users users = new Users(client);
+    users.getMemberships(
+        userId = "[USER_ID]"
+        new Continuation<Response>() {
+            @NotNull
+            @Override
+            public CoroutineContext getContext() {
+                return EmptyCoroutineContext.INSTANCE;
+            }
+
+            @Override
+            public void resumeWith(@NotNull Object o) {
+                String json = "";
+                try {
+                    if (o instanceof Result.Failure) {
+                        Result.Failure failure = (Result.Failure) o;
+                        throw failure.exception;
+                    } else {
+                        Response response = (Response) o;
+                    }
+                } catch (Throwable th) {
+                    Log.e("ERROR", th.toString());
+                }
+            }
+        }
+    );
+}

docs/examples/java/users/get-memberships.md

@@ -8,6 +8,6 @@ suspend fun main() {
       .setJWT("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...") // Your secret JSON Web Token
 
     val account = Account(client)
-    val response = account.delete()
+    val response = account.updateStatus()
     val json = response.body?.string()
 }

docs/examples/kotlin/account/delete.md renamed to docs/examples/kotlin/account/update-status.md

@@ -1,13 +1,15 @@
 import io.appwrite.Client
-import io.appwrite.services.Health
+import io.appwrite.services.Users
 
 suspend fun main() {
     val client = Client(context)
       .setEndpoint("https://[HOSTNAME_OR_IP]/v1") // Your API Endpoint
       .setProject("5df5acd0d48c2") // Your project ID
       .setKey("919c2d18fb5d4...a2ae413da83346ad2") // Your secret API key
 
-    val health = Health(client)
-    val response = health.getQueueUsage()
+    val users = Users(client)
+    val response = users.getMemberships(
+        userId = "[USER_ID]"
+    )
     val json = response.body?.string()
 }

docs/examples/kotlin/health/get-queue-usage.md renamed to docs/examples/kotlin/users/get-memberships.md

@@ -56,11 +56,11 @@ data class Execution(
     val statusCode: Long,
 
     /**
-     * The script stdout output string. Logs the last 4,000 characters of the execution stdout output.
+     * The script response output string. Logs the last 4,000 characters of the execution response output.
      *
      */
-    @SerializedName("stdout")
-    val stdout: String,
+    @SerializedName("response")
+    val response: String,
 
     /**
      * The script stderr output string. Logs the last 4,000 characters of the execution stderr output
@@ -86,7 +86,7 @@ data class Execution(
             trigger = map["trigger"] as String,
             status = map["status"] as String,
             statusCode = (map["statusCode"] as Number).toLong(),
-            stdout = map["stdout"] as String,
+            response = map["response"] as String,
             stderr = map["stderr"] as String,
             time = (map["time"] as Number).toDouble()
         )
@@ -100,7 +100,7 @@ data class Execution(
         "trigger" to trigger as Any,
         "status" to status as Any,
         "statusCode" to statusCode as Any,
-        "stdout" to stdout as Any,
+        "response" to response as Any,
         "stderr" to stderr as Any,
         "time" to time as Any
     )

src/main/kotlin/io/appwrite/models/Execution.kt

@@ -21,25 +21,32 @@ data class Membership(
     val userId: String,
 
     /**
-     * Team ID.
+     * User name.
      *
      */
-    @SerializedName("teamId")
-    val teamId: String,
+    @SerializedName("userName")
+    val userName: String,
 
     /**
-     * User name.
+     * User email address.
      *
      */
-    @SerializedName("name")
-    val name: String,
+    @SerializedName("userEmail")
+    val userEmail: String,
 
     /**
-     * User email address.
+     * Team ID.
+     *
+     */
+    @SerializedName("teamId")
+    val teamId: String,
+
+    /**
+     * Team name.
      *
      */
-    @SerializedName("email")
-    val email: String,
+    @SerializedName("teamName")
+    val teamName: String,
 
     /**
      * Date, the user has been invited to join the team in Unix timestamp.
@@ -74,9 +81,10 @@ data class Membership(
         fun from(map: Map<String, Any>) = Membership(
             id = map["\$id"] as String,
             userId = map["userId"] as String,
+            userName = map["userName"] as String,
+            userEmail = map["userEmail"] as String,
             teamId = map["teamId"] as String,
-            name = map["name"] as String,
-            email = map["email"] as String,
+            teamName = map["teamName"] as String,
             invited = (map["invited"] as Number).toLong(),
             joined = (map["joined"] as Number).toLong(),
             confirm = map["confirm"] as Boolean,
@@ -87,9 +95,10 @@ data class Membership(
     fun toMap(): Map<String, Any> = mapOf(
         "\$id" to id as Any,
         "userId" to userId as Any,
+        "userName" to userName as Any,
+        "userEmail" to userEmail as Any,
         "teamId" to teamId as Any,
-        "name" to name as Any,
-        "email" to email as Any,
+        "teamName" to teamName as Any,
         "invited" to invited as Any,
         "joined" to joined as Any,
         "confirm" to confirm as Any,

src/main/kotlin/io/appwrite/models/Membership.kt

@@ -37,35 +37,6 @@ class Account(client: Client) : Service(client) {
         )
     }
 
-    /**
-     * 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.
-     *
-     * @return [Any]     
-     */
-    @JvmOverloads
-    @Throws(AppwriteException::class)
-    suspend fun delete(): Any {
-        val path = "/account"
-        val params = mutableMapOf<String, Any?>(
-        )
-        val headers = mutableMapOf(
-            "content-type" to "application/json"
-        )
-        return client.call(
-            "DELETE",
-            path,
-            headers,
-            params,
-            responseType = Any::class.java,
-        )
-    }
-    
     /**
      * Update Account Email
      *
@@ -184,7 +155,7 @@ class Account(client: Client) : Service(client) {
      *
      * 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 password New user password. Must be at least 8 chars.
      * @param oldPassword Current user password. Must be at least 8 chars.
@@ -466,6 +437,10 @@ class Account(client: Client) : Service(client) {
     /**
      * 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 sessionId Session ID. Use the string &#039;current&#039; to update the current device session.
      * @return [io.appwrite.models.Session]     
      */
@@ -524,6 +499,37 @@ class Account(client: Client) : Service(client) {
         )
     }
 
+    /**
+     * 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.
+     *
+     * @return [io.appwrite.models.User]     
+     */
+    @JvmOverloads
+    @Throws(AppwriteException::class)
+    suspend fun updateStatus(): io.appwrite.models.User {
+        val path = "/account/status"
+        val params = mutableMapOf<String, Any?>(
+        )
+        val headers = mutableMapOf(
+            "content-type" to "application/json"
+        )
+        val converter: (Map<String, Any>) -> io.appwrite.models.User = {
+            io.appwrite.models.User.from(map = it)
+        }
+        return client.call(
+            "PATCH",
+            path,
+            headers,
+            params,
+            responseType = io.appwrite.models.User::class.java,
+            converter,
+        )
+    }
+    
     /**
      * Create Email Verification
      *