appwrite 23.0.0 → 24.0.0

data/lib/appwrite/services/databases.rb

@@ -626,6 +626,132 @@ module Appwrite
 
         end
 
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createBigIntColumn` instead.
+        #
+        # Create a bigint attribute. Optionally, minimum and maximum values can be
+        # provided.
+        # 
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] collection_id Collection ID.
+        # @param [String] key Attribute Key.
+        # @param [] required Is attribute required?
+        # @param [Integer] min Minimum value
+        # @param [Integer] max Maximum value
+        # @param [Integer] default Default value. Cannot be set when attribute is required.
+        # @param [] array Is attribute an array?
+        #
+        # @return [AttributeBigint]
+        def create_big_int_attribute(database_id:, collection_id:, key:, required:, min: nil, max: nil, default: nil, array: nil)
+            api_path = '/databases/{databaseId}/collections/{collectionId}/attributes/bigint'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            if key.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "key"')
+            end
+
+            if required.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "required"')
+            end
+
+            api_params = {
+                key: key,
+                required: required,
+                min: min,
+                max: max,
+                default: default,
+                array: array,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AttributeBigint
+            )
+
+        end
+
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateBigIntColumn` instead.
+        #
+        # Update a bigint attribute. Changing the `default` value will not update
+        # already existing documents.
+        # 
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] collection_id Collection ID.
+        # @param [String] key Attribute Key.
+        # @param [] required Is attribute required?
+        # @param [Integer] default Default value. Cannot be set when attribute is required.
+        # @param [Integer] min Minimum value
+        # @param [Integer] max Maximum value
+        # @param [String] new_key New Attribute Key.
+        #
+        # @return [AttributeBigint]
+        def update_big_int_attribute(database_id:, collection_id:, key:, required:, default:, min: nil, max: nil, new_key: nil)
+            api_path = '/databases/{databaseId}/collections/{collectionId}/attributes/bigint/{key}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+                .gsub('{key}', key)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            if key.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "key"')
+            end
+
+            if required.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "required"')
+            end
+
+            if default.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "default"')
+            end
+
+            api_params = {
+                required: required,
+                min: min,
+                max: max,
+                default: default,
+                newKey: new_key,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PATCH',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::AttributeBigint
+            )
+
+        end
+
         #
         # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createBooleanColumn` instead.
         #

data/lib/appwrite/services/functions.rb

@@ -879,9 +879,11 @@ module Appwrite
         # Get a list of all variables of a specific function.
         #
         # @param [String] function_id Function unique 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. You may filter on the following attributes: key, resourceType, resourceId, secret
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
         #
         # @return [VariableList]
-        def list_variables(function_id:)
+        def list_variables(function_id:, queries: nil, total: nil)
             api_path = '/functions/{functionId}/variables'
                 .gsub('{functionId}', function_id)
 
