appwrite 26.0.0 → 26.1.0

data/lib/appwrite/services/organization.rb

@@ -89,6 +89,174 @@ module Appwrite
 
         end
 
+        # List app installations on the organization. Any organization member can
+        # read installations.
+        #
+        # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
+        #
+        # @return [AppInstallationList]
+        def list_installations(queries: nil, total: nil)
+            api_path = '/organization/installations'
+
+            api_params = {
+                queries: queries,
+                total: total,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallationList
+            )
+
+        end
+
+        # Install an app on the organization. Only organization members with the
+        # owner role can install apps. The installation is granted the scopes the app
+        # currently requests.
+        #
+        # @param [String] app_id Application unique ID.
+        # @param [String] authorization_details Authorization details granted to the installation as a JSON array of objects, each with a `type` and app-defined fields. The Appwrite Console stores authorized project IDs here.
+        #
+        # @return [AppInstallation]
+        def create_installation(app_id:, authorization_details: nil)
+            api_path = '/organization/installations'
+
+            if app_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "appId"')
+            end
+
+            api_params = {
+                appId: app_id,
+                authorizationDetails: authorization_details,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Get an app installation on the organization by its unique ID. Any
+        # organization member can read installations.
+        #
+        # @param [String] installation_id Installation unique ID.
+        #
+        # @return [AppInstallation]
+        def get_installation(installation_id:)
+            api_path = '/organization/installations/{installationId}'
+                .gsub('{installationId}', installation_id)
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Update an app installation on the organization. Only organization members
+        # with the owner role can update installations. The installation's granted
+        # scopes are refreshed to the scopes the app currently requests; previously
+        # issued installation access tokens are revoked.
+        #
+        # @param [String] installation_id Installation unique ID.
+        # @param [String] authorization_details Authorization details granted to the installation as a JSON array of objects, each with a `type` and app-defined fields. Omit to keep the current value.
+        #
+        # @return [AppInstallation]
+        def update_installation(installation_id:, authorization_details: nil)
+            api_path = '/organization/installations/{installationId}'
+                .gsub('{installationId}', installation_id)
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+                authorizationDetails: authorization_details,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'PUT',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Uninstall an app from the organization by its installation ID. Only
+        # organization members with the owner role can remove installations.
+        # Previously issued installation access tokens are revoked.
+        #
+        # @param [String] installation_id Installation unique ID.
+        #
+        # @return []
+        def delete_installation(installation_id:)
+            api_path = '/organization/installations/{installationId}'
+                .gsub('{installationId}', installation_id)
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'DELETE',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+            )
+
+        end
+
         # Get a list of all API keys from the current organization.
         #
         # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: expire, accessedAt, name, scopes

data/lib/appwrite/services/project.rb

@@ -569,6 +569,7 @@ module Appwrite
         # @param [Integer] refresh_token_duration Refresh token duration in seconds for confidential clients (server-side apps that authenticate with a client secret). Leave empty to use default 1 year.
         # @param [Integer] public_access_token_duration Access token duration in seconds for public clients (SPAs, mobile, and native apps that cannot keep a client secret). Leave empty to use default 1 hour.
         # @param [Integer] public_refresh_token_duration Refresh token duration in seconds for public clients (SPAs, mobile, and native apps that cannot keep a client secret). Leave empty to use default 30 days.
+        # @param [Integer] installation_access_token_duration Access token duration in seconds for app installation access tokens. Leave empty to use default 1 hour.
         # @param [] confidential_pkce When enabled, PKCE is required for confidential clients (server-side flows using client_secret). PKCE is always required for public clients regardless of this setting.
         # @param [String] verification_url URL to your application page where users enter the device flow user code. Required to enable the Device Authorization Grant.
         # @param [Integer] user_code_length Number of characters in the device flow user code, excluding the formatting separator. Shorter codes are easier to type but weaker; pair short codes with short expiry. Leave empty to use default 8.
@@ -577,7 +578,7 @@ module Appwrite
         # @param [Array] default_scopes List of OAuth2 scopes used when an authorization request omits the scope parameter. Every default scope must also be allowed by the OAuth2 server. Maximum of 100 scopes are allowed, each up to 128 characters long.
         #
         # @return [Project]
