@knocklabs/cli 0.1.3 → 0.1.5

package/dist/commands/layout/list.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>EmailLayoutList
+});
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _date = require("../../lib/helpers/date");
+const _object = require("../../lib/helpers/object");
+const _page = require("../../lib/helpers/page");
+const _request = require("../../lib/helpers/request");
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+class EmailLayoutList extends _baseCommand.default {
+    async run() {
+        const resp = await this.request();
+        const { flags  } = this.props;
+        if (flags.json) return resp.data;
+        this.render(resp.data);
+    }
+    async request(pageParams = {}) {
+        const props = (0, _object.merge)(this.props, {
+            flags: {
+                ...pageParams
+            }
+        });
+        return (0, _request.withSpinner)(()=>this.apiV1.listEmailLayouts(props));
+    }
+    async render(data) {
+        const { entries  } = data;
+        const { environment: env , "hide-uncommitted-changes": commitedOnly  } = this.props.flags;
+        const qualifier = env === "development" && !commitedOnly ? "(including uncommitted)" : "";
+        this.log(`‣ Showing ${entries.length} email layouts in \`${env}\` environment ${qualifier}\n`);
+        /*
+     * Email layouts table
+     */ _core.ux.table(entries, {
+            key: {
+                header: "Key"
+            },
+            name: {
+                header: "Name"
+            },
+            updated_at: {
+                header: "Updated at",
+                get: (entry)=>(0, _date.formatDate)(entry.updated_at)
+            },
+            created_at: {
+                header: "Created at",
+                get: (entry)=>(0, _date.formatDate)(entry.created_at)
+            }
+        });
+        return this.prompt(data);
+    }
+    async prompt(data) {
+        const { page_info  } = data;
+        const pageAction = await (0, _page.maybePromptPageAction)(page_info);
+        const pageParams = pageAction && (0, _page.paramsForPageAction)(pageAction, page_info);
+        if (pageParams) {
+            this.log("\n");
+            const resp = await this.request(pageParams);
+            return this.render(resp.data);
+        }
+    }
+}
+EmailLayoutList.aliases = [
+    "email-layout:list",
+    "email_layout:list"
+];
+EmailLayoutList.summary = "Display all email layouts for an environment.";
+EmailLayoutList.flags = {
+    environment: _core.Flags.string({
+        default: "development",
+        summary: "The environment to use."
+    }),
+    "hide-uncommitted-changes": _core.Flags.boolean({
+        summary: "Hide any uncommitted changes."
+    }),
+    ..._page.pageFlags
+};
+EmailLayoutList.enableJsonFlag = true;

