appwrite-cli 1.1.0 → 1.2.1

package/Formula/appwrite.rb

@@ -4,7 +4,7 @@ class Appwrite < Formula
   desc "CLI is a Node based command-line tool for Appwrite API"
   homepage "https://appwrite.io"
   license "BSD-3-Clause"
-  head "https://github.com/appwrite/sdk-for-cli.git", branch: "main"
+  head "https://github.com/appwrite/sdk-for-cli.git", branch: "master"
 
   depends_on "node"
 

package/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2022 Appwrite (https://appwrite.io) and individual contributors.
+Copyright (c) 2023 Appwrite (https://appwrite.io) and individual contributors.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
@@ -7,6 +7,6 @@ Redistribution and use in source and binary forms, with or without modification,
 
     2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
 
-    3. Neither the name Appwrite nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+    3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,12 +1,12 @@
 # Appwrite Command Line SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-cli.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.0.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.2.1-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version 1.0.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-cli/releases).**
+**This SDK is compatible with Appwrite server version 1.2.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-cli/releases).**
 
 Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Command Line SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 
@@ -29,7 +29,7 @@ Once the installation is complete, you can verify the install using
 
 ```sh
 $ appwrite -v
-1.1.0
+1.2.1
 ```
 
 ### Install using prebuilt binaries
@@ -58,7 +58,7 @@ $ iwr -useb https://appwrite.io/cli/install.ps1 | iex
 Once the installation completes, you can verify your install using
 ```
 $ appwrite -v
-1.1.0
+1.2.1
 ```
 
 ## Getting Started 

package/docs/examples/account/create-phone-session.md

@@ -1,3 +1,3 @@
 appwrite account createPhoneSession \
         --userId [USER_ID] \
-        --phone ''
+        --phone +12065550100

package/docs/examples/account/update-phone.md

@@ -1,3 +1,3 @@
 appwrite account updatePhone \
-        --phone '' \
+        --phone +12065550100 \
         --password password

package/docs/examples/functions/create-build.md

@@ -0,0 +1,4 @@
+appwrite functions createBuild \
+        --functionId [FUNCTION_ID] \
+        --deploymentId [DEPLOYMENT_ID] \
+        --buildId [BUILD_ID]

package/docs/examples/graphql/mutation.md

@@ -0,0 +1,2 @@
+appwrite graphql mutation \
+        --query '{ "key": "value" }'

package/docs/examples/graphql/query.md

@@ -0,0 +1,2 @@
+appwrite graphql query \
+        --query '{ "key": "value" }'

package/docs/examples/projects/create.md

@@ -11,3 +11,4 @@ appwrite projects create \
 
 
 
+

package/docs/examples/projects/update-auth-duration.md

@@ -0,0 +1,3 @@
+appwrite projects updateAuthDuration \
+        --projectId [PROJECT_ID] \
+        --duration 0

package/docs/examples/projects/update-auth-sessions-limit.md

@@ -0,0 +1,3 @@
+appwrite projects updateAuthSessionsLimit \
+        --projectId [PROJECT_ID] \
+        --limit 1

package/docs/examples/projects/update-o-auth2.md

@@ -3,3 +3,4 @@ appwrite projects updateOAuth2 \
         --provider amazon \
 
 
+

package/docs/examples/users/update-phone.md

@@ -1,3 +1,3 @@
 appwrite users updatePhone \
         --userId [USER_ID] \
-        --number ''
+        --number +12065550100

package/index.js

@@ -1,4 +1,10 @@
 #! /usr/bin/env node
+
+/** Required to set max width of the help commands */
+const oldWidth = process.stdout.columns
+process.stdout.columns = 100
+/** ---------------------------------------------- */
+
 const program = require("commander");
 const chalk = require("chalk");
 const { version } = require("./package.json");
@@ -11,6 +17,7 @@ const { account } = require("./lib/commands/account");
 const { avatars } = require("./lib/commands/avatars");
 const { databases } = require("./lib/commands/databases");
 const { functions } = require("./lib/commands/functions");
+const { graphql } = require("./lib/commands/graphql");
 const { health } = require("./lib/commands/health");
 const { locale } = require("./lib/commands/locale");
 const { projects } = require("./lib/commands/projects");
@@ -20,6 +27,10 @@ const { users } = require("./lib/commands/users");
 
 program
   .description(commandDescriptions['main'])
+  .configureHelp({
+    helpWidth: process.stdout.columns || 80,
+    sortSubcommands: true
+  })
   .version(version, "-v, --version")
   .option("--verbose", "Show complete error log")
   .option("--json", "Output in JSON format")
@@ -38,6 +49,7 @@ program
   .addCommand(avatars)
   .addCommand(databases)
   .addCommand(functions)
+  .addCommand(graphql)
   .addCommand(health)
   .addCommand(locale)
   .addCommand(projects)
@@ -46,4 +58,5 @@ program
   .addCommand(users)
   .addCommand(client)
   .parse(process.argv);
-  
+  
+process.stdout.columns = oldWidth;

package/install.ps1

@@ -13,8 +13,8 @@
 # You can use "View source" of this page to see the full script.
 
 # REPO
-$GITHUB_x64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/1.1.0/appwrite-cli-win-x64.exe"
-$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/1.1.0/appwrite-cli-win-arm64.exe"
+$GITHUB_x64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/1.2.1/appwrite-cli-win-x64.exe"
+$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/1.2.1/appwrite-cli-win-arm64.exe"
 
 $APPWRITE_BINARY_NAME = "appwrite.exe"
 

package/install.sh

@@ -97,7 +97,7 @@ printSuccess() {
 downloadBinary() {
     echo "[2/4] Downloading executable for $OS ($ARCH) ..."
 
-    GITHUB_LATEST_VERSION="1.1.0"
+    GITHUB_LATEST_VERSION="1.2.1"
     GITHUB_FILE="appwrite-cli-${OS}-${ARCH}"
     GITHUB_URL="https://github.com/$GITHUB_REPOSITORY_NAME/releases/download/$GITHUB_LATEST_VERSION/$GITHUB_FILE"
 

package/lib/client.js

@@ -15,8 +15,8 @@ class Client {
       'x-sdk-name': 'Command Line',
       'x-sdk-platform': 'console',
       'x-sdk-language': 'cli',
-      'x-sdk-version': '1.1.0',
-      'user-agent' : `AppwriteCLI/1.1.0 (${os.type()} ${os.version()}; ${os.arch()})`,
+      'x-sdk-version': '1.2.1',
+      'user-agent' : `AppwriteCLI/1.2.1 (${os.type()} ${os.version()}; ${os.arch()})`,
       'X-Appwrite-Response-Format' : '1.0.0',
     };
   }

package/lib/commands/account.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const account = new Command("account").description(commandDescriptions['account'])
+const account = new Command("account").description(commandDescriptions['account']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const accountGet = async ({ parseOutput = true, sdk = undefined}) => {
 
@@ -740,7 +742,7 @@ account
 account
     .command(`create`)
     .description(`Use this endpoint to allow a new user to register a new account in your project. After the user registration completes successfully, you can use the [/account/verfication](/docs/client/account#accountCreateVerification) route to start verifying the user email address. To allow the new user to login to their new account, you need to create a new [account session](/docs/client/account#accountCreateSession).`)
-    .requiredOption(`--userId <userId>`, `Unique 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(`--userId <userId>`, `Unique 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password. Must be at least 8 chars.`)
     .option(`--name <name>`, `User name. Max length: 128 chars.`)
@@ -828,15 +830,15 @@ account
 
 account
     .command(`createEmailSession`)
-    .description(`Allow the user to login into their account by providing a valid email and password combination. This route will create a new session for the user.`)
+    .description(`Allow the user to login into their account by providing a valid email and password combination. This route will create a new session for the user.  A user is limited to 10 active sessions at a time by default. [Learn more about session limits](/docs/authentication#limits).`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password. Must be at least 8 chars.`)
     .action(actionRunner(accountCreateEmailSession))
 
 account
     .command(`createMagicURLSession`)
-    .description(`Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. When the user clicks the link in the email, the user is redirected back to the URL you provided with the secret key and userId values attached to the URL query string. Use the query string parameters to submit a request to the [PUT /account/sessions/magic-url](/docs/client/account#accountUpdateMagicURLSession) endpoint to complete the login process. The link sent to the user's email address is valid for 1 hour. If you are on a mobile device you can leave the URL parameter empty, so that the login completion will be handled by your Appwrite instance by default.`)
-    .requiredOption(`--userId <userId>`, `Unique 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.`)
+    .description(`Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. When the user clicks the link in the email, the user is redirected back to the URL you provided with the secret key and userId values attached to the URL query string. Use the query string parameters to submit a request to the [PUT /account/sessions/magic-url](/docs/client/account#accountUpdateMagicURLSession) endpoint to complete the login process. The link sent to the user's email address is valid for 1 hour. If you are on a mobile device you can leave the URL parameter empty, so that the login completion will be handled by your Appwrite instance by default.  A user is limited to 10 active sessions at a time by default. [Learn more about session limits](/docs/authentication#limits).`)
+    .requiredOption(`--userId <userId>`, `Unique 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .option(`--url <url>`, `URL to redirect the user back to your app from the magic URL login. 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.`)
     .action(actionRunner(accountCreateMagicURLSession))
@@ -850,7 +852,7 @@ account
 
 account
     .command(`createOAuth2Session`)
-    .description(`Allow the user to login to their account using the OAuth2 provider of their choice. Each OAuth2 provider should be enabled from the Appwrite console first. Use the success and failure arguments to provide a redirect URL's back to your app when login is completed.  If there is already an active session, the new session will be attached to the logged-in account. If there are no active sessions, the server will attempt to look for a user with the same email address as the email received from the OAuth2 provider and attach the new session to the existing user. If no matching user is found - the server will create a new user.. `)
+    .description(`Allow the user to login to their account using the OAuth2 provider of their choice. Each OAuth2 provider should be enabled from the Appwrite console first. Use the success and failure arguments to provide a redirect URL's back to your app when login is completed.  If there is already an active session, the new session will be attached to the logged-in account. If there are no active sessions, the server will attempt to look for a user with the same email address as the email received from the OAuth2 provider and attach the new session to the existing user. If no matching user is found - the server will create a new user.  A user is limited to 10 active sessions at a time by default. [Learn more about session limits](/docs/authentication#limits). `)
     .requiredOption(`--provider <provider>`, `OAuth2 Provider. Currently, supported providers are: amazon, apple, auth0, authentik, autodesk, bitbucket, bitly, box, dailymotion, discord, disqus, dropbox, etsy, facebook, github, gitlab, google, linkedin, microsoft, notion, okta, paypal, paypalSandbox, podio, salesforce, slack, spotify, stripe, tradeshift, tradeshiftBox, twitch, wordpress, yahoo, yammer, yandex, zoom.`)
     .option(`--success <success>`, `URL to redirect back to your app after a successful login attempt.  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(`--failure <failure>`, `URL to redirect back to your app after a failed login attempt.  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.`)
@@ -859,8 +861,8 @@ account
 
 account
     .command(`createPhoneSession`)
-    .description(`Sends the user an SMS with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [PUT /account/sessions/phone](/docs/client/account#accountUpdatePhoneSession) endpoint to complete the login process. The secret sent to the user's phone is valid for 15 minutes.`)
-    .requiredOption(`--userId <userId>`, `Unique 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.`)
+    .description(`Sends the user an SMS with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [PUT /account/sessions/phone](/docs/client/account#accountUpdatePhoneSession) endpoint to complete the login process. The secret sent to the user's phone is valid for 15 minutes.  A user is limited to 10 active sessions at a time by default. [Learn more about session limits](/docs/authentication#limits).`)
+    .requiredOption(`--userId <userId>`, `Unique 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.`)
     .requiredOption(`--phone <phone>`, `Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.`)
     .action(actionRunner(accountCreatePhoneSession))
 

package/lib/commands/avatars.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const avatars = new Command("avatars").description(commandDescriptions['avatars'])
+const avatars = new Command("avatars").description(commandDescriptions['avatars']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const avatarsGetBrowser = async ({ code, width, height, quality, parseOutput = true, sdk = undefined, destination}) => {
     /* @param {string} code */

package/lib/commands/databases.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const databases = new Command("databases").description(commandDescriptions['databases'])
+const databases = new Command("databases").description(commandDescriptions['databases']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const databasesList = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -1125,7 +1127,7 @@ databases
 databases
     .command(`create`)
     .description(`Create a new Database. `)
-    .requiredOption(`--databaseId <databaseId>`, `Unique 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(`--databaseId <databaseId>`, `Unique 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.`)
     .requiredOption(`--name <name>`, `Collection name. Max length: 128 chars.`)
     .action(actionRunner(databasesCreate))
 
@@ -1145,7 +1147,7 @@ databases
     .command(`update`)
     .description(`Update a database by its unique ID.`)
     .requiredOption(`--databaseId <databaseId>`, `Database ID.`)
-    .requiredOption(`--name <name>`, `Collection name. Max length: 128 chars.`)
+    .requiredOption(`--name <name>`, `Database name. Max length: 128 chars.`)
     .action(actionRunner(databasesUpdate))
 
 databases
@@ -1166,9 +1168,9 @@ databases
     .command(`createCollection`)
     .description(`Create a new Collection. Before using this route, you should create a new database resource using either a [server integration](/docs/server/databases#databasesCreateCollection) API or directly from your database console.`)
     .requiredOption(`--databaseId <databaseId>`, `Database ID.`)
-    .requiredOption(`--collectionId <collectionId>`, `Unique 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(`--collectionId <collectionId>`, `Unique 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.`)
     .requiredOption(`--name <name>`, `Collection name. Max length: 128 chars.`)
-    .option(`--permissions <permissions...>`, `An array of permissions strings. By default no user is granted with any permissions. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](/docs/permissions).`)
     .option(`--documentSecurity <documentSecurity>`, `Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](/docs/permissions).`, parseBool)
     .action(actionRunner(databasesCreateCollection))
 
@@ -1185,7 +1187,7 @@ databases
     .requiredOption(`--databaseId <databaseId>`, `Database ID.`)
     .requiredOption(`--collectionId <collectionId>`, `Collection ID.`)
     .requiredOption(`--name <name>`, `Collection name. Max length: 128 chars.`)
-    .option(`--permissions <permissions...>`, `An array of permission strings. By default the current permission are inherited. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
     .option(`--documentSecurity <documentSecurity>`, `Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](/docs/permissions).`, parseBool)
     .option(`--enabled <enabled>`, `Is collection enabled?`, parseBool)
     .action(actionRunner(databasesUpdateCollection))
@@ -1327,7 +1329,7 @@ databases
 
 databases
     .command(`listDocuments`)
-    .description(`Get a list of all the user's documents in a given collection. You can use the query params to filter your results. On admin mode, this endpoint will return a list of all of documents belonging to the provided collectionId. [Learn more about different API modes](/docs/admin).`)
+    .description(`Get a list of all the user's documents in a given collection. You can use the query params to filter your results.`)
     .requiredOption(`--databaseId <databaseId>`, `Database ID.`)
     .requiredOption(`--collectionId <collectionId>`, `Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).`)
     .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long.`)
@@ -1338,9 +1340,9 @@ databases
     .description(`Create a new Document. Before using this route, you should create a new collection resource using either a [server integration](/docs/server/databases#databasesCreateCollection) API or directly from your database console.`)
     .requiredOption(`--databaseId <databaseId>`, `Database ID.`)
     .requiredOption(`--collectionId <collectionId>`, `Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). Make sure to define attributes before creating documents.`)
-    .requiredOption(`--documentId <documentId>`, `Document 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(`--documentId <documentId>`, `Document 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.`)
     .requiredOption(`--data <data>`, `Document data as JSON object.`)
-    .option(`--permissions <permissions...>`, `An array of permissions strings. By default the current user is granted with all permissions. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](/docs/permissions).`)
     .action(actionRunner(databasesCreateDocument))
 
 databases
@@ -1358,7 +1360,7 @@ databases
     .requiredOption(`--collectionId <collectionId>`, `Collection ID.`)
     .requiredOption(`--documentId <documentId>`, `Document ID.`)
     .option(`--data <data>`, `Document data as JSON object. Include only attribute and value pairs to be updated.`)
-    .option(`--permissions <permissions...>`, `An array of permissions strings. By default the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
     .action(actionRunner(databasesUpdateDocument))
 
 databases

package/lib/commands/deploy.js

@@ -2,7 +2,7 @@ const inquirer = require("inquirer");
 const JSONbig = require("json-bigint")({ storeAsString: false });
 const { Command } = require("commander");
 const { localConfig } = require("../config");
-const { questionsDeployFunctions, questionsGetEntrypoint, questionsDeployCollections, questionsConfirmDeployCollections } = require("../questions");
+const { questionsDeployTeams, questionsDeployFunctions, questionsGetEntrypoint, questionsDeployCollections, questionsConfirmDeployCollections } = require("../questions");
 const { actionRunner, success, log, error, commandDescriptions } = require("../parser");
 const { functionsGet, functionsCreate, functionsUpdate, functionsCreateDeployment, functionsUpdateDeployment, functionsListVariables, functionsDeleteVariable, functionsCreateVariable } = require('./functions');
 const {
@@ -25,6 +25,11 @@ const {
     databasesListIndexes,
     databasesDeleteIndex
 } = require("./databases");
+const {
+    teamsGet,
+    teamsUpdate,
+    teamsCreate
+} = require("./teams");
 
 const POOL_DEBOUNCE = 2000; // in milliseconds
 const POOL_MAX_DEBOUNCES = 30;
@@ -138,6 +143,9 @@ const awaitPools = {
 
 const deploy = new Command("deploy")
     .description(commandDescriptions['deploy'])
+    .configureHelp({
+        helpWidth: process.stdout.columns || 80
+    })
     .action(actionRunner(async (_options, command) => {
         command.help()
     }));
@@ -593,6 +601,76 @@ const deployCollection = async ({ all, yes } = {}) => {
     }
 }
 
+const deployTeam = async ({ all, yes } = {}) => {
+    let response = {};
+
+    let teamIds = [];
+    const configTeams = localConfig.getTeams();
+
+    if(all) {
+        if (configTeams.length === 0) {
+            throw new Error("No teams found in the current directory. Run `appwrite init team` to fetch all your teams.");
+        }
+        teamIds.push(...configTeams.map((t) => t.$id));
+    }
+
+    if(teamIds.length === 0) {
+        let answers = await inquirer.prompt(questionsDeployTeams[0])
+        teamIds.push(...answers.teams);
+    }
+
+    let teams = [];
+
+    for(const teamId of teamIds) {
+        const idTeams = configTeams.filter((t) => t.$id === teamId);
+        teams.push(...idTeams);
+    }
+
+    for (let team of teams) {
+        log(`Deploying team ${team.name} ( ${team['$id']} )`)
+
+        try {
+            response = await teamsGet({
+                teamId: team['$id'],
+                parseOutput: false,
+            })
+            log(`Team ${team.name} ( ${team['$id']} ) already exists.`);
+
+            if(!yes) {
+                answers = await inquirer.prompt(questionsDeployTeams[1])
+                if (answers.override !== "YES") {
+                    log(`Received "${answers.override}". Skipping ${team.name} ( ${team['$id']} )`);
+                    continue;
+                }
+            }
+
+            log(`Updating team ...`)
+
+            await teamsUpdate({
+                teamId: team['$id'],
+                name: team.name,
+                parseOutput: false
+            });
+
+            success(`Deployed ${team.name} ( ${team['$id']} )`);
+        } catch (e) {
+            if (e.code == 404) {
+                log(`Team ${team.name} does not exist in the project. Creating ... `);
+
+                response = await teamsCreate({
+                    teamId: team['$id'],
+                    name: team.name,
+                    parseOutput: false
+                })
+
+                success(`Deployed ${team.name} ( ${team['$id']} )`);
+            } else {
+                throw e;
+            }
+        }
+    }
+}
+
 deploy
     .command("function")
     .description("Deploy functions in the current directory.")
@@ -608,6 +686,13 @@ deploy
     .option(`--yes`, `Flag to confirm all warnings`)
     .action(actionRunner(deployCollection));
 
+deploy
+    .command("team")
+    .description("Deploy teams in the current project.")
+    .option(`--all`, `Flag to deploy all teams`)
+    .option(`--yes`, `Flag to confirm all warnings`)
+    .action(actionRunner(deployTeam));
+
 module.exports = {
     deploy
 }

package/lib/commands/functions.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const functions = new Command("functions").description(commandDescriptions['functions'])
+const functions = new Command("functions").description(commandDescriptions['functions']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const functionsList = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -426,7 +428,7 @@ const functionsDeleteDeployment = async ({ functionId, deploymentId, parseOutput
     return response;
 }
 
-const functionsRetryBuild = async ({ functionId, deploymentId, buildId, parseOutput = true, sdk = undefined}) => {
+const functionsCreateBuild = async ({ functionId, deploymentId, buildId, parseOutput = true, sdk = undefined}) => {
     /* @param {string} functionId */
     /* @param {string} deploymentId */
     /* @param {string} buildId */
@@ -675,7 +677,7 @@ functions
 functions
     .command(`create`)
     .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(`--functionId <functionId>`, `Function 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.`)
     .requiredOption(`--name <name>`, `Function name. Max length: 128 chars.`)
     .requiredOption(`--execute <execute...>`, `An array of strings with execution roles. By default no user is granted with any execute permissions. [learn more about permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 64 characters long.`)
     .requiredOption(`--runtime <runtime>`, `Execution runtime.`)
@@ -759,16 +761,16 @@ functions
     .action(actionRunner(functionsDeleteDeployment))
 
 functions
-    .command(`retryBuild`)
+    .command(`createBuild`)
     .description(``)
     .requiredOption(`--functionId <functionId>`, `Function ID.`)
     .requiredOption(`--deploymentId <deploymentId>`, `Deployment ID.`)
     .requiredOption(`--buildId <buildId>`, `Build unique ID.`)
-    .action(actionRunner(functionsRetryBuild))
+    .action(actionRunner(functionsCreateBuild))
 
 functions
     .command(`listExecutions`)
-    .description(`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).`)
+    .description(`Get a list of all the current user function execution logs. You can use the query params to filter your results.`)
     .requiredOption(`--functionId <functionId>`, `Function ID.`)
     .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, statusCode, duration`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
@@ -848,7 +850,7 @@ module.exports = {
     functionsGetDeployment,
     functionsUpdateDeployment,
     functionsDeleteDeployment,
-    functionsRetryBuild,
+    functionsCreateBuild,
     functionsListExecutions,
     functionsCreateExecution,
     functionsGetExecution,

package/lib/commands/generic.js

@@ -9,6 +9,9 @@ const { accountCreateEmailSession, accountDeleteSession } = require("./account")
 
 const login = new Command("login")
     .description(commandDescriptions['login'])
+    .configureHelp({
+        helpWidth: process.stdout.columns || 80
+    })
     .action(actionRunner(async () => {
         const answers = await inquirer.prompt(questionsLogin)
 
@@ -26,6 +29,9 @@ const login = new Command("login")
 
 const logout = new Command("logout")
     .description(commandDescriptions['logout'])
+    .configureHelp({
+        helpWidth: process.stdout.columns || 80
+    })
     .action(actionRunner(async () => {
         let client = await sdkForConsole();
 
@@ -41,6 +47,9 @@ const logout = new Command("logout")
 
 const client = new Command("client")
     .description(commandDescriptions['client'])
+    .configureHelp({
+        helpWidth: process.stdout.columns || 80
+    })
     .option("--selfSigned <value>", "Configure the CLI to use a self-signed certificate ( true or false )", parseBool)
     .option("--endpoint <endpoint>", "Set your Appwrite server endpoint")
     .option("--projectId <projectId>", "Set your Appwrite project ID")

package/lib/commands/graphql.js

@@ -0,0 +1,85 @@
+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')
+const { localConfig, globalConfig } = require("../config");
+
+const graphql = new Command("graphql").description(commandDescriptions['graphql']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
+
+const graphqlQuery = async ({ query, parseOutput = true, sdk = undefined}) => {
+    /* @param {object} query */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/graphql';
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof query !== 'undefined') {
+        payload['query'] = JSON.parse(query);
+    }
+
+    let response = undefined;
+    response = await client.call('post', path, {
+        'x-sdk-graphql': 'true',
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+const graphqlMutation = async ({ query, parseOutput = true, sdk = undefined}) => {
+    /* @param {object} query */
+
+    let client = !sdk ? await sdkForProject() : sdk;
+    let path = '/graphql/mutation';
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof query !== 'undefined') {
+        payload['query'] = JSON.parse(query);
+    }
+
+    let response = undefined;
+    response = await client.call('post', path, {
+        'x-sdk-graphql': 'true',
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
+
+graphql
+    .command(`query`)
+    .description(`Execute a GraphQL mutation.`)
+    .requiredOption(`--query <query>`, `The query or queries to execute.`)
+    .action(actionRunner(graphqlQuery))
+
+graphql
+    .command(`mutation`)
+    .description(`Execute a GraphQL mutation.`)
+    .requiredOption(`--query <query>`, `The query or queries to execute.`)
+    .action(actionRunner(graphqlMutation))
+
+
+module.exports = {
+    graphql,
+    graphqlQuery,
+    graphqlMutation
+};

package/lib/commands/health.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const health = new Command("health").description(commandDescriptions['health'])
+const health = new Command("health").description(commandDescriptions['health']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const healthGet = async ({ parseOutput = true, sdk = undefined}) => {
 

package/lib/commands/init.js

@@ -3,7 +3,7 @@ const path = require("path");
 const childProcess = require('child_process');
 const { Command } = require("commander");
 const inquirer = require("inquirer");
-const { teamsCreate } = require("./teams");
+const { teamsCreate, teamsList } = require("./teams");
 const { projectsCreate } = require("./projects");
 const { functionsCreate } = require("./functions");
 const { databasesListCollections, databasesList } = require("./databases");
@@ -14,6 +14,9 @@ const { success, log, actionRunner, commandDescriptions } = require("../parser")
 
 const init = new Command("init")
   .description(commandDescriptions['init'])
+  .configureHelp({
+        helpWidth: process.stdout.columns || 80
+  })
   .action(actionRunner(async (_options, command) => {
     command.help();
   }));
@@ -186,6 +189,24 @@ const initCollection = async ({ all, databaseId } = {}) => {
   success();
 }
 
+const initTeam = async () => {
+  // TODO: Pagination?
+  let response = await teamsList({
+    queries: [ 'limit(100)' ],
+    parseOutput: false
+  })
+
+  let teams = response.teams;
+  log(`Found ${teams.length} teams`);
+
+  teams.forEach(async team => {
+    log(`Fetching ${team.name} ...`);
+    localConfig.addTeam(team);
+  });
+
+  success();
+}
+
 init
   .command("project")
   .description("Initialise your Appwrite project")
@@ -203,6 +224,11 @@ init
   .option(`--all`, `Flag to initialize all databases`)
   .action(actionRunner(initCollection))
 
+init
+  .command("team")
+  .description("Initialise your Appwrite teams")
+  .action(actionRunner(initTeam))
+
 module.exports = {
   init,
 };

package/lib/commands/locale.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const locale = new Command("locale").description(commandDescriptions['locale'])
+const locale = new Command("locale").description(commandDescriptions['locale']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const localeGet = async ({ parseOutput = true, sdk = undefined}) => {
 

package/lib/commands/projects.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const projects = new Command("projects").description(commandDescriptions['projects'])
+const projects = new Command("projects").description(commandDescriptions['projects']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const projectsList = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -39,10 +41,11 @@ const projectsList = async ({ queries, search, parseOutput = true, sdk = undefin
     return response;
 }
 
-const projectsCreate = async ({ projectId, name, teamId, description, logo, url, legalName, legalCountry, legalState, legalCity, legalAddress, legalTaxId, parseOutput = true, sdk = undefined}) => {
+const projectsCreate = async ({ projectId, name, teamId, region, description, logo, url, legalName, legalCountry, legalState, legalCity, legalAddress, legalTaxId, parseOutput = true, sdk = undefined}) => {
     /* @param {string} projectId */
     /* @param {string} name */
     /* @param {string} teamId */
+    /* @param {string} region */
     /* @param {string} description */
     /* @param {string} logo */
     /* @param {string} url */
@@ -70,6 +73,10 @@ const projectsCreate = async ({ projectId, name, teamId, description, logo, url,
         payload['teamId'] = teamId;
     }
 
+    if (typeof region !== 'undefined') {
+        payload['region'] = region;
+    }
+
     if (typeof description !== 'undefined') {
         payload['description'] = description;
     }
@@ -231,6 +238,31 @@ const projectsDelete = async ({ projectId, password, parseOutput = true, sdk = u
     return response;
 }
 
+const projectsUpdateAuthDuration = async ({ projectId, duration, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} projectId */
+    /* @param {number} duration */
+
+    let client = !sdk ? await sdkForConsole() : sdk;
+    let path = '/projects/{projectId}/auth/duration'.replace('{projectId}', projectId);
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof duration !== 'undefined') {
+        payload['duration'] = duration;
+    }
+
+    let response = undefined;
+    response = await client.call('patch', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
 const projectsUpdateAuthLimit = async ({ projectId, limit, parseOutput = true, sdk = undefined}) => {
     /* @param {string} projectId */
     /* @param {number} limit */
@@ -256,6 +288,31 @@ const projectsUpdateAuthLimit = async ({ projectId, limit, parseOutput = true, s
     return response;
 }
 
+const projectsUpdateAuthSessionsLimit = async ({ projectId, limit, parseOutput = true, sdk = undefined}) => {
+    /* @param {string} projectId */
+    /* @param {number} limit */
+
+    let client = !sdk ? await sdkForConsole() : sdk;
+    let path = '/projects/{projectId}/auth/max-sessions'.replace('{projectId}', projectId);
+    let payload = {};
+    
+    /** Body Params */
+    if (typeof limit !== 'undefined') {
+        payload['limit'] = limit;
+    }
+
+    let response = undefined;
+    response = await client.call('patch', path, {
+        'content-type': 'application/json',
+    }, payload);
+    
+    if (parseOutput) {
+        parse(response)
+        success()
+    }
+    return response;
+}
+
 const projectsUpdateAuthStatus = async ({ projectId, method, status, parseOutput = true, sdk = undefined}) => {
     /* @param {string} projectId */
     /* @param {string} method */
@@ -509,11 +566,12 @@ const projectsDeleteKey = async ({ projectId, keyId, parseOutput = true, sdk = u
     return response;
 }
 
-const projectsUpdateOAuth2 = async ({ projectId, provider, appId, secret, parseOutput = true, sdk = undefined}) => {
+const projectsUpdateOAuth2 = async ({ projectId, provider, appId, secret, enabled, parseOutput = true, sdk = undefined}) => {
     /* @param {string} projectId */
     /* @param {string} provider */
     /* @param {string} appId */
     /* @param {string} secret */
+    /* @param {boolean} enabled */
 
     let client = !sdk ? await sdkForConsole() : sdk;
     let path = '/projects/{projectId}/oauth2'.replace('{projectId}', projectId);
@@ -532,6 +590,10 @@ const projectsUpdateOAuth2 = async ({ projectId, provider, appId, secret, parseO
         payload['secret'] = secret;
     }
 
+    if (typeof enabled !== 'undefined') {
+        payload['enabled'] = enabled;
+    }
+
     let response = undefined;
     response = await client.call('patch', path, {
         'content-type': 'application/json',
@@ -920,16 +982,17 @@ const projectsUpdateWebhookSignature = async ({ projectId, webhookId, parseOutpu
 projects
     .command(`list`)
     .description(``)
-    .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name`)
+    .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, teamId`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
     .action(actionRunner(projectsList))
 
 projects
     .command(`create`)
     .description(``)
-    .requiredOption(`--projectId <projectId>`, `Unique 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(`--projectId <projectId>`, `Unique 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.`)
     .requiredOption(`--name <name>`, `Project name. Max length: 128 chars.`)
     .requiredOption(`--teamId <teamId>`, `Team unique ID.`)
+    .option(`--region <region>`, `Project Region.`)
     .option(`--description <description>`, `Project description. Max length: 256 chars.`)
     .option(`--logo <logo>`, `Project logo.`)
     .option(`--url <url>`, `Project URL.`)
@@ -970,6 +1033,13 @@ projects
     .requiredOption(`--password <password>`, `Your user password for confirmation. Must be at least 8 chars.`)
     .action(actionRunner(projectsDelete))
 
+projects
+    .command(`updateAuthDuration`)
+    .description(``)
+    .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
+    .requiredOption(`--duration <duration>`, `Project session length in seconds. Max length: 31536000 seconds.`, parseInteger)
+    .action(actionRunner(projectsUpdateAuthDuration))
+
 projects
     .command(`updateAuthLimit`)
     .description(``)
@@ -977,6 +1047,13 @@ projects
     .requiredOption(`--limit <limit>`, `Set the max number of users allowed in this project. Use 0 for unlimited.`, parseInteger)
     .action(actionRunner(projectsUpdateAuthLimit))
 
+projects
+    .command(`updateAuthSessionsLimit`)
+    .description(``)
+    .requiredOption(`--projectId <projectId>`, `Project unique ID.`)
+    .requiredOption(`--limit <limit>`, `Set the max number of users allowed in this project. Value allowed is between 1-100. Default is 10`, parseInteger)
+    .action(actionRunner(projectsUpdateAuthSessionsLimit))
+
 projects
     .command(`updateAuthStatus`)
     .description(``)
@@ -1065,6 +1142,7 @@ projects
     .requiredOption(`--provider <provider>`, `Provider Name`)
     .option(`--appId <appId>`, `Provider app ID. Max length: 256 chars.`)
     .option(`--secret <secret>`, `Provider secret key. Max length: 512 chars.`)
+    .option(`--enabled <enabled>`, `Provider status. Set to 'false' to disable new session creation.`, parseBool)
     .action(actionRunner(projectsUpdateOAuth2))
 
 projects
@@ -1184,7 +1262,9 @@ module.exports = {
     projectsGet,
     projectsUpdate,
     projectsDelete,
+    projectsUpdateAuthDuration,
     projectsUpdateAuthLimit,
+    projectsUpdateAuthSessionsLimit,
     projectsUpdateAuthStatus,
     projectsListDomains,
     projectsCreateDomain,

package/lib/commands/storage.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const storage = new Command("storage").description(commandDescriptions['storage'])
+const storage = new Command("storage").description(commandDescriptions['storage']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const storageListBuckets = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -570,9 +572,9 @@ storage
 storage
     .command(`createBucket`)
     .description(`Create a new storage bucket.`)
-    .requiredOption(`--bucketId <bucketId>`, `Unique 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(`--bucketId <bucketId>`, `Unique 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.`)
     .requiredOption(`--name <name>`, `Bucket name`)
-    .option(`--permissions <permissions...>`, `An array of permission strings. By default no user is granted with any permissions. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permission strings. By default, no user is granted with any permissions. [Learn more about permissions](/docs/permissions).`)
     .option(`--fileSecurity <fileSecurity>`, `Enables configuring permissions for individual file. A user needs one of file or bucket level permissions to access a file. [Learn more about permissions](/docs/permissions).`, parseBool)
     .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)
@@ -593,7 +595,7 @@ storage
     .description(`Update a storage bucket by its unique ID.`)
     .requiredOption(`--bucketId <bucketId>`, `Bucket unique ID.`)
     .requiredOption(`--name <name>`, `Bucket name`)
-    .option(`--permissions <permissions...>`, `An array of permission strings. By default the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
     .option(`--fileSecurity <fileSecurity>`, `Enables configuring permissions for individual file. A user needs one of file or bucket level permissions to access a file. [Learn more about permissions](/docs/permissions).`, parseBool)
     .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)
@@ -611,7 +613,7 @@ storage
 
 storage
     .command(`listFiles`)
-    .description(`Get a list of all the user files. 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 files. [Learn more about different API modes](/docs/admin).`)
+    .description(`Get a list of all the user files. You can use the query params to filter your results.`)
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
     .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, signature, mimeType, sizeOriginal, chunksTotal, chunksUploaded`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
@@ -621,9 +623,9 @@ storage
     .command(`createFile`)
     .description(`Create a new file. Before using this route, you should create a new bucket resource using either a [server integration](/docs/server/storage#storageCreateBucket) API or directly from your Appwrite console.  Larger files should be uploaded using multiple requests with the [content-range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range) header to send a partial request with a maximum supported chunk of '5MB'. The 'content-range' header values should always be in bytes.  When the first request is sent, the server will return the **File** object, and the subsequent part request must include the file's **id** in 'x-appwrite-id' header to allow the server to know that the partial upload is for the existing file and not for a new one.  If you're creating a new file using one of the Appwrite SDKs, all the chunking logic will be managed by the SDK internally. `)
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
-    .requiredOption(`--fileId <fileId>`, `File 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(`--fileId <fileId>`, `File 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.`)
     .requiredOption(`--file <file>`, `Binary file.`)
-    .option(`--permissions <permissions...>`, `An array of permission strings. By default the current user is granted with all permissions. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permission strings. By default, only the current user is granted all permissions. [Learn more about permissions](/docs/permissions).`)
     .action(actionRunner(storageCreateFile))
 
 storage
@@ -638,7 +640,7 @@ storage
     .description(`Update a file by its unique ID. Only users with write permissions have access to update this resource.`)
     .requiredOption(`--bucketId <bucketId>`, `Storage bucket unique ID. You can create a new storage bucket using the Storage service [server integration](/docs/server/storage#createBucket).`)
     .requiredOption(`--fileId <fileId>`, `File unique ID.`)
-    .option(`--permissions <permissions...>`, `An array of permission string. By default the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
+    .option(`--permissions <permissions...>`, `An array of permission string. By default, the current permissions are inherited. [Learn more about permissions](/docs/permissions).`)
     .action(actionRunner(storageUpdateFile))
 
 storage

package/lib/commands/teams.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const teams = new Command("teams").description(commandDescriptions['teams'])
+const teams = new Command("teams").description(commandDescriptions['teams']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const teamsList = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -324,7 +326,7 @@ const teamsUpdateMembershipStatus = async ({ teamId, membershipId, userId, secre
 
 teams
     .command(`list`)
-    .description(`Get a list of all the teams in which the current user is a member. You can use the parameters to filter your results.
 
 In admin mode, this endpoint returns a list of all the teams in the current project. [Learn more about different API modes](/docs/admin).`)
+    .description(`Get a list of all the teams in which the current user is a member. You can use the parameters to filter your results.`)
     .option(`--queries <queries...>`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/databases#querying-documents). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, total`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
     .action(actionRunner(teamsList))
@@ -332,7 +334,7 @@ teams
 teams
     .command(`create`)
     .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(`--teamId <teamId>`, `Team 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.`)
     .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). Maximum of 100 roles are allowed, each 32 characters long.`)
     .action(actionRunner(teamsCreate))

package/lib/commands/users.js

@@ -10,7 +10,9 @@ const { sdkForProject, sdkForConsole } = require('../sdks')
 const { parse, actionRunner, parseInteger, parseBool, commandDescriptions, success, log } = require('../parser')
 const { localConfig, globalConfig } = require("../config");
 
-const users = new Command("users").description(commandDescriptions['users'])
+const users = new Command("users").description(commandDescriptions['users']).configureHelp({
+    helpWidth: process.stdout.columns || 80
+  })
 
 const usersList = async ({ queries, search, parseOutput = true, sdk = undefined}) => {
     /* @param {string[]} queries */
@@ -790,7 +792,7 @@ users
 users
     .command(`create`)
     .description(`Create a new user.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .option(`--email <email>`, `User email.`)
     .option(`--phone <phone>`, `Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.`)
     .option(`--password <password>`, `Plain text user password. Must be at least 8 chars.`)
@@ -800,7 +802,7 @@ users
 users
     .command(`createArgon2User`)
     .description(`Create a new user. Password provided must be hashed with the [Argon2](https://en.wikipedia.org/wiki/Argon2) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using Argon2.`)
     .option(`--name <name>`, `User name. Max length: 128 chars.`)
@@ -809,7 +811,7 @@ users
 users
     .command(`createBcryptUser`)
     .description(`Create a new user. Password provided must be hashed with the [Bcrypt](https://en.wikipedia.org/wiki/Bcrypt) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using Bcrypt.`)
     .option(`--name <name>`, `User name. Max length: 128 chars.`)
@@ -818,7 +820,7 @@ users
 users
     .command(`createMD5User`)
     .description(`Create a new user. Password provided must be hashed with the [MD5](https://en.wikipedia.org/wiki/MD5) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using MD5.`)
     .option(`--name <name>`, `User name. Max length: 128 chars.`)
@@ -827,7 +829,7 @@ users
 users
     .command(`createPHPassUser`)
     .description(`Create a new user. Password provided must be hashed with the [PHPass](https://www.openwall.com/phpass/) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User ID. Choose a custom ID or pass the string 'ID.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(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using PHPass.`)
     .option(`--name <name>`, `User name. Max length: 128 chars.`)
@@ -836,7 +838,7 @@ users
 users
     .command(`createScryptUser`)
     .description(`Create a new user. Password provided must be hashed with the [Scrypt](https://github.com/Tarsnap/scrypt) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using Scrypt.`)
     .requiredOption(`--passwordSalt <passwordSalt>`, `Optional salt used to hash password.`)
@@ -850,7 +852,7 @@ users
 users
     .command(`createScryptModifiedUser`)
     .description(`Create a new user. Password provided must be hashed with the [Scrypt Modified](https://gist.github.com/Meldiron/eecf84a0225eccb5a378d45bb27462cc) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using Scrypt Modified.`)
     .requiredOption(`--passwordSalt <passwordSalt>`, `Salt used to hash password.`)
@@ -862,7 +864,7 @@ users
 users
     .command(`createSHAUser`)
     .description(`Create a new user. Password provided must be hashed with the [SHA](https://en.wikipedia.org/wiki/Secure_Hash_Algorithm) algorithm. Use the [POST /users](/docs/server/users#usersCreate) endpoint to create users with a plain text password.`)
-    .requiredOption(`--userId <userId>`, `User 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(`--userId <userId>`, `User 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.`)
     .requiredOption(`--email <email>`, `User email.`)
     .requiredOption(`--password <password>`, `User password hashed using SHA.`)
     .option(`--passwordVersion <passwordVersion>`, `Optional SHA version used to hash password. Allowed values are: 'sha1', 'sha224', 'sha256', 'sha384', 'sha512/224', 'sha512/256', 'sha512', 'sha3-224', 'sha3-256', 'sha3-384', 'sha3-512'`)

package/lib/config.js

@@ -166,6 +166,45 @@ class Local extends Config {
         this.set("collections", collections);
     }
 
+    getTeams() {
+        if (!this.has("teams")) {
+            return [];
+        }
+        return this.get("teams");
+    }
+
+    getTeam($id) {
+        if (!this.has("teams")) {
+            return {};
+        }
+
+        let teams = this.get("teams");
+        for (let i = 0; i < teams.length; i++) {
+            if (teams[i]['$id'] == $id) {
+                return teams[i];
+            }
+        }
+
+        return {};
+    }
+    
+    addTeam(props) {
+        if (!this.has("teams")) {
+            this.set("teams", []);
+        }
+
+        let teams = this.get("teams");
+        for (let i = 0; i < teams.length; i++) {
+            if (teams[i]['$id'] == props['$id']) {
+                teams[i] = props;
+                this.set("teams", teams);
+                return;
+            }
+        }
+        teams.push(props);
+        this.set("teams", teams);
+    }
+
     getProject() {
         if (!this.has("projectId") || !this.has("projectName")) {
             return {};

package/lib/parser.js

@@ -149,6 +149,7 @@ const logo = "\n    _                            _ _           ___   __   _____
 
 const commandDescriptions = {
     "account": `The account command allows you to authenticate and manage a user account.`,
+    "graphql": `The graphql command allows you to query and mutate any resource type on your Appwrite server.`,
     "avatars": `The avatars command aims to help you complete everyday tasks related to your app image, icons, and avatars.`,
     "databases": `The databases command allows you to create structured collections of documents, query and filter lists of documents.`,
     "deploy": `The deploy command provides a convenient wrapper for deploying your functions and collections.`,

package/lib/questions.js

@@ -255,7 +255,7 @@ const questionsDeployFunctions = [
   {
     type: "input",
     name: "override",
-    message: 'Are you sure you want to override this function's variables? This can lead to loss of secrets! Type "YES" to confirm.'
+    message: 'Are you sure you want to override this function\'s variables? This can lead to loss of secrets! Type "YES" to confirm.'
   },
 ]
 
@@ -300,6 +300,32 @@ const questionsGetEntrypoint = [
   },
 ]
 
+const questionsDeployTeams = [
+  {
+    type: "checkbox",
+    name: "teams",
+    message: "Which teams would you like to deploy?",
+    choices: () => {
+      let teams = localConfig.getTeams();
+      if (teams.length === 0) {
+        throw new Error("No teams found in the current directory. Run `appwrite init team` to fetch all your teams.");
+      }
+      let choices = teams.map((team, idx) => {
+        return {
+          name: `${team.name} (${team['$id']})`,
+          value: team.$id
+        }
+      })
+      return choices;
+    }
+  },
+  {
+    type: "input",
+    name: "override",
+    message: 'Are you sure you want to override this team? This can lead to loss of data! Type "YES" to confirm.'
+  },
+]
+
 module.exports = {
   questionsInitProject,
   questionsLogin,
@@ -307,5 +333,6 @@ module.exports = {
   questionsInitCollection,
   questionsDeployFunctions,
   questionsDeployCollections,
+  questionsDeployTeams,
   questionsGetEntrypoint
 };

package/package.json

@@ -2,7 +2,7 @@
   "name": "appwrite-cli",
   "homepage": "https://appwrite.io/support",
   "description": "Appwrite is an open-source self-hosted backend server that abstract and simplify complex and repetitive development tasks behind a very simple REST API",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "license": "BSD-3-Clause",
   "main": "index.js",
   "bin": {