appwrite 3.0.0 → 4.0.0

data/lib/appwrite/services/functions.rb

@@ -3,7 +3,6 @@
 module Appwrite
     class Functions < Service
 
-        include Models
         # Get a list of all the project's functions. You can use the query params to
         # filter your results.
         #
@@ -34,9 +33,9 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: FunctionList
+                params: params,
+                response_type: Models::FunctionList
             )
         end
 
@@ -44,7 +43,7 @@ module Appwrite
         # [permissions](/docs/permissions) to allow different project users or team
         # with access to execute the function using the client API.
         #
-        # @param [string] function_id Function ID. Choose your own unique ID or pass the string `unique()` to auto generate it. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can&#039;t start with a special char. Max length is 36 chars.
+        # @param [string] function_id Function ID. Choose your own unique ID or pass the string &quot;unique()&quot; to auto generate it. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can&#039;t start with a special char. Max length is 36 chars.
         # @param [string] name Function name. Max length: 128 chars.
         # @param [array] execute An array of strings with execution permissions. By default no user is granted with any execute permissions. [learn more about permissions](https://appwrite.io/docs/permissions) and get a full list of available permissions.
         # @param [string] runtime Execution runtime.
@@ -91,9 +90,9 @@ module Appwrite
             @client.call(
                 method: 'POST',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Function
+                params: params,
+                response_type: Models::Function
             )
         end
 
@@ -114,9 +113,9 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: RuntimeList
+                params: params,
+                response_type: Models::RuntimeList
             )
         end
 
@@ -143,9 +142,9 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Function
+                params: params,
+                response_type: Models::Function
             )
         end
 
@@ -192,9 +191,9 @@ module Appwrite
             @client.call(
                 method: 'PUT',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Function
+                params: params,
+                response_type: Models::Function
             )
         end
 
@@ -221,38 +220,38 @@ module Appwrite
             @client.call(
                 method: 'DELETE',
                 path: path,
-                params: params,
                 headers: headers,
+                params: params,
             )
         end
 
-        # Get a list of all the current user function execution logs. You can use the
-        # query params to filter your results. On admin mode, this endpoint will
-        # return a list of all of the project's executions. [Learn more about
-        # different API modes](/docs/admin).
+        # Get a list of all the project's code deployments. You can use the query
+        # params to filter your results.
         #
         # @param [string] function_id Function ID.
-        # @param [number] limit Maximum number of executions to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.
-        # @param [number] offset Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)
         # @param [string] search Search term to filter your list results. Max length: 256 chars.
-        # @param [string] cursor ID of the execution used as the starting point for the query, excluding the execution itself. Should be used for efficient pagination when working with large sets of data. [learn more about pagination](https://appwrite.io/docs/pagination)
+        # @param [number] limit Maximum number of deployments to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.
+        # @param [number] offset Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)
+        # @param [string] cursor ID of the deployment used as the starting point for the query, excluding the deployment itself. Should be used for efficient pagination when working with large sets of data. [learn more about pagination](https://appwrite.io/docs/pagination)
         # @param [string] cursor_direction Direction of the cursor.
+        # @param [string] order_type Order result by ASC or DESC order.
         #
-        # @return [ExecutionList]
-        def list_executions(function_id:, limit: nil, offset: nil, search: nil, cursor: nil, cursor_direction: nil)
+        # @return [DeploymentList]
+        def list_deployments(function_id:, search: nil, limit: nil, offset: nil, cursor: nil, cursor_direction: nil, order_type: nil)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            path = '/functions/{functionId}/executions'
+            path = '/functions/{functionId}/deployments'
                 .gsub('{functionId}', function_id)
 
             params = {
+                search: search,
                 limit: limit,
                 offset: offset,
-                search: search,
                 cursor: cursor,
                 cursorDirection: cursor_direction,
+                orderType: order_type,
             }
 
             headers = {
@@ -262,64 +261,89 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: ExecutionList
+                params: params,
+                response_type: Models::DeploymentList
             )
         end
 
-        # Trigger a function execution. The returned object will return you the
-        # current execution status. You can ping the `Get Execution` endpoint to get
-        # updates on the current execution status. Once this endpoint is called, your
-        # function execution process will start asynchronously.
+        # Create a new function code deployment. Use this endpoint to upload a new
+        # version of your code function. To execute your newly uploaded code, you'll
+        # need to update the function's deployment to use your new deployment UID.
+        # 
+        # This endpoint accepts a tar.gz file compressed with your code. Make sure to
+        # include any dependencies your code has within the compressed file. You can
+        # learn more about code packaging in the [Appwrite Cloud Functions
+        # tutorial](/docs/functions).
+        # 
+        # Use the "command" param to set the entry point used to execute your code.
         #
         # @param [string] function_id Function ID.
-        # @param [string] data String of custom data to send to function.
+        # @param [string] entrypoint Entrypoint File.
+        # @param [file] code Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.
+        # @param [boolean] activate Automatically activate the deployment when it is finished building.
         #
