@knocklabs/cli 0.3.1 → 1.0.0

package/dist/commands/workflow/pull.js

@@ -16,6 +16,7 @@ const _error = require("../../lib/helpers/error");
 const _flag = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/helpers/flag"));
 const _objectisomorphic = require("../../lib/helpers/object.isomorphic");
 const _page = require("../../lib/helpers/page");
+const _projectconfig = require("../../lib/helpers/project-config");
 const _request = require("../../lib/helpers/request");
 const _ux = require("../../lib/helpers/ux");
 const _workflow = /*#__PURE__*/ _interop_require_wildcard(require("../../lib/marshal/workflow"));
@@ -132,10 +133,12 @@ class WorkflowPull extends _basecommand.default {
             };
             return (0, _runcontext.ensureResourceDirForTarget)(resourceDir, target);
         }
+        // Default to knock project config first if present, otherwise cwd.
+        const dirCtx = await (0, _projectconfig.resolveResourceDir)(this.projectConfig, "workflow", runCwd);
         // Not inside any existing workflow directory, which means either create a
         // new worfklow directory in the cwd, or update it if there is one already.
         if (workflowKey) {
-            const dirPath = _nodepath.resolve(runCwd, workflowKey);
+            const dirPath = _nodepath.resolve(dirCtx.abspath, workflowKey);
             const exists = await _workflow.isWorkflowDir(dirPath);
             return {
                 type: "workflow",
@@ -151,13 +154,8 @@ class WorkflowPull extends _basecommand.default {
    * Pull all workflows
    */ async pullAllWorkflows() {
         const { flags } = this.props;
-        // TODO: In the future we should default to the knock project config first
-        // if present, before defaulting to the cwd.
-        const defaultToCwd = {
-            abspath: this.runContext.cwd,
-            exists: true
-        };
-        const targetDirCtx = flags["workflows-dir"] || defaultToCwd;
+        const workflowsIndexDirCtx = await (0, _projectconfig.resolveResourceDir)(this.projectConfig, "workflow", this.runContext.cwd);
+        const targetDirCtx = flags["workflows-dir"] || workflowsIndexDirCtx;
         const prompt = targetDirCtx.exists ? `Pull latest workflows into ${targetDirCtx.abspath}?\n  This will overwrite the contents of this directory.` : `Create a new workflows directory at ${targetDirCtx.abspath}?`;
         const input = flags.force || await (0, _ux.promptToConfirm)(prompt);
         if (!input) return;

package/dist/commands/workflow/push.js

@@ -83,7 +83,7 @@ class WorkflowPush extends _basecommand.default {
     async run() {
         const { flags } = this.props;
         // 1. First read all workflow directories found for the given command.
-        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext);
+        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext, this.projectConfig);
         const [workflows, readErrors] = await _workflow.readAllForCommandTarget(target, {
             withExtractedFiles: true
         });

package/dist/commands/workflow/validate.js

@@ -80,7 +80,7 @@ function _interop_require_wildcard(obj, nodeInterop) {
 class WorkflowValidate extends _basecommand.default {
     async run() {
         // 1. Read all workflow directories found for the given command.
-        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext);
+        const target = await _workflow.ensureValidCommandTarget(this.props, this.runContext, this.projectConfig);
         const [workflows, readErrors] = await _workflow.readAllForCommandTarget(target, {
             withExtractedFiles: true
         });

package/dist/lib/api-v1.js

@@ -323,6 +323,13 @@ class ApiV1 {
             params
         });
     }
+    async listAllMessageTypes(params) {
+        const messageTypes = [];
+        for await (const messageType of this.mgmtClient.messageTypes.list(params)){
+            messageTypes.push(messageType);
+        }
+        return messageTypes;
+    }
     async getMessageType({ args, flags }) {
         const params = (0, _objectisomorphic.prune)({
             environment: flags.environment,
@@ -425,6 +432,20 @@ class ApiV1 {
             params
         });
     }
+    async listAllChannels() {
+        const channels = [];
+        for await (const channel of this.mgmtClient.channels.list()){
+            channels.push(channel);
+        }
+        return channels;
+    }
+    async listAllEnvironments() {
+        const environments = [];
+        for await (const environment of this.mgmtClient.environments.list()){
+            environments.push(environment);
+        }
+        return environments;
+    }
     // By methods:
     async get(subpath, config) {
         return this.client.get(`/${API_VERSION}` + subpath, config);
@@ -433,18 +454,18 @@ class ApiV1 {
         return this.client.put(`/${API_VERSION}` + subpath, data, config);
     }
     constructor(sessionContext, config){
+        var _ref;
         var _sessionContext_session;
         _define_property(this, "client", void 0);
         _define_property(this, "mgmtClient", void 0);
         const baseURL = sessionContext.apiOrigin;
         const token = this.getToken(sessionContext);
-        var _sessionContext_session_clientId;
         const headers = {
             // Used to authenticate the request to the API.
             Authorization: `Bearer ${token}`,
             // Used in conjunction with the JWT access token, to allow the OAuth server to
             // verify the client ID of the OAuth client that issued the access token.
-            "x-knock-client-id": (_sessionContext_session_clientId = (_sessionContext_session = sessionContext.session) === null || _sessionContext_session === void 0 ? void 0 : _sessionContext_session.clientId) !== null && _sessionContext_session_clientId !== void 0 ? _sessionContext_session_clientId : undefined,
+            "x-knock-client-id": (_ref = (_sessionContext_session = sessionContext.session) === null || _sessionContext_session === void 0 ? void 0 : _sessionContext_session.clientId) !== null && _ref !== void 0 ? _ref : undefined,
             "User-Agent": `${config.userAgent}`
         };
         this.client = _axios.default.create({

package/dist/lib/auth.js

@@ -198,12 +198,12 @@ async function waitForAccessToken(dashboardUrl, authUrl) {
     };
     const browserUrl = `${authorizationEndpoint}?${new URLSearchParams(params).toString()}`;
     server.on("request", async (req, res)=>{
+        var _req_url;
         if (!clientId || !redirectUri) {
             res.writeHead(500).end("Something went wrong");
             cleanupAndReject("something went wrong");
             return;
         }
-        var _req_url;
         const url = new URL((_req_url = req.url) !== null && _req_url !== void 0 ? _req_url : "/", "http://127.0.0.1");
         if (url.pathname !== callbackPath) {
             res.writeHead(404).end("Invalid path");

package/dist/lib/base-command.js

@@ -12,6 +12,7 @@ const _core = require("@oclif/core");
 const _apiv1 = /*#__PURE__*/ _interop_require_default(require("./api-v1"));
 const _auth = /*#__PURE__*/ _interop_require_default(require("./auth"));
 const _accountfeatures = require("./helpers/account-features");
+const _projectconfig = require("./helpers/project-config");
 const _runcontext = /*#__PURE__*/ _interop_require_wildcard(require("./run-context"));
 const _urls = require("./urls");
 const _userconfig = require("./user-config");
@@ -89,52 +90,54 @@ class BaseCommand extends _core.Command {
         this.configStore = new _userconfig.UserConfigStore(this.config.configDir);
         // 1. Load user's config from the config dir, as available.
         await this.configStore.load();
-        // 2. Parse flags and args, must come after the user config load.
+        // 2. Load project config (knock.json) if available.
+        this.projectConfig = await (0, _projectconfig.findAndReadProjectConfig)();
+        // 3. Parse flags and args, must come after the user config load.
         const { args, flags } = await this.parse(this.ctor);
         this.props = {
             args: args,
             flags: flags
         };
-        // 3. Build the initial session context.
+        // 4. Build the initial session context.
         this.sessionContext = this.buildSessionContext();
-        // 4. If the command requires authentication, ensure the session is authenticated.
+        // 5. If the command requires authentication, ensure the session is authenticated.
         if (this.requiresAuth) {
             this.ensureAuthenticated();
         }
-        // 5. If the session context is an OAuth session, refresh the access token.
+        // 6. If the session context is an OAuth session, refresh the access token.
         if (this.sessionContext.type === "oauth") {
             await this.refreshAccessTokenForSession();
         }
-        // 6. Instantiate a knock api client.
+        // 7. Instantiate a knock api client.
         this.apiV1 = new _apiv1.default(this.sessionContext, this.config);
-        // 7. Verify that required features are enabled for the account.
+        // 8. Verify that required features are enabled for the account.
         const ctor = this.ctor;
         if (ctor.verifyFeatureEnabled) {
             await this.verifyFeatureEnabled(ctor.verifyFeatureEnabled);
         }
-        // 8. Load the run context of the invoked command.
+        // 9. Load the run context of the invoked command.
         this.runContext = await _runcontext.load(this.id);
     }
     buildSessionContext() {
+        var _this_props_flags_servicetoken, _this_props_flags_apiorigin;
         const userConfig = this.configStore.get();
         const session = userConfig.userSession;
         // If the user has a session and a service token is not provided, use the session.
         if (session && !this.props.flags["service-token"]) {
-            var _this_props_flags_apiorigin;
+            var _this_props_flags_apiorigin1;
             return sessionWithDefaultOrigins({
                 type: "oauth",
                 session,
-                apiOrigin: (_this_props_flags_apiorigin = this.props.flags["api-origin"]) !== null && _this_props_flags_apiorigin !== void 0 ? _this_props_flags_apiorigin : userConfig.apiOrigin,
+                apiOrigin: (_this_props_flags_apiorigin1 = this.props.flags["api-origin"]) !== null && _this_props_flags_apiorigin1 !== void 0 ? _this_props_flags_apiorigin1 : userConfig.apiOrigin,
                 dashboardOrigin: userConfig.dashboardOrigin,
                 authOrigin: userConfig.authOrigin
             });
         }
-        var _this_props_flags_servicetoken, _this_props_flags_apiorigin1;
         // Otherwise, default to this being a service token session.
         return sessionWithDefaultOrigins({
             type: "service",
             token: (_this_props_flags_servicetoken = this.props.flags["service-token"]) !== null && _this_props_flags_servicetoken !== void 0 ? _this_props_flags_servicetoken : userConfig.serviceToken,
-            apiOrigin: (_this_props_flags_apiorigin1 = this.props.flags["api-origin"]) !== null && _this_props_flags_apiorigin1 !== void 0 ? _this_props_flags_apiorigin1 : userConfig.apiOrigin,
+            apiOrigin: (_this_props_flags_apiorigin = this.props.flags["api-origin"]) !== null && _this_props_flags_apiorigin !== void 0 ? _this_props_flags_apiorigin : userConfig.apiOrigin,
             dashboardOrigin: userConfig.dashboardOrigin,
             authOrigin: userConfig.authOrigin
         });
@@ -156,12 +159,12 @@ class BaseCommand extends _core.Command {
     async refreshAccessTokenForSession() {
         // Maybe refresh the access token?
         try {
+            var _ref, _ref1;
             var _this_sessionContext_session, _this_sessionContext_session1;
-            var _this_sessionContext_session_clientId, _this_sessionContext_session_refreshToken;
             const refreshedSession = await _auth.default.refreshAccessToken({
                 authUrl: this.sessionContext.authOrigin,
-                clientId: (_this_sessionContext_session_clientId = (_this_sessionContext_session = this.sessionContext.session) === null || _this_sessionContext_session === void 0 ? void 0 : _this_sessionContext_session.clientId) !== null && _this_sessionContext_session_clientId !== void 0 ? _this_sessionContext_session_clientId : "",
-                refreshToken: (_this_sessionContext_session_refreshToken = (_this_sessionContext_session1 = this.sessionContext.session) === null || _this_sessionContext_session1 === void 0 ? void 0 : _this_sessionContext_session1.refreshToken) !== null && _this_sessionContext_session_refreshToken !== void 0 ? _this_sessionContext_session_refreshToken : ""
+                clientId: (_ref = (_this_sessionContext_session = this.sessionContext.session) === null || _this_sessionContext_session === void 0 ? void 0 : _this_sessionContext_session.clientId) !== null && _ref !== void 0 ? _ref : "",
+                refreshToken: (_ref1 = (_this_sessionContext_session1 = this.sessionContext.session) === null || _this_sessionContext_session1 === void 0 ? void 0 : _this_sessionContext_session1.refreshToken) !== null && _ref1 !== void 0 ? _ref1 : ""
             });
             this.debug("Successfully refreshed access token.");
             // Update the user config to use the new session.
@@ -178,7 +181,7 @@ class BaseCommand extends _core.Command {
         }
     }
     constructor(...args){
-        super(...args), _define_property(this, "props", void 0), _define_property(this, "apiV1", void 0), _define_property(this, "runContext", void 0), _define_property(this, "sessionContext", void 0), _define_property(this, "configStore", void 0), _define_property(this, "requiresAuth", true);
+        super(...args), _define_property(this, "props", void 0), _define_property(this, "apiV1", void 0), _define_property(this, "runContext", void 0), _define_property(this, "sessionContext", void 0), _define_property(this, "configStore", void 0), _define_property(this, "projectConfig", void 0), _define_property(this, "requiresAuth", true);
     }
 }
 _define_property(BaseCommand, "verifyFeatureEnabled", void 0);

package/dist/lib/helpers/project-config.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get PROJECT_CONFIG_FILE_NAME () {
+        return PROJECT_CONFIG_FILE_NAME;
+    },
+    get ResourceDirectoriesByType () {
+        return ResourceDirectoriesByType;
+    },
+    get findAndReadProjectConfig () {
+        return findAndReadProjectConfig;
+    },
+    get findProjectConfig () {
+        return findProjectConfig;
+    },
+    get readProjectConfig () {
+        return readProjectConfig;
+    },
+    get resolveKnockDir () {
+        return resolveKnockDir;
+    },
+    get resolveResourceDir () {
+        return resolveResourceDir;
+    }
+});
+const _nodepath = /*#__PURE__*/ _interop_require_wildcard(require("node:path"));
+const _findup = /*#__PURE__*/ _interop_require_default(require("find-up"));
+const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+const _zod = require("zod");
+const _fs = require("./fs");
+function _interop_require_default(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 _interop_require_wildcard(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 = {
+        __proto__: null
+    };
+    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;
+}
+const PROJECT_CONFIG_FILE_NAME = "knock.json";
+/**
+ * Schema for the project configuration file.
+ */ const projectConfigSchema = _zod.z.object({
+    knockDir: _zod.z.string()
+});
+const findProjectConfig = async ()=>{
+    const configPath = await (0, _findup.default)(PROJECT_CONFIG_FILE_NAME);
+    return configPath;
+};
+const readProjectConfig = async (configPath)=>{
+    const rawConfig = await _fsextra.readJSON(configPath);
+    const config = projectConfigSchema.parse(rawConfig);
+    return config;
+};
+const resolveKnockDir = async (knockDirFlag, projectConfig)=>{
+    if (knockDirFlag) {
+        return knockDirFlag;
+    }
+    if (!projectConfig) {
+        return undefined;
+    }
+    // Project configuration exists, must is invalid. So we error out.
+    if ([
+        "",
+        undefined,
+        null
+    ].includes(projectConfig.knockDir)) {
+        throw new Error("No knock directory specified in the project configuration");
+    }
+    const abspath = _nodepath.isAbsolute(projectConfig.knockDir) ? projectConfig.knockDir : _nodepath.resolve(process.cwd(), projectConfig.knockDir);
+    const exists = await _fsextra.pathExists(abspath);
+    if (!exists || !await (0, _fs.isDirectory)(abspath)) {
+        throw new Error(`${projectConfig.knockDir} does not exist or is not a directory`);
+    }
+    return {
+        abspath,
+        exists
+    };
+};
+const findAndReadProjectConfig = async ()=>{
+    const configPath = await findProjectConfig();
+    if (!configPath) {
+        return undefined;
+    }
+    return readProjectConfig(configPath);
+};
+const ResourceDirectoriesByType = {
+    workflow: "workflows",
+    guide: "guides",
+    partial: "partials",
+    email_layout: "layouts",
+    message_type: "message-types",
+    translation: "translations"
+};
+const resolveResourceDir = async (projectConfig, resourceType, basePath = process.cwd())=>{
+    if (!projectConfig) {
+        return {
+            abspath: basePath,
+            exists: true
+        };
+    }
+    const absoluteKnockDir = _nodepath.isAbsolute(projectConfig.knockDir) ? projectConfig.knockDir : _nodepath.resolve(basePath, projectConfig.knockDir);
+    const resourceDir = ResourceDirectoriesByType[resourceType];
+    const absResourceDirPath = _nodepath.resolve(absoluteKnockDir, resourceDir);
+    const exists = await _fsextra.pathExists(absResourceDirPath);
+    if (exists && !await (0, _fs.isDirectory)(absResourceDirPath)) {
+        throw new Error(`${absResourceDirPath} is not a directory`);
+    }
+    return {
+        abspath: absResourceDirPath,
+        exists
+    };
+};

package/dist/lib/helpers/request.js

@@ -49,14 +49,13 @@ const formatErrorRespMessage = ({ status, data })=>{
     return message;
 };
 const formatMgmtError = (apiError)=>{
+    var _apiError_error_message, _apiError_error_errors;
     if (apiError.status === 500) {
         return "An internal server error occurred";
     }
-    var _apiError_error_message;
     // Prefer the error message from the error object over
     // the error message formatted by the Stainless SDK
     const description = `${(_apiError_error_message = apiError.error.message) !== null && _apiError_error_message !== void 0 ? _apiError_error_message : apiError.message} (status: ${apiError.status})`;
-    var _apiError_error_errors;
     const inputErrors = (_apiError_error_errors = apiError.error.errors) !== null && _apiError_error_errors !== void 0 ? _apiError_error_errors : [];
     if (Array.isArray(inputErrors) && inputErrors.length > 0) {
         const errs = inputErrors.map((e)=>new _error.JsonDataError(e.message, e.field));

package/dist/lib/helpers/string.js

@@ -1,6 +1,4 @@
-/*
- * Checks if a given string is in a slugified format.
- */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
@@ -21,7 +19,9 @@ _export(exports, {
         return slugify;
     }
 });
-const SLUG_FORMAT_RE = /^[\w-]+$/;
+/*
+ * Checks if a given string is in a slugified format.
+ */ const SLUG_FORMAT_RE = /^[\w-]+$/;
 const SLUG_LOWERCASE_FORMAT_RE = /^[\d_a-z-]+$/;
 const checkSlugifiedFormat = (input, opts = {})=>{
     const { onlyLowerCase = true } = opts;

package/dist/lib/helpers/typegen.js

@@ -44,10 +44,10 @@ function getLanguageFromExtension(extension) {
     }
 }
 function transformSchema(schema) {
+    var _schema_properties;
     if (schema.type === "object" && !schema.additionalProperties) {
         schema.additionalProperties = false;
     }
-    var _schema_properties;
     for (const key of Object.keys((_schema_properties = schema.properties) !== null && _schema_properties !== void 0 ? _schema_properties : {})){
         const property = schema.properties[key];
         if (property.type === "object") {

package/dist/lib/marshal/email-layout/generator.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get generateEmailLayoutDir () {
+        return generateEmailLayoutDir;
+    },
+    get generateEmailLayoutFromTemplate () {
+        return generateEmailLayoutFromTemplate;
+    },
+    get scaffoldEmailLayoutDirBundle () {
+        return scaffoldEmailLayoutDirBundle;
+    },
+    get validateEmailLayoutKey () {
+        return validateEmailLayoutKey;
+    }
+});
+const _lodash = require("lodash");
+const _string = require("../../helpers/string");
+const _templates = /*#__PURE__*/ _interop_require_wildcard(require("../../templates"));
+const _constisomorphic = require("../shared/const.isomorphic");
+const _processorisomorphic = require("./processor.isomorphic");
+const _reader = require("./reader");
+const _writer = require("./writer");
+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 _interop_require_wildcard(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 = {
+        __proto__: null
+    };
+    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;
+}
+const validateEmailLayoutKey = (input)=>{
+    if (!(0, _string.checkSlugifiedFormat)(input, {
+        onlyLowerCase: true
+    })) {
+        return "must include only lowercase alphanumeric, dash, or underscore characters";
+    }
+    return undefined;
+};
+/*
+ * Returns the default scaffolded HTML layout content.
+ */ const defaultHtmlLayoutContent = ()=>{
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{ title }}</title>
+</head>
+<body>
+  <div style="max-width: 600px; margin: 0 auto; padding: 20px;">
+    {{ content }}
+  </div>
+</body>
+</html>`;
+};
+/*
+ * Returns the default scaffolded text layout content.
+ */ const defaultTextLayoutContent = ()=>{
+    return `{{ content }}`;
+};
+/*
+ * Scaffolds a new email layout directory bundle with default content.
+ */ const scaffoldEmailLayoutDirBundle = (attrs)=>{
+    const htmlLayoutFilePath = "html_layout.html";
+    const textLayoutFilePath = "text_layout.txt";
+    const defaultHtmlContent = defaultHtmlLayoutContent();
+    const defaultTextContent = defaultTextLayoutContent();
+    const layoutJson = {
+        name: attrs.name,
+        [`html_layout${_constisomorphic.FILEPATH_MARKER}`]: htmlLayoutFilePath,
+        [`text_layout${_constisomorphic.FILEPATH_MARKER}`]: textLayoutFilePath
+    };
+    return {
+        [_processorisomorphic.LAYOUT_JSON]: layoutJson,
+        [htmlLayoutFilePath]: defaultHtmlContent,
+        [textLayoutFilePath]: defaultTextContent
+    };
+};
+const generateEmailLayoutDir = async (emailLayoutDirCtx, attrs)=>{
+    const bundle = scaffoldEmailLayoutDirBundle(attrs);
+    return (0, _writer.writeEmailLayoutDirFromBundle)(emailLayoutDirCtx, bundle);
+};
+const generateEmailLayoutFromTemplate = async (emailLayoutDirCtx, templateString, attrs)=>{
+    let tempDir;
+    try {
+        // Download the template directory into a temp directory
+        tempDir = await _templates.downloadTemplate(templateString);
+        // Create an email layout directory context for the temp directory
+        const tempEmailLayoutDirCtx = {
+            type: "email_layout",
+            key: "temp",
+            abspath: tempDir,
+            exists: true
+        };
+        // Read the layout.json from the temp directory we downloaded
+        const [emailLayout, errors] = await (0, _reader.readEmailLayoutDir)(tempEmailLayoutDirCtx, {
+            withExtractedFiles: true
+        });
+        if (errors.length > 0 || !emailLayout) {
+            throw new Error(`Invalid email layout template: ${errors.join(", ")}`);
+        }
+        // Modify the email layout data with the new attributes
+        const emailLayoutData = (0, _lodash.cloneDeep)(emailLayout);
+        emailLayoutData.name = attrs.name;
+        // Finally, we write the email layout into the target email layout directory
+        await (0, _writer.writeEmailLayoutDirFromData)(emailLayoutDirCtx, emailLayoutData);
+    } finally{
+        await _templates.cleanupTempDir(tempDir);
+    }
+};

package/dist/lib/marshal/email-layout/helpers.js

@@ -25,6 +25,7 @@ _export(exports, {
 const _nodepath = /*#__PURE__*/ _interop_require_wildcard(require("node:path"));
 const _core = require("@oclif/core");
 const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
+const _projectconfig = require("../../helpers/project-config");
 const _processorisomorphic = require("./processor.isomorphic");
 function _getRequireWildcardCache(nodeInterop) {
     if (typeof WeakMap !== "function") return null;
@@ -74,7 +75,7 @@ const lsEmailLayoutJson = async (dirPath)=>{
     const exists = await _fsextra.pathExists(emailLayoutJsonPath);
     return exists ? emailLayoutJsonPath : undefined;
 };
-const ensureValidCommandTarget = async (props, runContext)=>{
+const ensureValidCommandTarget = async (props, runContext, projectConfig)=>{
     const { args, flags } = props;
     const { commandId, resourceDir: resourceDirCtx, cwd: runCwd } = runContext;
     // If the target resource is a different type than the current resource dir
@@ -86,19 +87,15 @@ const ensureValidCommandTarget = async (props, runContext)=>{
     if (flags.all && args.emailLayoutKey) {
         return _core.ux.error(`emailLayoutKey arg \`${args.emailLayoutKey}\` cannot also be provided when using --all`);
     }
+    // Default to knock project config first if present, otherwise cwd.
+    const layoutsIndexDirCtx = await (0, _projectconfig.resolveResourceDir)(projectConfig, "email_layout", runCwd);
     // --all flag is given, which means no layout key arg.
     if (flags.all) {
         // If --all flag used inside a layout directory, then require a layouts dir path.
         if (resourceDirCtx && !flags["layouts-dir"]) {
             return _core.ux.error("Missing required flag layouts-dir");
         }
-        // Targeting all layout dirs in the layouts index dir.
-        // TODO: Default to the knock project config first if present before cwd.
-        const defaultToCwd = {
-            abspath: runCwd,
-            exists: true
-        };
-        const indexDirCtx = flags["layouts-dir"] || defaultToCwd;
+        const indexDirCtx = flags["layouts-dir"] || layoutsIndexDirCtx;
         return {
             type: "emailLayoutsIndexDir",
             context: indexDirCtx
@@ -109,7 +106,7 @@ const ensureValidCommandTarget = async (props, runContext)=>{
         if (resourceDirCtx && resourceDirCtx.key !== args.emailLayoutKey) {
             return _core.ux.error(`Cannot run ${commandId} \`${args.emailLayoutKey}\` inside another layout directory:\n${resourceDirCtx.key}`);
         }
-        const targetDirPath = resourceDirCtx ? resourceDirCtx.abspath : _nodepath.resolve(runCwd, args.emailLayoutKey);
+        const targetDirPath = resourceDirCtx ? resourceDirCtx.abspath : _nodepath.resolve(layoutsIndexDirCtx.abspath, args.emailLayoutKey);
         const layoutDirCtx = {
             type: "email_layout",
             key: args.emailLayoutKey,

package/dist/lib/marshal/email-layout/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+_export_star(require("./generator"), exports);
 _export_star(require("./helpers"), exports);
 _export_star(require("./processor.isomorphic"), exports);
 _export_star(require("./reader"), exports);