groundmail-cli 0.25.1 → 0.26.1

package/README.md

@@ -81,6 +81,14 @@ groundmail tenants resume cus_123
 `suppressions` and `keys create` (a key limited to one tenant). `webhooks create` and
 `webhooks update` take `--tenants a,b` to receive only those tenants' email events.
 
+When a reader re-subscribes to a tenant's newsletter, remove their one-click opt-out so
+sends in that category go through again:
+
+```bash
+groundmail suppressions list --type category_opt_out --tenant cus_123
+groundmail suppressions remove --type category_opt_out --email reader@example.com --category newsletter --tenant cus_123
+```
+
 ## Docs
 
 - CLI: https://docs.groundmail.dev/cli

package/dist/cli.js

@@ -1452,7 +1452,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.25.1";
+var version = "0.26.1";
 
 // src/user-agent.ts
 function buildUserAgent(own) {
@@ -2400,6 +2400,26 @@ async function runListCommand6(args, env = process.env) {
     const cursor = readFlag19(args, "--cursor");
     const email = readFlag19(args, "--email");
     const tenant = readFlag19(args, "--tenant");
+    const type = readFlag19(args, "--type");
+    if (type && type !== "suppression" && type !== "category_opt_out") {
+      return { exitCode: 1, error: "--type must be suppression or category_opt_out" };
+    }
+    if (type === "category_opt_out") {
+      const category = readFlag19(args, "--category");
+      if (category && category !== "product" && category !== "newsletter") {
+        return { exitCode: 1, error: "--category must be product or newsletter" };
+      }
+      const optOuts = await client2.suppressions.listCategoryOptOuts({
+        ...limitRaw ? { limit: Number(limitRaw) } : {},
+        ...cursor ? { cursor } : {},
+        ...email ? { email } : {},
+        ...category ? { category } : {},
+        ...tenant ? { tenant } : {},
+        ...args.includes("--include-tenants") ? { includeTenants: true } : {}
+      });
+      console.log(JSON.stringify(optOuts));
+      return { exitCode: 0 };
+    }
     const result = await client2.suppressions.list({
       ...limitRaw ? { limit: Number(limitRaw) } : {},
       ...cursor ? { cursor } : {},
@@ -2448,14 +2468,30 @@ async function runRemoveCommand(args, env = process.env) {
     return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
   }
   const tenant = readFlag19(args, "--tenant");
+  const type = readFlag19(args, "--type");
+  const category = readFlag19(args, "--category");
+  if (type && type !== "suppression" && type !== "category_opt_out") {
+    return { exitCode: 1, error: "--type must be suppression or category_opt_out" };
+  }
+  if (category && category !== "product" && category !== "newsletter") {
+    return { exitCode: 1, error: "--category must be product or newsletter" };
+  }
   const idOrEmail = readFlag19(args, "--id") || readFlag19(args, "--email") || args.find(
-    (a, i) => !a.startsWith("-") && a !== "remove" && a !== "delete" && !["--tenant", "--api-key", "--base-url"].includes(args[i - 1] ?? "")
+    (a, i) => !a.startsWith("-") && a !== "remove" && a !== "delete" && !["--tenant", "--type", "--category", "--api-key", "--base-url"].includes(args[i - 1] ?? "")
   );
   if (!idOrEmail) {
     return { exitCode: 1, error: "Missing id or email. Pass --id <uuid> or --email user@example.com" };
   }
   try {
     const client2 = await createSuppressionsClient(apiKey, options.baseUrl);
+    if (type === "category_opt_out") {
+      const optOut = await client2.suppressions.removeCategoryOptOut(idOrEmail, {
+        ...category ? { category } : {},
+        ...tenant ? { tenant } : {}
+      });
+      console.log(JSON.stringify(optOut));
+      return { exitCode: 0 };
+    }
     const result = tenant ? await client2.suppressions.remove(idOrEmail, { tenant }) : await client2.suppressions.remove(idOrEmail);
     console.log(JSON.stringify(result));
     return { exitCode: 0 };
@@ -3759,6 +3795,8 @@ var USAGE_LINES = [
   "  groundmail suppressions list [--tenant <tenant>]",
   "  groundmail suppressions add --email user@example.com [--reason \u2026] [--tenant <tenant>]",
   "  groundmail suppressions remove --id <id> | --email user@example.com [--tenant <tenant>]",
+  "  groundmail suppressions list --type category_opt_out [--category product|newsletter] [--tenant <tenant> | --include-tenants]   one-click category unsubscribes",
+  "  groundmail suppressions remove --type category_opt_out --email user@example.com [--category newsletter] [--tenant <tenant>]   re-subscribe to a category",
   "  groundmail templates list [--status draft|published]",
   "  groundmail templates starters",
   "  groundmail templates from-starter password-reset",

package/package.json

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