@cimplify/sdk 0.8.7 → 0.8.9

package/dist/react.mjs

@@ -1,49 +1,7 @@
-import React2, { createContext, useContext, useState, useEffect, useRef, useMemo, useCallback, useSyncExternalStore } from 'react';
+import React3, { createContext, useContext, useState, useEffect, useRef, useMemo, useCallback, useSyncExternalStore } from 'react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 
-// src/react/index.tsx
-
-// src/types/elements.ts
-var ELEMENT_TYPES = {
-  AUTH: "auth",
-  ADDRESS: "address",
-  PAYMENT: "payment",
-  CHECKOUT: "checkout"
-};
-var MESSAGE_TYPES = {
-  // Parent → Iframe
-  INIT: "init",
-  SET_TOKEN: "set_token",
-  SET_CART: "set_cart",
-  GET_DATA: "get_data",
-  PROCESS_CHECKOUT: "process_checkout",
-  ABORT_CHECKOUT: "abort_checkout",
-  // Iframe → Parent
-  READY: "ready",
-  HEIGHT_CHANGE: "height_change",
-  AUTHENTICATED: "authenticated",
-  REQUIRES_OTP: "requires_otp",
-  ERROR: "error",
-  ADDRESS_CHANGED: "address_changed",
-  ADDRESS_SELECTED: "address_selected",
-  PAYMENT_METHOD_SELECTED: "payment_method_selected",
-  TOKEN_REFRESHED: "token_refreshed",
-  LOGOUT_COMPLETE: "logout_complete",
-  CONTACT_PROVIDED: "contact_provided",
-  CHECKOUT_STATUS: "checkout_status",
-  CHECKOUT_COMPLETE: "checkout_complete",
-  ORDER_TYPE_CHANGED: "order_type_changed",
-  REQUEST_SUBMIT: "request_submit"
-};
-var EVENT_TYPES = {
-  READY: "ready",
-  AUTHENTICATED: "authenticated",
-  REQUIRES_OTP: "requires_otp",
-  ERROR: "error",
-  CHANGE: "change",
-  ORDER_TYPE_CHANGED: "order_type_changed",
-  REQUEST_SUBMIT: "request_submit"
-};
+// src/ads/index.tsx
 
 // src/ads/identity.ts
 var COOKIE_NAME = "_cimplify_uid";
@@ -362,12 +320,13 @@ function getSelections(item) {
   }
   return void 0;
 }
