@mailmodo/cli 0.0.54 → 0.0.55-beta.pr57.93

package/dist/lib/commands/settings/prompt.js

@@ -0,0 +1,82 @@
+import { input, select } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { FREE_TIER } from '../../base-command.js';
+import { INFO } from '../../messages.js';
+import { settingKeyToProp } from '../../utils.js';
+import { saveYaml } from '../../yaml-config.js';
+import { applyMonthlyCapChange } from './actions.js';
+import { SETUP_HINTS } from './display.js';
+import { handleDomainChange, handleLogoUpload } from './logo-domain.js';
+async function handleUnknownEditKey(ctx, yamlConfig, editKey) {
+    if (editKey === 'logo_file') {
+        await handleLogoUpload(ctx, yamlConfig);
+        return;
+    }
+    const editPropKey = settingKeyToProp(editKey);
+    const hint = SETUP_HINTS[editPropKey];
+    if (hint) {
+        ctx.log(`\n  ${editKey} is not configured yet. Run ${chalk.cyan(hint)} to set it up.\n`);
+    }
+    else {
+        ctx.log(`\n  Unknown setting: ${editKey}\n`);
+    }
+}
+async function dispatchEditKey(ctx, yamlConfig, editKey, tier) {
+    if (editKey === 'logo_file') {
+        await handleLogoUpload(ctx, yamlConfig);
+        return;
+    }
+    if (editKey === 'domain') {
+        await handleDomainChange(ctx, yamlConfig);
+        return;
+    }
+    if (editKey === 'monthly_cap') {
+        const newValue = await input({ message: 'New monthly cap (blocks):' });
+        await applyMonthlyCapChange(ctx, yamlConfig, {
+            isJson: false,
+            knownTier: tier,
+            rawValue: newValue,
+        });
+        return;
+    }
+    if (editKey === 'email_style') {
+        const style = await select({
+            choices: [
+                { name: 'plain', value: 'plain' },
+                { name: 'branded', value: 'branded' },
+            ],
+            message: 'Email style:',
+        });
+        yamlConfig.project.emailStyle = style;
+        await saveYaml(yamlConfig);
+        await ctx.syncYaml();
+        ctx.log(`\n  ${chalk.green('✓')} email_style updated to ${chalk.cyan(style)}`);
+        ctx.log(`  ${INFO.DEPLOY_TO_APPLY}\n`);
+        return;
+    }
+    const editPropKey = settingKeyToProp(editKey);
+    const newValue = await input({ message: `New value for ${editKey}:` });
+    yamlConfig.project[editPropKey] = newValue;
+    await saveYaml(yamlConfig);
+    await ctx.syncYaml();
+    ctx.log(`\n  ${chalk.green('✓')} Updated. ${INFO.DEPLOY_TO_APPLY}\n`);
+}
+export async function promptEditSetting(ctx, yamlConfig, tier) {
+    const { project } = yamlConfig;
+    const editKey = await input({
+        default: 'n',
+        message: "Edit a setting? (key or 'n'):",
+    });
+    if (editKey === 'n')
+        return;
+    if (editKey === 'monthly_cap' && tier === FREE_TIER) {
+        ctx.warnFreeTierCapBlocked(false);
+        return;
+    }
+    const editPropKey = settingKeyToProp(editKey);
+    if (!(editPropKey in project)) {
+        await handleUnknownEditKey(ctx, yamlConfig, editKey);
+        return;
+    }
+    await dispatchEditKey(ctx, yamlConfig, editKey, tier);
+}

package/dist/lib/commands/settings/types.d.ts

@@ -0,0 +1,65 @@
+import type { ApiResponse } from '../../api-client.js';
+import type { BillingCapUpdateResult } from '../../base-command.js';
+import type { MailmodoYaml } from '../../yaml-config.js';
+export type SettingsYaml = MailmodoYaml;
+export type SettingsCtx = {
+    applyBillingCap(opts: {
+        cap: number;
+        json: boolean;
+    }): Promise<BillingCapUpdateResult>;
+    collectDomainInputs(yaml: MailmodoYaml, skip: boolean): Promise<{
+        address: string;
+        domain: string;
+        fromEmail: string;
+        fromName: string;
+        replyTo: string;
+    }>;
+    ensureAuth(): Promise<void>;
+    error(msg: string): never;
+    fetchBillingStatus(): Promise<null | {
+        cap?: {
+            inBlocks: null | number;
+        };
+        tier?: string;
+    }>;
+    fetchBillingTier(): Promise<null | string>;
+    get<T>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
+    log(msg?: string): void;
+    onApiError(resp: {
+        error?: string;
+        status: number;
+    }): never;
+    postFormData<T>(path: string, formData: FormData): 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>;
+    warnFreeTierCapBlocked(json: boolean): void;
+};
+export interface LogoUploadResponse {
+    url: string;
+}
+export interface DomainStatusResponse {
+    bounceRate: number;
+    domain: string;
+    spamRate: number;
+    status: string;
+    verified: boolean;
+}

