@ordersail/storefront-sdk 0.6.0 → 0.8.0

package/README.md

@@ -25,7 +25,7 @@ Inside this monorepo it's consumed via the npm workspace protocol instead
 import { StorefrontClient, ApiError } from "@ordersail/storefront-sdk";
 
 const storefront = new StorefrontClient(
-  "https://api.your-storefront-api-host.com",
+  "https://storefront.ordersail.com",
   "sfk_...", // your account's app key — see "Auth model" below
 );
 
@@ -40,6 +40,40 @@ try {
 }
 ```
 
+`baseUrl` is the bare host. The API is versioned in its paths (every route
+lives under `/v1`), and the SDK adds that prefix itself, so a given SDK
+release always talks to the API version it was generated from.
+
+### Upgrading from 0.7.x
+
+**0.8.0 changes how errors arrive.** Every API error now has one body, and
+`ApiError` carries it as typed fields: branch on `err.code` (see
+[Error handling](#error-handling)) instead of `err.status` or the message.
+Two behaviours change with it:
+
+- The client refreshes the customer's token only on `invalid_access_token`.
+  A bad app key or wrong credentials no longer trigger a refresh and retry.
+- `ApiError`'s constructor changed. If you construct one yourself (in tests,
+  say), pass `(message, status, body?)`.
+
+0.7.x clients keep working against the new API, but every `ApiError.message`
+is the generic `Request failed (<status>)`.
+
+```bash
+npm install @ordersail/storefront-sdk@^0.8.0
+```
+
+### Upgrading from 0.6.x
+
+**0.7.0 is a breaking change.** storefront-api now serves every route under
+`/v1`, so 0.6.x clients, which call unprefixed paths, get `404` on every
+request. Upgrading is just the package bump; `baseUrl` stays the bare host
+(don't append `/v1` yourself):
+
+```bash
+npm install @ordersail/storefront-sdk@^0.7.0
+```
+
 ## Resources
 
 | Resource                 | Method                        | Throws `ApiError`? |
@@ -66,22 +100,58 @@ try {
 
 ## Error handling
 
-Every mutation throws `ApiError` (from `@ordersail/storefront-sdk`) on a
-non-2xx response:
+Every failed call throws `ApiError` (from `@ordersail/storefront-sdk`). Every
+API error has the same shape, so one handler covers them all:
 
 ```ts
 export class ApiError extends Error {
-  readonly status: number; // the HTTP status code
-  readonly message: string; // the server's message, when it sends one
+  readonly status: number; // the HTTP status
+  readonly code: ApiErrorCode | undefined; // what to branch on, e.g. "email_taken"
+  readonly type: ApiErrorType | undefined; // the broad category, e.g. "invalid_request_error"
+  readonly message: string; // for people — show it, never parse it
+  readonly param: string | undefined; // the request field at fault, when there is one
+  readonly details: Record<string, unknown> | undefined; // data specific to the code
+  readonly requestId: string | undefined; // quote this when reporting a problem
+  readonly docUrl: string | undefined; // the code's reference page
 }
 ```
 
-`error.message` is the API's own message when the response body has one
-(most validation and conflict errors do); otherwise it falls back to
-`` `Request failed (${status})` ``. Two exceptions worth knowing: `signIn`'s
-`401` and `signUp`'s `409` currently carry no response body at all, so
-`error.message` for those two is always the generic fallback — write your
-own copy for those cases rather than surfacing it.
+**Branch on `code`, never on `message`.** Codes are part of the SDK's
+contract; messages can be reworded at any time. `ApiErrorCode` is the union of
+every code the API returns, and `isApiError` narrows a caught value:
+
+```ts
+import { isApiError } from "@ordersail/storefront-sdk";
+
+try {
+  await client.signUp(form);
+} catch (err) {
+  if (isApiError(err, "email_taken")) {
+    setFieldError(err.param ?? "email", "That email already has an account.");
+  } else if (isApiError(err, "validation_failed")) {
+    // details.fields lists every failing field as { param, message }
+    for (const { param, message } of err.details.fields) setFieldError(param, message);
+  } else {
+    throw err;
+  }
+}
+```
+
+A few codes worth knowing:
+
+| Code | When |
+|---|---|
+| `invalid_app_key` | The `x-app-key` is missing, wrong or revoked. A configuration problem — fix the key. |
+| `invalid_access_token` | The customer's access token is missing, expired or invalid. The client refreshes and retries this one for you. |
+| `invalid_credentials` | `signIn` with a wrong email or password. |
+| `email_taken` | `signUp` (or a profile update) with an email that already has an account. |
+| `validation_failed` | A request field failed validation; `param` is the first, `details.fields` lists all. |
+| `not_found` | The resource doesn't exist (single-resource reads return `undefined` instead). |
+| `internal_error` | Something failed on OrderSail's side. The message is always generic; quote `requestId`. |
+
+`code` is `undefined` only when the response carried no error body at all (a
+proxy's or the network's error page); `message` is then
+`` `Request failed (${status})` ``.
 
 ## Auth model
 
@@ -113,7 +183,7 @@ reload, not `client.refreshToken` read once:
 
 ```ts
 const storefront = new StorefrontClient(
-  "https://api.your-storefront-api-host.com",
+  "https://storefront.ordersail.com",
   "sfk_...",
   undefined, // cartToken — restore the same way if you have one saved
   localStorage.getItem("refreshToken") ?? undefined,

package/dist/http.d.ts

@@ -1,3 +1,4 @@
+import type { components } from "./types.gen.js";
 export type DoRequest<T> = () => Promise<{
     data?: T;
     error?: unknown;
@@ -8,10 +9,34 @@ export type DoFn = <T>(request: DoRequest<T>) => Promise<{
     error?: unknown;
     response: Response;
 }>;
+export type ErrorBody = components["schemas"]["ErrorResponse"]["error"];
+export type ApiErrorCode = ErrorBody["code"];
+export type ApiErrorType = ErrorBody["type"];
 export declare class ApiError extends Error {
     readonly status: number;
-    constructor(message: string, status: number);
+    readonly type: ApiErrorType | undefined;
+    readonly code: ApiErrorCode | undefined;
+    readonly param: string | undefined;
+    readonly docUrl: string | undefined;
+    readonly requestId: string | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(message: string, status: number, body?: ErrorBody);
 }
+export interface ApiErrorDetails {
+    validation_failed: {
+        fields: {
+            param: string;
+            message: string;
+        }[];
+    };
+}
+type DetailsFor<C extends ApiErrorCode> = C extends keyof ApiErrorDetails ? ApiErrorDetails[C] : Record<string, unknown> | undefined;
+export declare function isApiError<C extends ApiErrorCode>(err: unknown, code?: C): err is ApiError & {
+    code: C;
+    details: DetailsFor<C>;
+};
+export declare function readErrorBody(body: unknown): ErrorBody | undefined;
+export declare function isStaleTokenError(body: unknown): boolean;
 export declare function unwrap<T>(result: {
     data?: T;
     error?: unknown;
@@ -22,4 +47,5 @@ export declare function unwrapOrUndefinedOn<T>(result: {
     error?: unknown;
     response: Response;
 }, expectedStatus: number): T | undefined;
+export {};
 //# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CAAC;AAKH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,EACnB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,KAClB,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAIhE,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;CAK1B;AAkBD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,CAAC,CAGJ;AAMD,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,EACzD,cAAc,EAAE,MAAM,GACrB,CAAC,GAAG,SAAS,CAIf"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CAAC;AAKH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,EACnB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,KAClB,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAIhE,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC;AAGxE,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAc7C,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS;CAW9D;AAMD,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;CACrE;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,SAAS,MAAM,eAAe,GACrE,eAAe,CAAC,CAAC,CAAC,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;AAUxC,wBAAgB,UAAU,CAAC,CAAC,SAAS,YAAY,EAC/C,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE,CAAC,GACP,GAAG,IAAI,QAAQ,GAAG;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;CAAE,CAEvD;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAQlE;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAExD;AAgBD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,CAAC,CAGJ;AAUD,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,EACzD,cAAc,EAAE,MAAM,GACrB,CAAC,GAAG,SAAS,CAKf"}

package/dist/http.js

@@ -1,41 +1,92 @@
-// A non-2xx response from the API. `message` is the server's message when it
-// sends one (NestJS `{ message }`, string or string[]), otherwise a fallback.
+// A non-2xx response from the API.
+//
+// - `code` is what to branch on (`email_taken`, `invalid_credentials`, …). It's
+//   undefined only when the response carried no error body at all (a proxy's
+//   or the network's error page).
+// - `type` is the broad category (`invalid_request_error`, `api_error`, …).
+// - `message` is the server's message, or `Request failed (<status>)` when
+//   there was no error body.
+// - `param` names the request field at fault, when there is one; on
+//   `validation_failed`, `details.fields` lists every failing field.
+// - `requestId` is the request's x-request-id: quote it when reporting a
+//   problem.
 export class ApiError extends Error {
     status;
-    constructor(message, status) {
+    type;
+    code;
+    param;
+    docUrl;
+    requestId;
+    details;
+    constructor(message, status, body) {
         super(message);
-        this.status = status;
         this.name = "ApiError";
+        this.status = status;
+        this.type = body?.type;
+        this.code = body?.code;
+        this.param = body?.param;
+        this.docUrl = body?.doc_url;
+        this.requestId = body?.request_id ?? undefined;
+        this.details = body?.details;
     }
 }
-function buildErrorMessage(result) {
-    const body = result.error;
-    const raw = body && typeof body === "object" && "message" in body
-        ? body.message
+// Narrows an unknown caught value to an ApiError, optionally with a given
+// code, and narrows `details` to that code's shape:
+//
+//   catch (err) {
+//     if (isApiError(err, "validation_failed")) {
+//       for (const { param, message } of err.details.fields) showFieldError(param, message);
+//     }
+//   }
+export function isApiError(err, code) {
+    return err instanceof ApiError && (code === undefined || err.code === code);
+}
+// The envelope's `error` object, or undefined when the body isn't one.
+export function readErrorBody(body) {
+    if (!body || typeof body !== "object" || !("error" in body))
+        return undefined;
+    const error = body.error;
+    if (!error || typeof error !== "object")
+        return undefined;
+    const { code, message } = error;
+    return typeof code === "string" && typeof message === "string"
+        ? error
         : undefined;
-    return Array.isArray(raw)
-        ? raw.join(", ")
-        : typeof raw === "string" && raw
-            ? raw
-            : `Request failed (${result.response.status})`;
+}
+// Whether a 401 is one a token refresh could fix: the customer guard's
+// `invalid_access_token`. Any other 401 — a bad app key, wrong credentials —
+// would fail again after a refresh.
+export function isStaleTokenError(body) {
+    return readErrorBody(body)?.code === "invalid_access_token";
+}
+function toApiError(result) {
+    const body = readErrorBody(result.error);
+    return new ApiError(body?.message ?? `Request failed (${result.response.status})`, result.response.status, body);
 }
 // openapi-fetch resolves non-2xx as { error } rather than throwing. Resource
-// methods that mutate use this so callers can `try/catch` and show the API's
-// message instead of a generic string.
+// methods use this so callers can `try/catch` an ApiError.
+//
+// Success is `response.ok`, not "data is defined": an endpoint with no body
+// (204) legitimately resolves with `data: undefined` on success.
 export function unwrap(result) {
-    if (result.data !== undefined)
+    if (result.response.ok)
         return result.data;
-    throw new ApiError(buildErrorMessage(result), result.response.status);
+    throw toApiError(result);
 }
 // A few reads have exactly one well-understood "no data" outcome (a lookup
 // miss, or "not currently signed in") — anything else is a real failure and
 // should surface as ApiError just like a mutation, not collapse to the same
 // undefined a caller can't distinguish from the expected case.
+//
+// A bad app key is never the expected outcome, even on a read whose expected
+// status is 401: it's a misconfigured integration, and reading it as "not
+// signed in" would hide that.
 export function unwrapOrUndefinedOn(result, expectedStatus) {
-    if (result.data !== undefined)
+    if (result.response.ok)
         return result.data;
-    if (result.response.status === expectedStatus)
+    const misconfigured = readErrorBody(result.error)?.code === "invalid_app_key";
+    if (result.response.status === expectedStatus && !misconfigured)
         return undefined;
-    throw new ApiError(buildErrorMessage(result), result.response.status);
+    throw toApiError(result);
 }
 //# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAaA,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGtB;IAFX,YACE,OAAe,EACN,MAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,MAA+C;IACxE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC1B,MAAM,GAAG,GACP,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI;QACnD,CAAC,CAAE,IAA6B,CAAC,OAAO;QACxC,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QACvB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAChB,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;YAC9B,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,mBAAmB,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;AACrD,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,uCAAuC;AACvC,MAAM,UAAU,MAAM,CAAI,MAIzB;IACC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAClD,MAAM,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CACjC,MAAyD,EACzD,cAAsB;IAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { type Client } from "openapi-fetch";
 import type { paths, components } from "./types.gen.js";
-export { ApiError } from "./http.js";
+export { ApiError, isApiError, type ApiErrorCode, type ApiErrorDetails, type ApiErrorType, type ErrorBody, } from "./http.js";
 import { createProductsResource } from "./resources/products.js";
 import { createCategoriesResource } from "./resources/categories.js";
 import { createBrandsResource } from "./resources/brands.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,6 +1,6 @@
 import createClient, {} from "openapi-fetch";
-import { unwrap, unwrapOrUndefinedOn } from "./http.js";
-export { ApiError } from "./http.js";
+import { isStaleTokenError, unwrap, unwrapOrUndefinedOn, } from "./http.js";
+export { ApiError, isApiError, } from "./http.js";
 import { createProductsResource } from "./resources/products.js";
 import { createCategoriesResource } from "./resources/categories.js";
 import { createBrandsResource } from "./resources/brands.js";
@@ -73,7 +73,7 @@ export class StorefrontClient {
         this.customer = createCustomerResource(this.client, doRequest);
     }
     async signUp(signup) {
-        const result = await this.client.POST("/auth/signup", { body: signup });
+        const result = await this.client.POST("/v1/auth/signup", { body: signup });
         const tokens = unwrap(result);
         this.supersedeSession();
         this.accessToken = tokens.access_token;
@@ -84,7 +84,7 @@ export class StorefrontClient {
     // sends the current cart token (if any) so the backend can claim the
     // guest cart into the newly-signed-in customer's account
     async signIn(credentials) {
-        const result = await this.client.POST("/auth/signin", {
+        const result = await this.client.POST("/v1/auth/signin", {
             body: credentials,
             headers: this.cartToken ? { "x-cart-token": this.cartToken } : {},
         });
@@ -127,7 +127,7 @@ export class StorefrontClient {
             return undefined;
         }
         const generation = this.sessionGeneration;
-        const result = await this.client.POST("/auth/token/refresh", {
+        const result = await this.client.POST("/v1/auth/token/refresh", {
             body: { refresh_token: this.refreshToken },
         });
         // logged out or signed in as someone else while this was in flight —
@@ -156,7 +156,7 @@ export class StorefrontClient {
         this.emitTokensChanged();
         if (refreshToken) {
             try {
-                await this.client.POST("/auth/logout", {
+                await this.client.POST("/v1/auth/logout", {
                     body: { refresh_token: refreshToken },
                 });
             }
@@ -182,7 +182,9 @@ export class StorefrontClient {
     async do(request) {
         const accessTokenSent = this.accessToken;
         const result = await request();
-        if (result.response.status === 401) {
+        // only a stale access token is worth a refresh; a bad app key or any
+        // other 401 would just fail again
+        if (result.response.status === 401 && isStaleTokenError(result.error)) {
             // if another call already refreshed while this one was in flight, its
             // 401 is stale — retry with the new token rather than rotating again
             if (this.accessToken === accessTokenSent) {

package/dist/index.js.map

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

package/dist/resources/brands.d.ts

@@ -1,7 +1,7 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../types.gen.js";
 export declare function createBrandsResource(client: Client<paths>): {
-    list: (query?: paths["/brands"]["get"]["parameters"]["query"]) => Promise<{
+    list: (query?: paths["/v1/brands"]["get"]["parameters"]["query"]) => Promise<{
         items: {
             id: number;
             name: string;
@@ -11,7 +11,7 @@ export declare function createBrandsResource(client: Client<paths>): {
         limit: number;
         offset: number;
     }>;
-    getById: (id: number, query?: paths["/brands/{id}"]["get"]["parameters"]["query"]) => Promise<{
+    getById: (id: number, query?: paths["/v1/brands/{id}"]["get"]["parameters"]["query"]) => Promise<{
         id: number;
         name: string;
         products: {

package/dist/resources/brands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../src/resources/brands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;mBAI7C,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;kBAOjD,MAAM,UACH,KAAK,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAW/D"}
+{"version":3,"file":"brands.d.ts","sourceRoot":"","sources":["../../src/resources/brands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;mBAI7C,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;kBAOpD,MAAM,UACH,KAAK,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAWlE"}

package/dist/resources/brands.js

@@ -3,14 +3,14 @@ export function createBrandsResource(client) {
     return {
         // no legitimate "empty" case for a list — any non-2xx is a real failure
         list: async (query = {}) => {
-            const result = await client.GET("/brands", { params: { query } });
+            const result = await client.GET("/v1/brands", { params: { query } });
             return unwrap(result);
         },
         getById: async (id, query = {}) => {
             const path = {
                 id: String(id),
             };
-            const result = await client.GET("/brands/{id}", {
+            const result = await client.GET("/v1/brands/{id}", {
                 params: { path, query },
             });
             return unwrapOrUndefinedOn(result, 404);

package/dist/resources/brands.js.map

@@ -1 +1 @@
-{"version":3,"file":"brands.js","sourceRoot":"","sources":["../../src/resources/brands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAO;QACL,wEAAwE;QACxE,IAAI,EAAE,KAAK,EACT,QAAwD,EAAE,EAC1D,EAAE;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,KAAK,EACZ,EAAU,EACV,QAA6D,EAAE,EAC/D,EAAE;YACF,MAAM,IAAI,GAAuD;gBAC/D,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;aACf,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE;gBAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;aACxB,CAAC,CAAC;YACH,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"brands.js","sourceRoot":"","sources":["../../src/resources/brands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAO;QACL,wEAAwE;QACxE,IAAI,EAAE,KAAK,EACT,QAA2D,EAAE,EAC7D,EAAE;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,KAAK,EACZ,EAAU,EACV,QAAgE,EAAE,EAClE,EAAE;YACF,MAAM,IAAI,GAA0D;gBAClE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;aACf,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE;gBACjD,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;aACxB,CAAC,CAAC;YACH,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/cart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/resources/cart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKzD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;oBAoBb,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC;;eA4CktT,qBAAsB;;;;;;;;;;;;;;;;;;;;;;4BA7BxxT,MAAM,QACX,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;4BAYpB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevC"}
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/resources/cart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKzD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;oBAoBb,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC;;eA4Cs4S,qBAAsB;;;;;;;;;;;;;;;;;;;;;;4BA7B58S,MAAM,QACX,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;4BAYpB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevC"}

package/dist/resources/cart.js

@@ -18,7 +18,7 @@ export function createCartResource(client, getCartToken, setCartToken) {
     }
     return {
         addItem: async (body) => {
-            const result = await client.POST("/cart/items", {
+            const result = await client.POST("/v1/cart/items", {
                 body,
                 headers: cartHeaders(),
             });
@@ -26,12 +26,12 @@ export function createCartResource(client, getCartToken, setCartToken) {
         },
         // 404 = no cart yet for this token — the everyday first-visit case
         get: async () => {
-            const result = await client.GET("/cart", { headers: cartHeaders() });
+            const result = await client.GET("/v1/cart", { headers: cartHeaders() });
             return unwrapOrUndefinedOn(result, 404);
         },
         updateItem: async (variantId, body) => {
             const path = { variantId: String(variantId) };
-            const result = await client.PATCH("/cart/items/{variantId}", {
+            const result = await client.PATCH("/v1/cart/items/{variantId}", {
                 params: { path },
                 body,
                 headers: cartHeaders(),
@@ -40,14 +40,14 @@ export function createCartResource(client, getCartToken, setCartToken) {
         },
         removeItem: async (variantId) => {
             const path = { variantId: String(variantId) };
-            const result = await client.DELETE("/cart/items/{variantId}", {
+            const result = await client.DELETE("/v1/cart/items/{variantId}", {
                 params: { path },
                 headers: cartHeaders(),
             });
             return unwrap(result);
         },
         clear: async () => {
-            const result = await client.DELETE("/cart", { headers: cartHeaders() });
+            const result = await client.DELETE("/v1/cart", { headers: cartHeaders() });
             return unwrap(result);
         },
     };

package/dist/resources/cart.js.map

@@ -1 +1 @@
-{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/resources/cart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,YAAsC,EACtC,YAAqC;IAErC,0EAA0E;IAC1E,wEAAwE;IACxE,gEAAgE;IAChE,SAAS,WAAW;QAClB,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,yEAAyE;IACzE,2EAA2E;IAC3E,SAAS,YAAY,CAAC,IAAmC;QACvD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,IAA6C,EAAE,EAAE;YAC/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE;gBAC9C,IAAI;gBACJ,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,mEAAmE;QACnE,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACrE,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,UAAU,EAAE,KAAK,EACf,SAAiB,EACjB,IAAgD,EAChD,EAAE;YACF,MAAM,IAAI,GACR,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;gBAC3D,MAAM,EAAE,EAAE,IAAI,EAAE;gBAChB,IAAI;gBACJ,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;YACtC,MAAM,IAAI,GACR,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE;gBAC5D,MAAM,EAAE,EAAE,IAAI,EAAE;gBAChB,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/resources/cart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,YAAsC,EACtC,YAAqC;IAErC,0EAA0E;IAC1E,wEAAwE;IACxE,gEAAgE;IAChE,SAAS,WAAW;QAClB,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,yEAAyE;IACzE,2EAA2E;IAC3E,SAAS,YAAY,CAAC,IAAmC;QACvD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,IAA6C,EAAE,EAAE;YAC/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBACjD,IAAI;gBACJ,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,mEAAmE;QACnE,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACxE,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,UAAU,EAAE,KAAK,EACf,SAAiB,EACjB,IAAgD,EAChD,EAAE;YACF,MAAM,IAAI,GACR,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;gBAC9D,MAAM,EAAE,EAAE,IAAI,EAAE;gBAChB,IAAI;gBACJ,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;YACtC,MAAM,IAAI,GACR,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,4BAA4B,EAAE;gBAC/D,MAAM,EAAE,EAAE,IAAI,EAAE;gBAChB,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/categories.d.ts

@@ -1,7 +1,7 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../types.gen.js";
 export declare function createCategoriesResource(client: Client<paths>): {
-    list: (query?: paths["/categories"]["get"]["parameters"]["query"]) => Promise<{
+    list: (query?: paths["/v1/categories"]["get"]["parameters"]["query"]) => Promise<{
         items: {
             id: number;
             name: string;
@@ -11,7 +11,7 @@ export declare function createCategoriesResource(client: Client<paths>): {
         limit: number;
         offset: number;
     }>;
-    getById: (id: number, query?: paths["/categories/{id}"]["get"]["parameters"]["query"]) => Promise<{
+    getById: (id: number, query?: paths["/v1/categories/{id}"]["get"]["parameters"]["query"]) => Promise<{
         id: number;
         name: string;
         products: {

package/dist/resources/categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/resources/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;mBAIjD,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;kBAOrD,MAAM,UACH,KAAK,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAWnE"}
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/resources/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;mBAIjD,KAAK,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;kBAOxD,MAAM,UACH,KAAK,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAWtE"}

package/dist/resources/categories.js

@@ -3,14 +3,14 @@ export function createCategoriesResource(client) {
     return {
         // no legitimate "empty" case for a list — any non-2xx is a real failure
         list: async (query = {}) => {
-            const result = await client.GET("/categories", { params: { query } });
+            const result = await client.GET("/v1/categories", { params: { query } });
             return unwrap(result);
         },
         getById: async (id, query = {}) => {
             const path = {
                 id: String(id),
             };
-            const result = await client.GET("/categories/{id}", {
+            const result = await client.GET("/v1/categories/{id}", {
                 params: { path, query },
             });
             return unwrapOrUndefinedOn(result, 404);

package/dist/resources/categories.js.map

@@ -1 +1 @@
-{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/resources/categories.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC5D,OAAO;QACL,wEAAwE;QACxE,IAAI,EAAE,KAAK,EACT,QAA4D,EAAE,EAC9D,EAAE;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,KAAK,EACZ,EAAU,EACV,QAAiE,EAAE,EACnE,EAAE;YACF,MAAM,IAAI,GAA2D;gBACnE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;aACf,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE;gBAClD,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;aACxB,CAAC,CAAC;YACH,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/resources/categories.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC5D,OAAO;QACL,wEAAwE;QACxE,IAAI,EAAE,KAAK,EACT,QAA+D,EAAE,EACjE,EAAE;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACzE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,EAAE,KAAK,EACZ,EAAU,EACV,QAAoE,EAAE,EACtE,EAAE;YACF,MAAM,IAAI,GAA8D;gBACtE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;aACf,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE;gBACrD,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;aACxB,CAAC,CAAC;YACH,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/checkout.js

@@ -8,11 +8,11 @@ export function createCheckoutResource(client, getCartToken) {
     return {
         // no legitimate "empty" case — always returns a body (ready: boolean)
         getConfig: async () => {
-            const result = await client.GET("/checkout/config");
+            const result = await client.GET("/v1/checkout/config");
             return unwrap(result);
         },
         createSession: async (body) => {
-            const result = await client.POST("/checkout/session", {
+            const result = await client.POST("/v1/checkout/session", {
                 body,
                 headers: cartHeaders(),
             });
@@ -21,14 +21,14 @@ export function createCheckoutResource(client, getCartToken) {
         // 404 = no connected Stripe account, or an unknown/expired session id
         getSessionStatus: async (sessionId) => {
             const path = { sessionId };
-            const result = await client.GET("/checkout/session/{sessionId}", {
+            const result = await client.GET("/v1/checkout/session/{sessionId}", {
                 params: { path },
             });
             return unwrapOrUndefinedOn(result, 404);
         },
         // no legitimate "empty" case — a computed result, not a lookup
         getShippingOptions: async (body) => {
-            const result = await client.POST("/checkout/shipping-options", { body });
+            const result = await client.POST("/v1/checkout/shipping-options", { body });
             return unwrap(result);
         },
     };