@develemit/storefront 0.3.0 → 0.6.0

package/README.md

@@ -131,6 +131,12 @@ sold or held by another buyer; its `productIds` lists them so the cart can drop
 them. Send only ids and quantities: the server prices every line itself.
 Redirect the shopper to the returned `url`.
 
+Discount codes: `client.previewDiscount({ code, items })` returns
+`{ code, discountCents, subtotalCents, currency }` or throws
+`DiscountInvalidError` with a `reason` (`not_found`, `not_started`, `expired`,
+`min_subtotal`, `exhausted`, `currency`). `createCheckout(items, { discountCode })`
+sends the code and throws the same error if it was rejected at checkout.
+
 ## Images in production
 
 The default image adapter is a plain `<img loading="lazy" decoding="async">`
@@ -235,6 +241,58 @@ touches `window` during render.
 one-of-a-kind items can only be added once. Every label is overridable
 through a `labels` prop.
 
+### Checkout
+
+`useCheckout({ startCheckout, onRedirect?, onDiscountInvalid?, labels? })`
+wraps the host's checkout call (a server action or a fetch) and returns
+`{ checkout, busy, message, clearMessage }`. `startCheckout(items, { discountCode })`
+resolves to a `CheckoutResult`: `{ url }`, `{ error: 'out_of_stock', productIds }`
+or `{ error: 'discount_invalid', reason }`. On the server, `toCheckoutResult(error)`
+from `@develemit/storefront/client` maps `CheckoutConflictError` and
+`DiscountInvalidError` to those results (other errors are rethrown). The hook
+removes out-of-stock lines, sets `message`, and redirects with
+`window.location.assign` unless `onRedirect` is given. Copy is overridable
+through `labels` (`outOfStock`, `unavailable`, `discountReasons`).
+
+### Success page
+
+`<CheckoutSuccessView order={order} locale? labels? />` renders an order from
+`getOrderBySession`: lines, subtotal, discount row (only when applied),
+shipping, total, ship-to address (when the order includes `shippingAddress`),
+tracking, and a message per `OrderStatus` (`pending` tells the buyer to expect
+an email). It has no hooks, so a server component can render it. Labels live in
+`labels` (including `labels.status`). `<ClearCartOnMount />` empties the cart
+once, even under React strict mode. Styles are `.sf-checkout-success*`.
+
+### 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
+    },
+  }}
+/>
+```
+
+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

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/commerce-client.d.ts

@@ -1,4 +1,4 @@
-import { Category, CheckoutRequest, CheckoutResponse, OrderSummary, ProductCardPage, Product, ProductListQuery } from '@develemit/commerce-contracts';
+import { Category, CheckoutRequest, CheckoutResponse, DiscountPreview, OrderSummary, ProductCardPage, Product, ProductListQuery } from '@develemit/commerce-contracts';
 export interface CommerceClientOptions {
     baseUrl: string;
     fetch?: typeof fetch;
@@ -7,7 +7,14 @@ export interface CommerceClient {
     listProducts(query?: ProductListQuery): Promise<ProductCardPage>;
     getProduct(slug: string): Promise<Product>;
     listCategories(): Promise<Category[]>;
-    createCheckout(items: CheckoutRequest['items']): Promise<CheckoutResponse>;
+    createCheckout(items: CheckoutRequest['items'], options?: CreateCheckoutOptions): Promise<CheckoutResponse>;
+    previewDiscount(input: {
+        code: string;
+        items: CheckoutRequest['items'];
+    }): Promise<DiscountPreview>;
     getOrderBySession(sessionId: string): Promise<OrderSummary>;
 }
+export interface CreateCheckoutOptions {
+    discountCode?: string;
+}
 export declare function createCommerceClient({ baseUrl, fetch: fetchImpl, }: CommerceClientOptions): CommerceClient;

package/dist/client/errors.d.ts

@@ -1,3 +1,4 @@
+import { DiscountRejectionReason } from '@develemit/commerce-contracts';
 export declare class CommerceApiError extends Error {
     readonly status: number;
     readonly url: string;
@@ -10,3 +11,7 @@ export declare class CheckoutConflictError extends CommerceApiError {
     readonly productIds: string[];
     constructor(url: string, productIds: string[]);
 }
+export declare class DiscountInvalidError extends CommerceApiError {
+    readonly reason: DiscountRejectionReason;
+    constructor(url: string, reason: DiscountRejectionReason);
+}

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

@@ -1,64 +1,97 @@
-import { categorySchema as e, checkoutConflictSchema as t, checkoutResponseSchema as n, orderSummarySchema as r, productCardPageSchema as i, productSchema as a } from "@develemit/commerce-contracts";
+import { categorySchema as e, checkoutConflictSchema as t, checkoutResponseSchema as n, discountPreviewSchema as r, discountRejectionSchema as i, orderSummarySchema as a, productCardPageSchema as o, productSchema as s } from "@develemit/commerce-contracts";
 // src/client/errors.ts
-var o = class extends Error {
+var c = class extends Error {
 	status;
 	url;
 	constructor(e, t, n) {
 		super(n ?? `Commerce API request failed (${e}): ${t}`), this.status = e, this.url = t, this.name = "CommerceApiError";
 	}
-}, s = class extends o {
+}, l = class extends c {
 	constructor(e) {
 		super(404, e, `Not found: ${e}`), this.name = "NotFoundError";
 	}
-}, c = class extends o {
+}, u = class extends c {
 	productIds;
 	constructor(e, t) {
 		super(409, e, `Some items are no longer available: ${t.join(", ")}`), this.productIds = t, this.name = "CheckoutConflictError";
 	}
+}, d = class extends c {
+	reason;
+	constructor(e, t) {
+		super(422, e, `Discount code rejected: ${t}`), this.reason = t, this.name = "DiscountInvalidError";
+	}
 };
 // src/client/commerce-client.ts
-function l({ baseUrl: l, fetch: u = (...e) => globalThis.fetch(...e) }) {
-	let d = l.replace(/\/+$/, "");
-	async function f(e, t, n) {
-		if (t.status === 404) throw new s(e);
-		if (!t.ok) throw new o(t.status, e);
+function f({ baseUrl: f, fetch: p = (...e) => globalThis.fetch(...e) }) {
+	let m = f.replace(/\/+$/, "");
+	async function h(e, t, n) {
+		if (t.status === 404) throw new l(e);
+		if (!t.ok) throw new c(t.status, e);
 		return n.parse(await t.json());
 	}
-	async function p(e, t) {
-		let n = `${d}${e}`;
-		return f(n, await u(n, { headers: { accept: "application/json" } }), t);
+	async function g(e, t) {
+		let n = `${m}${e}`;
+		return h(n, await p(n, { headers: { accept: "application/json" } }), t);
 	}
-	async function m(e) {
-		let r = `${d}/checkout`, i = await u(r, {
+	function _(e, t) {
+		return p(e, {
 			method: "POST",
 			headers: {
 				accept: "application/json",
 				"content-type": "application/json"
 			},
-			body: JSON.stringify({ items: e })
+			body: JSON.stringify(t)
 		});
-		if (i.status === 409) throw new c(r, t.parse(await i.json()).unavailableProductIds);
-		return f(r, i, n);
+	}
+	async function v(e, t) {
+		if (t.status !== 422) return;
+		let n = i.safeParse(await t.json().catch(() => null));
+		if (n.success) throw new d(e, n.data.reason);
+	}
+	async function y(e, { discountCode: r } = {}) {
+		let i = `${m}/checkout`, a = await _(i, r ? {
+			items: e,
+			discountCode: r
+		} : { items: e });
+		if (a.status === 409) throw new u(i, t.parse(await a.json()).unavailableProductIds);
+		return await v(i, a), h(i, a, n);
+	}
+	async function b(e) {
+		let t = `${m}/checkout/discount/preview`, n = await _(t, e);
+		return await v(t, n), h(t, n, r);
 	}
 	return {
 		async listProducts(e = {}) {
 			let t = new URLSearchParams();
 			e.category && t.set("category", e.category), e.featured !== void 0 && t.set("featured", String(e.featured)), e.limit !== void 0 && t.set("limit", String(e.limit)), e.cursor && t.set("cursor", e.cursor);
 			let n = t.toString();
-			return p(`/catalog/products${n ? `?${n}` : ""}`, i);
+			return g(`/catalog/products${n ? `?${n}` : ""}`, o);
 		},
 		getProduct(e) {
-			return p(`/catalog/products/${encodeURIComponent(e)}`, a);
+			return g(`/catalog/products/${encodeURIComponent(e)}`, s);
 		},
 		listCategories() {
-			return p("/catalog/categories", e.array());
+			return g("/catalog/categories", e.array());
 		},
-		createCheckout: m,
+		createCheckout: y,
+		previewDiscount: b,
 		getOrderBySession(e) {
-			return p(`/orders/session/${encodeURIComponent(e)}`, r);
+			return g(`/orders/session/${encodeURIComponent(e)}`, a);
 		}
 	};
 }
-export { c as CheckoutConflictError, o as CommerceApiError, s as NotFoundError, l 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","createCommerceClient","fetchImpl","args","root","baseUrl","readJson","res","schema","get","path","createCheckout","checkoutConflictSchema","checkoutResponseSchema","params","query","qs","productCardPageSchema","slug","productSchema","categorySchema","sessionId","orderSummarySchema"],"sources":["../../src/client/errors.ts","../../src/client/commerce-client.ts"],"sourcesContent":["export 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","import {\n  categorySchema,\n  checkoutConflictSchema,\n  checkoutResponseSchema,\n  orderSummarySchema,\n  productCardPageSchema,\n  productSchema,\n  type Category,\n  type CheckoutRequest,\n  type CheckoutResponse,\n  type OrderSummary,\n  type ProductCardPage,\n  type Product,\n  type ProductListQuery,\n} from '@develemit/commerce-contracts';\nimport {\n  CheckoutConflictError,\n  CommerceApiError,\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(items: CheckoutRequest['items']): Promise<CheckoutResponse>;\n  getOrderBySession(sessionId: string): Promise<OrderSummary>;\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  async function createCheckout(\n    items: CheckoutRequest['items'],\n  ): Promise<CheckoutResponse> {\n    const url = `${root}/checkout`;\n    const res = await fetchImpl(url, {\n      method: 'POST',\n      headers: {\n        accept: 'application/json',\n        'content-type': 'application/json',\n      },\n      body: JSON.stringify({ items }),\n    });\n    if (res.status === 409) {\n      const conflict = checkoutConflictSchema.parse(await res.json());\n      throw new CheckoutConflictError(url, conflict.unavailableProductIds);\n    }\n    return readJson(url, res, checkoutResponseSchema);\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    getOrderBySession(sessionId) {\n      return get(\n        `/orders/session/${encodeURIComponent(sessionId)}`,\n        orderSummarySchema,\n      );\n    },\n  };\n}\n"],"mappings":";;AAAA,IAAaA,IAAb,cAAsC,MAAM;CAE/B;CACA;CAFX,YACE,GACA,GACA,GACA;EAEA,AADA,MAAMC,KAAW,gCAAgCC,EAAO,KAAKC,GAAK,GAJzD,KAAA,SAAAD,GACA,KAAA,MAAAC,GAIT,KAAK,OAAO;CACd;AACF,GAEaC,IAAb,cAAmCJ,EAAiB;CAClD,YAAY,GAAa;EAEvB,AADA,MAAM,KAAKG,GAAK,cAAcA,GAAK,GACnC,KAAK,OAAO;CACd;AACF,GAEaE,IAAb,cAA2CL,EAAiB;CAG/C;CAFX,YACE,GACA,GACA;EAMA,AALA,MACE,KACAG,GACA,uCAAuCG,EAAW,KAAK,IAAI,GAC7D,GANS,KAAA,aAAAA,GAOT,KAAK,OAAO;CACd;AACF;;ACMA,SAAgBC,EAAqB,EACnC,YACA,OAAOC,KAAa,GAAGC,MAAS,WAAW,MAAM,GAAGA,CAAI,KAChB;CACxC,IAAMC,IAAOC,EAAQ,QAAQ,QAAQ,EAAE;CAEvC,eAAeC,EACb,GACA,GACA,GACY;EACZ,IAAIC,EAAI,WAAW,KAAK,MAAM,IAAIT,EAAcD,CAAG;EACnD,IAAI,CAACU,EAAI,IAAI,MAAM,IAAIb,EAAiBa,EAAI,QAAQV,CAAG;EACvD,OAAOW,EAAO,MAAM,MAAMD,EAAI,KAAK,CAAC;CACtC;CAEA,eAAeE,EAAO,GAAc,GAA+B;EACjE,IAAMZ,IAAM,GAAGO,IAAOM;EAItB,OAAOJ,EAAST,GAAK,MAHHK,EAAUL,GAAK,EAC/B,SAAS,EAAE,QAAQ,mBAAmB,EACxC,CAAC,GACyBW,CAAM;CAClC;CAEA,eAAeG,EACb,GAC2B;EAC3B,IAAMd,IAAM,GAAGO,EAAK,YACdG,IAAM,MAAML,EAAUL,GAAK;GAC/B,QAAQ;GACR,SAAS;IACP,QAAQ;IACR,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAU,EAAE,SAAM,CAAC;EAChC,CAAC;EACD,IAAIU,EAAI,WAAW,KAEjB,MAAM,IAAIR,EAAsBF,GADfe,EAAuB,MAAM,MAAML,EAAI,KAAK,CACxB,CAAA,CAAS,qBAAqB;EAErE,OAAOD,EAAST,GAAKU,GAAKM,CAAsB;CAClD;CAEA,OAAO;EACL,MAAM,aAAa,IAAQ,CAAC,GAAG;GAC7B,IAAMC,IAAS,IAAI,gBAAgB;GAMnC,AALIC,EAAM,YAAUD,EAAO,IAAI,YAAYC,EAAM,QAAQ,GACrDA,EAAM,aAAa,KAAA,KACrBD,EAAO,IAAI,YAAY,OAAOC,EAAM,QAAQ,CAAC,GAE3CA,EAAM,UAAU,KAAA,KAAWD,EAAO,IAAI,SAAS,OAAOC,EAAM,KAAK,CAAC,GAClEA,EAAM,UAAQD,EAAO,IAAI,UAAUC,EAAM,MAAM;GACnD,IAAMC,IAAKF,EAAO,SAAS;GAC3B,OAAOL,EACL,oBAAoBO,IAAK,IAAIA,MAAO,MACpCC,CACF;EACF;EACA,WAAW,GAAM;GACf,OAAOR,EACL,qBAAqB,mBAAmBS,CAAI,KAC5CC,CACF;EACF;EACA,iBAAiB;GACf,OAAOV,EAAI,uBAAuBW,EAAe,MAAM,CAAC;EAC1D;EACA;EACA,kBAAkB,GAAW;GAC3B,OAAOX,EACL,mBAAmB,mBAAmBY,CAAS,KAC/CC,CACF;EACF;CACF;AACF"}
+{"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":";;AAEA,IAAaA,IAAb,cAAsC,MAAM;CAE/B;CACA;CAFX,YACE,GACA,GACA,GACA;EAEA,AADA,MAAMC,KAAW,gCAAgCC,EAAO,KAAKC,GAAK,GAJzD,KAAA,SAAAD,GACA,KAAA,MAAAC,GAIT,KAAK,OAAO;CACd;AACF,GAEaC,IAAb,cAAmCJ,EAAiB;CAClD,YAAY,GAAa;EAEvB,AADA,MAAM,KAAKG,GAAK,cAAcA,GAAK,GACnC,KAAK,OAAO;CACd;AACF,GAEaE,IAAb,cAA2CL,EAAiB;CAG/C;CAFX,YACE,GACA,GACA;EAMA,AALA,MACE,KACAG,GACA,uCAAuCG,EAAW,KAAK,IAAI,GAC7D,GANS,KAAA,aAAAA,GAOT,KAAK,OAAO;CACd;AACF,GAEaC,IAAb,cAA0CP,EAAiB;CAG9C;CAFX,YACE,GACA,GACA;EAEA,AADA,MAAM,KAAKG,GAAK,2BAA2BK,GAAQ,GAF1C,KAAA,SAAAA,GAGT,KAAK,OAAO;CACd;AACF;;ACSA,SAAgBC,EAAqB,EACnC,YACA,OAAOC,KAAa,GAAGC,MAAS,WAAW,MAAM,GAAGA,CAAI,KAChB;CACxC,IAAMC,IAAOC,EAAQ,QAAQ,QAAQ,EAAE;CAEvC,eAAeC,EACb,GACA,GACA,GACY;EACZ,IAAIC,EAAI,WAAW,KAAK,MAAM,IAAIX,EAAcD,CAAG;EACnD,IAAI,CAACY,EAAI,IAAI,MAAM,IAAIf,EAAiBe,EAAI,QAAQZ,CAAG;EACvD,OAAOa,EAAO,MAAM,MAAMD,EAAI,KAAK,CAAC;CACtC;CAEA,eAAeE,EAAO,GAAc,GAA+B;EACjE,IAAMd,IAAM,GAAGS,IAAOM;EAItB,OAAOJ,EAASX,GAAK,MAHHO,EAAUP,GAAK,EAC/B,SAAS,EAAE,QAAQ,mBAAmB,EACxC,CAAC,GACyBa,CAAM;CAClC;CAEA,SAASG,EAAS,GAAa,GAAkC;EAC/D,OAAOT,EAAUP,GAAK;GACpB,QAAQ;GACR,SAAS;IACP,QAAQ;IACR,gBAAgB;GAClB;GACA,MAAM,KAAK,UAAUiB,CAAI;EAC3B,CAAC;CACH;CAEA,eAAeC,EAAuB,GAAa,GAAe;EAChE,IAAIN,EAAI,WAAW,KAAK;EACxB,IAAMO,IAASC,EAAwB,UACrC,MAAMR,EAAI,KAAK,CAAC,CAAC,YAAY,IAAI,CACnC;EACA,IAAIO,EAAO,SAAS,MAAM,IAAIf,EAAqBJ,GAAKmB,EAAO,KAAK,MAAM;CAC5E;CAEA,eAAeE,EACb,GACA,EAAE,oBAAwC,CAAC,GAChB;EAC3B,IAAMrB,IAAM,GAAGS,EAAK,YACdG,IAAM,MAAMI,EAChBhB,GACAsB,IAAe;GAAE;GAAO;EAAa,IAAI,EAAE,SAAM,CACnD;EACA,IAAIV,EAAI,WAAW,KAEjB,MAAM,IAAIV,EAAsBF,GADfuB,EAAuB,MAAM,MAAMX,EAAI,KAAK,CACxB,CAAA,CAAS,qBAAqB;EAGrE,OADA,MAAMM,EAAuBlB,GAAKY,CAAG,GAC9BD,EAASX,GAAKY,GAAKY,CAAsB;CAClD;CAEA,eAAeC,EAAgB,GAGF;EAC3B,IAAMzB,IAAM,GAAGS,EAAK,6BACdG,IAAM,MAAMI,EAAShB,GAAK0B,CAAK;EAErC,OADA,MAAMR,EAAuBlB,GAAKY,CAAG,GAC9BD,EAASX,GAAKY,GAAKe,CAAqB;CACjD;CAEA,OAAO;EACL,MAAM,aAAa,IAAQ,CAAC,GAAG;GAC7B,IAAMC,IAAS,IAAI,gBAAgB;GAMnC,AALIC,EAAM,YAAUD,EAAO,IAAI,YAAYC,EAAM,QAAQ,GACrDA,EAAM,aAAa,KAAA,KACrBD,EAAO,IAAI,YAAY,OAAOC,EAAM,QAAQ,CAAC,GAE3CA,EAAM,UAAU,KAAA,KAAWD,EAAO,IAAI,SAAS,OAAOC,EAAM,KAAK,CAAC,GAClEA,EAAM,UAAQD,EAAO,IAAI,UAAUC,EAAM,MAAM;GACnD,IAAMC,IAAKF,EAAO,SAAS;GAC3B,OAAOd,EACL,oBAAoBgB,IAAK,IAAIA,MAAO,MACpCC,CACF;EACF;EACA,WAAW,GAAM;GACf,OAAOjB,EACL,qBAAqB,mBAAmBkB,CAAI,KAC5CC,CACF;EACF;EACA,iBAAiB;GACf,OAAOnB,EAAI,uBAAuBoB,EAAe,MAAM,CAAC;EAC1D;EACA;EACA;EACA,kBAAkB,GAAW;GAC3B,OAAOpB,EACL,mBAAmB,mBAAmBqB,CAAS,KAC/CC,CACF;EACF;CACF;AACF;;ACjJA,SAAgBC,EAAiB,GAAiC;CAChE,IAAIC,aAAiBpC,GACnB,OAAO;EAAE,OAAO;EAAgB,YAAYoC,EAAM;CAAW;CAE/D,IAAIA,aAAiBlC,GACnB,OAAO;EAAE,OAAO;EAAoB,QAAQkC,EAAM;CAAO;CAE3D,MAAMA;AACR"}

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

@@ -1,10 +1,17 @@
+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'>> & {
+        reasons?: Partial<DiscountLabels['reasons']>;
+    };
 }
 export interface CartSummaryProps {
     onCheckout?: () => void;
     checkoutLabel?: string;
     checkoutDisabled?: boolean;
     labels?: Partial<CartSummaryLabels>;
+    discount?: CartSummaryDiscount;
 }
-export declare function CartSummary({ onCheckout, checkoutLabel, checkoutDisabled, labels, }: CartSummaryProps): import('react').JSX.Element;
+export declare function CartSummary({ onCheckout, checkoutLabel, checkoutDisabled, labels, discount, }: CartSummaryProps): import('react').JSX.Element;

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

@@ -0,0 +1,13 @@
+import { DiscountLabels } from './discount-types';
+import { AppliedDiscount, DiscountError } from './use-discount';
+export interface DiscountFieldProps {
+    labels: DiscountLabels;
+    applied: AppliedDiscount | null;
+    error: DiscountError | null;
+    pending: boolean;
+    currency: string;
+    locale: string;
+    onApply: (code: string) => void;
+    onRemove: () => void;
+}
+export declare function DiscountField({ labels, applied, error, pending, currency, locale, onApply, onRemove, }: DiscountFieldProps): import('react').JSX.Element;

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

@@ -0,0 +1,28 @@
+import { DiscountRejectionReason } from '@develemit/commerce-contracts';
+export type DiscountPreviewResult = {
+    ok: true;
+    code: string;
+    discountCents: number;
+} | {
+    ok: false;
+    reason: DiscountRejectionReason;
+};
+export interface CartSummaryDiscount {
+    onPreview: (code: string, items: {
+        productId: string;
+        quantity: number;
+    }[]) => Promise<DiscountPreviewResult>;
+    onApply?: (code: string | null) => void;
+    debounceMs?: number;
+}
+export interface DiscountLabels {
+    toggle: string;
+    field: string;
+    apply: string;
+    remove: string;
+    line: string;
+    reasons: Record<DiscountRejectionReason, string>;
+    unavailable: string;
+}
+export declare const defaultDiscountLabels: DiscountLabels;
+export declare function discountReasonMessage(reason: DiscountRejectionReason, overrides?: Partial<DiscountLabels['reasons']>): string;

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

@@ -0,0 +1,14 @@
+import { DiscountRejectionReason } from '@develemit/commerce-contracts';
+import { CartSummaryDiscount } from './discount-types';
+export interface AppliedDiscount {
+    code: string;
+    discountCents: number;
+}
+export type DiscountError = DiscountRejectionReason | 'unavailable';
+export declare function useDiscount(discount: CartSummaryDiscount | undefined): {
+    applied: AppliedDiscount | null;
+    error: DiscountError | null;
+    pending: boolean;
+    apply: (code: string) => Promise<void>;
+    remove: () => void;
+};

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

@@ -0,0 +1,13 @@
+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;
+}
+export declare function CheckoutSuccessView({ order, locale, labels, className, }: CheckoutSuccessViewProps): import('react').JSX.Element;

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

@@ -0,0 +1,12 @@
+import { OrderStatus } from '@develemit/commerce-contracts';
+export interface CheckoutSuccessLabels {
+    heading: 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';