@mailmodo/cli 0.0.48 → 0.0.49-beta.pr51.78

package/dist/commands/edit/index.js

@@ -49,6 +49,7 @@ export default class Edit extends BaseCommand {
     async runEditStep(ctx, changeDescription, flags) {
         const response = await this.withApiSpinner({ json: flags.json, text: '  Applying AI edits...' }, () => this.callEditApi(changeDescription, ctx.email, ctx.templateHtml));
         if (!response.ok) {
+            this.handleAiQuotaError(response, 'edit');
             this.handleApiError(response);
         }
         const updated = response.data;

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

@@ -8,5 +8,6 @@ export default class Init extends BaseCommand {
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private persistMonthlyCap;
     private confirmOverwriteIfNeeded;
 }

package/dist/commands/init/index.js

@@ -64,6 +64,7 @@ export default class Init extends BaseCommand {
             url: productUrl,
         }));
         if (!analysisResponse.ok) {
+            this.handleAiQuotaError(analysisResponse, 'init');
             this.handleApiError(analysisResponse);
         }
         const analysis = analysisResponse.data;
@@ -154,12 +155,7 @@ export default class Init extends BaseCommand {
             },
         };
         await saveYaml(yamlConfig);
-        const billingStatus = await this.fetchBillingStatus();
-        const monthlyCap = billingStatus?.cap?.inBlocks;
-        if (monthlyCap !== null && monthlyCap !== undefined) {
-            yamlConfig.project.monthlyCap = monthlyCap;
-            await saveYaml(yamlConfig);
-        }
+        await this.persistMonthlyCap(yamlConfig);
         const templateSaves = analysisPayload.recommendedEmails.flatMap((rec, index) => {
             const generated = generatedEmails[index];
             const saves = [];
@@ -184,6 +180,14 @@ export default class Init extends BaseCommand {
         this.log(`  Created ${chalk.green('mailmodo.yaml')} + ${chalk.green(String(emailConfigs.length))} email templates in ${chalk.green('/mailmodo')}\n`);
         this.log(`  Run ${chalk.cyan("'mailmodo emails'")} to review.\n`);
     }
+    async persistMonthlyCap(yamlConfig) {
+        const billingStatus = await this.fetchBillingStatus();
+        const monthlyCap = billingStatus?.cap?.inBlocks;
+        if (monthlyCap !== null && monthlyCap !== undefined) {
+            yamlConfig.project.monthlyCap = monthlyCap;
+            await saveYaml(yamlConfig);
+        }
+    }
     async confirmOverwriteIfNeeded(flags) {
         const existing = await loadYaml();
         if (!existing)

package/dist/commands/logs/index.js

@@ -57,7 +57,8 @@ export default class Logs extends BaseCommand {
                 const contact = entry.contact || '';
                 this.log(`  ${time}${templateId}${status}${contact}`);
                 if (entry.reason) {
-                    this.log(`  ${' '.repeat(52)}${chalk.dim(`(reason: ${entry.reason})`)}`);
+                    const label = entry.status === 'skipped' ? 'condition not met' : 'reason';
+                    this.log(`  ${' '.repeat(52)}${chalk.dim(`(${label}: ${entry.reason})`)}`);
                 }
             }
             const totalPages = Math.ceil(total / limit);

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

@@ -2,6 +2,11 @@ import { Command } from '@oclif/core';
 import { ApiClient, type ApiRequestDebugInfo } from './api-client.js';
 import { type MailmodoConfig } from './config.js';
 import { type MailmodoYaml } from './yaml-config.js';
+/**
+ * Kind of AI quota that was exhausted. Drives both the headline default
+ * message and the follow-up tip pointing the user at the next-best action.
+ */
+export type AiQuotaFeature = 'edit' | 'init';
 export interface BillingCapUpdateResult {
     autoChargeBlockCount?: number;
     capBlocks: number;
@@ -76,6 +81,25 @@ export declare abstract class BaseCommand extends Command {
         error?: string;
         status: number;
     }): never;
+    /**
+     * Intercepts a 429 "Monthly quota exhausted" response from an AI rate-limited
+     * endpoint (analyze for `init`, email edit for `edit`) and exits with a
+     * feature-specific message that includes the server's error text, the reset
+     * date, optional retry hint, and the next-best action. Returns without
+     * exiting when the response is not a 429 so callers can fall through to
+     * `handleApiError` for non-quota failures.
+     *
+     * @param {{ status: number; error?: string; data?: unknown; debug?: ApiRequestDebugInfo }} response - The failed API response.
+     *   Must carry the parsed JSON body (`data`) so reset/retry fields can be surfaced.
+     * @param {AiQuotaFeature} feature - Which AI quota was hit. Drives the default headline + tip
+     *   shown when the server omits an explicit `error` string.
+     */
+    protected handleAiQuotaError(response: {
+        data?: unknown;
+        debug?: ApiRequestDebugInfo;
+        error?: string;
+        status: number;
+    }, feature: AiQuotaFeature): void;
     protected collectDomainSetupInputs(yamlConfig: MailmodoYaml, skipPrompts: boolean): Promise<{
         address: string;
         domain: string;

package/dist/lib/base-command.js

@@ -5,7 +5,7 @@ import ora from 'ora';
 import { ApiClient } from './api-client.js';
 import { loadConfig } from './config.js';
 import { API_ENDPOINTS } from './constants.js';
-import { ERRORS, INFO, PROMPTS, recordLabel, VALIDATION } from './messages.js';
+import { ERRORS, INFO, PROMPTS, quotaExhaustedMessage, recordLabel, VALIDATION, } from './messages.js';
 import { loadYaml, saveYaml } from './yaml-config.js';
 export const FREE_TIER = 'free';
 /**
@@ -107,6 +107,35 @@ export class BaseCommand extends Command {
         }
         this.error(this.formatApiFailure(response.error || ERRORS.UNEXPECTED_API, response));
     }
+    /**
+     * Intercepts a 429 "Monthly quota exhausted" response from an AI rate-limited
+     * endpoint (analyze for `init`, email edit for `edit`) and exits with a
+     * feature-specific message that includes the server's error text, the reset
+     * date, optional retry hint, and the next-best action. Returns without
+     * exiting when the response is not a 429 so callers can fall through to
+     * `handleApiError` for non-quota failures.
+     *
+     * @param {{ status: number; error?: string; data?: unknown; debug?: ApiRequestDebugInfo }} response - The failed API response.
+     *   Must carry the parsed JSON body (`data`) so reset/retry fields can be surfaced.
+     * @param {AiQuotaFeature} feature - Which AI quota was hit. Drives the default headline + tip
+     *   shown when the server omits an explicit `error` string.
+     */
+    handleAiQuotaError(response, feature) {
+        if (response.status !== 429)
+            return;
+        const body = (response.data ?? {});
+        const isInit = feature === 'init';
+        const message = quotaExhaustedMessage({
+            defaultMessage: isInit
+                ? ERRORS.QUOTA_INIT_DEFAULT
+                : ERRORS.QUOTA_EDIT_DEFAULT,
+            limitReset: body.limitReset,
+            retryAfter: body.retryAfter,
+            serverError: typeof body.error === 'string' ? body.error : undefined,
+            tip: isInit ? ERRORS.QUOTA_INIT_TIP : ERRORS.QUOTA_EDIT_TIP,
+        });
+        this.error(this.formatApiFailure(message, response));
+    }
     async collectDomainSetupInputs(yamlConfig, skipPrompts) {
         if (skipPrompts) {
             const domain = yamlConfig.project?.domain || '';

package/dist/lib/messages.d.ts

@@ -19,6 +19,10 @@ export declare const ERRORS: {
     readonly INVALID_API_KEY: `Invalid API key. Run ${string} to re-authenticate.`;
     readonly NOT_LOGGED_IN: `Not logged in. Run ${string} to authenticate.`;
     readonly NO_YAML: `No mailmodo.yaml found. Run ${string} first.`;
+    readonly QUOTA_EDIT_DEFAULT: "Edit limit reached for this month.";
+    readonly QUOTA_EDIT_TIP: "AI edits are limited to 50 per account per month. Manually edit the template file under ./mailmodo to make further changes.";
+    readonly QUOTA_INIT_DEFAULT: "Regeneration limit reached.";
+    readonly QUOTA_INIT_TIP: `Regenerations are limited to 5 per account per month. Run ${string} to modify individual emails instead.`;
     readonly RATE_LIMIT: "Rate limit exceeded. Please try again later.";
     readonly UNEXPECTED_API: "An unexpected API error occurred.";
 };
@@ -37,3 +41,26 @@ export declare const INFO: {
 };
 export declare function yamlParseError(detail: string): string;
 export declare function recordLabel(index: number): string;
+/**
+ * Parses an ISO-8601 timestamp into a `YYYY-MM-DD` date string.
+ * Returns the raw input if parsing fails so the original value is preserved.
+ */
+export declare function formatQuotaResetDate(value?: string): string | undefined;
+/**
+ * Formats a `retry-after` value (seconds) into a short, human-readable hint
+ * suitable for appending to a 429 error message.
+ */
+export declare function formatRetryAfter(seconds?: number): string | undefined;
+/**
+ * Builds the multi-line message printed when an AI quota (init regeneration or
+ * edit) is exhausted. `serverError` is the message returned by the API; the
+ * default text is used when the server omits it. The tip lists the next action
+ * the user can take (e.g. switch from init to edit).
+ */
+export declare function quotaExhaustedMessage(input: {
+    defaultMessage: string;
+    limitReset?: string;
+    retryAfter?: number;
+    serverError?: string;
+    tip: string;
+}): string;

package/dist/lib/messages.js

@@ -20,6 +20,10 @@ export const ERRORS = {
     INVALID_API_KEY: `Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`,
     NOT_LOGGED_IN: `Not logged in. Run ${chalk.cyan('mailmodo login')} to authenticate.`,
     NO_YAML: `No mailmodo.yaml found. Run ${chalk.cyan('mailmodo init')} first.`,
+    QUOTA_EDIT_DEFAULT: 'Edit limit reached for this month.',
+    QUOTA_EDIT_TIP: 'AI edits are limited to 50 per account per month. Manually edit the template file under ./mailmodo to make further changes.',
+    QUOTA_INIT_DEFAULT: 'Regeneration limit reached.',
+    QUOTA_INIT_TIP: `Regenerations are limited to 5 per account per month. Run ${chalk.cyan('mailmodo edit <id>')} to modify individual emails instead.`,
     RATE_LIMIT: 'Rate limit exceeded. Please try again later.',
     UNEXPECTED_API: 'An unexpected API error occurred.',
 };
@@ -42,3 +46,56 @@ export function recordLabel(index) {
     const labels = ['DKIM', 'DMARC', 'Return Path'];
     return labels[index] || `Record ${index + 1}`;
 }
+/**
+ * Parses an ISO-8601 timestamp into a `YYYY-MM-DD` date string.
+ * Returns the raw input if parsing fails so the original value is preserved.
+ */
+export function formatQuotaResetDate(value) {
+    if (!value)
+        return undefined;
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime()))
+        return value;
+    const year = parsed.getUTCFullYear();
+    const month = String(parsed.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(parsed.getUTCDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Formats a `retry-after` value (seconds) into a short, human-readable hint
+ * suitable for appending to a 429 error message.
+ */
+export function formatRetryAfter(seconds) {
+    if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds <= 0)
+        return undefined;
+    if (seconds < 60)
+        return `${Math.round(seconds)} seconds`;
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return `${minutes} minutes`;
+    const hours = Math.round(seconds / 3600);
+    if (hours < 24)
+        return `${hours} hours`;
+    const days = Math.round(seconds / 86_400);
+    return `${days} days`;
+}
+/**
+ * Builds the multi-line message printed when an AI quota (init regeneration or
+ * edit) is exhausted. `serverError` is the message returned by the API; the
+ * default text is used when the server omits it. The tip lists the next action
+ * the user can take (e.g. switch from init to edit).
+ */
+export function quotaExhaustedMessage(input) {
+    const headline = input.serverError || input.defaultMessage;
+    const lines = [headline];
+    const resetDate = formatQuotaResetDate(input.limitReset);
+    if (resetDate && !headline.includes(resetDate)) {
+        lines.push(`Resets on ${resetDate}.`);
+    }
+    const retryHint = formatRetryAfter(input.retryAfter);
+    if (retryHint) {
+        lines.push(`Try again in ${retryHint}.`);
+    }
+    lines.push('', input.tip);
+    return lines.join('\n');
+}

package/oclif.manifest.json

@@ -365,45 +365,6 @@
         "index.js"
       ]
     },
-    "login": {
-      "aliases": [],
-      "args": {},
-      "description": "Authenticate with Mailmodo using your API key",
-      "examples": [
-        "<%= config.bin %> login",
-        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "login",
-      "pluginAlias": "@mailmodo/cli",
-      "pluginName": "@mailmodo/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "login",
-        "index.js"
-      ]
-    },
     "logout": {
       "aliases": [],
       "args": {},
@@ -570,6 +531,53 @@
         "index.js"
       ]
     },
+    "settings": {
+      "aliases": [],
+      "args": {},
+      "description": "View and update project settings",
+      "examples": [
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "settings",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "settings",
+        "index.js"
+      ]
+    },
     "status": {
       "aliases": [],
       "args": {},
@@ -609,14 +617,13 @@
         "index.js"
       ]
     },
-    "settings": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "View and update project settings",
+      "description": "Authenticate with Mailmodo using your API key",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
       ],
       "flags": {
         "json": {
@@ -631,18 +638,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "settings",
+      "id": "login",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -652,10 +652,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "login",
         "index.js"
       ]
     }
   },
-  "version": "0.0.48"
+  "version": "0.0.49-beta.pr51.78"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.48",
+  "version": "0.0.49-beta.pr51.78",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"