-        # @return [Execution]
-        def create_execution(function_id:, data: nil)
+        # @return [Deployment]
+        def create_deployment(function_id:, entrypoint:, code:, activate:, on_progress: nil)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            path = '/functions/{functionId}/executions'
+            if entrypoint.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "entrypoint"')
+            end
+
+            if code.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "code"')
+            end
+
+            if activate.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "activate"')
+            end
+
+            path = '/functions/{functionId}/deployments'
                 .gsub('{functionId}', function_id)
 
             params = {
-                data: data,
+                entrypoint: entrypoint,
+                code: code,
+                activate: activate,
             }
 
             headers = {
-                "content-type": 'application/json',
+                "content-type": 'multipart/form-data',
             }
 
-            @client.call(
-                method: 'POST',
+            param_name = 'code'
+
+            @client.chunked_upload(
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Execution
+                params: params,
+                param_name: param_name,
+                on_progress: on_progress,
+                response_type: Models::Deployment
             )
         end
 
-        # Get a function execution log by its unique ID.
+        # Get a code deployment by its unique ID.
         #
         # @param [string] function_id Function ID.
-        # @param [string] execution_id Execution ID.
+        # @param [string] deployment_id Deployment ID.
         #
-        # @return [Execution]
-        def get_execution(function_id:, execution_id:)
+        # @return [DeploymentList]
+        def get_deployment(function_id:, deployment_id:)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            if execution_id.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "executionId"')
+            if deployment_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "deploymentId"')
             end
 
-            path = '/functions/{functionId}/executions/{executionId}'
+            path = '/functions/{functionId}/deployments/{deploymentId}'
                 .gsub('{functionId}', function_id)
-                .gsub('{executionId}', execution_id)
+                .gsub('{deploymentId}', deployment_id)
 
             params = {
             }
@@ -331,34 +355,34 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Execution
+                params: params,
+                response_type: Models::DeploymentList
             )
         end
 
-        # Update the function code tag ID using the unique function ID. Use this
-        # endpoint to switch the code tag that should be executed by the execution
-        # endpoint.
+        # Update the function code deployment ID using the unique function ID. Use
+        # this endpoint to switch the code deployment that should be executed by the
+        # execution endpoint.
         #
         # @param [string] function_id Function ID.
-        # @param [string] tag Tag ID.
+        # @param [string] deployment_id Deployment ID.
         #
         # @return [Function]
-        def update_tag(function_id:, tag:)
+        def update_deployment(function_id:, deployment_id:)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            if tag.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "tag"')
+            if deployment_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "deploymentId"')
             end
 
-            path = '/functions/{functionId}/tag'
+            path = '/functions/{functionId}/deployments/{deploymentId}'
                 .gsub('{functionId}', function_id)
