@mailmodo/cli 0.0.14 → 0.0.15-beta.pr17.25

package/dist/commands/contacts/index.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
+import { writeFile } from 'node:fs/promises';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
 export default class Contacts extends BaseCommand {
@@ -8,7 +9,7 @@ export default class Contacts extends BaseCommand {
     static examples = [
         '<%= config.bin %> contacts',
         '<%= config.bin %> contacts --search sarah@example.com',
-        '<%= config.bin %> contacts --export',
+        "<%= config.bin %> contacts --export   # GDPR CSV → contacts.csv",
         '<%= config.bin %> contacts --delete sarah@example.com',
     ];
     static flags = {
@@ -18,7 +19,7 @@ export default class Contacts extends BaseCommand {
         }),
         export: Flags.boolean({
             default: false,
-            description: 'Export all contacts as CSV',
+            description: 'Export all contacts as GDPR-compliant CSV (writes contacts.csv in the current directory)',
         }),
         search: Flags.string({ description: 'Search for a contact by email' }),
     };
@@ -106,10 +107,19 @@ export default class Contacts extends BaseCommand {
             return;
         }
         this.log(`\n  ${chalk.green('✓')} Contact export started.`);
-        if (response.data?.downloadUrl) {
-            this.log(`  Download: ${chalk.cyan(response.data.downloadUrl)}`);
+        const { downloadUrl, status } = response.data;
+        if (!downloadUrl) {
+            this.log(`\n  Export status: ${status ?? 'unknown'}. No download URL yet.\n`);
+            return;
         }
-        this.log('');
+        const url = `https://${downloadUrl}`;
+        const fileResult = await this.apiClient.getFile(url);
+        if (!fileResult.ok) {
+            this.error(`Download failed: ${fileResult.status} ${fileResult.error ?? ''}\n` +
+                `  URL: ${fileResult.debug.fullUrl}`);
+        }
+        await writeFile('contacts.csv', Buffer.from(fileResult.body));
+        this.log(`\n  ${chalk.green('✓')} Contact export saved to ${chalk.cyan('contacts.csv')}\n`);
     }
     /**
      * Performs a GDPR-compliant hard delete of a contact and all their

package/dist/commands/login/index.js

@@ -4,7 +4,7 @@ import open from 'open';
 import { BaseCommand } from '../../lib/base-command.js';
 import { ApiClient } from '../../lib/api-client.js';
 import { loadConfig, saveConfig } from '../../lib/config.js';
-import { API_ENDPOINTS, SIGNUP_URL } from '../../lib/constants.js';
+import { API_ENDPOINTS, LOGIN_URL } from '../../lib/constants.js';
 export default class Login extends BaseCommand {
     static description = 'Authenticate with Mailmodo using your API key';
     static examples = [
@@ -44,9 +44,9 @@ export default class Login extends BaseCommand {
             this.log('Detected MAILMODO_API_KEY from environment.');
         }
         else {
-            this.log(`\n  Get your free API key at: ${chalk.cyan(SIGNUP_URL)}\n`);
+            this.log(`\n  Get your free API key at: ${chalk.cyan(LOGIN_URL)}\n`);
             try {
-                await open(SIGNUP_URL);
+                await open(LOGIN_URL);
                 this.log('  Opening in browser...\n');
             }
             catch {

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

@@ -1,3 +1,4 @@
+import { type FileFetchResult } from './fetch-file.js';
 /**
  * Request context attached to API responses for troubleshooting failed calls.
  * Only the resolved URL is stored; it encodes origin, path, and query string.
@@ -38,6 +39,11 @@ export declare class ApiClient {
     private request;
     delete<T = Record<string, unknown>>(path: string): Promise<ApiResponse<T>>;
     get<T = Record<string, unknown>>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
+    /**
+     * GET an absolute URL and return the raw body (e.g. CSV export). Uses the same
+     * Bearer auth as other requests; does not parse JSON.
+     */
+    getFile(url: string): Promise<FileFetchResult>;
     patch<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>): Promise<ApiResponse<T>>;
     post<T = Record<string, unknown>>(path: string, body?: Record<string, unknown> | unknown): Promise<ApiResponse<T>>;
     postFormData<T = Record<string, unknown>>(path: string, formData: FormData): Promise<ApiResponse<T>>;

package/dist/lib/api-client.js

@@ -1,4 +1,5 @@
 import { API_BASE_URL } from './constants.js';
+import { fetchFileWithBearerAuth, } from './fetch-file.js';
 /**
  * HTTP client for the Mailmodo CLI API.
  * Wraps the native fetch API with Bearer token authentication,
@@ -115,6 +116,13 @@ export class ApiClient {
     async get(path, params) {
         return this.request('GET', path, undefined, params);
     }
+    /**
+     * GET an absolute URL and return the raw body (e.g. CSV export). Uses the same
+     * Bearer auth as other requests; does not parse JSON.
+     */
+    async getFile(url) {
+        return fetchFileWithBearerAuth(url, this.apiKey);
+    }
     async patch(path, body) {
         return this.request('PATCH', path, body);
     }

