@mailmodo/cli 0.0.52 → 0.0.54-beta.pr56.86

package/dist/lib/deploy/payload.js

@@ -0,0 +1,95 @@
+import { loadTemplate, } from '../yaml-config.js';
+import { DEFAULT_BRAND_COLOR } from '../constants.js';
+export function mapEmailToPayload(email) {
+    return {
+        condition: email.condition || null,
+        ctaText: email.ctaText || '',
+        delay: email.delay,
+        goal: email.goal || '',
+        id: email.id,
+        isReminder: false,
+        previewText: email.previewText || '',
+        priority: 'medium',
+        subject: email.subject,
+        trigger: email.trigger,
+    };
+}
+function buildBrandSection(project) {
+    return {
+        colors: [project?.brandColor || DEFAULT_BRAND_COLOR],
+        logoUrl: project?.logoUrl || '',
+    };
+}
+function buildProductSection(project) {
+    return {
+        businessType: project?.type || '',
+        description: project?.description || '',
+        pricingModel: project?.pricingModel || '',
+        productName: project?.name || '',
+        saasModel: project?.saasModel || '',
+        targetUser: project?.targetUser || '',
+        url: project?.url || '',
+    };
+}
+function buildSenderSection(project) {
+    return {
+        address: project?.address || '',
+        domain: project?.domain || '',
+        fromEmail: project?.fromEmail || '',
+        fromName: project?.fromName || '',
+        replyTo: project?.replyTo || project?.fromEmail || '',
+    };
+}
+export function buildProjectPayload(project, monthlyCap) {
+    return {
+        brand: buildBrandSection(project),
+        emailStyle: project?.emailStyle || 'branded',
+        ...(monthlyCap === undefined ? {} : { monthlyCap }),
+        product: buildProductSection(project),
+        senderDetails: buildSenderSection(project),
+        ...(project?.webhookUrl ? { webhookUrl: project.webhookUrl } : {}),
+    };
+}
+export function buildRegeneratePayload(yamlConfig, missingIds) {
+    const { emails, project } = yamlConfig;
+    const idSet = new Set(missingIds);
+    const targets = emails.filter((e) => idSet.has(e.id));
+    return {
+        brand: {
+            color: project.brandColor || DEFAULT_BRAND_COLOR,
+            logoUrl: project.logoUrl || '',
+        },
+        businessType: project.type || '',
+        description: project.description || '',
+        events: [...new Set(targets.map((e) => e.trigger))],
+        pricingModel: project.pricingModel || '',
+        productName: project.name || '',
+        recommendedEmails: targets.map((e) => ({
+            condition: e.condition || null,
+            delay: String(e.delay ?? '0'),
+            goal: e.goal || '',
+            id: e.id,
+            isReminder: false,
+            priority: 'medium',
+            trigger: e.trigger,
+        })),
+        saasModel: project.saasModel || '',
+        targetUser: project.targetUser || '',
+    };
+}
+export async function buildDeployPayload(ctx, yamlConfig) {
+    const [emailsWithHtml, monthlyCap] = await Promise.all([
+        Promise.all(yamlConfig.emails.map(async (email) => {
+            const html = (await loadTemplate(`${email.id}.html`)) || '';
+            const plainHtml = (await loadTemplate(`${email.id}_plain.html`)) || html;
+            return { ...mapEmailToPayload(email), html, plainHtml };
+        })),
+        yamlConfig.project.monthlyCap === undefined
+            ? ctx.getBillingCap()
+            : Promise.resolve(yamlConfig.project.monthlyCap),
+    ]);
+    return {
+        ...buildProjectPayload(yamlConfig.project, monthlyCap),
+        emails: emailsWithHtml,
+    };
+}

package/dist/lib/deploy/sequence-status.d.ts

