@garuhq/cli 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -3,6 +3,41 @@
 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.5.0] — 2026-05-19
+
+### Added
+
+- `garu webhooks events resend <id>` — audit-trail-preserving replay
+  of a webhook event. Unlike `retry`, this does **not** mutate the
+  original row: the gateway inserts a fresh event with its own
+  numeric id that points back at the source via `manualResendOf`,
+  then dispatches that clone. The original failure record (response
+  status, response body, attempts, timestamps) stays intact.
+  - In pretty mode the CLI prints `✓ Resent event <src> → new event
+    <clone>` to stderr so the new id is impossible to miss; the
+    cloned event itself is rendered on stdout with a new `resendOf:`
+    line.
+  - In JSON mode the cloned event is the full stdout payload —
+    `.id` is the new event, `.manualResendOf` is the source.
+  - Recipient handlers will see this as a distinct delivery: the
+    gateway POSTs the clone with `Idempotency-Key:
+    resend_<originalId>`.
+
+### Deprecated
+
+- `garu webhooks events retry <id>` — kept for backwards
+  compatibility but now marked `[deprecated: prefer resend]` in
+  `--help`. `retry` resets the original row in place, which means
+  once the replay succeeds the historical record of the prior
+  failure is gone. For incident response, support workflows, and
+  any backfill where the audit trail matters, use `resend` instead.
+
+### Changed
+
+- `@garuhq/node` SDK bumped to 0.12.0 for the new
+  `webhookEvents.resend()` method and the `manualResendOf` field on
+  `WebhookEvent`.
+
 ## [0.4.2] — 2026-05-19
 
 ### Fixed

package/dist/index.cjs

@@ -15,7 +15,7 @@ var pc__default = /*#__PURE__*/_interopDefault(pc);
 // src/index.ts
 
 // src/version.ts
-var CLI_VERSION = "0.4.2";
+var CLI_VERSION = "0.5.0";
 var CliError = class extends Error {
   code;
   exitCode;
@@ -510,6 +510,13 @@ async function webhooksEventsRetryCommand(opts) {
   printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
   return event;
 }
+async function webhooksEventsResendCommand(opts) {
+  const garu = await getClient2(opts);
+  const clone = await garu.webhookEvents.resend(opts.id);
+  printSuccess(`Resent event ${opts.id} \u2192 new event ${clone.id}`, opts);
+  printResult(clone, { ...opts, prettyPrint: prettyWebhookEvent });
+  return clone;
+}
 function statusBadge(status) {
   const padded = status.padEnd(7);
   if (status === "success") return pc__default.default.green(padded);
@@ -535,6 +542,7 @@ function prettyWebhookEvent(event) {
     `  endpoint:      [${event.webhookEndpoint.id}] ${event.webhookEndpoint.url}`,
     `  createdAt:     ${event.createdAt}`
   ];
+  if (event.manualResendOf !== null) lines.push(`  resendOf:      ${event.manualResendOf}`);
   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}`);
@@ -672,13 +680,24 @@ function buildCli() {
       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) => {
+  events.command("retry <id>").description(
+    "[deprecated: prefer `resend`] Re-deliver a webhook event in place (resets the original row to pending and triggers an immediate attempt; destroys the prior failure record)"
+  ).action(async (id) => {
     const base = toCommandOptions(program);
     await webhooksEventsRetryCommand({
       ...base,
       id: parsePositiveIntId(id, "Webhook event ID")
     }).catch((err) => printErrorAndExit(err, base));
   });
+  events.command("resend <id>").description(
+    "Re-deliver a webhook event by cloning it (audit-trail preserving: original row is untouched, clone gets a new id and points back via manualResendOf)"
+  ).action(async (id) => {
+    const base = toCommandOptions(program);
+    await webhooksEventsResendCommand({
+      ...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));

package/package.json

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