@simpleapps-com/augur-hooks 2.3.1 → 2026.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/EXPORTS.md +25 -65
- package/README.md +21 -246
- package/dist/checkout/create-checkout-provider.d.ts +25 -0
- package/dist/checkout/create-checkout-provider.d.ts.map +1 -0
- package/dist/checkout/index.cjs +123 -106
- package/dist/checkout/index.cjs.map +1 -1
- package/dist/checkout/index.d.ts +5 -293
- package/dist/checkout/index.d.ts.map +1 -0
- package/dist/checkout/index.js +99 -82
- package/dist/checkout/index.js.map +1 -1
- package/dist/checkout/{index.d.cts → types.d.ts} +18 -40
- package/dist/checkout/types.d.ts.map +1 -0
- package/dist/chunk-6Z6JGK2C.cjs.map +1 -1
- package/dist/chunk-QB7VB5FZ.cjs +523 -0
- package/dist/chunk-QB7VB5FZ.cjs.map +1 -0
- package/dist/{chunk-NRWH2BMN.js → chunk-UTDAFIQP.js} +237 -91
- package/dist/chunk-UTDAFIQP.js.map +1 -0
- package/dist/hooks/use-cart-actions.d.ts +68 -0
- package/dist/hooks/use-cart-actions.d.ts.map +1 -0
- package/dist/hooks/use-cart-initialization.d.ts +60 -0
- package/dist/hooks/use-cart-initialization.d.ts.map +1 -0
- package/dist/hooks/use-cart-pricing.d.ts +41 -0
- package/dist/hooks/use-cart-pricing.d.ts.map +1 -0
- package/dist/hooks/use-checkout-persistence.d.ts +40 -0
- package/dist/hooks/use-checkout-persistence.d.ts.map +1 -0
- package/dist/hooks/use-debounce.d.ts +6 -0
- package/dist/hooks/use-debounce.d.ts.map +1 -0
- package/dist/hooks/use-format-price.d.ts +29 -0
- package/dist/hooks/use-format-price.d.ts.map +1 -0
- package/dist/hooks/use-latest.d.ts +8 -0
- package/dist/hooks/use-latest.d.ts.map +1 -0
- package/dist/hooks/use-modal-lifecycle.d.ts +11 -0
- package/dist/hooks/use-modal-lifecycle.d.ts.map +1 -0
- package/dist/hooks/use-order-readiness.d.ts +47 -0
- package/dist/hooks/use-order-readiness.d.ts.map +1 -0
- package/dist/hooks/use-pagination-prefetch.d.ts +26 -0
- package/dist/hooks/use-pagination-prefetch.d.ts.map +1 -0
- package/dist/{use-order-readiness-DZTIfRzw.d.ts → hooks/use-payment-flow.d.ts} +23 -67
- package/dist/hooks/use-payment-flow.d.ts.map +1 -0
- package/dist/hooks/use-stock.d.ts +32 -0
- package/dist/hooks/use-stock.d.ts.map +1 -0
- package/dist/index.cjs +251 -192
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +32 -456
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +230 -171
- package/dist/index.js.map +1 -1
- package/dist/persistence/apply-limits.d.ts +8 -0
- package/dist/persistence/apply-limits.d.ts.map +1 -0
- package/dist/persistence/create-persister.d.ts +10 -0
- package/dist/persistence/create-persister.d.ts.map +1 -0
- package/dist/persistence/serializer.d.ts +11 -0
- package/dist/persistence/serializer.d.ts.map +1 -0
- package/dist/persistence/use-persistence.d.ts +59 -0
- package/dist/persistence/use-persistence.d.ts.map +1 -0
- package/dist/persistence/use-storage-monitor.d.ts +11 -0
- package/dist/persistence/use-storage-monitor.d.ts.map +1 -0
- package/dist/provider.d.ts +89 -0
- package/dist/provider.d.ts.map +1 -0
- package/dist/queries/batch-query.d.ts +23 -0
- package/dist/queries/batch-query.d.ts.map +1 -0
- package/dist/queries/cache-helper.d.ts +16 -0
- package/dist/queries/cache-helper.d.ts.map +1 -0
- package/dist/queries/index.d.ts +3 -0
- package/dist/queries/index.d.ts.map +1 -0
- package/dist/query-action-registry.d.ts +19 -0
- package/dist/query-action-registry.d.ts.map +1 -0
- package/dist/rules.d.ts +130 -0
- package/dist/rules.d.ts.map +1 -0
- package/dist/server.cjs.map +1 -1
- package/dist/server.d.ts +10 -12
- package/dist/server.d.ts.map +1 -0
- package/dist/stores/cart-store.d.ts +51 -0
- package/dist/stores/cart-store.d.ts.map +1 -0
- package/dist/stores/items-filters-store.d.ts +30 -0
- package/dist/stores/items-filters-store.d.ts.map +1 -0
- package/dist/types.d.ts +48 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/web/use-image-with-fallback.d.ts +16 -0
- package/dist/web/use-image-with-fallback.d.ts.map +1 -0
- package/dist/web/use-mobile-detection.d.ts +28 -0
- package/dist/web/use-mobile-detection.d.ts.map +1 -0
- package/dist/web/use-mobile-optimized-intersection.d.ts +17 -0
- package/dist/web/use-mobile-optimized-intersection.d.ts.map +1 -0
- package/dist/web.cjs.map +1 -1
- package/dist/web.d.ts +4 -60
- package/dist/web.d.ts.map +1 -0
- package/dist/web.js.map +1 -1
- package/llms.txt +76 -54
- package/package.json +25 -14
- package/dist/batch-query-CTlvxSmL.d.cts +0 -165
- package/dist/batch-query-CTlvxSmL.d.ts +0 -165
- package/dist/chunk-I4A5L2I6.cjs +0 -377
- package/dist/chunk-I4A5L2I6.cjs.map +0 -1
- package/dist/chunk-NRWH2BMN.js.map +0 -1
- package/dist/index.d.cts +0 -456
- package/dist/server.d.cts +0 -44
- package/dist/use-order-readiness-DZTIfRzw.d.cts +0 -137
- package/dist/web.d.cts +0 -60
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/checkout/create-checkout-provider.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n createContext,\n useContext,\n useState,\n useCallback,\n useEffect,\n useRef,\n type ReactElement,\n} from \"react\";\nimport { useQueryClient, type QueryClient } from \"@tanstack/react-query\";\nimport { usePaymentFlow, PAYMENT_STORAGE_KEY } from \"../hooks/use-payment-flow\";\nimport type { PaymentFlowCallbacks } from \"../hooks/use-payment-flow\";\nimport { clearFromSession } from \"../hooks/use-checkout-persistence\";\nimport { useOrderReadiness } from \"../hooks/use-order-readiness\";\nimport type { OrderReadinessParams } from \"../hooks/use-order-readiness\";\nimport { useCartHdrUid, useCartLines, useClearCart } from \"../stores/cart-store\";\nimport type { CustomerDocument } from \"@simpleapps-com/augur-utils\";\nimport type {\n CheckoutAddress,\n CheckoutContextValue,\n CheckoutContext,\n CheckoutPaymentModal,\n CheckoutProviderConfig,\n CheckoutProviderProps,\n} from \"./types\";\n\n/** sessionStorage key for persisted order confirmation data. */\nexport const ORDER_CONFIRMATION_KEY = \"orderConfirmation\";\n\n/** Default redirect via full page navigation. */\nfunction defaultRedirect(url: string): void {\n window.location.href = url;\n}\n\n/** Shape of the order state snapshot taken via ref. */\ninterface OrderStateSnapshot {\n shippingAddress: CheckoutAddress | undefined;\n billingAddress: CheckoutAddress | undefined;\n carrierId: string;\n shippingMethod: string | undefined;\n shippingFee: number | undefined;\n paymentMethod: string;\n taxRate: number | undefined;\n clientIp: string | undefined;\n isFreeShipping: boolean;\n identity: CheckoutProviderConfig[\"identity\"];\n unifiedPayment: unknown;\n unifiedCc: unknown;\n}\n\n/** Run pre-submit validation hooks. Returns error string or null. */\nfunction runPreSubmitChecks<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n shippingAddress: CheckoutAddress | undefined,\n): string | null {\n if (config.hooks?.onValidate) {\n const error = config.hooks.onValidate(ctx);\n if (error) return error;\n }\n if (config.hooks?.onBeforeSubmit) {\n const result = config.hooks.onBeforeSubmit(ctx);\n if (result === false) return \"__cancelled__\";\n }\n if (!shippingAddress) return \"Shipping address is required.\";\n return null;\n}\n\n/** Build the order data payload from current state. */\nfunction buildOrderData(s: OrderStateSnapshot): Record<string, unknown> {\n return {\n shippingAddress: s.shippingAddress,\n billingAddress: s.billingAddress,\n carrierId: s.carrierId,\n shippingMethod: s.shippingMethod,\n shippingFee: s.shippingFee,\n paymentMethod: s.paymentMethod,\n taxRate: s.taxRate,\n clientIp: s.clientIp,\n isFreeShipping: s.isFreeShipping,\n customerId: s.identity?.customerId,\n contactId: s.identity?.contactId,\n companyId: s.identity?.companyId,\n userId: s.identity?.userId,\n userEmail: s.identity?.userEmail,\n unifiedPayment: s.unifiedPayment,\n unifiedCc: s.unifiedCc,\n };\n}\n\n/** Handle order submission failure. */\nfunction handleOrderError<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n setProcessingOrder: (v: boolean) => void,\n error: unknown,\n): void {\n setProcessingOrder(false);\n const message = error instanceof Error ? error.message : \"Something went wrong.\";\n config.ui?.onError?.(\"Order Failed\", message);\n}\n\n/** Coerce cartHdrUid from store (string | number | undefined) to number. */\nfunction resolveCartHdrUid(cartHdrUid: number | string | undefined): number {\n if (typeof cartHdrUid === \"string\") return Number(cartHdrUid);\n return cartHdrUid ?? 0;\n}\n\n/**\n * Resolve the initial payment method. Honors `hooks.getDefaultPaymentMethod`\n * when provided; otherwise falls back to `\"credit-card\"` when payment\n * processing is configured and `\"invoice\"` when it is not.\n */\nfunction resolveDefaultPaymentMethod<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n): string {\n const explicit = config.hooks?.getDefaultPaymentMethod?.();\n if (explicit) return explicit;\n return config.payments?.callbacks ? \"credit-card\" : \"invoice\";\n}\n\n/**\n * Build the `customReadinessCheck` adapter for useOrderReadiness from the\n * site's `hooks.isOrderReady`. Returns `undefined` when no site hook is\n * provided so useOrderReadiness runs its default gates.\n */\nfunction buildReadinessOverride<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctxRef: React.RefObject<CheckoutContext<TCustom>>,\n): ((params: OrderReadinessParams) => boolean | undefined) | undefined {\n const siteIsOrderReady = config.hooks?.isOrderReady;\n if (!siteIsOrderReady) return undefined;\n return (params) => siteIsOrderReady(ctxRef.current, params);\n}\n\n/** Build order payload via assembleOrder hook or fallback to buildOrderData. */\nfunction assembleOrderPayload<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n contextValue: CheckoutContextValue<TCustom>,\n stateSnapshot: OrderStateSnapshot,\n): { orderData: Record<string, unknown>; error?: string } {\n if (config.hooks?.assembleOrder) {\n const assembled = config.hooks.assembleOrder(ctx, contextValue);\n if (assembled.error) return { orderData: {}, error: assembled.error };\n return { orderData: assembled.order };\n }\n return { orderData: buildOrderData(stateSnapshot) };\n}\n\n/**\n * Validate the minimum viable shape of an assembled order payload.\n *\n * Returns an error message when the payload is obviously broken, or `null`\n * when it passes. Invariants are conditional on key presence so sites using\n * the legacy `oe_hdr`/`oe_line` payload shape (or any shape without top-level\n * `lines`/`header`) pass through unchecked.\n *\n * Enforced invariants:\n * - `orderData` MUST be a non-null, non-array object.\n * - If `orderData.lines` is present, it MUST be a non-empty array.\n * - If `orderData.header` is present and is an object, it MUST include a\n * non-empty `customer_id`.\n */\nfunction validateOrderPayload(orderData: Record<string, unknown>): string | null {\n if (orderData === null || typeof orderData !== \"object\" || Array.isArray(orderData)) {\n return \"Order payload is empty or malformed.\";\n }\n\n if (\"lines\" in orderData) {\n const lines = orderData[\"lines\"];\n if (!Array.isArray(lines) || lines.length === 0) {\n return \"Order has no line items.\";\n }\n }\n\n if (\"header\" in orderData) {\n const header = orderData[\"header\"];\n if (header !== null && typeof header === \"object\" && !Array.isArray(header)) {\n const customerId = (header as Record<string, unknown>)[\"customer_id\"];\n if (customerId == null || String(customerId).trim() === \"\") {\n return \"Order is missing a customer.\";\n }\n }\n }\n\n return null;\n}\n\n/**\n * Assemble and validate the order payload. Surfaces any failure via\n * `config.ui.onError` + `setProcessingOrder(false)`, and additionally logs\n * the offending payload to `console.error` on validation failure. Returns\n * `null` when the payload was not produced or was rejected; returns the\n * `orderData` ready for `submitOrder` otherwise.\n */\nfunction prepareOrderPayload<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n contextValue: CheckoutContextValue<TCustom>,\n stateSnapshot: OrderStateSnapshot,\n setProcessingOrder: (v: boolean) => void,\n): Record<string, unknown> | null {\n const { orderData, error: assemblyError } = assembleOrderPayload(\n config,\n ctx,\n contextValue,\n stateSnapshot,\n );\n if (assemblyError) {\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Error\", assemblyError);\n return null;\n }\n\n const validationError = validateOrderPayload(orderData);\n if (validationError) {\n console.error(\"Order payload validation failed:\", orderData);\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Error\", validationError);\n return null;\n }\n\n return orderData;\n}\n\n/** Shape of persisted order confirmation data. */\nexport interface OrderConfirmation {\n orderData: Record<string, unknown>;\n result: unknown;\n shippingAddress: CheckoutAddress | undefined;\n billingAddress: CheckoutAddress | undefined;\n shippingFee: number | undefined;\n shippingMethod: string | undefined;\n taxRate: number | undefined;\n paymentMethod: string;\n carrierId: string;\n orderCartLines: unknown[] | undefined;\n}\n\n/** Build the confirmation snapshot from checkout state + API result. */\nfunction buildOrderConfirmation(\n orderData: Record<string, unknown>,\n resultData: unknown,\n state: OrderStateSnapshot,\n orderCartLines: unknown[] | undefined,\n): OrderConfirmation {\n return {\n orderData,\n result: resultData,\n shippingAddress: state.shippingAddress,\n billingAddress: state.billingAddress,\n shippingFee: state.shippingFee,\n shippingMethod: state.shippingMethod,\n taxRate: state.taxRate,\n paymentMethod: state.paymentMethod,\n carrierId: state.carrierId,\n orderCartLines,\n };\n}\n\n/**\n * Handle successful order submission.\n *\n * After running the site's `onAfterSubmit` hook and persisting the order\n * confirmation snapshot, the package clears its own client-side cart state:\n * the zustand cart store is reset, and the cart-related React Query caches\n * (`cartLines`, `cart-also-bought`, and the proxy-shape `commerce.cartLine`)\n * are invalidated so any subsequent page mount refetches from the server.\n * The redirect fires last. Sites retain responsibility for backend cart\n * cleanup inside `onAfterSubmit` or their `submitOrder` wrapper.\n */\nfunction handleOrderSuccess<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n resultData: unknown,\n confirmation: OrderConfirmation,\n setProcessingOrder: (v: boolean) => void,\n redirect: (url: string) => void,\n queryClient: QueryClient,\n clearCart: () => void,\n): void {\n if (config.payments?.persistence) {\n clearFromSession(PAYMENT_STORAGE_KEY);\n }\n config.hooks?.onAfterSubmit?.(ctx, resultData);\n if (config.order.persistence !== false) {\n try {\n sessionStorage.setItem(ORDER_CONFIRMATION_KEY, JSON.stringify(confirmation));\n } catch {\n // sessionStorage unavailable (private browsing, quota)\n }\n }\n clearCart();\n void queryClient.invalidateQueries({ queryKey: [\"cartLines\"] });\n void queryClient.invalidateQueries({ queryKey: [\"cart-also-bought\"] });\n void queryClient.invalidateQueries({ queryKey: [\"commerce\", \"cartLine\"] });\n redirect(config.order.successRedirect);\n setProcessingOrder(false);\n}\n\n/** Execute order submission -- extracted to reduce component complexity. */\nasync function executeOrder<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctxRef: React.RefObject<CheckoutContext<TCustom>>,\n stateRef: React.RefObject<OrderStateSnapshot>,\n contextValueRef: React.RefObject<CheckoutContextValue<TCustom>>,\n cartHdrUid: number | string | undefined,\n setProcessingOrder: (v: boolean) => void,\n redirect: (url: string) => void,\n queryClient: QueryClient,\n clearCart: () => void,\n): Promise<void> {\n const ctx = ctxRef.current;\n const s = stateRef.current;\n\n const preCheck = runPreSubmitChecks(config, ctx, s.shippingAddress);\n if (preCheck === \"__cancelled__\") return;\n if (preCheck) {\n config.ui?.onError?.(\"Missing Information\", preCheck);\n return;\n }\n\n setProcessingOrder(true);\n\n const orderData = prepareOrderPayload(\n config,\n ctx,\n contextValueRef.current,\n s,\n setProcessingOrder,\n );\n if (!orderData) return;\n\n let result: { ok: boolean; data?: unknown; error?: string };\n try {\n result = await config.order.submitOrder(orderData, resolveCartHdrUid(cartHdrUid));\n } catch (error) {\n handleOrderError(config, setProcessingOrder, error);\n return;\n }\n\n if (!result.ok) {\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Failed\", result.error ?? \"Something went wrong.\");\n return;\n }\n\n const confirmation = buildOrderConfirmation(\n orderData,\n result.data,\n s,\n contextValueRef.current.orderCartLines,\n );\n handleOrderSuccess(\n config,\n ctx,\n result.data,\n confirmation,\n setProcessingOrder,\n redirect,\n queryClient,\n clearCart,\n );\n}\n\n/** No-op callbacks for when payment is not configured. */\nconst NOOP_PAYMENT_CALLBACKS: PaymentFlowCallbacks = {\n transactionSetup: async () => undefined,\n cardInfo: async () => undefined,\n validatePayment: async () => undefined,\n accountQuery: async () => undefined,\n billingUpdate: async () => undefined,\n};\n\n/**\n * Creates a CheckoutProvider component and useCheckout() hook from site config.\n *\n * The package owns all state, transitions, validation, and order submission.\n * Sites own layout and inject configuration + lifecycle hooks.\n *\n * Steps are string-based -- sites define their own step names.\n * Payment flow is optional -- B2B sites without payment processing omit payments.callbacks.\n *\n * @example\n * ```ts\n * // Full checkout with payment\n * const { CheckoutProvider, useCheckout } = createCheckoutProvider({\n * shipping: { carriers: { \"100008\": \"UPS Ground\" }, defaultCarrierId: \"100008\" },\n * payments: { callbacks: { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate } },\n * order: { successRedirect: \"/thank-you\", submitOrder },\n * });\n *\n * // B2B checkout without payment\n * const { CheckoutProvider, useCheckout } = createCheckoutProvider({\n * shipping: { carriers: { \"100008\": \"UPS Ground\" }, defaultCarrierId: \"100008\" },\n * order: { successRedirect: \"/thank-you\", submitOrder },\n * });\n * ```\n */\n// Single context instance at module scope. Prevents stale context references\n// when createCheckoutProvider is re-called during HMR or page navigation.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst Ctx = createContext<any>(null);\n\nexport function createCheckoutProvider<\n TCustom extends Record<string, unknown> = Record<string, never>,\n>(config: CheckoutProviderConfig<TCustom>) {\n const hasPaymentFlow = !!config.payments?.callbacks;\n\n function CheckoutProvider({\n children,\n identity: propsIdentity,\n }: CheckoutProviderProps): ReactElement {\n // -- Shipping state --\n const [shippingAddress, setShippingAddress] = useState<CheckoutAddress | undefined>();\n const [shippingFee, setShippingFee] = useState<number | undefined>();\n const [shippingMethod, setShippingMethod] = useState<string | undefined>();\n const [shippingAccepted, setShippingAccepted] = useState(false);\n const [shippingMethodSaved, setShippingMethodSaved] = useState(false);\n const [isFreeShipping, setIsFreeShipping] = useState(false);\n const [carrierId, setCarrierId] = useState(config.shipping.defaultCarrierId);\n const [showShippingMethod, setShowShippingMethod] = useState(false);\n\n // -- Billing state --\n const [billingAddress, setBillingAddress] = useState<CheckoutAddress | undefined>();\n const [paymentMethod, setPaymentMethod] = useState(() => resolveDefaultPaymentMethod(config));\n const [showBillingInfoSummary, setShowBillingInfoSummary] = useState(false);\n\n // -- Order state --\n const [orderCartLines, setOrderCartLines] = useState<unknown[] | undefined>();\n const [processingOrder, setProcessingOrder] = useState(false);\n const [taxRate, setTaxRate] = useState<number | undefined>(undefined);\n const [clientIp, setClientIp] = useState<string | undefined>();\n const [cartToken, setCartToken] = useState<string>(\"\");\n const [customerDoc, setCustomerDoc] = useState<CustomerDocument | null>(null);\n\n // -- Edit flags --\n const [isEditShippingInfo, setIsEditShippingInfo] = useState(false);\n const [isEditShippingMethods, setIsEditShippingMethods] = useState(false);\n const [isEditBillingInfo, setIsEditBillingInfo] = useState(false);\n\n // -- Step navigation (string-based, sites define their own steps) --\n const [currentStep, setCurrentStep] = useState<string>(config.initialStep ?? \"shipping\");\n\n // -- Custom state --\n const [customState, setCustomState] = useState<TCustom>(\n () => (config.customState ?? {}) as TCustom,\n );\n\n const setCustomField = useCallback(<K extends keyof TCustom>(key: K, value: TCustom[K]) => {\n setCustomState((prev) => ({ ...prev, [key]: value }));\n }, []);\n\n // -- Identity (props override config for runtime hook values) --\n const identity = propsIdentity ?? config.identity;\n const payment = usePaymentFlow({\n callbacks: config.payments?.callbacks ?? NOOP_PAYMENT_CALLBACKS,\n customerId: identity?.customerId,\n billingAddress,\n paymentMethod,\n shippingAccepted,\n persistPayment: config.payments?.persistence,\n });\n\n const paymentModal: CheckoutPaymentModal | undefined = hasPaymentFlow\n ? {\n isOpen: payment.isOpen,\n setIsOpen: payment.setIsOpen,\n editCc: payment.editCc,\n setEditCc: payment.setEditCc,\n unified: payment.unified,\n unifiedCc: payment.unifiedCc,\n unifiedResponse: payment.unifiedResponse,\n unifiedBilling: payment.unifiedBilling,\n unifiedPayment: payment.unifiedPayment,\n handleBinCapture: payment.handleBinCapture,\n hasValidPayment: !!payment.unifiedPayment?.PaymentAccountID,\n }\n : undefined;\n\n // -- Lifecycle context (passed to hooks) --\n const ctxRef = useRef<CheckoutContext<TCustom>>(null!);\n ctxRef.current = {\n get: <K extends keyof TCustom>(key: K) => customState[key],\n set: setCustomField,\n skipToStep: setCurrentStep,\n setBillingAddress,\n setCarrierId,\n };\n\n // -- Edit flag transitions --\n const handleSetIsEditShippingInfo = useCallback((editing: boolean) => {\n setIsEditShippingInfo(editing);\n if (editing) {\n setShippingMethodSaved(false);\n setShowShippingMethod(false);\n }\n }, []);\n\n const handleSetIsEditShippingMethods = useCallback((editing: boolean) => {\n setIsEditShippingMethods(editing);\n if (editing) {\n setShippingMethodSaved(false);\n }\n }, []);\n\n // -- Step transitions with lifecycle hook --\n const goToStep = useCallback(\n (step: string) => {\n const from = currentStep;\n if (config.hooks?.onStepChange) {\n config.hooks.onStepChange(ctxRef.current, from, step);\n }\n setCurrentStep(step);\n },\n [currentStep],\n );\n\n // -- Cart store integration --\n const cartHdrUid = useCartHdrUid();\n const cartLines = useCartLines();\n const clearCart = useClearCart();\n const queryClient = useQueryClient();\n\n // -- Order readiness --\n const { enableProcessOrderBtn, processingValidation } = useOrderReadiness({\n cartHdrUid,\n shippingAddress,\n billingAddress,\n shippingMethodSaved,\n showBillingInfoSummary,\n processingOrder,\n paymentMethod,\n unifiedPaymentAccountId: payment.unifiedPayment?.PaymentAccountID,\n unifiedBilling: payment.unifiedBilling,\n isFreeShipping,\n carrierId,\n shippingFee,\n isEditShippingInfo,\n isEditShippingMethods,\n isEditBillingInfo,\n editCc: payment.editCc,\n customReadinessCheck: buildReadinessOverride(config, ctxRef),\n });\n\n // -- Effects: data fetching on mount --\n\n useEffect(() => {\n if (config.order.fetchClientIp) {\n void config.order.fetchClientIp().then(setClientIp);\n }\n }, []);\n\n useEffect(() => {\n const custId = identity?.customerId;\n if (custId && identity?.fetchCustomerDoc) {\n void identity\n .fetchCustomerDoc(custId)\n .then(setCustomerDoc)\n .catch(() => setCustomerDoc(null));\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [identity?.customerId]);\n\n // -- Effect: tax calculation when billing address changes --\n useEffect(() => {\n if (!config.order.calculateTax || !billingAddress?.postalCode) return;\n void config.order\n .calculateTax({\n customerId: identity?.customerId,\n postalCode: billingAddress.postalCode,\n items: orderCartLines ?? [],\n customerDoc,\n })\n .then((tax) => {\n if (tax !== undefined) setTaxRate(tax);\n });\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [billingAddress?.postalCode, orderCartLines]);\n\n // -- Effect: auto-copy shipping to billing (default \"same as shipping\") --\n useEffect(() => {\n if (shippingAccepted && shippingAddress && !billingAddress) {\n setBillingAddress(shippingAddress);\n }\n }, [shippingAccepted, shippingAddress, billingAddress]);\n\n // -- Effect: fire onShippingAccepted lifecycle hook --\n useEffect(() => {\n if (config.hooks?.onShippingAccepted && shippingAccepted && shippingAddress) {\n config.hooks.onShippingAccepted(ctxRef.current, shippingAddress, orderCartLines ?? []);\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [shippingAccepted, shippingAddress]);\n\n // -- Effect: cart token from cookie --\n useEffect(() => {\n if (typeof document === \"undefined\") return;\n const cookies = document.cookie.split(\";\");\n const match = cookies.find((c) => c.trim().startsWith(\"cartToken=\"));\n if (match) {\n const token = match.split(\"=\")[1];\n if (token) setCartToken(token);\n }\n }, []);\n\n // -- Order submission with double-submit prevention --\n\n const resetProcessing = useCallback(() => setProcessingOrder(false), []);\n\n const isProcessingRef = useRef(false);\n\n const orderStateRef = useRef<OrderStateSnapshot>({\n shippingAddress,\n billingAddress,\n carrierId,\n shippingMethod,\n shippingFee,\n paymentMethod,\n taxRate,\n clientIp,\n isFreeShipping,\n identity,\n unifiedPayment: payment.unifiedPayment,\n unifiedCc: payment.unifiedCc,\n });\n orderStateRef.current = {\n shippingAddress,\n billingAddress,\n carrierId,\n shippingMethod,\n shippingFee,\n paymentMethod,\n taxRate,\n clientIp,\n isFreeShipping,\n identity,\n unifiedPayment: payment.unifiedPayment,\n unifiedCc: payment.unifiedCc,\n };\n\n const contextValueRef = useRef<CheckoutContextValue<TCustom>>(null!);\n\n const redirect = useCallback((url: string) => {\n if (config.order.redirect) {\n config.order.redirect(url);\n } else {\n defaultRedirect(url);\n }\n }, []);\n\n const processOrder = useCallback(async () => {\n if (isProcessingRef.current) return;\n isProcessingRef.current = true;\n try {\n await executeOrder(\n config,\n ctxRef,\n orderStateRef,\n contextValueRef,\n cartHdrUid,\n setProcessingOrder,\n redirect,\n queryClient,\n clearCart,\n );\n } finally {\n isProcessingRef.current = false;\n }\n }, [cartHdrUid, redirect, queryClient, clearCart]);\n\n // -- Context value --\n const value: CheckoutContextValue<TCustom> = {\n shippingAddress,\n setShippingAddress,\n shippingFee,\n setShippingFee,\n shippingMethod,\n setShippingMethod,\n shippingAccepted,\n setShippingAccepted,\n shippingMethodSaved,\n setShippingMethodSaved,\n isFreeShipping,\n setIsFreeShipping,\n carrierId,\n setCarrierId,\n showShippingMethod,\n setShowShippingMethod,\n billingAddress,\n setBillingAddress,\n paymentMethod,\n setPaymentMethod,\n showBillingInfoSummary,\n setShowBillingInfoSummary,\n paymentModal,\n cartLines,\n orderCartLines,\n setOrderCartLines,\n processingOrder,\n processOrder,\n resetProcessing,\n customerDoc,\n taxRate,\n setTaxRate,\n clientIp,\n cartToken,\n isEditShippingInfo,\n setIsEditShippingInfo: handleSetIsEditShippingInfo,\n isEditShippingMethods,\n setIsEditShippingMethods: handleSetIsEditShippingMethods,\n isEditBillingInfo,\n setIsEditBillingInfo,\n enableProcessOrderBtn,\n processingValidation,\n currentStep,\n goToStep,\n custom: customState,\n setCustom: setCustomField,\n config,\n };\n\n contextValueRef.current = value;\n\n return <Ctx.Provider value={value}>{children}</Ctx.Provider>;\n }\n\n /** Access checkout state from any child of CheckoutProvider. */\n function useCheckout(): CheckoutContextValue<TCustom> {\n const ctx = useContext(Ctx);\n if (!ctx) {\n throw new Error(\"useCheckout must be used within a CheckoutProvider\");\n }\n return ctx;\n }\n\n return { CheckoutProvider, useCheckout };\n}\n"],"mappings":"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","names":["value"]}
|
|
1
|
+
{"version":3,"sources":["../../src/checkout/create-checkout-provider.tsx"],"sourcesContent":["\"use client\";\n\nimport React, {\n createContext,\n useContext,\n useState,\n useCallback,\n useEffect,\n useRef,\n type ReactElement,\n} from \"react\";\nimport { useQueryClient, type QueryClient } from \"@tanstack/react-query\";\nimport { usePaymentFlow, PAYMENT_STORAGE_KEY } from \"../hooks/use-payment-flow\";\nimport type { PaymentFlowCallbacks } from \"../hooks/use-payment-flow\";\nimport { clearFromSession } from \"../hooks/use-checkout-persistence\";\nimport { useLatest } from \"../hooks/use-latest\";\nimport { useOrderReadiness } from \"../hooks/use-order-readiness\";\nimport type { OrderReadinessParams } from \"../hooks/use-order-readiness\";\nimport {\n checkoutCartUid,\n defaultPaymentMethodOf,\n preSubmitOutcome,\n secondEqualsField,\n type PreSubmit,\n} from \"../rules\";\nimport { useCartHdrUid, useCartLines, useClearCart } from \"../stores/cart-store\";\nimport type { CustomerDocument } from \"@simpleapps-com/augur-utils\";\nimport type {\n CheckoutAddress,\n CheckoutContextValue,\n CheckoutContext,\n CheckoutPaymentModal,\n CheckoutProviderConfig,\n CheckoutProviderProps,\n} from \"./types\";\n\n/** sessionStorage key for persisted order confirmation data. */\nexport const ORDER_CONFIRMATION_KEY = \"orderConfirmation\";\n\n/** Default redirect via full page navigation. */\nfunction defaultRedirect(url: string): void {\n window.location.href = url;\n}\n\n/** Shape of the order state snapshot taken via ref. */\ninterface OrderStateSnapshot {\n shippingAddress: CheckoutAddress | undefined;\n billingAddress: CheckoutAddress | undefined;\n carrierId: string;\n shippingMethod: string | undefined;\n shippingFee: number | undefined;\n paymentMethod: string;\n taxRate: number | undefined;\n clientIp: string | undefined;\n isFreeShipping: boolean;\n identity: CheckoutProviderConfig[\"identity\"];\n unifiedPayment: unknown;\n unifiedCc: unknown;\n}\n\n/**\n * Run the pre-submit hooks (onBeforeSubmit only when validation passed, as before); the\n * outcome is `preSubmitOutcome`'s.\n */\nfunction runPreSubmitChecks<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n shippingAddress: CheckoutAddress | undefined,\n): PreSubmit {\n const validateError = config.hooks?.onValidate?.(ctx);\n const vetoed = !validateError && config.hooks?.onBeforeSubmit?.(ctx) === false;\n return preSubmitOutcome(validateError, vetoed, !!shippingAddress);\n}\n\n/** Build the order data payload from current state. */\nfunction buildOrderData(s: OrderStateSnapshot): Record<string, unknown> {\n return {\n shippingAddress: s.shippingAddress,\n billingAddress: s.billingAddress,\n carrierId: s.carrierId,\n shippingMethod: s.shippingMethod,\n shippingFee: s.shippingFee,\n paymentMethod: s.paymentMethod,\n taxRate: s.taxRate,\n clientIp: s.clientIp,\n isFreeShipping: s.isFreeShipping,\n customerId: s.identity?.customerId,\n contactId: s.identity?.contactId,\n companyId: s.identity?.companyId,\n userId: s.identity?.userId,\n userEmail: s.identity?.userEmail,\n unifiedPayment: s.unifiedPayment,\n unifiedCc: s.unifiedCc,\n };\n}\n\n/** Handle order submission failure. */\nfunction handleOrderError<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n setProcessingOrder: (v: boolean) => void,\n error: unknown,\n): void {\n setProcessingOrder(false);\n const message = error instanceof Error ? error.message : \"Something went wrong.\";\n config.ui?.onError?.(\"Order Failed\", message);\n}\n\n/** Coerce cartHdrUid from store (string | number | undefined) to number. */\nfunction resolveCartHdrUid(cartHdrUid: number | string | undefined): number {\n if (typeof cartHdrUid === \"string\") return Number(cartHdrUid);\n return checkoutCartUid(cartHdrUid);\n}\n\n/**\n * Resolve the initial payment method. Honors `hooks.getDefaultPaymentMethod`\n * when provided; otherwise falls back to `\"credit-card\"` when payment\n * processing is configured and `\"invoice\"` when it is not.\n */\nfunction resolveDefaultPaymentMethod<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n): string {\n return defaultPaymentMethodOf(\n config.hooks?.getDefaultPaymentMethod?.(),\n !!config.payments?.callbacks,\n );\n}\n\n/**\n * Build the `customReadinessCheck` adapter for useOrderReadiness from the\n * site's `hooks.isOrderReady`. Returns `undefined` when no site hook is\n * provided so useOrderReadiness runs its default gates.\n */\nfunction buildReadinessOverride<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctxRef: React.RefObject<CheckoutContext<TCustom>>,\n): ((params: OrderReadinessParams) => boolean | undefined) | undefined {\n const siteIsOrderReady = config.hooks?.isOrderReady;\n if (!siteIsOrderReady) return undefined;\n return (params) => siteIsOrderReady(ctxRef.current, params);\n}\n\n/** Build order payload via assembleOrder hook or fallback to buildOrderData. */\nfunction assembleOrderPayload<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n contextValue: CheckoutContextValue<TCustom>,\n stateSnapshot: OrderStateSnapshot,\n): { orderData: Record<string, unknown>; error?: string } {\n if (config.hooks?.assembleOrder) {\n const assembled = config.hooks.assembleOrder(ctx, contextValue);\n if (assembled.error) return { orderData: {}, error: assembled.error };\n return { orderData: assembled.order };\n }\n return { orderData: buildOrderData(stateSnapshot) };\n}\n\n/**\n * Validate the minimum viable shape of an assembled order payload.\n *\n * Returns an error message when the payload is obviously broken, or `null`\n * when it passes. Invariants are conditional on key presence so sites using\n * the legacy `oe_hdr`/`oe_line` payload shape (or any shape without top-level\n * `lines`/`header`) pass through unchecked.\n *\n * Enforced invariants:\n * - `orderData` MUST be a non-null, non-array object.\n * - If `orderData.lines` is present, it MUST be a non-empty array.\n * - If `orderData.header` is present and is an object, it MUST include a\n * non-empty `customer_id`.\n */\nfunction validateOrderPayload(orderData: Record<string, unknown>): string | null {\n if (!isPlainObject(orderData)) return \"Order payload is empty or malformed.\";\n return linesError(orderData) ?? headerError(orderData);\n}\n\n/** A non-null object that is not an array. */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** When `lines` is present it MUST be a non-empty array. */\nfunction linesError(orderData: Record<string, unknown>): string | null {\n if (!(\"lines\" in orderData)) return null;\n const lines = orderData[\"lines\"];\n return Array.isArray(lines) && lines.length > 0 ? null : \"Order has no line items.\";\n}\n\n/** When `header` is an object it MUST carry a non-blank `customer_id`. */\nfunction headerError(orderData: Record<string, unknown>): string | null {\n const header = orderData[\"header\"];\n if (!isPlainObject(header)) return null;\n const customerId = header[\"customer_id\"];\n if (customerId == null || String(customerId).trim() === \"\") {\n return \"Order is missing a customer.\";\n }\n return null;\n}\n\n/**\n * Assemble and validate the order payload. Surfaces any failure via\n * `config.ui.onError` + `setProcessingOrder(false)`, and additionally logs\n * the offending payload to `console.error` on validation failure. Returns\n * `null` when the payload was not produced or was rejected; returns the\n * `orderData` ready for `submitOrder` otherwise.\n */\nfunction prepareOrderPayload<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n contextValue: CheckoutContextValue<TCustom>,\n stateSnapshot: OrderStateSnapshot,\n setProcessingOrder: (v: boolean) => void,\n): Record<string, unknown> | null {\n const { orderData, error: assemblyError } = assembleOrderPayload(\n config,\n ctx,\n contextValue,\n stateSnapshot,\n );\n if (assemblyError) {\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Error\", assemblyError);\n return null;\n }\n\n const validationError = validateOrderPayload(orderData);\n if (validationError) {\n console.error(\"Order payload validation failed:\", orderData);\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Error\", validationError);\n return null;\n }\n\n return orderData;\n}\n\n/** Shape of persisted order confirmation data. */\nexport interface OrderConfirmation {\n orderData: Record<string, unknown>;\n result: unknown;\n shippingAddress: CheckoutAddress | undefined;\n billingAddress: CheckoutAddress | undefined;\n shippingFee: number | undefined;\n shippingMethod: string | undefined;\n taxRate: number | undefined;\n paymentMethod: string;\n carrierId: string;\n orderCartLines: unknown[] | undefined;\n}\n\n/** Build the confirmation snapshot from checkout state + API result. */\nfunction buildOrderConfirmation(\n orderData: Record<string, unknown>,\n resultData: unknown,\n state: OrderStateSnapshot,\n orderCartLines: unknown[] | undefined,\n): OrderConfirmation {\n return {\n orderData,\n result: resultData,\n shippingAddress: state.shippingAddress,\n billingAddress: state.billingAddress,\n shippingFee: state.shippingFee,\n shippingMethod: state.shippingMethod,\n taxRate: state.taxRate,\n paymentMethod: state.paymentMethod,\n carrierId: state.carrierId,\n orderCartLines,\n };\n}\n\n/**\n * Handle successful order submission.\n *\n * After running the site's `onAfterSubmit` hook and persisting the order\n * confirmation snapshot, the package clears its own client-side cart state:\n * the zustand cart store is reset, and the cart-related React Query caches\n * (`cartLines`, `cart-also-bought`, and the proxy-shape `commerce.cartLine`)\n * are invalidated so any subsequent page mount refetches from the server.\n * The redirect fires last. Sites retain responsibility for backend cart\n * cleanup inside `onAfterSubmit` or their `submitOrder` wrapper.\n */\nfunction handleOrderSuccess<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n resultData: unknown,\n confirmation: OrderConfirmation,\n setProcessingOrder: (v: boolean) => void,\n redirect: (url: string) => void,\n queryClient: QueryClient,\n clearCart: () => void,\n): void {\n if (config.payments?.persistence) {\n clearFromSession(PAYMENT_STORAGE_KEY);\n }\n config.hooks?.onAfterSubmit?.(ctx, resultData);\n if (config.order.persistence !== false) {\n try {\n sessionStorage.setItem(ORDER_CONFIRMATION_KEY, JSON.stringify(confirmation));\n } catch {\n // sessionStorage unavailable (private browsing, quota)\n }\n }\n clearCart();\n void queryClient.invalidateQueries({ queryKey: [\"cartLines\"] });\n void queryClient.invalidateQueries({ queryKey: [\"cart-also-bought\"] });\n void queryClient.invalidateQueries({ queryKey: [\"commerce\", \"cartLine\"] });\n redirect(config.order.successRedirect);\n setProcessingOrder(false);\n}\n\n/**\n * True when the order MUST NOT go ahead: a site hook cancelled it (silently), or a check\n * failed (reported as \"Missing Information\").\n */\nfunction preSubmitBlocked<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctx: CheckoutContext<TCustom>,\n shippingAddress: CheckoutAddress | undefined,\n): boolean {\n const preCheck = runPreSubmitChecks(config, ctx, shippingAddress);\n if (preCheck.kind === \"refused\") config.ui?.onError?.(\"Missing Information\", preCheck.message);\n return preCheck.kind !== \"ok\";\n}\n\n/**\n * Calls `submitOrder`. A throw or a not-ok result ends processing and reports \"Order Failed\"\n * (null); an ok result returns its data.\n */\nasync function submitOrderOnce<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n orderData: Record<string, unknown>,\n cartHdrUid: number | string | undefined,\n setProcessingOrder: (v: boolean) => void,\n): Promise<{ data: unknown } | null> {\n let result: { ok: boolean; data?: unknown; error?: string };\n try {\n result = await config.order.submitOrder(orderData, resolveCartHdrUid(cartHdrUid));\n } catch (error) {\n handleOrderError(config, setProcessingOrder, error);\n return null;\n }\n if (!result.ok) {\n setProcessingOrder(false);\n config.ui?.onError?.(\"Order Failed\", result.error ?? \"Something went wrong.\");\n return null;\n }\n return { data: result.data };\n}\n\n/** Execute order submission -- extracted to reduce component complexity. */\nasync function executeOrder<TCustom extends Record<string, unknown>>(\n config: CheckoutProviderConfig<TCustom>,\n ctxRef: React.RefObject<CheckoutContext<TCustom>>,\n stateRef: React.RefObject<OrderStateSnapshot>,\n contextValueRef: React.RefObject<CheckoutContextValue<TCustom>>,\n cartHdrUid: number | string | undefined,\n setProcessingOrder: (v: boolean) => void,\n redirect: (url: string) => void,\n queryClient: QueryClient,\n clearCart: () => void,\n): Promise<void> {\n const ctx = ctxRef.current;\n const s = stateRef.current;\n\n if (preSubmitBlocked(config, ctx, s.shippingAddress)) return;\n\n setProcessingOrder(true);\n\n const orderData = prepareOrderPayload(\n config,\n ctx,\n contextValueRef.current,\n s,\n setProcessingOrder,\n );\n if (!orderData) return;\n\n const result = await submitOrderOnce(config, orderData, cartHdrUid, setProcessingOrder);\n if (!result) return;\n\n const confirmation = buildOrderConfirmation(\n orderData,\n result.data,\n s,\n contextValueRef.current.orderCartLines,\n );\n handleOrderSuccess(\n config,\n ctx,\n result.data,\n confirmation,\n setProcessingOrder,\n redirect,\n queryClient,\n clearCart,\n );\n}\n\n/** No-op callbacks for when payment is not configured. Each resolves to undefined. */\nexport const NOOP_PAYMENT_CALLBACKS: PaymentFlowCallbacks = {\n transactionSetup: async () => undefined,\n cardInfo: async () => undefined,\n validatePayment: async () => undefined,\n accountQuery: async () => undefined,\n billingUpdate: async () => undefined,\n};\n\n/**\n * Creates a CheckoutProvider component and useCheckout() hook from site config.\n *\n * The package owns all state, transitions, validation, and order submission.\n * Sites own layout and inject configuration + lifecycle hooks.\n *\n * Steps are string-based -- sites define their own step names.\n * Payment flow is optional -- B2B sites without payment processing omit payments.callbacks.\n *\n * @example\n * ```ts\n * // Full checkout with payment\n * const { CheckoutProvider, useCheckout } = createCheckoutProvider({\n * shipping: { carriers: { \"100008\": \"UPS Ground\" }, defaultCarrierId: \"100008\" },\n * payments: { callbacks: { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate } },\n * order: { successRedirect: \"/thank-you\", submitOrder },\n * });\n *\n * // B2B checkout without payment\n * const { CheckoutProvider, useCheckout } = createCheckoutProvider({\n * shipping: { carriers: { \"100008\": \"UPS Ground\" }, defaultCarrierId: \"100008\" },\n * order: { successRedirect: \"/thank-you\", submitOrder },\n * });\n * ```\n */\n// Single context instance at module scope. Prevents stale context references\n// when createCheckoutProvider is re-called during HMR or page navigation. Each\n// provider's useCheckout reads it back as its own CheckoutContextValue<TCustom>.\nconst Ctx = createContext<unknown>(null);\n\n/** The payment modal state a site renders, when the site configured a payment flow. */\nfunction buildPaymentModal(\n hasPaymentFlow: boolean,\n payment: ReturnType<typeof usePaymentFlow>,\n): CheckoutPaymentModal | undefined {\n if (!hasPaymentFlow) return undefined;\n return {\n isOpen: payment.isOpen,\n setIsOpen: payment.setIsOpen,\n editCc: payment.editCc,\n setEditCc: payment.setEditCc,\n unified: payment.unified,\n unifiedCc: payment.unifiedCc,\n unifiedResponse: payment.unifiedResponse,\n unifiedBilling: payment.unifiedBilling,\n unifiedPayment: payment.unifiedPayment,\n handleBinCapture: payment.handleBinCapture,\n hasValidPayment: !!payment.unifiedPayment?.PaymentAccountID,\n };\n}\n\n/** The cart token from a `cartToken=` cookie; undefined with no document (SSR, React Native). */\nfunction cartTokenFrom(doc: { cookie: string } | undefined): string | undefined {\n const match = doc?.cookie.split(\";\").find((c) => c.trim().startsWith(\"cartToken=\"));\n return (match === undefined ? \"\" : secondEqualsField(match)) || undefined;\n}\n\nexport function createCheckoutProvider<\n TCustom extends Record<string, unknown> = Record<string, never>,\n>(config: CheckoutProviderConfig<TCustom>) {\n const hasPaymentFlow = !!config.payments?.callbacks;\n const paymentCallbacks = config.payments?.callbacks ?? NOOP_PAYMENT_CALLBACKS;\n\n function CheckoutProvider({\n children,\n identity: propsIdentity,\n }: CheckoutProviderProps): ReactElement {\n // -- Shipping state --\n const [shippingAddress, setShippingAddress] = useState<CheckoutAddress | undefined>();\n const [shippingFee, setShippingFee] = useState<number | undefined>();\n const [shippingMethod, setShippingMethod] = useState<string | undefined>();\n const [shippingAccepted, setShippingAccepted] = useState(false);\n const [shippingMethodSaved, setShippingMethodSaved] = useState(false);\n const [isFreeShipping, setIsFreeShipping] = useState(false);\n const [carrierId, setCarrierId] = useState(config.shipping.defaultCarrierId);\n const [showShippingMethod, setShowShippingMethod] = useState(false);\n\n // -- Billing state --\n const [billingAddress, setBillingAddress] = useState<CheckoutAddress | undefined>();\n const [paymentMethod, setPaymentMethod] = useState(() => resolveDefaultPaymentMethod(config));\n const [showBillingInfoSummary, setShowBillingInfoSummary] = useState(false);\n\n // -- Order state --\n const [orderCartLines, setOrderCartLines] = useState<unknown[] | undefined>();\n const [processingOrder, setProcessingOrder] = useState(false);\n const [taxRate, setTaxRate] = useState<number | undefined>(undefined);\n const [clientIp, setClientIp] = useState<string | undefined>();\n const [cartToken, setCartToken] = useState<string>(\"\");\n const [customerDoc, setCustomerDoc] = useState<CustomerDocument | null>(null);\n\n // -- Edit flags --\n const [isEditShippingInfo, setIsEditShippingInfo] = useState(false);\n const [isEditShippingMethods, setIsEditShippingMethods] = useState(false);\n const [isEditBillingInfo, setIsEditBillingInfo] = useState(false);\n\n // -- Step navigation (string-based, sites define their own steps) --\n const [currentStep, setCurrentStep] = useState<string>(config.initialStep ?? \"shipping\");\n\n // -- Custom state --\n const [customState, setCustomState] = useState<TCustom>(\n () => (config.customState ?? {}) as TCustom,\n );\n\n const setCustomField = useCallback(<K extends keyof TCustom>(key: K, value: TCustom[K]) => {\n setCustomState((prev) => ({ ...prev, [key]: value }));\n }, []);\n\n // -- Identity (props override config for runtime hook values) --\n const identity = propsIdentity ?? config.identity;\n const payment = usePaymentFlow({\n callbacks: paymentCallbacks,\n customerId: identity?.customerId,\n billingAddress,\n paymentMethod,\n shippingAccepted,\n persistPayment: config.payments?.persistence,\n });\n\n const paymentModal = buildPaymentModal(hasPaymentFlow, payment);\n\n // -- Lifecycle context (passed to hooks) --\n const ctxRef = useRef<CheckoutContext<TCustom>>(null!);\n ctxRef.current = {\n get: <K extends keyof TCustom>(key: K) => customState[key],\n set: setCustomField,\n skipToStep: setCurrentStep,\n setBillingAddress,\n setCarrierId,\n };\n\n // -- Edit flag transitions --\n const handleSetIsEditShippingInfo = useCallback((editing: boolean) => {\n setIsEditShippingInfo(editing);\n if (editing) {\n setShippingMethodSaved(false);\n setShowShippingMethod(false);\n }\n }, []);\n\n const handleSetIsEditShippingMethods = useCallback((editing: boolean) => {\n setIsEditShippingMethods(editing);\n if (editing) {\n setShippingMethodSaved(false);\n }\n }, []);\n\n // -- Step transitions with lifecycle hook --\n const goToStep = useCallback(\n (step: string) => {\n const from = currentStep;\n if (config.hooks?.onStepChange) {\n config.hooks.onStepChange(ctxRef.current, from, step);\n }\n setCurrentStep(step);\n },\n [currentStep],\n );\n\n // -- Cart store integration --\n const cartHdrUid = useCartHdrUid();\n const cartLines = useCartLines();\n const clearCart = useClearCart();\n const queryClient = useQueryClient();\n\n // -- Order readiness --\n const { enableProcessOrderBtn, processingValidation } = useOrderReadiness({\n cartHdrUid,\n shippingAddress,\n billingAddress,\n shippingMethodSaved,\n showBillingInfoSummary,\n processingOrder,\n paymentMethod,\n unifiedPaymentAccountId: payment.unifiedPayment?.PaymentAccountID,\n unifiedBilling: payment.unifiedBilling,\n isFreeShipping,\n carrierId,\n shippingFee,\n isEditShippingInfo,\n isEditShippingMethods,\n isEditBillingInfo,\n editCc: payment.editCc,\n customReadinessCheck: buildReadinessOverride(config, ctxRef),\n });\n\n // -- Effects: data fetching on mount --\n\n useEffect(() => {\n if (config.order.fetchClientIp) {\n void config.order.fetchClientIp().then(setClientIp);\n }\n }, []);\n\n // Fetched when the customer changes; the identity's other fields are read, not watched.\n const identityRef = useLatest(identity);\n const customerId = identity?.customerId;\n useEffect(() => {\n const current = identityRef.current;\n if (customerId && current?.fetchCustomerDoc) {\n void current\n .fetchCustomerDoc(customerId)\n .then(setCustomerDoc)\n .catch(() => setCustomerDoc(null));\n }\n }, [customerId, identityRef]);\n\n // -- Effect: tax calculation when the billing postal code or the order lines change --\n // (the customer and its document are read, not watched)\n const customerDocRef = useLatest(customerDoc);\n const postalCode = billingAddress?.postalCode;\n useEffect(() => {\n if (!config.order.calculateTax || !postalCode) return;\n void config.order\n .calculateTax({\n customerId: identityRef.current?.customerId,\n postalCode,\n items: orderCartLines ?? [],\n customerDoc: customerDocRef.current,\n })\n .then((tax) => {\n if (tax !== undefined) setTaxRate(tax);\n });\n }, [postalCode, orderCartLines, identityRef, customerDocRef]);\n\n // -- Effect: auto-copy shipping to billing (default \"same as shipping\") --\n useEffect(() => {\n if (shippingAccepted && shippingAddress && !billingAddress) {\n setBillingAddress(shippingAddress);\n }\n }, [shippingAccepted, shippingAddress, billingAddress]);\n\n // -- Effect: fire onShippingAccepted lifecycle hook (on acceptance or a new address; the\n // order lines are read, not watched) --\n const orderCartLinesRef = useLatest(orderCartLines);\n useEffect(() => {\n if (config.hooks?.onShippingAccepted && shippingAccepted && shippingAddress) {\n config.hooks.onShippingAccepted(\n ctxRef.current,\n shippingAddress,\n orderCartLinesRef.current ?? [],\n );\n }\n }, [shippingAccepted, shippingAddress, orderCartLinesRef]);\n\n // -- Effect: cart token from cookie --\n useEffect(() => {\n const token = cartTokenFrom(globalThis.document as Document | undefined);\n if (token) setCartToken(token);\n }, []);\n\n // -- Order submission with double-submit prevention --\n\n const resetProcessing = useCallback(() => setProcessingOrder(false), []);\n\n const isProcessingRef = useRef(false);\n\n const orderStateRef = useRef<OrderStateSnapshot>({\n shippingAddress,\n billingAddress,\n carrierId,\n shippingMethod,\n shippingFee,\n paymentMethod,\n taxRate,\n clientIp,\n isFreeShipping,\n identity,\n unifiedPayment: payment.unifiedPayment,\n unifiedCc: payment.unifiedCc,\n });\n orderStateRef.current = {\n shippingAddress,\n billingAddress,\n carrierId,\n shippingMethod,\n shippingFee,\n paymentMethod,\n taxRate,\n clientIp,\n isFreeShipping,\n identity,\n unifiedPayment: payment.unifiedPayment,\n unifiedCc: payment.unifiedCc,\n };\n\n const contextValueRef = useRef<CheckoutContextValue<TCustom>>(null!);\n\n const redirect = useCallback((url: string) => {\n if (config.order.redirect) {\n config.order.redirect(url);\n } else {\n defaultRedirect(url);\n }\n }, []);\n\n const processOrder = useCallback(async () => {\n if (isProcessingRef.current) return;\n isProcessingRef.current = true;\n try {\n await executeOrder(\n config,\n ctxRef,\n orderStateRef,\n contextValueRef,\n cartHdrUid,\n setProcessingOrder,\n redirect,\n queryClient,\n clearCart,\n );\n } finally {\n isProcessingRef.current = false;\n }\n }, [cartHdrUid, redirect, queryClient, clearCart]);\n\n // -- Context value --\n const value: CheckoutContextValue<TCustom> = {\n shippingAddress,\n setShippingAddress,\n shippingFee,\n setShippingFee,\n shippingMethod,\n setShippingMethod,\n shippingAccepted,\n setShippingAccepted,\n shippingMethodSaved,\n setShippingMethodSaved,\n isFreeShipping,\n setIsFreeShipping,\n carrierId,\n setCarrierId,\n showShippingMethod,\n setShowShippingMethod,\n billingAddress,\n setBillingAddress,\n paymentMethod,\n setPaymentMethod,\n showBillingInfoSummary,\n setShowBillingInfoSummary,\n paymentModal,\n cartLines,\n orderCartLines,\n setOrderCartLines,\n processingOrder,\n processOrder,\n resetProcessing,\n customerDoc,\n taxRate,\n setTaxRate,\n clientIp,\n cartToken,\n isEditShippingInfo,\n setIsEditShippingInfo: handleSetIsEditShippingInfo,\n isEditShippingMethods,\n setIsEditShippingMethods: handleSetIsEditShippingMethods,\n isEditBillingInfo,\n setIsEditBillingInfo,\n enableProcessOrderBtn,\n processingValidation,\n currentStep,\n goToStep,\n custom: customState,\n setCustom: setCustomField,\n config,\n };\n\n contextValueRef.current = value;\n\n return <Ctx.Provider value={value}>{children}</Ctx.Provider>;\n }\n\n /** Access checkout state from any child of CheckoutProvider. */\n function useCheckout(): CheckoutContextValue<TCustom> {\n const ctx = useContext(Ctx) as CheckoutContextValue<TCustom> | null;\n if (!ctx) {\n throw new Error(\"useCheckout must be used within a CheckoutProvider\");\n }\n return ctx;\n }\n\n return { CheckoutProvider, useCheckout };\n}\n"],"mappings":"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","names":["value"]}
|
|
@@ -1,15 +1,14 @@
|
|
|
1
|
-
import { ReactNode
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
|
|
5
|
-
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { PaymentFlowCallbacks } from "../hooks/use-payment-flow";
|
|
3
|
+
import type { OrderReadinessParams } from "../hooks/use-order-readiness";
|
|
4
|
+
import type { TAccountQuery, TCardInfo, TCartLine, CustomerDocument } from "@simpleapps-com/augur-utils";
|
|
6
5
|
/**
|
|
7
6
|
* Address shape used by the checkout state machine.
|
|
8
7
|
*
|
|
9
8
|
* Core fields match augur-utils ShippingAddressSchema/BillingAddressSchema.
|
|
10
9
|
* Index signature allows sites to pass schema outputs without casting.
|
|
11
10
|
*/
|
|
12
|
-
interface CheckoutAddress {
|
|
11
|
+
export interface CheckoutAddress {
|
|
13
12
|
address1: string;
|
|
14
13
|
address2?: string;
|
|
15
14
|
city: string;
|
|
@@ -32,9 +31,9 @@ interface CheckoutAddress {
|
|
|
32
31
|
[key: string]: unknown;
|
|
33
32
|
}
|
|
34
33
|
/** Default checkout steps. Sites can use any string as a step name. */
|
|
35
|
-
type DefaultCheckoutStep = "shipping" | "method" | "billing" | "payment" | "review";
|
|
34
|
+
export type DefaultCheckoutStep = "shipping" | "method" | "billing" | "payment" | "review";
|
|
36
35
|
/** Shipping configuration for the checkout provider. */
|
|
37
|
-
interface CheckoutShippingConfig {
|
|
36
|
+
export interface CheckoutShippingConfig {
|
|
38
37
|
/** Map of carrier ID to display name. */
|
|
39
38
|
carriers: Record<string, string>;
|
|
40
39
|
/** Default carrier ID selected on load. */
|
|
@@ -46,7 +45,7 @@ interface CheckoutShippingConfig {
|
|
|
46
45
|
* Payment configuration for the checkout provider.
|
|
47
46
|
* Entirely optional -- B2B sites without payment processing omit this.
|
|
48
47
|
*/
|
|
49
|
-
interface CheckoutPaymentConfig {
|
|
48
|
+
export interface CheckoutPaymentConfig {
|
|
50
49
|
/** Allowed postMessage origins for the payment iframe. */
|
|
51
50
|
allowedOrigins?: string[];
|
|
52
51
|
/** Whether invoice payment is available. Receives auth context. */
|
|
@@ -60,7 +59,7 @@ interface CheckoutPaymentConfig {
|
|
|
60
59
|
persistence?: boolean;
|
|
61
60
|
}
|
|
62
61
|
/** Order configuration for the checkout provider. */
|
|
63
|
-
interface CheckoutOrderConfig {
|
|
62
|
+
export interface CheckoutOrderConfig {
|
|
64
63
|
/** Redirect path after successful order submission. */
|
|
65
64
|
successRedirect: string;
|
|
66
65
|
/** Custom redirect function. Default: window.location.href assignment. */
|
|
@@ -88,12 +87,12 @@ interface CheckoutOrderConfig {
|
|
|
88
87
|
}) => Promise<number | undefined>;
|
|
89
88
|
}
|
|
90
89
|
/** UI callbacks for the checkout provider. */
|
|
91
|
-
interface CheckoutUIConfig {
|
|
90
|
+
export interface CheckoutUIConfig {
|
|
92
91
|
/** Called when an error needs to be displayed to the user. */
|
|
93
92
|
onError?: (title: string, message: string) => void;
|
|
94
93
|
}
|
|
95
94
|
/** Identity resolution — how the provider resolves customer/contact/user. */
|
|
96
|
-
interface CheckoutIdentityConfig {
|
|
95
|
+
export interface CheckoutIdentityConfig {
|
|
97
96
|
/** Current user session. */
|
|
98
97
|
userId?: string | number;
|
|
99
98
|
userEmail?: string;
|
|
@@ -112,7 +111,7 @@ interface CheckoutIdentityConfig {
|
|
|
112
111
|
* is tolerated today but may cause redundant effect runs if dependency
|
|
113
112
|
* handling tightens in future versions.
|
|
114
113
|
*/
|
|
115
|
-
interface CheckoutLifecycleHooks<TCustom extends Record<string, unknown>> {
|
|
114
|
+
export interface CheckoutLifecycleHooks<TCustom extends Record<string, unknown>> {
|
|
116
115
|
/**
|
|
117
116
|
* Called after shipping address is accepted.
|
|
118
117
|
*
|
|
@@ -164,7 +163,7 @@ interface CheckoutLifecycleHooks<TCustom extends Record<string, unknown>> {
|
|
|
164
163
|
isOrderReady?: (ctx: CheckoutContext<TCustom>, params: OrderReadinessParams) => boolean | undefined;
|
|
165
164
|
}
|
|
166
165
|
/** Full checkout provider configuration. */
|
|
167
|
-
interface CheckoutProviderConfig<TCustom extends Record<string, unknown> = Record<string, never>> {
|
|
166
|
+
export interface CheckoutProviderConfig<TCustom extends Record<string, unknown> = Record<string, never>> {
|
|
168
167
|
shipping: CheckoutShippingConfig;
|
|
169
168
|
/** Payment config. Omit entirely for B2B sites without payment processing. */
|
|
170
169
|
payments?: CheckoutPaymentConfig;
|
|
@@ -178,7 +177,7 @@ interface CheckoutProviderConfig<TCustom extends Record<string, unknown> = Recor
|
|
|
178
177
|
initialStep?: string;
|
|
179
178
|
}
|
|
180
179
|
/** Mutable context object passed to lifecycle hooks. */
|
|
181
|
-
interface CheckoutContext<TCustom extends Record<string, unknown>> {
|
|
180
|
+
export interface CheckoutContext<TCustom extends Record<string, unknown>> {
|
|
182
181
|
/** Get a custom state value. */
|
|
183
182
|
get: <K extends keyof TCustom>(key: K) => TCustom[K];
|
|
184
183
|
/** Set a custom state value. */
|
|
@@ -191,7 +190,7 @@ interface CheckoutContext<TCustom extends Record<string, unknown>> {
|
|
|
191
190
|
setCarrierId: (carrierId: string) => void;
|
|
192
191
|
}
|
|
193
192
|
/** Payment modal state. Only present when payments.callbacks is provided. */
|
|
194
|
-
interface CheckoutPaymentModal {
|
|
193
|
+
export interface CheckoutPaymentModal {
|
|
195
194
|
isOpen: boolean;
|
|
196
195
|
setIsOpen: (open: boolean) => void;
|
|
197
196
|
editCc: boolean;
|
|
@@ -205,7 +204,7 @@ interface CheckoutPaymentModal {
|
|
|
205
204
|
hasValidPayment: boolean;
|
|
206
205
|
}
|
|
207
206
|
/** Full checkout context value returned by useCheckout(). */
|
|
208
|
-
interface CheckoutContextValue<TCustom extends Record<string, unknown> = Record<string, never>> {
|
|
207
|
+
export interface CheckoutContextValue<TCustom extends Record<string, unknown> = Record<string, never>> {
|
|
209
208
|
shippingAddress: CheckoutAddress | undefined;
|
|
210
209
|
setShippingAddress: (address: CheckoutAddress | undefined) => void;
|
|
211
210
|
shippingFee: number | undefined;
|
|
@@ -264,30 +263,9 @@ interface CheckoutContextValue<TCustom extends Record<string, unknown> = Record<
|
|
|
264
263
|
config: CheckoutProviderConfig<TCustom>;
|
|
265
264
|
}
|
|
266
265
|
/** Props for the generated CheckoutProvider component. */
|
|
267
|
-
interface CheckoutProviderProps {
|
|
266
|
+
export interface CheckoutProviderProps {
|
|
268
267
|
children: ReactNode;
|
|
269
268
|
/** Runtime identity from hooks (useAugurAuth, useSession, etc.). Overrides config.identity. */
|
|
270
269
|
identity?: CheckoutIdentityConfig;
|
|
271
270
|
}
|
|
272
|
-
|
|
273
|
-
/** sessionStorage key for persisted order confirmation data. */
|
|
274
|
-
declare const ORDER_CONFIRMATION_KEY = "orderConfirmation";
|
|
275
|
-
/** Shape of persisted order confirmation data. */
|
|
276
|
-
interface OrderConfirmation {
|
|
277
|
-
orderData: Record<string, unknown>;
|
|
278
|
-
result: unknown;
|
|
279
|
-
shippingAddress: CheckoutAddress | undefined;
|
|
280
|
-
billingAddress: CheckoutAddress | undefined;
|
|
281
|
-
shippingFee: number | undefined;
|
|
282
|
-
shippingMethod: string | undefined;
|
|
283
|
-
taxRate: number | undefined;
|
|
284
|
-
paymentMethod: string;
|
|
285
|
-
carrierId: string;
|
|
286
|
-
orderCartLines: unknown[] | undefined;
|
|
287
|
-
}
|
|
288
|
-
declare function createCheckoutProvider<TCustom extends Record<string, unknown> = Record<string, never>>(config: CheckoutProviderConfig<TCustom>): {
|
|
289
|
-
CheckoutProvider: ({ children, identity: propsIdentity, }: CheckoutProviderProps) => ReactElement;
|
|
290
|
-
useCheckout: () => CheckoutContextValue<TCustom>;
|
|
291
|
-
};
|
|
292
|
-
|
|
293
|
-
export { type CheckoutAddress, type CheckoutContext, type CheckoutContextValue, type CheckoutIdentityConfig, type CheckoutLifecycleHooks, type CheckoutOrderConfig, type CheckoutPaymentConfig, type CheckoutPaymentModal, type CheckoutProviderConfig, type CheckoutProviderProps, type CheckoutShippingConfig, type CheckoutUIConfig, type DefaultCheckoutStep, ORDER_CONFIRMATION_KEY, type OrderConfirmation, createCheckoutProvider };
|
|
271
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkout/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/
|
|
1
|
+
{"version":3,"sources":["/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/chunk-6Z6JGK2C.cjs","../src/query-action-registry.ts","../src/queries/batch-query.ts"],"names":[],"mappings":"AAAA;ACaA,IAAI,aAAA,EAAqC,IAAA;AAGlC,SAAS,mBAAA,CAAoB,EAAA,EAAyB;AAC3D,EAAA,aAAA,EAAe,EAAA;AACjB;AAGO,SAAS,wBAAA,CAAA,EAAiD;AAC/D,EAAA,OAAO,YAAA;AACT;ADfA;AACA;AEcA,MAAA,SAAsB,iBAAA,CACpB,MAAA,EACgC;AAChC,EAAA,MAAM,EAAE,MAAA,EAAQ,WAAA,EAAa,UAAA,EAAY,YAAA,EAAc,UAAA,EAAY,WAAW,EAAA,EAAI,MAAA;AAElF,EAAA,GAAA,CAAI,MAAA,CAAO,OAAA,IAAW,CAAA,EAAG;AACvB,IAAA,OAAO,CAAC,CAAA;AAAA,EACV;AAEA,EAAA,MAAM,OAAA,EAAgC,CAAC,CAAA;AACvC,EAAA,MAAM,SAAA,EAAqB,CAAC,CAAA;AAE5B,EAAA,IAAA,CAAA,MAAW,MAAA,GAAS,MAAA,EAAQ;AAC1B,IAAA,MAAM,SAAA,EAAW,WAAA,CAAY,YAAA,CAAoB,UAAA,CAAW,KAAK,CAAC,CAAA;AAClE,IAAA,GAAA,CAAI,SAAA,IAAa,KAAA,CAAA,EAAW;AAC1B,MAAA,MAAA,CAAO,YAAA,CAAa,KAAK,CAAC,EAAA,EAAI,QAAA;AAAA,IAChC,EAAA,KAAO;AACL,MAAA,QAAA,CAAS,IAAA,CAAK,KAAK,CAAA;AAAA,IACrB;AAAA,EACF;AAEA,EAAA,GAAA,CAAI,QAAA,CAAS,OAAA,IAAW,CAAA,EAAG;AACzB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,QAAA,EAAU,MAAM,UAAA,CAAW,QAAQ,CAAA;AAEzC,EAAA,IAAA,CAAA,MAAW,CAAC,GAAA,EAAK,IAAI,EAAA,GAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACjD,IAAA,WAAA,CAAY,YAAA,CAAa,UAAA,CAAW,GAAA,EAAK,IAAa,CAAA,EAAG,IAAI,CAAA;AAAA,EAC/D;AAEA,EAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,GAAG,QAAQ,CAAA;AACjC;AFrBA;AACA;AACE;AACA;AACA;AACF,8JAAC","file":"/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/chunk-6Z6JGK2C.cjs","sourcesContent":[null,"/**\n * Lightweight registry for a query action function.\n *\n * augur-server/hooks.ts registers its queryAction as a side effect when\n * imported. augur-hooks consumers (useCartPricing, useStock, the provider)\n * read from this registry to route data through server actions automatically.\n *\n * No circular dependency: augur-server depends on augur-hooks and writes here.\n * augur-hooks reads from its own module.\n */\n\ntype QueryActionFn = (methodPath: string, ...args: unknown[]) => Promise<unknown>;\n\nlet _queryAction: QueryActionFn | null = null;\n\n/** Register a query action function (called by augur-server/hooks.ts on import). */\nexport function registerQueryAction(fn: QueryActionFn): void {\n _queryAction = fn;\n}\n\n/** Returns the registered query action, or null if none registered. */\nexport function getRegisteredQueryAction(): QueryActionFn | null {\n return _queryAction;\n}\n\n/** Clears the registered query action. Used in tests only. @internal */\nexport function clearRegisteredQueryAction(): void {\n _queryAction = null;\n}\n","import type { QueryClient } from \"@tanstack/react-query\";\n\nexport interface BatchQueryConfig<TParam, TData> {\n params: TParam[];\n queryClient: QueryClient;\n /** Build individual cache key for a single param. */\n getItemKey: (param: TParam) => readonly unknown[];\n /** Build the string key for the result Record from a param. */\n getResultKey: (param: TParam) => string;\n /** Fetch only uncached items, return keyed Record. */\n fetchItems: (uncached: TParam[]) => Promise<Record<string, TData>>;\n /** Extract individual cache key from a fetched result entry (for seeding). */\n getSeedKey: (resultKey: string, data: TData) => readonly unknown[];\n}\n\n/**\n * Generic batch query executor.\n *\n * 1. Checks queryClient cache for each param\n * 2. Fetches only uncached items in a single batch call\n * 3. Seeds individual cache entries from the response\n * 4. Returns merged cached + fetched record\n */\nexport async function executeBatchQuery<TParam, TData>(\n config: BatchQueryConfig<TParam, TData>,\n): Promise<Record<string, TData>> {\n const { params, queryClient, getItemKey, getResultKey, fetchItems, getSeedKey } = config;\n\n if (params.length === 0) {\n return {};\n }\n\n const cached: Record<string, TData> = {};\n const uncached: TParam[] = [];\n\n for (const param of params) {\n const existing = queryClient.getQueryData<TData>(getItemKey(param));\n if (existing !== undefined) {\n cached[getResultKey(param)] = existing;\n } else {\n uncached.push(param);\n }\n }\n\n if (uncached.length === 0) {\n return cached;\n }\n\n const fetched = await fetchItems(uncached);\n\n for (const [key, data] of Object.entries(fetched)) {\n queryClient.setQueryData(getSeedKey(key, data as TData), data);\n }\n\n return { ...cached, ...fetched };\n}\n"]}
|