@mailmodo/cli 0.0.21-beta.pr24.38 → 0.0.22

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

@@ -6,9 +6,14 @@ export default class Deploy extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    /**
+     * Fetches current DNS verification status for the deploy flow.
+     *
+     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
+     * @param domain - Sending domain to check. If empty, request will fail and trigger setup flow.
+     */
     private fetchDomainVerifyForDeploy;
     run(): Promise<void>;
-    private validateSequence;
     private buildDeployPayload;
     private mapEmailToPayload;
     private buildBrandSection;
@@ -17,11 +22,32 @@ export default class Deploy extends BaseCommand {
     private buildProjectPayload;
     private confirmDeploy;
     private ensureDomainReady;
+    /**
+     * Lists emails about to be deployed (skipped when `--json` is set).
+     *
+     * @param yamlConfig - Loaded project YAML.
+     * @param jsonOutput - When true, skip human-readable output.
+     */
     private logPreDeploySummary;
-    private logDiff;
+    /**
+     * Prints the post-deploy success message and SDK install snippet for interactive runs.
+     */
     private logDeploySuccessInstructions;
+    /**
+     * Interactive domain setup flow. Collects domain, sender email, and business
+     * address from the user, then calls the API to get DNS records to configure.
+     * Polls for verification when the user indicates they've added the records.
+     *
+     * @returns {Promise<boolean>} true if domain was verified, false if skipped.
+     */
     private runDomainSetup;
     private collectDomainInputs;
     private showDnsRecords;
+    /**
+     * Calls the domain verification API endpoint and reports pass/fail
+     * status for each DNS record (DKIM, DMARC, Return-Path).
+     *
+     * @returns {Promise<boolean>} true if all records pass.
+     */
     private verifyDomain;
 }

package/dist/commands/deploy/index.js

@@ -12,6 +12,12 @@ export default class Deploy extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
     };
