groundmail-cli 0.36.0 → 0.37.0

package/README.md

@@ -74,6 +74,8 @@ groundmail workspaces use <name>
 groundmail domains list
 groundmail domains verify example.com
 groundmail webhooks list
+groundmail webhooks deliveries list --webhook <webhook-id> --status failed
+groundmail webhooks deliveries resend --webhook <webhook-id> --id <delivery-id>
 groundmail emails list
 groundmail batches get batch_…                           # status counts for an emails batch
 groundmail batches cancel batch_…                        # cancel the batch's emails that are still scheduled

package/dist/cli.js

@@ -2001,6 +2001,57 @@ function parseEnabledFlag(value) {
   return { error: "--enabled must be true or false" };
 }
 
+// src/commands/webhooks/deliveries.ts
+var VALUE_FILTERS = {
+  "--status": "status",
+  "--event": "event",
+  "--email-id": "email_id",
+  "--q": "q",
+  "--cursor": "cursor"
+};
+function listParams(args) {
+  const params = {};
+  for (const [flag, key] of Object.entries(VALUE_FILTERS)) {
+    const value = readFlag13(args, flag);
+    if (value) params[key] = value;
+  }
+  const limit = readFlag13(args, "--limit");
+  if (limit) {
+    const parsed = Number(limit);
+    if (!Number.isInteger(parsed) || parsed < 1) return { error: "--limit must be a positive whole number." };
+    params.limit = parsed;
+  }
+  const test = readFlag13(args, "--test");
+  if (test) {
+    if (test !== "true" && test !== "false") return { error: "--test must be true or false." };
+    params.test = test === "true";
+  }
+  return params;
+}
+async function runDeliveriesCommand(args, env = process.env) {
+  const [action, ...rest] = args;
+  if (action !== "list" && action !== "get" && action !== "resend") {
+    return { exitCode: 1, error: "Usage: groundmail webhooks deliveries list|get|resend --webhook <webhook-id> [--id <delivery-id>]" };
+  }
+  const options = parseWebhooksCommonArgs(rest);
+  const apiKey = resolveApiKey6(options, env);
+  if (!apiKey) return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY or pass --api-key." };
+  const webhookId = readFlag13(rest, "--webhook");
+  if (!webhookId) return { exitCode: 1, error: "Missing webhook id. Pass --webhook <webhook-id>." };
+  const deliveryId = readFlag13(rest, "--id");
+  if (action !== "list" && !deliveryId) return { exitCode: 1, error: "Missing delivery id. Pass --id <delivery-id>." };
+  const params = action === "list" ? listParams(rest) : null;
+  if (params && "error" in params) return { exitCode: 1, error: params.error };
+  try {
+    const { webhooks } = await createWebhooksClient(apiKey, options.baseUrl);
+    const result = action === "list" ? await webhooks.deliveries.list(webhookId, params ?? {}) : action === "get" ? await webhooks.deliveries.get(webhookId, deliveryId) : await webhooks.deliveries.resend(webhookId, deliveryId);
+    console.log(JSON.stringify(result));
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 // src/commands/keys/list.ts
 function readFlag16(args, flag) {
   const index = args.indexOf(flag);
@@ -2055,7 +2106,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.36.0";
+var version = "0.37.0";
 
 // src/user-agent.ts
 function buildUserAgent(own) {
@@ -4806,6 +4857,9 @@ var USAGE_LINES = [
   "  groundmail webhooks get --id wh_\u2026",
   "  groundmail webhooks update --id wh_\u2026 [--url \u2026] [--event email.sent] [--enabled true|false] [--tenants a,b|all]",
   "  groundmail webhooks delete --id <webhook-id>",
+  "  groundmail webhooks deliveries list --webhook <webhook-id> [--status failed] [--event email.delivered] [--email-id msg_\u2026] [--q \u2026] [--test true|false] [--limit 25] [--cursor \u2026]",
+  "  groundmail webhooks deliveries get --webhook <webhook-id> --id <delivery-id>",
+  "  groundmail webhooks deliveries resend --webhook <webhook-id> --id <delivery-id>",
   "  groundmail validate user@example.com   Groundmail validation: verdict, reasons, typo suggestion (exit 2 when invalid)",
   "  groundmail suppressions list [--tenant <tenant>]",
   "  groundmail suppressions add --email user@example.com [--reason \u2026] [--tenant <tenant>]",
@@ -5083,6 +5137,11 @@ async function main() {
     }
   }
   if (command === "webhooks") {
+    if (subcommand === "deliveries") {
+      const result = await runDeliveriesCommand(rest);
+      if (result.error) console.error(result.error);
+      process.exit(result.exitCode);
+    }
     if (subcommand === "list") {
       const result = await runListCommand5(rest);
       if (result.error) console.error(result.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-cli",
-  "version": "0.36.0",
+  "version": "0.37.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.38.0"
+    "groundmail": "0.39.0"
   },
   "devDependencies": {
     "tsup": "^8.5.0",