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

package/dist/commands/deploy/index.js

@@ -1,10 +1,14 @@
 import { Flags } from '@oclif/core';
-import { confirm, input } from '@inquirer/prompts';
+import { confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, SDK_IMPORT_SNIPPET, SDK_INSTALL_COMMAND, } from '../../lib/constants.js';
-import { ERRORS, INFO, pauseAlready, pauseSuccess, PROMPTS, resumeAlready, resumeSuccess, SEPARATOR, } from '../../lib/messages.js';
-import { loadTemplate, } from '../../lib/yaml-config.js';
+import { API_ENDPOINTS } from '../../lib/constants.js';
+import { MISSING_TEMPLATES } from '../../lib/messages.js';
+import { buildDeployPayload } from '../../lib/commands/deploy/payload.js';
+import { logDeploySuccessInstructions, logPreDeploySummary, } from '../../lib/commands/deploy/output.js';
+import { pauseSequence, resumeSequence, } from '../../lib/commands/deploy/sequence-status.js';
+import { ensureDomainReady, validateDeploySequence, } from '../../lib/commands/deploy/domain-setup.js';
+import { getMissingTemplateIds, handleMissingTemplates, } from '../../lib/templates/missing-templates.js';
 export default class Deploy extends BaseCommand {
     static description = 'Deploy, pause, or resume an email sequence';
     static examples = [
@@ -24,37 +28,47 @@ export default class Deploy extends BaseCommand {
             exclusive: ['pause'],
         }),
     };
