@simpleapps-com/augur-hooks 2.4.0 → 2026.11.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/EXPORTS.md +25 -65
  2. package/README.md +21 -246
  3. package/dist/checkout/create-checkout-provider.d.ts +25 -0
  4. package/dist/checkout/create-checkout-provider.d.ts.map +1 -0
  5. package/dist/checkout/index.cjs +123 -106
  6. package/dist/checkout/index.cjs.map +1 -1
  7. package/dist/checkout/index.d.ts +5 -293
  8. package/dist/checkout/index.d.ts.map +1 -0
  9. package/dist/checkout/index.js +99 -82
  10. package/dist/checkout/index.js.map +1 -1
  11. package/dist/checkout/{index.d.cts → types.d.ts} +18 -40
  12. package/dist/checkout/types.d.ts.map +1 -0
  13. package/dist/chunk-6Z6JGK2C.cjs.map +1 -1
  14. package/dist/chunk-JJX23M5N.js +532 -0
  15. package/dist/chunk-JJX23M5N.js.map +1 -0
  16. package/dist/chunk-UZAFXUAO.cjs +532 -0
  17. package/dist/chunk-UZAFXUAO.cjs.map +1 -0
  18. package/dist/duration.d.ts +16 -0
  19. package/dist/duration.d.ts.map +1 -0
  20. package/dist/hooks/use-cart-actions.d.ts +68 -0
  21. package/dist/hooks/use-cart-actions.d.ts.map +1 -0
  22. package/dist/hooks/use-cart-initialization.d.ts +60 -0
  23. package/dist/hooks/use-cart-initialization.d.ts.map +1 -0
  24. package/dist/hooks/use-cart-pricing.d.ts +41 -0
  25. package/dist/hooks/use-cart-pricing.d.ts.map +1 -0
  26. package/dist/hooks/use-checkout-persistence.d.ts +41 -0
  27. package/dist/hooks/use-checkout-persistence.d.ts.map +1 -0
  28. package/dist/hooks/use-debounce.d.ts +6 -0
  29. package/dist/hooks/use-debounce.d.ts.map +1 -0
  30. package/dist/hooks/use-format-price.d.ts +29 -0
  31. package/dist/hooks/use-format-price.d.ts.map +1 -0
  32. package/dist/hooks/use-latest.d.ts +8 -0
  33. package/dist/hooks/use-latest.d.ts.map +1 -0
  34. package/dist/hooks/use-modal-lifecycle.d.ts +11 -0
  35. package/dist/hooks/use-modal-lifecycle.d.ts.map +1 -0
  36. package/dist/hooks/use-order-readiness.d.ts +47 -0
  37. package/dist/hooks/use-order-readiness.d.ts.map +1 -0
  38. package/dist/hooks/use-pagination-prefetch.d.ts +27 -0
  39. package/dist/hooks/use-pagination-prefetch.d.ts.map +1 -0
  40. package/dist/{use-order-readiness-DZTIfRzw.d.ts → hooks/use-payment-flow.d.ts} +23 -67
  41. package/dist/hooks/use-payment-flow.d.ts.map +1 -0
  42. package/dist/hooks/use-stock.d.ts +32 -0
  43. package/dist/hooks/use-stock.d.ts.map +1 -0
  44. package/dist/index.cjs +227 -184
  45. package/dist/index.cjs.map +1 -1
  46. package/dist/index.d.ts +32 -456
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +205 -162
  49. package/dist/index.js.map +1 -1
  50. package/dist/persistence/apply-limits.d.ts +8 -0
  51. package/dist/persistence/apply-limits.d.ts.map +1 -0
  52. package/dist/persistence/create-persister.d.ts +10 -0
  53. package/dist/persistence/create-persister.d.ts.map +1 -0
  54. package/dist/persistence/serializer.d.ts +11 -0
  55. package/dist/persistence/serializer.d.ts.map +1 -0
  56. package/dist/persistence/use-persistence.d.ts +59 -0
  57. package/dist/persistence/use-persistence.d.ts.map +1 -0
  58. package/dist/persistence/use-storage-monitor.d.ts +11 -0
  59. package/dist/persistence/use-storage-monitor.d.ts.map +1 -0
  60. package/dist/provider.d.ts +89 -0
  61. package/dist/provider.d.ts.map +1 -0
  62. package/dist/queries/batch-query.d.ts +23 -0
  63. package/dist/queries/batch-query.d.ts.map +1 -0
  64. package/dist/queries/index.d.ts +3 -0
  65. package/dist/queries/index.d.ts.map +1 -0
  66. package/dist/query-action-registry.d.ts +19 -0
  67. package/dist/query-action-registry.d.ts.map +1 -0
  68. package/dist/rules.d.ts +133 -0
  69. package/dist/rules.d.ts.map +1 -0
  70. package/dist/server.cjs +2 -1
  71. package/dist/server.cjs.map +1 -1
  72. package/dist/server.d.ts +10 -12
  73. package/dist/server.d.ts.map +1 -0
  74. package/dist/server.js +2 -1
  75. package/dist/server.js.map +1 -1
  76. package/dist/stores/cart-store.d.ts +51 -0
  77. package/dist/stores/cart-store.d.ts.map +1 -0
  78. package/dist/stores/items-filters-store.d.ts +30 -0
  79. package/dist/stores/items-filters-store.d.ts.map +1 -0
  80. package/dist/types.d.ts +48 -0
  81. package/dist/types.d.ts.map +1 -0
  82. package/dist/web/use-image-with-fallback.d.ts +16 -0
  83. package/dist/web/use-image-with-fallback.d.ts.map +1 -0
  84. package/dist/web/use-mobile-detection.d.ts +28 -0
  85. package/dist/web/use-mobile-detection.d.ts.map +1 -0
  86. package/dist/web/use-mobile-optimized-intersection.d.ts +17 -0
  87. package/dist/web/use-mobile-optimized-intersection.d.ts.map +1 -0
  88. package/dist/web.cjs.map +1 -1
  89. package/dist/web.d.ts +4 -60
  90. package/dist/web.d.ts.map +1 -0
  91. package/dist/web.js.map +1 -1
  92. package/llms.txt +76 -54
  93. package/package.json +26 -14
  94. package/dist/batch-query-CTlvxSmL.d.cts +0 -165
  95. package/dist/batch-query-CTlvxSmL.d.ts +0 -165
  96. package/dist/chunk-F5DUFW57.cjs +0 -383
  97. package/dist/chunk-F5DUFW57.cjs.map +0 -1
  98. package/dist/chunk-JNOHB4OP.js +0 -383
  99. package/dist/chunk-JNOHB4OP.js.map +0 -1
  100. package/dist/index.d.cts +0 -456
  101. package/dist/server.d.cts +0 -44
  102. package/dist/use-order-readiness-DZTIfRzw.d.cts +0 -137
  103. package/dist/web.d.cts +0 -60
