npm - @mailmodo/cli - Versions diffs - 0.0.8-beta.pr10.14 → 0.0.8 - Mend

@mailmodo/cli 0.0.8-beta.pr10.14 → 0.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/commands/login/index.js +3 -1
package/dist/lib/api-client.d.ts +13 -16
package/dist/lib/api-client.js +7 -52
package/dist/lib/base-command.d.ts +2 -14
package/dist/lib/base-command.js +4 -35
package/dist/lib/constants.d.ts +17 -17
package/dist/lib/constants.js +18 -23
package/oclif.manifest.json +61 -61
package/package.json +1 -1

package/dist/commands/login/index.js CHANGED Viewed

@@ -34,13 +34,15 @@ 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.post(API_ENDPOINTS.AUTH_VALIDATE, {});
+        const response = await client.get(API_ENDPOINTS.AUTH_VALIDATE);
         if (!response.ok) {
             this.handleApiError(response);
         }

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

@@ -1,29 +1,26 @@
-/**
- * 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 CHANGED Viewed

@@ -12,22 +12,6 @@ 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;
@@ -35,18 +19,6 @@ 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.
      *
@@ -59,8 +31,12 @@ export class ApiClient {
      *   data (parsed JSON body), and optional error (string message on failure).
      */
     async request(method, path, body, params) {
-        const url = this.resolveUrl(path, params);
-        const debug = this.requestDebug(url);
+        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',
@@ -75,13 +51,8 @@ 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}`,
@@ -94,13 +65,8 @@ 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.',
@@ -122,8 +88,7 @@ export class ApiClient {
         return this.request('POST', path, body);
     }
     async postFormData(path, formData) {
-        const url = this.resolveUrl(path);
-        const debug = this.requestDebug(url);
+        const url = new URL(`${this.baseUrl}${path}`);
         try {
             const response = await fetch(url.toString(), {
                 body: formData,
@@ -136,13 +101,8 @@ 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}`,
@@ -154,13 +114,8 @@ 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 CHANGED Viewed

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { ApiClient, type ApiRequestDebugInfo } from './api-client.js';
+import { ApiClient } from './api-client.js';
 import { type MailmodoConfig } from './config.js';
 import { type MailmodoYaml } from './yaml-config.js';
 /**
@@ -34,24 +34,12 @@ 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; debug?: ApiRequestDebugInfo }} response - The API response object with ok=false.
+     * @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.
-     *   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 CHANGED Viewed

@@ -57,48 +57,17 @@ 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; debug?: ApiRequestDebugInfo }} response - The API response object with ok=false.
+     * @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.
-     *   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(this.formatApiFailure(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`, response));
+            this.error(`Invalid API key. Run ${chalk.cyan('mailmodo login')} to re-authenticate.`);
         }
         if (response.status === 429) {
-            this.error(this.formatApiFailure('Rate limit exceeded. Please try again later.', response));
+            this.error('Rate limit exceeded. Please try again later.');
         }
-        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');
+        this.error(response.error || 'An unexpected API error occurred.');
     }
 }

package/dist/lib/constants.d.ts CHANGED Viewed

@@ -1,22 +1,22 @@
 export declare const API_BASE_URL: string;
 export declare const API_ENDPOINTS: Readonly<{
-    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";
+    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";
 }>;
 export declare const SIGNUP_URL = "https://mailmodo.com/cli";
 export declare const DOCS_URL = "https://mailmodo.com/docs/cli";

package/dist/lib/constants.js CHANGED Viewed

@@ -1,27 +1,22 @@
-/** 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_BASE_URL = process.env.MAILMODO_API_URL || 'https://api.mailmodo.com/cli/v1';
 export const API_ENDPOINTS = Object.freeze({
-    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',
+    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',
 });
 export const SIGNUP_URL = 'https://mailmodo.com/cli';
 export const DOCS_URL = 'https://mailmodo.com/docs/cli';

package/oclif.manifest.json CHANGED Viewed

@@ -342,15 +342,13 @@
         "index.js"
       ]
     },
-    "logs": {
+    "login": {
       "aliases": [],
       "args": {},
-      "description": "View email send logs and delivery events",
+      "description": "Authenticate with Mailmodo using your API key",
       "examples": [
-        "<%= config.bin %> logs",
-        "<%= config.bin %> logs --email sarah@example.com",
-        "<%= config.bin %> logs --failed",
-        "<%= config.bin %> logs --json"
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=mm_live_xxx <%= config.bin %> login"
       ],
       "flags": {
         "json": {
@@ -365,24 +363,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": "login",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -392,17 +377,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "login",
         "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": {
@@ -417,11 +404,24 @@
           "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": "login",
+      "id": "logs",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -431,18 +431,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "login",
+        "logs",
         "index.js"
       ]
     },
-    "settings": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "View and update project settings",
+      "args": {
+        "id": {
+          "description": "Email ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -458,17 +463,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "text": {
+          "description": "Output plain text version (for AI agents)",
+          "name": "text",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "settings",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -478,23 +489,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "preview",
         "index.js"
       ]
     },
-    "preview": {
+    "settings": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email ID to preview",
-          "name": "id"
-        }
-      },
-      "description": "Preview an email in browser, as text, or send a test",
+      "args": {},
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> preview welcome",
-        "<%= config.bin %> preview welcome --text",
-        "<%= config.bin %> preview welcome --send me@example.com"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -510,23 +516,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "send": {
-          "description": "Send test email to this address",
-          "name": "send",
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "text": {
-          "description": "Output plain text version (for AI agents)",
-          "name": "text",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preview",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -536,7 +536,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "preview",
+        "settings",
         "index.js"
       ]
     },
@@ -580,5 +580,5 @@
       ]
     }
   },
-  "version": "0.0.8-beta.pr10.14"
+  "version": "0.0.8"
 }

package/package.json CHANGED Viewed

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