@@ -0,0 +1,3 @@
+import type { DeployCtx, DeployFlags } from './types.js';
+export declare function pauseSequence(ctx: DeployCtx, sequenceId: string, flags: DeployFlags): Promise<void>;
+export declare function resumeSequence(ctx: DeployCtx, sequenceId: string, flags: DeployFlags): Promise<void>;

package/dist/lib/deploy/sequence-status.js

@@ -0,0 +1,56 @@
+import { confirm } from '@inquirer/prompts';
+import { API_ENDPOINTS } from '../constants.js';
+import { INFO, pauseAlready, pauseSuccess, PROMPTS, resumeAlready, resumeSuccess, } from '../messages.js';
+function sequenceStatusPath(sequenceId) {
+    return `${API_ENDPOINTS.SEQUENCES}/${encodeURIComponent(sequenceId)}/status`;
+}
+async function updateSequenceStatus(ctx, opts) {
+    const response = await ctx.spinner(opts.spinnerText, opts.flags.json, () => ctx.post(sequenceStatusPath(opts.sequenceId), {
+        status: opts.status,
+    }));
+    if (!response.ok)
+        ctx.onApiError(response);
+    return response.data;
+}
+export async function pauseSequence(ctx, sequenceId, flags) {
+    if (!flags.yes) {
+        const confirmed = await confirm({
+            default: false,
+            message: PROMPTS.PAUSE_CONFIRM,
+        });
+        if (!confirmed) {
+            ctx.log(`\n  ${INFO.PAUSE_CANCELLED}\n`);
+            return;
+        }
+    }
+    const data = await updateSequenceStatus(ctx, {
+        flags,
+        sequenceId,
+        spinnerText: '  Pausing sequence...',
+        status: 'paused',
+    });
+    if (flags.json) {
+        ctx.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const msg = data.alreadyInStatus
+        ? pauseAlready(data.sequenceId || sequenceId)
+        : pauseSuccess(data.sequenceId || sequenceId);
+    ctx.log(`\n  ${msg}\n`);
+}
+export async function resumeSequence(ctx, sequenceId, flags) {
+    const data = await updateSequenceStatus(ctx, {
+        flags,
+        sequenceId,
+        spinnerText: '  Resuming sequence...',
+        status: 'active',
+    });
+    if (flags.json) {
+        ctx.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const msg = data.alreadyInStatus
+        ? resumeAlready(data.sequenceId || sequenceId)
+        : resumeSuccess(data.sequenceId || sequenceId);
+    ctx.log(`\n  ${msg}\n`);
+}

package/dist/lib/deploy/types.d.ts

@@ -0,0 +1,86 @@
+import type { ApiResponse } from '../api-client.js';
+import type { MailmodoYaml } from '../yaml-config.js';
+export interface EmailDiffEntry {
+    changedFields?: string[];
+    id: string;
+    subject?: string;
+    trigger?: string;
+}
+export interface ValidateResponse {
+    diff: null | {
+        added: EmailDiffEntry[];
+        hasChanges: boolean;
+        modified: EmailDiffEntry[];
+        removed: EmailDiffEntry[];
+        unchanged: EmailDiffEntry[];
+    };
+    error: null | string;
+    existingDeployment: boolean;
+    isValid: boolean;
+}
+export interface SdkSnippet {
+    examples: {
+        identify: string;
+        track: string;
+    };
+    identifyCalls: string[];
+    install: string;
+    trackCalls: string[];
+}
+export interface DeployResponse {
+    deployed: boolean;
+    diff: {
+        added: EmailDiffEntry[];
+        hasChanges: boolean;
+        modified: EmailDiffEntry[];
+        removed: EmailDiffEntry[];
+        unchanged: EmailDiffEntry[];
+    };
+    emailsLive: number;
+    sdkSnippet: SdkSnippet;
+    sequenceId: string;
+}
+export type DeployFlags = {
+    json: boolean;
+    yes: boolean;
+};
+export type DeployCtx = {
+    collectDomainInputs(yaml: MailmodoYaml, skip: boolean): Promise<{
+        address: string;
+        domain: string;
+        fromEmail: string;
+        fromName: string;
+        replyTo: string;
+    }>;
+    error(msg: string): never;
+    exit(code?: number): never;
+    get<T = Record<string, unknown>>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
+    getBillingCap(): Promise<number | undefined>;
+    log(msg?: string): void;
+    onApiError(resp: {
+        error?: string;
+        status: number;
+    }): never;
+    post<T = Record<string, unknown>>(path: string, body?: Record<string, unknown> | unknown): Promise<ApiResponse<T>>;
+    registerDomainAndSave(yaml: MailmodoYaml, inputs: {
+        address: string;
+        domain: string;
+        fromEmail: string;
+        fromName?: string;
+        replyTo?: string;
+    }, json: boolean): Promise<{
+        dnsGuideUrl?: string;
+        dnsRecords: Array<{
+            host: string;
+            type: string;
+            value: string;
+        }>;
+    }>;
+    showDnsRecords(records: Array<{
+        host: string;
+        type: string;
+        value: string;
+    }>, guideUrl: string | undefined, json: boolean): void;
+    spinner<T>(text: string, json: boolean, work: () => Promise<T>): Promise<T>;
+    syncYaml(): Promise<void>;
+};

package/dist/lib/deploy/types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/messages.d.ts

@@ -13,6 +13,13 @@ export declare const PROMPTS: {
     readonly REPLY_TO: "Reply-to address (optional, press Enter to use sender email):";
     readonly SENDER_EMAIL: "Sender email address:";
 };
+export declare const MISSING_TEMPLATES: {
+    readonly ABORT_HINT: `Restore the missing files from version control, then run ${string} again.`;
+    readonly HEADER: `Some email templates are missing from ${string}:`;
+    readonly REGENERATE_NOTE: string;
+    readonly REVIEW_HINT: `Templates regenerated. Review them with ${string}, then run ${string} again.`;
+    readonly YES_ERROR: `Missing templates cannot be resolved with ${string}. Run ${string} without ${string} to regenerate via AI or restore from version control.`;
+};
 export declare const ERRORS: {
     readonly DOMAIN_NOT_CONFIGURED: `No domain configured. Run ${string} to set up your sending domain.`;
     readonly DOMAIN_NOT_REGISTERED: `Sending domain not registered. Run: ${string}`;
@@ -40,6 +47,8 @@ export declare const INFO: {
     readonly FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${string} to add a payment method, then set a cap.`;
     readonly PAUSE_CANCELLED: "Pause cancelled. Sequence is still live.";
     readonly SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${string}.`;
+    readonly YAML_RESTORED_FROM_SERVER: string;
+    readonly YAML_RESTORED_ON_LOGIN: `  mailmodo.yaml restored from server. Run ${string} to re-deploy your sequences.`;
 };
 export declare function pauseSuccess(sequenceId: string): string;
 export declare function pauseAlready(sequenceId: string): string;

package/dist/lib/messages.js

@@ -14,6 +14,13 @@ export const PROMPTS = {
     REPLY_TO: 'Reply-to address (optional, press Enter to use sender email):',
     SENDER_EMAIL: 'Sender email address:',
 };
+export const MISSING_TEMPLATES = {
+    ABORT_HINT: `Restore the missing files from version control, then run ${chalk.cyan('mailmodo deploy')} again.`,
+    HEADER: `Some email templates are missing from ${chalk.cyan('./mailmodo/')}:`,
+    REGENERATE_NOTE: chalk.yellow('  Note: any previous manual edits to these files will be replaced with a new AI draft.'),
+    REVIEW_HINT: `Templates regenerated. Review them with ${chalk.cyan('mailmodo preview')}, then run ${chalk.cyan('mailmodo deploy')} again.`,
+    YES_ERROR: `Missing templates cannot be resolved with ${chalk.cyan('--yes')}. Run ${chalk.cyan('mailmodo deploy')} without ${chalk.cyan('--yes')} to regenerate via AI or restore from version control.`,
+};
 export const ERRORS = {
     DOMAIN_NOT_CONFIGURED: `No domain configured. Run ${chalk.cyan('mailmodo domain')} to set up your sending domain.`,
     DOMAIN_NOT_REGISTERED: `Sending domain not registered. Run: ${chalk.cyan('mailmodo domain')}`,
@@ -40,6 +47,8 @@ export const INFO = {
     FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${chalk.cyan("'mailmodo billing --checkout'")} to add a payment method, then set a cap.`,
     PAUSE_CANCELLED: 'Pause cancelled. Sequence is still live.',
     SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${chalk.yellow('NOT deployed')}.`,
+    YAML_RESTORED_FROM_SERVER: chalk.dim('  mailmodo.yaml not found locally — restored from server.'),
+    YAML_RESTORED_ON_LOGIN: `  mailmodo.yaml restored from server. Run ${chalk.cyan("'mailmodo deploy'")} to re-deploy your sequences.`,
 };
 export function pauseSuccess(sequenceId) {
     return `Sequence ${chalk.cyan(sequenceId)} paused. Run ${chalk.cyan(`mailmodo deploy --resume ${sequenceId}`)} to resume.`;

package/dist/lib/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts a user-facing snake_case YAML setting key to its
+ * corresponding camelCase TypeScript property name.
+ *
+ * @param {string} key - A snake_case setting key (e.g., "brand_color").
+ * @returns {string} The camelCase property name (e.g., "brandColor").
+ */
+export declare function settingKeyToProp(key: string): string;
+export declare function generateTriggerPrefix(productName: string): string;
+export declare function normalizeTrigger(trigger: string, productName: string): string;
+export declare function isValidUrl(value: string): boolean;

package/dist/lib/utils.js

@@ -0,0 +1,40 @@
+/**
+ * Converts a user-facing snake_case YAML setting key to its
+ * corresponding camelCase TypeScript property name.
+ *
+ * @param {string} key - A snake_case setting key (e.g., "brand_color").
+ * @returns {string} The camelCase property name (e.g., "brandColor").
+ */
+export function settingKeyToProp(key) {
+    return key.replaceAll(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function toCamelCaseAlnum(input) {
+    const parts = input
+        .trim()
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean);
+    if (parts.length === 0)
+        return '';
+    return (parts[0].toLowerCase() +
+        parts
+            .slice(1)
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase())
+            .join(''));
+}
+export function generateTriggerPrefix(productName) {
+    return `${toCamelCaseAlnum(productName)}$`;
+}
+export function normalizeTrigger(trigger, productName) {
+    const prefix = generateTriggerPrefix(productName);
+    const dollarIdx = trigger.indexOf('$');
+    const eventName = dollarIdx === -1 ? trigger : trigger.slice(dollarIdx + 1);
+    return prefix + eventName;
+}
+export function isValidUrl(value) {
+    try {
+        return Boolean(new URL(value));
+    }
+    catch {
+        return false;
+    }
+}

package/oclif.manifest.json

@@ -631,6 +631,53 @@
         "index.js"
       ]
     },
+    "sdk": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the SDK track() / identify() reference for deployed sequences",
+      "examples": [
+        "<%= config.bin %> sdk",
+        "<%= config.bin %> sdk --sequence-id a1b2c3d4",
+        "<%= config.bin %> sdk --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sequence-id": {
+          "description": "Limit output to a single active sequence by ID (default: all active sequences)",
+          "name": "sequence-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sdk",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sdk",
+        "index.js"
+      ]
+    },
     "settings": {
       "aliases": [],
       "args": {},
@@ -718,5 +765,5 @@
       ]
     }
   },
-  "version": "0.0.52"
+  "version": "0.0.54-beta.pr56.86"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.52",
+  "version": "0.0.54-beta.pr56.86",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"