appwrite-cli 0.15.0 → 0.17.1

package/lib/commands/functions.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -84,7 +87,7 @@ const functionsCreate = async ({ functionId, name, execute, runtime, vars, event
     }
 
     if (typeof vars !== 'undefined') {
-        payload['vars'] = vars;
+        payload['vars'] = JSON.parse(vars);
     }
 
     if (typeof events !== 'undefined') {
@@ -169,7 +172,7 @@ const functionsUpdate = async ({ functionId, name, execute, vars, events, schedu
     }
 
     if (typeof vars !== 'undefined') {
-        payload['vars'] = vars;
+        payload['vars'] = JSON.parse(vars);
     }
 
     if (typeof events !== 'undefined') {
@@ -277,16 +280,31 @@ const functionsCreateDeployment = async ({ functionId, entrypoint, code, activat
     if (!fs.lstatSync(folderPath).isDirectory())
         throw new Error('The path is not a directory.');
     
+    const ignorer = ignore();
+
+    const func = localConfig.getFunction(functionId);
+
+    if(func.ignore) {
+        ignorer.add(func.ignore);
+        log('Ignoring files using configuration from appwrite.json');
+    } else if(fs.existsSync(pathLib.join(code, '.gitignore'))) {
+        ignorer.add(fs.readFileSync(pathLib.join(code, '.gitignore')).toString());
+        log('Ignoring files in .gitignore');
+    }
+    
+    const files = getAllFiles(code).map((file) => pathLib.relative(code, file)).filter((file) => !ignorer.ignores(file));
+
     await tar
         .create({
             gzip: true,
             sync: true,
             cwd: folderPath,
             file: 'code.tar.gz'
-        }, ['./'])
+        }, files);
     let archivePath = fs.realpathSync('code.tar.gz')
     if (typeof archivePath !== 'undefined') {
         payload['code'] = archivePath;
+        code = archivePath;
     }
 
     if (typeof activate !== 'undefined') {
@@ -301,46 +319,53 @@ const functionsCreateDeployment = async ({ functionId, entrypoint, code, activat
 
         response = await client.call('post', path, {
             'content-type': 'multipart/form-data',
-        }, payload);
+        }, payload).catch(err => {
+            fs.unlinkSync(archivePath);
+            throw err
+        });
     } else {
         const streamFilePath = payload['code'];
         let id = undefined;
 
+        let counter = 0;
         const totalCounters = Math.ceil(size / libClient.CHUNK_SIZE);
 
-        for (let counter = 0; counter < totalCounters; counter++) {
-                const start = (counter * libClient.CHUNK_SIZE);
-                const end = Math.min((((counter * libClient.CHUNK_SIZE) + libClient.CHUNK_SIZE) - 1), size);
-                const headers = {
-                        'content-type': 'multipart/form-data',
-                        'content-range': 'bytes ' + start + '-' + end + '/' + size
-                };
-
-                if (id) {
-                        headers['x-appwrite-id'] = id;
-                }
-
-                const stream = fs.createReadStream(streamFilePath, {
-                        start,
-                        end
+        const headers = {
+            'content-type': 'multipart/form-data',
+        };
+
+
+        for (counter; counter < totalCounters; counter++) {
+            const start = (counter * libClient.CHUNK_SIZE);
+            const end = Math.min((((counter * libClient.CHUNK_SIZE) + libClient.CHUNK_SIZE) - 1), size);
+
+            headers['content-range'] = 'bytes ' + start + '-' + end + '/' + size;
+
+            if (id) {
+                headers['x-appwrite-id'] = id;
+            }
+
+            const stream = fs.createReadStream(streamFilePath, {
+                start,
+                end
+            });
+            payload['code'] = stream;
+
+            response = await client.call('post', path, headers, payload);
+
+            if (!id) {
+                id = response['$id'];
+            }
+
+            if (onProgress !== null) {
+                onProgress({
+                    $id: response['$id'],
+                    progress: Math.min((counter+1) * libClient.CHUNK_SIZE, size) / size * 100,
+                    sizeUploaded: end+1,
+                    chunksTotal: response['chunksTotal'],
+                    chunksUploaded: response['chunksUploaded']
                 });
-                payload['code'] = stream;
-
-                response = await client.call('post', path, headers, payload);
-
-                if (!id) {
-                        id = response['$id'];
-                }
-
-                if (onProgress !== null) {
-                    onProgress({
-                        $id: response['$id'],
-                        progress: Math.min((counter+1) * libClient.CHUNK_SIZE, size) / size * 100,
-                        sizeUploaded: end+1,
-                        chunksTotal: response['chunksTotal'],
-                        chunksUploaded: response['chunksUploaded']
-                    });
-                }
+            }
         }
     }
 
@@ -560,10 +585,10 @@ functions
     .description(`Create a new function. You can pass a list of [permissions](/docs/permissions) to allow different project users or team with access to execute the function using the client API.`)
     .requiredOption(`--functionId <functionId>`, `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't start with a special char. Max length is 36 chars.`)
     .requiredOption(`--name <name>`, `Function name. Max length: 128 chars.`)
-    .requiredOption(`--execute <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.`)
+    .requiredOption(`--execute <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. Maximum of 100 scopes are allowed, each 64 characters long.`)
     .requiredOption(`--runtime <runtime>`, `Execution runtime.`)
     .option(`--vars <vars>`, `Key-value JSON object that will be passed to the function as environment variables.`)
-    .option(`--events <events...>`, `Events list.`)
+    .option(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
     .option(`--schedule <schedule>`, `Schedule CRON syntax.`)
     .option(`--timeout <timeout>`, `Function maximum execution time in seconds.`, parseInteger)
     .action(actionRunner(functionsCreate))
@@ -584,9 +609,9 @@ functions
     .description(`Update function by its unique ID.`)
     .requiredOption(`--functionId <functionId>`, `Function ID.`)
     .requiredOption(`--name <name>`, `Function name. Max length: 128 chars.`)
-    .requiredOption(`--execute <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.`)
+    .requiredOption(`--execute <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. Maximum of 100 scopes are allowed, each 64 characters long.`)
     .option(`--vars <vars>`, `Key-value JSON object that will be passed to the function as environment variables.`)
-    .option(`--events <events...>`, `Events list.`)
+    .option(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
     .option(`--schedule <schedule>`, `Schedule CRON syntax.`)
     .option(`--timeout <timeout>`, `Maximum execution time in seconds.`, parseInteger)
     .action(actionRunner(functionsUpdate))
@@ -699,4 +724,4 @@ module.exports = {
     functionsCreateExecution,
     functionsGetExecution,
     functionsGetUsage
-};
+};

package/lib/commands/generic.js

@@ -1,5 +1,6 @@
 const inquirer = require("inquirer");
 const { Command } = require("commander");
+const Client = require("../client");
 const { sdkForConsole } = require("../sdks");
 const { globalConfig, localConfig } = require("../config");
 const { actionRunner, success, parseBool, commandDescriptions, log, parse } = require("../parser");
@@ -65,13 +66,19 @@ const client = new Command("client")
         if (endpoint !== undefined) {
             try {
                 let url = new URL(endpoint);
-                if (url.protocol === "http:" || url.protocol === "https:") {
-                    globalConfig.setEndpoint(endpoint);
-                } else {
+                if (url.protocol !== "http:" && url.protocol !== "https:") {
                     throw new Error();
                 }
+                
+                let client = new Client().setEndpoint(endpoint);
+                let response = await client.call('GET', '/health/version');
+                if(!response.version) {
+                    throw new Error();
+                }
+                
+                globalConfig.setEndpoint(endpoint);
             } catch (_) {
-                throw new Error("Invalid endpoint");
+                throw new Error("Invalid endpoint or your Appwrite server is not running as expected.");
             }
         }
 

package/lib/commands/health.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -128,23 +131,6 @@ const healthGetQueueLogs = async ({ parseOutput = true, sdk = undefined}) => {
     return response;
 }
 
-const healthGetQueueUsage = async ({ parseOutput = true, sdk = undefined}) => {
-
-    let client = !sdk ? await sdkForProject() : sdk;
-    let path = '/health/queue/usage';
-    let payload = {};
-    let response = undefined;
-    response = await client.call('get', path, {
-        'content-type': 'application/json',
-    }, payload);
-    
-    if (parseOutput) {
-        parse(response)
-        success()
-    }
-    return response;
-}
-
 const healthGetQueueWebhooks = async ({ parseOutput = true, sdk = undefined}) => {
 
     let client = !sdk ? await sdkForProject() : sdk;
@@ -232,11 +218,6 @@ health
     .description(`Get the number of logs that are waiting to be processed in the Appwrite internal queue server.`)
     .action(actionRunner(healthGetQueueLogs))
 
-health
-    .command(`getQueueUsage`)
-    .description(`Get the number of usage stats that are waiting to be processed in the Appwrite internal queue server.`)
-    .action(actionRunner(healthGetQueueUsage))
-
 health
     .command(`getQueueWebhooks`)
     .description(`Get the number of webhooks that are waiting to be processed in the Appwrite internal queue server.`)
@@ -262,8 +243,7 @@ module.exports = {
     healthGetQueueCertificates,
     healthGetQueueFunctions,
     healthGetQueueLogs,
-    healthGetQueueUsage,
     healthGetQueueWebhooks,
     healthGetStorageLocal,
     healthGetTime
-};
+};

package/lib/commands/init.js

@@ -99,6 +99,7 @@ const initFunction = async () => {
     runtime: response.runtime,
     path: `functions/${answers.name}`,
     entrypoint: answers.runtime.entrypoint || '',
+    ignore: answers.runtime.ignore || null,
     execute: response.execute,
     events: response.events,
     schedule: response.schedule,

package/lib/commands/locale.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -174,4 +177,4 @@ module.exports = {
     localeGetCountriesPhones,
     localeGetCurrencies,
     localeGetLanguages
-};
+};

package/lib/commands/projects.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -1018,7 +1021,7 @@ projects
     .description(``)
     .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
     .requiredOption(`--name <name>`, `Key name. Max length: 128 chars.`)
-    .requiredOption(`--scopes <scopes...>`, `Key scopes list.`)
+    .requiredOption(`--scopes <scopes...>`, `Key scopes list. Maximum of 100 scopes are allowed.`)
     .action(actionRunner(projectsCreateKey))
 
 projects
@@ -1034,7 +1037,7 @@ projects
     .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
     .requiredOption(`--keyId <keyId>`, `Key unique ID.`)
     .requiredOption(`--name <name>`, `Key name. Max length: 128 chars.`)
-    .requiredOption(`--scopes <scopes...>`, `Key scopes list`)
+    .requiredOption(`--scopes <scopes...>`, `Key scopes list. Maximum of 100 events are allowed.`)
     .action(actionRunner(projectsUpdateKey))
 
 projects
@@ -1121,7 +1124,7 @@ projects
     .description(``)
     .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
     .requiredOption(`--name <name>`, `Webhook name. Max length: 128 chars.`)
-    .requiredOption(`--events <events...>`, `Events list.`)
+    .requiredOption(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
     .requiredOption(`--url <url>`, `Webhook URL.`)
     .requiredOption(`--security <security>`, `Certificate verification, false for disabled or true for enabled.`, parseBool)
     .option(`--httpUser <httpUser>`, `Webhook HTTP user. Max length: 256 chars.`)
@@ -1141,7 +1144,7 @@ projects
     .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
     .requiredOption(`--webhookId <webhookId>`, `Webhook unique ID.`)
     .requiredOption(`--name <name>`, `Webhook name. Max length: 128 chars.`)
-    .requiredOption(`--events <events...>`, `Events list.`)
+    .requiredOption(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
     .requiredOption(`--url <url>`, `Webhook URL.`)
     .requiredOption(`--security <security>`, `Certificate verification, false for disabled or true for enabled.`, parseBool)
     .option(`--httpUser <httpUser>`, `Webhook HTTP user. Max length: 256 chars.`)
@@ -1188,4 +1191,4 @@ module.exports = {
     projectsGetWebhook,
     projectsUpdateWebhook,
     projectsDeleteWebhook
-};
+};

package/lib/commands/storage.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -303,46 +306,57 @@ const storageCreateFile = async ({ bucketId, fileId, file, read, write, parseOut
 
         response = await client.call('post', path, {
             'content-type': 'multipart/form-data',
-        }, payload);
+        }, payload)
     } else {
         const streamFilePath = payload['file'];
         let id = undefined;
 
+        let counter = 0;
         const totalCounters = Math.ceil(size / libClient.CHUNK_SIZE);
 
-        for (let counter = 0; counter < totalCounters; counter++) {
-                const start = (counter * libClient.CHUNK_SIZE);
-                const end = Math.min((((counter * libClient.CHUNK_SIZE) + libClient.CHUNK_SIZE) - 1), size);
-                const headers = {
-                        'content-type': 'multipart/form-data',
-                        'content-range': 'bytes ' + start + '-' + end + '/' + size
-                };
-
-                if (id) {
-                        headers['x-appwrite-id'] = id;
-                }
-
-                const stream = fs.createReadStream(streamFilePath, {
-                        start,
-                        end
+        const headers = {
+            'content-type': 'multipart/form-data',
+        };
+
+        if(fileId != 'unique()') {
+            try {
+                response = await client.call('get', path + '/' + fileId, headers);
+                counter = response.chunksUploaded;
+            } catch(e) {
+            }
+        }
+
+        for (counter; counter < totalCounters; counter++) {
+            const start = (counter * libClient.CHUNK_SIZE);
+            const end = Math.min((((counter * libClient.CHUNK_SIZE) + libClient.CHUNK_SIZE) - 1), size);
+
+            headers['content-range'] = 'bytes ' + start + '-' + end + '/' + size;
+
+            if (id) {
+                headers['x-appwrite-id'] = id;
+            }
+
+            const stream = fs.createReadStream(streamFilePath, {
+                start,
+                end
+            });
+            payload['file'] = stream;
+
+            response = await client.call('post', path, headers, payload);
+
+            if (!id) {
+                id = response['$id'];
+            }
+
+            if (onProgress !== null) {
+                onProgress({
+                    $id: response['$id'],
+                    progress: Math.min((counter+1) * libClient.CHUNK_SIZE, size) / size * 100,
+                    sizeUploaded: end+1,
+                    chunksTotal: response['chunksTotal'],
+                    chunksUploaded: response['chunksUploaded']
                 });
-                payload['file'] = stream;
-
-                response = await client.call('post', path, headers, payload);
-
-                if (!id) {
-                        id = response['$id'];
-                }
-
-                if (onProgress !== null) {
-                    onProgress({
-                        $id: response['$id'],
-                        progress: Math.min((counter+1) * libClient.CHUNK_SIZE, size) / size * 100,
-                        sizeUploaded: end+1,
-                        chunksTotal: response['chunksTotal'],
-                        chunksUploaded: response['chunksUploaded']
-                    });
-                }
+            }
         }
     }
     
@@ -609,7 +623,7 @@ storage
     .option(`--write <write...>`, `An array of strings with write permissions. By default no user is granted with any write permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
     .option(`--enabled <enabled>`, `Is bucket enabled?`, parseBool)
     .option(`--maximumFileSize <maximumFileSize>`, `Maximum file size allowed in bytes. Maximum allowed value is 30MB. For self-hosted setups you can change the max limit by changing the '_APP_STORAGE_LIMIT' environment variable. [Learn more about storage environment variables](docs/environment-variables#storage)`, parseInteger)
-    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions`)
+    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions. Maximum of 100 extensions are allowed, each 64 characters long.`)
     .option(`--encryption <encryption>`, `Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled`, parseBool)
     .option(`--antivirus <antivirus>`, `Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled`, parseBool)
     .action(actionRunner(storageCreateBucket))
@@ -630,7 +644,7 @@ storage
     .option(`--write <write...>`, `An array of strings with write permissions. By default inherits the existing write permissions. [learn more about permissions](/docs/permissions) and get a full list of available permissions.`)
     .option(`--enabled <enabled>`, `Is bucket enabled?`, parseBool)
     .option(`--maximumFileSize <maximumFileSize>`, `Maximum file size allowed in bytes. Maximum allowed value is 30MB. For self hosted version you can change the limit by changing _APP_STORAGE_LIMIT environment variable. [Learn more about storage environment variables](docs/environment-variables#storage)`, parseInteger)
-    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions`)
+    .option(`--allowedFileExtensions <allowedFileExtensions...>`, `Allowed file extensions. Maximum of 100 extensions are allowed, each 64 characters long.`)
     .option(`--encryption <encryption>`, `Is encryption enabled? For file size above 20MB encryption is skipped even if it's enabled`, parseBool)
     .option(`--antivirus <antivirus>`, `Is virus scanning enabled? For file size above 20MB AntiVirus scanning is skipped even if it's enabled`, parseBool)
     .action(actionRunner(storageUpdateBucket))
@@ -752,4 +766,4 @@ module.exports = {
     storageGetFileView,
     storageGetUsage,
     storageGetBucketUsage
-};
+};

package/lib/commands/teams.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -147,6 +150,34 @@ const teamsDelete = async ({ teamId, parseOutput = true, sdk = undefined}) => {
     return response;
 }
 
+const teamsListLogs = async ({ teamId, limit, offset, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} teamId */
+    /* @param {number} limit */
+    /* @param {number} offset */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/teams/{teamId}/logs'.replace('{teamId}', teamId);
+    let payload = {};
+
+    /** Query Params */
+    if (typeof limit !== 'undefined') {
+        payload['limit'] = limit;
+    }
+    if (typeof offset !== 'undefined') {
+        payload['offset'] = offset;
+    }
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
 const teamsGetMemberships = async ({ teamId, search, limit, offset, cursor, cursorDirection, orderType, parseOutput = true, sdk = undefined}) => {
     /* @param {string} teamId */
     /* @param {string} search */
@@ -343,7 +374,7 @@ teams
     .description(`Create a new team. The user who creates the team will automatically be assigned as the owner of the team. Only the users with the owner role can invite new members, add new owners and delete or update the team.`)
     .requiredOption(`--teamId <teamId>`, `Team 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't start with a special char. Max length is 36 chars.`)
     .requiredOption(`--name <name>`, `Team name. Max length: 128 chars.`)
-    .option(`--roles <roles...>`, `Array of strings. Use this param to set the roles in the team for the user who created it. The default role is **owner**. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Max length for each role is 32 chars.`)
+    .option(`--roles <roles...>`, `Array of strings. Use this param to set the roles in the team for the user who created it. The default role is **owner**. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Maximum of 100 roles are allowed, each 32 characters long.`)
     .action(actionRunner(teamsCreate))
 
 teams
@@ -365,6 +396,14 @@ teams
     .requiredOption(`--teamId <teamId>`, `Team ID.`)
     .action(actionRunner(teamsDelete))
 
+teams
+    .command(`listLogs`)
+    .description(`Get the team activity logs list by its unique ID.`)
+    .requiredOption(`--teamId <teamId>`, `Team ID.`)
+    .option(`--limit <limit>`, `Maximum number of logs to return in response. By default will return maximum 25 results. Maximum of 100 results allowed per request.`, parseInteger)
+    .option(`--offset <offset>`, `Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)`, parseInteger)
+    .action(actionRunner(teamsListLogs))
+
 teams
     .command(`getMemberships`)
     .description(`Use this endpoint to list a team's members using the team's ID. All team members have read access to this endpoint.`)
@@ -382,7 +421,7 @@ teams
     .description(`Invite a new member to join your team. If initiated from the client SDK, an email with a link to join the team will be sent to the member's email address and an account will be created for them should they not be signed up already. If initiated from server-side SDKs, the new member will automatically be added to the team.  Use the 'url' parameter to redirect the user from the invitation email back to your app. When the user is redirected, use the [Update Team Membership Status](/docs/client/teams#teamsUpdateMembershipStatus) endpoint to allow the user to accept the invitation to the team.   Please note that to avoid a [Redirect Attack](https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.md) the only valid redirect URL's are the once from domains you have set when adding your platforms in the console interface.`)
     .requiredOption(`--teamId <teamId>`, `Team ID.`)
     .requiredOption(`--email <email>`, `Email of the new team member.`)
-    .requiredOption(`--roles <roles...>`, `Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Max length for each role is 32 chars.`)
+    .requiredOption(`--roles <roles...>`, `Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](/docs/permissions). Maximum of 100 roles are allowed, each 32 characters long.`)
     .requiredOption(`--url <url>`, `URL to redirect the user back to your app from the invitation email.  Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.`)
     .option(`--name <name>`, `Name of the new team member. Max length: 128 chars.`)
     .action(actionRunner(teamsCreateMembership))
@@ -399,7 +438,7 @@ teams
     .description(`Modify the roles of a team member. Only team members with the owner role have access to this endpoint. Learn more about [roles and permissions](/docs/permissions).`)
     .requiredOption(`--teamId <teamId>`, `Team ID.`)
     .requiredOption(`--membershipId <membershipId>`, `Membership ID.`)
-    .requiredOption(`--roles <roles...>`, `An array of strings. Use this param to set the user's roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Max length for each role is 32 chars.`)
+    .requiredOption(`--roles <roles...>`, `An array of strings. Use this param to set the user's roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 32 characters long.`)
     .action(actionRunner(teamsUpdateMembershipRoles))
 
 teams
@@ -426,10 +465,11 @@ module.exports = {
     teamsGet,
     teamsUpdate,
     teamsDelete,
+    teamsListLogs,
     teamsGetMemberships,
     teamsCreateMembership,
     teamsGetMembership,
     teamsUpdateMembershipRoles,
     teamsDeleteMembership,
     teamsUpdateMembershipStatus
-};
+};

package/lib/commands/users.js

@@ -1,7 +1,10 @@
 const fs = require('fs');
+const pathLib = require('path');
 const tar = require("tar");
+const ignore = require("ignore");
 const { promisify } = require('util');
 const libClient = require('../client.js');
+const { getAllFiles } = require('../utils.js');
 const { Command } = require('commander');
 const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
@@ -207,6 +210,24 @@ const usersGetLogs = async ({ userId, limit, offset, parseOutput = true, sdk = u
     return response;
 }
 
+const usersGetMemberships = async ({ userId, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} userId */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/users/{userId}/memberships'.replace('{userId}', userId);
+    let payload = {};
+    let response = undefined;
+    response = await client.call('get', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
 const usersUpdateName = async ({ userId, name, parseOutput = true, sdk = undefined}) => {
     /* @param {string} userId */
     /* @param {string} name */
@@ -285,7 +306,7 @@ const usersUpdatePrefs = async ({ userId, prefs, parseOutput = true, sdk = undef
     
     /** Body Params */
     if (typeof prefs !== 'undefined') {
-        payload['prefs'] = prefs;
+        payload['prefs'] = JSON.parse(prefs);
     }
 
     let response = undefined;
@@ -441,7 +462,7 @@ users
 
 users
     .command(`delete`)
-    .description(`Delete a user by its unique ID.`)
+    .description(`Delete a user by its unique ID, thereby releasing it's ID. Since ID is released and can be reused, all user-related resources like documents or storage files should be deleted before user deletion. If you want to keep ID reserved, use the [updateStatus](/docs/server/users#usersUpdateStatus) endpoint instead.`)
     .requiredOption(`--userId <userId>`, `User ID.`)
     .action(actionRunner(usersDelete))
 
@@ -460,6 +481,12 @@ users
     .option(`--offset <offset>`, `Offset value. The default value is 0. Use this value to manage pagination. [learn more about pagination](https://appwrite.io/docs/pagination)`, parseInteger)
     .action(actionRunner(usersGetLogs))
 
+users
+    .command(`getMemberships`)
+    .description(`Get the user membership list by its unique ID.`)
+    .requiredOption(`--userId <userId>`, `User ID.`)
+    .action(actionRunner(usersGetMemberships))
+
 users
     .command(`updateName`)
     .description(`Update the user name by its unique ID.`)
@@ -508,7 +535,7 @@ users
 
 users
     .command(`updateStatus`)
-    .description(`Update the user status by its unique ID.`)
+    .description(`Update the user status by its unique ID. Use this endpoint as an alternative to deleting a user if you want to keep user's ID reserved.`)
     .requiredOption(`--userId <userId>`, `User ID.`)
     .requiredOption(`--status <status>`, `User Status. To activate the user pass 'true' and to block the user pass 'false'.`, parseBool)
     .action(actionRunner(usersUpdateStatus))
@@ -530,6 +557,7 @@ module.exports = {
     usersDelete,
     usersUpdateEmail,
     usersGetLogs,
+    usersGetMemberships,
     usersUpdateName,
     usersUpdatePassword,
     usersGetPrefs,
@@ -539,4 +567,4 @@ module.exports = {
     usersDeleteSession,
     usersUpdateStatus,
     usersUpdateVerification
-};
+};