@appwrite.io/console 14.0.0 → 15.0.0

package/types/services/compute.d.ts

@@ -35,7 +35,7 @@ export declare class Compute {
      * @param {number} params.cpu - CPU in millicores (125-16000).
      * @param {number} params.memory - Memory in MB to allocate (128-65536).
      * @param {number} params.storage - Storage in GB to allocate (1-16384).
-     * @param {string} params.storageClass - Storage class: ssd, nvme, or hdd.
+     * @param {string} params.storageClass - Storage class. Allowed values: ssd. DigitalOcean exposes a single block-storage class, so only 'ssd' is offered today.
      * @param {number} params.storageMaxGb - Maximum storage limit in GB. 0 uses system default.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.highAvailabilitySyncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
@@ -51,7 +51,7 @@ export declare class Compute {
      * @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 {boolean} params.metricsEnabled - Enable metrics collection.
+     * @param {boolean} params.metricsEnabled - Enable metrics collection. Enabled by default; pass false to opt out.
      * @param {boolean} params.poolerEnabled - Enable connection pooler on provision.
      * @param {string} params.api - Product API that owns this database: compute (raw, direct-access), tablesdb, documentsdb, or vectorsdb. tablesdb/documentsdb/vectorsdb computes are reached only through their product APIs.
      * @throws {AppwriteException}
@@ -101,7 +101,7 @@ export declare class Compute {
      * @param {number} cpu - CPU in millicores (125-16000).
      * @param {number} memory - Memory in MB to allocate (128-65536).
      * @param {number} storage - Storage in GB to allocate (1-16384).
-     * @param {string} storageClass - Storage class: ssd, nvme, or hdd.
+     * @param {string} storageClass - Storage class. Allowed values: ssd. DigitalOcean exposes a single block-storage class, so only 'ssd' is offered today.
      * @param {number} storageMaxGb - Maximum storage limit in GB. 0 uses system default.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} highAvailabilitySyncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
@@ -117,7 +117,7 @@ export declare class Compute {
      * @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 {boolean} metricsEnabled - Enable metrics collection.
+     * @param {boolean} metricsEnabled - Enable metrics collection. Enabled by default; pass false to opt out.
      * @param {boolean} poolerEnabled - Enable connection pooler on provision.
      * @param {string} api - Product API that owns this database: compute (raw, direct-access), tablesdb, documentsdb, or vectorsdb. tablesdb/documentsdb/vectorsdb computes are reached only through their product APIs.
      * @throws {AppwriteException}
@@ -156,12 +156,12 @@ export declare class Compute {
      *
      * @param {string} params.databaseId - Database ID.
      * @param {string} params.name - Database display name.
-     * @param {string} params.status - Database status. Allowed values: ready, paused, inactive. Set to "paused" to pause, "ready" to resume, or "inactive" to spin down a shared-pool database.
+     * @param {string} params.status - Database status. Allowed values: ready, paused, inactive. Set to "paused" to pause, "ready" to resume (also recovers a failed database whose infrastructure is healthy), or "inactive" to spin down a shared-pool database.
      * @param {string} params.specification - Specification. Changes cpu, memory, and node pool based on specification config.
      * @param {number} params.cpu - CPU cores to allocate (125-16000).
      * @param {number} params.memory - Memory in MB to allocate (128-65536).
      * @param {number} params.storage - Storage in GB to allocate (1-16384).
-     * @param {string} params.storageClass - Storage class. Allowed values: ssd, nvme, hdd.
+     * @param {string} params.storageClass - Storage class. Allowed values: ssd.
      * @param {number} params.replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} params.highAvailabilitySyncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
      * @param {number} params.networkMaxConnections - Maximum concurrent connections.
@@ -226,12 +226,12 @@ export declare class Compute {
      *
      * @param {string} databaseId - Database ID.
      * @param {string} name - Database display name.
-     * @param {string} status - Database status. Allowed values: ready, paused, inactive. Set to "paused" to pause, "ready" to resume, or "inactive" to spin down a shared-pool database.
+     * @param {string} status - Database status. Allowed values: ready, paused, inactive. Set to "paused" to pause, "ready" to resume (also recovers a failed database whose infrastructure is healthy), or "inactive" to spin down a shared-pool database.
      * @param {string} specification - Specification. Changes cpu, memory, and node pool based on specification config.
      * @param {number} cpu - CPU cores to allocate (125-16000).
      * @param {number} memory - Memory in MB to allocate (128-65536).
      * @param {number} storage - Storage in GB to allocate (1-16384).
-     * @param {string} storageClass - Storage class. Allowed values: ssd, nvme, hdd.
+     * @param {string} storageClass - Storage class. Allowed values: ssd.
      * @param {number} replicas - Number of high availability replicas (0-5). High availability is enabled when greater than 0.
      * @param {string} highAvailabilitySyncMode - Replication sync mode preference. Allowed values: async, sync, quorum.
      * @param {number} networkMaxConnections - Maximum concurrent connections.

package/types/services/oauth-2.d.ts

@@ -0,0 +1,261 @@
+import { Client } from '../client';
+import type { Models } from '../models';
+export declare class Oauth2 {
+    client: Client;
+    constructor(client: Client);
+    /**
+     * Approve an OAuth2 grant after the user gives consent. Returns the `redirectUrl` the end user should be sent to. The consent screen may optionally pass enriched `authorization_details` to record the concrete resources the user selected. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} params.grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @param {string} params.authorizationDetails - Enriched `authorization_details` the user consented to, replacing what the client requested. Each entry must use a `type` the project accepts. Optional; omit to keep the originally requested details.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Approve>}
+     */
+    approve(params: {
+        grantId: string;
+        authorizationDetails?: string;
+    }): Promise<Models.Oauth2Approve>;
+    /**
+     * Approve an OAuth2 grant after the user gives consent. Returns the `redirectUrl` the end user should be sent to. The consent screen may optionally pass enriched `authorization_details` to record the concrete resources the user selected. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @param {string} authorizationDetails - Enriched `authorization_details` the user consented to, replacing what the client requested. Each entry must use a `type` the project accepts. Optional; omit to keep the originally requested details.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Approve>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    approve(grantId: string, authorizationDetails?: string): Promise<Models.Oauth2Approve>;
+    /**
+     * Begin the OAuth2 authorization flow. When called without a session, the user is redirected to the consent screen without grant ID. When called with a session, the redirect URL includes param for grant ID. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} params.clientId - OAuth2 client ID.
+     * @param {string} params.redirectUri - Redirect URI where visitor will be redirected after authorization, whether successful or not.
+     * @param {string} params.responseType - OAuth2 / OIDC response type. One of `code` (Authorization Code Flow), `id_token` (Implicit Flow, OIDC login only), or `code id_token` (Hybrid Flow).
+     * @param {string} params.scope - Space-separated OAuth2 scopes. Can include project scopes, and built-in scopes: `openid`, `email`, `profile`.
+     * @param {string} params.state - OAuth2 state. You receive this back in the redirect URI.
+     * @param {string} params.nonce - OIDC nonce parameter to prevent replay attacks. Required when response_type includes `id_token`.
+     * @param {string} params.codeChallenge - PKCE code challenge. Required when OAuth2 app is public.
+     * @param {string} params.codeChallengeMethod - PKCE code challenge method. Required when OAuth2 app is public.
+     * @param {string} params.prompt - OIDC prompt parameter for customization of consent screen. Space-separated list of: none, login, consent, select_account.
+     * @param {number} params.maxAge - OIDC max_age paraleter for customization of consent screen. Maximum allowable elapsed time in seconds since the user last authenticated. If exceeded, re-authentication is required.
+     * @param {string} params.authorizationDetails - Rich authorization request. JSON array of objects, each with a `type` and project-defined fields
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Authorize>}
+     */
+    authorize(params: {
+        clientId: string;
+        redirectUri: string;
+        responseType: string;
+        scope: string;
+        state?: string;
+        nonce?: string;
+        codeChallenge?: string;
+        codeChallengeMethod?: string;
+        prompt?: string;
+        maxAge?: number;
+        authorizationDetails?: string;
+    }): Promise<Models.Oauth2Authorize>;
+    /**
+     * Begin the OAuth2 authorization flow. When called without a session, the user is redirected to the consent screen without grant ID. When called with a session, the redirect URL includes param for grant ID. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} clientId - OAuth2 client ID.
+     * @param {string} redirectUri - Redirect URI where visitor will be redirected after authorization, whether successful or not.
+     * @param {string} responseType - OAuth2 / OIDC response type. One of `code` (Authorization Code Flow), `id_token` (Implicit Flow, OIDC login only), or `code id_token` (Hybrid Flow).
+     * @param {string} scope - Space-separated OAuth2 scopes. Can include project scopes, and built-in scopes: `openid`, `email`, `profile`.
+     * @param {string} state - OAuth2 state. You receive this back in the redirect URI.
+     * @param {string} nonce - OIDC nonce parameter to prevent replay attacks. Required when response_type includes `id_token`.
+     * @param {string} codeChallenge - PKCE code challenge. Required when OAuth2 app is public.
+     * @param {string} codeChallengeMethod - PKCE code challenge method. Required when OAuth2 app is public.
+     * @param {string} prompt - OIDC prompt parameter for customization of consent screen. Space-separated list of: none, login, consent, select_account.
+     * @param {number} maxAge - OIDC max_age paraleter for customization of consent screen. Maximum allowable elapsed time in seconds since the user last authenticated. If exceeded, re-authentication is required.
+     * @param {string} authorizationDetails - Rich authorization request. JSON array of objects, each with a `type` and project-defined fields
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Authorize>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    authorize(clientId: string, redirectUri: string, responseType: string, scope: string, state?: string, nonce?: string, codeChallenge?: string, codeChallengeMethod?: string, prompt?: string, maxAge?: number, authorizationDetails?: string): Promise<Models.Oauth2Authorize>;
+    /**
+     * Start the OAuth2 Device Authorization Grant. Returns the device code, user code, verification URL, expiration, and polling interval.
+     *
+     * @param {string} params.clientId - OAuth2 client ID.
+     * @param {string} params.scope - Space-separated OAuth2 scopes. Can include project scopes, and built-in scopes: `openid`, `email`, `profile`.
+     * @param {string} params.authorizationDetails - Rich authorization request. JSON array of objects, each with a `type` and project-defined fields
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2DeviceAuthorization>}
+     */
+    createDeviceAuthorization(params?: {
+        clientId?: string;
+        scope?: string;
+        authorizationDetails?: string;
+    }): Promise<Models.Oauth2DeviceAuthorization>;
+    /**
+     * Start the OAuth2 Device Authorization Grant. Returns the device code, user code, verification URL, expiration, and polling interval.
+     *
+     * @param {string} clientId - OAuth2 client ID.
+     * @param {string} scope - Space-separated OAuth2 scopes. Can include project scopes, and built-in scopes: `openid`, `email`, `profile`.
+     * @param {string} authorizationDetails - Rich authorization request. JSON array of objects, each with a `type` and project-defined fields
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2DeviceAuthorization>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    createDeviceAuthorization(clientId?: string, scope?: string, authorizationDetails?: string): Promise<Models.Oauth2DeviceAuthorization>;
+    /**
+     * Exchange a device flow user code for an OAuth2 grant. The authenticated user is bound to the pending grant. Pass the returned grant ID to the get grant endpoint to render the consent screen, then to the approve or reject endpoint to complete the flow.
+     *
+     * @param {string} params.userCode - User code displayed on the device.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Grant>}
+     */
+    createGrant(params: {
+        userCode: string;
+    }): Promise<Models.Oauth2Grant>;
+    /**
+     * Exchange a device flow user code for an OAuth2 grant. The authenticated user is bound to the pending grant. Pass the returned grant ID to the get grant endpoint to render the consent screen, then to the approve or reject endpoint to complete the flow.
+     *
+     * @param {string} userCode - User code displayed on the device.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Grant>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    createGrant(userCode: string): Promise<Models.Oauth2Grant>;
+    /**
+     * Get an OAuth2 grant by its ID. Used by the consent screen to display the details of the authorization the user is being asked to approve. A grant can only be read by the user it belongs to, or by server SDK.
+     *
+     * @param {string} params.grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Grant>}
+     */
+    getGrant(params: {
+        grantId: string;
+    }): Promise<Models.Oauth2Grant>;
+    /**
+     * Get an OAuth2 grant by its ID. Used by the consent screen to display the details of the authorization the user is being asked to approve. A grant can only be read by the user it belongs to, or by server SDK.
+     *
+     * @param {string} grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Grant>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    getGrant(grantId: string): Promise<Models.Oauth2Grant>;
+    /**
+     * OpenID Connect RP-Initiated Logout. Ends the user session and revokes the tokens issued to the app identified by the `id_token_hint`, then redirects the user to `post_logout_redirect_uri` when it matches a URI registered on the app.
+     *
+     * @param {string} params.idTokenHint - ID Token previously issued to the app, used as proof of the logout request. Required to end the session; signature and issuer are validated while expiry is ignored.
+     * @param {string} params.logoutHint - Hint about the user that is logging out. Accepted for OIDC compatibility.
+     * @param {string} params.clientId - OAuth2 client ID. When both `client_id` and `id_token_hint` are provided, they must identify the same app.
+     * @param {string} params.postLogoutRedirectUri - URI to redirect the user to after logout. Must exactly match a URI registered in the app's `postLogoutRedirectUris`.
+     * @param {string} params.state - Opaque value passed back unchanged in the `state` query param of the post-logout redirect.
+     * @param {string} params.uiLocales - Preferred languages for any logout UI, as space-separated BCP47 tags. Accepted for OIDC compatibility.
+     * @throws {AppwriteException}
+     * @returns {Promise<{}>}
+     */
+    logout(params?: {
+        idTokenHint?: string;
+        logoutHint?: string;
+        clientId?: string;
+        postLogoutRedirectUri?: string;
+        state?: string;
+        uiLocales?: string;
+    }): Promise<{}>;
+    /**
+     * OpenID Connect RP-Initiated Logout. Ends the user session and revokes the tokens issued to the app identified by the `id_token_hint`, then redirects the user to `post_logout_redirect_uri` when it matches a URI registered on the app.
+     *
+     * @param {string} idTokenHint - ID Token previously issued to the app, used as proof of the logout request. Required to end the session; signature and issuer are validated while expiry is ignored.
+     * @param {string} logoutHint - Hint about the user that is logging out. Accepted for OIDC compatibility.
+     * @param {string} clientId - OAuth2 client ID. When both `client_id` and `id_token_hint` are provided, they must identify the same app.
+     * @param {string} postLogoutRedirectUri - URI to redirect the user to after logout. Must exactly match a URI registered in the app's `postLogoutRedirectUris`.
+     * @param {string} state - Opaque value passed back unchanged in the `state` query param of the post-logout redirect.
+     * @param {string} uiLocales - Preferred languages for any logout UI, as space-separated BCP47 tags. Accepted for OIDC compatibility.
+     * @throws {AppwriteException}
+     * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    logout(idTokenHint?: string, logoutHint?: string, clientId?: string, postLogoutRedirectUri?: string, state?: string, uiLocales?: string): Promise<{}>;
+    /**
+     * Reject an OAuth2 grant when the user denies consent. Returns the `redirectUrl` the end user should be sent to with an `access_denied` error. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} params.grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Reject>}
+     */
+    reject(params: {
+        grantId: string;
+    }): Promise<Models.Oauth2Reject>;
+    /**
+     * Reject an OAuth2 grant when the user denies consent. Returns the `redirectUrl` the end user should be sent to with an `access_denied` error. You can pass Accept header of `application/json` to receive a JSON response instead of a redirect.
+     *
+     * @param {string} grantId - Grant ID made during authorization, provided to consent screen in URL search params.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Reject>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    reject(grantId: string): Promise<Models.Oauth2Reject>;
+    /**
+     * Revoke an OAuth2 access token or refresh token.
+     *
+     * @param {string} params.token - The access or refresh token to revoke.
+     * @param {string} params.tokenTypeHint - Type of token to revoke (access_token or refresh_token).
+     * @param {string} params.clientId - OAuth2 client ID.
+     * @param {string} params.clientSecret - OAuth2 client secret. Required for confidential apps; omitted for public apps.
+     * @throws {AppwriteException}
+     * @returns {Promise<{}>}
+     */
+    revoke(params: {
+        token: string;
+        tokenTypeHint?: string;
+        clientId?: string;
+        clientSecret?: string;
+    }): Promise<{}>;
+    /**
+     * Revoke an OAuth2 access token or refresh token.
+     *
+     * @param {string} token - The access or refresh token to revoke.
+     * @param {string} tokenTypeHint - Type of token to revoke (access_token or refresh_token).
+     * @param {string} clientId - OAuth2 client ID.
+     * @param {string} clientSecret - OAuth2 client secret. Required for confidential apps; omitted for public apps.
+     * @throws {AppwriteException}
+     * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    revoke(token: string, tokenTypeHint?: string, clientId?: string, clientSecret?: string): Promise<{}>;
+    /**
+     * Exchange an OAuth2 authorization code, refresh token, or device code for access and refresh tokens.
+     *
+     * @param {string} params.grantType - OAuth2 grant type. Can be one of: `authorization_code`, `refresh_token`, `urn:ietf:params:oauth:grant-type:device_code`.
+     * @param {string} params.code - Authorization code to be exchanged for access and refresh tokens. Required for `authorization_code` grant type.
+     * @param {string} params.refreshToken - Refresh token to be exchanged for a new access and refresh tokens. Required for `refresh_token` grant type.
+     * @param {string} params.deviceCode - Device code obtained from the device authorization endpoint. Required for `urn:ietf:params:oauth:grant-type:device_code` grant type.
+     * @param {string} params.clientId - OAuth2 client ID.
+     * @param {string} params.clientSecret - OAuth2 client secret. Required for confidential apps.
+     * @param {string} params.codeVerifier - PKCE code verifier. Required for public apps.
+     * @param {string} params.redirectUri - Redirect URI. Required for `authorization_code` grant type.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Token>}
+     */
+    createToken(params: {
+        grantType: string;
+        code?: string;
+        refreshToken?: string;
+        deviceCode?: string;
+        clientId?: string;
+        clientSecret?: string;
+        codeVerifier?: string;
+        redirectUri?: string;
+    }): Promise<Models.Oauth2Token>;
+    /**
+     * Exchange an OAuth2 authorization code, refresh token, or device code for access and refresh tokens.
+     *
+     * @param {string} grantType - OAuth2 grant type. Can be one of: `authorization_code`, `refresh_token`, `urn:ietf:params:oauth:grant-type:device_code`.
+     * @param {string} code - Authorization code to be exchanged for access and refresh tokens. Required for `authorization_code` grant type.
+     * @param {string} refreshToken - Refresh token to be exchanged for a new access and refresh tokens. Required for `refresh_token` grant type.
+     * @param {string} deviceCode - Device code obtained from the device authorization endpoint. Required for `urn:ietf:params:oauth:grant-type:device_code` grant type.
+     * @param {string} clientId - OAuth2 client ID.
+     * @param {string} clientSecret - OAuth2 client secret. Required for confidential apps.
+     * @param {string} codeVerifier - PKCE code verifier. Required for public apps.
+     * @param {string} redirectUri - Redirect URI. Required for `authorization_code` grant type.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Oauth2Token>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    createToken(grantType: string, code?: string, refreshToken?: string, deviceCode?: string, clientId?: string, clientSecret?: string, codeVerifier?: string, redirectUri?: string): Promise<Models.Oauth2Token>;
+}

package/types/services/project.d.ts

@@ -1864,6 +1864,25 @@ export declare class Project {
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     updateDenyAliasedEmailPolicy(enabled: boolean): Promise<Models.Project>;
+    /**
+     * Configures if only corporate email addresses (non-free and non-disposable domains) are allowed during new user sign-ups and email updates.
+     *
+     * @param {boolean} params.enabled - Set whether or not to restrict sign-ups and email updates to corporate email addresses only.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Project>}
+     */
+    updateDenyCorporateEmailPolicy(params: {
+        enabled: boolean;
+    }): Promise<Models.Project>;
+    /**
+     * Configures if only corporate email addresses (non-free and non-disposable domains) are allowed during new user sign-ups and email updates.
+     *
+     * @param {boolean} enabled - Set whether or not to restrict sign-ups and email updates to corporate email addresses only.
+     * @throws {AppwriteException}
+     * @returns {Promise<Models.Project>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    updateDenyCorporateEmailPolicy(enabled: boolean): Promise<Models.Project>;
     /**
      * Configures if disposable emails from known temporary domains are denied during new users sign-ups and email updates.
      *
@@ -2126,22 +2145,22 @@ export declare class Project {
     /**
      * Get a policy by its unique ID. This endpoint returns the current configuration for the requested project policy.
      *
-     * @param {ProjectPolicyId} params.policyId - Policy ID. Can be one of: password-dictionary, password-history, password-strength, password-personal-data, session-alert, session-duration, session-invalidation, session-limit, user-limit, membership-privacy, deny-aliased-email, deny-disposable-email, deny-free-email.
+     * @param {ProjectPolicyId} params.policyId - Policy ID. Can be one of: password-dictionary, password-history, password-strength, password-personal-data, session-alert, session-duration, session-invalidation, session-limit, user-limit, membership-privacy, deny-aliased-email, deny-disposable-email, deny-free-email, deny-corporate-email.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail>}
+     * @returns {Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail | Models.PolicyDenyCorporateEmail>}
      */
     getPolicy(params: {
         policyId: ProjectPolicyId;
-    }): Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail>;
+    }): Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail | Models.PolicyDenyCorporateEmail>;
     /**
      * Get a policy by its unique ID. This endpoint returns the current configuration for the requested project policy.
      *
-     * @param {ProjectPolicyId} policyId - Policy ID. Can be one of: password-dictionary, password-history, password-strength, password-personal-data, session-alert, session-duration, session-invalidation, session-limit, user-limit, membership-privacy, deny-aliased-email, deny-disposable-email, deny-free-email.
+     * @param {ProjectPolicyId} policyId - Policy ID. Can be one of: password-dictionary, password-history, password-strength, password-personal-data, session-alert, session-duration, session-invalidation, session-limit, user-limit, membership-privacy, deny-aliased-email, deny-disposable-email, deny-free-email, deny-corporate-email.
      * @throws {AppwriteException}
-     * @returns {Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail>}
+     * @returns {Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail | Models.PolicyDenyCorporateEmail>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    getPolicy(policyId: ProjectPolicyId): Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail>;
+    getPolicy(policyId: ProjectPolicyId): Promise<Models.PolicyPasswordDictionary | Models.PolicyPasswordHistory | Models.PolicyPasswordStrength | Models.PolicyPasswordPersonalData | Models.PolicySessionAlert | Models.PolicySessionDuration | Models.PolicySessionInvalidation | Models.PolicySessionLimit | Models.PolicyUserLimit | Models.PolicyMembershipPrivacy | Models.PolicyDenyAliasedEmail | Models.PolicyDenyDisposableEmail | Models.PolicyDenyFreeEmail | Models.PolicyDenyCorporateEmail>;
     /**
      * Update properties of a specific protocol. Use this endpoint to enable or disable a protocol in your project.
      *
@@ -2167,7 +2186,7 @@ export declare class Project {
     /**
      * Update properties of a specific service. Use this endpoint to enable or disable a service in your project.
      *
-     * @param {ProjectServiceId} params.serviceId - Service name. Can be one of: account, avatars, databases, tablesdb, locale, health, project, storage, teams, users, vcs, sites, functions, proxy, graphql, migrations, messaging, advisor
+     * @param {ProjectServiceId} params.serviceId - Service name. Can be one of: account, avatars, databases, tablesdb, locale, health, project, storage, teams, users, vcs, sites, functions, proxy, graphql, migrations, messaging, advisor, oauth2
      * @param {boolean} params.enabled - Service status.
      * @throws {AppwriteException}
      * @returns {Promise<Models.Project>}
@@ -2179,7 +2198,7 @@ export declare class Project {
     /**
      * Update properties of a specific service. Use this endpoint to enable or disable a service in your project.
      *
-     * @param {ProjectServiceId} serviceId - Service name. Can be one of: account, avatars, databases, tablesdb, locale, health, project, storage, teams, users, vcs, sites, functions, proxy, graphql, migrations, messaging, advisor
+     * @param {ProjectServiceId} serviceId - Service name. Can be one of: account, avatars, databases, tablesdb, locale, health, project, storage, teams, users, vcs, sites, functions, proxy, graphql, migrations, messaging, advisor, oauth2
      * @param {boolean} enabled - Service status.
      * @throws {AppwriteException}
      * @returns {Promise<Models.Project>}

package/types/services/usage.d.ts

@@ -4,47 +4,125 @@ export declare class Usage {
     client: Client;
     constructor(client: Client);
     /**
-     * Query usage event metrics from the usage database. Returns individual event rows with full metadata. Pass Query objects as JSON strings to filter, paginate, and order results. Supported query methods: equal, greaterThanEqual, lessThanEqual, orderAsc, orderDesc, limit, offset. Supported filter attributes: metric, path, method, status, resource, resourceId, country, userAgent, time (these match the underlying column names — note that the response surfaces `resource` as `resourceType` and `country` as `countryCode`). When no time filter is supplied the endpoint defaults to the last 7 days. Default `limit(100)` is applied if none is given; user-supplied limits are capped at 500. The `total` field is capped at 5000 to keep counts predictable — pass `total=false` to skip the count entirely.
+     * Aggregate usage event metrics. `metric` is required.
      *
-     * @param {string[]} params.queries - Array of query strings as JSON. Supported: equal("metric", [...]), equal("path", [...]), equal("method", [...]), equal("status", [...]), equal("resource", [...]), equal("resourceId", [...]), equal("country", [...]), equal("userAgent", [...]), greaterThanEqual("time", "..."), lessThanEqual("time", "..."), orderAsc("time"), orderDesc("time"), limit(N), offset(N).
-     * @param {boolean} params.total - When set to false, the total count returned will be 0 and will not be calculated.
+     * **Two response shapes**:
+     * - Omit `interval` for a flat top-N table — one row per dimension combination, no time axis. Useful for "top 10 paths by bandwidth in the last 7 days".
+     * - Pass `interval` (`1m`, `15m`, `30m`, `1h`, `1d`) for a time series — one row per (time bucket × dimension combination).
+     *
+     * `dimensions[]` breaks each row down by one or more attributes (service, path, status, country, …). `resource` and `resourceId` filter the underlying events. `orderBy=value`+`orderDir=desc`+`limit=N` returns the top-N by aggregated value. When `startAt` is omitted, the default window adapts to `interval` (or 7d when interval is omitted).
+     *
+     * @param {string} params.metric - Metric name (required). Example: executions, network.requests.
+     * @param {string} params.resource - Resource type filter (singular form). Common values: function, site, database, bucket, file, webhook, team, user, project.
+     * @param {string} params.resourceId - Resource id filter.
+     * @param {string} params.interval - Time interval size. Omit (null) for a flat aggregate over the whole window. Allowed: 1m, 15m, 30m, 1h, 1d.
+     * @param {string[]} params.dimensions - Break-down dimensions (max 10). Allowed: path, method, status, service, country, region, hostname, osName, clientType, clientName, deviceName, teamId, resourceId.
+     * @param {string} params.startAt - Range start in ISO 8601. Defaults adapt to interval (7d for the no-interval aggregate).
+     * @param {string} params.endAt - Range end in ISO 8601. Defaults to the current time.
+     * @param {string} params.orderBy - Column to order by. Allowed: time, value. Default time when an interval is set; otherwise value.
+     * @param {string} params.orderDir - Sort direction: asc or desc. Default desc — paired with the default limit, returns the most recent / highest-value groups first.
+     * @param {number} params.limit - Maximum rows to return (1-5000).
+     * @param {number} params.offset - Pagination offset (0-100000).
      * @throws {AppwriteException}
      * @returns {Promise<Models.UsageEventList>}
      */
-    listEvents(params?: {
-        queries?: string[];
-        total?: boolean;
+    listEvents(params: {
+        metric: string;
+        resource?: string;
+        resourceId?: string;
+        interval?: string;
+        dimensions?: string[];
+        startAt?: string;
+        endAt?: string;
+        orderBy?: string;
+        orderDir?: string;
+        limit?: number;
+        offset?: number;
     }): Promise<Models.UsageEventList>;
     /**
-     * Query usage event metrics from the usage database. Returns individual event rows with full metadata. Pass Query objects as JSON strings to filter, paginate, and order results. Supported query methods: equal, greaterThanEqual, lessThanEqual, orderAsc, orderDesc, limit, offset. Supported filter attributes: metric, path, method, status, resource, resourceId, country, userAgent, time (these match the underlying column names — note that the response surfaces `resource` as `resourceType` and `country` as `countryCode`). When no time filter is supplied the endpoint defaults to the last 7 days. Default `limit(100)` is applied if none is given; user-supplied limits are capped at 500. The `total` field is capped at 5000 to keep counts predictable — pass `total=false` to skip the count entirely.
+     * Aggregate usage event metrics. `metric` is required.
+     *
+     * **Two response shapes**:
+     * - Omit `interval` for a flat top-N table — one row per dimension combination, no time axis. Useful for "top 10 paths by bandwidth in the last 7 days".
+     * - Pass `interval` (`1m`, `15m`, `30m`, `1h`, `1d`) for a time series — one row per (time bucket × dimension combination).
+     *
+     * `dimensions[]` breaks each row down by one or more attributes (service, path, status, country, …). `resource` and `resourceId` filter the underlying events. `orderBy=value`+`orderDir=desc`+`limit=N` returns the top-N by aggregated value. When `startAt` is omitted, the default window adapts to `interval` (or 7d when interval is omitted).
      *
-     * @param {string[]} queries - Array of query strings as JSON. Supported: equal("metric", [...]), equal("path", [...]), equal("method", [...]), equal("status", [...]), equal("resource", [...]), equal("resourceId", [...]), equal("country", [...]), equal("userAgent", [...]), greaterThanEqual("time", "..."), lessThanEqual("time", "..."), orderAsc("time"), orderDesc("time"), limit(N), offset(N).
-     * @param {boolean} total - When set to false, the total count returned will be 0 and will not be calculated.
+     * @param {string} metric - Metric name (required). Example: executions, network.requests.
+     * @param {string} resource - Resource type filter (singular form). Common values: function, site, database, bucket, file, webhook, team, user, project.
+     * @param {string} resourceId - Resource id filter.
+     * @param {string} interval - Time interval size. Omit (null) for a flat aggregate over the whole window. Allowed: 1m, 15m, 30m, 1h, 1d.
+     * @param {string[]} dimensions - Break-down dimensions (max 10). Allowed: path, method, status, service, country, region, hostname, osName, clientType, clientName, deviceName, teamId, resourceId.
+     * @param {string} startAt - Range start in ISO 8601. Defaults adapt to interval (7d for the no-interval aggregate).
+     * @param {string} endAt - Range end in ISO 8601. Defaults to the current time.
+     * @param {string} orderBy - Column to order by. Allowed: time, value. Default time when an interval is set; otherwise value.
+     * @param {string} orderDir - Sort direction: asc or desc. Default desc — paired with the default limit, returns the most recent / highest-value groups first.
+     * @param {number} limit - Maximum rows to return (1-5000).
+     * @param {number} offset - Pagination offset (0-100000).
      * @throws {AppwriteException}
      * @returns {Promise<Models.UsageEventList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    listEvents(queries?: string[], total?: boolean): Promise<Models.UsageEventList>;
+    listEvents(metric: string, resource?: string, resourceId?: string, interval?: string, dimensions?: string[], startAt?: string, endAt?: string, orderBy?: string, orderDir?: string, limit?: number, offset?: number): Promise<Models.UsageEventList>;
     /**
-     * Query usage gauge metrics (point-in-time resource snapshots) from the usage database. Returns individual gauge snapshots with metric, value, timestamp, resourceType, and resourceId. Pass Query objects as JSON strings to filter, paginate, and order results. Supported query methods: equal, greaterThanEqual, lessThanEqual, orderAsc, orderDesc, limit, offset. Supported filter attributes: metric, time. Use `orderDesc("time"), limit(1)` to fetch the most recent snapshot. When no time filter is supplied the endpoint defaults to the last 7 days. Default `limit(100)` is applied if none is given; user-supplied limits are capped at 500. The `total` field is capped at 5000 to keep counts predictable — pass `total=false` to skip the count entirely.
+     * Aggregate usage gauge snapshots. Gauges are point-in-time values (storage totals, resource counts, …); each group carries the latest snapshot in its interval via `argMax(value, time)`. `metric` is required.
      *
-     * @param {string[]} params.queries - Array of query strings as JSON. Supported: equal("metric", [...]), greaterThanEqual("time", "..."), lessThanEqual("time", "..."), orderAsc("time"), orderDesc("time"), limit(N), offset(N).
-     * @param {boolean} params.total - When set to false, the total count returned will be 0 and will not be calculated.
+     * **Two response shapes**:
+     * - Omit `interval` for a flat top-N table — `argMax(value, time)` per dimension combination over the whole window, no time axis. Useful for "top 10 resources by current storage".
+     * - Pass `interval` (`1m`, `15m`, `30m`, `1h`, `1d`) for a time series — one snapshot per (time bucket × dimension combination).
+     *
+     * `dimensions[]` breaks each row down further — only `resourceId` and `teamId` are supported on gauges. `resourceId` and `teamId` parameters filter the underlying rows. `orderBy=value`+`orderDir=desc`+`limit=N` returns the top-N. When `startAt` is omitted, the default window adapts to interval (or 7d when interval is omitted).
+     *
+     * @param {string} params.metric - Metric name (required). Example: files.storage, deployments.storage.
+     * @param {string} params.resourceId - Resource id filter.
+     * @param {string} params.teamId - Team id filter.
+     * @param {string} params.interval - Time interval size. Omit (null) for a flat aggregate over the whole window. Allowed: 1m, 15m, 30m, 1h, 1d.
+     * @param {string[]} params.dimensions - Break-down dimensions. Allowed: resourceId, teamId.
+     * @param {string} params.startAt - Range start in ISO 8601. Defaults to endAt - 7d.
+     * @param {string} params.endAt - Range end in ISO 8601. Defaults to the current time.
+     * @param {string} params.orderBy - Column to order by. Allowed: time, value. Default time.
+     * @param {string} params.orderDir - Sort direction: asc or desc. Default desc — paired with the default limit, this returns the most recent groups first. Pass asc for chronological charting.
+     * @param {number} params.limit - Maximum rows to return (1-5000).
+     * @param {number} params.offset - Pagination offset (0-100000).
      * @throws {AppwriteException}
      * @returns {Promise<Models.UsageGaugeList>}
      */
-    listGauges(params?: {
-        queries?: string[];
-        total?: boolean;
+    listGauges(params: {
+        metric: string;
+        resourceId?: string;
+        teamId?: string;
+        interval?: string;
+        dimensions?: string[];
+        startAt?: string;
+        endAt?: string;
+        orderBy?: string;
+        orderDir?: string;
+        limit?: number;
+        offset?: number;
     }): Promise<Models.UsageGaugeList>;
     /**
-     * Query usage gauge metrics (point-in-time resource snapshots) from the usage database. Returns individual gauge snapshots with metric, value, timestamp, resourceType, and resourceId. Pass Query objects as JSON strings to filter, paginate, and order results. Supported query methods: equal, greaterThanEqual, lessThanEqual, orderAsc, orderDesc, limit, offset. Supported filter attributes: metric, time. Use `orderDesc("time"), limit(1)` to fetch the most recent snapshot. When no time filter is supplied the endpoint defaults to the last 7 days. Default `limit(100)` is applied if none is given; user-supplied limits are capped at 500. The `total` field is capped at 5000 to keep counts predictable — pass `total=false` to skip the count entirely.
+     * Aggregate usage gauge snapshots. Gauges are point-in-time values (storage totals, resource counts, …); each group carries the latest snapshot in its interval via `argMax(value, time)`. `metric` is required.
+     *
+     * **Two response shapes**:
+     * - Omit `interval` for a flat top-N table — `argMax(value, time)` per dimension combination over the whole window, no time axis. Useful for "top 10 resources by current storage".
+     * - Pass `interval` (`1m`, `15m`, `30m`, `1h`, `1d`) for a time series — one snapshot per (time bucket × dimension combination).
+     *
+     * `dimensions[]` breaks each row down further — only `resourceId` and `teamId` are supported on gauges. `resourceId` and `teamId` parameters filter the underlying rows. `orderBy=value`+`orderDir=desc`+`limit=N` returns the top-N. When `startAt` is omitted, the default window adapts to interval (or 7d when interval is omitted).
      *
-     * @param {string[]} queries - Array of query strings as JSON. Supported: equal("metric", [...]), greaterThanEqual("time", "..."), lessThanEqual("time", "..."), orderAsc("time"), orderDesc("time"), limit(N), offset(N).
-     * @param {boolean} total - When set to false, the total count returned will be 0 and will not be calculated.
+     * @param {string} metric - Metric name (required). Example: files.storage, deployments.storage.
+     * @param {string} resourceId - Resource id filter.
+     * @param {string} teamId - Team id filter.
+     * @param {string} interval - Time interval size. Omit (null) for a flat aggregate over the whole window. Allowed: 1m, 15m, 30m, 1h, 1d.
+     * @param {string[]} dimensions - Break-down dimensions. Allowed: resourceId, teamId.
+     * @param {string} startAt - Range start in ISO 8601. Defaults to endAt - 7d.
+     * @param {string} endAt - Range end in ISO 8601. Defaults to the current time.
+     * @param {string} orderBy - Column to order by. Allowed: time, value. Default time.
+     * @param {string} orderDir - Sort direction: asc or desc. Default desc — paired with the default limit, this returns the most recent groups first. Pass asc for chronological charting.
+     * @param {number} limit - Maximum rows to return (1-5000).
+     * @param {number} offset - Pagination offset (0-100000).
      * @throws {AppwriteException}
      * @returns {Promise<Models.UsageGaugeList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    listGauges(queries?: string[], total?: boolean): Promise<Models.UsageGaugeList>;
+    listGauges(metric: string, resourceId?: string, teamId?: string, interval?: string, dimensions?: string[], startAt?: string, endAt?: string, orderBy?: string, orderDir?: string, limit?: number, offset?: number): Promise<Models.UsageGaugeList>;
 }