@v3finance/core-sdk 0.1.0 → 0.2.0

package/dist/cjs/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,aAAa;AACvB,oFAAoF;AAClF,MAAM;AACR,uFAAuF;GACrF,SAAS;AACX,sFAAsF;GACpF,SAAS;AACX,gEAAgE;GAC9D,SAAS;AACX,yEAAyE;GACvE,OAAO,CAAA;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAErC,YAAY,IAAI,EAAE,aAAa,EAQ9B;CACF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyBrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAiD1F;AAsBD,eAAO,MAAM,YAAY,UAAW,OAAO,aAAa,MAAM,KAAG,SAQ7D,CAAA;AAEJ,eAAO,MAAM,YAAY,OAAQ,MAAM,aAAa,MAAM,KAAG,SAOzD,CAAA;AAEJ,eAAO,MAAM,YAAY,cAAe,MAAM,KAAG,SAO7C,CAAA;AAEJ,eAAO,MAAM,UAAU,UAAW,OAAO,aAAa,MAAM,KAAG,SAQ3D,CAAA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,aAAa;AACvB,oFAAoF;AAClF,MAAM;AACR,uFAAuF;GACrF,SAAS;AACX,sFAAsF;GACpF,SAAS;AACX,gEAAgE;GAC9D,SAAS;AACX,yEAAyE;GACvE,OAAO,CAAA;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAErC,YAAY,IAAI,EAAE,aAAa,EAQ9B;CACF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAsD1F;AAsBD,eAAO,MAAM,YAAY,UAAW,OAAO,aAAa,MAAM,KAAG,SAQ7D,CAAA;AAEJ,eAAO,MAAM,YAAY,OAAQ,MAAM,aAAa,MAAM,KAAG,SAYzD,CAAA;AAEJ,eAAO,MAAM,YAAY,cAAe,MAAM,KAAG,SAO7C,CAAA;AAEJ,eAAO,MAAM,UAAU,UAAW,OAAO,aAAa,MAAM,KAAG,SAQ3D,CAAA"}

package/dist/cjs/core/errors.js

@@ -6,14 +6,30 @@
  * wrapper has three gaps the client has to close itself — otherwise a precise
  * error turns into "something went wrong":
  *
- *   1. Bodies without an `error` key pass through untouched. Batch sharing
- *      endpoints answer 400 with `{results:[…]}`, which is not a failure of
- *      the whole call but "some subjects were rejected", and has to be read
- *      item by item.
- *   2. Validation failures arrive as a plain string — `{error: "path: msg"}`
- *      — with no code and no details.
- *   3. Inside a batch result `message` equals the code (`{code:"X",
- *      message:"X"}`), so it must never be shown to a person as-is.
+ *   1. Bodies without an `error` key pass through untouched — the wrapper
+ *      keys off that one field. Batch sharing endpoints answer 400 with
+ *      `{results:[…]}`, which is not a failure of the whole call but "some
+ *      subjects were rejected", and has to be read item by item.
+ *   2. Non-JSON bodies have no wrapper at all: the layer leaves by
+ *      content-type, and a thrown `HTTPException` carries its own response
+ *      past it. So a 502 from the edge, a WAF 403 or a platform 429 arrive as
+ *      text. `core/http.ts` reduces a short one to a flat `{error: "…"}`
+ *      (dropping HTML pages) before it reaches this parser, which is why the
+ *      flat string shape below is still read — and why the per-status
+ *      fallback wording here is what a person ends up seeing.
+ *   3. `message` sometimes IS the code. Handlers answer `{error: "<CODE>",
+ *      code: "<CODE>"}` and batch items carry `{code:"X", message:"X"}`; the
+ *      wrapper copies the former into `message` faithfully. A code is not a
+ *      sentence, so it must never be shown to a person as-is.
+ *
+ * What is NOT a gap any more: zod validation failures. The route hook does
+ * build a flat `{error: "amount: Required; …"}` (backend
+ * `openapi/common.ts`), but that is an intermediate form.
+ * `middleware/errorEnvelope` rewraps every JSON body carrying a string
+ * `error` into the canonical envelope, `code` derived from the status —
+ * `BAD_REQUEST` here, because the hook sets none of its own. The same layer
+ * answers an unmatched path and an uncaught throw. Reading `body.error` as a
+ * string against today's API therefore hands you an object.
  *
  * Because of that `code` is always present here: either the server sent one,
  * or it is derived from the HTTP status. Branch on `code`, display `message`.
