@cimplify/sdk 0.103.0 → 0.104.1

package/dist/react.mjs

@@ -1,13 +1,13 @@
 "use client";
-import { splitGenUIContent, messagePreview } from './chunk-U4MW6PYU.mjs';
-export { messagePreview, splitGenUIContent } from './chunk-U4MW6PYU.mjs';
 import { DURATION_UNIT, getVariantDisplayName, INPUT_FIELD_TYPE, isMultiDayService, serviceBillingMultiplier, PRODUCT_TYPE, BOUNDARY_KIND, resolveGallery, chatMessageCards, RENDER_HINT, displaysGrossPrices, DEFAULT_CDN_BASE_URL } from './chunk-3V4DVXV3.mjs';
 export { getVariantDisplayName } from './chunk-3V4DVXV3.mjs';
-import { SESSION_CLAIMED, SESSION_CLEARED, createCimplifyClient, AUTH_TOKEN_CHANGED, MUTATION_ERROR } from './chunk-GERXZQSX.mjs';
-import { generateIdempotencyKey, ELEMENT_TYPES, EVENT_TYPES, startSignIn } from './chunk-J6PNHDHL.mjs';
-import './chunk-GOHSXBKW.mjs';
-import { parsePrice, formatMoney, formatPrice, getVariantUnitPrice, getProductCurrency, getUnitPriceAtQuantity, isOnSale, getDiscountPercentage, getBasePrice, getPriceRange, formatPriceRange } from './chunk-M4URVKHE.mjs';
-import { isSupportedCurrency, currencyCode, CimplifyError } from './chunk-VNPEYLB2.mjs';
+import { chatRealtimeUpdateFromWire, SESSION_CLAIMED, SESSION_CLEARED, createCimplifyClient, AUTH_TOKEN_CHANGED, MUTATION_ERROR } from './chunk-UFOWPN3D.mjs';
+import { splitGenUIContent, messagePreview } from './chunk-U4MW6PYU.mjs';
+export { messagePreview, splitGenUIContent } from './chunk-U4MW6PYU.mjs';
+import { ELEMENT_TYPES, EVENT_TYPES, generateIdempotencyKey, startSignIn } from './chunk-V4457OKB.mjs';
+import { ORDER_TYPE, CHECKOUT_STATUS } from './chunk-33VCYWVL.mjs';
+import { parsePrice, formatMoney, formatPrice, getVariantUnitPrice, getProductCurrency, getUnitPriceAtQuantity, isOnSale, getDiscountPercentage, getBasePrice, getPriceRange, formatPriceRange } from './chunk-U54CWUUT.mjs';
+import { isSupportedCurrency, ErrorCode, currencyCode, CimplifyError } from './chunk-RBNBSQI7.mjs';
 import './chunk-3G6RQLXK.mjs';
 import React14, { createContext, lazy, memo, Suspense, useMemo, useContext, useRef, useCallback, useState, useEffect, useId, useSyncExternalStore } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -1494,25 +1494,28 @@ function statusToLabel(status) {
   if (!status) {
     return "";
   }
-  if (status === "preparing") {
+  if (status === CHECKOUT_STATUS.PREPARING) {
     return "Preparing checkout";
   }
-  if (status === "recovering") {
+  if (status === CHECKOUT_STATUS.REVIEWING_TERMS) {
+    return "Review updated terms";
+  }
+  if (status === CHECKOUT_STATUS.RECOVERING) {
     return "Resuming payment";
   }
-  if (status === "processing") {
+  if (status === CHECKOUT_STATUS.PROCESSING) {
     return "Processing payment";
   }
-  if (status === "awaiting_authorization") {
+  if (status === CHECKOUT_STATUS.AWAITING_AUTHORIZATION) {
     return "Waiting for authorization";
   }
-  if (status === "polling") {
+  if (status === CHECKOUT_STATUS.POLLING) {
     return "Confirming payment";
   }
-  if (status === "finalizing") {
+  if (status === CHECKOUT_STATUS.FINALIZING) {
     return "Finalizing order";
   }
-  if (status === "success") {
+  if (status === CHECKOUT_STATUS.SUCCESS) {
     return "Payment complete";
   }
   return "Payment failed";
@@ -1521,6 +1524,9 @@ function CimplifyCheckout({
   client,
   businessId,
   cartId,
+  intentId,
+  hostedSessionId,
+  initialTerms,
   locationId,
   linkUrl,
   orderTypes,
@@ -1534,14 +1540,14 @@ function CimplifyCheckout({
   className
 }) {
   const resolvedOrderTypes = useMemo(
-    () => orderTypes && orderTypes.length > 0 ? orderTypes : ["pickup", "delivery"],
+    () => orderTypes && orderTypes.length > 0 ? orderTypes : [ORDER_TYPE.PICKUP, ORDER_TYPE.DELIVERY],
     [orderTypes]
   );
   const resolvedDefaultOrderType = useMemo(() => {
     if (defaultOrderType && resolvedOrderTypes.includes(defaultOrderType)) {
       return defaultOrderType;
     }
-    return resolvedOrderTypes[0] || "pickup";
+    return resolvedOrderTypes[0] || ORDER_TYPE.PICKUP;
   }, [defaultOrderType, resolvedOrderTypes]);
   const [orderType, setOrderType] = useState(resolvedDefaultOrderType);
   const [status, setStatus] = useState(null);
@@ -1567,7 +1573,12 @@ function CimplifyCheckout({
       displayCurrency: cimplifyCtx.displayCurrency,
       convertPrice: cimplifyCtx.convertPrice
     };
-  }, [cimplifyCtx?.fxRate, cimplifyCtx?.displayCurrency, cimplifyCtx?.baseCurrency, cimplifyCtx?.convertPrice]);
+  }, [
+    cimplifyCtx?.fxRate,
+    cimplifyCtx?.displayCurrency,
+    cimplifyCtx?.baseCurrency,
+    cimplifyCtx?.convertPrice
+  ]);
   const fxOptionsRef = useRef(fxOptions);
   fxOptionsRef.current = fxOptions;
   const resolvedCartRef = useRef(resolvedCart);
@@ -1580,11 +1591,9 @@ function CimplifyCheckout({
       onStatusChange?.(nextStatus, context);
     }
   );
-  const fireError = React14.useEffectEvent(
-    (error) => {
-      onError?.(error);
-    }
-  );
+  const fireError = React14.useEffectEvent((error) => {
+    onError?.(error);
+  });
   useEffect(() => {
     if (!resolvedOrderTypes.includes(orderType)) {
       setOrderType(resolvedDefaultOrderType);
@@ -1602,20 +1611,23 @@ function CimplifyCheckout({
     let cancelled = false;
     async function bootstrap() {
       const needsBusinessResolve = !businessId;
-      const needsCartResolve = !cartId;
+      const needsCartResolve = !cartId && !intentId;
       if (!needsBusinessResolve && !needsCartResolve) {
         if (!cancelled) {
           setResolvedBusinessId(businessId || null);
-          setResolvedCartId(cartId || null);
+          setResolvedCartId(intentId ? null : cartId || null);
+          if (intentId) setResolvedCart(null);
           setIsInitializing(false);
           setErrorMessage(null);
         }
-        client.cart.get().then((cartResult) => {
-          if (!cancelled && cartResult.ok && cartResult.value) {
-            setResolvedCart(cartResult.value);
-          }
-        }).catch(() => {
-        });
+        if (!intentId) {
+          client.cart.get().then((cartResult) => {
+            if (!cancelled && cartResult.ok && cartResult.value) {
+              setResolvedCart(cartResult.value);
+            }
+          }).catch(() => {
+          });
+        }
         return;
       }
       if (!cancelled) {
@@ -1633,13 +1645,13 @@ function CimplifyCheckout({
             setResolvedCartId(null);
             setErrorMessage(message);
             setIsInitializing(false);
-            fireError({ code: "BUSINESS_ID_REQUIRED", message });
+            fireError({ code: ErrorCode.BUSINESS_ID_REQUIRED, message });
           }
           return;
         }
       }
-      let nextCartId = cartId ?? null;
-      if (!nextCartId) {
+      let nextCartId = intentId ? null : cartId ?? null;
+      if (!intentId && !nextCartId) {
         const cartResult = await client.cart.get();
         if (!cartResult.ok || !cartResult.value?.id || cartResult.value.items.length === 0) {
           if (!cancelled) {
@@ -1648,7 +1660,7 @@ function CimplifyCheckout({
             setResolvedCartId(null);
             setErrorMessage(message);
             setIsInitializing(false);
-            fireError({ code: "CART_EMPTY", message });
+            fireError({ code: ErrorCode.CART_EMPTY, message });
           }
           return;
         }
@@ -1668,7 +1680,7 @@ function CimplifyCheckout({
     return () => {
       cancelled = true;
     };
-  }, [businessId, cartId, client]);
+  }, [businessId, cartId, client, intentId]);
   useEffect(() => {
     return () => {
       isMountedRef.current = false;
@@ -1677,31 +1689,36 @@ function CimplifyCheckout({
     };
   }, []);
   const handleSubmit = React14.useEffectEvent(async () => {
-    if (isSubmitting || isInitializing || !resolvedCartId) {
-      if (!resolvedCartId && !isInitializing) {
-        const message = "Your cart is empty. Add items before checkout.";
+    if (isSubmitting || isInitializing || !resolvedCartId && !intentId) {
+      if (!resolvedCartId && !intentId && !isInitializing) {
+        const message = "A cart or purchase intent is required before checkout.";
         setErrorMessage(message);
-        fireError({ code: "CART_EMPTY", message });
+        fireError({ code: ErrorCode.CHECKOUT_AUTHORITY_REQUIRED, message });
       }
       return;
     }
     setErrorMessage(null);
     setIsSubmitting(true);
-    emitStatus("preparing", { display_text: statusToLabel("preparing") });
+    emitStatus(CHECKOUT_STATUS.PREPARING, {
+      display_text: statusToLabel(CHECKOUT_STATUS.PREPARING)
+    });
     if (!elementsRef.current) {
       const message = "Checkout is still initializing. Please try again.";
       setErrorMessage(message);
-      fireError({ code: "CHECKOUT_NOT_READY", message });
+      fireError({ code: ErrorCode.CHECKOUT_NOT_READY, message });
       setIsSubmitting(false);
       return;
     }
     const checkout = elementsRef.current.processCheckout({
-      cart_id: resolvedCartId,
+      cart_id: intentId ? void 0 : resolvedCartId ?? void 0,
+      intent_id: intentId,
+      hosted_session_id: hostedSessionId,
+      initial_terms: initialTerms,
       location_id: locationId ?? client.getLocationId() ?? void 0,
       order_type: orderType,
       enroll_in_link: enrollInLink,
       on_status_change: emitStatus,
-      pay_currency: fxOptions?.displayCurrency
+      pay_currency: intentId ? void 0 : fxOptions?.displayCurrency
     });
     activeCheckoutRef.current = checkout;
     try {
@@ -1710,7 +1727,7 @@ function CimplifyCheckout({
         onComplete(result);
         return;
       }
-      const code = result.error?.code || "CHECKOUT_FAILED";
+      const code = result.error?.code || ErrorCode.CHECKOUT_FAILED;
       const message = result.error?.message || "Payment failed.";
       setErrorMessage(message);
       fireError({ code, message });
@@ -1731,27 +1748,30 @@ function CimplifyCheckout({
       linkUrl
     });
     elementsRef.current = elements;
-    const checkout = elements.create("checkout", {
+    const checkout = elements.create(ELEMENT_TYPES.CHECKOUT, {
       orderTypes: resolvedOrderTypes,
       defaultOrderType: resolvedDefaultOrderType,
-      submitLabel
+      submitLabel,
+      intentId,
+      hostedSessionId,
+      initialTerms
     });
     if (checkoutMountRef.current) {
       checkout.mount(checkoutMountRef.current);
     }
-    checkout.on("ready", () => {
+    checkout.on(EVENT_TYPES.READY, () => {
       const cart = resolvedCartRef.current;
       if (cart) {
         checkout.setCart(transformToCheckoutCart(cart, fxOptionsRef.current));
       }
     });
-    checkout.on("order_type_changed", (data) => {
+    checkout.on(EVENT_TYPES.ORDER_TYPE_CHANGED, (data) => {
       const typed = data;
       if (typed.orderType) {
         setOrderType(typed.orderType);
       }
     });
-    checkout.on("request_submit", () => {
+    checkout.on(EVENT_TYPES.REQUEST_SUBMIT, () => {
       void handleSubmit();
     });
     return () => {
@@ -1765,11 +1785,14 @@ function CimplifyCheckout({
     resolvedBusinessId,
     resolvedOrderTypes,
     resolvedDefaultOrderType,
-    submitLabel
+    submitLabel,
+    intentId,
+    hostedSessionId,
+    initialTerms
   ]);
   useEffect(() => {
     if (!resolvedCart || !elementsRef.current) return;
-    const checkoutElement = elementsRef.current.getElement("checkout");
+    const checkoutElement = elementsRef.current.getElement(ELEMENT_TYPES.CHECKOUT);
     if (checkoutElement) {
       checkoutElement.setCart(transformToCheckoutCart(resolvedCart, fxOptions));
     }
@@ -1778,7 +1801,7 @@ function CimplifyCheckout({
   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 (!resolvedBusinessId || !resolvedCartId) {
+  if (!resolvedBusinessId || !resolvedCartId && !intentId) {
     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: [
@@ -1796,7 +1819,14 @@ function CimplifyCheckout({
       }
     ),
     /* @__PURE__ */ jsx("div", { "data-cimplify-section": "checkout", children: /* @__PURE__ */ jsx("div", { ref: checkoutMountRef }) }),
-    status && /* @__PURE__ */ jsx("p", { "data-cimplify-status": "", style: { marginTop: 8, fontSize: 13, color: colors.textSecondary }, children: statusText || statusToLabel(status) }),
+    status && /* @__PURE__ */ jsx(
+      "p",
+      {
+        "data-cimplify-status": "",
+        style: { marginTop: 8, fontSize: 13, color: colors.textSecondary },
+        children: statusText || statusToLabel(status)
+      }
+    ),
     errorMessage && /* @__PURE__ */ jsx("p", { "data-cimplify-error": "", style: { marginTop: 8, fontSize: 13, color: colors.error }, children: errorMessage })
   ] });
 }
@@ -3288,8 +3318,7 @@ var STATUS_TONE2 = {
   picked_up: "positive",
   served: "positive",
   completed: "positive",
-  cancelled: "muted",
-  refunded: "muted"
+  cancelled: "muted"
 };
 var PAYMENT_TONE = {
   paid: "positive",
@@ -4589,9 +4618,12 @@ function useCategories(options = {}) {
   const { data, isLoading, error, refetch } = categoriesQuery(options);
   return { categories: data ?? [], isLoading, error, refetch };
 }
-var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "cancelled", "refunded"]);
+var TERMINAL_STATUSES = {
+  completed: true,
+  cancelled: true
+};
 function isTerminalOrderStatus(status) {
-  return TERMINAL_STATUSES.has(status);
+  return Object.prototype.hasOwnProperty.call(TERMINAL_STATUSES, status);
 }
 var orderCache = /* @__PURE__ */ new Map();
 var orderInflight = /* @__PURE__ */ new Map();
@@ -4684,7 +4716,7 @@ function useOrder(orderId, options = {}) {
   useEffect(() => {
     void load(false);
   }, [load]);
-  const isTerminal = order ? TERMINAL_STATUSES.has(order.status) : false;
+  const isTerminal = order ? isTerminalOrderStatus(order.status) : false;
   useEffect(() => {
     if (!poll || !enabled || normalizedOrderId.length === 0 || isTerminal) {
       return;
@@ -6139,7 +6171,7 @@ function useChat(options = {}) {
     if (!c) return;
     const last = lastConfirmedMessage();
     const result = await c.support.getMessages({
-      after: last?.created_at,
+      afterSequence: last?.sequence,
       limit: 50
     });
     if (result.ok && result.value.length > 0) {
@@ -6182,9 +6214,9 @@ function useChat(options = {}) {
       );
       return mergeMessages(snapshot, extras);
     });
-    aiEnabledRef.current = result.value.conversation.ai_enabled;
-    setHumanRequested(result.value.conversation.needs_human_review ?? false);
-    setSeenAt(result.value.conversation.team_read_at ?? null);
+    aiEnabledRef.current = result.value.conversation.ai_mode === "auto";
+    setHumanRequested(result.value.conversation.ai_mode === "off");
+    setSeenAt(null);
     setMayHaveOlder(result.value.messages.length >= 50);
   }, []);
   const connectWebSocket = useCallback(() => {
@@ -6212,23 +6244,36 @@ function useChat(options = {}) {
     ws.onmessage = (event) => {
       try {
         const envelope = JSON.parse(event.data);
-        if (envelope.type === "message.created" && envelope.data) {
-          appendMessages([envelope.data]);
-        } else if (envelope.type === "thread.read") {
-          const at = envelope.data?.last_read_at;
-          if (at) setSeenAt((prev) => !prev || prev < at ? at : prev);
-        } else if (envelope.type === "thread.responding") {
-          const active = envelope.data?.active;
-          if (active) startAwaitingReply();
-          else stopAwaitingReply();
-        } else if (envelope.type === "resync") {
-          const latest = envelope.latest_message_at;
+        const update = chatRealtimeUpdateFromWire(envelope);
+        if (update.kind === "message") {
+          appendMessages([update.message]);
+        } else if (update.kind === "message_updated") {
+          lastActivityRef.current = Date.now();
+          setMessages(
+            (previous) => update.message.deleted_at ? previous.filter((message) => message.id !== update.message.id) : previous.map(
+              (message) => message.id === update.message.id ? update.message : message
+            )
+          );
+        } else if (update.kind === "business_read") {
+          setSeenAt(
+            (prev) => !prev || prev < update.occurredAt ? update.occurredAt : prev
+          );
+        } else if (update.kind === "ai_mode") {
+          aiEnabledRef.current = update.mode === "auto";
+          setHumanRequested(update.mode === "off");
+          if (update.mode !== "auto") stopAwaitingReply();
+        } else if (update.kind === "handoff") {
+          aiEnabledRef.current = false;
+          setHumanRequested(true);
+          stopAwaitingReply();
+        } else if (update.kind === "reload") {
+          void resyncConversation();
+        } else if (update.kind === "resync") {
+          const latest = update.latestSequence;
           const last = lastConfirmedMessage();
-          if (latest && (!last || new Date(last.created_at).getTime() < new Date(latest).getTime())) {
+          if (latest === void 0 || !last?.sequence || last.sequence < latest) {
             fetchNewMessages();
           }
-        } else if (envelope.type === "rekey") {
-          void resyncConversation();
         }
       } catch {
       }
@@ -6249,7 +6294,15 @@ function useChat(options = {}) {
     ws.onerror = () => {
     };
     wsRef.current = ws;
-  }, [appendMessages, startPolling, stopPolling, fetchNewMessages, resyncConversation, lastConfirmedMessage]);
+  }, [
+    appendMessages,
+    startPolling,
+    stopPolling,
+    fetchNewMessages,
+    resyncConversation,
+    lastConfirmedMessage,
+    stopAwaitingReply
+  ]);
   const resetConversation = useCallback(() => {
     stopPolling();
     if (wsReconnectTimerRef.current) {
@@ -6277,9 +6330,9 @@ function useChat(options = {}) {
       const c = clientRef.current;
       setMessages(value.messages);
       setConversationOpened(true);
-      aiEnabledRef.current = value.conversation.ai_enabled;
-      setHumanRequested(value.conversation.needs_human_review ?? false);
-      setSeenAt(value.conversation.team_read_at ?? null);
+      aiEnabledRef.current = value.conversation.ai_mode === "auto";
+      setHumanRequested(value.conversation.ai_mode === "off");
+      setSeenAt(null);
       setMayHaveOlder(value.messages.length >= 50);
       setClaimedAs(c?.support.claimedCustomerName ?? null);
       connectWebSocket();
@@ -6448,7 +6501,7 @@ function useChat(options = {}) {
     const c = clientRef.current;
     const earliest = messagesRef.current[0];
     if (!c || !earliest) return false;
-    const result = await c.support.getMessages({ before: earliest.created_at, limit: 50 });
+    const result = await c.support.getMessages({ beforeSequence: earliest.sequence, limit: 50 });
     if (!result.ok) {
       setError(result.error);
       return false;
@@ -13454,8 +13507,7 @@ var STATUS_LABELS = {
   delivered: "Delivered",
   picked_up: "Picked Up",
   completed: "Completed",
-  cancelled: "Cancelled",
-  refunded: "Refunded"
+  cancelled: "Cancelled"
 };
 var PAYMENT_STATE_LABELS = {
   not_paid: "Not Paid",
@@ -13667,8 +13719,7 @@ var STATUS_LABELS2 = {
   delivered: "Delivered",
   picked_up: "Picked Up",
   completed: "Completed",
-  cancelled: "Cancelled",
-  refunded: "Refunded"
+  cancelled: "Cancelled"
 };
 function OrderHistory({
   orders: ordersProp,
@@ -20871,6 +20922,7 @@ function KeepConversation({ client }) {
   const [dismissed, setDismissed] = useState(readKeepDismissed);
   const [contact, setContact] = useState("");
   const [code, setCode] = useState("");
+  const [challengeId, setChallengeId] = useState(null);
   const [busy, setBusy] = useState(false);
   const [verifyError, setVerifyError] = useState(null);
   if (dismissed) return null;
@@ -20883,6 +20935,7 @@ function KeepConversation({ client }) {
     const result = await client.link.requestOtp({ contact: trimmed, contact_type: contactType });
     setBusy(false);
     if (result.ok) {
+      setChallengeId(result.value.challenge_id);
       setCode("");
       setStep("code");
     } else {
@@ -20890,10 +20943,11 @@ function KeepConversation({ client }) {
     }
   };
   const verify = async (value) => {
-    if (value.length !== 6 || busy) return;
+    if (value.length !== 6 || busy || challengeId === null) return;
     setBusy(true);
     setVerifyError(null);
     const result = await client.link.verifyOtp({
+      ...challengeId === void 0 ? {} : { challenge_id: challengeId },
       contact: contact.trim(),
       contact_type: contactType,
       otp_code: value

package/dist/{server-DoXIpSd7.d.ts → server-DJ0mSs9i.d.mts}

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import { bk as ProductInputField, bF as SubmitAuthorizationInput } from './payment-H5LoIvXU.js';
+import { dH as ProductInputField, e3 as PurchaseIntentView, cx as MintPurchaseIntentRequest, bc as ConfirmPurchaseIntentResponse, el as SubmitAuthorizationInput, ab as CHECKOUT_NEXT_ACTION, i as ConfirmPurchaseIntentRequest, em as SubmitPurchaseIntentActionRequest } from './checkout-BqK9XUz5.mjs';
 
 interface Clock {
     now(): Date;
@@ -71,6 +71,7 @@ interface Session {
     id: string;
     token: string;
     business_id: string;
+    account_id?: string;
     customer_id?: string;
     customer_name?: string;
     customer_email?: string;
@@ -296,6 +297,17 @@ interface MockOrder {
     created_at: string;
     updated_at: string;
 }
+interface MockPurchaseIntent extends PurchaseIntentView {
+    intent_owner: {
+        kind: "account";
+        id: string;
+    } | {
+        kind: "storefront_session";
+        id: string;
+    };
+    mint_request: MintPurchaseIntentRequest;
+    last_confirmation?: ConfirmPurchaseIntentResponse;
+}
 interface MockSubscription {
     id: string;
     business_id: string;
@@ -552,6 +564,7 @@ interface StateRegistry {
     collections: Store<MockCollection>;
     carts: Store<MockCart>;
     orders: Store<MockOrder>;
+    purchaseIntents: Store<MockPurchaseIntent>;
     subscriptions: Store<MockSubscription>;
     bookings: Store<MockBooking>;
     services: Store<MockService>;
@@ -583,7 +596,7 @@ interface AuthService {
         expires_at: string;
         code_hint?: string;
     };
-    verifyOtp(contact: string, code: string): Session;
+    verifyOtp(contact: string, code: string, challengeId?: string): Session;
     logout(token: string): void;
     updateProfile(token: string, profile: {
         name?: string;
@@ -730,66 +743,27 @@ interface CartService {
     resolveCart(session: Session): MockCart;
 }
 
-interface CheckoutService {
-    process(session: Session, body: CheckoutBody): CheckoutResult;
-    authorize(body: SubmitAuthorizationInput): CheckoutResult;
-}
-interface CheckoutBody {
-    cart_id: string;
-    location_id?: string;
-    customer: {
-        name: string;
-        email: string;
-        phone: string;
-        notes?: string;
-        save_details?: boolean;
-    };
-    order_type: string;
-    address_info?: Record<string, unknown>;
-    payment_method: string;
-    mobile_money_details?: {
-        phone_number: string;
-        provider: string;
-    };
-    special_instructions?: string;
-    metadata?: Record<string, unknown>;
-    pay_currency?: string;
-    fx_quote_id?: string;
-}
-interface CheckoutResult {
+interface MockPaymentResult {
     order_id: string;
     order_number: string;
-    payment_id?: string;
-    payment_status: string;
+    payment_id: string;
     payment_reference?: string;
+    payment_status: string;
     requires_authorization: boolean;
-    authorization_type?: "otp" | "pin" | "phone" | "birthday" | "address";
     next_action: {
-        type: "none";
-    } | {
-        type: "card_popup";
-        provider: string;
-        client_secret: string;
-        public_key: string;
-    } | {
-        type: "redirect";
-        authorization_url: string;
-    } | {
-        type: "authorization";
-        authorization_type: string;
-        display_text?: string;
-    } | {
-        type: "poll";
+        type: typeof CHECKOUT_NEXT_ACTION.NONE;
     };
-    provider?: string;
-    authorization_url?: string;
-    display_text?: string;
-    /** Bearer token used for guest order access (lookup `/orders/{id}?token=...`). */
-    bill_token?: string;
-    /** Stripe-style client secret for direct PaymentIntent confirmation. */
-    client_secret?: string;
-    /** Stripe publishable key (mock value in dev). */
-    public_key?: string;
+}
+interface PaymentService {
+    authorize(body: SubmitAuthorizationInput): MockPaymentResult;
+}
+
+interface PurchaseIntentMockService {
+    mint(session: Session, request: MintPurchaseIntentRequest): PurchaseIntentView;
+    get(session: Session, intentId: string): PurchaseIntentView;
+    refresh(session: Session, intentId: string, expectedRevision: number): PurchaseIntentView;
+    confirm(session: Session, intentId: string, request: ConfirmPurchaseIntentRequest): ConfirmPurchaseIntentResponse;
+    submitAction(session: Session, intentId: string, attemptId: string, request: SubmitPurchaseIntentActionRequest): ConfirmPurchaseIntentResponse;
 }
 
 interface OrderService {
@@ -918,6 +892,7 @@ interface MockDeliveryOption {
     name: string;
     description?: string;
     fee: string;
+    fee_status: "priced" | "arranged";
     currency: string;
     free_delivery_applied: boolean;
     free_over_amount?: string;
@@ -1246,7 +1221,8 @@ interface Deps {
     business: BusinessService;
     catalogue: CatalogueService;
     cart: CartService;
-    checkout: CheckoutService;
+    payments: PaymentService;
+    purchaseIntents: PurchaseIntentMockService;
     orders: OrderService;
     subscriptions: SubscriptionService;
     scheduling: SchedulingService;