node-appwrite 4.0.2 → 6.0.0

package/lib/services/functions.js

@@ -1,5 +1,8 @@
 const Service = require('../service.js');
 const AppwriteException = require('../exception.js');
+const client = require('../client.js');
+const { promisify } = require('util');
+const fs = require('fs');
 
 class Functions extends Service {
 
@@ -127,9 +130,9 @@ class Functions extends Service {
     }
 
     /**
-     * List the currently active function runtimes.
+     * List runtimes
      *
-     * Get a list of all runtimes that are currently active in your project.
+     * Get a list of all runtimes that are currently active on your instance.
      *
      * @throws {AppwriteException}
      * @returns {Promise}
@@ -248,30 +251,33 @@ class Functions extends Service {
     }
 
     /**
-     * List Executions
+     * List Deployments
      *
-     * 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} functionId
+     * @param {string} search
      * @param {number} limit
      * @param {number} offset
-     * @param {string} search
      * @param {string} cursor
      * @param {string} cursorDirection
+     * @param {string} orderType
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async listExecutions(functionId, limit, offset, search, cursor, cursorDirection) {
+    async listDeployments(functionId, search, limit, offset, cursor, cursorDirection, orderType) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        let path = '/functions/{functionId}/executions'.replace('{functionId}', functionId);
+        let path = '/functions/{functionId}/deployments'.replace('{functionId}', functionId);
         let payload = {};
 
+        if (typeof search !== 'undefined') {
+            payload['search'] = search;
+        }
+
         if (typeof limit !== 'undefined') {
             payload['limit'] = limit;
         }
@@ -280,10 +286,6 @@ class Functions extends Service {
             payload['offset'] = offset;
         }
 
-        if (typeof search !== 'undefined') {
-            payload['search'] = search;
-        }
-
         if (typeof cursor !== 'undefined') {
             payload['cursor'] = cursor;
         }
@@ -292,61 +294,145 @@ class Functions extends Service {
             payload['cursorDirection'] = cursorDirection;
         }
 
+        if (typeof orderType !== 'undefined') {
+            payload['orderType'] = orderType;
+        }
+
         return await this.client.call('get', path, {
             'content-type': 'application/json',
         }, payload);
     }
 
     /**
-     * Create Execution
+     * Create Deployment
      *
-     * 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} functionId
-     * @param {string} data
+     * @param {string} entrypoint
+     * @param {string} code
+     * @param {boolean} activate
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async createExecution(functionId, data) {
+    async createDeployment(functionId, entrypoint, code, activate, onProgress = () => {}) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        let path = '/functions/{functionId}/executions'.replace('{functionId}', functionId);
+        if (typeof entrypoint === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "entrypoint"');
+        }
+
+        if (typeof code === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "code"');
+        }
+
+        if (typeof activate === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "activate"');
+        }
+
+        let path = '/functions/{functionId}/deployments'.replace('{functionId}', functionId);
         let payload = {};
 
-        if (typeof data !== 'undefined') {
-            payload['data'] = data;
+        if (typeof entrypoint !== 'undefined') {
+            payload['entrypoint'] = entrypoint;
         }
 
-        return await this.client.call('post', path, {
-            'content-type': 'application/json',
-        }, payload);
+        if (typeof code !== 'undefined') {
+            payload['code'] = code.toString();
+        }
+
+        if (typeof activate !== 'undefined') {
+            payload['activate'] = activate.toString();
+        }
+
+        const { size: size } = await promisify(fs.stat)(code);
+
+        if (size <= client.CHUNK_SIZE) {
+            payload['code'] = fs.createReadStream(code);
+                
+            return await this.client.call('post', path, {
+                'content-type': 'multipart/form-data',
+            }, payload);
+        } else {
+            let id = undefined;
+            let response = undefined;
+
+            let counter = 0;
+            const totalCounters = Math.ceil(size / client.CHUNK_SIZE);
+
+            const headers = {
+                'content-type': 'multipart/form-data',
+            };
+
+
+            for (counter; counter < totalCounters; counter++) {
+                const start = (counter * client.CHUNK_SIZE);
+                const end = Math.min((((counter * client.CHUNK_SIZE) + client.CHUNK_SIZE) - 1), size);
+
+                headers['content-range'] = 'bytes ' + start + '-' + end + '/' + size;
+
+                if (id) {
+                    headers['x-appwrite-id'] = id;
+                }
+
+                const stream = fs.createReadStream(code, {
+                    start,
+                    end
+                });
+                payload['code'] = stream;
+
+                response = await this.client.call('post', path, headers, payload);
+
+                if (!id) {
+                    id = response['$id'];
+                }
+                
+                if (onProgress !== null) {
+                    onProgress({
+                        $id: response['$id'],
+                        progress: Math.min((counter+1) * client.CHUNK_SIZE, size) / size * 100,
+                        sizeUploaded: end+1,
+                        chunksTotal: response['chunksTotal'],
+                        chunksUploaded: response['chunksUploaded']
+                    });
+                }
+            }
+
+            return response;
+        }
     }
 
     /**
-     * Get Execution
+     * Get Deployment
      *
-     * Get a function execution log by its unique ID.
+     * Get a code deployment by its unique ID.
      *
      * @param {string} functionId
-     * @param {string} executionId
+     * @param {string} deploymentId
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async getExecution(functionId, executionId) {
+    async getDeployment(functionId, deploymentId) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof executionId === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "executionId"');
+        if (typeof deploymentId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "deploymentId"');
         }
 
-        let path = '/functions/{functionId}/executions/{executionId}'.replace('{functionId}', functionId).replace('{executionId}', executionId);
+        let path = '/functions/{functionId}/deployments/{deploymentId}'.replace('{functionId}', functionId).replace('{deploymentId}', deploymentId);
         let payload = {};
 
         return await this.client.call('get', path, {
@@ -355,190 +441,199 @@ class Functions extends Service {
     }
 
     /**
-     * Update Function Tag
+     * Update Function Deployment
      *
-     * 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} functionId
-     * @param {string} tag
+     * @param {string} deploymentId
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async updateTag(functionId, tag) {
+    async updateDeployment(functionId, deploymentId) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof tag === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "tag"');
+        if (typeof deploymentId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "deploymentId"');
         }
 
-        let path = '/functions/{functionId}/tag'.replace('{functionId}', functionId);
+        let path = '/functions/{functionId}/deployments/{deploymentId}'.replace('{functionId}', functionId).replace('{deploymentId}', deploymentId);
         let payload = {};
 
-        if (typeof tag !== 'undefined') {
-            payload['tag'] = tag;
-        }
-
         return await this.client.call('patch', path, {
             'content-type': 'application/json',
         }, payload);
     }
 
     /**
-     * List Tags
+     * Delete Deployment
      *
-     * 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} functionId
-     * @param {string} search
-     * @param {number} limit
-     * @param {number} offset
-     * @param {string} cursor
-     * @param {string} cursorDirection
-     * @param {string} orderType
+     * @param {string} deploymentId
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async listTags(functionId, search, limit, offset, cursor, cursorDirection, orderType) {
+    async deleteDeployment(functionId, deploymentId) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        let path = '/functions/{functionId}/tags'.replace('{functionId}', functionId);
-        let payload = {};
-
-        if (typeof search !== 'undefined') {
-            payload['search'] = search;
+        if (typeof deploymentId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "deploymentId"');
         }
 
-        if (typeof limit !== 'undefined') {
-            payload['limit'] = limit;
-        }
+        let path = '/functions/{functionId}/deployments/{deploymentId}'.replace('{functionId}', functionId).replace('{deploymentId}', deploymentId);
+        let payload = {};
 
-        if (typeof offset !== 'undefined') {
-            payload['offset'] = offset;
-        }
+        return await this.client.call('delete', path, {
+            'content-type': 'application/json',
+        }, payload);
+    }
 
-        if (typeof cursor !== 'undefined') {
-            payload['cursor'] = cursor;
+    /**
+     * Retry Build
+     *
+     * @param {string} functionId
+     * @param {string} deploymentId
+     * @param {string} buildId
+     * @throws {AppwriteException}
+     * @returns {Promise}
+     */
+    async retryBuild(functionId, deploymentId, buildId) {
+        if (typeof functionId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof cursorDirection !== 'undefined') {
-            payload['cursorDirection'] = cursorDirection;
+        if (typeof deploymentId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "deploymentId"');
         }
 
-        if (typeof orderType !== 'undefined') {
-            payload['orderType'] = orderType;
+        if (typeof buildId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "buildId"');
         }
 
-        return await this.client.call('get', path, {
+        let path = '/functions/{functionId}/deployments/{deploymentId}/builds/{buildId}'.replace('{functionId}', functionId).replace('{deploymentId}', deploymentId).replace('{buildId}', buildId);
+        let payload = {};
+
+        return await this.client.call('post', path, {
             'content-type': 'application/json',
         }, payload);
     }
 
     /**
-     * Create Tag
+     * List Executions
      *
-     * 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.
+     * 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} functionId
-     * @param {string} command
-     * @param {File} code
+     * @param {number} limit
+     * @param {number} offset
+     * @param {string} search
+     * @param {string} cursor
+     * @param {string} cursorDirection
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async createTag(functionId, command, code) {
+    async listExecutions(functionId, limit, offset, search, cursor, cursorDirection) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof command === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "command"');
+        let path = '/functions/{functionId}/executions'.replace('{functionId}', functionId);
+        let payload = {};
+
+        if (typeof limit !== 'undefined') {
+            payload['limit'] = limit;
         }
 
-        if (typeof code === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "code"');
+        if (typeof offset !== 'undefined') {
+            payload['offset'] = offset;
         }
 
-        let path = '/functions/{functionId}/tags'.replace('{functionId}', functionId);
-        let payload = {};
+        if (typeof search !== 'undefined') {
+            payload['search'] = search;
+        }
 
-        if (typeof command !== 'undefined') {
-            payload['command'] = command;
+        if (typeof cursor !== 'undefined') {
+            payload['cursor'] = cursor;
         }
 
-        if (typeof code !== 'undefined') {
-            payload['code'] = code;
+        if (typeof cursorDirection !== 'undefined') {
+            payload['cursorDirection'] = cursorDirection;
         }
 
-        return await this.client.call('post', path, {
-            'content-type': 'multipart/form-data',
+        return await this.client.call('get', path, {
+            'content-type': 'application/json',
         }, payload);
     }
 
     /**
-     * Get Tag
+     * Create Execution
      *
-     * Get a code tag by its unique ID.
+     * 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} functionId
-     * @param {string} tagId
+     * @param {string} data
+     * @param {boolean} async
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async getTag(functionId, tagId) {
+    async createExecution(functionId, data, async) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof tagId === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "tagId"');
+        let path = '/functions/{functionId}/executions'.replace('{functionId}', functionId);
+        let payload = {};
+
+        if (typeof data !== 'undefined') {
+            payload['data'] = data;
         }
 
-        let path = '/functions/{functionId}/tags/{tagId}'.replace('{functionId}', functionId).replace('{tagId}', tagId);
-        let payload = {};
+        if (typeof async !== 'undefined') {
+            payload['async'] = async;
+        }
 
-        return await this.client.call('get', path, {
+        return await this.client.call('post', path, {
             'content-type': 'application/json',
         }, payload);
     }
 
     /**
-     * Delete Tag
+     * Get Execution
      *
-     * Delete a code tag by its unique ID.
+     * Get a function execution log by its unique ID.
      *
      * @param {string} functionId
-     * @param {string} tagId
+     * @param {string} executionId
      * @throws {AppwriteException}
      * @returns {Promise}
      */
-    async deleteTag(functionId, tagId) {
+    async getExecution(functionId, executionId) {
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
 
-        if (typeof tagId === 'undefined') {
-            throw new AppwriteException('Missing required parameter: "tagId"');
+        if (typeof executionId === 'undefined') {
+            throw new AppwriteException('Missing required parameter: "executionId"');
         }
 
-        let path = '/functions/{functionId}/tags/{tagId}'.replace('{functionId}', functionId).replace('{tagId}', tagId);
+        let path = '/functions/{functionId}/executions/{executionId}'.replace('{functionId}', functionId).replace('{executionId}', executionId);
         let payload = {};
 
-        return await this.client.call('delete', path, {
+        return await this.client.call('get', path, {
             'content-type': 'application/json',
         }, payload);
     }

package/lib/services/health.js

@@ -1,5 +1,8 @@
 const Service = require('../service.js');
 const AppwriteException = require('../exception.js');
+const client = require('../client.js');
+const { promisify } = require('util');
+const fs = require('fs');
 
 class Health extends Service {
 
@@ -124,24 +127,6 @@ class Health extends Service {
         }, payload);
     }
 
-    /**
-     * Get Usage Queue
-     *
-     * Get the number of usage stats that are waiting to be processed in the
-     * Appwrite internal queue server.
-     *
-     * @throws {AppwriteException}
-     * @returns {Promise}
-     */
-    async getQueueUsage() {
-        let path = '/health/queue/usage';
-        let payload = {};
-
-        return await this.client.call('get', path, {
-            'content-type': 'application/json',
-        }, payload);
-    }
-
     /**
      * Get Webhooks Queue
      *

package/lib/services/locale.js

@@ -1,5 +1,8 @@
 const Service = require('../service.js');
 const AppwriteException = require('../exception.js');
+const client = require('../client.js');
+const { promisify } = require('util');
+const fs = require('fs');
 
 class Locale extends Service {