Merge pull request #33 from appwrite/dev

fix: patch updates for appwrite 1.4.1

Author: abnegate

README.md

@@ -39,7 +39,7 @@ repositories {
 Next, add the dependency to your project's `build.gradle(.kts)` file:
 
 ```groovy
-implementation("io.appwrite:sdk-for-kotlin:3.0.0")
+implementation("io.appwrite:sdk-for-kotlin:3.0.1")
 ```
 
 ### 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>3.0.0</version>
+        <version>3.0.1</version>
     </dependency>
 </dependencies>
 ```

src/main/kotlin/io/appwrite/Client.kt

@@ -62,11 +62,11 @@ class Client @JvmOverloads constructor(
     init {
         headers = mutableMapOf(
             "content-type" to "application/json",
-            "user-agent" to "AppwriteKotlinSDK/3.0.0 ${System.getProperty("http.agent")}",
+            "user-agent" to "AppwriteKotlinSDK/3.0.1 ${System.getProperty("http.agent")}",
             "x-sdk-name" to "Kotlin",
             "x-sdk-platform" to "server",
             "x-sdk-language" to "kotlin",
-            "x-sdk-version" to "3.0.0",            "x-appwrite-response-format" to "1.4.0"
+            "x-sdk-version" to "3.0.1",            "x-appwrite-response-format" to "1.4.0"
         )
         config = mutableMapOf()
 
@@ -368,7 +368,7 @@ class Client @JvmOverloads constructor(
                 responseType = Map::class.java,
             )
             val chunksUploaded = current["chunksUploaded"] as Long
-            offset = (chunksUploaded * CHUNK_SIZE).coerceAtMost(size)
+            offset = chunksUploaded * CHUNK_SIZE
         }
 
         while (offset < size) {
@@ -379,7 +379,7 @@ class Client @JvmOverloads constructor(
                 }
                 "bytes" -> {
                     val end = if (offset + CHUNK_SIZE < size) {
-                        offset + CHUNK_SIZE
+                        offset + CHUNK_SIZE - 1
                     } else {
                         size - 1
                     }
@@ -399,7 +399,7 @@ class Client @JvmOverloads constructor(
             )
 
             headers["Content-Range"] =
-                "bytes $offset-${((offset + CHUNK_SIZE) - 1).coerceAtMost(size)}/$size"
+                "bytes $offset-${((offset + CHUNK_SIZE) - 1).coerceAtMost(size - 1)}/$size"
 
             result = call(
                 method = "POST",

src/main/kotlin/io/appwrite/Role.kt

@@ -1,29 +1,72 @@
 package io.appwrite
 
+/**
+ * Helper class to generate role strings for [Permission].
+ */
 class Role {
     companion object {
+
+        /**
+         * Grants access to anyone.
+         *
+         * This includes authenticated and unauthenticated users.
+         */
         fun any(): String = "any"
 
+        /**
+         * Grants access to a specific user by user ID.
+         *
+         * You can optionally pass verified or unverified for
+         * [status] to target specific types of users.
+         */
         fun user(id: String, status: String = ""): String = if(status.isEmpty()) {
             "user:$id"
         } else {
             "user:$id/$status"
         }
 
+        /**
+         * Grants access to any authenticated or anonymous user.
+         *
+         * You can optionally pass verified or unverified for
+         * [status] to target specific types of users.
+         */
         fun users(status: String = ""): String = if(status.isEmpty()) {
             "users"
         } else {
             "users/$status"
         }
 
+        /**
+         * Grants access to any guest user without a session.
+         *
+         * Authenticated users don't have access to this role.
+         */
         fun guests(): String = "guests"
 
+        /**
+         * Grants access to a team by team ID.
+         *
+         * You can optionally pass a role for [role] to target
+         * team members with the specified role.
+         */
         fun team(id: String, role: String = ""): String = if(role.isEmpty()) {
             "team:$id"
         } else {
             "team:$id/$role"
         }
 
+        /**
+         * Grants access to a specific member of a team.
+         *
+         * When the member is removed from the team, they will
+         * no longer have access.
+         */
         fun member(id: String): String = "member:$id"
+
+        /**
+         * Grants access to a user with the specified label.
+         */
+        fun label(name: String): String = "label:$name"
     }
 }