Merge pull request #276 from appwrite/dev

abnegate · web-flow · commit d1ea40ea1ff0 · 2025-10-09T23:17:51.000+13:00
feat: Flutter SDK update for version 20.2.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Change Log
 
+## 20.2.0
+
+* Add transaction support for Databases and TablesDB
+
 ## 20.1.0
 
 * Deprecate `createVerification` method in `Account` service
diff --git a/README.md b/README.md
@@ -21,7 +21,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^20.1.0
+  appwrite: ^20.2.0
 ```
 
 You can install packages from the command line:
diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -18,4 +18,5 @@ Document result = await databases.createDocument(
         "isAdmin": false
     },
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/create-operations.md b/docs/examples/databases/create-operations.md
@@ -0,0 +1,22 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+Transaction result = await databases.createOperations(
+    transactionId: '<TRANSACTION_ID>',
+    operations: [
+	    {
+	        "action": "create",
+	        "databaseId": "<DATABASE_ID>",
+	        "collectionId": "<COLLECTION_ID>",
+	        "documentId": "<DOCUMENT_ID>",
+	        "data": {
+	            "name": "Walter O'Brien"
+	        }
+	    }
+	], // optional
+);
diff --git a/docs/examples/databases/create-transaction.md b/docs/examples/databases/create-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+Transaction result = await databases.createTransaction(
+    ttl: 60, // optional
+);
diff --git a/docs/examples/databases/decrement-document-attribute.md b/docs/examples/databases/decrement-document-attribute.md
@@ -13,4 +13,5 @@ Document result = await databases.decrementDocumentAttribute(
     attribute: '',
     value: 0, // optional
     min: 0, // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/delete-document.md b/docs/examples/databases/delete-document.md
@@ -10,4 +10,5 @@ await databases.deleteDocument(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/delete-transaction.md b/docs/examples/databases/delete-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+await databases.deleteTransaction(
+    transactionId: '<TRANSACTION_ID>',
+);
diff --git a/docs/examples/databases/get-document.md b/docs/examples/databases/get-document.md
@@ -11,4 +11,5 @@ Document result = await databases.getDocument(
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/get-transaction.md b/docs/examples/databases/get-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+Transaction result = await databases.getTransaction(
+    transactionId: '<TRANSACTION_ID>',
+);
diff --git a/docs/examples/databases/increment-document-attribute.md b/docs/examples/databases/increment-document-attribute.md
@@ -13,4 +13,5 @@ Document result = await databases.incrementDocumentAttribute(
     attribute: '',
     value: 0, // optional
     max: 0, // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/list-documents.md b/docs/examples/databases/list-documents.md
@@ -10,4 +10,5 @@ DocumentList result = await databases.listDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/list-transactions.md b/docs/examples/databases/list-transactions.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+TransactionList result = await databases.listTransactions(
+    queries: [], // optional
+);
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -12,4 +12,5 @@ Document result = await databases.updateDocument(
     documentId: '<DOCUMENT_ID>',
     data: {}, // optional
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/databases/update-transaction.md b/docs/examples/databases/update-transaction.md
@@ -0,0 +1,13 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Databases databases = Databases(client);
+
+Transaction result = await databases.updateTransaction(
+    transactionId: '<TRANSACTION_ID>',
+    commit: false, // optional
+    rollback: false, // optional
+);
diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -12,4 +12,5 @@ Document result = await databases.upsertDocument(
     documentId: '<DOCUMENT_ID>',
     data: {},
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/create-operations.md b/docs/examples/tablesdb/create-operations.md
@@ -0,0 +1,22 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+Transaction result = await tablesDB.createOperations(
+    transactionId: '<TRANSACTION_ID>',
+    operations: [
+	    {
+	        "action": "create",
+	        "databaseId": "<DATABASE_ID>",
+	        "tableId": "<TABLE_ID>",
+	        "rowId": "<ROW_ID>",
+	        "data": {
+	            "name": "Walter O'Brien"
+	        }
+	    }
+	], // optional
+);
diff --git a/docs/examples/tablesdb/create-row.md b/docs/examples/tablesdb/create-row.md
@@ -18,4 +18,5 @@ Row result = await tablesDB.createRow(
         "isAdmin": false
     },
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/create-transaction.md b/docs/examples/tablesdb/create-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+Transaction result = await tablesDB.createTransaction(
+    ttl: 60, // optional
+);
diff --git a/docs/examples/tablesdb/decrement-row-column.md b/docs/examples/tablesdb/decrement-row-column.md
@@ -13,4 +13,5 @@ Row result = await tablesDB.decrementRowColumn(
     column: '',
     value: 0, // optional
     min: 0, // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/delete-row.md b/docs/examples/tablesdb/delete-row.md
@@ -10,4 +10,5 @@ await tablesDB.deleteRow(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/delete-transaction.md b/docs/examples/tablesdb/delete-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+await tablesDB.deleteTransaction(
+    transactionId: '<TRANSACTION_ID>',
+);
diff --git a/docs/examples/tablesdb/get-row.md b/docs/examples/tablesdb/get-row.md
@@ -11,4 +11,5 @@ Row result = await tablesDB.getRow(
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
     queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/get-transaction.md b/docs/examples/tablesdb/get-transaction.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+Transaction result = await tablesDB.getTransaction(
+    transactionId: '<TRANSACTION_ID>',
+);
diff --git a/docs/examples/tablesdb/increment-row-column.md b/docs/examples/tablesdb/increment-row-column.md
@@ -13,4 +13,5 @@ Row result = await tablesDB.incrementRowColumn(
     column: '',
     value: 0, // optional
     max: 0, // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/list-rows.md b/docs/examples/tablesdb/list-rows.md
@@ -10,4 +10,5 @@ RowList result = await tablesDB.listRows(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     queries: [], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/list-transactions.md b/docs/examples/tablesdb/list-transactions.md
@@ -0,0 +1,11 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+TransactionList result = await tablesDB.listTransactions(
+    queries: [], // optional
+);
diff --git a/docs/examples/tablesdb/update-row.md b/docs/examples/tablesdb/update-row.md
@@ -12,4 +12,5 @@ Row result = await tablesDB.updateRow(
     rowId: '<ROW_ID>',
     data: {}, // optional
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/docs/examples/tablesdb/update-transaction.md b/docs/examples/tablesdb/update-transaction.md
@@ -0,0 +1,13 @@
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+TablesDB tablesDB = TablesDB(client);
+
+Transaction result = await tablesDB.updateTransaction(
+    transactionId: '<TRANSACTION_ID>',
+    commit: false, // optional
+    rollback: false, // optional
+);
diff --git a/docs/examples/tablesdb/upsert-row.md b/docs/examples/tablesdb/upsert-row.md
@@ -12,4 +12,5 @@ Row result = await tablesDB.upsertRow(
     rowId: '<ROW_ID>',
     data: {}, // optional
     permissions: ["read("any")"], // optional
+    transactionId: '<TRANSACTION_ID>', // optional
 );
diff --git a/lib/models.dart b/lib/models.dart
@@ -19,6 +19,7 @@ part 'src/models/language_list.dart';
 part 'src/models/currency_list.dart';
 part 'src/models/phone_list.dart';
 part 'src/models/locale_code_list.dart';
+part 'src/models/transaction_list.dart';
 part 'src/models/row.dart';
 part 'src/models/document.dart';
 part 'src/models/log.dart';
@@ -51,5 +52,6 @@ part 'src/models/mfa_challenge.dart';
 part 'src/models/mfa_recovery_codes.dart';
 part 'src/models/mfa_type.dart';
 part 'src/models/mfa_factors.dart';
+part 'src/models/transaction.dart';
 part 'src/models/subscriber.dart';
 part 'src/models/target.dart';
diff --git a/lib/services/databases.dart b/lib/services/databases.dart
diff --git a/lib/services/tables_db.dart b/lib/services/tables_db.dart
diff --git a/lib/src/client_browser.dart b/lib/src/client_browser.dart
diff --git a/lib/src/client_io.dart b/lib/src/client_io.dart
diff --git a/lib/src/models/transaction.dart b/lib/src/models/transaction.dart
diff --git a/lib/src/models/transaction_list.dart b/lib/src/models/transaction_list.dart
diff --git a/pubspec.yaml b/pubspec.yaml
diff --git a/test/services/databases_test.dart b/test/services/databases_test.dart
diff --git a/test/services/tables_db_test.dart b/test/services/tables_db_test.dart
diff --git a/test/src/models/transaction_list_test.dart b/test/src/models/transaction_list_test.dart
diff --git a/test/src/models/transaction_test.dart b/test/src/models/transaction_test.dart
