@knocklabs/cli 0.1.0-rc.4 → 0.1.3

package/README.md

@@ -16,7 +16,7 @@ $ npm install -g @knocklabs/cli
 $ knock COMMAND
 running command...
 $ knock (--version)
-@knocklabs/cli/0.1.0-rc.4 linux-x64 node-v16.4.2
+@knocklabs/cli/0.1.3 linux-x64 node-v18.16.0
 $ knock --help [COMMAND]
 USAGE
   $ knock COMMAND
@@ -30,7 +30,6 @@ USAGE
 * [`knock commit`](#knock-commit)
 * [`knock commit promote`](#knock-commit-promote)
 * [`knock help [COMMANDS]`](#knock-help-commands)
-* [`knock ping`](#knock-ping)
 * [`knock plugins`](#knock-plugins)
 * [`knock plugins:install PLUGIN...`](#knock-pluginsinstall-plugin)
 * [`knock plugins:inspect PLUGIN...`](#knock-pluginsinspect-plugin)
@@ -40,44 +39,51 @@ USAGE
 * [`knock plugins:uninstall PLUGIN...`](#knock-pluginsuninstall-plugin-1)
 * [`knock plugins:uninstall PLUGIN...`](#knock-pluginsuninstall-plugin-2)
 * [`knock plugins update`](#knock-plugins-update)
+* [`knock translation get TRANSLATIONREF`](#knock-translation-get-translationref)
 * [`knock translation list`](#knock-translation-list)
-* [`knock translation pull`](#knock-translation-pull)
+* [`knock translation pull [TRANSLATIONREF]`](#knock-translation-pull-translationref)
 * [`knock translation push [TRANSLATIONREF]`](#knock-translation-push-translationref)
 * [`knock translation validate [TRANSLATIONREF]`](#knock-translation-validate-translationref)
+* [`knock whoami`](#knock-whoami)
 * [`knock workflow activate WORKFLOWKEY`](#knock-workflow-activate-workflowkey)
 * [`knock workflow get WORKFLOWKEY`](#knock-workflow-get-workflowkey)
 * [`knock workflow list`](#knock-workflow-list)
 * [`knock workflow pull [WORKFLOWKEY]`](#knock-workflow-pull-workflowkey)
 * [`knock workflow push [WORKFLOWKEY]`](#knock-workflow-push-workflowkey)
+* [`knock workflow run WORKFLOWKEY`](#knock-workflow-run-workflowkey)
 * [`knock workflow validate [WORKFLOWKEY]`](#knock-workflow-validate-workflowkey)
 
 ## `knock commit`
 
+Commit all changes in development environment.
+
 ```
 USAGE
   $ knock commit --service-token <value> [--environment development] [-m <value>] [--force]
 
 FLAGS
-  -m, --commit-message=<value>  Use the given value as the commit message
+  -m, --commit-message=<value>  Use the given value as the commit message.
   --environment=<option>        [default: development] Committing changes applies to the development environment only,
-                                use `commit promote` to promote changes to a later environment
+                                use `commit promote` to promote changes to a subsequent environment.
                                 <options: development>
-  --force
-  --service-token=<value>       (required) The service token to authenticate with
+  --force                       Remove the confirmation prompt.
+  --service-token=<value>       (required) The service token to authenticate with.
 ```
 
-_See code: [dist/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.0-rc.4/dist/commands/commit/index.ts)_
+_See code: [dist/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.3/dist/commands/commit/index.ts)_
 
 ## `knock commit promote`
 
+Promote all changes to the destination environment.
+
 ```
 USAGE
   $ knock commit promote --service-token <value> --to <value> [--force]
 
 FLAGS
-  --force
-  --service-token=<value>  (required) The service token to authenticate with
-  --to=<value>             (required) The destination environment to promote changes from the preceding environment
+  --force                  Remove the confirmation prompt.
+  --service-token=<value>  (required) The service token to authenticate with.
+  --to=<value>             (required) The destination environment to promote changes from the preceding environment.
 ```
 
 ## `knock help [COMMANDS]`
@@ -100,26 +106,6 @@ DESCRIPTION
 
 _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.2.9/src/commands/help.ts)_
 
-## `knock ping`
-
-Ping the Knock management API to verify access.
-
-```
-USAGE
-  $ knock ping --service-token <value>
-
-FLAGS
-  --service-token=<value>  (required) The service token to authenticate with
-
-DESCRIPTION
-  Ping the Knock management API to verify access.
-
-EXAMPLES
-  $ knock ping
-```
-
-_See code: [dist/commands/ping.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.0-rc.4/dist/commands/ping.ts)_
-
 ## `knock plugins`
 
 List installed plugins.
@@ -138,7 +124,7 @@ EXAMPLES
   $ knock plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.4.7/src/commands/plugins/index.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.0.1/src/commands/plugins/index.ts)_
 
 ## `knock plugins:install PLUGIN...`
 
@@ -353,99 +339,176 @@ DESCRIPTION
   Update installed plugins.
 ```
 
+## `knock translation get TRANSLATIONREF`
+
+Display a single translation from an environment.
+
+```
+USAGE
+  $ knock translation get TRANSLATIONREF --service-token <value> [--environment <value>] [--hide-uncommitted-changes]
+    [--json]
+
+ARGUMENTS
+  TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
+                  If a translation has no namespace, it is the same as the locale, e.g. `en`.
+                  If namespaced, it is formatted as namespace.locale, e.g. `admin.en`.
+
+FLAGS
+  --environment=<value>       [default: development] The environment to use.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --service-token=<value>     (required) The service token to authenticate with.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+```
+
 ## `knock translation list`
 
+Display all translations for an environment.
+
 ```
 USAGE
   $ knock translation list --service-token <value> [--environment <value>] [--hide-uncommitted-changes] [--after
     <value>] [--before <value>] [--limit <value>] [--json]
 
 FLAGS
-  --after=<value>
-  --before=<value>
-  --environment=<value>       [default: development]
-  --hide-uncommitted-changes
-  --limit=<value>
-  --service-token=<value>     (required) The service token to authenticate with
+  --after=<value>             The cursor after which to fetch the next page.
+  --before=<value>            The cursor before which to fetch the previous page.
+  --environment=<value>       [default: development] The environment to use.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --limit=<value>             The total number of entries to fetch per page.
+  --service-token=<value>     (required) The service token to authenticate with.
 
 GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-## `knock translation pull`
+## `knock translation pull [TRANSLATIONREF]`
+
+Pull one or more translations from an environment into a local file system.
 
 ```
 USAGE
-  $ knock translation pull --service-token <value> [--environment <value>] [--translations-dir <value> --all]
-    [--hide-uncommitted-changes] [--force]
+  $ knock translation pull [TRANSLATIONREF] --service-token <value> [--environment <value>] [--translations-dir
+    <value> --all] [--hide-uncommitted-changes] [--force]
+
+ARGUMENTS
+  TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
+                  If a translation has no namespace, it is the same as the locale, e.g. `en`.
+                  If namespaced, it is formatted as namespace.locale, e.g. `admin.en`.
 
 FLAGS
-  --all
-  --environment=<value>       [default: development]
-  --force
-  --hide-uncommitted-changes
-  --service-token=<value>     (required) The service token to authenticate with
-  --translations-dir=<value>
+  --all                       Whether to pull all translations from the specified environment.
+  --environment=<value>       [default: development] The environment to use.
+  --force                     Remove the confirmation prompt.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --service-token=<value>     (required) The service token to authenticate with.
+  --translations-dir=<value>  The target directory path to pull all translations into.
 ```
 
 ## `knock translation push [TRANSLATIONREF]`
 
+Push one or more translations from a local file system to Knock.
+
 ```
 USAGE
   $ knock translation push [TRANSLATIONREF] --service-token <value> [--environment development] [--translations-dir
     <value> --all] [-m <value> --commit]
 
+ARGUMENTS
+  TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
+                  If a translation has no namespace, it is the same as the locale, e.g. `en`.
+                  If namespaced, it is formatted as namespace.locale, e.g. `admin.en`.
+
 FLAGS
   -m, --commit-message=<value>  Use the given value as the commit message
-  --all
+  --all                         Whether to push all translations from the target directory.
   --commit                      Push and commit the translation(s) at the same time
   --environment=<option>        [default: development] Pushing a translation is only allowed in the development
                                 environment
                                 <options: development>
-  --service-token=<value>       (required) The service token to authenticate with
-  --translations-dir=<value>
+  --service-token=<value>       (required) The service token to authenticate with.
+  --translations-dir=<value>    The target directory path to find all translations to push.
 ```
 
 ## `knock translation validate [TRANSLATIONREF]`
 
+Validate one or more translations from a local file system.
+
 ```
 USAGE
   $ knock translation validate [TRANSLATIONREF] --service-token <value> [--environment development] [--translations-dir
     <value> --all]
 
+ARGUMENTS
+  TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
+                  If a translation has no namespace, it is the same as the locale, e.g. `en`.
+                  If namespaced, it is formatted as namespace.locale, e.g. `admin.en`.
+
 FLAGS
-  --all
-  --environment=<option>      [default: development] Validating a workflow is only done in the development environment
+  --all                       Whether to validate all translations from the target directory.
+  --environment=<option>      [default: development] Validating a translation is only done in the development
+                              environment
                               <options: development>
-  --service-token=<value>     (required) The service token to authenticate with
-  --translations-dir=<value>
+  --service-token=<value>     (required) The service token to authenticate with.
+  --translations-dir=<value>  The target directory path to find all translations to validate.
+```
+
+## `knock whoami`
+
+Verify the provided service token.
+
 ```
+USAGE
+  $ knock whoami --service-token <value> [--json]
+
+FLAGS
+  --service-token=<value>  (required) The service token to authenticate with.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+```
+
+_See code: [dist/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.3/dist/commands/whoami.ts)_
 
 ## `knock workflow activate WORKFLOWKEY`
 
+Activate or deactivate a workflow in a given environment.
+
 ```
 USAGE
   $ knock workflow activate WORKFLOWKEY --service-token <value> --environment <value> [--status true|false] [--force]
 
 FLAGS
-  --environment=<value>    (required)
-  --force
-  --service-token=<value>  (required) The service token to authenticate with
-  --status=<option>        [default: true]
+  --environment=<value>    (required) The environment to use.
+  --force                  Remove the confirmation prompt.
+  --service-token=<value>  (required) The service token to authenticate with.
+  --status=<option>        [default: true] The workflow active status to set.
                            <options: true|false>
+
+DESCRIPTION
+  Activate or deactivate a workflow in a given environment.
+
+  This immediately enables or disables a workflow in a given environment without
+  needing to go through environment promotion.
+
+  By default, this command activates a given workflow. Pass in the --status flag
+  with `false` in order to deactivate it.
 ```
 
 ## `knock workflow get WORKFLOWKEY`
 
+Display a single workflow from an environment.
+
 ```
 USAGE
   $ knock workflow get WORKFLOWKEY --service-token <value> [--environment <value>] [--hide-uncommitted-changes]
     [--json]
 
 FLAGS
-  --environment=<value>       [default: development]
-  --hide-uncommitted-changes
-  --service-token=<value>     (required) The service token to authenticate with
+  --environment=<value>       [default: development] The environment to use.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --service-token=<value>     (required) The service token to authenticate with.
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -453,18 +516,20 @@ GLOBAL FLAGS
 
 ## `knock workflow list`
 
+Display all workflows for an environment.
+
 ```
 USAGE
   $ knock workflow list --service-token <value> [--environment <value>] [--hide-uncommitted-changes] [--after
     <value>] [--before <value>] [--limit <value>] [--json]
 
 FLAGS
-  --after=<value>
-  --before=<value>
-  --environment=<value>       [default: development]
-  --hide-uncommitted-changes
-  --limit=<value>
-  --service-token=<value>     (required) The service token to authenticate with
+  --after=<value>             The cursor after which to fetch the next page.
+  --before=<value>            The cursor before which to fetch the previous page.
+  --environment=<value>       [default: development] The environment to use.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --limit=<value>             The total number of entries to fetch per page.
+  --service-token=<value>     (required) The service token to authenticate with.
 
 GLOBAL FLAGS
   --json  Format output as json.
@@ -472,43 +537,73 @@ GLOBAL FLAGS
 
 ## `knock workflow pull [WORKFLOWKEY]`
 
+Pull one or more workflows from an environment into a local file system.
+
 ```
 USAGE
   $ knock workflow pull [WORKFLOWKEY] --service-token <value> [--environment <value>] [--workflows-dir <value>
     --all] [--hide-uncommitted-changes] [--force]
 
 FLAGS
-  --all
-  --environment=<value>       [default: development]
-  --force
-  --hide-uncommitted-changes
-  --service-token=<value>     (required) The service token to authenticate with
-  --workflows-dir=<value>
+  --all                       Whether to pull all workflows from the specified environment.
+  --environment=<value>       [default: development] The environment to use.
+  --force                     Remove the confirmation prompt.
+  --hide-uncommitted-changes  Hide any uncommitted changes.
+  --service-token=<value>     (required) The service token to authenticate with.
+  --workflows-dir=<value>     The target directory path to pull all workflows into.
 ```
 
 ## `knock workflow push [WORKFLOWKEY]`
 
+Push one or more workflows from a local file system to Knock.
+
 ```
 USAGE
-  $ knock workflow push [WORKFLOWKEY] --service-token <value> [--environment development] [-m <value> --commit]
+  $ knock workflow push [WORKFLOWKEY] --service-token <value> [--environment development] [--workflows-dir <value>
+    --all] [-m <value> --commit]
 
 FLAGS
   -m, --commit-message=<value>  Use the given value as the commit message
+  --all                         Whether to push all workflows from the target directory.
   --commit                      Push and commit the workflow(s) at the same time
   --environment=<option>        [default: development] Pushing a workflow is only allowed in the development environment
                                 <options: development>
-  --service-token=<value>       (required) The service token to authenticate with
+  --service-token=<value>       (required) The service token to authenticate with.
+  --workflows-dir=<value>       The target directory path to find all workflows to push.
+```
+
+## `knock workflow run WORKFLOWKEY`
+
+Test run a workflow using the latest version from Knock, or a local workflow directory.
+
+```
+USAGE
+  $ knock workflow run WORKFLOWKEY --service-token <value> --recipients <value> [--environment <value>] [--actor
+    <value>] [--tenant <value>] [--data <value>]
+
+FLAGS
+  --actor=<value>          An actor id for the workflow run.
+  --data=<value>           A JSON string of the data for this workflow
+  --environment=<value>    [default: development] The environment in which to run the workflow
+  --recipients=<value>...  (required) One or more recipient ids for this workflow run, separated by comma.
+  --service-token=<value>  (required) The service token to authenticate with.
+  --tenant=<value>         A tenant id for the workflow run.
 ```
 
 ## `knock workflow validate [WORKFLOWKEY]`
 
+Validate one or more workflows from a local file system.
+
 ```
 USAGE
-  $ knock workflow validate [WORKFLOWKEY] --service-token <value> [--environment development]
+  $ knock workflow validate [WORKFLOWKEY] --service-token <value> [--environment development] [--workflows-dir <value>
+    --all]
 
 FLAGS
+  --all                    Whether to validate all workflows from the target directory.
   --environment=<option>   [default: development] Validating a workflow is only done in the development environment
                            <options: development>
-  --service-token=<value>  (required) The service token to authenticate with
+  --service-token=<value>  (required) The service token to authenticate with.
+  --workflows-dir=<value>  The target directory path to find all workflows to validate.
 ```
 <!-- commandsstop -->

package/dist/commands/commit/index.js

@@ -28,17 +28,20 @@ class Commit extends _baseCommand.default {
         this.log(`‣ Successfully committed all changes in \`${flags.environment}\` environment`);
     }
 }
+Commit.summary = "Commit all changes in development environment.";
 Commit.flags = {
     environment: _core.Flags.string({
-        summary: "Committing changes applies to the development environment only, use `commit promote` to promote changes to a later environment",
+        summary: "Committing changes applies to the development environment only, use `commit promote` to promote changes to a subsequent environment.",
         default: _const.KnockEnv.Development,
         options: [
             _const.KnockEnv.Development
         ]
     }),
     "commit-message": _core.Flags.string({
-        summary: "Use the given value as the commit message",
+        summary: "Use the given value as the commit message.",
         char: "m"
     }),
-    force: _core.Flags.boolean()
+    force: _core.Flags.boolean({
+        summary: "Remove the confirmation prompt."
+    })
 };

package/dist/commands/commit/promote.js

@@ -27,10 +27,13 @@ class CommitPromote extends _baseCommand.default {
         this.log(`‣ Successfully promoted all changes to \`${flags.to}\` environment`);
     }
 }
+CommitPromote.summary = "Promote all changes to the destination environment.";
 CommitPromote.flags = {
     to: _core.Flags.string({
-        summary: "The destination environment to promote changes from the preceding environment",
+        summary: "The destination environment to promote changes from the preceding environment.",
         required: true
     }),
-    force: _core.Flags.boolean()
+    force: _core.Flags.boolean({
+        summary: "Remove the confirmation prompt."
+    })
 };

package/dist/commands/knock.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>Knock
+});
+const _enquirer = /*#__PURE__*/ _interopRequireDefault(require("enquirer"));
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../lib/base-command"));
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const JOKES = [
+    [
+        "Boo.",
+        "Boo who?",
+        "Don't cry, it's just a joke!"
+    ],
+    [
+        "Cows go.",
+        "Cows go who?",
+        "No silly, cows go moo!"
+    ],
+    [
+        "Lettuce.",
+        "Lettuce who?",
+        "Lettuce in!"
+    ],
+    [
+        "Interrupting cow.",
+        "Interrupting cow wh—",
+        "MOO!"
+    ],
+    [
+        "Alpaca.",
+        "Alpaca who?",
+        "Alpaca the suitcase, let's go on vacation!"
+    ],
+    [
+        "To.",
+        "To who?",
+        "It's to whom."
+    ],
+    [
+        "HIPAA.",
+        "HIPAA who?",
+        "I'm sorry, I’m not authorized to release that information."
+    ],
+    [
+        "Control freak.",
+        "Con–",
+        "Okay, now you say, 'Control freak who?'."
+    ],
+    [
+        "Dejav.",
+        "Dejav who?",
+        "Knock, knock."
+    ],
+    [
+        "Art.",
+        "Art who?",
+        "R2D2!"
+    ],
+    [
+        "Spell.",
+        "Spell who?",
+        "W-h-o"
+    ],
+    [
+        "Beets.",
+        "Beets who?",
+        "Beets me!"
+    ]
+];
+class Knock extends _baseCommand.default {
+    async run() {
+        const promptOpts = {
+            type: "invisible",
+            name: "input"
+        };
+        await _enquirer.default.prompt({
+            ...promptOpts,
+            message: "Who's there?"
+        });
+        const randomIndex = Math.floor(Math.random() * JOKES.length);
+        const lines = JOKES[randomIndex];
+        for (const line of lines){
+            // eslint-disable-next-line no-await-in-loop
+            await _enquirer.default.prompt({
+                ...promptOpts,
+                message: line
+            });
+        }
+        this.log("");
+        this.log("Thank you for using Knock, and have a nice day! 🙂");
+    }
+}
+// Because, it's a secret :)
+Knock.hidden = true;

package/dist/commands/ping.js

@@ -18,7 +18,5 @@ class Ping extends _baseCommand.default {
         this.log(resp.data);
     }
 }
-Ping.description = "Ping the Knock management API to verify access.";
-Ping.examples = [
-    "<%= config.bin %> <%= command.id %>"
-];
+// Deprecated, in favor of the whoami command.
+Ping.hidden = true;