appwrite · abnegate · Nov 3, 2025 · Nov 3, 2025 · Nov 3, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Change Log
 
+## 20.3.0
+
+* Add `total` parameter to list queries allowing skipping counting rows in a table for improved performance
+* Add `Operator` class for atomic modification of rows via update, bulk update, upsert, and bulk upsert operations
+
 ## 20.2.1
 
 * Add transaction support for Databases and TablesDB

diff --git a/docs/examples/account/list-identities.md b/docs/examples/account/list-identities.md
@@ -8,5 +8,6 @@ const client = new sdk.Client()
 const account = new sdk.Account(client);
 
 const result = await account.listIdentities({
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/account/list-logs.md b/docs/examples/account/list-logs.md
@@ -8,5 +8,6 @@ const client = new sdk.Client()
 const account = new sdk.Account(client);
 
 const result = await account.listLogs({
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/create-collection.md b/docs/examples/databases/create-collection.md
@@ -11,7 +11,7 @@ const result = await databases.createCollection({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     documentSecurity: false, // optional
     enabled: false // optional
 });
diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -18,6 +18,6 @@ const result = await databases.createDocument({
         "age": 30,
         "isAdmin": false
     },
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
diff --git a/docs/examples/databases/list-attributes.md b/docs/examples/databases/list-attributes.md
@@ -10,5 +10,6 @@ const databases = new sdk.Databases(client);
 const result = await databases.listAttributes({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/list-collections.md b/docs/examples/databases/list-collections.md
@@ -10,5 +10,6 @@ const databases = new sdk.Databases(client);
 const result = await databases.listCollections({
     databaseId: '<DATABASE_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/list-documents.md b/docs/examples/databases/list-documents.md
@@ -11,5 +11,6 @@ const result = await databases.listDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     queries: [], // optional
-    transactionId: '<TRANSACTION_ID>' // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/list-indexes.md b/docs/examples/databases/list-indexes.md
@@ -10,5 +10,6 @@ const databases = new sdk.Databases(client);
 const result = await databases.listIndexes({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/list.md b/docs/examples/databases/list.md
@@ -9,5 +9,6 @@ const databases = new sdk.Databases(client);
 
 const result = await databases.list({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/databases/update-collection.md b/docs/examples/databases/update-collection.md
@@ -11,7 +11,7 @@ const result = await databases.updateCollection({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     documentSecurity: false, // optional
     enabled: false // optional
 });
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -12,6 +12,6 @@ const result = await databases.updateDocument({
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -12,6 +12,6 @@ const result = await databases.upsertDocument({
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: {},
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
diff --git a/docs/examples/functions/list-deployments.md b/docs/examples/functions/list-deployments.md
@@ -10,5 +10,6 @@ const functions = new sdk.Functions(client);
 const result = await functions.listDeployments({
     functionId: '<FUNCTION_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/functions/list-executions.md b/docs/examples/functions/list-executions.md
@@ -9,5 +9,6 @@ const functions = new sdk.Functions(client);
 
 const result = await functions.listExecutions({
     functionId: '<FUNCTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/functions/list.md b/docs/examples/functions/list.md
@@ -9,5 +9,6 @@ const functions = new sdk.Functions(client);
 
 const result = await functions.list({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/create-resend-provider.md b/docs/examples/messaging/create-resend-provider.md
@@ -0,0 +1,19 @@
+const sdk = require('node-appwrite');
+
+const client = new sdk.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
+
+const messaging = new sdk.Messaging(client);
+
+const result = await messaging.createResendProvider({
+    providerId: '<PROVIDER_ID>',
+    name: '<NAME>',
+    apiKey: '<API_KEY>', // optional
+    fromName: '<FROM_NAME>', // optional
+    fromEmail: 'email@example.com', // optional
+    replyToName: '<REPLY_TO_NAME>', // optional
+    replyToEmail: 'email@example.com', // optional
+    enabled: false // optional
+});
diff --git a/docs/examples/messaging/list-message-logs.md b/docs/examples/messaging/list-message-logs.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listMessageLogs({
     messageId: '<MESSAGE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-messages.md b/docs/examples/messaging/list-messages.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listMessages({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-provider-logs.md b/docs/examples/messaging/list-provider-logs.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listProviderLogs({
     providerId: '<PROVIDER_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-providers.md b/docs/examples/messaging/list-providers.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listProviders({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-subscriber-logs.md b/docs/examples/messaging/list-subscriber-logs.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listSubscriberLogs({
     subscriberId: '<SUBSCRIBER_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-subscribers.md b/docs/examples/messaging/list-subscribers.md
@@ -10,5 +10,6 @@ const messaging = new sdk.Messaging(client);
 const result = await messaging.listSubscribers({
     topicId: '<TOPIC_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-targets.md b/docs/examples/messaging/list-targets.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listTargets({
     messageId: '<MESSAGE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-topic-logs.md b/docs/examples/messaging/list-topic-logs.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listTopicLogs({
     topicId: '<TOPIC_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/list-topics.md b/docs/examples/messaging/list-topics.md
@@ -9,5 +9,6 @@ const messaging = new sdk.Messaging(client);
 
 const result = await messaging.listTopics({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/messaging/update-resend-provider.md b/docs/examples/messaging/update-resend-provider.md
@@ -0,0 +1,19 @@
+const sdk = require('node-appwrite');
+
+const client = new sdk.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
+
+const messaging = new sdk.Messaging(client);
+
+const result = await messaging.updateResendProvider({
+    providerId: '<PROVIDER_ID>',
+    name: '<NAME>', // optional
+    enabled: false, // optional
+    apiKey: '<API_KEY>', // optional
+    fromName: '<FROM_NAME>', // optional
+    fromEmail: 'email@example.com', // optional
+    replyToName: '<REPLY_TO_NAME>', // optional
+    replyToEmail: '<REPLY_TO_EMAIL>' // optional
+});
diff --git a/docs/examples/sites/list-deployments.md b/docs/examples/sites/list-deployments.md
@@ -10,5 +10,6 @@ const sites = new sdk.Sites(client);
 const result = await sites.listDeployments({
     siteId: '<SITE_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/sites/list-logs.md b/docs/examples/sites/list-logs.md
@@ -9,5 +9,6 @@ const sites = new sdk.Sites(client);
 
 const result = await sites.listLogs({
     siteId: '<SITE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/sites/list.md b/docs/examples/sites/list.md
@@ -9,5 +9,6 @@ const sites = new sdk.Sites(client);
 
 const result = await sites.list({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/storage/create-bucket.md b/docs/examples/storage/create-bucket.md
@@ -10,7 +10,7 @@ const storage = new sdk.Storage(client);
 const result = await storage.createBucket({
     bucketId: '<BUCKET_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     fileSecurity: false, // optional
     enabled: false, // optional
     maximumFileSize: 1, // optional

diff --git a/docs/examples/storage/create-file.md b/docs/examples/storage/create-file.md
@@ -12,5 +12,5 @@ const result = await storage.createFile({
     bucketId: '<BUCKET_ID>',
     fileId: '<FILE_ID>',
     file: InputFile.fromPath('/path/to/file', 'filename'),
-    permissions: ["read("any")"] // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())] // optional
 });
diff --git a/docs/examples/storage/list-buckets.md b/docs/examples/storage/list-buckets.md
@@ -9,5 +9,6 @@ const storage = new sdk.Storage(client);
 
 const result = await storage.listBuckets({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/storage/list-files.md b/docs/examples/storage/list-files.md
@@ -10,5 +10,6 @@ const storage = new sdk.Storage(client);
 const result = await storage.listFiles({
     bucketId: '<BUCKET_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/storage/update-bucket.md b/docs/examples/storage/update-bucket.md
@@ -10,7 +10,7 @@ const storage = new sdk.Storage(client);
 const result = await storage.updateBucket({
     bucketId: '<BUCKET_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     fileSecurity: false, // optional
     enabled: false, // optional
     maximumFileSize: 1, // optional

diff --git a/docs/examples/storage/update-file.md b/docs/examples/storage/update-file.md
@@ -11,5 +11,5 @@ const result = await storage.updateFile({
     bucketId: '<BUCKET_ID>',
     fileId: '<FILE_ID>',
     name: '<NAME>', // optional
-    permissions: ["read("any")"] // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())] // optional
 });
diff --git a/docs/examples/tablesdb/create-row.md b/docs/examples/tablesdb/create-row.md
@@ -18,6 +18,6 @@ const result = await tablesDB.createRow({
         "age": 30,
         "isAdmin": false
     },
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
diff --git a/docs/examples/tablesdb/create-table.md b/docs/examples/tablesdb/create-table.md
@@ -11,7 +11,7 @@ const result = await tablesDB.createTable({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     rowSecurity: false, // optional
     enabled: false // optional
 });
diff --git a/docs/examples/tablesdb/list-columns.md b/docs/examples/tablesdb/list-columns.md
@@ -10,5 +10,6 @@ const tablesDB = new sdk.TablesDB(client);
 const result = await tablesDB.listColumns({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/tablesdb/list-indexes.md b/docs/examples/tablesdb/list-indexes.md
@@ -10,5 +10,6 @@ const tablesDB = new sdk.TablesDB(client);
 const result = await tablesDB.listIndexes({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
diff --git a/docs/examples/tablesdb/list-rows.md b/docs/examples/tablesdb/list-rows.md
@@ -11,5 +11,6 @@ const result = await tablesDB.listRows({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     queries: [], // optional
-    transactionId: '<TRANSACTION_ID>' // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/tablesdb/list-tables.md b/docs/examples/tablesdb/list-tables.md
@@ -10,5 +10,6 @@ const tablesDB = new sdk.TablesDB(client);
 const result = await tablesDB.listTables({
     databaseId: '<DATABASE_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/tablesdb/list.md b/docs/examples/tablesdb/list.md
@@ -9,5 +9,6 @@ const tablesDB = new sdk.TablesDB(client);
 
 const result = await tablesDB.list({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
diff --git a/docs/examples/tablesdb/update-row.md b/docs/examples/tablesdb/update-row.md
@@ -12,6 +12,6 @@ const result = await tablesDB.updateRow({
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
diff --git a/docs/examples/tablesdb/update-table.md b/docs/examples/tablesdb/update-table.md
@@ -11,7 +11,7 @@ const result = await tablesDB.updateTable({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     name: '<NAME>',
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     rowSecurity: false, // optional
     enabled: false // optional
 });
diff --git a/docs/examples/tablesdb/upsert-row.md b/docs/examples/tablesdb/upsert-row.md
@@ -12,6 +12,6 @@ const result = await tablesDB.upsertRow({
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [sdk.Permission.read(sdk.Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });