@usethrottle/checkout-react 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   PaymentEmbed: () => PaymentEmbed,
   ThrottleCheckout: () => CheckoutEmbed,
   useCartSession: () => useCartSession,
+  useThrottleCheckout: () => useThrottleCheckout,
   useThrottleEvents: () => useThrottleEvents
 });
 module.exports = __toCommonJS(index_exports);
@@ -394,12 +395,269 @@ function useCartSession(options) {
     reset
   };
 }
+
+// src/useThrottleCheckout.tsx
+var import_react6 = require("react");
+var import_cart2 = require("@usethrottle/cart");
+var DEFAULT_STORAGE_KEY2 = "throttle.cartSessionId";
+function readStored2(key) {
+  if (!key || typeof window === "undefined") return null;
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function writeStored2(key, value) {
+  if (!key || typeof window === "undefined") return;
+  try {
+    if (value === null) window.localStorage.removeItem(key);
+    else window.localStorage.setItem(key, value);
+  } catch {
+  }
+}
+function totalsOf(cart) {
+  if (!cart) return null;
+  return {
+    currency: cart.currency,
+    subtotal: cart.subtotal,
+    discountTotal: cart.discountTotal,
+    shippingTotal: cart.shippingTotal,
+    taxTotal: cart.taxTotal,
+    total: cart.total
+  };
+}
+function useThrottleCheckout(options) {
+  const { applicationId, environmentId, quoteToken, baseUrl } = options;
+  const autoRecover = options.autoRecover ?? true;
+  const storageKey = options.storageKey === void 0 ? DEFAULT_STORAGE_KEY2 : options.storageKey;
+  const [cart, setCart] = (0, import_react6.useState)(null);
+  const [cartSessionId, setCartSessionId] = (0, import_react6.useState)(null);
+  const [status, setStatus] = (0, import_react6.useState)("idle");
+  const [error, setError] = (0, import_react6.useState)(null);
+  const cartRef = (0, import_react6.useRef)(null);
+  cartRef.current = cart;
+  const { client, initError } = (0, import_react6.useMemo)(() => {
+    try {
+      return {
+        client: new import_cart2.CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),
+        initError: null
+      };
+    } catch (e) {
+      return { client: null, initError: e };
+    }
+  }, [applicationId, environmentId, quoteToken, baseUrl]);
+  (0, import_react6.useEffect)(() => {
+    if (initError) {
+      setError(initError);
+      setStatus("error");
+    }
+  }, [initError]);
+  (0, import_react6.useEffect)(() => {
+    if (!client) return;
+    const saved = readStored2(storageKey);
+    if (!saved) return;
+    let cancelled = false;
+    client.resume(saved);
+    setCartSessionId(saved);
+    setStatus("loading");
+    client.get().then((s) => {
+      if (cancelled) return;
+      setCart(s.cart);
+      setStatus("ready");
+    }).catch(() => {
+      if (cancelled) return;
+      writeStored2(storageKey, null);
+      client.resume("");
+      setCartSessionId(null);
+      setCart(null);
+      setStatus("idle");
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, storageKey]);
+  const ensureSession = (0, import_react6.useCallback)(
+    async (input) => {
+      if (!client) throw initError ?? new Error("CartSessionClient unavailable");
+      if (client.cartSessionId) return;
+      const session = await client.create(input ?? {});
+      writeStored2(storageKey, session.cartSessionId);
+      setCartSessionId(session.cartSessionId);
+      setCart(session.cart);
+    },
+    [client, initError, storageKey]
+  );
+  const rebuild = (0, import_react6.useCallback)(async () => {
+    if (!client) throw initError ?? new Error("CartSessionClient unavailable");
+    const prev = cartRef.current;
+    client.resume("");
+    setCartSessionId(null);
+    const session = await client.create({
+      currency: prev?.currency,
+      netN: prev?.netN ?? void 0
+    });
+    writeStored2(storageKey, session.cartSessionId);
+    setCartSessionId(session.cartSessionId);
+    let next = session.cart;
+    for (const item of prev?.lineItems ?? []) {
+      next = await client.addItem({
+        type: item.type,
+        referenceId: item.referenceId ?? void 0,
+        name: item.name,
+        description: item.description ?? void 0,
+        unitPrice: item.unitPrice,
+        quantity: item.quantity,
+        imageUrl: item.imageUrl ?? void 0,
+        metadata: item.metadata
+      });
+    }
+    const ship = prev?.selectedShipping;
+    if (ship) {
+      next = await client.selectShipping({
+        methodId: ship.methodId,
+        displayName: ship.displayName,
+        rateAmount: ship.rateAmount,
+        currency: ship.currency,
+        carrier: ship.carrier ?? void 0,
+        serviceCode: ship.serviceCode ?? void 0,
+        estimatedDeliveryDays: ship.estimatedDeliveryDays ?? void 0
+      });
+    }
+    setCart(next);
+    return next;
+  }, [client, initError, storageKey]);
+  const run = (0, import_react6.useCallback)(
+    async (fn, opts = {}) => {
+      if (!client) {
+        const e = initError ?? new Error("CartSessionClient unavailable");
+        setError(e);
+        setStatus("error");
+        throw e;
+      }
+      setStatus("loading");
+      setError(null);
+      try {
+        if (opts.create) await ensureSession();
+        const result = await fn();
+        setStatus("ready");
+        return result;
+      } catch (e) {
+        const stale = e instanceof import_cart2.CartNotOpenError || e instanceof import_cart2.CartNotFoundError;
+        if (stale && autoRecover) {
+          try {
+            setStatus("recovering");
+            await rebuild();
+            if (opts.retryAfterRecover) {
+              const retried = await fn();
+              setStatus("ready");
+              return retried;
+            }
+            setStatus("ready");
+            const stale2 = new import_cart2.CartNotOpenError({
+              message: "Cart was rebuilt after going stale; retry your action against the new cart."
+            });
+            setError(stale2);
+            throw stale2;
+          } catch (recoverErr) {
+            setError(recoverErr);
+            setStatus("error");
+            throw recoverErr;
+          }
+        }
+        setError(e);
+        setStatus("error");
+        throw e;
+      }
+    },
+    [client, ensureSession, initError, autoRecover, rebuild]
+  );
+  const addItem = (0, import_react6.useCallback)(
+    async (input) => {
+      const next = await run(() => client.addItem(input), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const updateItem = (0, import_react6.useCallback)(
+    async (itemId, input) => {
+      const next = await run(() => client.updateItem(itemId, input), { retryAfterRecover: false });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const removeItem = (0, import_react6.useCallback)(
+    async (itemId) => {
+      const next = await run(() => client.removeItem(itemId), { retryAfterRecover: false });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const selectMethod = (0, import_react6.useCallback)(
+    async (input) => {
+      const next = await run(() => client.selectShipping(input), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const clearShipping = (0, import_react6.useCallback)(async () => {
+    const next = await run(() => client.clearShipping(), { retryAfterRecover: true });
+    setCart(next);
+  }, [client, run]);
+  const applyDiscount = (0, import_react6.useCallback)(
+    async (code) => {
+      const next = await run(() => client.applyDiscount(code), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const removeDiscount = (0, import_react6.useCallback)(async () => {
+    const next = await run(() => client.removeDiscount(), { retryAfterRecover: true });
+    setCart(next);
+  }, [client, run]);
+  const refresh = (0, import_react6.useCallback)(async () => {
+    if (!client?.cartSessionId) return;
+    const next = await run(async () => (await client.get()).cart);
+    setCart(next);
+  }, [client, run]);
+  const createSession = (0, import_react6.useCallback)(
+    (input) => run(() => client.checkout(input), { create: true, retryAfterRecover: true }),
+    [client, run]
+  );
+  const reset = (0, import_react6.useCallback)(() => {
+    writeStored2(storageKey, null);
+    client?.resume("");
+    setCartSessionId(null);
+    setCart(null);
+    setError(null);
+    setStatus("idle");
+  }, [client, storageKey]);
+  return {
+    cart,
+    cartSessionId,
+    status,
+    error,
+    selectedMethod: cart?.selectedShipping ?? null,
+    totals: totalsOf(cart),
+    addItem,
+    updateItem,
+    removeItem,
+    selectMethod,
+    clearShipping,
+    applyDiscount,
+    removeDiscount,
+    createSession,
+    refresh,
+    reset
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CheckoutEmbed,
   PaymentEmbed,
   ThrottleCheckout,
   useCartSession,
+  useThrottleCheckout,
   useThrottleEvents
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx","../src/CheckoutEmbed.tsx","../src/useThrottleEvents.ts","../src/useParentCommands.ts","../src/PaymentEmbed.tsx","../src/useCartSession.tsx"],"sourcesContent":["export { CheckoutEmbed } from './CheckoutEmbed.js';\nexport { PaymentEmbed } from './PaymentEmbed.js';\nexport { useThrottleEvents } from './useThrottleEvents.js';\nexport { useCartSession } from './useCartSession.js';\nexport type { UseCartSessionOptions, UseCartSessionResult } from './useCartSession.js';\nexport type {\n  ThrottleEvent,\n  ThrottleMessage,\n  ThrottleEnvelope,\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  RecurringIntent,\n  ThrottleParentCommand,\n  ThrottleParentEnvelope,\n  ThrottleParentMessage,\n} from './types.js';\n\n// v0.1.x compat alias. v0.1's <ThrottleCheckout> shape (positional\n// onCompleted/onError args, optional baseUrl, no parentOrigin) is\n// gone in v0.2 — the alias resolves to <CheckoutEmbed> which now\n// requires `parentOrigin`. Update call sites accordingly.\nexport { CheckoutEmbed as ThrottleCheckout } from './CheckoutEmbed.js';\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type {\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  ThrottleMessage,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Full-checkout iframe embed. Renders the entire Throttle hosted\n * checkout (address / shipping / payment) inside an iframe and\n * surfaces lifecycle + terminal events through callbacks. The\n * iframe auto-resizes on `throttle.resize` events.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list\n * (`throttle embed-config set --origins ...`). Mismatches render\n * an in-iframe \"Embed not authorized\" panel.\n */\nexport function CheckoutEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 600,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n  onStepChanged,\n}: ThrottleEmbedProps & CheckoutEmbedExtraProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.step.changed':\n          onStepChanged?.({ step: msg.step });\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled, onStepChanged],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'checkout-full', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle checkout\"\n    />\n  );\n}\n","import { useEffect, type RefObject } from 'react';\nimport type { ThrottleMessage } from './types.js';\n\nexport interface UseThrottleEventsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /**\n   * The Throttle origin (e.g. https://checkout.usethrottle.dev).\n   * Strict-equals check against `MessageEvent.origin`. Anything else\n   * is silently dropped.\n   */\n  expectedOrigin: string;\n  onMessage: (msg: ThrottleMessage) => void;\n}\n\n/**\n * Subscribe to validated postMessage events from a Throttle iframe.\n *\n * Validation:\n *  - event.origin === expectedOrigin (strict string match)\n *  - event.source === iframeRef.current.contentWindow (defends against\n *    other iframes on the same origin spoofing events)\n *  - event.data.source === 'throttle' && event.data.version === 1\n *  - event.data.type starts with 'throttle.'\n *\n * Anything failing validation is silently dropped — the parent page\n * may receive postMessages from analytics SDKs, browser extensions,\n * other iframes, etc. We must never throw on those.\n */\nexport function useThrottleEvents({ iframeRef, expectedOrigin, onMessage }: UseThrottleEventsOptions) {\n  useEffect(() => {\n    function handle(ev: MessageEvent) {\n      if (ev.origin !== expectedOrigin) return;\n      if (iframeRef.current && ev.source !== iframeRef.current.contentWindow) return;\n      const data = ev.data as Partial<ThrottleMessage> | null | undefined;\n      if (!data || typeof data !== 'object') return;\n      if (data.source !== 'throttle' || data.version !== 1) return;\n      if (typeof data.type !== 'string' || !data.type.startsWith('throttle.')) return;\n      onMessage(data as ThrottleMessage);\n    }\n    window.addEventListener('message', handle);\n    return () => window.removeEventListener('message', handle);\n  }, [iframeRef, expectedOrigin, onMessage]);\n}\n","import { useEffect, useState, type RefObject } from 'react';\nimport type { ThrottleParentMessage } from './types.js';\n\ninterface UseParentCommandsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /** The Throttle origin to address messages to. */\n  targetOrigin: string;\n  /**\n   * The current value of `submitDisabled` from the embed props. Posts a\n   * `set-submit-disabled` parent command whenever it changes — and once\n   * after the iframe reports `throttle.ready` so the iframe sees the\n   * intent even if it boots after the prop is already set.\n   *\n   * `undefined` means the parent never explicitly enabled/disabled — we\n   * never post in that case. Backward-compat with embeds that don't\n   * pass the prop.\n   */\n  submitDisabled?: boolean;\n  /**\n   * Set to `true` once the iframe posts `throttle.ready`. Until then,\n   * commands are buffered (we still try to post but the iframe may not\n   * have its listener attached yet — and we re-post on ready as a\n   * belt-and-braces guard).\n   */\n  iframeReady: boolean;\n}\n\n/**\n * Post parent → iframe commands when controlled props change. v1.2 adds\n * `set-submit-disabled`; future commands extend the same channel.\n *\n * postMessage is fire-and-forget — we don't wait for an ack from the\n * iframe. The iframe's listener is idempotent (setting the same value\n * twice is a no-op).\n */\nexport function useParentCommands({\n  iframeRef,\n  targetOrigin,\n  submitDisabled,\n  iframeReady,\n}: UseParentCommandsOptions) {\n  const [lastSent, setLastSent] = useState<boolean | undefined>(undefined);\n\n  // Post when the prop value changes OR when the iframe transitions to\n  // ready (so the first state lands).\n  useEffect(() => {\n    if (submitDisabled === undefined) return;\n    const win = iframeRef.current?.contentWindow;\n    if (!win) return;\n    // Skip if we already sent this value AND the iframe was already ready\n    // — avoids spam on unrelated re-renders.\n    if (lastSent === submitDisabled && iframeReady) return;\n    if (!iframeReady) return; // Defer until ready\n\n    const message: ThrottleParentMessage = {\n      source: 'throttle-parent',\n      version: 1,\n      type: 'set-submit-disabled',\n      disabled: submitDisabled,\n    };\n    win.postMessage(message, targetOrigin);\n    setLastSent(submitDisabled);\n  }, [iframeRef, targetOrigin, submitDisabled, iframeReady, lastSent]);\n}\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type { ThrottleEmbedProps, ThrottleMessage } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Payment-only iframe embed. Renders just the Gr4vy provider iframe\n * (no address / shipping / cart UI). Email is collected by the Gr4vy\n * iframe in proxy-mode sessions. Used when the merchant has built\n * their own checkout UI and only needs Throttle to handle payment\n * authorization + capture.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list.\n * The iframe auto-resizes on `throttle.resize` events.\n */\nexport function PaymentEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 480,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n}: ThrottleEmbedProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'payment-only', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle payment\"\n    />\n  );\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport {\n  CartSessionClient,\n  type Cart,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\nexport interface UseCartSessionOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the session id across page loads. Default\n   * `'throttle.cartSessionId'`. Pass `null` to disable persistence (in-memory\n   * only).\n   */\n  storageKey?: string | null;\n}\n\nexport interface UseCartSessionResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current opaque session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** True while a request is in flight. */\n  loading: boolean;\n  /** Last error, or null. */\n  error: Error | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  selectShipping: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /** Hand off to checkout. Returns the hand-off (redirect the buyer to `checkoutUrl`). */\n  checkout: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\n/**\n * React hook for backend-less cart ownership. Wraps {@link CartSessionClient}:\n * creates the Throttle cart lazily on the first `addItem` (so empty carts\n * aren't created on every page load), persists the session id to localStorage,\n * and resumes it on the next visit. Mutations update reactive `cart` state.\n *\n * ```tsx\n * const cart = useCartSession({ applicationId, environmentId, quoteToken });\n * <button onClick={() => cart.addItem({ name: 'Widget', unitPrice: 2999, quantity: 1 })}>Add</button>\n * <button onClick={async () => {\n *   const { checkoutUrl } = await cart.checkout({ returnUrl, cancelUrl });\n *   window.location.href = checkoutUrl;\n * }}>Checkout</button>\n * ```\n */\nexport function useCartSession(options: UseCartSessionOptions): UseCartSessionResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Stable client across renders for a given config; construction validates the\n  // token, so capture any constructor error instead of throwing during render.\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) setError(initError);\n  }, [initError]);\n\n  // Resume a persisted session on mount (and whenever the client identity changes).\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setLoading(true);\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n      })\n      .catch(() => {\n        // Expired / unknown / origin-rejected → drop the stale id and start fresh.\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /** Run a mutation that returns the updated cart, managing loading/error + creating the session first. */\n  const run = useCallback(\n    async (fn: () => Promise<Cart>, opts: { create?: boolean } = {}): Promise<void> => {\n      if (!client) {\n        setError(initError ?? new Error('CartSessionClient unavailable'));\n        return;\n      }\n      setLoading(true);\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const next = await fn();\n        setCart(next);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const addItem = useCallback(\n    (input: AddLineItemInput) => run(() => client!.addItem(input), { create: true }),\n    [client, run],\n  );\n  const updateItem = useCallback(\n    (itemId: string, input: UpdateLineItemInput) => run(() => client!.updateItem(itemId, input)),\n    [client, run],\n  );\n  const removeItem = useCallback((itemId: string) => run(() => client!.removeItem(itemId)), [client, run]);\n  const selectShipping = useCallback(\n    (input: SelectShippingInput) => run(() => client!.selectShipping(input), { create: true }),\n    [client, run],\n  );\n  const clearShipping = useCallback(() => run(() => client!.clearShipping()), [client, run]);\n  const applyDiscount = useCallback(\n    (code: string) => run(() => client!.applyDiscount(code), { create: true }),\n    [client, run],\n  );\n  const removeDiscount = useCallback(() => run(() => client!.removeDiscount()), [client, run]);\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    await run(async () => (await client.get()).cart);\n  }, [client, run]);\n\n  const checkout = useCallback(\n    async (input: CheckoutHandoffInput): Promise<CheckoutHandoff> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      setLoading(true);\n      setError(null);\n      try {\n        await ensureSession();\n        return await client.checkout(input);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    loading,\n    error,\n    addItem,\n    updateItem,\n    removeItem,\n    selectShipping,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    checkout,\n    refresh,\n    reset,\n  };\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_jsx_runtime","DEFAULT_BASE_URL","import_react"]}
+{"version":3,"sources":["../src/index.tsx","../src/CheckoutEmbed.tsx","../src/useThrottleEvents.ts","../src/useParentCommands.ts","../src/PaymentEmbed.tsx","../src/useCartSession.tsx","../src/useThrottleCheckout.tsx"],"sourcesContent":["export { CheckoutEmbed } from './CheckoutEmbed.js';\nexport { PaymentEmbed } from './PaymentEmbed.js';\nexport { useThrottleEvents } from './useThrottleEvents.js';\nexport { useCartSession } from './useCartSession.js';\nexport type { UseCartSessionOptions, UseCartSessionResult } from './useCartSession.js';\nexport { useThrottleCheckout } from './useThrottleCheckout.js';\nexport type {\n  UseThrottleCheckoutOptions,\n  UseThrottleCheckoutResult,\n  ThrottleCheckoutStatus,\n  CheckoutTotals,\n} from './useThrottleCheckout.js';\nexport type {\n  ThrottleEvent,\n  ThrottleMessage,\n  ThrottleEnvelope,\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  RecurringIntent,\n  ThrottleParentCommand,\n  ThrottleParentEnvelope,\n  ThrottleParentMessage,\n} from './types.js';\n\n// v0.1.x compat alias. v0.1's <ThrottleCheckout> shape (positional\n// onCompleted/onError args, optional baseUrl, no parentOrigin) is\n// gone in v0.2 — the alias resolves to <CheckoutEmbed> which now\n// requires `parentOrigin`. Update call sites accordingly.\nexport { CheckoutEmbed as ThrottleCheckout } from './CheckoutEmbed.js';\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type {\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  ThrottleMessage,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Full-checkout iframe embed. Renders the entire Throttle hosted\n * checkout (address / shipping / payment) inside an iframe and\n * surfaces lifecycle + terminal events through callbacks. The\n * iframe auto-resizes on `throttle.resize` events.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list\n * (`throttle embed-config set --origins ...`). Mismatches render\n * an in-iframe \"Embed not authorized\" panel.\n */\nexport function CheckoutEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 600,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n  onStepChanged,\n}: ThrottleEmbedProps & CheckoutEmbedExtraProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.step.changed':\n          onStepChanged?.({ step: msg.step });\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled, onStepChanged],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'checkout-full', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle checkout\"\n    />\n  );\n}\n","import { useEffect, type RefObject } from 'react';\nimport type { ThrottleMessage } from './types.js';\n\nexport interface UseThrottleEventsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /**\n   * The Throttle origin (e.g. https://checkout.usethrottle.dev).\n   * Strict-equals check against `MessageEvent.origin`. Anything else\n   * is silently dropped.\n   */\n  expectedOrigin: string;\n  onMessage: (msg: ThrottleMessage) => void;\n}\n\n/**\n * Subscribe to validated postMessage events from a Throttle iframe.\n *\n * Validation:\n *  - event.origin === expectedOrigin (strict string match)\n *  - event.source === iframeRef.current.contentWindow (defends against\n *    other iframes on the same origin spoofing events)\n *  - event.data.source === 'throttle' && event.data.version === 1\n *  - event.data.type starts with 'throttle.'\n *\n * Anything failing validation is silently dropped — the parent page\n * may receive postMessages from analytics SDKs, browser extensions,\n * other iframes, etc. We must never throw on those.\n */\nexport function useThrottleEvents({ iframeRef, expectedOrigin, onMessage }: UseThrottleEventsOptions) {\n  useEffect(() => {\n    function handle(ev: MessageEvent) {\n      if (ev.origin !== expectedOrigin) return;\n      if (iframeRef.current && ev.source !== iframeRef.current.contentWindow) return;\n      const data = ev.data as Partial<ThrottleMessage> | null | undefined;\n      if (!data || typeof data !== 'object') return;\n      if (data.source !== 'throttle' || data.version !== 1) return;\n      if (typeof data.type !== 'string' || !data.type.startsWith('throttle.')) return;\n      onMessage(data as ThrottleMessage);\n    }\n    window.addEventListener('message', handle);\n    return () => window.removeEventListener('message', handle);\n  }, [iframeRef, expectedOrigin, onMessage]);\n}\n","import { useEffect, useState, type RefObject } from 'react';\nimport type { ThrottleParentMessage } from './types.js';\n\ninterface UseParentCommandsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /** The Throttle origin to address messages to. */\n  targetOrigin: string;\n  /**\n   * The current value of `submitDisabled` from the embed props. Posts a\n   * `set-submit-disabled` parent command whenever it changes — and once\n   * after the iframe reports `throttle.ready` so the iframe sees the\n   * intent even if it boots after the prop is already set.\n   *\n   * `undefined` means the parent never explicitly enabled/disabled — we\n   * never post in that case. Backward-compat with embeds that don't\n   * pass the prop.\n   */\n  submitDisabled?: boolean;\n  /**\n   * Set to `true` once the iframe posts `throttle.ready`. Until then,\n   * commands are buffered (we still try to post but the iframe may not\n   * have its listener attached yet — and we re-post on ready as a\n   * belt-and-braces guard).\n   */\n  iframeReady: boolean;\n}\n\n/**\n * Post parent → iframe commands when controlled props change. v1.2 adds\n * `set-submit-disabled`; future commands extend the same channel.\n *\n * postMessage is fire-and-forget — we don't wait for an ack from the\n * iframe. The iframe's listener is idempotent (setting the same value\n * twice is a no-op).\n */\nexport function useParentCommands({\n  iframeRef,\n  targetOrigin,\n  submitDisabled,\n  iframeReady,\n}: UseParentCommandsOptions) {\n  const [lastSent, setLastSent] = useState<boolean | undefined>(undefined);\n\n  // Post when the prop value changes OR when the iframe transitions to\n  // ready (so the first state lands).\n  useEffect(() => {\n    if (submitDisabled === undefined) return;\n    const win = iframeRef.current?.contentWindow;\n    if (!win) return;\n    // Skip if we already sent this value AND the iframe was already ready\n    // — avoids spam on unrelated re-renders.\n    if (lastSent === submitDisabled && iframeReady) return;\n    if (!iframeReady) return; // Defer until ready\n\n    const message: ThrottleParentMessage = {\n      source: 'throttle-parent',\n      version: 1,\n      type: 'set-submit-disabled',\n      disabled: submitDisabled,\n    };\n    win.postMessage(message, targetOrigin);\n    setLastSent(submitDisabled);\n  }, [iframeRef, targetOrigin, submitDisabled, iframeReady, lastSent]);\n}\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type { ThrottleEmbedProps, ThrottleMessage } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Payment-only iframe embed. Renders just the Gr4vy provider iframe\n * (no address / shipping / cart UI). Email is collected by the Gr4vy\n * iframe in proxy-mode sessions. Used when the merchant has built\n * their own checkout UI and only needs Throttle to handle payment\n * authorization + capture.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list.\n * The iframe auto-resizes on `throttle.resize` events.\n */\nexport function PaymentEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 480,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n}: ThrottleEmbedProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'payment-only', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle payment\"\n    />\n  );\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport {\n  CartSessionClient,\n  type Cart,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\nexport interface UseCartSessionOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the session id across page loads. Default\n   * `'throttle.cartSessionId'`. Pass `null` to disable persistence (in-memory\n   * only).\n   */\n  storageKey?: string | null;\n}\n\nexport interface UseCartSessionResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current opaque session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** True while a request is in flight. */\n  loading: boolean;\n  /** Last error, or null. */\n  error: Error | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  selectShipping: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /** Hand off to checkout. Returns the hand-off (redirect the buyer to `checkoutUrl`). */\n  checkout: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\n/**\n * React hook for backend-less cart ownership. Wraps {@link CartSessionClient}:\n * creates the Throttle cart lazily on the first `addItem` (so empty carts\n * aren't created on every page load), persists the session id to localStorage,\n * and resumes it on the next visit. Mutations update reactive `cart` state.\n *\n * ```tsx\n * const cart = useCartSession({ applicationId, environmentId, quoteToken });\n * <button onClick={() => cart.addItem({ name: 'Widget', unitPrice: 2999, quantity: 1 })}>Add</button>\n * <button onClick={async () => {\n *   const { checkoutUrl } = await cart.checkout({ returnUrl, cancelUrl });\n *   window.location.href = checkoutUrl;\n * }}>Checkout</button>\n * ```\n */\nexport function useCartSession(options: UseCartSessionOptions): UseCartSessionResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Stable client across renders for a given config; construction validates the\n  // token, so capture any constructor error instead of throwing during render.\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) setError(initError);\n  }, [initError]);\n\n  // Resume a persisted session on mount (and whenever the client identity changes).\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setLoading(true);\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n      })\n      .catch(() => {\n        // Expired / unknown / origin-rejected → drop the stale id and start fresh.\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /** Run a mutation that returns the updated cart, managing loading/error + creating the session first. */\n  const run = useCallback(\n    async (fn: () => Promise<Cart>, opts: { create?: boolean } = {}): Promise<void> => {\n      if (!client) {\n        setError(initError ?? new Error('CartSessionClient unavailable'));\n        return;\n      }\n      setLoading(true);\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const next = await fn();\n        setCart(next);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const addItem = useCallback(\n    (input: AddLineItemInput) => run(() => client!.addItem(input), { create: true }),\n    [client, run],\n  );\n  const updateItem = useCallback(\n    (itemId: string, input: UpdateLineItemInput) => run(() => client!.updateItem(itemId, input)),\n    [client, run],\n  );\n  const removeItem = useCallback((itemId: string) => run(() => client!.removeItem(itemId)), [client, run]);\n  const selectShipping = useCallback(\n    (input: SelectShippingInput) => run(() => client!.selectShipping(input), { create: true }),\n    [client, run],\n  );\n  const clearShipping = useCallback(() => run(() => client!.clearShipping()), [client, run]);\n  const applyDiscount = useCallback(\n    (code: string) => run(() => client!.applyDiscount(code), { create: true }),\n    [client, run],\n  );\n  const removeDiscount = useCallback(() => run(() => client!.removeDiscount()), [client, run]);\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    await run(async () => (await client.get()).cart);\n  }, [client, run]);\n\n  const checkout = useCallback(\n    async (input: CheckoutHandoffInput): Promise<CheckoutHandoff> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      setLoading(true);\n      setError(null);\n      try {\n        await ensureSession();\n        return await client.checkout(input);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    loading,\n    error,\n    addItem,\n    updateItem,\n    removeItem,\n    selectShipping,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    checkout,\n    refresh,\n    reset,\n  };\n}\n","import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  CartSessionClient,\n  CartNotOpenError,\n  CartNotFoundError,\n  type Cart,\n  type SelectedShipping,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\n/**\n * Lifecycle status for the checkout orchestration.\n * - `idle`       — no work in flight, no cart yet\n * - `loading`    — a request is in flight\n * - `recovering` — the cart went stale (converted/abandoned); rebuilding from the\n *                  last-known line items into a fresh session\n * - `ready`      — a cart is present and no request is in flight\n * - `error`      — the last operation failed (see `error`)\n */\nexport type ThrottleCheckoutStatus = 'idle' | 'loading' | 'recovering' | 'ready' | 'error';\n\nexport interface CheckoutTotals {\n  currency: string;\n  subtotal: number;\n  discountTotal: number;\n  shippingTotal: number;\n  taxTotal: number;\n  total: number;\n}\n\nexport interface UseThrottleCheckoutOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the cart session id across page loads.\n   * Default `'throttle.cartSessionId'`. Pass `null` to disable persistence.\n   */\n  storageKey?: string | null;\n  /**\n   * Auto-recover from a stale cart. When a mutation fails with\n   * {@link CartNotOpenError} (the cart was converted by a completed order, or\n   * abandoned), the hook starts a fresh session, re-adds the last-known line\n   * items and re-selects the shipping method, then retries the operation once.\n   * Default `true`. Set `false` to surface {@link CartNotOpenError} instead.\n   */\n  autoRecover?: boolean;\n}\n\nexport interface UseThrottleCheckoutResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current cart session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** Coarse lifecycle status — drive your UI off this rather than `cart === null`. */\n  status: ThrottleCheckoutStatus;\n  /** Last error, or null. */\n  error: Error | null;\n  /** The selected shipping method, bound to the cart (never a shadow copy). */\n  selectedMethod: SelectedShipping | null;\n  /** Live totals, bound to the cart. Null before a cart exists. */\n  totals: CheckoutTotals | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  /** Lock a shipping method. One call — the returned cart carries recomputed totals. */\n  selectMethod: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /**\n   * Hand off to checkout. Returns the hand-off — use `checkoutSessionId` with\n   * `<PaymentEmbed sessionId={…}>` (or redirect the buyer to `checkoutUrl`).\n   */\n  createSession: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\nfunction totalsOf(cart: Cart | null): CheckoutTotals | null {\n  if (!cart) return null;\n  return {\n    currency: cart.currency,\n    subtotal: cart.subtotal,\n    discountTotal: cart.discountTotal,\n    shippingTotal: cart.shippingTotal,\n    taxTotal: cart.taxTotal,\n    total: cart.total,\n  };\n}\n\n/**\n * Orchestrates a backend-less storefront checkout on top of\n * {@link CartSessionClient}, bundling the pieces every storefront otherwise\n * re-implements:\n *\n * - **Cart as source of truth** — `selectedMethod` and `totals` are read straight\n *   off the cart; there is no shadow copy to drift.\n * - **One-call shipping select** — `selectMethod` locks the method and returns the\n *   cart with recomputed totals in a single round trip.\n * - **Stale-cart recovery** — a {@link CartNotOpenError} (cart converted by a\n *   completed order, or abandoned) transparently rebuilds a fresh session from\n *   the last-known line items + shipping and retries (`status === 'recovering'`).\n * - **Session handoff** — `createSession` returns the `checkoutSessionId` for\n *   `<PaymentEmbed>`.\n *\n * Address collection is handled inside the checkout embed (the hosted/full\n * checkout collects shipping/billing), so this hook intentionally does not write\n * addresses to the cart.\n *\n * ```tsx\n * const { addItem, selectMethod, totals, createSession, status } =\n *   useThrottleCheckout({ applicationId, environmentId, quoteToken });\n * ```\n */\nexport function useThrottleCheckout(\n  options: UseThrottleCheckoutOptions,\n): UseThrottleCheckoutResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const autoRecover = options.autoRecover ?? true;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [status, setStatus] = useState<ThrottleCheckoutStatus>('idle');\n  const [error, setError] = useState<Error | null>(null);\n\n  // Keep the latest cart in a ref so recovery can read the last-known line items\n  // without threading it through every callback's dependency list.\n  const cartRef = useRef<Cart | null>(null);\n  cartRef.current = cart;\n\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) {\n      setError(initError);\n      setStatus('error');\n    }\n  }, [initError]);\n\n  // Resume a persisted session on mount.\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setStatus('loading');\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n        setStatus('ready');\n      })\n      .catch(() => {\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n        setStatus('idle');\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /**\n   * Rebuild a fresh session from the last-known cart so a stale cart doesn't\n   * strand the buyer. Re-adds line items and re-selects shipping, then returns\n   * the rebuilt cart.\n   */\n  const rebuild = useCallback(async (): Promise<Cart> => {\n    if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n    const prev = cartRef.current;\n    // Drop the stale session and create a new one.\n    client.resume('');\n    setCartSessionId(null);\n    const session = await client.create({\n      currency: prev?.currency,\n      netN: prev?.netN ?? undefined,\n    });\n    writeStored(storageKey, session.cartSessionId);\n    setCartSessionId(session.cartSessionId);\n    let next = session.cart;\n    for (const item of prev?.lineItems ?? []) {\n      next = await client.addItem({\n        type: item.type,\n        referenceId: item.referenceId ?? undefined,\n        name: item.name,\n        description: item.description ?? undefined,\n        unitPrice: item.unitPrice,\n        quantity: item.quantity,\n        imageUrl: item.imageUrl ?? undefined,\n        metadata: item.metadata,\n      });\n    }\n    const ship = prev?.selectedShipping;\n    if (ship) {\n      next = await client.selectShipping({\n        methodId: ship.methodId,\n        displayName: ship.displayName,\n        rateAmount: ship.rateAmount,\n        currency: ship.currency,\n        carrier: ship.carrier ?? undefined,\n        serviceCode: ship.serviceCode ?? undefined,\n        estimatedDeliveryDays: ship.estimatedDeliveryDays ?? undefined,\n      });\n    }\n    setCart(next);\n    return next;\n  }, [client, initError, storageKey]);\n\n  /**\n   * Run a cart op with loading/error bookkeeping. On a stale-cart error, rebuild\n   * (when `autoRecover`) and — for forward-progress ops (`retryAfterRecover`) —\n   * retry once against the rebuilt session. Item-id-specific ops set\n   * `retryAfterRecover: false` because the id no longer exists after rebuild.\n   */\n  const run = useCallback(\n    async <T,>(\n      fn: () => Promise<T>,\n      opts: { create?: boolean; retryAfterRecover?: boolean } = {},\n    ): Promise<T> => {\n      if (!client) {\n        const e = initError ?? new Error('CartSessionClient unavailable');\n        setError(e);\n        setStatus('error');\n        throw e;\n      }\n      setStatus('loading');\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const result = await fn();\n        setStatus('ready');\n        return result;\n      } catch (e) {\n        const stale = e instanceof CartNotOpenError || e instanceof CartNotFoundError;\n        if (stale && autoRecover) {\n          try {\n            setStatus('recovering');\n            await rebuild();\n            if (opts.retryAfterRecover) {\n              const retried = await fn();\n              setStatus('ready');\n              return retried;\n            }\n            // Rebuild-only: the original op targeted a now-gone id. Surface the\n            // rebuilt cart and let the caller reconcile against fresh state.\n            setStatus('ready');\n            const stale2 = new CartNotOpenError({\n              message: 'Cart was rebuilt after going stale; retry your action against the new cart.',\n            });\n            setError(stale2);\n            throw stale2;\n          } catch (recoverErr) {\n            setError(recoverErr as Error);\n            setStatus('error');\n            throw recoverErr;\n          }\n        }\n        setError(e as Error);\n        setStatus('error');\n        throw e;\n      }\n    },\n    [client, ensureSession, initError, autoRecover, rebuild],\n  );\n\n  const addItem = useCallback(\n    async (input: AddLineItemInput) => {\n      const next = await run(() => client!.addItem(input), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const updateItem = useCallback(\n    async (itemId: string, input: UpdateLineItemInput) => {\n      const next = await run(() => client!.updateItem(itemId, input), { retryAfterRecover: false });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const removeItem = useCallback(\n    async (itemId: string) => {\n      const next = await run(() => client!.removeItem(itemId), { retryAfterRecover: false });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const selectMethod = useCallback(\n    async (input: SelectShippingInput) => {\n      const next = await run(() => client!.selectShipping(input), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const clearShipping = useCallback(async () => {\n    const next = await run(() => client!.clearShipping(), { retryAfterRecover: true });\n    setCart(next);\n  }, [client, run]);\n  const applyDiscount = useCallback(\n    async (code: string) => {\n      const next = await run(() => client!.applyDiscount(code), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const removeDiscount = useCallback(async () => {\n    const next = await run(() => client!.removeDiscount(), { retryAfterRecover: true });\n    setCart(next);\n  }, [client, run]);\n\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    const next = await run(async () => (await client.get()).cart);\n    setCart(next);\n  }, [client, run]);\n\n  const createSession = useCallback(\n    (input: CheckoutHandoffInput): Promise<CheckoutHandoff> =>\n      run(() => client!.checkout(input), { create: true, retryAfterRecover: true }),\n    [client, run],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n    setStatus('idle');\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    status,\n    error,\n    selectedMethod: cart?.selectedShipping ?? null,\n    totals: totalsOf(cart),\n    addItem,\n    updateItem,\n    removeItem,\n    selectMethod,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    createSession,\n    refresh,\n    reset,\n  };\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_jsx_runtime","DEFAULT_BASE_URL","import_react","import_react","import_cart","DEFAULT_STORAGE_KEY","readStored","writeStored"]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CSSProperties, RefObject } from 'react';
-import { Cart, AddLineItemInput, UpdateLineItemInput, SelectShippingInput, CheckoutHandoffInput, CheckoutHandoff } from '@usethrottle/cart';
+import { Cart, AddLineItemInput, UpdateLineItemInput, SelectShippingInput, CheckoutHandoffInput, CheckoutHandoff, SelectedShipping } from '@usethrottle/cart';
 
 /**
  * Envelope every Throttle iframe message carries. Lets parents
@@ -233,4 +233,101 @@ interface UseCartSessionResult {
  */
 declare function useCartSession(options: UseCartSessionOptions): UseCartSessionResult;
 
-export { CheckoutEmbed, type CheckoutEmbedExtraProps, PaymentEmbed, type RecurringIntent, CheckoutEmbed as ThrottleCheckout, type ThrottleEmbedProps, type ThrottleEnvelope, type ThrottleEvent, type ThrottleMessage, type ThrottleParentCommand, type ThrottleParentEnvelope, type ThrottleParentMessage, type UseCartSessionOptions, type UseCartSessionResult, useCartSession, useThrottleEvents };
+/**
+ * Lifecycle status for the checkout orchestration.
+ * - `idle`       — no work in flight, no cart yet
+ * - `loading`    — a request is in flight
+ * - `recovering` — the cart went stale (converted/abandoned); rebuilding from the
+ *                  last-known line items into a fresh session
+ * - `ready`      — a cart is present and no request is in flight
+ * - `error`      — the last operation failed (see `error`)
+ */
+type ThrottleCheckoutStatus = 'idle' | 'loading' | 'recovering' | 'ready' | 'error';
+interface CheckoutTotals {
+    currency: string;
+    subtotal: number;
+    discountTotal: number;
+    shippingTotal: number;
+    taxTotal: number;
+    total: number;
+}
+interface UseThrottleCheckoutOptions {
+    /** Application UUID. */
+    applicationId: string;
+    /** Workspace environment UUID the publishable token was minted for. */
+    environmentId: string;
+    /** Publishable storefront quote token (`pk_…`). */
+    quoteToken: string;
+    baseUrl?: string;
+    /**
+     * localStorage key for persisting the cart session id across page loads.
+     * Default `'throttle.cartSessionId'`. Pass `null` to disable persistence.
+     */
+    storageKey?: string | null;
+    /**
+     * Auto-recover from a stale cart. When a mutation fails with
+     * {@link CartNotOpenError} (the cart was converted by a completed order, or
+     * abandoned), the hook starts a fresh session, re-adds the last-known line
+     * items and re-selects the shipping method, then retries the operation once.
+     * Default `true`. Set `false` to surface {@link CartNotOpenError} instead.
+     */
+    autoRecover?: boolean;
+}
+interface UseThrottleCheckoutResult {
+    /** Current cart snapshot, or null before the first item / resume. */
+    cart: Cart | null;
+    /** Current cart session id, or null before the first item. */
+    cartSessionId: string | null;
+    /** Coarse lifecycle status — drive your UI off this rather than `cart === null`. */
+    status: ThrottleCheckoutStatus;
+    /** Last error, or null. */
+    error: Error | null;
+    /** The selected shipping method, bound to the cart (never a shadow copy). */
+    selectedMethod: SelectedShipping | null;
+    /** Live totals, bound to the cart. Null before a cart exists. */
+    totals: CheckoutTotals | null;
+    addItem: (input: AddLineItemInput) => Promise<void>;
+    updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;
+    removeItem: (itemId: string) => Promise<void>;
+    /** Lock a shipping method. One call — the returned cart carries recomputed totals. */
+    selectMethod: (input: SelectShippingInput) => Promise<void>;
+    clearShipping: () => Promise<void>;
+    applyDiscount: (code: string) => Promise<void>;
+    removeDiscount: () => Promise<void>;
+    /**
+     * Hand off to checkout. Returns the hand-off — use `checkoutSessionId` with
+     * `<PaymentEmbed sessionId={…}>` (or redirect the buyer to `checkoutUrl`).
+     */
+    createSession: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;
+    /** Re-fetch the current cart. */
+    refresh: () => Promise<void>;
+    /** Forget the current session (a new cart is created on the next item). */
+    reset: () => void;
+}
+/**
+ * Orchestrates a backend-less storefront checkout on top of
+ * {@link CartSessionClient}, bundling the pieces every storefront otherwise
+ * re-implements:
+ *
+ * - **Cart as source of truth** — `selectedMethod` and `totals` are read straight
+ *   off the cart; there is no shadow copy to drift.
+ * - **One-call shipping select** — `selectMethod` locks the method and returns the
+ *   cart with recomputed totals in a single round trip.
+ * - **Stale-cart recovery** — a {@link CartNotOpenError} (cart converted by a
+ *   completed order, or abandoned) transparently rebuilds a fresh session from
+ *   the last-known line items + shipping and retries (`status === 'recovering'`).
+ * - **Session handoff** — `createSession` returns the `checkoutSessionId` for
+ *   `<PaymentEmbed>`.
+ *
+ * Address collection is handled inside the checkout embed (the hosted/full
+ * checkout collects shipping/billing), so this hook intentionally does not write
+ * addresses to the cart.
+ *
+ * ```tsx
+ * const { addItem, selectMethod, totals, createSession, status } =
+ *   useThrottleCheckout({ applicationId, environmentId, quoteToken });
+ * ```
+ */
+declare function useThrottleCheckout(options: UseThrottleCheckoutOptions): UseThrottleCheckoutResult;
+
+export { CheckoutEmbed, type CheckoutEmbedExtraProps, type CheckoutTotals, PaymentEmbed, type RecurringIntent, CheckoutEmbed as ThrottleCheckout, type ThrottleCheckoutStatus, type ThrottleEmbedProps, type ThrottleEnvelope, type ThrottleEvent, type ThrottleMessage, type ThrottleParentCommand, type ThrottleParentEnvelope, type ThrottleParentMessage, type UseCartSessionOptions, type UseCartSessionResult, type UseThrottleCheckoutOptions, type UseThrottleCheckoutResult, useCartSession, useThrottleCheckout, useThrottleEvents };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CSSProperties, RefObject } from 'react';
-import { Cart, AddLineItemInput, UpdateLineItemInput, SelectShippingInput, CheckoutHandoffInput, CheckoutHandoff } from '@usethrottle/cart';
+import { Cart, AddLineItemInput, UpdateLineItemInput, SelectShippingInput, CheckoutHandoffInput, CheckoutHandoff, SelectedShipping } from '@usethrottle/cart';
 
 /**
  * Envelope every Throttle iframe message carries. Lets parents
@@ -233,4 +233,101 @@ interface UseCartSessionResult {
  */
 declare function useCartSession(options: UseCartSessionOptions): UseCartSessionResult;
 
-export { CheckoutEmbed, type CheckoutEmbedExtraProps, PaymentEmbed, type RecurringIntent, CheckoutEmbed as ThrottleCheckout, type ThrottleEmbedProps, type ThrottleEnvelope, type ThrottleEvent, type ThrottleMessage, type ThrottleParentCommand, type ThrottleParentEnvelope, type ThrottleParentMessage, type UseCartSessionOptions, type UseCartSessionResult, useCartSession, useThrottleEvents };
+/**
+ * Lifecycle status for the checkout orchestration.
+ * - `idle`       — no work in flight, no cart yet
+ * - `loading`    — a request is in flight
+ * - `recovering` — the cart went stale (converted/abandoned); rebuilding from the
+ *                  last-known line items into a fresh session
+ * - `ready`      — a cart is present and no request is in flight
+ * - `error`      — the last operation failed (see `error`)
+ */
+type ThrottleCheckoutStatus = 'idle' | 'loading' | 'recovering' | 'ready' | 'error';
+interface CheckoutTotals {
+    currency: string;
+    subtotal: number;
+    discountTotal: number;
+    shippingTotal: number;
+    taxTotal: number;
+    total: number;
+}
+interface UseThrottleCheckoutOptions {
+    /** Application UUID. */
+    applicationId: string;
+    /** Workspace environment UUID the publishable token was minted for. */
+    environmentId: string;
+    /** Publishable storefront quote token (`pk_…`). */
+    quoteToken: string;
+    baseUrl?: string;
+    /**
+     * localStorage key for persisting the cart session id across page loads.
+     * Default `'throttle.cartSessionId'`. Pass `null` to disable persistence.
+     */
+    storageKey?: string | null;
+    /**
+     * Auto-recover from a stale cart. When a mutation fails with
+     * {@link CartNotOpenError} (the cart was converted by a completed order, or
+     * abandoned), the hook starts a fresh session, re-adds the last-known line
+     * items and re-selects the shipping method, then retries the operation once.
+     * Default `true`. Set `false` to surface {@link CartNotOpenError} instead.
+     */
+    autoRecover?: boolean;
+}
+interface UseThrottleCheckoutResult {
+    /** Current cart snapshot, or null before the first item / resume. */
+    cart: Cart | null;
+    /** Current cart session id, or null before the first item. */
+    cartSessionId: string | null;
+    /** Coarse lifecycle status — drive your UI off this rather than `cart === null`. */
+    status: ThrottleCheckoutStatus;
+    /** Last error, or null. */
+    error: Error | null;
+    /** The selected shipping method, bound to the cart (never a shadow copy). */
+    selectedMethod: SelectedShipping | null;
+    /** Live totals, bound to the cart. Null before a cart exists. */
+    totals: CheckoutTotals | null;
+    addItem: (input: AddLineItemInput) => Promise<void>;
+    updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;
+    removeItem: (itemId: string) => Promise<void>;
+    /** Lock a shipping method. One call — the returned cart carries recomputed totals. */
+    selectMethod: (input: SelectShippingInput) => Promise<void>;
+    clearShipping: () => Promise<void>;
+    applyDiscount: (code: string) => Promise<void>;
+    removeDiscount: () => Promise<void>;
+    /**
+     * Hand off to checkout. Returns the hand-off — use `checkoutSessionId` with
+     * `<PaymentEmbed sessionId={…}>` (or redirect the buyer to `checkoutUrl`).
+     */
+    createSession: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;
+    /** Re-fetch the current cart. */
+    refresh: () => Promise<void>;
+    /** Forget the current session (a new cart is created on the next item). */
+    reset: () => void;
+}
+/**
+ * Orchestrates a backend-less storefront checkout on top of
+ * {@link CartSessionClient}, bundling the pieces every storefront otherwise
+ * re-implements:
+ *
+ * - **Cart as source of truth** — `selectedMethod` and `totals` are read straight
+ *   off the cart; there is no shadow copy to drift.
+ * - **One-call shipping select** — `selectMethod` locks the method and returns the
+ *   cart with recomputed totals in a single round trip.
+ * - **Stale-cart recovery** — a {@link CartNotOpenError} (cart converted by a
+ *   completed order, or abandoned) transparently rebuilds a fresh session from
+ *   the last-known line items + shipping and retries (`status === 'recovering'`).
+ * - **Session handoff** — `createSession` returns the `checkoutSessionId` for
+ *   `<PaymentEmbed>`.
+ *
+ * Address collection is handled inside the checkout embed (the hosted/full
+ * checkout collects shipping/billing), so this hook intentionally does not write
+ * addresses to the cart.
+ *
+ * ```tsx
+ * const { addItem, selectMethod, totals, createSession, status } =
+ *   useThrottleCheckout({ applicationId, environmentId, quoteToken });
+ * ```
+ */
+declare function useThrottleCheckout(options: UseThrottleCheckoutOptions): UseThrottleCheckoutResult;
+
+export { CheckoutEmbed, type CheckoutEmbedExtraProps, type CheckoutTotals, PaymentEmbed, type RecurringIntent, CheckoutEmbed as ThrottleCheckout, type ThrottleCheckoutStatus, type ThrottleEmbedProps, type ThrottleEnvelope, type ThrottleEvent, type ThrottleMessage, type ThrottleParentCommand, type ThrottleParentEnvelope, type ThrottleParentMessage, type UseCartSessionOptions, type UseCartSessionResult, type UseThrottleCheckoutOptions, type UseThrottleCheckoutResult, useCartSession, useThrottleCheckout, useThrottleEvents };

package/dist/index.js

@@ -366,11 +366,272 @@ function useCartSession(options) {
     reset
   };
 }
+
+// src/useThrottleCheckout.tsx
+import { useCallback as useCallback4, useEffect as useEffect4, useMemo as useMemo2, useRef as useRef3, useState as useState5 } from "react";
+import {
+  CartSessionClient as CartSessionClient2,
+  CartNotOpenError,
+  CartNotFoundError
+} from "@usethrottle/cart";
+var DEFAULT_STORAGE_KEY2 = "throttle.cartSessionId";
+function readStored2(key) {
+  if (!key || typeof window === "undefined") return null;
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function writeStored2(key, value) {
+  if (!key || typeof window === "undefined") return;
+  try {
+    if (value === null) window.localStorage.removeItem(key);
+    else window.localStorage.setItem(key, value);
+  } catch {
+  }
+}
+function totalsOf(cart) {
+  if (!cart) return null;
+  return {
+    currency: cart.currency,
+    subtotal: cart.subtotal,
+    discountTotal: cart.discountTotal,
+    shippingTotal: cart.shippingTotal,
+    taxTotal: cart.taxTotal,
+    total: cart.total
+  };
+}
+function useThrottleCheckout(options) {
+  const { applicationId, environmentId, quoteToken, baseUrl } = options;
+  const autoRecover = options.autoRecover ?? true;
+  const storageKey = options.storageKey === void 0 ? DEFAULT_STORAGE_KEY2 : options.storageKey;
+  const [cart, setCart] = useState5(null);
+  const [cartSessionId, setCartSessionId] = useState5(null);
+  const [status, setStatus] = useState5("idle");
+  const [error, setError] = useState5(null);
+  const cartRef = useRef3(null);
+  cartRef.current = cart;
+  const { client, initError } = useMemo2(() => {
+    try {
+      return {
+        client: new CartSessionClient2({ applicationId, environmentId, quoteToken, baseUrl }),
+        initError: null
+      };
+    } catch (e) {
+      return { client: null, initError: e };
+    }
+  }, [applicationId, environmentId, quoteToken, baseUrl]);
+  useEffect4(() => {
+    if (initError) {
+      setError(initError);
+      setStatus("error");
+    }
+  }, [initError]);
+  useEffect4(() => {
+    if (!client) return;
+    const saved = readStored2(storageKey);
+    if (!saved) return;
+    let cancelled = false;
+    client.resume(saved);
+    setCartSessionId(saved);
+    setStatus("loading");
+    client.get().then((s) => {
+      if (cancelled) return;
+      setCart(s.cart);
+      setStatus("ready");
+    }).catch(() => {
+      if (cancelled) return;
+      writeStored2(storageKey, null);
+      client.resume("");
+      setCartSessionId(null);
+      setCart(null);
+      setStatus("idle");
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, storageKey]);
+  const ensureSession = useCallback4(
+    async (input) => {
+      if (!client) throw initError ?? new Error("CartSessionClient unavailable");
+      if (client.cartSessionId) return;
+      const session = await client.create(input ?? {});
+      writeStored2(storageKey, session.cartSessionId);
+      setCartSessionId(session.cartSessionId);
+      setCart(session.cart);
+    },
+    [client, initError, storageKey]
+  );
+  const rebuild = useCallback4(async () => {
+    if (!client) throw initError ?? new Error("CartSessionClient unavailable");
+    const prev = cartRef.current;
+    client.resume("");
+    setCartSessionId(null);
+    const session = await client.create({
+      currency: prev?.currency,
+      netN: prev?.netN ?? void 0
+    });
+    writeStored2(storageKey, session.cartSessionId);
+    setCartSessionId(session.cartSessionId);
+    let next = session.cart;
+    for (const item of prev?.lineItems ?? []) {
+      next = await client.addItem({
+        type: item.type,
+        referenceId: item.referenceId ?? void 0,
+        name: item.name,
+        description: item.description ?? void 0,
+        unitPrice: item.unitPrice,
+        quantity: item.quantity,
+        imageUrl: item.imageUrl ?? void 0,
+        metadata: item.metadata
+      });
+    }
+    const ship = prev?.selectedShipping;
+    if (ship) {
+      next = await client.selectShipping({
+        methodId: ship.methodId,
+        displayName: ship.displayName,
+        rateAmount: ship.rateAmount,
+        currency: ship.currency,
+        carrier: ship.carrier ?? void 0,
+        serviceCode: ship.serviceCode ?? void 0,
+        estimatedDeliveryDays: ship.estimatedDeliveryDays ?? void 0
+      });
+    }
+    setCart(next);
+    return next;
+  }, [client, initError, storageKey]);
+  const run = useCallback4(
+    async (fn, opts = {}) => {
+      if (!client) {
+        const e = initError ?? new Error("CartSessionClient unavailable");
+        setError(e);
+        setStatus("error");
+        throw e;
+      }
+      setStatus("loading");
+      setError(null);
+      try {
+        if (opts.create) await ensureSession();
+        const result = await fn();
+        setStatus("ready");
+        return result;
+      } catch (e) {
+        const stale = e instanceof CartNotOpenError || e instanceof CartNotFoundError;
+        if (stale && autoRecover) {
+          try {
+            setStatus("recovering");
+            await rebuild();
+            if (opts.retryAfterRecover) {
+              const retried = await fn();
+              setStatus("ready");
+              return retried;
+            }
+            setStatus("ready");
+            const stale2 = new CartNotOpenError({
+              message: "Cart was rebuilt after going stale; retry your action against the new cart."
+            });
+            setError(stale2);
+            throw stale2;
+          } catch (recoverErr) {
+            setError(recoverErr);
+            setStatus("error");
+            throw recoverErr;
+          }
+        }
+        setError(e);
+        setStatus("error");
+        throw e;
+      }
+    },
+    [client, ensureSession, initError, autoRecover, rebuild]
+  );
+  const addItem = useCallback4(
+    async (input) => {
+      const next = await run(() => client.addItem(input), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const updateItem = useCallback4(
+    async (itemId, input) => {
+      const next = await run(() => client.updateItem(itemId, input), { retryAfterRecover: false });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const removeItem = useCallback4(
+    async (itemId) => {
+      const next = await run(() => client.removeItem(itemId), { retryAfterRecover: false });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const selectMethod = useCallback4(
+    async (input) => {
+      const next = await run(() => client.selectShipping(input), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const clearShipping = useCallback4(async () => {
+    const next = await run(() => client.clearShipping(), { retryAfterRecover: true });
+    setCart(next);
+  }, [client, run]);
+  const applyDiscount = useCallback4(
+    async (code) => {
+      const next = await run(() => client.applyDiscount(code), { create: true, retryAfterRecover: true });
+      setCart(next);
+    },
+    [client, run]
+  );
+  const removeDiscount = useCallback4(async () => {
+    const next = await run(() => client.removeDiscount(), { retryAfterRecover: true });
+    setCart(next);
+  }, [client, run]);
+  const refresh = useCallback4(async () => {
+    if (!client?.cartSessionId) return;
+    const next = await run(async () => (await client.get()).cart);
+    setCart(next);
+  }, [client, run]);
+  const createSession = useCallback4(
+    (input) => run(() => client.checkout(input), { create: true, retryAfterRecover: true }),
+    [client, run]
+  );
+  const reset = useCallback4(() => {
+    writeStored2(storageKey, null);
+    client?.resume("");
+    setCartSessionId(null);
+    setCart(null);
+    setError(null);
+    setStatus("idle");
+  }, [client, storageKey]);
+  return {
+    cart,
+    cartSessionId,
+    status,
+    error,
+    selectedMethod: cart?.selectedShipping ?? null,
+    totals: totalsOf(cart),
+    addItem,
+    updateItem,
+    removeItem,
+    selectMethod,
+    clearShipping,
+    applyDiscount,
+    removeDiscount,
+    createSession,
+    refresh,
+    reset
+  };
+}
 export {
   CheckoutEmbed,
   PaymentEmbed,
   CheckoutEmbed as ThrottleCheckout,
   useCartSession,
+  useThrottleCheckout,
   useThrottleEvents
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/CheckoutEmbed.tsx","../src/useThrottleEvents.ts","../src/useParentCommands.ts","../src/PaymentEmbed.tsx","../src/useCartSession.tsx"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type {\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  ThrottleMessage,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Full-checkout iframe embed. Renders the entire Throttle hosted\n * checkout (address / shipping / payment) inside an iframe and\n * surfaces lifecycle + terminal events through callbacks. The\n * iframe auto-resizes on `throttle.resize` events.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list\n * (`throttle embed-config set --origins ...`). Mismatches render\n * an in-iframe \"Embed not authorized\" panel.\n */\nexport function CheckoutEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 600,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n  onStepChanged,\n}: ThrottleEmbedProps & CheckoutEmbedExtraProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.step.changed':\n          onStepChanged?.({ step: msg.step });\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled, onStepChanged],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'checkout-full', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle checkout\"\n    />\n  );\n}\n","import { useEffect, type RefObject } from 'react';\nimport type { ThrottleMessage } from './types.js';\n\nexport interface UseThrottleEventsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /**\n   * The Throttle origin (e.g. https://checkout.usethrottle.dev).\n   * Strict-equals check against `MessageEvent.origin`. Anything else\n   * is silently dropped.\n   */\n  expectedOrigin: string;\n  onMessage: (msg: ThrottleMessage) => void;\n}\n\n/**\n * Subscribe to validated postMessage events from a Throttle iframe.\n *\n * Validation:\n *  - event.origin === expectedOrigin (strict string match)\n *  - event.source === iframeRef.current.contentWindow (defends against\n *    other iframes on the same origin spoofing events)\n *  - event.data.source === 'throttle' && event.data.version === 1\n *  - event.data.type starts with 'throttle.'\n *\n * Anything failing validation is silently dropped — the parent page\n * may receive postMessages from analytics SDKs, browser extensions,\n * other iframes, etc. We must never throw on those.\n */\nexport function useThrottleEvents({ iframeRef, expectedOrigin, onMessage }: UseThrottleEventsOptions) {\n  useEffect(() => {\n    function handle(ev: MessageEvent) {\n      if (ev.origin !== expectedOrigin) return;\n      if (iframeRef.current && ev.source !== iframeRef.current.contentWindow) return;\n      const data = ev.data as Partial<ThrottleMessage> | null | undefined;\n      if (!data || typeof data !== 'object') return;\n      if (data.source !== 'throttle' || data.version !== 1) return;\n      if (typeof data.type !== 'string' || !data.type.startsWith('throttle.')) return;\n      onMessage(data as ThrottleMessage);\n    }\n    window.addEventListener('message', handle);\n    return () => window.removeEventListener('message', handle);\n  }, [iframeRef, expectedOrigin, onMessage]);\n}\n","import { useEffect, useState, type RefObject } from 'react';\nimport type { ThrottleParentMessage } from './types.js';\n\ninterface UseParentCommandsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /** The Throttle origin to address messages to. */\n  targetOrigin: string;\n  /**\n   * The current value of `submitDisabled` from the embed props. Posts a\n   * `set-submit-disabled` parent command whenever it changes — and once\n   * after the iframe reports `throttle.ready` so the iframe sees the\n   * intent even if it boots after the prop is already set.\n   *\n   * `undefined` means the parent never explicitly enabled/disabled — we\n   * never post in that case. Backward-compat with embeds that don't\n   * pass the prop.\n   */\n  submitDisabled?: boolean;\n  /**\n   * Set to `true` once the iframe posts `throttle.ready`. Until then,\n   * commands are buffered (we still try to post but the iframe may not\n   * have its listener attached yet — and we re-post on ready as a\n   * belt-and-braces guard).\n   */\n  iframeReady: boolean;\n}\n\n/**\n * Post parent → iframe commands when controlled props change. v1.2 adds\n * `set-submit-disabled`; future commands extend the same channel.\n *\n * postMessage is fire-and-forget — we don't wait for an ack from the\n * iframe. The iframe's listener is idempotent (setting the same value\n * twice is a no-op).\n */\nexport function useParentCommands({\n  iframeRef,\n  targetOrigin,\n  submitDisabled,\n  iframeReady,\n}: UseParentCommandsOptions) {\n  const [lastSent, setLastSent] = useState<boolean | undefined>(undefined);\n\n  // Post when the prop value changes OR when the iframe transitions to\n  // ready (so the first state lands).\n  useEffect(() => {\n    if (submitDisabled === undefined) return;\n    const win = iframeRef.current?.contentWindow;\n    if (!win) return;\n    // Skip if we already sent this value AND the iframe was already ready\n    // — avoids spam on unrelated re-renders.\n    if (lastSent === submitDisabled && iframeReady) return;\n    if (!iframeReady) return; // Defer until ready\n\n    const message: ThrottleParentMessage = {\n      source: 'throttle-parent',\n      version: 1,\n      type: 'set-submit-disabled',\n      disabled: submitDisabled,\n    };\n    win.postMessage(message, targetOrigin);\n    setLastSent(submitDisabled);\n  }, [iframeRef, targetOrigin, submitDisabled, iframeReady, lastSent]);\n}\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type { ThrottleEmbedProps, ThrottleMessage } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Payment-only iframe embed. Renders just the Gr4vy provider iframe\n * (no address / shipping / cart UI). Email is collected by the Gr4vy\n * iframe in proxy-mode sessions. Used when the merchant has built\n * their own checkout UI and only needs Throttle to handle payment\n * authorization + capture.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list.\n * The iframe auto-resizes on `throttle.resize` events.\n */\nexport function PaymentEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 480,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n}: ThrottleEmbedProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'payment-only', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle payment\"\n    />\n  );\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport {\n  CartSessionClient,\n  type Cart,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\nexport interface UseCartSessionOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the session id across page loads. Default\n   * `'throttle.cartSessionId'`. Pass `null` to disable persistence (in-memory\n   * only).\n   */\n  storageKey?: string | null;\n}\n\nexport interface UseCartSessionResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current opaque session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** True while a request is in flight. */\n  loading: boolean;\n  /** Last error, or null. */\n  error: Error | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  selectShipping: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /** Hand off to checkout. Returns the hand-off (redirect the buyer to `checkoutUrl`). */\n  checkout: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\n/**\n * React hook for backend-less cart ownership. Wraps {@link CartSessionClient}:\n * creates the Throttle cart lazily on the first `addItem` (so empty carts\n * aren't created on every page load), persists the session id to localStorage,\n * and resumes it on the next visit. Mutations update reactive `cart` state.\n *\n * ```tsx\n * const cart = useCartSession({ applicationId, environmentId, quoteToken });\n * <button onClick={() => cart.addItem({ name: 'Widget', unitPrice: 2999, quantity: 1 })}>Add</button>\n * <button onClick={async () => {\n *   const { checkoutUrl } = await cart.checkout({ returnUrl, cancelUrl });\n *   window.location.href = checkoutUrl;\n * }}>Checkout</button>\n * ```\n */\nexport function useCartSession(options: UseCartSessionOptions): UseCartSessionResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Stable client across renders for a given config; construction validates the\n  // token, so capture any constructor error instead of throwing during render.\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) setError(initError);\n  }, [initError]);\n\n  // Resume a persisted session on mount (and whenever the client identity changes).\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setLoading(true);\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n      })\n      .catch(() => {\n        // Expired / unknown / origin-rejected → drop the stale id and start fresh.\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /** Run a mutation that returns the updated cart, managing loading/error + creating the session first. */\n  const run = useCallback(\n    async (fn: () => Promise<Cart>, opts: { create?: boolean } = {}): Promise<void> => {\n      if (!client) {\n        setError(initError ?? new Error('CartSessionClient unavailable'));\n        return;\n      }\n      setLoading(true);\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const next = await fn();\n        setCart(next);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const addItem = useCallback(\n    (input: AddLineItemInput) => run(() => client!.addItem(input), { create: true }),\n    [client, run],\n  );\n  const updateItem = useCallback(\n    (itemId: string, input: UpdateLineItemInput) => run(() => client!.updateItem(itemId, input)),\n    [client, run],\n  );\n  const removeItem = useCallback((itemId: string) => run(() => client!.removeItem(itemId)), [client, run]);\n  const selectShipping = useCallback(\n    (input: SelectShippingInput) => run(() => client!.selectShipping(input), { create: true }),\n    [client, run],\n  );\n  const clearShipping = useCallback(() => run(() => client!.clearShipping()), [client, run]);\n  const applyDiscount = useCallback(\n    (code: string) => run(() => client!.applyDiscount(code), { create: true }),\n    [client, run],\n  );\n  const removeDiscount = useCallback(() => run(() => client!.removeDiscount()), [client, run]);\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    await run(async () => (await client.get()).cart);\n  }, [client, run]);\n\n  const checkout = useCallback(\n    async (input: CheckoutHandoffInput): Promise<CheckoutHandoff> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      setLoading(true);\n      setError(null);\n      try {\n        await ensureSession();\n        return await client.checkout(input);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    loading,\n    error,\n    addItem,\n    updateItem,\n    removeItem,\n    selectShipping,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    checkout,\n    refresh,\n    reset,\n  };\n}\n"],"mappings":"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","names":["useState","useEffect","useState","useCallback","useRef","useState","jsx","DEFAULT_BASE_URL","useRef","useState","useCallback","useCallback","useEffect","useState"]}
+{"version":3,"sources":["../src/CheckoutEmbed.tsx","../src/useThrottleEvents.ts","../src/useParentCommands.ts","../src/PaymentEmbed.tsx","../src/useCartSession.tsx","../src/useThrottleCheckout.tsx"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type {\n  ThrottleEmbedProps,\n  CheckoutEmbedExtraProps,\n  ThrottleMessage,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Full-checkout iframe embed. Renders the entire Throttle hosted\n * checkout (address / shipping / payment) inside an iframe and\n * surfaces lifecycle + terminal events through callbacks. The\n * iframe auto-resizes on `throttle.resize` events.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list\n * (`throttle embed-config set --origins ...`). Mismatches render\n * an in-iframe \"Embed not authorized\" panel.\n */\nexport function CheckoutEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 600,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n  onStepChanged,\n}: ThrottleEmbedProps & CheckoutEmbedExtraProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.step.changed':\n          onStepChanged?.({ step: msg.step });\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled, onStepChanged],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'checkout-full', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle checkout\"\n    />\n  );\n}\n","import { useEffect, type RefObject } from 'react';\nimport type { ThrottleMessage } from './types.js';\n\nexport interface UseThrottleEventsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /**\n   * The Throttle origin (e.g. https://checkout.usethrottle.dev).\n   * Strict-equals check against `MessageEvent.origin`. Anything else\n   * is silently dropped.\n   */\n  expectedOrigin: string;\n  onMessage: (msg: ThrottleMessage) => void;\n}\n\n/**\n * Subscribe to validated postMessage events from a Throttle iframe.\n *\n * Validation:\n *  - event.origin === expectedOrigin (strict string match)\n *  - event.source === iframeRef.current.contentWindow (defends against\n *    other iframes on the same origin spoofing events)\n *  - event.data.source === 'throttle' && event.data.version === 1\n *  - event.data.type starts with 'throttle.'\n *\n * Anything failing validation is silently dropped — the parent page\n * may receive postMessages from analytics SDKs, browser extensions,\n * other iframes, etc. We must never throw on those.\n */\nexport function useThrottleEvents({ iframeRef, expectedOrigin, onMessage }: UseThrottleEventsOptions) {\n  useEffect(() => {\n    function handle(ev: MessageEvent) {\n      if (ev.origin !== expectedOrigin) return;\n      if (iframeRef.current && ev.source !== iframeRef.current.contentWindow) return;\n      const data = ev.data as Partial<ThrottleMessage> | null | undefined;\n      if (!data || typeof data !== 'object') return;\n      if (data.source !== 'throttle' || data.version !== 1) return;\n      if (typeof data.type !== 'string' || !data.type.startsWith('throttle.')) return;\n      onMessage(data as ThrottleMessage);\n    }\n    window.addEventListener('message', handle);\n    return () => window.removeEventListener('message', handle);\n  }, [iframeRef, expectedOrigin, onMessage]);\n}\n","import { useEffect, useState, type RefObject } from 'react';\nimport type { ThrottleParentMessage } from './types.js';\n\ninterface UseParentCommandsOptions {\n  iframeRef: RefObject<HTMLIFrameElement | null>;\n  /** The Throttle origin to address messages to. */\n  targetOrigin: string;\n  /**\n   * The current value of `submitDisabled` from the embed props. Posts a\n   * `set-submit-disabled` parent command whenever it changes — and once\n   * after the iframe reports `throttle.ready` so the iframe sees the\n   * intent even if it boots after the prop is already set.\n   *\n   * `undefined` means the parent never explicitly enabled/disabled — we\n   * never post in that case. Backward-compat with embeds that don't\n   * pass the prop.\n   */\n  submitDisabled?: boolean;\n  /**\n   * Set to `true` once the iframe posts `throttle.ready`. Until then,\n   * commands are buffered (we still try to post but the iframe may not\n   * have its listener attached yet — and we re-post on ready as a\n   * belt-and-braces guard).\n   */\n  iframeReady: boolean;\n}\n\n/**\n * Post parent → iframe commands when controlled props change. v1.2 adds\n * `set-submit-disabled`; future commands extend the same channel.\n *\n * postMessage is fire-and-forget — we don't wait for an ack from the\n * iframe. The iframe's listener is idempotent (setting the same value\n * twice is a no-op).\n */\nexport function useParentCommands({\n  iframeRef,\n  targetOrigin,\n  submitDisabled,\n  iframeReady,\n}: UseParentCommandsOptions) {\n  const [lastSent, setLastSent] = useState<boolean | undefined>(undefined);\n\n  // Post when the prop value changes OR when the iframe transitions to\n  // ready (so the first state lands).\n  useEffect(() => {\n    if (submitDisabled === undefined) return;\n    const win = iframeRef.current?.contentWindow;\n    if (!win) return;\n    // Skip if we already sent this value AND the iframe was already ready\n    // — avoids spam on unrelated re-renders.\n    if (lastSent === submitDisabled && iframeReady) return;\n    if (!iframeReady) return; // Defer until ready\n\n    const message: ThrottleParentMessage = {\n      source: 'throttle-parent',\n      version: 1,\n      type: 'set-submit-disabled',\n      disabled: submitDisabled,\n    };\n    win.postMessage(message, targetOrigin);\n    setLastSent(submitDisabled);\n  }, [iframeRef, targetOrigin, submitDisabled, iframeReady, lastSent]);\n}\n","import { useCallback, useRef, useState } from 'react';\nimport { useThrottleEvents } from './useThrottleEvents.js';\nimport { useParentCommands } from './useParentCommands.js';\nimport type { ThrottleEmbedProps, ThrottleMessage } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://checkout.usethrottle.dev';\n\n/**\n * Payment-only iframe embed. Renders just the Gr4vy provider iframe\n * (no address / shipping / cart UI). Email is collected by the Gr4vy\n * iframe in proxy-mode sessions. Used when the merchant has built\n * their own checkout UI and only needs Throttle to handle payment\n * authorization + capture.\n *\n * `parentOrigin` must match an entry in the merchant's allow-list.\n * The iframe auto-resizes on `throttle.resize` events.\n */\nexport function PaymentEmbed({\n  sessionId,\n  parentOrigin,\n  baseUrl = DEFAULT_BASE_URL,\n  primary,\n  logo,\n  initialHeight = 480,\n  className,\n  style,\n  submitDisabled,\n  onReady,\n  onProcessing,\n  onSucceeded,\n  onFailed,\n  onCanceled,\n}: ThrottleEmbedProps) {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const expectedOrigin = new URL(baseUrl).origin;\n  const [iframeReady, setIframeReady] = useState(false);\n\n  const dispatch = useCallback(\n    (msg: ThrottleMessage) => {\n      switch (msg.type) {\n        case 'throttle.ready':\n          setIframeReady(true);\n          onReady?.();\n          break;\n        case 'throttle.processing':\n          onProcessing?.();\n          break;\n        case 'throttle.completed':\n          onSucceeded?.({\n            orderId: msg.orderId,\n            paymentId: msg.paymentId,\n            ...(msg.subscriptionId !== undefined ? { subscriptionId: msg.subscriptionId } : {}),\n          });\n          break;\n        case 'throttle.error':\n          onFailed?.({ code: msg.code, message: msg.message });\n          break;\n        case 'throttle.cancelled':\n          onCanceled?.();\n          break;\n        case 'throttle.resize':\n          if (iframeRef.current) iframeRef.current.style.height = `${msg.height}px`;\n          break;\n      }\n    },\n    [onReady, onProcessing, onSucceeded, onFailed, onCanceled],\n  );\n\n  useThrottleEvents({ iframeRef, expectedOrigin, onMessage: dispatch });\n  useParentCommands({\n    iframeRef,\n    targetOrigin: expectedOrigin,\n    submitDisabled,\n    iframeReady,\n  });\n\n  const params = new URLSearchParams({ embed: '1', mode: 'payment-only', parentOrigin });\n  if (primary) params.set('primary', primary);\n  if (logo) params.set('logo', logo);\n  const cleanBase = baseUrl.replace(/\\/$/, '');\n  const src = `${cleanBase}/c/${encodeURIComponent(sessionId)}?${params.toString()}`;\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={src}\n      className={className}\n      style={{ border: 0, width: '100%', minHeight: initialHeight, ...style }}\n      allow=\"payment *\"\n      title=\"Throttle payment\"\n    />\n  );\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport {\n  CartSessionClient,\n  type Cart,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\nexport interface UseCartSessionOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the session id across page loads. Default\n   * `'throttle.cartSessionId'`. Pass `null` to disable persistence (in-memory\n   * only).\n   */\n  storageKey?: string | null;\n}\n\nexport interface UseCartSessionResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current opaque session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** True while a request is in flight. */\n  loading: boolean;\n  /** Last error, or null. */\n  error: Error | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  selectShipping: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /** Hand off to checkout. Returns the hand-off (redirect the buyer to `checkoutUrl`). */\n  checkout: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\n/**\n * React hook for backend-less cart ownership. Wraps {@link CartSessionClient}:\n * creates the Throttle cart lazily on the first `addItem` (so empty carts\n * aren't created on every page load), persists the session id to localStorage,\n * and resumes it on the next visit. Mutations update reactive `cart` state.\n *\n * ```tsx\n * const cart = useCartSession({ applicationId, environmentId, quoteToken });\n * <button onClick={() => cart.addItem({ name: 'Widget', unitPrice: 2999, quantity: 1 })}>Add</button>\n * <button onClick={async () => {\n *   const { checkoutUrl } = await cart.checkout({ returnUrl, cancelUrl });\n *   window.location.href = checkoutUrl;\n * }}>Checkout</button>\n * ```\n */\nexport function useCartSession(options: UseCartSessionOptions): UseCartSessionResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // Stable client across renders for a given config; construction validates the\n  // token, so capture any constructor error instead of throwing during render.\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) setError(initError);\n  }, [initError]);\n\n  // Resume a persisted session on mount (and whenever the client identity changes).\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setLoading(true);\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n      })\n      .catch(() => {\n        // Expired / unknown / origin-rejected → drop the stale id and start fresh.\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /** Run a mutation that returns the updated cart, managing loading/error + creating the session first. */\n  const run = useCallback(\n    async (fn: () => Promise<Cart>, opts: { create?: boolean } = {}): Promise<void> => {\n      if (!client) {\n        setError(initError ?? new Error('CartSessionClient unavailable'));\n        return;\n      }\n      setLoading(true);\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const next = await fn();\n        setCart(next);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const addItem = useCallback(\n    (input: AddLineItemInput) => run(() => client!.addItem(input), { create: true }),\n    [client, run],\n  );\n  const updateItem = useCallback(\n    (itemId: string, input: UpdateLineItemInput) => run(() => client!.updateItem(itemId, input)),\n    [client, run],\n  );\n  const removeItem = useCallback((itemId: string) => run(() => client!.removeItem(itemId)), [client, run]);\n  const selectShipping = useCallback(\n    (input: SelectShippingInput) => run(() => client!.selectShipping(input), { create: true }),\n    [client, run],\n  );\n  const clearShipping = useCallback(() => run(() => client!.clearShipping()), [client, run]);\n  const applyDiscount = useCallback(\n    (code: string) => run(() => client!.applyDiscount(code), { create: true }),\n    [client, run],\n  );\n  const removeDiscount = useCallback(() => run(() => client!.removeDiscount()), [client, run]);\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    await run(async () => (await client.get()).cart);\n  }, [client, run]);\n\n  const checkout = useCallback(\n    async (input: CheckoutHandoffInput): Promise<CheckoutHandoff> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      setLoading(true);\n      setError(null);\n      try {\n        await ensureSession();\n        return await client.checkout(input);\n      } catch (e) {\n        setError(e as Error);\n        throw e;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [client, ensureSession, initError],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    loading,\n    error,\n    addItem,\n    updateItem,\n    removeItem,\n    selectShipping,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    checkout,\n    refresh,\n    reset,\n  };\n}\n","import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  CartSessionClient,\n  CartNotOpenError,\n  CartNotFoundError,\n  type Cart,\n  type SelectedShipping,\n  type AddLineItemInput,\n  type UpdateLineItemInput,\n  type SelectShippingInput,\n  type CreateCartSessionInput,\n  type CheckoutHandoffInput,\n  type CheckoutHandoff,\n} from '@usethrottle/cart';\n\nconst DEFAULT_STORAGE_KEY = 'throttle.cartSessionId';\n\n/**\n * Lifecycle status for the checkout orchestration.\n * - `idle`       — no work in flight, no cart yet\n * - `loading`    — a request is in flight\n * - `recovering` — the cart went stale (converted/abandoned); rebuilding from the\n *                  last-known line items into a fresh session\n * - `ready`      — a cart is present and no request is in flight\n * - `error`      — the last operation failed (see `error`)\n */\nexport type ThrottleCheckoutStatus = 'idle' | 'loading' | 'recovering' | 'ready' | 'error';\n\nexport interface CheckoutTotals {\n  currency: string;\n  subtotal: number;\n  discountTotal: number;\n  shippingTotal: number;\n  taxTotal: number;\n  total: number;\n}\n\nexport interface UseThrottleCheckoutOptions {\n  /** Application UUID. */\n  applicationId: string;\n  /** Workspace environment UUID the publishable token was minted for. */\n  environmentId: string;\n  /** Publishable storefront quote token (`pk_…`). */\n  quoteToken: string;\n  baseUrl?: string;\n  /**\n   * localStorage key for persisting the cart session id across page loads.\n   * Default `'throttle.cartSessionId'`. Pass `null` to disable persistence.\n   */\n  storageKey?: string | null;\n  /**\n   * Auto-recover from a stale cart. When a mutation fails with\n   * {@link CartNotOpenError} (the cart was converted by a completed order, or\n   * abandoned), the hook starts a fresh session, re-adds the last-known line\n   * items and re-selects the shipping method, then retries the operation once.\n   * Default `true`. Set `false` to surface {@link CartNotOpenError} instead.\n   */\n  autoRecover?: boolean;\n}\n\nexport interface UseThrottleCheckoutResult {\n  /** Current cart snapshot, or null before the first item / resume. */\n  cart: Cart | null;\n  /** Current cart session id, or null before the first item. */\n  cartSessionId: string | null;\n  /** Coarse lifecycle status — drive your UI off this rather than `cart === null`. */\n  status: ThrottleCheckoutStatus;\n  /** Last error, or null. */\n  error: Error | null;\n  /** The selected shipping method, bound to the cart (never a shadow copy). */\n  selectedMethod: SelectedShipping | null;\n  /** Live totals, bound to the cart. Null before a cart exists. */\n  totals: CheckoutTotals | null;\n  addItem: (input: AddLineItemInput) => Promise<void>;\n  updateItem: (itemId: string, input: UpdateLineItemInput) => Promise<void>;\n  removeItem: (itemId: string) => Promise<void>;\n  /** Lock a shipping method. One call — the returned cart carries recomputed totals. */\n  selectMethod: (input: SelectShippingInput) => Promise<void>;\n  clearShipping: () => Promise<void>;\n  applyDiscount: (code: string) => Promise<void>;\n  removeDiscount: () => Promise<void>;\n  /**\n   * Hand off to checkout. Returns the hand-off — use `checkoutSessionId` with\n   * `<PaymentEmbed sessionId={…}>` (or redirect the buyer to `checkoutUrl`).\n   */\n  createSession: (input: CheckoutHandoffInput) => Promise<CheckoutHandoff>;\n  /** Re-fetch the current cart. */\n  refresh: () => Promise<void>;\n  /** Forget the current session (a new cart is created on the next item). */\n  reset: () => void;\n}\n\nfunction readStored(key: string | null | undefined): string | null {\n  if (!key || typeof window === 'undefined') return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeStored(key: string | null | undefined, value: string | null): void {\n  if (!key || typeof window === 'undefined') return;\n  try {\n    if (value === null) window.localStorage.removeItem(key);\n    else window.localStorage.setItem(key, value);\n  } catch {\n    /* ignore quota / privacy-mode errors */\n  }\n}\n\nfunction totalsOf(cart: Cart | null): CheckoutTotals | null {\n  if (!cart) return null;\n  return {\n    currency: cart.currency,\n    subtotal: cart.subtotal,\n    discountTotal: cart.discountTotal,\n    shippingTotal: cart.shippingTotal,\n    taxTotal: cart.taxTotal,\n    total: cart.total,\n  };\n}\n\n/**\n * Orchestrates a backend-less storefront checkout on top of\n * {@link CartSessionClient}, bundling the pieces every storefront otherwise\n * re-implements:\n *\n * - **Cart as source of truth** — `selectedMethod` and `totals` are read straight\n *   off the cart; there is no shadow copy to drift.\n * - **One-call shipping select** — `selectMethod` locks the method and returns the\n *   cart with recomputed totals in a single round trip.\n * - **Stale-cart recovery** — a {@link CartNotOpenError} (cart converted by a\n *   completed order, or abandoned) transparently rebuilds a fresh session from\n *   the last-known line items + shipping and retries (`status === 'recovering'`).\n * - **Session handoff** — `createSession` returns the `checkoutSessionId` for\n *   `<PaymentEmbed>`.\n *\n * Address collection is handled inside the checkout embed (the hosted/full\n * checkout collects shipping/billing), so this hook intentionally does not write\n * addresses to the cart.\n *\n * ```tsx\n * const { addItem, selectMethod, totals, createSession, status } =\n *   useThrottleCheckout({ applicationId, environmentId, quoteToken });\n * ```\n */\nexport function useThrottleCheckout(\n  options: UseThrottleCheckoutOptions,\n): UseThrottleCheckoutResult {\n  const { applicationId, environmentId, quoteToken, baseUrl } = options;\n  const autoRecover = options.autoRecover ?? true;\n  const storageKey = options.storageKey === undefined ? DEFAULT_STORAGE_KEY : options.storageKey;\n\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [cartSessionId, setCartSessionId] = useState<string | null>(null);\n  const [status, setStatus] = useState<ThrottleCheckoutStatus>('idle');\n  const [error, setError] = useState<Error | null>(null);\n\n  // Keep the latest cart in a ref so recovery can read the last-known line items\n  // without threading it through every callback's dependency list.\n  const cartRef = useRef<Cart | null>(null);\n  cartRef.current = cart;\n\n  const { client, initError } = useMemo(() => {\n    try {\n      return {\n        client: new CartSessionClient({ applicationId, environmentId, quoteToken, baseUrl }),\n        initError: null as Error | null,\n      };\n    } catch (e) {\n      return { client: null as CartSessionClient | null, initError: e as Error };\n    }\n  }, [applicationId, environmentId, quoteToken, baseUrl]);\n\n  useEffect(() => {\n    if (initError) {\n      setError(initError);\n      setStatus('error');\n    }\n  }, [initError]);\n\n  // Resume a persisted session on mount.\n  useEffect(() => {\n    if (!client) return;\n    const saved = readStored(storageKey);\n    if (!saved) return;\n    let cancelled = false;\n    client.resume(saved);\n    setCartSessionId(saved);\n    setStatus('loading');\n    client\n      .get()\n      .then((s) => {\n        if (cancelled) return;\n        setCart(s.cart);\n        setStatus('ready');\n      })\n      .catch(() => {\n        if (cancelled) return;\n        writeStored(storageKey, null);\n        client.resume('');\n        setCartSessionId(null);\n        setCart(null);\n        setStatus('idle');\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, storageKey]);\n\n  const ensureSession = useCallback(\n    async (input?: CreateCartSessionInput): Promise<void> => {\n      if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n      if (client.cartSessionId) return;\n      const session = await client.create(input ?? {});\n      writeStored(storageKey, session.cartSessionId);\n      setCartSessionId(session.cartSessionId);\n      setCart(session.cart);\n    },\n    [client, initError, storageKey],\n  );\n\n  /**\n   * Rebuild a fresh session from the last-known cart so a stale cart doesn't\n   * strand the buyer. Re-adds line items and re-selects shipping, then returns\n   * the rebuilt cart.\n   */\n  const rebuild = useCallback(async (): Promise<Cart> => {\n    if (!client) throw initError ?? new Error('CartSessionClient unavailable');\n    const prev = cartRef.current;\n    // Drop the stale session and create a new one.\n    client.resume('');\n    setCartSessionId(null);\n    const session = await client.create({\n      currency: prev?.currency,\n      netN: prev?.netN ?? undefined,\n    });\n    writeStored(storageKey, session.cartSessionId);\n    setCartSessionId(session.cartSessionId);\n    let next = session.cart;\n    for (const item of prev?.lineItems ?? []) {\n      next = await client.addItem({\n        type: item.type,\n        referenceId: item.referenceId ?? undefined,\n        name: item.name,\n        description: item.description ?? undefined,\n        unitPrice: item.unitPrice,\n        quantity: item.quantity,\n        imageUrl: item.imageUrl ?? undefined,\n        metadata: item.metadata,\n      });\n    }\n    const ship = prev?.selectedShipping;\n    if (ship) {\n      next = await client.selectShipping({\n        methodId: ship.methodId,\n        displayName: ship.displayName,\n        rateAmount: ship.rateAmount,\n        currency: ship.currency,\n        carrier: ship.carrier ?? undefined,\n        serviceCode: ship.serviceCode ?? undefined,\n        estimatedDeliveryDays: ship.estimatedDeliveryDays ?? undefined,\n      });\n    }\n    setCart(next);\n    return next;\n  }, [client, initError, storageKey]);\n\n  /**\n   * Run a cart op with loading/error bookkeeping. On a stale-cart error, rebuild\n   * (when `autoRecover`) and — for forward-progress ops (`retryAfterRecover`) —\n   * retry once against the rebuilt session. Item-id-specific ops set\n   * `retryAfterRecover: false` because the id no longer exists after rebuild.\n   */\n  const run = useCallback(\n    async <T,>(\n      fn: () => Promise<T>,\n      opts: { create?: boolean; retryAfterRecover?: boolean } = {},\n    ): Promise<T> => {\n      if (!client) {\n        const e = initError ?? new Error('CartSessionClient unavailable');\n        setError(e);\n        setStatus('error');\n        throw e;\n      }\n      setStatus('loading');\n      setError(null);\n      try {\n        if (opts.create) await ensureSession();\n        const result = await fn();\n        setStatus('ready');\n        return result;\n      } catch (e) {\n        const stale = e instanceof CartNotOpenError || e instanceof CartNotFoundError;\n        if (stale && autoRecover) {\n          try {\n            setStatus('recovering');\n            await rebuild();\n            if (opts.retryAfterRecover) {\n              const retried = await fn();\n              setStatus('ready');\n              return retried;\n            }\n            // Rebuild-only: the original op targeted a now-gone id. Surface the\n            // rebuilt cart and let the caller reconcile against fresh state.\n            setStatus('ready');\n            const stale2 = new CartNotOpenError({\n              message: 'Cart was rebuilt after going stale; retry your action against the new cart.',\n            });\n            setError(stale2);\n            throw stale2;\n          } catch (recoverErr) {\n            setError(recoverErr as Error);\n            setStatus('error');\n            throw recoverErr;\n          }\n        }\n        setError(e as Error);\n        setStatus('error');\n        throw e;\n      }\n    },\n    [client, ensureSession, initError, autoRecover, rebuild],\n  );\n\n  const addItem = useCallback(\n    async (input: AddLineItemInput) => {\n      const next = await run(() => client!.addItem(input), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const updateItem = useCallback(\n    async (itemId: string, input: UpdateLineItemInput) => {\n      const next = await run(() => client!.updateItem(itemId, input), { retryAfterRecover: false });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const removeItem = useCallback(\n    async (itemId: string) => {\n      const next = await run(() => client!.removeItem(itemId), { retryAfterRecover: false });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const selectMethod = useCallback(\n    async (input: SelectShippingInput) => {\n      const next = await run(() => client!.selectShipping(input), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const clearShipping = useCallback(async () => {\n    const next = await run(() => client!.clearShipping(), { retryAfterRecover: true });\n    setCart(next);\n  }, [client, run]);\n  const applyDiscount = useCallback(\n    async (code: string) => {\n      const next = await run(() => client!.applyDiscount(code), { create: true, retryAfterRecover: true });\n      setCart(next);\n    },\n    [client, run],\n  );\n  const removeDiscount = useCallback(async () => {\n    const next = await run(() => client!.removeDiscount(), { retryAfterRecover: true });\n    setCart(next);\n  }, [client, run]);\n\n  const refresh = useCallback(async () => {\n    if (!client?.cartSessionId) return;\n    const next = await run(async () => (await client.get()).cart);\n    setCart(next);\n  }, [client, run]);\n\n  const createSession = useCallback(\n    (input: CheckoutHandoffInput): Promise<CheckoutHandoff> =>\n      run(() => client!.checkout(input), { create: true, retryAfterRecover: true }),\n    [client, run],\n  );\n\n  const reset = useCallback(() => {\n    writeStored(storageKey, null);\n    client?.resume('');\n    setCartSessionId(null);\n    setCart(null);\n    setError(null);\n    setStatus('idle');\n  }, [client, storageKey]);\n\n  return {\n    cart,\n    cartSessionId,\n    status,\n    error,\n    selectedMethod: cart?.selectedShipping ?? null,\n    totals: totalsOf(cart),\n    addItem,\n    updateItem,\n    removeItem,\n    selectMethod,\n    clearShipping,\n    applyDiscount,\n    removeDiscount,\n    createSession,\n    refresh,\n    reset,\n  };\n}\n"],"mappings":"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","names":["useState","useEffect","useState","useCallback","useRef","useState","jsx","DEFAULT_BASE_URL","useRef","useState","useCallback","useCallback","useEffect","useState","useCallback","useEffect","useMemo","useRef","useState","CartSessionClient","DEFAULT_STORAGE_KEY","readStored","writeStored"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/checkout-react",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "React component for embedded Throttle checkout",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@usethrottle/cart": "^3.4.0"
+    "@usethrottle/cart": "^3.6.0"
   },
   "scripts": {
     "build": "tsup",