@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
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/provider.tsx","../src/stores/items-filters-store.ts","../src/hooks/use-debounce.ts","../src/hooks/use-format-price.ts","../src/hooks/use-stock.ts","../src/hooks/use-cart-actions.ts","../src/hooks/use-modal-lifecycle.ts","../src/hooks/use-cart-initialization.ts","../src/hooks/use-cart-pricing.ts","../src/hooks/use-pagination-prefetch.ts","../src/persistence/use-persistence.ts","../src/persistence/serializer.ts","../src/persistence/apply-limits.ts","../src/persistence/create-persister.ts","../src/persistence/use-storage-monitor.ts"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type {\n AugurAuthContext,\n AugurSiteConfig,\n CacheConfig,\n DeepQueryOptions,\n} from \"@simpleapps-com/augur-core\";\nimport {\n createOptionsProxy,\n createQueryActionProxy,\n createKeysOnlyProxy,\n} from \"@simpleapps-com/augur-core\";\nimport type { OptionsProxyConfig } from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/**\n * Minimal type for the augur-api SDK instance.\n * Consumers provide their concrete AugurAPI instance; we keep the type\n * loose so augur-hooks doesn't need to depend directly on the SDK package.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AugurApiClient = any;\n\ninterface AugurHooksProviderProps {\n /** SDK client instance. When omitted, `useAugurOptions()` returns a keys-only\n * proxy — consumers MUST override queryFn with a server action at each call site. */\n api?: AugurApiClient;\n /** Optional auth context — hooks fall back to these values when not passed directly. */\n auth?: AugurAuthContext;\n /** Optional cache configuration — controls edge and Redis caching per tier. */\n cache?: CacheConfig;\n /** Optional site configuration — hooks read defaults and formatting from this. */\n site?: AugurSiteConfig;\n children: ReactNode;\n}\n\nconst AugurApiContext = createContext<AugurApiClient | null>(null);\nconst AugurAuthReactContext = createContext<AugurAuthContext | undefined>(undefined);\nconst AugurCacheContext = createContext<CacheConfig | undefined>(undefined);\nconst AugurOptionsContext = createContext<unknown>(null);\nconst AugurSiteContext = createContext<AugurSiteConfig | undefined>(undefined);\n\n/**\n * Provides the augur-api SDK instance, proxy options, and auth to all hooks.\n *\n * ```tsx\n * <AugurHooksProvider api={api} auth={authContext} cache={cacheConfig}>\n * <App />\n * </AugurHooksProvider>\n * ```\n *\n * Components use `useAugurOptions()` to get the proxy:\n * ```tsx\n * const q = useAugurOptions();\n * const { data } = useQuery(q.items.invMast.get(42));\n * ```\n */\nexport function AugurHooksProvider({ api, auth, cache, site, children }: AugurHooksProviderProps) {\n const proxyConfig: OptionsProxyConfig | undefined = cache\n ? { cache: { static: cache.static, semiStatic: cache.semiStatic } }\n : undefined;\n\n const options = useMemo(() => {\n if (api) return createOptionsProxy(api, proxyConfig);\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) return createQueryActionProxy(registeredAction, proxyConfig);\n return createKeysOnlyProxy(proxyConfig);\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [api]);\n\n return (\n <AugurApiContext.Provider value={api ?? null}>\n <AugurAuthReactContext.Provider value={auth}>\n <AugurCacheContext.Provider value={cache}>\n <AugurSiteContext.Provider value={site}>\n <AugurOptionsContext.Provider value={options}>{children}</AugurOptionsContext.Provider>\n </AugurSiteContext.Provider>\n </AugurCacheContext.Provider>\n </AugurAuthReactContext.Provider>\n </AugurApiContext.Provider>\n );\n}\n\n/**\n * Returns the deep proxy for creating TanStack Query options.\n *\n * When an `api` prop is provided to the provider, every path returns\n * full query options (queryKey, queryFn, staleTime, gcTime).\n *\n * When no `api` is provided (server-only JWT sites), returns a keys-only\n * proxy — queryKey, staleTime, and gcTime are generated normally, but\n * queryFn throws unless overridden. This lets B2B sites use the proxy\n * for deterministic keys and cache tiers while routing data through\n * server actions.\n *\n * @example\n * ```tsx\n * // With api (direct SDK access):\n * const q = useAugurOptions();\n * const { data } = useQuery(q.items.invMast.get(42));\n *\n * // Without api (server-only JWT):\n * const q = useAugurOptions();\n * const { data } = useQuery({\n * ...q.items.invMast.doc.get(42),\n * queryFn: () => getItemAction(42), // server action\n * });\n * ```\n */\nexport function useAugurOptions<T = DeepQueryOptions<AugurAPI>>(): T {\n const options = useContext(AugurOptionsContext);\n if (!options) {\n throw new Error(\n \"useAugurOptions must be used within an <AugurHooksProvider>. \" +\n \"Wrap your app with <AugurHooksProvider>.\",\n );\n }\n return options as T;\n}\n\n/**\n * Returns the augur-api SDK instance from context, or null if not provided.\n * Used internally by hooks that need the SDK for fallback queries.\n */\nexport function useAugurApiOptional(): AugurApiClient | null {\n return useContext(AugurApiContext);\n}\n\n/**\n * Returns the augur-api SDK instance from context.\n * Throws if called outside of `<AugurHooksProvider>` or when no api is provided.\n */\nexport function useAugurApi(): AugurApiClient {\n const api = useContext(AugurApiContext);\n if (!api) {\n throw new Error(\n \"useAugurApi must be used within an <AugurHooksProvider>. \" +\n \"Wrap your app with <AugurHooksProvider api={apiInstance}>.\",\n );\n }\n return api;\n}\n\n/**\n * Returns the provider-level auth context, if any.\n * Used internally by hooks to fall back to provider auth when\n * auth fields are not passed directly as hook parameters.\n */\nexport function useAugurAuth(): AugurAuthContext | undefined {\n return useContext(AugurAuthReactContext);\n}\n\n/**\n * Returns the provider-level cache configuration, if any.\n * Used internally by hooks to enable edge/Redis caching.\n */\nexport function useAugurCache(): CacheConfig | undefined {\n return useContext(AugurCacheContext);\n}\n\n/**\n * Returns the site configuration from the nearest `AugurHooksProvider`.\n * Returns `undefined` when no `site` prop is provided.\n */\nexport function useAugurSite(): AugurSiteConfig | undefined {\n return useContext(AugurSiteContext);\n}\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport type { TItemsFilters } from \"@simpleapps-com/augur-utils\";\n\n/** Default filter values used when the store is first created or reset. */\nconst DEFAULT_FILTER_STATE: TItemsFilters = {\n filters: [],\n limit: 12,\n offset: 0,\n sortBy: \"asc\",\n q: \"\",\n page: 1,\n};\n\n/** Zustand state shape for item list filtering, sorting, and pagination. */\ninterface ItemsFiltersState {\n /** Snapshot of the initial defaults; useful for \"reset filters\" UIs. */\n initialFiltersState: TItemsFilters;\n /** Current active filter/sort/pagination state. */\n itemsFilters: TItemsFilters;\n /** Replace the entire filter state. */\n setItemsFilters: (itemFilters: TItemsFilters) => void;\n}\n\n/** Zustand store for item list filters, sorting, and pagination state. */\nexport const useItemFiltersStore = create<ItemsFiltersState>()(\n devtools(\n (set) => ({\n initialFiltersState: DEFAULT_FILTER_STATE,\n itemsFilters: DEFAULT_FILTER_STATE,\n setItemsFilters: (state) => set({ itemsFilters: state }, false, \"setItemsFilters\"),\n }),\n {\n name: \"ItemsFiltersStore\",\n enabled: process.env[\"NODE_ENV\"] === \"development\",\n },\n ),\n);\n","import { useEffect, useState } from \"react\";\n\n/**\n * Debounces a rapidly-changing value.\n * Returns the latest value only after `delay` ms of inactivity.\n */\nexport function useDebounce<T>(value: T, delay: number = 500): T {\n const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n useEffect(() => {\n const handler = setTimeout(() => {\n setDebouncedValue(value);\n }, delay);\n\n return () => {\n clearTimeout(handler);\n };\n }, [value, delay]);\n\n return debouncedValue;\n}\n","import type { AugurSiteFormatting } from \"@simpleapps-com/augur-core\";\nimport { useAugurSite } from \"../provider\";\n\n/** Options for configuring the useFormatPrice hook. */\nexport interface UseFormatPriceOptions {\n /** BCP 47 locale tag. Overrides site.formatting.locale. */\n locale?: string;\n /** ISO 4217 currency code. Overrides site.formatting.currency. */\n currency?: string;\n /** Decimal digits. Overrides site.formatting.precision. */\n precision?: number;\n /** Label returned when the effective value is 0 (e.g. \"Call for Price\"). */\n zeroLabel?: string;\n}\n\n/** Per-call options passed to the returned formatPrice function. */\nexport interface FormatPriceCallOptions {\n /** Override decimal digits for this call only. */\n precision?: number;\n /** Multiply the value by this quantity before formatting. */\n quantity?: number;\n}\n\nfunction normaliseOptions(\n optionsOrLocale: UseFormatPriceOptions | string | undefined,\n legacyCurrency: string | undefined,\n): UseFormatPriceOptions {\n if (typeof optionsOrLocale === \"string\") {\n return { locale: optionsOrLocale, currency: legacyCurrency };\n }\n return optionsOrLocale ?? {};\n}\n\nfunction resolveFormatting(\n opts: UseFormatPriceOptions,\n siteFormatting: AugurSiteFormatting | undefined,\n) {\n return {\n locale: opts.locale ?? siteFormatting?.locale ?? \"en-US\",\n currency: opts.currency ?? siteFormatting?.currency ?? \"USD\",\n precision: opts.precision ?? siteFormatting?.precision ?? 2,\n zeroLabel: opts.zeroLabel ?? siteFormatting?.zeroLabel,\n };\n}\n\n/**\n * Hook that returns a price formatter.\n * Reads defaults from site config when params are omitted.\n *\n * Supports both the new options-object signature and the legacy positional\n * `(locale?, currency?)` signature for backwards compatibility.\n */\nexport function useFormatPrice(\n optionsOrLocale?: UseFormatPriceOptions | string,\n legacyCurrency?: string,\n) {\n const site = useAugurSite();\n const opts = normaliseOptions(optionsOrLocale, legacyCurrency);\n const {\n locale,\n currency,\n precision: basePrecision,\n zeroLabel,\n } = resolveFormatting(opts, site?.formatting);\n\n const formatPrice = (price: number, callOptions?: FormatPriceCallOptions): string => {\n const effectiveValue = price * (callOptions?.quantity ?? 1);\n\n if (effectiveValue === 0 && zeroLabel !== undefined) {\n return zeroLabel;\n }\n\n const precision = callOptions?.precision ?? basePrecision;\n\n return new Intl.NumberFormat(locale, {\n style: \"currency\",\n currency,\n minimumFractionDigits: precision,\n maximumFractionDigits: precision,\n }).format(effectiveValue);\n };\n\n return { formatPrice };\n}\n","import { useMemo } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { TStock } from \"@simpleapps-com/augur-utils\";\nimport { resolveStock } from \"@simpleapps-com/augur-utils\";\nimport { useAugurOptions } from \"../provider\";\n\nexport interface UseStockOptions {\n enabled?: boolean;\n /** Override the default queryFn (e.g. with a custom server action). */\n queryFn?: () => Promise<TStock>;\n /** Company key to extract stock for a specific company. */\n companyKey?: string;\n /** Whether to round the quantity. */\n round?: boolean;\n /** Threshold below which stock is considered \"low\". */\n lowStockThreshold?: number;\n /** Whether to include the quantity in the resolved output. */\n showQuantity?: boolean;\n}\n\n/**\n * Fetches full TStock data and resolves it into a normalized stock object.\n *\n * Uses the proxy from AugurHooksProvider context. Works with:\n * - Direct SDK (api prop on provider)\n * - Server actions (auto-detected via queryAction registration)\n * - Custom queryFn override\n */\nexport function useStock(invMastUid: number | string, options: UseStockOptions = {}) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const proxy = useAugurOptions<any>();\n\n const resolvedQueryFn = options.queryFn;\n\n // Use the proxy for query options (works with SDK, server actions, or keys-only)\n const proxyOpts = proxy.items.invMast.stock.get(Number(invMastUid));\n\n const query = useQuery({\n ...proxyOpts,\n ...(resolvedQueryFn ? { queryFn: resolvedQueryFn } : {}),\n enabled: (options.enabled ?? true) && !!invMastUid,\n retry: 3,\n /* v8 ignore start */\n retryDelay: (attemptIndex: number) => Math.min(1000 * 2 ** attemptIndex, 10000),\n /* v8 ignore stop */\n });\n\n const stockData = useMemo(() => {\n const rawData = query.data;\n if (!rawData) return null;\n // Proxy returns the full BaseResponse — extract .data if present\n const inner = (rawData as { data?: unknown }).data ?? rawData;\n const stock = inner as { stockData?: unknown[]; companySummary?: Record<string, number> };\n return {\n stockData: stock.stockData ?? [],\n companySummary: stock.companySummary ?? {},\n } as TStock;\n }, [query.data]);\n\n const resolved = useMemo(\n () =>\n resolveStock({\n stock: stockData,\n companyKey: options.companyKey,\n round: options.round,\n lowStockThreshold: options.lowStockThreshold,\n showQuantity: options.showQuantity,\n }),\n [stockData, options.companyKey, options.round, options.lowStockThreshold, options.showQuantity],\n );\n\n return {\n stock: stockData,\n resolved,\n loading: query.isLoading,\n error: query.error as Error | null,\n };\n}\n","import { useCallback } from \"react\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\nimport { useCartHdrUid, useCartLines, useSetCartLines } from \"../stores/cart-store\";\n\ntype CartLineInput = Pick<TCartLine, \"invMastUid\" | \"quantity\" | \"unitOfMeasure\"> & {\n cartHdrUid?: number | string | undefined;\n};\n\n/** Site-specific callbacks injected into useCartActions. */\nexport interface CartActionCallbacks {\n /** Add items to cart via API. Truthy = success, falsy = failure. */\n addToCart: (\n cartHdrUid: number,\n items: Array<{\n cartHdrUid: number;\n invMastUid: number;\n quantity: number;\n unitOfMeasure: string;\n }>,\n ) => Promise<boolean | undefined | void>;\n /** Update cart lines via API. Truthy = success, falsy = failure. */\n updateCartLines: (cartHdrUid: number, lines: TCartLine[]) => Promise<boolean | undefined | void>;\n /** Delete all items from cart via API. Truthy = success, falsy = failure. */\n deleteItemsFromCart: (cartHdrUid: number) => Promise<boolean | undefined | void>;\n /** Optional toast notification callback. */\n toast?: {\n info?: (message: string) => void;\n error?: (message: string) => void;\n success?: (message: string) => void;\n };\n}\n\ninterface CartActionOptions {\n showToast?: boolean;\n itemId?: string;\n onSuccess?: () => void;\n onError?: (error: Error) => void;\n}\n\nfunction requireCartUid(cartHdrUid: string | number | undefined): number {\n const num = typeof cartHdrUid === \"string\" ? Number(cartHdrUid) : cartHdrUid;\n if (!num) throw new Error(\"Cart UID is not set\");\n return num;\n}\n\nfunction buildOptimisticAdd(\n cartLines: TCartLine[],\n item: CartLineInput,\n cartHdrUid: number,\n itemId: string,\n): TCartLine[] {\n const existingIndex = cartLines.findIndex((line) => line.invMastUid === item.invMastUid);\n\n if (existingIndex >= 0) {\n return cartLines.map((line, index) =>\n index === existingIndex ? { ...line, quantity: line.quantity + item.quantity } : line,\n );\n }\n\n return [\n ...cartLines,\n {\n cartHdrUid,\n invMastUid: item.invMastUid,\n invMastUidCount: 1,\n isAssembly: \"N\",\n itemId,\n lineNo: cartLines.length + 1,\n lineNote: null,\n quantity: item.quantity,\n unitOfMeasure: item.unitOfMeasure,\n },\n ];\n}\n\n/**\n * Optimistic cart actions hook with automatic rollback on failure.\n *\n * Accepts site-specific server action callbacks so the hook itself\n * has no dependency on any particular server action implementation.\n *\n * @example\n * ```tsx\n * import { useCartActions } from \"@simpleapps-com/augur-hooks\";\n * import { addToCart, updateCartLines, deleteItemsFromCart } from \"@/lib/actions/commerce\";\n * import { toast } from \"react-toastify\";\n *\n * const cart = useCartActions({\n * addToCart, updateCartLines, deleteItemsFromCart,\n * toast: { info: toast.info, error: toast.error },\n * });\n *\n * await cart.addToCart({ invMastUid: 123, quantity: 1, unitOfMeasure: \"EA\" });\n * ```\n */\nexport function useCartActions(callbacks: CartActionCallbacks) {\n const queryClient = useQueryClient();\n const cartHdrUid = useCartHdrUid();\n const cartLines = useCartLines();\n const setCartLines = useSetCartLines();\n const notify = callbacks.toast;\n\n const invalidateCartCache = useCallback(() => {\n void queryClient.invalidateQueries({ queryKey: [\"cartLines\", cartHdrUid] });\n void queryClient.invalidateQueries({\n queryKey: [\"cart-also-bought\", cartHdrUid],\n });\n }, [queryClient, cartHdrUid]);\n\n const addToCart = useCallback(\n async (item: CartLineInput, options: CartActionOptions = {}): Promise<boolean> => {\n const { showToast = true, itemId = \"\", onSuccess, onError } = options;\n const uid = requireCartUid(cartHdrUid);\n const previousCartLines = [...cartLines];\n\n setCartLines(buildOptimisticAdd(cartLines, item, uid, itemId));\n\n try {\n const success = await callbacks.addToCart(uid, [\n {\n cartHdrUid: uid,\n invMastUid: item.invMastUid,\n quantity: item.quantity,\n unitOfMeasure: item.unitOfMeasure,\n },\n ]);\n if (!success) throw new Error(\"Failed to add item to cart\");\n\n invalidateCartCache();\n if (showToast && notify?.info) {\n notify.info(`${item.quantity} x ${itemId || \"Item\"} added to cart`);\n }\n onSuccess?.();\n return true;\n } catch (error) {\n setCartLines(previousCartLines);\n if (showToast && notify?.error) {\n notify.error(\"Failed to add item to cart. Please try again.\");\n }\n onError?.(error as Error);\n return false;\n }\n },\n [cartHdrUid, cartLines, setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const updateQuantity = useCallback(\n async (\n invMastUid: number,\n newQuantity: number,\n options: CartActionOptions = {},\n ): Promise<boolean> => {\n const { showToast = false, onSuccess, onError } = options;\n const uid = requireCartUid(cartHdrUid);\n const previousCartLines = [...cartLines];\n\n const updatedLines = cartLines.map((line) =>\n line.invMastUid === invMastUid ? { ...line, quantity: newQuantity } : line,\n );\n setCartLines(updatedLines);\n\n try {\n const success = await callbacks.updateCartLines(uid, updatedLines);\n if (!success) throw new Error(\"Failed to update quantity\");\n\n invalidateCartCache();\n onSuccess?.();\n return true;\n } catch (error) {\n setCartLines(previousCartLines);\n if (showToast && notify?.error) {\n notify.error(\"Failed to update quantity. Please try again.\");\n }\n onError?.(error as Error);\n return false;\n }\n },\n [cartHdrUid, cartLines, setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const removeFromCart = useCallback(\n async (invMastUid: number, options: CartActionOptions = {}): Promise<boolean> => {\n const { showToast = true, itemId = \"\", onSuccess, onError } = options;\n const uid = requireCartUid(cartHdrUid);\n const previousCartLines = [...cartLines];\n\n setCartLines(cartLines.filter((line) => line.invMastUid !== invMastUid));\n\n try {\n const zeroedLines = cartLines.map((line) =>\n line.invMastUid === invMastUid ? { ...line, quantity: 0 } : line,\n );\n const success = await callbacks.updateCartLines(uid, zeroedLines);\n if (!success) throw new Error(\"Failed to remove item\");\n\n invalidateCartCache();\n if (showToast && notify?.info) {\n notify.info(`${itemId || \"Item\"} removed from cart`);\n }\n onSuccess?.();\n return true;\n } catch (error) {\n setCartLines(previousCartLines);\n if (showToast && notify?.error) {\n notify.error(\"Failed to remove item. Please try again.\");\n }\n onError?.(error as Error);\n return false;\n }\n },\n [cartHdrUid, cartLines, setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const clearCart = useCallback(\n async (options: Omit<CartActionOptions, \"itemId\"> = {}): Promise<boolean> => {\n const { showToast = true, onSuccess, onError } = options;\n const uid = requireCartUid(cartHdrUid);\n const previousCartLines = [...cartLines];\n setCartLines([]);\n\n try {\n const success = await callbacks.deleteItemsFromCart(uid);\n if (!success) throw new Error(\"Failed to clear cart\");\n\n invalidateCartCache();\n if (showToast && notify?.info) {\n notify.info(\"Cart cleared\");\n }\n onSuccess?.();\n return true;\n } catch (error) {\n setCartLines(previousCartLines);\n if (showToast && notify?.error) {\n notify.error(\"Failed to clear cart. Please try again.\");\n }\n onError?.(error as Error);\n return false;\n }\n },\n [cartHdrUid, cartLines, setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const isInCart = useCallback(\n (invMastUid: number): boolean => {\n return cartLines.some((line) => line.invMastUid === invMastUid);\n },\n [cartLines],\n );\n\n const getItemQuantity = useCallback(\n (invMastUid: number): number => {\n return cartLines.find((line) => line.invMastUid === invMastUid)?.quantity ?? 0;\n },\n [cartLines],\n );\n\n return {\n addToCart,\n updateQuantity,\n removeFromCart,\n clearCart,\n isInCart,\n getItemQuantity,\n cartHdrUid,\n cartLines,\n invalidateCartCache,\n };\n}\n","\"use client\";\nimport { useEffect, useState } from \"react\";\n\n/**\n * Shared modal lifecycle hook -- scroll lock, Escape key, client-side hydration gate.\n *\n * Locks body scroll when the modal is open and restores it on close.\n * Listens for Escape key to trigger onClose. Returns isClient for\n * hydration-safe conditional rendering.\n */\nexport function useModalLifecycle(isOpen: boolean, onClose: () => void) {\n const [isClient, setIsClient] = useState(false);\n\n useEffect(() => {\n setIsClient(true);\n }, []);\n\n // Scroll lock\n useEffect(() => {\n document.body.style.overflow = isOpen ? \"hidden\" : \"auto\";\n return () => {\n document.body.style.overflow = \"auto\";\n };\n }, [isOpen]);\n\n // Escape key\n useEffect(() => {\n const handleEscape = (e: KeyboardEvent) => {\n if (e.key === \"Escape\" && isOpen) onClose();\n };\n document.addEventListener(\"keydown\", handleEscape);\n return () => document.removeEventListener(\"keydown\", handleEscape);\n }, [isOpen, onClose]);\n\n return { isClient };\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\nimport {\n useCartHdrUid,\n useSetCartHdrUid,\n useSetCartLines,\n useClearCart,\n} from \"../stores/cart-store\";\nimport { useAugurAuth } from \"../provider\";\n\nconst MAX_RETRY_ATTEMPTS = 7;\nconst RETRY_DELAY_MS = 1000;\n\n/** Session info passed from the consumer's auth system. */\nexport interface CartSessionInfo {\n /** Auth status: \"loading\" | \"authenticated\" | \"unauthenticated\" */\n status: \"loading\" | \"authenticated\" | \"unauthenticated\";\n /** User's ID (e.g., Joomla user ID). Undefined if not authenticated. */\n userId?: string | number;\n /** Cart header UID from the auth session, if available. */\n cartHdrUid?: number | string;\n}\n\n/** Site-specific callbacks injected into useCartInitialization. */\nexport interface CartInitCallbacks {\n /** Look up or create a cart header. Returns { cartHdrUid, cartToken? }. */\n cartHdrLookup: (\n userId: string | number,\n cartToken: string,\n ) => Promise<{ cartHdrUid: number; cartToken?: string | null } | null | undefined>;\n /** Fetch cart line items for a given cart header UID. */\n getCartLines: (cartHdrUid: number) => Promise<TCartLine[] | undefined>;\n /** Get the current cart token. Defaults to localStorage.getItem(\"cartToken\"). */\n getCartToken?: () => string | null;\n /** Save cart token. Defaults to localStorage.setItem(\"cartToken\", token). */\n saveCartToken?: (token: string) => void;\n /** Generate a new unique cart token. Defaults to crypto.randomUUID(). */\n generateCartToken?: () => string;\n}\n\nconst defaultGetCartToken = () => localStorage.getItem(\"cartToken\");\nconst defaultSaveCartToken = (token: string) => localStorage.setItem(\"cartToken\", token);\nconst defaultGenerateCartToken = () => crypto.randomUUID();\n\n/**\n * Initialize cart state from session (authenticated) or cookie (guest).\n * Call once in the root layout.\n *\n * @example\n * ```tsx\n * import { useCartInitialization } from \"@simpleapps-com/augur-hooks\";\n * import { useSession } from \"next-auth/react\";\n * import { cartHdrLookup, getCartLines } from \"@/lib/actions/commerce\";\n *\n * function CartInitializer() {\n * const { data: session, status } = useSession();\n *\n * // Minimal setup — token storage defaults to localStorage,\n * // token generation defaults to crypto.randomUUID().\n * useCartInitialization(\n * {\n * status,\n * userId: session?.user?.id,\n * cartHdrUid: session?.user?.cartHdrUid,\n * },\n * { cartHdrLookup, getCartLines },\n * );\n *\n * return null;\n * }\n * ```\n */\nexport function useCartInitialization(session: CartSessionInfo, callbacks: CartInitCallbacks) {\n const getCartToken = callbacks.getCartToken ?? defaultGetCartToken;\n const saveCartToken = callbacks.saveCartToken ?? defaultSaveCartToken;\n const generateCartToken = callbacks.generateCartToken ?? defaultGenerateCartToken;\n\n const auth = useAugurAuth();\n const cartHdrUid = useCartHdrUid();\n const setCartHdrUid = useSetCartHdrUid();\n const setCartLines = useSetCartLines();\n const clearCart = useClearCart();\n const queryClient = useQueryClient();\n\n // Merge session with provider auth — session fields take priority\n const effectiveStatus = session.status;\n const effectiveUserId = session.userId ?? auth?.userId;\n const effectiveCartHdrUid = session.cartHdrUid ?? auth?.cartHdrUid;\n const effectiveSession = useMemo<CartSessionInfo>(\n () => ({ status: effectiveStatus, userId: effectiveUserId, cartHdrUid: effectiveCartHdrUid }),\n [effectiveStatus, effectiveUserId, effectiveCartHdrUid],\n );\n\n const retryCountRef = useRef(0);\n const isInitializingRef = useRef(false);\n const prevStatusRef = useRef(effectiveSession.status);\n\n // Auto-clear cart on logout (authenticated → unauthenticated)\n useEffect(() => {\n const prevStatus = prevStatusRef.current;\n prevStatusRef.current = effectiveSession.status;\n\n if (prevStatus === \"authenticated\" && effectiveSession.status === \"unauthenticated\") {\n clearCart();\n queryClient.removeQueries({ queryKey: [\"cartLines\"] });\n queryClient.removeQueries({ queryKey: [\"cart-also-bought\"] });\n }\n }, [effectiveSession.status, clearCart, queryClient]);\n\n // Initialize cart header\n useEffect(() => {\n if (cartHdrUid || effectiveSession.status === \"loading\") return;\n\n // Authenticated user — use session cartHdrUid\n if (effectiveSession.cartHdrUid && effectiveSession.status === \"authenticated\") {\n setCartHdrUid(effectiveSession.cartHdrUid);\n return;\n }\n\n // Guest user — lookup/create cart\n if (effectiveSession.status === \"unauthenticated\" && !isInitializingRef.current) {\n isInitializingRef.current = true;\n retryCountRef.current = 0;\n\n const initializeGuestCart = async () => {\n const existingToken = getCartToken();\n const cartToken =\n existingToken && typeof existingToken === \"string\" ? existingToken : generateCartToken();\n\n while (retryCountRef.current < MAX_RETRY_ATTEMPTS) {\n try {\n const cartHdr = await callbacks.cartHdrLookup(\"0\", cartToken);\n\n if (cartHdr && cartHdr.cartHdrUid !== 0) {\n saveCartToken(cartToken);\n setCartHdrUid(cartHdr.cartHdrUid);\n isInitializingRef.current = false;\n return;\n }\n\n retryCountRef.current++;\n\n if (retryCountRef.current < MAX_RETRY_ATTEMPTS) {\n const delay = Math.min(RETRY_DELAY_MS * Math.pow(1.5, retryCountRef.current), 10000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n } catch (error) {\n console.error(\n `Cart initialization attempt ${retryCountRef.current + 1} failed:`,\n error,\n );\n retryCountRef.current++;\n\n if (retryCountRef.current < MAX_RETRY_ATTEMPTS) {\n const delay = Math.min(RETRY_DELAY_MS * Math.pow(1.5, retryCountRef.current), 10000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n }\n }\n }\n\n console.error(`Cart initialization failed after ${MAX_RETRY_ATTEMPTS} attempts`);\n isInitializingRef.current = false;\n };\n\n void initializeGuestCart();\n }\n }, [\n effectiveSession,\n cartHdrUid,\n setCartHdrUid,\n callbacks,\n getCartToken,\n saveCartToken,\n generateCartToken,\n ]);\n\n // Fetch cart lines when cartHdrUid is available\n const { data: cartLinesData } = useQuery({\n queryKey: [\"cartLines\", cartHdrUid],\n queryFn: async () => (await callbacks.getCartLines(Number(cartHdrUid))) ?? [],\n enabled: !!cartHdrUid,\n });\n\n // Sync cart lines to Zustand store\n useEffect(() => {\n if (cartLinesData) {\n setCartLines(cartLinesData);\n }\n }, [cartLinesData, setCartLines]);\n\n return {\n cartHdrUid,\n isInitializing: isInitializingRef.current,\n retryCount: retryCountRef.current,\n };\n}\n","import { useMemo } from \"react\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport type { TPriceData } from \"@simpleapps-com/augur-utils\";\nimport { derivePrice } from \"@simpleapps-com/augur-utils\";\nimport { useCartLines } from \"../stores/cart-store\";\nimport { useAugurOptions, useAugurAuth, useAugurSite } from \"../provider\";\n\nexport interface CartPriceData {\n unitPrice: number;\n priceData: Record<string, unknown> | null;\n}\n\nexport interface CartPricingResult {\n /** Map of itemId -> price data (with quantity-specific pricing) */\n prices: Record<string, CartPriceData>;\n /** Get unit price for an item (returns 0 if not found) */\n getUnitPrice: (itemId: string) => number;\n /** Get total price for an item (unitPrice * quantity) */\n getItemTotal: (itemId: string, quantity: number) => number;\n /** Cart subtotal (sum of all item totals) */\n subtotal: number;\n /** True if any price is still loading */\n isLoading: boolean;\n /** True if all prices loaded successfully */\n isSuccess: boolean;\n /** True if any price failed to load */\n isError: boolean;\n}\n\ninterface UseCartPricingOptions {\n customerId?: string | number;\n /** Override per-item price fetching (e.g. with a custom server action). */\n queryFn?: (itemId: string, customerId: string | number, quantity: number) => Promise<TPriceData>;\n}\n\n/**\n * Centralized hook for cart/checkout pricing.\n *\n * Fetches prices for ALL cart items with their actual quantities\n * to support quantity-based price breaks. React Query dedupes\n * identical calls across components.\n *\n * Uses the proxy from AugurHooksProvider context. Works with:\n * - Direct SDK (api prop on provider)\n * - Server actions (auto-detected via queryAction registration)\n * - Custom queryFn override\n */\nexport function useCartPricing(options: UseCartPricingOptions = {}): CartPricingResult {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const proxy = useAugurOptions<any>();\n const auth = useAugurAuth();\n const site = useAugurSite();\n const cartLines = useCartLines();\n const customerId = options.customerId ?? auth?.customerId ?? site?.defaults?.customerId;\n\n const priceFn = options.queryFn;\n\n const priceQueries = useQueries({\n queries: cartLines.map((line) => {\n if (priceFn) {\n return {\n queryKey: [\"price\", line.itemId?.toUpperCase() || \"\", customerId, line.quantity],\n queryFn: () => priceFn(line.itemId, customerId!, line.quantity),\n refetchOnReconnect: true,\n refetchOnWindowFocus: false,\n meta: { persist: true },\n enabled: !!customerId && !!line.itemId,\n };\n }\n\n // Use the proxy — works with SDK, server actions, or keys-only\n const proxyOpts = proxy.pricing.priceEngine.list({\n itemId: line.itemId?.toUpperCase() || \"\",\n customerId: Number(customerId),\n quantity: line.quantity,\n });\n\n return {\n ...proxyOpts,\n enabled: !!customerId && !!line.itemId,\n refetchOnReconnect: true,\n refetchOnWindowFocus: false,\n meta: { persist: true },\n };\n }),\n });\n\n const prices = useMemo(() => {\n const map: Record<string, CartPriceData> = {};\n cartLines.forEach((line, index) => {\n const queryResult = priceQueries[index];\n const rawData = queryResult?.data;\n if (rawData) {\n // Direct SDK (via provider) returns BaseResponse; queryAction auto-unwraps.\n // Handle both shapes so the hook works in either mode.\n const priceData = (rawData as { data?: unknown }).data ?? rawData;\n const derived = derivePrice({\n priceData: priceData as TPriceData,\n quantity: line.quantity,\n })!;\n map[line.itemId.toUpperCase()] = {\n unitPrice: derived.unitPrice,\n priceData: priceData as Record<string, unknown>,\n };\n }\n });\n return map;\n }, [cartLines, priceQueries]);\n\n const getUnitPrice = useMemo(() => {\n return (itemId: string): number => {\n return prices[itemId?.toUpperCase()]?.unitPrice ?? 0;\n };\n }, [prices]);\n\n const getItemTotal = useMemo(() => {\n return (itemId: string, quantity: number): number => {\n return getUnitPrice(itemId) * quantity;\n };\n }, [getUnitPrice]);\n\n const subtotal = useMemo(() => {\n return cartLines.reduce((sum, line) => {\n const unitPrice = prices[line.itemId.toUpperCase()]?.unitPrice ?? 0;\n return sum + unitPrice * line.quantity;\n }, 0);\n }, [cartLines, prices]);\n\n const isLoading = priceQueries.some((q) => q.isLoading);\n const isSuccess = priceQueries.every((q) => q.isSuccess);\n const isError = priceQueries.some((q) => q.isError);\n\n return {\n prices,\n getUnitPrice,\n getItemTotal,\n subtotal,\n isLoading,\n isSuccess,\n isError,\n };\n}\n","import { useQueryClient } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport type { QueryKey } from \"@tanstack/react-query\";\n\ninterface UsePaginationPrefetchOptions {\n /** Query key for the paginated data */\n queryKey: QueryKey;\n /** Function to fetch a page of data */\n queryFn: (offset: number) => Promise<unknown>;\n /** Number of items per page */\n pageSize: number;\n /** Custom query key builder. Receives the base key and offset, returns the full key. Default: [...queryKey, offset]. */\n queryKeyFn?: (baseKey: QueryKey, offset: number) => QueryKey;\n /** Stale time in ms (defaults to 10 minutes) */\n staleTime?: number;\n /** GC time in ms (defaults to 30 minutes) */\n gcTime?: number;\n enabled?: boolean;\n}\n\n/**\n * Prefetch adjacent pages on hover for instant pagination.\n * Accepts a generic queryFn so it works with any paginated resource.\n */\nexport const usePaginationPrefetch = ({\n queryKey,\n queryFn,\n pageSize,\n queryKeyFn,\n staleTime = 10 * 60 * 1000,\n gcTime = 30 * 60 * 1000,\n enabled = true,\n}: UsePaginationPrefetchOptions) => {\n const queryClient = useQueryClient();\n\n const prefetchPage = useCallback(\n async (page: number) => {\n if (!enabled) return;\n\n const offset = (page - 1) * pageSize;\n\n try {\n await queryClient.prefetchQuery({\n queryKey: queryKeyFn ? queryKeyFn(queryKey, offset) : [...queryKey, offset],\n queryFn: () => queryFn(offset),\n staleTime,\n gcTime,\n });\n } catch (error) {\n console.warn(`Error prefetching page ${page}:`, error);\n }\n },\n [queryKey, queryFn, pageSize, queryKeyFn, staleTime, gcTime, queryClient, enabled],\n );\n\n const handlePaginationHover = useCallback(\n (page: number) => {\n const timeoutId = setTimeout(() => prefetchPage(page), 150);\n return () => clearTimeout(timeoutId);\n },\n [prefetchPage],\n );\n\n return {\n prefetchPage,\n handlePaginationHover,\n };\n};\n","import { useState, useEffect, useMemo } from \"react\";\nimport type { PersistenceConfig } from \"../types\";\nimport { createPersister } from \"./create-persister\";\nimport { useStorageMonitor } from \"./use-storage-monitor\";\n\n/**\n * Returns a fully configured `persistOptions` object for use with\n * `PersistQueryClientProvider` from `@tanstack/react-query-persist-client`.\n *\n * Handles:\n * - SSR-safe persister creation (no-op on server)\n * - Map → Record serialization for localStorage compatibility\n * - Selective persistence (only successful queries matching persistableKeys)\n * - Per-key-prefix LRU eviction (via `limits`)\n * - Throttled writes to localStorage\n * - Hydration safety (maxAge: 0 until client mount)\n * - Storage monitoring with automatic eviction when over threshold\n * - Dev mode auto-buster (invalidates cache on each restart)\n *\n * @example\n * ```tsx\n * import { useAugurPersistence } from \"@simpleapps-com/augur-hooks\";\n *\n * function Providers({ children }) {\n * const [queryClient] = useState(() => new QueryClient({ ... }));\n * const persistOptions = useAugurPersistence({\n * key: \"my-site-cache\",\n * buster: \"1.0.0\",\n * persistableKeys: [\"price\", \"categories\", \"invMast\"],\n * limits: { invMast: 100 },\n * });\n *\n * return (\n * <PersistQueryClientProvider client={queryClient} persistOptions={persistOptions}>\n * <augur.Provider api={api} auth={auth}>\n * {children}\n * </augur.Provider>\n * </PersistQueryClientProvider>\n * );\n * }\n * ```\n */\nexport function useAugurPersistence(config: PersistenceConfig) {\n const [persister] = useState(() => createPersister(config));\n const [isMounted, setIsMounted] = useState(false);\n\n useEffect(() => {\n setIsMounted(true);\n }, []);\n\n useStorageMonitor(config);\n\n const isDev = typeof process !== \"undefined\" && process.env?.[\"NODE_ENV\"] === \"development\";\n\n const { persistableKeys } = config;\n\n const dehydrateOptions = useMemo(\n () => ({\n shouldDehydrateQuery: (query: {\n queryKey: readonly unknown[];\n state: { status: string };\n }) => {\n const key = query.queryKey;\n if (!Array.isArray(key) || key.length === 0) return false;\n if (query.state.status !== \"success\") return false;\n return persistableKeys.includes(key[0] as string);\n },\n }),\n [persistableKeys],\n );\n\n return {\n persister,\n maxAge: isMounted ? (config.maxAge ?? 24 * 60 * 60 * 1000) : 0,\n buster: isDev ? String(Date.now()) : (config.buster ?? \"\"),\n dehydrateOptions,\n };\n}\n","import type { PersistedClient } from \"@tanstack/react-query-persist-client\";\n\n/**\n * Serializes a PersistedClient to a JSON string.\n * Converts Map instances to plain objects for localStorage compatibility.\n */\nexport function serialize(data: PersistedClient): string {\n return JSON.stringify(data, (_key, value) => {\n if (value instanceof Map) return Object.fromEntries(value);\n return value;\n });\n}\n\n/**\n * Deserializes a JSON string back to a PersistedClient.\n */\nexport function deserialize(data: string): PersistedClient {\n return JSON.parse(data) as PersistedClient;\n}\n","import type { PersistedClient } from \"@tanstack/react-query-persist-client\";\n\ninterface QueryEntry {\n queryKey: readonly unknown[];\n queryHash: string;\n state: { dataUpdatedAt?: number };\n}\n\n/**\n * Applies per-key-prefix LRU limits to the queries in a PersistedClient.\n * For each prefix in `limits`, keeps only the N most-recently-updated queries.\n * Returns a shallow copy with trimmed queries; does not mutate the input.\n */\nexport function applyLimits(\n data: PersistedClient,\n limits: Record<string, number>,\n): PersistedClient {\n const queries = data.clientState?.queries;\n if (!queries || Object.keys(limits).length === 0) return data;\n\n const entries = queries as unknown as QueryEntry[];\n const unlimited: QueryEntry[] = [];\n const groups = new Map<string, QueryEntry[]>();\n\n for (const q of entries) {\n const prefix = Array.isArray(q.queryKey) ? q.queryKey[0] : undefined;\n if (typeof prefix === \"string\" && prefix in limits) {\n const group = groups.get(prefix) ?? [];\n group.push(q);\n groups.set(prefix, group);\n } else {\n unlimited.push(q);\n }\n }\n\n const kept: QueryEntry[] = [];\n for (const [prefix, group] of groups) {\n const limit = limits[prefix]!;\n const sorted = [...group].sort(\n (a, b) => (b.state.dataUpdatedAt ?? 0) - (a.state.dataUpdatedAt ?? 0),\n );\n kept.push(...sorted.slice(0, limit));\n }\n\n return {\n ...data,\n clientState: {\n ...data.clientState,\n queries: [...unlimited, ...kept] as unknown as typeof queries,\n },\n };\n}\n","import type { Persister, PersistedClient } from \"@tanstack/react-query-persist-client\";\nimport type { PersistenceConfig } from \"../types\";\nimport { serialize, deserialize } from \"./serializer\";\nimport { applyLimits } from \"./apply-limits\";\n\n/** No-op persister for SSR environments where localStorage is unavailable. */\nconst noopPersister: Persister = {\n persistClient: async () => {},\n restoreClient: async () => undefined,\n removeClient: async () => {},\n};\n\n/**\n * Creates an SSR-safe localStorage persister with throttled writes and LRU limiting.\n *\n * On the server (typeof window === \"undefined\"), returns a no-op persister.\n * On the client, writes are throttled to avoid performance degradation.\n */\nexport function createPersister(config: PersistenceConfig): Persister {\n if (typeof window === \"undefined\") return noopPersister;\n\n const throttleMs = config.throttleMs ?? 1000;\n const limits = config.limits ?? {};\n let timer: ReturnType<typeof setTimeout> | undefined;\n let pending: PersistedClient | undefined;\n\n function flush() {\n /* v8 ignore next -- defensive guard; pending is always set before timer starts */\n if (!pending) return;\n try {\n const limited = applyLimits(pending, limits);\n window.localStorage.setItem(config.key, serialize(limited));\n } catch {\n /* quota exceeded — silently skip */\n }\n pending = undefined;\n }\n\n return {\n persistClient(client: PersistedClient) {\n pending = client;\n if (!timer) {\n timer = setTimeout(() => {\n timer = undefined;\n flush();\n }, throttleMs);\n }\n },\n\n restoreClient() {\n try {\n const raw = window.localStorage.getItem(config.key);\n if (!raw) return undefined;\n return deserialize(raw);\n } catch {\n return undefined;\n }\n },\n\n removeClient() {\n window.localStorage.removeItem(config.key);\n },\n };\n}\n","import { useEffect } from \"react\";\nimport type { PersistenceConfig } from \"../types\";\n\nconst CHECK_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * Monitors total localStorage size and evicts limited query families\n * when the threshold is exceeded.\n *\n * Eviction strategy: remove queries whose key prefix appears in `limits`,\n * starting with the largest family. If parsing fails, clears the entire\n * persistence key as a fallback.\n */\nexport function useStorageMonitor(config: PersistenceConfig): void {\n const { key, limits = {}, maxStorageMB = 3 } = config;\n const limitKeys = Object.keys(limits);\n\n useEffect(() => {\n if (typeof window === \"undefined\" || limitKeys.length === 0) return;\n\n function evict() {\n const storage = window.localStorage;\n let totalSize = 0;\n\n for (const k of Object.keys(storage)) {\n const v = storage.getItem(k);\n if (v) totalSize += k.length + v.length;\n }\n\n // UTF-16: each char = 2 bytes\n const usedMB = (totalSize * 2) / 1024 / 1024;\n if (usedMB <= maxStorageMB) return;\n\n try {\n const raw = storage.getItem(key);\n if (!raw) return;\n const parsed = JSON.parse(raw);\n if (!parsed.clientState?.queries) return;\n\n // Remove all queries whose prefix is in limits\n parsed.clientState.queries = parsed.clientState.queries.filter(\n (q: { queryKey?: unknown[] }) => {\n if (!Array.isArray(q.queryKey)) return true;\n const prefix = q.queryKey[0];\n return typeof prefix !== \"string\" || !limitKeys.includes(prefix);\n },\n );\n\n storage.setItem(key, JSON.stringify(parsed));\n } catch {\n // Corrupted data — clear entirely\n storage.removeItem(key);\n }\n }\n\n evict();\n const id = setInterval(evict, CHECK_INTERVAL_MS);\n return () => clearInterval(id);\n }, [key, maxStorageMB, limitKeys.length]); // eslint-disable-line react-hooks/exhaustive-deps\n}\n"],"mappings":"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","names":["useMemo","useMemo","useEffect","useState","useEffect","useMemo","useQuery","useQueryClient","useQueryClient","useMemo","useEffect","useQuery","useMemo","useMemo","useQueryClient","useCallback","useState","useEffect","useMemo","useEffect","useState","useEffect","useMemo"]}
|
|
1
|
+
{"version":3,"sources":["../src/provider.tsx","../src/stores/items-filters-store.ts","../src/hooks/use-debounce.ts","../src/hooks/use-format-price.ts","../src/hooks/use-stock.ts","../src/hooks/use-cart-actions.ts","../../utils/src/lists.ts","../src/hooks/use-modal-lifecycle.ts","../src/hooks/use-cart-initialization.ts","../src/hooks/use-cart-pricing.ts","../src/hooks/use-pagination-prefetch.ts","../src/persistence/use-persistence.ts","../src/persistence/serializer.ts","../src/persistence/apply-limits.ts","../src/persistence/create-persister.ts","../src/persistence/use-storage-monitor.ts"],"sourcesContent":["import { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type {\n AugurAuthContext,\n AugurSiteConfig,\n CacheConfig,\n DeepQueryOptions,\n} from \"@simpleapps-com/augur-core\";\nimport {\n createOptionsProxy,\n createQueryActionProxy,\n createKeysOnlyProxy,\n} from \"@simpleapps-com/augur-core\";\nimport type { OptionsProxyConfig } from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { useLatest } from \"./hooks/use-latest\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/** The augur-api SDK instance, as `useAugurApi()` returns it (the SDK is a peer dependency). */\nexport type AugurApiClient = AugurAPI;\n\ninterface AugurHooksProviderProps {\n /** SDK client instance. When omitted, `useAugurOptions()` returns a keys-only\n * proxy — consumers MUST override queryFn with a server action at each call site.\n * Any object is accepted (a site's test double included); hooks read it as the SDK. */\n api?: object;\n /** Optional auth context — hooks fall back to these values when not passed directly. */\n auth?: AugurAuthContext;\n /** Optional cache configuration — controls edge and Redis caching per tier. */\n cache?: CacheConfig;\n /** Optional site configuration — hooks read defaults and formatting from this. */\n site?: AugurSiteConfig;\n children: ReactNode;\n}\n\nconst AugurApiContext = createContext<object | null>(null);\nconst AugurAuthReactContext = createContext<AugurAuthContext | undefined>(undefined);\nconst AugurCacheContext = createContext<CacheConfig | undefined>(undefined);\nconst AugurOptionsContext = createContext<unknown>(null);\nconst AugurSiteContext = createContext<AugurSiteConfig | undefined>(undefined);\n\n/**\n * Provides the augur-api SDK instance, proxy options, and auth to all hooks.\n *\n * ```tsx\n * <AugurHooksProvider api={api} auth={authContext} cache={cacheConfig}>\n * <App />\n * </AugurHooksProvider>\n * ```\n *\n * Components use `useAugurOptions()` to get the proxy:\n * ```tsx\n * const q = useAugurOptions();\n * const { data } = useQuery(q.items.invMast.get(42));\n * ```\n */\nexport function AugurHooksProvider({ api, auth, cache, site, children }: AugurHooksProviderProps) {\n const proxyConfig: OptionsProxyConfig | undefined = cache\n ? { cache: { static: cache.static, semiStatic: cache.semiStatic } }\n : undefined;\n\n // The proxy is rebuilt when the api changes; the cache config is read at that point, not\n // watched (it is a new object on every render).\n const proxyConfigRef = useLatest(proxyConfig);\n const options = useMemo(() => {\n const config = proxyConfigRef.current;\n if (api) return createOptionsProxy(api, config);\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) return createQueryActionProxy(registeredAction, config);\n return createKeysOnlyProxy(config);\n }, [api, proxyConfigRef]);\n\n return (\n <AugurApiContext.Provider value={api ?? null}>\n <AugurAuthReactContext.Provider value={auth}>\n <AugurCacheContext.Provider value={cache}>\n <AugurSiteContext.Provider value={site}>\n <AugurOptionsContext.Provider value={options}>{children}</AugurOptionsContext.Provider>\n </AugurSiteContext.Provider>\n </AugurCacheContext.Provider>\n </AugurAuthReactContext.Provider>\n </AugurApiContext.Provider>\n );\n}\n\n/**\n * Returns the deep proxy for creating TanStack Query options.\n *\n * When an `api` prop is provided to the provider, every path returns\n * full query options (queryKey, queryFn, staleTime, gcTime).\n *\n * When no `api` is provided (server-only JWT sites), returns a keys-only\n * proxy — queryKey, staleTime, and gcTime are generated normally, but\n * queryFn throws unless overridden. This lets B2B sites use the proxy\n * for deterministic keys and cache tiers while routing data through\n * server actions.\n *\n * @example\n * ```tsx\n * // With api (direct SDK access):\n * const q = useAugurOptions();\n * const { data } = useQuery(q.items.invMast.get(42));\n *\n * // Without api (server-only JWT):\n * const q = useAugurOptions();\n * const { data } = useQuery({\n * ...q.items.invMast.doc.get(42),\n * queryFn: () => getItemAction(42), // server action\n * });\n * ```\n */\nexport function useAugurOptions<T = DeepQueryOptions<AugurAPI>>(): T {\n const options = useContext(AugurOptionsContext);\n if (!options) {\n throw new Error(\n \"useAugurOptions must be used within an <AugurHooksProvider>. \" +\n \"Wrap your app with <AugurHooksProvider>.\",\n );\n }\n return options as T;\n}\n\n/**\n * Returns the augur-api SDK instance from context, or null if not provided.\n * Used internally by hooks that need the SDK for fallback queries.\n */\nexport function useAugurApiOptional(): AugurApiClient | null {\n return useContext(AugurApiContext) as AugurApiClient | null;\n}\n\n/**\n * Returns the augur-api SDK instance from context.\n * Throws if called outside of `<AugurHooksProvider>` or when no api is provided.\n */\nexport function useAugurApi(): AugurApiClient {\n const api = useContext(AugurApiContext) as AugurApiClient | null;\n if (!api) {\n throw new Error(\n \"useAugurApi must be used within an <AugurHooksProvider>. \" +\n \"Wrap your app with <AugurHooksProvider api={apiInstance}>.\",\n );\n }\n return api;\n}\n\n/**\n * Returns the provider-level auth context, if any.\n * Used internally by hooks to fall back to provider auth when\n * auth fields are not passed directly as hook parameters.\n */\nexport function useAugurAuth(): AugurAuthContext | undefined {\n return useContext(AugurAuthReactContext);\n}\n\n/**\n * Returns the provider-level cache configuration, if any.\n * Used internally by hooks to enable edge/Redis caching.\n */\nexport function useAugurCache(): CacheConfig | undefined {\n return useContext(AugurCacheContext);\n}\n\n/**\n * Returns the site configuration from the nearest `AugurHooksProvider`.\n * Returns `undefined` when no `site` prop is provided.\n */\nexport function useAugurSite(): AugurSiteConfig | undefined {\n return useContext(AugurSiteContext);\n}\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport type { TItemsFilters } from \"@simpleapps-com/augur-utils\";\n\n/** Default filter values used when the store is first created or reset. */\nconst DEFAULT_FILTER_STATE: TItemsFilters = {\n filters: [],\n limit: 12,\n offset: 0,\n sortBy: \"asc\",\n q: \"\",\n page: 1,\n};\n\n/** Zustand state shape for item list filtering, sorting, and pagination. */\ninterface ItemsFiltersState {\n /** Snapshot of the initial defaults; useful for \"reset filters\" UIs. */\n initialFiltersState: TItemsFilters;\n /** Current active filter/sort/pagination state. */\n itemsFilters: TItemsFilters;\n /** Replace the entire filter state. */\n setItemsFilters: (itemFilters: TItemsFilters) => void;\n}\n\n/** Zustand store for item list filters, sorting, and pagination state. */\nexport const useItemFiltersStore = create<ItemsFiltersState>()(\n devtools(\n (set) => ({\n initialFiltersState: DEFAULT_FILTER_STATE,\n itemsFilters: DEFAULT_FILTER_STATE,\n setItemsFilters: (state) => set({ itemsFilters: state }, false, \"setItemsFilters\"),\n }),\n {\n name: \"ItemsFiltersStore\",\n enabled: process.env[\"NODE_ENV\"] === \"development\",\n },\n ),\n);\n","import { useEffect, useState } from \"react\";\n\n/**\n * Debounces a rapidly-changing value.\n * Returns the latest value only after `delay` ms of inactivity.\n */\nexport function useDebounce<T>(value: T, delay: number = 500): T {\n const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n useEffect(() => {\n const handler = setTimeout(() => {\n setDebouncedValue(value);\n }, delay);\n\n return () => {\n clearTimeout(handler);\n };\n }, [value, delay]);\n\n return debouncedValue;\n}\n","import type { AugurSiteFormatting } from \"@simpleapps-com/augur-core\";\nimport { cleanMoney } from \"@simpleapps-com/augur-utils\";\nimport { useAugurSite } from \"../provider\";\n\n/** Options for configuring the useFormatPrice hook. */\nexport interface UseFormatPriceOptions {\n /** BCP 47 locale tag. Overrides site.formatting.locale. */\n locale?: string;\n /** ISO 4217 currency code. Overrides site.formatting.currency. */\n currency?: string;\n /** Decimal digits. Overrides site.formatting.precision. */\n precision?: number;\n /** Label returned when the effective value is 0 (e.g. \"Call for Price\"). */\n zeroLabel?: string;\n}\n\n/** Per-call options passed to the returned formatPrice function. */\nexport interface FormatPriceCallOptions {\n /** Override decimal digits for this call only. */\n precision?: number;\n /** Multiply the value by this quantity before formatting. */\n quantity?: number;\n}\n\nfunction normaliseOptions(\n optionsOrLocale: UseFormatPriceOptions | string | undefined,\n legacyCurrency: string | undefined,\n): UseFormatPriceOptions {\n if (typeof optionsOrLocale === \"string\") {\n return { locale: optionsOrLocale, currency: legacyCurrency };\n }\n return optionsOrLocale ?? {};\n}\n\nfunction resolveFormatting(\n opts: UseFormatPriceOptions,\n siteFormatting: AugurSiteFormatting | undefined,\n) {\n const site: Partial<AugurSiteFormatting> = siteFormatting ?? {};\n return {\n locale: opts.locale ?? site.locale ?? \"en-US\",\n currency: opts.currency ?? site.currency ?? \"USD\",\n precision: opts.precision ?? site.precision ?? 2,\n zeroLabel: opts.zeroLabel ?? site.zeroLabel,\n };\n}\n\n/**\n * Hook that returns a price formatter.\n * Reads defaults from site config when params are omitted.\n *\n * Supports both the new options-object signature and the legacy positional\n * `(locale?, currency?)` signature for backwards compatibility.\n */\nexport function useFormatPrice(\n optionsOrLocale?: UseFormatPriceOptions | string,\n legacyCurrency?: string,\n) {\n const site = useAugurSite();\n const opts = normaliseOptions(optionsOrLocale, legacyCurrency);\n const {\n locale,\n currency,\n precision: basePrecision,\n zeroLabel,\n } = resolveFormatting(opts, site?.formatting);\n\n const formatPrice = (price: number, callOptions?: FormatPriceCallOptions): string => {\n // cleanMoney drops float noise so a line formats to the same cent as the cart total (GH #496).\n const effectiveValue = cleanMoney(price * (callOptions?.quantity ?? 1));\n\n if (effectiveValue === 0 && zeroLabel !== undefined) {\n return zeroLabel;\n }\n\n const precision = callOptions?.precision ?? basePrecision;\n\n return new Intl.NumberFormat(locale, {\n style: \"currency\",\n currency,\n minimumFractionDigits: precision,\n maximumFractionDigits: precision,\n }).format(effectiveValue);\n };\n\n return { formatPrice };\n}\n","import { useMemo } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { ResolvedStock, TStock } from \"@simpleapps-com/augur-utils\";\nimport { resolveStock } from \"@simpleapps-com/augur-utils\";\nimport { useAugurOptions } from \"../provider\";\nimport { stockEnabled, stockRetryDelay } from \"../rules\";\n\nexport interface UseStockOptions {\n enabled?: boolean;\n /** Override the default queryFn (e.g. with a custom server action). */\n queryFn?: () => Promise<TStock>;\n /** Company key to extract stock for a specific company. */\n companyKey?: string;\n /** Whether to round the quantity. */\n round?: boolean;\n /** Threshold below which stock is considered \"low\". */\n lowStockThreshold?: number;\n /** Whether to include the quantity in the resolved output. */\n showQuantity?: boolean;\n}\n\n/** Raw stock, its resolved form, and query state returned by useStock. */\ninterface StockResult {\n stock: TStock | null;\n resolved: ResolvedStock | null;\n loading: boolean;\n error: Error | null;\n}\n\n/**\n * Fetches full TStock data and resolves it into a normalized stock object.\n *\n * Uses the proxy from AugurHooksProvider context. Works with:\n * - Direct SDK (api prop on provider)\n * - Server actions (auto-detected via queryAction registration)\n * - Custom queryFn override\n */\nexport function useStock(invMastUid: number | string, options: UseStockOptions = {}): StockResult {\n const proxy = useAugurOptions();\n\n const resolvedQueryFn = options.queryFn;\n\n // Use the proxy for query options (works with SDK, server actions, or keys-only)\n const proxyOpts = proxy.items.invMast.stock.get(Number(invMastUid));\n\n const query = useQuery({\n ...proxyOpts,\n ...(resolvedQueryFn ? { queryFn: resolvedQueryFn } : {}),\n enabled: stockEnabled(options.enabled, !!invMastUid),\n retry: 3,\n retryDelay: stockRetryDelay,\n });\n\n // Every proxy resolves to the unwrapped SDK data (augur-core unwrapBaseResponse).\n const stockData = (query.data as TStock | undefined) ?? null;\n\n const resolved = useMemo(\n () =>\n resolveStock({\n stock: stockData,\n companyKey: options.companyKey,\n round: options.round,\n lowStockThreshold: options.lowStockThreshold,\n showQuantity: options.showQuantity,\n }),\n [stockData, options.companyKey, options.round, options.lowStockThreshold, options.showQuantity],\n );\n\n return {\n stock: stockData,\n resolved,\n loading: query.isLoading,\n error: query.error as Error | null,\n };\n}\n","import { useCallback } from \"react\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\nimport { hasNumberFrom } from \"@atlas/utils/lists\";\nimport { indexOfUidFrom, keepsAfterReverse, qtyOrZero, requiredCartUid } from \"../rules\";\nimport { useCartStore, useCartHdrUid, useCartLines, useSetCartLines } from \"../stores/cart-store\";\n\ntype CartLineInput = {\n invMastUid: number;\n quantity: number;\n unitOfMeasure: string;\n cartHdrUid?: number | string | undefined;\n};\n\n/** Site-specific callbacks injected into useCartActions. */\nexport interface CartActionCallbacks {\n /** Add items to cart via API. Truthy = success, falsy = failure. */\n addToCart: (\n cartHdrUid: number,\n items: Array<{\n cartHdrUid: number;\n invMastUid: number;\n quantity: number;\n unitOfMeasure: string;\n }>,\n ) => Promise<boolean | undefined | void>;\n /** Update cart lines via API. Truthy = success, falsy = failure. */\n updateCartLines: (cartHdrUid: number, lines: TCartLine[]) => Promise<boolean | undefined | void>;\n /** Delete all items from cart via API. Truthy = success, falsy = failure. */\n deleteItemsFromCart: (cartHdrUid: number) => Promise<boolean | undefined | void>;\n /** Optional toast notification callback. */\n toast?: {\n info?: (message: string) => void;\n error?: (message: string) => void;\n success?: (message: string) => void;\n };\n}\n\ninterface CartActionOptions {\n showToast?: boolean;\n itemId?: string;\n onSuccess?: () => void;\n onError?: (error: Error) => void;\n}\n\n/** Actions and state returned by useCartActions. */\ninterface CartActions {\n addToCart: (item: CartLineInput, options?: CartActionOptions) => Promise<boolean>;\n updateQuantity: (\n invMastUid: number,\n newQuantity: number,\n options?: CartActionOptions,\n ) => Promise<boolean>;\n removeFromCart: (invMastUid: number, options?: CartActionOptions) => Promise<boolean>;\n clearCart: (options?: Omit<CartActionOptions, \"itemId\">) => Promise<boolean>;\n isInCart: (invMastUid: number) => boolean;\n getItemQuantity: (invMastUid: number) => number;\n cartHdrUid: number | string | undefined;\n cartLines: TCartLine[];\n invalidateCartCache: () => void;\n}\n\nfunction requireCartUid(cartHdrUid: string | number | undefined): number {\n const num = typeof cartHdrUid === \"string\" ? Number(cartHdrUid) : cartHdrUid;\n // NaN is no uid, as `!num` treated it.\n const uid = requiredCartUid(num === undefined || Number.isNaN(num) ? undefined : num);\n if (uid === null) throw new Error(\"Cart UID is not set\");\n return uid;\n}\n\n/** The store's LIVE cart (not a render closure), so concurrent ops stack; throws with no cart UID. */\nfunction liveCart(): { uid: number; lines: TCartLine[] } {\n const { cartHdrUid, cartLines } = useCartStore.getState();\n return { uid: requireCartUid(cartHdrUid), lines: cartLines };\n}\n\nfunction buildOptimisticAdd(\n cartLines: TCartLine[],\n item: CartLineInput,\n cartHdrUid: number,\n itemId: string,\n): TCartLine[] {\n const existingIndex = indexOfUidFrom(uidsOf(cartLines), item.invMastUid, 0);\n\n if (existingIndex >= 0) {\n return cartLines.map((line, index) =>\n index === existingIndex\n ? { ...line, quantity: qtyOrZero(line.quantity) + item.quantity }\n : line,\n );\n }\n\n return [\n ...cartLines,\n {\n cartHdrUid,\n invMastUid: item.invMastUid,\n invMastUidCount: 1,\n isAssembly: \"N\",\n itemId,\n lineNo: cartLines.length + 1,\n lineNote: null,\n quantity: item.quantity,\n unitOfMeasure: item.unitOfMeasure,\n key: null,\n unitPrice: null,\n },\n ];\n}\n\n// --- Targeted optimistic-rollback helpers ---------------------------------\n// Each reverses ONLY its own op's delta against the LIVE store state (passed\n// in from useCartStore.getState()), never a stale render-closure snapshot.\n// This is what makes concurrent cart ops safe: a failing op undoes its own\n// contribution while leaving a concurrent op's committed change in place.\n\n/**\n * Reverse an optimistic add.\n * @invariant ∀ line. matched ⇒ quantity' = quantity − q, and the line is dropped\n * iff quantity' ≤ 0. Subtracts this op's `quantity` from the targeted line;\n * a concurrent add to the same line keeps its own delta (we subtract only q).\n */\nfunction reverseAdd(cartLines: TCartLine[], invMastUid: number, quantity: number): TCartLine[] {\n return cartLines.flatMap((line) => {\n if (line.invMastUid !== invMastUid) return [line];\n return keepsAfterReverse(line.quantity, quantity)\n ? [{ ...line, quantity: qtyOrZero(line.quantity) - quantity }]\n : [];\n });\n}\n\n/**\n * Reverse an optimistic absolute quantity set.\n * @invariant previousQuantity = undefined ⇒ no-op (the line did not exist at op\n * start, so there is nothing this op changed). Otherwise restores the targeted\n * line to its pre-op quantity; other lines (incl. concurrent edits) untouched.\n */\nfunction reverseQuantity(\n cartLines: TCartLine[],\n invMastUid: number,\n previousQuantity: TCartLine[\"quantity\"] | undefined,\n): TCartLine[] {\n if (previousQuantity === undefined) return cartLines;\n return cartLines.map((line) =>\n line.invMastUid === invMastUid ? { ...line, quantity: previousQuantity } : line,\n );\n}\n\n/**\n * Reverse an optimistic remove by re-inserting the removed line.\n * @invariant re-adds removedLine iff it existed at op start ∧ is absent now\n * (a concurrent op may have already re-added it; never duplicate).\n */\nfunction restoreRemoved(\n cartLines: TCartLine[],\n invMastUid: number,\n removedLine: TCartLine | undefined,\n): TCartLine[] {\n if (!removedLine) return cartLines;\n if (hasNumberFrom(uidsOf(cartLines), invMastUid, 0)) return cartLines;\n return [...cartLines, removedLine];\n}\n\n/**\n * Reverse an optimistic clear by restoring snapshot lines missing from live state.\n * @invariant result ⊇ live ∧ result ⊇ snapshot (by invMastUid); concurrent adds\n * that landed after the clear are preserved, cleared lines are restored.\n */\nfunction mergeRestore(cartLines: TCartLine[], snapshot: TCartLine[]): TCartLine[] {\n const merged = [...cartLines];\n for (const line of snapshot) {\n if (!hasNumberFrom(uidsOf(merged), line.invMastUid, 0)) merged.push(line);\n }\n return merged;\n}\n\n/** Each line's item uid, in order. */\nfunction uidsOf(cartLines: TCartLine[]): number[] {\n return cartLines.map((line) => line.invMastUid);\n}\n\n/** Calls `notify[kind]` as a method when toasts are on, it is set, and there is a message. */\nfunction sendToast(\n notify: CartActionCallbacks[\"toast\"],\n kind: \"info\" | \"error\",\n showToast: boolean,\n message: string | undefined,\n): void {\n if (showToast && message !== undefined) notify?.[kind]?.(message);\n}\n\n/** One cart op after its optimistic update: the server call and how it settles. */\ninterface CartOp {\n call: () => Promise<boolean | undefined | void>;\n /** The error a falsy result becomes (what `onError` receives). */\n failure: string;\n /** The success toast, if the op has one. */\n infoMessage?: string;\n errorMessage: string;\n showToast: boolean;\n /** Undoes this op's own optimistic change against the live store. */\n rollback: () => void;\n}\n\n/**\n * Runs the server call. On success: invalidate the cart queries, the info toast, `onSuccess`,\n * true. On a falsy result or a throw: rollback, the error toast, `onError`, false.\n */\nasync function settleCartOp(\n op: CartOp,\n options: CartActionOptions,\n notify: CartActionCallbacks[\"toast\"],\n invalidate: () => void,\n): Promise<boolean> {\n try {\n const success = await op.call();\n if (!success) throw new Error(op.failure);\n invalidate();\n sendToast(notify, \"info\", op.showToast, op.infoMessage);\n options.onSuccess?.();\n return true;\n } catch (error) {\n op.rollback();\n sendToast(notify, \"error\", op.showToast, op.errorMessage);\n options.onError?.(error as Error);\n return false;\n }\n}\n\n/**\n * Optimistic cart actions hook with automatic rollback on failure.\n *\n * Accepts site-specific server action callbacks so the hook itself\n * has no dependency on any particular server action implementation.\n *\n * @example\n * ```tsx\n * import { useCartActions } from \"@simpleapps-com/augur-hooks\";\n * import { addToCart, updateCartLines, deleteItemsFromCart } from \"@/lib/actions/commerce\";\n * import { toast } from \"react-toastify\";\n *\n * const cart = useCartActions({\n * addToCart, updateCartLines, deleteItemsFromCart,\n * toast: { info: toast.info, error: toast.error },\n * });\n *\n * await cart.addToCart({ invMastUid: 123, quantity: 1, unitOfMeasure: \"EA\" });\n * ```\n */\nexport function useCartActions(callbacks: CartActionCallbacks): CartActions {\n const queryClient = useQueryClient();\n const cartHdrUid = useCartHdrUid();\n const cartLines = useCartLines();\n const setCartLines = useSetCartLines();\n const notify = callbacks.toast;\n\n const invalidateCartCache = useCallback(() => {\n void queryClient.invalidateQueries({ queryKey: [\"cartLines\", cartHdrUid] });\n void queryClient.invalidateQueries({\n queryKey: [\"cart-also-bought\", cartHdrUid],\n });\n }, [queryClient, cartHdrUid]);\n\n const addToCart = useCallback(\n async (item: CartLineInput, options: CartActionOptions = {}): Promise<boolean> => {\n const { showToast = true, itemId = \"\" } = options;\n const { uid, lines: liveLines } = liveCart();\n\n setCartLines(buildOptimisticAdd(liveLines, item, uid, itemId));\n\n return settleCartOp(\n {\n call: () =>\n callbacks.addToCart(uid, [\n {\n cartHdrUid: uid,\n invMastUid: item.invMastUid,\n quantity: item.quantity,\n unitOfMeasure: item.unitOfMeasure,\n },\n ]),\n failure: \"Failed to add item to cart\",\n infoMessage: `${item.quantity} x ${itemId || \"Item\"} added to cart`,\n errorMessage: \"Failed to add item to cart. Please try again.\",\n showToast,\n rollback: () =>\n setCartLines(\n reverseAdd(useCartStore.getState().cartLines, item.invMastUid, item.quantity),\n ),\n },\n options,\n notify,\n invalidateCartCache,\n );\n },\n [setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const updateQuantity = useCallback(\n async (\n invMastUid: number,\n newQuantity: number,\n options: CartActionOptions = {},\n ): Promise<boolean> => {\n const { showToast = false } = options;\n const { uid, lines: liveLines } = liveCart();\n const previousQuantity = liveLines.find((line) => line.invMastUid === invMastUid)?.quantity;\n\n const updatedLines = liveLines.map((line) =>\n line.invMastUid === invMastUid ? { ...line, quantity: newQuantity } : line,\n );\n setCartLines(updatedLines);\n\n return settleCartOp(\n {\n call: () => callbacks.updateCartLines(uid, updatedLines),\n failure: \"Failed to update quantity\",\n errorMessage: \"Failed to update quantity. Please try again.\",\n showToast,\n rollback: () =>\n setCartLines(\n reverseQuantity(useCartStore.getState().cartLines, invMastUid, previousQuantity),\n ),\n },\n options,\n notify,\n invalidateCartCache,\n );\n },\n [setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const removeFromCart = useCallback(\n async (invMastUid: number, options: CartActionOptions = {}): Promise<boolean> => {\n const { showToast = true, itemId = \"\" } = options;\n const { uid, lines: liveLines } = liveCart();\n const removedLine = liveLines.find((line) => line.invMastUid === invMastUid);\n\n setCartLines(liveLines.filter((line) => line.invMastUid !== invMastUid));\n\n const zeroedLines = liveLines.map((line) =>\n line.invMastUid === invMastUid ? { ...line, quantity: 0 } : line,\n );\n return settleCartOp(\n {\n call: () => callbacks.updateCartLines(uid, zeroedLines),\n failure: \"Failed to remove item\",\n infoMessage: `${itemId || \"Item\"} removed from cart`,\n errorMessage: \"Failed to remove item. Please try again.\",\n showToast,\n rollback: () =>\n setCartLines(\n restoreRemoved(useCartStore.getState().cartLines, invMastUid, removedLine),\n ),\n },\n options,\n notify,\n invalidateCartCache,\n );\n },\n [setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const clearCart = useCallback(\n async (options: Omit<CartActionOptions, \"itemId\"> = {}): Promise<boolean> => {\n const { showToast = true } = options;\n const { uid, lines: snapshot } = liveCart();\n setCartLines([]);\n\n return settleCartOp(\n {\n call: () => callbacks.deleteItemsFromCart(uid),\n failure: \"Failed to clear cart\",\n infoMessage: \"Cart cleared\",\n errorMessage: \"Failed to clear cart. Please try again.\",\n showToast,\n rollback: () => setCartLines(mergeRestore(useCartStore.getState().cartLines, snapshot)),\n },\n options,\n notify,\n invalidateCartCache,\n );\n },\n [setCartLines, invalidateCartCache, callbacks, notify],\n );\n\n const isInCart = useCallback(\n (invMastUid: number): boolean => {\n return cartLines.some((line) => line.invMastUid === invMastUid);\n },\n [cartLines],\n );\n\n const getItemQuantity = useCallback(\n (invMastUid: number): number => {\n return cartLines.find((line) => line.invMastUid === invMastUid)?.quantity ?? 0;\n },\n [cartLines],\n );\n\n return {\n addToCart,\n updateQuantity,\n removeFromCart,\n clearCart,\n isInCart,\n getItemQuantity,\n cartHdrUid,\n cartLines,\n invalidateCartCache,\n };\n}\n","//@ backend dafny\nimport { endsWith, includesFrom } from \"./strings\";\n\n/* Pure list helpers, verified with LemmaScript → Dafny (model: models/Utils.dfy; link:\n models/links/utils-lists.dfy). */\n\n/**\n * The items from index `i` joined by `sep` (JS `xs.join(sep)` at i = 0).\n *\n * @ensures exactly the model's JoinFrom\n */\nexport function joinFrom(xs: string[], sep: string, i: number): string {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases xs.length - i\n //@ ensures i >= xs.length ==> \\result === \"\"\n if (i >= xs.length) return \"\";\n if (i === xs.length - 1) return xs[i] as string;\n return (xs[i] as string) + sep + joinFrom(xs, sep, i + 1);\n}\n\n/**\n * Whether `x` is one of `xs` from index `i` on (JS `xs.includes(x)` at i = 0).\n *\n * @ensures result ⟺ ∃ k. i ≤ k < |xs| ∧ xs[k] = x — exactly the model's HasItemFrom\n */\nexport function hasItemFrom(xs: string[], x: string, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= xs.length\n //@ decreases xs.length - i\n //@ ensures \\result <==> exists(k: nat, i <= k && k < xs.length && xs[k] === x)\n // `===`, not `>=`: past the end xs[i] is undefined, never x, so `>=` vs `>` is equivalent\n if (i === xs.length) return false;\n if ((xs[i] as string) === x) return true;\n return hasItemFrom(xs, x, i + 1);\n}\n\n/**\n * Whether the number `x` is one of `xs` from index `i` on (JS `xs.includes(x)` at i = 0, for\n * numbers).\n *\n * @ensures result ⟺ ∃ k. i ≤ k < |xs| ∧ xs[k] = x — exactly the model's HasNumberFrom\n */\nexport function hasNumberFrom(xs: number[], x: number, i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= xs.length\n //@ decreases xs.length - i\n //@ ensures \\result <==> exists(k: nat, i <= k && k < xs.length && xs[k] === x)\n if (i === xs.length) return false;\n if ((xs[i] as number) === x) return true;\n return hasNumberFrom(xs, x, i + 1);\n}\n\n/**\n * Whether `s` ends with one of `xs` from index `i` on (a regex `(a|b|…)$` at i = 0).\n *\n * @ensures exactly the model's EndsWithAnyFrom\n */\nexport function endsWithAnyFrom(s: string, xs: string[], i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= xs.length\n //@ decreases xs.length - i\n //@ ensures \\result <==> exists(k: nat, i <= k && k < xs.length && endsWith(s, xs[k]))\n if (i === xs.length) return false;\n if (endsWith(s, xs[i] as string)) return true;\n return endsWithAnyFrom(s, xs, i + 1);\n}\n\n/**\n * Whether one of `xs` from index `i` on occurs in `s` (a regex `(a|b|…)` at i = 0).\n *\n * @ensures exactly the model's IncludesAnyFrom\n */\nexport function includesAnyFrom(s: string, xs: string[], i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= xs.length\n //@ decreases xs.length - i\n //@ ensures \\result <==> exists(k: nat, i <= k && k < xs.length && includesFrom(s, xs[k], 0))\n if (i === xs.length) return false;\n if (includesFrom(s, xs[i] as string, 0)) return true;\n return includesAnyFrom(s, xs, i + 1);\n}\n\n/**\n * The items of `xs` from index `i` that `allowed` doesn't hold, in order (JS\n * `xs.filter((x) => !allowed.includes(x))` at i = 0).\n *\n * @ensures exactly the model's NotInFrom (NotInFromIsTheUnknown: the unknown ones, all of them)\n */\nexport function notInFrom(xs: string[], allowed: string[], i: number): string[] {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases xs.length - i\n //@ ensures i >= xs.length ==> \\result.length === 0\n if (i >= xs.length) return [];\n const rest = notInFrom(xs, allowed, i + 1);\n return hasItemFrom(allowed, xs[i] as string, 0) ? rest : [xs[i] as string, ...rest];\n}\n\n/**\n * Whether `x` is one of the first `k` items of `xs` (JS `xs.slice(0, k).includes(x)`).\n *\n * @ensures result ⟺ ∃ j < k. xs[j] = x — exactly the model's HasItemBelow\n */\nexport function hasItemBelow(xs: string[], x: string, k: number): boolean {\n //@ verify\n //@ type k nat\n //@ requires k >= 0 && k <= xs.length\n //@ decreases k\n //@ ensures \\result <==> exists(j: nat, j < k && xs[j] === x)\n if (k === 0) return false;\n if ((xs[k - 1] as string) === x) return true;\n return hasItemBelow(xs, x, k - 1);\n}\n\n/**\n * The items of `xs` from index `i` that repeat an earlier item, in order (at i = 0, every\n * duplicate after its first; none ⟺ the items are unique).\n *\n * @ensures exactly the model's RepeatsFrom (RepeatsFromEmpty: none exactly when unique)\n */\nexport function repeatsFrom(xs: string[], i: number): string[] {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases xs.length - i\n //@ ensures i >= xs.length ==> \\result.length === 0\n if (i >= xs.length) return [];\n const rest = repeatsFrom(xs, i + 1);\n return hasItemBelow(xs, xs[i] as string, i) ? [xs[i] as string, ...rest] : rest;\n}\n\n/**\n * The items of `xs` from index `i` that no earlier item repeats, in order (at i = 0, JS\n * `[...new Set(xs)]`: each item once, first occurrence kept).\n *\n * @ensures exactly the model's FirstsFrom\n */\nexport function firstsFrom(xs: string[], i: number): string[] {\n //@ verify\n //@ type i nat\n //@ requires i >= 0\n //@ decreases xs.length - i\n //@ ensures i >= xs.length ==> \\result.length === 0\n if (i >= xs.length) return [];\n const rest = firstsFrom(xs, i + 1);\n return hasItemBelow(xs, xs[i] as string, i) ? rest : [xs[i] as string, ...rest];\n}\n\n/**\n * At most the first `n` items (JS `xs.slice(0, n)` for n ≥ 0).\n *\n * @ensures exactly the model's TakeAtMost\n */\nexport function takeAtMost(xs: string[], n: number): string[] {\n //@ verify\n //@ type n nat\n //@ requires n >= 0\n //@ ensures n < xs.length ==> \\result.length === n\n //@ ensures n >= xs.length ==> \\result.length === xs.length\n return n < xs.length ? xs.slice(0, n) : xs;\n}\n\n/**\n * Whether two number lists are equal from index `i` on (the whole lists at i = 0).\n *\n * @ensures result ⟺ |a| = |b| ∧ ∀ k ∈ [i, |a|). a[k] = b[k] — exactly the model's\n * SameNumbersFrom\n */\nexport function sameNumbersFrom(a: number[], b: number[], i: number): boolean {\n //@ verify\n //@ type i nat\n //@ requires i >= 0 && i <= a.length\n //@ decreases a.length - i\n //@ ensures \\result <==> (a.length === b.length && forall(k: nat, i <= k && k < a.length ==> a[k] === b[k]))\n if (a.length !== b.length) return false;\n if (i === a.length) return true;\n return (a[i] as number) === (b[i] as number) && sameNumbersFrom(a, b, i + 1);\n}\n","\"use client\";\nimport { useEffect, useState } from \"react\";\n\n/**\n * Shared modal lifecycle hook -- scroll lock, Escape key, client-side hydration gate.\n *\n * Locks body scroll when the modal is open and restores it on close.\n * Listens for Escape key to trigger onClose. Returns isClient for\n * hydration-safe conditional rendering.\n */\nexport function useModalLifecycle(isOpen: boolean, onClose: () => void) {\n const [isClient, setIsClient] = useState(false);\n\n useEffect(() => {\n setIsClient(true);\n }, []);\n\n // Scroll lock\n useEffect(() => {\n document.body.style.overflow = isOpen ? \"hidden\" : \"auto\";\n return () => {\n document.body.style.overflow = \"auto\";\n };\n }, [isOpen]);\n\n // Escape key\n useEffect(() => {\n const handleEscape = (e: KeyboardEvent) => {\n if (e.key === \"Escape\" && isOpen) onClose();\n };\n document.addEventListener(\"keydown\", handleEscape);\n return () => document.removeEventListener(\"keydown\", handleEscape);\n }, [isOpen, onClose]);\n\n return { isClient };\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useQuery, useQueryClient } from \"@tanstack/react-query\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\nimport {\n useCartHdrUid,\n useSetCartHdrUid,\n useSetCartLines,\n useClearCart,\n} from \"../stores/cart-store\";\nimport { useAugurAuth } from \"../provider\";\n\nconst MAX_RETRY_ATTEMPTS = 7;\nconst RETRY_DELAY_MS = 1000;\n\n/** Before another lookup attempt: wait 1 s × 1.5^attempt (at most 10 s); none after the last. */\nasync function waitBeforeRetry(attempt: number): Promise<void> {\n if (attempt >= MAX_RETRY_ATTEMPTS) return;\n const delay = Math.min(RETRY_DELAY_MS * Math.pow(1.5, attempt), 10000);\n await new Promise((resolve) => setTimeout(resolve, delay));\n}\n\n/** Session info passed from the consumer's auth system. */\nexport interface CartSessionInfo {\n /** Auth status: \"loading\" | \"authenticated\" | \"unauthenticated\" */\n status: \"loading\" | \"authenticated\" | \"unauthenticated\";\n /** User's ID (e.g., Joomla user ID). Undefined if not authenticated. */\n userId?: string | number;\n /** Cart header UID from the auth session, if available. */\n cartHdrUid?: number | string;\n}\n\n/** Site-specific callbacks injected into useCartInitialization. */\nexport interface CartInitCallbacks {\n /** Look up or create a cart header. Returns { cartHdrUid, cartToken? }. */\n cartHdrLookup: (\n userId: string | number,\n cartToken: string,\n ) => Promise<{ cartHdrUid: number; cartToken?: string | null } | false | null | undefined>;\n /** Fetch cart line items for a given cart header UID. */\n getCartLines: (cartHdrUid: number) => Promise<TCartLine[] | undefined>;\n /** Get the current cart token. Defaults to localStorage.getItem(\"cartToken\"). */\n getCartToken?: () => string | null;\n /** Save cart token. Defaults to localStorage.setItem(\"cartToken\", token). */\n saveCartToken?: (token: string) => void;\n /** Generate a new unique cart token. Defaults to crypto.randomUUID(). */\n generateCartToken?: () => string;\n}\n\nconst defaultGetCartToken = () => localStorage.getItem(\"cartToken\");\nconst defaultSaveCartToken = (token: string) => localStorage.setItem(\"cartToken\", token);\nconst defaultGenerateCartToken = () => crypto.randomUUID();\n\n/**\n * Initialize cart state from session (authenticated) or cookie (guest).\n * Call once in the root layout.\n *\n * @example\n * ```tsx\n * import { useCartInitialization } from \"@simpleapps-com/augur-hooks\";\n * import { useSession } from \"next-auth/react\";\n * import { cartHdrLookup, getCartLines } from \"@/lib/actions/commerce\";\n *\n * function CartInitializer() {\n * const { data: session, status } = useSession();\n *\n * // Minimal setup — token storage defaults to localStorage,\n * // token generation defaults to crypto.randomUUID().\n * useCartInitialization(\n * {\n * status,\n * userId: session?.user?.id,\n * cartHdrUid: session?.user?.cartHdrUid,\n * },\n * { cartHdrLookup, getCartLines },\n * );\n *\n * return null;\n * }\n * ```\n */\nexport function useCartInitialization(session: CartSessionInfo, callbacks: CartInitCallbacks) {\n const getCartToken = callbacks.getCartToken ?? defaultGetCartToken;\n const saveCartToken = callbacks.saveCartToken ?? defaultSaveCartToken;\n const generateCartToken = callbacks.generateCartToken ?? defaultGenerateCartToken;\n\n const auth = useAugurAuth();\n const cartHdrUid = useCartHdrUid();\n const setCartHdrUid = useSetCartHdrUid();\n const setCartLines = useSetCartLines();\n const clearCart = useClearCart();\n const queryClient = useQueryClient();\n\n // Merge session with provider auth — session fields take priority\n const effectiveStatus = session.status;\n const effectiveUserId = session.userId ?? auth?.userId;\n const effectiveCartHdrUid = session.cartHdrUid ?? auth?.cartHdrUid;\n const effectiveSession = useMemo<CartSessionInfo>(\n () => ({ status: effectiveStatus, userId: effectiveUserId, cartHdrUid: effectiveCartHdrUid }),\n [effectiveStatus, effectiveUserId, effectiveCartHdrUid],\n );\n\n const retryCountRef = useRef(0);\n const isInitializingRef = useRef(false);\n const prevStatusRef = useRef(effectiveSession.status);\n\n // Auto-clear cart on logout (authenticated → unauthenticated)\n useEffect(() => {\n const prevStatus = prevStatusRef.current;\n prevStatusRef.current = effectiveSession.status;\n\n if (prevStatus === \"authenticated\" && effectiveSession.status === \"unauthenticated\") {\n clearCart();\n queryClient.removeQueries({ queryKey: [\"cartLines\"] });\n queryClient.removeQueries({ queryKey: [\"cart-also-bought\"] });\n }\n }, [effectiveSession.status, clearCart, queryClient]);\n\n // Initialize cart header\n useEffect(() => {\n if (cartHdrUid || effectiveSession.status === \"loading\") return;\n\n // Authenticated user — use session cartHdrUid\n if (effectiveSession.cartHdrUid && effectiveSession.status === \"authenticated\") {\n setCartHdrUid(effectiveSession.cartHdrUid);\n return;\n }\n\n // Guest user — lookup/create cart\n if (effectiveSession.status === \"unauthenticated\" && !isInitializingRef.current) {\n isInitializingRef.current = true;\n retryCountRef.current = 0;\n\n const initializeGuestCart = async () => {\n const existingToken = getCartToken();\n const cartToken =\n existingToken && typeof existingToken === \"string\" ? existingToken : generateCartToken();\n let lastError: unknown;\n\n while (retryCountRef.current < MAX_RETRY_ATTEMPTS) {\n try {\n const cartHdr = await callbacks.cartHdrLookup(\"0\", cartToken);\n\n if (cartHdr && cartHdr.cartHdrUid !== 0) {\n saveCartToken(cartToken);\n setCartHdrUid(cartHdr.cartHdrUid);\n isInitializingRef.current = false;\n return;\n }\n\n retryCountRef.current++;\n await waitBeforeRetry(retryCountRef.current);\n } catch (error) {\n // Retries are expected; only the final failure is logged (below).\n lastError = error;\n retryCountRef.current++;\n await waitBeforeRetry(retryCountRef.current);\n }\n }\n\n console.error(`Cart initialization failed after ${MAX_RETRY_ATTEMPTS} attempts`, lastError);\n isInitializingRef.current = false;\n };\n\n void initializeGuestCart();\n }\n }, [\n effectiveSession,\n cartHdrUid,\n setCartHdrUid,\n callbacks,\n getCartToken,\n saveCartToken,\n generateCartToken,\n ]);\n\n // Fetch cart lines when cartHdrUid is available\n const { data: cartLinesData } = useQuery({\n queryKey: [\"cartLines\", cartHdrUid],\n queryFn: async () => (await callbacks.getCartLines(Number(cartHdrUid))) ?? [],\n enabled: !!cartHdrUid,\n });\n\n // Sync cart lines to Zustand store\n useEffect(() => {\n if (cartLinesData) {\n setCartLines(cartLinesData);\n }\n }, [cartLinesData, setCartLines]);\n\n return {\n cartHdrUid,\n isInitializing: isInitializingRef.current,\n retryCount: retryCountRef.current,\n };\n}\n","import { useMemo } from \"react\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport type { TPriceData } from \"@simpleapps-com/augur-utils\";\nimport { cleanMoney, derivePrice } from \"@simpleapps-com/augur-utils\";\nimport { useCartLines } from \"../stores/cart-store\";\nimport { useAugurOptions, useAugurAuth, useAugurSite } from \"../provider\";\n\nexport interface CartPriceData {\n unitPrice: number;\n priceData: Record<string, unknown> | null;\n}\n\nexport interface CartPricingResult {\n /** Map of itemId -> price data (with quantity-specific pricing) */\n prices: Record<string, CartPriceData>;\n /** Get unit price for an item (returns 0 if not found) */\n getUnitPrice: (itemId: string) => number;\n /** Get total price for an item (unitPrice * quantity) */\n getItemTotal: (itemId: string, quantity: number) => number;\n /** Cart subtotal (sum of all item totals) */\n subtotal: number;\n /** True if any price is still loading */\n isLoading: boolean;\n /** True if all prices loaded successfully */\n isSuccess: boolean;\n /** True if any price failed to load */\n isError: boolean;\n}\n\ninterface UseCartPricingOptions {\n customerId?: string | number;\n /** Override per-item price fetching (e.g. with a custom server action). */\n queryFn?: (itemId: string, customerId: string | number, quantity: number) => Promise<TPriceData>;\n}\n\n/**\n * Unit price for one cart line. Only \"priced\" yields a real unit price;\n * loading/callForPrice → 0. A line that violates derivePrice's preconditions\n * (negative or non-finite quantity or unitPrice) also prices as 0, so one bad\n * line degrades instead of throwing during render and crashing the cart (GH #496).\n * Only derivePrice's RangeError is absorbed; any other error is a bug and is rethrown.\n * A null or non-finite quantity is unknown, so the line is unpriced rather than\n * priced at an invented quantity.\n */\nfunction deriveLineUnitPrice(priceData: TPriceData, quantity: number | null): number {\n if (typeof quantity !== \"number\" || !Number.isFinite(quantity)) return 0;\n try {\n const derived = derivePrice({ priceData, quantity });\n return derived.state === \"priced\" ? derived.unitPrice : 0;\n } catch (error) {\n if (error instanceof RangeError) return 0;\n throw error;\n }\n}\n\n/**\n * Extended price for one line. A non-finite quantity (NaN, ±Infinity, or null\n * at runtime) contributes 0, so one bad line cannot turn the whole subtotal\n * into NaN (GH #496). The product is passed through cleanMoney to drop float noise.\n */\nfunction lineTotal(unitPrice: number, quantity: number | null): number {\n return Number.isFinite(quantity) ? cleanMoney(unitPrice * (quantity as number)) : 0;\n}\n\n/**\n * Centralized hook for cart/checkout pricing.\n *\n * Fetches prices for ALL cart items with their actual quantities\n * to support quantity-based price breaks. React Query dedupes\n * identical calls across components.\n *\n * Uses the proxy from AugurHooksProvider context. Works with:\n * - Direct SDK (api prop on provider)\n * - Server actions (auto-detected via queryAction registration)\n * - Custom queryFn override\n */\nexport function useCartPricing(options: UseCartPricingOptions = {}): CartPricingResult {\n const proxy = useAugurOptions();\n const auth = useAugurAuth();\n const site = useAugurSite();\n const cartLines = useCartLines();\n const customerId = options.customerId ?? auth?.customerId ?? site?.defaults?.customerId;\n\n const priceFn = options.queryFn;\n\n const priceQueries = useQueries({\n queries: cartLines.map((line) => {\n // The price request needs a number; a null-quantity line is still left\n // unpriced below (deriveLineUnitPrice), see GH #501.\n const quantity = line.quantity ?? 1;\n if (priceFn) {\n return {\n queryKey: [\"price\", line.itemId?.toUpperCase() || \"\", customerId, quantity],\n queryFn: () => priceFn(line.itemId, customerId!, quantity),\n refetchOnReconnect: true,\n refetchOnWindowFocus: false,\n meta: { persist: true },\n enabled: !!customerId && !!line.itemId,\n };\n }\n\n // Use the proxy — works with SDK, server actions, or keys-only\n const proxyOpts = proxy.pricing.priceEngine.list({\n itemId: line.itemId?.toUpperCase() || \"\",\n customerId: Number(customerId),\n quantity,\n });\n\n return {\n ...proxyOpts,\n enabled: !!customerId && !!line.itemId,\n refetchOnReconnect: true,\n refetchOnWindowFocus: false,\n meta: { persist: true },\n };\n }),\n });\n\n const prices = useMemo(() => {\n const map: Record<string, CartPriceData> = {};\n cartLines.forEach((line, index) => {\n const queryResult = priceQueries[index];\n // Every proxy resolves to the unwrapped SDK data (augur-core unwrapBaseResponse).\n const priceData = queryResult?.data as TPriceData | undefined;\n if (priceData) {\n const unitPrice = deriveLineUnitPrice(priceData, line.quantity);\n map[line.itemId.toUpperCase()] = {\n unitPrice,\n priceData: priceData as Record<string, unknown>,\n };\n }\n });\n return map;\n }, [cartLines, priceQueries]);\n\n const getUnitPrice = useMemo(() => {\n return (itemId: string): number => {\n return prices[itemId?.toUpperCase()]?.unitPrice ?? 0;\n };\n }, [prices]);\n\n const getItemTotal = useMemo(() => {\n return (itemId: string, quantity: number): number => {\n return lineTotal(getUnitPrice(itemId), quantity);\n };\n }, [getUnitPrice]);\n\n const subtotal = useMemo(() => {\n return cartLines.reduce((sum, line) => {\n const unitPrice = prices[line.itemId.toUpperCase()]?.unitPrice ?? 0;\n return cleanMoney(sum + lineTotal(unitPrice, line.quantity));\n }, 0);\n }, [cartLines, prices]);\n\n const isLoading = priceQueries.some((q) => q.isLoading);\n const isSuccess = priceQueries.every((q) => q.isSuccess);\n const isError = priceQueries.some((q) => q.isError);\n\n return {\n prices,\n getUnitPrice,\n getItemTotal,\n subtotal,\n isLoading,\n isSuccess,\n isError,\n };\n}\n","import { useQueryClient } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport type { QueryKey } from \"@tanstack/react-query\";\n\ninterface UsePaginationPrefetchOptions {\n /** Query key for the paginated data */\n queryKey: QueryKey;\n /** Function to fetch a page of data */\n queryFn: (offset: number) => Promise<unknown>;\n /** Number of items per page */\n pageSize: number;\n /** Custom query key builder. Receives the base key and offset, returns the full key. Default: [...queryKey, offset]. */\n queryKeyFn?: (baseKey: QueryKey, offset: number) => QueryKey;\n /** Stale time in ms (defaults to 10 minutes) */\n staleTime?: number;\n /** GC time in ms (defaults to 30 minutes) */\n gcTime?: number;\n enabled?: boolean;\n}\n\n/**\n * Prefetch adjacent pages on hover for instant pagination.\n * Accepts a generic queryFn so it works with any paginated resource.\n */\nexport const usePaginationPrefetch = ({\n queryKey,\n queryFn,\n pageSize,\n queryKeyFn,\n staleTime = 10 * 60 * 1000,\n gcTime = 30 * 60 * 1000,\n enabled = true,\n}: UsePaginationPrefetchOptions) => {\n const queryClient = useQueryClient();\n\n const prefetchPage = useCallback(\n async (page: number) => {\n if (!enabled) return;\n\n const offset = (page - 1) * pageSize;\n\n // prefetchQuery never rejects: query-core swallows fetch errors, and the\n // real query surfaces them when the page is actually opened.\n await queryClient.prefetchQuery({\n queryKey: queryKeyFn ? queryKeyFn(queryKey, offset) : [...queryKey, offset],\n queryFn: () => queryFn(offset),\n staleTime,\n gcTime,\n });\n },\n [queryKey, queryFn, pageSize, queryKeyFn, staleTime, gcTime, queryClient, enabled],\n );\n\n const handlePaginationHover = useCallback(\n (page: number) => {\n const timeoutId = setTimeout(() => prefetchPage(page), 150);\n return () => clearTimeout(timeoutId);\n },\n [prefetchPage],\n );\n\n return {\n prefetchPage,\n handlePaginationHover,\n };\n};\n","import { useState, useEffect, useMemo } from \"react\";\nimport { shouldPersistOf } from \"../rules\";\nimport type { PersistenceConfig } from \"../types\";\nimport { createPersister } from \"./create-persister\";\nimport { useStorageMonitor } from \"./use-storage-monitor\";\n\n/**\n * Version of the persisted query-data format, prefixed to every buster.\n * Bump it when the shape the proxies resolve to changes, so caches written by\n * older package versions are discarded without each site bumping its own buster.\n * \"augur-2\": the direct-SDK options proxy unwraps BaseResponse (2.5.0).\n */\nexport const PERSISTED_DATA_FORMAT = \"augur-2\";\n\n/**\n * Returns a fully configured `persistOptions` object for use with\n * `PersistQueryClientProvider` from `@tanstack/react-query-persist-client`.\n *\n * Handles:\n * - SSR-safe persister creation (no-op on server)\n * - Map → Record serialization for localStorage compatibility\n * - Selective persistence (only successful queries matching persistableKeys)\n * - Per-key-prefix LRU eviction (via `limits`)\n * - Throttled writes to localStorage\n * - Hydration safety (maxAge: 0 until client mount)\n * - Storage monitoring with automatic eviction when over threshold\n * - Dev mode auto-buster (invalidates cache on each restart)\n *\n * @example\n * ```tsx\n * import { useAugurPersistence } from \"@simpleapps-com/augur-hooks\";\n *\n * function Providers({ children }) {\n * const [queryClient] = useState(() => new QueryClient({ ... }));\n * const persistOptions = useAugurPersistence({\n * key: \"my-site-cache\",\n * buster: \"1.0.0\",\n * persistableKeys: [\"price\", \"categories\", \"invMast\"],\n * limits: { invMast: 100 },\n * });\n *\n * return (\n * <PersistQueryClientProvider client={queryClient} persistOptions={persistOptions}>\n * <augur.Provider api={api} auth={auth}>\n * {children}\n * </augur.Provider>\n * </PersistQueryClientProvider>\n * );\n * }\n * ```\n */\nexport function useAugurPersistence(config: PersistenceConfig) {\n const [persister] = useState(() => createPersister(config));\n const [isMounted, setIsMounted] = useState(false);\n\n useEffect(() => {\n setIsMounted(true);\n }, []);\n\n useStorageMonitor(config);\n\n const isDev = typeof process !== \"undefined\" && process.env?.[\"NODE_ENV\"] === \"development\";\n\n const { persistableKeys } = config;\n\n const dehydrateOptions = useMemo(\n () => ({\n shouldDehydrateQuery: (query: {\n queryKey: readonly unknown[];\n state: { status: string };\n }) => {\n const key = query.queryKey;\n const hasHead = Array.isArray(key) && key.length > 0;\n return shouldPersistOf(\n hasHead,\n query.state.status === \"success\",\n hasHead && persistableKeys.includes(key[0] as string),\n );\n },\n }),\n [persistableKeys],\n );\n\n return {\n persister,\n maxAge: isMounted ? (config.maxAge ?? 24 * 60 * 60 * 1000) : 0,\n buster: isDev ? String(Date.now()) : `${PERSISTED_DATA_FORMAT}:${config.buster ?? \"\"}`,\n dehydrateOptions,\n };\n}\n","import type { PersistedClient } from \"@tanstack/react-query-persist-client\";\n\n/**\n * Serializes a PersistedClient to a JSON string.\n * Converts Map instances to plain objects for localStorage compatibility.\n */\nexport function serialize(data: PersistedClient): string {\n return JSON.stringify(data, (_key, value) => {\n if (value instanceof Map) return Object.fromEntries(value);\n return value;\n });\n}\n\n/**\n * Deserializes a JSON string back to a PersistedClient.\n */\nexport function deserialize(data: string): PersistedClient {\n return JSON.parse(data) as PersistedClient;\n}\n","import type { PersistedClient } from \"@tanstack/react-query-persist-client\";\n\ninterface QueryEntry {\n queryKey: readonly unknown[];\n queryHash: string;\n state: { dataUpdatedAt?: number };\n}\n\n/**\n * Applies per-key-prefix LRU limits to the queries in a PersistedClient.\n * For each prefix in `limits`, keeps only the N most-recently-updated queries.\n * Returns a shallow copy with trimmed queries; does not mutate the input.\n */\nexport function applyLimits(\n data: PersistedClient,\n limits: Record<string, number>,\n): PersistedClient {\n const queries = data.clientState?.queries;\n if (!queries || Object.keys(limits).length === 0) return data;\n\n const entries = queries as unknown as QueryEntry[];\n const unlimited: QueryEntry[] = [];\n const groups = new Map<string, QueryEntry[]>();\n\n for (const q of entries) {\n const prefix = Array.isArray(q.queryKey) ? q.queryKey[0] : undefined;\n if (typeof prefix === \"string\" && prefix in limits) {\n const group = groups.get(prefix) ?? [];\n group.push(q);\n groups.set(prefix, group);\n } else {\n unlimited.push(q);\n }\n }\n\n const kept: QueryEntry[] = [];\n for (const [prefix, group] of groups) {\n const limit = limits[prefix]!;\n const sorted = [...group].sort(\n (a, b) => (b.state.dataUpdatedAt ?? 0) - (a.state.dataUpdatedAt ?? 0),\n );\n kept.push(...sorted.slice(0, limit));\n }\n\n return {\n ...data,\n clientState: {\n ...data.clientState,\n queries: [...unlimited, ...kept] as unknown as typeof queries,\n },\n };\n}\n","import type { Persister, PersistedClient } from \"@tanstack/react-query-persist-client\";\nimport type { PersistenceConfig } from \"../types\";\nimport { serialize, deserialize } from \"./serializer\";\nimport { applyLimits } from \"./apply-limits\";\n\n/** No-op persister for SSR environments where localStorage is unavailable. */\nconst noopPersister: Persister = {\n persistClient: async () => {},\n restoreClient: async () => undefined,\n removeClient: async () => {},\n};\n\n/**\n * Creates an SSR-safe localStorage persister with throttled writes and LRU limiting.\n *\n * On the server (typeof window === \"undefined\"), returns a no-op persister.\n * On the client, writes are throttled to avoid performance degradation.\n */\nexport function createPersister(config: PersistenceConfig): Persister {\n if (typeof window === \"undefined\") return noopPersister;\n\n const throttleMs = config.throttleMs ?? 1000;\n const limits = config.limits ?? {};\n let timer: ReturnType<typeof setTimeout> | undefined;\n // The latest client handed to persistClient. Only the timer reads it, and persistClient\n // sets it before it starts the timer, so it is always assigned when read.\n let pending!: PersistedClient;\n\n function write(client: PersistedClient) {\n try {\n const limited = applyLimits(client, limits);\n window.localStorage.setItem(config.key, serialize(limited));\n } catch {\n /* quota exceeded — silently skip */\n }\n }\n\n return {\n persistClient(client: PersistedClient) {\n pending = client;\n if (!timer) {\n timer = setTimeout(() => {\n timer = undefined;\n write(pending);\n }, throttleMs);\n }\n },\n\n restoreClient() {\n try {\n const raw = window.localStorage.getItem(config.key);\n if (!raw) return undefined;\n return deserialize(raw);\n } catch {\n return undefined;\n }\n },\n\n removeClient() {\n window.localStorage.removeItem(config.key);\n },\n };\n}\n","import { useEffect } from \"react\";\nimport { useLatest } from \"../hooks/use-latest\";\nimport type { PersistenceConfig } from \"../types\";\n\nconst CHECK_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * Monitors total localStorage size and evicts limited query families\n * when the threshold is exceeded.\n *\n * Eviction strategy: remove queries whose key prefix appears in `limits`,\n * starting with the largest family. If parsing fails, clears the entire\n * persistence key as a fallback.\n */\nexport function useStorageMonitor(config: PersistenceConfig): void {\n const { key, limits = {}, maxStorageMB = 3 } = config;\n // A new array each render: the effect restarts when the number of limited families\n // changes, and takes the keys as of that render.\n const limitKeysRef = useLatest(Object.keys(limits));\n const limitCount = limitKeysRef.current.length;\n\n useEffect(() => {\n const limitKeys = limitKeysRef.current;\n if (typeof window === \"undefined\" || limitKeys.length === 0) return;\n\n function evict() {\n const storage = window.localStorage;\n let totalSize = 0;\n\n for (const k of Object.keys(storage)) {\n const v = storage.getItem(k);\n if (v) totalSize += k.length + v.length;\n }\n\n // UTF-16: each char = 2 bytes\n const usedMB = (totalSize * 2) / 1024 / 1024;\n if (usedMB <= maxStorageMB) return;\n\n try {\n const raw = storage.getItem(key);\n if (!raw) return;\n const parsed = JSON.parse(raw);\n if (!parsed.clientState?.queries) return;\n\n // Remove all queries whose prefix is in limits\n parsed.clientState.queries = parsed.clientState.queries.filter(\n (q: { queryKey?: unknown[] }) => {\n if (!Array.isArray(q.queryKey)) return true;\n const prefix = q.queryKey[0];\n return typeof prefix !== \"string\" || !limitKeys.includes(prefix);\n },\n );\n\n storage.setItem(key, JSON.stringify(parsed));\n } catch {\n // Corrupted data — clear entirely\n storage.removeItem(key);\n }\n }\n\n evict();\n const id = setInterval(evict, CHECK_INTERVAL_MS);\n return () => clearInterval(id);\n }, [key, maxStorageMB, limitCount, limitKeysRef]);\n}\n"],"mappings":"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","names":["useMemo","useMemo","useEffect","useState","useEffect","useMemo","useQuery","useQueryClient","useQueryClient","useMemo","useEffect","useQuery","useMemo","cleanMoney","cleanMoney","useMemo","useQueryClient","useCallback","useState","useEffect","useMemo","useEffect","useEffect","useState","useEffect","useMemo"]}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { PersistedClient } from "@tanstack/react-query-persist-client";
|
|
2
|
+
/**
|
|
3
|
+
* Applies per-key-prefix LRU limits to the queries in a PersistedClient.
|
|
4
|
+
* For each prefix in `limits`, keeps only the N most-recently-updated queries.
|
|
5
|
+
* Returns a shallow copy with trimmed queries; does not mutate the input.
|
|
6
|
+
*/
|
|
7
|
+
export declare function applyLimits(data: PersistedClient, limits: Record<string, number>): PersistedClient;
|
|
8
|
+
//# sourceMappingURL=apply-limits.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apply-limits.d.ts","sourceRoot":"","sources":["../../src/persistence/apply-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAQ5E;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,eAAe,CAmCjB"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Persister } from "@tanstack/react-query-persist-client";
|
|
2
|
+
import type { PersistenceConfig } from "../types";
|
|
3
|
+
/**
|
|
4
|
+
* Creates an SSR-safe localStorage persister with throttled writes and LRU limiting.
|
|
5
|
+
*
|
|
6
|
+
* On the server (typeof window === "undefined"), returns a no-op persister.
|
|
7
|
+
* On the client, writes are throttled to avoid performance degradation.
|
|
8
|
+
*/
|
|
9
|
+
export declare function createPersister(config: PersistenceConfig): Persister;
|
|
10
|
+
//# sourceMappingURL=create-persister.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-persister.d.ts","sourceRoot":"","sources":["../../src/persistence/create-persister.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAWlD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CA4CpE"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { PersistedClient } from "@tanstack/react-query-persist-client";
|
|
2
|
+
/**
|
|
3
|
+
* Serializes a PersistedClient to a JSON string.
|
|
4
|
+
* Converts Map instances to plain objects for localStorage compatibility.
|
|
5
|
+
*/
|
|
6
|
+
export declare function serialize(data: PersistedClient): string;
|
|
7
|
+
/**
|
|
8
|
+
* Deserializes a JSON string back to a PersistedClient.
|
|
9
|
+
*/
|
|
10
|
+
export declare function deserialize(data: string): PersistedClient;
|
|
11
|
+
//# sourceMappingURL=serializer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/persistence/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEzD"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { PersistenceConfig } from "../types";
|
|
2
|
+
/**
|
|
3
|
+
* Version of the persisted query-data format, prefixed to every buster.
|
|
4
|
+
* Bump it when the shape the proxies resolve to changes, so caches written by
|
|
5
|
+
* older package versions are discarded without each site bumping its own buster.
|
|
6
|
+
* "augur-2": the direct-SDK options proxy unwraps BaseResponse (2.5.0).
|
|
7
|
+
*/
|
|
8
|
+
export declare const PERSISTED_DATA_FORMAT = "augur-2";
|
|
9
|
+
/**
|
|
10
|
+
* Returns a fully configured `persistOptions` object for use with
|
|
11
|
+
* `PersistQueryClientProvider` from `@tanstack/react-query-persist-client`.
|
|
12
|
+
*
|
|
13
|
+
* Handles:
|
|
14
|
+
* - SSR-safe persister creation (no-op on server)
|
|
15
|
+
* - Map → Record serialization for localStorage compatibility
|
|
16
|
+
* - Selective persistence (only successful queries matching persistableKeys)
|
|
17
|
+
* - Per-key-prefix LRU eviction (via `limits`)
|
|
18
|
+
* - Throttled writes to localStorage
|
|
19
|
+
* - Hydration safety (maxAge: 0 until client mount)
|
|
20
|
+
* - Storage monitoring with automatic eviction when over threshold
|
|
21
|
+
* - Dev mode auto-buster (invalidates cache on each restart)
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```tsx
|
|
25
|
+
* import { useAugurPersistence } from "@simpleapps-com/augur-hooks";
|
|
26
|
+
*
|
|
27
|
+
* function Providers({ children }) {
|
|
28
|
+
* const [queryClient] = useState(() => new QueryClient({ ... }));
|
|
29
|
+
* const persistOptions = useAugurPersistence({
|
|
30
|
+
* key: "my-site-cache",
|
|
31
|
+
* buster: "1.0.0",
|
|
32
|
+
* persistableKeys: ["price", "categories", "invMast"],
|
|
33
|
+
* limits: { invMast: 100 },
|
|
34
|
+
* });
|
|
35
|
+
*
|
|
36
|
+
* return (
|
|
37
|
+
* <PersistQueryClientProvider client={queryClient} persistOptions={persistOptions}>
|
|
38
|
+
* <augur.Provider api={api} auth={auth}>
|
|
39
|
+
* {children}
|
|
40
|
+
* </augur.Provider>
|
|
41
|
+
* </PersistQueryClientProvider>
|
|
42
|
+
* );
|
|
43
|
+
* }
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export declare function useAugurPersistence(config: PersistenceConfig): {
|
|
47
|
+
persister: import("@tanstack/react-query-persist-client").Persister;
|
|
48
|
+
maxAge: number;
|
|
49
|
+
buster: string;
|
|
50
|
+
dehydrateOptions: {
|
|
51
|
+
shouldDehydrateQuery: (query: {
|
|
52
|
+
queryKey: readonly unknown[];
|
|
53
|
+
state: {
|
|
54
|
+
status: string;
|
|
55
|
+
};
|
|
56
|
+
}) => boolean;
|
|
57
|
+
};
|
|
58
|
+
};
|
|
59
|
+
//# sourceMappingURL=use-persistence.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-persistence.d.ts","sourceRoot":"","sources":["../../src/persistence/use-persistence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIlD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB;;;;;sCAgBzB;YAC5B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;YAC7B,KAAK,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;SAC3B;;EAmBN"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { PersistenceConfig } from "../types";
|
|
2
|
+
/**
|
|
3
|
+
* Monitors total localStorage size and evicts limited query families
|
|
4
|
+
* when the threshold is exceeded.
|
|
5
|
+
*
|
|
6
|
+
* Eviction strategy: remove queries whose key prefix appears in `limits`,
|
|
7
|
+
* starting with the largest family. If parsing fails, clears the entire
|
|
8
|
+
* persistence key as a fallback.
|
|
9
|
+
*/
|
|
10
|
+
export declare function useStorageMonitor(config: PersistenceConfig): void;
|
|
11
|
+
//# sourceMappingURL=use-storage-monitor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"use-storage-monitor.d.ts","sourceRoot":"","sources":["../../src/persistence/use-storage-monitor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIlD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAkDjE"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
import type { AugurAuthContext, AugurSiteConfig, CacheConfig, DeepQueryOptions } from "@simpleapps-com/augur-core";
|
|
3
|
+
import type { AugurAPI } from "@simpleapps-com/augur-api";
|
|
4
|
+
/** The augur-api SDK instance, as `useAugurApi()` returns it (the SDK is a peer dependency). */
|
|
5
|
+
export type AugurApiClient = AugurAPI;
|
|
6
|
+
interface AugurHooksProviderProps {
|
|
7
|
+
/** SDK client instance. When omitted, `useAugurOptions()` returns a keys-only
|
|
8
|
+
* proxy — consumers MUST override queryFn with a server action at each call site.
|
|
9
|
+
* Any object is accepted (a site's test double included); hooks read it as the SDK. */
|
|
10
|
+
api?: object;
|
|
11
|
+
/** Optional auth context — hooks fall back to these values when not passed directly. */
|
|
12
|
+
auth?: AugurAuthContext;
|
|
13
|
+
/** Optional cache configuration — controls edge and Redis caching per tier. */
|
|
14
|
+
cache?: CacheConfig;
|
|
15
|
+
/** Optional site configuration — hooks read defaults and formatting from this. */
|
|
16
|
+
site?: AugurSiteConfig;
|
|
17
|
+
children: ReactNode;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Provides the augur-api SDK instance, proxy options, and auth to all hooks.
|
|
21
|
+
*
|
|
22
|
+
* ```tsx
|
|
23
|
+
* <AugurHooksProvider api={api} auth={authContext} cache={cacheConfig}>
|
|
24
|
+
* <App />
|
|
25
|
+
* </AugurHooksProvider>
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* Components use `useAugurOptions()` to get the proxy:
|
|
29
|
+
* ```tsx
|
|
30
|
+
* const q = useAugurOptions();
|
|
31
|
+
* const { data } = useQuery(q.items.invMast.get(42));
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
export declare function AugurHooksProvider({ api, auth, cache, site, children }: AugurHooksProviderProps): import("react").JSX.Element;
|
|
35
|
+
/**
|
|
36
|
+
* Returns the deep proxy for creating TanStack Query options.
|
|
37
|
+
*
|
|
38
|
+
* When an `api` prop is provided to the provider, every path returns
|
|
39
|
+
* full query options (queryKey, queryFn, staleTime, gcTime).
|
|
40
|
+
*
|
|
41
|
+
* When no `api` is provided (server-only JWT sites), returns a keys-only
|
|
42
|
+
* proxy — queryKey, staleTime, and gcTime are generated normally, but
|
|
43
|
+
* queryFn throws unless overridden. This lets B2B sites use the proxy
|
|
44
|
+
* for deterministic keys and cache tiers while routing data through
|
|
45
|
+
* server actions.
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* ```tsx
|
|
49
|
+
* // With api (direct SDK access):
|
|
50
|
+
* const q = useAugurOptions();
|
|
51
|
+
* const { data } = useQuery(q.items.invMast.get(42));
|
|
52
|
+
*
|
|
53
|
+
* // Without api (server-only JWT):
|
|
54
|
+
* const q = useAugurOptions();
|
|
55
|
+
* const { data } = useQuery({
|
|
56
|
+
* ...q.items.invMast.doc.get(42),
|
|
57
|
+
* queryFn: () => getItemAction(42), // server action
|
|
58
|
+
* });
|
|
59
|
+
* ```
|
|
60
|
+
*/
|
|
61
|
+
export declare function useAugurOptions<T = DeepQueryOptions<AugurAPI>>(): T;
|
|
62
|
+
/**
|
|
63
|
+
* Returns the augur-api SDK instance from context, or null if not provided.
|
|
64
|
+
* Used internally by hooks that need the SDK for fallback queries.
|
|
65
|
+
*/
|
|
66
|
+
export declare function useAugurApiOptional(): AugurApiClient | null;
|
|
67
|
+
/**
|
|
68
|
+
* Returns the augur-api SDK instance from context.
|
|
69
|
+
* Throws if called outside of `<AugurHooksProvider>` or when no api is provided.
|
|
70
|
+
*/
|
|
71
|
+
export declare function useAugurApi(): AugurApiClient;
|
|
72
|
+
/**
|
|
73
|
+
* Returns the provider-level auth context, if any.
|
|
74
|
+
* Used internally by hooks to fall back to provider auth when
|
|
75
|
+
* auth fields are not passed directly as hook parameters.
|
|
76
|
+
*/
|
|
77
|
+
export declare function useAugurAuth(): AugurAuthContext | undefined;
|
|
78
|
+
/**
|
|
79
|
+
* Returns the provider-level cache configuration, if any.
|
|
80
|
+
* Used internally by hooks to enable edge/Redis caching.
|
|
81
|
+
*/
|
|
82
|
+
export declare function useAugurCache(): CacheConfig | undefined;
|
|
83
|
+
/**
|
|
84
|
+
* Returns the site configuration from the nearest `AugurHooksProvider`.
|
|
85
|
+
* Returns `undefined` when no `site` prop is provided.
|
|
86
|
+
*/
|
|
87
|
+
export declare function useAugurSite(): AugurSiteConfig | undefined;
|
|
88
|
+
export {};
|
|
89
|
+
//# sourceMappingURL=provider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D,gGAAgG;AAChG,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,UAAU,uBAAuB;IAC/B;;4FAEwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,uBAAuB,+BA2B/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CASnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAS5C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,GAAG,SAAS,CAE3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,WAAW,GAAG,SAAS,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,eAAe,GAAG,SAAS,CAE1D"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { QueryClient } from "@tanstack/react-query";
|
|
2
|
+
export interface BatchQueryConfig<TParam, TData> {
|
|
3
|
+
params: TParam[];
|
|
4
|
+
queryClient: QueryClient;
|
|
5
|
+
/** Build individual cache key for a single param. */
|
|
6
|
+
getItemKey: (param: TParam) => readonly unknown[];
|
|
7
|
+
/** Build the string key for the result Record from a param. */
|
|
8
|
+
getResultKey: (param: TParam) => string;
|
|
9
|
+
/** Fetch only uncached items, return keyed Record. */
|
|
10
|
+
fetchItems: (uncached: TParam[]) => Promise<Record<string, TData>>;
|
|
11
|
+
/** Extract individual cache key from a fetched result entry (for seeding). */
|
|
12
|
+
getSeedKey: (resultKey: string, data: TData) => readonly unknown[];
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Generic batch query executor.
|
|
16
|
+
*
|
|
17
|
+
* 1. Checks queryClient cache for each param
|
|
18
|
+
* 2. Fetches only uncached items in a single batch call
|
|
19
|
+
* 3. Seeds individual cache entries from the response
|
|
20
|
+
* 4. Returns merged cached + fetched record
|
|
21
|
+
*/
|
|
22
|
+
export declare function executeBatchQuery<TParam, TData>(config: BatchQueryConfig<TParam, TData>): Promise<Record<string, TData>>;
|
|
23
|
+
//# sourceMappingURL=batch-query.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"batch-query.d.ts","sourceRoot":"","sources":["../../src/queries/batch-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,KAAK;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,qDAAqD;IACrD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,CAAC;IAClD,+DAA+D;IAC/D,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,sDAAsD;IACtD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnE,8EAA8E;IAC9E,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,OAAO,EAAE,CAAC;CACpE;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EACnD,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CA8BhC"}
|