@appwrite.io/console 2.1.2 → 2.1.3

package/dist/esm/sdk.js

@@ -1,4 +1,5 @@
 import JSONbigModule from 'json-bigint';
+import BigNumber from 'bignumber.js';
 
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -84,6 +85,14 @@ Query.equal = (attribute, value) => new Query("equal", attribute, value).toStrin
  * @returns {string}
  */
 Query.notEqual = (attribute, value) => new Query("notEqual", attribute, value).toString();
+/**
+ * Filter resources where attribute matches a regular expression pattern.
+ *
+ * @param {string} attribute The attribute to filter on.
+ * @param {string} pattern The regular expression pattern to match.
+ * @returns {string}
+ */
+Query.regex = (attribute, pattern) => new Query("regex", attribute, pattern).toString();
 /**
  * Filter resources where attribute is less than value.
  *
@@ -130,6 +139,20 @@ Query.isNull = (attribute) => new Query("isNull", attribute).toString();
  * @returns {string}
  */
 Query.isNotNull = (attribute) => new Query("isNotNull", attribute).toString();
+/**
+ * Filter resources where the specified attributes exist.
+ *
+ * @param {string[]} attributes The list of attributes that must exist.
+ * @returns {string}
+ */
+Query.exists = (attributes) => new Query("exists", undefined, attributes).toString();
+/**
+ * Filter resources where the specified attributes do not exist.
+ *
+ * @param {string[]} attributes The list of attributes that must not exist.
+ * @returns {string}
+ */
+Query.notExists = (attributes) => new Query("notExists", undefined, attributes).toString();
 /**
  * Filter resources where attribute is between start and end (inclusive).
  *
@@ -327,6 +350,14 @@ Query.or = (queries) => new Query("or", undefined, queries.map((query) => JSONbi
  * @returns {string}
  */
 Query.and = (queries) => new Query("and", undefined, queries.map((query) => JSONbig$1.parse(query))).toString();
+/**
+ * Filter array elements where at least one element matches all the specified queries.
+ *
+ * @param {string} attribute The attribute containing the array to filter on.
+ * @param {string[]} queries The list of query strings to match against array elements.
+ * @returns {string}
+ */
+Query.elemMatch = (attribute, queries) => new Query("elemMatch", attribute, queries.map((query) => JSONbig$1.parse(query))).toString();
 /**
  * Filter resources where attribute is at a specific distance from the given coordinates.
  *
@@ -432,7 +463,47 @@ Query.touches = (attribute, values) => new Query("touches", attribute, [values])
  */
 Query.notTouches = (attribute, values) => new Query("notTouches", attribute, [values]).toString();
 
-const JSONbig = JSONbigModule({ useNativeBigInt: true });
+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) {
+    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 = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = convertBigNumbers(v);
+        }
+        return result;
+    }
+    return value;
+}
+const JSONbig = {
+    parse: (text) => convertBigNumbers(JSONbigParser.parse(text)),
+    stringify: JSONbigSerializer.stringify
+};
 /**
  * Exception thrown by the  package
  */
@@ -482,7 +553,7 @@ class Client {
             'x-sdk-name': 'Console',
             'x-sdk-platform': 'console',
             'x-sdk-language': 'web',
-            'x-sdk-version': '2.1.2',
+            'x-sdk-version': '2.1.3',
             'X-Appwrite-Response-Format': '1.8.0',
         };
         this.realtime = {
@@ -784,8 +855,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
@@ -803,21 +874,40 @@ 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(channels, callback) {
-        let channelArray = typeof channels === 'string' ? [channels] : channels;
-        channelArray.forEach(channel => this.realtime.channels.add(channel));
+        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.toString === 'function') {
+                return ch.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
         });
         this.realtime.connect();
         return () => {
             this.realtime.subscriptions.delete(counter);
-            this.realtime.cleanUp(channelArray);
+            this.realtime.cleanUp(channelStrings);
             this.realtime.connect();
         };
     }
