@mailmodo/cli 0.0.29 → 0.0.30-beta.pr32.51

package/dist/commands/deploy/index.js

@@ -1,7 +1,7 @@
 import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, DNS_GUIDE_URL, } from '../../lib/constants.js';
+import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, } from '../../lib/constants.js';
 import { loadTemplate, saveYaml, } from '../../lib/yaml-config.js';
 export default class Deploy extends BaseCommand {
     static description = 'Deploy email sequences and verify sending domain';
@@ -62,7 +62,8 @@ export default class Deploy extends BaseCommand {
     async buildDeployPayload(yamlConfig) {
         const emailsWithHtml = await Promise.all(yamlConfig.emails.map(async (email) => {
             const html = (await loadTemplate(`${email.id}.html`)) || '';
-            return { ...this.mapEmailToPayload(email), html, plainHtml: html };
+            const plainHtml = (await loadTemplate(`${email.id}_plain.html`)) || html;
+            return { ...this.mapEmailToPayload(email), html, plainHtml };
         }));
         return {
             ...this.buildProjectPayload(yamlConfig.project),
@@ -232,7 +233,7 @@ export default class Deploy extends BaseCommand {
         yamlConfig.project.fromEmail = senderEmail;
         yamlConfig.project.address = address;
         await saveYaml(yamlConfig);
-        this.showDnsRecords(domainResponse.data?.dnsRecords || [], flags.json);
+        this.showDnsRecords(domainResponse.data?.dnsRecords || [], flags.json, domainResponse.data?.dnsGuideUrl);
         if (flags.yes) {
             return this.verifyDomain(flags.json, domain);
         }
@@ -273,7 +274,7 @@ export default class Deploy extends BaseCommand {
         });
         return { address, domain, senderEmail };
     }
-    showDnsRecords(dnsRecords, jsonOutput) {
+    showDnsRecords(dnsRecords, jsonOutput, dnsGuideUrl) {
         if (jsonOutput)
             return;
         this.log(`\n  Add these ${dnsRecords.length} DNS records to your domain provider:\n`);
@@ -284,7 +285,8 @@ export default class Deploy extends BaseCommand {
             this.log(`  Value:  ${record.value}\n`);
         }
         this.log(`  DNS changes take 5–30 minutes to propagate.`);
-        this.log(`  Full guide: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
+        if (dnsGuideUrl)
+            this.log(`  Full guide: ${chalk.cyan(dnsGuideUrl)}\n`);
     }
     async verifyDomain(jsonOutput, domain) {
         const verify = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
@@ -293,7 +295,7 @@ export default class Deploy extends BaseCommand {
         if (!verify.ok) {
             this.handleApiError(verify);
         }
-        const { dkim, dmarc, domainStatus, returnPath } = verify.data;
+        const { dkim, dmarc, dnsGuideUrl, domainStatus, returnPath } = verify.data;
         const allPassed = domainStatus === 'VERIFIED';
         if (!jsonOutput) {
             this.log(`  DKIM         ${dkim ? chalk.green('✓') : chalk.red('✗')}`);
@@ -304,7 +306,8 @@ export default class Deploy extends BaseCommand {
             }
             else {
                 this.log(`\n  ${chalk.yellow('Some records failed.')} Fix them and run ${chalk.cyan('mailmodo domain --verify')}.`);
-                this.log(`  Help: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
+                if (dnsGuideUrl)
+                    this.log(`  Help: ${chalk.cyan(dnsGuideUrl)}\n`);
             }
         }
         return allPassed;

package/dist/commands/domain/index.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DNS_GUIDE_URL } from '../../lib/constants.js';
+import { API_ENDPOINTS } from '../../lib/constants.js';
 import { saveConfig } from '../../lib/config.js';
 import { saveYaml } from '../../lib/yaml-config.js';
 export default class Domain extends BaseCommand {
@@ -69,7 +69,7 @@ export default class Domain extends BaseCommand {
         await saveYaml(yamlConfig);
         await saveConfig({ ...config, domain });
         const records = response.data?.dnsRecords || [];
-        const guideUrl = response.data?.dnsGuideUrl ?? DNS_GUIDE_URL;
+        const guideUrl = response.data?.dnsGuideUrl;
         if (flags.json) {
             this.log(JSON.stringify({ dnsRecords: records, domain }, null, 2));
             return;
@@ -82,7 +82,8 @@ export default class Domain extends BaseCommand {
             this.log(`  Value:  ${record.value}\n`);
         }
         this.log(`  DNS changes take 5–30 minutes to propagate.`);
-        this.log(`  Full guide: ${chalk.cyan(guideUrl)}\n`);
+        if (guideUrl)
+            this.log(`  Full guide: ${chalk.cyan(guideUrl)}\n`);
         if (!flags.yes) {
             const action = await input({
                 default: '',
@@ -107,7 +108,7 @@ export default class Domain extends BaseCommand {
         if (!response.ok) {
             this.handleApiError(response);
         }
-        const { dkim, dmarc, returnPath, domainStatus } = response.data;
+        const { dkim, dmarc, dnsGuideUrl, returnPath, domainStatus } = response.data;
         if (jsonOutput) {
             this.log(JSON.stringify({ dkim, dmarc, returnPath, domainStatus }, null, 2));
             return;
@@ -133,7 +134,8 @@ export default class Domain extends BaseCommand {
                 this.log(`  - Cloudflare: proxy must be OFF (grey cloud, not orange)`);
             }
             this.log(`\n  Fix the records and run ${chalk.cyan('mailmodo domain --verify')} again.`);
-            this.log(`  Help: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
+            if (dnsGuideUrl)
+                this.log(`  Help: ${chalk.cyan(dnsGuideUrl)}\n`);
         }
     }
     /**

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

@@ -10,6 +10,17 @@ export default class Edit extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    run(): Promise<void>;
+    private runEditStep;
+    private handleUserAction;
+    private callEditApi;
+    private finalizeEdit;
+    private applyEmailChanges;
+    private persistChanges;
+    private logJsonResult;
+    private handleAcceptOutput;
+    private promptEditAction;
+    private askChangeDescription;
     private showFieldDiff;
     private stripHtml;
     private truncate;
@@ -20,5 +31,4 @@ export default class Edit extends BaseCommand {
     private showUnchanged;
     private buildDiffPreview;
     private showChangeSummary;
-    run(): Promise<void>;
 }

package/dist/commands/edit/index.js

@@ -1,9 +1,9 @@
 import { Args, Flags } from '@oclif/core';
-import { confirm, input } from '@inquirer/prompts';
+import { confirm, input, select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
-import { loadTemplate, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
+import { loadTemplate, resolveTemplateFilename, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 export default class Edit extends BaseCommand {
     static args = {
         id: Args.string({
@@ -22,6 +22,152 @@ export default class Edit extends BaseCommand {
             description: 'Natural language description of the change',
         }),
     };
+    async run() {
+        const { args, flags } = await this.parse(Edit);
+        await this.ensureAuth();
+        const yamlConfig = await this.ensureYaml();
+        const emailIndex = yamlConfig.emails.findIndex((e) => e.id === args.id);
+        if (emailIndex === -1) {
+            this.error(`Email '${args.id}' not found in mailmodo.yaml.`);
+        }
+        const email = yamlConfig.emails[emailIndex];
+        const templateFilename = resolveTemplateFilename(email.id, email.style, yamlConfig.project?.emailStyle);
+        const ctx = {
+            email,
+            emailIndex,
+            templateFilename,
+            templateHtml: await loadTemplate(templateFilename),
+            yamlConfig,
+        };
+        const editFlags = {
+            json: flags.json ?? false,
+            yes: flags.yes ?? false,
+        };
+        const initialChange = flags.change ?? (await this.askChangeDescription());
+        await this.runEditStep(ctx, initialChange, editFlags);
+    }
+    async runEditStep(ctx, changeDescription, flags) {
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Applying AI edits...' }, () => this.callEditApi(changeDescription, ctx.email, ctx.templateHtml));
+        if (!response.ok) {
+            this.handleApiError(response);
+        }
+        const updated = response.data;
+        if (flags.json) {
+            this.log(JSON.stringify(this.buildDiffPreview(ctx.email, updated, ctx.templateHtml), null, 2));
+        }
+        else {
+            this.showChangeSummary(ctx.email, updated, ctx.templateHtml);
+        }
+        if (flags.yes) {
+            await this.finalizeEdit(ctx, updated, flags);
+            return;
+        }
+        await this.handleUserAction(ctx, updated, changeDescription, flags);
+    }
+    async handleUserAction(ctx, updated, changeDescription, flags) {
+        this.log('');
+        const action = await this.promptEditAction();
+        if (action === 'skip') {
+            this.log('\n  Changes discarded.\n');
+            return;
+        }
+        if (action === 'retry') {
+            const newChange = await this.askChangeDescription();
+            await this.runEditStep(ctx, newChange, flags);
+            return;
+        }
+        await this.finalizeEdit(ctx, updated, flags);
+    }
+    callEditApi(changeDescription, email, templateHtml) {
+        return this.apiClient.post(API_ENDPOINTS.EDIT, {
+            changeRequest: changeDescription,
+            currentEmail: {
+                condition: email.condition,
+                goal: email.goal,
+                html: templateHtml,
+                id: email.id,
+                previewText: email.previewText,
+                subject: email.subject,
+                trigger: email.trigger,
+            },
+        });
+    }
+    async finalizeEdit(ctx, updated, flags) {
+        const oldSubject = ctx.email.subject;
+        this.applyEmailChanges(ctx.email, updated);
+        await this.persistChanges(ctx, updated);
+        if (flags.json) {
+            this.logJsonResult(ctx.email, updated, oldSubject);
+        }
+        else if (flags.yes) {
+            this.log(`\n  Updated ${chalk.green('mailmodo.yaml')}\n`);
+        }
+        else {
+            await this.handleAcceptOutput(ctx.email);
+        }
+    }
+    applyEmailChanges(email, updated) {
+        if (updated.subject)
+            email.subject = updated.subject;
+        if (updated.previewText)
+            email.previewText = updated.previewText;
+        if (updated.ctaText)
+            email.ctaText = updated.ctaText;
+    }
+    async persistChanges(ctx, updated) {
+        const updatedYaml = {
+            ...ctx.yamlConfig,
+            emails: [...ctx.yamlConfig.emails],
+        };
+        updatedYaml.emails[ctx.emailIndex] = ctx.email;
+        await saveYaml(updatedYaml);
+        if (updated.html) {
+            await saveTemplate(ctx.templateFilename, updated.html);
+        }
+    }
+    logJsonResult(email, updated, oldSubject) {
+        this.log(JSON.stringify({
+            diff: {
+                previewText: updated.previewText && updated.previewText !== email.previewText
+                    ? { new: updated.previewText, old: email.previewText }
+                    : undefined,
+                subject: oldSubject === email.subject
+                    ? undefined
+                    : { new: email.subject, old: oldSubject },
+            },
+            email,
+            status: 'updated',
+        }, null, 2));
+    }
+    async handleAcceptOutput(email) {
+        this.log(`\n  Updated ${chalk.green('mailmodo.yaml')}`);
+        const shouldPreview = await confirm({
+            default: true,
+            message: 'Preview the change?',
+        });
+        if (shouldPreview) {
+            await this.config.runCommand('preview', [email.id]);
+        }
+        else {
+            this.log(`  Run: ${chalk.cyan(`mailmodo preview ${email.id}`)}\n`);
+        }
+    }
+    async promptEditAction() {
+        return select({
+            message: 'Accept, try again, or skip?',
+            choices: [
+                { name: 'Accept', value: 'accept' },
+                { name: 'Try again', value: 'retry' },
+                { name: 'Skip', value: 'skip' },
+            ],
+        });
+    }
+    async askChangeDescription() {
+        return input({
+            message: 'What do you want to change?',
+            validate: (value) => value?.trim() ? true : 'Please describe the change',
+        });
+    }
     showFieldDiff(label, oldVal, newVal) {
         if (!newVal || oldVal === newVal)
             return false;
@@ -139,88 +285,4 @@ export default class Edit extends BaseCommand {
         this.showSuggestedChanges(email, updated, templateHtml, changed);
         this.showUnchanged(email, templateHtml, changed);
     }
-    async run() {
-        const { args, flags } = await this.parse(Edit);
-        await this.ensureAuth();
-        const yamlConfig = await this.ensureYaml();
-        const emailIndex = yamlConfig.emails.findIndex((e) => e.id === args.id);
-        if (emailIndex === -1) {
-            this.error(`Email '${args.id}' not found in mailmodo.yaml.`);
-        }
-        const email = yamlConfig.emails[emailIndex];
-        const templateHtml = await loadTemplate(`${email.id}.html`);
-        let changeDescription = flags.change;
-        if (!changeDescription) {
-            changeDescription = await input({
-                message: 'What do you want to change?',
-                validate: (value) => value?.trim() ? true : 'Please describe the change',
-            });
-        }
-        const response = await this.withApiSpinner({ json: flags.json, text: '  Applying AI edits...' }, () => this.apiClient.post(API_ENDPOINTS.EDIT, {
-            changeRequest: changeDescription,
-            currentEmail: {
-                condition: email.condition,
-                goal: email.goal,
-                html: templateHtml,
-                id: email.id,
-                previewText: email.previewText,
-                subject: email.subject,
-                trigger: email.trigger,
-            },
-        }));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        const updated = response.data;
-        if (flags.json) {
-            this.log(JSON.stringify(this.buildDiffPreview(email, updated, templateHtml), null, 2));
-        }
-        else {
-            this.showChangeSummary(email, updated, templateHtml);
-        }
-        if (!flags.yes) {
-            const accepted = await confirm({
-                default: true,
-                message: 'Accept changes?',
-            });
-            if (!accepted) {
-                this.log('\n  Changes discarded.\n');
-                return;
-            }
-        }
-        const oldSubject = email.subject;
-        const newSubject = updated.subject || email.subject;
-        if (updated.subject)
-            email.subject = updated.subject;
-        if (updated.previewText)
-            email.previewText = updated.previewText;
-        if (updated.ctaText)
-            email.ctaText = updated.ctaText;
-        const updatedYaml = {
-            ...yamlConfig,
-            emails: [...yamlConfig.emails],
-        };
-        updatedYaml.emails[emailIndex] = email;
-        await saveYaml(updatedYaml);
-        if (updated.html) {
-            await saveTemplate(`${email.id}.html`, updated.html);
-        }
-        if (flags.json) {
-            this.log(JSON.stringify({
-                diff: {
-                    previewText: updated.previewText && updated.previewText !== email.previewText
-                        ? { new: updated.previewText, old: email.previewText }
-                        : undefined,
-                    subject: oldSubject === newSubject
-                        ? undefined
-                        : { new: newSubject, old: oldSubject },
-                },
-                email,
-                status: 'updated',
-            }, null, 2));
-            return;
-        }
-        this.log(`\n  Updated ${chalk.green('mailmodo.yaml')}`);
-        this.log(`  Preview the change: ${chalk.cyan(`mailmodo preview ${email.id}`)}\n`);
-    }
 }

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

@@ -7,4 +7,6 @@ export default class Emails extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private openTemplateInEditor;
+    private trySpawnEditor;
 }

package/dist/commands/emails/index.js

@@ -1,5 +1,8 @@
-import { input } from '@inquirer/prompts';
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
+import open from 'open';
 import { BaseCommand } from '../../lib/base-command.js';
 export default class Emails extends BaseCommand {
     static description = 'List and view configured email sequences';
@@ -61,7 +64,48 @@ export default class Emails extends BaseCommand {
                     this.log(`  ${chalk.bold('Goal:')}     ${email.goal}`);
                 }
                 this.log('');
+                const openIt = await confirm({
+                    default: true,
+                    message: 'Open template in editor?',
+                });
+                if (openIt) {
+                    await this.openTemplateInEditor(email.template);
+                }
             }
         }
     }
+    async openTemplateInEditor(template) {
+        const templatePath = join(process.cwd(), template);
+        this.log(`\n  Opening ${template}...\n`);
+        const editor = process.env.VISUAL || process.env.EDITOR;
+        if (editor) {
+            const child = spawn(editor, [templatePath], { stdio: 'inherit' });
+            await new Promise((resolve) => {
+                child.on('close', resolve);
+            });
+            return;
+        }
+        if (await this.trySpawnEditor('code', templatePath))
+            return;
+        try {
+            await open(templatePath);
+        }
+        catch {
+            this.log(`  ${chalk.dim(`Could not open editor. Open the file manually: ${templatePath}`)}`);
+        }
+    }
+    trySpawnEditor(editor, filePath) {
+        const [cmd, args] = process.platform === 'win32'
+            ? ['cmd.exe', ['/c', editor, filePath]]
+            : [editor, [filePath]];
+        return new Promise((resolve) => {
+            const child = spawn(cmd, [...args], { stdio: 'ignore' });
+            child.on('error', () => {
+                resolve(false);
+            });
+            child.on('close', (code) => {
+                resolve(code === 0);
+            });
+        });
+    }
 }

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

@@ -8,4 +8,5 @@ export default class Init extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private confirmOverwriteIfNeeded;
 }

package/dist/commands/init/index.js

@@ -1,9 +1,9 @@
 import { Flags } from '@oclif/core';
-import { editor, input, select } from '@inquirer/prompts';
+import { confirm, editor, input, select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, } from '../../lib/constants.js';
-import { saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
+import { loadYaml, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 function isValidUrl(value) {
     try {
         return Boolean(new URL(value));
@@ -42,6 +42,8 @@ export default class Init extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Init);
         await this.ensureAuth();
+        if (!(await this.confirmOverwriteIfNeeded(flags)))
+            return;
         let productUrl = flags.url;
         if (!productUrl) {
             productUrl = await input({
@@ -137,7 +139,7 @@ export default class Init extends BaseCommand {
             project: {
                 brandColor: analysisPayload.brand?.color || DEFAULT_BRAND_COLOR,
                 description: analysisPayload.description,
-                emailStyle: 'branded',
+                emailStyle: 'plain',
                 fromEmail: '',
                 fromName: `Team ${analysisPayload.productName}`,
                 logoUrl: analysisPayload.brand?.logoUrl || '',
@@ -177,4 +179,21 @@ export default class Init extends BaseCommand {
         this.log(`  Created ${chalk.green('mailmodo.yaml')} + ${chalk.green(String(emailConfigs.length))} email templates in ${chalk.green('/mailmodo')}\n`);
         this.log(`  Run ${chalk.cyan("'mailmodo emails'")} to review.\n`);
     }
+    async confirmOverwriteIfNeeded(flags) {
+        const existing = await loadYaml();
+        if (!existing)
+            return true;
+        if (flags.yes)
+            return true;
+        this.log(`\n  ${chalk.yellow('⚠')}  ${chalk.bold('mailmodo.yaml already exists.')}`);
+        this.log(`  Running init will overwrite your current project configuration and all email templates.\n`);
+        const proceed = await confirm({
+            default: false,
+            message: 'Overwrite existing configuration and templates?',
+        });
+        if (!proceed) {
+            this.log(`\n  Init cancelled. Run ${chalk.cyan('mailmodo edit')} to modify individual emails.\n`);
+        }
+        return proceed;
+    }
 }

package/dist/commands/preview/index.js

@@ -4,7 +4,7 @@ import chalk from 'chalk';
 import open from 'open';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS, PREVIEW_PORT } from '../../lib/constants.js';
-import { loadTemplate } from '../../lib/yaml-config.js';
+import { loadTemplate, resolveTemplateFilename, } from '../../lib/yaml-config.js';
 /* eslint-disable camelcase */
 const SAMPLE_DATA = Object.freeze({
     app_url: 'https://yourapp.com',
@@ -84,7 +84,7 @@ export default class Preview extends BaseCommand {
             app_url: yamlConfig.project?.url || 'https://yourapp.com', // eslint-disable-line camelcase
             product_name: yamlConfig.project?.name || 'YourApp', // eslint-disable-line camelcase
         };
-        const templateHtml = await loadTemplate(`${email.id}.html`);
+        const templateHtml = await loadTemplate(resolveTemplateFilename(email.id, email.style, yamlConfig.project?.emailStyle));
         if (flags.send) {
             const rendered = templateHtml
                 ? renderTemplate(templateHtml, sampleData)

package/dist/commands/settings/index.js

@@ -5,7 +5,7 @@ import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DNS_GUIDE_URL } from '../../lib/constants.js';
+import { API_ENDPOINTS } from '../../lib/constants.js';
 import { saveYaml } from '../../lib/yaml-config.js';
 const SETTINGS_GROUPS = Object.freeze({
     billing: ['monthly_cap'],
@@ -232,6 +232,7 @@ export default class Settings extends BaseCommand {
             this.handleApiError(response);
         }
         const records = response.data?.dnsRecords || [];
+        const dnsGuideUrl = response.data?.dnsGuideUrl;
         yamlConfig.project.domain = newDomain;
         yamlConfig.project.fromEmail = newFromEmail;
         yamlConfig.project.address = newAddress;
@@ -246,7 +247,8 @@ export default class Settings extends BaseCommand {
         }
         this.log(`  Run ${chalk.cyan("'mailmodo domain --verify'")} once records are added.`);
         this.log(`  Emails will not send until the new domain is verified.`);
-        this.log(`  Help: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
+        if (dnsGuideUrl)
+            this.log(`  Help: ${chalk.cyan(dnsGuideUrl)}\n`);
     }
     recordLabel(index) {
         const labels = ['DKIM', 'DMARC', 'Return Path'];

package/dist/lib/api-client.d.ts

@@ -12,6 +12,8 @@ export interface ApiRequestDebugInfo {
     responseSummary?: string;
 }
 export interface ApiResponse<T = Record<string, unknown>> {
+    /** Warning string from the API when the user's card is expiring or has issues. */
+    addCardWarning?: string;
     data: T;
     /** Populated for tracing; especially useful when `ok` is false. */
     debug?: ApiRequestDebugInfo;

package/dist/lib/api-client.js

@@ -14,6 +14,12 @@ import { fetchFileNoAuth, fetchFileWithBearerAuth, } from './fetch-file.js';
  * indicating the API may not be available, rather than a raw stack trace.
  */
 const RESPONSE_BODY_DEBUG_MAX = 800;
+function extractAddCardWarning(data) {
+    const raw = data;
+    return typeof raw.addCardWarning === 'string'
+        ? raw.addCardWarning
+        : undefined;
+}
 function summarizeResponseBody(data) {
     if (data === null || data === undefined)
         return undefined;
@@ -90,7 +96,13 @@ export class ApiClient {
                     status: response.status,
                 };
             }
-            return { data: data, ok: true, status: response.status };
+            const addCardWarning = extractAddCardWarning(data);
+            return {
+                ...(addCardWarning === undefined ? {} : { addCardWarning }),
+                data: data,
+                ok: true,
+                status: response.status,
+            };
         }
         catch (error) {
             const err = error;
@@ -164,7 +176,13 @@ export class ApiClient {
                     status: response.status,
                 };
             }
-            return { data: data, ok: true, status: response.status };
+            const addCardWarning = extractAddCardWarning(data);
+            return {
+                ...(addCardWarning === undefined ? {} : { addCardWarning }),
+                data: data,
+                ok: true,
+                status: response.status,
+            };
         }
         catch (error) {
             const err = error;

package/dist/lib/base-command.js

@@ -63,12 +63,12 @@ export class BaseCommand extends Command {
             color: 'cyan',
             text: options.text,
         }).start();
-        try {
-            return await work();
-        }
-        finally {
-            spinner.stop();
+        const result = await work().finally(() => spinner.stop());
+        const warning = result.addCardWarning;
+        if (typeof warning === 'string' && warning) {
+            this.warn(warning);
         }
+        return result;
     }
     /**
      * Loads and returns the mailmodo.yaml configuration from the current directory.

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

@@ -68,3 +68,4 @@ export declare function saveTemplate(filename: string, html: string, cwd?: strin
  *   or null if the file doesn't exist or can't be read.
  */
 export declare function loadTemplate(filename: string, cwd?: string): Promise<null | string>;
+export declare function resolveTemplateFilename(emailId: string, emailStyle?: 'branded' | 'plain', projectStyle?: 'branded' | 'plain'): string;

package/dist/lib/yaml-config.js

@@ -72,3 +72,7 @@ export async function loadTemplate(filename, cwd) {
         return null;
     }
 }
+export function resolveTemplateFilename(emailId, emailStyle, projectStyle) {
+    const style = emailStyle ?? projectStyle ?? 'branded';
+    return style === 'plain' ? `${emailId}_plain.html` : `${emailId}.html`;
+}

package/oclif.manifest.json

@@ -657,5 +657,5 @@
       ]
     }
   },
-  "version": "0.0.29"
+  "version": "0.0.30-beta.pr32.51"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.29",
+  "version": "0.0.30-beta.pr32.51",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"