Merge pull request #147 from appwrite/dev

abnegate · web-flow · commit de72141ece55 · 2025-11-03T18:46:44.000+13:00
feat: Web SDK update for version 21.4.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Change Log
 
+## 21.4.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
+
 ## 21.3.0
 
 * Add new `Realtime` service with methods for subscribing to channels and receiving messages
diff --git a/README.md b/README.md
@@ -33,7 +33,7 @@ import { Client, Account } from "appwrite";
 To install with a CDN (content delivery network) add the following scripts to the bottom of your <body> tag, but before you use any Appwrite services:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/appwrite@21.3.0"></script>
+<script src="https://cdn.jsdelivr.net/npm/appwrite@21.4.0"></script>
 ```
 
 
diff --git a/docs/examples/account/list-identities.md b/docs/examples/account/list-identities.md
@@ -7,7 +7,8 @@ const client = new Client()
 const account = new Account(client);
 
 const result = await account.listIdentities({
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/account/list-logs.md b/docs/examples/account/list-logs.md
@@ -7,7 +7,8 @@ const client = new Client()
 const account = new Account(client);
 
 const result = await account.listLogs({
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/databases/create-document.md b/docs/examples/databases/create-document.md
@@ -1,4 +1,4 @@
-import { Client, Databases } from "appwrite";
+import { Client, Databases, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -17,7 +17,7 @@ const result = await databases.createDocument({
         "age": 30,
         "isAdmin": false
     },
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/databases/list-documents.md b/docs/examples/databases/list-documents.md
@@ -10,7 +10,8 @@ const result = await databases.listDocuments({
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     queries: [], // optional
-    transactionId: '<TRANSACTION_ID>' // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/databases/update-document.md b/docs/examples/databases/update-document.md
@@ -1,4 +1,4 @@
-import { Client, Databases } from "appwrite";
+import { Client, Databases, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -11,7 +11,7 @@ const result = await databases.updateDocument({
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/databases/upsert-document.md b/docs/examples/databases/upsert-document.md
@@ -1,4 +1,4 @@
-import { Client, Databases } from "appwrite";
+import { Client, Databases, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -11,7 +11,7 @@ const result = await databases.upsertDocument({
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
     data: {},
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/functions/list-executions.md b/docs/examples/functions/list-executions.md
@@ -8,7 +8,8 @@ const functions = new Functions(client);
 
 const result = await functions.listExecutions({
     functionId: '<FUNCTION_ID>',
-    queries: [] // optional
+    queries: [], // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/storage/create-file.md b/docs/examples/storage/create-file.md
@@ -1,4 +1,4 @@
-import { Client, Storage } from "appwrite";
+import { Client, Storage, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -10,7 +10,7 @@ const result = await storage.createFile({
     bucketId: '<BUCKET_ID>',
     fileId: '<FILE_ID>',
     file: document.getElementById('uploader').files[0],
-    permissions: ["read("any")"] // optional
+    permissions: [Permission.read(Role.any())] // optional
 });
 
 console.log(result);
diff --git a/docs/examples/storage/list-files.md b/docs/examples/storage/list-files.md
@@ -9,7 +9,8 @@ const storage = new Storage(client);
 const result = await storage.listFiles({
     bucketId: '<BUCKET_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/storage/update-file.md b/docs/examples/storage/update-file.md
@@ -1,4 +1,4 @@
-import { Client, Storage } from "appwrite";
+import { Client, Storage, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -10,7 +10,7 @@ const result = await storage.updateFile({
     bucketId: '<BUCKET_ID>',
     fileId: '<FILE_ID>',
     name: '<NAME>', // optional
-    permissions: ["read("any")"] // optional
+    permissions: [Permission.read(Role.any())] // optional
 });
 
 console.log(result);
diff --git a/docs/examples/tablesdb/create-row.md b/docs/examples/tablesdb/create-row.md
@@ -1,4 +1,4 @@
-import { Client, TablesDB } from "appwrite";
+import { Client, TablesDB, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -17,7 +17,7 @@ const result = await tablesDB.createRow({
         "age": 30,
         "isAdmin": false
     },
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/tablesdb/list-rows.md b/docs/examples/tablesdb/list-rows.md
@@ -10,7 +10,8 @@ const result = await tablesDB.listRows({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     queries: [], // optional
-    transactionId: '<TRANSACTION_ID>' // optional
+    transactionId: '<TRANSACTION_ID>', // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/tablesdb/update-row.md b/docs/examples/tablesdb/update-row.md
@@ -1,4 +1,4 @@
-import { Client, TablesDB } from "appwrite";
+import { Client, TablesDB, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -11,7 +11,7 @@ const result = await tablesDB.updateRow({
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/tablesdb/upsert-row.md b/docs/examples/tablesdb/upsert-row.md
@@ -1,4 +1,4 @@
-import { Client, TablesDB } from "appwrite";
+import { Client, TablesDB, Permission, Role } from "appwrite";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -11,7 +11,7 @@ const result = await tablesDB.upsertRow({
     tableId: '<TABLE_ID>',
     rowId: '<ROW_ID>',
     data: {}, // optional
-    permissions: ["read("any")"], // optional
+    permissions: [Permission.read(Role.any())], // optional
     transactionId: '<TRANSACTION_ID>' // optional
 });
 
diff --git a/docs/examples/teams/list-memberships.md b/docs/examples/teams/list-memberships.md
@@ -9,7 +9,8 @@ const teams = new Teams(client);
 const result = await teams.listMemberships({
     teamId: '<TEAM_ID>',
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/docs/examples/teams/list.md b/docs/examples/teams/list.md
@@ -8,7 +8,8 @@ const teams = new Teams(client);
 
 const result = await teams.list({
     queries: [], // optional
-    search: '<SEARCH>' // optional
+    search: '<SEARCH>', // optional
+    total: false // optional
 });
 
 console.log(result);
diff --git a/package.json b/package.json
@@ -2,7 +2,7 @@
   "name": "appwrite",
   "homepage": "https://appwrite.io/support",
   "description": "Appwrite is an open-source self-hosted backend server that abstract and simplify complex and repetitive development tasks behind a very simple REST API",
-  "version": "21.3.0",
+  "version": "21.4.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {
diff --git a/src/client.ts b/src/client.ts
@@ -320,7 +320,7 @@ class Client {
         'x-sdk-name': 'Web',
         'x-sdk-platform': 'client',
         'x-sdk-language': 'web',
-        'x-sdk-version': '21.3.0',
+        'x-sdk-version': '21.4.0',
         'X-Appwrite-Response-Format': '1.8.0',
     };
 
diff --git a/src/enums/execution-status.ts b/src/enums/execution-status.ts
@@ -3,4 +3,5 @@ export enum ExecutionStatus {
     Processing = 'processing',
     Completed = 'completed',
     Failed = 'failed',
+    Scheduled = 'scheduled',
 }
diff --git a/src/index.ts b/src/index.ts
@@ -22,6 +22,7 @@ export type { QueryTypes, QueryTypesList } from './query';
 export { Permission } from './permission';
 export { Role } from './role';
 export { ID } from './id';
+export { Operator, Condition } from './operator';
 export { AuthenticatorType } from './enums/authenticator-type';
 export { AuthenticationFactor } from './enums/authentication-factor';
 export { OAuthProvider } from './enums/o-auth-provider';
@@ -31,3 +32,5 @@ export { Flag } from './enums/flag';
 export { ExecutionMethod } from './enums/execution-method';
 export { ImageGravity } from './enums/image-gravity';
 export { ImageFormat } from './enums/image-format';
+export { ExecutionTrigger } from './enums/execution-trigger';
+export { ExecutionStatus } from './enums/execution-status';
diff --git a/src/models.ts b/src/models.ts
@@ -1030,7 +1030,7 @@ export namespace Models {
          */
         trigger: ExecutionTrigger;
         /**
-         * The status of the function execution. Possible values can be: `waiting`, `processing`, `completed`, or `failed`.
+         * The status of the function execution. Possible values can be: `waiting`, `processing`, `completed`, `failed`, or `scheduled`.
          */
         status: ExecutionStatus;
         /**
diff --git a/src/operator.ts b/src/operator.ts
diff --git a/src/query.ts b/src/query.ts
diff --git a/src/services/account.ts b/src/services/account.ts
diff --git a/src/services/databases.ts b/src/services/databases.ts
diff --git a/src/services/functions.ts b/src/services/functions.ts
diff --git a/src/services/storage.ts b/src/services/storage.ts
diff --git a/src/services/tables-db.ts b/src/services/tables-db.ts
diff --git a/src/services/teams.ts b/src/services/teams.ts
