@garuhq/node 3.0.0 → 4.1.0

package/CHANGELOG.md

@@ -3,6 +3,72 @@
 All notable changes to `@garuhq/node` are documented in this file. Format:
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
 
+## [4.1.0] — 2026-08-22
+
+### Added
+
+- `customers.create()`, `charges.refund()`, and
+  `installmentPlans.requestRefund()` now attach an `X-Idempotency-Key`
+  header automatically (UUIDv4 unless you pass `idempotencyKey`). The
+  gateway now caches and replays the first response for 24h, so a network
+  retry can no longer register a duplicate customer, open a second refund
+  request, or (via `scheduledCharges.create()` — see Fixed below)
+  double-book recurring billing.
+
+### Fixed
+
+- `scheduledCharges.create()`'s docstring dropped the "the gateway does not
+  currently deduplicate" caveat — the backend now enforces it, so a retried
+  create is safe by default.
+
+## [4.0.0] — 2026-08-22
+
+**Breaking:** `scheduledCharges` now targets the versioned public API
+`/api/v1/scheduled-charges`. `id` was already a stable, non-enumerable
+string (`sch_...`) — no identifier change — but the list envelope shape
+changed. If you use `garu.scheduledCharges.*`, read the migration below.
+
+### Breaking
+
+- **`scheduledCharges` moved to `/api/v1/scheduled-charges`.**
+  - **`scheduledCharges.list()` and `.listAttempts()` now return
+    `{ data, count, totalCount, totalPages }`** (was `{ data, meta }`).
+  - No method signatures changed — every method already took/returned the
+    same shapes, since `id` was never a numeric internal id here.
+
+### Added
+
+- `ScheduledChargeRecord` now explicitly types `recurrence`,
+  `cancelAtPeriodEnd`, `trialEndsAt`, and `subscriptionId` (previously only
+  reachable via the type's index signature, untyped).
+- Test coverage for `cancelRecurrence`, `setCancelAtPeriodEnd`,
+  `changePaymentMethod`, `clearPaymentMethod`, and `listAttempts` — none of
+  these five methods had a single test before this release.
+
+### Fixed
+
+- `ScheduledChargeLinkedTransaction.value`'s docstring claimed centavos;
+  `/api/v1/charges`' own mapper treats the same `transaction.value` column
+  as decimal reais with no conversion. Corrected to match reality — this is
+  a documentation fix, not a behavior or wire-format change.
+- `scheduledCharges.create()`'s docstring claimed the SDK's
+  `X-Idempotency-Key` prevents duplicate creates on retry. The gateway does
+  not deduplicate `/scheduled-charges` creates against it (same pre-existing
+  gap as `webhookEvents.resend()` had). Corrected the docstring; the header
+  is still sent (harmless) in case the gateway adds this later.
+
+### Migration
+
+```ts
+// before (≤ 3.x)
+const { data, meta } = await garu.scheduledCharges.list({ status: 'overdue' });
+meta.total; // number
+
+// after (4.0.0)
+const { data, totalCount } = await garu.scheduledCharges.list({ status: 'overdue' });
+totalCount; // number
+```
+
 ## [3.0.0] — 2026-08-22
 
 **Breaking:** `webhookEvents` now targets the versioned public API
@@ -34,16 +100,16 @@ read the migration below.
 // before (0.x – 2.x)
 const failed = await garu.webhookEvents.list({ status: 'failed', limit: 5 });
 const event = failed.data[0];
-event.id;                                // number
+event.id; // number
 const clone = await garu.webhookEvents.resend(event.id);
-clone.manualResendOf === event.id;       // true
+clone.manualResendOf === event.id; // true
 
 // after (3.0.0)
 const failed = await garu.webhookEvents.list({ status: 'failed', limit: 5 });
 const event = failed.data[0];
-event.uuid;                              // string
+event.uuid; // string
 const clone = await garu.webhookEvents.resend(event.uuid);
-clone.manualResendOf === event.uuid;     // true
+clone.manualResendOf === event.uuid; // true
 ```
 
 ## [2.0.0] — 2026-08-22
@@ -78,14 +144,14 @@ keyed on `uuid`. If you use `garu.customers.*`, read the migration below.
 ```ts
 // before (1.x)
 const c = await garu.customers.create({ name, email, document, phone, personType });
-c.id;                    // number
+c.id; // number
 const one = await garu.customers.get(c.id);
 await garu.customers.update(c.id, { name: 'Maria Santos' });
 await garu.customers.delete(c.id);
 
 // after (2.0.0)
 const c = await garu.customers.create({ name, email, document, phone, personType });
-c.uuid;                   // string
+c.uuid; // string
 const one = await garu.customers.get(c.uuid);
 await garu.customers.update(c.uuid, { name: 'Maria Santos' });
 const { removed } = await garu.customers.delete(c.uuid);
@@ -93,7 +159,6 @@ const { removed } = await garu.customers.delete(c.uuid);
 
 ## [1.1.0] — 2026-08-15
 
-
 ### Added
 
 - **`garu.installmentPlans` — boleto parcelado (carnê).** One product sold as N
@@ -170,22 +235,26 @@ webhook-events) changed.
 ```ts
 // before (0.16.x)
 const c = await garu.charges.create({
-  productId, paymentMethod: 'credit_card', customer,
+  productId,
+  paymentMethod: 'credit_card',
+  customer,
   cardInfo: { cardNumber: '4111…', cvv, expirationDate, holderName, installments: 2 }
 });
-c.id;                 // number
-c.paymentMethodId;    // 'creditcard'
+c.id; // number
+c.paymentMethodId; // 'creditcard'
 const one = await garu.charges.get(c.id);
 await garu.charges.refund(c.id, { amount: 1000 }); // "R$10,00" (bug: reais)
 
 // after (1.0.0)
 const c = await garu.charges.create({
-  productId, paymentMethod: 'creditCard', customer,
+  productId,
+  paymentMethod: 'creditCard',
+  customer,
   card: { number: '4111…', cvv, expirationDate, holderName, installments: 2 }
 });
-c.uuid;               // string
-c.paymentMethod;      // 'creditCard'
-c.chargedTotal;       // what was actually charged
+c.uuid; // string
+c.paymentMethod; // 'creditCard'
+c.chargedTotal; // what was actually charged
 const one = await garu.charges.retrieve(c.uuid);
 await garu.charges.refund(c.uuid, { amount: 10.0 }); // R$10,00
 ```

