appwrite-cli 1.1.1 → 2.0.0

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 */
@@ -39,11 +41,11 @@ const functionsList = async ({ queries, search, parseOutput = true, sdk = undefi
     return response;
 }
 
-const functionsCreate = async ({ functionId, name, execute, runtime, events, schedule, timeout, enabled, parseOutput = true, sdk = undefined}) => {
+const functionsCreate = async ({ functionId, name, runtime, execute, events, schedule, timeout, enabled, parseOutput = true, sdk = undefined}) => {
     /* @param {string} functionId */
     /* @param {string} name */
-    /* @param {string[]} execute */
     /* @param {string} runtime */
+    /* @param {string[]} execute */
     /* @param {string[]} events */
     /* @param {string} schedule */
     /* @param {number} timeout */
@@ -54,34 +56,44 @@ const functionsCreate = async ({ functionId, name, execute, runtime, events, sch
     let payload = {};
     
     /** Body Params */
+
     if (typeof functionId !== 'undefined') {
         payload['functionId'] = functionId;
     }
 
+
     if (typeof name !== 'undefined') {
         payload['name'] = name;
     }
 
+    execute = execute === true ? [] : execute;
+
     if (typeof execute !== 'undefined') {
         payload['execute'] = execute;
     }
 
+
     if (typeof runtime !== 'undefined') {
         payload['runtime'] = runtime;
     }
 
+    events = events === true ? [] : events;
+
     if (typeof events !== 'undefined') {
         payload['events'] = events;
     }
 
+
     if (typeof schedule !== 'undefined') {
         payload['schedule'] = schedule;
     }
 
+
     if (typeof timeout !== 'undefined') {
         payload['timeout'] = timeout;
     }
 
+
     if (typeof enabled !== 'undefined') {
         payload['enabled'] = enabled;
     }
@@ -170,26 +182,34 @@ const functionsUpdate = async ({ functionId, name, execute, events, schedule, ti
     let payload = {};
     
     /** Body Params */
+
     if (typeof name !== 'undefined') {
         payload['name'] = name;
     }
 
+    execute = execute === true ? [] : execute;
+
     if (typeof execute !== 'undefined') {
         payload['execute'] = execute;
     }
 
+    events = events === true ? [] : events;
+
     if (typeof events !== 'undefined') {
         payload['events'] = events;
     }
 
+
     if (typeof schedule !== 'undefined') {
         payload['schedule'] = schedule;
     }
 
+
     if (typeof timeout !== 'undefined') {
         payload['timeout'] = timeout;
     }
 
+
     if (typeof enabled !== 'undefined') {
         payload['enabled'] = enabled;
     }
@@ -263,6 +283,7 @@ const functionsCreateDeployment = async ({ functionId, entrypoint, code, activat
     let payload = {};
     
     /** Body Params */
+
     if (typeof entrypoint !== 'undefined') {
         payload['entrypoint'] = entrypoint;
     }
@@ -298,6 +319,7 @@ const functionsCreateDeployment = async ({ functionId, entrypoint, code, activat
         code = archivePath;
     }
 
+
     if (typeof activate !== 'undefined') {
         payload['activate'] = activate.toString();
     }
@@ -426,7 +448,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 */
@@ -484,10 +506,12 @@ const functionsCreateExecution = async ({ functionId, data, async, parseOutput =
     let payload = {};
     
     /** Body Params */
+
     if (typeof data !== 'undefined') {
         payload['data'] = data;
     }
 
+
     if (typeof async !== 'undefined') {
         payload['async'] = async;
     }
@@ -575,10 +599,12 @@ const functionsCreateVariable = async ({ functionId, key, value, parseOutput = t
     let payload = {};
     
     /** Body Params */
+
     if (typeof key !== 'undefined') {
         payload['key'] = key;
     }
 
+
     if (typeof value !== 'undefined') {
         payload['value'] = value;
     }
@@ -625,10 +651,12 @@ const functionsUpdateVariable = async ({ functionId, variableId, key, value, par
     let payload = {};
     
     /** Body Params */
+
     if (typeof key !== 'undefined') {
         payload['key'] = key;
     }
 
+
     if (typeof value !== 'undefined') {
         payload['value'] = value;
     }
@@ -668,18 +696,18 @@ const functionsDeleteVariable = async ({ functionId, variableId, parseOutput = t
 functions
     .command(`list`)
     .description(`Get a list of all the project's functions. You can use the query params 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, enabled, runtime, deployment, schedule, scheduleNext, schedulePrevious, timeout`)
+    .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, runtime, deployment, schedule, scheduleNext, schedulePrevious, timeout`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
     .action(actionRunner(functionsList))
 
 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.`)
-    .option(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
+    .option(`--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.`)
+    .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)
     .option(`--enabled <enabled>`, `Is function enabled?`, parseBool)
@@ -707,8 +735,8 @@ 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 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.`)
-    .option(`--events <events...>`, `Events list. Maximum of 100 events are allowed.`)
+    .option(`--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.`)
+    .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)
     .option(`--enabled <enabled>`, `Is function enabled?`, parseBool)
@@ -724,7 +752,7 @@ functions
     .command(`listDeployments`)
     .description(`Get a list of all the project's code deployments. 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: entrypoint, size, buildId, activate`)
+    .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: entrypoint, size, buildId, activate`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
     .action(actionRunner(functionsListDeployments))
 
@@ -759,18 +787,18 @@ 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(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, statusCode, duration`)
     .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
     .action(actionRunner(functionsListExecutions))
 
@@ -848,7 +876,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")
@@ -69,13 +78,16 @@ const client = new Command("client")
                 if (url.protocol !== "http:" && url.protocol !== "https:") {
                     throw new Error();
                 }
-                
+
                 let client = new Client().setEndpoint(endpoint);
+                if (selfSigned || globalConfig.getSelfSigned()) {
+                    client.setSelfSigned(true);
+                }
                 let response = await client.call('GET', '/health/version');
-                if(!response.version) {
+                if (!response.version) {
                     throw new Error();
                 }
-                
+
                 globalConfig.setEndpoint(endpoint);
             } catch (_) {
                 throw new Error("Invalid endpoint or your Appwrite server is not running as expected.");

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}) => {