@mailmodo/cli 0.0.14-beta.pr16.23 → 0.0.15-beta.pr17.24

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/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/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"
@@ -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,45 +296,6 @@
         "index.js"
       ]
     },
-    "emails": {
-      "aliases": [],
-      "args": {},
-      "description": "List and view configured email sequences",
-      "examples": [
-        "<%= config.bin %> emails",
-        "<%= config.bin %> emails --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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "emails",
-      "pluginAlias": "@mailmodo/cli",
-      "pluginName": "@mailmodo/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "emails",
-        "index.js"
-      ]
-    },
     "init": {
       "aliases": [],
       "args": {},
@@ -618,5 +618,5 @@
       ]
     }
   },
-  "version": "0.0.14-beta.pr16.23"
+  "version": "0.0.15-beta.pr17.24"
 }

package/package.json

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