groundmail-cli 0.18.1 → 0.20.0

package/dist/cli.js

@@ -69,6 +69,9 @@ async function runSendCommand(args, deps) {
       unsubscribe: options.unsubscribe
     });
     stdout(JSON.stringify(result));
+    if (result.test) {
+      stderr("Test send: simulated, nothing was delivered. Its status and webhooks are marked test.");
+    }
     return 0;
   } catch (error) {
     stderr(error instanceof Error ? error.message : String(error));
@@ -109,8 +112,8 @@ function createDefaultSendDeps(apiKey, baseUrl) {
   return {
     sendEmail: async (params) => {
       const { Groundmail } = await import("groundmail");
-      const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
-      return client.emails.send(params);
+      const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+      return client2.emails.send(params);
     }
   };
 }
@@ -179,10 +182,10 @@ async function runBatchCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runBatchCommand(args, {
     env,
-    sendBatch: (emails) => client.emails.batch(emails)
+    sendBatch: (emails) => client2.emails.batch(emails)
   });
 }
 function parseBatchPayload(source) {
@@ -235,10 +238,10 @@ async function runCancelCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runCancelCommand(args, {
     env,
-    cancelEmail: (id) => client.emails.cancel(id)
+    cancelEmail: (id) => client2.emails.cancel(id)
   });
 }
 
@@ -278,10 +281,10 @@ async function runResendCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runResendCommand(args, {
     env,
-    resendEmail: (id) => client.emails.resend(id)
+    resendEmail: (id) => client2.emails.resend(id)
   });
 }
 
@@ -321,10 +324,10 @@ async function runGetCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runGetCommand(args, {
     env,
-    getEmail: (id) => client.emails.get(id)
+    getEmail: (id) => client2.emails.get(id)
   });
 }
 
@@ -364,10 +367,10 @@ async function runInsightsCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runInsightsCommand(args, {
     env,
-    getInsights: (window) => client.emails.insights(window)
+    getInsights: (window) => client2.emails.insights(window)
   });
 }
 
