groundmail-cli 0.17.2 → 0.19.0

package/dist/cli.js

@@ -109,8 +109,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 +179,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 +235,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 +278,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 +321,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 +364,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)
   });
 }
 
@@ -408,10 +408,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 +458,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 +542,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 +561,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 +590,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 +622,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 +645,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 +662,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 +679,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 +740,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 +788,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 +827,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 +855,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 +882,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 +954,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 +977,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 +1034,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 +1050,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 +1098,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 +1116,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 +1151,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 +1168,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 +1198,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 +1247,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 +1288,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.17.2";
+var version = "0.19.0";
 
 // src/user-agent.ts
 function buildUserAgent(own) {
@@ -2184,9 +2184,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 +2224,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 +2252,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 +2277,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 +2315,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 +2344,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 +2372,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 +2399,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 +2424,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 +2600,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 +2618,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 +2626,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 +2634,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 +2667,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 +2723,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 +2787,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 +2801,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 +2833,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 +2856,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 +2879,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 +2915,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 +2946,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 +2966,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 +3120,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 +3149,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 +3168,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 +3186,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 +3263,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;
@@ -3229,6 +3282,28 @@ async function runMigrateCommand(provider, args, env = process.env) {
   }
 }
 
+// src/commands/validate.ts
+async function runValidateCommand(args, env = process.env) {
+  const options = parseSuppressionsCommonArgs(args);
+  const apiKey = resolveApiKey6(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY, pass --api-key, or run `groundmail login`." };
+  }
+  const flagValues = new Set([options.apiKey, options.baseUrl].filter(Boolean));
+  const email = readFlag18(args, "--email") || args.find((arg) => arg.includes("@") && !arg.startsWith("-") && !flagValues.has(arg));
+  if (!email) {
+    return { exitCode: 1, error: "Missing email. Usage: groundmail validate user@example.com" };
+  }
+  try {
+    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) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 // src/help.ts
 var USAGE_LINES = [
   "  groundmail login [--scope <scopes>] [--workspace <name>]   sign in through the browser (OAuth; no key to copy)",
@@ -3270,6 +3345,7 @@ var USAGE_LINES = [
   "  groundmail webhooks get --id wh_\u2026",
   "  groundmail webhooks update --id wh_\u2026 [--url \u2026] [--event email.sent] [--enabled true|false]",
   "  groundmail webhooks delete --id <webhook-id>",
+  "  groundmail validate user@example.com   Groundmail validation: verdict, reasons, typo suggestion (exit 2 when invalid)",
   "  groundmail suppressions list",
   "  groundmail suppressions add --email user@example.com [--reason \u2026]",
   "  groundmail suppressions remove --id <id> | --email user@example.com",
@@ -3292,6 +3368,8 @@ var USAGE_LINES = [
   "  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"
@@ -3381,6 +3459,7 @@ async function main() {
   if (session.notice) console.error(session.notice);
   const rest = session.argv;
   if (command === "migrate") await finish(await runMigrateCommand(subcommand, rest));
+  if (command === "validate") await finish(await runValidateCommand([...subcommand ? [subcommand] : [], ...rest]));
   if (command === "domains") {
     if (subcommand === "add" || subcommand === "create") {
       const result = await runAddCommand(rest);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-cli",
-  "version": "0.17.2",
+  "version": "0.19.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.14.8"
+    "groundmail": "0.16.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",