@appwrite.io/console 16.0.0 → 17.0.0

package/types/services/messaging.d.ts

@@ -690,6 +690,68 @@ export declare class Messaging {
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     updateAPNSProvider(providerId: string, name?: string, enabled?: boolean, authKey?: string, authKeyId?: string, teamId?: string, bundleId?: string, sandbox?: boolean): Promise<Models.Provider>;
+    /**
+     * Create a new Appwrite push provider.
+     *
+     * @param {string} params.providerId - Provider 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 - Provider name.
+     * @param {boolean} params.enabled - Set as enabled.
+     * @param {number} params.qos - Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
+     * @param {number} params.expiry - Default message retention in seconds for offline delivery. Max 7 days (604800).
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Provider>}
+     */
+    createAppwriteProvider(params: {
+        providerId: string;
+        name: string;
+        enabled?: boolean;
+        qos?: number;
+        expiry?: number;
+    }): Promise<Models.Provider>;
+    /**
+     * Create a new Appwrite push provider.
+     *
+     * @param {string} providerId - Provider 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 - Provider name.
+     * @param {boolean} enabled - Set as enabled.
+     * @param {number} qos - Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
+     * @param {number} expiry - Default message retention in seconds for offline delivery. Max 7 days (604800).
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Provider>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    createAppwriteProvider(providerId: string, name: string, enabled?: boolean, qos?: number, expiry?: number): Promise<Models.Provider>;
+    /**
+     * Update an Appwrite push provider by its unique ID.
+     *
+     * @param {string} params.providerId - Provider ID.
+     * @param {string} params.name - Provider name.
+     * @param {boolean} params.enabled - Set as enabled.
+     * @param {number} params.qos - Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
+     * @param {number} params.expiry - Default message retention in seconds for offline delivery. Max 7 days (604800).
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Provider>}
+     */
+    updateAppwriteProvider(params: {
+        providerId: string;
+        name?: string;
+        enabled?: boolean;
+        qos?: number;
+        expiry?: number;
+    }): Promise<Models.Provider>;
+    /**
+     * Update an Appwrite push provider by its unique ID.
+     *
+     * @param {string} providerId - Provider ID.
+     * @param {string} name - Provider name.
+     * @param {boolean} enabled - Set as enabled.
+     * @param {number} qos - Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
+     * @param {number} expiry - Default message retention in seconds for offline delivery. Max 7 days (604800).
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Provider>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    updateAppwriteProvider(providerId: string, name?: string, enabled?: boolean, qos?: number, expiry?: number): Promise<Models.Provider>;
     /**
      * Create a new Firebase Cloud Messaging provider.
      *
@@ -1591,7 +1653,7 @@ export declare class Messaging {
      *
      * @param {string} params.providerId - Provider 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 - Provider name.
-     * @param {string} params.from - Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
+     * @param {string} params.from - Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
      * @param {string} params.accountSid - Twilio account secret ID.
      * @param {string} params.authToken - Twilio authentication token.
      * @param {boolean} params.enabled - Set as enabled.
@@ -1611,7 +1673,7 @@ export declare class Messaging {
      *
      * @param {string} providerId - Provider 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 - Provider name.
-     * @param {string} from - Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
+     * @param {string} from - Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
      * @param {string} accountSid - Twilio account secret ID.
      * @param {string} authToken - Twilio authentication token.
      * @param {boolean} enabled - Set as enabled.
@@ -1628,7 +1690,7 @@ export declare class Messaging {
      * @param {boolean} params.enabled - Set as enabled.
      * @param {string} params.accountSid - Twilio account secret ID.
      * @param {string} params.authToken - Twilio authentication token.
-     * @param {string} params.from - Sender number.
+     * @param {string} params.from - Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
      * @throws {AppwriteException}
      * @returns {Promise<Models.Provider>}
      */
@@ -1648,7 +1710,7 @@ export declare class Messaging {
      * @param {boolean} enabled - Set as enabled.
      * @param {string} accountSid - Twilio account secret ID.
      * @param {string} authToken - Twilio authentication token.
-     * @param {string} from - Sender number.
+     * @param {string} from - Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
      * @throws {AppwriteException}
      * @returns {Promise<Models.Provider>}
      * @deprecated Use the object parameter style method for a better developer experience.
@@ -1793,6 +1855,8 @@ export declare class Messaging {
      * @param {string} params.topicId - Topic ID. Choose a custom Topic ID or a new Topic ID.
      * @param {string} params.name - Topic Name.
      * @param {string[]} params.subscribe - An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
+     * @param {number} params.qos - MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
+     * @param {number} params.expiry - Message retention in seconds for offline delivery. Max 7 days (604800).
      * @throws {AppwriteException}
      * @returns {Promise<Models.Topic>}
      */
@@ -1800,6 +1864,8 @@ export declare class Messaging {
         topicId: string;
         name: string;
         subscribe?: string[];
+        qos?: number;
+        expiry?: number;
     }): Promise<Models.Topic>;
     /**
      * Create a new topic.
@@ -1807,11 +1873,13 @@ export declare class Messaging {
      * @param {string} topicId - Topic ID. Choose a custom Topic ID or a new Topic ID.
      * @param {string} name - Topic Name.
      * @param {string[]} subscribe - An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
+     * @param {number} qos - MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
+     * @param {number} expiry - Message retention in seconds for offline delivery. Max 7 days (604800).
      * @throws {AppwriteException}
      * @returns {Promise<Models.Topic>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    createTopic(topicId: string, name: string, subscribe?: string[]): Promise<Models.Topic>;
+    createTopic(topicId: string, name: string, subscribe?: string[], qos?: number, expiry?: number): Promise<Models.Topic>;
     /**
      * Get a topic by its unique ID.
      *
@@ -1840,6 +1908,8 @@ export declare class Messaging {
      * @param {string} params.topicId - Topic ID.
      * @param {string} params.name - Topic Name.
      * @param {string[]} params.subscribe - An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
+     * @param {number} params.qos - MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
+     * @param {number} params.expiry - Message retention in seconds for offline delivery. Max 7 days (604800).
      * @throws {AppwriteException}
      * @returns {Promise<Models.Topic>}
      */
@@ -1847,6 +1917,8 @@ export declare class Messaging {
         topicId: string;
         name?: string;
         subscribe?: string[];
+        qos?: number;
+        expiry?: number;
     }): Promise<Models.Topic>;
     /**
      * Update a topic by its unique ID.
@@ -1855,11 +1927,13 @@ export declare class Messaging {
      * @param {string} topicId - Topic ID.
      * @param {string} name - Topic Name.
      * @param {string[]} subscribe - An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
+     * @param {number} qos - MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
+     * @param {number} expiry - Message retention in seconds for offline delivery. Max 7 days (604800).
      * @throws {AppwriteException}
      * @returns {Promise<Models.Topic>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    updateTopic(topicId: string, name?: string, subscribe?: string[]): Promise<Models.Topic>;
+    updateTopic(topicId: string, name?: string, subscribe?: string[], qos?: number, expiry?: number): Promise<Models.Topic>;
     /**
      * Delete a topic by its unique ID.
      *

package/types/services/mongo.d.ts

@@ -31,7 +31,6 @@ export declare class Mongo {
      * @param {string} params.specification - Specification identifier. Drives the allocated CPU, memory, storage, storage class, and connection ceiling.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {string} params.standbyRegion - Standby region for a cross-region replica. When set, a replica is provisioned in this region for cross-region high availability. Must differ from the database region.
      * @param {number} params.networkIdleTimeoutSeconds - Connection idle timeout in seconds.
      * @param {string[]} params.networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} params.idleTimeoutMinutes - Minutes of inactivity before container scales to zero.
@@ -39,7 +38,7 @@ export declare class Mongo {
      * @param {number} params.pitrRetentionDays - Number of days to retain PITR data.
      * @param {boolean} params.storageAutoscaling - Enable automatic storage expansion when usage exceeds threshold.
      * @param {number} params.storageAutoscalingThresholdPercent - Storage usage percentage (50-95) that triggers automatic expansion.
-     * @param {number} params.storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. 0 means no limit.
+     * @param {number} params.storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. Defaults to 3 times the specification's storage. 0 means no limit.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabase>}
      */
@@ -50,7 +49,6 @@ export declare class Mongo {
         specification?: string;
         replicas?: number;
         syncMode?: string;
-        standbyRegion?: string;
         networkIdleTimeoutSeconds?: number;
         networkIPAllowlist?: string[];
         idleTimeoutMinutes?: number;
@@ -69,7 +67,6 @@ export declare class Mongo {
      * @param {string} specification - Specification identifier. Drives the allocated CPU, memory, storage, storage class, and connection ceiling.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {string} standbyRegion - Standby region for a cross-region replica. When set, a replica is provisioned in this region for cross-region high availability. Must differ from the database region.
      * @param {number} networkIdleTimeoutSeconds - Connection idle timeout in seconds.
      * @param {string[]} networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} idleTimeoutMinutes - Minutes of inactivity before container scales to zero.
@@ -77,14 +74,14 @@ export declare class Mongo {
      * @param {number} pitrRetentionDays - Number of days to retain PITR data.
      * @param {boolean} storageAutoscaling - Enable automatic storage expansion when usage exceeds threshold.
      * @param {number} storageAutoscalingThresholdPercent - Storage usage percentage (50-95) that triggers automatic expansion.
-     * @param {number} storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. 0 means no limit.
+     * @param {number} storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. Defaults to 3 times the specification's storage. 0 means no limit.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabase>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    create(databaseId: string, name: string, version?: string, specification?: string, replicas?: number, syncMode?: string, standbyRegion?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number): Promise<Models.DedicatedDatabase>;
+    create(databaseId: string, name: string, version?: string, specification?: string, replicas?: number, syncMode?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number): Promise<Models.DedicatedDatabase>;
     /**
-     * List the dedicated database specifications available on the current plan. Each specification reports its resource limits, pricing, and whether it is enabled for the organization.
+     * List the dedicated database specifications available on the current plan. Each specification reports its resource limits, its own prices and overage rates, and whether it is enabled for the organization.
      *
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseSpecificationList>}
@@ -118,8 +115,6 @@ export declare class Mongo {
      * @param {string} params.specification - Specification. Changes cpu, memory, storage, connection ceiling, and node pool based on specification config. Resource changes are applied via rolling cutover with zero downtime.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {number} params.crossRegionReplicas - Number of cross-region standby replicas (0-1). Cross-region replication is enabled when greater than 0.
-     * @param {string} params.standbyRegion - Standby region for the cross-region replica. Required when enabling cross-region replication and no standby region is already configured. Must differ from the database region.
      * @param {number} params.networkIdleTimeoutSeconds - Connection idle timeout in seconds (60-86400).
      * @param {string[]} params.networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} params.idleTimeoutMinutes - Minutes before container scales to zero.
@@ -145,8 +140,6 @@ export declare class Mongo {
         specification?: string;
         replicas?: number;
         syncMode?: string;
-        crossRegionReplicas?: number;
-        standbyRegion?: string;
         networkIdleTimeoutSeconds?: number;
         networkIPAllowlist?: string[];
         idleTimeoutMinutes?: number;
@@ -172,8 +165,6 @@ export declare class Mongo {
      * @param {string} specification - Specification. Changes cpu, memory, storage, connection ceiling, and node pool based on specification config. Resource changes are applied via rolling cutover with zero downtime.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {number} crossRegionReplicas - Number of cross-region standby replicas (0-1). Cross-region replication is enabled when greater than 0.
-     * @param {string} standbyRegion - Standby region for the cross-region replica. Required when enabling cross-region replication and no standby region is already configured. Must differ from the database region.
      * @param {number} networkIdleTimeoutSeconds - Connection idle timeout in seconds (60-86400).
      * @param {string[]} networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} idleTimeoutMinutes - Minutes before container scales to zero.
@@ -193,7 +184,7 @@ export declare class Mongo {
      * @returns {Promise<Models.DedicatedDatabase>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    update(databaseId: string, name?: string, status?: string, specification?: string, replicas?: number, syncMode?: string, crossRegionReplicas?: number, standbyRegion?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number, metricsTraceSampleRate?: number, metricsSlowQueryLogThresholdMs?: number, sqlApiEnabled?: boolean, sqlApiAllowedStatements?: string[], sqlApiMaxRows?: number, sqlApiMaxBytes?: number, sqlApiTimeoutSeconds?: number): Promise<Models.DedicatedDatabase>;
+    update(databaseId: string, name?: string, status?: string, specification?: string, replicas?: number, syncMode?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number, metricsTraceSampleRate?: number, metricsSlowQueryLogThresholdMs?: number, sqlApiEnabled?: boolean, sqlApiAllowedStatements?: string[], sqlApiMaxRows?: number, sqlApiMaxBytes?: number, sqlApiTimeoutSeconds?: number): Promise<Models.DedicatedDatabase>;
     /**
      * Delete a dedicated database. This action is irreversible. The database status will be set to 'deleting' and all resources will be cleaned up. Deletion is allowed from any state, and repeating the call re-dispatches the cleanup.
      *
@@ -545,26 +536,26 @@ export declare class Mongo {
      */
     deleteBranch(databaseId: string, branchId: string): Promise<Models.DedicatedDatabase>;
     /**
-     * Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+     * Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
      *
      * @param {string} params.databaseId - Database ID.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.DedicatedDatabase>}
+     * @returns {Promise<Models.DedicatedDatabaseOperation>}
      */
     updateCredentials(params: {
         databaseId: string;
-    }): Promise<Models.DedicatedDatabase>;
+    }): Promise<Models.DedicatedDatabaseOperation>;
     /**
-     * Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+     * Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
      *
      * @param {string} databaseId - Database ID.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.DedicatedDatabase>}
+     * @returns {Promise<Models.DedicatedDatabaseOperation>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    updateCredentials(databaseId: string): Promise<Models.DedicatedDatabase>;
+    updateCredentials(databaseId: string): Promise<Models.DedicatedDatabaseOperation>;
     /**
-     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation by a failover that did not finish also accepts this call as a repair, provided `targetReplicaId` names the member to promote.
+     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation also accepts this call as a repair once nothing is driving the operation it is stuck in. Repairing a failover that did not finish, a `failed` database, a stranded upgrade or migrate, or a stranded compute resize additionally requires `targetReplicaId` to name the member to promote, because the default target may be the member that operation already promoted.
      *
      * @param {string} params.databaseId - Database ID.
      * @param {string} params.targetReplicaId - Target replica ID to promote. If not specified, the healthiest replica is selected.
@@ -576,7 +567,7 @@ export declare class Mongo {
         targetReplicaId?: string;
     }): Promise<Models.DedicatedDatabase>;
     /**
-     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation by a failover that did not finish also accepts this call as a repair, provided `targetReplicaId` names the member to promote.
+     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation also accepts this call as a repair once nothing is driving the operation it is stuck in. Repairing a failover that did not finish, a `failed` database, a stranded upgrade or migrate, or a stranded compute resize additionally requires `targetReplicaId` to name the member to promote, because the default target may be the member that operation already promoted.
      *
      * @param {string} databaseId - Database ID.
      * @param {string} targetReplicaId - Target replica ID to promote. If not specified, the healthiest replica is selected.
@@ -738,6 +729,7 @@ export declare class Mongo {
      * @param {string} params.databaseId - Database ID.
      * @param {string} params.type - Restoration type. Allowed values: backup, pitr. Use "backup" to restore from a specific backup, or "pitr" for point-in-time recovery.
      * @param {string} params.backupId - Backup ID to restore from (required for backup type).
+     * @param {string} params.targetDatabaseId - Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version.
      * @param {string} params.targetTime - Target time for PITR (required for pitr type) as an [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseRestoration>}
@@ -746,6 +738,7 @@ export declare class Mongo {
         databaseId: string;
         type?: string;
         backupId?: string;
+        targetDatabaseId?: string;
         targetTime?: string;
     }): Promise<Models.DedicatedDatabaseRestoration>;
     /**
@@ -754,12 +747,13 @@ export declare class Mongo {
      * @param {string} databaseId - Database ID.
      * @param {string} type - Restoration type. Allowed values: backup, pitr. Use "backup" to restore from a specific backup, or "pitr" for point-in-time recovery.
      * @param {string} backupId - Backup ID to restore from (required for backup type).
+     * @param {string} targetDatabaseId - Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version.
      * @param {string} targetTime - Target time for PITR (required for pitr type) as an [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseRestoration>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    createRestoration(databaseId: string, type?: string, backupId?: string, targetTime?: string): Promise<Models.DedicatedDatabaseRestoration>;
+    createRestoration(databaseId: string, type?: string, backupId?: string, targetDatabaseId?: string, targetTime?: string): Promise<Models.DedicatedDatabaseRestoration>;
     /**
      * Get details of a specific database restoration including its status, type, and timestamps.
      *

package/types/services/mysql.d.ts

@@ -31,7 +31,6 @@ export declare class Mysql {
      * @param {string} params.specification - Specification identifier. Drives the allocated CPU, memory, storage, storage class, and connection ceiling.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {string} params.standbyRegion - Standby region for a cross-region replica. When set, a replica is provisioned in this region for cross-region high availability. Must differ from the database region.
      * @param {number} params.networkIdleTimeoutSeconds - Connection idle timeout in seconds.
      * @param {string[]} params.networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} params.idleTimeoutMinutes - Minutes of inactivity before container scales to zero.
@@ -39,7 +38,7 @@ export declare class Mysql {
      * @param {number} params.pitrRetentionDays - Number of days to retain PITR data.
      * @param {boolean} params.storageAutoscaling - Enable automatic storage expansion when usage exceeds threshold.
      * @param {number} params.storageAutoscalingThresholdPercent - Storage usage percentage (50-95) that triggers automatic expansion.
-     * @param {number} params.storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. 0 means no limit.
+     * @param {number} params.storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. Defaults to 3 times the specification's storage. 0 means no limit.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabase>}
      */
@@ -50,7 +49,6 @@ export declare class Mysql {
         specification?: string;
         replicas?: number;
         syncMode?: string;
-        standbyRegion?: string;
         networkIdleTimeoutSeconds?: number;
         networkIPAllowlist?: string[];
         idleTimeoutMinutes?: number;
@@ -69,7 +67,6 @@ export declare class Mysql {
      * @param {string} specification - Specification identifier. Drives the allocated CPU, memory, storage, storage class, and connection ceiling.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {string} standbyRegion - Standby region for a cross-region replica. When set, a replica is provisioned in this region for cross-region high availability. Must differ from the database region.
      * @param {number} networkIdleTimeoutSeconds - Connection idle timeout in seconds.
      * @param {string[]} networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} idleTimeoutMinutes - Minutes of inactivity before container scales to zero.
@@ -77,14 +74,14 @@ export declare class Mysql {
      * @param {number} pitrRetentionDays - Number of days to retain PITR data.
      * @param {boolean} storageAutoscaling - Enable automatic storage expansion when usage exceeds threshold.
      * @param {number} storageAutoscalingThresholdPercent - Storage usage percentage (50-95) that triggers automatic expansion.
-     * @param {number} storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. 0 means no limit.
+     * @param {number} storageAutoscalingMaxGb - Maximum storage size in GB for autoscaling. Defaults to 3 times the specification's storage. 0 means no limit.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabase>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    create(databaseId: string, name: string, version?: string, specification?: string, replicas?: number, syncMode?: string, standbyRegion?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number): Promise<Models.DedicatedDatabase>;
+    create(databaseId: string, name: string, version?: string, specification?: string, replicas?: number, syncMode?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number): Promise<Models.DedicatedDatabase>;
     /**
-     * List the dedicated database specifications available on the current plan. Each specification reports its resource limits, pricing, and whether it is enabled for the organization.
+     * List the dedicated database specifications available on the current plan. Each specification reports its resource limits, its own prices and overage rates, and whether it is enabled for the organization.
      *
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseSpecificationList>}
@@ -118,8 +115,6 @@ export declare class Mysql {
      * @param {string} params.specification - Specification. Changes cpu, memory, storage, connection ceiling, and node pool based on specification config. Resource changes are applied via rolling cutover with zero downtime.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {number} params.crossRegionReplicas - Number of cross-region standby replicas (0-1). Cross-region replication is enabled when greater than 0.
-     * @param {string} params.standbyRegion - Standby region for the cross-region replica. Required when enabling cross-region replication and no standby region is already configured. Must differ from the database region.
      * @param {number} params.networkIdleTimeoutSeconds - Connection idle timeout in seconds (60-86400).
      * @param {string[]} params.networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} params.idleTimeoutMinutes - Minutes before container scales to zero.
@@ -145,8 +140,6 @@ export declare class Mysql {
         specification?: string;
         replicas?: number;
         syncMode?: string;
-        crossRegionReplicas?: number;
-        standbyRegion?: string;
         networkIdleTimeoutSeconds?: number;
         networkIPAllowlist?: string[];
         idleTimeoutMinutes?: number;
@@ -172,8 +165,6 @@ export declare class Mysql {
      * @param {string} specification - Specification. Changes cpu, memory, storage, connection ceiling, and node pool based on specification config. Resource changes are applied via rolling cutover with zero downtime.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} syncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
-     * @param {number} crossRegionReplicas - Number of cross-region standby replicas (0-1). Cross-region replication is enabled when greater than 0.
-     * @param {string} standbyRegion - Standby region for the cross-region replica. Required when enabling cross-region replication and no standby region is already configured. Must differ from the database region.
      * @param {number} networkIdleTimeoutSeconds - Connection idle timeout in seconds (60-86400).
      * @param {string[]} networkIPAllowlist - IP addresses/CIDR ranges allowed to connect.
      * @param {number} idleTimeoutMinutes - Minutes before container scales to zero.
@@ -193,7 +184,7 @@ export declare class Mysql {
      * @returns {Promise<Models.DedicatedDatabase>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    update(databaseId: string, name?: string, status?: string, specification?: string, replicas?: number, syncMode?: string, crossRegionReplicas?: number, standbyRegion?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number, metricsTraceSampleRate?: number, metricsSlowQueryLogThresholdMs?: number, sqlApiEnabled?: boolean, sqlApiAllowedStatements?: string[], sqlApiMaxRows?: number, sqlApiMaxBytes?: number, sqlApiTimeoutSeconds?: number): Promise<Models.DedicatedDatabase>;
+    update(databaseId: string, name?: string, status?: string, specification?: string, replicas?: number, syncMode?: string, networkIdleTimeoutSeconds?: number, networkIPAllowlist?: string[], idleTimeoutMinutes?: number, pitr?: boolean, pitrRetentionDays?: number, storageAutoscaling?: boolean, storageAutoscalingThresholdPercent?: number, storageAutoscalingMaxGb?: number, metricsTraceSampleRate?: number, metricsSlowQueryLogThresholdMs?: number, sqlApiEnabled?: boolean, sqlApiAllowedStatements?: string[], sqlApiMaxRows?: number, sqlApiMaxBytes?: number, sqlApiTimeoutSeconds?: number): Promise<Models.DedicatedDatabase>;
     /**
      * Delete a dedicated database. This action is irreversible. The database status will be set to 'deleting' and all resources will be cleaned up. Deletion is allowed from any state, and repeating the call re-dispatches the cleanup.
      *
@@ -545,24 +536,24 @@ export declare class Mysql {
      */
     deleteBranch(databaseId: string, branchId: string): Promise<Models.DedicatedDatabase>;
     /**
-     * Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+     * Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
      *
      * @param {string} params.databaseId - Database ID.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.DedicatedDatabase>}
+     * @returns {Promise<Models.DedicatedDatabaseOperation>}
      */
     updateCredentials(params: {
         databaseId: string;
-    }): Promise<Models.DedicatedDatabase>;
+    }): Promise<Models.DedicatedDatabaseOperation>;
     /**
-     * Rotate the primary connection credentials for a dedicated database. Generates a new password and updates the database atomically. Previous credentials stop working immediately. Returns the database with a refreshed connection string carrying the new password.
+     * Queue a rotation of the primary connection credentials for a dedicated database. A hibernated database is woken by the worker before rotation. List database operations until the returned operation reaches a terminal status, then fetch the database again for the refreshed connection string.
      *
      * @param {string} databaseId - Database ID.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.DedicatedDatabase>}
+     * @returns {Promise<Models.DedicatedDatabaseOperation>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    updateCredentials(databaseId: string): Promise<Models.DedicatedDatabase>;
+    updateCredentials(databaseId: string): Promise<Models.DedicatedDatabaseOperation>;
     /**
      * Execute SQL through the console-facing Cloud endpoint. Cloud proxies through the edge platform to the per-database SQL API sidecar. Application traffic should bypass cloud entirely and POST directly to the per-database hostname: `https://db-{project}-{db}.{region}.appwrite.center/v1/sql/executions` with an `X-Appwrite-Key` header — that path scales to the whole DB fleet without a per-query cloud round-trip. The statement type must be on the database's configured allow-list. Use bound parameters for any user-supplied values — the API does not interpolate raw strings.
      *
@@ -592,7 +583,7 @@ export declare class Mysql {
      */
     createExecution(databaseId: string, sql: string, bindings?: object, timeoutSeconds?: number): Promise<Models.DedicatedDatabaseExecution>;
     /**
-     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation by a failover that did not finish also accepts this call as a repair, provided `targetReplicaId` names the member to promote.
+     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation also accepts this call as a repair once nothing is driving the operation it is stuck in. Repairing a failover that did not finish, a `failed` database, a stranded upgrade or migrate, or a stranded compute resize additionally requires `targetReplicaId` to name the member to promote, because the default target may be the member that operation already promoted.
      *
      * @param {string} params.databaseId - Database ID.
      * @param {string} params.targetReplicaId - Target replica ID to promote. If not specified, the healthiest replica is selected.
@@ -604,7 +595,7 @@ export declare class Mysql {
         targetReplicaId?: string;
     }): Promise<Models.DedicatedDatabase>;
     /**
-     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation by a failover that did not finish also accepts this call as a repair, provided `targetReplicaId` names the member to promote.
+     * Trigger a manual failover for a dedicated database with high availability enabled. Promotes a replica to primary. The failover runs asynchronously; poll the database document for status updates. A database left mid-operation also accepts this call as a repair once nothing is driving the operation it is stuck in. Repairing a failover that did not finish, a `failed` database, a stranded upgrade or migrate, or a stranded compute resize additionally requires `targetReplicaId` to name the member to promote, because the default target may be the member that operation already promoted.
      *
      * @param {string} databaseId - Database ID.
      * @param {string} targetReplicaId - Target replica ID to promote. If not specified, the healthiest replica is selected.
@@ -828,6 +819,7 @@ export declare class Mysql {
      * @param {string} params.databaseId - Database ID.
      * @param {string} params.type - Restoration type. Allowed values: backup, pitr. Use "backup" to restore from a specific backup, or "pitr" for point-in-time recovery.
      * @param {string} params.backupId - Backup ID to restore from (required for backup type).
+     * @param {string} params.targetDatabaseId - Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version.
      * @param {string} params.targetTime - Target time for PITR (required for pitr type) as an [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseRestoration>}
@@ -836,6 +828,7 @@ export declare class Mysql {
         databaseId: string;
         type?: string;
         backupId?: string;
+        targetDatabaseId?: string;
         targetTime?: string;
     }): Promise<Models.DedicatedDatabaseRestoration>;
     /**
@@ -844,12 +837,13 @@ export declare class Mysql {
      * @param {string} databaseId - Database ID.
      * @param {string} type - Restoration type. Allowed values: backup, pitr. Use "backup" to restore from a specific backup, or "pitr" for point-in-time recovery.
      * @param {string} backupId - Backup ID to restore from (required for backup type).
+     * @param {string} targetDatabaseId - Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version.
      * @param {string} targetTime - Target time for PITR (required for pitr type) as an [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime.
      * @throws {AppwriteException}
      * @returns {Promise<Models.DedicatedDatabaseRestoration>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    createRestoration(databaseId: string, type?: string, backupId?: string, targetTime?: string): Promise<Models.DedicatedDatabaseRestoration>;
+    createRestoration(databaseId: string, type?: string, backupId?: string, targetDatabaseId?: string, targetTime?: string): Promise<Models.DedicatedDatabaseRestoration>;
     /**
      * Get details of a specific database restoration including its status, type, and timestamps.
      *