@@ -0,0 +1,23 @@
1
+ import type { QueryClient } from "@tanstack/react-query";
2
+ export interface BatchQueryConfig<TParam, TData> {
3
+ params: TParam[];
4
+ queryClient: QueryClient;
5
+ /** Build individual cache key for a single param. */
6
+ getItemKey: (param: TParam) => readonly unknown[];
7
+ /** Build the string key for the result Record from a param. */
8
+ getResultKey: (param: TParam) => string;
9
+ /** Fetch only uncached items, return keyed Record. */
10
+ fetchItems: (uncached: TParam[]) => Promise<Record<string, TData>>;
11
+ /** Extract individual cache key from a fetched result entry (for seeding). */
12
+ getSeedKey: (resultKey: string, data: TData) => readonly unknown[];
13
+ }
14
+ /**
15
+ * Generic batch query executor.
16
+ *
17
+ * 1. Checks queryClient cache for each param
18
+ * 2. Fetches only uncached items in a single batch call
19
+ * 3. Seeds individual cache entries from the response
20
+ * 4. Returns merged cached + fetched record
21
+ */
22
+ export declare function executeBatchQuery<TParam, TData>(config: BatchQueryConfig<TParam, TData>): Promise<Record<string, TData>>;
23
+ //# sourceMappingURL=batch-query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch-query.d.ts","sourceRoot":"","sources":["../../src/queries/batch-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,KAAK;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,qDAAqD;IACrD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,CAAC;IAClD,+DAA+D;IAC/D,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,sDAAsD;IACtD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnE,8EAA8E;IAC9E,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,OAAO,EAAE,CAAC;CACpE;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EACnD,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CA8BhC"}
@@ -0,0 +1,3 @@
1
+ export { executeBatchQuery } from "./batch-query";
2
+ export type { BatchQueryConfig } from "./batch-query";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queries/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Lightweight registry for a query action function.
3
+ *
4
+ * augur-server/hooks.ts registers its queryAction as a side effect when
5
+ * imported. augur-hooks consumers (useCartPricing, useStock, the provider)
6
+ * read from this registry to route data through server actions automatically.
7
+ *
8
+ * No circular dependency: augur-server depends on augur-hooks and writes here.
9
+ * augur-hooks reads from its own module.
10
+ */
11
+ type QueryActionFn = (methodPath: string, ...args: unknown[]) => Promise<unknown>;
12
+ /** Register a query action function (called by augur-server/hooks.ts on import). */
13
+ export declare function registerQueryAction(fn: QueryActionFn): void;
14
+ /** Returns the registered query action, or null if none registered. */
15
+ export declare function getRegisteredQueryAction(): QueryActionFn | null;
16
+ /** Clears the registered query action. Used in tests only. @internal */
17
+ export declare function clearRegisteredQueryAction(): void;
18
+ export {};
19
+ //# sourceMappingURL=query-action-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-action-registry.d.ts","sourceRoot":"","sources":["../src/query-action-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,KAAK,aAAa,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAIlF,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,IAAI,aAAa,GAAG,IAAI,CAE/D;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}
@@ -0,0 +1,133 @@
1
+ import type { Millis } from "./duration";
2
+ /**
3
+ * The cart's quantity total: `acc` plus each quantity from index `i` on, added left to right as
4
+ * `reduce` does (each line's quantity, null or NaN as 0, already taken by the caller).
5
+ *
6
+ * @ensures result = acc + Σ_{k ≥ i} quantities[k], the model's QuantityTotal at acc = i = 0
7
+ */
8
+ export declare function quantityTotalFrom(quantities: number[], i: number, acc: number): number;
9
+ /**
10
+ * A cart line's quantity with null as 0.
11
+ *
12
+ * @ensures result = q ?? 0, the model's QtyOrZero
13
+ */
14
+ export declare function qtyOrZero(q: number | null): number;
15
+ /**
16
+ * The first index from `i` whose item uid is `uid`, or −1 (JS `findIndex` at i = 0).
17
+ *
18
+ * @ensures exactly the model's IndexOfUid
19
+ */
20
+ export declare function indexOfUidFrom(uids: number[], uid: number, i: number): number;
21
+ /**
22
+ * Reversing an add keeps a matched line only while something is left of it.
23
+ *
24
+ * @ensures result ⟺ (current ?? 0) − q > 0, the model's ReverseAdd keep rule
25
+ */
26
+ export declare function keepsAfterReverse(current: number | null, q: number): boolean;
27
+ /**
28
+ * requireCartUid: a missing or 0 uid refuses (null); the hooks throw on it.
29
+ *
30
+ * @ensures result = null ⟺ uid ∈ {undefined, 0}; otherwise result = uid
31
+ */
32
+ export declare function requiredCartUid(uid: number | undefined): number | null;
33
+ /**
34
+ * resolveCartHdrUid (checkout): a missing uid is 0; any other passes unchanged.
35
+ *
36
+ * @ensures result = uid ?? 0
37
+ */
38
+ export declare function checkoutCartUid(uid: number | undefined): number;
39
+ /**
40
+ * The initial payment method: the site hook's non-empty answer, else credit card when payments
41
+ * are configured, else invoice.
42
+ *
43
+ * @ensures exactly the model's DefaultPaymentMethod
44
+ */
45
+ export declare function defaultPaymentMethodOf(fromHook: string | undefined, hasCallbacks: boolean): string;
46
+ /** The default order gates' inputs, each already reduced to a flag by the caller. */
47
+ export interface ReadinessFlags {
48
+ cartUidSet: boolean;
49
+ editShippingInfo: boolean;
50
+ editShippingMethods: boolean;
51
+ editBillingInfo: boolean;
52
+ editCc: boolean;
53
+ hasShippingAddress: boolean;
54
+ hasBillingAddress: boolean;
55
+ methodSaved: boolean;
56
+ showBillingSummary: boolean;
57
+ processing: boolean;
58
+ isCreditCard: boolean;
59
+ hasAccountId: boolean;
60
+ hasUnifiedBilling: boolean;
61
+ isFreeShipping: boolean;
62
+ hasShippingFee: boolean;
63
+ }
64
+ /**
65
+ * The default gates: a cart, nothing being edited, both addresses, a saved method, the billing
66
+ * summary shown, not processing, a completed card flow for credit card, and a fee unless
67
+ * shipping is free.
68
+ *
69
+ * @ensures exactly the model's DefaultReady
70
+ */
71
+ export declare function defaultReady(r: ReadinessFlags): boolean;
72
+ /**
73
+ * A site's own readiness answer wins; undefined defers to the default gates.
74
+ *
75
+ * @ensures result = custom ?? defaultReady
76
+ */
77
+ export declare function orderReadyOf(custom: boolean | undefined, ready: boolean): boolean;
78
+ /** The pre-submit outcome: go ahead, the site cancelled it, or refused with a message. */
79
+ export type PreSubmit = {
80
+ kind: "ok";
81
+ } | {
82
+ kind: "cancelled";
83
+ } | {
84
+ kind: "refused";
85
+ message: string;
86
+ };
87
+ /**
88
+ * runPreSubmitChecks: the site's validation error first (an empty one is no error), then its
89
+ * beforeSubmit veto, then a missing shipping address.
90
+ *
91
+ * @ensures exactly the model's PreSubmitOutcome (an empty validation error as None)
92
+ */
93
+ export declare function preSubmitOutcome(validateError: string | undefined, beforeSubmitFalse: boolean, hasShippingAddress: boolean): PreSubmit;
94
+ /**
95
+ * A cookie entry's `split("=")[1]`: the text between the first and second "=" (to the end with
96
+ * no second), or "" with no "=". A token holding "=" is cut at it, as before.
97
+ *
98
+ * @ensures exactly the model's SecondEqualsField
99
+ */
100
+ export declare function secondEqualsField(s: string): string;
101
+ /**
102
+ * A saved checkout entry is expired once more than `ttl` has passed since it was saved (all
103
+ * three `Millis`: the clock, the saved-at reading, the duration).
104
+ *
105
+ * @ensures result ⟺ now − savedAt > ttl
106
+ */
107
+ export declare function isExpired(now: Millis, savedAt: Millis, ttl: Millis): boolean;
108
+ /**
109
+ * A query is persisted iff it has a string head that is listed and it succeeded.
110
+ *
111
+ * @ensures exactly the model's ShouldPersist, with the listing already looked up
112
+ */
113
+ export declare function shouldPersistOf(hasHead: boolean, succeeded: boolean, listed: boolean): boolean;
114
+ /**
115
+ * 2ⁿ.
116
+ *
117
+ * @ensures result = 2ⁿ, the model's Pow2
118
+ */
119
+ export declare function pow2(n: number): number;
120
+ /**
121
+ * A stock fetch's retry delay: 2ⁿ seconds, at most 10 s (n ≥ 4 is always the cap), as
122
+ * React Query's `Millis`.
123
+ *
124
+ * @ensures exactly the model's StockRetryDelay
125
+ */
126
+ export declare function stockRetryDelay(attemptIndex: number): Millis;
127
+ /**
128
+ * useStock fetches only when enabled (default true) and given a uid.
129
+ *
130
+ * @ensures exactly the model's StockEnabled
131
+ */
132
+ export declare function stockEnabled(enabled: boolean | undefined, uidSet: boolean): boolean;
133
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"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"}
package/dist/server.cjs CHANGED
@@ -7,11 +7,12 @@ var _chunk6Z6JGK2Ccjs = require('./chunk-6Z6JGK2C.cjs');
7
7
  var _react = require('react');
8
8
  var _reactquery = require('@tanstack/react-query');
9
9
  var _augurcore = require('@simpleapps-com/augur-core');
