@mailmodo/cli 0.0.7-beta.pr9.13 → 0.0.8-beta.pr10.14

package/dist/commands/login/index.js

@@ -34,15 +34,13 @@ export default class Login extends BaseCommand {
                 validate(value) {
                     if (!value?.trim())
                         return 'API key is required';
-                    if (!value.startsWith('mm_'))
-                        return 'Invalid API key format. Keys start with mm_';
                     return true;
                 },
             });
         }
         const trimmedKey = apiKey.trim();
         const client = new ApiClient(trimmedKey);
-        const response = await client.get(API_ENDPOINTS.AUTH_VALIDATE);
+        const response = await client.post(API_ENDPOINTS.AUTH_VALIDATE, {});
         if (!response.ok) {
             this.handleApiError(response);
         }

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

@@ -1,26 +1,29 @@
+/**
+ * Request context attached to API responses for troubleshooting failed calls.
+ * Only the resolved URL is stored; it encodes origin, path, and query string.
+ */
+export interface ApiRequestDebugInfo {
+    /** Node/DNS/network error code when `fetch` throws before an HTTP response. */
+    causeCode?: string;
+    /** Fully resolved request URL (origin, path, and query string). */
+    fullUrl: string;
+    /** Truncated JSON summary of a non-empty error response body, when available. */
+    responseSummary?: string;
+}
 export interface ApiResponse<T = Record<string, unknown>> {
     data: T;
+    /** Populated for tracing; especially useful when `ok` is false. */
+    debug?: ApiRequestDebugInfo;
     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);
+    private resolveUrl;
+    private requestDebug;
     /**
      * Sends an HTTP request to the Mailmodo API and returns a typed response.
      *

package/dist/lib/api-client.js

@@ -12,6 +12,22 @@ import { API_BASE_URL } from './constants.js';
  * Network errors (ECONNREFUSED, ENOTFOUND) return a friendly message
  * indicating the API may not be available, rather than a raw stack trace.
  */