-function mapItem(item) {
+function mapItem(item, fx) {
+  const amt = (value) => fx ? String(fx.convertPrice(value)) : String(value);
   const result = {
     name: item.name,
     quantity: item.quantity,
-    unit_price: String(item.base_price),
-    total_price: String(item.total_price),
+    unit_price: amt(item.base_price),
+    total_price: amt(item.total_price),
     line_type: item.line_type
   };
   if (item.image_url) result.image_url = item.image_url;
@@ -380,7 +339,7 @@ function mapItem(item) {
   if (item.add_on_options?.length) {
     result.add_ons = item.add_on_options.map((opt) => ({
       name: opt.name,
-      price: String(opt.price ?? "0")
+      price: amt(opt.price ?? "0")
     }));
   }
   if (item.special_instructions) {
@@ -388,623 +347,231 @@ function mapItem(item) {
   }
   return result;
 }
-function transformToCheckoutCart(cart) {
+function transformToCheckoutCart(cart, fx) {
+  const amt = (value) => fx ? String(fx.convertPrice(value)) : String(value);
   return {
-    items: cart.items.map(mapItem),
-    subtotal: String(cart.pricing.subtotal),
-    tax_amount: String(cart.pricing.tax_amount),
-    total_discounts: String(cart.pricing.total_discounts),
-    service_charge: String(cart.pricing.service_charge),
-    total: String(cart.pricing.total_price),
-    currency: cart.pricing.currency
+    items: cart.items.map((item) => mapItem(item, fx)),
+    subtotal: amt(cart.pricing.subtotal),
+    tax_amount: amt(cart.pricing.tax_amount),
+    total_discounts: amt(cart.pricing.total_discounts),
+    service_charge: amt(cart.pricing.service_charge),
+    total: amt(cart.pricing.total_price),
+    currency: fx?.displayCurrency ?? cart.pricing.currency
   };
 }
-var SPACE = { sm: 8};
-function shellColors(isDark, primaryColor) {
-  return {
-    text: isDark ? "#f4f4f5" : "#1a1a1a",
-    textSecondary: isDark ? "#a1a1aa" : "#52525b",
-    textMuted: isDark ? "#71717a" : "#a1a1aa",
-    border: isDark ? "#27272a" : "#e4e4e7",
-    surface: isDark ? "#18181b" : "#fafafa",
-    error: "#dc2626",
-    primary: primaryColor
-  };
+
+// src/types/common.ts
+function money(value) {
+  return value;
 }
-function statusToLabel(status) {
-  if (!status) {
-    return "";
+function moneyFromNumber(value) {
+  return value.toFixed(2);
+}
+var SUPPORTED_CURRENCY_CODES = /* @__PURE__ */ new Set([
+  "USD",
+  "EUR",
+  "GBP",
+  "JPY",
+  "CNY",
+  "CHF",
+  "CAD",
+  "AUD",
+  "GHS",
+  "NGN",
+  "KES",
+  "ZAR",
+  "XOF",
+  "XAF",
+  "EGP",
+  "TZS",
+  "UGX",
+  "RWF",
+  "ETB",
+  "ZMW",
+  "BWP",
+  "MUR",
+  "NAD",
+  "MWK",
+  "AOA",
+  "CDF",
+  "GMD",
+  "GNF",
+  "LRD",
+  "SLL",
+  "MZN",
+  "BIF",
+  "INR",
+  "BRL",
+  "MXN",
+  "KRW",
+  "TRY",
+  "THB",
+  "MYR",
+  "PHP",
+  "IDR",
+  "VND",
+  "SGD",
+  "HKD",
+  "TWD",
+  "AED",
+  "SAR",
+  "ILS"
+]);
+function isSupportedCurrency(code) {
+  return SUPPORTED_CURRENCY_CODES.has(code);
+}
+function currencyCode(value) {
+  return value;
+}
+var ErrorCode = {
+  // General
+  UNKNOWN_ERROR: "UNKNOWN_ERROR",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  TIMEOUT: "TIMEOUT",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  NOT_FOUND: "NOT_FOUND"};
+var DOCS_ERROR_BASE_URL = "https://docs.cimplify.io/reference/error-codes";
+function docsUrlForCode(code) {
+  return `${DOCS_ERROR_BASE_URL}#${code.toLowerCase().replace(/_/g, "-")}`;
+}
+var ERROR_SUGGESTIONS = {
+  UNKNOWN_ERROR: "An unexpected error occurred. Capture the request/response payload and retry with exponential backoff.",
+  NETWORK_ERROR: "Check the shopper's connection and retry. If this persists, inspect CORS, DNS, and API reachability.",
+  TIMEOUT: "The request exceeded the timeout. Retry once, then poll order status before charging again.",
+  UNAUTHORIZED: "Authentication is missing or expired. Ensure a valid access token is set and refresh the session if needed.",
+  FORBIDDEN: "The key/session lacks permission for this resource. Verify business ownership and API key scope.",
+  NOT_FOUND: "The requested resource does not exist or is not visible in this environment.",
+  VALIDATION_ERROR: "One or more fields are invalid. Validate required fields and enum values before retrying.",
+  CART_EMPTY: "The cart has no items. Redirect back to menu/catalogue and require at least one line item.",
+  CART_EXPIRED: "This cart is no longer active. Recreate a new cart and re-add shopper selections.",
+  CART_NOT_FOUND: "Cart could not be located. It may have expired or belongs to a different key/location.",
+  ITEM_UNAVAILABLE: "The selected item is unavailable at this location/time. Prompt the shopper to pick an alternative.",
+  VARIANT_NOT_FOUND: "The requested variant no longer exists. Refresh product data and require re-selection.",
+  VARIANT_OUT_OF_STOCK: "The selected variant is out of stock. Show in-stock variants and block checkout for this line.",
+  ADDON_REQUIRED: "A required add-on is missing. Ensure required modifier groups are completed before add-to-cart.",
+  ADDON_MAX_EXCEEDED: "Too many add-ons were selected. Enforce max selections client-side before submission.",
+  CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
+  DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
+  CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
+  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
+  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
+  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
+  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
+  PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
+  PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
+  INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
+  CARD_DECLINED: "Card was declined. Ask shopper to retry or switch payment method.",
+  INVALID_OTP: "Authorization code is invalid. Let shopper re-enter OTP/PIN and retry.",
+  OTP_EXPIRED: "Authorization code expired. Request a new OTP and re-submit authorization.",
+  AUTHORIZATION_FAILED: "Additional payment authorization failed. Retry authorization or change payment method.",
+  PAYMENT_ACTION_NOT_COMPLETED: "Required payment action was not completed. Resume provider flow and poll for status.",
+  SLOT_UNAVAILABLE: "Selected schedule slot is unavailable. Refresh available slots and ask shopper to reselect.",
+  BOOKING_CONFLICT: "The requested booking conflicts with an existing reservation. Pick another slot/resource.",
+  SERVICE_NOT_FOUND: "Requested service no longer exists. Refresh service catalogue and retry selection.",
+  OUT_OF_STOCK: "Inventory is depleted for this item. Remove it or reduce quantity before checkout.",
+  INSUFFICIENT_QUANTITY: "Requested quantity exceeds available inventory. Reduce quantity and retry.",
+  BUSINESS_ID_REQUIRED: "Business context could not be resolved. Verify the public key and business bootstrap call.",
+  INVALID_CART: "Cart is invalid for checkout. Sync cart state, ensure items exist, then retry.",
+  ORDER_TYPE_REQUIRED: "Order type is required. Provide one of delivery, pickup, or dine_in before checkout.",
+  NO_PAYMENT_ELEMENT: "PaymentElement is required for processCheckout(). Mount it before triggering checkout.",
+  PAYMENT_NOT_MOUNTED: "PaymentElement iframe is not mounted. Mount it in the DOM before processCheckout().",
+  AUTH_INCOMPLETE: "AuthElement has not completed authentication. Wait for AUTHENTICATED before checkout.",
+  AUTH_LOST: "Session was cleared during checkout. Re-authenticate and restart checkout safely.",
+  ALREADY_PROCESSING: "Checkout is already in progress. Disable duplicate submits until completion.",
+  CHECKOUT_NOT_READY: "Checkout elements are still initializing. Wait for readiness before submit.",
+  CANCELLED: "Checkout was cancelled. Preserve cart state and allow shopper to retry.",
+  REQUEST_TIMEOUT: "Provider call timed out. Poll payment/order status before issuing another charge attempt.",
+  POPUP_BLOCKED: "Browser blocked provider popup. Ask shopper to enable popups and retry.",
+  FX_QUOTE_FAILED: "Failed to lock FX quote. Retry currency quote or fallback to base currency."
+};
+var ERROR_HINTS = Object.fromEntries(
+  Object.entries(ERROR_SUGGESTIONS).map(([code, suggestion]) => [
+    code,
+    {
+      docs_url: docsUrlForCode(code),
+      suggestion
+    }
+  ])
+);
+var CimplifyError = class extends Error {
+  constructor(code, message, retryable = false, docs_url, suggestion) {
+    super(message);
+    this.code = code;
+    this.retryable = retryable;
+    this.docs_url = docs_url;
+    this.suggestion = suggestion;
+    this.name = "CimplifyError";
   }
-  if (status === "preparing") {
-    return "Preparing checkout";
+  /** User-friendly message safe to display */
+  get userMessage() {
+    return this.message;
   }
-  if (status === "recovering") {
-    return "Resuming payment";
+};
+function getErrorHint(code) {
+  return ERROR_HINTS[code];
+}
+function enrichError(error, options = {}) {
+  const hint = getErrorHint(error.code);
+  if (hint) {
+    if (!error.docs_url) {
+      error.docs_url = hint.docs_url;
+    }
+    if (!error.suggestion) {
+      error.suggestion = hint.suggestion;
+    }
+  } else if (!error.docs_url) {
+    error.docs_url = docsUrlForCode(error.code || ErrorCode.UNKNOWN_ERROR);
   }
-  if (status === "processing") {
-    return "Processing payment";
+  if (options.isTestMode && !error.message.includes("pk_test_")) {
+    error.message = `${error.message}
+
+\u2139 Your API key is a test-mode key (pk_test_...). Verify test data/session before retrying.`;
   }
-  if (status === "awaiting_authorization") {
-    return "Waiting for authorization";
+  return error;
+}
+
+// src/types/result.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+
+// src/catalogue.ts
+function toCimplifyError(error) {
+  if (error instanceof CimplifyError) return enrichError(error);
+  if (error instanceof Error) {
+    return enrichError(new CimplifyError(ErrorCode.UNKNOWN_ERROR, error.message, false));
   }
-  if (status === "polling") {
-    return "Confirming payment";
+  return enrichError(new CimplifyError(ErrorCode.UNKNOWN_ERROR, String(error), false));
+}
+async function safe(promise) {
+  try {
+    return ok(await promise);
+  } catch (error) {
+    return err(toCimplifyError(error));
   }
-  if (status === "finalizing") {
-    return "Finalizing order";
+}
+function withQuery(path, params) {
+  const query = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0) continue;
+    query.set(key, String(value));
   }
-  if (status === "success") {
-    return "Payment complete";
+  const queryString = query.toString();
+  return queryString ? `${path}?${queryString}` : path;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readFinalPrice(value) {
+  if (!isRecord(value)) return void 0;
+  const finalPrice = value.final_price;
+  if (typeof finalPrice === "string" || typeof finalPrice === "number") {
+    return finalPrice;
   }
-  return "Payment failed";
-}
-function CimplifyCheckout({
-  client,
-  businessId,
-  cartId,
-  locationId,
-  linkUrl,
-  orderTypes,
-  enrollInLink = true,
-  onComplete,
-  onError,
-  onStatusChange,
-  appearance,
-  demoMode,
-  className
-}) {
-  const resolvedOrderTypes = useMemo(
-    () => orderTypes && orderTypes.length > 0 ? orderTypes : ["pickup", "delivery"],
-    [orderTypes]
-  );
-  const [orderType, setOrderType] = useState(resolvedOrderTypes[0] || "pickup");
-  const [status, setStatus] = useState(null);
-  const [statusText, setStatusText] = useState("");
-  const [isSubmitting, setIsSubmitting] = useState(false);
-  const [isInitializing, setIsInitializing] = useState(false);
-  const [errorMessage, setErrorMessage] = useState(null);
-  const [resolvedBusinessId, setResolvedBusinessId] = useState(businessId ?? null);
-  const [resolvedCartId, setResolvedCartId] = useState(cartId ?? null);
-  const [resolvedCart, setResolvedCart] = useState(null);
-  const checkoutMountRef = useRef(null);
-  const elementsRef = useRef(null);
-  const activeCheckoutRef = useRef(null);
-  const initialAppearanceRef = useRef(appearance);
-  const hasWarnedInlineAppearanceRef = useRef(false);
-  const isMountedRef = useRef(true);
-  const demoRunRef = useRef(0);
-  const isDemoCheckout = demoMode ?? client.getPublicKey().trim().length === 0;
-  const isTestMode = client.isTestMode();
-  const primaryColor = appearance?.variables?.primaryColor || "#0a2540";
-  const isDark = appearance?.theme === "dark";
-  const emitStatus = React2.useEffectEvent(
-    (nextStatus, context = {}) => {
-      setStatus(nextStatus);
-      setStatusText(context.display_text || "");
-      onStatusChange?.(nextStatus, context);
-    }
-  );
-  const fireError = React2.useEffectEvent(
-    (error) => {
-      onError?.(error);
-    }
-  );
-  useEffect(() => {
-    if (!resolvedOrderTypes.includes(orderType)) {
-      setOrderType(resolvedOrderTypes[0] || "pickup");
-    }
-  }, [resolvedOrderTypes, orderType]);
-  useEffect(() => {
-    if (appearance && appearance !== initialAppearanceRef.current && !hasWarnedInlineAppearanceRef.current) {
-      hasWarnedInlineAppearanceRef.current = true;
-      console.warn(
-        "[Cimplify] `appearance` prop reference changed after mount. Elements keep the initial appearance to avoid iframe remount. Memoize appearance with useMemo() to remove this warning."
-      );
-    }
-  }, [appearance]);
-  useEffect(() => {
-    let cancelled = false;
-    async function bootstrap() {
-      if (isDemoCheckout) {
-        if (!cancelled) {
-          setResolvedBusinessId(businessId ?? null);
-          setResolvedCartId(cartId ?? "cart_demo");
-          setIsInitializing(false);
-          setErrorMessage(null);
-        }
-        return;
-      }
-      const needsBusinessResolve = !businessId;
-      const needsCartResolve = !cartId;
-      if (!needsBusinessResolve && !needsCartResolve) {
-        if (!cancelled) {
-          setResolvedBusinessId(businessId || null);
-          setResolvedCartId(cartId || null);
-          setIsInitializing(false);
-          setErrorMessage(null);
-        }
-        client.cart.get().then((cartResult) => {
-          if (!cancelled && cartResult.ok && cartResult.value) {
-            setResolvedCart(cartResult.value);
-          }
-        }).catch(() => {
-        });
-        return;
-      }
-      if (!cancelled) {
-        setIsInitializing(true);
-        setErrorMessage(null);
-      }
-      let nextBusinessId = businessId ?? null;
-      if (!nextBusinessId) {
-        try {
-          nextBusinessId = await client.resolveBusinessId();
-        } catch {
-          if (!cancelled) {
-            const message = "Unable to initialize checkout business context.";
-            setResolvedBusinessId(null);
-            setResolvedCartId(null);
-            setErrorMessage(message);
-            setIsInitializing(false);
-            fireError({ code: "BUSINESS_ID_REQUIRED", message });
-          }
-          return;
-        }
-      }
-      let nextCartId = cartId ?? null;
-      if (!nextCartId) {
-        const cartResult = await client.cart.get();
-        if (!cartResult.ok || !cartResult.value?.id || cartResult.value.items.length === 0) {
-          if (!cancelled) {
-            const message = "Your cart is empty. Add items before checkout.";
-            setResolvedBusinessId(nextBusinessId);
-            setResolvedCartId(null);
-            setErrorMessage(message);
-            setIsInitializing(false);
-            fireError({ code: "CART_EMPTY", message });
-          }
-          return;
-        }
-        nextCartId = cartResult.value.id;
-        if (!cancelled) {
-          setResolvedCart(cartResult.value);
-        }
-      }
-      if (!cancelled) {
-        setResolvedBusinessId(nextBusinessId);
-        setResolvedCartId(nextCartId);
-        setIsInitializing(false);
-        setErrorMessage(null);
-      }
-    }
-    void bootstrap();
-    return () => {
-      cancelled = true;
-    };
-  }, [businessId, cartId, client, isDemoCheckout]);
-  useEffect(() => {
-    return () => {
-      isMountedRef.current = false;
-      demoRunRef.current += 1;
-      activeCheckoutRef.current?.abort();
-      activeCheckoutRef.current = null;
-    };
-  }, []);
-  const handleSubmit = React2.useEffectEvent(async () => {
-    if (isSubmitting || isInitializing || !resolvedCartId) {
-      if (!resolvedCartId && !isInitializing) {
-        const message = "Your cart is empty. Add items before checkout.";
-        setErrorMessage(message);
-        fireError({ code: "CART_EMPTY", message });
-      }
-      return;
-    }
-    setErrorMessage(null);
-    setIsSubmitting(true);
-    emitStatus("preparing", { display_text: statusToLabel("preparing") });
-    if (isDemoCheckout) {
-      const runId = demoRunRef.current + 1;
-      demoRunRef.current = runId;
-      const wait = async (ms) => {
-        await new Promise((resolve) => setTimeout(resolve, ms));
-        return isMountedRef.current && runId === demoRunRef.current;
-      };
-      try {
-        if (!await wait(400)) return;
-        emitStatus("processing", { display_text: statusToLabel("processing") });
-        if (!await wait(900)) return;
-        emitStatus("polling", { display_text: statusToLabel("polling") });
-        if (!await wait(1200)) return;
-        const result = {
-          success: true,
-          order: {
-            id: `ord_demo_${Date.now()}`,
-            order_number: `DEMO-${Math.random().toString(36).slice(2, 8).toUpperCase()}`,
-            status: "confirmed",
-            total: "0.00",
-            currency: "USD"
-          }
-        };
-        emitStatus("success", {
-          order_id: result.order?.id,
-          order_number: result.order?.order_number,
-          display_text: statusToLabel("success")
-        });
-        onComplete(result);
-      } finally {
-        if (isMountedRef.current && runId === demoRunRef.current) {
-          setIsSubmitting(false);
-        }
-      }
-      return;
-    }
-    if (!elementsRef.current) {
-      const message = "Checkout is still initializing. Please try again.";
-      setErrorMessage(message);
-      fireError({ code: "CHECKOUT_NOT_READY", message });
-      setIsSubmitting(false);
-      return;
-    }
-    const checkout = elementsRef.current.processCheckout({
-      cart_id: resolvedCartId,
-      location_id: locationId ?? client.getLocationId() ?? void 0,
-      order_type: orderType,
-      enroll_in_link: enrollInLink,
-      on_status_change: emitStatus
-    });
-    activeCheckoutRef.current = checkout;
-    try {
-      const result = await checkout;
-      if (result.success) {
-        onComplete(result);
-        return;
-      }
-      const code = result.error?.code || "CHECKOUT_FAILED";
-      const message = result.error?.message || "Payment failed.";
-      setErrorMessage(message);
-      fireError({ code, message });
-    } finally {
-      if (isMountedRef.current) {
-        activeCheckoutRef.current = null;
-        setIsSubmitting(false);
-      }
-    }
-  });
-  useEffect(() => {
-    if (isDemoCheckout || !resolvedBusinessId) {
-      elementsRef.current = null;
-      return;
-    }
-    const elements = client.elements(resolvedBusinessId, {
-      appearance: initialAppearanceRef.current,
-      linkUrl
-    });
-    elementsRef.current = elements;
-    const checkout = elements.create("checkout", {
-      orderTypes: resolvedOrderTypes,
-      defaultOrderType: resolvedOrderTypes[0]
-    });
-    if (checkoutMountRef.current) {
-      checkout.mount(checkoutMountRef.current);
-    }
-    checkout.on("ready", () => {
-      if (resolvedCart) {
-        checkout.setCart(transformToCheckoutCart(resolvedCart));
-      }
-    });
-    checkout.on("order_type_changed", (data) => {
-      const typed = data;
-      if (typed.orderType) {
-        setOrderType(typed.orderType);
-      }
-    });
-    checkout.on("request_submit", () => {
-      void handleSubmit();
-    });
-    return () => {
-      activeCheckoutRef.current?.abort();
-      activeCheckoutRef.current = null;
-      elements.destroy();
-      elementsRef.current = null;
-    };
-  }, [client, resolvedBusinessId, isDemoCheckout]);
-  useEffect(() => {
-    if (!resolvedCart || !elementsRef.current) return;
-    const checkoutElement = elementsRef.current.getElement("checkout");
-    if (checkoutElement) {
-      checkoutElement.setCart(transformToCheckoutCart(resolvedCart));
-    }
-  }, [resolvedCart]);
-  const colors = shellColors(isDark ?? false, primaryColor);
-  if (isInitializing) {
-    return /* @__PURE__ */ jsx("div", { className, "data-cimplify-checkout": "", children: /* @__PURE__ */ jsx("p", { "data-cimplify-status": "", style: { fontSize: 13, color: colors.textSecondary }, children: "Preparing checkout..." }) });
-  }
-  if (!isDemoCheckout && (!resolvedBusinessId || !resolvedCartId)) {
-    return /* @__PURE__ */ jsx("div", { className, "data-cimplify-checkout": "", children: /* @__PURE__ */ jsx("p", { "data-cimplify-error": "", style: { fontSize: 13, color: colors.error }, children: errorMessage || "Unable to initialize checkout. Please refresh and try again." }) });
-  }
-  return /* @__PURE__ */ jsxs("div", { className, "data-cimplify-checkout": "", children: [
-    isTestMode && !isDemoCheckout && /* @__PURE__ */ jsx(
-      "p",
-      {
-        "data-cimplify-test-mode": "",
-        style: {
-          marginBottom: "10px",
-          fontSize: "12px",
-          fontWeight: 600,
-          color: "#92400e"
-        },
-        children: "Test mode - no real charges"
-      }
-    ),
-    /* @__PURE__ */ jsx("div", { "data-cimplify-section": "checkout", children: /* @__PURE__ */ jsx("div", { ref: isDemoCheckout ? void 0 : checkoutMountRef }) }),
-    status && /* @__PURE__ */ jsx("p", { "data-cimplify-status": "", style: { marginTop: SPACE.sm, fontSize: 13, color: colors.textSecondary }, children: statusText || statusToLabel(status) }),
-    errorMessage && /* @__PURE__ */ jsx("p", { "data-cimplify-error": "", style: { marginTop: SPACE.sm, fontSize: 13, color: colors.error }, children: errorMessage })
-  ] });
-}
-
-// src/utils/price.ts
-var CURRENCY_SYMBOLS = {
-  // Major world currencies
-  USD: "$",
-  EUR: "\u20AC",
-  GBP: "\xA3",
-  JPY: "\xA5",
-  CNY: "\xA5",
-  CHF: "CHF",
-  CAD: "C$",
-  AUD: "A$",
-  NZD: "NZ$",
-  HKD: "HK$",
-  SGD: "S$",
-  INR: "\u20B9",
-  BRL: "R$",
-  MXN: "MX$",
-  KRW: "\u20A9",
-  RUB: "\u20BD",
-  TRY: "\u20BA",
-  THB: "\u0E3F",
-  PLN: "z\u0142",
-  SEK: "kr",
-  NOK: "kr",
-  DKK: "kr",
-  CZK: "K\u010D",
-  HUF: "Ft",
-  ILS: "\u20AA",
-  AED: "\u062F.\u0625",
-  SAR: "\uFDFC",
-  MYR: "RM",
-  PHP: "\u20B1",
-  IDR: "Rp",
-  VND: "\u20AB",
-  TWD: "NT$",
-  // African currencies
-  GHS: "GH\u20B5",
-  NGN: "\u20A6",
-  KES: "KSh",
-  ZAR: "R",
-  XOF: "CFA",
-  XAF: "FCFA",
-  EGP: "E\xA3",
-  MAD: "MAD",
-  TZS: "TSh",
-  UGX: "USh",
-  RWF: "FRw",
-  ETB: "Br",
-  ZMW: "ZK",
-  BWP: "P",
-  MUR: "\u20A8",
-  SCR: "\u20A8",
-  NAD: "N$",
-  SZL: "E",
-  LSL: "L",
-  MWK: "MK",
-  AOA: "Kz",
-  CDF: "FC",
-  GMD: "D",
-  GNF: "FG",
-  LRD: "L$",
-  SLL: "Le",
-  MZN: "MT",
-  SDG: "SDG",
-  SSP: "SSP",
-  SOS: "Sh.So.",
-  DJF: "Fdj",
-  ERN: "Nfk",
-  CVE: "$",
-  STN: "Db",
-  KMF: "CF",
-  BIF: "FBu"
-};
-function getCurrencySymbol(currencyCode2) {
-  return CURRENCY_SYMBOLS[currencyCode2.toUpperCase()] || currencyCode2;
-}
-function formatPrice(amount, currency = "GHS", locale = "en-US") {
-  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
-  if (isNaN(numAmount)) {
-    return `${getCurrencySymbol(currency)}0.00`;
-  }
-  try {
-    return new Intl.NumberFormat(locale, {
-      style: "currency",
-      currency: currency.toUpperCase(),
-      minimumFractionDigits: 2,
-      maximumFractionDigits: 2
-    }).format(numAmount);
-  } catch {
-    return `${getCurrencySymbol(currency)}${numAmount.toFixed(2)}`;
-  }
-}
-function parsePrice(value) {
-  if (value === void 0 || value === null) {
-    return 0;
-  }
-  if (typeof value === "number") {
-    return isNaN(value) ? 0 : value;
-  }
-  const cleaned = value.replace(/[^\d.-]/g, "");
-  const parsed = parseFloat(cleaned);
-  return isNaN(parsed) ? 0 : parsed;
-}
-
-// src/types/common.ts
-function money(value) {
-  return value;
-}
-function moneyFromNumber(value) {
-  return value.toFixed(2);
-}
-function currencyCode(value) {
-  return value;
-}
-var ErrorCode = {
-  // General
-  UNKNOWN_ERROR: "UNKNOWN_ERROR",
-  NETWORK_ERROR: "NETWORK_ERROR",
-  TIMEOUT: "TIMEOUT",
-  UNAUTHORIZED: "UNAUTHORIZED",
-  NOT_FOUND: "NOT_FOUND"};
-var DOCS_ERROR_BASE_URL = "https://docs.cimplify.io/reference/error-codes";
-function docsUrlForCode(code) {
-  return `${DOCS_ERROR_BASE_URL}#${code.toLowerCase().replace(/_/g, "-")}`;
-}
-var ERROR_SUGGESTIONS = {
-  UNKNOWN_ERROR: "An unexpected error occurred. Capture the request/response payload and retry with exponential backoff.",
-  NETWORK_ERROR: "Check the shopper's connection and retry. If this persists, inspect CORS, DNS, and API reachability.",
-  TIMEOUT: "The request exceeded the timeout. Retry once, then poll order status before charging again.",
-  UNAUTHORIZED: "Authentication is missing or expired. Ensure a valid access token is set and refresh the session if needed.",
-  FORBIDDEN: "The key/session lacks permission for this resource. Verify business ownership and API key scope.",
-  NOT_FOUND: "The requested resource does not exist or is not visible in this environment.",
-  VALIDATION_ERROR: "One or more fields are invalid. Validate required fields and enum values before retrying.",
-  CART_EMPTY: "The cart has no items. Redirect back to menu/catalogue and require at least one line item.",
-  CART_EXPIRED: "This cart is no longer active. Recreate a new cart and re-add shopper selections.",
-  CART_NOT_FOUND: "Cart could not be located. It may have expired or belongs to a different key/location.",
-  ITEM_UNAVAILABLE: "The selected item is unavailable at this location/time. Prompt the shopper to pick an alternative.",
-  VARIANT_NOT_FOUND: "The requested variant no longer exists. Refresh product data and require re-selection.",
-  VARIANT_OUT_OF_STOCK: "The selected variant is out of stock. Show in-stock variants and block checkout for this line.",
-  ADDON_REQUIRED: "A required add-on is missing. Ensure required modifier groups are completed before add-to-cart.",
-  ADDON_MAX_EXCEEDED: "Too many add-ons were selected. Enforce max selections client-side before submission.",
-  CHECKOUT_VALIDATION_FAILED: "Checkout payload failed validation. Verify customer, order type, and address fields are complete.",
-  DELIVERY_ADDRESS_REQUIRED: "Delivery orders require an address. Collect and pass address info before processing checkout.",
-  CUSTOMER_INFO_REQUIRED: "Customer details are required. Ensure name/email/phone are available before checkout.",
-  QUOTE_NOT_FOUND: "Quote could not be found. Refresh pricing and create a new quote before checkout.",
-  QUOTE_EXPIRED: "Quote has expired. Re-fetch pricing to generate a new quote with a valid expiry window.",
-  QUOTE_CONSUMED: "Quote has already been used. Request a fresh quote to prevent duplicate checkout attempts.",
-  QUOTE_STORAGE_UNAVAILABLE: "Quote storage is temporarily unavailable. Retry shortly and avoid charging until quote fetch succeeds.",
-  PAYMENT_FAILED: "Payment provider rejected or failed processing. Show retry/change-method options to the shopper.",
-  PAYMENT_CANCELLED: "Payment was cancelled by the shopper or provider flow. Allow a safe retry path.",
-  INSUFFICIENT_FUNDS: "Payment method has insufficient funds. Prompt shopper to use another method.",
-  CARD_DECLINED: "Card was declined. Ask shopper to retry or switch payment method.",
-  INVALID_OTP: "Authorization code is invalid. Let shopper re-enter OTP/PIN and retry.",
-  OTP_EXPIRED: "Authorization code expired. Request a new OTP and re-submit authorization.",
-  AUTHORIZATION_FAILED: "Additional payment authorization failed. Retry authorization or change payment method.",
-  PAYMENT_ACTION_NOT_COMPLETED: "Required payment action was not completed. Resume provider flow and poll for status.",
-  SLOT_UNAVAILABLE: "Selected schedule slot is unavailable. Refresh available slots and ask shopper to reselect.",
-  BOOKING_CONFLICT: "The requested booking conflicts with an existing reservation. Pick another slot/resource.",
-  SERVICE_NOT_FOUND: "Requested service no longer exists. Refresh service catalogue and retry selection.",
-  OUT_OF_STOCK: "Inventory is depleted for this item. Remove it or reduce quantity before checkout.",
-  INSUFFICIENT_QUANTITY: "Requested quantity exceeds available inventory. Reduce quantity and retry.",
-  BUSINESS_ID_REQUIRED: "Business context could not be resolved. Verify the public key and business bootstrap call.",
-  INVALID_CART: "Cart is invalid for checkout. Sync cart state, ensure items exist, then retry.",
-  ORDER_TYPE_REQUIRED: "Order type is required. Provide one of delivery, pickup, or dine_in before checkout.",
-  NO_PAYMENT_ELEMENT: "PaymentElement is required for processCheckout(). Mount it before triggering checkout.",
-  PAYMENT_NOT_MOUNTED: "PaymentElement iframe is not mounted. Mount it in the DOM before processCheckout().",
-  AUTH_INCOMPLETE: "AuthElement has not completed authentication. Wait for AUTHENTICATED before checkout.",
-  AUTH_LOST: "Session was cleared during checkout. Re-authenticate and restart checkout safely.",
-  ALREADY_PROCESSING: "Checkout is already in progress. Disable duplicate submits until completion.",
-  CHECKOUT_NOT_READY: "Checkout elements are still initializing. Wait for readiness before submit.",
-  CANCELLED: "Checkout was cancelled. Preserve cart state and allow shopper to retry.",
-  REQUEST_TIMEOUT: "Provider call timed out. Poll payment/order status before issuing another charge attempt.",
-  POPUP_BLOCKED: "Browser blocked provider popup. Ask shopper to enable popups and retry.",
-  FX_QUOTE_FAILED: "Failed to lock FX quote. Retry currency quote or fallback to base currency."
-};
-var ERROR_HINTS = Object.fromEntries(
-  Object.entries(ERROR_SUGGESTIONS).map(([code, suggestion]) => [
-    code,
-    {
-      docs_url: docsUrlForCode(code),
-      suggestion
-    }
-  ])
-);
-var CimplifyError = class extends Error {
-  constructor(code, message, retryable = false, docs_url, suggestion) {
-    super(message);
-    this.code = code;
-    this.retryable = retryable;
-    this.docs_url = docs_url;
-    this.suggestion = suggestion;
-    this.name = "CimplifyError";
-  }
-  /** User-friendly message safe to display */
-  get userMessage() {
-    return this.message;
-  }
-};
-function getErrorHint(code) {
-  return ERROR_HINTS[code];
-}
-function enrichError(error, options = {}) {
-  const hint = getErrorHint(error.code);
-  if (hint) {
-    if (!error.docs_url) {
-      error.docs_url = hint.docs_url;
-    }
-    if (!error.suggestion) {
-      error.suggestion = hint.suggestion;
-    }
-  } else if (!error.docs_url) {
-    error.docs_url = docsUrlForCode(error.code || ErrorCode.UNKNOWN_ERROR);
-  }
-  if (options.isTestMode && !error.message.includes("pk_test_")) {
-    error.message = `${error.message}
-
-\u2139 Your API key is a test-mode key (pk_test_...). Verify test data/session before retrying.`;
-  }
-  return error;
-}
-
-// src/types/result.ts
-function ok(value) {
-  return { ok: true, value };
-}
-function err(error) {
-  return { ok: false, error };
-}
-
-// src/catalogue.ts
-function toCimplifyError(error) {
-  if (error instanceof CimplifyError) return enrichError(error);
-  if (error instanceof Error) {
-    return enrichError(new CimplifyError(ErrorCode.UNKNOWN_ERROR, error.message, false));
-  }
-  return enrichError(new CimplifyError(ErrorCode.UNKNOWN_ERROR, String(error), false));
-}
-async function safe(promise) {
-  try {
-    return ok(await promise);
-  } catch (error) {
-    return err(toCimplifyError(error));
-  }
-}
-function withQuery(path, params) {
-  const query = new URLSearchParams();
-  for (const [key, value] of Object.entries(params)) {
-    if (value === void 0) continue;
-    query.set(key, String(value));
-  }
-  const queryString = query.toString();
-  return queryString ? `${path}?${queryString}` : path;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function readFinalPrice(value) {
-  if (!isRecord(value)) return void 0;
-  const finalPrice = value.final_price;
-  if (typeof finalPrice === "string" || typeof finalPrice === "number") {
-    return finalPrice;
-  }
-  return void 0;
+  return void 0;
 }
 function normalizeAddOnPayload(addOn) {
   if (!isRecord(addOn)) return addOn;
@@ -1457,6 +1024,110 @@ var MOBILE_MONEY_PROVIDER = {
   AIRTEL: "airtel"
 };
 
+// src/utils/price.ts
+var CURRENCY_SYMBOLS = {
+  // Major world currencies
+  USD: "$",
+  EUR: "\u20AC",
+  GBP: "\xA3",
+  JPY: "\xA5",
+  CNY: "\xA5",
+  CHF: "CHF",
+  CAD: "C$",
+  AUD: "A$",
+  NZD: "NZ$",
+  HKD: "HK$",
+  SGD: "S$",
+  INR: "\u20B9",
+  BRL: "R$",
+  MXN: "MX$",
+  KRW: "\u20A9",
+  RUB: "\u20BD",
+  TRY: "\u20BA",
+  THB: "\u0E3F",
+  PLN: "z\u0142",
+  SEK: "kr",
+  NOK: "kr",
+  DKK: "kr",
+  CZK: "K\u010D",
+  HUF: "Ft",
+  ILS: "\u20AA",
+  AED: "\u062F.\u0625",
+  SAR: "\uFDFC",
+  MYR: "RM",
+  PHP: "\u20B1",
+  IDR: "Rp",
+  VND: "\u20AB",
+  TWD: "NT$",
+  // African currencies
+  GHS: "GH\u20B5",
+  NGN: "\u20A6",
+  KES: "KSh",
+  ZAR: "R",
+  XOF: "CFA",
+  XAF: "FCFA",
+  EGP: "E\xA3",
+  MAD: "MAD",
+  TZS: "TSh",
+  UGX: "USh",
+  RWF: "FRw",
+  ETB: "Br",
+  ZMW: "ZK",
+  BWP: "P",
+  MUR: "\u20A8",
+  SCR: "\u20A8",
+  NAD: "N$",
+  SZL: "E",
+  LSL: "L",
+  MWK: "MK",
+  AOA: "Kz",
+  CDF: "FC",
+  GMD: "D",
+  GNF: "FG",
+  LRD: "L$",
+  SLL: "Le",
+  MZN: "MT",
+  SDG: "SDG",
+  SSP: "SSP",
+  SOS: "Sh.So.",
+  DJF: "Fdj",
+  ERN: "Nfk",
+  CVE: "$",
+  STN: "Db",
+  KMF: "CF",
+  BIF: "FBu"
+};
+function getCurrencySymbol(currencyCode2) {
+  return CURRENCY_SYMBOLS[currencyCode2.toUpperCase()] || currencyCode2;
+}
+function formatPrice(amount, currency = "GHS", locale = "en-US") {
+  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (isNaN(numAmount)) {
+    return `${getCurrencySymbol(currency)}0.00`;
+  }
+  try {
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency: currency.toUpperCase(),
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2
+    }).format(numAmount);
+  } catch {
+    return `${getCurrencySymbol(currency)}${numAmount.toFixed(2)}`;
+  }
+}
+function parsePrice(value) {
+  if (value === void 0 || value === null) {
+    return 0;
+  }
+  if (typeof value === "number") {
+    return isNaN(value) ? 0 : value;
+  }
+  const cleaned = value.replace(/[^\d.-]/g, "");
+  const parsed = parseFloat(cleaned);
+  return isNaN(parsed) ? 0 : parsed;
+}
+
 // src/utils/payment.ts
 var PAYMENT_SUCCESS_STATUSES = /* @__PURE__ */ new Set([
   "success",
@@ -3114,6 +2785,48 @@ var FxService = class {
   }
 };
 
+// src/types/elements.ts
+var ELEMENT_TYPES = {
+  AUTH: "auth",
+  ADDRESS: "address",
+  PAYMENT: "payment",
+  CHECKOUT: "checkout"
+};
+var MESSAGE_TYPES = {
+  // Parent → Iframe
+  INIT: "init",
+  SET_TOKEN: "set_token",
+  SET_CART: "set_cart",
+  GET_DATA: "get_data",
+  PROCESS_CHECKOUT: "process_checkout",
+  ABORT_CHECKOUT: "abort_checkout",
+  // Iframe → Parent
+  READY: "ready",
+  HEIGHT_CHANGE: "height_change",
+  AUTHENTICATED: "authenticated",
+  REQUIRES_OTP: "requires_otp",
+  ERROR: "error",
+  ADDRESS_CHANGED: "address_changed",
+  ADDRESS_SELECTED: "address_selected",
+  PAYMENT_METHOD_SELECTED: "payment_method_selected",
+  TOKEN_REFRESHED: "token_refreshed",
+  LOGOUT_COMPLETE: "logout_complete",
+  CONTACT_PROVIDED: "contact_provided",
+  CHECKOUT_STATUS: "checkout_status",
+  CHECKOUT_COMPLETE: "checkout_complete",
+  ORDER_TYPE_CHANGED: "order_type_changed",
+  REQUEST_SUBMIT: "request_submit"
+};
+var EVENT_TYPES = {
+  READY: "ready",
+  AUTHENTICATED: "authenticated",
+  REQUIRES_OTP: "requires_otp",
+  ERROR: "error",
+  CHANGE: "change",
+  ORDER_TYPE_CHANGED: "order_type_changed",
+  REQUEST_SUBMIT: "request_submit"
+};
+
 // src/elements.ts
 function toCheckoutError(code, message, recoverable) {
   const hint = getErrorHint(code);
@@ -4400,247 +4113,610 @@ var CimplifyClient = class {
     }
     return createElements(this, businessId ?? this.businessId ?? void 0, options);
   }
-};
-function createCimplifyClient(config = {}) {
-  return new CimplifyClient(config);
+};
+function createCimplifyClient(config = {}) {
+  return new CimplifyClient(config);
+}
+var LOCATION_STORAGE_KEY = "cimplify_location_id";
+var DISPLAY_CURRENCY_STORAGE_KEY = "cimplify_display_currency";
+var FX_REFRESH_INTERVAL = 12e4;
+var DEFAULT_CURRENCY = "USD";
+var DEFAULT_COUNTRY = "US";
+function createDefaultClient() {
+  const processRef = globalThis.process;
+  const envPublicKey = processRef?.env?.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY || "";
+  return createCimplifyClient({ publicKey: envPublicKey });
+}
+function getStoredLocationId() {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return null;
+  }
+  const value = window.localStorage.getItem(LOCATION_STORAGE_KEY);
+  if (!value) {
+    return null;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function setStoredLocationId(locationId) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return;
+  }
+  if (!locationId) {
+    window.localStorage.removeItem(LOCATION_STORAGE_KEY);
+    return;
+  }
+  window.localStorage.setItem(LOCATION_STORAGE_KEY, locationId);
+}
+function getStoredDisplayCurrency() {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return null;
+  }
+  const value = window.localStorage.getItem(DISPLAY_CURRENCY_STORAGE_KEY);
+  if (!value) {
+    return null;
+  }
+  const normalized = value.trim().toUpperCase();
+  return normalized.length > 0 ? normalized : null;
+}
+function setStoredDisplayCurrency(currency) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return;
+  }
+  if (!currency) {
+    window.localStorage.removeItem(DISPLAY_CURRENCY_STORAGE_KEY);
+    return;
+  }
+  window.localStorage.setItem(DISPLAY_CURRENCY_STORAGE_KEY, currency.toUpperCase());
+}
+function resolveInitialLocation(locations) {
+  if (locations.length === 0) {
+    return null;
+  }
+  const storedId = getStoredLocationId();
+  if (storedId) {
+    const matched = locations.find((location) => location.id === storedId);
+    if (matched) {
+      return matched;
+    }
+  }
+  return locations[0];
+}
+var CimplifyContext = createContext(null);
+function CimplifyProvider({
+  client,
+  children,
+  onLocationChange
+}) {
+  const resolvedClient = useMemo(() => client ?? createDefaultClient(), [client]);
+  const onLocationChangeRef = useRef(onLocationChange);
+  const [business, setBusiness] = useState(null);
+  const [locations, setLocations] = useState([]);
+  const [currentLocation, setCurrentLocationState] = useState(null);
+  const [isReady, setIsReady] = useState(false);
+  useEffect(() => {
+    onLocationChangeRef.current = onLocationChange;
+  }, [onLocationChange]);
+  const isDemoMode = resolvedClient.getPublicKey().trim().length === 0;
+  const baseCurrency = business?.default_currency || DEFAULT_CURRENCY;
+  const [displayCurrencyOverride, setDisplayCurrencyOverride] = useState(
+    () => getStoredDisplayCurrency()
+  );
+  const [fxRate, setFxRate] = useState(null);
+  const displayCurrency = displayCurrencyOverride && displayCurrencyOverride !== baseCurrency ? displayCurrencyOverride : baseCurrency;
+  const setDisplayCurrency = useCallback(
+    (currency) => {
+      const normalized = currency?.trim().toUpperCase() || null;
+      if (normalized && !isSupportedCurrency(normalized)) {
+        return;
+      }
+      setDisplayCurrencyOverride(normalized);
+      setStoredDisplayCurrency(normalized);
+      if (!normalized || normalized === baseCurrency) {
+        setFxRate(null);
+      }
+    },
+    [baseCurrency]
+  );
+  useEffect(() => {
+    if (displayCurrency === baseCurrency || isDemoMode) {
+      setFxRate(null);
+      return;
+    }
+    let cancelled = false;
+    async function fetchRate() {
+      const result = await resolvedClient.fx.getRate(
+        baseCurrency,
+        displayCurrency
+      );
+      if (cancelled) return;
+      if (result.ok) {
+        setFxRate(result.value.rate);
+      } else {
+        setFxRate(null);
+      }
+    }
+    void fetchRate();
+    const intervalId = setInterval(() => void fetchRate(), FX_REFRESH_INTERVAL);
+    return () => {
+      cancelled = true;
+      clearInterval(intervalId);
+    };
+  }, [resolvedClient, baseCurrency, displayCurrency, isDemoMode]);
+  const convertPrice = useCallback(
+    (amount) => {
+      const num = typeof amount === "string" ? parseFloat(amount) : amount;
+      if (isNaN(num)) return 0;
+      if (!fxRate || displayCurrency === baseCurrency) return num;
+      return Math.round(num * fxRate * 100) / 100;
+    },
+    [fxRate, displayCurrency, baseCurrency]
+  );
+  const setCurrentLocation = useCallback(
+    (location) => {
+      setCurrentLocationState(location);
+      resolvedClient.setLocationId(location.id);
+      setStoredLocationId(location.id);
+      onLocationChangeRef.current?.(location);
+    },
+    [resolvedClient]
+  );
+  useEffect(() => {
+    let cancelled = false;
+    async function bootstrap() {
+      setIsReady(false);
+      if (isDemoMode) {
+        if (!cancelled) {
+          setBusiness(null);
+          setLocations([]);
+          setCurrentLocationState(null);
+          resolvedClient.setLocationId(null);
+          setStoredLocationId(null);
+          setIsReady(true);
+        }
+        return;
+      }
+      const [businessResult, locationsResult] = await Promise.all([
+        resolvedClient.business.getInfo(),
+        resolvedClient.business.getLocations()
+      ]);
+      if (cancelled) {
+        return;
+      }
+      const nextBusiness = businessResult.ok ? businessResult.value : null;
+      const nextLocations = locationsResult.ok && Array.isArray(locationsResult.value) ? locationsResult.value : [];
+      const initialLocation = resolveInitialLocation(nextLocations);
+      setBusiness(nextBusiness);
+      if (nextBusiness?.id) {
+        resolvedClient.setBusinessId(nextBusiness.id);
+      }
+      setLocations(nextLocations);
+      if (initialLocation) {
+        setCurrentLocationState(initialLocation);
+        resolvedClient.setLocationId(initialLocation.id);
+        setStoredLocationId(initialLocation.id);
+      } else {
+        setCurrentLocationState(null);
+        resolvedClient.setLocationId(null);
+        setStoredLocationId(null);
+      }
+      setIsReady(true);
+    }
+    bootstrap().catch(() => {
+      if (cancelled) {
+        return;
+      }
+      setBusiness(null);
+      setLocations([]);
+      setCurrentLocationState(null);
+      resolvedClient.setLocationId(null);
+      setStoredLocationId(null);
+      setIsReady(true);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [resolvedClient, isDemoMode]);
+  const contextValue = useMemo(
+    () => ({
+      client: resolvedClient,
+      business,
+      currency: baseCurrency,
+      country: business?.country_code || DEFAULT_COUNTRY,
+      locations,
+      currentLocation,
+      setCurrentLocation,
+      isReady,
+      isDemoMode,
+      baseCurrency,
+      displayCurrency,
+      setDisplayCurrency,
+      convertPrice,
+      fxRate
+    }),
+    [
+      resolvedClient,
+      business,
+      baseCurrency,
+      locations,
+      currentLocation,
+      setCurrentLocation,
+      isReady,
+      isDemoMode,
+      displayCurrency,
+      setDisplayCurrency,
+      convertPrice,
+      fxRate
+    ]
+  );
+  return /* @__PURE__ */ jsx(CimplifyContext.Provider, { value: contextValue, children });
+}
+function useCimplify() {
+  const context = useContext(CimplifyContext);
+  if (!context) {
+    throw new Error("useCimplify must be used within CimplifyProvider");
+  }
+  return context;
 }
-var LOCATION_STORAGE_KEY = "cimplify_location_id";
-var DISPLAY_CURRENCY_STORAGE_KEY = "cimplify_display_currency";
-var FX_REFRESH_INTERVAL = 12e4;
-var DEFAULT_CURRENCY = "USD";
-var DEFAULT_COUNTRY = "US";
-function createDefaultClient() {
-  const processRef = globalThis.process;
-  const envPublicKey = processRef?.env?.NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY || "";
-  return createCimplifyClient({ publicKey: envPublicKey });
+function useOptionalCimplify() {
+  return useContext(CimplifyContext);
 }
-function getStoredLocationId() {
-  if (typeof window === "undefined" || !window.localStorage) {
-    return null;
-  }
-  const value = window.localStorage.getItem(LOCATION_STORAGE_KEY);
-  if (!value) {
-    return null;
-  }
-  const normalized = value.trim();
-  return normalized.length > 0 ? normalized : null;
+var SPACE = { sm: 8};
+function shellColors(isDark, primaryColor) {
+  return {
+    text: isDark ? "#f4f4f5" : "#1a1a1a",
+    textSecondary: isDark ? "#a1a1aa" : "#52525b",
+    textMuted: isDark ? "#71717a" : "#a1a1aa",
+    border: isDark ? "#27272a" : "#e4e4e7",
+    surface: isDark ? "#18181b" : "#fafafa",
+    error: "#dc2626",
+    primary: primaryColor
+  };
 }
-function setStoredLocationId(locationId) {
-  if (typeof window === "undefined" || !window.localStorage) {
-    return;
+function statusToLabel(status) {
+  if (!status) {
+    return "";
   }
-  if (!locationId) {
-    window.localStorage.removeItem(LOCATION_STORAGE_KEY);
-    return;
+  if (status === "preparing") {
+    return "Preparing checkout";
   }
-  window.localStorage.setItem(LOCATION_STORAGE_KEY, locationId);
-}
-function getStoredDisplayCurrency() {
-  if (typeof window === "undefined" || !window.localStorage) {
-    return null;
+  if (status === "recovering") {
+    return "Resuming payment";
   }
-  const value = window.localStorage.getItem(DISPLAY_CURRENCY_STORAGE_KEY);
-  if (!value) {
-    return null;
+  if (status === "processing") {
+    return "Processing payment";
   }
-  const normalized = value.trim().toUpperCase();
-  return normalized.length > 0 ? normalized : null;
-}
-function setStoredDisplayCurrency(currency) {
-  if (typeof window === "undefined" || !window.localStorage) {
-    return;
+  if (status === "awaiting_authorization") {
+    return "Waiting for authorization";
   }
-  if (!currency) {
-    window.localStorage.removeItem(DISPLAY_CURRENCY_STORAGE_KEY);
-    return;
+  if (status === "polling") {
+    return "Confirming payment";
   }
-  window.localStorage.setItem(DISPLAY_CURRENCY_STORAGE_KEY, currency.toUpperCase());
-}
-function resolveInitialLocation(locations) {
-  if (locations.length === 0) {
-    return null;
+  if (status === "finalizing") {
+    return "Finalizing order";
   }
-  const storedId = getStoredLocationId();
-  if (storedId) {
-    const matched = locations.find((location) => location.id === storedId);
-    if (matched) {
-      return matched;
-    }
+  if (status === "success") {
+    return "Payment complete";
   }
-  return locations[0];
+  return "Payment failed";
 }
-var CimplifyContext = createContext(null);
-function CimplifyProvider({
+function CimplifyCheckout({
   client,
-  children,
-  onLocationChange
+  businessId,
+  cartId,
+  locationId,
+  linkUrl,
+  orderTypes,
+  enrollInLink = true,
+  onComplete,
+  onError,
+  onStatusChange,
+  appearance,
+  demoMode,
+  className
 }) {
-  const resolvedClient = useMemo(() => client ?? createDefaultClient(), [client]);
-  const onLocationChangeRef = useRef(onLocationChange);
-  const [business, setBusiness] = useState(null);
-  const [locations, setLocations] = useState([]);
-  const [currentLocation, setCurrentLocationState] = useState(null);
-  const [isReady, setIsReady] = useState(false);
-  useEffect(() => {
-    onLocationChangeRef.current = onLocationChange;
-  }, [onLocationChange]);
-  const isDemoMode = resolvedClient.getPublicKey().trim().length === 0;
-  const baseCurrency = business?.default_currency || DEFAULT_CURRENCY;
-  const [displayCurrencyOverride, setDisplayCurrencyOverride] = useState(
-    () => getStoredDisplayCurrency()
+  const resolvedOrderTypes = useMemo(
+    () => orderTypes && orderTypes.length > 0 ? orderTypes : ["pickup", "delivery"],
+    [orderTypes]
   );
-  const [fxRate, setFxRate] = useState(null);
-  const displayCurrency = displayCurrencyOverride && displayCurrencyOverride !== baseCurrency ? displayCurrencyOverride : baseCurrency;
-  const setDisplayCurrency = useCallback(
-    (currency) => {
-      const normalized = currency?.trim().toUpperCase() || null;
-      setDisplayCurrencyOverride(normalized);
-      setStoredDisplayCurrency(normalized);
-      if (!normalized || normalized === baseCurrency) {
-        setFxRate(null);
-      }
-    },
-    [baseCurrency]
+  const [orderType, setOrderType] = useState(resolvedOrderTypes[0] || "pickup");
+  const [status, setStatus] = useState(null);
+  const [statusText, setStatusText] = useState("");
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [isInitializing, setIsInitializing] = useState(false);
+  const [errorMessage, setErrorMessage] = useState(null);
+  const [resolvedBusinessId, setResolvedBusinessId] = useState(businessId ?? null);
+  const [resolvedCartId, setResolvedCartId] = useState(cartId ?? null);
+  const [resolvedCart, setResolvedCart] = useState(null);
+  const checkoutMountRef = useRef(null);
+  const elementsRef = useRef(null);
+  const activeCheckoutRef = useRef(null);
+  const initialAppearanceRef = useRef(appearance);
+  const hasWarnedInlineAppearanceRef = useRef(false);
+  const isMountedRef = useRef(true);
+  const demoRunRef = useRef(0);
+  const isDemoCheckout = demoMode ?? client.getPublicKey().trim().length === 0;
+  const isTestMode = client.isTestMode();
+  const cimplifyCtx = useOptionalCimplify();
+  const fxOptions = useMemo(() => {
+    if (!cimplifyCtx?.fxRate) return void 0;
+    if (cimplifyCtx.displayCurrency === cimplifyCtx.baseCurrency) return void 0;
+    return {
+      displayCurrency: cimplifyCtx.displayCurrency,
+      convertPrice: cimplifyCtx.convertPrice
+    };
+  }, [cimplifyCtx?.fxRate, cimplifyCtx?.displayCurrency, cimplifyCtx?.baseCurrency, cimplifyCtx?.convertPrice]);
+  const fxOptionsRef = useRef(fxOptions);
+  fxOptionsRef.current = fxOptions;
+  const resolvedCartRef = useRef(resolvedCart);
+  resolvedCartRef.current = resolvedCart;
+  const primaryColor = appearance?.variables?.primaryColor || "#0a2540";
+  const isDark = appearance?.theme === "dark";
+  const emitStatus = React3.useEffectEvent(
+    (nextStatus, context = {}) => {
+      setStatus(nextStatus);
+      setStatusText(context.display_text || "");
+      onStatusChange?.(nextStatus, context);
+    }
+  );
+  const fireError = React3.useEffectEvent(
+    (error) => {
+      onError?.(error);
+    }
   );
   useEffect(() => {
-    if (displayCurrency === baseCurrency || isDemoMode) {
-      setFxRate(null);
-      return;
+    if (!resolvedOrderTypes.includes(orderType)) {
+      setOrderType(resolvedOrderTypes[0] || "pickup");
     }
-    let cancelled = false;
-    async function fetchRate() {
-      const result = await resolvedClient.fx.getRate(
-        baseCurrency,
-        displayCurrency
+  }, [resolvedOrderTypes, orderType]);
+  useEffect(() => {
+    if (appearance && appearance !== initialAppearanceRef.current && !hasWarnedInlineAppearanceRef.current) {
+      hasWarnedInlineAppearanceRef.current = true;
+      console.warn(
+        "[Cimplify] `appearance` prop reference changed after mount. Elements keep the initial appearance to avoid iframe remount. Memoize appearance with useMemo() to remove this warning."
       );
-      if (!cancelled && result.ok) {
-        setFxRate(result.value.rate);
+    }
+  }, [appearance]);
+  useEffect(() => {
+    let cancelled = false;
+    async function bootstrap() {
+      if (isDemoCheckout) {
+        if (!cancelled) {
+          setResolvedBusinessId(businessId ?? null);
+          setResolvedCartId(cartId ?? "cart_demo");
+          setIsInitializing(false);
+          setErrorMessage(null);
+        }
+        return;
+      }
+      const needsBusinessResolve = !businessId;
+      const needsCartResolve = !cartId;
+      if (!needsBusinessResolve && !needsCartResolve) {
+        if (!cancelled) {
+          setResolvedBusinessId(businessId || null);
+          setResolvedCartId(cartId || null);
+          setIsInitializing(false);
+          setErrorMessage(null);
+        }
+        client.cart.get().then((cartResult) => {
+          if (!cancelled && cartResult.ok && cartResult.value) {
+            setResolvedCart(cartResult.value);
+          }
+        }).catch(() => {
+        });
+        return;
+      }
+      if (!cancelled) {
+        setIsInitializing(true);
+        setErrorMessage(null);
+      }
+      let nextBusinessId = businessId ?? null;
+      if (!nextBusinessId) {
+        try {
+          nextBusinessId = await client.resolveBusinessId();
+        } catch {
+          if (!cancelled) {
+            const message = "Unable to initialize checkout business context.";
+            setResolvedBusinessId(null);
+            setResolvedCartId(null);
+            setErrorMessage(message);
+            setIsInitializing(false);
+            fireError({ code: "BUSINESS_ID_REQUIRED", message });
+          }
+          return;
+        }
+      }
+      let nextCartId = cartId ?? null;
+      if (!nextCartId) {
+        const cartResult = await client.cart.get();
+        if (!cartResult.ok || !cartResult.value?.id || cartResult.value.items.length === 0) {
+          if (!cancelled) {
+            const message = "Your cart is empty. Add items before checkout.";
+            setResolvedBusinessId(nextBusinessId);
+            setResolvedCartId(null);
+            setErrorMessage(message);
+            setIsInitializing(false);
+            fireError({ code: "CART_EMPTY", message });
+          }
+          return;
+        }
+        nextCartId = cartResult.value.id;
+        if (!cancelled) {
+          setResolvedCart(cartResult.value);
+        }
+      }
+      if (!cancelled) {
+        setResolvedBusinessId(nextBusinessId);
+        setResolvedCartId(nextCartId);
+        setIsInitializing(false);
+        setErrorMessage(null);
       }
     }
-    void fetchRate();
-    const intervalId = setInterval(() => void fetchRate(), FX_REFRESH_INTERVAL);
+    void bootstrap();
     return () => {
       cancelled = true;
-      clearInterval(intervalId);
     };
-  }, [resolvedClient, baseCurrency, displayCurrency, isDemoMode]);
-  const convertPrice = useCallback(
-    (amount) => {
-      const num = typeof amount === "string" ? parseFloat(amount) : amount;
-      if (isNaN(num)) return 0;
-      if (!fxRate || displayCurrency === baseCurrency) return num;
-      return Math.round(num * fxRate * 100) / 100;
-    },
-    [fxRate, displayCurrency, baseCurrency]
-  );
-  const setCurrentLocation = useCallback(
-    (location) => {
-      setCurrentLocationState(location);
-      resolvedClient.setLocationId(location.id);
-      setStoredLocationId(location.id);
-      onLocationChangeRef.current?.(location);
-    },
-    [resolvedClient]
-  );
+  }, [businessId, cartId, client, isDemoCheckout]);
   useEffect(() => {
-    let cancelled = false;
-    async function bootstrap() {
-      setIsReady(false);
-      if (isDemoMode) {
-        if (!cancelled) {
-          setBusiness(null);
-          setLocations([]);
-          setCurrentLocationState(null);
-          resolvedClient.setLocationId(null);
-          setStoredLocationId(null);
-          setIsReady(true);
+    return () => {
+      isMountedRef.current = false;
+      demoRunRef.current += 1;
+      activeCheckoutRef.current?.abort();
+      activeCheckoutRef.current = null;
+    };
+  }, []);
+  const handleSubmit = React3.useEffectEvent(async () => {
+    if (isSubmitting || isInitializing || !resolvedCartId) {
+      if (!resolvedCartId && !isInitializing) {
+        const message = "Your cart is empty. Add items before checkout.";
+        setErrorMessage(message);
+        fireError({ code: "CART_EMPTY", message });
+      }
+      return;
+    }
+    setErrorMessage(null);
+    setIsSubmitting(true);
+    emitStatus("preparing", { display_text: statusToLabel("preparing") });
+    if (isDemoCheckout) {
+      const runId = demoRunRef.current + 1;
+      demoRunRef.current = runId;
+      const wait = async (ms) => {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+        return isMountedRef.current && runId === demoRunRef.current;
+      };
+      try {
+        if (!await wait(400)) return;
+        emitStatus("processing", { display_text: statusToLabel("processing") });
+        if (!await wait(900)) return;
+        emitStatus("polling", { display_text: statusToLabel("polling") });
+        if (!await wait(1200)) return;
+        const result = {
+          success: true,
+          order: {
+            id: `ord_demo_${Date.now()}`,
+            order_number: `DEMO-${Math.random().toString(36).slice(2, 8).toUpperCase()}`,
+            status: "confirmed",
+            total: "0.00",
+            currency: "USD"
+          }
+        };
+        emitStatus("success", {
+          order_id: result.order?.id,
+          order_number: result.order?.order_number,
+          display_text: statusToLabel("success")
+        });
+        onComplete(result);
+      } finally {
+        if (isMountedRef.current && runId === demoRunRef.current) {
+          setIsSubmitting(false);
         }
-        return;
       }
-      const [businessResult, locationsResult] = await Promise.all([
-        resolvedClient.business.getInfo(),
-        resolvedClient.business.getLocations()
-      ]);
-      if (cancelled) {
+      return;
+    }
+    if (!elementsRef.current) {
+      const message = "Checkout is still initializing. Please try again.";
+      setErrorMessage(message);
+      fireError({ code: "CHECKOUT_NOT_READY", message });
+      setIsSubmitting(false);
+      return;
+    }
+    const checkout = elementsRef.current.processCheckout({
+      cart_id: resolvedCartId,
+      location_id: locationId ?? client.getLocationId() ?? void 0,
+      order_type: orderType,
+      enroll_in_link: enrollInLink,
+      on_status_change: emitStatus,
+      pay_currency: fxOptions?.displayCurrency
+    });
+    activeCheckoutRef.current = checkout;
+    try {
+      const result = await checkout;
+      if (result.success) {
+        onComplete(result);
         return;
       }
-      const nextBusiness = businessResult.ok ? businessResult.value : null;
-      const nextLocations = locationsResult.ok && Array.isArray(locationsResult.value) ? locationsResult.value : [];
-      const initialLocation = resolveInitialLocation(nextLocations);
-      setBusiness(nextBusiness);
-      if (nextBusiness?.id) {
-        resolvedClient.setBusinessId(nextBusiness.id);
-      }
-      setLocations(nextLocations);
-      if (initialLocation) {
-        setCurrentLocationState(initialLocation);
-        resolvedClient.setLocationId(initialLocation.id);
-        setStoredLocationId(initialLocation.id);
-      } else {
-        setCurrentLocationState(null);
-        resolvedClient.setLocationId(null);
-        setStoredLocationId(null);
+      const code = result.error?.code || "CHECKOUT_FAILED";
+      const message = result.error?.message || "Payment failed.";
+      setErrorMessage(message);
+      fireError({ code, message });
+    } finally {
+      if (isMountedRef.current) {
+        activeCheckoutRef.current = null;
+        setIsSubmitting(false);
       }
-      setIsReady(true);
     }
-    bootstrap().catch(() => {
-      if (cancelled) {
-        return;
+  });
+  useEffect(() => {
+    if (isDemoCheckout || !resolvedBusinessId) {
+      elementsRef.current = null;
+      return;
+    }
+    const elements = client.elements(resolvedBusinessId, {
+      appearance: initialAppearanceRef.current,
+      linkUrl
+    });
+    elementsRef.current = elements;
+    const checkout = elements.create("checkout", {
+      orderTypes: resolvedOrderTypes,
+      defaultOrderType: resolvedOrderTypes[0]
+    });
+    if (checkoutMountRef.current) {
+      checkout.mount(checkoutMountRef.current);
+    }
+    checkout.on("ready", () => {
+      const cart = resolvedCartRef.current;
+      if (cart) {
+        checkout.setCart(transformToCheckoutCart(cart, fxOptionsRef.current));
       }
-      setBusiness(null);
-      setLocations([]);
-      setCurrentLocationState(null);
-      resolvedClient.setLocationId(null);
-      setStoredLocationId(null);
-      setIsReady(true);
+    });
+    checkout.on("order_type_changed", (data) => {
+      const typed = data;
+      if (typed.orderType) {
+        setOrderType(typed.orderType);
+      }
+    });
+    checkout.on("request_submit", () => {
+      void handleSubmit();
     });
     return () => {
-      cancelled = true;
+      activeCheckoutRef.current?.abort();
+      activeCheckoutRef.current = null;
+      elements.destroy();
+      elementsRef.current = null;
     };
-  }, [resolvedClient, isDemoMode]);
-  const contextValue = useMemo(
-    () => ({
-      client: resolvedClient,
-      business,
-      currency: baseCurrency,
-      country: business?.country_code || DEFAULT_COUNTRY,
-      locations,
-      currentLocation,
-      setCurrentLocation,
-      isReady,
-      isDemoMode,
-      baseCurrency,
-      displayCurrency,
-      setDisplayCurrency,
-      convertPrice,
-      fxRate
-    }),
-    [
-      resolvedClient,
-      business,
-      baseCurrency,
-      locations,
-      currentLocation,
-      setCurrentLocation,
-      isReady,
-      isDemoMode,
-      displayCurrency,
-      setDisplayCurrency,
-      convertPrice,
-      fxRate
-    ]
-  );
-  return /* @__PURE__ */ jsx(CimplifyContext.Provider, { value: contextValue, children });
-}
-function useCimplify() {
-  const context = useContext(CimplifyContext);
-  if (!context) {
-    throw new Error("useCimplify must be used within CimplifyProvider");
+  }, [client, resolvedBusinessId, isDemoCheckout]);
+  useEffect(() => {
+    if (!resolvedCart || !elementsRef.current) return;
+    const checkoutElement = elementsRef.current.getElement("checkout");
+    if (checkoutElement) {
+      checkoutElement.setCart(transformToCheckoutCart(resolvedCart, fxOptions));
+    }
+  }, [resolvedCart, fxOptions]);
+  const colors = shellColors(isDark ?? false, primaryColor);
+  if (isInitializing) {
+    return /* @__PURE__ */ jsx("div", { className, "data-cimplify-checkout": "", children: /* @__PURE__ */ jsx("p", { "data-cimplify-status": "", style: { fontSize: 13, color: colors.textSecondary }, children: "Preparing checkout..." }) });
   }
-  return context;
-}
-function useOptionalCimplify() {
-  return useContext(CimplifyContext);
+  if (!isDemoCheckout && (!resolvedBusinessId || !resolvedCartId)) {
+    return /* @__PURE__ */ jsx("div", { className, "data-cimplify-checkout": "", children: /* @__PURE__ */ jsx("p", { "data-cimplify-error": "", style: { fontSize: 13, color: colors.error }, children: errorMessage || "Unable to initialize checkout. Please refresh and try again." }) });
+  }
+  return /* @__PURE__ */ jsxs("div", { className, "data-cimplify-checkout": "", children: [
+    isTestMode && !isDemoCheckout && /* @__PURE__ */ jsx(
+      "p",
+      {
+        "data-cimplify-test-mode": "",
+        style: {
+          marginBottom: "10px",
+          fontSize: "12px",
+          fontWeight: 600,
+          color: "#92400e"
+        },
+        children: "Test mode - no real charges"
+      }
+    ),
+    /* @__PURE__ */ jsx("div", { "data-cimplify-section": "checkout", children: /* @__PURE__ */ jsx("div", { ref: isDemoCheckout ? void 0 : checkoutMountRef }) }),
+    status && /* @__PURE__ */ jsx("p", { "data-cimplify-status": "", style: { marginTop: SPACE.sm, fontSize: 13, color: colors.textSecondary }, children: statusText || statusToLabel(status) }),
+    errorMessage && /* @__PURE__ */ jsx("p", { "data-cimplify-error": "", style: { marginTop: SPACE.sm, fontSize: 13, color: colors.error }, children: errorMessage })
+  ] });
 }
 function Price({ amount, className, prefix }) {
   const { displayCurrency, convertPrice } = useCimplify();