package/README.md

@@ -147,10 +147,13 @@ await garu.charges.refund('6f1c9b2e-…', { amount: 10.0 }); // partial refund (
 ## Customers
 
 Backed by `/api/v1/customers`, keyed on `uuid` — there is no numeric id in
-this shape. `installmentPlans.create` and `scheduledCharges.create` still
-link customers by the internal numeric id (unmigrated resources); fetch that
-id from the dashboard or the internal `/api/customers` endpoint until they
-move to `/api/v1` too.
+this shape. `installmentPlans.create` still links customers by the internal
+numeric id (unmigrated resource); fetch that id from the dashboard or the
+internal `/api/customers` endpoint until it moves to `/api/v1` too.
+`scheduledCharges.create` also takes the internal numeric `customerId` —
+customers and scheduled charges are on separate `/api/v1` resources, and
+neither exposes a cross-reference between a customer's `uuid` and their
+numeric id yet.
 
 | Method                                  | Description                                     |
 | --------------------------------------- | ----------------------------------------------- |
@@ -206,20 +209,25 @@ await garu.products.portalConfig.patch('b3f2c1e8-6e4a-4b9f-9d1c-2a1f6c3d4e5f', {
 
 Bill an existing customer on a future date — one-time or recurring with card tokenization. The Garu drives email reminders, dunning, retries, and the lifecycle state machine.
 
-| Method                               | Description                                                                 |
-| ------------------------------------ | --------------------------------------------------------------------------- |
-| `create(params)`                     | Create one-time or recurring schedule. Auto-attaches `X-Idempotency-Key`.   |
-| `list(params?)`                      | Paginated list with status / type / dueFrom / dueTo / customerId filters.   |
-| `get(id)`                            | Detail bundle: charge + event timeline + linked transactions.               |
-| `chargeNow(id)`                      | Force-bill the current cycle now instead of waiting for the due date.       |
-| `markPaid(id, params)`               | Mark cycle paid (off-Garu reconciliation).                                  |
-| `postpone(id, params)`               | Move the next cycle's due date forward.                                     |
-| `pause(id, params?)` / `resume(id)`  | Suspend / re-enable a series.                                               |
-| `cancelRecurrence(id, params?)`      | Hard-stop future cycles (recurring only).                                   |
-| `cancelAtPeriodEnd(id, { enabled })` | Stripe-style soft-cancel; reversible.                                       |
-| `changePaymentMethod(id, params)`    | Swap the saved card.                                                        |
-| `clearPaymentMethod(id)`             | Remove the saved card; future cycles email-with-link.                       |
-| `listAttempts(id, params?)`          | Per-attempt billing log — every silent-charge / retry / mark-paid (v0.8.2). |
+Backed by `/api/v1/scheduled-charges`. Unlike products/customers/webhook-events,
+`id` here was already a stable, non-enumerable string (`sch_...`) before this
+move — there is no separate uuid and no id change, only the path and the list
+envelope (`totalCount`/`totalPages`, not `meta.total`/`meta.totalPages`).
+
+| Method                                  | Description                                                               |
+| --------------------------------------- | ------------------------------------------------------------------------- |
+| `create(params)`                        | Create one-time or recurring schedule.                                    |
+| `list(params?)`                         | Paginated list with status / type / dueFrom / dueTo / customerId filters. |
+| `get(id)`                               | Detail bundle: charge + event timeline + linked transactions.             |
+| `chargeNow(id)`                         | Force-bill the current cycle now instead of waiting for the due date.     |
+| `markPaid(id, params)`                  | Mark cycle paid (off-Garu reconciliation).                                |
+| `postpone(id, params)`                  | Move the next cycle's due date forward.                                   |
+| `pause(id, params?)` / `resume(id)`     | Suspend / re-enable a series.                                             |
+| `cancelRecurrence(id, params?)`         | Hard-stop future cycles (recurring only).                                 |
+| `setCancelAtPeriodEnd(id, { enabled })` | Stripe-style soft-cancel; reversible.                                     |
+| `changePaymentMethod(id, params)`       | Swap the saved card.                                                      |
+| `clearPaymentMethod(id)`                | Remove the saved card; future cycles email-with-link.                     |
+| `listAttempts(id, params?)`             | Per-attempt billing log — every silent-charge / retry / mark-paid.        |
 
 ```ts
 // Recurring with 7-day trial. `maxRecoveryDays` caps how long past the due
@@ -240,11 +248,10 @@ const series = await garu.scheduledCharges.create({
 // Idempotent: a cycle already dispatched today reports `already_sent`.
 const result = await garu.scheduledCharges.chargeNow(series.id);
 if (result.outcome === 'failed') {
-  // result.reason is e.g. 'card_expired' or a gateway decline code
-  console.error(`${result.message} (${result.reason})`);
+  result.reason; // e.g. 'card_expired' or a gateway decline code
 }
 
-// Audit why cycle 3 failed (v0.8.2)
+// Audit why cycle 3 failed
 const { data } = await garu.scheduledCharges.listAttempts(series.id, {
   cycleNumber: 3
 });
@@ -308,7 +315,7 @@ const series = await garu.scheduledCharges.create({
 });
 ```
 
-Cancel and the rest of the lifecycle use the **same methods** as card-backed series — `cancelRecurrence(id)`, `cancelAtPeriodEnd(id, { enabled })`, `pause(id)` / `resume(id)`. The customer can also revoke the authorization directly in their bank app; Garu surfaces that as a `subscription.cancelled` event.
+Cancel and the rest of the lifecycle use the **same methods** as card-backed series — `cancelRecurrence(id)`, `setCancelAtPeriodEnd(id, { enabled })`, `pause(id)` / `resume(id)`. The customer can also revoke the authorization directly in their bank app; Garu surfaces that as a `subscription.cancelled` event.
 
 ### 3. Handle the webhooks
 

package/dist/index.cjs

@@ -217,7 +217,7 @@ var Charges = class {
    *     phone: '11987654321'
    *   }
    * });