+const RESPONSE_BODY_DEBUG_MAX = 800;
+function summarizeResponseBody(data) {
+    if (data === null || data === undefined)
+        return undefined;
+    try {
+        const s = JSON.stringify(data);
+        if (s === '{}' || s === '[]')
+            return undefined;
+        return s.length > RESPONSE_BODY_DEBUG_MAX
+            ? `${s.slice(0, RESPONSE_BODY_DEBUG_MAX)}…`
+            : s;
+    }
+    catch {
+        return undefined;
+    }
+}
 export class ApiClient {
     apiKey;
     baseUrl;
@@ -19,6 +35,18 @@ export class ApiClient {
         this.baseUrl = API_BASE_URL;
         this.apiKey = apiKey;
     }
+    resolveUrl(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        return url;
+    }
+    requestDebug(url) {
+        return { fullUrl: url.toString() };
+    }
     /**
      * Sends an HTTP request to the Mailmodo API and returns a typed response.
      *
@@ -31,12 +59,8 @@ export class ApiClient {
      *   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 url = this.resolveUrl(path, params);
+        const debug = this.requestDebug(url);
         const headers = {
             Authorization: `Bearer ${this.apiKey}`,
             'Content-Type': 'application/json',
@@ -51,8 +75,13 @@ export class ApiClient {
             const data = await response.json().catch(() => ({}));
             if (!response.ok) {
                 const errorData = data;
+                const summary = summarizeResponseBody(data);
                 return {
                     data: data,
+                    debug: {
+                        ...debug,
+                        responseSummary: summary,
+                    },
                     error: errorData?.message ||
                         errorData?.error ||
                         `Request failed with status ${response.status}`,
@@ -65,8 +94,13 @@ export class ApiClient {
         catch (error) {
             const err = error;
             const isConnectionError = err?.cause?.code === 'ECONNREFUSED' || err?.cause?.code === 'ENOTFOUND';
+            const causeCode = err?.cause?.code;
             return {
                 data: {},
+                debug: {
+                    ...debug,
+                    ...(causeCode ? { causeCode } : {}),
+                },
                 error: isConnectionError
                     ? 'Cannot connect to Mailmodo API. The API service may not be available yet.'
                     : err?.message || 'An unexpected network error occurred.',
@@ -88,7 +122,8 @@ export class ApiClient {
         return this.request('POST', path, body);
     }
     async postFormData(path, formData) {
-        const url = new URL(`${this.baseUrl}${path}`);
+        const url = this.resolveUrl(path);
+        const debug = this.requestDebug(url);
         try {
             const response = await fetch(url.toString(), {
                 body: formData,
@@ -101,8 +136,13 @@ export class ApiClient {
             const data = await response.json().catch(() => ({}));
             if (!response.ok) {
                 const errorData = data;
+                const summary = summarizeResponseBody(data);
                 return {
                     data: data,
+                    debug: {
+                        ...debug,
+                        responseSummary: summary,
+                    },
                     error: errorData?.message ||
                         errorData?.error ||
                         `Upload failed with status ${response.status}`,
@@ -114,8 +154,13 @@ export class ApiClient {
         }
         catch (error) {
             const err = error;
+            const causeCode = err?.cause?.code;
             return {
                 data: {},
+                debug: {
+                    ...debug,
+                    ...(causeCode ? { causeCode } : {}),
+                },
                 error: err?.message || 'File upload failed.',
                 ok: false,
                 status: 0,

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

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { ApiClient } from './api-client.js';
+import { ApiClient, type ApiRequestDebugInfo } from './api-client.js';
 import { type MailmodoConfig } from './config.js';
 import { type MailmodoYaml } from './yaml-config.js';
 /**
@@ -34,12 +34,24 @@ export declare abstract class BaseCommand extends Command {
      * 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.
+     * @param {{ status: number; error?: string; debug?: ApiRequestDebugInfo }} 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.
+     *   When `debug` is present, extra lines list Full URL, Status, optional Response
+     *   body summary, and optional Error Code (network failures).
      */
     protected handleApiError(response: {
+        debug?: ApiRequestDebugInfo;
         error?: string;
         status: number;
     }): never;
+    /**
+     * Builds the terminal error string for a failed API call, appending request
+     * metadata when {@link ApiRequestDebugInfo} is available.
+     *
+     * @param {string} message - Primary error text (HTTP message or generic).
+     * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
+     * @returns {string} Message plus indented Request details for troubleshooting.
+     */
+    private formatApiFailure;
 }

package/dist/lib/base-command.js

@@ -57,17 +57,48 @@ export class BaseCommand extends Command {
      * 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.
+     * @param {{ status: number; error?: string; debug?: ApiRequestDebugInfo }} 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.
+     *   When `debug` is present, extra lines list Full URL, Status, optional Response
+     *   body summary, and optional Error Code (network failures).
      */
     handleApiError(response) {
         if (response.status === 401) {
-            this.error(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`);
+            this.error(this.formatApiFailure(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`, response));
         }
         if (response.status === 429) {
-            this.error('Rate limit exceeded. Please try again later.');
+            this.error(this.formatApiFailure('Rate limit exceeded. Please try again later.', response));
         }
-        this.error(response.error || 'An unexpected API error occurred.');
+        this.error(this.formatApiFailure(response.error || 'An unexpected API error occurred.', response));
+    }
+    /**
+     * Builds the terminal error string for a failed API call, appending request
+     * metadata when {@link ApiRequestDebugInfo} is available.
+     *
+     * @param {string} message - Primary error text (HTTP message or generic).
+     * @param {{ status: number; debug?: ApiRequestDebugInfo }} response - Failed API response.
+     * @returns {string} Message plus indented Request details for troubleshooting.
+     */
+    formatApiFailure(message, response) {
+        const { debug, status } = response;
+        if (!debug) {
+            return message;
+        }
+        return [
+            message,
+            '',
+            chalk.dim('Request:'),
+            chalk.dim(`  URL: ${debug.fullUrl}`),
+            status > 0
+                ? chalk.dim(`  Status: ${String(status)}`)
+                : chalk.dim('  Status: (No HTTP response — network or client error)'),
+            ...(debug.responseSummary
+                ? [chalk.dim(`  Response: ${debug.responseSummary}`)]
+                : []),
+            ...(debug.causeCode
+                ? [chalk.dim(`  Error Code: ${debug.causeCode}`)]
+                : []),
+        ].join('\n');
     }
 }

