@mailmodo/cli 0.0.22 → 0.0.23-beta.pr25.40

package/dist/commands/deploy/index.d.ts

@@ -6,14 +6,9 @@ export default class Deploy extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    /**
-     * Fetches current DNS verification status for the deploy flow.
-     *
-     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
-     * @param domain - Sending domain to check. If empty, request will fail and trigger setup flow.
-     */
     private fetchDomainVerifyForDeploy;
     run(): Promise<void>;
+    private validateSequence;
     private buildDeployPayload;
     private mapEmailToPayload;
     private buildBrandSection;
@@ -22,32 +17,11 @@ export default class Deploy extends BaseCommand {
     private buildProjectPayload;
     private confirmDeploy;
     private ensureDomainReady;
-    /**
-     * Lists emails about to be deployed (skipped when `--json` is set).
-     *
-     * @param yamlConfig - Loaded project YAML.
-     * @param jsonOutput - When true, skip human-readable output.
-     */
     private logPreDeploySummary;
-    /**
-     * Prints the post-deploy success message and SDK install snippet for interactive runs.
-     */
+    private logDiff;
     private logDeploySuccessInstructions;
-    /**
-     * Interactive domain setup flow. Collects domain, sender email, and business
-     * address from the user, then calls the API to get DNS records to configure.
-     * Polls for verification when the user indicates they've added the records.
-     *
-     * @returns {Promise<boolean>} true if domain was verified, false if skipped.
-     */
     private runDomainSetup;
     private collectDomainInputs;
     private showDnsRecords;
-    /**
-     * Calls the domain verification API endpoint and reports pass/fail
-     * status for each DNS record (DKIM, DMARC, Return-Path).
-     *
-     * @returns {Promise<boolean>} true if all records pass.
-     */
     private verifyDomain;
 }

package/dist/commands/deploy/index.js

@@ -12,12 +12,6 @@ export default class Deploy extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
     };
