@mailmodo/cli 0.0.28 → 0.0.29-beta.pr31.49

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';
@@ -232,7 +232,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 +273,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 +284,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 +294,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 +305,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 {
@@ -45,22 +45,31 @@ export default class Domain extends BaseCommand {
         this.log(`\n  ${'─'.repeat(53)}`);
         this.log(`  ${chalk.bold('DOMAIN SETUP')}`);
         this.log(`  ${'─'.repeat(53)}\n`);
-        const { domain, senderEmail, address } = await this.collectDomainInputs(flags.yes, yamlConfig);
-        const response = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, {
+        const { domain, senderEmail, fromName, replyTo, address } = await this.collectDomainInputs(flags.yes, yamlConfig);
+        const apiPayload = {
             address,
             domain,
             fromEmail: senderEmail,
-        }));
+        };
+        if (fromName)
+            apiPayload.fromName = fromName;
+        if (replyTo)
+            apiPayload.replyTo = replyTo;
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, apiPayload));
         if (!response.ok) {
             this.handleApiError(response);
         }
         yamlConfig.project.domain = domain;
         yamlConfig.project.fromEmail = senderEmail;
         yamlConfig.project.address = address;
+        if (fromName)
+            yamlConfig.project.fromName = fromName;
+        if (replyTo)
+            yamlConfig.project.replyTo = replyTo;
         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;
@@ -73,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: '',
@@ -98,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;
@@ -124,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`);
         }
     }
     /**
@@ -161,6 +172,8 @@ export default class Domain extends BaseCommand {
             return {
                 address: yamlConfig.project?.address || '',
                 domain,
+                fromName: yamlConfig.project?.fromName || '',
+                replyTo: yamlConfig.project?.replyTo || '',
                 senderEmail: yamlConfig.project?.fromEmail || '',
             };
         }
@@ -174,12 +187,20 @@ export default class Domain extends BaseCommand {
             message: 'Sender email address:',
             validate: (v) => (v?.includes('@') ? true : 'Please enter a valid email'),
         });
+        const fromName = await input({
+            default: yamlConfig.project?.fromName || '',
+            message: 'Display name (optional, shown as sender name):',
+        });
+        const replyTo = await input({
+            default: yamlConfig.project?.replyTo || '',
+            message: 'Reply-to address (optional, press Enter to use sender email):',
+        });
         const address = await input({
             default: yamlConfig.project?.address,
             message: 'Business address (required by law):',
             validate: (v) => (v?.trim() ? true : 'Address is required'),
         });
-        return { address, domain, senderEmail };
+        return { address, domain, fromName, replyTo, senderEmail };
     }
     recordLabel(index) {
         const labels = ['DKIM', 'DMARC', 'Return Path'];

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({
@@ -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/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/oclif.manifest.json

@@ -570,14 +570,13 @@
         "index.js"
       ]
     },
-    "settings": {
+    "status": {
       "aliases": [],
       "args": {},
-      "description": "View and update project settings",
+      "description": "View email performance metrics and quota usage",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> status",
+        "<%= config.bin %> status --json"
       ],
       "flags": {
         "json": {
@@ -592,18 +591,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "settings",
+      "id": "status",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -613,17 +605,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "status",
         "index.js"
       ]
     },
-    "status": {
+    "settings": {
       "aliases": [],
       "args": {},
-      "description": "View email performance metrics and quota usage",
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> status",
-        "<%= config.bin %> status --json"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -638,11 +631,18 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "status",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -652,10 +652,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "status",
+        "settings",
         "index.js"
       ]
     }
   },
-  "version": "0.0.28"
+  "version": "0.0.29-beta.pr31.49"
 }

package/package.json

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