@garuhq/cli 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -3,6 +3,67 @@
 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
+
+- **Error codes**: HTTP 403 responses (valid key, not your resource —
+  e.g. retrying a webhook event that belongs to another seller) were
+  previously surfaced as `auth_error`, which read like "your key is
+  bad". They now surface as `permission_error`. `auth_error` is now
+  reserved for HTTP 401 (bad/missing key).
+- **`garu --version`** correctly reports `0.4.2`. The `0.4.1` release
+  shipped with `src/version.ts:CLI_VERSION` still pinned to `'0.4.0'`
+  because that file was missed during the bump. A new `scripts/
+  check-version-sync.mjs` runs as part of `prepublishOnly` and fails
+  the build if `package.json:version` and `src/version.ts:CLI_VERSION`
+  drift apart.
+
+### Changed
+
+- **Error output**: `printErrorAndExit` now includes `status` and
+  `body` from `GaruAPIError`-derived failures.
+  - In `--json` mode, the payload gains optional `status` and `body`
+    fields: `{"error":{"code","message","status","body"}}`. Allows
+    self-diagnosis of 4xx responses without dropping to `curl`.
+  - In pretty mode, the HTTP status is shown as a dimmed line below
+    the existing `code:` line.
+
 ## [0.4.1] — 2026-05-19
 
 ### Fixed

package/dist/index.cjs

@@ -15,19 +15,28 @@ var pc__default = /*#__PURE__*/_interopDefault(pc);
 // src/index.ts
 
 // src/version.ts
-var CLI_VERSION = "0.4.0";
+var CLI_VERSION = "0.5.0";
 var CliError = class extends Error {
   code;
   exitCode;
-  constructor(code, message, exitCode = 1) {
+  /** HTTP status code when the error came from a `GaruAPIError`, else `null`. */
+  status;
+  /** Raw backend response body when the error came from a `GaruAPIError`, else `undefined`. */
+  body;
+  constructor(code, message, exitCode = 1, status = null, body = void 0) {
     super(message);
     this.name = "CliError";
     this.code = code;
     this.exitCode = exitCode;
+    this.status = status;
+    this.body = body;
   }
 };
 function toCliError(err) {
   if (err instanceof CliError) return err;
+  if (err instanceof node.GaruAPIError) {
+    return new CliError(mapSdkCodeToCliCode(err.code), err.message, 1, err.status, err.body);
+  }
   if (err instanceof node.GaruError) {
     return new CliError(mapSdkCodeToCliCode(err.code), err.message, 1);
   }
@@ -37,8 +46,9 @@ function toCliError(err) {
 function mapSdkCodeToCliCode(sdkCode) {
   switch (sdkCode) {
     case "authentication_error":
-    case "permission_error":
       return "auth_error";
+    case "permission_error":
+      return "permission_error";
     case "not_found":
       return "not_found";
     case "validation_error":
@@ -154,6 +164,8 @@ function printSuccess(message, opts = {}) {
 function printErrorAndExit(err, opts = {}) {
   const cliErr = toCliError(err);
   const payload = { error: { code: cliErr.code, message: cliErr.message } };
+  if (cliErr.status !== null) payload.error.status = cliErr.status;
+  if (cliErr.body !== void 0) payload.error.body = cliErr.body;
   if (resolveMode(opts) === "json") {
     process.stdout.write(`${JSON.stringify(payload)}
 `);
@@ -162,6 +174,10 @@ function printErrorAndExit(err, opts = {}) {
 `);
     if (cliErr.code !== "unknown_error") {
       process.stderr.write(`${pc__default.default.dim(`  code: ${cliErr.code}`)}
+`);
+    }
+    if (cliErr.status !== null) {
+      process.stderr.write(`${pc__default.default.dim(`  status: ${cliErr.status}`)}
 `);
     }
   }
@@ -494,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);
@@ -519,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}`);
@@ -656,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.1",
+  "version": "0.5.0",
   "description": "Official command-line interface for the Garu payment gateway.",
   "license": "MIT",
   "homepage": "https://garu.com.br",
@@ -42,10 +42,11 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+    "check:version-sync": "node scripts/check-version-sync.mjs",
+    "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",