-    /**
-     * Fetches current DNS verification status for the deploy flow.
-     *
-     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
-     * @param domain - Sending domain to check. If empty, request will fail and trigger setup flow.
-     */
     fetchDomainVerifyForDeploy(jsonOutput, domain) {
         return this.withApiSpinner({ json: jsonOutput, text: '  Checking domain verification...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
             domain: domain || '',
@@ -30,11 +24,12 @@ export default class Deploy extends BaseCommand {
         const domainReady = await this.ensureDomainReady(yamlConfig, flags);
         if (!domainReady)
             return;
-        this.logPreDeploySummary(yamlConfig, flags.json);
+        const payload = await this.buildDeployPayload(yamlConfig);
+        const validateResult = await this.validateSequence(payload, flags);
+        this.logPreDeploySummary(yamlConfig, validateResult, flags.json);
         const confirmed = await this.confirmDeploy(yamlConfig, flags);
         if (!confirmed)
             return;
-        const payload = await this.buildDeployPayload(yamlConfig);
         const response = await this.withApiSpinner({ json: flags.json, text: '  Deploying email sequences...' }, () => this.apiClient.post(API_ENDPOINTS.SEQUENCES_DEPLOY, payload));
         if (!response.ok) {
             this.handleApiError(response);
@@ -51,6 +46,19 @@ export default class Deploy extends BaseCommand {
         }
         this.logDeploySuccessInstructions(response.data.sdkSnippet);
     }
+    async validateSequence(payload, flags) {
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Validating sequence...' }, () => this.apiClient.post(API_ENDPOINTS.SEQUENCES_VALIDATE, payload));
+        if (!response.ok) {
+            if (response.data.error === 'senderDomainNotFound') {
+                this.error(`Sending domain not registered. Run: ${chalk.cyan('mailmodo domain')}`);
+            }
+            if (response.data.error === 'senderDomainNotVerified') {
+                this.error(`Sending domain not verified. Run: ${chalk.cyan('mailmodo domain --verify')}`);
+            }
+            this.handleApiError(response);
+        }
+        return response.data;
+    }
     async buildDeployPayload(yamlConfig) {
         const emailsWithHtml = await Promise.all(yamlConfig.emails.map(async (email) => {
             const html = (await loadTemplate(`${email.id}.html`)) || '';
@@ -64,7 +72,7 @@ export default class Deploy extends BaseCommand {
     mapEmailToPayload(email) {
         return {
             condition: email.condition || null,
-            ctaText: '',
+            ctaText: email.ctaText || '',
             delay: typeof email.delay === 'string'
                 ? Number.parseInt(email.delay, 10) || 0
                 : email.delay,
@@ -86,11 +94,11 @@ export default class Deploy extends BaseCommand {
     buildProductSection(project) {
         return {
             businessType: project?.type || '',
-            description: '',
-            pricingModel: '',
+            description: project?.description || '',
+            pricingModel: project?.pricingModel || '',
             productName: project?.name || '',
-            saasModel: '',
-            targetUser: '',
+            saasModel: project?.saasModel || '',
+            targetUser: project?.targetUser || '',
             url: project?.url || '',
         };
     }
@@ -110,7 +118,7 @@ export default class Deploy extends BaseCommand {
             monthlyCap: project?.monthlyCap ?? DEFAULT_MONTHLY_CAP,
             product: this.buildProductSection(project),
             senderDetails: this.buildSenderSection(project),
-            webhookUrl: project?.webhookUrl || '',
+            ...(project?.webhookUrl ? { webhookUrl: project.webhookUrl } : {}),
         };
     }
     async confirmDeploy(yamlConfig, flags) {
@@ -150,25 +158,41 @@ export default class Deploy extends BaseCommand {
         }
         return this.runDomainSetup(yamlConfig, flags);
     }
-    /**
-     * Lists emails about to be deployed (skipped when `--json` is set).
-     *
-     * @param yamlConfig - Loaded project YAML.
-     * @param jsonOutput - When true, skip human-readable output.
-     */
-    logPreDeploySummary(yamlConfig, jsonOutput) {
+    logPreDeploySummary(yamlConfig, validateResult, jsonOutput) {
         if (jsonOutput)
             return;
         this.log(`\n  ${chalk.green('✓')} Domain: ${yamlConfig.project?.domain || 'verified'}\n`);
-        this.log(`  Deploying:`);
-        for (const email of yamlConfig.emails) {
-            this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
+        if (!validateResult.existingDeployment || !validateResult.diff) {
+            this.log(`  Deploying:`);
+            for (const email of yamlConfig.emails) {
+                this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
+            }
+        }
+        else {
+            this.logDiff(validateResult.diff);
         }
         this.log('');
     }
-    /**
-     * Prints the post-deploy success message and SDK install snippet for interactive runs.
-     */
+    logDiff(diff) {
+        if (!diff.hasChanges) {
+            this.log(`  No changes from last deployment.`);
+            return;
+        }
+        this.log(`  Changes vs. last deployment:`);
+        for (const email of diff.added) {
+            this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger || ''}`);
+        }
+        for (const email of diff.removed) {
+            this.log(`  ${chalk.red('-')} ${email.id.padEnd(24)} ${email.trigger || ''}`);
+        }
+        for (const email of diff.modified) {
+            const fields = email.changedFields?.join(', ') || '';
+            this.log(`  ${chalk.yellow('~')} ${email.id.padEnd(24)} ${fields}`);
+        }
+        if (diff.unchanged.length > 0) {
+            this.log(`  ${chalk.dim(`∙ ${diff.unchanged.length} unchanged`)}`);
+        }
+    }
     logDeploySuccessInstructions(sdkSnippet) {
         this.log(`  ${chalk.green('Deployed.')} Emails are live.\n`);
         this.log(`  ${'─'.repeat(53)}`);
@@ -185,13 +209,6 @@ export default class Deploy extends BaseCommand {
         this.log(`  Full SDK docs: ${chalk.cyan('mailmodo.com/docs/sdk')}\n`);
         this.log(`  ${'─'.repeat(53)}\n`);
     }
-    /**
-     * Interactive domain setup flow. Collects domain, sender email, and business
-     * address from the user, then calls the API to get DNS records to configure.
-     * Polls for verification when the user indicates they've added the records.
-     *
-     * @returns {Promise<boolean>} true if domain was verified, false if skipped.
-     */
     async runDomainSetup(yamlConfig, flags) {
         const { address, domain, senderEmail } = await this.collectDomainInputs(yamlConfig, flags);
         const domainResponse = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, {
@@ -260,12 +277,6 @@ export default class Deploy extends BaseCommand {
         this.log(`  DNS changes take 5–30 minutes to propagate.`);
         this.log(`  Full guide: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
     }
-    /**
-     * Calls the domain verification API endpoint and reports pass/fail
-     * status for each DNS record (DKIM, DMARC, Return-Path).
-     *
-     * @returns {Promise<boolean>} true if all records pass.
-     */
     async verifyDomain(jsonOutput, domain) {
         const verify = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
             domain,

package/dist/commands/domain/index.js

@@ -179,7 +179,7 @@ export default class Domain extends BaseCommand {
         this.log(`  Spam rate:   ${data.spamRate ?? 'N/A'}%\n`);
     }
     recordLabel(index) {
-        const labels = ['SPF', 'DKIM', 'DMARC'];
+        const labels = ['DKIM', 'DMARC', 'Return Path'];
         return labels[index] || `Record ${index + 1}`;
     }
 }

package/dist/commands/edit/index.js

@@ -194,6 +194,8 @@ export default class Edit extends BaseCommand {
             email.subject = updated.subject;
         if (updated.previewText)
             email.previewText = updated.previewText;
+        if (updated.ctaText)
+            email.ctaText = updated.ctaText;
         const updatedYaml = {
             ...yamlConfig,
             emails: [...yamlConfig.emails],

package/dist/commands/init/index.js

@@ -128,6 +128,7 @@ export default class Init extends BaseCommand {
                 ...(generated?.previewText
                     ? { previewText: generated.previewText }
                     : {}),
+                ...(generated?.ctaText ? { ctaText: generated.ctaText } : {}),
                 goal: rec.goal,
             };
         });
@@ -135,14 +136,18 @@ export default class Init extends BaseCommand {
             emails: emailConfigs,
             project: {
                 brandColor: analysisPayload.brand?.color || DEFAULT_BRAND_COLOR,
+                description: analysisPayload.description,
                 emailStyle: 'branded',
                 fromEmail: '',
                 fromName: `Team ${analysisPayload.productName}`,
                 logoUrl: analysisPayload.brand?.logoUrl || '',
                 monthlyCap: DEFAULT_MONTHLY_CAP,
                 name: analysisPayload.productName,
+                pricingModel: analysisPayload.pricingModel,
                 replyTo: '',
-                type: analysisPayload.pricingModel,
+                saasModel: analysisPayload.saasModel,
+                targetUser: analysisPayload.targetUser,
+                type: analysisPayload.businessType,
                 url: productUrl,
                 webhookUrl: '',
             },

package/dist/commands/settings/index.js

@@ -249,7 +249,7 @@ export default class Settings extends BaseCommand {
         this.log(`  Help: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
     }
     recordLabel(index) {
-        const labels = ['SPF', 'DKIM', 'DMARC'];
+        const labels = ['DKIM', 'DMARC', 'Return Path'];
         return labels[index] || `Record ${index + 1}`;
     }
     /**

package/dist/lib/yaml-config.d.ts

@@ -1,5 +1,6 @@
 export interface EmailConfig {
     condition?: string;
+    ctaText?: string;
     delay: number | string;
     goal?: string;
     id: string;
@@ -12,6 +13,7 @@ export interface EmailConfig {
 export interface ProjectConfig {
     address?: string;
     brandColor?: string;
+    description?: string;
     domain?: string;
     emailStyle?: 'branded' | 'plain';
     fromEmail?: string;
@@ -20,7 +22,10 @@ export interface ProjectConfig {
     logoUrl?: string;
     monthlyCap?: number;
     name?: string;
+    pricingModel?: string;
     replyTo?: string;
+    saasModel?: string;
+    targetUser?: string;
     type?: string;
     url?: string;
     webhookUrl?: string;

package/oclif.manifest.json

@@ -153,14 +153,19 @@
         "index.js"
       ]
     },
-    "domain": {
+    "edit": {
       "aliases": [],
-      "args": {},
-      "description": "Set up and verify your sending domain",
+      "args": {
+        "id": {
+          "description": "Email template ID to edit",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Edit an email using AI-assisted natural language changes",
       "examples": [
-        "<%= config.bin %> domain",
-        "<%= config.bin %> domain --verify",
-        "<%= config.bin %> domain --status"
+        "<%= config.bin %> edit welcome",
+        "<%= config.bin %> edit welcome --change \"make subject more urgent\" --yes"
       ],
       "flags": {
         "json": {
@@ -176,22 +181,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "status": {
-          "description": "Show domain health status",
-          "name": "status",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verify": {
-          "description": "Verify DNS records",
-          "name": "verify",
-          "allowNo": false,
-          "type": "boolean"
+        "change": {
+          "description": "Natural language description of the change",
+          "name": "change",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "domain",
+      "id": "edit",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -201,23 +201,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "domain",
+        "edit",
         "index.js"
       ]
     },
-    "edit": {
+    "emails": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email template ID to edit",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Edit an email using AI-assisted natural language changes",
+      "args": {},
+      "description": "List and view configured email sequences",
       "examples": [
-        "<%= config.bin %> edit welcome",
-        "<%= config.bin %> edit welcome --change \"make subject more urgent\" --yes"
+        "<%= config.bin %> emails",
+        "<%= config.bin %> emails --json"
       ],
       "flags": {
         "json": {
@@ -232,18 +226,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "change": {
-          "description": "Natural language description of the change",
-          "name": "change",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "edit",
+      "id": "emails",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -253,17 +240,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "edit",
+        "emails",
         "index.js"
       ]
     },
-    "emails": {
+    "domain": {
       "aliases": [],
       "args": {},
-      "description": "List and view configured email sequences",
+      "description": "Set up and verify your sending domain",
       "examples": [
-        "<%= config.bin %> emails",
-        "<%= config.bin %> emails --json"
+        "<%= config.bin %> domain",
+        "<%= config.bin %> domain --verify",
+        "<%= config.bin %> domain --status"
       ],
       "flags": {
         "json": {
@@ -278,11 +266,23 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "status": {
+          "description": "Show domain health status",
+          "name": "status",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verify": {
+          "description": "Verify DNS records",
+          "name": "verify",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "emails",
+      "id": "domain",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -292,7 +292,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "domain",
         "index.js"
       ]
     },
@@ -634,5 +634,5 @@
       ]
     }
   },
-  "version": "0.0.22"
+  "version": "0.0.23-beta.pr25.40"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.22",
+  "version": "0.0.23-beta.pr25.40",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"