-    fetchDomainVerifyForDeploy(jsonOutput, domain) {
-        return this.withApiSpinner({ json: jsonOutput, text: '  Checking domain verification...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
-            domain: domain || '',
-        }));
-    }
     async run() {
         const { flags } = await this.parse(Deploy);
         await this.ensureAuth();
+        const ctx = this.makeCtx();
         const baseFlags = { json: flags.json, yes: flags.yes };
         if (flags.pause) {
-            await this.pauseSequence(flags.pause, baseFlags);
+            await pauseSequence(ctx, flags.pause, baseFlags);
             return;
         }
         if (flags.resume) {
-            await this.resumeSequence(flags.resume, baseFlags);
+            await resumeSequence(ctx, flags.resume, baseFlags);
             return;
         }
         const yamlConfig = await this.ensureYaml();
-        const domainReady = await this.ensureDomainReady(yamlConfig, flags);
-        if (!domainReady)
+        const missingIds = getMissingTemplateIds(yamlConfig);
+        if (missingIds.length > 0) {
+            const regenerated = await handleMissingTemplates(ctx, yamlConfig, missingIds, baseFlags);
+            if (regenerated)
+                ctx.log(`\n  ${chalk.green('✓')} ${MISSING_TEMPLATES.REVIEW_HINT}\n`);
             return;
-        const payload = await this.buildDeployPayload(yamlConfig);
-        const validateResult = await this.validateSequence(payload, flags);
-        this.logPreDeploySummary(yamlConfig, validateResult, flags.json);
-        const confirmed = await this.confirmDeploy(yamlConfig, flags);
-        if (!confirmed)
+        }
+        const domainReady = await ensureDomainReady(ctx, yamlConfig, baseFlags);
+        if (!domainReady)
             return;
-        const response = await this.withApiSpinner({ json: flags.json, text: '  Deploying email sequences...' }, () => this.apiClient.post(API_ENDPOINTS.SEQUENCES_DEPLOY, payload));
-        if (!response.ok) {
-            this.handleApiError(response);
+        const payload = await buildDeployPayload(ctx, yamlConfig);
+        const validateResult = await validateDeploySequence(ctx, payload, baseFlags);
+        logPreDeploySummary(ctx, yamlConfig, validateResult, flags.json);
+        if (!flags.yes) {
+            const proceed = await confirm({
+                default: true,
+                message: `Deploy ${yamlConfig.emails.length} emails?`,
+            });
+            if (!proceed) {
+                this.log('\n  Deploy cancelled.\n');
+                return;
+            }
         }
+        const response = await ctx.spinner('  Deploying email sequences...', flags.json, () => ctx.post(API_ENDPOINTS.SEQUENCES_DEPLOY, payload));
+        if (!response.ok)
+            ctx.onApiError(response);
+        await ctx.syncYaml();
         if (flags.json) {
             this.log(JSON.stringify({
                 deployed: response.data.deployed,
@@ -65,290 +79,25 @@ export default class Deploy extends BaseCommand {
             }, null, 2));
             return;
         }
-        this.logDeploySuccessInstructions(response.data.sdkSnippet);
+        logDeploySuccessInstructions(ctx, response.data.sdkSnippet);
     }
-    async validateSequence(payload, flags) {
-        const response = await this.withApiSpinner({ json: flags.json, text: '  Validating sequence...' }, () => this.apiClient.post(API_ENDPOINTS.SEQUENCES_VALIDATE, payload));
-        if (!response.ok) {
-            if (response.data.error === 'senderDomainNotFound') {
-                this.error(ERRORS.DOMAIN_NOT_REGISTERED);
-            }
-            if (response.data.error === 'senderDomainNotVerified') {
-                this.error(ERRORS.DOMAIN_NOT_VERIFIED);
-            }
-            this.handleApiError(response);
-        }
-        return response.data;
-    }
-    /**
-     * Calls `POST /sequences/{id}/status` with `{ status: "paused" }` and prints
-     * a confirmation-aware success/no-op message. Skips the prompt entirely when
-     * `--yes` is set so the command stays scriptable. `--json` always emits the
-     * raw server payload (sequenceId, status, alreadyInStatus).
-     */
-    async pauseSequence(sequenceId, flags) {
-        if (!flags.yes) {
-            const confirmed = await confirm({
-                default: false,
-                message: PROMPTS.PAUSE_CONFIRM,
-            });
-            if (!confirmed) {
-                this.log(`\n  ${INFO.PAUSE_CANCELLED}\n`);
-                return;
-            }
-        }
-        const data = await this.updateSequenceStatus(sequenceId, 'paused', flags, '  Pausing sequence...');
-        if (flags.json) {
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        const message = data.alreadyInStatus
-            ? pauseAlready(data.sequenceId || sequenceId)
-            : pauseSuccess(data.sequenceId || sequenceId);
-        this.log(`\n  ${message}\n`);
-    }
-    /**
-     * Calls `POST /sequences/{id}/status` with `{ status: "active" }`. No prompt
-     * — resuming is the safe direction (it does not start sends that weren't
-     * already queued). `--json` always emits the raw server payload (sequenceId,
-     * status, alreadyInStatus).
-     */
-    async resumeSequence(sequenceId, flags) {
-        const data = await this.updateSequenceStatus(sequenceId, 'active', flags, '  Resuming sequence...');
-        if (flags.json) {
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        const message = data.alreadyInStatus
-            ? resumeAlready(data.sequenceId || sequenceId)
-            : resumeSuccess(data.sequenceId || sequenceId);
-        this.log(`\n  ${message}\n`);
-    }
-    async updateSequenceStatus(sequenceId, status, flags, spinnerText) {
-        const response = await this.withApiSpinner({ json: flags.json, text: spinnerText }, () => this.apiClient.post(this.sequenceStatusPath(sequenceId), { status }));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        return response.data;
-    }
-    sequenceStatusPath(sequenceId) {
-        return `${API_ENDPOINTS.SEQUENCES}/${encodeURIComponent(sequenceId)}/status`;
-    }
-    async buildDeployPayload(yamlConfig) {
-        const [emailsWithHtml, monthlyCap] = await Promise.all([
-            Promise.all(yamlConfig.emails.map(async (email) => {
-                const html = (await loadTemplate(`${email.id}.html`)) || '';
-                const plainHtml = (await loadTemplate(`${email.id}_plain.html`)) || html;
-                return { ...this.mapEmailToPayload(email), html, plainHtml };
-            })),
-            this.resolveMonthlyCapForDeploy(yamlConfig.project.monthlyCap),
-        ]);
-        return {
-            ...this.buildProjectPayload(yamlConfig.project, monthlyCap),
-            emails: emailsWithHtml,
-        };
-    }
-    async resolveMonthlyCapForDeploy(yamlMonthlyCap) {
-        if (yamlMonthlyCap !== undefined)
-            return yamlMonthlyCap;
-        const billingStatus = await this.fetchBillingStatus();
-        return billingStatus?.cap?.inBlocks ?? undefined;
-    }
-    mapEmailToPayload(email) {
-        return {
-            condition: email.condition || null,
-            ctaText: email.ctaText || '',
-            delay: email.delay,
-            goal: email.goal || '',
-            id: email.id,
-            isReminder: false,
-            previewText: email.previewText || '',
-            priority: 'medium',
-            subject: email.subject,
-            trigger: email.trigger,
-        };
-    }
-    buildBrandSection(project) {
+    makeCtx() {
         return {
-            colors: [project?.brandColor || DEFAULT_BRAND_COLOR],
-            logoUrl: project?.logoUrl || '',
+            collectDomainInputs: (yaml, skip) => this.collectDomainSetupInputs(yaml, skip),
+            error: (msg) => this.error(msg),
+            exit: (code) => this.exit(code),
+            get: (path, params) => this.apiClient.get(path, params),
+            getBillingCap: async () => {
+                const s = await this.fetchBillingStatus();
+                return s?.cap?.inBlocks ?? undefined;
+            },
+            log: (msg) => this.log(msg),
+            onApiError: (r) => this.handleApiError(r),
+            post: (path, body) => this.apiClient.post(path, body),
+            registerDomainAndSave: (yaml, inputs, json) => this.registerDomain(yaml, inputs, json),
+            showDnsRecords: (records, url, json) => this.logDnsRecords(records, url, json),
+            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
+            syncYaml: () => this.syncYamlToServer(),
         };
     }
-    buildProductSection(project) {
-        return {
-            businessType: project?.type || '',
-            description: project?.description || '',
-            pricingModel: project?.pricingModel || '',
-            productName: project?.name || '',
-            saasModel: project?.saasModel || '',
-            targetUser: project?.targetUser || '',
-            url: project?.url || '',
-        };
-    }
-    buildSenderSection(project) {
-        return {
-            address: project?.address || '',
-            domain: project?.domain || '',
-            fromEmail: project?.fromEmail || '',
-            fromName: project?.fromName || '',
-            replyTo: project?.replyTo || project?.fromEmail || '',
-        };
-    }
-    buildProjectPayload(project, monthlyCap) {
-        return {
-            brand: this.buildBrandSection(project),
-            emailStyle: project?.emailStyle || 'branded',
-            ...(monthlyCap === undefined ? {} : { monthlyCap }),
-            product: this.buildProductSection(project),
-            senderDetails: this.buildSenderSection(project),
-            ...(project?.webhookUrl ? { webhookUrl: project.webhookUrl } : {}),
-        };
-    }
-    async confirmDeploy(yamlConfig, flags) {
-        if (flags.yes)
-            return true;
-        const proceed = await confirm({
-            default: true,
-            message: `Deploy ${yamlConfig.emails.length} emails?`,
-        });
-        if (!proceed) {
-            this.log('\n  Deploy cancelled.\n');
-        }
-        return proceed;
-    }
-    async ensureDomainReady(yamlConfig, flags) {
-        const domainVerify = await this.fetchDomainVerifyForDeploy(flags.json, yamlConfig.project?.domain);
-        if (domainVerify.ok && domainVerify.data?.domainStatus === 'VERIFIED') {
-            return true;
-        }
-        if (yamlConfig.project?.domain) {
-            if (!flags.json) {
-                this.log(`\n  ${INFO.DOMAIN_PENDING_VERIFICATION}\n`);
-            }
-            return false;
-        }
-        if (!flags.json) {
-            this.log(`\n  No sending domain set up yet.`);
-            this.log(`  You need a verified domain before sending emails.`);
-            this.log(`  This is a one-time setup. Takes about 5 minutes.\n`);
-        }
-        if (!flags.yes) {
-            const setupNow = await confirm({
-                default: true,
-                message: 'Set up your sending domain now?',
-            });
-            if (!setupNow) {
-                this.log(`\n  ${INFO.SEQUENCES_NOT_DEPLOYED}`);
-                this.log(`  Emails will not send until your domain is verified.`);
-                this.log(`  ${INFO.DOMAIN_NOT_DEPLOYED_HINT}\n`);
-                return false;
-            }
-        }
-        return this.runDomainSetup(yamlConfig, flags);
-    }
-    logPreDeploySummary(yamlConfig, validateResult, jsonOutput) {
-        if (jsonOutput)
-            return;
-        this.log(`\n  ${chalk.green('✓')} Domain: ${yamlConfig.project?.domain || 'verified'}\n`);
-        if (!validateResult.existingDeployment || !validateResult.diff) {
-            this.log(`  Deploying:`);
-            for (const email of yamlConfig.emails) {
-                this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
-            }
-        }
-        else {
-            this.logDiff(validateResult.diff);
-        }
-        this.log('');
-    }
-    logDiff(diff) {
-        if (!diff.hasChanges) {
-            this.log(`  No changes from last deployment.`);
-            return;
-        }
-        this.log(`  Changes vs. last deployment:`);
-        for (const email of diff.added) {
-            this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger || ''}`);
-        }
-        for (const email of diff.removed) {
-            this.log(`  ${chalk.red('-')} ${email.id.padEnd(24)} ${email.trigger || ''}`);
-        }
-        for (const email of diff.modified) {
-            const fields = email.changedFields?.join(', ') || '';
-            this.log(`  ${chalk.yellow('~')} ${email.id.padEnd(24)} ${fields}`);
-        }
-        if (diff.unchanged.length > 0) {
-            this.log(`  ${chalk.dim(`∙ ${diff.unchanged.length} unchanged`)}`);
-        }
-    }
-    logDeploySuccessInstructions(sdkSnippet) {
-        this.log(`  ${chalk.green('Deployed.')} Emails are live.\n`);
-        this.log(`  ${SEPARATOR}`);
-        this.log(`  ${chalk.bold('ADD THIS TO YOUR APP (one-time only):')}`);
-        this.log(`  ${SEPARATOR}\n`);
-        this.log(`  ${chalk.cyan(sdkSnippet.install ?? SDK_INSTALL_COMMAND)}\n`);
-        this.log(`  ${chalk.dim(SDK_IMPORT_SNIPPET)}\n`);
-        if (sdkSnippet.examples) {
-            this.log(`  ${chalk.dim('// Example usage:')}`);
-            this.log(`  ${chalk.dim(sdkSnippet.examples.track)}`);
-            this.log(`  ${chalk.dim(sdkSnippet.examples.identify)}\n`);
-        }
-        const trackCalls = [...new Set(sdkSnippet.trackCalls ?? [])];
-        for (const call of trackCalls) {
-            this.log(`  ${chalk.dim(call)}`);
-        }
-        if (trackCalls.length > 0)
-            this.log('');
-        const identifyCalls = [...new Set(sdkSnippet.identifyCalls ?? [])];
-        for (const call of identifyCalls) {
-            this.log(`  ${chalk.dim(call)}`);
-        }
-        if (identifyCalls.length > 0)
-            this.log('');
-        this.log(`  Full SDK docs: ${chalk.cyan('mailmodo.com/docs/sdk')}\n`);
-        this.log(`  ${SEPARATOR}\n`);
-    }
-    async runDomainSetup(yamlConfig, flags) {
-        const inputs = await this.collectDomainSetupInputs(yamlConfig, flags.yes);
-        const { dnsRecords, dnsGuideUrl } = await this.registerDomain(yamlConfig, inputs, flags.json);
-        this.logDnsRecords(dnsRecords, dnsGuideUrl, flags.json);
-        if (flags.yes) {
-            return this.verifyDomain(flags.json, inputs.domain);
-        }
-        const action = await input({
-            default: '',
-            message: PROMPTS.ENTER_AFTER_RECORDS,
-        });
-        if (action.toLowerCase() === 'skip') {
-            this.log(`\n  ${INFO.SEQUENCES_NOT_DEPLOYED}`);
-            this.log(`  ${INFO.DOMAIN_NOT_DEPLOYED_HINT}\n`);
-            return false;
-        }
-        return this.verifyDomain(flags.json, inputs.domain);
-    }
-    async verifyDomain(jsonOutput, domain) {
-        const verify = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
-            domain,
-        }));
-        if (!verify.ok) {
-            this.handleApiError(verify);
-        }
-        const { dkim, dmarc, dnsGuideUrl, domainStatus, returnPath } = verify.data;
-        const allPassed = domainStatus === 'VERIFIED';
-        if (!jsonOutput) {
-            this.log(`  DKIM         ${dkim ? chalk.green('✓') : chalk.red('✗')}`);
-            this.log(`  DMARC        ${dmarc ? chalk.green('✓') : chalk.red('✗')}`);
-            this.log(`  Return-Path  ${returnPath ? chalk.green('✓') : chalk.red('✗')}`);
-            if (allPassed) {
-                this.log(`\n  ${chalk.green('Domain verified.')} Continuing deploy...\n`);
-            }
-            else {
-                this.log(`\n  ${INFO.DNS_RECORDS_FAILED}`);
-                this.log(`\n  ${INFO.DNS_FIX_AND_VERIFY}`);
-                if (dnsGuideUrl)
-                    this.log(`  Help: ${chalk.cyan(dnsGuideUrl)}\n`);
-            }
-        }
-        return allPassed;
-    }
 }

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

@@ -7,8 +7,5 @@ export default class Deployments extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private renderTable;
-    private statusColor;
-    private colWidth;
-    private formatDate;
+    private makeCtx;
 }

package/dist/commands/deployments/index.js

@@ -1,6 +1,6 @@
-import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
+import { renderDeploymentsTable } from '../../lib/commands/deployments/output.js';
 export default class Deployments extends BaseCommand {
     static description = 'List every deployed sequence on this account, with the IDs needed for deploy --pause / --resume';
     static examples = [
@@ -13,64 +13,23 @@ export default class Deployments extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Deployments);
         await this.ensureAuth();
-        const response = await this.withApiSpinner({ json: flags.json, text: '  Loading deployments...' }, () => this.apiClient.get(API_ENDPOINTS.SEQUENCES));
+        const ctx = this.makeCtx();
+        const response = await ctx.spinner('  Loading deployments...', flags.json, () => ctx.get(API_ENDPOINTS.SEQUENCES));
         if (!response.ok) {
-            this.handleApiError(response);
+            ctx.onApiError(response);
         }
         if (flags.json) {
             this.log(JSON.stringify(response.data, null, 2));
             return;
         }
-        this.renderTable(response.data);
+        renderDeploymentsTable(ctx, response.data);
     }
-    renderTable(data) {
-        const sequences = data.sequences ?? [];
-        if (sequences.length === 0) {
-            this.log(`\n  ${chalk.dim('No deployed sequences yet.')}`);
-            this.log(`  Run ${chalk.cyan('mailmodo deploy')} to deploy one.\n`);
-            return;
-        }
-        const rows = sequences.map((seq) => ({
-            emails: String(seq.emailCount ?? 0),
-            product: seq.productName ?? '',
-            sequenceId: seq.sequenceId ?? '',
-            status: seq.status ?? '',
-            updated: this.formatDate(seq.updatedAt),
-        }));
-        const widths = {
-            emails: this.colWidth(rows, 'emails', 'Emails'),
-            product: this.colWidth(rows, 'product', 'Product'),
-            sequenceId: this.colWidth(rows, 'sequenceId', 'Sequence ID'),
-            status: this.colWidth(rows, 'status', 'Status'),
-            updated: this.colWidth(rows, 'updated', 'Updated'),
+    makeCtx() {
+        return {
+            get: (path, params) => this.apiClient.get(path, params),
+            log: (msg) => this.log(msg),
+            onApiError: (r) => this.handleApiError(r),
+            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
         };
-        this.log(`\n  ${chalk.bold(String(sequences.length))} deployed ${sequences.length === 1 ? 'sequence' : 'sequences'}:\n`);
-        this.log(`  ${chalk.bold('Product'.padEnd(widths.product))}${chalk.bold('Status'.padEnd(widths.status))}${chalk.bold('Emails'.padEnd(widths.emails))}${chalk.bold('Sequence ID'.padEnd(widths.sequenceId))}${chalk.bold('Updated')}`);
-        this.log(`  ${'─'.repeat(widths.product + widths.status + widths.emails + widths.sequenceId + widths.updated)}`);
-        for (const row of rows) {
-            const status = this.statusColor(row.status)(row.status.padEnd(widths.status));
-            this.log(`  ${row.product.padEnd(widths.product)}${status}${row.emails.padEnd(widths.emails)}${chalk.cyan(row.sequenceId.padEnd(widths.sequenceId))}${chalk.dim(row.updated)}`);
-        }
-        this.log('');
-        this.log(`  Pause:  ${chalk.cyan('mailmodo deploy --pause <sequence-id>')}`);
-        this.log(`  Resume: ${chalk.cyan('mailmodo deploy --resume <sequence-id>')}\n`);
-    }
-    statusColor(status) {
-        if (status === 'active')
-            return chalk.green;
-        if (status === 'paused')
-            return chalk.yellow;
-        return chalk.white;
-    }
-    colWidth(rows, key, header) {
-        return Math.max(...rows.map((r) => r[key].length), header.length) + 2;
-    }
-    formatDate(iso) {
-        if (!iso)
-            return '';
-        const parsed = new Date(iso);
-        if (Number.isNaN(parsed.getTime()))
-            return iso;
-        return parsed.toISOString().slice(0, 10);
     }
 }

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

@@ -9,18 +9,5 @@ export default class Domain extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    /**
-     * Interactive domain setup: collects domain, sender email, and business address,
-     * then calls the API to retrieve the required DNS records.
-     */
-    private setupDomain;
-    /**
-     * Calls the domain verification API and displays pass/fail for each DNS record.
-     */
-    private verifyDomain;
-    /**
-     * Displays domain health metrics including verification status,
-     * bounce rate, and spam complaint rate.
-     */
-    private showDomainStatus;
+    private makeCtx;
 }

package/dist/commands/domain/index.js

@@ -1,9 +1,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 } from '../../lib/constants.js';
-import { ERRORS, INFO, PROMPTS, SEPARATOR } from '../../lib/messages.js';
+import { getDomainOrError, setupDomain, showDomainStatus, } from '../../lib/commands/domain/setup.js';
+import { verifyDomain } from '../../lib/commands/domain/verify.js';
 export default class Domain extends BaseCommand {
     static description = 'Set up and verify your sending domain';
     static examples = [
@@ -25,111 +23,32 @@ export default class Domain extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Domain);
         await this.ensureAuth();
+        const ctx = this.makeCtx();
         if (flags.verify) {
             const yamlConfig = await this.ensureYaml();
-            const domain = yamlConfig.project?.domain;
-            if (!domain) {
-                this.error(ERRORS.DOMAIN_NOT_CONFIGURED);
-            }
-            await this.verifyDomain(flags.json, domain);
+            const domain = getDomainOrError(ctx, yamlConfig);
+            await verifyDomain(ctx, { domain, json: flags.json });
             return;
         }
         if (flags.status) {
             const yamlConfig = await this.ensureYaml();
-            const domain = yamlConfig.project?.domain;
-            if (!domain) {
-                this.error(ERRORS.DOMAIN_NOT_CONFIGURED);
-            }
-            await this.showDomainStatus(flags.json, domain);
+            const domain = getDomainOrError(ctx, yamlConfig);
+            await showDomainStatus(ctx, { domain, json: flags.json });
             return;
         }
-        await this.setupDomain(flags);
-    }
-    /**
-     * Interactive domain setup: collects domain, sender email, and business address,
-     * then calls the API to retrieve the required DNS records.
-     */
-    async setupDomain(flags) {
         const yamlConfig = await this.ensureYaml();
-        this.log(`\n  ${SEPARATOR}`);
-        this.log(`  ${chalk.bold('DOMAIN SETUP')}`);
-        this.log(`  ${SEPARATOR}\n`);
-        const inputs = await this.collectDomainSetupInputs(yamlConfig, flags.yes);
-        const { dnsRecords, dnsGuideUrl } = await this.registerDomain(yamlConfig, inputs, flags.json);
-        if (flags.json) {
-            this.log(JSON.stringify({ dnsRecords, domain: inputs.domain }, null, 2));
-            return;
-        }
-        this.logDnsRecords(dnsRecords, dnsGuideUrl, flags.json);
-        if (!flags.yes) {
-            const action = await input({
-                default: '',
-                message: PROMPTS.ENTER_AFTER_RECORDS,
-            });
-            if (action.toLowerCase() !== 'skip') {
-                await this.verifyDomain(false, inputs.domain);
-            }
-        }
+        await setupDomain(ctx, yamlConfig, flags);
     }
-    /**
-     * Calls the domain verification API and displays pass/fail for each DNS record.
-     */
-    async verifyDomain(jsonOutput, 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);
-        }
-        const { dkim, dmarc, dnsGuideUrl, returnPath, domainStatus } = response.data;
-        if (jsonOutput) {
-            this.log(JSON.stringify({ dkim, dmarc, returnPath, domainStatus }, null, 2));
-            return;
-        }
-        this.log(`  DKIM         ${dkim ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        this.log(`  DMARC        ${dmarc ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        this.log(`  Return Path  ${returnPath ? chalk.green('✓') : chalk.red('✗  Not found')}`);
-        const allPassed = domainStatus === 'VERIFIED';
-        if (allPassed) {
-            this.log(`\n  ${chalk.green('✓')} Domain verified.\n`);
-        }
-        else {
-            this.log(`\n  ${INFO.DNS_RECORDS_FAILED}`);
-            if (!dkim) {
-                this.log(`\n  DKIM common mistakes:`);
-                this.log(`  - Using CNAME instead of TXT record type`);
-                this.log(`  - Including the full domain in the Host field`);
-                this.log(`  - Cloudflare: proxy must be OFF (grey cloud, not orange)`);
-            }
-            if (!returnPath) {
-                this.log(`\n  Return Path common mistakes:`);
-                this.log(`  - Missing or incorrect CNAME for mm-bounce subdomain`);
-                this.log(`  - Cloudflare: proxy must be OFF (grey cloud, not orange)`);
-            }
-            this.log(`\n  ${INFO.DNS_FIX_AND_VERIFY}`);
-            if (dnsGuideUrl)
-                this.log(`  Help: ${chalk.cyan(dnsGuideUrl)}\n`);
-        }
-    }
-    /**
-     * Displays domain health metrics including verification status,
-     * bounce rate, and spam complaint rate.
-     */
-    async showDomainStatus(jsonOutput, 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);
-        }
-        const { data } = response;
-        if (jsonOutput) {
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        this.log(`\n  Domain: ${chalk.bold(data.domain || 'not configured')}`);
-        this.log(`  Status: ${data.verified ? chalk.green('✓ verified') : chalk.red('✗ not verified')}`);
-        this.log(`  Bounce rate: ${data.bounceRate ?? 'N/A'}%`);
-        this.log(`  Spam rate:   ${data.spamRate ?? 'N/A'}%\n`);
+    makeCtx() {
+        return {
+            collectDomainInputs: (yaml, skip) => this.collectDomainSetupInputs(yaml, skip),
+            error: (msg) => this.error(msg),
+            get: (path, params) => this.apiClient.get(path, params),
+            log: (msg) => this.log(msg),
+            onApiError: (r) => this.handleApiError(r),
+            registerDomainAndSave: (yaml, inputs, json) => this.registerDomain(yaml, inputs, json),
+            showDnsRecords: (records, url, json) => this.logDnsRecords(records, url, json),
+            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
+        };
     }
 }

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

@@ -11,24 +11,6 @@ export default class Edit extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private runEditStep;
-    private handleUserAction;
-    private callEditApi;
-    private finalizeEdit;
-    private applyEmailChanges;
-    private persistChanges;
-    private logJsonResult;
-    private handleAcceptOutput;
-    private promptEditAction;
-    private askChangeDescription;
-    private showFieldDiff;
-    private stripHtml;
-    private truncate;
-    private showHtmlChange;
-    private showUnchangedField;
-    private showUnchangedHtml;
-    private showSuggestedChanges;
-    private showUnchanged;
-    private buildDiffPreview;
-    private showChangeSummary;
+    private makeCtx;
+    private makeRegenCtx;
 }