@appwrite.io/console 0.6.1 → 0.6.4

package/dist/iife/sdk.js

@@ -1,4 +1,4 @@
-(function (exports, isomorphicFormData, crossFetch) {
+(function (exports) {
     'use strict';
 
     /******************************************************************************
@@ -50,9 +50,22 @@
             return output;
         }
     }
+    /**
+     * The size for chunked uploads in bytes.
+     */
     Service.CHUNK_SIZE = 5 * 1024 * 1024; // 5MB
 
+    /**
+     * Helper class to generate query strings.
+     */
     class Query {
+        /**
+         * Constructor for Query class.
+         *
+         * @param {string} method
+         * @param {AttributesTypes} attribute
+         * @param {QueryTypes} values
+         */
         constructor(method, attribute, values) {
             this.method = method;
             this.attribute = attribute;
@@ -65,6 +78,11 @@
                 }
             }
         }
+        /**
+         * Convert the query object to a JSON string.
+         *
+         * @returns {string}
+         */
         toString() {
             return JSON.stringify({
                 method: this.method,
@@ -73,30 +91,186 @@
             });
         }
     }
+    /**
+     * Filter resources where attribute is equal to value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.equal = (attribute, value) => new Query("equal", attribute, value).toString();
+    /**
+     * Filter resources where attribute is not equal to value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.notEqual = (attribute, value) => new Query("notEqual", attribute, value).toString();
+    /**
+     * Filter resources where attribute is less than value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.lessThan = (attribute, value) => new Query("lessThan", attribute, value).toString();
+    /**
+     * Filter resources where attribute is less than or equal to value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.lessThanEqual = (attribute, value) => new Query("lessThanEqual", attribute, value).toString();
+    /**
+     * Filter resources where attribute is greater than value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.greaterThan = (attribute, value) => new Query("greaterThan", attribute, value).toString();
+    /**
+     * Filter resources where attribute is greater than or equal to value.
+     *
+     * @param {string} attribute
+     * @param {QueryTypes} value
+     * @returns {string}
+     */
     Query.greaterThanEqual = (attribute, value) => new Query("greaterThanEqual", attribute, value).toString();
+    /**
+     * Filter resources where attribute is null.
+     *
+     * @param {string} attribute
+     * @returns {string}
+     */
     Query.isNull = (attribute) => new Query("isNull", attribute).toString();
+    /**
+     * Filter resources where attribute is not null.
+     *
+     * @param {string} attribute
+     * @returns {string}
+     */
     Query.isNotNull = (attribute) => new Query("isNotNull", attribute).toString();
+    /**
+     * Filter resources where attribute is between start and end (inclusive).
+     *
+     * @param {string} attribute
+     * @param {string | number} start
+     * @param {string | number} end
+     * @returns {string}
+     */
     Query.between = (attribute, start, end) => new Query("between", attribute, [start, end]).toString();
+    /**
+     * Filter resources where attribute starts with value.
+     *
+     * @param {string} attribute
+     * @param {string} value
+     * @returns {string}
+     */
     Query.startsWith = (attribute, value) => new Query("startsWith", attribute, value).toString();
+    /**
+     * Filter resources where attribute ends with value.
+     *
+     * @param {string} attribute
+     * @param {string} value
+     * @returns {string}
+     */
     Query.endsWith = (attribute, value) => new Query("endsWith", attribute, value).toString();
+    /**
+     * Specify which attributes should be returned by the API call.
+     *
+     * @param {string[]} attributes
+     * @returns {string}
+     */
     Query.select = (attributes) => new Query("select", undefined, attributes).toString();
+    /**
+     * Filter resources by searching attribute for value.
+     * A fulltext index on attribute is required for this query to work.
+     *
+     * @param {string} attribute
+     * @param {string} value
+     * @returns {string}
+     */
     Query.search = (attribute, value) => new Query("search", attribute, value).toString();
+    /**
+     * Sort results by attribute descending.
+     *
+     * @param {string} attribute
+     * @returns {string}
+     */
     Query.orderDesc = (attribute) => new Query("orderDesc", attribute).toString();
+    /**
+     * Sort results by attribute ascending.
+     *
+     * @param {string} attribute
+     * @returns {string}
+     */
     Query.orderAsc = (attribute) => new Query("orderAsc", attribute).toString();
+    /**
+     * Return results after documentId.
+     *
+     * @param {string} documentId
+     * @returns {string}
+     */
     Query.cursorAfter = (documentId) => new Query("cursorAfter", undefined, documentId).toString();
+    /**
+     * Return results before documentId.
+     *
+     * @param {string} documentId
+     * @returns {string}
+     */
     Query.cursorBefore = (documentId) => new Query("cursorBefore", undefined, documentId).toString();
+    /**
+     * Return only limit results.
+     *
+     * @param {number} limit
+     * @returns {string}
+     */
     Query.limit = (limit) => new Query("limit", undefined, limit).toString();
+    /**
+     * Filter resources by skipping the first offset results.
+     *
+     * @param {number} offset
+     * @returns {string}
+     */
     Query.offset = (offset) => new Query("offset", undefined, offset).toString();
+    /**
+     * Filter resources where attribute contains the specified value.
+     *
+     * @param {string} attribute
+     * @param {string | string[]} value
+     * @returns {string}
+     */
     Query.contains = (attribute, value) => new Query("contains", attribute, value).toString();
+    /**
+     * Combine multiple queries using logical OR operator.
+     *
+     * @param {string[]} queries
+     * @returns {string}
+     */
     Query.or = (queries) => new Query("or", undefined, queries.map((query) => JSON.parse(query))).toString();
+    /**
+     * Combine multiple queries using logical AND operator.
+     *
+     * @param {string[]} queries
+     * @returns {string}
+     */
     Query.and = (queries) => new Query("and", undefined, queries.map((query) => JSON.parse(query))).toString();
 
+    /**
+     * Exception thrown by the  package
+     */
     class AppwriteException extends Error {
+        /**
+         * Initializes a Appwrite Exception.
+         *
+         * @param {string} message - The error message.
+         * @param {number} code - The error code. Default is 0.
+         * @param {string} type - The error type. Default is an empty string.
+         * @param {string} response - The response string. Default is an empty string.
+         */
         constructor(message, code = 0, type = '', response = '') {
             super(message);
             this.name = 'AppwriteException';
@@ -106,8 +280,14 @@
             this.response = response;
         }
     }
+    /**
+     * Client that handles requests to Appwrite
+     */
     class Client {
         constructor() {
+            /**
+             * Holds configuration such as project.
+             */
             this.config = {
                 endpoint: 'https://cloud.appwrite.io/v1',
                 endpointRealtime: '',
@@ -117,11 +297,14 @@
                 locale: '',
                 mode: '',
             };
+            /**
+             * Custom headers for API requests.
+             */
             this.headers = {
                 'x-sdk-name': 'Console',
                 'x-sdk-platform': 'console',
                 'x-sdk-language': 'web',
-                'x-sdk-version': '0.6.1',
+                'x-sdk-version': '0.6.4',
                 'X-Appwrite-Response-Format': '1.5.0',
             };
             this.realtime = {
@@ -153,9 +336,12 @@
                     }
                 },
                 createSocket: () => {
-                    var _a, _b;
-                    if (this.realtime.channels.size < 1)
+                    var _a, _b, _c;
+                    if (this.realtime.channels.size < 1) {
+                        this.realtime.reconnect = false;
+                        (_a = this.realtime.socket) === null || _a === void 0 ? void 0 : _a.close();
                         return;
+                    }
                     const channels = new URLSearchParams();
                     channels.set('project', this.config.project);
                     this.realtime.channels.forEach(channel => {
@@ -164,10 +350,10 @@
                     const url = this.config.endpointRealtime + '/realtime?' + channels.toString();
                     if (url !== this.realtime.url || // Check if URL is present
                         !this.realtime.socket || // Check if WebSocket has not been created
-                        ((_a = this.realtime.socket) === null || _a === void 0 ? void 0 : _a.readyState) > WebSocket.OPEN // Check if WebSocket is CLOSING (3) or CLOSED (4)
+                        ((_b = this.realtime.socket) === null || _b === void 0 ? void 0 : _b.readyState) > WebSocket.OPEN // Check if WebSocket is CLOSING (3) or CLOSED (4)
                     ) {
                         if (this.realtime.socket &&
-                            ((_b = this.realtime.socket) === null || _b === void 0 ? void 0 : _b.readyState) < WebSocket.CLOSING // Close WebSocket if it is CONNECTING (0) or OPEN (1)
+                            ((_c = this.realtime.socket) === null || _c === void 0 ? void 0 : _c.readyState) < WebSocket.CLOSING // Close WebSocket if it is CONNECTING (0) or OPEN (1)
                         ) {
                             this.realtime.reconnect = false;
                             this.realtime.socket.close();
@@ -383,8 +569,21 @@
                 this.realtime.connect();
             };
         }
+        /**
+         * Call API endpoint with the specified method, URL, headers, and parameters.
+         *
+         * @param {string} method - HTTP method (e.g., 'GET', 'POST', 'PUT', 'DELETE').
+         * @param {URL} url - The URL of the API endpoint.
+         * @param {Headers} headers - Custom headers for the API request.
+         * @param {Payload} params - Request parameters.
+         * @returns {Promise<any>} - A promise that resolves with the response data.
+         *
+         * @typedef {Object} Payload - Request payload data.
+         * @property {string} key - The key.
+         * @property {string} value - The value.
+         */
         call(method, url, headers = {}, params = {}) {
-            var _a, _b;
+            var _a;
             return __awaiter(this, void 0, void 0, function* () {
                 method = method.toUpperCase();
                 headers = Object.assign({}, this.headers, headers);
@@ -394,7 +593,10 @@
                     credentials: 'include'
                 };
                 if (typeof window !== 'undefined' && window.localStorage) {
-                    headers['X-Fallback-Cookies'] = (_a = window.localStorage.getItem('cookieFallback')) !== null && _a !== void 0 ? _a : '';
+                    const cookieFallback = window.localStorage.getItem('cookieFallback');
+                    if (cookieFallback) {
+                        headers['X-Fallback-Cookies'] = cookieFallback;
+                    }
                 }
                 if (method === 'GET') {
                     for (const [key, value] of Object.entries(Service.flatten(params))) {
@@ -425,8 +627,12 @@
                 }
                 try {
                     let data = null;
-                    const response = yield crossFetch.fetch(url.toString(), options);
-                    if ((_b = response.headers.get('content-type')) === null || _b === void 0 ? void 0 : _b.includes('application/json')) {
+                    const response = yield fetch(url.toString(), options);
+                    const warnings = response.headers.get('x-appwrite-warning');
+                    if (warnings) {
+                        warnings.split(';').forEach((warning) => console.warn('Warning: ' + warning));
+                    }
+                    if ((_a = response.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.includes('application/json')) {
                         data = yield response.json();
                     }
                     else {
@@ -697,11 +903,11 @@
             });
         }
         /**
-         * Add Authenticator
+         * Create Authenticator
          *
          * Add an authenticator app to be used as an MFA factor. Verify the
          * authenticator using the [verify
-         * authenticator](/docs/references/cloud/client-web/account#verifyAuthenticator)
+         * authenticator](/docs/references/cloud/client-web/account#updateMfaAuthenticator)
          * method.
          *
          * @param {AuthenticatorType} type
@@ -725,7 +931,7 @@
          * Verify Authenticator
          *
          * Verify an authenticator app after adding it using the [add
-         * authenticator](/docs/references/cloud/client-web/account#addAuthenticator)
+         * authenticator](/docs/references/cloud/client-web/account#createMfaAuthenticator)
          * method.
          *
          * @param {AuthenticatorType} type
@@ -782,7 +988,7 @@
             });
         }
         /**
-         * Create 2FA Challenge
+         * Create MFA Challenge
          *
          * Begin the process of MFA verification after sign-in. Finish the flow with
          * [updateMfaChallenge](/docs/references/cloud/client-web/account#updateMfaChallenge)
@@ -1875,7 +2081,7 @@
             });
         }
         /**
-         * Create phone verification (confirmation)
+         * Update phone verification (confirmation)
          *
          * Use this endpoint to complete the user phone verification process. Use the
          * **userId** and **secret** that were sent to your user's phone number to
@@ -4243,10 +4449,11 @@
          * @param {string} templateOwner
          * @param {string} templateRootDirectory
          * @param {string} templateBranch
+         * @param {string} specification
          * @throws {AppwriteException}
          * @returns {Promise}
         */
-        create(functionId, name, runtime, execute, events, schedule, timeout, enabled, logging, entrypoint, commands, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, templateRepository, templateOwner, templateRootDirectory, templateBranch) {
+        create(functionId, name, runtime, execute, events, schedule, timeout, enabled, logging, entrypoint, commands, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, templateRepository, templateOwner, templateRootDirectory, templateBranch, specification) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (typeof functionId === 'undefined') {
                     throw new AppwriteException('Missing required parameter: "functionId"');
@@ -4319,6 +4526,9 @@
                 if (typeof templateBranch !== 'undefined') {
                     payload['templateBranch'] = templateBranch;
                 }
+                if (typeof specification !== 'undefined') {
+                    payload['specification'] = specification;
+                }
                 const uri = new URL(this.client.config.endpoint + apiPath);
                 return yield this.client.call('post', uri, {
                     'content-type': 'application/json',
@@ -4343,6 +4553,25 @@
                 }, payload);
             });
         }
+        /**
+         * Get available function runtime specifications
+         *
+         * Get allowed function specifications for this instance.
+         *
+         *
+         * @throws {AppwriteException}
+         * @returns {Promise}
+        */
+        getSpecifications() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const apiPath = '/functions/specifications';
+                const payload = {};
+                const uri = new URL(this.client.config.endpoint + apiPath);
+                return yield this.client.call('get', uri, {
+                    'content-type': 'application/json',
+                }, payload);
+            });
+        }
         /**
          * Get functions usage
          *
@@ -4407,10 +4636,11 @@
          * @param {string} providerBranch
          * @param {boolean} providerSilentMode
          * @param {string} providerRootDirectory
+         * @param {string} specification
          * @throws {AppwriteException}
          * @returns {Promise}
         */
-        update(functionId, name, runtime, execute, events, schedule, timeout, enabled, logging, entrypoint, commands, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory) {
+        update(functionId, name, runtime, execute, events, schedule, timeout, enabled, logging, entrypoint, commands, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, specification) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (typeof functionId === 'undefined') {
                     throw new AppwriteException('Missing required parameter: "functionId"');
@@ -4465,6 +4695,9 @@
                 if (typeof providerRootDirectory !== 'undefined') {
                     payload['providerRootDirectory'] = providerRootDirectory;
                 }
+                if (typeof specification !== 'undefined') {
+                    payload['specification'] = specification;
+                }
                 const uri = new URL(this.client.config.endpoint + apiPath);
                 return yield this.client.call('put', uri, {
                     'content-type': 'application/json',
@@ -4636,7 +4869,7 @@
             });
         }
         /**
-         * Update function deployment
+         * Update deployment
          *
          * Update the function code deployment ID using the unique function ID. Use
          * this endpoint to switch the code deployment that should be executed by the
@@ -4721,7 +4954,7 @@
             });
         }
         /**
-         * Download Deployment
+         * Download deployment
          *
          * Get a Deployment's contents by its unique ID. This endpoint supports range
          * requests for partial or streaming file download.
@@ -5873,10 +6106,11 @@
          * @param {string[]} cc
          * @param {string[]} bcc
          * @param {string} scheduledAt
+         * @param {string[]} attachments
          * @throws {AppwriteException}
          * @returns {Promise}
         */
-        updateEmail(messageId, topics, users, targets, subject, content, draft, html, cc, bcc, scheduledAt) {
+        updateEmail(messageId, topics, users, targets, subject, content, draft, html, cc, bcc, scheduledAt, attachments) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (typeof messageId === 'undefined') {
                     throw new AppwriteException('Missing required parameter: "messageId"');
@@ -5913,6 +6147,9 @@
                 if (typeof scheduledAt !== 'undefined') {
                     payload['scheduledAt'] = scheduledAt;
                 }
+                if (typeof attachments !== 'undefined') {
+                    payload['attachments'] = attachments;
+                }
                 const uri = new URL(this.client.config.endpoint + apiPath);
                 return yield this.client.call('patch', uri, {
                     'content-type': 'application/json',
@@ -12440,12 +12677,12 @@
         /**
          * Create token
          *
-         * Returns a token with a secret key for creating a session. If the provided
-         * user ID has not be registered, a new user will be created. Use the returned
-         * user ID and secret and submit a request to the [PUT
-         * /account/sessions/custom](https://appwrite.io/docs/references/cloud/client-web/account#updateCustomSession)
+         * Returns a token with a secret key for creating a session. Use the user ID
+         * and secret and submit a request to the [PUT
+         * /account/sessions/token](https://appwrite.io/docs/references/cloud/client-web/account#createSession)
          * endpoint to complete the login process.
          *
+         *
          * @param {string} userId
          * @param {number} length
          * @param {number} expire
@@ -12775,20 +13012,56 @@
         }
     }
 
+    /**
+     * Helper class to generate permission strings for resources.
+     */
     class Permission {
     }
+    /**
+     * Generate read permission string for the provided role.
+     *
+     * @param {string} role
+     * @returns {string}
+     */
     Permission.read = (role) => {
         return `read("${role}")`;
     };
+    /**
+     * Generate write permission string for the provided role.
+     *
+     * This is an alias of update, delete, and possibly create.
+     * Don't use write in combination with update, delete, or create.
+     *
+     * @param {string} role
+     * @returns {string}
+     */
     Permission.write = (role) => {
         return `write("${role}")`;
     };
+    /**
+     * Generate create permission string for the provided role.
+     *
+     * @param {string} role
+     * @returns {string}
+     */
     Permission.create = (role) => {
         return `create("${role}")`;
     };
+    /**
+     * Generate update permission string for the provided role.
+     *
+     * @param {string} role
+     * @returns {string}
+     */
     Permission.update = (role) => {
         return `update("${role}")`;
     };
+    /**
+     * Generate delete permission string for the provided role.
+     *
+     * @param {string} role
+     * @returns {string}
+     */
     Permission.delete = (role) => {
         return `delete("${role}")`;
     };
@@ -12888,10 +13161,25 @@
     }
 
     var _a, _ID_hexTimestamp;
+    /**
+     * Helper class to generate ID strings for resources.
+     */
     class ID {
+        /**
+         * Uses the provided ID as the ID for the resource.
+         *
+         * @param {string} id
+         * @returns {string}
+         */
         static custom(id) {
             return id;
         }
+        /**
+         * Have Appwrite generate a unique ID for you.
+         *
+         * @param {number} padding. Default is 7.
+         * @returns {string}
+         */
         static unique(padding = 7) {
             // Generate a unique ID with padding to have a longer ID
             const baseId = __classPrivateFieldGet(ID, _a, "m", _ID_hexTimestamp).call(ID);
@@ -12991,7 +13279,7 @@
         CreditCard["AmericanExpress"] = "amex";
         CreditCard["Argencard"] = "argencard";
         CreditCard["Cabal"] = "cabal";
-        CreditCard["Consosud"] = "censosud";
+        CreditCard["Cencosud"] = "cencosud";
         CreditCard["DinersClub"] = "diners";
         CreditCard["Discover"] = "discover";
         CreditCard["Elo"] = "elo";
@@ -13149,6 +13437,7 @@
         Flag["Palau"] = "pw";
         Flag["PapuaNewGuinea"] = "pg";
         Flag["Poland"] = "pl";
+        Flag["FrenchPolynesia"] = "pf";
         Flag["NorthKorea"] = "kp";
         Flag["Portugal"] = "pt";
         Flag["Paraguay"] = "py";
@@ -13254,6 +13543,7 @@
         Runtime["Python310"] = "python-3.10";
         Runtime["Python311"] = "python-3.11";
         Runtime["Python312"] = "python-3.12";
+        Runtime["Pythonml311"] = "python-ml-3.11";
         Runtime["Deno140"] = "deno-1.40";
         Runtime["Dart215"] = "dart-2.15";
         Runtime["Dart216"] = "dart-2.16";
@@ -13307,12 +13597,11 @@
         Name["V1functions"] = "v1-functions";
         Name["V1usage"] = "v1-usage";
         Name["V1usagedump"] = "v1-usage-dump";
-        Name["Webhooksv1"] = "webhooksv1";
+        Name["V1webhooks"] = "v1-webhooks";
         Name["V1certificates"] = "v1-certificates";
         Name["V1builds"] = "v1-builds";
         Name["V1messaging"] = "v1-messaging";
         Name["V1migrations"] = "v1-migrations";
-        Name["Hamsterv1"] = "hamsterv1";
     })(exports.Name || (exports.Name = {}));
 
     exports.SmtpEncryption = void 0;
@@ -13774,4 +14063,4 @@
 
     Object.defineProperty(exports, '__esModule', { value: true });
 
-})(this.Appwrite = this.Appwrite || {}, null, window);
+})(this.Appwrite = this.Appwrite || {});

package/docs/examples/account/create-anonymous-session.md

@@ -2,7 +2,7 @@ import { Client, Account } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);
 

package/docs/examples/account/create-email-password-session.md

@@ -2,7 +2,7 @@ import { Client, Account } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);
 

package/docs/examples/account/create-email-token.md

@@ -2,7 +2,7 @@ import { Client, Account } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);
 

package/docs/examples/account/create-j-w-t.md

@@ -2,7 +2,7 @@ import { Client, Account } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);
 

package/docs/examples/account/create-magic-u-r-l-token.md

@@ -2,7 +2,7 @@ import { Client, Account } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);
 

package/docs/examples/account/create-mfa-authenticator.md

@@ -2,7 +2,7 @@ import { Client, Account, AuthenticatorType } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
-    .setProject('5df5acd0d48c2'); // Your project ID
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
 
 const account = new Account(client);