@garuhq/cli 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to `@garuhq/cli` are documented in this file. Format:
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
 
+## [0.4.0] — 2026-05-19
+
+### Added
+
+- `garu webhooks events` command tree — inspect and replay webhook
+  deliveries from the CLI. The dashboard "Reenviar" button is now
+  available from the API key auth path as well, which means support
+  + on-call workflows can resend events from a terminal instead of
+  having to log into the dashboard.
+  - `garu webhooks events list [--status <s>] [--event-type <t>] [--endpoint-id <n>] [--page <n>] [--limit <n>]`
+    — paginated listing with status badges (green `success`, yellow
+    `pending`, red `failed`) in TTY mode.
+  - `garu webhooks events get <id>` — fetch one webhook event with
+    the full endpoint snapshot, response status, and (truncated)
+    response body.
+  - `garu webhooks events retry <id>` — re-deliver a webhook event
+    (resets to `pending` and triggers an immediate attempt). Works on
+    any status; use this when a customer reports a missed event.
+
+### Changed
+
+- `@garuhq/node` SDK bumped to 0.11.0 for the new `webhookEvents`
+  resource and its response-shape normalization fix.
+
 ## [0.3.0] — 2026-04-28
 
 Rolls up the unpublished 0.2.0 work plus a new update notifier into a single

package/dist/index.cjs

@@ -15,7 +15,7 @@ var pc__default = /*#__PURE__*/_interopDefault(pc);
 // src/index.ts
 
 // src/version.ts
