@appwrite.io/console 13.2.0 → 14.0.0

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": "13.2.0",
+  "version": "14.0.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {

package/types/enums/project-key-scopes.d.ts

@@ -89,6 +89,7 @@ export declare enum ProjectKeyScopes {
     ArchivesWrite = "archives.write",
     RestorationsRead = "restorations.read",
     RestorationsWrite = "restorations.write",
+    DedicatedDatabasesExecute = "dedicatedDatabases.execute",
     DomainsRead = "domains.read",
     DomainsWrite = "domains.write",
     EventsRead = "events.read",

package/types/models.d.ts

@@ -1490,7 +1490,7 @@ export declare namespace Models {
         /**
          * Default value for attribute when not provided. Cannot be set when attribute is required.
          */
-        default?: any[];
+        default?: number[];
     };
     /**
      * AttributeLine
@@ -1531,7 +1531,7 @@ export declare namespace Models {
         /**
          * Default value for attribute when not provided. Cannot be set when attribute is required.
          */
-        default?: any[];
+        default?: number[][];
     };
     /**
      * AttributePolygon
@@ -1572,7 +1572,7 @@ export declare namespace Models {
         /**
          * Default value for attribute when not provided. Cannot be set when attribute is required.
          */
-        default?: any[];
+        default?: number[][][];
     };
     /**
      * AttributeVarchar
@@ -2680,7 +2680,7 @@ export declare namespace Models {
         /**
          * Default value for column when not provided. Cannot be set when column is required.
          */
-        default?: any[];
+        default?: number[];
     };
     /**
      * ColumnLine
@@ -2721,7 +2721,7 @@ export declare namespace Models {
         /**
          * Default value for column when not provided. Cannot be set when column is required.
          */
-        default?: any[];
+        default?: number[][];
     };
     /**
      * ColumnPolygon
@@ -2762,7 +2762,7 @@ export declare namespace Models {
         /**
          * Default value for column when not provided. Cannot be set when column is required.
          */
-        default?: any[];
+        default?: number[][][];
     };
     /**
      * ColumnVarchar
@@ -3306,6 +3306,26 @@ export declare namespace Models {
          * Email verification status.
          */
         emailVerification: boolean;
+        /**
+         * Canonical form of the user email address.
+         */
+        emailCanonical?: string;
+        /**
+         * Whether the user email is from a free email provider.
+         */
+        emailIsFree?: boolean;
+        /**
+         * Whether the user email is from a disposable email provider.
+         */
+        emailIsDisposable?: boolean;
+        /**
+         * Whether the user email is from a corporate domain.
+         */
+        emailIsCorporate?: boolean;
+        /**
+         * Whether the user email is in its canonical form.
+         */
+        emailIsCanonical?: boolean;
         /**
          * Phone verification status.
          */