package/dist/commands/layout/pull.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>EmailLayoutPull
+});
+const _nodePath = /*#__PURE__*/ _interopRequireWildcard(require("node:path"));
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _error = require("../../lib/helpers/error");
+const _flag = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/helpers/flag"));
+const _object = require("../../lib/helpers/object");
+const _page = require("../../lib/helpers/page");
+const _request = require("../../lib/helpers/request");
+const _ux = require("../../lib/helpers/ux");
+const _emailLayout = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/email-layout"));
+const _runContext = require("../../lib/run-context");
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interopRequireWildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {};
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+class EmailLayoutPull extends _baseCommand.default {
+    async run() {
+        const { args , flags  } = this.props;
+        if (flags.all && args.emailLayoutKey) {
+            return this.error(`emailLayoutKey arg \`${args.emailLayoutKey}\` cannot also be provided when using --all`);
+        }
+        return flags.all ? this.pullAllEmailLayouts() : this.pullOneEmailLayout();
+    }
+    // Pull one email layout
+    async pullOneEmailLayout() {
+        const { flags  } = this.props;
+        const dirContext = await this.getEmailLayoutDirContext();
+        if (dirContext.exists) {
+            this.log(`‣ Found \`${dirContext.key}\` at ${dirContext.abspath}`);
+        } else {
+            const prompt = `Create a new email layout directory \`${dirContext.key}\` at ${dirContext.abspath}?`;
+            const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+            if (!input) return;
+        }
+        const resp = await (0, _request.withSpinner)(()=>{
+            const props = (0, _object.merge)(this.props, {
+                args: {
+                    emailLayoutKey: dirContext.key
+                },
+                flags: {
+                    annotate: true
+                }
+            });
+            return this.apiV1.getEmailLayout(props);
+        });
+        await _emailLayout.writeEmailLayoutDirFromData(dirContext, resp.data);
+        const action = dirContext.exists ? "updated" : "created";
+        this.log(`‣ Successfully ${action} \`${dirContext.key}\` at ${dirContext.abspath}`);
+    }
+    // Pull all email layouts
+    async pullAllEmailLayouts() {
+        const { flags  } = this.props;
+        const defaultToCwd = {
+            abspath: this.runContext.cwd,
+            exists: true
+        };
+        const targetDirCtx = flags["layouts-dir"] || defaultToCwd;
+        const prompt = targetDirCtx.exists ? `Pull latest layouts into ${targetDirCtx.abspath}?\n  This will overwrite the contents of this directory.` : `Create a new layouts directory at ${targetDirCtx.abspath}?`;
+        const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
+        if (!input) return;
+        _ux.spinner.start(`‣ Loading`);
+        const emailLayouts = await this.listAllEmailLayouts();
+        await _emailLayout.writeEmailLayoutIndexDir(targetDirCtx, emailLayouts);
+        _ux.spinner.stop();
+        const action = targetDirCtx.exists ? "updated" : "created";
+        this.log(`‣ Successfully ${action} the layouts directory at ${targetDirCtx.abspath}`);
+    }
+    async listAllEmailLayouts(pageParams = {}, emailLayoutsFetchedSoFar = []) {
+        const props = (0, _object.merge)(this.props, {
+            flags: {
+                ...pageParams,
+                annotate: true,
+                limit: _page.MAX_PAGINATION_LIMIT
+            }
+        });
+        const resp = await this.apiV1.listEmailLayouts(props);
+        if (!(0, _request.isSuccessResp)(resp)) {
+            const message = (0, _request.formatErrorRespMessage)(resp);
+            this.error(new _error.ApiError(message));
+        }
+        const { entries , page_info: pageInfo  } = resp.data;
+        const emailLayouts = [
+            ...emailLayoutsFetchedSoFar,
+            ...entries
+        ];
+        return pageInfo.after ? this.listAllEmailLayouts({
+            after: pageInfo.after
+        }, emailLayouts) : emailLayouts;
+    }
+    async getEmailLayoutDirContext() {
+        const { emailLayoutKey  } = this.props.args;
+        const { resourceDir , cwd: runCwd  } = this.runContext;
+        // Inside an existing resource dir, use it if valid for the target email layout.
+        if (resourceDir) {
+            const target = {
+                commandId: _baseCommand.default.id,
+                type: "email_layout",
+                key: emailLayoutKey
+            };
+            return (0, _runContext.ensureResourceDirForTarget)(resourceDir, target);
+        }
+        // Not inside any existing email layout directory, which means either create a
+        // new email layout directory in the cwd, or update it if there is one already.
+        if (emailLayoutKey) {
+            const dirPath = _nodePath.resolve(runCwd, emailLayoutKey);
+            const exists = await _emailLayout.isEmailLayoutDir(dirPath);
+            return {
+                type: "email_layout",
+                key: emailLayoutKey,
+                abspath: dirPath,
+                exists
+            };
+        }
+        // Not in any email layout directory, nor a email layout key arg was given so error.
+        return this.error("Missing 1 required arg:\nemailLayoutKey");
+    }
+}
+EmailLayoutPull.aliases = [
+    "email-layout:pull",
+    "email_layout:pull"
+];
+EmailLayoutPull.summary = "Pull one or more email layouts from an environment into a local file system.";
+EmailLayoutPull.flags = {
+    environment: _core.Flags.string({
+        default: "development",
+        summary: "The environment to use."
+    }),
+    all: _core.Flags.boolean({
+        summary: "Whether to pull all email layouts from the specified environment."
+    }),
+    "layouts-dir": _flag.dirPath({
+        summary: "The target directory path to pull all email layouts into.",
+        dependsOn: [
+            "all"
+        ],
+        aliases: [
+            "email-layouts-dir"
+        ]
+    }),
+    "hide-uncommitted-changes": _core.Flags.boolean({
+        summary: "Hide any uncommitted changes."
+    }),
+    force: _core.Flags.boolean({
+        summary: "Remove the confirmation prompt."
+    })
+};
+EmailLayoutPull.args = {
+    emailLayoutKey: _core.Args.string({
+        required: false
+    })
+};