-var CLI_VERSION = "0.3.0";
+var CLI_VERSION = "0.4.0";
 var CliError = class extends Error {
   code;
   exitCode;
@@ -459,6 +459,98 @@ async function logoutCommand(opts = {}) {
   printSuccess(`Profile '${opts.profile}' removed.`, opts);
   return { cleared: opts.profile };
 }
+async function getClient2(opts) {
+  if (opts.garu) return opts.garu;
+  const auth = await resolveAuth({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.profile !== void 0 ? { profile: opts.profile } : {}
+  });
+  return createGaruClient({
+    auth,
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {}
+  });
+}
+async function webhooksEventsListCommand(opts) {
+  const garu = await getClient2(opts);
+  const params = {};
+  if (opts.page !== void 0) params.page = opts.page;
+  if (opts.limit !== void 0) params.limit = opts.limit;
+  if (opts.status !== void 0) params.status = opts.status;
+  if (opts.eventType !== void 0) params.eventType = opts.eventType;
+  if (opts.endpointId !== void 0) params.endpointId = opts.endpointId;
+  const result = await garu.webhookEvents.list(params);
+  printResult(result, { ...opts, prettyPrint: prettyWebhookEventList });
+  return result;
+}
+async function webhooksEventsGetCommand(opts) {
+  const garu = await getClient2(opts);
+  const event = await garu.webhookEvents.get(opts.id);
+  printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
+  return event;
+}
+async function webhooksEventsRetryCommand(opts) {
+  const garu = await getClient2(opts);
+  const event = await garu.webhookEvents.retry(opts.id);
+  printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
+  return event;
+}
+function statusBadge(status) {
+  const padded = status.padEnd(7);
+  if (status === "success") return pc__default.default.green(padded);
+  if (status === "failed") return pc__default.default.red(padded);
+  return pc__default.default.yellow(padded);
+}
+function prettyWebhookEventList(list) {
+  if (list.data.length === 0) {
+    return `No webhook events found (page ${list.meta.page}/${list.meta.totalPages || 1})`;
+  }
+  const header = `Webhook events (page ${list.meta.page}/${list.meta.totalPages || "?"}, ${list.meta.total} total)`;
+  const rows = list.data.map(
+    (e) => `  ${String(e.id).padStart(8)}  ${statusBadge(e.status)}  attempts=${String(e.attempts).padStart(2)}  ${e.eventType.padEnd(38)}  ${e.createdAt}`
+  );
+  return [header, ...rows].join("\n");
+}
+function prettyWebhookEvent(event) {
+  const lines = [
+    `Webhook event ${event.id}`,
+    `  status:        ${statusBadge(event.status)}`,
+    `  eventType:     ${event.eventType}`,
+    `  attempts:      ${event.attempts}`,
+    `  endpoint:      [${event.webhookEndpoint.id}] ${event.webhookEndpoint.url}`,
+    `  createdAt:     ${event.createdAt}`
+  ];
+  if (event.lastAttemptAt) lines.push(`  lastAttemptAt: ${event.lastAttemptAt}`);
+  if (event.nextRetryAt) lines.push(`  nextRetryAt:   ${event.nextRetryAt}`);
+  if (event.responseStatus !== null) lines.push(`  responseStatus: ${event.responseStatus}`);
+  if (event.responseBody) {
+    const body = event.responseBody.length > 200 ? `${event.responseBody.slice(0, 200)}\u2026` : event.responseBody;
+    lines.push(`  responseBody:  ${body}`);
+  }
+  return lines.join("\n");
+}
+
+// src/lib/parse.ts
+function parsePositiveIntId(raw, label) {
+  const id = Number.parseInt(raw, 10);
+  if (!Number.isFinite(id) || id <= 0) {
+    throw new CliError("invalid_input", `${label} must be a positive integer (got '${raw}')`);
+  }
+  return id;
+}
+function parsePaymentMethod(raw) {
+  if (raw === "pix" || raw === "credit_card" || raw === "boleto") return raw;
+  throw new CliError(
+    "invalid_input",
+    `--type must be 'pix', 'credit_card', or 'boleto' (got '${raw}')`
+  );
+}
+function parseWebhookEventStatus(raw) {
+  if (raw === "pending" || raw === "success" || raw === "failed") return raw;
+  throw new CliError(
+    "invalid_input",
+    `--status must be 'pending', 'success', or 'failed' (got '${raw}')`
+  );
+}
 
 // src/index.ts
 function buildCli() {
@@ -524,7 +616,7 @@ function buildCli() {
   });
   charges.command("get <id>").description("Fetch a single charge by ID").action(async (id) => {
     const base = toCommandOptions(program);
-    await chargesGetCommand({ ...base, id: parseId(id) }).catch(
+    await chargesGetCommand({ ...base, id: parsePositiveIntId(id, "Charge ID") }).catch(
       (err) => printErrorAndExit(err, base)
     );
   });
@@ -532,12 +624,45 @@ function buildCli() {
     const base = toCommandOptions(program);
     await chargesRefundCommand({
       ...base,
-      id: parseId(id),
+      id: parsePositiveIntId(id, "Charge ID"),
       amount: cmdOpts.amount,
       reason: cmdOpts.reason,
       idempotencyKey: cmdOpts.idempotencyKey
     }).catch((err) => printErrorAndExit(err, base));
   });
+  const webhooks = program.command("webhooks").description("Inspect and replay webhook deliveries");
+  const events = webhooks.command("events").description("List, inspect, and resend webhook events");
+  events.command("list").description("List webhook events with filters").option("--page <n>", "page number (1-based)", (v) => parseInt(v, 10)).option("--limit <n>", "items per page (1-100)", (v) => parseInt(v, 10)).option("--status <status>", "filter: pending, success, or failed").option("--event-type <type>", "filter by Garu event type, e.g. transaction.payment.paid").option(
+    "--endpoint-id <n>",
+    "filter by destination endpoint id",
+    (v) => parseInt(v, 10)
+  ).action(
+    async (cmdOpts) => {
+      const base = toCommandOptions(program);
+      await webhooksEventsListCommand({
+        ...base,
+        page: cmdOpts.page,
+        limit: cmdOpts.limit,
+        status: cmdOpts.status ? parseWebhookEventStatus(cmdOpts.status) : void 0,
+        eventType: cmdOpts.eventType,
+        endpointId: cmdOpts.endpointId
+      }).catch((err) => printErrorAndExit(err, base));
+    }
+  );
+  events.command("get <id>").description("Fetch a single webhook event by ID").action(async (id) => {
+    const base = toCommandOptions(program);
+    await webhooksEventsGetCommand({
+      ...base,
+      id: parsePositiveIntId(id, "Webhook event ID")
+    }).catch((err) => printErrorAndExit(err, base));
+  });
+  events.command("retry <id>").description("Re-deliver a webhook event (resets to pending and triggers an immediate attempt)").action(async (id) => {
+    const base = toCommandOptions(program);
+    await webhooksEventsRetryCommand({
+      ...base,
+      id: parsePositiveIntId(id, "Webhook event ID")
+    }).catch((err) => printErrorAndExit(err, base));
+  });
   program.command("doctor").description("Environment diagnostic").action(async () => {
     const base = toCommandOptions(program);
     await doctorCommand(base).catch((err) => printErrorAndExit(err, base));
@@ -553,20 +678,6 @@ function toCommandOptions(program) {
   if (g.quiet) out.quiet = true;
   return out;
 }
-function parsePaymentMethod(raw) {
-  if (raw === "pix" || raw === "credit_card" || raw === "boleto") return raw;
-  throw new CliError(
-    "invalid_input",
-    `--type must be 'pix', 'credit_card', or 'boleto' (got '${raw}')`
-  );
-}
-function parseId(raw) {
-  const id = Number.parseInt(raw, 10);
-  if (!Number.isFinite(id) || id <= 0) {
-    throw new CliError("invalid_input", `Charge ID must be a positive integer (got '${raw}')`);
-  }
-  return id;
-}
 async function setupUpdateNotifier() {
   try {
     const { default: updateNotifier } = await import('update-notifier');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garuhq/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official command-line interface for the Garu payment gateway.",
   "license": "MIT",
   "homepage": "https://garu.com.br",
@@ -45,7 +45,7 @@
     "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
   "dependencies": {
-    "@garuhq/node": "0.2.0",
+    "@garuhq/node": "0.11.0",
     "@inquirer/prompts": "8.4.1",
     "commander": "12.0.0",
     "picocolors": "1.0.0",