@simpleapps-com/augur-hooks 2.4.0 → 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.
Files changed (99) hide show
  1. package/EXPORTS.md +25 -65
  2. package/README.md +21 -246
  3. package/dist/checkout/create-checkout-provider.d.ts +25 -0
  4. package/dist/checkout/create-checkout-provider.d.ts.map +1 -0
  5. package/dist/checkout/index.cjs +123 -106
  6. package/dist/checkout/index.cjs.map +1 -1
  7. package/dist/checkout/index.d.ts +5 -293
  8. package/dist/checkout/index.d.ts.map +1 -0
  9. package/dist/checkout/index.js +99 -82
  10. package/dist/checkout/index.js.map +1 -1
  11. package/dist/checkout/{index.d.cts → types.d.ts} +18 -40
  12. package/dist/checkout/types.d.ts.map +1 -0
  13. package/dist/chunk-6Z6JGK2C.cjs.map +1 -1
  14. package/dist/chunk-QB7VB5FZ.cjs +523 -0
  15. package/dist/chunk-QB7VB5FZ.cjs.map +1 -0
  16. package/dist/{chunk-JNOHB4OP.js → chunk-UTDAFIQP.js} +234 -94
  17. package/dist/chunk-UTDAFIQP.js.map +1 -0
  18. package/dist/hooks/use-cart-actions.d.ts +68 -0
  19. package/dist/hooks/use-cart-actions.d.ts.map +1 -0
  20. package/dist/hooks/use-cart-initialization.d.ts +60 -0
  21. package/dist/hooks/use-cart-initialization.d.ts.map +1 -0
  22. package/dist/hooks/use-cart-pricing.d.ts +41 -0
  23. package/dist/hooks/use-cart-pricing.d.ts.map +1 -0
  24. package/dist/hooks/use-checkout-persistence.d.ts +40 -0
  25. package/dist/hooks/use-checkout-persistence.d.ts.map +1 -0
  26. package/dist/hooks/use-debounce.d.ts +6 -0
  27. package/dist/hooks/use-debounce.d.ts.map +1 -0
  28. package/dist/hooks/use-format-price.d.ts +29 -0
  29. package/dist/hooks/use-format-price.d.ts.map +1 -0
  30. package/dist/hooks/use-latest.d.ts +8 -0
  31. package/dist/hooks/use-latest.d.ts.map +1 -0
  32. package/dist/hooks/use-modal-lifecycle.d.ts +11 -0
  33. package/dist/hooks/use-modal-lifecycle.d.ts.map +1 -0
  34. package/dist/hooks/use-order-readiness.d.ts +47 -0
  35. package/dist/hooks/use-order-readiness.d.ts.map +1 -0
  36. package/dist/hooks/use-pagination-prefetch.d.ts +26 -0
  37. package/dist/hooks/use-pagination-prefetch.d.ts.map +1 -0
  38. package/dist/{use-order-readiness-DZTIfRzw.d.ts → hooks/use-payment-flow.d.ts} +23 -67
  39. package/dist/hooks/use-payment-flow.d.ts.map +1 -0
  40. package/dist/hooks/use-stock.d.ts +32 -0
  41. package/dist/hooks/use-stock.d.ts.map +1 -0
  42. package/dist/index.cjs +215 -178
  43. package/dist/index.cjs.map +1 -1
  44. package/dist/index.d.ts +32 -456
  45. package/dist/index.d.ts.map +1 -0
  46. package/dist/index.js +193 -156
  47. package/dist/index.js.map +1 -1
  48. package/dist/persistence/apply-limits.d.ts +8 -0
  49. package/dist/persistence/apply-limits.d.ts.map +1 -0
  50. package/dist/persistence/create-persister.d.ts +10 -0
  51. package/dist/persistence/create-persister.d.ts.map +1 -0
  52. package/dist/persistence/serializer.d.ts +11 -0
  53. package/dist/persistence/serializer.d.ts.map +1 -0
  54. package/dist/persistence/use-persistence.d.ts +59 -0
  55. package/dist/persistence/use-persistence.d.ts.map +1 -0
  56. package/dist/persistence/use-storage-monitor.d.ts +11 -0
  57. package/dist/persistence/use-storage-monitor.d.ts.map +1 -0
  58. package/dist/provider.d.ts +89 -0
  59. package/dist/provider.d.ts.map +1 -0
  60. package/dist/queries/batch-query.d.ts +23 -0
  61. package/dist/queries/batch-query.d.ts.map +1 -0
  62. package/dist/queries/cache-helper.d.ts +16 -0
  63. package/dist/queries/cache-helper.d.ts.map +1 -0
  64. package/dist/queries/index.d.ts +3 -0
  65. package/dist/queries/index.d.ts.map +1 -0
  66. package/dist/query-action-registry.d.ts +19 -0
  67. package/dist/query-action-registry.d.ts.map +1 -0
  68. package/dist/rules.d.ts +130 -0
  69. package/dist/rules.d.ts.map +1 -0
  70. package/dist/server.cjs.map +1 -1
  71. package/dist/server.d.ts +10 -12
  72. package/dist/server.d.ts.map +1 -0
  73. package/dist/stores/cart-store.d.ts +51 -0
  74. package/dist/stores/cart-store.d.ts.map +1 -0
  75. package/dist/stores/items-filters-store.d.ts +30 -0
  76. package/dist/stores/items-filters-store.d.ts.map +1 -0
  77. package/dist/types.d.ts +48 -0
  78. package/dist/types.d.ts.map +1 -0
  79. package/dist/web/use-image-with-fallback.d.ts +16 -0
  80. package/dist/web/use-image-with-fallback.d.ts.map +1 -0
  81. package/dist/web/use-mobile-detection.d.ts +28 -0
  82. package/dist/web/use-mobile-detection.d.ts.map +1 -0
  83. package/dist/web/use-mobile-optimized-intersection.d.ts +17 -0
  84. package/dist/web/use-mobile-optimized-intersection.d.ts.map +1 -0
  85. package/dist/web.cjs.map +1 -1
  86. package/dist/web.d.ts +4 -60
  87. package/dist/web.d.ts.map +1 -0
  88. package/dist/web.js.map +1 -1
  89. package/llms.txt +76 -54
  90. package/package.json +25 -14
  91. package/dist/batch-query-CTlvxSmL.d.cts +0 -165
  92. package/dist/batch-query-CTlvxSmL.d.ts +0 -165
  93. package/dist/chunk-F5DUFW57.cjs +0 -383
  94. package/dist/chunk-F5DUFW57.cjs.map +0 -1
  95. package/dist/chunk-JNOHB4OP.js.map +0 -1
  96. package/dist/index.d.cts +0 -456
  97. package/dist/server.d.cts +0 -44
  98. package/dist/use-order-readiness-DZTIfRzw.d.cts +0 -137
  99. package/dist/web.d.cts +0 -60
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/stores/cart-store.ts","../src/hooks/use-checkout-persistence.ts","../src/hooks/use-payment-flow.ts","../src/hooks/use-order-readiness.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\n\n/** Internal state shape for the cart Zustand store. */\ninterface CartState {\n /** P21 cart header UID; `undefined` when no cart exists. */\n cartHdrUid: number | string | undefined;\n /** Current line items in the cart. */\n cartLines: TCartLine[];\n /** Sum of `quantity` across all cart lines (auto-computed by `setCartLines`). */\n cartQuantityTotal: number;\n /** Number of distinct line items (auto-computed by `setCartLines`). */\n cartLineCount: number;\n setCartHdrUid: (cartHdrUid: number | string | undefined) => void;\n /** Replace all cart lines. Auto-recomputes `cartQuantityTotal` and `cartLineCount`. */\n setCartLines: (cartLines: TCartLine[]) => void;\n /** Reset the cart to its empty initial state. */\n clearCart: () => void;\n}\n\n/** Zustand store for cart state. Prefer the individual selector hooks below for optimal re-renders. */\nexport const useCartStore = create<CartState>()(\n devtools(\n (set) => ({\n cartHdrUid: undefined,\n cartLines: [],\n cartQuantityTotal: 0,\n cartLineCount: 0,\n\n setCartHdrUid: (cartHdrUid) => set({ cartHdrUid }, false, \"setCartHdrUid\"),\n\n setCartLines: (cartLines) => {\n const cartQuantityTotal = cartLines.reduce((sum, line) => sum + (line.quantity || 0), 0);\n const cartLineCount = cartLines.length;\n set({ cartLines, cartQuantityTotal, cartLineCount }, false, \"setCartLines\");\n },\n\n clearCart: () =>\n set(\n { cartHdrUid: undefined, cartLines: [], cartQuantityTotal: 0, cartLineCount: 0 },\n false,\n \"clearCart\",\n ),\n }),\n { name: \"CartStore\", enabled: process.env[\"NODE_ENV\"] === \"development\" },\n ),\n);\n\n// Selector hooks -- only re-render when specific state changes\n\n/** Select the current cart header UID. */\nexport const useCartHdrUid = () => useCartStore((s) => s.cartHdrUid);\n/** Select the current cart line items array. */\nexport const useCartLines = () => useCartStore((s) => s.cartLines);\n/** Select the total quantity summed across all cart lines. */\nexport const useCartQuantityTotal = () => useCartStore((s) => s.cartQuantityTotal);\n/** Select the number of distinct line items in the cart. */\nexport const useCartLineCount = () => useCartStore((s) => s.cartLineCount);\n/** Get the `setCartHdrUid` action (stable reference). */\nexport const useSetCartHdrUid = () => useCartStore((s) => s.setCartHdrUid);\n/** Get the `setCartLines` action (stable reference). Also recomputes totals. */\nexport const useSetCartLines = () => useCartStore((s) => s.setCartLines);\n/** Get the `clearCart` action (stable reference). */\nexport const useClearCart = () => useCartStore((s) => s.clearCart);\n","\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\n/** A single persisted field with its storage key and optional TTL. */\nexport interface CheckoutPersistField<T> {\n key: string;\n value: T;\n set: (value: T) => void;\n /** Valibot or custom validator. Return the parsed value or throw to reject. */\n validate?: (raw: unknown) => T;\n /** TTL in milliseconds. Default: 30 minutes. */\n ttl?: number;\n}\n\ninterface StorageEntry {\n value: unknown;\n savedAt: number;\n}\n\nconst DEFAULT_TTL = 30 * 60 * 1000; // 30 minutes\n\n/**\n * Saves a value to sessionStorage with a timestamp for TTL expiration.\n *\n * Fails silently on storage errors (private browsing, quota exceeded).\n */\nexport function saveToSession(key: string, value: unknown): void {\n try {\n const entry: StorageEntry = { value, savedAt: Date.now() };\n sessionStorage.setItem(key, JSON.stringify(entry));\n } catch {\n // sessionStorage unavailable (private browsing, quota)\n }\n}\n\n/**\n * Loads a value from sessionStorage, checking TTL and optionally validating.\n *\n * Returns null if missing, expired, invalid, or storage is unavailable.\n * Cleans up expired entries automatically.\n */\nexport function loadFromSession<T>(\n key: string,\n ttl: number = DEFAULT_TTL,\n validate?: (raw: unknown) => T,\n): T | null {\n try {\n const raw = sessionStorage.getItem(key);\n if (!raw) return null;\n\n const entry = JSON.parse(raw) as StorageEntry;\n if (Date.now() - entry.savedAt > ttl) {\n sessionStorage.removeItem(key);\n return null;\n }\n\n if (validate) {\n return validate(entry.value);\n }\n return entry.value as T;\n } catch {\n sessionStorage.removeItem(key);\n return null;\n }\n}\n\n/** Removes a checkout persistence key from sessionStorage. */\nexport function clearFromSession(key: string): void {\n try {\n sessionStorage.removeItem(key);\n } catch {\n // ignore\n }\n}\n\n/**\n * Hook that persists checkout state fields to sessionStorage and restores on mount.\n *\n * Each field is saved when its value changes and restored once on initial mount.\n * Validates restored values against an optional schema to guard against\n * corrupted or stale storage. Expired entries (past TTL) are discarded.\n */\nexport function useCheckoutPersistence(fields: CheckoutPersistField<unknown>[]): void {\n // Restore on mount (once). Capture fields in a ref so the effect has no deps.\n const fieldsRef = useRef(fields);\n fieldsRef.current = fields;\n\n useEffect(() => {\n for (const field of fieldsRef.current) {\n const restored = loadFromSession(field.key, field.ttl ?? DEFAULT_TTL, field.validate);\n if (restored !== null) {\n field.set(restored);\n }\n }\n }, []);\n\n // Save on change -- serialized values as dependency to avoid dynamic dep arrays\n const serialized = JSON.stringify(fields.map((f) => [f.key, f.value]));\n useEffect(() => {\n for (const field of fields) {\n if (field.value !== undefined && field.value !== null) {\n saveToSession(field.key, field.value);\n }\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [serialized]);\n}\n\n/**\n * Clears all checkout persistence keys from sessionStorage.\n *\n * Call after successful order submission to prevent stale data on next checkout.\n */\nexport function clearCheckoutPersistence(keys: string[]): void {\n for (const key of keys) {\n clearFromSession(key);\n }\n}\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type {\n TTransactionSetup,\n TCardInfo,\n TPaymentValidation,\n TAccountQuery,\n TBillingUpdate,\n} from \"@simpleapps-com/augur-utils\";\nimport { saveToSession, loadFromSession, clearFromSession } from \"./use-checkout-persistence\";\n\n/** Site-specific payment action callbacks injected into usePaymentFlow. */\nexport interface PaymentFlowCallbacks {\n /** Initialize a payment session. Returns transaction setup or undefined on failure. */\n transactionSetup: (params: { customerId: string }) => Promise<TTransactionSetup | undefined>;\n /** Retrieve card details after iframe entry. */\n cardInfo: (params: { transactionSetupId: string }) => Promise<TCardInfo | undefined>;\n /** Verify card is valid. */\n validatePayment: (params: {\n transactionSetupId: string;\n customerId: string;\n }) => Promise<TPaymentValidation | undefined>;\n /** Get payment account ID. */\n accountQuery: (params: {\n transactionSetupId: string;\n customerId: string;\n }) => Promise<TAccountQuery | undefined>;\n /** Send billing address to payment processor. */\n billingUpdate: (params: {\n transactionSetupId: string;\n address1: string;\n address2?: string;\n city: string;\n state: string;\n zip: string;\n }) => Promise<TBillingUpdate | undefined>;\n /** Optional toast notification callback. */\n toast?: {\n error?: (message: string) => void;\n };\n}\n\n/** Billing address shape accepted by the payment flow. */\nexport interface PaymentBillingAddress {\n address1: string;\n address2?: string;\n city: string;\n state: string;\n postalCode: string;\n}\n\ninterface UsePaymentFlowParams {\n callbacks: PaymentFlowCallbacks;\n customerId: string | number | undefined;\n billingAddress: PaymentBillingAddress | undefined;\n paymentMethod: string;\n shippingAccepted: boolean;\n /** Persist payment tokens to sessionStorage for cross-navigation recovery. */\n persistPayment?: boolean;\n}\n\n/** sessionStorage key for persisted payment tokens. */\nexport const PAYMENT_STORAGE_KEY = \"checkout:payment\";\n\n/** Shape of persisted payment data. Only token IDs, never card data (PCI-DSS). */\ninterface PersistedPayment {\n transactionSetupId: string;\n paymentAccountId: string;\n}\n\n/**\n * Manages the full Element/Unified payment lifecycle:\n * transactionSetup -> cardInfo -> validatePayment -> accountQuery -> billingUpdate\n *\n * Accepts site-specific server action callbacks so the hook has no dependency\n * on any particular server action implementation.\n *\n * @example\n * ```tsx\n * import { usePaymentFlow } from \"@simpleapps-com/augur-hooks\";\n * import { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate } from \"@/lib/actions/payments\";\n *\n * const payment = usePaymentFlow({\n * callbacks: { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate },\n * customerId,\n * billingAddress,\n * paymentMethod: \"credit-card\",\n * shippingAccepted: true,\n * });\n * ```\n */\nexport function usePaymentFlow({\n callbacks,\n customerId,\n billingAddress,\n paymentMethod,\n shippingAccepted,\n persistPayment,\n}: UsePaymentFlowParams) {\n const [isOpen, setIsOpen] = useState(false);\n const [unified, setUnified] = useState<TTransactionSetup | null>(null);\n const [unifiedCc, setUnifiedCc] = useState<TCardInfo | null>(null);\n const [unifiedResponse, setUnifiedResponse] = useState(false);\n const [unifiedBilling, setUnifiedBilling] = useState(false);\n const [unifiedPayment, setUnifiedPayment] = useState<TAccountQuery | null>(null);\n const [capturedBin, setCapturedBin] = useState<string | null>(null);\n const [editCc, setEditCc] = useState(false);\n\n const handleBinCapture = useCallback((bin: string) => {\n setCapturedBin(bin);\n }, []);\n\n // Ref ensures callbacks always read the latest customerId, avoiding stale\n // closures when React batches state updates (e.g., modal close + verify).\n const customerIdRef = useRef(customerId);\n customerIdRef.current = customerId;\n\n // @invariant verifyUnified runs at most once per transactionSetupId\n // (hasVerifiedRef.current ∈ {null} ∪ {setupId already verified}; a fresh\n // setupId ⇒ exactly one verify). Without this, the post-close verify effect\n // re-fires whenever the consumer's inline `callbacks` prop changes identity\n // (every parent render), spraying redundant validatePayment/cardInfo calls\n // at the payment gateway. Keyed by setupId, not a boolean, so a new setup\n // (edit-card) re-verifies while a restored setup is treated as done.\n const hasVerifiedRef = useRef<string | null>(null);\n\n // Step 1: Initialize payment session\n const postUnified = useCallback(async () => {\n if (!customerIdRef.current) return;\n try {\n const result = await callbacks.transactionSetup({\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to initialize payment. Please try again.\");\n return;\n }\n setUnified(result);\n } catch (error) {\n console.error(\"transactionSetup failed:\", error);\n callbacks.toast?.error?.(\"Unable to initialize payment. Please try again.\");\n }\n }, [callbacks]);\n\n // Step 2: Get card info after iframe entry\n const getCardInfo = useCallback(async () => {\n /* v8 ignore next -- defensive: caller (verifyUnified) already guards */\n if (!unified?.transactionSetupId) return;\n try {\n const result = await callbacks.cardInfo({ transactionSetupId: unified.transactionSetupId });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to verify card details. Please try again.\");\n return;\n }\n setUnifiedCc(result);\n } catch (error) {\n console.error(\"cardInfo failed:\", error);\n callbacks.toast?.error?.(\"Unable to verify card details. Please try again.\");\n }\n }, [unified, callbacks]);\n\n // Step 3: Validate payment\n const verifyUnified = useCallback(async () => {\n if (!unified?.transactionSetupId || !customerIdRef.current) return;\n try {\n const result = await callbacks.validatePayment({\n transactionSetupId: unified.transactionSetupId,\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Payment verification failed. Please try again.\");\n return;\n }\n setUnifiedResponse(result.valid);\n if (result.valid) {\n await getCardInfo();\n }\n } catch (error) {\n console.error(\"validatePayment failed:\", error);\n callbacks.toast?.error?.(\"Payment verification failed. Please try again.\");\n }\n }, [unified, getCardInfo, callbacks]);\n\n // Step 4: Get payment account info\n const getUnifiedPayment = useCallback(async () => {\n if (!unified?.transactionSetupId || !customerIdRef.current) return;\n try {\n const result = await callbacks.accountQuery({\n transactionSetupId: unified.transactionSetupId,\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to retrieve payment account. Please try again.\");\n return;\n }\n const payment = capturedBin && !result.Bin ? { ...result, Bin: capturedBin } : result;\n setUnifiedPayment(payment);\n if (persistPayment && result.PaymentAccountID) {\n saveToSession(PAYMENT_STORAGE_KEY, {\n transactionSetupId: unified.transactionSetupId,\n paymentAccountId: result.PaymentAccountID,\n } satisfies PersistedPayment);\n }\n } catch (error) {\n console.error(\"accountQuery failed:\", error);\n callbacks.toast?.error?.(\"Unable to retrieve payment account. Please try again.\");\n }\n }, [unified, capturedBin, callbacks, persistPayment]);\n\n // Step 5: Update billing info\n const updateUnifiedBilling = useCallback(async () => {\n /* v8 ignore next -- defensive: effect already guards billingAddress/unified */\n if (!unified?.transactionSetupId || !billingAddress) return;\n try {\n const result = await callbacks.billingUpdate({\n transactionSetupId: unified.transactionSetupId,\n address1: billingAddress.address1,\n address2: billingAddress.address2,\n city: billingAddress.city,\n state: billingAddress.state,\n zip: billingAddress.postalCode,\n });\n if (!result) {\n callbacks.toast?.error?.(\"Billing update failed. Please try again.\");\n return;\n }\n setUnifiedBilling(true);\n void getUnifiedPayment();\n } catch (error) {\n console.error(\"billingUpdate failed:\", error);\n callbacks.toast?.error?.(\"Billing update failed. Please try again.\");\n }\n }, [unified, billingAddress, getUnifiedPayment, callbacks]);\n\n // Close payment modal if preconditions are lost\n useEffect(() => {\n if (isOpen && (!shippingAccepted || paymentMethod !== \"credit-card\")) {\n setIsOpen(false);\n }\n }, [isOpen, shippingAccepted, paymentMethod]);\n\n // Initialize payment setup when modal opens with no transaction\n useEffect(() => {\n if (isOpen && shippingAccepted && paymentMethod === \"credit-card\" && unified === null) {\n void postUnified();\n }\n }, [isOpen, shippingAccepted, paymentMethod, unified, postUnified]);\n\n // Verify payment after modal closes. Guard by transactionSetupId so the\n // effect verifies once per setup instead of re-firing on every parent render\n // (the consumer's inline `callbacks` prop churns verifyUnified's identity).\n useEffect(() => {\n const setupId = unified?.transactionSetupId;\n if (!isOpen && setupId && shippingAccepted && paymentMethod === \"credit-card\") {\n if (hasVerifiedRef.current === setupId) return;\n hasVerifiedRef.current = setupId;\n void verifyUnified();\n }\n }, [isOpen, unified, shippingAccepted, paymentMethod, verifyUnified]);\n\n // Trigger billing update when card verified + billing address ready\n useEffect(() => {\n if (\n unifiedResponse &&\n billingAddress !== undefined &&\n unifiedCc?.transactionSetupId &&\n paymentMethod === \"credit-card\"\n ) {\n void updateUnifiedBilling();\n }\n }, [\n unifiedResponse,\n billingAddress,\n unifiedCc?.transactionSetupId,\n updateUnifiedBilling,\n paymentMethod,\n ]);\n\n // Reset all payment state when editing CC\n useEffect(() => {\n if (editCc) {\n setIsOpen(true);\n setUnified(null);\n setUnifiedCc(null);\n setUnifiedPayment(null);\n setUnifiedBilling(false);\n setUnifiedResponse(false);\n setCapturedBin(null);\n hasVerifiedRef.current = null;\n if (persistPayment) {\n clearFromSession(PAYMENT_STORAGE_KEY);\n }\n }\n }, [editCc, persistPayment]);\n\n // Restore persisted payment tokens on mount\n const restorePayment = useCallback(async () => {\n if (!customerIdRef.current) return;\n\n const saved = loadFromSession<PersistedPayment>(PAYMENT_STORAGE_KEY);\n if (!saved?.transactionSetupId || !saved?.paymentAccountId) return;\n\n const { transactionSetupId } = saved;\n try {\n const account = await callbacks.accountQuery({\n transactionSetupId,\n customerId: String(customerIdRef.current),\n });\n if (!account?.PaymentAccountID) {\n clearFromSession(PAYMENT_STORAGE_KEY);\n return;\n }\n // Restore already proved this setup valid (accountQuery succeeded);\n // mark it verified so the post-close effect does not re-validate it.\n hasVerifiedRef.current = transactionSetupId;\n setUnified({ transactionSetupId });\n setUnifiedPayment(account);\n setUnifiedResponse(true);\n setUnifiedBilling(true);\n const card = await callbacks.cardInfo({ transactionSetupId });\n if (card) setUnifiedCc(card);\n } catch {\n clearFromSession(PAYMENT_STORAGE_KEY);\n }\n }, [callbacks]);\n\n useEffect(() => {\n if (persistPayment) {\n void restorePayment();\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [persistPayment]);\n\n return {\n isOpen,\n setIsOpen,\n editCc,\n setEditCc,\n unified,\n unifiedCc,\n unifiedResponse,\n unifiedBilling,\n unifiedPayment,\n capturedBin,\n handleBinCapture,\n };\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/** Parameters for order readiness validation. */\nexport interface OrderReadinessParams {\n cartHdrUid: string | number | undefined;\n shippingAddress: unknown;\n billingAddress: unknown;\n shippingMethodSaved: boolean;\n showBillingInfoSummary: boolean;\n processingOrder: boolean;\n paymentMethod: string;\n unifiedPaymentAccountId: string | undefined;\n unifiedBilling: boolean;\n isFreeShipping: boolean;\n carrierId: string;\n shippingFee: number | undefined;\n isEditShippingInfo: boolean;\n isEditShippingMethods: boolean;\n isEditBillingInfo: boolean;\n editCc: boolean;\n /**\n * Site-provided function to check if the order is ready.\n *\n * Return `true` or `false` to override the default gates. Return\n * `undefined` to defer to the default logic (useful when the override\n * only applies to specific order flows — e.g. sample-only or pickup).\n */\n customReadinessCheck?: (params: OrderReadinessParams) => boolean | undefined;\n}\n\n/**\n * Pure function that determines if an order is ready to submit.\n *\n * Checks all gates: cart exists, addresses present, shipping method saved,\n * billing shown, payment complete (for credit card), shipping fee present\n * (for non-free, non-pickup orders), and no sections being edited.\n */\nexport function determineOrderReadiness(params: OrderReadinessParams): boolean {\n if (params.customReadinessCheck) {\n const override = params.customReadinessCheck(params);\n if (override !== undefined) return override;\n }\n\n if (!params.cartHdrUid) return false;\n\n // Block if any section is being edited or addresses are missing\n const blockers = [\n params.isEditShippingInfo,\n params.isEditShippingMethods,\n params.isEditBillingInfo,\n params.editCc,\n params.shippingAddress === undefined,\n params.billingAddress === undefined,\n !params.shippingMethodSaved,\n !params.showBillingInfoSummary,\n params.processingOrder,\n ];\n if (blockers.some(Boolean)) return false;\n\n // Credit card requires completed payment flow\n if (\n params.paymentMethod === \"credit-card\" &&\n (!params.unifiedPaymentAccountId || !params.unifiedBilling)\n ) {\n return false;\n }\n\n // Non-free shipping requires a fee (unless carrier is pickup/freight)\n if (!params.isFreeShipping && params.shippingFee === undefined) {\n return false;\n }\n\n return true;\n}\n\n/**\n * Debounced order readiness hook.\n *\n * Recomputes readiness 300ms after any dependency changes to avoid\n * excessive re-renders during rapid state transitions (e.g., typing\n * in address fields).\n */\nexport function useOrderReadiness(params: OrderReadinessParams) {\n const [enableProcessOrderBtn, setEnableProcessOrderBtn] = useState(false);\n const [processingValidation, setProcessingValidation] = useState(false);\n\n useEffect(() => {\n setProcessingValidation(true);\n\n const timeoutId = setTimeout(() => {\n const ready = determineOrderReadiness(params);\n setEnableProcessOrderBtn(ready);\n setProcessingValidation(false);\n }, 300);\n\n return () => clearTimeout(timeoutId);\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [\n params.billingAddress,\n params.shippingAddress,\n params.isEditShippingInfo,\n params.isEditShippingMethods,\n params.isEditBillingInfo,\n params.editCc,\n params.isFreeShipping,\n params.unifiedPaymentAccountId,\n params.unifiedBilling,\n params.paymentMethod,\n params.processingOrder,\n params.carrierId,\n params.shippingFee,\n params.shippingMethodSaved,\n params.showBillingInfoSummary,\n params.cartHdrUid,\n ]);\n\n return { enableProcessOrderBtn, processingValidation };\n}\n"],"mappings":"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","names":["useEffect","useRef","useRef","useEffect","useEffect","useState"]}
package/dist/index.d.cts DELETED
@@ -1,456 +0,0 @@
1
- import { P as PersistenceConfig } from './batch-query-CTlvxSmL.cjs';
2
- export { A as AugurApiClient, a as AugurHooksProvider, B as BatchQueryConfig, G as GetItemCategoryApiOptions, b as PageData, e as executeBatchQuery, u as useAugurApi, c as useAugurApiOptional, d as useAugurAuth, f as useAugurCache, g as useAugurOptions, h as useAugurSite } from './batch-query-CTlvxSmL.cjs';
3
- export { AugurAuthContext, AugurSiteConfig, AugurSiteDefaults, AugurSiteFormatting, CacheConfig, CacheProvider, CacheTierConfig, DeepQueryOptions, EdgeCacheValue, InfiniteScrollPage, ProxyMutationOptions, ProxyQueryOptions } from '@simpleapps-com/augur-core';
4
- import * as zustand from 'zustand';
5
- import * as _simpleapps_com_augur_utils from '@simpleapps-com/augur-utils';
6
- import { TCartLine, TItemsFilters, TStock, TPriceData } from '@simpleapps-com/augur-utils';
7
- export { DerivePriceInput, DerivedPrice, ResolveStockInput, ResolvedStock, TSearchSuggestion as SearchSuggestion, TSearchSuggestionsResponse as SearchSuggestionsResponse } from '@simpleapps-com/augur-utils';
8
- export { O as OrderReadinessParams, P as PaymentBillingAddress, a as PaymentFlowCallbacks, d as determineOrderReadiness, u as useOrderReadiness, b as usePaymentFlow } from './use-order-readiness-DZTIfRzw.cjs';
9
- import { QueryKey } from '@tanstack/react-query';
10
- import * as _tanstack_react_query_persist_client from '@tanstack/react-query-persist-client';
11
- import 'react/jsx-runtime';
12
- import 'react';
13
- import '@simpleapps-com/augur-api';
14
-
15
- /** Internal state shape for the cart Zustand store. */
16
- interface CartState {
17
- /** P21 cart header UID; `undefined` when no cart exists. */
18
- cartHdrUid: number | string | undefined;
19
- /** Current line items in the cart. */
20
- cartLines: TCartLine[];
21
- /** Sum of `quantity` across all cart lines (auto-computed by `setCartLines`). */
22
- cartQuantityTotal: number;
23
- /** Number of distinct line items (auto-computed by `setCartLines`). */
24
- cartLineCount: number;
25
- setCartHdrUid: (cartHdrUid: number | string | undefined) => void;
26
- /** Replace all cart lines. Auto-recomputes `cartQuantityTotal` and `cartLineCount`. */
27
- setCartLines: (cartLines: TCartLine[]) => void;
28
- /** Reset the cart to its empty initial state. */
29
- clearCart: () => void;
30
- }
31
- /** Zustand store for cart state. Prefer the individual selector hooks below for optimal re-renders. */
32
- declare const useCartStore: zustand.UseBoundStore<Omit<zustand.StoreApi<CartState>, "setState" | "devtools"> & {
33
- setState(partial: CartState | Partial<CartState> | ((state: CartState) => CartState | Partial<CartState>), replace?: false | undefined, action?: (string | {
34
- [x: string]: unknown;
35
- [x: number]: unknown;
36
- [x: symbol]: unknown;
37
- type: string;
38
- }) | undefined): void;
39
- setState(state: CartState | ((state: CartState) => CartState), replace: true, action?: (string | {
40
- [x: string]: unknown;
41
- [x: number]: unknown;
42
- [x: symbol]: unknown;
43
- type: string;
44
- }) | undefined): void;
45
- devtools: {
46
- cleanup: () => void;
47
- };
48
- }>;
49
- /** Select the current cart header UID. */
50
- declare const useCartHdrUid: () => string | number | undefined;
51
- /** Select the current cart line items array. */
52
- declare const useCartLines: () => TCartLine[];
53
- /** Select the total quantity summed across all cart lines. */
54
- declare const useCartQuantityTotal: () => number;
55
- /** Select the number of distinct line items in the cart. */
56
- declare const useCartLineCount: () => number;
57
- /** Get the `setCartHdrUid` action (stable reference). */
58
- declare const useSetCartHdrUid: () => (cartHdrUid: number | string | undefined) => void;
59
- /** Get the `setCartLines` action (stable reference). Also recomputes totals. */
60
- declare const useSetCartLines: () => (cartLines: TCartLine[]) => void;
61
- /** Get the `clearCart` action (stable reference). */
62
- declare const useClearCart: () => () => void;
63
-
64
- /** Zustand state shape for item list filtering, sorting, and pagination. */
65
- interface ItemsFiltersState {
66
- /** Snapshot of the initial defaults; useful for "reset filters" UIs. */
67
- initialFiltersState: TItemsFilters;
68
- /** Current active filter/sort/pagination state. */
69
- itemsFilters: TItemsFilters;
70
- /** Replace the entire filter state. */
71
- setItemsFilters: (itemFilters: TItemsFilters) => void;
72
- }
73
- /** Zustand store for item list filters, sorting, and pagination state. */
74
- declare const useItemFiltersStore: zustand.UseBoundStore<Omit<zustand.StoreApi<ItemsFiltersState>, "setState" | "devtools"> & {
75
- setState(partial: ItemsFiltersState | Partial<ItemsFiltersState> | ((state: ItemsFiltersState) => ItemsFiltersState | Partial<ItemsFiltersState>), replace?: false | undefined, action?: (string | {
76
- [x: string]: unknown;
77
- [x: number]: unknown;
78
- [x: symbol]: unknown;
79
- type: string;
80
- }) | undefined): void;
81
- setState(state: ItemsFiltersState | ((state: ItemsFiltersState) => ItemsFiltersState), replace: true, action?: (string | {
82
- [x: string]: unknown;
83
- [x: number]: unknown;
84
- [x: symbol]: unknown;
85
- type: string;
86
- }) | undefined): void;
87
- devtools: {
88
- cleanup: () => void;
89
- };
90
- }>;
91
-
92
- /**
93
- * Debounces a rapidly-changing value.
94
- * Returns the latest value only after `delay` ms of inactivity.
95
- */
96
- declare function useDebounce<T>(value: T, delay?: number): T;
97
-
98
- /** Options for configuring the useFormatPrice hook. */
99
- interface UseFormatPriceOptions {
100
- /** BCP 47 locale tag. Overrides site.formatting.locale. */
101
- locale?: string;
102
- /** ISO 4217 currency code. Overrides site.formatting.currency. */
103
- currency?: string;
104
- /** Decimal digits. Overrides site.formatting.precision. */
105
- precision?: number;
106
- /** Label returned when the effective value is 0 (e.g. "Call for Price"). */
107
- zeroLabel?: string;
108
- }
109
- /** Per-call options passed to the returned formatPrice function. */
110
- interface FormatPriceCallOptions {
111
- /** Override decimal digits for this call only. */
112
- precision?: number;
113
- /** Multiply the value by this quantity before formatting. */
114
- quantity?: number;
115
- }
116
- /**
117
- * Hook that returns a price formatter.
118
- * Reads defaults from site config when params are omitted.
119
- *
120
- * Supports both the new options-object signature and the legacy positional
121
- * `(locale?, currency?)` signature for backwards compatibility.
122
- */
123
- declare function useFormatPrice(optionsOrLocale?: UseFormatPriceOptions | string, legacyCurrency?: string): {
124
- formatPrice: (price: number, callOptions?: FormatPriceCallOptions) => string;
125
- };
126
-
127
- interface UseStockOptions {
128
- enabled?: boolean;
129
- /** Override the default queryFn (e.g. with a custom server action). */
130
- queryFn?: () => Promise<TStock>;
131
- /** Company key to extract stock for a specific company. */
132
- companyKey?: string;
133
- /** Whether to round the quantity. */
134
- round?: boolean;
135
- /** Threshold below which stock is considered "low". */
136
- lowStockThreshold?: number;
137
- /** Whether to include the quantity in the resolved output. */
138
- showQuantity?: boolean;
139
- }
140
- /**
141
- * Fetches full TStock data and resolves it into a normalized stock object.
142
- *
143
- * Uses the proxy from AugurHooksProvider context. Works with:
144
- * - Direct SDK (api prop on provider)
145
- * - Server actions (auto-detected via queryAction registration)
146
- * - Custom queryFn override
147
- */
148
- declare function useStock(invMastUid: number | string, options?: UseStockOptions): {
149
- stock: TStock | null;
150
- resolved: _simpleapps_com_augur_utils.ResolvedStock | null;
151
- loading: false;
152
- error: Error | null;
153
- };
154
-
155
- type CartLineInput = Pick<TCartLine, "invMastUid" | "quantity" | "unitOfMeasure"> & {
156
- cartHdrUid?: number | string | undefined;
157
- };
158
- /** Site-specific callbacks injected into useCartActions. */
159
- interface CartActionCallbacks {
160
- /** Add items to cart via API. Truthy = success, falsy = failure. */
161
- addToCart: (cartHdrUid: number, items: Array<{
162
- cartHdrUid: number;
163
- invMastUid: number;
164
- quantity: number;
165
- unitOfMeasure: string;
166
- }>) => Promise<boolean | undefined | void>;
167
- /** Update cart lines via API. Truthy = success, falsy = failure. */
168
- updateCartLines: (cartHdrUid: number, lines: TCartLine[]) => Promise<boolean | undefined | void>;
169
- /** Delete all items from cart via API. Truthy = success, falsy = failure. */
170
- deleteItemsFromCart: (cartHdrUid: number) => Promise<boolean | undefined | void>;
171
- /** Optional toast notification callback. */
172
- toast?: {
173
- info?: (message: string) => void;
174
- error?: (message: string) => void;
175
- success?: (message: string) => void;
176
- };
177
- }
178
- interface CartActionOptions {
179
- showToast?: boolean;
180
- itemId?: string;
181
- onSuccess?: () => void;
182
- onError?: (error: Error) => void;
183
- }
184
- /**
185
- * Optimistic cart actions hook with automatic rollback on failure.
186
- *
187
- * Accepts site-specific server action callbacks so the hook itself
188
- * has no dependency on any particular server action implementation.
189
- *
190
- * @example
191
- * ```tsx
192
- * import { useCartActions } from "@simpleapps-com/augur-hooks";
193
- * import { addToCart, updateCartLines, deleteItemsFromCart } from "@/lib/actions/commerce";
194
- * import { toast } from "react-toastify";
195
- *
196
- * const cart = useCartActions({
197
- * addToCart, updateCartLines, deleteItemsFromCart,
198
- * toast: { info: toast.info, error: toast.error },
199
- * });
200
- *
201
- * await cart.addToCart({ invMastUid: 123, quantity: 1, unitOfMeasure: "EA" });
202
- * ```
203
- */
204
- declare function useCartActions(callbacks: CartActionCallbacks): {
205
- addToCart: (item: CartLineInput, options?: CartActionOptions) => Promise<boolean>;
206
- updateQuantity: (invMastUid: number, newQuantity: number, options?: CartActionOptions) => Promise<boolean>;
207
- removeFromCart: (invMastUid: number, options?: CartActionOptions) => Promise<boolean>;
208
- clearCart: (options?: Omit<CartActionOptions, "itemId">) => Promise<boolean>;
209
- isInCart: (invMastUid: number) => boolean;
210
- getItemQuantity: (invMastUid: number) => number;
211
- cartHdrUid: string | number | undefined;
212
- cartLines: TCartLine[];
213
- invalidateCartCache: () => void;
214
- };
215
-
216
- /**
217
- * Shared modal lifecycle hook -- scroll lock, Escape key, client-side hydration gate.
218
- *
219
- * Locks body scroll when the modal is open and restores it on close.
220
- * Listens for Escape key to trigger onClose. Returns isClient for
221
- * hydration-safe conditional rendering.
222
- */
223
- declare function useModalLifecycle(isOpen: boolean, onClose: () => void): {
224
- isClient: boolean;
225
- };
226
-
227
- /** A single persisted field with its storage key and optional TTL. */
228
- interface CheckoutPersistField<T> {
229
- key: string;
230
- value: T;
231
- set: (value: T) => void;
232
- /** Valibot or custom validator. Return the parsed value or throw to reject. */
233
- validate?: (raw: unknown) => T;
234
- /** TTL in milliseconds. Default: 30 minutes. */
235
- ttl?: number;
236
- }
237
- /**
238
- * Saves a value to sessionStorage with a timestamp for TTL expiration.
239
- *
240
- * Fails silently on storage errors (private browsing, quota exceeded).
241
- */
242
- declare function saveToSession(key: string, value: unknown): void;
243
- /**
244
- * Loads a value from sessionStorage, checking TTL and optionally validating.
245
- *
246
- * Returns null if missing, expired, invalid, or storage is unavailable.
247
- * Cleans up expired entries automatically.
248
- */
249
- declare function loadFromSession<T>(key: string, ttl?: number, validate?: (raw: unknown) => T): T | null;
250
- /** Removes a checkout persistence key from sessionStorage. */
251
- declare function clearFromSession(key: string): void;
252
- /**
253
- * Hook that persists checkout state fields to sessionStorage and restores on mount.
254
- *
255
- * Each field is saved when its value changes and restored once on initial mount.
256
- * Validates restored values against an optional schema to guard against
257
- * corrupted or stale storage. Expired entries (past TTL) are discarded.
258
- */
259
- declare function useCheckoutPersistence(fields: CheckoutPersistField<unknown>[]): void;
260
- /**
261
- * Clears all checkout persistence keys from sessionStorage.
262
- *
263
- * Call after successful order submission to prevent stale data on next checkout.
264
- */
265
- declare function clearCheckoutPersistence(keys: string[]): void;
266
-
267
- /** Session info passed from the consumer's auth system. */
268
- interface CartSessionInfo {
269
- /** Auth status: "loading" | "authenticated" | "unauthenticated" */
270
- status: "loading" | "authenticated" | "unauthenticated";
271
- /** User's ID (e.g., Joomla user ID). Undefined if not authenticated. */
272
- userId?: string | number;
273
- /** Cart header UID from the auth session, if available. */
274
- cartHdrUid?: number | string;
275
- }
276
- /** Site-specific callbacks injected into useCartInitialization. */
277
- interface CartInitCallbacks {
278
- /** Look up or create a cart header. Returns { cartHdrUid, cartToken? }. */
279
- cartHdrLookup: (userId: string | number, cartToken: string) => Promise<{
280
- cartHdrUid: number;
281
- cartToken?: string | null;
282
- } | null | undefined>;
283
- /** Fetch cart line items for a given cart header UID. */
284
- getCartLines: (cartHdrUid: number) => Promise<TCartLine[] | undefined>;
285
- /** Get the current cart token. Defaults to localStorage.getItem("cartToken"). */
286
- getCartToken?: () => string | null;
287
- /** Save cart token. Defaults to localStorage.setItem("cartToken", token). */
288
- saveCartToken?: (token: string) => void;
289
- /** Generate a new unique cart token. Defaults to crypto.randomUUID(). */
290
- generateCartToken?: () => string;
291
- }
292
- /**
293
- * Initialize cart state from session (authenticated) or cookie (guest).
294
- * Call once in the root layout.
295
- *
296
- * @example
297
- * ```tsx
298
- * import { useCartInitialization } from "@simpleapps-com/augur-hooks";
299
- * import { useSession } from "next-auth/react";
300
- * import { cartHdrLookup, getCartLines } from "@/lib/actions/commerce";
301
- *
302
- * function CartInitializer() {
303
- * const { data: session, status } = useSession();
304
- *
305
- * // Minimal setup — token storage defaults to localStorage,
306
- * // token generation defaults to crypto.randomUUID().
307
- * useCartInitialization(
308
- * {
309
- * status,
310
- * userId: session?.user?.id,
311
- * cartHdrUid: session?.user?.cartHdrUid,
312
- * },
313
- * { cartHdrLookup, getCartLines },
314
- * );
315
- *
316
- * return null;
317
- * }
318
- * ```
319
- */
320
- declare function useCartInitialization(session: CartSessionInfo, callbacks: CartInitCallbacks): {
321
- cartHdrUid: string | number | undefined;
322
- isInitializing: boolean;
323
- retryCount: number;
324
- };
325
-
326
- interface CartPriceData {
327
- unitPrice: number;
328
- priceData: Record<string, unknown> | null;
329
- }
330
- interface CartPricingResult {
331
- /** Map of itemId -> price data (with quantity-specific pricing) */
332
- prices: Record<string, CartPriceData>;
333
- /** Get unit price for an item (returns 0 if not found) */
334
- getUnitPrice: (itemId: string) => number;
335
- /** Get total price for an item (unitPrice * quantity) */
336
- getItemTotal: (itemId: string, quantity: number) => number;
337
- /** Cart subtotal (sum of all item totals) */
338
- subtotal: number;
339
- /** True if any price is still loading */
340
- isLoading: boolean;
341
- /** True if all prices loaded successfully */
342
- isSuccess: boolean;
343
- /** True if any price failed to load */
344
- isError: boolean;
345
- }
346
- interface UseCartPricingOptions {
347
- customerId?: string | number;
348
- /** Override per-item price fetching (e.g. with a custom server action). */
349
- queryFn?: (itemId: string, customerId: string | number, quantity: number) => Promise<TPriceData>;
350
- }
351
- /**
352
- * Centralized hook for cart/checkout pricing.
353
- *
354
- * Fetches prices for ALL cart items with their actual quantities
355
- * to support quantity-based price breaks. React Query dedupes
356
- * identical calls across components.
357
- *
358
- * Uses the proxy from AugurHooksProvider context. Works with:
359
- * - Direct SDK (api prop on provider)
360
- * - Server actions (auto-detected via queryAction registration)
361
- * - Custom queryFn override
362
- */
363
- declare function useCartPricing(options?: UseCartPricingOptions): CartPricingResult;
364
-
365
- interface UsePaginationPrefetchOptions {
366
- /** Query key for the paginated data */
367
- queryKey: QueryKey;
368
- /** Function to fetch a page of data */
369
- queryFn: (offset: number) => Promise<unknown>;
370
- /** Number of items per page */
371
- pageSize: number;
372
- /** Custom query key builder. Receives the base key and offset, returns the full key. Default: [...queryKey, offset]. */
373
- queryKeyFn?: (baseKey: QueryKey, offset: number) => QueryKey;
374
- /** Stale time in ms (defaults to 10 minutes) */
375
- staleTime?: number;
376
- /** GC time in ms (defaults to 30 minutes) */
377
- gcTime?: number;
378
- enabled?: boolean;
379
- }
380
- /**
381
- * Prefetch adjacent pages on hover for instant pagination.
382
- * Accepts a generic queryFn so it works with any paginated resource.
383
- */
384
- declare const usePaginationPrefetch: ({ queryKey, queryFn, pageSize, queryKeyFn, staleTime, gcTime, enabled, }: UsePaginationPrefetchOptions) => {
385
- prefetchPage: (page: number) => Promise<void>;
386
- handlePaginationHover: (page: number) => () => void;
387
- };
388
-
389
- /**
390
- * Returns a fully configured `persistOptions` object for use with
391
- * `PersistQueryClientProvider` from `@tanstack/react-query-persist-client`.
392
- *
393
- * Handles:
394
- * - SSR-safe persister creation (no-op on server)
395
- * - Map → Record serialization for localStorage compatibility
396
- * - Selective persistence (only successful queries matching persistableKeys)
397
- * - Per-key-prefix LRU eviction (via `limits`)
398
- * - Throttled writes to localStorage
399
- * - Hydration safety (maxAge: 0 until client mount)
400
- * - Storage monitoring with automatic eviction when over threshold
401
- * - Dev mode auto-buster (invalidates cache on each restart)
402
- *
403
- * @example
404
- * ```tsx
405
- * import { useAugurPersistence } from "@simpleapps-com/augur-hooks";
406
- *
407
- * function Providers({ children }) {
408
- * const [queryClient] = useState(() => new QueryClient({ ... }));
409
- * const persistOptions = useAugurPersistence({
410
- * key: "my-site-cache",
411
- * buster: "1.0.0",
412
- * persistableKeys: ["price", "categories", "invMast"],
413
- * limits: { invMast: 100 },
414
- * });
415
- *
416
- * return (
417
- * <PersistQueryClientProvider client={queryClient} persistOptions={persistOptions}>
418
- * <augur.Provider api={api} auth={auth}>
419
- * {children}
420
- * </augur.Provider>
421
- * </PersistQueryClientProvider>
422
- * );
423
- * }
424
- * ```
425
- */
426
- declare function useAugurPersistence(config: PersistenceConfig): {
427
- persister: _tanstack_react_query_persist_client.Persister;
428
- maxAge: number;
429
- buster: string;
430
- dehydrateOptions: {
431
- shouldDehydrateQuery: (query: {
432
- queryKey: readonly unknown[];
433
- state: {
434
- status: string;
435
- };
436
- }) => boolean;
437
- };
438
- };
439
-
440
- /**
441
- * Lightweight registry for a query action function.
442
- *
443
- * augur-server/hooks.ts registers its queryAction as a side effect when
444
- * imported. augur-hooks consumers (useCartPricing, useStock, the provider)
445
- * read from this registry to route data through server actions automatically.
446
- *
447
- * No circular dependency: augur-server depends on augur-hooks and writes here.
448
- * augur-hooks reads from its own module.
449
- */
450
- type QueryActionFn = (methodPath: string, ...args: unknown[]) => Promise<unknown>;
451
- /** Register a query action function (called by augur-server/hooks.ts on import). */
452
- declare function registerQueryAction(fn: QueryActionFn): void;
453
- /** Returns the registered query action, or null if none registered. */
454
- declare function getRegisteredQueryAction(): QueryActionFn | null;
455
-
456
- export { type CartActionCallbacks, type CartInitCallbacks, type CartPriceData, type CartPricingResult, type CartSessionInfo, type CheckoutPersistField, type FormatPriceCallOptions, PersistenceConfig, type UseFormatPriceOptions, type UseStockOptions, clearCheckoutPersistence, clearFromSession, getRegisteredQueryAction, loadFromSession, registerQueryAction, saveToSession, useAugurPersistence, useCartActions, useCartHdrUid, useCartInitialization, useCartLineCount, useCartLines, useCartPricing, useCartQuantityTotal, useCartStore, useCheckoutPersistence, useClearCart, useDebounce, useFormatPrice, useItemFiltersStore, useModalLifecycle, usePaginationPrefetch, useSetCartHdrUid, useSetCartLines, useStock };
package/dist/server.d.cts DELETED
@@ -1,44 +0,0 @@
1
- import { QueryClient } from '@tanstack/react-query';
2
- import { QueryActionFn, CacheConfig, DeepQueryOptions } from '@simpleapps-com/augur-core';
3
- export { AugurAuthContext, CacheConfig, InfiniteScrollPage } from '@simpleapps-com/augur-core';
4
- import { AugurAPI } from '@simpleapps-com/augur-api';
5
- export { A as AugurApiClient, B as BatchQueryConfig, b as PageData, e as executeBatchQuery } from './batch-query-CTlvxSmL.cjs';
6
- import 'react/jsx-runtime';
7
- import 'react';
8
-
9
- /**
10
- * Returns a per-request singleton QueryClient for React Server Components.
11
- *
12
- * React's `cache()` deduplicates calls within a single server request,
13
- * so layout, page, and header all share the same prefetch cache without
14
- * leaking state between requests.
15
- */
16
- declare const getQueryClient: () => QueryClient;
17
- /**
18
- * Creates server-side query options proxy for prefetching.
19
- *
20
- * Uses the same augur-core proxy as `useAugurOptions()`, so query keys
21
- * are identical on server and client — SSR hydration is automatic.
22
- *
23
- * Accepts either an SDK client instance or a queryAction function.
24
- * When called with no arguments, uses the auto-registered queryAction
25
- * (registered by augur-server/hooks on import).
26
- *
27
- * @example
28
- * ```ts
29
- * // With SDK client (traditional)
30
- * const q = createAugurOptions(site.client, cacheConfig);
31
- *
32
- * // With queryAction (server-only JWT sites)
33
- * import { queryAction } from "@simpleapps-com/augur-server/query-action";
34
- * const q = createAugurOptions(queryAction, cacheConfig);
35
- *
36
- * // With auto-registered queryAction (zero args -- requires augur-server/hooks import)
37
- * const q = createAugurOptions();
38
- *
39
- * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));
40
- * ```
41
- */
42
- declare function createAugurOptions<TApi extends object = AugurAPI>(apiOrQueryAction?: TApi | QueryActionFn, cacheConfig?: CacheConfig): DeepQueryOptions<TApi>;
43
-
44
- export { createAugurOptions, getQueryClient };