@mailmodo/cli 0.0.12 → 0.0.13-beta.pr14.22

package/dist/commands/domain/index.js

@@ -3,6 +3,7 @@ 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 { saveConfig } from '../../lib/config.js';
 import { saveYaml } from '../../lib/yaml-config.js';
 export default class Domain extends BaseCommand {
     static description = 'Set up and verify your sending domain';
@@ -24,22 +25,22 @@ export default class Domain extends BaseCommand {
     };
     async run() {
         const { flags } = await this.parse(Domain);
-        await this.ensureAuth();
+        const config = await this.ensureAuth();
         if (flags.verify) {
-            await this.verifyDomain(flags.json);
+            await this.verifyDomain(flags.json, config);
             return;
         }
         if (flags.status) {
-            await this.showDomainStatus(flags.json);
+            await this.showDomainStatus(flags.json, config);
             return;
         }
-        await this.setupDomain(flags);
+        await this.setupDomain(flags, config);
     }
     /**
      * Interactive domain setup: collects domain, sender email, and business address,
      * then calls the API to retrieve the required DNS records.
      */
-    async setupDomain(flags) {
+    async setupDomain(flags, config) {
         const yamlConfig = await this.ensureYaml();
         this.log(`\n  ${'─'.repeat(53)}`);
         this.log(`  ${chalk.bold('DOMAIN SETUP')}`);
@@ -84,6 +85,7 @@ export default class Domain extends BaseCommand {
         yamlConfig.project.fromEmail = senderEmail;
         yamlConfig.project.address = address;
         await saveYaml(yamlConfig);
+        await saveConfig({ ...config, domain });
         const records = response.data?.dnsRecords || [];
         if (flags.json) {
             this.log(JSON.stringify({ dnsRecords: records, domain }, null, 2));
@@ -104,15 +106,21 @@ export default class Domain extends BaseCommand {
                 message: "Press Enter once you've added the records, or 'skip'.",
             });
             if (action.toLowerCase() !== 'skip') {
-                await this.verifyDomain(false);
+                await this.verifyDomain(false, { ...config, domain });
             }
         }
     }
     /**
      * Calls the domain verification API and displays pass/fail for each DNS record.
      */
-    async verifyDomain(jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY));
+    async verifyDomain(jsonOutput, config) {
+        if (!config.domain) {
+            this.error(`No domain configured. Run ${chalk.cyan('mailmodo domain')} to set up your sending domain.`);
+        }
+        const domain = config.domain;
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
+            domain,
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -121,16 +129,16 @@ export default class Domain extends BaseCommand {
             this.log(JSON.stringify({ dkim, dmarc, spf }, null, 2));
             return;
         }
-        this.log(`  SPF    ${spf === 'pass' ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        this.log(`  DKIM   ${dkim === 'pass' ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        this.log(`  DMARC  ${dmarc === 'pass' ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        const allPassed = spf === 'pass' && dkim === 'pass' && dmarc === 'pass';
+        this.log(`  SPF    ${spf ? chalk.green('✓') : chalk.red('✗  Not found')}`);
+        this.log(`  DKIM   ${dkim ? chalk.green('✓') : chalk.red('✗  Not found')}`);
+        this.log(`  DMARC  ${dmarc ? chalk.green('✓') : chalk.red('✗  Not found')}`);
+        const allPassed = spf && dkim && dmarc;
         if (allPassed) {
             this.log(`\n  ${chalk.green('✓')} Domain verified.\n`);
         }
         else {
             this.log(`\n  ${chalk.yellow('Some records failed.')}`);
-            if (dkim !== 'pass') {
+            if (!dkim) {
                 this.log(`\n  DKIM common mistakes:`);
                 this.log(`  - Using TXT instead of CNAME record type`);
                 this.log(`  - Including the full domain in the Host field`);
@@ -144,8 +152,14 @@ export default class Domain extends BaseCommand {
      * Displays domain health metrics including verification status,
      * bounce rate, and spam complaint rate.
      */
-    async showDomainStatus(jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading domain status...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_STATUS));
+    async showDomainStatus(jsonOutput, config) {
+        if (!config.domain) {
+            this.error(`No domain configured. Run ${chalk.cyan('mailmodo domain')} to set up your sending domain.`);
+        }
+        const domain = config.domain;
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading domain status...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_STATUS, {
+            domain,
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/init/index.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { 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 { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, } from '../../lib/constants.js';
 import { saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 function isValidUrl(value) {
     try {

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/dist/lib/config.d.ts

@@ -1,6 +1,7 @@
 export interface MailmodoConfig {
     accountName?: string;
     apiKey: string;
+    domain?: string;
     email?: string;
     freeRemaining?: number;
 }

package/dist/lib/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const API_BASE_URL: string;
+export declare const API_BASE_URL = "https://app-vertex-debug.azurewebsites.net";
 export declare const API_ENDPOINTS: Readonly<{
     ANALYTICS: "/analytics";
     ANALYZE: "/analyze";

package/dist/lib/constants.js

@@ -1,6 +1,7 @@
 /** Set by `bin/dev.js` when running the CLI locally (tsx bootstrap). */
 const DEV_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
-const PRODUCTION_API_BASE_URL = 'https://api.mailmodo.com';
+// const PRODUCTION_API_BASE_URL = 'https://api.mailmodo.com';
+const PRODUCTION_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
 export const API_BASE_URL = process.env.MAILMODO_DEV_TSX
     ? DEV_API_BASE_URL
     : PRODUCTION_API_BASE_URL;

package/oclif.manifest.json

@@ -473,14 +473,19 @@
         "index.js"
       ]
     },
-    "settings": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "View and update project settings",
+      "args": {
+        "id": {
+          "description": "Email ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -496,17 +501,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
           "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": "settings",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -516,23 +527,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "preview",
         "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-beta.pr14.22"
 }

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-beta.pr14.22",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"
@@ -24,13 +24,17 @@
     "@types/chai": "^4",
     "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10",
-    "@types/node": "^18",
+    "@types/node": "^18.19.130",
     "chai": "^4",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
     "mocha": "^11",
     "oclif": "^4",
+    "prettier": "^3.8.2",
     "shx": "^0.3.3",
     "ts-node": "^10",
     "tsx": "^4.21.0",
@@ -69,7 +73,15 @@
     "posttest": "npm run lint",
     "prepack": "oclif manifest && oclif readme",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-    "version": "oclif readme && git add README.md"
+    "version": "oclif readme && git add README.md",
+    "prepare": "husky"
   },
-  "types": "dist/index.d.ts"
+  "types": "dist/index.d.ts",
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,mjs,cjs}": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "*.{json,md,yaml,yml}": "prettier --write"
+  }
 }