feat: SDK update for version 12.1.0 (#89)

ChiragAgg5k · web-flow · commit 0da2748b3a04 · 2026-05-06T15:06:10.000+05:30
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Use Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v6
       with:
         node-version: '24.14.1'
         registry-url: 'https://registry.npmjs.org'
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Change Log
 
+## 12.1.0
+
+* Added: `setSession` method on `Client` for `X-Appwrite-Session` authentication
+* Added: `setDevKey` method on `Client` for `X-Appwrite-Dev-Key` authentication
+* Added: `suggestQueries` method on `Console` service
+* Added: `QuerySuggestionResource` enum for supported list resource types
+* Added: `project.policies.read`, `project.policies.write`, `backups.policies.read`, `backups.policies.write` scopes
+* Updated: `setCookie` documentation clarified for server-side runtimes
+
 ## 12.0.0
 
 * Breaking: Renamed `AuthMethod` enum to `MethodId`
diff --git a/README.md b/README.md
@@ -33,7 +33,7 @@ import { Client, Account } from "@appwrite.io/console";
 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.io/console@12.0.0"></script>
+<script src="https://cdn.jsdelivr.net/npm/@appwrite.io/console@12.1.0"></script>
 ```
 
 
diff --git a/docs/examples/console/create-program-membership.md b/docs/examples/console/create-program-membership.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.createProgramMembership({
+const result = await xconsole.createProgramMembership({
     programId: '<PROGRAM_ID>'
 });
 
diff --git a/docs/examples/console/create-source.md b/docs/examples/console/create-source.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.createSource({
+const result = await xconsole.createSource({
     ref: '<REF>', // optional
     referrer: 'https://example.com', // optional
     utmSource: '<UTM_SOURCE>', // optional
diff --git a/docs/examples/console/get-campaign.md b/docs/examples/console/get-campaign.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getCampaign({
+const result = await xconsole.getCampaign({
     campaignId: '<CAMPAIGN_ID>'
 });
 
diff --git a/docs/examples/console/get-coupon.md b/docs/examples/console/get-coupon.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getCoupon({
+const result = await xconsole.getCoupon({
     couponId: '<COUPON_ID>'
 });
 
diff --git a/docs/examples/console/get-plan.md b/docs/examples/console/get-plan.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getPlan({
+const result = await xconsole.getPlan({
     planId: '<PLAN_ID>'
 });
 
diff --git a/docs/examples/console/get-plans.md b/docs/examples/console/get-plans.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getPlans({
+const result = await xconsole.getPlans({
     platform: Platform.Appwrite // optional
 });
 
diff --git a/docs/examples/console/get-program.md b/docs/examples/console/get-program.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getProgram({
+const result = await xconsole.getProgram({
     programId: '<PROGRAM_ID>'
 });
 
diff --git a/docs/examples/console/get-resource.md b/docs/examples/console/get-resource.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.getResource({
+const result = await xconsole.getResource({
     value: '<VALUE>',
     type: ConsoleResourceType.Rules
 });
diff --git a/docs/examples/console/list-o-auth-2-providers.md b/docs/examples/console/list-o-auth-2-providers.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.listOAuth2Providers();
+const result = await xconsole.listOAuth2Providers();
 
 console.log(result);
 ```
diff --git a/docs/examples/console/list-project-scopes.md b/docs/examples/console/list-project-scopes.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.listProjectScopes();
+const result = await xconsole.listProjectScopes();
 
 console.log(result);
 ```
diff --git a/docs/examples/console/list-regions.md b/docs/examples/console/list-regions.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.listRegions();
+const result = await xconsole.listRegions();
 
 console.log(result);
 ```
diff --git a/docs/examples/console/suggest-columns.md b/docs/examples/console/suggest-columns.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.suggestColumns({
+const result = await xconsole.suggestColumns({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     context: '<CONTEXT>', // optional
diff --git a/docs/examples/console/suggest-indexes.md b/docs/examples/console/suggest-indexes.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.suggestIndexes({
+const result = await xconsole.suggestIndexes({
     databaseId: '<DATABASE_ID>',
     tableId: '<TABLE_ID>',
     min: 1, // optional
diff --git a/docs/examples/console/suggest-queries.md b/docs/examples/console/suggest-queries.md
@@ -0,0 +1,18 @@
+```javascript
+import { Client, Console, QuerySuggestionResource } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const xconsole = new Console(client);
+
+const result = await xconsole.suggestQueries({
+    resource: QuerySuggestionResource.Activities,
+    input: '<INPUT>',
+    databaseId: '<DATABASE_ID>', // optional
+    tableId: '<TABLE_ID>' // optional
+});
+
+console.log(result);
+```
diff --git a/docs/examples/console/variables.md b/docs/examples/console/variables.md
@@ -5,9 +5,9 @@ const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
     .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
-const console = new Console(client);
+const xconsole = new Console(client);
 
-const result = await console.variables();
+const result = await xconsole.variables();
 
 console.log(result);
 ```
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -2,7 +2,7 @@
   "name": "@appwrite.io/console",
   "homepage": "https://appwrite.io/support",
   "description": "Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API",
-  "version": "12.0.0",
+  "version": "12.1.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {
diff --git a/src/client.ts b/src/client.ts
@@ -359,12 +359,13 @@ class Client {
         locale: string;
         mode: string;
         cookie: string;
+        session: string;
+        devkey: string;
         impersonateuserid: string;
         impersonateuseremail: string;
         impersonateuserphone: string;
         platform: string;
         selfSigned: boolean;
-        session?: string;
     } = {
         endpoint: 'https://cloud.appwrite.io/v1',
         endpointRealtime: '',
@@ -374,12 +375,13 @@ class Client {
         locale: '',
         mode: '',
         cookie: '',
+        session: '',
+        devkey: '',
         impersonateuserid: '',
         impersonateuseremail: '',
         impersonateuserphone: '',
         platform: '',
         selfSigned: false,
-        session: undefined,
     };
     /**
      * Custom headers for API requests.
@@ -388,7 +390,7 @@ class Client {
         'x-sdk-name': 'Console',
         'x-sdk-platform': 'console',
         'x-sdk-language': 'web',
-        'x-sdk-version': '12.0.0',
+        'x-sdk-version': '12.1.0',
         'X-Appwrite-Response-Format': '1.9.3',
     };
 
@@ -529,7 +531,7 @@ class Client {
     /**
      * Set Cookie
      *
-     * The user cookie to authenticate with
+     * The user cookie to authenticate with. Used by SDKs that forward an incoming Cookie header in server-side runtimes.
      *
      * @param value string
      *
@@ -540,6 +542,34 @@ class Client {
         this.config.cookie = value;
         return this;
     }
+    /**
+     * Set Session
+     *
+     * The user session to authenticate with
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setSession(value: string): this {
+        this.headers['X-Appwrite-Session'] = value;
+        this.config.session = value;
+        return this;
+    }
+    /**
+     * Set DevKey
+     *
+     * Your secret dev API key
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setDevKey(value: string): this {
+        this.headers['X-Appwrite-Dev-Key'] = value;
+        this.config.devkey = value;
+        return this;
+    }
     /**
      * Set ImpersonateUserId
      *
diff --git a/src/enums/query-suggestion-resource.ts b/src/enums/query-suggestion-resource.ts
diff --git a/src/enums/scopes.ts b/src/enums/scopes.ts
diff --git a/src/index.ts b/src/index.ts
diff --git a/src/services/console.ts b/src/services/console.ts
