Merge pull request #94 from appwrite/dev

abnegate · web-flow · commit 6279a1c8bde2 · 2025-10-09T23:18:38.000+13:00
feat: Dart SDK update for version 19.2.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Change Log
 
+## 19.2.0
+
+* Add transaction support for Databases and TablesDB
+
 ## 19.1.0
 
 * Deprecate `createVerification` method in `Account` service
diff --git a/README.md b/README.md
@@ -23,7 +23,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  dart_appwrite: ^19.1.0
+  dart_appwrite: ^19.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
@@ -19,4 +19,5 @@ Document result = await databases.createDocument(
         "isAdmin": false
     },
     permissions: ["read("any")"], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/create-documents.md b/docs/examples/databases/create-documents.md
@@ -11,4 +11,5 @@ DocumentList result = await databases.createDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documents: [],
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/create-operations.md b/docs/examples/databases/create-operations.md
@@ -0,0 +1,23 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = 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,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = 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
@@ -14,4 +14,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
@@ -11,4 +11,5 @@ await databases.deleteDocument(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/delete-documents.md b/docs/examples/databases/delete-documents.md
@@ -11,4 +11,5 @@ await databases.deleteDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     queries: [], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/delete-transaction.md b/docs/examples/databases/delete-transaction.md
@@ -0,0 +1,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = Databases(client);
+
+await databases.deleteTransaction(
+    transactionId: '<TRANSACTION_ID>',
+);
diff --git a/docs/examples/databases/get-document.md b/docs/examples/databases/get-document.md
@@ -12,4 +12,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,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = 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
@@ -14,4 +14,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
@@ -11,4 +11,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,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = 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
@@ -13,4 +13,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-documents.md b/docs/examples/databases/update-documents.md
@@ -12,4 +12,5 @@ DocumentList result = await databases.updateDocuments(
     collectionId: '<COLLECTION_ID>',
     data: {}, // (optional)
     queries: [], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/update-transaction.md b/docs/examples/databases/update-transaction.md
@@ -0,0 +1,14 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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 = 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
@@ -13,4 +13,5 @@ Document result = await databases.upsertDocument(
     documentId: '<DOCUMENT_ID>',
     data: {},
     permissions: ["read("any")"], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/databases/upsert-documents.md b/docs/examples/databases/upsert-documents.md
@@ -11,4 +11,5 @@ DocumentList result = await databases.upsertDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documents: [],
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/messaging/create-push.md b/docs/examples/messaging/create-push.md
@@ -16,7 +16,7 @@ Message result = await messaging.createPush(
     targets: [], // (optional)
     data: {}, // (optional)
     action: '<ACTION>', // (optional)
-    image: '[ID1:ID2]', // (optional)
+    image: '<ID1:ID2>', // (optional)
     icon: '<ICON>', // (optional)
     sound: '<SOUND>', // (optional)
     color: '<COLOR>', // (optional)
diff --git a/docs/examples/messaging/update-push.md b/docs/examples/messaging/update-push.md
@@ -16,7 +16,7 @@ Message result = await messaging.updatePush(
     body: '<BODY>', // (optional)
     data: {}, // (optional)
     action: '<ACTION>', // (optional)
-    image: '[ID1:ID2]', // (optional)
+    image: '<ID1:ID2>', // (optional)
     icon: '<ICON>', // (optional)
     sound: '<SOUND>', // (optional)
     color: '<COLOR>', // (optional)
diff --git a/docs/examples/tablesdb/create-operations.md b/docs/examples/tablesdb/create-operations.md
@@ -0,0 +1,23 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -19,4 +19,5 @@ Row result = await tablesDB.createRow(
         "isAdmin": false
     },
     permissions: ["read("any")"], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/create-rows.md b/docs/examples/tablesdb/create-rows.md
@@ -11,4 +11,5 @@ RowList result = await tablesDB.createRows(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     rows: [],
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/create-transaction.md b/docs/examples/tablesdb/create-transaction.md
@@ -0,0 +1,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -14,4 +14,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
@@ -11,4 +11,5 @@ await tablesDB.deleteRow(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/delete-rows.md b/docs/examples/tablesdb/delete-rows.md
@@ -11,4 +11,5 @@ await tablesDB.deleteRows(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     queries: [], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/delete-transaction.md b/docs/examples/tablesdb/delete-transaction.md
@@ -0,0 +1,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -12,4 +12,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,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -14,4 +14,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
@@ -11,4 +11,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,12 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -13,4 +13,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-rows.md b/docs/examples/tablesdb/update-rows.md
@@ -12,4 +12,5 @@ RowList result = await tablesDB.updateRows(
     tableId: '<TABLE_ID>',
     data: {}, // (optional)
     queries: [], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/update-transaction.md b/docs/examples/tablesdb/update-transaction.md
@@ -0,0 +1,14 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+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
@@ -13,4 +13,5 @@ Row result = await tablesDB.upsertRow(
     rowId: '<ROW_ID>',
     data: {}, // (optional)
     permissions: ["read("any")"], // (optional)
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/docs/examples/tablesdb/upsert-rows.md b/docs/examples/tablesdb/upsert-rows.md
@@ -11,4 +11,5 @@ RowList result = await tablesDB.upsertRows(
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     rows: [],
+    transactionId: '<TRANSACTION_ID>', // (optional)
 );
diff --git a/lib/models.dart b/lib/models.dart
@@ -38,6 +38,7 @@ part 'src/models/message_list.dart';
 part 'src/models/topic_list.dart';
 part 'src/models/subscriber_list.dart';
 part 'src/models/target_list.dart';
+part 'src/models/transaction_list.dart';
 part 'src/models/specification_list.dart';
 part 'src/models/database.dart';
 part 'src/models/collection.dart';
@@ -122,5 +123,6 @@ part 'src/models/mfa_factors.dart';
 part 'src/models/provider.dart';
 part 'src/models/message.dart';
 part 'src/models/topic.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