10
+ var _augurutils = require('@simpleapps-com/augur-utils');
10
11
  var getQueryClient = _react.cache.call(void 0,
11
12
  () => new (0, _reactquery.QueryClient)({
12
13
  defaultOptions: {
13
14
  queries: {
14
- staleTime: 60 * 1e3,
15
+ staleTime: _augurutils.toMillis.call(void 0, _augurutils.minutes.call(void 0, 1)),
15
16
  refetchOnWindowFocus: false
16
17
  }
17
18
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/server.cjs","../src/server.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACFA,8BAAsB;AACtB,mDAA4B;AAC5B,uDAA2D;AAiBpD,IAAM,eAAA,EAAiB,0BAAA;AAAA,EAC5B,CAAA,EAAA,GACE,IAAI,4BAAA,CAAY;AAAA,IACd,cAAA,EAAgB;AAAA,MACd,OAAA,EAAS;AAAA,QACP,SAAA,EAAW,GAAA,EAAK,GAAA;AAAA,QAChB,oBAAA,EAAsB;AAAA,MACxB;AAAA,IACF;AAAA,EACF,CAAC;AACL,CAAA;AA2BO,SAAS,kBAAA,CACd,gBAAA,EACA,WAAA,EACwB;AACxB,EAAA,MAAM,YAAA,EAA8C,YAAA,EAChD,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,WAAA,CAAY,MAAA,EAAQ,UAAA,EAAY,WAAA,CAAY,WAAW,EAAE,EAAA,EAC5E,KAAA,CAAA;AAGJ,EAAA,GAAA,CAAI,OAAO,iBAAA,IAAqB,UAAA,EAAY;AAC1C,IAAA,OAAO,+CAAA,gBAA6B,EAAmC,WAAW,CAAA;AAAA,EACpF;AAGA,EAAA,GAAA,CAAI,gBAAA,EAAkB;AACpB,IAAA,OAAO,2CAAA,gBAAmB,EAAkB,WAAW,CAAA;AAAA,EACzD;AAGA,EAAA,MAAM,iBAAA,EAAmB,wDAAA,CAAyB;AAClD,EAAA,GAAA,CAAI,gBAAA,EAAkB;AACpB,IAAA,OAAO,+CAAA,gBAA6B,EAAkB,WAAW,CAAA;AAAA,EACnE;AAEA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR;AAAA,EAEF,CAAA;AACF;ADpDA;AACE;AACA;AACA;AACF,0JAAC","file":"/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/server.cjs","sourcesContent":[null,"// @simpleapps-com/augur-hooks/server\n// Query options, keys, and utilities for server-side prefetching in Next.js App Router.\n\nimport { cache } from \"react\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { createOptionsProxy, createQueryActionProxy } from \"@simpleapps-com/augur-core\";\nimport type {\n DeepQueryOptions,\n OptionsProxyConfig,\n CacheConfig,\n QueryActionFn,\n} from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/**\n * Returns a per-request singleton QueryClient for React Server Components.\n *\n * React's `cache()` deduplicates calls within a single server request,\n * so layout, page, and header all share the same prefetch cache without\n * leaking state between requests.\n */\nexport const getQueryClient = cache(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: 60 * 1000,\n refetchOnWindowFocus: false,\n },\n },\n }),\n);\n\n/**\n * Creates server-side query options proxy for prefetching.\n *\n * Uses the same augur-core proxy as `useAugurOptions()`, so query keys\n * are identical on server and client — SSR hydration is automatic.\n *\n * Accepts either an SDK client instance or a queryAction function.\n * When called with no arguments, uses the auto-registered queryAction\n * (registered by augur-server/hooks on import).\n *\n * @example\n * ```ts\n * // With SDK client (traditional)\n * const q = createAugurOptions(site.client, cacheConfig);\n *\n * // With queryAction (server-only JWT sites)\n * import { queryAction } from \"@simpleapps-com/augur-server/query-action\";\n * const q = createAugurOptions(queryAction, cacheConfig);\n *\n * // With auto-registered queryAction (zero args -- requires augur-server/hooks import)\n * const q = createAugurOptions();\n *\n * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));\n * ```\n */\nexport function createAugurOptions<TApi extends object = AugurAPI>(\n apiOrQueryAction?: TApi | QueryActionFn,\n cacheConfig?: CacheConfig,\n): DeepQueryOptions<TApi> {\n const proxyConfig: OptionsProxyConfig | undefined = cacheConfig\n ? { cache: { static: cacheConfig.static, semiStatic: cacheConfig.semiStatic } }\n : undefined;\n\n // If a function is passed, treat it as a queryAction\n if (typeof apiOrQueryAction === \"function\") {\n return createQueryActionProxy<TApi>(apiOrQueryAction as QueryActionFn, proxyConfig);\n }\n\n // If an object is passed, treat it as an SDK client\n if (apiOrQueryAction) {\n return createOptionsProxy(apiOrQueryAction, proxyConfig);\n }\n\n // No args — use auto-registered queryAction\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) {\n return createQueryActionProxy<TApi>(registeredAction, proxyConfig);\n }\n\n throw new Error(\n \"createAugurOptions() requires either an SDK client, a queryAction function, or \" +\n \"a registered queryAction (import augur-server/hooks to auto-register).\",\n );\n}\n\n// All pure query options and keys (legacy)\nexport * from \"./queries\";\n\n// Re-export shared types from augur-core\nexport type { AugurAuthContext, InfiniteScrollPage, CacheConfig } from \"@simpleapps-com/augur-core\";\n\n// Types needed for server-side usage (type-only, erased at compile time)\nexport type { AugurApiClient } from \"./provider\";\nexport type { PageData } from \"./types\";\n"]}
1
+ {"version":3,"sources":["/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/server.cjs","../src/server.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACFA,8BAAsB;AACtB,mDAA4B;AAC5B,uDAA2D;AAC3D,yDAAkC;AAiB3B,IAAM,eAAA,EAAiB,0BAAA;AAAA,EAC5B,CAAA,EAAA,GACE,IAAI,4BAAA,CAAY;AAAA,IACd,cAAA,EAAgB;AAAA,MACd,OAAA,EAAS;AAAA,QACP,SAAA,EAAW,kCAAA,iCAAS,CAAS,CAAC,CAAA;AAAA,QAC9B,oBAAA,EAAsB;AAAA,MACxB;AAAA,IACF;AAAA,EACF,CAAC;AACL,CAAA;AA2BO,SAAS,kBAAA,CACd,gBAAA,EACA,WAAA,EACwB;AACxB,EAAA,MAAM,YAAA,EAA8C,YAAA,EAChD,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,WAAA,CAAY,MAAA,EAAQ,UAAA,EAAY,WAAA,CAAY,WAAW,EAAE,EAAA,EAC5E,KAAA,CAAA;AAGJ,EAAA,GAAA,CAAI,OAAO,iBAAA,IAAqB,UAAA,EAAY;AAC1C,IAAA,OAAO,+CAAA,gBAA6B,EAAmC,WAAW,CAAA;AAAA,EACpF;AAGA,EAAA,GAAA,CAAI,gBAAA,EAAkB;AACpB,IAAA,OAAO,2CAAA,gBAAmB,EAAkB,WAAW,CAAA;AAAA,EACzD;AAGA,EAAA,MAAM,iBAAA,EAAmB,wDAAA,CAAyB;AAClD,EAAA,GAAA,CAAI,gBAAA,EAAkB;AACpB,IAAA,OAAO,+CAAA,gBAA6B,EAAkB,WAAW,CAAA;AAAA,EACnE;AAEA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR;AAAA,EAEF,CAAA;AACF;ADpDA;AACE;AACA;AACA;AACF,0JAAC","file":"/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/server.cjs","sourcesContent":[null,"// @simpleapps-com/augur-hooks/server\n// Query options, keys, and utilities for server-side prefetching in Next.js App Router.\n\nimport { cache } from \"react\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { createOptionsProxy, createQueryActionProxy } from \"@simpleapps-com/augur-core\";\nimport { minutes, toMillis } from \"@simpleapps-com/augur-utils\";\nimport type {\n DeepQueryOptions,\n OptionsProxyConfig,\n CacheConfig,\n QueryActionFn,\n} from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/**\n * Returns a per-request singleton QueryClient for React Server Components.\n *\n * React's `cache()` deduplicates calls within a single server request,\n * so layout, page, and header all share the same prefetch cache without\n * leaking state between requests.\n */\nexport const getQueryClient = cache(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: toMillis(minutes(1)),\n refetchOnWindowFocus: false,\n },\n },\n }),\n);\n\n/**\n * Creates server-side query options proxy for prefetching.\n *\n * Uses the same augur-core proxy as `useAugurOptions()`, so query keys\n * are identical on server and client — SSR hydration is automatic.\n *\n * Accepts either an SDK client instance or a queryAction function.\n * When called with no arguments, uses the auto-registered queryAction\n * (registered by augur-server/hooks on import).\n *\n * @example\n * ```ts\n * // With SDK client (traditional)\n * const q = createAugurOptions(site.client, cacheConfig);\n *\n * // With queryAction (server-only JWT sites)\n * import { queryAction } from \"@simpleapps-com/augur-server/query-action\";\n * const q = createAugurOptions(queryAction, cacheConfig);\n *\n * // With auto-registered queryAction (zero args -- requires augur-server/hooks import)\n * const q = createAugurOptions();\n *\n * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));\n * ```\n */\nexport function createAugurOptions<TApi extends object = AugurAPI>(\n apiOrQueryAction?: TApi | QueryActionFn,\n cacheConfig?: CacheConfig,\n): DeepQueryOptions<TApi> {\n const proxyConfig: OptionsProxyConfig | undefined = cacheConfig\n ? { cache: { static: cacheConfig.static, semiStatic: cacheConfig.semiStatic } }\n : undefined;\n\n // If a function is passed, treat it as a queryAction\n if (typeof apiOrQueryAction === \"function\") {\n return createQueryActionProxy<TApi>(apiOrQueryAction as QueryActionFn, proxyConfig);\n }\n\n // If an object is passed, treat it as an SDK client\n if (apiOrQueryAction) {\n return createOptionsProxy(apiOrQueryAction, proxyConfig);\n }\n\n // No args — use auto-registered queryAction\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) {\n return createQueryActionProxy<TApi>(registeredAction, proxyConfig);\n }\n\n throw new Error(\n \"createAugurOptions() requires either an SDK client, a queryAction function, or \" +\n \"a registered queryAction (import augur-server/hooks to auto-register).\",\n );\n}\n\n// All pure query options and keys (legacy)\nexport * from \"./queries\";\n\n// Re-export shared types from augur-core\nexport type { AugurAuthContext, InfiniteScrollPage, CacheConfig } from \"@simpleapps-com/augur-core\";\n\n// Types needed for server-side usage (type-only, erased at compile time)\nexport type { AugurApiClient } from \"./provider\";\nexport type { PageData } from \"./types\";\n"]}
package/dist/server.d.ts CHANGED
@@ -1,11 +1,6 @@
1
- import { QueryClient } from '@tanstack/react-query';
2
- import { QueryActionFn, CacheConfig, DeepQueryOptions } from '@simpleapps-com/augur-core';
3
- export { AugurAuthContext, CacheConfig, InfiniteScrollPage } from '@simpleapps-com/augur-core';
4
- import { AugurAPI } from '@simpleapps-com/augur-api';
5
- export { A as AugurApiClient, B as BatchQueryConfig, b as PageData, e as executeBatchQuery } from './batch-query-CTlvxSmL.js';
6
- import 'react/jsx-runtime';
7
- import 'react';
8
-
1
+ import { QueryClient } from "@tanstack/react-query";
2
+ import type { DeepQueryOptions, CacheConfig, QueryActionFn } from "@simpleapps-com/augur-core";
3
+ import type { AugurAPI } from "@simpleapps-com/augur-api";
9
4
  /**
10
5
  * Returns a per-request singleton QueryClient for React Server Components.
11
6
  *
@@ -13,7 +8,7 @@ import 'react';
13
8
  * so layout, page, and header all share the same prefetch cache without
14
9
  * leaking state between requests.
15
10
  */
16
- declare const getQueryClient: () => QueryClient;
11
+ export declare const getQueryClient: () => QueryClient;
17
12
  /**
18
13
  * Creates server-side query options proxy for prefetching.
19
14
  *
@@ -39,6 +34,9 @@ declare const getQueryClient: () => QueryClient;
39
34
  * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));
40
35
  * ```
41
36
  */
42
- declare function createAugurOptions<TApi extends object = AugurAPI>(apiOrQueryAction?: TApi | QueryActionFn, cacheConfig?: CacheConfig): DeepQueryOptions<TApi>;
43
-
44
- export { createAugurOptions, getQueryClient };
37
+ export declare function createAugurOptions<TApi extends object = AugurAPI>(apiOrQueryAction?: TApi | QueryActionFn, cacheConfig?: CacheConfig): DeepQueryOptions<TApi>;
38
+ export * from "./queries";
39
+ export type { AugurAuthContext, InfiniteScrollPage, CacheConfig } from "@simpleapps-com/augur-core";
40
+ export type { AugurApiClient } from "./provider";
41
+ export type { PageData } from "./types";
42
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EACX,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,mBAU1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,MAAM,GAAG,QAAQ,EAC/D,gBAAgB,CAAC,EAAE,IAAI,GAAG,aAAa,EACvC,WAAW,CAAC,EAAE,WAAW,GACxB,gBAAgB,CAAC,IAAI,CAAC,CAyBxB;AAGD,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGpG,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
package/dist/server.js CHANGED
@@ -7,11 +7,12 @@ import {
7
7
  import { cache } from "react";
8
8
  import { QueryClient } from "@tanstack/react-query";
9
9
  import { createOptionsProxy, createQueryActionProxy } from "@simpleapps-com/augur-core";
10
+ import { minutes, toMillis } from "@simpleapps-com/augur-utils";
10
11
  var getQueryClient = cache(
11
12
  () => new QueryClient({
12
13
  defaultOptions: {
13
14
  queries: {
14
- staleTime: 60 * 1e3,
15
+ staleTime: toMillis(minutes(1)),
15
16
  refetchOnWindowFocus: false
16
17
  }
17
18
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/server.ts"],"sourcesContent":["// @simpleapps-com/augur-hooks/server\n// Query options, keys, and utilities for server-side prefetching in Next.js App Router.\n\nimport { cache } from \"react\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { createOptionsProxy, createQueryActionProxy } from \"@simpleapps-com/augur-core\";\nimport type {\n DeepQueryOptions,\n OptionsProxyConfig,\n CacheConfig,\n QueryActionFn,\n} from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/**\n * Returns a per-request singleton QueryClient for React Server Components.\n *\n * React's `cache()` deduplicates calls within a single server request,\n * so layout, page, and header all share the same prefetch cache without\n * leaking state between requests.\n */\nexport const getQueryClient = cache(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: 60 * 1000,\n refetchOnWindowFocus: false,\n },\n },\n }),\n);\n\n/**\n * Creates server-side query options proxy for prefetching.\n *\n * Uses the same augur-core proxy as `useAugurOptions()`, so query keys\n * are identical on server and client — SSR hydration is automatic.\n *\n * Accepts either an SDK client instance or a queryAction function.\n * When called with no arguments, uses the auto-registered queryAction\n * (registered by augur-server/hooks on import).\n *\n * @example\n * ```ts\n * // With SDK client (traditional)\n * const q = createAugurOptions(site.client, cacheConfig);\n *\n * // With queryAction (server-only JWT sites)\n * import { queryAction } from \"@simpleapps-com/augur-server/query-action\";\n * const q = createAugurOptions(queryAction, cacheConfig);\n *\n * // With auto-registered queryAction (zero args -- requires augur-server/hooks import)\n * const q = createAugurOptions();\n *\n * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));\n * ```\n */\nexport function createAugurOptions<TApi extends object = AugurAPI>(\n apiOrQueryAction?: TApi | QueryActionFn,\n cacheConfig?: CacheConfig,\n): DeepQueryOptions<TApi> {\n const proxyConfig: OptionsProxyConfig | undefined = cacheConfig\n ? { cache: { static: cacheConfig.static, semiStatic: cacheConfig.semiStatic } }\n : undefined;\n\n // If a function is passed, treat it as a queryAction\n if (typeof apiOrQueryAction === \"function\") {\n return createQueryActionProxy<TApi>(apiOrQueryAction as QueryActionFn, proxyConfig);\n }\n\n // If an object is passed, treat it as an SDK client\n if (apiOrQueryAction) {\n return createOptionsProxy(apiOrQueryAction, proxyConfig);\n }\n\n // No args — use auto-registered queryAction\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) {\n return createQueryActionProxy<TApi>(registeredAction, proxyConfig);\n }\n\n throw new Error(\n \"createAugurOptions() requires either an SDK client, a queryAction function, or \" +\n \"a registered queryAction (import augur-server/hooks to auto-register).\",\n );\n}\n\n// All pure query options and keys (legacy)\nexport * from \"./queries\";\n\n// Re-export shared types from augur-core\nexport type { AugurAuthContext, InfiniteScrollPage, CacheConfig } from \"@simpleapps-com/augur-core\";\n\n// Types needed for server-side usage (type-only, erased at compile time)\nexport type { AugurApiClient } from \"./provider\";\nexport type { PageData } from \"./types\";\n"],"mappings":";;;;;;AAGA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB,8BAA8B;AAiBpD,IAAM,iBAAiB;AAAA,EAC5B,MACE,IAAI,YAAY;AAAA,IACd,gBAAgB;AAAA,MACd,SAAS;AAAA,QACP,WAAW,KAAK;AAAA,QAChB,sBAAsB;AAAA,MACxB;AAAA,IACF;AAAA,EACF,CAAC;AACL;AA2BO,SAAS,mBACd,kBACA,aACwB;AACxB,QAAM,cAA8C,cAChD,EAAE,OAAO,EAAE,QAAQ,YAAY,QAAQ,YAAY,YAAY,WAAW,EAAE,IAC5E;AAGJ,MAAI,OAAO,qBAAqB,YAAY;AAC1C,WAAO,uBAA6B,kBAAmC,WAAW;AAAA,EACpF;AAGA,MAAI,kBAAkB;AACpB,WAAO,mBAAmB,kBAAkB,WAAW;AAAA,EACzD;AAGA,QAAM,mBAAmB,yBAAyB;AAClD,MAAI,kBAAkB;AACpB,WAAO,uBAA6B,kBAAkB,WAAW;AAAA,EACnE;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAEF;AACF;","names":[]}
1
+ {"version":3,"sources":["../src/server.ts"],"sourcesContent":["// @simpleapps-com/augur-hooks/server\n// Query options, keys, and utilities for server-side prefetching in Next.js App Router.\n\nimport { cache } from \"react\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { createOptionsProxy, createQueryActionProxy } from \"@simpleapps-com/augur-core\";\nimport { minutes, toMillis } from \"@simpleapps-com/augur-utils\";\nimport type {\n DeepQueryOptions,\n OptionsProxyConfig,\n CacheConfig,\n QueryActionFn,\n} from \"@simpleapps-com/augur-core\";\nimport type { AugurAPI } from \"@simpleapps-com/augur-api\";\nimport { getRegisteredQueryAction } from \"./query-action-registry\";\n\n/**\n * Returns a per-request singleton QueryClient for React Server Components.\n *\n * React's `cache()` deduplicates calls within a single server request,\n * so layout, page, and header all share the same prefetch cache without\n * leaking state between requests.\n */\nexport const getQueryClient = cache(\n () =>\n new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: toMillis(minutes(1)),\n refetchOnWindowFocus: false,\n },\n },\n }),\n);\n\n/**\n * Creates server-side query options proxy for prefetching.\n *\n * Uses the same augur-core proxy as `useAugurOptions()`, so query keys\n * are identical on server and client — SSR hydration is automatic.\n *\n * Accepts either an SDK client instance or a queryAction function.\n * When called with no arguments, uses the auto-registered queryAction\n * (registered by augur-server/hooks on import).\n *\n * @example\n * ```ts\n * // With SDK client (traditional)\n * const q = createAugurOptions(site.client, cacheConfig);\n *\n * // With queryAction (server-only JWT sites)\n * import { queryAction } from \"@simpleapps-com/augur-server/query-action\";\n * const q = createAugurOptions(queryAction, cacheConfig);\n *\n * // With auto-registered queryAction (zero args -- requires augur-server/hooks import)\n * const q = createAugurOptions();\n *\n * await queryClient.prefetchQuery(q.items.invMast.doc.get(42));\n * ```\n */\nexport function createAugurOptions<TApi extends object = AugurAPI>(\n apiOrQueryAction?: TApi | QueryActionFn,\n cacheConfig?: CacheConfig,\n): DeepQueryOptions<TApi> {\n const proxyConfig: OptionsProxyConfig | undefined = cacheConfig\n ? { cache: { static: cacheConfig.static, semiStatic: cacheConfig.semiStatic } }\n : undefined;\n\n // If a function is passed, treat it as a queryAction\n if (typeof apiOrQueryAction === \"function\") {\n return createQueryActionProxy<TApi>(apiOrQueryAction as QueryActionFn, proxyConfig);\n }\n\n // If an object is passed, treat it as an SDK client\n if (apiOrQueryAction) {\n return createOptionsProxy(apiOrQueryAction, proxyConfig);\n }\n\n // No args — use auto-registered queryAction\n const registeredAction = getRegisteredQueryAction();\n if (registeredAction) {\n return createQueryActionProxy<TApi>(registeredAction, proxyConfig);\n }\n\n throw new Error(\n \"createAugurOptions() requires either an SDK client, a queryAction function, or \" +\n \"a registered queryAction (import augur-server/hooks to auto-register).\",\n );\n}\n\n// All pure query options and keys (legacy)\nexport * from \"./queries\";\n\n// Re-export shared types from augur-core\nexport type { AugurAuthContext, InfiniteScrollPage, CacheConfig } from \"@simpleapps-com/augur-core\";\n\n// Types needed for server-side usage (type-only, erased at compile time)\nexport type { AugurApiClient } from \"./provider\";\nexport type { PageData } from \"./types\";\n"],"mappings":";;;;;;AAGA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB,8BAA8B;AAC3D,SAAS,SAAS,gBAAgB;AAiB3B,IAAM,iBAAiB;AAAA,EAC5B,MACE,IAAI,YAAY;AAAA,IACd,gBAAgB;AAAA,MACd,SAAS;AAAA,QACP,WAAW,SAAS,QAAQ,CAAC,CAAC;AAAA,QAC9B,sBAAsB;AAAA,MACxB;AAAA,IACF;AAAA,EACF,CAAC;AACL;AA2BO,SAAS,mBACd,kBACA,aACwB;AACxB,QAAM,cAA8C,cAChD,EAAE,OAAO,EAAE,QAAQ,YAAY,QAAQ,YAAY,YAAY,WAAW,EAAE,IAC5E;AAGJ,MAAI,OAAO,qBAAqB,YAAY;AAC1C,WAAO,uBAA6B,kBAAmC,WAAW;AAAA,EACpF;AAGA,MAAI,kBAAkB;AACpB,WAAO,mBAAmB,kBAAkB,WAAW;AAAA,EACzD;AAGA,QAAM,mBAAmB,yBAAyB;AAClD,MAAI,kBAAkB;AACpB,WAAO,uBAA6B,kBAAkB,WAAW;AAAA,EACnE;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAEF;AACF;","names":[]}
@@ -0,0 +1,51 @@
1
+ import type { TCartLine } from "@simpleapps-com/augur-utils";
2
+ /** Internal state shape for the cart Zustand store. */
3
+ interface CartState {
4
+ /** P21 cart header UID; `undefined` when no cart exists. */
5
+ cartHdrUid: number | string | undefined;
6
+ /** Current line items in the cart. */
7
+ cartLines: TCartLine[];
8
+ /** Sum of `quantity` across all cart lines (auto-computed by `setCartLines`). */
9
+ cartQuantityTotal: number;
10
+ /** Number of distinct line items (auto-computed by `setCartLines`). */
11
+ cartLineCount: number;
12
+ setCartHdrUid: (cartHdrUid: number | string | undefined) => void;
13
+ /** Replace all cart lines. Auto-recomputes `cartQuantityTotal` and `cartLineCount`. */
14
+ setCartLines: (cartLines: TCartLine[]) => void;
15
+ /** Reset the cart to its empty initial state. */
16
+ clearCart: () => void;
17
+ }
18
+ /** Zustand store for cart state. Prefer the individual selector hooks below for optimal re-renders. */
19
+ export declare const useCartStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<CartState>, "setState" | "devtools"> & {
20
+ setState(partial: CartState | Partial<CartState> | ((state: CartState) => CartState | Partial<CartState>), replace?: false | undefined, action?: (string | {
21
+ [x: string]: unknown;
22
+ [x: number]: unknown;
23
+ [x: symbol]: unknown;
24
+ type: string;
25
+ }) | undefined): void;
26
+ setState(state: CartState | ((state: CartState) => CartState), replace: true, action?: (string | {
27
+ [x: string]: unknown;
28
+ [x: number]: unknown;
29
+ [x: symbol]: unknown;
30
+ type: string;
31
+ }) | undefined): void;
32
+ devtools: {
33
+ cleanup: () => void;
34
+ };
35
+ }>;
36
+ /** Select the current cart header UID. */
37
+ export declare const useCartHdrUid: () => string | number | undefined;
38
+ /** Select the current cart line items array. */
39
+ export declare const useCartLines: () => TCartLine[];
40
+ /** Select the total quantity summed across all cart lines. */
41
+ export declare const useCartQuantityTotal: () => number;
42
+ /** Select the number of distinct line items in the cart. */
43
+ export declare const useCartLineCount: () => number;
44
+ /** Get the `setCartHdrUid` action (stable reference). */
45
+ export declare const useSetCartHdrUid: () => (cartHdrUid: number | string | undefined) => void;
46
+ /** Get the `setCartLines` action (stable reference). Also recomputes totals. */
47
+ export declare const useSetCartLines: () => (cartLines: TCartLine[]) => void;
48
+ /** Get the `clearCart` action (stable reference). */
49
+ export declare const useClearCart: () => () => void;
50
+ export {};
51
+ //# sourceMappingURL=cart-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cart-store.d.ts","sourceRoot":"","sources":["../../src/stores/cart-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D,uDAAuD;AACvD,UAAU,SAAS;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,sCAAsC;IACtC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACjE,uFAAuF;IACvF,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC/C,iDAAiD;IACjD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,uGAAuG;AACvG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;EA0BxB,CAAC;AAIF,0CAA0C;AAC1C,eAAO,MAAM,aAAa,mCAA0C,CAAC;AACrE,gDAAgD;AAChD,eAAO,MAAM,YAAY,QAAO,SAAS,EAAsC,CAAC;AAChF,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,cAAiD,CAAC;AACnF,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,cAA6C,CAAC;AAC3E,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,qBA/CC,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,IA+CY,CAAC;AAC3E,gFAAgF;AAChF,eAAO,MAAM,eAAe,oBA/CA,SAAS,EAAE,KAAK,IA+C4B,CAAC;AACzE,qDAAqD;AACrD,eAAO,MAAM,YAAY,cA/CN,IA+C+C,CAAC"}
@@ -0,0 +1,30 @@
1
+ import type { TItemsFilters } from "@simpleapps-com/augur-utils";
2
+ /** Zustand state shape for item list filtering, sorting, and pagination. */
3
+ interface ItemsFiltersState {
4
+ /** Snapshot of the initial defaults; useful for "reset filters" UIs. */
5
+ initialFiltersState: TItemsFilters;
6
+ /** Current active filter/sort/pagination state. */
7
+ itemsFilters: TItemsFilters;
8
+ /** Replace the entire filter state. */
9
+ setItemsFilters: (itemFilters: TItemsFilters) => void;
10
+ }
11
+ /** Zustand store for item list filters, sorting, and pagination state. */
12
+ export declare const useItemFiltersStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ItemsFiltersState>, "setState" | "devtools"> & {
13
+ setState(partial: ItemsFiltersState | Partial<ItemsFiltersState> | ((state: ItemsFiltersState) => ItemsFiltersState | Partial<ItemsFiltersState>), replace?: false | undefined, action?: (string | {
14
+ [x: string]: unknown;
15
+ [x: number]: unknown;
16
+ [x: symbol]: unknown;
17
+ type: string;
18
+ }) | undefined): void;
19
+ setState(state: ItemsFiltersState | ((state: ItemsFiltersState) => ItemsFiltersState), replace: true, action?: (string | {
20
+ [x: string]: unknown;
21
+ [x: number]: unknown;
22
+ [x: symbol]: unknown;
23
+ type: string;
24
+ }) | undefined): void;
25
+ devtools: {
26
+ cleanup: () => void;
27
+ };
28
+ }>;
29
+ export {};
30
+ //# sourceMappingURL=items-filters-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"items-filters-store.d.ts","sourceRoot":"","sources":["../../src/stores/items-filters-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAYjE,4EAA4E;AAC5E,UAAU,iBAAiB;IACzB,wEAAwE;IACxE,mBAAmB,EAAE,aAAa,CAAC;IACnC,mDAAmD;IACnD,YAAY,EAAE,aAAa,CAAC;IAC5B,uCAAuC;IACvC,eAAe,EAAE,CAAC,WAAW,EAAE,aAAa,KAAK,IAAI,CAAC;CACvD;AAED,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAY/B,CAAC"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Hook-specific types that don't belong in augur-utils or augur-core.
3
+ * These describe hook parameters and API response shapes.
4
+ */
5
+ import type { Millis } from "./duration";
6
+ /** Parameters for product search queries. */
7
+ export type PageData = {
8
+ categoryIdList?: string;
9
+ filters?: [string, string][];
10
+ limit: number;
11
+ page: number;
12
+ offset: number;
13
+ q: string;
14
+ sortBy: string;
15
+ tagslist?: string;
16
+ itemCategoryUid?: number;
17
+ };
18
+ export type { TSearchSuggestion as SearchSuggestion, TSearchSuggestionsResponse as SearchSuggestionsResponse, } from "@simpleapps-com/augur-utils";
19
+ /** Configuration for React Query localStorage persistence. */
20
+ export interface PersistenceConfig {
21
+ /** localStorage key for the persisted cache. */
22
+ key: string;
23
+ /** Cache buster string. When changed, persisted data is discarded. In development, defaults to Date.now(). */
24
+ buster?: string;
25
+ /** Max age of persisted data (e.g. `toMillis(hours(24))`). Default: 24 hours. */
26
+ maxAge?: Millis;
27
+ /** Query key prefixes to persist. Only successful queries whose first key element matches are persisted. */
28
+ persistableKeys: string[];
29
+ /** Per-key-prefix LRU limits. Queries exceeding the limit are evicted oldest-first by dataUpdatedAt. */
30
+ limits?: Record<string, number>;
31
+ /** localStorage size threshold in MB before eviction runs. Default: 3. */
32
+ maxStorageMB?: number;
33
+ /** Write throttle. Default: one second. */
34
+ throttleMs?: Millis;
35
+ }
36
+ /** API options for item category queries. */
37
+ export interface GetItemCategoryApiOptions {
38
+ childrenFilter?: string;
39
+ childrenLimit?: number;
40
+ childrenOffset?: number;
41
+ classId5List?: string;
42
+ filters?: Record<string, string>;
43
+ orderBy?: string;
44
+ path?: string;
45
+ productCollection?: string;
46
+ rootItemCategoryId?: string;
47
+ }
48
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,GAAG;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAGF,YAAY,EACV,iBAAiB,IAAI,gBAAgB,EACrC,0BAA0B,IAAI,yBAAyB,GACxD,MAAM,6BAA6B,CAAC;AAErC,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,8GAA8G;IAC9G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}
@@ -0,0 +1,16 @@
1
+ import type { ImageConfig, ImageUrlOptions } from "@simpleapps-com/augur-utils";
2
+ interface UseImageWithFallbackResult {
3
+ src: string;
4
+ isLoading: boolean;
5
+ hasError: boolean;
6
+ }
7
+ /**
8
+ * Preloads an agr.media image and shows a fallback while loading.
9
+ *
10
+ * 1. Returns the default image immediately.
11
+ * 2. Preloads the real image via `new Image()`.
12
+ * 3. Swaps to the real URL on success; keeps the fallback on error.
13
+ */
14
+ export declare function useImageWithFallback(config: ImageConfig, imagePath: string | undefined, options?: ImageUrlOptions): UseImageWithFallbackResult;
15
+ export {};
16
+ //# sourceMappingURL=use-image-with-fallback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-image-with-fallback.d.ts","sourceRoot":"","sources":["../../src/web/use-image-with-fallback.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGhF,UAAU,0BAA0B;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,0BAA0B,CA4C5B"}
@@ -0,0 +1,28 @@
1
+ import { type ReactNode } from "react";
2
+ /** The store's subscribe: one throttled resize listener shared by every subscriber (none without a window). */
3
+ export declare function subscribe(callback: () => void): () => void;
4
+ /**
5
+ * Returns whether the screen is mobile-sized.
6
+ * Uses `useSyncExternalStore` for proper SSR support.
7
+ *
8
+ * - SSR-safe: returns false on server, updates on client after hydration
9
+ * - Single listener: one resize listener regardless of component count
10
+ * - Throttled: resize events throttled to prevent excessive re-renders
11
+ */
12
+ export declare function useIsMobile(): boolean;
13
+ interface MobileProviderProps {
14
+ children: ReactNode;
15
+ }
16
+ /**
17
+ * Optional provider that tracks hydration state.
18
+ * Wrap your app with this if you need to conditionally render
19
+ * mobile-only content after hydration.
20
+ */
21
+ export declare function MobileProvider({ children }: MobileProviderProps): import("react").JSX.Element;
22
+ /**
23
+ * Returns true only after the client has hydrated.
24
+ * Prevents hydration mismatches with conditional rendering.
25
+ */
26
+ export declare function useIsHydrated(): boolean;
27
+ export {};
28
+ //# sourceMappingURL=use-mobile-detection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-mobile-detection.d.ts","sourceRoot":"","sources":["../../src/web/use-mobile-detection.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAmBxF,+GAA+G;AAC/G,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAqC1D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAID,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB,+BAQ/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}
@@ -0,0 +1,17 @@
1
+ interface UseMobileOptimizedIntersectionOptions {
2
+ rootMarginMobile?: string;
3
+ rootMarginDesktop?: string;
4
+ threshold?: number;
5
+ enabled?: boolean;
6
+ mobileBreakpoint?: number;
7
+ }
8
+ /**
9
+ * IntersectionObserver hook with mobile-optimized root margins.
10
+ * Uses larger margins on mobile for more aggressive prefetching/lazy loading.
11
+ */
12
+ export declare const useMobileOptimizedIntersection: ({ rootMarginMobile, rootMarginDesktop, threshold, enabled, mobileBreakpoint, }?: UseMobileOptimizedIntersectionOptions) => {
13
+ ref: import("react").RefObject<HTMLDivElement | null>;
14
+ isIntersecting: boolean;
15
+ };
16
+ export {};
17
+ //# sourceMappingURL=use-mobile-optimized-intersection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-mobile-optimized-intersection.d.ts","sourceRoot":"","sources":["../../src/web/use-mobile-optimized-intersection.ts"],"names":[],"mappings":"AAIA,UAAU,qCAAqC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAAI,iFAM5C,qCAA0C;;;CAkC5C,CAAC"}
package/dist/web.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/web.cjs","../src/web/use-mobile-detection.tsx","../src/web/use-mobile-optimized-intersection.ts","../src/web/use-image-with-fallback.ts"],"names":["useState","useRef","useEffect"],"mappings":"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","file":"/home/runner/work/augur-packages/augur-packages/packages/augur-hooks/dist/web.cjs","sourcesContent":[null,"import { createContext, useContext, useSyncExternalStore, type ReactNode } from \"react\";\n\nconst MOBILE_BREAKPOINT = 992;\nconst THROTTLE_MS = 150;\n\n// Singleton state for mobile detection\nlet isMobileState = false;\nconst listeners: Set<() => void> = new Set();\nlet throttleTimeout: ReturnType<typeof setTimeout> | null = null;\nlet cleanupResize: (() => void) | null = null;\n\nfunction getSnapshot(): boolean {\n return isMobileState;\n}\n\n/* v8 ignore next 3 */\nfunction getServerSnapshot(): boolean {\n return false;\n}\n\nfunction subscribe(callback: () => void): () => void {\n if (listeners.size === 0 && typeof window !== \"undefined\") {\n isMobileState = window.innerWidth <= MOBILE_BREAKPOINT;\n\n const handleResize = () => {\n if (throttleTimeout) return;\n\n throttleTimeout = setTimeout(() => {\n throttleTimeout = null;\n const newValue = window.innerWidth <= MOBILE_BREAKPOINT;\n if (newValue !== isMobileState) {\n isMobileState = newValue;\n listeners.forEach((listener) => listener());\n }\n }, THROTTLE_MS);\n };\n\n window.addEventListener(\"resize\", handleResize, { passive: true });\n\n cleanupResize = () => {\n window.removeEventListener(\"resize\", handleResize);\n if (throttleTimeout) {\n clearTimeout(throttleTimeout);\n throttleTimeout = null;\n }\n };\n }\n\n listeners.add(callback);\n\n return () => {\n listeners.delete(callback);\n if (listeners.size === 0 && cleanupResize) {\n cleanupResize();\n cleanupResize = null;\n }\n };\n}\n\n/**\n * Returns whether the screen is mobile-sized.\n * Uses `useSyncExternalStore` for proper SSR support.\n *\n * - SSR-safe: returns false on server, updates on client after hydration\n * - Single listener: one resize listener regardless of component count\n * - Throttled: resize events throttled to prevent excessive re-renders\n */\nexport function useIsMobile(): boolean {\n return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\nconst HydrationContext = createContext(false);\n\ninterface MobileProviderProps {\n children: ReactNode;\n}\n\n/**\n * Optional provider that tracks hydration state.\n * Wrap your app with this if you need to conditionally render\n * mobile-only content after hydration.\n */\nexport function MobileProvider({ children }: MobileProviderProps) {\n const isHydrated = useSyncExternalStore(\n () => () => {},\n () => true,\n () => false,\n );\n\n return <HydrationContext.Provider value={isHydrated}>{children}</HydrationContext.Provider>;\n}\n\n/**\n * Returns true only after the client has hydrated.\n * Prevents hydration mismatches with conditional rendering.\n */\nexport function useIsHydrated(): boolean {\n return useContext(HydrationContext);\n}\n","\"use client\";\n\nimport { useEffect, useState, useRef } from \"react\";\n\ninterface UseMobileOptimizedIntersectionOptions {\n rootMarginMobile?: string;\n rootMarginDesktop?: string;\n threshold?: number;\n enabled?: boolean;\n mobileBreakpoint?: number;\n}\n\n/**\n * IntersectionObserver hook with mobile-optimized root margins.\n * Uses larger margins on mobile for more aggressive prefetching/lazy loading.\n */\nexport const useMobileOptimizedIntersection = ({\n rootMarginMobile = \"300px\",\n rootMarginDesktop = \"150px\",\n threshold = 0,\n enabled = true,\n mobileBreakpoint = 992,\n}: UseMobileOptimizedIntersectionOptions = {}) => {\n const [isIntersecting, setIsIntersecting] = useState(false);\n const elementRef = useRef<HTMLDivElement | null>(null);\n\n useEffect(() => {\n if (!enabled || !elementRef.current) return;\n\n const isMobile = window.innerWidth <= mobileBreakpoint;\n\n const observer = new IntersectionObserver(\n (entries) => {\n entries.forEach((entry) => {\n if (entry.isIntersecting && !isIntersecting) {\n setIsIntersecting(true);\n }\n });\n },\n {\n rootMargin: isMobile ? rootMarginMobile : rootMarginDesktop,\n threshold,\n },\n );\n\n observer.observe(elementRef.current);\n\n return () => {\n observer.disconnect();\n };\n }, [enabled, rootMarginMobile, rootMarginDesktop, threshold, isIntersecting, mobileBreakpoint]);\n\n return {\n ref: elementRef,\n isIntersecting,\n };\n};\n","\"use client\";\n\nimport { useEffect, useState, useRef } from \"react\";\nimport type { ImageConfig, ImageUrlOptions } from \"@simpleapps-com/augur-utils\";\nimport { getImageUrl, getDefaultImageUrl } from \"@simpleapps-com/augur-utils\";\n\ninterface UseImageWithFallbackResult {\n src: string;\n isLoading: boolean;\n hasError: boolean;\n}\n\n/**\n * Preloads an agr.media image and shows a fallback while loading.\n *\n * 1. Returns the default image immediately.\n * 2. Preloads the real image via `new Image()`.\n * 3. Swaps to the real URL on success; keeps the fallback on error.\n */\nexport function useImageWithFallback(\n config: ImageConfig,\n imagePath: string | undefined,\n options?: ImageUrlOptions,\n): UseImageWithFallbackResult {\n const defaultSrc = getDefaultImageUrl(config, options);\n const realSrc = imagePath ? getImageUrl(config, imagePath) : \"\";\n\n const [src, setSrc] = useState(defaultSrc);\n const [isLoading, setIsLoading] = useState(!!realSrc);\n const [hasError, setHasError] = useState(false);\n const imageRef = useRef<HTMLImageElement | null>(null);\n\n useEffect(() => {\n if (!realSrc) {\n setSrc(defaultSrc);\n setIsLoading(false);\n setHasError(false);\n return;\n }\n\n setSrc(defaultSrc);\n setIsLoading(true);\n setHasError(false);\n\n const img = new Image();\n imageRef.current = img;\n\n img.onload = () => {\n setSrc(realSrc);\n setIsLoading(false);\n };\n\n img.onerror = () => {\n setIsLoading(false);\n setHasError(true);\n };\n\n img.src = realSrc;\n\n return () => {\n img.onload = null;\n img.onerror = null;\n imageRef.current = null;\n };\n }, [realSrc, defaultSrc]);\n\n return { src, isLoading, hasError };\n}\n"]}
1
+ {"version":3,"sources":["/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/web.cjs","../src/web/use-mobile-detection.tsx","../src/web/use-mobile-optimized-intersection.ts","../src/web/use-image-with-fallback.ts"],"names":["useState","useRef","useEffect"],"mappings":"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","file":"/Users/stuartjackson/Projects/simpleapps/atlas/repo/packages/augur-hooks/dist/web.cjs","sourcesContent":[null,"import { createContext, useContext, useSyncExternalStore, type ReactNode } from \"react\";\n\nconst MOBILE_BREAKPOINT = 992;\nconst THROTTLE_MS = 150;\n\n// Singleton state for mobile detection\nlet isMobileState = false;\nconst listeners: Set<() => void> = new Set();\nlet throttleTimeout: ReturnType<typeof setTimeout> | null = null;\nlet cleanupResize: (() => void) | null = null;\n\nfunction getSnapshot(): boolean {\n return isMobileState;\n}\n\nfunction getServerSnapshot(): boolean {\n return false;\n}\n\n/** The store's subscribe: one throttled resize listener shared by every subscriber (none without a window). */\nexport function subscribe(callback: () => void): () => void {\n if (listeners.size === 0 && typeof window !== \"undefined\") {\n isMobileState = window.innerWidth <= MOBILE_BREAKPOINT;\n\n const handleResize = () => {\n if (throttleTimeout) return;\n\n throttleTimeout = setTimeout(() => {\n throttleTimeout = null;\n const newValue = window.innerWidth <= MOBILE_BREAKPOINT;\n if (newValue !== isMobileState) {\n isMobileState = newValue;\n listeners.forEach((listener) => listener());\n }\n }, THROTTLE_MS);\n };\n\n window.addEventListener(\"resize\", handleResize, { passive: true });\n\n cleanupResize = () => {\n window.removeEventListener(\"resize\", handleResize);\n if (throttleTimeout) {\n clearTimeout(throttleTimeout);\n throttleTimeout = null;\n }\n };\n }\n\n listeners.add(callback);\n\n return () => {\n listeners.delete(callback);\n if (listeners.size === 0 && cleanupResize) {\n cleanupResize();\n cleanupResize = null;\n }\n };\n}\n\n/**\n * Returns whether the screen is mobile-sized.\n * Uses `useSyncExternalStore` for proper SSR support.\n *\n * - SSR-safe: returns false on server, updates on client after hydration\n * - Single listener: one resize listener regardless of component count\n * - Throttled: resize events throttled to prevent excessive re-renders\n */\nexport function useIsMobile(): boolean {\n return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\nconst HydrationContext = createContext(false);\n\ninterface MobileProviderProps {\n children: ReactNode;\n}\n\n/**\n * Optional provider that tracks hydration state.\n * Wrap your app with this if you need to conditionally render\n * mobile-only content after hydration.\n */\nexport function MobileProvider({ children }: MobileProviderProps) {\n const isHydrated = useSyncExternalStore(\n () => () => {},\n () => true,\n () => false,\n );\n\n return <HydrationContext.Provider value={isHydrated}>{children}</HydrationContext.Provider>;\n}\n\n/**\n * Returns true only after the client has hydrated.\n * Prevents hydration mismatches with conditional rendering.\n */\nexport function useIsHydrated(): boolean {\n return useContext(HydrationContext);\n}\n","\"use client\";\n\nimport { useEffect, useState, useRef } from \"react\";\n\ninterface UseMobileOptimizedIntersectionOptions {\n rootMarginMobile?: string;\n rootMarginDesktop?: string;\n threshold?: number;\n enabled?: boolean;\n mobileBreakpoint?: number;\n}\n\n/**\n * IntersectionObserver hook with mobile-optimized root margins.\n * Uses larger margins on mobile for more aggressive prefetching/lazy loading.\n */\nexport const useMobileOptimizedIntersection = ({\n rootMarginMobile = \"300px\",\n rootMarginDesktop = \"150px\",\n threshold = 0,\n enabled = true,\n mobileBreakpoint = 992,\n}: UseMobileOptimizedIntersectionOptions = {}) => {\n const [isIntersecting, setIsIntersecting] = useState(false);\n const elementRef = useRef<HTMLDivElement | null>(null);\n\n useEffect(() => {\n if (!enabled || !elementRef.current) return;\n\n const isMobile = window.innerWidth <= mobileBreakpoint;\n\n const observer = new IntersectionObserver(\n (entries) => {\n entries.forEach((entry) => {\n if (entry.isIntersecting && !isIntersecting) {\n setIsIntersecting(true);\n }\n });\n },\n {\n rootMargin: isMobile ? rootMarginMobile : rootMarginDesktop,\n threshold,\n },\n );\n\n observer.observe(elementRef.current);\n\n return () => {\n observer.disconnect();\n };\n }, [enabled, rootMarginMobile, rootMarginDesktop, threshold, isIntersecting, mobileBreakpoint]);\n\n return {\n ref: elementRef,\n isIntersecting,\n };\n};\n","\"use client\";\n\nimport { useEffect, useState, useRef } from \"react\";\nimport type { ImageConfig, ImageUrlOptions } from \"@simpleapps-com/augur-utils\";\nimport { getImageUrl, getDefaultImageUrl } from \"@simpleapps-com/augur-utils\";\n\ninterface UseImageWithFallbackResult {\n src: string;\n isLoading: boolean;\n hasError: boolean;\n}\n\n/**\n * Preloads an agr.media image and shows a fallback while loading.\n *\n * 1. Returns the default image immediately.\n * 2. Preloads the real image via `new Image()`.\n * 3. Swaps to the real URL on success; keeps the fallback on error.\n */\nexport function useImageWithFallback(\n config: ImageConfig,\n imagePath: string | undefined,\n options?: ImageUrlOptions,\n): UseImageWithFallbackResult {\n const defaultSrc = getDefaultImageUrl(config, options);\n const realSrc = imagePath ? getImageUrl(config, imagePath) : \"\";\n\n const [src, setSrc] = useState(defaultSrc);\n const [isLoading, setIsLoading] = useState(!!realSrc);\n const [hasError, setHasError] = useState(false);\n const imageRef = useRef<HTMLImageElement | null>(null);\n\n useEffect(() => {\n if (!realSrc) {\n setSrc(defaultSrc);\n setIsLoading(false);\n setHasError(false);\n return;\n }\n\n setSrc(defaultSrc);\n setIsLoading(true);\n setHasError(false);\n\n const img = new Image();\n imageRef.current = img;\n\n img.onload = () => {\n setSrc(realSrc);\n setIsLoading(false);\n };\n\n img.onerror = () => {\n setIsLoading(false);\n setHasError(true);\n };\n\n img.src = realSrc;\n\n return () => {\n img.onload = null;\n img.onerror = null;\n imageRef.current = null;\n };\n }, [realSrc, defaultSrc]);\n\n return { src, isLoading, hasError };\n}\n"]}