@simpleapps-com/augur-hooks 2.2.21 → 2.2.23

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/dist/index.js CHANGED
@@ -7,18 +7,23 @@ import {
7
7
  registerQueryAction
8
8
  } from "./chunk-GHON6UMJ.js";
9
9
  import {
10
+ clearCheckoutPersistence,
11
+ clearFromSession,
10
12
  determineOrderReadiness,
13
+ loadFromSession,
14
+ saveToSession,
11
15
  useCartHdrUid,
12
16
  useCartLineCount,
13
17
  useCartLines,
14
18
  useCartQuantityTotal,
15
19
  useCartStore,
20
+ useCheckoutPersistence,
16
21
  useClearCart,
17
22
  useOrderReadiness,
18
23
  usePaymentFlow,
19
24
  useSetCartHdrUid,
20
25
  useSetCartLines
21
- } from "./chunk-ONB6O35U.js";
26
+ } from "./chunk-5YN2RPZ4.js";
22
27
 
23
28
  // src/provider.tsx
24
29
  import { createContext, useContext, useMemo } from "react";
@@ -403,68 +408,8 @@ function useModalLifecycle(isOpen, onClose) {
403
408
  return { isClient };
404
409
  }
405
410
 
406
- // src/hooks/use-checkout-persistence.ts
407
- import { useEffect as useEffect3, useRef } from "react";
408
- var DEFAULT_TTL = 30 * 60 * 1e3;
409
- function saveToSession(key, value) {
410
- try {
411
- const entry = { value, savedAt: Date.now() };
412
- sessionStorage.setItem(key, JSON.stringify(entry));
413
- } catch {
414
- }
415
- }
416
- function loadFromSession(key, ttl = DEFAULT_TTL, validate) {
417
- try {
418
- const raw = sessionStorage.getItem(key);
419
- if (!raw) return null;
420
- const entry = JSON.parse(raw);
421
- if (Date.now() - entry.savedAt > ttl) {
422
- sessionStorage.removeItem(key);
423
- return null;
424
- }
425
- if (validate) {
426
- return validate(entry.value);
427
- }
428
- return entry.value;
429
- } catch {
430
- sessionStorage.removeItem(key);
431
- return null;
432
- }
433
- }
434
- function clearFromSession(key) {
435
- try {
436
- sessionStorage.removeItem(key);
437
- } catch {
438
- }
439
- }
440
- function useCheckoutPersistence(fields) {
441
- const fieldsRef = useRef(fields);
442
- fieldsRef.current = fields;
443
- useEffect3(() => {
444
- for (const field of fieldsRef.current) {
445
- const restored = loadFromSession(field.key, field.ttl ?? DEFAULT_TTL, field.validate);
446
- if (restored !== null) {
447
- field.set(restored);
448
- }
449
- }
450
- }, []);
451
- const serialized = JSON.stringify(fields.map((f) => [f.key, f.value]));
452
- useEffect3(() => {
453
- for (const field of fields) {
454
- if (field.value !== void 0 && field.value !== null) {
455
- saveToSession(field.key, field.value);
456
- }
457
- }
458
- }, [serialized]);
459
- }
460
- function clearCheckoutPersistence(keys) {
461
- for (const key of keys) {
462
- clearFromSession(key);
463
- }
464
- }
465
-
466
411
  // src/hooks/use-cart-initialization.ts
467
- import { useEffect as useEffect4, useMemo as useMemo3, useRef as useRef2 } from "react";
412
+ import { useEffect as useEffect3, useMemo as useMemo3, useRef } from "react";
468
413
  import { useQuery as useQuery2, useQueryClient as useQueryClient2 } from "@tanstack/react-query";
469
414
  var MAX_RETRY_ATTEMPTS = 7;
470
415
  var RETRY_DELAY_MS = 1e3;
@@ -488,10 +433,10 @@ function useCartInitialization(session, callbacks) {
488
433
  () => ({ status: effectiveStatus, userId: effectiveUserId, cartHdrUid: effectiveCartHdrUid }),
489
434
  [effectiveStatus, effectiveUserId, effectiveCartHdrUid]
490
435
  );