package/dist/lib/commands/settings/types.js

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

package/dist/lib/commands/status/output.d.ts

@@ -0,0 +1,2 @@
+import type { AnalyticsResponse, StatusCtx } from './types.js';
+export declare function logStatusOutput(ctx: StatusCtx, data: AnalyticsResponse): void;

package/dist/lib/commands/status/output.js

@@ -0,0 +1,49 @@
+import chalk from 'chalk';
+function logMetricRow(ctx, metric) {
+    const id = (metric.emailId || '').padEnd(30);
+    const sent = String(metric.sent ?? 0).padEnd(7);
+    const openRate = (metric.open || '0%').padEnd(7);
+    const clickRate = (metric.click || '0%').padEnd(8);
+    const convRate = metric.conv || '0%';
+    ctx.log(`  ${id}${sent}${openRate}${clickRate}${convRate}`);
+}
+function logEmailsTable(ctx, emails) {
+    ctx.log(`\n  ${chalk.bold('Last 7 days')}${''.padEnd(20)}Sent   Open   Click   Conv`);
+    ctx.log(`  ${'─'.repeat(62)}`);
+    if (emails?.length) {
+        for (const metric of emails) {
+            logMetricRow(ctx, metric);
+        }
+    }
+    else {
+        ctx.log(`  ${chalk.dim('No data yet. Deploy emails first.')}`);
+    }
+}
+function logQuota(ctx, quota) {
+    if (quota.plan === 'free') {
+        ctx.log(`  Free tier remaining:     ${chalk.cyan(String(quota.freeRemaining))} emails`);
+        return;
+    }
+    if (quota.plan === 'paid') {
+        if (quota.currentBlockEmailsRemaining !== null &&
+            quota.currentBlockEmailsRemaining !== undefined) {
+            const { blockSize } = quota;
+            const sent = blockSize - quota.currentBlockEmailsRemaining;
+            const remaining = quota.currentBlockEmailsRemaining;
+            ctx.log(`  Current paid block (${blockSize} emails) : ${chalk.cyan(`${sent} emails sent, ${remaining} emails remaining`)}`);
+        }
+        ctx.log(`  Blocks used:             ${quota.blocksUsed}`);
+    }
+}
+export function logStatusOutput(ctx, data) {
+    const { emails, monthlySent, quota } = data;
+    logEmailsTable(ctx, emails);
+    ctx.log('');
+    if (monthlySent !== null && monthlySent !== undefined) {
+        ctx.log(`  Emails sent this month:  ${chalk.bold(String(monthlySent))}`);
+    }
+    if (quota) {
+        logQuota(ctx, quota);
+    }
+    ctx.log('');
+}

package/dist/lib/commands/status/types.d.ts

@@ -0,0 +1,28 @@
+import type { ApiResponse } from '../../api-client.js';
+export interface EmailMetric {
+    click: string;
+    conv: string;
+    emailId: string;
+    open: string;
+    sent: number;
+}
+export interface AnalyticsResponse {
+    emails: EmailMetric[];
+    monthlySent: number;
+    quota: {
+        blockSize: number;
+        blocksUsed: number;
+        currentBlockEmailsRemaining: number;
+        freeRemaining: number;
+        plan: string;
+    };
+}
+export type StatusCtx = {
+    get<T = Record<string, unknown>>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
+    log(msg?: string): void;
+    onApiError(resp: {
+        error?: string;
+        status: number;
+    }): never;
+    spinner<T>(text: string, json: boolean, work: () => Promise<T>): Promise<T>;
+};

package/dist/lib/commands/status/types.js

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

package/dist/lib/constants.d.ts

