@garuhq/cli 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 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.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.4.2";
 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}`)}
 `);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garuhq/cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Official command-line interface for the Garu payment gateway.",
   "license": "MIT",
   "homepage": "https://garu.com.br",
@@ -42,7 +42,8 @@
     "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",