package/dist/lib/constants.d.ts

@@ -18,7 +18,7 @@ export declare const API_ENDPOINTS: Readonly<{
     PREVIEW: "/preview";
     SEQUENCES: "/sequences";
 }>;
-export declare const SIGNUP_URL = "https://mailmodo.com/cli";
+export declare const LOGIN_URL = "https://app-vertex-debug.azurewebsites.net/login.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;

package/dist/lib/constants.js

@@ -24,7 +24,12 @@ export const API_ENDPOINTS = Object.freeze({
     PREVIEW: '/preview',
     SEQUENCES: '/sequences',
 });
-export const SIGNUP_URL = 'https://mailmodo.com/cli';
+const DEV_LOGIN_URL = 'https://app-vertex-debug.azurewebsites.net/login.html';
+// const PRODUCTION_LOGIN_URL = 'https://mailmodo.com/cli';
+const PRODUCTION_LOGIN_URL = 'https://app-vertex-debug.azurewebsites.net/login.html';
+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;

package/dist/lib/fetch-file.d.ts

@@ -0,0 +1,14 @@
+export interface FileFetchResult {
+    body: ArrayBuffer;
+    debug: {
+        fullUrl: string;
+    };
+    error?: string;
+    ok: boolean;
+    status: number;
+}
+/**
+ * GET an absolute URL and return the raw body (e.g. CSV). Uses Bearer auth;
+ * does not parse JSON.
+ */
+export declare function fetchFileWithBearerAuth(url: string, apiKey: string): Promise<FileFetchResult>;

package/dist/lib/fetch-file.js

@@ -0,0 +1,51 @@
+const USER_AGENT = '@mailmodo/cli';
+/**
+ * GET an absolute URL and return the raw body (e.g. CSV). Uses Bearer auth;
+ * does not parse JSON.
+ */
+export async function fetchFileWithBearerAuth(url, apiKey) {
+    let href;
+    try {
+        href = new URL(url.trim()).toString();
+    }
+    catch {
+        return {
+            body: new ArrayBuffer(0),
+            debug: { fullUrl: url.trim() },
+            error: 'Invalid URL',
+            ok: false,
+            status: 0,
+        };
+    }
+    const debug = { fullUrl: href };
+    try {
+        const response = await fetch(href, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'User-Agent': USER_AGENT,
+            },
+            method: 'GET',
+        });
+        const body = await response.arrayBuffer();
+        if (!response.ok) {
+            return {
+                body: new ArrayBuffer(0),
+                debug,
+                error: response.statusText,
+                ok: false,
+                status: response.status,
+            };
+        }
+        return { body, debug, ok: true, status: response.status };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            body: new ArrayBuffer(0),
+            debug,
+            error: err?.message || 'Request failed.',
+            ok: false,
+            status: 0,
+        };
+    }
+}

package/oclif.manifest.json

@@ -60,7 +60,7 @@
       "examples": [
         "<%= config.bin %> contacts",
         "<%= config.bin %> contacts --search sarah@example.com",
-        "<%= config.bin %> contacts --export",
+        "<%= config.bin %> contacts --export   # GDPR CSV → contacts.csv",
         "<%= config.bin %> contacts --delete sarah@example.com"
       ],
       "flags": {
@@ -85,7 +85,7 @@
           "type": "option"
         },
         "export": {
-          "description": "Export all contacts as CSV",
+          "description": "Export all contacts as GDPR-compliant CSV (writes contacts.csv in the current directory)",
           "name": "export",
           "allowNo": false,
           "type": "boolean"
@@ -205,19 +205,13 @@
         "index.js"
       ]
     },
-    "edit": {
+    "emails": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email 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": {
@@ -232,18 +226,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",
@@ -253,17 +240,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "edit",
+        "emails",
         "index.js"
       ]
     },
-    "emails": {
+    "edit": {
       "aliases": [],
-      "args": {},
-      "description": "List and view configured email sequences",
+      "args": {
+        "id": {
+          "description": "Email 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": {
@@ -278,11 +271,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",
@@ -292,7 +292,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "emails",
+        "edit",
         "index.js"
       ]
     },
@@ -531,14 +531,13 @@
         "index.js"
       ]
     },
-    "settings": {
+    "status": {
       "aliases": [],
       "args": {},
-      "description": "View and update project settings",
+      "description": "View email performance metrics and quota usage",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> status",
+        "<%= config.bin %> status --json"
       ],
       "flags": {
         "json": {
@@ -553,18 +552,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": "status",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -574,17 +566,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "status",
         "index.js"
       ]
     },
-    "status": {
+    "settings": {
       "aliases": [],
       "args": {},
-      "description": "View email performance metrics and quota usage",
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> status",
-        "<%= config.bin %> status --json"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -599,11 +592,18 @@
           "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": "status",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -613,10 +613,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "status",
+        "settings",
         "index.js"
       ]
     }
   },
-  "version": "0.0.14"
+  "version": "0.0.15-beta.pr17.25"
 }

package/package.json

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