@@ -9,6 +9,7 @@ export declare const API_ENDPOINTS: Readonly<{
     ANALYTICS: "/analytics";
     ANALYZE: "/analyze";
     ASSETS_LOGO: "/assets/logo";
+    ASSETS_YAML: "/assets/yaml";
     AUTH_VALIDATE: "/auth/validate";
     BILLING_CAP: "/billing/cap";
     BILLING_CHECKOUT: "/billing/checkout";

package/dist/lib/constants.js

@@ -15,6 +15,7 @@ export const API_ENDPOINTS = Object.freeze({
     ANALYTICS: '/analytics',
     ANALYZE: '/analyze',
     ASSETS_LOGO: '/assets/logo',
+    ASSETS_YAML: '/assets/yaml',
     AUTH_VALIDATE: '/auth/validate',
     BILLING_CAP: '/billing/cap',
     BILLING_CHECKOUT: '/billing/checkout',

package/dist/lib/messages.d.ts

@@ -13,6 +13,17 @@ 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 CHOICE_ABORT: "Abort (restore from version control)";
+    readonly CHOICE_REGENERATE: "Re-generate via AI";
+    readonly HEADER: `Some email templates are missing from ${string}:`;
+    readonly PROMPT_ACTION: "What would you like to do?";
+    readonly REGENERATE_NOTE: string;
+    readonly REGENERATE_SPINNER: "Regenerating email templates...";
+    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 +51,17 @@ 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 const DEPLOY: {
+    readonly CHANGES_HEADER: "Changes vs. last deployment:";
+    readonly DEPLOYING_HEADER: "Deploying:";
+    readonly NO_CHANGES: "No changes from last deployment.";
+    readonly SDK_DOCS_HINT: `Full SDK docs: ${string}`;
+    readonly SDK_EXAMPLE_COMMENT: string;
+    readonly SDK_ONBOARDING_HEADER: string;
+    readonly SUCCESS: `${string} Emails are live.`;
 };
 export declare function pauseSuccess(sequenceId: string): string;
 export declare function pauseAlready(sequenceId: string): string;

package/dist/lib/messages.js

@@ -14,6 +14,17 @@ 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.`,
+    CHOICE_ABORT: 'Abort (restore from version control)',
+    CHOICE_REGENERATE: 'Re-generate via AI',
+    HEADER: `Some email templates are missing from ${chalk.cyan('./mailmodo/')}:`,
+    PROMPT_ACTION: 'What would you like to do?',
+    REGENERATE_NOTE: chalk.yellow('  Note: any previous manual edits to these files will be replaced with a new AI draft.'),
+    REGENERATE_SPINNER: 'Regenerating email templates...',
+    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 +51,17 @@ 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 const DEPLOY = {
+    CHANGES_HEADER: 'Changes vs. last deployment:',
+    DEPLOYING_HEADER: 'Deploying:',
+    NO_CHANGES: 'No changes from last deployment.',
+    SDK_DOCS_HINT: `Full SDK docs: ${chalk.cyan('mailmodo.com/docs/sdk')}`,
+    SDK_EXAMPLE_COMMENT: chalk.dim('// Example usage:'),
+    SDK_ONBOARDING_HEADER: chalk.bold('ADD THIS TO YOUR APP (one-time only):'),
+    SUCCESS: `${chalk.green('Deployed.')} Emails are live.`,
 };
 export function pauseSuccess(sequenceId) {
     return `Sequence ${chalk.cyan(sequenceId)} paused. Run ${chalk.cyan(`mailmodo deploy --resume ${sequenceId}`)} to resume.`;

package/dist/lib/templates/missing-templates.d.ts

@@ -0,0 +1,5 @@
+import { type MailmodoYaml } from '../yaml-config.js';
+import type { DeployFlags } from '../commands/deploy/types.js';
+import type { RegenCtx } from './types.js';
+export declare function getMissingTemplateIds(yamlConfig: MailmodoYaml): string[];
+export declare function handleMissingTemplates(ctx: RegenCtx, yamlConfig: MailmodoYaml, missingIds: string[], flags: DeployFlags): Promise<boolean>;

package/dist/lib/templates/missing-templates.js

@@ -0,0 +1,61 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { select } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { API_ENDPOINTS, TEMPLATES_DIR } from '../constants.js';
+import { MISSING_TEMPLATES } from '../messages.js';
+import { getTemplateFilename, saveTemplate, } from '../yaml-config.js';
+import { buildRegeneratePayload } from '../commands/deploy/payload.js';
+export function getMissingTemplateIds(yamlConfig) {
+    return yamlConfig.emails
+        .filter((e) => !existsSync(join(process.cwd(), TEMPLATES_DIR, getTemplateFilename(e.id, e.style, yamlConfig.project?.emailStyle))))
+        .map((e) => e.id);
+}
+async function regenerateMissingTemplates(ctx, yamlConfig, missingIds, flags) {
+    const response = await ctx.spinner(`  ${MISSING_TEMPLATES.REGENERATE_SPINNER}`, flags.json, () => ctx.post(API_ENDPOINTS.GENERATE, buildRegeneratePayload(yamlConfig, missingIds)));
+    if (!response.ok)
+        ctx.onApiError(response);
+    const saves = [];
+    for (const email of response.data?.emails ?? []) {
+        if (!/^[\w-]+$/.test(email.id))
+            continue;
+        if (email.html)
+            saves.push(saveTemplate(`${email.id}.html`, email.html));
+        if (email.plainHtml)
+            saves.push(saveTemplate(`${email.id}_plain.html`, email.plainHtml));
+    }
+    await Promise.all(saves);
+    await ctx.syncYaml();
+}
+export async function handleMissingTemplates(ctx, yamlConfig, missingIds, flags) {
+    if (flags.json) {
+        ctx.log(JSON.stringify({
+            error: 'missing_templates',
+            message: MISSING_TEMPLATES.YES_ERROR,
+            missingTemplates: missingIds.map((id) => `${id}.html`),
+        }, null, 2));
+        ctx.exit(1);
+    }
+    if (flags.yes)
+        ctx.error(MISSING_TEMPLATES.YES_ERROR);
+    ctx.log(`\n  ${MISSING_TEMPLATES.HEADER}`);
+    for (const id of missingIds)
+        ctx.log(`  ${chalk.red('✗')} mailmodo/${id}.html`);
+    ctx.log(`\n  ${MISSING_TEMPLATES.REGENERATE_NOTE}\n`);
+    const action = await select({
+        choices: [
+            {
+                name: MISSING_TEMPLATES.CHOICE_REGENERATE,
+                value: 'regenerate',
+            },
+            { name: MISSING_TEMPLATES.CHOICE_ABORT, value: 'abort' },
+        ],
+        message: MISSING_TEMPLATES.PROMPT_ACTION,
+    });
+    if (action === 'abort') {
+        ctx.log(`\n  ${MISSING_TEMPLATES.ABORT_HINT}\n`);
+        return false;
+    }
+    await regenerateMissingTemplates(ctx, yamlConfig, missingIds, flags);
+    return true;
+}

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

@@ -0,0 +1,13 @@
+import type { ApiResponse } from '../api-client.js';
+export type RegenCtx = {
+    error(msg: string): never;
+    exit(code?: number): never;
+    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>>;
+    spinner<T>(text: string, json: boolean, work: () => Promise<T>): Promise<T>;
+    syncYaml(): Promise<void>;
+};

package/dist/lib/templates/types.js

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

package/oclif.manifest.json

@@ -198,6 +198,45 @@
         "index.js"
       ]
     },
+    "deployments": {
+      "aliases": [],
+      "args": {},
+      "description": "List every deployed sequence on this account, with the IDs needed for deploy --pause / --resume",
+      "examples": [
+        "<%= config.bin %> deployments",
+        "<%= config.bin %> deployments --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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deployments",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deployments",
+        "index.js"
+      ]
+    },
     "domain": {
       "aliases": [],
       "args": {},
@@ -464,45 +503,6 @@
         "index.js"
       ]
     },
-    "deployments": {
-      "aliases": [],
-      "args": {},
-      "description": "List every deployed sequence on this account, with the IDs needed for deploy --pause / --resume",
-      "examples": [
-        "<%= config.bin %> deployments",
-        "<%= config.bin %> deployments --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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "deployments",
-      "pluginAlias": "@mailmodo/cli",
-      "pluginName": "@mailmodo/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "deployments",
-        "index.js"
-      ]
-    },
     "logs": {
       "aliases": [],
       "args": {},
@@ -765,5 +765,5 @@
       ]
     }
   },
-  "version": "0.0.54"
+  "version": "0.0.55-beta.pr57.93"
 }

package/package.json

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