+                .gsub('{deploymentId}', deployment_id)
 
             params = {
-                tag: tag,
             }
 
             headers = {
@@ -368,39 +392,32 @@ module Appwrite
             @client.call(
                 method: 'PATCH',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Function
+                params: params,
+                response_type: Models::Function
             )
         end
 
-        # Get a list of all the project's code tags. You can use the query params to
-        # filter your results.
+        # Delete a code deployment by its unique ID.
         #
         # @param [string] function_id Function ID.
-        # @param [string] search Search term to filter your list results. Max length: 256 chars.
-        # @param [number] limit Maximum number of tags to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.
-        # @param [number] offset Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)
-        # @param [string] cursor ID of the tag used as the starting point for the query, excluding the tag itself. Should be used for efficient pagination when working with large sets of data. [learn more about pagination](https://appwrite.io/docs/pagination)
-        # @param [string] cursor_direction Direction of the cursor.
-        # @param [string] order_type Order result by ASC or DESC order.
+        # @param [string] deployment_id Deployment ID.
         #
-        # @return [TagList]
-        def list_tags(function_id:, search: nil, limit: nil, offset: nil, cursor: nil, cursor_direction: nil, order_type: nil)
+        # @return []
+        def delete_deployment(function_id:, deployment_id:)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            path = '/functions/{functionId}/tags'
+            if deployment_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "deploymentId"')
+            end
+
+            path = '/functions/{functionId}/deployments/{deploymentId}'
                 .gsub('{functionId}', function_id)
+                .gsub('{deploymentId}', deployment_id)
 
             params = {
-                search: search,
-                limit: limit,
-                offset: offset,
-                cursor: cursor,
-                cursorDirection: cursor_direction,
-                orderType: order_type,
             }
 
             headers = {
@@ -408,84 +425,80 @@ module Appwrite
             }
 
             @client.call(
-                method: 'GET',
+                method: 'DELETE',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: TagList
+                params: params,
             )
         end
 
-        # Create a new function code tag. Use this endpoint to upload a new version
-        # of your code function. To execute your newly uploaded code, you'll need to
-        # update the function's tag to use your new tag UID.
-        # 
-        # This endpoint accepts a tar.gz file compressed with your code. Make sure to
-        # include any dependencies your code has within the compressed file. You can
-        # learn more about code packaging in the [Appwrite Cloud Functions
-        # tutorial](/docs/functions).
         # 
-        # Use the "command" param to set the entry point used to execute your code.
         #
         # @param [string] function_id Function ID.
-        # @param [string] command Code execution command.
-        # @param [File] code Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.
+        # @param [string] deployment_id Deployment ID.
+        # @param [string] build_id Build unique ID.
         #
-        # @return [Tag]
-        def create_tag(function_id:, command:, code:)
+        # @return []
+        def retry_build(function_id:, deployment_id:, build_id:)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            if command.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "command"')
+            if deployment_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "deploymentId"')
             end
 
-            if code.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "code"')
+            if build_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "buildId"')
             end
 
-            path = '/functions/{functionId}/tags'
+            path = '/functions/{functionId}/deployments/{deploymentId}/builds/{buildId}'
                 .gsub('{functionId}', function_id)
+                .gsub('{deploymentId}', deployment_id)
+                .gsub('{buildId}', build_id)
 
             params = {
-                command: command,
-                code: code,
             }
 
             headers = {
-                "content-type": 'multipart/form-data',
+                "content-type": 'application/json',
             }
 
             @client.call(
                 method: 'POST',
                 path: path,
-                params: params,
                 headers: headers,
-                response_type: Tag
+                params: params,
             )
         end
 
-        # Get a code tag by its unique ID.
+        # Get a list of all the current user function execution logs. You can use the
+        # query params to filter your results. On admin mode, this endpoint will
+        # return a list of all of the project's executions. [Learn more about
+        # different API modes](/docs/admin).
         #
         # @param [string] function_id Function ID.
-        # @param [string] tag_id Tag ID.
+        # @param [number] limit Maximum number of executions to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.
+        # @param [number] offset Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)
+        # @param [string] search Search term to filter your list results. Max length: 256 chars.
+        # @param [string] cursor ID of the execution used as the starting point for the query, excluding the execution itself. Should be used for efficient pagination when working with large sets of data. [learn more about pagination](https://appwrite.io/docs/pagination)
+        # @param [string] cursor_direction Direction of the cursor.
         #
-        # @return [Tag]
-        def get_tag(function_id:, tag_id:)
+        # @return [ExecutionList]
+        def list_executions(function_id:, limit: nil, offset: nil, search: nil, cursor: nil, cursor_direction: nil)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            if tag_id.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "tagId"')
-            end
-
-            path = '/functions/{functionId}/tags/{tagId}'
+            path = '/functions/{functionId}/executions'
                 .gsub('{functionId}', function_id)
-                .gsub('{tagId}', tag_id)
 
             params = {
+                limit: limit,
+                offset: offset,
+                search: search,
+                cursor: cursor,
+                cursorDirection: cursor_direction,
             }
 
             headers = {
@@ -495,30 +508,66 @@ module Appwrite
             @client.call(
                 method: 'GET',
                 path: path,
+                headers: headers,
                 params: params,
+                response_type: Models::ExecutionList
+            )
+        end
+
+        # Trigger a function execution. The returned object will return you the
+        # current execution status. You can ping the `Get Execution` endpoint to get
+        # updates on the current execution status. Once this endpoint is called, your
+        # function execution process will start asynchronously.
+        #
+        # @param [string] function_id Function ID.
+        # @param [string] data String of custom data to send to function.
+        # @param [boolean] async Execute code asynchronously. Default value is true.
+        #
+        # @return [Execution]
+        def create_execution(function_id:, data: nil, async: nil)
+            if function_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "functionId"')
+            end
+
+            path = '/functions/{functionId}/executions'
+                .gsub('{functionId}', function_id)
+
+            params = {
+                data: data,
+                async: async,
+            }
+
+            headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: path,
                 headers: headers,
-                response_type: Tag
+                params: params,
+                response_type: Models::Execution
             )
         end
 
-        # Delete a code tag by its unique ID.
+        # Get a function execution log by its unique ID.
         #
         # @param [string] function_id Function ID.
-        # @param [string] tag_id Tag ID.
+        # @param [string] execution_id Execution ID.
         #
-        # @return []
-        def delete_tag(function_id:, tag_id:)
+        # @return [Execution]
+        def get_execution(function_id:, execution_id:)
             if function_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "functionId"')
             end
 
-            if tag_id.nil?
-                raise Appwrite::Exception.new('Missing required parameter: "tagId"')
+            if execution_id.nil?
+                raise Appwrite::Exception.new('Missing required parameter: "executionId"')
             end
 
-            path = '/functions/{functionId}/tags/{tagId}'
+            path = '/functions/{functionId}/executions/{executionId}'
                 .gsub('{functionId}', function_id)
-                .gsub('{tagId}', tag_id)
+                .gsub('{executionId}', execution_id)
 
             params = {
             }
@@ -528,10 +577,11 @@ module Appwrite
             }
 
             @client.call(
-                method: 'DELETE',
+                method: 'GET',
                 path: path,
-                params: params,
                 headers: headers,
+                params: params,
+                response_type: Models::Execution
             )
         end