@mailmodo/cli 0.0.54-beta.pr56.91 → 0.0.55-beta.pr57.92

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/templates/missing-templates.d.ts

@@ -1,5 +1,5 @@
 import { type MailmodoYaml } from '../yaml-config.js';
-import type { DeployFlags } from '../deploy/types.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

@@ -5,7 +5,7 @@ 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 '../deploy/payload.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))))

package/oclif.manifest.json

@@ -289,19 +289,13 @@
         "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": {
@@ -316,18 +310,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",
@@ -337,17 +324,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "edit",
+        "emails",
         "index.js"
       ]
     },
-    "emails": {
+    "edit": {
       "aliases": [],
-      "args": {},
-      "description": "List and view configured email sequences",
+      "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 %> emails",
-        "<%= config.bin %> emails --json"
+        "<%= config.bin %> edit welcome",
+        "<%= config.bin %> edit welcome --change \"make subject more urgent\" --yes"
       ],
       "flags": {
         "json": {
@@ -362,11 +355,18 @@
           "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": "emails",
+      "id": "edit",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -376,7 +376,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "edit",
         "index.js"
       ]
     },
@@ -631,13 +631,14 @@
         "index.js"
       ]
     },
-    "status": {
+    "sdk": {
       "aliases": [],
       "args": {},
-      "description": "View email performance metrics and quota usage",
+      "description": "Show the SDK track() / identify() reference for deployed sequences",
       "examples": [
-        "<%= config.bin %> status",
-        "<%= config.bin %> status --json"
+        "<%= config.bin %> sdk",
+        "<%= config.bin %> sdk --sequence-id a1b2c3d4",
+        "<%= config.bin %> sdk --json"
       ],
       "flags": {
         "json": {
@@ -652,11 +653,18 @@
           "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": "status",
+      "id": "sdk",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -666,7 +674,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "status",
+        "sdk",
         "index.js"
       ]
     },
@@ -717,14 +725,13 @@
         "index.js"
       ]
     },
-    "sdk": {
+    "status": {
       "aliases": [],
       "args": {},
-      "description": "Show the SDK track() / identify() reference for deployed sequences",
+      "description": "View email performance metrics and quota usage",
       "examples": [
-        "<%= config.bin %> sdk",
-        "<%= config.bin %> sdk --sequence-id a1b2c3d4",
-        "<%= config.bin %> sdk --json"
+        "<%= config.bin %> status",
+        "<%= config.bin %> status --json"
       ],
       "flags": {
         "json": {
@@ -739,18 +746,11 @@
           "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",
+      "id": "status",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -760,10 +760,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk",
+        "status",
         "index.js"
       ]
     }
   },
-  "version": "0.0.54-beta.pr56.91"
+  "version": "0.0.55-beta.pr57.92"
 }

package/package.json

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