@develemit/storefront 0.4.0 → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,91 @@
+## 0.7.0 (2026-11-04)
+
+### Features
+
+- `CheckoutSuccessView` gains `slots` (`header`, `beforeLines`, `afterTotals`, `actions`), `showReference`, `showSummaryHeading`, `continueHref` and `renderLink`, plus the labels `summaryHeading`, `reference` (`{id}` placeholder) and `continue`. All additive; the view still has no hooks.
+
+### Docs
+
+- The package now ships `CHANGELOG.md` and `docs/cart.md` (cart, checkout, success page and discount codes, moved out of the README), and declares `description`, `repository` and `homepage`.
+
+## 0.6.0 (2026-11-03)
+
+No changes; released in lockstep with the other packages.
+
+## 0.5.0 (2026-11-02)
+
+### Features
+
+- `CheckoutSuccessView({ order, locale?, labels?, className? })` renders the order summary for a checkout success page (lines, discount, shipping, total, ship-to address, tracking, per-status message), themed by `--sf-*` tokens with new `.sf-checkout-success*` styles. Exports `CheckoutSuccessLabels` and `defaultCheckoutSuccessLabels`.
+- `ClearCartOnMount` empties the cart once after hydration, safe under React strict mode.
+- `useCheckout({ startCheckout, onRedirect?, onDiscountInvalid?, labels? })` returns `{ checkout, busy, message, clearMessage }`: busy state, removal of out-of-stock lines, discount-reason messages and the gateway redirect. Exports `CheckoutLabels`, `defaultCheckoutLabels`, `StartCheckoutOptions`, `UseCheckoutOptions` and `UseCheckoutValue`.
+- `@develemit/storefront/client` exports `toCheckoutResult(error)` and the `CheckoutResult` / `CheckoutFailure` types, so a server action can turn `CheckoutConflictError` and `DiscountInvalidError` into a serializable result without importing React.
+- Exports `discountReasonMessage(reason, overrides?)`, the same reason text `CartSummary` shows for a rejected code, so hosts can show it when checkout rejects a code (`DiscountInvalidError`).
+
+## 0.4.0 (2026-10-30)
+
+### Features
+
+- `client.previewDiscount({ code, items })` and `createCheckout(items, { discountCode })`, with a new `DiscountInvalidError` (422, carries the rejection `reason`). Exports `CreateCheckoutOptions`.
+- `CartSummary` takes an optional `discount={{ onPreview, onApply, debounceMs }}` prop (also through `CartDrawer`'s `summary`): a collapsible "Have a code?" field, a discount row with Remove, reason messages, and a debounced re-preview that drops a code that stops applying. Labels live under `labels.discount`. Exports `CartSummaryDiscount` and `DiscountPreviewResult`. New `.sf-cart-summary__code*` styles. Needs a server with discounts.
+
+## 0.3.0 (2026-10-30)
+
+### Breaking
+
+- `client.listProducts(query)` returns a page, `{ items: ProductCard[], nextCursor }`, instead of an array, and accepts `limit` and `cursor`. `ProductGrid`, `ProductCard`, `ShopView` and `FeaturedProducts` take the slim `ProductCard` shape (a full `Product` is still assignable).
+
+### Features
+
+- The default `renderImage` now renders `<img loading="lazy" decoding="async">`, or `loading="eager"` with `fetchpriority="high"` when `priority` is set (non-breaking behavior change).
+
+- `ShopView` `nextHref` and `loadMoreLabel` render a server-rendered "Load more" link through `renderLink`; hosts build `nextHref` from `nextCursor`.
+- The "Load more" link now has default `--sf-*` token styling (`.sf-shop__more`, centered in a new `.sf-shop__pager` wrapper).
+- Exports the `ProductCardData` and `ProductCardPage` types (`ProductCardData` avoids clashing with the `ProductCard` component).
+
+### Fixes
+
+- Published tarballs no longer include declaration maps (`*.d.ts.map`), which pointed at `src/` files that were not shipped. JS sourcemaps now embed `sourcesContent`.
+- Built `dist` type resolution: the `client` and `format` entries now emit to `dist/<name>/index.js` beside their declarations, so `allowJs` consumers (Next) get real types instead of `any`. No API change; the `exports` subpaths are unchanged.
+
+## 0.2.0 (2026-10-29)
+
+First published release. 0.1.0 was tagged but never published to npm, so installing 0.2.0 gets everything in both entries below.
+
+### Features
+
+- `CartDrawer` `slots` (`empty`, `summaryNote`) for a custom empty-cart state and a note under the subtotal.
+- `CartButton` `icon`, `labelHidden` and `hideZeroCount` props.
+- `--sf-motion-duration` theme variable (default `0ms`) for drawer slide-in/out and backdrop fade; forced to `0ms` under `prefers-reduced-motion: reduce`. The drawer carries `data-state="open" | "closed"`.
+
+- Catalog presentation hooks: `--sf-card-hover-lift`, `--sf-card-hover-shadow`, `--sf-card-image-hover-scale`, `--sf-sold-opacity`, `--sf-sold-filter`, `--sf-grid-columns-mobile` and `--sf-color-focus` (all default to the current look).
+- `CategoryFilter` `formatLabel` and `sortCategories`; `ShopView` `allLabel`, `formatCategoryLabel` and `sortCategories`.
+- `ShopView`, `FeaturedProducts` and `ProductDetailView` forward `labels` to the availability badge.
+
+### Fixes
+
+- `AvailabilityBadge` is sized to its text (`inline-size: fit-content`) instead of stretching in grid/flex columns.
+- Gallery slide and thumb frames are `position: relative`, so `next/image` `fill` renders correctly; the gallery and thumbs show a `--sf-color-focus` focus ring.
+
+### Behavior changes
+
+- An empty cart no longer renders the summary or a disabled Checkout button.
+- Close is now an icon button (`×`) with `labels.close` as its accessible name, and Close and Remove have a 44×44px minimum target.
+
+## 0.1.0 (2026-10-29)
+
+First release. Brand-agnostic React UI, cart and typed API client. Peers: `react` and `react-dom` `^19`.
+
+### Features
+
+- Catalog components: `PriceTag`, `AvailabilityBadge`, `ProductCard`, `ProductGrid`, `CategoryFilter`, `ProductGallery`.
+- Page views: `ShopView`, `ProductDetailView`, `FeaturedProducts`, `sortForDisplay`.
+- Theme contract: `styles.css` ships the `--sf-*` custom properties; override them to brand the kit.
+- Cart: `CartProvider`, `useCart`, a reducer with localStorage persistence, `AddToCartButton`, `CartDrawer`, `CartLineItem`, `CartSummary` and `CartButton`.
+- `@develemit/storefront/client`: the typed API client (`createCommerceClient`, including `createCheckout` and `getOrderBySession`) and its error types.
+- Image priority: `ImageProps.priority` lets `renderImage` adapters mark above-the-fold images (e.g. `next/image` `priority`). `ProductCard` accepts `priority`, `ProductGrid` accepts `priorityCount` (prioritizes the first N cards; `ShopView` and `FeaturedProducts` use 6), and `ProductGallery` prioritizes the active main image but not the thumbnails.
+- `@develemit/storefront/format`: server-safe entry for `formatPrice` and `sortForDisplay`.
+
+### Notes
+
+- The main bundle is marked `"use client"`. Server components must import pure helpers from `@develemit/storefront/format`.

package/README.md

@@ -1,16 +1,23 @@
 # @develemit/storefront
 
-Brand-agnostic storefront UI and commerce logic, built so it can be extracted
-and published as a standalone package.
+Brand-agnostic storefront UI, cart, checkout and a typed API client for shops
+backed by `@develemit/commerce-server`. New here? Start with the
+[getting-started guide](https://github.com/develemit/develemit-commerce/blob/main/docs/getting-started.md).
+What changed in each version is in [CHANGELOG.md](CHANGELOG.md).
+
+```bash
+pnpm add @develemit/storefront @develemit/commerce-contracts react react-dom
+```
 
 ## Boundary rules
 
 - No client branding, copy, colors, or product data in this package.
   The consuming app supplies those through props, theme tokens, and data adapters.
 - No imports from `apps/*` or other app-specific packages.
-- React, React DOM, and Next are peer dependencies, never bundled.
+- React and React DOM are peer dependencies, never bundled. Next is optional:
+  it is wired in through the adapters below, never imported.
 
-## Commands
+## Developing this package
 
 - `pnpm exec nx build storefront` — library build to `packages/storefront/dist`
 - `pnpm exec nx test storefront`
@@ -49,7 +56,8 @@ the variables in the host app (or pass a `StorefrontTheme` through
 `PriceTag`, `AvailabilityBadge`, `ProductCard`, `ProductGrid`,
 `CategoryFilter`, and `ProductGallery` are styled only through the `--sf-*`
 variables. Wrap them in `StorefrontProvider` to supply framework adapters;
-without it they fall back to plain `<a>` and `<img>`.
+without it they fall back to plain `<a>` and `<img>`. `useStorefront()` reads
+the provider's config (locale, adapters, hrefs) in your own components.
 
 Example Next.js host setup (host code, not part of this package):
 
@@ -215,74 +223,11 @@ export default async function ProductPage({
 }
 ```
 
-## Cart
-
-Wrap the app in `CartProvider` (inside `StorefrontProvider`). State is a
-snapshot of `CartLine`s; prices and availability are re-verified server-side
-at checkout. Persistence goes through a `CartStorage` (`load`/`save`); the
-default is `localStorageCartStorage(key)`, which hydrates after mount and never
-touches `window` during render.
-
-```tsx
-<CartProvider>
-  <CartButton />
-  <CartDrawer summary={{ onCheckout, checkoutLabel: 'Checkout' }} />
-</CartProvider>
-
-<ProductDetailView
-  product={product}
-  slots={{ actions: <AddToCartButton product={product} /> }}
-/>
-```
-
-`useCart()` exposes `add` (returns `{ added, capped, reason? }`), `remove`,
-`setQuantity`, `clear`, `open`/`close`, and the derived `itemCount` and
-`subtotalCents`. A product's `quantity` is the line's `maxQuantity`, so
-one-of-a-kind items can only be added once. Every label is overridable
-through a `labels` prop.
-
-### Discount codes
-
-`CartSummary` (and `CartDrawer` through `summary`) takes an optional `discount`
-prop. The kit stays framework-agnostic, so the host performs the API call (a
-server action in Next):
-
-```tsx
-<CartDrawer
-  summary={{
-    onCheckout: checkout,
-    discount: {
-      onPreview: async (code, items) => {
-        // call client.previewDiscount; map DiscountInvalidError to a reason
-        return { ok: true, code, discountCents: 480 };
-        // or { ok: false, reason: 'exhausted' }
-      },
-      onApply: (code) => setDiscountCode(code), // null when removed or dropped
-    },
-  }}
-/>
-```
+## Cart and checkout
 
-It renders a collapsible "Have a code?" field, a "Discount (CODE) −$4.80" row
-with Remove, and a message for a rejected code. When the cart changes
-(debounced, `debounceMs`, default 300) the code is previewed again and dropped
-with its reason if it no longer applies. Pass the applied code to
-`createCheckout`. Override copy with `labels.discount` (`toggle`, `field`,
-`apply`, `remove`, `line`, `unavailable`, and `reasons` per rejection reason).
-
-### Polish hooks
-
-- `CartDrawer` `slots={{ empty, summaryNote }}`: `empty` replaces the
-  `labels.empty` text (for example with a link back to the shop); `summaryNote`
-  renders under the subtotal and Checkout button. An empty cart shows no
-  summary or Checkout button. Close and Remove are at least 44×44px.
-- `CartButton` `icon` (rendered before the label), `labelHidden` (visually
-  hides the label, keeping an accessible name like "Cart, 2 items") and
-  `hideZeroCount` (omits the count at 0; the accessible name becomes
-  "Cart, empty").
-- `--sf-motion-duration` (default `0ms`, no motion) drives the drawer's
-  slide-in and the backdrop's fade, in and out. It is forced to `0ms` under
-  `prefers-reduced-motion: reduce`. Example: `--sf-motion-duration: 200ms`.
+`CartProvider`, `CartButton`, `CartDrawer`, `AddToCartButton`, `useCart`,
+`useCheckout`, `CheckoutSuccessView`, `ClearCartOnMount` and discount codes are
+documented in [docs/cart.md](docs/cart.md).
 
 ### Catalog presentation hooks
 

package/dist/cart/clear-cart-on-mount.d.ts

@@ -0,0 +1 @@
+export declare function ClearCartOnMount(): null;

package/dist/cart/use-checkout.d.ts

@@ -0,0 +1,27 @@
+import { DiscountRejectionReason } from '@develemit/commerce-contracts';
+import { CheckoutResult } from '../client/checkout-result';
+export interface CheckoutLabels {
+    outOfStock: string;
+    unavailable: string;
+    discountReasons?: Partial<Record<DiscountRejectionReason, string>>;
+}
+export declare const defaultCheckoutLabels: CheckoutLabels;
+export interface StartCheckoutOptions {
+    discountCode?: string;
+}
+export interface UseCheckoutOptions {
+    startCheckout: (items: {
+        productId: string;
+        quantity: number;
+    }[], options: StartCheckoutOptions) => Promise<CheckoutResult>;
+    onRedirect?: (url: string) => void;
+    onDiscountInvalid?: (reason: DiscountRejectionReason) => void;
+    labels?: Partial<CheckoutLabels>;
+}
+export interface UseCheckoutValue {
+    checkout: (options?: StartCheckoutOptions) => Promise<void>;
+    busy: boolean;
+    message: string | null;
+    clearMessage: () => void;
+}
+export declare function useCheckout({ startCheckout, onRedirect, onDiscountInvalid, labels, }: UseCheckoutOptions): UseCheckoutValue;

package/dist/client/checkout-result.d.ts

@@ -0,0 +1,12 @@
+import { DiscountRejectionReason } from '@develemit/commerce-contracts';
+export type CheckoutFailure = {
+    error: 'out_of_stock';
+    productIds: string[];
+} | {
+    error: 'discount_invalid';
+    reason: DiscountRejectionReason;
+};
+export type CheckoutResult = {
+    url: string;
+} | CheckoutFailure;
+export declare function toCheckoutResult(error: unknown): CheckoutFailure;

package/dist/client/index.d.ts

@@ -1,2 +1,3 @@
 export * from './commerce-client';
 export * from './errors';
+export * from './checkout-result';

package/dist/client/index.js

@@ -80,6 +80,18 @@ function f({ baseUrl: f, fetch: p = (...e) => globalThis.fetch(...e) }) {
 		}
 	};
 }
-export { u as CheckoutConflictError, c as CommerceApiError, d as DiscountInvalidError, l as NotFoundError, f as createCommerceClient };
+// src/client/checkout-result.ts
+function p(e) {
+	if (e instanceof u) return {
+		error: "out_of_stock",
+		productIds: e.productIds
+	};
+	if (e instanceof d) return {
+		error: "discount_invalid",
+		reason: e.reason
+	};
+	throw e;
+}
+export { u as CheckoutConflictError, c as CommerceApiError, d as DiscountInvalidError, l as NotFoundError, f as createCommerceClient, p as toCheckoutResult };
 
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["CommerceApiError","message","status","url","NotFoundError","CheckoutConflictError","productIds","DiscountInvalidError","reason","createCommerceClient","fetchImpl","args","root","baseUrl","readJson","res","schema","get","path","postJson","body","throwIfDiscountInvalid","parsed","discountRejectionSchema","createCheckout","discountCode","checkoutConflictSchema","checkoutResponseSchema","previewDiscount","input","discountPreviewSchema","params","query","qs","productCardPageSchema","slug","productSchema","categorySchema","sessionId","orderSummarySchema"],"sources":["../../src/client/errors.ts","../../src/client/commerce-client.ts"],"sourcesContent":["import type { DiscountRejectionReason } from '@develemit/commerce-contracts';\n\nexport class CommerceApiError extends Error {\n  constructor(\n    readonly status: number,\n    readonly url: string,\n    message?: string,\n  ) {\n    super(message ?? `Commerce API request failed (${status}): ${url}`);\n    this.name = 'CommerceApiError';\n  }\n}\n\nexport class NotFoundError extends CommerceApiError {\n  constructor(url: string) {\n    super(404, url, `Not found: ${url}`);\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class CheckoutConflictError extends CommerceApiError {\n  constructor(\n    url: string,\n    readonly productIds: string[],\n  ) {\n    super(\n      409,\n      url,\n      `Some items are no longer available: ${productIds.join(', ')}`,\n    );\n    this.name = 'CheckoutConflictError';\n  }\n}\n\nexport class DiscountInvalidError extends CommerceApiError {\n  constructor(\n    url: string,\n    readonly reason: DiscountRejectionReason,\n  ) {\n    super(422, url, `Discount code rejected: ${reason}`);\n    this.name = 'DiscountInvalidError';\n  }\n}\n","import {\n  categorySchema,\n  checkoutConflictSchema,\n  checkoutResponseSchema,\n  discountPreviewSchema,\n  discountRejectionSchema,\n  orderSummarySchema,\n  productCardPageSchema,\n  productSchema,\n  type Category,\n  type CheckoutRequest,\n  type CheckoutResponse,\n  type DiscountPreview,\n  type OrderSummary,\n  type ProductCardPage,\n  type Product,\n  type ProductListQuery,\n} from '@develemit/commerce-contracts';\nimport {\n  CheckoutConflictError,\n  CommerceApiError,\n  DiscountInvalidError,\n  NotFoundError,\n} from './errors';\n\nexport interface CommerceClientOptions {\n  baseUrl: string;\n  fetch?: typeof fetch;\n}\n\nexport interface CommerceClient {\n  listProducts(query?: ProductListQuery): Promise<ProductCardPage>;\n  getProduct(slug: string): Promise<Product>;\n  listCategories(): Promise<Category[]>;\n  createCheckout(\n    items: CheckoutRequest['items'],\n    options?: CreateCheckoutOptions,\n  ): Promise<CheckoutResponse>;\n  previewDiscount(input: {\n    code: string;\n    items: CheckoutRequest['items'];\n  }): Promise<DiscountPreview>;\n  getOrderBySession(sessionId: string): Promise<OrderSummary>;\n}\n\nexport interface CreateCheckoutOptions {\n  discountCode?: string;\n}\n\ntype Schema<T> = { parse(data: unknown): T };\n\nexport function createCommerceClient({\n  baseUrl,\n  fetch: fetchImpl = (...args) => globalThis.fetch(...args),\n}: CommerceClientOptions): CommerceClient {\n  const root = baseUrl.replace(/\\/+$/, '');\n\n  async function readJson<T>(\n    url: string,\n    res: Response,\n    schema: Schema<T>,\n  ): Promise<T> {\n    if (res.status === 404) throw new NotFoundError(url);\n    if (!res.ok) throw new CommerceApiError(res.status, url);\n    return schema.parse(await res.json());\n  }\n\n  async function get<T>(path: string, schema: Schema<T>): Promise<T> {\n    const url = `${root}${path}`;\n    const res = await fetchImpl(url, {\n      headers: { accept: 'application/json' },\n    });\n    return readJson(url, res, schema);\n  }\n\n  function postJson(url: string, body: unknown): Promise<Response> {\n    return fetchImpl(url, {\n      method: 'POST',\n      headers: {\n        accept: 'application/json',\n        'content-type': 'application/json',\n      },\n      body: JSON.stringify(body),\n    });\n  }\n\n  async function throwIfDiscountInvalid(url: string, res: Response) {\n    if (res.status !== 422) return;\n    const parsed = discountRejectionSchema.safeParse(\n      await res.json().catch(() => null),\n    );\n    if (parsed.success) throw new DiscountInvalidError(url, parsed.data.reason);\n  }\n\n  async function createCheckout(\n    items: CheckoutRequest['items'],\n    { discountCode }: CreateCheckoutOptions = {},\n  ): Promise<CheckoutResponse> {\n    const url = `${root}/checkout`;\n    const res = await postJson(\n      url,\n      discountCode ? { items, discountCode } : { items },\n    );\n    if (res.status === 409) {\n      const conflict = checkoutConflictSchema.parse(await res.json());\n      throw new CheckoutConflictError(url, conflict.unavailableProductIds);\n    }\n    await throwIfDiscountInvalid(url, res);\n    return readJson(url, res, checkoutResponseSchema);\n  }\n\n  async function previewDiscount(input: {\n    code: string;\n    items: CheckoutRequest['items'];\n  }): Promise<DiscountPreview> {\n    const url = `${root}/checkout/discount/preview`;\n    const res = await postJson(url, input);\n    await throwIfDiscountInvalid(url, res);\n    return readJson(url, res, discountPreviewSchema);\n  }\n\n  return {\n    async listProducts(query = {}) {\n      const params = new URLSearchParams();\n      if (query.category) params.set('category', query.category);\n      if (query.featured !== undefined) {\n        params.set('featured', String(query.featured));\n      }\n      if (query.limit !== undefined) params.set('limit', String(query.limit));\n      if (query.cursor) params.set('cursor', query.cursor);\n      const qs = params.toString();\n      return get(\n        `/catalog/products${qs ? `?${qs}` : ''}`,\n        productCardPageSchema,\n      );\n    },\n    getProduct(slug) {\n      return get(\n        `/catalog/products/${encodeURIComponent(slug)}`,\n        productSchema,\n      );\n    },\n    listCategories() {\n      return get('/catalog/categories', categorySchema.array());\n    },\n    createCheckout,\n    previewDiscount,\n    getOrderBySession(sessionId) {\n      return get(\n        `/orders/session/${encodeURIComponent(sessionId)}`,\n        orderSummarySchema,\n      );\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["CommerceApiError","message","status","url","NotFoundError","CheckoutConflictError","productIds","DiscountInvalidError","reason","createCommerceClient","fetchImpl","args","root","baseUrl","readJson","res","schema","get","path","postJson","body","throwIfDiscountInvalid","parsed","discountRejectionSchema","createCheckout","discountCode","checkoutConflictSchema","checkoutResponseSchema","previewDiscount","input","discountPreviewSchema","params","query","qs","productCardPageSchema","slug","productSchema","categorySchema","sessionId","orderSummarySchema","toCheckoutResult","error"],"sources":["../../src/client/errors.ts","../../src/client/commerce-client.ts","../../src/client/checkout-result.ts"],"sourcesContent":["import type { DiscountRejectionReason } from '@develemit/commerce-contracts';\n\nexport class CommerceApiError extends Error {\n  constructor(\n    readonly status: number,\n    readonly url: string,\n    message?: string,\n  ) {\n    super(message ?? `Commerce API request failed (${status}): ${url}`);\n    this.name = 'CommerceApiError';\n  }\n}\n\nexport class NotFoundError extends CommerceApiError {\n  constructor(url: string) {\n    super(404, url, `Not found: ${url}`);\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class CheckoutConflictError extends CommerceApiError {\n  constructor(\n    url: string,\n    readonly productIds: string[],\n  ) {\n    super(\n      409,\n      url,\n      `Some items are no longer available: ${productIds.join(', ')}`,\n    );\n    this.name = 'CheckoutConflictError';\n  }\n}\n\nexport class DiscountInvalidError extends CommerceApiError {\n  constructor(\n    url: string,\n    readonly reason: DiscountRejectionReason,\n  ) {\n    super(422, url, `Discount code rejected: ${reason}`);\n    this.name = 'DiscountInvalidError';\n  }\n}\n","import {\n  categorySchema,\n  checkoutConflictSchema,\n  checkoutResponseSchema,\n  discountPreviewSchema,\n  discountRejectionSchema,\n  orderSummarySchema,\n  productCardPageSchema,\n  productSchema,\n  type Category,\n  type CheckoutRequest,\n  type CheckoutResponse,\n  type DiscountPreview,\n  type OrderSummary,\n  type ProductCardPage,\n  type Product,\n  type ProductListQuery,\n} from '@develemit/commerce-contracts';\nimport {\n  CheckoutConflictError,\n  CommerceApiError,\n  DiscountInvalidError,\n  NotFoundError,\n} from './errors';\n\nexport interface CommerceClientOptions {\n  baseUrl: string;\n  fetch?: typeof fetch;\n}\n\nexport interface CommerceClient {\n  listProducts(query?: ProductListQuery): Promise<ProductCardPage>;\n  getProduct(slug: string): Promise<Product>;\n  listCategories(): Promise<Category[]>;\n  createCheckout(\n    items: CheckoutRequest['items'],\n    options?: CreateCheckoutOptions,\n  ): Promise<CheckoutResponse>;\n  previewDiscount(input: {\n    code: string;\n    items: CheckoutRequest['items'];\n  }): Promise<DiscountPreview>;\n  getOrderBySession(sessionId: string): Promise<OrderSummary>;\n}\n\nexport interface CreateCheckoutOptions {\n  discountCode?: string;\n}\n\ntype Schema<T> = { parse(data: unknown): T };\n\nexport function createCommerceClient({\n  baseUrl,\n  fetch: fetchImpl = (...args) => globalThis.fetch(...args),\n}: CommerceClientOptions): CommerceClient {\n  const root = baseUrl.replace(/\\/+$/, '');\n\n  async function readJson<T>(\n    url: string,\n    res: Response,\n    schema: Schema<T>,\n  ): Promise<T> {\n    if (res.status === 404) throw new NotFoundError(url);\n    if (!res.ok) throw new CommerceApiError(res.status, url);\n    return schema.parse(await res.json());\n  }\n\n  async function get<T>(path: string, schema: Schema<T>): Promise<T> {\n    const url = `${root}${path}`;\n    const res = await fetchImpl(url, {\n      headers: { accept: 'application/json' },\n    });\n    return readJson(url, res, schema);\n  }\n\n  function postJson(url: string, body: unknown): Promise<Response> {\n    return fetchImpl(url, {\n      method: 'POST',\n      headers: {\n        accept: 'application/json',\n        'content-type': 'application/json',\n      },\n      body: JSON.stringify(body),\n    });\n  }\n\n  async function throwIfDiscountInvalid(url: string, res: Response) {\n    if (res.status !== 422) return;\n    const parsed = discountRejectionSchema.safeParse(\n      await res.json().catch(() => null),\n    );\n    if (parsed.success) throw new DiscountInvalidError(url, parsed.data.reason);\n  }\n\n  async function createCheckout(\n    items: CheckoutRequest['items'],\n    { discountCode }: CreateCheckoutOptions = {},\n  ): Promise<CheckoutResponse> {\n    const url = `${root}/checkout`;\n    const res = await postJson(\n      url,\n      discountCode ? { items, discountCode } : { items },\n    );\n    if (res.status === 409) {\n      const conflict = checkoutConflictSchema.parse(await res.json());\n      throw new CheckoutConflictError(url, conflict.unavailableProductIds);\n    }\n    await throwIfDiscountInvalid(url, res);\n    return readJson(url, res, checkoutResponseSchema);\n  }\n\n  async function previewDiscount(input: {\n    code: string;\n    items: CheckoutRequest['items'];\n  }): Promise<DiscountPreview> {\n    const url = `${root}/checkout/discount/preview`;\n    const res = await postJson(url, input);\n    await throwIfDiscountInvalid(url, res);\n    return readJson(url, res, discountPreviewSchema);\n  }\n\n  return {\n    async listProducts(query = {}) {\n      const params = new URLSearchParams();\n      if (query.category) params.set('category', query.category);\n      if (query.featured !== undefined) {\n        params.set('featured', String(query.featured));\n      }\n      if (query.limit !== undefined) params.set('limit', String(query.limit));\n      if (query.cursor) params.set('cursor', query.cursor);\n      const qs = params.toString();\n      return get(\n        `/catalog/products${qs ? `?${qs}` : ''}`,\n        productCardPageSchema,\n      );\n    },\n    getProduct(slug) {\n      return get(\n        `/catalog/products/${encodeURIComponent(slug)}`,\n        productSchema,\n      );\n    },\n    listCategories() {\n      return get('/catalog/categories', categorySchema.array());\n    },\n    createCheckout,\n    previewDiscount,\n    getOrderBySession(sessionId) {\n      return get(\n        `/orders/session/${encodeURIComponent(sessionId)}`,\n        orderSummarySchema,\n      );\n    },\n  };\n}\n","import type { DiscountRejectionReason } from '@develemit/commerce-contracts';\nimport { CheckoutConflictError, DiscountInvalidError } from './errors';\n\nexport type CheckoutFailure =\n  | { error: 'out_of_stock'; productIds: string[] }\n  | { error: 'discount_invalid'; reason: DiscountRejectionReason };\n\nexport type CheckoutResult = { url: string } | CheckoutFailure;\n\nexport function toCheckoutResult(error: unknown): CheckoutFailure {\n  if (error instanceof CheckoutConflictError) {\n    return { error: 'out_of_stock', productIds: error.productIds };\n  }\n  if (error instanceof DiscountInvalidError) {\n    return { error: 'discount_invalid', reason: error.reason };\n  }\n  throw error;\n}\n"],"mappings":"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"}

package/dist/components/cart-summary/cart-summary.d.ts

@@ -1,5 +1,6 @@
 import { CartSummaryDiscount, DiscountLabels } from './discount-types';
 export type { CartSummaryDiscount, DiscountPreviewResult, } from './discount-types';
+export { discountReasonMessage } from './discount-types';
 export interface CartSummaryLabels {
     subtotal: string;
     discount: Partial<Omit<DiscountLabels, 'reasons'>> & {

package/dist/components/cart-summary/discount-types.d.ts

@@ -25,3 +25,4 @@ export interface DiscountLabels {
     unavailable: string;
 }
 export declare const defaultDiscountLabels: DiscountLabels;
+export declare function discountReasonMessage(reason: DiscountRejectionReason, overrides?: Partial<DiscountLabels['reasons']>): string;

package/dist/components/checkout-success/checkout-success-view.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+import { OrderAddress, OrderSummary } from '@develemit/commerce-contracts';
+import { CheckoutSuccessLabels } from './labels';
+export interface CheckoutSuccessViewProps {
+    order: OrderSummary & {
+        shippingAddress?: OrderAddress | null;
+    };
+    locale?: string;
+    labels?: Partial<Omit<CheckoutSuccessLabels, 'status'>> & {
+        status?: Partial<CheckoutSuccessLabels['status']>;
+    };
+    className?: string;
+    slots?: {
+        header?: ReactNode;
+        beforeLines?: ReactNode;
+        afterTotals?: ReactNode;
+        actions?: ReactNode;
+    };
+    showReference?: boolean;
+    showSummaryHeading?: boolean;
+    continueHref?: string;
+    renderLink?: (props: {
+        href: string;
+        children: ReactNode;
+        className?: string;
+    }) => ReactNode;
+}
+export declare function CheckoutSuccessView({ order, locale, labels, className, slots, showReference, showSummaryHeading, continueHref, renderLink, }: CheckoutSuccessViewProps): import('react').JSX.Element;

package/dist/components/checkout-success/labels.d.ts

@@ -0,0 +1,15 @@
+import { OrderStatus } from '@develemit/commerce-contracts';
+export interface CheckoutSuccessLabels {
+    heading: string;
+    summaryHeading: string;
+    reference: string;
+    continue: string;
+    subtotal: string;
+    discount: string;
+    shipping: string;
+    total: string;
+    shipTo: string;
+    tracking: string;
+    status: Record<OrderStatus, string>;
+}
+export declare const defaultCheckoutSuccessLabels: CheckoutSuccessLabels;

package/dist/index.d.ts

@@ -15,8 +15,12 @@ export * from './views/sort-for-display';
 export * from './cart/cart-reducer';
 export * from './cart/cart-storage';
 export * from './cart/cart-provider';
+export * from './cart/use-checkout';
 export * from './components/add-to-cart-button/add-to-cart-button';
 export * from './components/cart-drawer/cart-drawer';
 export * from './components/cart-line-item/cart-line-item';
 export * from './components/cart-summary/cart-summary';
 export * from './components/cart-button/cart-button';
+export * from './components/checkout-success/checkout-success-view';
+export * from './components/checkout-success/labels';
+export * from './cart/clear-cart-on-mount';