@@ -890,6 +892,8 @@ module Appwrite
             end
 
             api_params = {
+                queries: queries,
+                total: total,
             }
             
             api_headers = {
@@ -909,12 +913,13 @@ module Appwrite
         # in the function at runtime as environment variables.
         #
         # @param [String] function_id Function unique ID.
+        # @param [String] variable_id Variable 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] key Variable key. Max length: 255 chars.
         # @param [String] value Variable value. Max length: 8192 chars.
         # @param [] secret Secret variables can be updated or deleted, but only functions can read them during build and runtime.
         #
         # @return [Variable]
-        def create_variable(function_id:, key:, value:, secret: nil)
+        def create_variable(function_id:, variable_id:, key:, value:, secret: nil)
             api_path = '/functions/{functionId}/variables'
                 .gsub('{functionId}', function_id)
 
@@ -922,6 +927,10 @@ module Appwrite
               raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
+            if variable_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "variableId"')
+            end
+
             if key.nil?
               raise Appwrite::Exception.new('Missing required parameter: "key"')
             end
@@ -931,6 +940,7 @@ module Appwrite
             end
 
             api_params = {
+                variableId: variable_id,
                 key: key,
                 value: value,
                 secret: secret,
@@ -994,7 +1004,7 @@ module Appwrite
         # @param [] secret Secret variables can be updated or deleted, but only functions can read them during build and runtime.
         #
         # @return [Variable]
-        def update_variable(function_id:, variable_id:, key:, value: nil, secret: nil)
+        def update_variable(function_id:, variable_id:, key: nil, value: nil, secret: nil)
             api_path = '/functions/{functionId}/variables/{variableId}'
                 .gsub('{functionId}', function_id)
                 .gsub('{variableId}', variable_id)
@@ -1007,10 +1017,6 @@ module Appwrite
               raise Appwrite::Exception.new('Missing required parameter: "variableId"')
             end
 
-            if key.nil?
-              raise Appwrite::Exception.new('Missing required parameter: "key"')
-            end
-
             api_params = {
                 key: key,
                 value: value,

data/lib/appwrite/services/presences.rb

@@ -0,0 +1,199 @@
+#frozen_string_literal: true
+
+module Appwrite
+    class Presences < Service
+
+        def initialize(client)
+            @client = client
+        end
+
+        # List presence logs. Expired entries are filtered out automatically.
+        # 
+        #
+        # @param [Array] queries Array of query strings generated using the Query class provided by the SDK.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
+        # @param [Integer] ttl TTL (seconds) for caching list responses. Responses are stored in an in-memory key-value cache, keyed per project, collection, schema version (attributes and indexes), caller authorization roles, and the exact query — so users with different permissions never share cached entries. Schema changes invalidate cached entries automatically; document writes do not, so choose a TTL you are comfortable serving as stale data. Set to 0 to disable caching. Must be between 0 and 86400 (24 hours).
+        #
+        # @return [PresenceList]
+        def list(queries: nil, total: nil, ttl: nil)
+            api_path = '/presences'
+
+            api_params = {
+                queries: queries,
+                total: total,
+                ttl: ttl,
+            }
+            
+            api_headers = {
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::PresenceList
+            )
+
+        end
+
+        # Get a presence log by its unique ID. Entries whose `expiresAt` is in the
+        # past are treated as not found.
+        # 
+        #
+        # @param [String] presence_id Presence unique ID.
+        #
+        # @return [Presence]
+        def get(presence_id:)
+            api_path = '/presences/{presenceId}'
+                .gsub('{presenceId}', presence_id)
+
+            if presence_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "presenceId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Presence
+            )
+
+        end
+
+        # Create or update a presence log by its user ID.
+        # 
+        #
+        # @param [String] presence_id Presence unique ID.
+        # @param [String] user_id User ID.
+        # @param [String] status Presence status.
+        # @param [Array] permissions An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).
+        # @param [String] expires_at Presence expiry datetime.
+        # @param [Hash] metadata Presence metadata object.
+        #
+        # @return [Presence]
+        def upsert(presence_id:, user_id:, status:, permissions: nil, expires_at: nil, metadata: nil)
+            api_path = '/presences/{presenceId}'
+                .gsub('{presenceId}', presence_id)
+
+            if presence_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "presenceId"')
+            end
+
+            if user_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "userId"')
+            end
+
+            if status.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "status"')
+            end
+
+            api_params = {
+                userId: user_id,
+                status: status,
+                permissions: permissions,
+                expiresAt: expires_at,
+                metadata: metadata,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PUT',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Presence
+            )
+
+        end
+
+        # Update a presence log by its unique ID. Using the patch method you can pass
+        # only specific fields that will get updated.
+        # 
+        #
+        # @param [String] presence_id Presence unique ID.
+        # @param [String] user_id User ID.
+        # @param [String] status Presence status.
+        # @param [String] expires_at Presence expiry datetime.
+        # @param [Hash] metadata Presence metadata object.
+        # @param [Array] permissions An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).
+        # @param [] purge When true, purge cached responses used by list presences endpoint.
+        #
+        # @return [Presence]
+        def update_presence(presence_id:, user_id:, status: nil, expires_at: nil, metadata: nil, permissions: nil, purge: nil)
+            api_path = '/presences/{presenceId}'
+                .gsub('{presenceId}', presence_id)
+
+            if presence_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "presenceId"')
+            end
+
+            if user_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "userId"')
+            end
+
+            api_params = {
+                userId: user_id,
+                status: status,
+                expiresAt: expires_at,
+                metadata: metadata,
+                permissions: permissions,
+                purge: purge,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PATCH',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Presence
+            )
+
+        end
+
+        # Delete a presence log by its unique ID.
+        # 
+        #
+        # @param [String] presence_id Presence unique ID.
+        #
+        # @return []
+        def delete(presence_id:)
+            api_path = '/presences/{presenceId}'
+                .gsub('{presenceId}', presence_id)
+
+            if presence_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "presenceId"')
+            end
+
+            api_params = {
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'DELETE',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+            )
+
+        end
+
+    end 
+end