-        def update_o_auth2_server(enabled:, authorization_url:, scopes: nil, authorization_details_types: nil, access_token_duration: nil, refresh_token_duration: nil, public_access_token_duration: nil, public_refresh_token_duration: nil, confidential_pkce: nil, verification_url: nil, user_code_length: nil, user_code_format: nil, device_code_duration: nil, default_scopes: nil)
+        def update_o_auth2_server(enabled:, authorization_url:, scopes: nil, authorization_details_types: nil, access_token_duration: nil, refresh_token_duration: nil, public_access_token_duration: nil, public_refresh_token_duration: nil, installation_access_token_duration: nil, confidential_pkce: nil, verification_url: nil, user_code_length: nil, user_code_format: nil, device_code_duration: nil, default_scopes: nil)
             api_path = '/project/oauth2-server'
 
             if enabled.nil?
@@ -597,6 +598,7 @@ module Appwrite
                 refreshTokenDuration: refresh_token_duration,
                 publicAccessTokenDuration: public_access_token_duration,
                 publicRefreshTokenDuration: public_refresh_token_duration,
+                installationAccessTokenDuration: installation_access_token_duration,
                 confidentialPkce: confidential_pkce,
                 verificationUrl: verification_url,
                 userCodeLength: user_code_length,

data/lib/appwrite/services/sites.rb

@@ -693,9 +693,10 @@ module Appwrite
         # @param [String] site_id Site ID.
         # @param [String] deployment_id Deployment ID.
         # @param [DeploymentDownloadType] type Deployment file to download. Can be: "source", "output".
+        # @param [String] token Presigned source-download token for accessing this deployment without a session (jobs-service).
         #
         # @return []
-        def get_deployment_download(site_id:, deployment_id:, type: nil)
+        def get_deployment_download(site_id:, deployment_id:, type: nil, token: nil)
             api_path = '/sites/{siteId}/deployments/{deploymentId}/download'
                 .gsub('{siteId}', site_id)
                 .gsub('{deploymentId}', deployment_id)
@@ -710,6 +711,7 @@ module Appwrite
 
             api_params = {
                 type: type,
+                token: token,
             }
             
             api_headers = {

data/lib/appwrite/services/tables_db.rb

@@ -46,9 +46,10 @@ module Appwrite
         # @param [String] name Database name. Max length: 128 chars.
         # @param [] enabled Is the database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
         # @param [String] specification Database specification. Defaults to `serverless`, which creates the database on the shared pool. Any other value provisions a dedicated database on that specification.
+        # @param [Integer] replicas Number of high availability replicas (0-5) for the dedicated database backing this database. Requires a dedicated `specification`; must be 0 for a serverless database. High availability is enabled when greater than 0.
         #
         # @return [Database]
-        def create(database_id:, name:, enabled: nil, specification: nil)
+        def create(database_id:, name:, enabled: nil, specification: nil, replicas: nil)
             api_path = '/tablesdb'
 
             if database_id.nil?
@@ -64,6 +65,7 @@ module Appwrite
                 name: name,
                 enabled: enabled,
                 specification: specification,
+                replicas: replicas,
             }
             
             api_headers = {
@@ -82,6 +84,33 @@ module Appwrite
 
         end
 
+        # 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.
+        #
+        #
+        # @return [DedicatedDatabaseSpecificationList]
+        def list_specifications()
+            api_path = '/tablesdb/specifications'
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DedicatedDatabaseSpecificationList
+            )
+
+        end
+
         # List transactions across all databases.
         #
         # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries).
@@ -305,9 +334,10 @@ module Appwrite
         # @param [String] database_id Database ID.
         # @param [String] name Database name. Max length: 128 chars.
         # @param [] enabled Is database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
+        # @param [Integer] replicas Number of high availability replicas (0-5) for the dedicated database backing this database. Only valid when the database is backed by a dedicated specification. High availability is enabled when greater than 0.
         #
         # @return [Database]
-        def update(database_id:, name: nil, enabled: nil)
+        def update(database_id:, name: nil, enabled: nil, replicas: nil)
             api_path = '/tablesdb/{databaseId}'
                 .gsub('{databaseId}', database_id)
 