package/dist/commands/layout/push.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>EmailLayoutPush
+});
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _const = require("../../lib/helpers/const");
+const _error = require("../../lib/helpers/error");
+const _flag = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/helpers/flag"));
+const _object = require("../../lib/helpers/object");
+const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
+const _ux = require("../../lib/helpers/ux");
+const _emailLayout = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/email-layout"));
+const _validate = /*#__PURE__*/ _interopRequireDefault(require("./validate"));
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interopRequireWildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {};
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+class EmailLayoutPush extends _baseCommand.default {
+    async run() {
+        const { flags  } = this.props;
+        // 1. First read all layout directories found for the given command.
+        const target = await _emailLayout.ensureValidCommandTarget(this.props, this.runContext);
+        const [layouts, readErrors] = await _emailLayout.readAllForCommandTarget(target, {
+            withExtractedFiles: true
+        });
+        if (readErrors.length > 0) {
+            this.error((0, _error.formatErrors)(readErrors, {
+                prependBy: "\n\n"
+            }));
+        }
+        if (layouts.length === 0) {
+            this.error(`No layout directories found in ${target.context.abspath}`);
+        }
+        // 2. Then validate them all ahead of pushing them.
+        _ux.spinner.start(`‣ Validating`);
+        const apiErrors = await _validate.default.validateAll(this.apiV1, this.props, layouts);
+        if (apiErrors.length > 0) {
+            this.error((0, _error.formatErrors)(apiErrors, {
+                prependBy: "\n\n"
+            }));
+        }
+        _ux.spinner.stop();
+        // 3. Finally push up each layout, abort on the first error.
+        _ux.spinner.start(`‣ Pushing`);
+        for (const layout of layouts){
+            const props = (0, _object.merge)(this.props, {
+                flags: {
+                    annotate: true
+                }
+            });
+            // eslint-disable-next-line no-await-in-loop
+            const resp = await this.apiV1.upsertEmailLayout(props, {
+                ...layout.content,
+                key: layout.key
+            });
+            if ((0, _request.isSuccessResp)(resp)) {
+                // Update the layout directory with the successfully pushed layout
+                // payload from the server.
+                // eslint-disable-next-line no-await-in-loop
+                await _emailLayout.writeEmailLayoutDirFromData(layout, resp.data.email_layout);
+                continue;
+            }
+            const error = new _error.SourceError((0, _request.formatErrorRespMessage)(resp), _emailLayout.emailLayoutJsonPath(layout), "ApiError");
+            this.error((0, _error.formatError)(error));
+        }
+        _ux.spinner.stop();
+        // 4. Display a success message.
+        const layoutKeys = layouts.map((l)=>l.key);
+        const actioned = flags.commit ? "pushed and committed" : "pushed";
+        this.log(`‣ Successfully ${actioned} ${layouts.length} layout(s):\n` + (0, _string.indentString)(layoutKeys.join("\n"), 4));
+    }
+}
+EmailLayoutPush.aliases = [
+    "email-layout:push",
+    "email_layout:push"
+];
+EmailLayoutPush.summary = "Push one or more email layouts from a local file system to Knock.";
+EmailLayoutPush.flags = {
+    environment: _core.Flags.string({
+        summary: "Pushing an email layout is only allowed in the development environment",
+        default: _const.KnockEnv.Development,
+        options: [
+            _const.KnockEnv.Development
+        ]
+    }),
+    all: _core.Flags.boolean({
+        summary: "Whether to push all layouts from the target directory."
+    }),
+    "layouts-dir": _flag.dirPath({
+        summary: "The target directory path to find all layouts to push.",
+        dependsOn: [
+            "all"
+        ],
+        aliases: [
+            "email-layouts-dir"
+        ]
+    }),
+    commit: _core.Flags.boolean({
+        summary: "Push and commit the layout(s) at the same time"
+    }),
+    "commit-message": _core.Flags.string({
+        summary: "Use the given value as the commit message",
+        char: "m",
+        dependsOn: [
+            "commit"
+        ]
+    })
+};
+EmailLayoutPush.args = {
+    emailLayoutKey: _core.Args.string({
+        required: false
+    })
+};

