@ordersail/storefront-sdk 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# @ordersail/storefront-sdk
+
+A typed TypeScript client for OrderSail's public `storefront-api`. This is
+the thing a merchant (or their developer) uses to build and host their
+**own** storefront against OrderSail's catalog, cart, checkout, and customer
+account data — `storefront-web` is just the worked reference example of
+doing that.
+
+Generated types come straight from `storefront-api`'s OpenAPI spec
+(`src/types.gen.ts`); everything else is a thin, hand-written wrapper for
+ergonomics around [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/).
+
+## Install
+
+```bash
+npm install @ordersail/storefront-sdk
+```
+
+Inside this monorepo it's consumed via the npm workspace protocol instead
+(see `apps/storefront-web/package.json`).
+
+## Quickstart
+
+```ts
+import { StorefrontClient, ApiError } from "@ordersail/storefront-sdk";
+
+const storefrontApi = new StorefrontClient(
+  "https://api.your-storefront-api-host.com",
+  "sfk_...", // your account's app key — see "Auth model" below
+);
+
+// reads return the data directly, or undefined if not found
+const products = await storefrontApi.products.list({ limit: 20 });
+
+// mutations throw a typed ApiError on failure
+try {
+  await storefrontApi.cart.addItem({ variantId: 123, quantity: 1 });
+} catch (error) {
+  if (error instanceof ApiError) {
+    console.error(`${error.status}: ${error.message}`);
+  }
+}
+```
+
+## Resources
+
+| Resource                      | Method                                  | Throws `ApiError`? |
+| ------------------------------ | ---------------------------------------- | ------------------- |
+| `storefrontApi.products`      | `list(query?)`                          | no                   |
+|                                | `getById(id)`                           | no                   |
+| `storefrontApi.cart`          | `get()`                                  | no                   |
+|                                | `addItem(body)`                         | **yes**              |
+|                                | `updateItem(variantId, body)`           | **yes**              |
+|                                | `removeItem(variantId)`                 | **yes**              |
+|                                | `clear()`                                | **yes**              |
+| `storefrontApi.checkout`      | `getConfig()`                            | no                   |
+|                                | `createSession(body)`                    | **yes**              |
+|                                | `getSessionStatus(sessionId)`            | no                   |
+|                                | `getShippingOptions(body)`               | no                   |
+| `storefrontApi.customer`      | `get()`                                  | no                   |
+|                                | `update(params)`                         | **yes**              |
+| `storefrontApi` (top level)   | `signUp(dto)`                            | **yes**              |
+|                                | `signIn(credentials)`                    | **yes**              |
+|                                | `refreshAccessToken()`                   | no                   |
+|                                | `logout()`                               | no                   |
+
+The convention throughout: a read returns the response body directly (or
+`undefined` on a non-2xx response), while a mutation throws `ApiError` so a
+failure can't be silently ignored.
+
+Not yet supported: **order history** for customers (`storefront-api` has no
+customer-facing order endpoints yet — see Storefront Builder M5) and
+**webhooks/real-time events** (no plans yet).
+
+## Error handling
+
+Every mutation throws `ApiError` (from `@ordersail/storefront-sdk`) on a
+non-2xx response:
+
+```ts
+export class ApiError extends Error {
+  readonly status: number; // the HTTP status code
+  readonly message: string; // the server's message, when it sends one
+}
+```
+
+`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 (see
+`apps/storefront-web/src/routes/signin.tsx` for the pattern).
+
+## Auth model
+
+Two independent layers, both handled for you by `StorefrontClient`:
+
+- **Tenant scoping** — every request carries an `x-app-key` header (your
+  account's app key, created in `merchant-web` under Settings → Developer
+  API keys). Set once in the constructor; re-assign `client.appKey` later if
+  you ever need to switch accounts.
+- **Customer auth** — a bearer JWT (`accessToken`), held in memory only (it
+  doesn't survive a page reload), plus an httpOnly `customer_refresh_token`
+  cookie the browser sends automatically (`credentials: "include"`). Call
+  `refreshAccessToken()` on app start to restore a session from that cookie.
+
+**Known gap**: only `customer.get()`/`customer.update()` currently retry
+once on a `401` by calling `refreshAccessToken()` and re-issuing the
+request. `cart` and `checkout` methods do not — if you're calling them a
+long time after the last customer request, a stale in-memory token can
+produce an unhandled `401`. Call `refreshAccessToken()` proactively if this
+matters for your integration, or treat it as a signed-out state and prompt
+sign-in again.
+
+## Regenerating after an API change
+
+```bash
+npm run generate:openapi -w storefront-api   # refresh storefront-api's openapi.json
+npm run generate -w @ordersail/storefront-sdk  # regenerate types.gen.ts from it
+```
+
+Both steps are manual and their output is committed — there's no watch mode
+or CI auto-regen.

package/dist/http.d.ts

@@ -0,0 +1,20 @@
+export type DoRequest<T> = () => Promise<{
+    data?: T;
+    error?: unknown;
+    response: Response;
+}>;
+export type DoFn = <T>(request: DoRequest<T>) => Promise<{
+    data?: T;
+    error?: unknown;
+    response: Response;
+}>;
+export declare class ApiError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare function unwrap<T>(result: {
+    data?: T;
+    error?: unknown;
+    response: Response;
+}): T;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +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;AAKD,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,CAaJ"}

package/dist/http.js

@@ -0,0 +1,28 @@
+// 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.
+export class ApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "ApiError";
+    }
+}
+// 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.
+export function unwrap(result) {
+    if (result.data !== undefined)
+        return result.data;
+    const body = result.error;
+    const raw = body && typeof body === "object" && "message" in body
+        ? body.message
+        : undefined;
+    const message = Array.isArray(raw)
+        ? raw.join(", ")
+        : typeof raw === "string" && raw
+            ? raw
+            : `Request failed (${result.response.status})`;
+    throw new ApiError(message, result.response.status);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +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,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,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,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAChC,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;IACnD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { type Client } from "openapi-fetch";
+import type { paths, components } from "./types.gen.js";
+export { ApiError } from "./http.js";
+import { createProductsResource } from "./resources/products.js";
+import { createCartResource } from "./resources/cart.js";
+import { createCheckoutResource } from "./resources/checkout.js";
+import { createCustomerResource } from "./resources/customer.js";
+export type ProductListItem = components["schemas"]["ProductListItem"];
+export type PaginatedProducts = components["schemas"]["PaginatedProducts"];
+export type ProductDetail = components["schemas"]["ProductDetail"];
+export type ProductDetailOption = components["schemas"]["ProductDetailOption"];
+export type ProductDetailVariant = components["schemas"]["ProductDetailVariant"];
+export type Cart = components["schemas"]["Cart"];
+export type CartItem = components["schemas"]["CartItem"];
+export type CheckoutSession = components["schemas"]["CheckoutSession"];
+export type CheckoutConfig = components["schemas"]["CheckoutConfig"];
+export type CheckoutSessionStatus = components["schemas"]["CheckoutSessionStatus"];
+export type Customer = components["schemas"]["Customer"];
+export type CustomerSignUpDto = components["schemas"]["CustomerSignUpDto"];
+export type CustomerSignInDto = components["schemas"]["CustomerSignInDto"];
+export type UpdateCustomerDto = components["schemas"]["UpdateCustomerDto"];
+export declare class StorefrontClient {
+    appKey: string;
+    cartToken: string | undefined;
+    accessToken: string | undefined;
+    client: Client<paths>;
+    products: ReturnType<typeof createProductsResource>;
+    cart: ReturnType<typeof createCartResource>;
+    checkout: ReturnType<typeof createCheckoutResource>;
+    customer: ReturnType<typeof createCustomerResource>;
+    private authMiddleware;
+    constructor(baseUrl: string, appKey: string, cartToken?: string);
+    signUp(signup: CustomerSignUpDto): Promise<string>;
+    signIn(credentials: CustomerSignInDto): Promise<string>;
+    refreshAccessToken(): Promise<string | undefined>;
+    logout(): Promise<void>;
+    private do;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAE,KAAK,MAAM,EAAmB,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,CAAC;AACjF,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,CAAC;AACnF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAI3E,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAG9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtB,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACpD,IAAI,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC5C,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACpD,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAKpD,OAAO,CAAC,cAAc,CAKpB;gBAEU,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IA6BzD,MAAM,CAAC,MAAM,EAAE,iBAAiB;IAQhC,MAAM,CAAC,WAAW,EAAE,iBAAiB;IASrC,kBAAkB;IAQlB,MAAM;YAME,EAAE;CAUjB"}

package/dist/index.js

@@ -0,0 +1,89 @@
+import createClient, {} from "openapi-fetch";
+import { unwrap } from "./http.js";
+export { ApiError } from "./http.js";
+import { createProductsResource } from "./resources/products.js";
+import { createCartResource } from "./resources/cart.js";
+import { createCheckoutResource } from "./resources/checkout.js";
+import { createCustomerResource } from "./resources/customer.js";
+const APP_KEY_HEADER = "x-app-key";
+export class StorefrontClient {
+    appKey;
+    // set automatically the first time cart.addItem() creates a cart — or
+    // pass one in up front (e.g. restored from localStorage) to resume a cart
+    cartToken;
+    // in-memory only, like merchant-sdk — a page refresh re-derives it from the
+    // httpOnly customer_refresh_token cookie via refreshAccessToken()
+    accessToken;
+    client;
+    products;
+    cart;
+    checkout;
+    customer;
+    // every authenticated request needs the bearer token and the cross-origin
+    // cookie (for customer_refresh_token) — centralized here instead of at
+    // each call site, same pattern as merchant-sdk's AdminClient
+    authMiddleware = {
+        onRequest: ({ request }) => {
+            request.headers.set("Authorization", `Bearer ${this.accessToken}`);
+            return new Request(request, { credentials: "include" });
+        },
+    };
+    constructor(baseUrl, appKey, cartToken) {
+        this.appKey = appKey;
+        this.cartToken = cartToken;
+        this.client = createClient({ baseUrl });
+        // the app key identifies the tenant on every request — read off `this`
+        // rather than captured at construction, so reassigning `appKey` later
+        // (e.g. switching storefronts) takes effect immediately
+        this.client.use({
+            onRequest: ({ request }) => {
+                request.headers.set(APP_KEY_HEADER, this.appKey);
+                return request;
+            },
+        });
+        this.client.use(this.authMiddleware);
+        const doRequest = (request) => this.do(request);
+        this.products = createProductsResource(this.client);
+        this.cart = createCartResource(this.client, () => this.cartToken, (token) => {
+            this.cartToken = token;
+        });
+        this.checkout = createCheckoutResource(this.client, () => this.cartToken);
+        this.customer = createCustomerResource(this.client, doRequest);
+    }
+    async signUp(signup) {
+        const result = await this.client.POST("/auth/signup", { body: signup });
+        this.accessToken = unwrap(result).access_token;
+        return this.accessToken;
+    }
+    // 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", {
+            body: credentials,
+            headers: this.cartToken ? { "x-cart-token": this.cartToken } : {},
+        });
+        this.accessToken = unwrap(result).access_token;
+        return this.accessToken;
+    }
+    async refreshAccessToken() {
+        const { data } = await this.client.GET("/auth/token/refresh");
+        this.accessToken = data?.access_token;
+        return this.accessToken;
+    }
+    // clears the httpOnly customer_refresh_token cookie server-side — the
+    // client can't delete it itself — then drops the in-memory access token
+    async logout() {
+        await this.client.POST("/auth/logout");
+        this.accessToken = undefined;
+    }
+    // request is a thunk so the retry rebuilds headers off the refreshed accessToken, not a stale one
+    async do(request) {
+        const result = await request();
+        if (result.response.status === 401) {
+            await this.refreshAccessToken();
+            return await request();
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resources/cart.d.ts

@@ -0,0 +1,83 @@
+import type { Client } from "openapi-fetch";
+import type { components, paths } from "../types.gen.js";
+export declare function createCartResource(client: Client<paths>, getCartToken: () => string | undefined, setCartToken: (token: string) => void): {
+    addItem: (body: components["schemas"]["AddCartItemDto"]) => Promise<{
+        token: string;
+        items: components["schemas"]["CartItem"][];
+        subtotalCents: number;
+        itemCount: number;
+    }>;
+    get: () => Promise<{
+        token: string;
+        items: {
+            variantId: number;
+            productId: number;
+            productName: string;
+            sku: string | null;
+            priceCents: number;
+            quantity: number;
+            stock: number;
+            optionValues: {
+                optionName: string;
+                value: string;
+            }[];
+        }[];
+        subtotalCents: number;
+        itemCount: number;
+    } | undefined>;
+    updateItem: (variantId: number, body: components["schemas"]["UpdateCartItemDto"]) => Promise<{
+        token: string;
+        items: {
+            variantId: number;
+            productId: number;
+            productName: string;
+            sku: string | null;
+            priceCents: number;
+            quantity: number;
+            stock: number;
+            optionValues: {
+                optionName: string;
+                value: string;
+            }[];
+        }[];
+        subtotalCents: number;
+        itemCount: number;
+    }>;
+    removeItem: (variantId: number) => Promise<{
+        token: string;
+        items: {
+            variantId: number;
+            productId: number;
+            productName: string;
+            sku: string | null;
+            priceCents: number;
+            quantity: number;
+            stock: number;
+            optionValues: {
+                optionName: string;
+                value: string;
+            }[];
+        }[];
+        subtotalCents: number;
+        itemCount: number;
+    }>;
+    clear: () => Promise<{
+        token: string;
+        items: {
+            variantId: number;
+            productId: number;
+            productName: string;
+            sku: string | null;
+            priceCents: number;
+            quantity: number;
+            stock: number;
+            optionValues: {
+                optionName: string;
+                value: string;
+            }[];
+        }[];
+        subtotalCents: number;
+        itemCount: number;
+    }>;
+};
+//# sourceMappingURL=cart.d.ts.map

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

@@ -0,0 +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;;eA2CmrN,qBAAsB;;;;;;;;;;;;;;;;;;;;;;4BA7BzvN,MAAM,QACX,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;4BAYpB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevC"}

package/dist/resources/cart.js

@@ -0,0 +1,54 @@
+import { unwrap } from "../http.js";
+const CART_TOKEN_HEADER = "x-cart-token";
+export function createCartResource(client, getCartToken, setCartToken) {
+    // x-cart-token isn't a documented OpenAPI header parameter (it's read via
+    // a plain decorator server-side, not @ApiHeader), so it's sent as a raw
+    // fetch header rather than through the typed params.header slot
+    function cartHeaders() {
+        const token = getCartToken();
+        return token ? { [CART_TOKEN_HEADER]: token } : {};
+    }
+    // addItem may create a cart server-side and hand back a new token — this
+    // captures it so the caller doesn't have to wire that up by hand. addItem
+    // always calls this with unwrap()'s result, which is defined or throws —
+    // never undefined — so this stays non-optional rather than re-widening it.
+    function captureToken(cart) {
+        setCartToken(cart.token);
+        return cart;
+    }
+    return {
+        addItem: async (body) => {
+            const result = await client.POST("/cart/items", {
+                body,
+                headers: cartHeaders(),
+            });
+            return captureToken(unwrap(result));
+        },
+        get: async () => {
+            const { data } = await client.GET("/cart", { headers: cartHeaders() });
+            return data;
+        },
+        updateItem: async (variantId, body) => {
+            const path = { variantId: String(variantId) };
+            const result = await client.PATCH("/cart/items/{variantId}", {
+                params: { path },
+                body,
+                headers: cartHeaders(),
+            });
+            return unwrap(result);
+        },
+        removeItem: async (variantId) => {
+            const path = { variantId: String(variantId) };
+            const result = await client.DELETE("/cart/items/{variantId}", {
+                params: { path },
+                headers: cartHeaders(),
+            });
+            return unwrap(result);
+        },
+        clear: async () => {
+            const result = await client.DELETE("/cart", { headers: cartHeaders() });
+            return unwrap(result);
+        },
+    };
+}
+//# sourceMappingURL=cart.js.map

package/dist/resources/cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/resources/cart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,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,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,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"}

package/dist/resources/checkout.d.ts

@@ -0,0 +1,21 @@
+import type { Client } from "openapi-fetch";
+import type { components, paths } from "../types.gen.js";
+export declare function createCheckoutResource(client: Client<paths>, getCartToken: () => string | undefined): {
+    getConfig: () => Promise<{
+        ready: boolean;
+        stripeAccountId: string | null;
+    } | undefined>;
+    createSession: (body: components["schemas"]["CreateCheckoutSessionDto"]) => Promise<{
+        clientSecret: string;
+    }>;
+    getSessionStatus: (sessionId: string) => Promise<{
+        status: string;
+        paymentStatus: string;
+        customerEmail: string | null;
+    } | undefined>;
+    getShippingOptions: (body: components["schemas"]["GetShippingOptionsDto"]) => Promise<{
+        ok: boolean;
+        errorMessage?: string;
+    } | undefined>;
+};
+//# sourceMappingURL=checkout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/resources/checkout.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,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS;;;;;0BAaR,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC;;;kCAQzC,MAAM;;;;;+BAUlC,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC;;;;EAMzD"}

package/dist/resources/checkout.js

@@ -0,0 +1,33 @@
+import { unwrap } from "../http.js";
+const CART_TOKEN_HEADER = "x-cart-token";
+export function createCheckoutResource(client, getCartToken) {
+    function cartHeaders() {
+        const token = getCartToken();
+        return token ? { [CART_TOKEN_HEADER]: token } : {};
+    }
+    return {
+        getConfig: async () => {
+            const { data } = await client.GET("/checkout/config");
+            return data;
+        },
+        createSession: async (body) => {
+            const result = await client.POST("/checkout/session", {
+                body,
+                headers: cartHeaders(),
+            });
+            return unwrap(result);
+        },
+        getSessionStatus: async (sessionId) => {
+            const path = { sessionId };
+            const { data } = await client.GET("/checkout/session/{sessionId}", {
+                params: { path },
+            });
+            return data;
+        },
+        getShippingOptions: async (body) => {
+            const { data } = await client.POST("/checkout/shipping-options", { body });
+            return data;
+        },
+    };
+}
+//# sourceMappingURL=checkout.js.map

package/dist/resources/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../src/resources/checkout.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CACpC,MAAqB,EACrB,YAAsC;IAEtC,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,OAAO;QACL,SAAS,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,aAAa,EAAE,KAAK,EAAE,IAAuD,EAAE,EAAE;YAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBACpD,IAAI;gBACJ,OAAO,EAAE,WAAW,EAAE;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,gBAAgB,EAAE,KAAK,EAAE,SAAiB,EAAE,EAAE;YAC5C,MAAM,IAAI,GACR,EAAE,SAAS,EAAE,CAAC;YAChB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE;gBACjE,MAAM,EAAE,EAAE,IAAI,EAAE;aACjB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB,EAAE,KAAK,EACvB,IAAoD,EACpD,EAAE;YACF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/customer.d.ts

@@ -0,0 +1,24 @@
+import type { Client } from "openapi-fetch";
+import type { components, paths } from "../types.gen.js";
+import { type DoFn } from "../http.js";
+export declare function createCustomerResource(client: Client<paths>, doRequest: DoFn): {
+    get: () => Promise<{
+        id: number;
+        accountId: number;
+        firstName: string;
+        lastName: string;
+        email: string;
+        createdAt: string;
+        updatedAt: string;
+    } | undefined>;
+    update: (params: components["schemas"]["UpdateCustomerDto"]) => Promise<{
+        id: number;
+        accountId: number;
+        firstName: string;
+        lastName: string;
+        email: string;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+};
+//# sourceMappingURL=customer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../src/resources/customer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI;;;;;;;;;;qBAOlD,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;EAOpE"}

package/dist/resources/customer.js

@@ -0,0 +1,14 @@
+import { unwrap } from "../http.js";
+export function createCustomerResource(client, doRequest) {
+    return {
+        get: async () => {
+            const { data } = await doRequest(() => client.GET("/customer"));
+            return data;
+        },
+        update: async (params) => {
+            const result = await doRequest(() => client.PATCH("/customer", { body: params }));
+            return unwrap(result);
+        },
+    };
+}
+//# sourceMappingURL=customer.js.map

package/dist/resources/customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../src/resources/customer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAa,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,SAAe;IAC3E,OAAO;QACL,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,MAAkD,EAAE,EAAE;YACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAClC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC5C,CAAC;YACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/products.d.ts

@@ -0,0 +1,67 @@
+import type { Client } from "openapi-fetch";
+import type { paths } from "../types.gen.js";
+export declare function createProductsResource(client: Client<paths>): {
+    list: (query?: paths["/products"]["get"]["parameters"]["query"]) => Promise<{
+        items: {
+            id: number;
+            name: string;
+            description: string | null;
+            brand: {
+                id: number;
+                name: string;
+            } | null;
+            categories: {
+                id: number;
+                name: string;
+            }[];
+            minPriceCents: number | null;
+            maxPriceCents: number | null;
+            thumbnailUrl: string | null;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    } | undefined>;
+    getById: (id: number) => Promise<{
+        id: number;
+        name: string;
+        description: string | null;
+        brand: {
+            id: number;
+            name: string;
+        } | null;
+        categories: {
+            id: number;
+            name: string;
+        }[];
+        options: {
+            id: number;
+            name: string;
+            values: {
+                id: number;
+                value: string;
+            }[];
+        }[];
+        variants: {
+            id: number;
+            sku: string | null;
+            priceCents: number;
+            stock: number;
+            optionValues: {
+                optionName: string;
+                value: string;
+            }[];
+            images: {
+                id: number;
+                url: string;
+                position: number;
+            }[];
+        }[];
+        images: {
+            id: number;
+            url: string;
+            position: number;
+        }[];
+    } | undefined>;
+};
+//# sourceMappingURL=products.d.ts.map