@garuhq/cli 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 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.11.0] — 2026-08-22
+
+### Changed
+
+- **`garu webhooks events` now targets `/api/v1/webhook-events`, uuid-keyed.**
+  `get`, `retry`, and `resend` take a `<uuid>` positional argument instead of
+  a numeric id. `list` output now reports `count`/`totalCount`/`totalPages`
+  instead of a `page`/`total` counter, and every row/detail view prints the
+  event's `uuid`.
+- **`@garuhq/node` bumped to `3.0.0`.** Breaking for `garu.webhookEvents.*`
+  (see that package's changelog).
+
+### Breaking
+
+- `garu webhooks events get <id>` / `retry <id>` / `resend <id>` now expect
+  a `uuid`, not a numeric id. Run `garu webhooks events list` to read the
+  `uuid` of the event you want to act on.
+
 ## [0.10.0] — 2026-08-22
 
 ### Added

package/dist/index.cjs

@@ -15,7 +15,7 @@ var pc__default = /*#__PURE__*/_interopDefault(pc);
 // src/index.ts
 
 // src/version.ts
-var CLI_VERSION = "0.10.0";
+var CLI_VERSION = "0.11.0";
 var CliError = class extends Error {
   code;
   exitCode;
@@ -1292,20 +1292,20 @@ async function webhooksEventsListCommand(opts) {
 }
 async function webhooksEventsGetCommand(opts) {
   const garu = await getClient7(opts);
-  const event = await garu.webhookEvents.get(opts.id);
+  const event = await garu.webhookEvents.get(opts.uuid);
   printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
   return event;
 }
 async function webhooksEventsRetryCommand(opts) {
   const garu = await getClient7(opts);
-  const event = await garu.webhookEvents.retry(opts.id);
+  const event = await garu.webhookEvents.retry(opts.uuid);
   printResult(event, { ...opts, prettyPrint: prettyWebhookEvent });
   return event;
 }
 async function webhooksEventsResendCommand(opts) {
   const garu = await getClient7(opts);
-  const clone = await garu.webhookEvents.resend(opts.id);
-  printSuccess(`Resent event ${opts.id} \u2192 new event ${clone.id}`, opts);
+  const clone = await garu.webhookEvents.resend(opts.uuid);
+  printSuccess(`Resent event ${opts.uuid} \u2192 new event ${clone.uuid}`, opts);
   printResult(clone, { ...opts, prettyPrint: prettyWebhookEvent });
   return clone;
 }
@@ -1316,18 +1316,16 @@ function statusBadge(status) {
   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)`;
+  if (list.data.length === 0) return "No webhook events found";
+  const header = `Webhook events (${list.count} of ${list.totalCount} total, ${list.totalPages} page(s))`;
   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}`
+    (e) => `  ${e.uuid}  ${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}`,
+    `Webhook event ${event.uuid}`,
     `  status:        ${statusBadge(event.status)}`,
     `  eventType:     ${event.eventType}`,
     `  attempts:      ${event.attempts}`,
@@ -1639,30 +1637,27 @@ Recipes:
       }).catch((err) => printErrorAndExit(err, base));
     }
   );
-  events.command("get <id>").description("Fetch a single webhook event by ID").action(async (id) => {
+  events.command("get <uuid>").description("Fetch a single webhook event by uuid").action(async (uuid) => {
     const base = toCommandOptions(program);
-    await webhooksEventsGetCommand({
-      ...base,
-      id: parsePositiveIntId(id, "Webhook event ID")
-    }).catch((err) => printErrorAndExit(err, base));
+    await webhooksEventsGetCommand({ ...base, uuid }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
   });
-  events.command("retry <id>").description(
+  events.command("retry <uuid>").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) => {
+  ).action(async (uuid) => {
     const base = toCommandOptions(program);
-    await webhooksEventsRetryCommand({
-      ...base,
-      id: parsePositiveIntId(id, "Webhook event ID")
-    }).catch((err) => printErrorAndExit(err, base));
+    await webhooksEventsRetryCommand({ ...base, uuid }).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) => {
+  events.command("resend <uuid>").description(
+    "Re-deliver a webhook event by cloning it (audit-trail preserving: original row is untouched, clone gets a new uuid and points back via manualResendOf)"
+  ).action(async (uuid) => {
     const base = toCommandOptions(program);
-    await webhooksEventsResendCommand({
-      ...base,
-      id: parsePositiveIntId(id, "Webhook event ID")
-    }).catch((err) => printErrorAndExit(err, base));
+    await webhooksEventsResendCommand({ ...base, uuid }).catch(
+      (err) => printErrorAndExit(err, base)
+    );
   });
   const customers = program.command("customers").description("Manage your customer base");
   customers.command("create").description("Register a customer for the current seller (dedup by document)").requiredOption("--name <name>", "customer name").requiredOption("--email <email>", "customer email").requiredOption("--document <document>", "CPF (11 digits) or CNPJ (14 digits), digits only").requiredOption("--phone <phone>", "phone with area code, 10-11 digits").requiredOption("--person-type <type>", "'fisica' or 'juridica'").option("--zip-code <cep>", "ZIP code, 8 digits").option("--street <street>", "street address").option("--number <number>", "address number").option("--complement <text>", "address complement").option("--neighborhood <text>", "neighborhood").option("--city <city>", "city").option("--state <uf>", "2-letter state code, e.g. SP").action(async (cmdOpts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garuhq/cli",
-  "version": "0.10.0",
+  "version": "0.11.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": "2.0.0",
+    "@garuhq/node": "3.0.0",
     "@inquirer/prompts": "8.4.1",
     "commander": "12.0.0",
     "picocolors": "1.0.0",