@@ -24917,11 +25007,31 @@ class Realtime {
     sleep(ms) {
         return new Promise(resolve => setTimeout(resolve, ms));
     }
+    /**
+     * Convert a channel value to a string
+     *
+     * @private
+     * @param {string | Channel<any> | ActionableChannel | ResolvedChannel} channel - Channel value (string or Channel builder instance)
+     * @returns {string} Channel string representation
+     */
+    channelToString(channel) {
+        if (typeof channel === 'string') {
+            return channel;
+        }
+        // All Channel instances have toString() method
+        if (channel && typeof channel.toString === 'function') {
+            return channel.toString();
+        }
+        return String(channel);
+    }
     subscribe(channelsOrChannel, callback) {
         return __awaiter(this, void 0, void 0, function* () {
-            const channels = Array.isArray(channelsOrChannel)
-                ? new Set(channelsOrChannel)
-                : new Set([channelsOrChannel]);
+            const channelArray = Array.isArray(channelsOrChannel)
+                ? channelsOrChannel
+                : [channelsOrChannel];
+            // Convert all channels to strings
+            const channelStrings = channelArray.map(ch => this.channelToString(ch));
+            const channels = new Set(channelStrings);
             this.subscriptionsCounter++;
             const count = this.subscriptionsCounter;
             for (const channel of channels) {
@@ -25225,6 +25335,96 @@ _a = ID, _ID_hexTimestamp = function _ID_hexTimestamp() {
     return hexTimestamp;
 };
 
+function normalize(id) {
+    const trimmed = id.trim();
+    return trimmed === "" ? "*" : trimmed;
+}
+class Channel {
+    constructor(segments) {
+        this.segments = segments;
+    }
+    next(segment, id = "*") {
+        return new Channel([...this.segments, segment, normalize(id)]);
+    }
+    resolve(action) {
+        return new Channel([...this.segments, action]);
+    }
+    toString() {
+        return this.segments.join(".");
+    }
+    // --- DATABASE ROUTE ---
+    // Only available on Channel<Database>
+    collection(id = "*") {
+        return this.next("collections", id);
+    }
+    // Only available on Channel<Collection>
+    document(id = "*") {
+        return this.next("documents", id);
+    }
+    // --- TABLESDB ROUTE ---
+    table(id = "*") {
+        return this.next("tables", id);
+    }
+    row(id = "*") {
+        return this.next("rows", id);
+    }
+    // --- BUCKET ROUTE ---
+    file(id = "*") {
+        return this.next("files", id);
+    }
+    // --- FUNCTION ROUTE ---
+    execution(id = "*") {
+        return this.next("executions", id);
+    }
+    // --- TERMINAL ACTIONS ---
+    // Restricted to the Actionable union
+    create() {
+        return this.resolve("create");
+    }
+    update() {
+        return this.resolve("update");
+    }
+    delete() {
+        return this.resolve("delete");
+    }
+    // --- ROOT FACTORIES ---
+    static database(id = "*") {
+        return new Channel(["databases", normalize(id)]);
+    }
+    static tablesdb(id = "*") {
+        return new Channel(["tablesdb", normalize(id)]);
+    }
+    static bucket(id = "*") {
+        return new Channel(["buckets", normalize(id)]);
+    }
+    static function(id = "*") {
+        return new Channel(["functions", normalize(id)]);
+    }
+    static team(id = "*") {
+        return new Channel(["teams", normalize(id)]);
+    }
+    static membership(id = "*") {
+        return new Channel(["memberships", normalize(id)]);
+    }
+    static account(userId = "") {
+        const id = normalize(userId);
+        return id === "*" ? "account" : `account.${id}`;
+    }
+    // Global events
+    static get documents() {
+        return "documents";
+    }
+    static get rows() {
+        return "rows";
+    }
+    static get files() {
+        return "files";
+    }
+    static get executions() {
+        return "executions";
+    }
+}
+
 var Condition;
 (function (Condition) {
     Condition["Equal"] = "equal";
@@ -27048,5 +27248,5 @@ var BillingPlanGroup;
     BillingPlanGroup["Scale"] = "scale";
 })(BillingPlanGroup || (BillingPlanGroup = {}));
 
-export { Account, Adapter, Api, ApiService, AppwriteException, Assistant, AttributeStatus, AuthMethod, AuthenticationFactor, AuthenticatorType, Avatars, Backups, BillingPlan, BillingPlanGroup, Browser, BuildRuntime, Client, ColumnStatus, Compression, Condition, Console, ConsoleResourceType, CreditCard, DatabaseType, Databases, DeploymentDownloadType, DeploymentStatus, Domains, EmailTemplateLocale, EmailTemplateType, ExecutionMethod, ExecutionStatus, ExecutionTrigger, FilterType, Flag, Framework, Functions, Graphql, Health, HealthAntivirusStatus, HealthCheckStatus, ID, ImageFormat, ImageGravity, IndexStatus, IndexType, Locale, MessagePriority, MessageStatus, Messaging, MessagingProviderType, Migrations, Name, OAuthProvider, Operator, Organizations, PasswordHash, Permission, Platform, PlatformType, Project, ProjectUsageRange, Projects, Proxy, ProxyResourceType, ProxyRuleDeploymentResourceType, ProxyRuleStatus, Query, Realtime, Region, RelationMutate, RelationshipType, Role, Runtime, SMTPSecure, Sites, SmsTemplateLocale, SmsTemplateType, SmtpEncryption, Status, StatusCode, Storage, TablesDB, Teams, TemplateReferenceType, Theme, Timezone, Tokens, UsageRange, Users, VCSDetectionType, VCSReferenceType, Vcs };
+export { Account, Adapter, Api, ApiService, AppwriteException, Assistant, AttributeStatus, AuthMethod, AuthenticationFactor, AuthenticatorType, Avatars, Backups, BillingPlan, BillingPlanGroup, Browser, BuildRuntime, Channel, Client, ColumnStatus, Compression, Condition, Console, ConsoleResourceType, CreditCard, DatabaseType, Databases, DeploymentDownloadType, DeploymentStatus, Domains, EmailTemplateLocale, EmailTemplateType, ExecutionMethod, ExecutionStatus, ExecutionTrigger, FilterType, Flag, Framework, Functions, Graphql, Health, HealthAntivirusStatus, HealthCheckStatus, ID, ImageFormat, ImageGravity, IndexStatus, IndexType, Locale, MessagePriority, MessageStatus, Messaging, MessagingProviderType, Migrations, Name, OAuthProvider, Operator, Organizations, PasswordHash, Permission, Platform, PlatformType, Project, ProjectUsageRange, Projects, Proxy, ProxyResourceType, ProxyRuleDeploymentResourceType, ProxyRuleStatus, Query, Realtime, Region, RelationMutate, RelationshipType, Role, Runtime, SMTPSecure, Sites, SmsTemplateLocale, SmsTemplateType, SmtpEncryption, Status, StatusCode, Storage, TablesDB, Teams, TemplateReferenceType, Theme, Timezone, Tokens, UsageRange, Users, VCSDetectionType, VCSReferenceType, Vcs };
 //# sourceMappingURL=sdk.js.map