+    /**
+     * Fetches current DNS verification status for the deploy flow.
+     *
+     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
+     * @param domain - Sending domain to check. If empty, request will fail and trigger setup flow.
+     */
     fetchDomainVerifyForDeploy(jsonOutput, domain) {
         return this.withApiSpinner({ json: jsonOutput, text: '  Checking domain verification...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
             domain: domain || '',
@@ -24,12 +30,11 @@ export default class Deploy extends BaseCommand {
         const domainReady = await this.ensureDomainReady(yamlConfig, flags);
         if (!domainReady)
             return;
-        const payload = await this.buildDeployPayload(yamlConfig);
-        const validateResult = await this.validateSequence(payload, flags);
-        this.logPreDeploySummary(yamlConfig, validateResult, flags.json);
+        this.logPreDeploySummary(yamlConfig, flags.json);
         const confirmed = await this.confirmDeploy(yamlConfig, flags);
         if (!confirmed)
             return;
+        const payload = await this.buildDeployPayload(yamlConfig);
         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);
@@ -46,19 +51,6 @@ export default class Deploy extends BaseCommand {
         }
         this.logDeploySuccessInstructions(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(`Sending domain not registered. Run: ${chalk.cyan('mailmodo domain')}`);
-            }
-            if (response.data.error === 'senderDomainNotVerified') {
-                this.error(`Sending domain not verified. Run: ${chalk.cyan('mailmodo domain --verify')}`);
-            }
-            this.handleApiError(response);
-        }
-        return response.data;
-    }
     async buildDeployPayload(yamlConfig) {
         const emailsWithHtml = await Promise.all(yamlConfig.emails.map(async (email) => {
             const html = (await loadTemplate(`${email.id}.html`)) || '';
@@ -72,7 +64,7 @@ export default class Deploy extends BaseCommand {
     mapEmailToPayload(email) {
         return {
             condition: email.condition || null,
-            ctaText: email.ctaText || '',
+            ctaText: '',
             delay: typeof email.delay === 'string'
                 ? Number.parseInt(email.delay, 10) || 0
                 : email.delay,
@@ -94,11 +86,11 @@ export default class Deploy extends BaseCommand {
     buildProductSection(project) {
         return {
             businessType: project?.type || '',
-            description: project?.description || '',
-            pricingModel: project?.pricingModel || '',
+            description: '',
+            pricingModel: '',
             productName: project?.name || '',
-            saasModel: project?.saasModel || '',
-            targetUser: project?.targetUser || '',
+            saasModel: '',
+            targetUser: '',
             url: project?.url || '',
         };
     }
@@ -158,41 +150,25 @@ export default class Deploy extends BaseCommand {
         }
         return this.runDomainSetup(yamlConfig, flags);
     }
-    logPreDeploySummary(yamlConfig, validateResult, jsonOutput) {
+    /**
+     * Lists emails about to be deployed (skipped when `--json` is set).
+     *
+     * @param yamlConfig - Loaded project YAML.
+     * @param jsonOutput - When true, skip human-readable output.
+     */
+    logPreDeploySummary(yamlConfig, 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(`  Deploying:`);
+        for (const email of yamlConfig.emails) {
+            this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
         }
         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`)}`);
-        }
-    }
+    /**
+     * Prints the post-deploy success message and SDK install snippet for interactive runs.
+     */
     logDeploySuccessInstructions(sdkSnippet) {
         this.log(`  ${chalk.green('Deployed.')} Emails are live.\n`);
         this.log(`  ${'─'.repeat(53)}`);
@@ -209,6 +185,13 @@ export default class Deploy extends BaseCommand {
         this.log(`  Full SDK docs: ${chalk.cyan('mailmodo.com/docs/sdk')}\n`);
         this.log(`  ${'─'.repeat(53)}\n`);
     }
+    /**
+     * Interactive domain setup flow. Collects domain, sender email, and business
+     * address from the user, then calls the API to get DNS records to configure.
+     * Polls for verification when the user indicates they've added the records.
+     *
+     * @returns {Promise<boolean>} true if domain was verified, false if skipped.
+     */
     async runDomainSetup(yamlConfig, flags) {
         const { address, domain, senderEmail } = await this.collectDomainInputs(yamlConfig, flags);
         const domainResponse = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, {
@@ -277,6 +260,12 @@ export default class Deploy extends BaseCommand {
         this.log(`  DNS changes take 5–30 minutes to propagate.`);
         this.log(`  Full guide: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
     }
+    /**
+     * Calls the domain verification API endpoint and reports pass/fail
+     * status for each DNS record (DKIM, DMARC, Return-Path).
+     *
+     * @returns {Promise<boolean>} true if all records pass.
+     */
     async verifyDomain(jsonOutput, domain) {
         const verify = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY, {
             domain,

package/dist/commands/domain/index.js

@@ -179,7 +179,7 @@ export default class Domain extends BaseCommand {
         this.log(`  Spam rate:   ${data.spamRate ?? 'N/A'}%\n`);
     }
     recordLabel(index) {
-        const labels = ['DKIM', 'DMARC', 'Return Path'];
+        const labels = ['SPF', 'DKIM', 'DMARC'];
         return labels[index] || `Record ${index + 1}`;
     }
 }

package/dist/commands/edit/index.js

@@ -194,8 +194,6 @@ export default class Edit extends BaseCommand {
             email.subject = updated.subject;
         if (updated.previewText)
             email.previewText = updated.previewText;
-        if (updated.ctaText)
-            email.ctaText = updated.ctaText;
         const updatedYaml = {
             ...yamlConfig,
             emails: [...yamlConfig.emails],

package/dist/commands/init/index.js

@@ -128,7 +128,6 @@ export default class Init extends BaseCommand {
                 ...(generated?.previewText
                     ? { previewText: generated.previewText }
                     : {}),
-                ...(generated?.ctaText ? { ctaText: generated.ctaText } : {}),
                 goal: rec.goal,
             };
         });
@@ -136,18 +135,14 @@ export default class Init extends BaseCommand {
             emails: emailConfigs,
             project: {
                 brandColor: analysisPayload.brand?.color || DEFAULT_BRAND_COLOR,
-                description: analysisPayload.description,
                 emailStyle: 'branded',
                 fromEmail: '',
                 fromName: `Team ${analysisPayload.productName}`,
                 logoUrl: analysisPayload.brand?.logoUrl || '',
                 monthlyCap: DEFAULT_MONTHLY_CAP,
                 name: analysisPayload.productName,
-                pricingModel: analysisPayload.pricingModel,
                 replyTo: '',
-                saasModel: analysisPayload.saasModel,
-                targetUser: analysisPayload.targetUser,
-                type: analysisPayload.businessType,
+                type: analysisPayload.pricingModel,
                 url: productUrl,
                 webhookUrl: '',
             },

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

@@ -5,6 +5,8 @@ export default class Logs extends BaseCommand {
     static flags: {
         email: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         failed: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/logs/index.js

@@ -17,11 +17,22 @@ export default class Logs extends BaseCommand {
             default: false,
             description: 'Show only failed/bounced events',
         }),
+        limit: Flags.integer({
+            default: 50,
+            description: 'Entries per page (max 200)',
+        }),
+        page: Flags.integer({
+            default: 1,
+            description: 'Page number',
+        }),
     };
     async run() {
         const { flags } = await this.parse(Logs);
         await this.ensureAuth();
-        const params = {};
+        const params = {
+            limit: String(flags.limit),
+            page: String(flags.page),
+        };
         if (flags.email)
             params.email = flags.email;
         if (flags.failed)
@@ -30,7 +41,7 @@ export default class Logs extends BaseCommand {
         if (!response.ok) {
             this.handleApiError(response);
         }
-        const { entries } = response.data;
+        const { entries, limit, page, total } = response.data;
         if (flags.json) {
             this.log(JSON.stringify(response.data, null, 2));
             return;
@@ -49,6 +60,11 @@ export default class Logs extends BaseCommand {
                     this.log(`  ${' '.repeat(52)}${chalk.dim(`(reason: ${entry.reason})`)}`);
                 }
             }
+            const totalPages = Math.ceil(total / limit);
+            this.log(`\n  Page ${page} of ${totalPages}  ·  ${total} total entries`);
+            if (page < totalPages) {
+                this.log(`  ${chalk.dim(`Next: --page ${page + 1}`)}`);
+            }
         }
         else {
             this.log(`  ${chalk.dim('No log entries found.')}`);

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

@@ -8,6 +8,8 @@ export default class Settings extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private applySetFlag;
+    private displaySettingsGroup;
     /**
      * Prompts the user to pick a setting key to edit and dispatches
      * to the appropriate handler for that key.

package/dist/commands/settings/index.js

@@ -43,73 +43,85 @@ export default class Settings extends BaseCommand {
     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`);
+            await this.applySetFlag(flags.set, yamlConfig, flags.json ?? false);
             return;
         }
         if (flags.json) {
-            this.log(JSON.stringify({ settings: project }, null, 2));
+            this.log(JSON.stringify({ settings: yamlConfig.project }, null, 2));
             return;
         }
-        const domainVerified = await this.fetchDomainVerified(project.domain);
-        this.log(`\n  Current settings for ${chalk.bold(project.name || 'project')}:\n`);
+        const domainVerified = await this.fetchDomainVerified(yamlConfig.project.domain);
+        this.log(`\n  Current settings for ${chalk.bold(yamlConfig.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.displaySettingsGroup(group, keys, yamlConfig.project, domainVerified);
+        }
+        if (!flags.yes) {
+            await this.promptEditSetting(yamlConfig);
+        }
+    }
+    async applySetFlag(setFlag, yamlConfig, isJson) {
+        const { project } = yamlConfig;
+        const eqIndex = setFlag.indexOf('=');
+        if (eqIndex === -1) {
+            this.error('Invalid format. Use --set key=value (e.g., --set brand_color=#0F3460)');
+        }
+        const key = setFlag.slice(0, eqIndex).trim();
+        const propKey = settingKeyToProp(key);
+        const value = setFlag.slice(eqIndex + 1).trim();
+        if (!(propKey in project) && key !== 'logo_file') {
+            this.error(`Unknown setting: ${key}`);
+        }
+        project[propKey] =
+            propKey === 'monthlyCap' ? Number(value) : value;
+        await saveYaml(yamlConfig);
+        if (isJson) {
+            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`);
+    }
+    displaySettingsGroup(group, keys, project, domainVerified) {
+        const availableKeys = keys.filter((key) => {
+            if (group === 'brand' && key === 'logo_file')
+                return true;
+            return settingKeyToProp(key) in project;
+        });
+        const groupTitle = `  ${chalk.bold(group.charAt(0).toUpperCase() + group.slice(1))}`;
+        if (availableKeys.length === 0) {
+            const hint = SETUP_HINTS[settingKeyToProp(keys[0])];
+            if (hint) {
+                this.log(groupTitle);
+                this.log(`  ${'─'.repeat(49)}`);
+                this.log(`  ${chalk.dim(`Run ${hint} to configure.`)}`);
+                this.log('');
             }
-            this.log(`  ${chalk.bold(group.charAt(0).toUpperCase() + group.slice(1))}`);
-            this.log(`  ${'─'.repeat(49)}`);
-            for (const key of availableKeys) {
-                const propKey = settingKeyToProp(key);
-                const value = project[propKey];
-                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}`);
+            return;
+        }
+        this.log(groupTitle);
+        this.log(`  ${'─'.repeat(49)}`);
+        for (const key of availableKeys) {
+            const propKey = settingKeyToProp(key);
+            const value = project[propKey];
+            let displayValue = value ? String(value) : chalk.dim('(not set)');
+            if (key === 'domain' && value && domainVerified === true) {
+                displayValue += `  ${chalk.green('✓ verified')}`;
             }
-            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)`)}`);
-                }
+            else if (key === 'domain' && value && domainVerified === false) {
+                displayValue += `  ${chalk.red('✗ not verified')}`;
             }
-            this.log('');
+            this.log(`  ${key.padEnd(16)} ${displayValue}`);
         }
-        if (!flags.yes) {
-            await this.promptEditSetting(yamlConfig);
+        const missingKeys = keys.filter((key) => !(settingKeyToProp(key) in project) &&
+            !(group === 'brand' && key === 'logo_file'));
+        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('');
     }
     /**
      * Prompts the user to pick a setting key to edit and dispatches
@@ -125,6 +137,10 @@ export default class Settings extends BaseCommand {
             return;
         const editPropKey = settingKeyToProp(editKey);
         if (!(editPropKey in project)) {
+            if (editKey === 'logo_file') {
+                await this.handleLogoUpload(yamlConfig);
+                return;
+            }
             const hint = SETUP_HINTS[editPropKey];
             if (hint) {
                 this.log(`\n  ${editKey} is not configured yet. Run ${chalk.cyan(hint)} to set it up.\n`);
@@ -233,7 +249,7 @@ export default class Settings extends BaseCommand {
         this.log(`  Help: ${chalk.cyan(DNS_GUIDE_URL)}\n`);
     }
     recordLabel(index) {
-        const labels = ['DKIM', 'DMARC', 'Return Path'];
+        const labels = ['SPF', 'DKIM', 'DMARC'];
         return labels[index] || `Record ${index + 1}`;
     }
     /**
@@ -252,8 +268,16 @@ export default class Settings extends BaseCommand {
         }
         await this.ensureAuth();
         const fileBuffer = await readFile(resolvedPath);
+        const ext = resolvedPath.split('.').pop()?.toLowerCase();
+        const mimeTypes = {
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            svg: 'image/svg+xml',
+        };
+        const mimeType = mimeTypes[ext ?? ''] ?? 'application/octet-stream';
         const formData = new FormData();
-        formData.append('logo', new Blob([new Uint8Array(fileBuffer)]), logoPath.split(/[/\\]/).pop() || 'logo.png');
+        formData.append('logo', new Blob([new Uint8Array(fileBuffer)], { type: mimeType }), logoPath.split(/[/\\]/).pop() || 'logo.png');
         const response = await this.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData);
         if (!response.ok) {
             this.handleApiError(response);

package/dist/lib/yaml-config.d.ts

@@ -1,6 +1,5 @@
 export interface EmailConfig {
     condition?: string;
-    ctaText?: string;
     delay: number | string;
     goal?: string;
     id: string;
@@ -13,7 +12,6 @@ export interface EmailConfig {
 export interface ProjectConfig {
     address?: string;
     brandColor?: string;
-    description?: string;
     domain?: string;
     emailStyle?: 'branded' | 'plain';
     fromEmail?: string;
@@ -22,10 +20,7 @@ export interface ProjectConfig {
     logoUrl?: string;
     monthlyCap?: number;
     name?: string;
-    pricingModel?: string;
     replyTo?: string;
-    saasModel?: string;
-    targetUser?: string;
     type?: string;
     url?: string;
     webhookUrl?: string;

package/oclif.manifest.json

@@ -342,12 +342,13 @@
         "index.js"
       ]
     },
-    "logout": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "Sign out by removing saved credentials from this machine",
+      "description": "Authenticate with Mailmodo using your API key",
       "examples": [
-        "<%= config.bin %> logout"
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=mm_live_xxx <%= config.bin %> login"
       ],
       "flags": {
         "json": {
@@ -366,7 +367,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logout",
+      "id": "login",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -376,19 +377,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "logout",
+        "login",
         "index.js"
       ]
     },
-    "logs": {
+    "logout": {
       "aliases": [],
       "args": {},
-      "description": "View email send logs and delivery events",
+      "description": "Sign out by removing saved credentials from this machine",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> logout"
       ],
       "flags": {
         "json": {
@@ -403,24 +401,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "email": {
-          "description": "Filter logs by contact email",
-          "name": "email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "failed": {
-          "description": "Show only failed/bounced events",
-          "name": "failed",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs",
+      "id": "logout",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -430,17 +415,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "logout",
         "index.js"
       ]
     },
-    "login": {
+    "logs": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Mailmodo using your API key",
+      "description": "View email send logs and delivery events",
       "examples": [
-        "<%= config.bin %> login",
-        "MAILMODO_API_KEY=mm_live_xxx <%= config.bin %> login"
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs --email sarah@example.com",
+        "<%= config.bin %> logs --failed",
+        "<%= config.bin %> logs --json"
       ],
       "flags": {
         "json": {
@@ -455,11 +442,40 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "email": {
+          "description": "Filter logs by contact email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "failed": {
+          "description": "Show only failed/bounced events",
+          "name": "failed",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Entries per page (max 200)",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "login",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -469,7 +485,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "login",
+        "logs",
         "index.js"
       ]
     },
@@ -618,5 +634,5 @@
       ]
     }
   },
-  "version": "0.0.21-beta.pr24.38"
+  "version": "0.0.22"
 }

package/package.json

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