@mailmodo/cli 0.0.46 → 0.0.47-beta.pr49.75

package/dist/commands/billing/index.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
 import chalk from 'chalk';
 import open from 'open';
-import { BaseCommand } from '../../lib/base-command.js';
+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';
@@ -200,6 +200,12 @@ export default class Billing extends BaseCommand {
         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,

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

@@ -10,6 +10,7 @@ export default class Deploy extends BaseCommand {
     run(): Promise<void>;
     private validateSequence;
     private buildDeployPayload;
+    private resolveMonthlyCapForDeploy;
     private mapEmailToPayload;
     private buildBrandSection;
     private buildProductSection;

package/dist/commands/deploy/index.js

@@ -1,7 +1,7 @@
 import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, } from '../../lib/constants.js';
+import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
 import { ERRORS, INFO, PROMPTS, SEPARATOR } from '../../lib/messages.js';
 import { loadTemplate, } from '../../lib/yaml-config.js';
 export default class Deploy extends BaseCommand {
@@ -61,16 +61,25 @@ export default class Deploy extends BaseCommand {
         return response.data;
     }
     async buildDeployPayload(yamlConfig) {
-        const emailsWithHtml = await Promise.all(yamlConfig.emails.map(async (email) => {
-            const html = (await loadTemplate(`${email.id}.html`)) || '';
-            const plainHtml = (await loadTemplate(`${email.id}_plain.html`)) || html;
-            return { ...this.mapEmailToPayload(email), html, plainHtml };
-        }));
+        const [emailsWithHtml, monthlyCap] = await Promise.all([
+            Promise.all(yamlConfig.emails.map(async (email) => {
+                const html = (await loadTemplate(`${email.id}.html`)) || '';
+                const plainHtml = (await loadTemplate(`${email.id}_plain.html`)) || html;
+                return { ...this.mapEmailToPayload(email), html, plainHtml };
+            })),
+            this.resolveMonthlyCapForDeploy(yamlConfig.project.monthlyCap),
+        ]);
         return {
-            ...this.buildProjectPayload(yamlConfig.project),
+            ...this.buildProjectPayload(yamlConfig.project, monthlyCap),
             emails: emailsWithHtml,
         };
     }
+    async resolveMonthlyCapForDeploy(yamlMonthlyCap) {
+        if (yamlMonthlyCap !== undefined)
+            return yamlMonthlyCap;
+        const billingStatus = await this.fetchBillingStatus();
+        return billingStatus?.cap?.inBlocks ?? undefined;
+    }
     mapEmailToPayload(email) {
         return {
             condition: email.condition || null,
@@ -111,11 +120,11 @@ export default class Deploy extends BaseCommand {
             replyTo: project?.replyTo || project?.fromEmail || '',
         };
     }
-    buildProjectPayload(project) {
+    buildProjectPayload(project, monthlyCap) {
         return {
             brand: this.buildBrandSection(project),
             emailStyle: project?.emailStyle || 'branded',
-            monthlyCap: project?.monthlyCap ?? DEFAULT_MONTHLY_CAP,
+            ...(monthlyCap === undefined ? {} : { monthlyCap }),
             product: this.buildProductSection(project),
             senderDetails: this.buildSenderSection(project),
             ...(project?.webhookUrl ? { webhookUrl: project.webhookUrl } : {}),

package/dist/commands/init/index.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { confirm, editor, input, select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, DEFAULT_MONTHLY_CAP, } from '../../lib/constants.js';
+import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
 import { loadYaml, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
 function isValidUrl(value) {
     try {
@@ -143,7 +143,6 @@ export default class Init extends BaseCommand {
                 fromEmail: '',
                 fromName: `Team ${analysisPayload.productName}`,
                 logoUrl: analysisPayload.brand?.logoUrl || '',
-                monthlyCap: DEFAULT_MONTHLY_CAP,
                 name: analysisPayload.productName,
                 pricingModel: analysisPayload.pricingModel,
                 replyTo: '',
@@ -155,6 +154,12 @@ 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);
+        }
         const templateSaves = analysisPayload.recommendedEmails.flatMap((rec, index) => {
             const generated = generatedEmails[index];
             const saves = [];

package/dist/commands/settings/index.js

@@ -4,7 +4,7 @@ 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 { BaseCommand, FREE_TIER } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
 import { INFO } from '../../lib/messages.js';
 import { saveYaml } from '../../lib/yaml-config.js';
@@ -48,17 +48,30 @@ export default class Settings extends BaseCommand {
             await this.applySetFlag(flags.set, yamlConfig, flags.json ?? false);
             return;
         }
+        const [domainVerified, billingStatus] = await Promise.all([
+            flags.json
+                ? Promise.resolve(null)
+                : this.fetchDomainVerified(yamlConfig.project.domain),
+            this.fetchBillingStatus(),
+        ]);
+        const tier = billingStatus?.tier ?? null;
+        const capFromApi = billingStatus?.cap?.inBlocks ?? null;
+        if (capFromApi !== null) {
+            yamlConfig.project.monthlyCap = capFromApi;
+            await saveYaml(yamlConfig);
+        }
         if (flags.json) {
             this.log(JSON.stringify({ settings: yamlConfig.project }, null, 2));
             return;
         }
-        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)) {
+            if (group === 'billing' && tier === FREE_TIER)
+                continue;
             this.displaySettingsGroup(group, keys, yamlConfig.project, domainVerified);
         }
         if (!flags.yes) {
-            await this.promptEditSetting(yamlConfig);
+            await this.promptEditSetting(yamlConfig, tier);
         }
     }
     async applySetFlag(setFlag, yamlConfig, isJson) {
@@ -74,7 +87,7 @@ export default class Settings extends BaseCommand {
             this.error(`Unknown setting: ${key}`);
         }
         if (propKey === 'monthlyCap') {
-            await this.applyMonthlyCapChange(yamlConfig, value, isJson);
+            await this.applyMonthlyCapChange(yamlConfig, value, isJson, null);
             return;
         }
         project[propKey] = value;
@@ -86,12 +99,17 @@ export default class Settings extends BaseCommand {
         this.log(`\n  ${chalk.green('✓')} ${key} updated to ${chalk.cyan(value)}`);
         this.log(`  ${INFO.DEPLOY_TO_APPLY}\n`);
     }
-    async applyMonthlyCapChange(yamlConfig, rawValue, isJson) {
+    async applyMonthlyCapChange(yamlConfig, rawValue, isJson, knownTier) {
         const parsed = Number(rawValue);
         if (!Number.isInteger(parsed) || parsed < 1) {
             this.error('monthly_cap must be a positive integer (blocks).');
         }
         await this.ensureAuth();
+        const tier = knownTier ?? (await this.fetchBillingTier());
+        if (tier === FREE_TIER) {
+            this.warnFreeTierCapBlocked(isJson);
+            return;
+        }
         const data = await this.applyBillingCap({ cap: parsed, json: isJson });
         yamlConfig.project.monthlyCap = data.capBlocks;
         await saveYaml(yamlConfig);
@@ -146,7 +164,7 @@ export default class Settings extends BaseCommand {
      * Prompts the user to pick a setting key to edit and dispatches
      * to the appropriate handler for that key.
      */
-    async promptEditSetting(yamlConfig) {
+    async promptEditSetting(yamlConfig, tier) {
         const { project } = yamlConfig;
         const editKey = await input({
             default: 'n',
@@ -154,6 +172,10 @@ export default class Settings extends BaseCommand {
         });
         if (editKey === 'n')
             return;
+        if (editKey === 'monthly_cap' && tier === FREE_TIER) {
+            this.warnFreeTierCapBlocked(false);
+            return;
+        }
         const editPropKey = settingKeyToProp(editKey);
         if (!(editPropKey in project)) {
             if (editKey === 'logo_file') {
@@ -181,7 +203,7 @@ export default class Settings extends BaseCommand {
             const newValue = await input({
                 message: 'New monthly cap (blocks):',
             });
-            await this.applyMonthlyCapChange(yamlConfig, newValue, false);
+            await this.applyMonthlyCapChange(yamlConfig, newValue, false, tier);
             return;
         }
         if (editKey === 'email_style') {

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

@@ -8,6 +8,15 @@ export interface BillingCapUpdateResult {
     capEmails: number;
     message: string;
 }
+export interface BillingStatusResult {
+    cap?: {
+        capUpdatedAt: null | string;
+        inBlocks: null | number;
+        inEmails: null | number;
+    };
+    tier?: string;
+}
+export declare const FREE_TIER = "free";
 /**
  * Abstract base command providing shared functionality for all Mailmodo CLI commands.
  * Subclasses inherit --json and --yes base flags, authentication enforcement,
@@ -74,6 +83,15 @@ export declare abstract class BaseCommand extends Command {
         fromName: string;
         replyTo: string;
     }>;
+    /**
+     * Validates the inputs that would be sent to `POST /billing/cap`. Extracted
+     * so callers can run cheap, no-API local checks (positive integers) before
+     * the tier lookup or any other network round trip.
+     */
+    protected validateBillingCapInputs(options: {
+        autoChargeBlockCount?: number;
+        cap: number;
+    }): void;
     /**
      * Updates the account's monthly sending cap on the server.
      * Validates inputs, wraps the POST /billing/cap call in a spinner, and
@@ -85,6 +103,27 @@ export declare abstract class BaseCommand extends Command {
         cap: number;
         json: boolean;
     }): Promise<BillingCapUpdateResult>;
+    /**
+     * Shared "free-tier users can't set a monthly cap" notice for both the
+     * billing and settings commands. Prints a yellow warning in text mode and a
+     * `status: 'blocked'` payload in JSON mode so machine-readable callers can
+     * distinguish from a successful update.
+     */
+    protected warnFreeTierCapBlocked(jsonOutput: boolean): void;
+    /**
+     * Fetches the full billing status from `/billing/status`. Returns `null`
+     * when the request cannot be completed (no credentials, network failure,
+     * non-OK response) so callers can degrade gracefully without halting.
+     */
+    protected fetchBillingStatus(): Promise<BillingStatusResult | null>;
+    /**
+     * Fetches the account's billing tier from `/billing/status`. Returns `null`
+     * when the request cannot be completed (no credentials, network failure,
+     * non-OK response) so callers can degrade gracefully without halting.
+     * Callers that need a hard "free vs paid" decision should treat `null` as
+     * unknown and fall through to their default behavior.
+     */
+    protected fetchBillingTier(): Promise<null | string>;
     protected registerDomain(yamlConfig: MailmodoYaml, inputs: {
         address: string;
         domain: string;

package/dist/lib/base-command.js

@@ -7,6 +7,7 @@ import { loadConfig } from './config.js';
 import { API_ENDPOINTS } from './constants.js';
 import { ERRORS, INFO, PROMPTS, recordLabel, VALIDATION } from './messages.js';
 import { loadYaml, saveYaml } from './yaml-config.js';
+export const FREE_TIER = 'free';
 /**
  * Abstract base command providing shared functionality for all Mailmodo CLI commands.
  * Subclasses inherit --json and --yes base flags, authentication enforcement,
@@ -146,12 +147,11 @@ export class BaseCommand extends Command {
         return { address, domain, fromEmail, fromName, replyTo };
     }
     /**
-     * Updates the account's monthly sending cap on the server.
-     * Validates inputs, wraps the POST /billing/cap call in a spinner, and
-     * surfaces errors via handleApiError. The caller is responsible for any
-     * local persistence (e.g. writing `monthlyCap` to mailmodo.yaml).
+     * Validates the inputs that would be sent to `POST /billing/cap`. Extracted
+     * so callers can run cheap, no-API local checks (positive integers) before
+     * the tier lookup or any other network round trip.
      */
-    async applyBillingCap(options) {
+    validateBillingCapInputs(options) {
         if (options.cap < 1) {
             this.error('Cap must be at least 1 block.');
         }
@@ -159,6 +159,15 @@ export class BaseCommand extends Command {
             options.autoChargeBlockCount < 1) {
             this.error('Auto-charge block count must be at least 1 block.');
         }
+    }
+    /**
+     * Updates the account's monthly sending cap on the server.
+     * Validates inputs, wraps the POST /billing/cap call in a spinner, and
+     * surfaces errors via handleApiError. The caller is responsible for any
+     * local persistence (e.g. writing `monthlyCap` to mailmodo.yaml).
+     */
+    async applyBillingCap(options) {
+        this.validateBillingCapInputs(options);
         const payload = options.autoChargeBlockCount === undefined
             ? { cap: options.cap }
             : {
@@ -171,6 +180,51 @@ export class BaseCommand extends Command {
         }
         return response.data;
     }
+    /**
+     * Shared "free-tier users can't set a monthly cap" notice for both the
+     * billing and settings commands. Prints a yellow warning in text mode and a
+     * `status: 'blocked'` payload in JSON mode so machine-readable callers can
+     * distinguish from a successful update.
+     */
+    warnFreeTierCapBlocked(jsonOutput) {
+        if (jsonOutput) {
+            this.log(JSON.stringify({
+                message: INFO.FREE_TIER_CAP_BLOCKED,
+                status: 'blocked',
+                tier: FREE_TIER,
+            }, null, 2));
+            return;
+        }
+        this.warn(chalk.yellow(INFO.FREE_TIER_CAP_BLOCKED));
+    }
+    /**
+     * Fetches the full billing status from `/billing/status`. Returns `null`
+     * when the request cannot be completed (no credentials, network failure,
+     * non-OK response) so callers can degrade gracefully without halting.
+     */
+    async fetchBillingStatus() {
+        try {
+            await this.ensureAuth();
+            const response = await this.apiClient.get(API_ENDPOINTS.BILLING_STATUS);
+            if (!response.ok)
+                return null;
+            return response.data ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Fetches the account's billing tier from `/billing/status`. Returns `null`
+     * when the request cannot be completed (no credentials, network failure,
+     * non-OK response) so callers can degrade gracefully without halting.
+     * Callers that need a hard "free vs paid" decision should treat `null` as
+     * unknown and fall through to their default behavior.
+     */
+    async fetchBillingTier() {
+        const status = await this.fetchBillingStatus();
+        return status?.tier ?? null;
+    }
     async registerDomain(yamlConfig, inputs, json) {
         const apiPayload = {
             address: inputs.address,

package/dist/lib/constants.d.ts

@@ -23,10 +23,7 @@ export declare const API_ENDPOINTS: Readonly<{
     SEQUENCES_VALIDATE: "/sequences/validate";
 }>;
 export declare const LOGIN_URL = "https://app-vertex-debug.azurewebsites.net/signup.html";
-export declare const DOCS_URL = "https://mailmodo.com/docs/cli";
-export declare const DNS_GUIDE_URL = "https://mailmodo.com/docs/dns";
 export declare const PREVIEW_PORT = 3421;
 export declare const DEFAULT_BRAND_COLOR = "#1A56DB";
-export declare const DEFAULT_MONTHLY_CAP = 5;
 export declare const TEMPLATES_DIR = "mailmodo";
 export declare const YAML_FILE = "mailmodo.yaml";

package/dist/lib/constants.js

@@ -34,10 +34,7 @@ const PRODUCTION_LOGIN_URL = 'https://app-vertex-debug.azurewebsites.net/signup.
 export const LOGIN_URL = process.env.MAILMODO_DEV_TSX
     ? DEV_LOGIN_URL
     : PRODUCTION_LOGIN_URL;
-export const DOCS_URL = 'https://mailmodo.com/docs/cli';
-export const DNS_GUIDE_URL = 'https://mailmodo.com/docs/dns';
 export const PREVIEW_PORT = 3421;
 export const DEFAULT_BRAND_COLOR = '#1A56DB';
-export const DEFAULT_MONTHLY_CAP = 5;
 export const TEMPLATES_DIR = 'mailmodo';
 export const YAML_FILE = 'mailmodo.yaml';

package/dist/lib/messages.d.ts

@@ -32,6 +32,7 @@ export declare const INFO: {
     readonly DOMAIN_NOT_DEPLOYED_HINT: `When ready, run: ${string}
   Then: ${string}`;
     readonly DOMAIN_PENDING_VERIFICATION: `Your domain is not verified yet. Please verify it first. Run ${string} to check the status.`;
+    readonly FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${string} to add a payment method, then set a cap.`;
     readonly SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${string}.`;
 };
 export declare function yamlParseError(detail: string): string;

package/dist/lib/messages.js

@@ -32,6 +32,7 @@ export const INFO = {
     DNS_RECORDS_FAILED: chalk.yellow('Some records failed.'),
     DOMAIN_NOT_DEPLOYED_HINT: `When ready, run: ${chalk.cyan('mailmodo domain')}\n  Then: ${chalk.cyan('mailmodo deploy')}`,
     DOMAIN_PENDING_VERIFICATION: `Your domain is not verified yet. Please verify it first. Run ${chalk.cyan('mailmodo domain --verify')} to check the status.`,
+    FREE_TIER_CAP_BLOCKED: `Monthly cap is a paid-tier setting and is not available on the free tier. Run ${chalk.cyan("'mailmodo billing --checkout'")} to add a payment method, then set a cap.`,
     SEQUENCES_NOT_DEPLOYED: `Sequences saved but ${chalk.yellow('NOT deployed')}.`,
 };
 export function yamlParseError(detail) {

package/oclif.manifest.json

@@ -228,13 +228,19 @@
         "index.js"
       ]
     },
-    "emails": {
+    "edit": {
       "aliases": [],
-      "args": {},
-      "description": "List and view configured email sequences",
+      "args": {
+        "id": {
+          "description": "Email template ID to edit",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Edit an email using AI-assisted natural language changes",
       "examples": [
-        "<%= config.bin %> emails",
-        "<%= config.bin %> emails --json"
+        "<%= config.bin %> edit welcome",
+        "<%= config.bin %> edit welcome --change \"make subject more urgent\" --yes"
       ],
       "flags": {
         "json": {
@@ -249,11 +255,18 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "change": {
+          "description": "Natural language description of the change",
+          "name": "change",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "emails",
+      "id": "edit",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -263,23 +276,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "edit",
         "index.js"
       ]
     },
-    "edit": {
+    "emails": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email template ID to edit",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Edit an email using AI-assisted natural language changes",
+      "args": {},
+      "description": "List and view configured email sequences",
       "examples": [
-        "<%= config.bin %> edit welcome",
-        "<%= config.bin %> edit welcome --change \"make subject more urgent\" --yes"
+        "<%= config.bin %> emails",
+        "<%= config.bin %> emails --json"
       ],
       "flags": {
         "json": {
@@ -294,18 +301,11 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "change": {
-          "description": "Natural language description of the change",
-          "name": "change",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "edit",
+      "id": "emails",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -315,7 +315,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "edit",
+        "emails",
         "index.js"
       ]
     },
@@ -657,5 +657,5 @@
       ]
     }
   },
-  "version": "0.0.46"
+  "version": "0.0.47-beta.pr49.75"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.46",
+  "version": "0.0.47-beta.pr49.75",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"