package/dist/commands/layout/validate.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: ()=>EmailLayoutValidate
+});
+const _core = require("@oclif/core");
+const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
+const _const = require("../../lib/helpers/const");
+const _error = require("../../lib/helpers/error");
+const _flag = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/helpers/flag"));
+const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
+const _ux = require("../../lib/helpers/ux");
+const _emailLayout = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/email-layout"));
+function _interopRequireDefault(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interopRequireWildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {};
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+class EmailLayoutValidate extends _baseCommand.default {
+    async run() {
+        // 1. Read all layout directories found for the given command.
+        const target = await _emailLayout.ensureValidCommandTarget(this.props, this.runContext);
+        const [layouts, readErrors] = await _emailLayout.readAllForCommandTarget(target, {
+            withExtractedFiles: true
+        });
+        if (readErrors.length > 0) {
+            this.error((0, _error.formatErrors)(readErrors, {
+                prependBy: "\n\n"
+            }));
+        }
+        if (layouts.length === 0) {
+            this.error(`No layout directories found in ${target.context.abspath}`);
+        }
+        // 2. Validate each layout data
+        _ux.spinner.start(`‣ Validating`);
+        const apiErrors = await EmailLayoutValidate.validateAll(this.apiV1, this.props, layouts);
+        if (apiErrors.length > 0) {
+            this.error((0, _error.formatErrors)(apiErrors, {
+                prependBy: "\n\n"
+            }));
+        }
+        _ux.spinner.stop();
+        // 3. Display a success message.
+        const layoutsKey = layouts.map((l)=>l.key);
+        this.log(`‣ Successfully validated ${layouts.length} layout(s):\n` + (0, _string.indentString)(layoutsKey.join("\n"), 4));
+    }
+    static async validateAll(api, props, layouts) {
+        const errorPromises = layouts.map(async (layout)=>{
+            const resp = await api.validateEmailLayout(props, {
+                ...layout.content,
+                key: layout.key
+            });
+            if ((0, _request.isSuccessResp)(resp)) return;
+            const error = new _error.SourceError((0, _request.formatErrorRespMessage)(resp), _emailLayout.emailLayoutJsonPath(layout), "ApiError");
+            return error;
+        });
+        const errors = (await Promise.all(errorPromises)).filter((e)=>Boolean(e));
+        return errors;
+    }
+}
+EmailLayoutValidate.aliases = [
+    "email-layout:validate",
+    "email_layout:validate"
+];
+EmailLayoutValidate.summary = "Validate one or more layouts from a local file system.";
+EmailLayoutValidate.flags = {
+    environment: _core.Flags.string({
+        summary: "Validating a layout is only done in the development environment",
+        default: _const.KnockEnv.Development,
+        options: [
+            _const.KnockEnv.Development
+        ]
+    }),
+    all: _core.Flags.boolean({
+        summary: "Whether to validate all layouts from the target directory."
+    }),
+    "layouts-dir": _flag.dirPath({
+        summary: "The target directory path to find all layouts to validate.",
+        dependsOn: [
+            "all"
+        ],
+        aliases: [
+            "email-layouts-dir"
+        ]
+    })
+};
+EmailLayoutValidate.args = {
+    emailLayoutKey: _core.Args.string({
+        required: false
+    })
+};

package/dist/commands/workflow/get.js

@@ -9,7 +9,10 @@ Object.defineProperty(exports, "default", {
 const _core = require("@oclif/core");
 const _baseCommand = /*#__PURE__*/ _interopRequireDefault(require("../../lib/base-command"));
 const _date = require("../../lib/helpers/date");
+const _error = require("../../lib/helpers/error");
 const _request = require("../../lib/helpers/request");
+const _string = require("../../lib/helpers/string");
+const _ux = require("../../lib/helpers/ux");
 const _conditions = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/conditions"));
 const _workflow = /*#__PURE__*/ _interopRequireWildcard(require("../../lib/marshal/workflow"));
 function _interopRequireDefault(obj) {
@@ -58,12 +61,30 @@ function _interopRequireWildcard(obj, nodeInterop) {
 }
 class WorkflowGet extends _baseCommand.default {
     async run() {
-        const resp = await (0, _request.withSpinner)(()=>this.apiV1.getWorkflow(this.props));
+        _ux.spinner.start("‣ Loading");
+        const { workflow , whoami  } = await this.loadWorkflow();
+        _ux.spinner.stop();
         const { flags  } = this.props;
-        if (flags.json) return resp.data;
-        this.render(resp.data);
+        if (flags.json) return workflow;
+        this.render(workflow, whoami);
     }
-    render(workflow) {
+    async loadWorkflow() {
+        const workflowResp = await this.apiV1.getWorkflow(this.props);
+        if (!(0, _request.isSuccessResp)(workflowResp)) {
+            const message = (0, _request.formatErrorRespMessage)(workflowResp);
+            _core.ux.error(new _error.ApiError(message));
+        }
+        const whoamiResp = await this.apiV1.whoami();
+        if (!(0, _request.isSuccessResp)(whoamiResp)) {
+            const message = (0, _request.formatErrorRespMessage)(whoamiResp);
+            _core.ux.error(new _error.ApiError(message));
+        }
+        return {
+            workflow: workflowResp.data,
+            whoami: whoamiResp.data
+        };
+    }
+    render(workflow, whoami) {
         const { workflowKey  } = this.props.args;
         const { environment: env , "hide-uncommitted-changes": commitedOnly  } = this.props.flags;
         const qualifier = env === "development" && !commitedOnly ? "(including uncommitted)" : "";
@@ -130,11 +151,13 @@ class WorkflowGet extends _baseCommand.default {
             },
             ref: {
                 header: "Ref",
-                minWidth: 18
+                minWidth: 18,
+                get: (step)=>step.ref
             },
             type: {
                 header: "Type",
-                minWidth: 12
+                minWidth: 12,
+                get: (step)=>step.type
             },
             summary: {
                 header: "Summary",
@@ -142,9 +165,18 @@ class WorkflowGet extends _baseCommand.default {
             },
             conditions: {
                 header: "Conditions",
-                get: (step)=>step.conditions ? _conditions.formatConditions(step.conditions) : "-"
+                get: (step)=>{
+                    if (step.type === _workflow.StepType.Branch) return "-";
+                    if (!step.conditions) return "-";
+                    return _conditions.formatConditions(step.conditions);
+                }
             }
         });
+        const hasTopLevelBranchStep = workflow.steps.some((step)=>step.type === _workflow.StepType.Branch);
+        const dashboardLinkMessage = hasTopLevelBranchStep ? `\n‣ This workflow has branches with nested steps, view the full workflow tree in the Knock Dashboard:` : `\n‣ View the full workflow in the Knock Dashboard:`;
+        const viewWorkflowUrl = `https://dashboard.knock.app/${whoami.account_slug}/${env.toLowerCase()}/workflows/${workflow.key}`;
+        this.log(dashboardLinkMessage);
+        this.log((0, _string.indentString)(viewWorkflowUrl, 2));
     }
 }
 WorkflowGet.summary = "Display a single workflow from an environment.";

package/dist/commands/workflow/list.js

@@ -98,7 +98,10 @@ class WorkflowList extends _baseCommand.default {
             },
             steps: {
                 header: "Steps",
-                get: (entry)=>entry.steps.length > 0 ? entry.steps.length : "-"
+                get: (entry)=>{
+                    const result = _workflow.countSteps(entry);
+                    return result > 0 ? result : "-";
+                }
             },
             updated_at: {
                 header: "Updated at",