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

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

@@ -12,15 +12,5 @@ export default class Billing extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private startCheckout;
-    private showStatus;
-    private formatAutoCharge;
-    private formatCap;
-    private formatCurrency;
-    private formatPaymentMethod;
-    private formatUsageBlock;
-    private persistMonthlyCap;
-    private pluralize;
-    private purchaseBlocks;
-    private setCap;
+    private makeCtx;
 }

package/dist/commands/billing/index.js

@@ -1,10 +1,8 @@
 import { Flags } from '@oclif/core';
 import chalk from 'chalk';
-import open from 'open';
-import { BaseCommand, FREE_TIER } from '../../lib/base-command.js';
-import { API_ENDPOINTS } from '../../lib/constants.js';
-import { INFO } from '../../lib/messages.js';
-import { loadYaml, saveYaml } from '../../lib/yaml-config.js';
+import { BaseCommand } from '../../lib/base-command.js';
+import { showStatus, startCheckout, } from '../../lib/commands/billing/checkout-status.js';
+import { purchaseBlocks, setCap, } from '../../lib/commands/billing/purchase-cap.js';
 export default class Billing extends BaseCommand {
     static description = 'View billing status, purchase blocks, set cap, or add a payment method';
     static examples = [
@@ -20,16 +18,12 @@ export default class Billing extends BaseCommand {
         'auto-charge-block-count': Flags.integer({
             description: 'Blocks to auto-purchase when the quota runs low (use with --cap)',
         }),
-        cap: Flags.integer({
-            description: 'Set monthly sending cap in blocks',
-        }),
+        cap: Flags.integer({ description: 'Set monthly sending cap in blocks' }),
         checkout: Flags.boolean({
             default: false,
             description: 'Open Stripe checkout to add or update a payment method',
         }),
-        purchase: Flags.integer({
-            description: 'Manually purchase email blocks',
-        }),
+        purchase: Flags.integer({ description: 'Manually purchase email blocks' }),
         status: Flags.boolean({
             default: false,
             description: 'Show billing status only',
@@ -38,189 +32,42 @@ export default class Billing extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Billing);
         await this.ensureAuth();
+        const ctx = this.makeCtx();
         const autoChargeBlockCount = flags['auto-charge-block-count'];
         if (autoChargeBlockCount !== undefined && flags.cap === undefined) {
             this.error(`Use ${chalk.cyan('--auto-charge-block-count')} together with ${chalk.cyan('--cap')}.`);
         }
         if (flags.checkout) {
-            await this.startCheckout(flags.json);
+            await startCheckout(ctx, flags.json);
             return;
         }
         if (flags.purchase !== undefined) {
-            await this.purchaseBlocks(flags.purchase, flags.json);
+            await purchaseBlocks(ctx, flags.purchase, flags.json);
             return;
         }
         if (flags.cap !== undefined) {
-            await this.setCap(flags.cap, autoChargeBlockCount, flags.json);
-            return;
-        }
-        await this.showStatus(flags.json, flags.status);
-    }
-    async startCheckout(jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Creating checkout session...' }, () => this.apiClient.post(API_ENDPOINTS.BILLING_CHECKOUT));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        const { checkoutUrl } = response.data;
-        if (jsonOutput) {
-            this.log(JSON.stringify({ checkoutUrl }, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.bold('Stripe Checkout')} — add or update your payment method.`);
-        this.log(`  ${chalk.dim(checkoutUrl)}\n`);
-        try {
-            await open(checkoutUrl);
-            this.log(`  ${INFO.BROWSER_OPENING}\n`);
-        }
-        catch {
-            this.log(`  ${INFO.BROWSER_OPEN_FAILED}\n`);
-        }
-    }
-    async showStatus(jsonOutput, statusOnly) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading billing status...' }, () => this.apiClient.get(API_ENDPOINTS.BILLING_STATUS));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        const { data } = response;
-        if (jsonOutput) {
-            this.log(JSON.stringify(data, null, 2));
+            await setCap(ctx, {
+                autoChargeBlockCount,
+                cap: flags.cap,
+                json: flags.json,
+            });
             return;
         }
-        this.log('');
-        this.log(`  Tier:          ${data.tier}`);
-        this.log(`  Payment:       ${this.formatPaymentMethod(data)}`);
-        this.log(`  Auto-charge:   ${this.formatAutoCharge(data)}`);
-        if (data.tier !== 'free') {
-            this.log(`  Monthly cap:   ${this.formatCap(data.cap)}`);
-        }
-        this.log(`  Total spent:   ${this.formatCurrency(data.totalSpent, data.spentCurrency)}`);
-        if (data.activeBlocks.length === 0) {
-            this.log('  Active blocks: none');
-        }
-        else {
-            this.log('  Active blocks:');
-            for (const block of data.activeBlocks) {
-                this.log(`    - ${this.formatUsageBlock(block)}`);
-            }
-        }
-        this.log('');
-        if (!data.hasPaymentMethod && !statusOnly) {
-            await this.startCheckout(jsonOutput);
-        }
+        await showStatus(ctx, flags.json, flags.status);
     }
-    formatAutoCharge(data) {
-        if (!data.autoChargeEnabled) {
-            return 'disabled';
-        }
-        if (typeof data.autoChargeBlockCount !== 'number') {
-            return 'enabled';
-        }
-        return `enabled (${data.autoChargeBlockCount} ${this.pluralize('block', data.autoChargeBlockCount)})`;
-    }
-    formatCap(cap) {
-        const hasBlocks = typeof cap.inBlocks === 'number';
-        const hasEmails = typeof cap.inEmails === 'number';
-        if (hasBlocks && hasEmails) {
-            return `${cap.inBlocks} ${this.pluralize('block', cap.inBlocks)} (${cap.inEmails.toLocaleString()} ${this.pluralize('email', cap.inEmails)})`;
-        }
-        if (hasBlocks) {
-            return `${cap.inBlocks} ${this.pluralize('block', cap.inBlocks)}`;
-        }
-        if (hasEmails) {
-            return `${cap.inEmails.toLocaleString()} ${this.pluralize('email', cap.inEmails)}`;
-        }
-        return 'not set';
-    }
-    formatCurrency(amount, currency) {
-        const numericAmount = typeof amount === 'number' ? amount : Number.parseFloat(amount);
-        const normalizedCurrency = currency.toUpperCase();
-        if (Number.isFinite(numericAmount)) {
-            try {
-                return new Intl.NumberFormat('en-US', {
-                    currency: normalizedCurrency,
-                    style: 'currency',
-                }).format(numericAmount);
-            }
-            catch {
-                return `${numericAmount.toFixed(2)} ${normalizedCurrency}`;
-            }
-        }
-        return `${String(amount)} ${normalizedCurrency}`;
-    }
-    formatPaymentMethod(data) {
-        if (!data.hasPaymentMethod) {
-            return 'No payment method on file';
-        }
-        const primaryMethod = data.paymentMethod[0];
-        if (!primaryMethod) {
-            return 'Payment method on file';
-        }
-        const brand = primaryMethod.brand || 'Card';
-        return primaryMethod.last4
-            ? `${brand} ending ${primaryMethod.last4}`
-            : `${brand} on file`;
-    }
-    formatUsageBlock(block) {
-        const allowance = block.blockAllowance ?? Math.max(block.blocksCount * block.blockSize, 0);
-        const used = Math.max(block.emailsSent ?? 0, 0);
-        const activationSuffix = block.activatedAt
-            ? `, activated at ${new Date(block.activatedAt).toLocaleDateString('en-US')}`
-            : '';
-        return `${block.type} block (${used + allowance}): ${used} ${this.pluralize('email', used)} sent, ${allowance} ${this.pluralize('email', allowance)} remaining${activationSuffix}`;
-    }
-    async persistMonthlyCap(capBlocks) {
-        const yamlConfig = await loadYaml();
-        if (!yamlConfig)
-            return;
-        if (yamlConfig.project.monthlyCap === capBlocks)
-            return;
-        yamlConfig.project.monthlyCap = capBlocks;
-        await saveYaml(yamlConfig);
-    }
-    pluralize(word, count) {
-        return count === 1 ? word : `${word}s`;
-    }
-    async purchaseBlocks(blocksCount, jsonOutput) {
-        if (blocksCount < 1) {
-            this.error('Purchase block count must be at least 1 block.');
-        }
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Initiating block purchase...' }, () => this.apiClient.post(API_ENDPOINTS.BILLING_PURCHASE, {
-            blocksCount,
-        }));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        if (jsonOutput) {
-            this.log(JSON.stringify(response.data, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.green('✓')} ${response.data.message}`);
-        this.log(`  Blocks:        ${blocksCount} ${this.pluralize('block', blocksCount)}`);
-        this.log(`  Payment intent:${` ${chalk.dim(response.data.paymentIntentId)}`}`);
-        this.log('');
-    }
-    async setCap(cap, autoChargeBlockCount, jsonOutput) {
-        this.validateBillingCapInputs({ autoChargeBlockCount, cap });
-        const tier = await this.fetchBillingTier();
-        if (tier === FREE_TIER) {
-            this.warnFreeTierCapBlocked(jsonOutput);
-            return;
-        }
-        const data = await this.applyBillingCap({
-            autoChargeBlockCount,
-            cap,
-            json: jsonOutput,
-        });
-        await this.persistMonthlyCap(data.capBlocks);
-        if (jsonOutput) {
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.green('✓')} ${data.message}`);
-        this.log(`  Monthly cap:   ${chalk.bold(String(data.capBlocks))} ${this.pluralize('block', data.capBlocks)} (${data.capEmails.toLocaleString()} emails)`);
-        if (data.autoChargeBlockCount !== undefined) {
-            this.log(`  Auto-charge:   ${data.autoChargeBlockCount} ${this.pluralize('block', data.autoChargeBlockCount)}`);
-        }
-        this.log('');
+    makeCtx() {
+        return {
+            applyBillingCap: (opts) => this.applyBillingCap(opts),
+            error: (msg) => this.error(msg),
+            fetchBillingTier: () => this.fetchBillingTier(),
+            get: (path, params) => this.apiClient.get(path, params),
+            log: (msg) => this.log(msg),
+            onApiError: (r) => this.handleApiError(r),
+            post: (path, body) => this.apiClient.post(path, body),
+            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
+            syncYaml: () => this.syncYamlToServer(),
+            validateBillingCapInputs: (opts) => this.validateBillingCapInputs(opts),
+            warnFreeTierCapBlocked: (json) => this.warnFreeTierCapBlocked(json),
+        };
     }
 }

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

@@ -10,23 +10,5 @@ export default class Contacts extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    /**
-     * Displays aggregate contact counts: total, active, unsubscribed, bounced.
-     */
-    private showSummary;
-    /**
-     * Looks up a single contact by email address and displays their
-     * status, properties, and pending emails.
-     */
-    private searchContact;
-    /**
-     * Triggers a CSV export of all contacts. The API returns a download URL
-     * for the generated file.
-     */
-    private exportContacts;
-    /**
-     * Performs a GDPR-compliant hard delete of a contact and all their
-     * send history. Requires confirmation unless --yes flag is used.
-     */
-    private deleteContact;
+    private makeCtx;
 }

package/dist/commands/contacts/index.js

@@ -1,10 +1,7 @@
 import { Flags } from '@oclif/core';
-import { confirm } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { writeFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS } from '../../lib/constants.js';
+import { deleteContact, exportContacts, } from '../../lib/commands/contacts/export-delete.js';
+import { searchContact, showSummary, } from '../../lib/commands/contacts/actions.js';
 export default class Contacts extends BaseCommand {
     static description = 'Manage contacts — search, export, or delete';
     static examples = [
@@ -27,124 +24,34 @@ export default class Contacts extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Contacts);
         await this.ensureAuth();
+        const ctx = this.makeCtx();
         if (flags.search) {
-            await this.searchContact(flags.search, flags.json);
+            await searchContact(ctx, flags.search, flags.json);
             return;
         }
         if (flags.export) {
-            await this.exportContacts(flags.json);
+            await exportContacts(ctx, { json: flags.json });
             return;
         }
         if (flags.delete) {
-            await this.deleteContact(flags.delete, flags.json, flags.yes);
-            return;
-        }
-        await this.showSummary(flags.json);
-    }
-    /**
-     * Displays aggregate contact counts: total, active, unsubscribed, bounced.
-     */
-    async showSummary(jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading contacts...' }, () => this.apiClient.get(API_ENDPOINTS.CONTACTS));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        const { data } = response;
-        if (jsonOutput) {
-            this.log(JSON.stringify(data, null, 2));
-            return;
-        }
-        this.log(`\n  Total: ${chalk.bold(String(data.total ?? 0))}  ` +
-            `Active: ${chalk.green(String(data.active ?? 0))}  ` +
-            `Unsubscribed: ${chalk.yellow(String(data.unsubscribed ?? 0))}  ` +
-            `Bounced: ${chalk.red(String(data.bounced ?? 0))}\n`);
-    }
-    /**
-     * Looks up a single contact by email address and displays their
-     * status, properties, and pending emails.
-     */
-    async searchContact(email, jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Looking up contact...' }, () => this.apiClient.get(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`));
-        if (!response.ok) {
-            if (response.status === 404) {
-                if (jsonOutput) {
-                    this.log(JSON.stringify({ email, error: 'Contact not found' }, null, 2));
-                }
-                else {
-                    this.log(`\n  Contact '${email}' not found.\n`);
-                }
-                return;
-            }
-            this.handleApiError(response);
-        }
-        const contact = response.data;
-        if (jsonOutput) {
-            this.log(JSON.stringify(contact, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.bold('Email:')}       ${contact.email}`);
-        this.log(`  ${chalk.bold('Status:')}      ${contact.status}`);
-        this.log(`  ${chalk.bold('Added:')}       ${contact.added}`);
-        this.log(`  ${chalk.bold('Next email:')}  ${contact.nextEmail || 'None'}`);
-        if (contact.properties && Object.keys(contact.properties).length > 0) {
-            this.log(`  ${chalk.bold('Properties:')}`);
-            for (const [key, value] of Object.entries(contact.properties)) {
-                this.log(`    ${key}: ${String(value)}`);
-            }
-        }
-        this.log('');
-    }
-    /**
-     * Triggers a CSV export of all contacts. The API returns a download URL
-     * for the generated file.
-     */
-    async exportContacts(jsonOutput) {
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Preparing contact export...' }, () => this.apiClient.get(API_ENDPOINTS.CONTACTS_EXPORT));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        if (jsonOutput) {
-            this.log(JSON.stringify(response.data, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.green('✓')} Contact export started.`);
-        const { downloadUrl, status } = response.data;
-        if (!downloadUrl) {
-            this.log(`\n  Export status: ${status ?? 'unknown'}. No download URL yet.\n`);
-            return;
-        }
-        const fileResult = await this.withApiSpinner({ json: jsonOutput, text: '  Downloading CSV file...' }, () => this.apiClient.getPublicFile(downloadUrl.trim()));
-        if (!fileResult.ok) {
-            this.error(`Download failed: ${fileResult.status} ${fileResult.error ?? ''}\n` +
-                `  URL: ${fileResult.debug.fullUrl}`);
-        }
-        const outputPath = resolve('contacts.csv');
-        await writeFile(outputPath, Buffer.from(fileResult.body));
-        this.log(`\n  ${chalk.green('✓')} Contact export saved to ${chalk.cyan(outputPath)}\n`);
-    }
-    /**
-     * Performs a GDPR-compliant hard delete of a contact and all their
-     * send history. Requires confirmation unless --yes flag is used.
-     */
-    async deleteContact(email, jsonOutput, skipConfirm) {
-        if (!skipConfirm) {
-            const confirmed = await confirm({
-                default: false,
-                message: `Permanently delete ${email} and all their data? This cannot be undone.`,
+            await deleteContact(ctx, {
+                email: flags.delete,
+                json: flags.json,
+                skipConfirm: flags.yes,
             });
-            if (!confirmed) {
-                this.log('\n  Delete cancelled.\n');
-                return;
-            }
-        }
-        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Deleting contact...' }, () => this.apiClient.delete(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`));
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        if (jsonOutput) {
-            this.log(JSON.stringify({ deleted: true, email }, null, 2));
             return;
         }
-        this.log(`\n  ${chalk.green('✓')} Contact ${email} permanently deleted.\n`);
+        await showSummary(ctx, flags.json);
+    }
+    makeCtx() {
+        return {
+            delete: (path) => this.apiClient.delete(path),
+            error: (msg) => this.error(msg),
+            get: (path, params) => this.apiClient.get(path, params),
+            getPublicFile: (url) => this.apiClient.getPublicFile(url),
+            log: (msg) => this.log(msg),
+            onApiError: (r) => this.handleApiError(r),
+            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
+        };
     }
 }

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

@@ -8,37 +8,6 @@ export default class Deploy extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    private fetchDomainVerifyForDeploy;
     run(): Promise<void>;
-    private validateSequence;
-    /**
-     * 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).
-     */
-    private pauseSequence;
-    /**
-     * 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).
-     */
-    private resumeSequence;
-    private updateSequenceStatus;
-    private sequenceStatusPath;
-    private buildDeployPayload;
-    private resolveMonthlyCapForDeploy;
-    private mapEmailToPayload;
-    private buildBrandSection;
-    private buildProductSection;
-    private buildSenderSection;
-    private buildProjectPayload;
-    private confirmDeploy;
-    private ensureDomainReady;
-    private logPreDeploySummary;
-    private logDiff;
-    private logDeploySuccessInstructions;
-    private runDomainSetup;
-    private verifyDomain;
+    private makeCtx;
 }