491
- const retryCountRef = useRef2(0);
492
- const isInitializingRef = useRef2(false);
493
- const prevStatusRef = useRef2(effectiveSession.status);
494
- useEffect4(() => {
436
+ const retryCountRef = useRef(0);
437
+ const isInitializingRef = useRef(false);
438
+ const prevStatusRef = useRef(effectiveSession.status);
439
+ useEffect3(() => {
495
440
  const prevStatus = prevStatusRef.current;
496
441
  prevStatusRef.current = effectiveSession.status;
497
442
  if (prevStatus === "authenticated" && effectiveSession.status === "unauthenticated") {
@@ -500,7 +445,7 @@ function useCartInitialization(session, callbacks) {
500
445
  queryClient.removeQueries({ queryKey: ["cart-also-bought"] });
501
446
  }
502
447
  }, [effectiveSession.status, clearCart, queryClient]);
503
- useEffect4(() => {
448
+ useEffect3(() => {
504
449
  if (cartHdrUid || effectiveSession.status === "loading") return;
505
450
  if (effectiveSession.cartHdrUid && effectiveSession.status === "authenticated") {
506
451
  setCartHdrUid(effectiveSession.cartHdrUid);
@@ -557,7 +502,7 @@ function useCartInitialization(session, callbacks) {
557
502
  queryFn: async () => await callbacks.getCartLines(Number(cartHdrUid)) ?? [],
558
503
  enabled: !!cartHdrUid
559
504
  });
560
- useEffect4(() => {
505
+ useEffect3(() => {
561
506
  if (cartLinesData) {
562
507
  setCartLines(cartLinesData);
563
508
  }
@@ -699,7 +644,7 @@ var usePaginationPrefetch = ({
699
644
  };
700
645
 
701
646
  // src/persistence/use-persistence.ts
702
- import { useState as useState3, useEffect as useEffect6, useMemo as useMemo5 } from "react";
647
+ import { useState as useState3, useEffect as useEffect5, useMemo as useMemo5 } from "react";
703
648
 
704
649
  // src/persistence/serializer.ts
705
650
  function serialize(data) {
@@ -795,12 +740,12 @@ function createPersister(config) {
795
740
  }
796
741
 
797
742
  // src/persistence/use-storage-monitor.ts
798
- import { useEffect as useEffect5 } from "react";
743
+ import { useEffect as useEffect4 } from "react";
799
744
  var CHECK_INTERVAL_MS = 5 * 60 * 1e3;
800
745
  function useStorageMonitor(config) {
801
746
  const { key, limits = {}, maxStorageMB = 3 } = config;
802
747
  const limitKeys = Object.keys(limits);
803
- useEffect5(() => {
748
+ useEffect4(() => {
804
749
  if (typeof window === "undefined" || limitKeys.length === 0) return;
805
750
  function evict() {
806
751
  const storage = window.localStorage;
@@ -838,7 +783,7 @@ function useStorageMonitor(config) {
838
783
  function useAugurPersistence(config) {
839
784
  const [persister] = useState3(() => createPersister(config));
840
785
  const [isMounted, setIsMounted] = useState3(false);
841
- useEffect6(() => {
786
+ useEffect5(() => {
842
787
  setIsMounted(true);
843
788
  }, []);
844
789
  useStorageMonitor(config);
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-checkout-persistence.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\n// Keep legacy exports for backward compat (api-based sites still use these)\nexport { getStockKey, getStockOptions } from \"../queries/stock\";\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","\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\n/** A single persisted field with its storage key and optional TTL. */\nexport interface CheckoutPersistField<T> {\n key: string;\n value: T;\n set: (value: T) => void;\n /** Valibot or custom validator. Return the parsed value or throw to reject. */\n validate?: (raw: unknown) => T;\n /** TTL in milliseconds. Default: 30 minutes. */\n ttl?: number;\n}\n\ninterface StorageEntry {\n value: unknown;\n savedAt: number;\n}\n\nconst DEFAULT_TTL = 30 * 60 * 1000; // 30 minutes\n\n/**\n * Saves a value to sessionStorage with a timestamp for TTL expiration.\n *\n * Fails silently on storage errors (private browsing, quota exceeded).\n */\nexport function saveToSession(key: string, value: unknown): void {\n try {\n const entry: StorageEntry = { value, savedAt: Date.now() };\n sessionStorage.setItem(key, JSON.stringify(entry));\n } catch {\n // sessionStorage unavailable (private browsing, quota)\n }\n}\n\n/**\n * Loads a value from sessionStorage, checking TTL and optionally validating.\n *\n * Returns null if missing, expired, invalid, or storage is unavailable.\n * Cleans up expired entries automatically.\n */\nexport function loadFromSession<T>(\n key: string,\n ttl: number = DEFAULT_TTL,\n validate?: (raw: unknown) => T,\n): T | null {\n try {\n const raw = sessionStorage.getItem(key);\n if (!raw) return null;\n\n const entry = JSON.parse(raw) as StorageEntry;\n if (Date.now() - entry.savedAt > ttl) {\n sessionStorage.removeItem(key);\n return null;\n }\n\n if (validate) {\n return validate(entry.value);\n }\n return entry.value as T;\n } catch {\n sessionStorage.removeItem(key);\n return null;\n }\n}\n\n/** Removes a checkout persistence key from sessionStorage. */\nexport function clearFromSession(key: string): void {\n try {\n sessionStorage.removeItem(key);\n } catch {\n // ignore\n }\n}\n\n/**\n * Hook that persists checkout state fields to sessionStorage and restores on mount.\n *\n * Each field is saved when its value changes and restored once on initial mount.\n * Validates restored values against an optional schema to guard against\n * corrupted or stale storage. Expired entries (past TTL) are discarded.\n */\nexport function useCheckoutPersistence(fields: CheckoutPersistField<unknown>[]): void {\n // Restore on mount (once). Capture fields in a ref so the effect has no deps.\n const fieldsRef = useRef(fields);\n fieldsRef.current = fields;\n\n useEffect(() => {\n for (const field of fieldsRef.current) {\n const restored = loadFromSession(field.key, field.ttl ?? DEFAULT_TTL, field.validate);\n if (restored !== null) {\n field.set(restored);\n }\n }\n }, []);\n\n // Save on change -- serialized values as dependency to avoid dynamic dep arrays\n const serialized = JSON.stringify(fields.map((f) => [f.key, f.value]));\n useEffect(() => {\n for (const field of fields) {\n if (field.value !== undefined && field.value !== null) {\n saveToSession(field.key, field.value);\n }\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [serialized]);\n}\n\n/**\n * Clears all checkout persistence keys from sessionStorage.\n *\n * Call after successful order submission to prevent stale data on next checkout.\n */\nexport function clearCheckoutPersistence(keys: string[]): void {\n for (const key of keys) {\n clearFromSession(key);\n }\n}\n","import { 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\n// Keep legacy exports for backward compat (api-based sites still use these)\nexport { getCartPricingQueryOptions } from \"../queries/cart-pricing\";\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":";;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,eAAe,YAAY,eAA+B;AAOnE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAiEK;AAvCZ,IAAM,kBAAkB,cAAqC,IAAI;AACjE,IAAM,wBAAwB,cAA4C,MAAS;AACnF,IAAM,oBAAoB,cAAuC,MAAS;AAC1E,IAAM,sBAAsB,cAAuB,IAAI;AACvD,IAAM,mBAAmB,cAA2C,MAAS;AAiBtE,SAAS,mBAAmB,EAAE,KAAK,MAAM,OAAO,MAAM,SAAS,GAA4B;AAChG,QAAM,cAA8C,QAChD,EAAE,OAAO,EAAE,QAAQ,MAAM,QAAQ,YAAY,MAAM,WAAW,EAAE,IAChE;AAEJ,QAAM,UAAU,QAAQ,MAAM;AAC5B,QAAI,IAAK,QAAO,mBAAmB,KAAK,WAAW;AACnD,UAAM,mBAAmB,yBAAyB;AAClD,QAAI,iBAAkB,QAAO,uBAAuB,kBAAkB,WAAW;AACjF,WAAO,oBAAoB,WAAW;AAAA,EAExC,GAAG,CAAC,GAAG,CAAC;AAER,SACE,oBAAC,gBAAgB,UAAhB,EAAyB,OAAO,OAAO,MACtC,8BAAC,sBAAsB,UAAtB,EAA+B,OAAO,MACrC,8BAAC,kBAAkB,UAAlB,EAA2B,OAAO,OACjC,8BAAC,iBAAiB,UAAjB,EAA0B,OAAO,MAChC,8BAAC,oBAAoB,UAApB,EAA6B,OAAO,SAAU,UAAS,GAC1D,GACF,GACF,GACF;AAEJ;AA4BO,SAAS,kBAAqD;AACnE,QAAM,UAAU,WAAW,mBAAmB;AAC9C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,sBAA6C;AAC3D,SAAO,WAAW,eAAe;AACnC;AAMO,SAAS,cAA8B;AAC5C,QAAM,MAAM,WAAW,eAAe;AACtC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,eAA6C;AAC3D,SAAO,WAAW,qBAAqB;AACzC;AAMO,SAAS,gBAAyC;AACvD,SAAO,WAAW,iBAAiB;AACrC;AAMO,SAAS,eAA4C;AAC1D,SAAO,WAAW,gBAAgB;AACpC;;;ACvKA,SAAS,cAAc;AACvB,SAAS,gBAAgB;AAIzB,IAAM,uBAAsC;AAAA,EAC1C,SAAS,CAAC;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,GAAG;AAAA,EACH,MAAM;AACR;AAaO,IAAM,sBAAsB,OAA0B;AAAA,EAC3D;AAAA,IACE,CAAC,SAAS;AAAA,MACR,qBAAqB;AAAA,MACrB,cAAc;AAAA,MACd,iBAAiB,CAAC,UAAU,IAAI,EAAE,cAAc,MAAM,GAAG,OAAO,iBAAiB;AAAA,IACnF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS,QAAQ,IAAI,UAAU,MAAM;AAAA,IACvC;AAAA,EACF;AACF;;;ACrCA,SAAS,WAAW,gBAAgB;AAM7B,SAAS,YAAe,OAAU,QAAgB,KAAQ;AAC/D,QAAM,CAAC,gBAAgB,iBAAiB,IAAI,SAAY,KAAK;AAE7D,YAAU,MAAM;AACd,UAAM,UAAU,WAAW,MAAM;AAC/B,wBAAkB,KAAK;AAAA,IACzB,GAAG,KAAK;AAER,WAAO,MAAM;AACX,mBAAa,OAAO;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,OAAO,KAAK,CAAC;AAEjB,SAAO;AACT;;;ACGA,SAAS,iBACP,iBACA,gBACuB;AACvB,MAAI,OAAO,oBAAoB,UAAU;AACvC,WAAO,EAAE,QAAQ,iBAAiB,UAAU,eAAe;AAAA,EAC7D;AACA,SAAO,mBAAmB,CAAC;AAC7B;AAEA,SAAS,kBACP,MACA,gBACA;AACA,SAAO;AAAA,IACL,QAAQ,KAAK,UAAU,gBAAgB,UAAU;AAAA,IACjD,UAAU,KAAK,YAAY,gBAAgB,YAAY;AAAA,IACvD,WAAW,KAAK,aAAa,gBAAgB,aAAa;AAAA,IAC1D,WAAW,KAAK,aAAa,gBAAgB;AAAA,EAC/C;AACF;AASO,SAAS,eACd,iBACA,gBACA;AACA,QAAM,OAAO,aAAa;AAC1B,QAAM,OAAO,iBAAiB,iBAAiB,cAAc;AAC7D,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX;AAAA,EACF,IAAI,kBAAkB,MAAM,MAAM,UAAU;AAE5C,QAAM,cAAc,CAAC,OAAe,gBAAiD;AACnF,UAAM,iBAAiB,SAAS,aAAa,YAAY;AAEzD,QAAI,mBAAmB,KAAK,cAAc,QAAW;AACnD,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,aAAa,aAAa;AAE5C,WAAO,IAAI,KAAK,aAAa,QAAQ;AAAA,MACnC,OAAO;AAAA,MACP;AAAA,MACA,uBAAuB;AAAA,MACvB,uBAAuB;AAAA,IACzB,CAAC,EAAE,OAAO,cAAc;AAAA,EAC1B;AAEA,SAAO,EAAE,YAAY;AACvB;;;ACnFA,SAAS,WAAAA,gBAAe;AACxB,SAAS,gBAAgB;AAEzB,SAAS,oBAAoB;AA4BtB,SAAS,SAAS,YAA6B,UAA2B,CAAC,GAAG;AAEnF,QAAM,QAAQ,gBAAqB;AAEnC,QAAM,kBAAkB,QAAQ;AAGhC,QAAM,YAAY,MAAM,MAAM,QAAQ,MAAM,IAAI,OAAO,UAAU,CAAC;AAElE,QAAM,QAAQ,SAAS;AAAA,IACrB,GAAG;AAAA,IACH,GAAI,kBAAkB,EAAE,SAAS,gBAAgB,IAAI,CAAC;AAAA,IACtD,UAAU,QAAQ,WAAW,SAAS,CAAC,CAAC;AAAA,IACxC,OAAO;AAAA;AAAA,IAEP,YAAY,CAAC,iBAAyB,KAAK,IAAI,MAAO,KAAK,cAAc,GAAK;AAAA;AAAA,EAEhF,CAAC;AAED,QAAM,YAAYC,SAAQ,MAAM;AAC9B,UAAM,UAAU,MAAM;AACtB,QAAI,CAAC,QAAS,QAAO;AAErB,UAAM,QAAS,QAA+B,QAAQ;AACtD,UAAM,QAAQ;AACd,WAAO;AAAA,MACL,WAAW,MAAM,aAAa,CAAC;AAAA,MAC/B,gBAAgB,MAAM,kBAAkB,CAAC;AAAA,IAC3C;AAAA,EACF,GAAG,CAAC,MAAM,IAAI,CAAC;AAEf,QAAM,WAAWA;AAAA,IACf,MACE,aAAa;AAAA,MACX,OAAO;AAAA,MACP,YAAY,QAAQ;AAAA,MACpB,OAAO,QAAQ;AAAA,MACf,mBAAmB,QAAQ;AAAA,MAC3B,cAAc,QAAQ;AAAA,IACxB,CAAC;AAAA,IACH,CAAC,WAAW,QAAQ,YAAY,QAAQ,OAAO,QAAQ,mBAAmB,QAAQ,YAAY;AAAA,EAChG;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP;AAAA,IACA,SAAS,MAAM;AAAA,IACf,OAAO,MAAM;AAAA,EACf;AACF;;;AChFA,SAAS,mBAAmB;AAC5B,SAAS,sBAAsB;AAuC/B,SAAS,eAAe,YAAiD;AACvE,QAAM,MAAM,OAAO,eAAe,WAAW,OAAO,UAAU,IAAI;AAClE,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,qBAAqB;AAC/C,SAAO;AACT;AAEA,SAAS,mBACP,WACA,MACA,YACA,QACa;AACb,QAAM,gBAAgB,UAAU,UAAU,CAAC,SAAS,KAAK,eAAe,KAAK,UAAU;AAEvF,MAAI,iBAAiB,GAAG;AACtB,WAAO,UAAU;AAAA,MAAI,CAAC,MAAM,UAC1B,UAAU,gBAAgB,EAAE,GAAG,MAAM,UAAU,KAAK,WAAW,KAAK,SAAS,IAAI;AAAA,IACnF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,MACE;AAAA,MACA,YAAY,KAAK;AAAA,MACjB,iBAAiB;AAAA,MACjB,YAAY;AAAA,MACZ;AAAA,MACA,QAAQ,UAAU,SAAS;AAAA,MAC3B,UAAU;AAAA,MACV,UAAU,KAAK;AAAA,MACf,eAAe,KAAK;AAAA,IACtB;AAAA,EACF;AACF;AAsBO,SAAS,eAAe,WAAgC;AAC7D,QAAM,cAAc,eAAe;AACnC,QAAM,aAAa,cAAc;AACjC,QAAM,YAAY,aAAa;AAC/B,QAAM,eAAe,gBAAgB;AACrC,QAAM,SAAS,UAAU;AAEzB,QAAM,sBAAsB,YAAY,MAAM;AAC5C,SAAK,YAAY,kBAAkB,EAAE,UAAU,CAAC,aAAa,UAAU,EAAE,CAAC;AAC1E,SAAK,YAAY,kBAAkB;AAAA,MACjC,UAAU,CAAC,oBAAoB,UAAU;AAAA,IAC3C,CAAC;AAAA,EACH,GAAG,CAAC,aAAa,UAAU,CAAC;AAE5B,QAAM,YAAY;AAAA,IAChB,OAAO,MAAqB,UAA6B,CAAC,MAAwB;AAChF,YAAM,EAAE,YAAY,MAAM,SAAS,IAAI,WAAW,QAAQ,IAAI;AAC9D,YAAM,MAAM,eAAe,UAAU;AACrC,YAAM,oBAAoB,CAAC,GAAG,SAAS;AAEvC,mBAAa,mBAAmB,WAAW,MAAM,KAAK,MAAM,CAAC;AAE7D,UAAI;AACF,cAAM,UAAU,MAAM,UAAU,UAAU,KAAK;AAAA,UAC7C;AAAA,YACE,YAAY;AAAA,YACZ,YAAY,KAAK;AAAA,YACjB,UAAU,KAAK;AAAA,YACf,eAAe,KAAK;AAAA,UACtB;AAAA,QACF,CAAC;AACD,YAAI,CAAC,QAAS,OAAM,IAAI,MAAM,4BAA4B;AAE1D,4BAAoB;AACpB,YAAI,aAAa,QAAQ,MAAM;AAC7B,iBAAO,KAAK,GAAG,KAAK,QAAQ,MAAM,UAAU,MAAM,gBAAgB;AAAA,QACpE;AACA,oBAAY;AACZ,eAAO;AAAA,MACT,SAAS,OAAO;AACd,qBAAa,iBAAiB;AAC9B,YAAI,aAAa,QAAQ,OAAO;AAC9B,iBAAO,MAAM,+CAA+C;AAAA,QAC9D;AACA,kBAAU,KAAc;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,cAAc,qBAAqB,WAAW,MAAM;AAAA,EAC9E;AAEA,QAAM,iBAAiB;AAAA,IACrB,OACE,YACA,aACA,UAA6B,CAAC,MACT;AACrB,YAAM,EAAE,YAAY,OAAO,WAAW,QAAQ,IAAI;AAClD,YAAM,MAAM,eAAe,UAAU;AACrC,YAAM,oBAAoB,CAAC,GAAG,SAAS;AAEvC,YAAM,eAAe,UAAU;AAAA,QAAI,CAAC,SAClC,KAAK,eAAe,aAAa,EAAE,GAAG,MAAM,UAAU,YAAY,IAAI;AAAA,MACxE;AACA,mBAAa,YAAY;AAEzB,UAAI;AACF,cAAM,UAAU,MAAM,UAAU,gBAAgB,KAAK,YAAY;AACjE,YAAI,CAAC,QAAS,OAAM,IAAI,MAAM,2BAA2B;AAEzD,4BAAoB;AACpB,oBAAY;AACZ,eAAO;AAAA,MACT,SAAS,OAAO;AACd,qBAAa,iBAAiB;AAC9B,YAAI,aAAa,QAAQ,OAAO;AAC9B,iBAAO,MAAM,8CAA8C;AAAA,QAC7D;AACA,kBAAU,KAAc;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,cAAc,qBAAqB,WAAW,MAAM;AAAA,EAC9E;AAEA,QAAM,iBAAiB;AAAA,IACrB,OAAO,YAAoB,UAA6B,CAAC,MAAwB;AAC/E,YAAM,EAAE,YAAY,MAAM,SAAS,IAAI,WAAW,QAAQ,IAAI;AAC9D,YAAM,MAAM,eAAe,UAAU;AACrC,YAAM,oBAAoB,CAAC,GAAG,SAAS;AAEvC,mBAAa,UAAU,OAAO,CAAC,SAAS,KAAK,eAAe,UAAU,CAAC;AAEvE,UAAI;AACF,cAAM,cAAc,UAAU;AAAA,UAAI,CAAC,SACjC,KAAK,eAAe,aAAa,EAAE,GAAG,MAAM,UAAU,EAAE,IAAI;AAAA,QAC9D;AACA,cAAM,UAAU,MAAM,UAAU,gBAAgB,KAAK,WAAW;AAChE,YAAI,CAAC,QAAS,OAAM,IAAI,MAAM,uBAAuB;AAErD,4BAAoB;AACpB,YAAI,aAAa,QAAQ,MAAM;AAC7B,iBAAO,KAAK,GAAG,UAAU,MAAM,oBAAoB;AAAA,QACrD;AACA,oBAAY;AACZ,eAAO;AAAA,MACT,SAAS,OAAO;AACd,qBAAa,iBAAiB;AAC9B,YAAI,aAAa,QAAQ,OAAO;AAC9B,iBAAO,MAAM,0CAA0C;AAAA,QACzD;AACA,kBAAU,KAAc;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,cAAc,qBAAqB,WAAW,MAAM;AAAA,EAC9E;AAEA,QAAM,YAAY;AAAA,IAChB,OAAO,UAA6C,CAAC,MAAwB;AAC3E,YAAM,EAAE,YAAY,MAAM,WAAW,QAAQ,IAAI;AACjD,YAAM,MAAM,eAAe,UAAU;AACrC,YAAM,oBAAoB,CAAC,GAAG,SAAS;AACvC,mBAAa,CAAC,CAAC;AAEf,UAAI;AACF,cAAM,UAAU,MAAM,UAAU,oBAAoB,GAAG;AACvD,YAAI,CAAC,QAAS,OAAM,IAAI,MAAM,sBAAsB;AAEpD,4BAAoB;AACpB,YAAI,aAAa,QAAQ,MAAM;AAC7B,iBAAO,KAAK,cAAc;AAAA,QAC5B;AACA,oBAAY;AACZ,eAAO;AAAA,MACT,SAAS,OAAO;AACd,qBAAa,iBAAiB;AAC9B,YAAI,aAAa,QAAQ,OAAO;AAC9B,iBAAO,MAAM,yCAAyC;AAAA,QACxD;AACA,kBAAU,KAAc;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,cAAc,qBAAqB,WAAW,MAAM;AAAA,EAC9E;AAEA,QAAM,WAAW;AAAA,IACf,CAAC,eAAgC;AAC/B,aAAO,UAAU,KAAK,CAAC,SAAS,KAAK,eAAe,UAAU;AAAA,IAChE;AAAA,IACA,CAAC,SAAS;AAAA,EACZ;AAEA,QAAM,kBAAkB;AAAA,IACtB,CAAC,eAA+B;AAC9B,aAAO,UAAU,KAAK,CAAC,SAAS,KAAK,eAAe,UAAU,GAAG,YAAY;AAAA,IAC/E;AAAA,IACA,CAAC,SAAS;AAAA,EACZ;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AC3QA,SAAS,aAAAC,YAAW,YAAAC,iBAAgB;AAS7B,SAAS,kBAAkB,QAAiB,SAAqB;AACtE,QAAM,CAAC,UAAU,WAAW,IAAIA,UAAS,KAAK;AAE9C,EAAAD,WAAU,MAAM;AACd,gBAAY,IAAI;AAAA,EAClB,GAAG,CAAC,CAAC;AAGL,EAAAA,WAAU,MAAM;AACd,aAAS,KAAK,MAAM,WAAW,SAAS,WAAW;AACnD,WAAO,MAAM;AACX,eAAS,KAAK,MAAM,WAAW;AAAA,IACjC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAGX,EAAAA,WAAU,MAAM;AACd,UAAM,eAAe,CAAC,MAAqB;AACzC,UAAI,EAAE,QAAQ,YAAY,OAAQ,SAAQ;AAAA,IAC5C;AACA,aAAS,iBAAiB,WAAW,YAAY;AACjD,WAAO,MAAM,SAAS,oBAAoB,WAAW,YAAY;AAAA,EACnE,GAAG,CAAC,QAAQ,OAAO,CAAC;AAEpB,SAAO,EAAE,SAAS;AACpB;;;ACjCA,SAAS,aAAAE,YAAW,cAAc;AAkBlC,IAAM,cAAc,KAAK,KAAK;AAOvB,SAAS,cAAc,KAAa,OAAsB;AAC/D,MAAI;AACF,UAAM,QAAsB,EAAE,OAAO,SAAS,KAAK,IAAI,EAAE;AACzD,mBAAe,QAAQ,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACnD,QAAQ;AAAA,EAER;AACF;AAQO,SAAS,gBACd,KACA,MAAc,aACd,UACU;AACV,MAAI;AACF,UAAM,MAAM,eAAe,QAAQ,GAAG;AACtC,QAAI,CAAC,IAAK,QAAO;AAEjB,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,QAAI,KAAK,IAAI,IAAI,MAAM,UAAU,KAAK;AACpC,qBAAe,WAAW,GAAG;AAC7B,aAAO;AAAA,IACT;AAEA,QAAI,UAAU;AACZ,aAAO,SAAS,MAAM,KAAK;AAAA,IAC7B;AACA,WAAO,MAAM;AAAA,EACf,QAAQ;AACN,mBAAe,WAAW,GAAG;AAC7B,WAAO;AAAA,EACT;AACF;AAGO,SAAS,iBAAiB,KAAmB;AAClD,MAAI;AACF,mBAAe,WAAW,GAAG;AAAA,EAC/B,QAAQ;AAAA,EAER;AACF;AASO,SAAS,uBAAuB,QAA+C;AAEpF,QAAM,YAAY,OAAO,MAAM;AAC/B,YAAU,UAAU;AAEpB,EAAAA,WAAU,MAAM;AACd,eAAW,SAAS,UAAU,SAAS;AACrC,YAAM,WAAW,gBAAgB,MAAM,KAAK,MAAM,OAAO,aAAa,MAAM,QAAQ;AACpF,UAAI,aAAa,MAAM;AACrB,cAAM,IAAI,QAAQ;AAAA,MACpB;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAGL,QAAM,aAAa,KAAK,UAAU,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACrE,EAAAA,WAAU,MAAM;AACd,eAAW,SAAS,QAAQ;AAC1B,UAAI,MAAM,UAAU,UAAa,MAAM,UAAU,MAAM;AACrD,sBAAc,MAAM,KAAK,MAAM,KAAK;AAAA,MACtC;AAAA,IACF;AAAA,EAEF,GAAG,CAAC,UAAU,CAAC;AACjB;AAOO,SAAS,yBAAyB,MAAsB;AAC7D,aAAW,OAAO,MAAM;AACtB,qBAAiB,GAAG;AAAA,EACtB;AACF;;;ACtHA,SAAS,aAAAC,YAAW,WAAAC,UAAS,UAAAC,eAAc;AAC3C,SAAS,YAAAC,WAAU,kBAAAC,uBAAsB;AAUzC,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AA6BvB,IAAM,sBAAsB,MAAM,aAAa,QAAQ,WAAW;AAClE,IAAM,uBAAuB,CAAC,UAAkB,aAAa,QAAQ,aAAa,KAAK;AACvF,IAAM,2BAA2B,MAAM,OAAO,WAAW;AA8BlD,SAAS,sBAAsB,SAA0B,WAA8B;AAC5F,QAAM,eAAe,UAAU,gBAAgB;AAC/C,QAAM,gBAAgB,UAAU,iBAAiB;AACjD,QAAM,oBAAoB,UAAU,qBAAqB;AAEzD,QAAM,OAAO,aAAa;AAC1B,QAAM,aAAa,cAAc;AACjC,QAAM,gBAAgB,iBAAiB;AACvC,QAAM,eAAe,gBAAgB;AACrC,QAAM,YAAY,aAAa;AAC/B,QAAM,cAAcC,gBAAe;AAGnC,QAAM,kBAAkB,QAAQ;AAChC,QAAM,kBAAkB,QAAQ,UAAU,MAAM;AAChD,QAAM,sBAAsB,QAAQ,cAAc,MAAM;AACxD,QAAM,mBAAmBC;AAAA,IACvB,OAAO,EAAE,QAAQ,iBAAiB,QAAQ,iBAAiB,YAAY,oBAAoB;AAAA,IAC3F,CAAC,iBAAiB,iBAAiB,mBAAmB;AAAA,EACxD;AAEA,QAAM,gBAAgBC,QAAO,CAAC;AAC9B,QAAM,oBAAoBA,QAAO,KAAK;AACtC,QAAM,gBAAgBA,QAAO,iBAAiB,MAAM;AAGpD,EAAAC,WAAU,MAAM;AACd,UAAM,aAAa,cAAc;AACjC,kBAAc,UAAU,iBAAiB;AAEzC,QAAI,eAAe,mBAAmB,iBAAiB,WAAW,mBAAmB;AACnF,gBAAU;AACV,kBAAY,cAAc,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC;AACrD,kBAAY,cAAc,EAAE,UAAU,CAAC,kBAAkB,EAAE,CAAC;AAAA,IAC9D;AAAA,EACF,GAAG,CAAC,iBAAiB,QAAQ,WAAW,WAAW,CAAC;AAGpD,EAAAA,WAAU,MAAM;AACd,QAAI,cAAc,iBAAiB,WAAW,UAAW;AAGzD,QAAI,iBAAiB,cAAc,iBAAiB,WAAW,iBAAiB;AAC9E,oBAAc,iBAAiB,UAAU;AACzC;AAAA,IACF;AAGA,QAAI,iBAAiB,WAAW,qBAAqB,CAAC,kBAAkB,SAAS;AAC/E,wBAAkB,UAAU;AAC5B,oBAAc,UAAU;AAExB,YAAM,sBAAsB,YAAY;AACtC,cAAM,gBAAgB,aAAa;AACnC,cAAM,YACJ,iBAAiB,OAAO,kBAAkB,WAAW,gBAAgB,kBAAkB;AAEzF,eAAO,cAAc,UAAU,oBAAoB;AACjD,cAAI;AACF,kBAAM,UAAU,MAAM,UAAU,cAAc,KAAK,SAAS;AAE5D,gBAAI,WAAW,QAAQ,eAAe,GAAG;AACvC,4BAAc,SAAS;AACvB,4BAAc,QAAQ,UAAU;AAChC,gCAAkB,UAAU;AAC5B;AAAA,YACF;AAEA,0BAAc;AAEd,gBAAI,cAAc,UAAU,oBAAoB;AAC9C,oBAAM,QAAQ,KAAK,IAAI,iBAAiB,KAAK,IAAI,KAAK,cAAc,OAAO,GAAG,GAAK;AACnF,oBAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,CAAC;AAAA,YAC3D;AAAA,UACF,SAAS,OAAO;AACd,oBAAQ;AAAA,cACN,+BAA+B,cAAc,UAAU,CAAC;AAAA,cACxD;AAAA,YACF;AACA,0BAAc;AAEd,gBAAI,cAAc,UAAU,oBAAoB;AAC9C,oBAAM,QAAQ,KAAK,IAAI,iBAAiB,KAAK,IAAI,KAAK,cAAc,OAAO,GAAG,GAAK;AACnF,oBAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,CAAC;AAAA,YAC3D;AAAA,UACF;AAAA,QACF;AAEA,gBAAQ,MAAM,oCAAoC,kBAAkB,WAAW;AAC/E,0BAAkB,UAAU;AAAA,MAC9B;AAEA,WAAK,oBAAoB;AAAA,IAC3B;AAAA,EACF,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAGD,QAAM,EAAE,MAAM,cAAc,IAAIC,UAAS;AAAA,IACvC,UAAU,CAAC,aAAa,UAAU;AAAA,IAClC,SAAS,YAAa,MAAM,UAAU,aAAa,OAAO,UAAU,CAAC,KAAM,CAAC;AAAA,IAC5E,SAAS,CAAC,CAAC;AAAA,EACb,CAAC;AAGD,EAAAD,WAAU,MAAM;AACd,QAAI,eAAe;AACjB,mBAAa,aAAa;AAAA,IAC5B;AAAA,EACF,GAAG,CAAC,eAAe,YAAY,CAAC;AAEhC,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,kBAAkB;AAAA,IAClC,YAAY,cAAc;AAAA,EAC5B;AACF;;;ACpMA,SAAS,WAAAE,gBAAe;AACxB,SAAS,kBAAkB;AAE3B,SAAS,mBAAmB;AA+CrB,SAAS,eAAe,UAAiC,CAAC,GAAsB;AAErF,QAAM,QAAQ,gBAAqB;AACnC,QAAM,OAAO,aAAa;AAC1B,QAAM,OAAO,aAAa;AAC1B,QAAM,YAAY,aAAa;AAC/B,QAAM,aAAa,QAAQ,cAAc,MAAM,cAAc,MAAM,UAAU;AAE7E,QAAM,UAAU,QAAQ;AAExB,QAAM,eAAe,WAAW;AAAA,IAC9B,SAAS,UAAU,IAAI,CAAC,SAAS;AAC/B,UAAI,SAAS;AACX,eAAO;AAAA,UACL,UAAU,CAAC,SAAS,KAAK,QAAQ,YAAY,KAAK,IAAI,YAAY,KAAK,QAAQ;AAAA,UAC/E,SAAS,MAAM,QAAQ,KAAK,QAAQ,YAAa,KAAK,QAAQ;AAAA,UAC9D,oBAAoB;AAAA,UACpB,sBAAsB;AAAA,UACtB,MAAM,EAAE,SAAS,KAAK;AAAA,UACtB,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK;AAAA,QAClC;AAAA,MACF;AAGA,YAAM,YAAY,MAAM,QAAQ,YAAY,KAAK;AAAA,QAC/C,QAAQ,KAAK,QAAQ,YAAY,KAAK;AAAA,QACtC,YAAY,OAAO,UAAU;AAAA,QAC7B,UAAU,KAAK;AAAA,MACjB,CAAC;AAED,aAAO;AAAA,QACL,GAAG;AAAA,QACH,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC,KAAK;AAAA,QAChC,oBAAoB;AAAA,QACpB,sBAAsB;AAAA,QACtB,MAAM,EAAE,SAAS,KAAK;AAAA,MACxB;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,QAAM,SAASC,SAAQ,MAAM;AAC3B,UAAM,MAAqC,CAAC;AAC5C,cAAU,QAAQ,CAAC,MAAM,UAAU;AACjC,YAAM,cAAc,aAAa,KAAK;AACtC,YAAM,UAAU,aAAa;AAC7B,UAAI,SAAS;AAGX,cAAM,YAAa,QAA+B,QAAQ;AAC1D,cAAM,UAAU,YAAY;AAAA,UAC1B;AAAA,UACA,UAAU,KAAK;AAAA,QACjB,CAAC;AACD,YAAI,KAAK,OAAO,YAAY,CAAC,IAAI;AAAA,UAC/B,WAAW,QAAQ;AAAA,UACnB;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,WAAW,YAAY,CAAC;AAE5B,QAAM,eAAeA,SAAQ,MAAM;AACjC,WAAO,CAAC,WAA2B;AACjC,aAAO,OAAO,QAAQ,YAAY,CAAC,GAAG,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,eAAeA,SAAQ,MAAM;AACjC,WAAO,CAAC,QAAgB,aAA6B;AACnD,aAAO,aAAa,MAAM,IAAI;AAAA,IAChC;AAAA,EACF,GAAG,CAAC,YAAY,CAAC;AAEjB,QAAM,WAAWA,SAAQ,MAAM;AAC7B,WAAO,UAAU,OAAO,CAAC,KAAK,SAAS;AACrC,YAAM,YAAY,OAAO,KAAK,OAAO,YAAY,CAAC,GAAG,aAAa;AAClE,aAAO,MAAM,YAAY,KAAK;AAAA,IAChC,GAAG,CAAC;AAAA,EACN,GAAG,CAAC,WAAW,MAAM,CAAC;AAEtB,QAAM,YAAY,aAAa,KAAK,CAAC,MAAM,EAAE,SAAS;AACtD,QAAM,YAAY,aAAa,MAAM,CAAC,MAAM,EAAE,SAAS;AACvD,QAAM,UAAU,aAAa,KAAK,CAAC,MAAM,EAAE,OAAO;AAElD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AChJA,SAAS,kBAAAC,uBAAsB;AAC/B,SAAS,eAAAC,oBAAmB;AAuBrB,IAAM,wBAAwB,CAAC;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY,KAAK,KAAK;AAAA,EACtB,SAAS,KAAK,KAAK;AAAA,EACnB,UAAU;AACZ,MAAoC;AAClC,QAAM,cAAcD,gBAAe;AAEnC,QAAM,eAAeC;AAAA,IACnB,OAAO,SAAiB;AACtB,UAAI,CAAC,QAAS;AAEd,YAAM,UAAU,OAAO,KAAK;AAE5B,UAAI;AACF,cAAM,YAAY,cAAc;AAAA,UAC9B,UAAU,aAAa,WAAW,UAAU,MAAM,IAAI,CAAC,GAAG,UAAU,MAAM;AAAA,UAC1E,SAAS,MAAM,QAAQ,MAAM;AAAA,UAC7B;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH,SAAS,OAAO;AACd,gBAAQ,KAAK,0BAA0B,IAAI,KAAK,KAAK;AAAA,MACvD;AAAA,IACF;AAAA,IACA,CAAC,UAAU,SAAS,UAAU,YAAY,WAAW,QAAQ,aAAa,OAAO;AAAA,EACnF;AAEA,QAAM,wBAAwBA;AAAA,IAC5B,CAAC,SAAiB;AAChB,YAAM,YAAY,WAAW,MAAM,aAAa,IAAI,GAAG,GAAG;AAC1D,aAAO,MAAM,aAAa,SAAS;AAAA,IACrC;AAAA,IACA,CAAC,YAAY;AAAA,EACf;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;;;ACnEA,SAAS,YAAAC,WAAU,aAAAC,YAAW,WAAAC,gBAAe;;;ACMtC,SAAS,UAAU,MAA+B;AACvD,SAAO,KAAK,UAAU,MAAM,CAAC,MAAM,UAAU;AAC3C,QAAI,iBAAiB,IAAK,QAAO,OAAO,YAAY,KAAK;AACzD,WAAO;AAAA,EACT,CAAC;AACH;AAKO,SAAS,YAAY,MAA+B;AACzD,SAAO,KAAK,MAAM,IAAI;AACxB;;;ACLO,SAAS,YACd,MACA,QACiB;AACjB,QAAM,UAAU,KAAK,aAAa;AAClC,MAAI,CAAC,WAAW,OAAO,KAAK,MAAM,EAAE,WAAW,EAAG,QAAO;AAEzD,QAAM,UAAU;AAChB,QAAM,YAA0B,CAAC;AACjC,QAAM,SAAS,oBAAI,IAA0B;AAE7C,aAAW,KAAK,SAAS;AACvB,UAAM,SAAS,MAAM,QAAQ,EAAE,QAAQ,IAAI,EAAE,SAAS,CAAC,IAAI;AAC3D,QAAI,OAAO,WAAW,YAAY,UAAU,QAAQ;AAClD,YAAM,QAAQ,OAAO,IAAI,MAAM,KAAK,CAAC;AACrC,YAAM,KAAK,CAAC;AACZ,aAAO,IAAI,QAAQ,KAAK;AAAA,IAC1B,OAAO;AACL,gBAAU,KAAK,CAAC;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,OAAqB,CAAC;AAC5B,aAAW,CAAC,QAAQ,KAAK,KAAK,QAAQ;AACpC,UAAM,QAAQ,OAAO,MAAM;AAC3B,UAAM,SAAS,CAAC,GAAG,KAAK,EAAE;AAAA,MACxB,CAAC,GAAG,OAAO,EAAE,MAAM,iBAAiB,MAAM,EAAE,MAAM,iBAAiB;AAAA,IACrE;AACA,SAAK,KAAK,GAAG,OAAO,MAAM,GAAG,KAAK,CAAC;AAAA,EACrC;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa;AAAA,MACX,GAAG,KAAK;AAAA,MACR,SAAS,CAAC,GAAG,WAAW,GAAG,IAAI;AAAA,IACjC;AAAA,EACF;AACF;;;AC7CA,IAAM,gBAA2B;AAAA,EAC/B,eAAe,YAAY;AAAA,EAAC;AAAA,EAC5B,eAAe,YAAY;AAAA,EAC3B,cAAc,YAAY;AAAA,EAAC;AAC7B;AAQO,SAAS,gBAAgB,QAAsC;AACpE,MAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,QAAM,aAAa,OAAO,cAAc;AACxC,QAAM,SAAS,OAAO,UAAU,CAAC;AACjC,MAAI;AACJ,MAAI;AAEJ,WAAS,QAAQ;AAEf,QAAI,CAAC,QAAS;AACd,QAAI;AACF,YAAM,UAAU,YAAY,SAAS,MAAM;AAC3C,aAAO,aAAa,QAAQ,OAAO,KAAK,UAAU,OAAO,CAAC;AAAA,IAC5D,QAAQ;AAAA,IAER;AACA,cAAU;AAAA,EACZ;AAEA,SAAO;AAAA,IACL,cAAc,QAAyB;AACrC,gBAAU;AACV,UAAI,CAAC,OAAO;AACV,gBAAQ,WAAW,MAAM;AACvB,kBAAQ;AACR,gBAAM;AAAA,QACR,GAAG,UAAU;AAAA,MACf;AAAA,IACF;AAAA,IAEA,gBAAgB;AACd,UAAI;AACF,cAAM,MAAM,OAAO,aAAa,QAAQ,OAAO,GAAG;AAClD,YAAI,CAAC,IAAK,QAAO;AACjB,eAAO,YAAY,GAAG;AAAA,MACxB,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,eAAe;AACb,aAAO,aAAa,WAAW,OAAO,GAAG;AAAA,IAC3C;AAAA,EACF;AACF;;;AC/DA,SAAS,aAAAC,kBAAiB;AAG1B,IAAM,oBAAoB,IAAI,KAAK;AAU5B,SAAS,kBAAkB,QAAiC;AACjE,QAAM,EAAE,KAAK,SAAS,CAAC,GAAG,eAAe,EAAE,IAAI;AAC/C,QAAM,YAAY,OAAO,KAAK,MAAM;AAEpC,EAAAA,WAAU,MAAM;AACd,QAAI,OAAO,WAAW,eAAe,UAAU,WAAW,EAAG;AAE7D,aAAS,QAAQ;AACf,YAAM,UAAU,OAAO;AACvB,UAAI,YAAY;AAEhB,iBAAW,KAAK,OAAO,KAAK,OAAO,GAAG;AACpC,cAAM,IAAI,QAAQ,QAAQ,CAAC;AAC3B,YAAI,EAAG,cAAa,EAAE,SAAS,EAAE;AAAA,MACnC;AAGA,YAAM,SAAU,YAAY,IAAK,OAAO;AACxC,UAAI,UAAU,aAAc;AAE5B,UAAI;AACF,cAAM,MAAM,QAAQ,QAAQ,GAAG;AAC/B,YAAI,CAAC,IAAK;AACV,cAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,YAAI,CAAC,OAAO,aAAa,QAAS;AAGlC,eAAO,YAAY,UAAU,OAAO,YAAY,QAAQ;AAAA,UACtD,CAAC,MAAgC;AAC/B,gBAAI,CAAC,MAAM,QAAQ,EAAE,QAAQ,EAAG,QAAO;AACvC,kBAAM,SAAS,EAAE,SAAS,CAAC;AAC3B,mBAAO,OAAO,WAAW,YAAY,CAAC,UAAU,SAAS,MAAM;AAAA,UACjE;AAAA,QACF;AAEA,gBAAQ,QAAQ,KAAK,KAAK,UAAU,MAAM,CAAC;AAAA,MAC7C,QAAQ;AAEN,gBAAQ,WAAW,GAAG;AAAA,MACxB;AAAA,IACF;AAEA,UAAM;AACN,UAAM,KAAK,YAAY,OAAO,iBAAiB;AAC/C,WAAO,MAAM,cAAc,EAAE;AAAA,EAC/B,GAAG,CAAC,KAAK,cAAc,UAAU,MAAM,CAAC;AAC1C;;;AJjBO,SAAS,oBAAoB,QAA2B;AAC7D,QAAM,CAAC,SAAS,IAAIC,UAAS,MAAM,gBAAgB,MAAM,CAAC;AAC1D,QAAM,CAAC,WAAW,YAAY,IAAIA,UAAS,KAAK;AAEhD,EAAAC,WAAU,MAAM;AACd,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,CAAC;AAEL,oBAAkB,MAAM;AAExB,QAAM,QAAQ,OAAO,YAAY,eAAe,QAAQ,MAAM,UAAU,MAAM;AAE9E,QAAM,EAAE,gBAAgB,IAAI;AAE5B,QAAM,mBAAmBC;AAAA,IACvB,OAAO;AAAA,MACL,sBAAsB,CAAC,UAGjB;AACJ,cAAM,MAAM,MAAM;AAClB,YAAI,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAI,WAAW,EAAG,QAAO;AACpD,YAAI,MAAM,MAAM,WAAW,UAAW,QAAO;AAC7C,eAAO,gBAAgB,SAAS,IAAI,CAAC,CAAW;AAAA,MAClD;AAAA,IACF;AAAA,IACA,CAAC,eAAe;AAAA,EAClB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,YAAa,OAAO,UAAU,KAAK,KAAK,KAAK,MAAQ;AAAA,IAC7D,QAAQ,QAAQ,OAAO,KAAK,IAAI,CAAC,IAAK,OAAO,UAAU;AAAA,IACvD;AAAA,EACF;AACF;","names":["useMemo","useMemo","useEffect","useState","useEffect","useEffect","useMemo","useRef","useQuery","useQueryClient","useQueryClient","useMemo","useRef","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","../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\n// Keep legacy exports for backward compat (api-based sites still use these)\nexport { getStockKey, getStockOptions } from \"../queries/stock\";\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\n// Keep legacy exports for backward compat (api-based sites still use these)\nexport { getCartPricingQueryOptions } from \"../queries/cart-pricing\";\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"]}
@@ -49,6 +49,8 @@ interface UsePaymentFlowParams {
49
49
  billingAddress: PaymentBillingAddress | undefined;
50
50
  paymentMethod: string;
51
51
  shippingAccepted: boolean;
52
+ /** Persist payment tokens to sessionStorage for cross-navigation recovery. */
53
+ persistPayment?: boolean;
52
54
  }
53
55
  /**
54
56
  * Manages the full Element/Unified payment lifecycle:
@@ -71,7 +73,7 @@ interface UsePaymentFlowParams {
71
73
  * });
72
74
  * ```
73
75
  */
74
- declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, }: UsePaymentFlowParams): {
76
+ declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, persistPayment, }: UsePaymentFlowParams): {
75
77
  isOpen: boolean;
76
78
  setIsOpen: react.Dispatch<react.SetStateAction<boolean>>;
77
79
  editCc: boolean;
@@ -49,6 +49,8 @@ interface UsePaymentFlowParams {
49
49
  billingAddress: PaymentBillingAddress | undefined;
50
50
  paymentMethod: string;
51
51
  shippingAccepted: boolean;
52
+ /** Persist payment tokens to sessionStorage for cross-navigation recovery. */
53
+ persistPayment?: boolean;
52
54
  }
53
55
  /**
54
56
  * Manages the full Element/Unified payment lifecycle:
@@ -71,7 +73,7 @@ interface UsePaymentFlowParams {
71
73
  * });
72
74
  * ```
73
75
  */
74
- declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, }: UsePaymentFlowParams): {
76
+ declare function usePaymentFlow({ callbacks, customerId, billingAddress, paymentMethod, shippingAccepted, persistPayment, }: UsePaymentFlowParams): {
75
77
  isOpen: boolean;
76
78
  setIsOpen: react.Dispatch<react.SetStateAction<boolean>>;
77
79
  editCc: boolean;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@simpleapps-com/augur-hooks",
3
- "version": "2.2.21",
3
+ "version": "2.2.23",
4
4
  "description": "Cross-platform React Query hooks and Zustand stores for Augur ecommerce sites",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -38,8 +38,8 @@
38
38
  "llms.txt"
39
39
  ],
40
40
  "dependencies": {
41
- "@simpleapps-com/augur-core": "2.2.21",
42
- "@simpleapps-com/augur-utils": "2.2.21"
41
+ "@simpleapps-com/augur-core": "2.2.23",
42
+ "@simpleapps-com/augur-utils": "2.2.23"
43
43
  },
44
44
  "peerDependencies": {
45
45
  "@simpleapps-com/augur-api": "^2026.3.7",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/chunk-EOHLFKJN.cjs","../src/stores/cart-store.ts","../src/hooks/use-payment-flow.ts","../src/hooks/use-order-readiness.ts"],"names":["useState","useEffect"],"mappings":"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","file":"/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/chunk-EOHLFKJN.cjs","sourcesContent":[null,"import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport type { TCartLine } from \"@simpleapps-com/augur-utils\";\n\n/** Internal state shape for the cart Zustand store. */\ninterface CartState {\n /** P21 cart header UID; `undefined` when no cart exists. */\n cartHdrUid: number | string | undefined;\n /** Current line items in the cart. */\n cartLines: TCartLine[];\n /** Sum of `quantity` across all cart lines (auto-computed by `setCartLines`). */\n cartQuantityTotal: number;\n /** Number of distinct line items (auto-computed by `setCartLines`). */\n cartLineCount: number;\n setCartHdrUid: (cartHdrUid: number | string | undefined) => void;\n /** Replace all cart lines. Auto-recomputes `cartQuantityTotal` and `cartLineCount`. */\n setCartLines: (cartLines: TCartLine[]) => void;\n /** Reset the cart to its empty initial state. */\n clearCart: () => void;\n}\n\n/** Zustand store for cart state. Prefer the individual selector hooks below for optimal re-renders. */\nexport const useCartStore = create<CartState>()(\n devtools(\n (set) => ({\n cartHdrUid: undefined,\n cartLines: [],\n cartQuantityTotal: 0,\n cartLineCount: 0,\n\n setCartHdrUid: (cartHdrUid) => set({ cartHdrUid }, false, \"setCartHdrUid\"),\n\n setCartLines: (cartLines) => {\n const cartQuantityTotal = cartLines.reduce((sum, line) => sum + (line.quantity || 0), 0);\n const cartLineCount = cartLines.length;\n set({ cartLines, cartQuantityTotal, cartLineCount }, false, \"setCartLines\");\n },\n\n clearCart: () =>\n set(\n { cartHdrUid: undefined, cartLines: [], cartQuantityTotal: 0, cartLineCount: 0 },\n false,\n \"clearCart\",\n ),\n }),\n { name: \"CartStore\", enabled: process.env[\"NODE_ENV\"] === \"development\" },\n ),\n);\n\n// Selector hooks -- only re-render when specific state changes\n\n/** Select the current cart header UID. */\nexport const useCartHdrUid = () => useCartStore((s) => s.cartHdrUid);\n/** Select the current cart line items array. */\nexport const useCartLines = () => useCartStore((s) => s.cartLines);\n/** Select the total quantity summed across all cart lines. */\nexport const useCartQuantityTotal = () => useCartStore((s) => s.cartQuantityTotal);\n/** Select the number of distinct line items in the cart. */\nexport const useCartLineCount = () => useCartStore((s) => s.cartLineCount);\n/** Get the `setCartHdrUid` action (stable reference). */\nexport const useSetCartHdrUid = () => useCartStore((s) => s.setCartHdrUid);\n/** Get the `setCartLines` action (stable reference). Also recomputes totals. */\nexport const useSetCartLines = () => useCartStore((s) => s.setCartLines);\n/** Get the `clearCart` action (stable reference). */\nexport const useClearCart = () => useCartStore((s) => s.clearCart);\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type {\n TTransactionSetup,\n TCardInfo,\n TPaymentValidation,\n TAccountQuery,\n TBillingUpdate,\n} from \"@simpleapps-com/augur-utils\";\n\n/** Site-specific payment action callbacks injected into usePaymentFlow. */\nexport interface PaymentFlowCallbacks {\n /** Initialize a payment session. Returns transaction setup or undefined on failure. */\n transactionSetup: (params: { customerId: string }) => Promise<TTransactionSetup | undefined>;\n /** Retrieve card details after iframe entry. */\n cardInfo: (params: { transactionSetupId: string }) => Promise<TCardInfo | undefined>;\n /** Verify card is valid. */\n validatePayment: (params: {\n transactionSetupId: string;\n customerId: string;\n }) => Promise<TPaymentValidation | undefined>;\n /** Get payment account ID. */\n accountQuery: (params: {\n transactionSetupId: string;\n customerId: string;\n }) => Promise<TAccountQuery | undefined>;\n /** Send billing address to payment processor. */\n billingUpdate: (params: {\n transactionSetupId: string;\n address1: string;\n address2?: string;\n city: string;\n state: string;\n zip: string;\n }) => Promise<TBillingUpdate | undefined>;\n /** Optional toast notification callback. */\n toast?: {\n error?: (message: string) => void;\n };\n}\n\n/** Billing address shape accepted by the payment flow. */\nexport interface PaymentBillingAddress {\n address1: string;\n address2?: string;\n city: string;\n state: string;\n postalCode: string;\n}\n\ninterface UsePaymentFlowParams {\n callbacks: PaymentFlowCallbacks;\n customerId: string | number | undefined;\n billingAddress: PaymentBillingAddress | undefined;\n paymentMethod: string;\n shippingAccepted: boolean;\n}\n\n/**\n * Manages the full Element/Unified payment lifecycle:\n * transactionSetup -> cardInfo -> validatePayment -> accountQuery -> billingUpdate\n *\n * Accepts site-specific server action callbacks so the hook has no dependency\n * on any particular server action implementation.\n *\n * @example\n * ```tsx\n * import { usePaymentFlow } from \"@simpleapps-com/augur-hooks\";\n * import { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate } from \"@/lib/actions/payments\";\n *\n * const payment = usePaymentFlow({\n * callbacks: { transactionSetup, cardInfo, validatePayment, accountQuery, billingUpdate },\n * customerId,\n * billingAddress,\n * paymentMethod: \"credit-card\",\n * shippingAccepted: true,\n * });\n * ```\n */\nexport function usePaymentFlow({\n callbacks,\n customerId,\n billingAddress,\n paymentMethod,\n shippingAccepted,\n}: UsePaymentFlowParams) {\n const [isOpen, setIsOpen] = useState(false);\n const [unified, setUnified] = useState<TTransactionSetup | null>(null);\n const [unifiedCc, setUnifiedCc] = useState<TCardInfo | null>(null);\n const [unifiedResponse, setUnifiedResponse] = useState(false);\n const [unifiedBilling, setUnifiedBilling] = useState(false);\n const [unifiedPayment, setUnifiedPayment] = useState<TAccountQuery | null>(null);\n const [capturedBin, setCapturedBin] = useState<string | null>(null);\n const [editCc, setEditCc] = useState(false);\n\n const handleBinCapture = useCallback((bin: string) => {\n setCapturedBin(bin);\n }, []);\n\n // Ref ensures callbacks always read the latest customerId, avoiding stale\n // closures when React batches state updates (e.g., modal close + verify).\n const customerIdRef = useRef(customerId);\n customerIdRef.current = customerId;\n\n // Step 1: Initialize payment session\n const postUnified = useCallback(async () => {\n if (!customerIdRef.current) return;\n try {\n const result = await callbacks.transactionSetup({\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to initialize payment. Please try again.\");\n return;\n }\n setUnified(result);\n } catch (error) {\n console.error(\"transactionSetup failed:\", error);\n callbacks.toast?.error?.(\"Unable to initialize payment. Please try again.\");\n }\n }, [callbacks]);\n\n // Step 2: Get card info after iframe entry\n const getCardInfo = useCallback(async () => {\n /* v8 ignore next -- defensive: caller (verifyUnified) already guards */\n if (!unified?.transactionSetupId) return;\n try {\n const result = await callbacks.cardInfo({ transactionSetupId: unified.transactionSetupId });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to verify card details. Please try again.\");\n return;\n }\n setUnifiedCc(result);\n } catch (error) {\n console.error(\"cardInfo failed:\", error);\n callbacks.toast?.error?.(\"Unable to verify card details. Please try again.\");\n }\n }, [unified, callbacks]);\n\n // Step 3: Validate payment\n const verifyUnified = useCallback(async () => {\n if (!unified?.transactionSetupId || !customerIdRef.current) return;\n try {\n const result = await callbacks.validatePayment({\n transactionSetupId: unified.transactionSetupId,\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Payment verification failed. Please try again.\");\n return;\n }\n setUnifiedResponse(result.valid);\n if (result.valid) {\n await getCardInfo();\n }\n } catch (error) {\n console.error(\"validatePayment failed:\", error);\n callbacks.toast?.error?.(\"Payment verification failed. Please try again.\");\n }\n }, [unified, getCardInfo, callbacks]);\n\n // Step 4: Get payment account info\n const getUnifiedPayment = useCallback(async () => {\n if (!unified?.transactionSetupId || !customerIdRef.current) return;\n try {\n const result = await callbacks.accountQuery({\n transactionSetupId: unified.transactionSetupId,\n customerId: String(customerIdRef.current),\n });\n if (!result) {\n callbacks.toast?.error?.(\"Unable to retrieve payment account. Please try again.\");\n return;\n }\n const payment = capturedBin && !result.Bin ? { ...result, Bin: capturedBin } : result;\n setUnifiedPayment(payment);\n } catch (error) {\n console.error(\"accountQuery failed:\", error);\n callbacks.toast?.error?.(\"Unable to retrieve payment account. Please try again.\");\n }\n }, [unified, capturedBin, callbacks]);\n\n // Step 5: Update billing info\n const updateUnifiedBilling = useCallback(async () => {\n /* v8 ignore next -- defensive: effect already guards billingAddress/unified */\n if (!unified?.transactionSetupId || !billingAddress) return;\n try {\n const result = await callbacks.billingUpdate({\n transactionSetupId: unified.transactionSetupId,\n address1: billingAddress.address1,\n address2: billingAddress.address2,\n city: billingAddress.city,\n state: billingAddress.state,\n zip: billingAddress.postalCode,\n });\n if (!result) {\n callbacks.toast?.error?.(\"Billing update failed. Please try again.\");\n return;\n }\n setUnifiedBilling(true);\n void getUnifiedPayment();\n } catch (error) {\n console.error(\"billingUpdate failed:\", error);\n callbacks.toast?.error?.(\"Billing update failed. Please try again.\");\n }\n }, [unified, billingAddress, getUnifiedPayment, callbacks]);\n\n // Close payment modal if preconditions are lost\n useEffect(() => {\n if (isOpen && (!shippingAccepted || paymentMethod !== \"credit-card\")) {\n setIsOpen(false);\n }\n }, [isOpen, shippingAccepted, paymentMethod]);\n\n // Initialize payment setup when modal opens with no transaction\n useEffect(() => {\n if (isOpen && shippingAccepted && paymentMethod === \"credit-card\" && unified === null) {\n void postUnified();\n }\n }, [isOpen, shippingAccepted, paymentMethod, unified, postUnified]);\n\n // Verify payment after modal closes\n useEffect(() => {\n if (!isOpen && unified !== null && shippingAccepted && paymentMethod === \"credit-card\") {\n void verifyUnified();\n }\n }, [isOpen, unified, shippingAccepted, paymentMethod, verifyUnified]);\n\n // Trigger billing update when card verified + billing address ready\n useEffect(() => {\n if (\n unifiedResponse &&\n billingAddress !== undefined &&\n unifiedCc?.transactionSetupId &&\n paymentMethod === \"credit-card\"\n ) {\n void updateUnifiedBilling();\n }\n }, [\n unifiedResponse,\n billingAddress,\n unifiedCc?.transactionSetupId,\n updateUnifiedBilling,\n paymentMethod,\n ]);\n\n // Reset all payment state when editing CC\n useEffect(() => {\n if (editCc) {\n setIsOpen(true);\n setUnified(null);\n setUnifiedCc(null);\n setUnifiedPayment(null);\n setUnifiedBilling(false);\n setUnifiedResponse(false);\n setCapturedBin(null);\n }\n }, [editCc]);\n\n return {\n isOpen,\n setIsOpen,\n editCc,\n setEditCc,\n unified,\n unifiedCc,\n unifiedResponse,\n unifiedBilling,\n unifiedPayment,\n capturedBin,\n handleBinCapture,\n };\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/** Parameters for order readiness validation. */\nexport interface OrderReadinessParams {\n cartHdrUid: string | number | undefined;\n shippingAddress: unknown;\n billingAddress: unknown;\n shippingMethodSaved: boolean;\n showBillingInfoSummary: boolean;\n processingOrder: boolean;\n paymentMethod: string;\n unifiedPaymentAccountId: string | undefined;\n unifiedBilling: boolean;\n isFreeShipping: boolean;\n carrierId: string;\n shippingFee: number | undefined;\n isEditShippingInfo: boolean;\n isEditShippingMethods: boolean;\n isEditBillingInfo: boolean;\n editCc: boolean;\n /** Site-provided function to check if the order is ready. Overrides default logic when provided. */\n customReadinessCheck?: (params: OrderReadinessParams) => boolean;\n}\n\n/**\n * Pure function that determines if an order is ready to submit.\n *\n * Checks all gates: cart exists, addresses present, shipping method saved,\n * billing shown, payment complete (for credit card), shipping fee present\n * (for non-free, non-pickup orders), and no sections being edited.\n */\nexport function determineOrderReadiness(params: OrderReadinessParams): boolean {\n if (params.customReadinessCheck) {\n return params.customReadinessCheck(params);\n }\n\n if (!params.cartHdrUid) return false;\n\n // Block if any section is being edited or addresses are missing\n const blockers = [\n params.isEditShippingInfo,\n params.isEditShippingMethods,\n params.isEditBillingInfo,\n params.editCc,\n params.shippingAddress === undefined,\n params.billingAddress === undefined,\n !params.shippingMethodSaved,\n !params.showBillingInfoSummary,\n params.processingOrder,\n ];\n if (blockers.some(Boolean)) return false;\n\n // Credit card requires completed payment flow\n if (\n params.paymentMethod === \"credit-card\" &&\n (!params.unifiedPaymentAccountId || !params.unifiedBilling)\n ) {\n return false;\n }\n\n // Non-free shipping requires a fee (unless carrier is pickup/freight)\n if (!params.isFreeShipping && params.shippingFee === undefined) {\n return false;\n }\n\n return true;\n}\n\n/**\n * Debounced order readiness hook.\n *\n * Recomputes readiness 300ms after any dependency changes to avoid\n * excessive re-renders during rapid state transitions (e.g., typing\n * in address fields).\n */\nexport function useOrderReadiness(params: OrderReadinessParams) {\n const [enableProcessOrderBtn, setEnableProcessOrderBtn] = useState(false);\n const [processingValidation, setProcessingValidation] = useState(false);\n\n useEffect(() => {\n setProcessingValidation(true);\n\n const timeoutId = setTimeout(() => {\n const ready = determineOrderReadiness(params);\n setEnableProcessOrderBtn(ready);\n setProcessingValidation(false);\n }, 300);\n\n return () => clearTimeout(timeoutId);\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [\n params.billingAddress,\n params.shippingAddress,\n params.isEditShippingInfo,\n params.isEditShippingMethods,\n params.isEditBillingInfo,\n params.editCc,\n params.isFreeShipping,\n params.unifiedPaymentAccountId,\n params.unifiedBilling,\n params.paymentMethod,\n params.processingOrder,\n params.carrierId,\n params.shippingFee,\n params.shippingMethodSaved,\n params.showBillingInfoSummary,\n params.cartHdrUid,\n ]);\n\n return { enableProcessOrderBtn, processingValidation };\n}\n"]}