@mailmodo/cli 0.0.3-beta.pr5.8 → 0.0.3

package/dist/commands/preview/index.js

@@ -1,213 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { createServer } from 'node:http';
-import chalk from 'chalk';
-import open from 'open';
-import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, PREVIEW_PORT } from '../../lib/constants.js';
-import { loadTemplate } from '../../lib/yaml-config.js';
-/* eslint-disable camelcase */
-const SAMPLE_DATA = Object.freeze({
-    app_url: 'https://yourapp.com',
-    cta_url: 'https://yourapp.com/action',
-    first_name: 'Sarah',
-    product_name: 'YourApp',
-    unsubscribe_url: '#',
-});
-/* eslint-enable camelcase */
-/**
- * Replaces all {{variable}} template placeholders in the HTML string
- * with corresponding values from the sample data map.
- *
- * @param {string} html - Raw HTML template with {{variable}} placeholders.
- * @param {Record<string, string>} data - Key-value map of template variable replacements.
- * @returns {string} HTML with all recognized placeholders replaced.
- */
-function renderTemplate(html, data) {
-    return html.replaceAll(/\{\{(\w+)\}\}/g, (match, key) => data[key] || match);
-}
-/**
- * Strips HTML tags and decodes common HTML entities to produce
- * a readable plain text representation of an email.
- *
- * @param {string} html - The HTML content to convert.
- * @returns {string} Plain text with tags removed and entities decoded.
- */
-function htmlToText(html) {
-    return html
-        .replaceAll(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
-        .replaceAll(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
-        .replaceAll(/<br\s*\/?>/gi, '\n')
-        .replaceAll(/<\/p>/gi, '\n\n')
-        .replaceAll(/<\/div>/gi, '\n')
-        .replaceAll(/<\/tr>/gi, '\n')
-        .replaceAll(/<\/li>/gi, '\n')
-        .replaceAll(/<[^>]+>/g, '')
-        .replaceAll('&nbsp;', ' ')
-        .replaceAll('&amp;', '&')
-        .replaceAll('&lt;', '<')
-        .replaceAll('&gt;', '>')
-        .replaceAll('&quot;', '"')
-        .replaceAll(/\n{3,}/g, '\n\n')
-        .trim();
-}
-export default class Preview extends BaseCommand {
-    static args = {
-        id: Args.string({ description: 'Email ID to preview' }),
-    };
-    static description = 'Preview an email in browser, as text, or send a test';
-    static examples = [
-        '<%= config.bin %> preview welcome',
-        '<%= config.bin %> preview welcome --text',
-        '<%= config.bin %> preview welcome --send me@example.com',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        send: Flags.string({ description: 'Send test email to this address' }),
-        text: Flags.boolean({ default: false, description: 'Output plain text version (for AI agents)' }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(Preview);
-        const yamlConfig = await this.ensureYaml();
-        const emailId = args.id || yamlConfig.emails[0]?.id;
-        if (!emailId) {
-            this.error('No emails configured. Run mailmodo init first.');
-        }
-        const email = yamlConfig.emails.find((e) => e.id === emailId);
-        if (!email) {
-            this.error(`Email '${emailId}' not found in mailmodo.yaml.`);
-        }
-        const sampleData = {
-            ...SAMPLE_DATA,
-            app_url: yamlConfig.project?.url || 'https://yourapp.com', // eslint-disable-line camelcase
-            product_name: yamlConfig.project?.name || 'YourApp', // eslint-disable-line camelcase
-        };
-        if (flags.send) {
-            await this.sendTestEmail(emailId, flags.send, flags.json);
-            return;
-        }
-        const templateHtml = await loadTemplate(`${email.id}.html`);
-        if (flags.text) {
-            await this.renderText(email, templateHtml, sampleData, flags.json);
-            return;
-        }
-        await this.startPreviewServer(email, templateHtml, sampleData, flags.json);
-    }
-    /**
-     * Renders a plain text version of the email to stdout. Used by AI agents
-     * and CI pipelines that cannot open a browser.
-     */
-    async renderText(email, templateHtml, sampleData, jsonOutput) {
-        const rendered = templateHtml ? renderTemplate(templateHtml, sampleData) : '';
-        const plainText = htmlToText(rendered);
-        if (jsonOutput) {
-            this.log(JSON.stringify({
-                body: plainText,
-                id: email.id,
-                previewText: email.previewText,
-                subject: email.subject,
-            }, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.bold('SUBJECT:')}  ${email.subject}`);
-        if (email.previewText) {
-            this.log(`  ${chalk.bold('PREVIEW:')}  ${email.previewText}`);
-        }
-        this.log(`\n${plainText}\n`);
-    }
-    /**
-     * Calls the API to send a test email to the specified address.
-     * Before domain verification, tests send via the mailmodo.com domain.
-     */
-    async sendTestEmail(emailId, toAddress, jsonOutput) {
-        await this.ensureAuth();
-        const response = await this.apiClient.post(`${API_ENDPOINTS.PREVIEW}/${emailId}/send`, {
-            to: toAddress,
-        });
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        if (jsonOutput) {
-            this.log(JSON.stringify({ emailId, sentTo: toAddress, status: 'sent' }, null, 2));
-            return;
-        }
-        this.log(`\n  Sending test to ${chalk.cyan(toAddress)}...`);
-        this.log(`  ${chalk.dim('Note: If domain is not yet verified, test sends via mailmodo.com domain.')}`);
-        this.log(`  ${chalk.green('✓')} Sent.\n`);
-    }
-    /**
-     * Starts a local HTTP server on PREVIEW_PORT to serve the rendered email
-     * template, then opens the user's default browser to view it.
-     */
-    async startPreviewServer(email, templateHtml, sampleData, jsonOutput) {
-        const rendered = templateHtml ? renderTemplate(templateHtml, sampleData) : '<p>No template found.</p>';
-        const wrapperHtml = `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8">
-  <title>Preview: ${email.subject}</title>
-  <style>
-    body { margin: 0; padding: 2rem; background: #f5f5f5; font-family: system-ui; }
-    .preview-bar { background: #1a1a2e; color: #fff; padding: 0.75rem 1.5rem; border-radius: 0.5rem;
-      margin-bottom: 1.5rem; display: flex; justify-content: space-between; align-items: center; }
-    .preview-bar h3 { margin: 0; font-size: 0.875rem; }
-    .preview-bar span { font-size: 0.75rem; opacity: 0.7; }
-    .email-frame { background: #fff; max-width: 40rem; margin: 0 auto; border-radius: 0.5rem;
-      box-shadow: 0 0.125rem 0.5rem rgba(0,0,0,0.1); overflow: hidden; }
-    .email-header { padding: 1rem 1.5rem; border-bottom: 1px solid #eee; }
-    .email-header .subject { font-weight: 600; font-size: 1rem; }
-    .email-header .meta { font-size: 0.75rem; color: #666; margin-top: 0.25rem; }
-    .email-body { padding: 1.5rem; }
-  </style>
-</head>
-<body>
-  <div class="preview-bar">
-    <h3>Mailmodo Preview — ${email.id}</h3>
-    <span>Style: ${email.style || 'branded'} · Press Ctrl+C in terminal to stop</span>
-  </div>
-  <div class="email-frame">
-    <div class="email-header">
-      <div class="subject">${email.subject}</div>
-      <div class="meta">To: ${sampleData.first_name} · From: ${sampleData.product_name}</div>
-    </div>
-    <div class="email-body">${rendered}</div>
-  </div>
-</body>
-</html>`;
-        if (jsonOutput) {
-            this.log(JSON.stringify({
-                id: email.id,
-                style: email.style || 'branded',
-                url: `http://localhost:${PREVIEW_PORT}`,
-            }, null, 2));
-        }
-        const server = createServer((_req, res) => {
-            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-            res.end(wrapperHtml);
-        });
-        await new Promise((resolve) => {
-            server.listen(PREVIEW_PORT, () => resolve());
-        });
-        const url = `http://localhost:${PREVIEW_PORT}`;
-        if (!jsonOutput) {
-            this.log(`\n  Style: ${chalk.cyan(email.style || 'branded')}`);
-            this.log(`  Preview server at ${chalk.cyan(url)}`);
-            this.log(`  Opening in browser...\n`);
-            this.log(`  ${chalk.dim('Press Ctrl+C to stop the preview server.')}\n`);
-        }
-        try {
-            await open(url);
-        }
-        catch {
-            if (!jsonOutput) {
-                this.log(`  ${chalk.dim('Could not open browser. Visit the URL above manually.')}`);
-            }
-        }
-        await new Promise((resolve) => {
-            const shutdown = () => {
-                server.close(() => resolve());
-            };
-            process.on('SIGINT', shutdown);
-            process.on('SIGTERM', shutdown);
-        });
-    }
-}

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

@@ -1,19 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class Settings extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        set: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    /**
-     * 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.
-     */
-    private handleLogoUpload;
-}

package/dist/commands/settings/index.js

@@ -1,147 +0,0 @@
-import { Flags } from '@oclif/core';
-import { input, select } from '@inquirer/prompts';
-import chalk from 'chalk';
-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 { saveYaml } from '../../lib/yaml-config.js';
-const SETTINGS_GROUPS = Object.freeze({
-    billing: ['monthly_cap'],
-    brand: ['email_style', 'brand_color', 'logo_url', 'logo_file'],
-    domain: ['domain', 'address'],
-    identity: ['from_name', 'from_email', 'reply_to'],
-    integrations: ['webhook_url'],
-});
-/**
- * Converts a user-facing snake_case YAML setting key to its
- * corresponding camelCase TypeScript property name.
- *
- * @param {string} key - A snake_case setting key (e.g., "brand_color").
- * @returns {string} The camelCase property name (e.g., "brandColor").
- */
-function settingKeyToProp(key) {
-    return key.replaceAll(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-}
-export default class Settings extends BaseCommand {
-    static description = 'View and update project settings';
-    static examples = [
-        '<%= config.bin %> settings',
-        '<%= config.bin %> settings --set brand_color=#0F3460',
-        '<%= config.bin %> settings --json',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        set: Flags.string({ description: 'Set a setting (format: key=value)' }),
-    };
-    async run() {
-        const { flags } = await this.parse(Settings);
-        const yamlConfig = await this.ensureYaml();
-        const { project } = yamlConfig;
-        if (flags.set) {
-            const eqIndex = flags.set.indexOf('=');
-            if (eqIndex === -1) {
-                this.error('Invalid format. Use --set key=value (e.g., --set brand_color=#0F3460)');
-            }
-            const key = flags.set.slice(0, eqIndex).trim();
-            const propKey = settingKeyToProp(key);
-            const value = flags.set.slice(eqIndex + 1).trim();
-            if (!(propKey in project)) {
-                this.error(`Unknown setting: ${key}`);
-            }
-            project[propKey] = propKey === 'monthlyCap' ? Number(value) : value;
-            await saveYaml(yamlConfig);
-            if (flags.json) {
-                this.log(JSON.stringify({ [propKey]: value, status: 'updated' }, null, 2));
-                return;
-            }
-            this.log(`\n  ${chalk.green('✓')} ${key} updated to ${chalk.cyan(value)}`);
-            this.log(`  Run ${chalk.cyan("'mailmodo deploy'")} to apply.\n`);
-            return;
-        }
-        if (flags.json) {
-            this.log(JSON.stringify({ settings: project }, null, 2));
-            return;
-        }
-        this.log(`\n  Current settings for ${chalk.bold(project.name || 'project')}:\n`);
-        for (const [group, keys] of Object.entries(SETTINGS_GROUPS)) {
-            this.log(`  ${chalk.bold(group.charAt(0).toUpperCase() + group.slice(1))}`);
-            this.log(`  ${'─'.repeat(49)}`);
-            for (const key of keys) {
-                const propKey = settingKeyToProp(key);
-                const value = project[propKey];
-                const displayValue = value ? String(value) : chalk.dim('(not set)');
-                this.log(`  ${key.padEnd(16)} ${displayValue}`);
-            }
-            this.log('');
-        }
-        if (!flags.yes) {
-            const editKey = await input({
-                default: 'n',
-                message: "Edit a setting? (key or 'n'):",
-            });
-            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);
-                    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`);
-            }
-        }
-    }
-    /**
-     * 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.
-     */
-    async handleLogoUpload(yamlConfig) {
-        const logoPath = await input({ message: 'Path to logo file:' });
-        const resolvedPath = resolve(logoPath);
-        if (!existsSync(resolvedPath)) {
-            this.log(`\n  File not found: ${resolvedPath}\n`);
-            return;
-        }
-        await this.ensureAuth();
-        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.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData);
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        yamlConfig.project.logoUrl = response.data?.url || '';
-        yamlConfig.project.logoFile = logoPath;
-        await saveYaml(yamlConfig);
-        this.log(`\n  Logo uploaded and hosted at:`);
-        this.log(`  ${chalk.cyan(String(response.data?.url))}`);
-        this.log(`  Run ${chalk.cyan("'mailmodo deploy'")} to apply to all branded emails.\n`);
-    }
-}

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

@@ -1,10 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class Status extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/status/index.js

@@ -1,53 +0,0 @@
-import chalk from 'chalk';
-import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS } from '../../lib/constants.js';
-export default class Status extends BaseCommand {
-    static description = 'View email performance metrics and quota usage';
-    static examples = [
-        '<%= config.bin %> status',
-        '<%= config.bin %> status --json',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-    };
-    async run() {
-        const { flags } = await this.parse(Status);
-        await this.ensureAuth();
-        const response = await this.apiClient.get(API_ENDPOINTS.ANALYTICS);
-        if (!response.ok) {
-            this.handleApiError(response);
-        }
-        const { emails, monthlySent, quota } = response.data;
-        if (flags.json) {
-            this.log(JSON.stringify(response.data, null, 2));
-            return;
-        }
-        this.log(`\n  ${chalk.bold('Last 7 days')}${''.padEnd(20)}Sent   Open   Click   Conv`);
-        this.log(`  ${'─'.repeat(62)}`);
-        if (emails?.length) {
-            for (const metric of emails) {
-                const id = (metric.emailId || '').padEnd(30);
-                const sent = String(metric.sent ?? 0).padEnd(7);
-                const openRate = (metric.open || '0%').padEnd(7);
-                const clickRate = (metric.click || '0%').padEnd(8);
-                const convRate = metric.conv || '0%';
-                this.log(`  ${id}${sent}${openRate}${clickRate}${convRate}`);
-            }
-        }
-        else {
-            this.log(`  ${chalk.dim('No data yet. Deploy emails first.')}`);
-        }
-        this.log('');
-        this.log(`  Emails sent this month:  ${chalk.bold(String(monthlySent ?? 0))}`);
-        if (quota) {
-            if (quota.freeRemaining > 0) {
-                this.log(`  Free tier remaining:     ${chalk.cyan(String(quota.freeRemaining))}`);
-            }
-            else if (quota.blocksUsed !== undefined) {
-                this.log(`  Current paid block:      ${chalk.cyan(`${quota.currentBlockRemaining ?? 0} / 10,000 used`)}`);
-                this.log(`  Blocks purchased:        ${quota.blocksUsed}`);
-            }
-        }
-        this.log('');
-    }
-}

package/dist/lib/api-client.d.ts

@@ -1,41 +0,0 @@
-export interface ApiResponse<T = Record<string, unknown>> {
-    data: T;
-    error?: string;
-    ok: boolean;
-    status: number;
-}
-/**
- * HTTP client for the Mailmodo CLI API.
- * Wraps the native fetch API with Bearer token authentication,
- * consistent error handling, and typed responses.
- *
- * All requests include:
- * - Authorization header with the user's API key
- * - Content-Type: application/json
- * - User-Agent: @mailmodo/cli
- *
- * Network errors (ECONNREFUSED, ENOTFOUND) return a friendly message
- * indicating the API may not be available, rather than a raw stack trace.
- */
-export declare class ApiClient {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string);
-    /**
-     * Sends an HTTP request to the Mailmodo API and returns a typed response.
-     *
-     * @template T - The expected shape of the response body on success.
-     * @param {string} method - HTTP method (GET, POST, PATCH, DELETE).
-     * @param {string} path - API endpoint path relative to base URL (e.g., '/auth/validate').
-     * @param {Record<string, unknown> | unknown} [body] - JSON-serializable request body for POST/PATCH.
-     * @param {Record<string, string>} [params] - URL query parameters appended to the request URL.
-     * @returns {Promise<ApiResponse<T>>} Response object with ok (boolean), status (HTTP code),
-     *   data (parsed JSON body), and optional error (string message on failure).
-     */
-    private request;
-    delete<T = Record<string, unknown>>(path: string): Promise<ApiResponse<T>>;
-    get<T = Record<string, unknown>>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
-    patch<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
-    post<T = Record<string, unknown>>(path: string, body?: Record<string, unknown> | unknown): Promise<ApiResponse<T>>;
-    postFormData<T = Record<string, unknown>>(path: string, formData: FormData): Promise<ApiResponse<T>>;
-}

package/dist/lib/api-client.js

@@ -1,125 +0,0 @@
-import { API_BASE_URL } from './constants.js';
-/**
- * HTTP client for the Mailmodo CLI API.
- * Wraps the native fetch API with Bearer token authentication,
- * consistent error handling, and typed responses.
- *
- * All requests include:
- * - Authorization header with the user's API key
- * - Content-Type: application/json
- * - User-Agent: @mailmodo/cli
- *
- * Network errors (ECONNREFUSED, ENOTFOUND) return a friendly message
- * indicating the API may not be available, rather than a raw stack trace.
- */
-export class ApiClient {
-    apiKey;
-    baseUrl;
-    constructor(apiKey) {
-        this.baseUrl = API_BASE_URL;
-        this.apiKey = apiKey;
-    }
-    /**
-     * Sends an HTTP request to the Mailmodo API and returns a typed response.
-     *
-     * @template T - The expected shape of the response body on success.
-     * @param {string} method - HTTP method (GET, POST, PATCH, DELETE).
-     * @param {string} path - API endpoint path relative to base URL (e.g., '/auth/validate').
-     * @param {Record<string, unknown> | unknown} [body] - JSON-serializable request body for POST/PATCH.
-     * @param {Record<string, string>} [params] - URL query parameters appended to the request URL.
-     * @returns {Promise<ApiResponse<T>>} Response object with ok (boolean), status (HTTP code),
-     *   data (parsed JSON body), and optional error (string message on failure).
-     */
-    async request(method, path, body, params) {
-        const url = new URL(`${this.baseUrl}${path}`);
-        if (params) {
-            for (const [key, value] of Object.entries(params)) {
-                url.searchParams.set(key, value);
-            }
-        }
-        const headers = {
-            'Authorization': `Bearer ${this.apiKey}`,
-            'Content-Type': 'application/json',
-            'User-Agent': '@mailmodo/cli',
-        };
-        try {
-            const response = await fetch(url.toString(), {
-                body: body ? JSON.stringify(body) : undefined,
-                headers,
-                method,
-            });
-            const data = await response.json().catch(() => ({}));
-            if (!response.ok) {
-                const errorData = data;
-                return {
-                    data: data,
-                    error: errorData?.message ||
-                        errorData?.error ||
-                        `Request failed with status ${response.status}`,
-                    ok: false,
-                    status: response.status,
-                };
-            }
-            return { data: data, ok: true, status: response.status };
-        }
-        catch (error) {
-            const err = error;
-            const isConnectionError = err?.cause?.code === 'ECONNREFUSED' || err?.cause?.code === 'ENOTFOUND';
-            return {
-                data: {},
-                error: isConnectionError
-                    ? 'Cannot connect to Mailmodo API. The API service may not be available yet.'
-                    : (err?.message || 'An unexpected network error occurred.'),
-                ok: false,
-                status: 0,
-            };
-        }
-    }
-    async delete(path) {
-        return this.request('DELETE', path);
-    }
-    async get(path, params) {
-        return this.request('GET', path, undefined, params);
-    }
-    async patch(path, body) {
-        return this.request('PATCH', path, body);
-    }
-    async post(path, body) {
-        return this.request('POST', path, body);
-    }
-    async postFormData(path, formData) {
-        const url = new URL(`${this.baseUrl}${path}`);
-        try {
-            const response = await fetch(url.toString(), {
-                body: formData,
-                headers: {
-                    'Authorization': `Bearer ${this.apiKey}`,
-                    'User-Agent': '@mailmodo/cli',
-                },
-                method: 'POST',
-            });
-            const data = await response.json().catch(() => ({}));
-            if (!response.ok) {
-                const errorData = data;
-                return {
-                    data: data,
-                    error: errorData?.message ||
-                        errorData?.error ||
-                        `Upload failed with status ${response.status}`,
-                    ok: false,
-                    status: response.status,
-                };
-            }
-            return { data: data, ok: true, status: response.status };
-        }
-        catch (error) {
-            const err = error;
-            return {
-                data: {},
-                error: err?.message || 'File upload failed.',
-                ok: false,
-                status: 0,
-            };
-        }
-    }
-}

package/dist/lib/base-command.d.ts

@@ -1,45 +0,0 @@
-import { Command } from '@oclif/core';
-import { ApiClient } from './api-client.js';
-import { type MailmodoConfig } from './config.js';
-import { type MailmodoYaml } from './yaml-config.js';
-/**
- * Abstract base command providing shared functionality for all Mailmodo CLI commands.
- * Subclasses inherit --json and --yes base flags, authentication enforcement,
- * YAML config loading, and consistent API error handling.
- */
-export declare abstract class BaseCommand extends Command {
-    static baseFlags: {
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    protected apiClient: ApiClient;
-    /**
-     * Validates that the user is authenticated and initializes the API client.
-     * Checks MAILMODO_API_KEY environment variable first (for AI agent usage),
-     * then falls back to ~/.mailmodo/config.
-     * Exits with an error if no valid API key is found.
-     *
-     * @returns {Promise<MailmodoConfig>} The resolved configuration containing the API key.
-     */
-    protected ensureAuth(): Promise<MailmodoConfig>;
-    /**
-     * Loads and returns the mailmodo.yaml configuration from the current directory.
-     * Exits with an error if the file is not found, directing the user to run init.
-     *
-     * @returns {Promise<MailmodoYaml>} The parsed mailmodo.yaml containing project
-     *   settings and all email sequence definitions.
-     */
-    protected ensureYaml(): Promise<MailmodoYaml>;
-    /**
-     * Handles a failed API response by mapping HTTP status codes to
-     * user-friendly error messages and exiting the process.
-     *
-     * @param {{ status: number; error?: string }} response - The API response object with ok=false.
-     *   Status 401 prompts re-authentication, 429 indicates rate limiting,
-     *   all others display the server's error message or a generic fallback.
-     */
-    protected handleApiError(response: {
-        error?: string;
-        status: number;
-    }): never;
-}