Merge pull request #59 from appwrite/dev

feat: Kotlin SDK update for version 12.2.0

Author: abnegate

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 12.2.0
+
+* Add transaction support for Databases and TablesDB
+
 ## 12.1.0
 
 * Deprecate `createVerification` method in `Account` service

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:12.1.0")
+implementation("io.appwrite:sdk-for-kotlin:12.2.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>12.1.0</version>
+        <version>12.2.0</version>
     </dependency>
 </dependencies>
 ```

docs/examples/java/databases/create-document.md

@@ -21,6 +21,7 @@ databases.createDocument(
         "isAdmin" to false
     ), // data
     listOf("read("any")"), // permissions (optional)
+    "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

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

@@ -13,6 +13,7 @@ databases.createDocuments(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     listOf(), // documents
+    "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

docs/examples/java/databases/create-operations.md

@@ -0,0 +1,34 @@
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Databases;
+
+Client client = new Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+    .setKey("<YOUR_API_KEY>"); // Your secret API key
+
+Databases databases = new Databases(client);
+
+databases.createOperations(
+    "<TRANSACTION_ID>", // transactionId
+    listOf(
+	    {
+	        "action": "create",
+	        "databaseId": "<DATABASE_ID>",
+	        "collectionId": "<COLLECTION_ID>",
+	        "documentId": "<DOCUMENT_ID>",
+	        "data": {
+	            "name": "Walter O'Brien"
+	        }
+	    }
+	), // operations (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        System.out.println(result);
+    })
+);
+

docs/examples/java/databases/create-transaction.md

@@ -0,0 +1,23 @@
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Databases;
+
+Client client = new Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+    .setKey("<YOUR_API_KEY>"); // Your secret API key
+
+Databases databases = new Databases(client);
+
+databases.createTransaction(
+    60, // ttl (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        System.out.println(result);
+    })
+);
+

docs/examples/java/databases/decrement-document-attribute.md

@@ -16,6 +16,7 @@ databases.decrementDocumentAttribute(
     "", // attribute
     0, // value (optional)
     0, // min (optional)
+    "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

docs/examples/java/databases/delete-document.md

@@ -13,6 +13,7 @@ databases.deleteDocument(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     "<DOCUMENT_ID>", // documentId
+    "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

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

@@ -13,6 +13,7 @@ databases.deleteDocuments(
     "<DATABASE_ID>", // databaseId
     "<COLLECTION_ID>", // collectionId
     listOf(), // queries (optional)
+    "<TRANSACTION_ID>", // transactionId (optional)
     new CoroutineCallback<>((result, error) -> {
         if (error != null) {
             error.printStackTrace();

docs/examples/java/databases/delete-transaction.md

@@ -0,0 +1,23 @@
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Databases;
+
+Client client = new Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+    .setKey("<YOUR_API_KEY>"); // Your secret API key
+
+Databases databases = new Databases(client);
+
+databases.deleteTransaction(
+    "<TRANSACTION_ID>", // transactionId
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        System.out.println(result);
+    })
+);
+