-   * console.log(charge.uuid, charge.pix?.code);
+   * // charge.uuid, charge.pix?.code
    *
    * @example
    * // Credit card, 2 installments. Server-to-server only (PCI scope).
@@ -262,7 +262,7 @@ var Charges = class {
    *
    * @example
    * const { data, totalCount } = await garu.charges.list({ status: 'paid', limit: 50 });
-   * console.log(`${data.length} of ${totalCount} paid charges`);
+   * // data.length of totalCount paid charges
    */
   async list(params = {}) {
     const query = {};
@@ -285,15 +285,24 @@ var Charges = class {
    * charge in `refund_pending`, reaching `refunded` only once the transfer
    * settles.
    *
+   * For Pix/boleto (which open a refund request instead of an automated
+   * reversal), attaches an `X-Idempotency-Key` header automatically — if you
+   * don't pass `idempotencyKey`, the SDK generates a UUIDv4. Ignored for
+   * card, which reverses automatically and has no manual request to
+   * duplicate.
+   *
    * @example
    * await garu.charges.refund('6f1c9b2e-...');                       // full
    * await garu.charges.refund('6f1c9b2e-...', { amount: 10.0 });     // R$10,00
    */
   async refund(uuid, params = {}) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
     const body = {};
     if (params.amount !== void 0) body.amount = params.amount;
     if (params.reason !== void 0) body.reason = params.reason;
-    return this.post(`/api/v1/charges/${encodeURIComponent(uuid)}/refund`, body);
+    return this.post(`/api/v1/charges/${encodeURIComponent(uuid)}/refund`, body, {
+      "X-Idempotency-Key": idempotencyKey
+    });
   }
   /**
    * Cancel an unpaid charge.
@@ -318,7 +327,11 @@ var Charges = class {
   }
   post(url, body, headers) {
     return this.http.call(
-      (signal) => this.http.client.POST(url, { body, headers, signal })
+      (signal) => this.http.client.POST(url, {
+        body,
+        headers,
+        signal
+      })
     );
   }
 };
@@ -507,6 +520,11 @@ var InstallmentPlans = class {
    * team. Transfer the money to the buyer yourself, then close it with
    * `garu.refundRequests.confirm`.
    *
+   * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. The backend already dedupes
+   * a second pending request for the same carnê, so this is mainly
+   * defense-in-depth for the request-in-flight window.
+   *
    * @example
    * const request = await garu.installmentPlans.requestRefund(uuid, {
    *   reason: 'Produto não entregue'
@@ -515,9 +533,12 @@ var InstallmentPlans = class {
    * request.amount;  // defaults to everything the carnê collected
    */
   async requestRefund(uuid, params = {}) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
+    const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
       (signal) => this.http.client.POST(`/api/v1/installment-plans/${uuid}/refund-requests`, {
-        body: params,
+        body,
+        headers: { "X-Idempotency-Key": idempotencyKey },
         signal
       }).then((r) => r)
     );
@@ -625,6 +646,10 @@ var Customers = class {
   /**
    * Register a customer for the current seller.
    *
+   * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. Safe to retry: the same key
+   * returns the originally-created/matched customer for 24h.
+   *
    * @example
    * const customer = await garu.customers.create({
    *   name: 'Maria Silva',
@@ -636,9 +661,12 @@ var Customers = class {
    * customer.uuid;
    */
   async create(params) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
+    const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
       (signal) => this.http.client.POST("/api/v1/customers", {
-        body: params,
+        body,
+        headers: { "X-Idempotency-Key": idempotencyKey },
         signal
       }).then((r) => r)
     );
@@ -942,9 +970,10 @@ var ScheduledCharges = class {
   }
   http;
   /**
-   * Create a new scheduled charge. Auto-attaches `X-Idempotency-Key`
-   * (UUIDv4 if you don't pass `idempotencyKey`) so retries on transient
-   * network failures don't silently double-create.
+   * Create a new scheduled charge. Attaches an `X-Idempotency-Key` header
+   * automatically — if you don't pass `idempotencyKey`, the SDK generates a
+   * UUIDv4. Safe to retry: the same key returns the originally-created
+   * series for 24h instead of double-booking recurring billing.
    *
    * @example
    * const charge = await garu.scheduledCharges.create({
@@ -974,7 +1003,7 @@ var ScheduledCharges = class {
     const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
     const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
-      (signal) => this.http.client.POST("/api/scheduled-charges", {
+      (signal) => this.http.client.POST("/api/v1/scheduled-charges", {
         body,
         headers: { "X-Idempotency-Key": idempotencyKey },
         signal
@@ -1009,7 +1038,7 @@ var ScheduledCharges = class {
       for (const s of statuses) qs.append("status", s);
     }
     const query = qs.toString();
-    const url = `/api/scheduled-charges${query ? `?${query}` : ""}`;
+    const url = `/api/v1/scheduled-charges${query ? `?${query}` : ""}`;
     return this.http.call(
       (signal) => this.http.client.GET(url, { signal }).then(
         (r) => r
@@ -1026,7 +1055,7 @@ var ScheduledCharges = class {
    */
   async get(id) {
     return this.http.call(
-      (signal) => this.http.client.GET(`/api/scheduled-charges/${encodeURIComponent(id)}`, {
+      (signal) => this.http.client.GET(`/api/v1/scheduled-charges/${encodeURIComponent(id)}`, {
         signal
       }).then((r) => r)
     );
@@ -1045,7 +1074,7 @@ var ScheduledCharges = class {
   async postpone(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/postpone`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/postpone`,
         {
           body: params,
           signal
@@ -1064,7 +1093,7 @@ var ScheduledCharges = class {
   async pause(id, params = {}) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/pause`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/pause`,
         {
           body: params,
           signal
@@ -1081,7 +1110,7 @@ var ScheduledCharges = class {
   async resume(id) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/resume`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/resume`,
         {
           body: {},
           signal
@@ -1115,7 +1144,7 @@ var ScheduledCharges = class {
   async markPaid(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/mark-paid`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/mark-paid`,
         {
           body: params,
           signal
@@ -1137,24 +1166,22 @@ var ScheduledCharges = class {
    * const result = await garu.scheduledCharges.chargeNow('sch_abc123');
    * switch (result.outcome) {
    *   case 'dispatched':
-   *     console.log(`Cobrança enviada (ciclo ${result.cycleNumber}).`);
+   *     result.cycleNumber; // billed this cycle
    *     break;
    *   case 'already_sent':
-   *     console.log('Já havia sido enviada — nada a fazer.');
-   *     break;
+   *     break; // nothing to do
    *   case 'failed':
-   *     // result.reason is e.g. 'card_expired' or a gateway decline code
-   *     console.error(`Falha na cobrança: ${result.reason}. ${result.message}`);
+   *     result.reason; // e.g. 'card_expired' or a gateway decline code
    *     break;
    *   case 'not_sent':
-   *     console.warn(`Não enviada (${result.reason}): ${result.message}`);
+   *     result.reason;
    *     break;
    * }
    */
   async chargeNow(id) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/charge-now`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/charge-now`,
         {
           body: {},
           signal
@@ -1176,7 +1203,7 @@ var ScheduledCharges = class {
   async cancelRecurrence(id, params = {}) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/cancel-recurrence`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/cancel-recurrence`,
         {
           body: params,
           signal
@@ -1196,7 +1223,7 @@ var ScheduledCharges = class {
   async setCancelAtPeriodEnd(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/cancel-at-period-end`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/cancel-at-period-end`,
         {
           body: params,
           signal
@@ -1215,7 +1242,7 @@ var ScheduledCharges = class {
   async changePaymentMethod(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
         {
           body: params,
           signal
@@ -1234,7 +1261,7 @@ var ScheduledCharges = class {
   async clearPaymentMethod(id) {
     return this.http.call(
       (signal) => this.http.client.DELETE(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
         {
           body: {},
           signal
@@ -1261,7 +1288,7 @@ var ScheduledCharges = class {
     if (params.limit !== void 0) qs.set("limit", String(params.limit));
     if (params.cycleNumber !== void 0) qs.set("cycleNumber", String(params.cycleNumber));
     const query = qs.toString();
-    const url = `/api/scheduled-charges/${encodeURIComponent(id)}/attempts${query ? `?${query}` : ""}`;
+    const url = `/api/v1/scheduled-charges/${encodeURIComponent(id)}/attempts${query ? `?${query}` : ""}`;
     return this.http.call(
       (signal) => this.http.client.GET(url, { signal }).then(
         (r) => r

package/dist/index.d.cts

@@ -219,6 +219,13 @@ interface RefundChargeParams {
     amount?: number;
     /** Free-form reason stored on the refund. */
     reason?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. Only used
+     * for Pix/boleto, which open a refund request instead of an automated
+     * reversal — ignored for card, which has no manual request to duplicate.
+     */
+    idempotencyKey?: string;
 }
 interface ListChargesParams {
     /** Page number (1-based). Default: 1. */
@@ -324,6 +331,13 @@ interface CreateCustomerParams {
     city?: string;
     /** 2-letter uppercase state code, e.g. `SP`. */
     state?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. Document
+     * uniqueness already merges a retried create into the same customer, so
+     * this mainly protects registrations with no document set.
+     */
+    idempotencyKey?: string;
 }
 interface UpdateCustomerParams {
     name?: string;
@@ -390,7 +404,13 @@ interface ScheduledChargeRecord {
     /** YYYY-MM-DD in São Paulo time. */
     dueDate: string;
     methods: ScheduledPaymentMethod[];
+    recurrence: RecurrenceConfig | null;
     status: ScheduledChargeStatus;
+    subscriptionId: number | null;
+    /** ISO-8601. Set only when the series was created with `trialDays`. */
+    trialEndsAt: string | null;
+    /** Recurring only. Toggle with `setCancelAtPeriodEnd`. */
+    cancelAtPeriodEnd: boolean;
     externalReference: string | null;
     /**
      * Max days past `dueDate` the daily recovery sweep will still auto-bill a
@@ -425,7 +445,7 @@ interface ScheduledChargeEvent {
 }
 interface ScheduledChargeLinkedTransaction {
     id: number;
-    /** Centavos (BRL × 100), matching `garu.charges.*` value semantics. */
+    /** Decimal BRL (e.g. `297.50`), never centavos. */
     value: number;
     paymentMethod: string;
     status: string;
@@ -438,7 +458,14 @@ interface ScheduledChargeDetail {
     events: ScheduledChargeEvent[];
     transactions: ScheduledChargeLinkedTransaction[];
 }
-type ScheduledChargeList = PaginatedList<ScheduledChargeRecord>;
+interface ScheduledChargeList {
+    data: ScheduledChargeRecord[];
+    /** Items on this page. */
+    count: number;
+    /** Total matches across all pages. */
+    totalCount: number;
+    totalPages: number;
+}
 /** Source of a billing attempt — see SPEC §3.1. */
 type ScheduledChargeAttemptSource = 'cycle1_interactive' | 'silent_charge' | 'card_retry' | 'manual_mark_paid' | 'fallback_pix';
 type ScheduledChargeAttemptStatus = 'pending' | 'succeeded' | 'declined' | 'canceled' | 'errored';
@@ -460,7 +487,14 @@ interface ScheduledChargeAttempt {
     gatewayChargeId: number | null;
     transactionId: number | null;
 }
-type ScheduledChargeAttemptList = PaginatedList<ScheduledChargeAttempt>;
+interface ScheduledChargeAttemptList {
+    data: ScheduledChargeAttempt[];
+    /** Items on this page. */
+    count: number;
+    /** Total matches across all pages. */
+    totalCount: number;
+    totalPages: number;
+}
 interface ListScheduledChargeAttemptsParams {
     page?: number;
     limit?: number;
@@ -1031,6 +1065,13 @@ interface RequestPlanRefundParams {
     /** Defaults to everything the carnê has collected. */
     amount?: number;
     reason?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. The backend
+     * already dedupes a second pending request for the same carnê, so this is
+     * mainly defense-in-depth for the request-in-flight window.
+     */
+    idempotencyKey?: string;
 }
 interface ListRefundRequestsParams {
     page?: number;
@@ -1075,7 +1116,7 @@ declare class Charges {
      *     phone: '11987654321'
      *   }
      * });
-     * console.log(charge.uuid, charge.pix?.code);
+     * // charge.uuid, charge.pix?.code
      *
      * @example
      * // Credit card, 2 installments. Server-to-server only (PCI scope).
@@ -1107,7 +1148,7 @@ declare class Charges {
      *
      * @example
      * const { data, totalCount } = await garu.charges.list({ status: 'paid', limit: 50 });
-     * console.log(`${data.length} of ${totalCount} paid charges`);
+     * // data.length of totalCount paid charges
      */
     list(params?: ListChargesParams): Promise<ChargeList>;
     /**
@@ -1117,6 +1158,12 @@ declare class Charges {
      * charge in `refund_pending`, reaching `refunded` only once the transfer
      * settles.
      *
+     * For Pix/boleto (which open a refund request instead of an automated
+     * reversal), attaches an `X-Idempotency-Key` header automatically — if you
+     * don't pass `idempotencyKey`, the SDK generates a UUIDv4. Ignored for
+     * card, which reverses automatically and has no manual request to
+     * duplicate.
+     *
      * @example
      * await garu.charges.refund('6f1c9b2e-...');                       // full
      * await garu.charges.refund('6f1c9b2e-...', { amount: 10.0 });     // R$10,00
@@ -1263,6 +1310,11 @@ declare class InstallmentPlans {
      * team. Transfer the money to the buyer yourself, then close it with
      * `garu.refundRequests.confirm`.
      *
+     * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. The backend already dedupes
+     * a second pending request for the same carnê, so this is mainly
+     * defense-in-depth for the request-in-flight window.
+     *
      * @example
      * const request = await garu.installmentPlans.requestRefund(uuid, {
      *   reason: 'Produto não entregue'
@@ -1352,6 +1404,10 @@ declare class Customers {
     /**
      * Register a customer for the current seller.
      *
+     * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. Safe to retry: the same key
+     * returns the originally-created/matched customer for 24h.
+     *
      * @example
      * const customer = await garu.customers.create({
      *   name: 'Maria Silva',
@@ -1573,9 +1629,10 @@ declare class ScheduledCharges {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Create a new scheduled charge. Auto-attaches `X-Idempotency-Key`
-     * (UUIDv4 if you don't pass `idempotencyKey`) so retries on transient
-     * network failures don't silently double-create.
+     * Create a new scheduled charge. Attaches an `X-Idempotency-Key` header
+     * automatically — if you don't pass `idempotencyKey`, the SDK generates a
+     * UUIDv4. Safe to retry: the same key returns the originally-created
+     * series for 24h instead of double-booking recurring billing.
      *
      * @example
      * const charge = await garu.scheduledCharges.create({
@@ -1692,17 +1749,15 @@ declare class ScheduledCharges {
      * const result = await garu.scheduledCharges.chargeNow('sch_abc123');
      * switch (result.outcome) {
      *   case 'dispatched':
-     *     console.log(`Cobrança enviada (ciclo ${result.cycleNumber}).`);
+     *     result.cycleNumber; // billed this cycle
      *     break;
      *   case 'already_sent':
-     *     console.log('Já havia sido enviada — nada a fazer.');
-     *     break;
+     *     break; // nothing to do
      *   case 'failed':
-     *     // result.reason is e.g. 'card_expired' or a gateway decline code
-     *     console.error(`Falha na cobrança: ${result.reason}. ${result.message}`);
+     *     result.reason; // e.g. 'card_expired' or a gateway decline code
      *     break;
      *   case 'not_sent':
-     *     console.warn(`Não enviada (${result.reason}): ${result.message}`);
+     *     result.reason;
      *     break;
      * }
      */

package/dist/index.d.ts

@@ -219,6 +219,13 @@ interface RefundChargeParams {
     amount?: number;
     /** Free-form reason stored on the refund. */
     reason?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. Only used
+     * for Pix/boleto, which open a refund request instead of an automated
+     * reversal — ignored for card, which has no manual request to duplicate.
+     */
+    idempotencyKey?: string;
 }
 interface ListChargesParams {
     /** Page number (1-based). Default: 1. */
@@ -324,6 +331,13 @@ interface CreateCustomerParams {
     city?: string;
     /** 2-letter uppercase state code, e.g. `SP`. */
     state?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. Document
+     * uniqueness already merges a retried create into the same customer, so
+     * this mainly protects registrations with no document set.
+     */
+    idempotencyKey?: string;
 }
 interface UpdateCustomerParams {
     name?: string;
@@ -390,7 +404,13 @@ interface ScheduledChargeRecord {
     /** YYYY-MM-DD in São Paulo time. */
     dueDate: string;
     methods: ScheduledPaymentMethod[];
+    recurrence: RecurrenceConfig | null;
     status: ScheduledChargeStatus;
+    subscriptionId: number | null;
+    /** ISO-8601. Set only when the series was created with `trialDays`. */
+    trialEndsAt: string | null;
+    /** Recurring only. Toggle with `setCancelAtPeriodEnd`. */
+    cancelAtPeriodEnd: boolean;
     externalReference: string | null;
     /**
      * Max days past `dueDate` the daily recovery sweep will still auto-bill a
@@ -425,7 +445,7 @@ interface ScheduledChargeEvent {
 }
 interface ScheduledChargeLinkedTransaction {
     id: number;
-    /** Centavos (BRL × 100), matching `garu.charges.*` value semantics. */
+    /** Decimal BRL (e.g. `297.50`), never centavos. */
     value: number;
     paymentMethod: string;
     status: string;
@@ -438,7 +458,14 @@ interface ScheduledChargeDetail {
     events: ScheduledChargeEvent[];
     transactions: ScheduledChargeLinkedTransaction[];
 }
-type ScheduledChargeList = PaginatedList<ScheduledChargeRecord>;
+interface ScheduledChargeList {
+    data: ScheduledChargeRecord[];
+    /** Items on this page. */
+    count: number;
+    /** Total matches across all pages. */
+    totalCount: number;
+    totalPages: number;
+}
 /** Source of a billing attempt — see SPEC §3.1. */
 type ScheduledChargeAttemptSource = 'cycle1_interactive' | 'silent_charge' | 'card_retry' | 'manual_mark_paid' | 'fallback_pix';
 type ScheduledChargeAttemptStatus = 'pending' | 'succeeded' | 'declined' | 'canceled' | 'errored';
@@ -460,7 +487,14 @@ interface ScheduledChargeAttempt {
     gatewayChargeId: number | null;
     transactionId: number | null;
 }
-type ScheduledChargeAttemptList = PaginatedList<ScheduledChargeAttempt>;
+interface ScheduledChargeAttemptList {
+    data: ScheduledChargeAttempt[];
+    /** Items on this page. */
+    count: number;
+    /** Total matches across all pages. */
+    totalCount: number;
+    totalPages: number;
+}
 interface ListScheduledChargeAttemptsParams {
     page?: number;
     limit?: number;
@@ -1031,6 +1065,13 @@ interface RequestPlanRefundParams {
     /** Defaults to everything the carnê has collected. */
     amount?: number;
     reason?: string;
+    /**
+     * Optional idempotency key for safe retries. The SDK auto-generates a
+     * UUIDv4 when omitted and forwards it as `X-Idempotency-Key`. The backend
+     * already dedupes a second pending request for the same carnê, so this is
+     * mainly defense-in-depth for the request-in-flight window.
+     */
+    idempotencyKey?: string;
 }
 interface ListRefundRequestsParams {
     page?: number;
@@ -1075,7 +1116,7 @@ declare class Charges {
      *     phone: '11987654321'
      *   }
      * });
-     * console.log(charge.uuid, charge.pix?.code);
+     * // charge.uuid, charge.pix?.code
      *
      * @example
      * // Credit card, 2 installments. Server-to-server only (PCI scope).
@@ -1107,7 +1148,7 @@ declare class Charges {
      *
      * @example
      * const { data, totalCount } = await garu.charges.list({ status: 'paid', limit: 50 });
-     * console.log(`${data.length} of ${totalCount} paid charges`);
+     * // data.length of totalCount paid charges
      */
     list(params?: ListChargesParams): Promise<ChargeList>;
     /**
@@ -1117,6 +1158,12 @@ declare class Charges {
      * charge in `refund_pending`, reaching `refunded` only once the transfer
      * settles.
      *
+     * For Pix/boleto (which open a refund request instead of an automated
+     * reversal), attaches an `X-Idempotency-Key` header automatically — if you
+     * don't pass `idempotencyKey`, the SDK generates a UUIDv4. Ignored for
+     * card, which reverses automatically and has no manual request to
+     * duplicate.
+     *
      * @example
      * await garu.charges.refund('6f1c9b2e-...');                       // full
      * await garu.charges.refund('6f1c9b2e-...', { amount: 10.0 });     // R$10,00
@@ -1263,6 +1310,11 @@ declare class InstallmentPlans {
      * team. Transfer the money to the buyer yourself, then close it with
      * `garu.refundRequests.confirm`.
      *
+     * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. The backend already dedupes
+     * a second pending request for the same carnê, so this is mainly
+     * defense-in-depth for the request-in-flight window.
+     *
      * @example
      * const request = await garu.installmentPlans.requestRefund(uuid, {
      *   reason: 'Produto não entregue'
@@ -1352,6 +1404,10 @@ declare class Customers {
     /**
      * Register a customer for the current seller.
      *
+     * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+     * `idempotencyKey`, the SDK generates a UUIDv4. Safe to retry: the same key
+     * returns the originally-created/matched customer for 24h.
+     *
      * @example
      * const customer = await garu.customers.create({
      *   name: 'Maria Silva',
@@ -1573,9 +1629,10 @@ declare class ScheduledCharges {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Create a new scheduled charge. Auto-attaches `X-Idempotency-Key`
-     * (UUIDv4 if you don't pass `idempotencyKey`) so retries on transient
-     * network failures don't silently double-create.
+     * Create a new scheduled charge. Attaches an `X-Idempotency-Key` header
+     * automatically — if you don't pass `idempotencyKey`, the SDK generates a
+     * UUIDv4. Safe to retry: the same key returns the originally-created
+     * series for 24h instead of double-booking recurring billing.
      *
      * @example
      * const charge = await garu.scheduledCharges.create({
@@ -1692,17 +1749,15 @@ declare class ScheduledCharges {
      * const result = await garu.scheduledCharges.chargeNow('sch_abc123');
      * switch (result.outcome) {
      *   case 'dispatched':
-     *     console.log(`Cobrança enviada (ciclo ${result.cycleNumber}).`);
+     *     result.cycleNumber; // billed this cycle
      *     break;
      *   case 'already_sent':
-     *     console.log('Já havia sido enviada — nada a fazer.');
-     *     break;
+     *     break; // nothing to do
      *   case 'failed':
-     *     // result.reason is e.g. 'card_expired' or a gateway decline code
-     *     console.error(`Falha na cobrança: ${result.reason}. ${result.message}`);
+     *     result.reason; // e.g. 'card_expired' or a gateway decline code
      *     break;
      *   case 'not_sent':
-     *     console.warn(`Não enviada (${result.reason}): ${result.message}`);
+     *     result.reason;
      *     break;
      * }
      */

package/dist/index.js

@@ -211,7 +211,7 @@ var Charges = class {
    *     phone: '11987654321'
    *   }
    * });
-   * console.log(charge.uuid, charge.pix?.code);
+   * // charge.uuid, charge.pix?.code
    *
    * @example
    * // Credit card, 2 installments. Server-to-server only (PCI scope).
@@ -256,7 +256,7 @@ var Charges = class {
    *
    * @example
    * const { data, totalCount } = await garu.charges.list({ status: 'paid', limit: 50 });
-   * console.log(`${data.length} of ${totalCount} paid charges`);
+   * // data.length of totalCount paid charges
    */
   async list(params = {}) {
     const query = {};
@@ -279,15 +279,24 @@ var Charges = class {
    * charge in `refund_pending`, reaching `refunded` only once the transfer
    * settles.
    *
+   * For Pix/boleto (which open a refund request instead of an automated
+   * reversal), attaches an `X-Idempotency-Key` header automatically — if you
+   * don't pass `idempotencyKey`, the SDK generates a UUIDv4. Ignored for
+   * card, which reverses automatically and has no manual request to
+   * duplicate.
+   *
    * @example
    * await garu.charges.refund('6f1c9b2e-...');                       // full
    * await garu.charges.refund('6f1c9b2e-...', { amount: 10.0 });     // R$10,00
    */
   async refund(uuid, params = {}) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
     const body = {};
     if (params.amount !== void 0) body.amount = params.amount;
     if (params.reason !== void 0) body.reason = params.reason;
-    return this.post(`/api/v1/charges/${encodeURIComponent(uuid)}/refund`, body);
+    return this.post(`/api/v1/charges/${encodeURIComponent(uuid)}/refund`, body, {
+      "X-Idempotency-Key": idempotencyKey
+    });
   }
   /**
    * Cancel an unpaid charge.
@@ -312,7 +321,11 @@ var Charges = class {
   }
   post(url, body, headers) {
     return this.http.call(
-      (signal) => this.http.client.POST(url, { body, headers, signal })
+      (signal) => this.http.client.POST(url, {
+        body,
+        headers,
+        signal
+      })
     );
   }
 };
@@ -501,6 +514,11 @@ var InstallmentPlans = class {
    * team. Transfer the money to the buyer yourself, then close it with
    * `garu.refundRequests.confirm`.
    *
+   * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. The backend already dedupes
+   * a second pending request for the same carnê, so this is mainly
+   * defense-in-depth for the request-in-flight window.
+   *
    * @example
    * const request = await garu.installmentPlans.requestRefund(uuid, {
    *   reason: 'Produto não entregue'
@@ -509,9 +527,12 @@ var InstallmentPlans = class {
    * request.amount;  // defaults to everything the carnê collected
    */
   async requestRefund(uuid, params = {}) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
+    const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
       (signal) => this.http.client.POST(`/api/v1/installment-plans/${uuid}/refund-requests`, {
-        body: params,
+        body,
+        headers: { "X-Idempotency-Key": idempotencyKey },
         signal
       }).then((r) => r)
     );
@@ -619,6 +640,10 @@ var Customers = class {
   /**
    * Register a customer for the current seller.
    *
+   * Attaches an `X-Idempotency-Key` header automatically — if you don't pass
+   * `idempotencyKey`, the SDK generates a UUIDv4. Safe to retry: the same key
+   * returns the originally-created/matched customer for 24h.
+   *
    * @example
    * const customer = await garu.customers.create({
    *   name: 'Maria Silva',
@@ -630,9 +655,12 @@ var Customers = class {
    * customer.uuid;
    */
   async create(params) {
+    const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
+    const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
       (signal) => this.http.client.POST("/api/v1/customers", {
-        body: params,
+        body,
+        headers: { "X-Idempotency-Key": idempotencyKey },
         signal
       }).then((r) => r)
     );
@@ -936,9 +964,10 @@ var ScheduledCharges = class {
   }
   http;
   /**
-   * Create a new scheduled charge. Auto-attaches `X-Idempotency-Key`
-   * (UUIDv4 if you don't pass `idempotencyKey`) so retries on transient
-   * network failures don't silently double-create.
+   * Create a new scheduled charge. Attaches an `X-Idempotency-Key` header
+   * automatically — if you don't pass `idempotencyKey`, the SDK generates a
+   * UUIDv4. Safe to retry: the same key returns the originally-created
+   * series for 24h instead of double-booking recurring billing.
    *
    * @example
    * const charge = await garu.scheduledCharges.create({
@@ -968,7 +997,7 @@ var ScheduledCharges = class {
     const idempotencyKey = params.idempotencyKey ?? generateIdempotencyKey();
     const { idempotencyKey: _omit, ...body } = params;
     return this.http.call(
-      (signal) => this.http.client.POST("/api/scheduled-charges", {
+      (signal) => this.http.client.POST("/api/v1/scheduled-charges", {
         body,
         headers: { "X-Idempotency-Key": idempotencyKey },
         signal
@@ -1003,7 +1032,7 @@ var ScheduledCharges = class {
       for (const s of statuses) qs.append("status", s);
     }
     const query = qs.toString();
-    const url = `/api/scheduled-charges${query ? `?${query}` : ""}`;
+    const url = `/api/v1/scheduled-charges${query ? `?${query}` : ""}`;
     return this.http.call(
       (signal) => this.http.client.GET(url, { signal }).then(
         (r) => r
@@ -1020,7 +1049,7 @@ var ScheduledCharges = class {
    */
   async get(id) {
     return this.http.call(
-      (signal) => this.http.client.GET(`/api/scheduled-charges/${encodeURIComponent(id)}`, {
+      (signal) => this.http.client.GET(`/api/v1/scheduled-charges/${encodeURIComponent(id)}`, {
         signal
       }).then((r) => r)
     );
@@ -1039,7 +1068,7 @@ var ScheduledCharges = class {
   async postpone(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/postpone`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/postpone`,
         {
           body: params,
           signal
@@ -1058,7 +1087,7 @@ var ScheduledCharges = class {
   async pause(id, params = {}) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/pause`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/pause`,
         {
           body: params,
           signal
@@ -1075,7 +1104,7 @@ var ScheduledCharges = class {
   async resume(id) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/resume`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/resume`,
         {
           body: {},
           signal
@@ -1109,7 +1138,7 @@ var ScheduledCharges = class {
   async markPaid(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/mark-paid`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/mark-paid`,
         {
           body: params,
           signal
@@ -1131,24 +1160,22 @@ var ScheduledCharges = class {
    * const result = await garu.scheduledCharges.chargeNow('sch_abc123');
    * switch (result.outcome) {
    *   case 'dispatched':
-   *     console.log(`Cobrança enviada (ciclo ${result.cycleNumber}).`);
+   *     result.cycleNumber; // billed this cycle
    *     break;
    *   case 'already_sent':
-   *     console.log('Já havia sido enviada — nada a fazer.');
-   *     break;
+   *     break; // nothing to do
    *   case 'failed':
-   *     // result.reason is e.g. 'card_expired' or a gateway decline code
-   *     console.error(`Falha na cobrança: ${result.reason}. ${result.message}`);
+   *     result.reason; // e.g. 'card_expired' or a gateway decline code
    *     break;
    *   case 'not_sent':
-   *     console.warn(`Não enviada (${result.reason}): ${result.message}`);
+   *     result.reason;
    *     break;
    * }
    */
   async chargeNow(id) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/charge-now`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/charge-now`,
         {
           body: {},
           signal
@@ -1170,7 +1197,7 @@ var ScheduledCharges = class {
   async cancelRecurrence(id, params = {}) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/cancel-recurrence`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/cancel-recurrence`,
         {
           body: params,
           signal
@@ -1190,7 +1217,7 @@ var ScheduledCharges = class {
   async setCancelAtPeriodEnd(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/cancel-at-period-end`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/cancel-at-period-end`,
         {
           body: params,
           signal
@@ -1209,7 +1236,7 @@ var ScheduledCharges = class {
   async changePaymentMethod(id, params) {
     return this.http.call(
       (signal) => this.http.client.POST(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
         {
           body: params,
           signal
@@ -1228,7 +1255,7 @@ var ScheduledCharges = class {
   async clearPaymentMethod(id) {
     return this.http.call(
       (signal) => this.http.client.DELETE(
-        `/api/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
+        `/api/v1/scheduled-charges/${encodeURIComponent(id)}/payment-method`,
         {
           body: {},
           signal
@@ -1255,7 +1282,7 @@ var ScheduledCharges = class {
     if (params.limit !== void 0) qs.set("limit", String(params.limit));
     if (params.cycleNumber !== void 0) qs.set("cycleNumber", String(params.cycleNumber));
     const query = qs.toString();
-    const url = `/api/scheduled-charges/${encodeURIComponent(id)}/attempts${query ? `?${query}` : ""}`;
+    const url = `/api/v1/scheduled-charges/${encodeURIComponent(id)}/attempts${query ? `?${query}` : ""}`;
     return this.http.call(
       (signal) => this.http.client.GET(url, { signal }).then(
         (r) => r

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garuhq/node",
-  "version": "3.0.0",
+  "version": "4.1.0",
   "description": "Official Node.js / TypeScript SDK for the Garu payment gateway.",
   "license": "MIT",
   "homepage": "https://garu.com.br",