sdk update

Author: ArnabChatterjee20k

README.md

@@ -7,7 +7,7 @@
 [![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 1.8.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-android/releases).**
+**This SDK is compatible with Appwrite server version latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-android/releases).**
 
 Appwrite is an open-source backend as a service server that abstracts and simplifies 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 Android 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)
 
@@ -38,7 +38,7 @@ repositories {
 Next, add the dependency to your project's `build.gradle(.kts)` file:
 
 ```groovy
-implementation("io.appwrite:sdk-for-android:12.2.0")
+implementation("io.appwrite:sdk-for-android:12.2.1")
 ```
 
 ### Maven
@@ -49,7 +49,7 @@ Add this to your project's `pom.xml` file:
     <dependency>
         <groupId>io.appwrite</groupId>
         <artifactId>sdk-for-android</artifactId>
-        <version>12.2.0</version>
+        <version>12.2.1</version>
     </dependency>
 </dependencies>
 ```

docs/examples/java/databases/list-documents.md

@@ -15,6 +15,7 @@ databases.listDocuments(
     List.of(), // queries (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
     false, // total (optional)
+    0, // ttl (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

docs/examples/java/tablesdb/list-rows.md

@@ -15,6 +15,7 @@ tablesDB.listRows(
     List.of(), // queries (optional)
     "<TRANSACTION_ID>", // transactionId (optional)
     false, // total (optional)
+    0, // ttl (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

docs/examples/kotlin/databases/list-documents.md

@@ -15,5 +15,6 @@ val result = databases.listDocuments(
     queries = listOf(), // (optional)
     transactionId = "<TRANSACTION_ID>", // (optional)
     total = false, // (optional)
+    ttl = 0, // (optional)
 )
 ```

docs/examples/kotlin/tablesdb/list-rows.md

@@ -15,5 +15,6 @@ val result = tablesDB.listRows(
     queries = listOf(), // (optional)
     transactionId = "<TRANSACTION_ID>", // (optional)
     total = false, // (optional)
+    ttl = 0, // (optional)
 )
 ```

library/src/main/java/io/appwrite/Channel.kt

@@ -24,7 +24,8 @@ typealias Actionable = _Document
  */
 private fun normalize(id: String): String {
     val trimmed = id.trim()
-    return if (trimmed.isEmpty()) "*" else trimmed
+    require(trimmed.isNotEmpty()) { "Channel ID is required." }
+    return trimmed
 }
 
 /**
@@ -59,25 +60,25 @@ class Channel<out T> private constructor(
     override fun toString(): String = segments.joinToString(".")
 
     companion object {
-        fun database(id: String = "*"): Channel<_Database> =
+        fun database(id: String): Channel<_Database> =
             Channel(listOf("databases", normalize(id)))
 
-        fun tablesdb(id: String = "*"): Channel<_TablesDB> =
+        fun tablesdb(id: String): Channel<_TablesDB> =
             Channel(listOf("tablesdb", normalize(id)))
 
-        fun bucket(id: String = "*"): Channel<_Bucket> =
+        fun bucket(id: String): Channel<_Bucket> =
             Channel(listOf("buckets", normalize(id)))
 
-        fun execution(id: String = "*"): Channel<_Execution> =
+        fun execution(id: String): Channel<_Execution> =
             Channel(listOf("executions", normalize(id)))
 
-        fun function(id: String = "*"): Channel<_Func> =
+        fun function(id: String): Channel<_Func> =
             Channel(listOf("functions", normalize(id)))
 
-        fun team(id: String = "*"): Channel<_Team> =
+        fun team(id: String): Channel<_Team> =
             Channel(listOf("teams", normalize(id)))
 
-        fun membership(id: String = "*"): Channel<_Membership> =
+        fun membership(id: String): Channel<_Membership> =
             Channel(listOf("memberships", normalize(id)))
 
         fun account(): String = "account"
@@ -98,8 +99,8 @@ class Channel<out T> private constructor(
 /**
  * Only available on Channel<_Database>
  */
-fun Channel<_Database>.collection(id: String? = null): Channel<_Collection> =
-    this.next("collections", id ?: "*")
+fun Channel<_Database>.collection(id: String): Channel<_Collection> =
+    this.next("collections", id)
 
 /**
  * Only available on Channel<_Collection>
@@ -112,8 +113,8 @@ fun Channel<_Collection>.document(id: String? = null): Channel<_Document> =
 /**
  * Only available on Channel<_TablesDB>
  */
-fun Channel<_TablesDB>.table(id: String? = null): Channel<_Table> =
-    this.next("tables", id ?: "*")
+fun Channel<_TablesDB>.table(id: String): Channel<_Table> =
+    this.next("tables", id)
 
 /**
  * Only available on Channel<_Table>

library/src/main/java/io/appwrite/Client.kt

@@ -87,7 +87,7 @@ class Client @JvmOverloads constructor(
             "x-sdk-name" to "Android",
             "x-sdk-platform" to "client",
             "x-sdk-language" to "android",
-            "x-sdk-version" to "12.2.0",
+            "x-sdk-version" to "12.2.1",
             "x-appwrite-response-format" to "1.8.0"
         )
         config = mutableMapOf()

library/src/main/java/io/appwrite/models/Document.kt

@@ -14,7 +14,7 @@ data class Document<T>(
     val id: String,
 
     /**
-     * Document automatically incrementing ID.
+     * Document sequence ID.
      */
     @SerializedName("\$sequence")
     val sequence: Long,

library/src/main/java/io/appwrite/models/Row.kt

@@ -14,7 +14,7 @@ data class Row<T>(
     val id: String,
 
     /**
-     * Row automatically incrementing ID.
+     * Row sequence ID.
      */
     @SerializedName("\$sequence")
     val sequence: Long,

library/src/main/java/io/appwrite/services/Databases.kt

@@ -220,6 +220,7 @@ class Databases(client: Client) : Service(client) {
      * @param queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
      * @param transactionId Transaction ID to read uncommitted changes within the transaction.
      * @param total When set to false, the total count returned will be 0 and will not be calculated.
+     * @param ttl TTL (seconds) for cached responses when caching is enabled for select queries. Must be between 0 and 86400 (24 hours).
      * @return [io.appwrite.models.DocumentList<T>]
      */
     @Deprecated(
@@ -233,6 +234,7 @@ class Databases(client: Client) : Service(client) {
         queries: List<String>? = null,
         transactionId: String? = null,
         total: Boolean? = null,
+        ttl: Long? = null,
         nestedType: Class<T>,
     ): io.appwrite.models.DocumentList<T> {
         val apiPath = "/databases/{databaseId}/collections/{collectionId}/documents"
@@ -243,6 +245,7 @@ class Databases(client: Client) : Service(client) {
             "queries" to queries,
             "transactionId" to transactionId,
             "total" to total,
+            "ttl" to ttl,
         )
         val apiHeaders = mutableMapOf<String, String>(
         )
@@ -268,6 +271,7 @@ class Databases(client: Client) : Service(client) {
      * @param queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
      * @param transactionId Transaction ID to read uncommitted changes within the transaction.
      * @param total When set to false, the total count returned will be 0 and will not be calculated.
+     * @param ttl TTL (seconds) for cached responses when caching is enabled for select queries. Must be between 0 and 86400 (24 hours).
      * @return [io.appwrite.models.DocumentList<T>]
      */
     @Deprecated(
@@ -282,12 +286,14 @@ class Databases(client: Client) : Service(client) {
         queries: List<String>? = null,
         transactionId: String? = null,
         total: Boolean? = null,
+        ttl: Long? = null,
     ): io.appwrite.models.DocumentList<Map<String, Any>> = listDocuments(
         databaseId,
         collectionId,
         queries,
         transactionId,
         total,
+        ttl,
         nestedType = classOf(),
     )