@mailmodo/cli 0.0.12 → 0.0.13

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

@@ -8,13 +8,30 @@ export default class Settings extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    /**
+     * Prompts the user to pick a setting key to edit and dispatches
+     * to the appropriate handler for that key.
+     */
+    private promptEditSetting;
+    /**
+     * Fetches the domain verification status from the API.
+     * Returns true/false for verified/unverified, or null if unavailable.
+     */
+    private fetchDomainVerified;
+    /**
+     * Handles domain change: collects the new domain, sender email, and
+     * business address, calls the API to register them, displays the required
+     * DNS records, and saves the updated config. Emails won't send until the
+     * domain is re-verified.
+     */
+    private handleDomainChange;
+    private recordLabel;
     /**
      * Handles the logo file upload flow: validates the local file exists,
      * reads it, uploads to Mailmodo CDN via API, and updates both logoFile
      * and logoUrl in the project config.
      *
      * @param {import('../../lib/yaml-config.js').MailmodoYaml} yamlConfig - The full YAML config to update and save.
-     * @param {boolean} jsonOutput - When true, spinner uses stderr so stdout stays clean.
      */
     private handleLogoUpload;
 }

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 } from '../../lib/constants.js';
+import { API_ENDPOINTS, DNS_GUIDE_URL } from '../../lib/constants.js';
 import { saveYaml } from '../../lib/yaml-config.js';
 const SETTINGS_GROUPS = Object.freeze({
     billing: ['monthly_cap'],
@@ -14,6 +14,11 @@ const SETTINGS_GROUPS = Object.freeze({
     identity: ['from_name', 'from_email', 'reply_to'],
     integrations: ['webhook_url'],
 });
+const SETUP_HINTS = {
+    address: "'mailmodo domain'",
+    domain: "'mailmodo domain'",
+    monthlyCap: "'mailmodo billing --cap <n>'",
+};
 /**
  * Converts a user-facing snake_case YAML setting key to its
  * corresponding camelCase TypeScript property name.
@@ -65,66 +70,180 @@ export default class Settings extends BaseCommand {
             this.log(JSON.stringify({ settings: project }, null, 2));
             return;
         }
+        const domainVerified = await this.fetchDomainVerified(project.domain);
         this.log(`\n  Current settings for ${chalk.bold(project.name || 'project')}:\n`);
         for (const [group, keys] of Object.entries(SETTINGS_GROUPS)) {
+            const availableKeys = keys.filter((key) => settingKeyToProp(key) in project);
+            if (availableKeys.length === 0) {
+                const hint = SETUP_HINTS[settingKeyToProp(keys[0])];
+                if (hint) {
+                    this.log(`  ${chalk.bold(group.charAt(0).toUpperCase() + group.slice(1))}`);
+                    this.log(`  ${'─'.repeat(49)}`);
+                    this.log(`  ${chalk.dim(`Run ${hint} to configure.`)}`);
+                    this.log('');
+                }
+                continue;
+            }
             this.log(`  ${chalk.bold(group.charAt(0).toUpperCase() + group.slice(1))}`);
             this.log(`  ${'─'.repeat(49)}`);
-            for (const key of keys) {
+            for (const key of availableKeys) {
                 const propKey = settingKeyToProp(key);
                 const value = project[propKey];
-                const displayValue = value ? String(value) : chalk.dim('(not set)');
+                let displayValue = value ? String(value) : chalk.dim('(not set)');
+                if (key === 'domain' && value && domainVerified === true) {
+                    displayValue += `  ${chalk.green('✓ verified')}`;
+                }
+                else if (key === 'domain' && value && domainVerified === false) {
+                    displayValue += `  ${chalk.red('✗ not verified')}`;
+                }
                 this.log(`  ${key.padEnd(16)} ${displayValue}`);
             }
+            const missingKeys = keys.filter((key) => !(settingKeyToProp(key) in project));
+            for (const key of missingKeys) {
+                const hint = SETUP_HINTS[settingKeyToProp(key)];
+                if (hint) {
+                    this.log(`  ${key.padEnd(16)} ${chalk.dim(`(run ${hint} to set up)`)}`);
+                }
+            }
             this.log('');
         }
         if (!flags.yes) {
-            const editKey = await input({
-                default: 'n',
-                message: "Edit a setting? (key or 'n'):",
+            await this.promptEditSetting(yamlConfig);
+        }
+    }
+    /**
+     * Prompts the user to pick a setting key to edit and dispatches
+     * to the appropriate handler for that key.
+     */
+    async promptEditSetting(yamlConfig) {
+        const { project } = yamlConfig;
+        const editKey = await input({
+            default: 'n',
+            message: "Edit a setting? (key or 'n'):",
+        });
+        if (editKey === 'n')
+            return;
+        const editPropKey = settingKeyToProp(editKey);
+        if (!(editPropKey in project)) {
+            const hint = SETUP_HINTS[editPropKey];
+            if (hint) {
+                this.log(`\n  ${editKey} is not configured yet. Run ${chalk.cyan(hint)} to set it up.\n`);
+            }
+            else {
+                this.log(`\n  Unknown setting: ${editKey}\n`);
+            }
+            return;
+        }
+        if (editKey === 'logo_file') {
+            await this.handleLogoUpload(yamlConfig);
+            return;
+        }
+        if (editKey === 'domain') {
+            await this.handleDomainChange(yamlConfig);
+            return;
+        }
+        if (editKey === 'email_style') {
+            const style = await select({
+                choices: [
+                    { name: 'plain', value: 'plain' },
+                    { name: 'branded', value: 'branded' },
+                ],
+                message: 'Email style:',
             });
-            if (editKey !== 'n') {
-                const editPropKey = settingKeyToProp(editKey);
-                if (!(editPropKey in project)) {
-                    this.log(`\n  Unknown setting: ${editKey}\n`);
-                    return;
-                }
-                if (editKey === 'logo_file') {
-                    await this.handleLogoUpload(yamlConfig, flags.json);
-                    return;
-                }
-                if (editKey === 'email_style') {
-                    const style = await select({
-                        choices: [
-                            { name: 'plain', value: 'plain' },
-                            { name: 'branded', value: 'branded' },
-                        ],
-                        message: 'Email style:',
-                    });
-                    project.emailStyle = style;
-                    await saveYaml(yamlConfig);
-                    this.log(`\n  ${chalk.green('✓')} email_style updated to ${chalk.cyan(style)}`);
-                    this.log(`  Run ${chalk.cyan("'mailmodo deploy'")} to apply.\n`);
-                    return;
-                }
-                const newValue = await input({
-                    message: `New value for ${editKey}:`,
-                });
-                project[editPropKey] =
-                    editPropKey === 'monthlyCap' ? Number(newValue) : newValue;
-                await saveYaml(yamlConfig);
-                this.log(`\n  ${chalk.green('✓')} Updated. Run ${chalk.cyan("'mailmodo deploy'")} to apply.\n`);
+            project.emailStyle = style;
+            await saveYaml(yamlConfig);
+            this.log(`\n  ${chalk.green('✓')} email_style updated to ${chalk.cyan(style)}`);
+            this.log(`  Run ${chalk.cyan("'mailmodo deploy'")} to apply.\n`);
+            return;
+        }
+        const newValue = await input({
+            message: `New value for ${editKey}:`,
+        });
+        project[editPropKey] =
+            editPropKey === 'monthlyCap' ? Number(newValue) : newValue;
+        await saveYaml(yamlConfig);
+        this.log(`\n  ${chalk.green('✓')} Updated. Run ${chalk.cyan("'mailmodo deploy'")} to apply.\n`);
+    }
+    /**
+     * Fetches the domain verification status from the API.
+     * Returns true/false for verified/unverified, or null if unavailable.
+     */
+    async fetchDomainVerified(domain) {
+        if (!domain)
+            return null;
+        try {
+            await this.ensureAuth();
+            const response = await this.apiClient.get(API_ENDPOINTS.DOMAIN_STATUS, { domain });
+            if (!response.ok) {
+                this.log(`  ${chalk.dim('Could not fetch domain status. Run')} ${chalk.cyan("'mailmodo domain --status'")} ${chalk.dim('to check manually.')}`);
+                return null;
             }
+            return response.data?.verified === true;
+        }
+        catch {
+            this.log(`  ${chalk.dim('Could not reach API for domain status. Skipping verification check.')}`);
+            return null;
         }
     }
+    /**
+     * Handles domain change: collects the new domain, sender email, and
+     * business address, calls the API to register them, displays the required
+     * DNS records, and saves the updated config. Emails won't send until the
+     * domain is re-verified.
+     */
+    async handleDomainChange(yamlConfig) {
+        const newDomain = await input({
+            message: 'New domain:',
+            validate: (v) => (v?.trim() ? true : 'Domain is required'),
+        });
+        const newFromEmail = await input({
+            default: yamlConfig.project.fromEmail || '',
+            message: 'Sender email (from address):',
+            validate: (v) => v?.includes('@') ? true : 'Please enter a valid email',
+        });
+        const newAddress = await input({
+            default: yamlConfig.project.address || '',
+            message: 'Business address (required by law):',
+            validate: (v) => (v?.trim() ? true : 'Address is required'),
+        });
+        await this.ensureAuth();
+        const response = await this.apiClient.post(API_ENDPOINTS.DOMAIN, {
+            address: newAddress,
+            domain: newDomain,
+            fromEmail: newFromEmail,
+        });
+        if (!response.ok) {
+            this.handleApiError(response);
+        }
+        const records = response.data?.dnsRecords || [];
+        yamlConfig.project.domain = newDomain;
+        yamlConfig.project.fromEmail = newFromEmail;
+        yamlConfig.project.address = newAddress;
+        await saveYaml(yamlConfig);
+        this.log(`\n  Domain, sender email, and business address updated. You will need to re-verify.`);
+        this.log(`  New DNS records:\n`);
+        for (const [i, record] of records.entries()) {
+            this.log(`  ${chalk.bold(`RECORD ${i + 1} — ${this.recordLabel(i)}`)}`);
+            this.log(`  Type:   ${record.type}`);
+            this.log(`  Host:   ${record.host}`);
+            this.log(`  Value:  ${record.value}\n`);
+        }
+        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`);
+    }
+    recordLabel(index) {
+        const labels = ['SPF', 'DKIM', 'DMARC'];
+        return labels[index] || `Record ${index + 1}`;
+    }
     /**
      * Handles the logo file upload flow: validates the local file exists,
      * reads it, uploads to Mailmodo CDN via API, and updates both logoFile
      * and logoUrl in the project config.
      *
      * @param {import('../../lib/yaml-config.js').MailmodoYaml} yamlConfig - The full YAML config to update and save.
-     * @param {boolean} jsonOutput - When true, spinner uses stderr so stdout stays clean.
      */
-    async handleLogoUpload(yamlConfig, jsonOutput) {
+    async handleLogoUpload(yamlConfig) {
         const logoPath = await input({ message: 'Path to logo file:' });
         const resolvedPath = resolve(logoPath);
         if (!existsSync(resolvedPath)) {
@@ -135,7 +254,7 @@ export default class Settings extends BaseCommand {
         const fileBuffer = await readFile(resolvedPath);
         const formData = new FormData();
         formData.append('logo', new Blob([new Uint8Array(fileBuffer)]), logoPath.split(/[/\\]/).pop() || 'logo.png');
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Uploading logo...' }, () => this.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData));
+        const response = await this.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData);
         if (!response.ok) {
             this.handleApiError(response);
         }

package/oclif.manifest.json

@@ -205,19 +205,13 @@
         "index.js"
       ]
     },
-    "edit": {
+    "emails": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email 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": {
@@ -232,18 +226,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",
@@ -253,17 +240,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "edit",
+        "emails",
         "index.js"
       ]
     },
-    "emails": {
+    "edit": {
       "aliases": [],
-      "args": {},
-      "description": "List and view configured email sequences",
+      "args": {
+        "id": {
+          "description": "Email 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": {
@@ -278,11 +271,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",
@@ -292,7 +292,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "edit",
         "index.js"
       ]
     },
@@ -342,13 +342,12 @@
         "index.js"
       ]
     },
-    "login": {
+    "logout": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Mailmodo using your API key",
+      "description": "Sign out by removing saved credentials from this machine",
       "examples": [
-        "<%= config.bin %> login",
-        "MAILMODO_API_KEY=mm_live_xxx <%= config.bin %> login"
+        "<%= config.bin %> logout"
       ],
       "flags": {
         "json": {
@@ -367,7 +366,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "login",
+      "id": "logout",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -377,16 +376,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "login",
+        "logout",
         "index.js"
       ]
     },
-    "logout": {
+    "logs": {
       "aliases": [],
       "args": {},
-      "description": "Sign out by removing saved credentials from this machine",
+      "description": "View email send logs and delivery events",
       "examples": [
-        "<%= config.bin %> logout"
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs --email sarah@example.com",
+        "<%= config.bin %> logs --failed",
+        "<%= config.bin %> logs --json"
       ],
       "flags": {
         "json": {
@@ -401,11 +403,24 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "email": {
+          "description": "Filter logs by contact email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "failed": {
+          "description": "Show only failed/bounced events",
+          "name": "failed",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logout",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -415,19 +430,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "logout",
+        "logs",
         "index.js"
       ]
     },
-    "logs": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "View email send logs and delivery events",
+      "args": {
+        "id": {
+          "description": "Email ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -443,23 +462,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "email": {
-          "description": "Filter logs by contact email",
-          "name": "email",
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "failed": {
-          "description": "Show only failed/bounced events",
-          "name": "failed",
+        "text": {
+          "description": "Output plain text version (for AI agents)",
+          "name": "text",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -469,18 +488,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "preview",
         "index.js"
       ]
     },
-    "settings": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "View and update project settings",
+      "description": "Authenticate with Mailmodo using your API key",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=mm_live_xxx <%= config.bin %> login"
       ],
       "flags": {
         "json": {
@@ -495,18 +513,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": "login",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -516,23 +527,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "login",
         "index.js"
       ]
     },
-    "preview": {
+    "settings": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email ID to preview",
-          "name": "id"
-        }
-      },
-      "description": "Preview an email in browser, as text, or send a test",
+      "args": {},
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> preview welcome",
-        "<%= config.bin %> preview welcome --text",
-        "<%= config.bin %> preview welcome --send me@example.com"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -548,23 +554,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "send": {
-          "description": "Send test email to this address",
-          "name": "send",
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "text": {
-          "description": "Output plain text version (for AI agents)",
-          "name": "text",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preview",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -574,7 +574,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "preview",
+        "settings",
         "index.js"
       ]
     },
@@ -618,5 +618,5 @@
       ]
     }
   },
-  "version": "0.0.12"
+  "version": "0.0.13"
 }

package/package.json

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