@appwrite.io/console 2.1.1 → 2.1.3

package/docs/examples/domains/list-suggestions.md

@@ -0,0 +1,18 @@
+import { Client, Domains, FilterType } 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 domains = new Domains(client);
+
+const result = await domains.listSuggestions({
+    query: '<QUERY>',
+    tlds: [], // optional
+    limit: null, // optional
+    filterType: FilterType.Premium, // optional
+    priceMax: null, // optional
+    priceMin: null // optional
+});
+
+console.log(result);

package/docs/examples/health/get-queue-audits.md

@@ -0,0 +1,13 @@
+import { Client, Health } 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 health = new Health(client);
+
+const result = await health.getQueueAudits({
+    threshold: null // optional
+});
+
+console.log(result);

package/docs/examples/organizations/create.md

@@ -1,4 +1,4 @@
-import { Client, Organizations, Platform } from "@appwrite.io/console";
+import { Client, Organizations, BillingPlan, Platform } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -9,7 +9,7 @@ const organizations = new Organizations(client);
 const result = await organizations.create({
     organizationId: '<ORGANIZATION_ID>',
     name: '<NAME>',
-    billingPlan: 'tier-0',
+    billingPlan: BillingPlan.Tier0,
     paymentMethodId: '<PAYMENT_METHOD_ID>', // optional
     billingAddressId: '<BILLING_ADDRESS_ID>', // optional
     invites: [], // optional

package/docs/examples/organizations/estimation-create-organization.md

@@ -1,4 +1,4 @@
-import { Client, Organizations, Platform } from "@appwrite.io/console";
+import { Client, Organizations, BillingPlan, Platform } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -7,7 +7,7 @@ const client = new Client()
 const organizations = new Organizations(client);
 
 const result = await organizations.estimationCreateOrganization({
-    billingPlan: 'tier-0',
+    billingPlan: BillingPlan.Tier0,
     paymentMethodId: '<PAYMENT_METHOD_ID>', // optional
     invites: [], // optional
     couponId: '<COUPON_ID>', // optional

package/docs/examples/organizations/estimation-update-plan.md

@@ -1,4 +1,4 @@
-import { Client, Organizations } from "@appwrite.io/console";
+import { Client, Organizations, BillingPlan } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const organizations = new Organizations(client);
 
 const result = await organizations.estimationUpdatePlan({
     organizationId: '<ORGANIZATION_ID>',
-    billingPlan: 'tier-0',
+    billingPlan: BillingPlan.Tier0,
     invites: [], // optional
     couponId: '<COUPON_ID>' // optional
 });

package/docs/examples/organizations/update-plan.md

@@ -1,4 +1,4 @@
-import { Client, Organizations } from "@appwrite.io/console";
+import { Client, Organizations, BillingPlan } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const organizations = new Organizations(client);
 
 const result = await organizations.updatePlan({
     organizationId: '<ORGANIZATION_ID>',
-    billingPlan: 'tier-0',
+    billingPlan: BillingPlan.Tier0,
     paymentMethodId: '<PAYMENT_METHOD_ID>', // optional
     billingAddressId: '<BILLING_ADDRESS_ID>', // optional
     invites: [], // optional

package/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": "2.1.1",
+  "version": "2.1.3",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {
@@ -25,7 +25,8 @@
     "build:libs": "rollup -c"
   },
   "dependencies": {
-    "json-bigint": "1.0.0"
+    "json-bigint": "1.0.0",
+    "bignumber.js": "9.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "22.0.0",

package/src/channel.ts

@@ -0,0 +1,134 @@
+interface Root {}
+interface Database { _db: any }
+interface Collection { _coll: any }
+interface Document { _doc: any }
+interface TablesDB { _tdb: any }
+interface Table { _tbl: any }
+interface Row { _row: any }
+interface Bucket { _bkt: any }
+interface File { _file: any }
+interface Func { _fn: any }
+interface Execution { _exec: any }
+interface Team { _team: any }
+interface Membership { _mem: any }
+interface Resolved { _res: any }
+
+type Actionable = Document | Row | File | Execution | Team | Membership;
+
+function normalize(id: string): string {
+  const trimmed = id.trim();
+  return trimmed === "" ? "*" : trimmed;
+}
+
+export class Channel<T> {
+  declare _type: T;
+
+  private constructor(private readonly segments: string[]) {}
+
+  private next<N>(segment: string, id: string = "*"): Channel<N> {
+    return new Channel<N>([...this.segments, segment, normalize(id)]) as any;
+  }
+
+  private resolve(action: string): Channel<Resolved> {
+    return new Channel<Resolved>([...this.segments, action]) as any;
+  }
+
+  toString(): string {
+    return this.segments.join(".");
+  }
+
+  // --- DATABASE ROUTE ---
+  // Only available on Channel<Database>
+  collection(this: Channel<Database>, id: string = "*"): Channel<Collection> {
+    return this.next<Collection>("collections", id);
+  }
+
+  // Only available on Channel<Collection>
+  document(this: Channel<Collection>, id: string = "*"): Channel<Document> {
+    return this.next<Document>("documents", id);
+  }
+
+  // --- TABLESDB ROUTE ---
+  table(this: Channel<TablesDB>, id: string = "*"): Channel<Table> {
+    return this.next<Table>("tables", id);
+  }
+
+  row(this: Channel<Table>, id: string = "*"): Channel<Row> {
+    return this.next<Row>("rows", id);
+  }
+
+  // --- BUCKET ROUTE ---
+  file(this: Channel<Bucket>, id: string = "*"): Channel<File> {
+    return this.next<File>("files", id);
+  }
+
+  // --- FUNCTION ROUTE ---
+  execution(this: Channel<Func>, id: string = "*"): Channel<Execution> {
+    return this.next<Execution>("executions", id);
+  }
+
+  // --- TERMINAL ACTIONS ---
+  // Restricted to the Actionable union
+  create(this: Channel<Actionable>): Channel<Resolved> {
+    return this.resolve("create");
+  }
+
+  update(this: Channel<Actionable>): Channel<Resolved> {
+    return this.resolve("update");
+  }
+
+  delete(this: Channel<Actionable>): Channel<Resolved> {
+    return this.resolve("delete");
+  }
+
+  // --- ROOT FACTORIES ---
+  static database(id: string = "*") {
+    return new Channel<Database>(["databases", normalize(id)]);
+  }
+
+  static tablesdb(id: string = "*") {
+    return new Channel<TablesDB>(["tablesdb", normalize(id)]);
+  }
+
+  static bucket(id: string = "*") {
+    return new Channel<Bucket>(["buckets", normalize(id)]);
+  }
+
+  static function(id: string = "*") {
+    return new Channel<Func>(["functions", normalize(id)]);
+  }
+
+  static team(id: string = "*") {
+    return new Channel<Team>(["teams", normalize(id)]);
+  }
+
+  static membership(id: string = "*") {
+    return new Channel<Membership>(["memberships", normalize(id)]);
+  }
+
+  static account(userId: string = ""): string {
+    const id = normalize(userId);
+    return id === "*" ? "account" : `account.${id}`;
+  }
+
+  // Global events
+  static get documents(): string {
+    return "documents";
+  }
+
+  static get rows(): string {
+    return "rows";
+  }
+
+  static get files(): string {
+    return "files";
+  }
+
+  static get executions(): string {
+    return "executions";
+  }
+}
+
+// Export types for backward compatibility with realtime
+export type ActionableChannel = Channel<Document> | Channel<Row> | Channel<File> | Channel<Execution> | Channel<Team> | Channel<Membership>;
+export type ResolvedChannel = Channel<Resolved>;

package/src/client.ts

@@ -1,6 +1,57 @@
 import { Models } from './models';
+import { Channel, ActionableChannel, ResolvedChannel } from './channel';
 import JSONbigModule from 'json-bigint';
-const JSONbig = JSONbigModule({ useNativeBigInt: true });
+import BigNumber from 'bignumber.js';
+const JSONbigParser = JSONbigModule({ storeAsString: false });
+const JSONbigSerializer = JSONbigModule({ useNativeBigInt: true });
+
+/**
+ * Converts BigNumber objects from json-bigint to native types.
+ * - Integer BigNumbers → BigInt (if unsafe) or number (if safe)
+ * - Float BigNumbers → number
+ * - Strings remain strings (never converted to BigNumber by json-bigint)
+ */
+const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+const MIN_SAFE = BigInt(Number.MIN_SAFE_INTEGER);
+
+function convertBigNumbers(value: any): any {
+    if (value === null || value === undefined) return value;
+
+    if (Array.isArray(value)) {
+        return value.map(convertBigNumbers);
+    }
+
+    if (BigNumber.isBigNumber(value)) {
+        if (value.isInteger()) {
+            const str = value.toFixed();
+            const bi = BigInt(str);
+
+            if (bi >= MIN_SAFE && bi <= MAX_SAFE) {
+                return Number(str);
+            }
+
+            return bi;
+        }
+
+        // float
+        return value.toNumber();
+    }
+
+    if (typeof value === 'object') {
+        const result: any = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = convertBigNumbers(v);
+        }
+        return result;
+    }
+
+    return value;
+}
+
+const JSONbig = {
+    parse: (text: string) => convertBigNumbers(JSONbigParser.parse(text)),
+    stringify: JSONbigSerializer.stringify
+};
 
 /**
  * Payload type representing a key-value pair with string keys and any values.
@@ -334,7 +385,7 @@ class Client {
         'x-sdk-name': 'Console',
         'x-sdk-platform': 'console',
         'x-sdk-language': 'web',
-        'x-sdk-version': '2.1.1',
+        'x-sdk-version': '2.1.3',
         'X-Appwrite-Response-Format': '1.8.0',
     };
 
@@ -654,8 +705,8 @@ class Client {
      * @deprecated Use the Realtime service instead.
      * @see Realtime
      *
-     * @param {string|string[]} channels
-     * Channel to subscribe - pass a single channel as a string or multiple with an array of strings.
+     * @param {string|string[]|Channel<any>|ActionableChannel|ResolvedChannel|(Channel<any>|ActionableChannel|ResolvedChannel)[]} channels
+     * Channel to subscribe - pass a single channel as a string or Channel builder instance, or multiple with an array.
      *
      * Possible channels are:
      * - account
@@ -673,16 +724,35 @@ class Client {
      * - teams.[ID]
      * - memberships
      * - memberships.[ID]
+     * 
+     * You can also use Channel builders:
+     * - Channel.database('db').collection('col').document('doc').create()
+     * - Channel.bucket('bucket').file('file').update()
+     * - Channel.function('func').execution('exec').delete()
+     * - Channel.team('team').create()
+     * - Channel.membership('membership').update()
      * @param {(payload: RealtimeMessage) => void} callback Is called on every realtime update.
      * @returns {() => void} Unsubscribes from events.
      */
-    subscribe<T extends unknown>(channels: string | string[], callback: (payload: RealtimeResponseEvent<T>) => void): () => void {
-        let channelArray = typeof channels === 'string' ? [channels] : channels;
-        channelArray.forEach(channel => this.realtime.channels.add(channel));
+    subscribe<T extends unknown>(channels: string | string[] | Channel<any> | ActionableChannel | ResolvedChannel | (Channel<any> | ActionableChannel | ResolvedChannel)[], callback: (payload: RealtimeResponseEvent<T>) => void): () => void {
+        const channelArray = Array.isArray(channels) ? channels : [channels];
+        // Convert Channel instances to strings
+        const channelStrings = channelArray.map(ch => {
+            if (typeof ch === 'string') {
+                return ch;
+            }
+            // All Channel instances have toString() method
+            if (ch && typeof (ch as Channel<any>).toString === 'function') {
+                return (ch as Channel<any>).toString();
+            }
+            // Fallback to generic string conversion
+            return String(ch);
+        });
+        channelStrings.forEach(channel => this.realtime.channels.add(channel));
 
         const counter = this.realtime.subscriptionsCounter++;
         this.realtime.subscriptions.set(counter, {
-            channels: channelArray,
+            channels: channelStrings,
             callback
         });
 
@@ -690,7 +760,7 @@ class Client {
 
         return () => {
             this.realtime.subscriptions.delete(counter);
-            this.realtime.cleanUp(channelArray);
+            this.realtime.cleanUp(channelStrings);
             this.realtime.connect();
         }
     }

package/src/enums/billing-plan.ts

@@ -0,0 +1,17 @@
+export enum BillingPlan {
+    Tier0 = 'tier-0',
+    Tier1 = 'tier-1',
+    Tier2 = 'tier-2',
+    Imaginetier0 = 'imagine-tier-0',
+    Imaginetier1 = 'imagine-tier-1',
+    Imaginetier150 = 'imagine-tier-1-50',
+    Imaginetier1100 = 'imagine-tier-1-100',
+    Imaginetier1200 = 'imagine-tier-1-200',
+    Imaginetier1290 = 'imagine-tier-1-290',
+    Imaginetier1480 = 'imagine-tier-1-480',
+    Imaginetier1700 = 'imagine-tier-1-700',
+    Imaginetier1900 = 'imagine-tier-1-900',
+    Imaginetier11100 = 'imagine-tier-1-1100',
+    Imaginetier11650 = 'imagine-tier-1-1650',
+    Imaginetier12200 = 'imagine-tier-1-2200',
+}

package/src/enums/filter-type.ts

@@ -0,0 +1,4 @@
+export enum FilterType {
+    Premium = 'premium',
+    Suggestion = 'suggestion',
+}

package/src/enums/name.ts

@@ -9,6 +9,7 @@ export enum Name {
     V1webhooks = 'v1-webhooks',
     V1certificates = 'v1-certificates',
     V1builds = 'v1-builds',
+    V1screenshots = 'v1-screenshots',
     V1messaging = 'v1-messaging',
     V1migrations = 'v1-migrations',
 }

package/src/enums/o-auth-provider.ts

@@ -38,8 +38,6 @@ export enum OAuthProvider {
     Yandex = 'yandex',
     Zoho = 'zoho',
     Zoom = 'zoom',
-    Mock = 'mock',
-    Mockunverified = 'mock-unverified',
     GithubImagine = 'githubImagine',
     GoogleImagine = 'googleImagine',
 }

package/src/index.ts

@@ -36,6 +36,7 @@ export type { QueryTypes, QueryTypesList } from './query';
 export { Permission } from './permission';
 export { Role } from './role';
 export { ID } from './id';
+export { Channel } from './channel';
 export { Operator, Condition } from './operator';
 export { AuthenticatorType } from './enums/authenticator-type';
 export { AuthenticationFactor } from './enums/authentication-factor';
@@ -52,6 +53,7 @@ export { UsageRange } from './enums/usage-range';
 export { RelationshipType } from './enums/relationship-type';
 export { RelationMutate } from './enums/relation-mutate';
 export { IndexType } from './enums/index-type';
+export { FilterType } from './enums/filter-type';
 export { Runtime } from './enums/runtime';
 export { TemplateReferenceType } from './enums/template-reference-type';
 export { VCSReferenceType } from './enums/vcs-reference-type';
@@ -60,6 +62,7 @@ export { ExecutionMethod } from './enums/execution-method';
 export { Name } from './enums/name';
 export { MessagePriority } from './enums/message-priority';
 export { SmtpEncryption } from './enums/smtp-encryption';
+export { BillingPlan } from './enums/billing-plan';
 export { ProjectUsageRange } from './enums/project-usage-range';
 export { Region } from './enums/region';
 export { Api } from './enums/api';