@@ -389,10 +392,16 @@ async function runListCommand(args, deps) {
   const limitRaw = readFlag7(args, "--limit");
   const cursor = readFlag7(args, "--cursor");
   const limit = limitRaw ? Number(limitRaw) : void 0;
+  if (args.includes("--test") && args.includes("--live")) {
+    stderr("Pass --test or --live, not both.");
+    return { exitCode: 1, error: "conflicting flags" };
+  }
+  const test = args.includes("--test") ? true : args.includes("--live") ? false : void 0;
   try {
     const result = await deps.listEmails({
       ...limit != null && Number.isFinite(limit) ? { limit } : {},
-      ...cursor ? { cursor } : {}
+      ...cursor ? { cursor } : {},
+      ...test !== void 0 ? { test } : {}
     });
     stdout(JSON.stringify(result));
     return { exitCode: 0 };
@@ -408,10 +417,10 @@ async function runListCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   return runListCommand(args, {
     env,
-    listEmails: (params) => client.emails.list(params)
+    listEmails: (params) => client2.emails.list(params)
   });
 }
 
@@ -458,8 +467,8 @@ async function runSendEventCommand(args, env = process.env) {
     }
   }
   try {
-    const client = await createClient(apiKey, baseUrl);
-    const result = await client.events.trigger({
+    const client2 = await createClient(apiKey, baseUrl);
+    const result = await client2.events.trigger({
       name,
       email,
       user_id: userId,
@@ -542,8 +551,8 @@ async function runListCommand2(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.list();
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.list();
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -561,8 +570,8 @@ async function runGetCommand2(args, env = process.env) {
   const id = readFlag9(args, "--id");
   if (!id) return { exitCode: 1, error: "Required flag: --id" };
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.get(id);
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.get(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -590,8 +599,8 @@ async function runCreateCommand(args, env = process.env) {
     return { exitCode: 1, error: "Required: --steps or steps in --file" };
   }
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.create({
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.create({
       name,
       trigger,
       steps
@@ -622,8 +631,8 @@ async function runUpdateCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.update(id, {
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.update(id, {
       ...name ? { name } : {},
       ...trigger ? { trigger } : {},
       ...steps ? { steps } : {}
@@ -645,8 +654,8 @@ async function runActivateCommand(args, env = process.env) {
   const id = readFlag9(args, "--id");
   if (!id) return { exitCode: 1, error: "Required flag: --id" };
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.activate(id);
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.activate(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -662,8 +671,8 @@ async function runPauseCommand(args, env = process.env) {
   const id = readFlag9(args, "--id");
   if (!id) return { exitCode: 1, error: "Required flag: --id" };
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.pause(id);
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.pause(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -679,8 +688,8 @@ async function runDeleteCommand(args, env = process.env) {
   const id = readFlag9(args, "--id");
   if (!id) return { exitCode: 1, error: "Required flag: --id" };
   try {
-    const client = await createAutomationsClient(apiKey, options.baseUrl);
-    const result = await client.automations.remove(id);
+    const client2 = await createAutomationsClient(apiKey, options.baseUrl);
+    const result = await client2.automations.remove(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -740,9 +749,9 @@ async function runAddCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
     const inbound = readFlag10(args, "--inbound");
-    const result = await client.domains.create({
+    const result = await client2.domains.create({
       name,
       ...inbound === "true" || inbound === "1" ? { inbound_enabled: true } : {}
     });
@@ -788,12 +797,12 @@ async function runApplyCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
     const localCloudflare = env.CLOUDFLARE_API_TOKEN || env.CLOUDFLARE_API_KEY;
     const localVercel = env.VERCEL_API_TOKEN;
     const useStoredCloudflare = provider === "cloudflare" && !localCloudflare;
     const useStoredVercel = provider === "vercel" && !localVercel;
-    const result = useStoredCloudflare || useStoredVercel ? await client.domains.apply(idOrName, { provider }) : await client.domains.applyDns({
+    const result = useStoredCloudflare || useStoredVercel ? await client2.domains.apply(idOrName, { provider }) : await client2.domains.applyDns({
       idOrName,
       provider,
       cloudflareApiToken: localCloudflare,
@@ -827,8 +836,8 @@ async function runDeleteCommand2(args, env = process.env) {
   const idOrName = options.id || options.name || readFirstPositional2(args);
   if (!idOrName) return { exitCode: 1, error: "Missing domain. Usage: groundmail domains delete example.com" };
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.domains.delete(idOrName)));
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.domains.delete(idOrName)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -855,8 +864,8 @@ async function runGetCommand3(args, env = process.env) {
   const idOrName = options.id || options.name || readFirstPositional3(args);
   if (!idOrName) return { exitCode: 1, error: "Missing domain. Usage: groundmail domains get example.com" };
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.domains.get(idOrName)));
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.domains.get(idOrName)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -882,8 +891,8 @@ async function runListCommand3(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
-    const result = await client.domains.list();
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
+    const result = await client2.domains.list();
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -954,8 +963,8 @@ async function runUpdateCommand2(args, env = process.env) {
         error: "No updates provided. Pass --inbound true|false, --tls-mode opportunistic|enforced, --open-tracking true|false, or --click-tracking true|false."
       };
     }
-    const client = await createDomainsClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.domains.update(idOrName, payload)));
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.domains.update(idOrName, payload)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -977,8 +986,8 @@ async function runVerifyCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createDomainsClient(apiKey, options.baseUrl);
-    const result = await client.domains.verify(idOrName);
+    const client2 = await createDomainsClient(apiKey, options.baseUrl);
+    const result = await client2.domains.verify(idOrName);
     console.log(JSON.stringify(result));
     if (result.verified) {
       console.error(`Domain ${result.domain.name} verified.`);
@@ -1034,8 +1043,8 @@ async function runGetCommand4(args, env = process.env) {
     return { exitCode: 1, error: "Missing id. Usage: groundmail received-emails get inb_..." };
   }
   try {
-    const client = await createReceivedEmailsClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.receivedEmails.get(id)));
+    const client2 = await createReceivedEmailsClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.receivedEmails.get(id)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -1050,10 +1059,10 @@ async function runListCommand4(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createReceivedEmailsClient(apiKey, options.baseUrl);
+    const client2 = await createReceivedEmailsClient(apiKey, options.baseUrl);
     console.log(
       JSON.stringify(
-        await client.receivedEmails.list({
+        await client2.receivedEmails.list({
           limit: readFlag11(args, "--limit") ? Number(readFlag11(args, "--limit")) : void 0,
           cursor: readFlag11(args, "--cursor"),
           domain: readFlag11(args, "--domain")
@@ -1098,8 +1107,8 @@ async function runCreateCommand2(args, env = process.env) {
     return { exitCode: 1, error: "Required flag: --url" };
   }
   try {
-    const client = await createWebhooksClient(apiKey, options.baseUrl);
-    const result = await client.webhooks.create({ url });
+    const client2 = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client2.webhooks.create({ url });
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -1116,8 +1125,8 @@ async function runGetCommand5(args, env = process.env) {
   const id = readFlag13(args, "--id") || readFirstPositional6(args);
   if (!id) return { exitCode: 1, error: "Missing webhook id. Pass --id wh_\u2026" };
   try {
-    const client = await createWebhooksClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.webhooks.get(id)));
+    const client2 = await createWebhooksClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.webhooks.get(id)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -1151,8 +1160,8 @@ async function runDeleteCommand3(args, env = process.env) {
     return { exitCode: 1, error: "Required flag: --id" };
   }
   try {
-    const client = await createWebhooksClient(apiKey, options.baseUrl);
-    const result = await client.webhooks.delete(id);
+    const client2 = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client2.webhooks.delete(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -1168,8 +1177,8 @@ async function runListCommand5(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createWebhooksClient(apiKey, options.baseUrl);
-    const result = await client.webhooks.list();
+    const client2 = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = await client2.webhooks.list();
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -1198,8 +1207,8 @@ async function runUpdateCommand3(args, env = process.env) {
     ...enabled.value !== void 0 ? { enabled: enabled.value } : {}
   };
   try {
-    const client = await createWebhooksClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.webhooks.update(id, payload)));
+    const client2 = await createWebhooksClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.webhooks.update(id, payload)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -1247,11 +1256,11 @@ async function runListKeysCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   try {
     const limitRaw = readFlag15(args, "--limit");
     const cursor = readFlag15(args, "--cursor");
-    const result = await client.apiKeys.list({
+    const result = await client2.apiKeys.list({
       ...limitRaw ? { limit: Number(limitRaw) } : {},
       ...cursor ? { cursor } : {}
     });
@@ -1288,7 +1297,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.18.1";
+var version = "0.20.0";
 
 // src/user-agent.ts
 function buildUserAgent(own) {
@@ -2146,6 +2155,7 @@ async function runCreateKeyCommandWithClient(args, env = process.env) {
   if (scopes && !scopes.ok) return { exitCode: 1, error: scopes.error };
   const domainsFlag = readFlag16(args, "--allowed-domains");
   const allowedDomains = domainsFlag?.split(/[\s,]+/).map((domain) => domain.trim()).filter(Boolean);
+  const test = args.includes("--test");
   try {
     const response = await apiRequest(baseUrl, "/api-keys", {
       apiKey,
@@ -2154,13 +2164,17 @@ async function runCreateKeyCommandWithClient(args, env = process.env) {
         ...name ? { name } : {},
         ...scope && !scopes ? { scope } : {},
         ...scopes?.ok ? { scopes: scopes.scope.split(" ") } : {},
-        ...allowedDomains?.length ? { allowed_domains: allowedDomains } : {}
+        ...allowedDomains?.length ? { allowed_domains: allowedDomains } : {},
+        ...test ? { test: true } : {}
       }
     });
     if (!response.ok) {
       return { exitCode: 1, error: errorMessage(response, "Could not create the key") };
     }
     console.log(JSON.stringify(response.body));
+    if (test) {
+      console.error("Test key: sends with it run every check and fire webhooks, but nothing is delivered. https://docs.groundmail.dev/testing");
+    }
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2184,9 +2198,9 @@ async function runDeleteKeyCommandWithClient(args, env = process.env) {
     return { exitCode: 1, error: "Required: --id <api-key-id>" };
   }
   const { Groundmail } = await import("groundmail");
-  const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+  const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
   try {
-    const result = await client.apiKeys.remove(id);
+    const result = await client2.apiKeys.remove(id);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -2224,11 +2238,11 @@ async function runListCommand6(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const client2 = await createSuppressionsClient(apiKey, options.baseUrl);
     const limitRaw = readFlag18(args, "--limit");
     const cursor = readFlag18(args, "--cursor");
     const email = readFlag18(args, "--email");
-    const result = await client.suppressions.list({
+    const result = await client2.suppressions.list({
       ...limitRaw ? { limit: Number(limitRaw) } : {},
       ...cursor ? { cursor } : {},
       ...email ? { email } : {}
@@ -2252,9 +2266,9 @@ async function runAddCommand2(args, env = process.env) {
     return { exitCode: 1, error: "Missing email. Pass --email user@example.com" };
   }
   try {
-    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const client2 = await createSuppressionsClient(apiKey, options.baseUrl);
     const reason = readFlag18(args, "--reason");
-    const result = await client.suppressions.create({
+    const result = await client2.suppressions.create({
       email,
       ...reason ? { reason } : {}
     });
@@ -2277,8 +2291,8 @@ async function runRemoveCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing id or email. Pass --id <uuid> or --email user@example.com" };
   }
   try {
-    const client = await createSuppressionsClient(apiKey, options.baseUrl);
-    const result = await client.suppressions.remove(idOrEmail);
+    const client2 = await createSuppressionsClient(apiKey, options.baseUrl);
+    const result = await client2.suppressions.remove(idOrEmail);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -2315,8 +2329,8 @@ async function runDeleteCommand4(args, env = process.env) {
   const idOrAlias = readFlag19(args, "--id") || readFlag19(args, "--alias") || readFirstPositional8(args);
   if (!idOrAlias) return { exitCode: 1, error: "Missing template id or alias. Pass --id tpl_\u2026 or --alias welcome" };
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.remove(idOrAlias)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.remove(idOrAlias)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2344,8 +2358,8 @@ async function runDuplicateCommand(args, env = process.env) {
   if (!idOrAlias) return { exitCode: 1, error: "Missing template id or alias. Pass --id tpl_\u2026 or --alias welcome" };
   const name = readFlag19(args, "--name");
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.duplicate(idOrAlias, name ? { name } : {})));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.duplicate(idOrAlias, name ? { name } : {})));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2372,8 +2386,8 @@ async function runGetCommand6(args, env = process.env) {
   const idOrAlias = readFlag19(args, "--id") || readFlag19(args, "--alias") || readFirstPositional10(args);
   if (!idOrAlias) return { exitCode: 1, error: "Missing template id or alias. Pass --id tpl_\u2026 or --alias welcome" };
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.get(idOrAlias)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.get(idOrAlias)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2399,11 +2413,11 @@ async function runListCommand7(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
     const limitRaw = readFlag19(args, "--limit");
     const cursor = readFlag19(args, "--cursor");
     const status = readFlag19(args, "--status");
-    const result = await client.templates.list({
+    const result = await client2.templates.list({
       ...limitRaw ? { limit: Number(limitRaw) } : {},
       ...cursor ? { cursor } : {},
       ...status ? { status } : {}
@@ -2424,8 +2438,8 @@ async function runPublishCommand(args, env = process.env) {
   const idOrAlias = readFlag19(args, "--id") || readFlag19(args, "--alias") || readFirstPositional11(args);
   if (!idOrAlias) return { exitCode: 1, error: "Missing template id or alias. Pass --id tpl_\u2026 or --alias welcome" };
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.publish(idOrAlias)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.publish(idOrAlias)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2600,10 +2614,10 @@ async function runPushCommand(args, env = process.env, deps = {}) {
       return { exitCode: 1, error: `${file} produced no content to push.` };
     }
     const createClient2 = deps.createClient ?? createTemplatesClient;
-    const client = await createClient2(apiKey, options.baseUrl);
+    const client2 = await createClient2(apiKey, options.baseUrl);
     let existed = true;
     try {
-      await client.templates.get(alias);
+      await client2.templates.get(alias);
     } catch (error) {
       if (statusOf(error) !== 404) throw error;
       existed = false;
@@ -2618,7 +2632,7 @@ async function runPushCommand(args, env = process.env, deps = {}) {
     };
     let result;
     if (existed) {
-      result = await client.templates.update(alias, body);
+      result = await client2.templates.update(alias, body);
     } else {
       if (!subject) {
         return {
@@ -2626,7 +2640,7 @@ async function runPushCommand(args, env = process.env, deps = {}) {
           error: `Template "${alias}" does not exist yet. Pass --subject to create it.`
         };
       }
-      result = await client.templates.create({
+      result = await client2.templates.create({
         name: name || alias,
         subject,
         alias,
@@ -2634,7 +2648,7 @@ async function runPushCommand(args, env = process.env, deps = {}) {
       });
     }
     if (shouldPublish) {
-      result = await client.templates.publish(alias);
+      result = await client2.templates.publish(alias);
     }
     console.log(JSON.stringify({ ...result, pushed: { file, alias, created: !existed } }));
     return { exitCode: 0 };
@@ -2667,8 +2681,8 @@ async function runCreateCommand3(args, env = process.env) {
     return { exitCode: 1, error: 'Missing body. Pass --html "<p>Hi</p>" or --text "Hi"' };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    const result = await client.templates.create({
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    const result = await client2.templates.create({
       name,
       subject,
       ...html ? { html } : {},
@@ -2723,8 +2737,8 @@ async function runUpdateCommand4(args, env = process.env) {
     };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    const result = await client.templates.update(idOrAlias, {
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    const result = await client2.templates.update(idOrAlias, {
       ...name ? { name } : {},
       ...subject ? { subject } : {},
       ...html ? { html } : {},
@@ -2787,8 +2801,8 @@ async function runFromStarterCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.fromStarter(alias)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.fromStarter(alias)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2801,8 +2815,8 @@ async function runListStartersCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.listStarters()));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.listStarters()));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2833,8 +2847,8 @@ async function runVersionsCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing template id or alias. Pass --id tpl_\u2026 or --alias welcome" };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.listVersions(idOrAlias)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.listVersions(idOrAlias)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2856,8 +2870,8 @@ async function runRestoreCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.restoreVersion(idOrAlias, version2)));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.restoreVersion(idOrAlias, version2)));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2879,8 +2893,8 @@ async function runTestSendCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createTemplatesClient(apiKey, options.baseUrl);
-    console.log(JSON.stringify(await client.templates.testSend(idOrAlias, { from, to })));
+    const client2 = await createTemplatesClient(apiKey, options.baseUrl);
+    console.log(JSON.stringify(await client2.templates.testSend(idOrAlias, { from, to })));
     return { exitCode: 0 };
   } catch (error) {
     return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
@@ -2915,8 +2929,8 @@ async function runTwilioStatusCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createIntegrationsClient(apiKey, options.baseUrl);
-    const result = await client.integrations.getTwilio();
+    const client2 = await createIntegrationsClient(apiKey, options.baseUrl);
+    const result = await client2.integrations.getTwilio();
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -2946,8 +2960,8 @@ async function runTwilioConnectCommand(args, env = process.env) {
     };
   }
   try {
-    const client = await createIntegrationsClient(apiKey, options.baseUrl);
-    const result = await client.integrations.connectTwilio({
+    const client2 = await createIntegrationsClient(apiKey, options.baseUrl);
+    const result = await client2.integrations.connectTwilio({
       accountSid: accountSid.trim(),
       authToken: authToken.trim(),
       ...defaultFrom.trim() ? { defaultFrom: defaultFrom.trim() } : {},
@@ -2966,8 +2980,8 @@ async function runTwilioDisconnectCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   try {
-    const client = await createIntegrationsClient(apiKey, options.baseUrl);
-    const result = await client.integrations.disconnectTwilio();
+    const client2 = await createIntegrationsClient(apiKey, options.baseUrl);
+    const result = await client2.integrations.disconnectTwilio();
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
   } catch (error) {
@@ -3120,6 +3134,7 @@ var KEY_ENV = {
   mailgun: "MAILGUN_API_KEY"
 };
 var LABELS = { sendgrid: "SendGrid", postmark: "Postmark", mailgun: "Mailgun" };
+var VALUE_FLAGS2 = /* @__PURE__ */ new Set(["--api-key", "--base-url"]);
 function readFlag21(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1) return void 0;
@@ -3148,6 +3163,10 @@ function formatMigrationSummary(m) {
     lines.push(
       m.dry_run ? `  Suppressions   ${n(s.found)}${m.suppressions.estimated ? "+ (first page of each list)" : ""}` : `  Suppressions   ${n(s.imported)} added, ${n(s.already_suppressed)} already suppressed`
     );
+    if (s.product_opt_out) lines.push(`                 ${n(s.product_opt_out)} of them product email opt-outs (transactional mail still reaches them)`);
+    for (const [reason, count] of Object.entries(m.suppressions.skipped_reasons)) {
+      lines.push(`                 ${n(count)} skipped: ${reason}`);
+    }
   }
   if (m.errors.length) {
     lines.push("", "Could not read:");
@@ -3163,6 +3182,17 @@ function formatMigrationSummary(m) {
     for (const line of failed.slice(0, 20)) lines.push(`  ${line}`);
     if (failed.length > 20) lines.push(`  \u2026and ${failed.length - 20} more (see the JSON report)`);
   }
+  const plans = (m.domains?.items ?? []).filter((d) => d.dns_plan);
+  for (const d of plans) {
+    const changes = d.dns_plan.changes.filter((c) => c.action === "add" || c.action === "update");
+    lines.push("", `DNS changes for ${d.name}${changes.length ? "" : ": all published"}`);
+    for (const c of changes) {
+      lines.push(`  ${c.action === "update" ? "edit" : "add "} ${c.type.padEnd(5)} ${c.host}  ${c.value}`);
+      if (c.action === "update" && c.current) lines.push(`        now: ${c.current}`);
+    }
+    for (const c of d.dns_plan.changes.filter((c2) => c2.action === "keep")) lines.push(`  keep ${c.type.padEnd(5)} ${c.host} (yours)`);
+    lines.push(`  ${d.dns_plan.keep_old_records}`);
+  }
   if (m.attention.length) {
     lines.push("", "Next:");
     for (const line of m.attention) lines.push(`  - ${line}`);
@@ -3170,11 +3200,48 @@ function formatMigrationSummary(m) {
   const node = m.code_changes?.find((c) => c.stack === "node");
   if (node) lines.push("", "Code change (Node.js):", node.diff);
   if (m.agent_prompt) lines.push("", "Prompt for your coding agent is in the JSON report (`agent_prompt`).");
+  if (!m.dry_run && !m.has_more) lines.push("", `Report: groundmail migrate report ${m.id} --csv > import-report.csv`);
   return lines.join("\n");
 }
+async function client(args, env) {
+  const apiKey = readFlag21(args, "--api-key") || env.GROUNDMAIL_API_KEY;
+  if (!apiKey) return null;
+  const { Groundmail } = await import("groundmail");
+  const baseUrl = readFlag21(args, "--base-url");
+  return new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+}
+async function runStoredCommand(sub, args, env) {
+  const gm = await client(args, env);
+  if (!gm) return { exitCode: 1, error: "Not signed in. Run `groundmail login`, or set GROUNDMAIL_API_KEY." };
+  try {
+    if (sub === "list") {
+      const { data } = await gm.migrations.list();
+      console.log(JSON.stringify({ data }));
+      for (const m of data) console.error(`${m.id}  ${LABELS[m.provider]}  ${m.status}  ${m.started_at.slice(0, 10)}`);
+      if (!data.length) console.error("No imports yet. Previews are not stored.");
+      return { exitCode: 0 };
+    }
+    const id = args.find((arg, i) => !arg.startsWith("--") && !VALUE_FLAGS2.has(args[i - 1] ?? ""));
+    if (!id) return { exitCode: 1, error: "Usage: groundmail migrate report <import id> [--csv]" };
+    if (args.includes("--csv")) {
+      process.stdout.write(await gm.migrations.reportCsv(id));
+      return { exitCode: 0 };
+    }
+    const { migration } = await gm.migrations.get(id);
+    console.log(JSON.stringify(migration));
+    console.error(formatMigrationSummary(migration));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
 async function runMigrateCommand(provider, args, env = process.env) {
+  if (provider === "list" || provider === "report") return runStoredCommand(provider, args, env);
   if (!provider || !PROVIDERS.includes(provider)) {
-    return { exitCode: 1, error: "Usage: groundmail migrate <sendgrid|postmark|mailgun> [--dry-run] [--only templates,suppressions]" };
+    return {
+      exitCode: 1,
+      error: "Usage: groundmail migrate <sendgrid|postmark|mailgun> [--dry-run] [--only templates,suppressions], groundmail migrate list, or groundmail migrate report <id> [--csv]"
+    };
   }
   const id = provider;
   const apiKey = readFlag21(args, "--api-key") || env.GROUNDMAIL_API_KEY;
@@ -3210,9 +3277,9 @@ async function runMigrateCommand(provider, args, env = process.env) {
   try {
     const { Groundmail } = await import("groundmail");
     const baseUrl = readFlag21(args, "--base-url");
-    const client = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
+    const client2 = new Groundmail(apiKey, baseUrl ? { baseUrl } : void 0);
     console.error(`${params.dry_run ? "Previewing" : "Importing"} from ${LABELS[id]} (Beta)\u2026`);
-    const report = await client.migrations.run(params, {
+    const report = await client2.migrations.run(params, {
       onProgress: (m) => {
         if (m.has_more) {
           const s = m.suppressions?.totals;
@@ -3242,8 +3309,8 @@ async function runValidateCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing email. Usage: groundmail validate user@example.com" };
   }
   try {
-    const client = await createSuppressionsClient(apiKey, options.baseUrl);
-    const result = await client.validate(email);
+    const client2 = await createSuppressionsClient(apiKey, options.baseUrl);
+    const result = await client2.validate(email);
     console.log(JSON.stringify(result));
     return { exitCode: result.verdict === "invalid" ? 2 : 0 };
   } catch (error) {
@@ -3272,7 +3339,7 @@ var USAGE_LINES = [
   "  groundmail received-emails get inb_...",
   '  groundmail emails send --from you@domain.com --to user@example.com --subject "Hello" --html "<p>Hi</p>" [--category transactional|product] [--unsubscribe]',
   "  groundmail emails batch --file ./emails.json",
-  "  groundmail emails list [--limit 25] [--cursor \u2026]",
+  "  groundmail emails list [--limit 25] [--cursor \u2026] [--test | --live]",
   "  groundmail emails insights [--window 7d|30d]",
   "  groundmail emails get --id msg_\u2026",
   "  groundmail emails cancel --id msg_\u2026",
@@ -3310,11 +3377,13 @@ var USAGE_LINES = [
   '  groundmail templates duplicate --id tpl_\u2026 [--name "Copy"]',
   "  groundmail templates delete --id tpl_\u2026",
   "  groundmail keys list",
-  "  groundmail keys create [--name Default] [--scopes emails:send,domains:read] [--allowed-domains example.com]",
+  "  groundmail keys create [--name Default] [--scopes emails:send,domains:read] [--allowed-domains example.com] [--test]   --test: a gm_test_ key, sends are simulated",
   "  groundmail keys delete --id <api-key-id>",
   "  groundmail migrate sendgrid [--dry-run] [--only templates,suppressions,domains,webhooks] [--region eu]   import from SendGrid (Beta)",
   "  groundmail migrate postmark [--dry-run] [--only \u2026]   import from Postmark (Beta)",
   "  groundmail migrate mailgun [--dry-run] [--only \u2026] [--region eu]   import from Mailgun (Beta)",
+  "  groundmail migrate list                          your recent imports",
+  "  groundmail migrate report <id> [--csv]           an import report (JSON, or CSV to stdout)",
   "  groundmail integrations twilio status",
   "  groundmail integrations twilio connect --account-sid AC\u2026 --auth-token \u2026 --from +15551234567",
   "  groundmail integrations twilio disconnect"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-cli",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "description": "Groundmail CLI — send transactional email from the terminal",
   "license": "MIT",
   "type": "module",
@@ -38,7 +38,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "groundmail": "0.15.1"
+    "groundmail": "0.17.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",