@@ -52,29 +68,37 @@ function hasCode(e, ...codes) {
     return isCoreError(e) && codes.includes(e.code);
 }
 /**
- * Status to code, mirroring the mapping the API uses, so that both sides call
- * the same thing by the same name.
+ * Status to code, used only when a body carried no code of its own: a proxy's
+ * HTML 502, a platform 429, an empty body.
+ *
+ * The names are the API's own names for the same statuses, so that one
+ * condition has one name whichever side produced it. 502 and 504 are the
+ * exception — the API has no envelope for them, they arrive from the edge.
  */
 function codeFromStatus(status) {
     switch (status) {
         case 400:
             return 'BAD_REQUEST';
         case 401:
-            return 'UNAUTHORIZED';
+            return 'UNAUTHENTICATED';
         case 403:
             return 'FORBIDDEN';
         case 404:
             return 'NOT_FOUND';
         case 409:
             return 'CONFLICT';
+        case 413:
+            return 'PAYLOAD_TOO_LARGE';
         case 422:
-            return 'UNPROCESSABLE';
+            return 'UNPROCESSABLE_ENTITY';
         case 429:
             return 'RATE_LIMITED';
+        case 501:
+            return 'NOT_IMPLEMENTED';
         case 502:
             return 'BAD_GATEWAY';
         case 503:
-            return 'UNAVAILABLE';
+            return 'SERVICE_UNAVAILABLE';
         case 504:
             return 'GATEWAY_TIMEOUT';
         default:
@@ -110,7 +134,12 @@ function parseErrorBody(status, body, endpoint) {
             : fallbackMessage(status);
         return make(message, code, o.details);
     }
-    // Shape 2 — a validation failure as a string: {error: "path: msg; …"}
+    // Shape 2 — a flat string `error`. No longer how validation failures reach
+    // a client (the envelope rewraps those into Shape 1), so the live producer
+    // is `core/http.ts`, which folds a short non-JSON error body into this
+    // shape. The sibling `code` is still read: handlers do put one next to a
+    // string `error`, and an older deployment without the envelope layer would
+    // deliver exactly that.
     if (typeof inner === 'string' && inner) {
         const flat = body.code;
         const code = typeof flat === 'string' && flat ? flat : fallbackCode;
@@ -156,7 +185,10 @@ const timeoutError = (ms, endpoint) => new CoreError({
     kind: 'timeout',
     code: 'TIMEOUT',
     status: null,
-    message: `The server did not answer within ${Math.round(ms / 1000)}s`,
+    // Sub-second timeouts rounded to `0s`, which reads as "no time was
+    // allowed" rather than "400ms was". Below a second the unit changes
+    // instead of the number; a whole second keeps the shorter wording.
+    message: `The server did not answer within ${ms < 1000 ? `${Math.round(ms)}ms` : `${Math.round(ms / 1000)}s`}`,
     ...(endpoint === undefined ? {} : { endpoint }),
 });
 exports.timeoutError = timeoutError;

package/dist/cjs/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/cjs/core/gated.d.ts

@@ -4,8 +4,10 @@
  *
  *   201 — applied immediately (policy allowed it without signatures);
  *   202 — queued for approval, funds are reserved, nothing has moved yet;
- *   200 — a replay of the same idempotency key: nothing happened now, the
- *         existing operation came back (no second broadcast).
+ *   200 — on a transfer: a replay of the same idempotency key, nothing
+ *         happened now and the existing operation came back (no second
+ *         broadcast). Everywhere else: an ordinary applied success, because
+ *         an edit is not a creation and answers 200 (see `replayOn200`).
  *
  * The body can be identical: a transfer returns `{transaction}` in all three.
  * A client that reads only the body will say "sent" where the truth is
@@ -17,9 +19,18 @@
  * person should be told "already sent", not "sent" a second time.
  */
 export type GatedOutcome = 'applied' | 'pending' | 'replayed';
+/**
+ * `status` is the status the server ACTUALLY answered, which is why `applied`
+ * carries `200 | 201` rather than 201 alone: an ordinary 200 success is an
+ * applied operation too (updating a counterparty, editing a label — anything
+ * gated that is not a creation). The field used to be hard-coded to 201 for
+ * those, so every gated method except `transfers.send` reported a status the
+ * server never sent, into logs and error reports where it is the one thing
+ * worth trusting. Branch on `outcome`; read `status` when you need the fact.
+ */
 export type Gated<TApplied, TPending = TApplied> = {
     readonly outcome: 'applied';
-    readonly status: 201;
+    readonly status: 200 | 201;
     readonly data: TApplied;
 } | {
     readonly outcome: 'replayed';
@@ -39,6 +50,13 @@ export type Gated<TApplied, TPending = TApplied> = {
  * success. Telling a person "already sent" after a plain edit would be as
  * wrong as telling them "done" after a replay, so each caller states which
  * of the two it is instead of the helper guessing.
+ *
+ * Which also means `outcome: 'replayed'` is UNREACHABLE for every gated
+ * method other than `transfers.send`: replay protection needs an idempotency
+ * key, and the transfer body is the only place the API takes one. The
+ * three-way `switch` in `docs/concepts.md` is right for a transfer; beside a
+ * counterparty edit its `case 'replayed'` is dead, and it is not evidence
+ * that such an edit can come back as a replay.
  */
 export declare function toGated<TApplied, TPending>(status: number, data: unknown, options?: {
     replayOn200?: boolean;

package/dist/cjs/core/gated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gated.d.ts","sourceRoot":"","sources":["../../../src/core/gated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAE7D,MAAM,MAAM,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,IAC3C;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAElF;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAgB3B;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACb,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,CAAC,CAEhE;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACb,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CAEnD"}
+{"version":3,"file":"gated.d.ts","sourceRoot":"","sources":["../../../src/core/gated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,IAC3C;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAElF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAgB3B;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACb,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,CAAC,CAEhE;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACb,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CAEnD"}

package/dist/cjs/core/gated.js

@@ -5,8 +5,10 @@
  *
  *   201 — applied immediately (policy allowed it without signatures);
  *   202 — queued for approval, funds are reserved, nothing has moved yet;
- *   200 — a replay of the same idempotency key: nothing happened now, the
- *         existing operation came back (no second broadcast).
+ *   200 — on a transfer: a replay of the same idempotency key, nothing
+ *         happened now and the existing operation came back (no second
+ *         broadcast). Everywhere else: an ordinary applied success, because
+ *         an edit is not a creation and answers 200 (see `replayOn200`).
  *
  * The body can be identical: a transfer returns `{transaction}` in all three.
  * A client that reads only the body will say "sent" where the truth is
@@ -30,13 +32,20 @@ exports.isPending = isPending;
  * success. Telling a person "already sent" after a plain edit would be as
  * wrong as telling them "done" after a replay, so each caller states which
  * of the two it is instead of the helper guessing.
+ *
+ * Which also means `outcome: 'replayed'` is UNREACHABLE for every gated
+ * method other than `transfers.send`: replay protection needs an idempotency
+ * key, and the transfer body is the only place the API takes one. The
+ * three-way `switch` in `docs/concepts.md` is right for a transfer; beside a
+ * counterparty edit its `case 'replayed'` is dead, and it is not evidence
+ * that such an edit can come back as a replay.
  */
 function toGated(status, data, options = {}) {
     switch (status) {
         case 200:
             return options.replayOn200
                 ? { outcome: 'replayed', status: 200, data: data }
-                : { outcome: 'applied', status: 201, data: data };
+                : { outcome: 'applied', status: 200, data: data };
         case 201:
             return { outcome: 'applied', status: 201, data: data };
         case 202:

package/dist/cjs/core/gated.js.map

@@ -1 +1 @@
-{"version":3,"file":"gated.js","sourceRoot":"","sources":["../../../src/core/gated.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;AASH;;;;;;;;;GASG;AACH,iBACE,MAAc,EACd,IAAa,EACb,OAAO,GAA8B,EAAE;IAEvC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,OAAO,CAAC,WAAW;gBACxB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE;gBAC9D,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACjE,KAAK,GAAG;YACN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACpE,KAAK,GAAG;YACN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACpE;YACE,MAAM,IAAI,KAAK,CACb,kDAAkD,MAAM,IAAI;gBAC1D,yDAAyD,CAC5D,CAAA;IACL,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,mBACE,CAAc;IAEd,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,UAAU,CAAA;AAC5D,CAAC;AAED,yEAAyE;AACzE,mBACE,CAAc;IAEd,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,CAAA;AAChC,CAAC"}
+{"version":3,"file":"gated.js","sourceRoot":"","sources":["../../../src/core/gated.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;AAkBH;;;;;;;;;;;;;;;;GAgBG;AACH,iBACE,MAAc,EACd,IAAa,EACb,OAAO,GAA8B,EAAE;IAEvC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,OAAO,CAAC,WAAW;gBACxB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE;gBAC9D,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACjE,KAAK,GAAG;YACN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACpE,KAAK,GAAG;YACN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAgB,EAAE,CAAA;QACpE;YACE,MAAM,IAAI,KAAK,CACb,kDAAkD,MAAM,IAAI;gBAC1D,yDAAyD,CAC5D,CAAA;IACL,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,mBACE,CAAc;IAEd,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,UAAU,CAAA;AAC5D,CAAC;AAED,yEAAyE;AACzE,mBACE,CAAc;IAEd,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,CAAA;AAChC,CAAC"}

package/dist/cjs/core/http.d.ts

@@ -39,15 +39,19 @@ export interface RequestOptions {
     signal?: AbortSignal | undefined;
     timeoutMs?: number | undefined;
     /**
-     * Attempt key, sent as the `idempotency-key` header.
+     * Attempt key. ACCEPTED AND IGNORED BY THE TRANSPORT — the working place
+     * for it is the request BODY, the way `transfers.send` passes it.
      *
-     * THE SERVER DOES NOT READ THIS HEADER TODAY. Replay protection on money
-     * paths is resolved from the `idempotencyKey` FIELD OF THE BODY — that is
-     * what `transfers.send` uses, and that is what protects it. The header is
-     * here for the day the API starts honouring it; until then, calling a
-     * money endpoint through the low-level client and passing the key only
-     * here buys you nothing, and a retry after a timeout sends the money
-     * twice. Put the key in the body.
+     * It used to go out as an `idempotency-key` header. The server has never
+     * read that header, which by itself merely bought nothing; in a browser it
+     * cost the whole request. The API's CORS preflight allows exactly
+     * `Content-Type` and `Authorization` (`allowHeaders`, backend
+     * `src/index.ts`), so the extra header failed the preflight and the call
+     * was never sent at all — a money request that could not reach the server,
+     * and a "network error" that no retry explains. Replay protection is
+     * resolved from the `idempotencyKey` FIELD of the body and nowhere else.
+     *
+     * @deprecated The transport sends this nowhere. Put the key in the body.
      */
     idempotencyKey?: string | undefined;
     headers?: Record<string, string> | undefined;

package/dist/cjs/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,aAAa,CAAA;AAwBpB,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAA;AAE1C,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,SAAS,GACT,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;IAE/C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExD,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3D,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAE/B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAC7C;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,sFAAsF;AACtF,eAAO,MAAM,GAAG,UAAW,MAAM,KAAG,MAAmC,CAAA;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAa/D;AAED,qBAAa,UAAU;;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAKxB,YAAY,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAWvD;IAED,yFAAyF;IACnF,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;IAED;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAc5F;IAED,qFAAqF;IAC/E,UAAU,CAAC,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAczB;CA4DF"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,aAAa,CAAA;AAwBpB,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAA;AAE1C,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,SAAS,GACT,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;IAE/C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExD,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3D,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAE/B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAC7C;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,CAAC,CAAA;IACP,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,sFAAsF;AACtF,eAAO,MAAM,GAAG,UAAW,MAAM,KAAG,MAAmC,CAAA;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAa/D;AAED,qBAAa,UAAU;;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAKxB,YAAY,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAWvD;IAED,yFAAyF;IACnF,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;IAED;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB5F;IAED,qFAAqF;IAC/E,UAAU,CAAC,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAYzB;CA8FF"}

package/dist/cjs/core/http.js

@@ -86,13 +86,18 @@ class HttpClient {
      * time. Read it with `.blob()`, `.text()` or `.arrayBuffer()`.
      */
     async fetchRaw(method, path, options = {}) {
-        const { response, endpoint } = await this.#send(method, path, options);
+        // The body is touched only when the call FAILED — and then by the same
+        // reader a JSON call uses, so one 502 from the edge produces one message
+        // whichever method asked for it. The two used to disagree: this one fell
+        // back to neutral wording while `requestRaw` put the proxy's HTML page
+        // into `message`.
+        //
+        // On success the response is handed over unread, which also means the
+        // timeout ends at the headers here: the file body is the caller's to read
+        // and to bound, with their own signal.
+        const { response, endpoint, payload } = await this.#send(method, path, options, (r, ep) => r.ok ? Promise.resolve(undefined) : readJsonBody(r, ep));
         if (!response.ok) {
-            const body = await response
-                .clone()
-                .json()
-                .catch(() => undefined);
-            const error = (0, errors_js_1.parseErrorBody)(response.status, body, endpoint);
+            const error = (0, errors_js_1.parseErrorBody)(response.status, payload, endpoint);
             if (response.status === 401 && this.#options.onUnauthorized) {
                 await this.#options.onUnauthorized(error);
             }
@@ -102,18 +107,28 @@ class HttpClient {
     }
     /** Same, but exposes the status — needed where 200 and 202 mean different things. */
     async requestRaw(method, path, options = {}) {
-        const { response, endpoint } = await this.#send(method, path, options);
-        const data = await readBody(response, endpoint);
+        const { response, endpoint, payload } = await this.#send(method, path, options, readJsonBody);
         if (!response.ok) {
-            const error = (0, errors_js_1.parseErrorBody)(response.status, data, endpoint);
+            const error = (0, errors_js_1.parseErrorBody)(response.status, payload, endpoint);
             if (response.status === 401 && this.#options.onUnauthorized) {
                 await this.#options.onUnauthorized(error);
             }
             throw error;
         }
-        return { status: response.status, data: data, headers: response.headers };
+        return { status: response.status, data: payload, headers: response.headers };
     }
-    async #send(method, path, options) {
+    /**
+     * One attempt: headers out, body in, cleanup.
+     *
+     * The body is read HERE, through `readPayload`, instead of by the caller
+     * afterwards — because the timeout and the caller's signal have to stay
+     * armed until the body is in hand. Headers arrive first and the body streams
+     * after; with the timer cleared at the headers, a server that answers and
+     * then stalls mid-body left a request hanging with nothing to end it. On a
+     * money path that is a transfer whose outcome is never learned, and no
+     * retry decision either.
+     */
+    async #send(method, path, options, readPayload) {
         const endpoint = `${method.toUpperCase()} ${path}`;
         const url = `${this.baseUrl}${path}${serializeQuery(options.query)}`;
         const timeoutMs = options.timeoutMs ?? this.#timeoutMs;
@@ -126,8 +141,14 @@ class HttpClient {
         };
         if (options.body !== undefined)
             headers['content-type'] = 'application/json';
-        if (options.idempotencyKey)
-            headers['idempotency-key'] = options.idempotencyKey;
+        // NOTHING ELSE IS ADDED BY DEFAULT, and that is a browser constraint
+        // rather than minimalism: the API's CORS preflight allows exactly
+        // `Content-Type` and `Authorization`, so any further header of ours makes
+        // the preflight fail and the request is never sent. These three are safe —
+        // `accept` is CORS-safelisted, and `user-agent` is a forbidden header name
+        // the browser drops before it can be preflighted (it still reaches the API
+        // from Node and React Native, which is where it is useful). A header
+        // passed in through `headers` is the caller's own risk.
         // A timer of our own on top of the caller's signal: `AbortSignal.timeout`
         // is missing in some React Native runtimes, and "the caller cancelled" has
         // to stay distinguishable from "time ran out" — on money paths those call
@@ -140,45 +161,89 @@ class HttpClient {
         }, timeoutMs);
         const onExternalAbort = () => controller.abort();
         options.signal?.addEventListener('abort', onExternalAbort, { once: true });
-        let response;
+        const classify = (cause) => transportError(cause, { timedOut, timeoutMs, endpoint, signal: options.signal });
+        // The cleanup is an OUTER finally, so it also runs when `onTokenRotated`
+        // throws — a caller's storage failure should not leave our timer armed,
+        // ready to abort an unrelated stream seconds later.
         try {
-            response = await this.#fetch(url, {
-                method: method.toUpperCase(),
-                headers,
-                ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),
-                ...(this.#options.credentials === undefined
-                    ? {}
-                    : { credentials: this.#options.credentials }),
-                signal: controller.signal,
-            });
-        }
-        catch (cause) {
-            if (timedOut)
-                throw (0, errors_js_1.timeoutError)(timeoutMs, endpoint);
-            if (options.signal?.aborted)
-                throw (0, errors_js_1.abortedError)(endpoint);
-            throw (0, errors_js_1.networkError)(cause, endpoint);
+            let response;
+            try {
+                response = await this.#fetch(url, {
+                    method: method.toUpperCase(),
+                    headers,
+                    ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),
+                    ...(this.#options.credentials === undefined
+                        ? {}
+                        : { credentials: this.#options.credentials }),
+                    signal: controller.signal,
+                });
+            }
+            catch (cause) {
+                throw classify(cause);
+            }
+            // Rotation arrives on successful responses too, and is taken BEFORE the
+            // body: the token is valid whatever the body turns out to be, and a
+            // rotation we drop signs the client out at the next one.
+            const rotated = response.headers.get(ROTATED_TOKEN_HEADER);
+            if (rotated && this.#options.onTokenRotated)
+                await this.#options.onTokenRotated(rotated);
+            let payload;
+            try {
+                payload = await readPayload(response, endpoint);
+            }
+            catch (cause) {
+                throw classify(cause);
+            }
+            return { response, endpoint, payload };
         }
         finally {
             clearTimeout(timer);
             options.signal?.removeEventListener('abort', onExternalAbort);
         }
-        // Rotation arrives on successful responses too.
-        const rotated = response.headers.get(ROTATED_TOKEN_HEADER);
-        if (rotated && this.#options.onTokenRotated)
-            await this.#options.onTokenRotated(rotated);
-        return { response, endpoint };
     }
 }
 exports.HttpClient = HttpClient;
+/**
+ * Names a transport failure, of the request or of the body behind it.
+ *
+ * The distinction is not cosmetic on a money path: a timeout may have been
+ * applied server-side (retry only with the same idempotency key), a cancel is
+ * the caller's own decision and must not be shown as a failure, and a network
+ * error never left the device. A `CoreError` arrives already named — the body
+ * reader raises one when a successful response is not the JSON the contract
+ * promises — and is passed through, so "the contract is wrong" is not reported
+ * as "the network is down".
+ *
+ * Our own timeout wins over the caller's signal, and both win over the cause:
+ * an abort mid-body surfaces as the abort that caused it, not as the opaque
+ * `AbortError` the stream rejects with.
+ */
+function transportError(cause, ctx) {
+    if (ctx.timedOut)
+        return (0, errors_js_1.timeoutError)(ctx.timeoutMs, ctx.endpoint);
+    if (ctx.signal?.aborted)
+        return (0, errors_js_1.abortedError)(ctx.endpoint);
+    if ((0, errors_js_1.isCoreError)(cause))
+        return cause;
+    return (0, errors_js_1.networkError)(cause, ctx.endpoint);
+}
+/** The longest fragment of a non-JSON error body worth carrying into a message. */
+const MAX_PLAIN_ERROR_CHARS = 200;
 /**
  * An empty body (204, DELETE) is `undefined`, not a parse failure. Invalid
  * JSON on a SUCCESSFUL status is a failure: the contract is not what we think
- * it is, and returning `undefined` quietly is worse than throwing. On an error
- * status the text is kept as-is for `parseErrorBody` to read.
+ * it is, and returning `undefined` quietly is worse than throwing.
+ *
+ * A read that fails halfway is no longer swallowed. It used to be caught into
+ * an empty string, which turned a truncated response — a dropped connection,
+ * our own timeout firing while the body streamed — into `data: undefined`
+ * typed as the shape the caller asked for: a failure wearing the face of a
+ * successful empty answer, and on a balance or a transfer the worst possible
+ * disguise. The rejection now travels out to `transportError`, which names it
+ * a timeout, a cancel or a network failure.
  */
-async function readBody(response, endpoint) {
-    const text = await response.text().catch(() => '');
+async function readJsonBody(response, endpoint) {
+    const text = await response.text();
     if (!text)
         return undefined;
     try {
@@ -187,7 +252,32 @@ async function readBody(response, endpoint) {
     catch (cause) {
         if (response.ok)
             throw (0, errors_js_1.parseError)(cause, endpoint);
-        return { error: text };
+        return plainTextError(text);
     }
 }
+/**
+ * A non-JSON error body reduced to something showable — or to nothing.
+ *
+ * Who sends these: everything in front of the API, never the API itself. A
+ * 502/504 while the worker is being replaced, a 403 from a WAF, a platform
+ * 429 — they answer with a whole HTML page (2318 bytes in one measured case).
+ * Passing that on as `{error: text}` put the page into `message`, which is the
+ * one field meant to be read by a person.
+ *
+ * Markup is therefore dropped and `parseErrorBody` falls back to its own
+ * wording for the status. A short line of plain text is kept instead of being
+ * dropped with it, because a proxy occasionally says something the status does
+ * not ("upstream connect error", "no healthy upstream").
+ */
+function plainTextError(text) {
+    // A leading `<` catches HTML and XML error documents alike; neither is ours.
+    const collapsed = text.trim().replace(/\s+/g, ' ');
+    if (!collapsed || collapsed.startsWith('<'))
+        return undefined;
+    return {
+        error: collapsed.length > MAX_PLAIN_ERROR_CHARS
+            ? `${collapsed.slice(0, MAX_PLAIN_ERROR_CHARS)}…`
+            : collapsed,
+    };
+}
 //# sourceMappingURL=http.js.map

package/dist/cjs/core/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"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"}

package/dist/cjs/core/pagination.d.ts

@@ -1,5 +1,32 @@
 /**
- * Keyset pagination. Every list endpoint returns `{items, nextCursor}`.
+ * Keyset pagination — for the eleven endpoints that have it.
+ *
+ * "Every list returns `{items, nextCursor}`" is what this file used to claim,
+ * and it is not what the API does. Counted over the spec snapshot
+ * (`openapi/spec.json`), the reading endpoints fall into three shapes:
+ *
+ *   • 11 GETs take `cursor`/`limit` and answer a `nextCursor` — addresses,
+ *     history, approval requests, members, counterparties, counterparty
+ *     groups, operation categories, operation relations, ledger entries, a
+ *     vault's policies, balances. These are what `paginate` is for;
+ *   • 18 answer `{items}` with NO cursor parameter at all — folders and their
+ *     grants, address shares, shared-with-me / shared-by-me, visibility
+ *     grants, category assignments and their versions, report templates and
+ *     snapshots, user groups and their members, status history, the
+ *     admin-level `/policies` list and one policy's versions (18 paths, two
+ *     of them the older `/address-groups` prefix of the folder endpoints).
+ *     What you get is everything there is; `paginate` over one of them yields
+ *     that single page and stops, because an absent `nextCursor` is the
+ *     end-of-list signal;
+ *   • 8 answer a BARE ARRAY rather than an object: `/networks`, `/tokens`,
+ *     `/vaults`, a vault's `/policy-groups` and `/invitations`, one
+ *     operation's `/relations`, a policy group's `/policies`, a user's
+ *     `/policy-groups`. There is no `items` to walk, so `paginate` refuses
+ *     them by name instead of quietly yielding nothing.
+ *
+ * `/balances` is the one cursored endpoint `paginate` CANNOT walk: its page is
+ * `{vaultId, totals, accounts, nextCursor}` and the array is called
+ * `accounts`. Pass the cursor by hand there.
  *
  * The cursor is opaque: do not parse it, build it or compare it. A
  * `nextCursor` of `null` is the only end-of-list signal — an empty page is

package/dist/cjs/core/pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAyBpC;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,CAAC,EAChC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,CAAC,EAAE,CAAC,CAId"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAmCpC;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,CAAC,EAChC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACnD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,CAAC,EAAE,CAAC,CAId"}