@@ -318,6 +348,7 @@ module Appwrite
             api_params = {
                 name: name,
                 enabled: enabled,
+                replicas: replicas,
             }
             
             api_headers = {
@@ -367,6 +398,107 @@ module Appwrite
 
         end
 
+        # 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.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] target_replica_id Target replica ID to promote. If not specified, the healthiest replica is selected.
+        #
+        # @return [DedicatedDatabase]
+        def create_failover(database_id:, target_replica_id: nil)
+            api_path = '/tablesdb/{databaseId}/failovers'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            api_params = {
+                targetReplicaId: target_replica_id,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DedicatedDatabase
+            )
+
+        end
+
+        # Get high availability status for a dedicated database. Returns replica
+        # statuses, replication lag, and sync mode.
+        #
+        # @param [String] database_id Database ID.
+        #
+        # @return [DedicatedDatabaseReplicas]
+        def get_replicas(database_id:)
+            api_path = '/tablesdb/{databaseId}/replicas'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DedicatedDatabaseReplicas
+            )
+
+        end
+
+        # Get real-time health and status information for a dedicated database.
+        # Returns health status, readiness, uptime, connection info, replica status,
+        # and volume information.
+        #
+        # @param [String] database_id Database ID.
+        #
+        # @return [DatabaseStatus]
+        def get_status(database_id:)
+            api_path = '/tablesdb/{databaseId}/status'
+                .gsub('{databaseId}', database_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DatabaseStatus
+            )
+
+        end
+
         # Get a list of all tables that belong to the provided databaseId. You can
         # use the search parameter to filter your results.
         #

data/lib/appwrite/services/teams.rb

@@ -181,6 +181,204 @@ module Appwrite
 
         end
 
+        # List app installations on a team. Any team member can read installations.
+        #
+        # @param [String] team_id Team ID.
+        # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
+        #
+        # @return [AppInstallationList]
+        def list_installations(team_id:, queries: nil, total: nil)
+            api_path = '/teams/{teamId}/installations'
+                .gsub('{teamId}', team_id)
+
+            if team_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "teamId"')
+            end
+
+            api_params = {
+                queries: queries,
+                total: total,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallationList
+            )
+
+        end
+
+        # Install an app on a team. When authenticated as a user, only team members
+        # with the owner role can install apps. Requests using an API key or in admin
+        # mode can install apps on any team. The installation is granted the scopes
+        # the app currently requests.
+        #
+        # @param [String] team_id Team ID.
+        # @param [String] app_id Application unique ID.
+        # @param [String] authorization_details Authorization details granted to the installation as a JSON array of objects, each with a `type` and app-defined fields. The Appwrite Console stores authorized project IDs here.
+        #
+        # @return [AppInstallation]
+        def create_installation(team_id:, app_id:, authorization_details: nil)
+            api_path = '/teams/{teamId}/installations'
+                .gsub('{teamId}', team_id)
+
+            if team_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "teamId"')
+            end
+
+            if app_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "appId"')
+            end
+
+            api_params = {
+                appId: app_id,
+                authorizationDetails: authorization_details,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Get an app installation on a team by its unique ID. Any team member can
+        # read installations.
+        #
+        # @param [String] team_id Team ID.
+        # @param [String] installation_id Installation unique ID.
+        #
+        # @return [AppInstallation]
+        def get_installation(team_id:, installation_id:)
+            api_path = '/teams/{teamId}/installations/{installationId}'
+                .gsub('{teamId}', team_id)
+                .gsub('{installationId}', installation_id)
+
+            if team_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "teamId"')
+            end
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Update an app installation on a team. Only team members with the owner role
+        # can update installations. The installation's granted scopes are refreshed
+        # to the scopes the app currently requests; previously issued installation
+        # access tokens are revoked.
+        #
+        # @param [String] team_id Team ID.
+        # @param [String] installation_id Installation unique ID.
+        # @param [String] authorization_details Authorization details granted to the installation as a JSON array of objects, each with a `type` and app-defined fields. Omit to keep the current value.
+        #
+        # @return [AppInstallation]
+        def update_installation(team_id:, installation_id:, authorization_details: nil)
+            api_path = '/teams/{teamId}/installations/{installationId}'
+                .gsub('{teamId}', team_id)
+                .gsub('{installationId}', installation_id)
+
+            if team_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "teamId"')
+            end
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+                authorizationDetails: authorization_details,
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'PUT',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AppInstallation
+            )
+
+        end
+
+        # Uninstall an app from a team by its installation ID. Only team members with
+        # the owner role can remove installations. Previously issued installation
+        # access tokens are revoked.
+        #
+        # @param [String] team_id Team ID.
+        # @param [String] installation_id Installation unique ID.
+        #
+        # @return []
+        def delete_installation(team_id:, installation_id:)
+            api_path = '/teams/{teamId}/installations/{installationId}'
+                .gsub('{teamId}', team_id)
+                .gsub('{installationId}', installation_id)
+
+            if team_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "teamId"')
+            end
+
+            if installation_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "installationId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'DELETE',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+            )
+
+        end
+
         # Use this endpoint to list a team's members using the team's ID. All team
         # members have read access to this endpoint. Hide sensitive attributes from
         # the response by toggling membership privacy in the Console.