package/dist/lib/constants.d.ts

@@ -1,22 +1,22 @@
 export declare const API_BASE_URL: string;
 export declare const API_ENDPOINTS: Readonly<{
-    ANALYTICS: "/analytics";
-    ANALYZE: "/analyze";
-    ASSETS_LOGO: "/assets/logo";
-    AUTH_VALIDATE: "/auth/validate";
-    BILLING_CAP: "/billing/cap";
-    BILLING_STATUS: "/billing/status";
-    CONTACTS: "/contacts";
-    CONTACTS_EXPORT: "/contacts/export";
-    DOMAIN: "/domain";
-    DOMAIN_STATUS: "/domain/status";
-    DOMAIN_VERIFY: "/domain/verify";
-    EDIT: "/edit";
-    EVENTS: "/events";
-    GENERATE: "/generate";
-    LOGS: "/logs";
-    PREVIEW: "/preview";
-    SEQUENCES: "/sequences";
+    ANALYTICS: "/api/analytics";
+    ANALYZE: "/api/analyze";
+    ASSETS_LOGO: "/api/assets/logo";
+    AUTH_VALIDATE: "/api/auth/validate";
+    BILLING_CAP: "/api/billing/cap";
+    BILLING_STATUS: "/api/billing/status";
+    CONTACTS: "/api/contacts";
+    CONTACTS_EXPORT: "/api/contacts/export";
+    DOMAIN: "/api/domain";
+    DOMAIN_STATUS: "/api/domain/status";
+    DOMAIN_VERIFY: "/api/domain/verify";
+    EDIT: "/api/edit";
+    EVENTS: "/api/events";
+    GENERATE: "/api/generate";
+    LOGS: "/api/logs";
+    PREVIEW: "/api/preview";
+    SEQUENCES: "/api/sequences";
 }>;
 export declare const SIGNUP_URL = "https://mailmodo.com/cli";
 export declare const DOCS_URL = "https://mailmodo.com/docs/cli";

package/dist/lib/constants.js

@@ -1,22 +1,27 @@
-export const API_BASE_URL = process.env.MAILMODO_API_URL || 'https://api.mailmodo.com/cli/v1';
+/** Set by `bin/dev.js` when running the CLI locally (tsx bootstrap). */
+const DEV_API_BASE_URL = 'https://app-vertex-debug.azurewebsites.net';
+const PRODUCTION_API_BASE_URL = 'https://api.mailmodo.com';
+export const API_BASE_URL = process.env.MAILMODO_DEV_TSX
+    ? DEV_API_BASE_URL
+    : PRODUCTION_API_BASE_URL;
 export const API_ENDPOINTS = Object.freeze({
-    ANALYTICS: '/analytics',
-    ANALYZE: '/analyze',
-    ASSETS_LOGO: '/assets/logo',
-    AUTH_VALIDATE: '/auth/validate',
-    BILLING_CAP: '/billing/cap',
-    BILLING_STATUS: '/billing/status',
-    CONTACTS: '/contacts',
-    CONTACTS_EXPORT: '/contacts/export',
-    DOMAIN: '/domain',
-    DOMAIN_STATUS: '/domain/status',
-    DOMAIN_VERIFY: '/domain/verify',
-    EDIT: '/edit',
-    EVENTS: '/events',
-    GENERATE: '/generate',
-    LOGS: '/logs',
-    PREVIEW: '/preview',
-    SEQUENCES: '/sequences',
+    ANALYTICS: '/api/analytics',
+    ANALYZE: '/api/analyze',
+    ASSETS_LOGO: '/api/assets/logo',
+    AUTH_VALIDATE: '/api/auth/validate',
+    BILLING_CAP: '/api/billing/cap',
+    BILLING_STATUS: '/api/billing/status',
+    CONTACTS: '/api/contacts',
+    CONTACTS_EXPORT: '/api/contacts/export',
+    DOMAIN: '/api/domain',
+    DOMAIN_STATUS: '/api/domain/status',
+    DOMAIN_VERIFY: '/api/domain/verify',
+    EDIT: '/api/edit',
+    EVENTS: '/api/events',
+    GENERATE: '/api/generate',
+    LOGS: '/api/logs',
+    PREVIEW: '/api/preview',
+    SEQUENCES: '/api/sequences',
 });
 export const SIGNUP_URL = 'https://mailmodo.com/cli';
 export const DOCS_URL = 'https://mailmodo.com/docs/cli';