@@ -3936,6 +3956,10 @@ export declare namespace Models {
          * Multi factor authentication status, true if the user has MFA enabled or false otherwise. Hide this attribute by toggling membership privacy in the Console.
          */
         mfa: boolean;
+        /**
+         * Most recent access date in ISO 8601 format. Show this attribute by toggling membership privacy in the Console.
+         */
+        userAccessedAt: string;
         /**
          * User list of roles
          */
@@ -5106,6 +5130,10 @@ export declare namespace Models {
          * OAuth2 server allowed scopes
          */
         oAuth2ServerScopes: string[];
+        /**
+         * OAuth2 server accepted RFC 9396 authorization_details types
+         */
+        oAuth2ServerAuthorizationDetailsTypes: string[];
         /**
          * OAuth2 server access token duration in seconds for confidential clients
          */
@@ -5126,6 +5154,22 @@ export declare namespace Models {
          * When enabled, PKCE is required for confidential clients (server-side flows using client_secret). PKCE is always required for public clients regardless of this setting.
          */
         oAuth2ServerConfidentialPkce: boolean;
+        /**
+         * URL to your application page where users enter the device flow user code. Empty when the Device Authorization Grant is not configured.
+         */
+        oAuth2ServerVerificationUrl: string;
+        /**
+         * Number of characters in the device flow user code, excluding the formatting separator.
+         */
+        oAuth2ServerUserCodeLength: number;
+        /**
+         * Character set for device flow user codes: `numeric`, `alphabetic`, or `alphanumeric`.
+         */
+        oAuth2ServerUserCodeFormat: string;
+        /**
+         * Lifetime in seconds of device flow device codes and user codes.
+         */
+        oAuth2ServerDeviceCodeDuration: number;
         /**
          * OAuth2 server discovery URL
          */
@@ -6445,6 +6489,10 @@ export declare namespace Models {
          * Whether user MFA status is visible in memberships.
          */
         userMFA: boolean;
+        /**
+         * Whether user last access time is visible in memberships.
+         */
+        userAccessedAt: boolean;
     };
     /**
      * Platform Web
@@ -8988,54 +9036,6 @@ export declare namespace Models {
          * Hostname.
          */
         hostname: string;
-        /**
-         * Operating system code name. View list of [available options](https://github.com/appwrite/appwrite/blob/master/docs/lists/os.json).
-         */
-        osCode: string;
-        /**
-         * Operating system name.
-         */
-        osName: string;
-        /**
-         * Operating system version.
-         */
-        osVersion: string;
-        /**
-         * Client type.
-         */
-        clientType: string;
-        /**
-         * Client code name. View list of [available options](https://github.com/appwrite/appwrite/blob/master/docs/lists/clients.json).
-         */
-        clientCode: string;
-        /**
-         * Client name.
-         */
-        clientName: string;
-        /**
-         * Client version.
-         */
-        clientVersion: string;
-        /**
-         * Client engine name.
-         */
-        clientEngine: string;
-        /**
-         * Client engine name.
-         */
-        clientEngineVersion: string;
-        /**
-         * Device name.
-         */
-        deviceName: string;
-        /**
-         * Device brand name.
-         */
-        deviceBrand: string;
-        /**
-         * Device model name.
-         */
-        deviceModel: string;
         /**
          * Country two-character ISO 3166-1 alpha code.
          */
@@ -9939,6 +9939,38 @@ export declare namespace Models {
          * Unix timestamp when the branch expires.
          */
         expiresAt: number;
+        /**
+         * Branch hostname for direct connections.
+         */
+        host: string;
+        /**
+         * Branch port.
+         */
+        port: number;
+        /**
+         * Database name the client sends for routing to the branch.
+         */
+        database: string;
+        /**
+         * Database username. Shared with the parent database.
+         */
+        username: string;
+        /**
+         * Database password. Shared with the parent database.
+         */
+        password: string;
+        /**
+         * Whether SSL is required.
+         */
+        ssl: boolean;
+        /**
+         * Database engine. Possible values: postgres, mysql, mariadb, mongodb.
+         */
+        engine: string;
+        /**
+         * Full connection string for the branch.
+         */
+        connectionString: string;
     };
     /**
      * BranchList
@@ -10092,6 +10124,18 @@ export declare namespace Models {
          * Database name.
          */
         database: string;
+        /**
+         * Database TCP hostname or address.
+         */
+        tcpHost: string;
+        /**
+         * Database TCP port.
+         */
+        tcpPort: number;
+        /**
+         * Database name for direct TCP connections.
+         */
+        tcpDatabase: string;
         /**
          * Database engine. Possible values: postgres, mysql, mariadb, mongodb.
          */
@@ -10180,55 +10224,6 @@ export declare namespace Models {
          */
         available: number;
     };
-    /**
-     * DatabaseMetrics
-     */
-    export type DedicatedDatabaseMetrics = {
-        /**
-         * Metrics aggregation period. Possible values: 1h (last hour), 24h (last 24 hours), 7d (last 7 days), 30d (last 30 days).
-         */
-        period: string;
-        /**
-         * Average CPU usage percentage.
-         */
-        cpuPercent: number;
-        /**
-         * Average memory usage percentage.
-         */
-        memoryPercent: number;
-        /**
-         * Memory used in bytes.
-         */
-        memoryUsedBytes: number;
-        /**
-         * Maximum memory available in bytes.
-         */
-        memoryMaxBytes: number;
-        /**
-         * Storage used in bytes.
-         */
-        storageUsedBytes: number;
-        /**
-         * Current active connections.
-         */
-        connectionsActive: number;
-        /**
-         * Maximum connections configured.
-         */
-        connectionsMax: number;
-        /**
-         * Average read IOPS.
-         */
-        iopsRead: number;
-        /**
-         * Average write IOPS.
-         */
-        iopsWrite: number;
-        /**
-         * Queries per second.
-         */
-        qps: number;
-    };
     /**
      * DedicatedDatabase
      */
@@ -10253,18 +10248,10 @@ export declare namespace Models {
          * Database display name.
          */
         name: string;
-        /**
-         * Database type: shared (serverless) or dedicated (always-on).
-         */
-        type: string;
         /**
          * Product API that owns this database: compute, documentsdb, or vectorsdb.
          */
         api: string;
-        /**
-         * Region identifier (e.g., fra, nyc, syd).
-         */
-        region: string;
         /**
          * Database engine: postgres, mysql, mariadb, or mongodb.
          */
@@ -10306,7 +10293,7 @@ export declare namespace Models {
          */
         status: string;
         /**
-         * Container status for shared databases: active or inactive.
+         * Container status for lifecycle-managed database runtimes: active or inactive.
          */
         containerStatus: string;
         /**
@@ -10346,13 +10333,9 @@ export declare namespace Models {
          */
         nodePool: string;
         /**
-         * Whether high availability is enabled.
+         * Number of high availability replicas. High availability is enabled when greater than 0.
          */
-        highAvailability: boolean;
-        /**
-         * Number of high availability replicas.
-         */
-        highAvailabilityReplicaCount: number;
+        replicas: number;
         /**
          * Replication sync mode: async, sync, or quorum.
          */
@@ -10418,7 +10401,7 @@ export declare namespace Models {
          */
         sqlApiEnabled: boolean;
         /**
-         * Statement types accepted by the SQL API. Allowed values: SELECT, INSERT, UPDATE, DELETE.
+         * Statement types accepted by the SQL API. Defaults to DML only; DDL/DCL types (CREATE, ALTER, DROP, TRUNCATE, GRANT, REVOKE) are opt-in per database. Allowed values: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, TRUNCATE, GRANT, REVOKE.
          */
         sqlApiAllowedStatements: string[];
         /**
@@ -11374,77 +11357,6 @@ export declare namespace Models {
          */
         failed: boolean;
     };
-    /**
-     * PerformanceInsights
-     */
-    export type DedicatedDatabasePerformanceInsights = {
-        /**
-         * Top queries by total execution time.
-         */
-        topQueries: DedicatedDatabasePerformanceInsightsQuery[];
-        /**
-         * Active wait events.
-         */
-        waitEvents: DedicatedDatabasePerformanceInsightsWaitEvent[];
-        /**
-         * Total number of query calls.
-         */
-        totalCalls: number;
-        /**
-         * Total query execution time in milliseconds.
-         */
-        totalTimeMs: number;
-        /**
-         * Average query execution time in milliseconds.
-         */
-        avgTimeMs: number;
-    };
-    /**
-     * PerformanceInsightsQuery
-     */
-    export type DedicatedDatabasePerformanceInsightsQuery = {
-        /**
-         * The SQL query text.
-         */
-        query: string;
-        /**
-         * Number of times this query has been executed.
-         */
-        calls: number;
-        /**
-         * Total execution time in milliseconds.
-         */
-        totalTimeMs: number;
-        /**
-         * Mean execution time in milliseconds.
-         */
-        meanTimeMs: number;
-        /**
-         * Total rows returned or affected.
-         */
-        rows: number;
-    };
-    /**
-     * PerformanceInsightsWaitEvent
-     */
-    export type DedicatedDatabasePerformanceInsightsWaitEvent = {
-        /**
-         * Wait event name.
-         */
-        event: string;
-        /**
-         * Wait event type or category.
-         */
-        type: string;
-        /**
-         * Number of occurrences.
-         */
-        count: number;
-        /**
-         * Total wait time in milliseconds.
-         */
-        totalWaitMs: number;
-    };
     /**
      * PITRWindows
      */
@@ -11622,6 +11534,10 @@ export declare namespace Models {
          * Policy backup schedule in CRON format.
          */
         schedule: string;
+        /**
+         * Backup type. Possible values: full (complete database snapshot), incremental (changes since last backup).
+         */
+        type: string;
         /**
          * Is this policy enabled.
          */
@@ -11890,36 +11806,6 @@ export declare namespace Models {
          */
         roles: string[];
     };
-    /**
-     * Schema
-     */
-    export type DedicatedDatabaseSchema = {
-        /**
-         * List of tables with columns, types, and constraints.
-         */
-        tables: Record<string, any>[];
-        /**
-         * List of indexes across all tables.
-         */
-        indexes: Record<string, any>[];
-    };
-    /**
-     * SchemaPreview
-     */
-    export type DedicatedDatabaseSchemaPreview = {
-        /**
-         * Whether the engine supports transactional DDL for safe preview.
-         */
-        supportsTransactionalDDL: boolean;
-        /**
-         * Schema change preview output.
-         */
-        preview: string;
-        /**
-         * List of tables in the database after the change.
-         */
-        tables: string[];
-    };
     /**
      * SlowQuery
      */
@@ -12478,13 +12364,33 @@ export declare namespace Models {
          */
         name: string;
         /**
-         * List of authorized redirect URIs. These URIs can be used to redirect users after they authenticate.
+         * Application description shown to users during OAuth2 consent.
          */
-        redirectUris: string[];
+        description: string;
         /**
-         * When true, the application is restricted to the owner user (if `userId` is set) or members of `teamId` (if set). When false, any user in the project can authorize against the app.
+         * Application homepage URL shown to users during OAuth2 consent.
          */
-        internal: boolean;
+        clientUri: string;
+        /**
+         * Application logo URL shown to users during OAuth2 consent.
+         */
+        logoUri: string;
+        /**
+         * Application privacy policy URL shown to users during OAuth2 consent.
+         */
+        privacyPolicyUrl: string;
+        /**
+         * Application terms of service URL shown to users during OAuth2 consent.
+         */
+        termsUrl: string;
+        /**
+         * Application support or security contact emails.
+         */
+        contacts: string[];
+        /**
+         * List of authorized redirect URIs. These URIs can be used to redirect users after they authenticate.
+         */
+        redirectUris: string[];
         /**
          * Whether the app is enabled or not.
          */
@@ -12493,6 +12399,10 @@ export declare namespace Models {
          * OAuth2 client type. `public` for SPAs, mobile, and native apps that cannot keep a client secret (PKCE required); `confidential` for server-side clients that authenticate with a client secret.
          */
         type: string;
+        /**
+         * Whether this client may use the OAuth2 Device Authorization Grant (RFC 8628).
+         */
+        deviceFlow: boolean;
         /**
          * ID of team that owns the application, if owned by team. Otherwise, user ID will be used.
          */
@@ -12527,9 +12437,13 @@ export declare namespace Models {
          */
         appId: string;
         /**
-         * Masked application client secret. Only the last 6 characters are returned.
+         * Hashed application client secret.
          */
         secret: string;
+        /**
+         * Last few characters of the client secret, used to help identify it.
+         */
+        hint: string;
         /**
          * ID of the user who created the secret.
          */
@@ -12567,6 +12481,10 @@ export declare namespace Models {
          * Application client secret. Returned in full only when the secret is created; subsequent reads return a masked value.
          */
         secret: string;
+        /**
+         * Last few characters of the client secret, used to help identify it.
+         */
+        hint: string;
         /**
          * ID of the user who created the secret.
          */

package/types/services/apps.d.ts

@@ -31,9 +31,15 @@ export declare class Apps {
      * @param {string} params.appId - Application ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
      * @param {string} params.name - Application name.
      * @param {string[]} params.redirectUris - Redirect URIs (array of valid URLs).
+     * @param {string} params.description - Application description shown to users during OAuth2 consent.
+     * @param {string} params.clientUri - Application homepage URL shown to users during OAuth2 consent.
+     * @param {string} params.logoUri - Application logo URL shown to users during OAuth2 consent.
+     * @param {string} params.privacyPolicyUrl - Application privacy policy URL shown to users during OAuth2 consent.
+     * @param {string} params.termsUrl - Application terms of service URL shown to users during OAuth2 consent.
+     * @param {string[]} params.contacts - Application support or security contact emails. Maximum of 100 contacts are allowed.
      * @param {boolean} params.enabled - Is application enabled?
-     * @param {boolean} params.internal - When true, the application is restricted to the owner user or members of the configured team. Defaults to false (any user in the project can authorize).
      * @param {string} params.type - OAuth2 client type. Use `public` for SPAs, mobile, and native apps that cannot keep a `client_secret` — PKCE is then required at the token endpoint. Use `confidential` for server-side clients that present a `client_secret`. Defaults to `confidential`.
+     * @param {boolean} params.deviceFlow - Allow this client to use the OAuth2 Device Authorization Grant (RFC 8628) for input-constrained devices such as TVs and CLIs. Defaults to false.
      * @param {string} params.teamId - Team unique ID.
      * @throws {AppwriteException}
      * @returns {Promise<Models.App>}
@@ -42,9 +48,15 @@ export declare class Apps {
         appId: string;
         name: string;
         redirectUris: string[];
+        description?: string;
+        clientUri?: string;
+        logoUri?: string;
+        privacyPolicyUrl?: string;
+        termsUrl?: string;
+        contacts?: string[];
         enabled?: boolean;
-        internal?: boolean;
         type?: string;
+        deviceFlow?: boolean;
         teamId?: string;
     }): Promise<Models.App>;
     /**
@@ -53,15 +65,21 @@ export declare class Apps {
      * @param {string} appId - Application ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
      * @param {string} name - Application name.
      * @param {string[]} redirectUris - Redirect URIs (array of valid URLs).
+     * @param {string} description - Application description shown to users during OAuth2 consent.
+     * @param {string} clientUri - Application homepage URL shown to users during OAuth2 consent.
+     * @param {string} logoUri - Application logo URL shown to users during OAuth2 consent.
+     * @param {string} privacyPolicyUrl - Application privacy policy URL shown to users during OAuth2 consent.
+     * @param {string} termsUrl - Application terms of service URL shown to users during OAuth2 consent.
+     * @param {string[]} contacts - Application support or security contact emails. Maximum of 100 contacts are allowed.
      * @param {boolean} enabled - Is application enabled?
-     * @param {boolean} internal - When true, the application is restricted to the owner user or members of the configured team. Defaults to false (any user in the project can authorize).
      * @param {string} type - OAuth2 client type. Use `public` for SPAs, mobile, and native apps that cannot keep a `client_secret` — PKCE is then required at the token endpoint. Use `confidential` for server-side clients that present a `client_secret`. Defaults to `confidential`.
+     * @param {boolean} deviceFlow - Allow this client to use the OAuth2 Device Authorization Grant (RFC 8628) for input-constrained devices such as TVs and CLIs. Defaults to false.
      * @param {string} teamId - Team unique ID.
      * @throws {AppwriteException}
      * @returns {Promise<Models.App>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    create(appId: string, name: string, redirectUris: string[], enabled?: boolean, internal?: boolean, type?: string, teamId?: string): Promise<Models.App>;
+    create(appId: string, name: string, redirectUris: string[], description?: string, clientUri?: string, logoUri?: string, privacyPolicyUrl?: string, termsUrl?: string, contacts?: string[], enabled?: boolean, type?: string, deviceFlow?: boolean, teamId?: string): Promise<Models.App>;
     /**
      * Get an application by its unique ID.
      *
@@ -86,35 +104,53 @@ export declare class Apps {
      *
      * @param {string} params.appId - Application unique ID.
      * @param {string} params.name - Application name.
+     * @param {string} params.description - Application description shown to users during OAuth2 consent.
+     * @param {string} params.clientUri - Application homepage URL shown to users during OAuth2 consent.
+     * @param {string} params.logoUri - Application logo URL shown to users during OAuth2 consent.
+     * @param {string} params.privacyPolicyUrl - Application privacy policy URL shown to users during OAuth2 consent.
+     * @param {string} params.termsUrl - Application terms of service URL shown to users during OAuth2 consent.
+     * @param {string[]} params.contacts - Application support or security contact emails. Maximum of 100 contacts are allowed.
      * @param {boolean} params.enabled - Is application enabled?
-     * @param {boolean} params.internal - When true, the application is restricted to the owner user or members of the configured team. Defaults to false (any user in the project can authorize).
      * @param {string[]} params.redirectUris - Redirect URIs (array of valid URLs).
      * @param {string} params.type - OAuth2 client type. Use `public` for SPAs, mobile, and native apps that cannot keep a `client_secret` — PKCE is then required at the token endpoint. Use `confidential` for server-side clients that present a `client_secret`. Defaults to `confidential`.
+     * @param {boolean} params.deviceFlow - Allow this client to use the OAuth2 Device Authorization Grant (RFC 8628) for input-constrained devices such as TVs and CLIs. Defaults to false.
      * @throws {AppwriteException}
      * @returns {Promise<Models.App>}
      */
     update(params: {
         appId: string;
         name: string;
+        description?: string;
+        clientUri?: string;
+        logoUri?: string;
+        privacyPolicyUrl?: string;
+        termsUrl?: string;
+        contacts?: string[];
         enabled?: boolean;
-        internal?: boolean;
         redirectUris?: string[];
         type?: string;
+        deviceFlow?: boolean;
     }): Promise<Models.App>;
     /**
      * Update an application by its unique ID.
      *
      * @param {string} appId - Application unique ID.
      * @param {string} name - Application name.
+     * @param {string} description - Application description shown to users during OAuth2 consent.
+     * @param {string} clientUri - Application homepage URL shown to users during OAuth2 consent.
+     * @param {string} logoUri - Application logo URL shown to users during OAuth2 consent.
+     * @param {string} privacyPolicyUrl - Application privacy policy URL shown to users during OAuth2 consent.
+     * @param {string} termsUrl - Application terms of service URL shown to users during OAuth2 consent.
+     * @param {string[]} contacts - Application support or security contact emails. Maximum of 100 contacts are allowed.
      * @param {boolean} enabled - Is application enabled?
-     * @param {boolean} internal - When true, the application is restricted to the owner user or members of the configured team. Defaults to false (any user in the project can authorize).
      * @param {string[]} redirectUris - Redirect URIs (array of valid URLs).
      * @param {string} type - OAuth2 client type. Use `public` for SPAs, mobile, and native apps that cannot keep a `client_secret` — PKCE is then required at the token endpoint. Use `confidential` for server-side clients that present a `client_secret`. Defaults to `confidential`.
+     * @param {boolean} deviceFlow - Allow this client to use the OAuth2 Device Authorization Grant (RFC 8628) for input-constrained devices such as TVs and CLIs. Defaults to false.
      * @throws {AppwriteException}
      * @returns {Promise<Models.App>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    update(appId: string, name: string, enabled?: boolean, internal?: boolean, redirectUris?: string[], type?: string): Promise<Models.App>;
+    update(appId: string, name: string, description?: string, clientUri?: string, logoUri?: string, privacyPolicyUrl?: string, termsUrl?: string, contacts?: string[], enabled?: boolean, redirectUris?: string[], type?: string, deviceFlow?: boolean): Promise<Models.App>;
     /**
      * Delete an application by its unique ID.
      *