data/lib/appwrite.rb

@@ -234,6 +234,10 @@ require_relative 'appwrite/models/billing_plan_limits'
 require_relative 'appwrite/models/billing_plan_dedicated_database_limits'
 require_relative 'appwrite/models/billing_plan_supported_addons'
 require_relative 'appwrite/models/block'
+require_relative 'appwrite/models/dedicated_database'
+require_relative 'appwrite/models/database_status'
+require_relative 'appwrite/models/dedicated_database_member'
+require_relative 'appwrite/models/dedicated_database_replicas'
 require_relative 'appwrite/models/organization'
 require_relative 'appwrite/models/backup_policy'
 require_relative 'appwrite/models/policy_deny_aliased_email'
@@ -242,11 +246,43 @@ require_relative 'appwrite/models/policy_deny_free_email'
 require_relative 'appwrite/models/policy_deny_corporate_email'
 require_relative 'appwrite/models/program'
 require_relative 'appwrite/models/backup_restoration'
+require_relative 'appwrite/models/dedicated_database_specification'
+require_relative 'appwrite/models/dedicated_database_specification_list'
+require_relative 'appwrite/models/dedicated_database_specification_pricing'
+require_relative 'appwrite/models/database_status_connections'
+require_relative 'appwrite/models/database_status_replica'
+require_relative 'appwrite/models/database_status_volume'
 require_relative 'appwrite/models/usage_billing_plan'
+require_relative 'appwrite/models/app'
+require_relative 'appwrite/models/app_secret'
+require_relative 'appwrite/models/app_secret_plaintext'
+require_relative 'appwrite/models/app_scope'
+require_relative 'appwrite/models/app_installation'
+require_relative 'appwrite/models/app_key'
+require_relative 'appwrite/models/oauth2_authorize'
+require_relative 'appwrite/models/oauth2_approve'
+require_relative 'appwrite/models/oauth2_reject'
+require_relative 'appwrite/models/oauth2_grant'
+require_relative 'appwrite/models/oauth2_device_authorization'
+require_relative 'appwrite/models/oauth2_par'
+require_relative 'appwrite/models/oauth2_token'
+require_relative 'appwrite/models/oauth2_consent'
+require_relative 'appwrite/models/oauth2_consent_token'
+require_relative 'appwrite/models/oauth2_project'
+require_relative 'appwrite/models/oauth2_organization'
+require_relative 'appwrite/models/oauth2_project_list'
+require_relative 'appwrite/models/oauth2_organization_list'
+require_relative 'appwrite/models/oauth2_consent_list'
+require_relative 'appwrite/models/oauth2_consent_token_list'
 require_relative 'appwrite/models/activity_event_list'
 require_relative 'appwrite/models/backup_archive_list'
 require_relative 'appwrite/models/backup_policy_list'
 require_relative 'appwrite/models/backup_restoration_list'
+require_relative 'appwrite/models/apps_list'
+require_relative 'appwrite/models/app_secret_list'
+require_relative 'appwrite/models/app_scope_list'
+require_relative 'appwrite/models/app_installation_list'
+require_relative 'appwrite/models/app_key_list'
 
 require_relative 'appwrite/enums/authenticator_type'
 require_relative 'appwrite/enums/authentication_factor'
@@ -311,6 +347,7 @@ require_relative 'appwrite/enums/billing_plan_group'
 
 require_relative 'appwrite/services/account'
 require_relative 'appwrite/services/activities'
+require_relative 'appwrite/services/apps'
 require_relative 'appwrite/services/avatars'
 require_relative 'appwrite/services/backups'
 require_relative 'appwrite/services/databases'
@@ -318,6 +355,7 @@ require_relative 'appwrite/services/functions'
 require_relative 'appwrite/services/graphql'
 require_relative 'appwrite/services/locale'
 require_relative 'appwrite/services/messaging'
+require_relative 'appwrite/services/oauth2'
 require_relative 'appwrite/services/organization'
 require_relative 'appwrite/services/presences'
 require_relative 'appwrite/services/project'