package/oclif.manifest.json

@@ -114,6 +114,45 @@
         "index.js"
       ]
     },
+    "deploy": {
+      "aliases": [],
+      "args": {},
+      "description": "Deploy email sequences and verify sending domain",
+      "examples": [
+        "<%= config.bin %> deploy",
+        "<%= config.bin %> deploy --yes"
+      ],
+      "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": "deploy",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy",
+        "index.js"
+      ]
+    },
     "domain": {
       "aliases": [],
       "args": {},
@@ -166,13 +205,13 @@
         "index.js"
       ]
     },
-    "deploy": {
+    "emails": {
       "aliases": [],
       "args": {},
-      "description": "Deploy email sequences and verify sending domain",
+      "description": "List and view configured email sequences",
       "examples": [
-        "<%= config.bin %> deploy",
-        "<%= config.bin %> deploy --yes"
+        "<%= config.bin %> emails",
+        "<%= config.bin %> emails --json"
       ],
       "flags": {
         "json": {
@@ -191,7 +230,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "deploy",
+      "id": "emails",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -201,7 +240,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "deploy",
+        "emails",
         "index.js"
       ]
     },
@@ -257,13 +296,13 @@
         "index.js"
       ]
     },
-    "emails": {
+    "init": {
       "aliases": [],
       "args": {},
-      "description": "List and view configured email sequences",
+      "description": "Analyze your product and generate email sequences",
       "examples": [
-        "<%= config.bin %> emails",
-        "<%= config.bin %> emails --json"
+        "<%= config.bin %> init",
+        "<%= config.bin %> init --url https://myapp.com --yes"
       ],
       "flags": {
         "json": {
@@ -278,11 +317,18 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "url": {
+          "description": "Product URL to analyze",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "emails",
+      "id": "init",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -292,17 +338,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "init",
         "index.js"
       ]
     },
-    "init": {
+    "logs": {
       "aliases": [],
       "args": {},
-      "description": "Analyze your product and generate email sequences",
+      "description": "View email send logs and delivery events",
       "examples": [
-        "<%= config.bin %> init",
-        "<%= config.bin %> init --url https://myapp.com --yes"
+        "<%= config.bin %> logs",
+        "<%= config.bin %> logs --email sarah@example.com",
+        "<%= config.bin %> logs --failed",
+        "<%= config.bin %> logs --json"
       ],
       "flags": {
         "json": {
@@ -318,17 +366,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "url": {
-          "description": "Product URL to analyze",
-          "name": "url",
+        "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": "init",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -338,7 +392,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "init",
+        "logs",
         "index.js"
       ]
     },
@@ -381,15 +435,14 @@
         "index.js"
       ]
     },
-    "logs": {
+    "settings": {
       "aliases": [],
       "args": {},
-      "description": "View email send logs and delivery events",
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -405,23 +458,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "email": {
-          "description": "Filter logs by contact email",
-          "name": "email",
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
           "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": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -431,7 +478,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "settings",
         "index.js"
       ]
     },
@@ -493,53 +540,6 @@
         "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": {},
@@ -580,5 +580,5 @@
       ]
     }
   },
-  "version": "0.0.7-beta.pr9.13"
+  "version": "0.0.8-beta.pr10.14"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.7-beta.pr9.13",
+  "version": "0.0.8-beta.pr10.14",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"