@simpleapps-com/augur-hooks 2.3.1 → 2026.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/EXPORTS.md +25 -65
  2. package/README.md +21 -246
  3. package/dist/checkout/create-checkout-provider.d.ts +25 -0
  4. package/dist/checkout/create-checkout-provider.d.ts.map +1 -0
  5. package/dist/checkout/index.cjs +123 -106
  6. package/dist/checkout/index.cjs.map +1 -1
  7. package/dist/checkout/index.d.ts +5 -293
  8. package/dist/checkout/index.d.ts.map +1 -0
  9. package/dist/checkout/index.js +99 -82
  10. package/dist/checkout/index.js.map +1 -1
  11. package/dist/checkout/{index.d.cts → types.d.ts} +18 -40
  12. package/dist/checkout/types.d.ts.map +1 -0
  13. package/dist/chunk-6Z6JGK2C.cjs.map +1 -1
  14. package/dist/chunk-QB7VB5FZ.cjs +523 -0
  15. package/dist/chunk-QB7VB5FZ.cjs.map +1 -0
  16. package/dist/{chunk-NRWH2BMN.js → chunk-UTDAFIQP.js} +237 -91
  17. package/dist/chunk-UTDAFIQP.js.map +1 -0
  18. package/dist/hooks/use-cart-actions.d.ts +68 -0
  19. package/dist/hooks/use-cart-actions.d.ts.map +1 -0
  20. package/dist/hooks/use-cart-initialization.d.ts +60 -0
  21. package/dist/hooks/use-cart-initialization.d.ts.map +1 -0
  22. package/dist/hooks/use-cart-pricing.d.ts +41 -0
  23. package/dist/hooks/use-cart-pricing.d.ts.map +1 -0
  24. package/dist/hooks/use-checkout-persistence.d.ts +40 -0
  25. package/dist/hooks/use-checkout-persistence.d.ts.map +1 -0
  26. package/dist/hooks/use-debounce.d.ts +6 -0
  27. package/dist/hooks/use-debounce.d.ts.map +1 -0
  28. package/dist/hooks/use-format-price.d.ts +29 -0
  29. package/dist/hooks/use-format-price.d.ts.map +1 -0
  30. package/dist/hooks/use-latest.d.ts +8 -0
  31. package/dist/hooks/use-latest.d.ts.map +1 -0
  32. package/dist/hooks/use-modal-lifecycle.d.ts +11 -0
  33. package/dist/hooks/use-modal-lifecycle.d.ts.map +1 -0
  34. package/dist/hooks/use-order-readiness.d.ts +47 -0
  35. package/dist/hooks/use-order-readiness.d.ts.map +1 -0
  36. package/dist/hooks/use-pagination-prefetch.d.ts +26 -0
  37. package/dist/hooks/use-pagination-prefetch.d.ts.map +1 -0
  38. package/dist/{use-order-readiness-DZTIfRzw.d.ts → hooks/use-payment-flow.d.ts} +23 -67
  39. package/dist/hooks/use-payment-flow.d.ts.map +1 -0
  40. package/dist/hooks/use-stock.d.ts +32 -0
  41. package/dist/hooks/use-stock.d.ts.map +1 -0
  42. package/dist/index.cjs +251 -192
  43. package/dist/index.cjs.map +1 -1
  44. package/dist/index.d.ts +32 -456
  45. package/dist/index.d.ts.map +1 -0
  46. package/dist/index.js +230 -171
  47. package/dist/index.js.map +1 -1
  48. package/dist/persistence/apply-limits.d.ts +8 -0
  49. package/dist/persistence/apply-limits.d.ts.map +1 -0
  50. package/dist/persistence/create-persister.d.ts +10 -0
  51. package/dist/persistence/create-persister.d.ts.map +1 -0
  52. package/dist/persistence/serializer.d.ts +11 -0
  53. package/dist/persistence/serializer.d.ts.map +1 -0
  54. package/dist/persistence/use-persistence.d.ts +59 -0
  55. package/dist/persistence/use-persistence.d.ts.map +1 -0
  56. package/dist/persistence/use-storage-monitor.d.ts +11 -0
  57. package/dist/persistence/use-storage-monitor.d.ts.map +1 -0
  58. package/dist/provider.d.ts +89 -0
  59. package/dist/provider.d.ts.map +1 -0
  60. package/dist/queries/batch-query.d.ts +23 -0
  61. package/dist/queries/batch-query.d.ts.map +1 -0
  62. package/dist/queries/cache-helper.d.ts +16 -0
  63. package/dist/queries/cache-helper.d.ts.map +1 -0
  64. package/dist/queries/index.d.ts +3 -0
  65. package/dist/queries/index.d.ts.map +1 -0
  66. package/dist/query-action-registry.d.ts +19 -0
  67. package/dist/query-action-registry.d.ts.map +1 -0
  68. package/dist/rules.d.ts +130 -0
  69. package/dist/rules.d.ts.map +1 -0
  70. package/dist/server.cjs.map +1 -1
  71. package/dist/server.d.ts +10 -12
  72. package/dist/server.d.ts.map +1 -0
  73. package/dist/stores/cart-store.d.ts +51 -0
  74. package/dist/stores/cart-store.d.ts.map +1 -0
  75. package/dist/stores/items-filters-store.d.ts +30 -0
  76. package/dist/stores/items-filters-store.d.ts.map +1 -0
  77. package/dist/types.d.ts +48 -0
  78. package/dist/types.d.ts.map +1 -0
  79. package/dist/web/use-image-with-fallback.d.ts +16 -0
  80. package/dist/web/use-image-with-fallback.d.ts.map +1 -0
  81. package/dist/web/use-mobile-detection.d.ts +28 -0
  82. package/dist/web/use-mobile-detection.d.ts.map +1 -0
  83. package/dist/web/use-mobile-optimized-intersection.d.ts +17 -0
  84. package/dist/web/use-mobile-optimized-intersection.d.ts.map +1 -0
  85. package/dist/web.cjs.map +1 -1
  86. package/dist/web.d.ts +4 -60
  87. package/dist/web.d.ts.map +1 -0
  88. package/dist/web.js.map +1 -1
  89. package/llms.txt +76 -54
  90. package/package.json +25 -14
  91. package/dist/batch-query-CTlvxSmL.d.cts +0 -165
  92. package/dist/batch-query-CTlvxSmL.d.ts +0 -165
  93. package/dist/chunk-I4A5L2I6.cjs +0 -377
  94. package/dist/chunk-I4A5L2I6.cjs.map +0 -1
  95. package/dist/chunk-NRWH2BMN.js.map +0 -1
  96. package/dist/index.d.cts +0 -456
  97. package/dist/server.d.cts +0 -44
  98. package/dist/use-order-readiness-DZTIfRzw.d.cts +0 -137
  99. package/dist/web.d.cts +0 -60
@@ -0,0 +1,16 @@
1
+ import type { CacheProvider, CacheTierConfig } from "../types";
2
+ /**
3
+ * Wraps an async function with optional Redis caching.
4
+ *
5
+ * - When `provider` and `tier.redis` are both set, checks Redis before
6
+ * calling `fn`, then caches the result on miss.
7
+ * - When either is missing, calls `fn` directly (no-op passthrough).
8
+ *
9
+ * @param provider Redis-compatible get/set + prefix. Undefined = skip Redis.
10
+ * @param tier Cache tier config. Undefined or missing `redis` = skip Redis.
11
+ * @param methodPath Dot-separated SDK method path (used as cache key segment).
12
+ * @param fn The async function to cache (typically the SDK call).
13
+ * @param keyArgs Values to hash for the cache key (e.g. query params).
14
+ */
15
+ export declare function withCache<T>(provider: CacheProvider | undefined, tier: CacheTierConfig | undefined, methodPath: string, fn: () => Promise<T>, ...keyArgs: unknown[]): Promise<T>;
16
+ //# sourceMappingURL=cache-helper.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-helper.d.ts","sourceRoot":"","sources":["../../src/queries/cache-helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG/D;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,IAAI,EAAE,eAAe,GAAG,SAAS,EACjC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,GAAG,OAAO,EAAE,OAAO,EAAE,GACpB,OAAO,CAAC,CAAC,CAAC,CAuBZ"}
@@ -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,130 @@
1
+ /**
2
+ * The cart's quantity total: `acc` plus each quantity from index `i` on, added left to right as
3
+ * `reduce` does (each line's quantity, null or NaN as 0, already taken by the caller).
4
+ *
5
+ * @ensures result = acc + Σ_{k ≥ i} quantities[k], the model's QuantityTotal at acc = i = 0
6
+ */
7
+ export declare function quantityTotalFrom(quantities: number[], i: number, acc: number): number;
8
+ /**
9
+ * A cart line's quantity with null as 0.
10
+ *
11
+ * @ensures result = q ?? 0, the model's QtyOrZero
12
+ */
13
+ export declare function qtyOrZero(q: number | null): number;
14
+ /**
15
+ * The first index from `i` whose item uid is `uid`, or −1 (JS `findIndex` at i = 0).
16
+ *
17
+ * @ensures exactly the model's IndexOfUid
18
+ */
19
+ export declare function indexOfUidFrom(uids: number[], uid: number, i: number): number;
20
+ /**
21
+ * Reversing an add keeps a matched line only while something is left of it.
22
+ *
23
+ * @ensures result ⟺ (current ?? 0) − q > 0, the model's ReverseAdd keep rule
24
+ */
25
+ export declare function keepsAfterReverse(current: number | null, q: number): boolean;
26
+ /**
27
+ * requireCartUid: a missing or 0 uid refuses (null); the hooks throw on it.
28
+ *
29
+ * @ensures result = null ⟺ uid ∈ {undefined, 0}; otherwise result = uid
30
+ */
31
+ export declare function requiredCartUid(uid: number | undefined): number | null;
32
+ /**
33
+ * resolveCartHdrUid (checkout): a missing uid is 0; any other passes unchanged.
34
+ *
35
+ * @ensures result = uid ?? 0
36
+ */
37
+ export declare function checkoutCartUid(uid: number | undefined): number;
38
+ /**
39
+ * The initial payment method: the site hook's non-empty answer, else credit card when payments
40
+ * are configured, else invoice.
41
+ *
42
+ * @ensures exactly the model's DefaultPaymentMethod
43
+ */
44
+ export declare function defaultPaymentMethodOf(fromHook: string | undefined, hasCallbacks: boolean): string;
45
+ /** The default order gates' inputs, each already reduced to a flag by the caller. */
46
+ export interface ReadinessFlags {
47
+ cartUidSet: boolean;
48
+ editShippingInfo: boolean;
49
+ editShippingMethods: boolean;
50
+ editBillingInfo: boolean;
51
+ editCc: boolean;
52
+ hasShippingAddress: boolean;
53
+ hasBillingAddress: boolean;
54
+ methodSaved: boolean;
55
+ showBillingSummary: boolean;
56
+ processing: boolean;
57
+ isCreditCard: boolean;
58
+ hasAccountId: boolean;
59
+ hasUnifiedBilling: boolean;
60
+ isFreeShipping: boolean;
61
+ hasShippingFee: boolean;
62
+ }
63
+ /**
64
+ * The default gates: a cart, nothing being edited, both addresses, a saved method, the billing
65
+ * summary shown, not processing, a completed card flow for credit card, and a fee unless
66
+ * shipping is free.
67
+ *
68
+ * @ensures exactly the model's DefaultReady
69
+ */
70
+ export declare function defaultReady(r: ReadinessFlags): boolean;
71
+ /**
72
+ * A site's own readiness answer wins; undefined defers to the default gates.
73
+ *
74
+ * @ensures result = custom ?? defaultReady
75
+ */
76
+ export declare function orderReadyOf(custom: boolean | undefined, ready: boolean): boolean;
77
+ /** The pre-submit outcome: go ahead, the site cancelled it, or refused with a message. */
78
+ export type PreSubmit = {
79
+ kind: "ok";
80
+ } | {
81
+ kind: "cancelled";
82
+ } | {
83
+ kind: "refused";
84
+ message: string;
85
+ };
86
+ /**
87
+ * runPreSubmitChecks: the site's validation error first (an empty one is no error), then its
88
+ * beforeSubmit veto, then a missing shipping address.
89
+ *
90
+ * @ensures exactly the model's PreSubmitOutcome (an empty validation error as None)
91
+ */
92
+ export declare function preSubmitOutcome(validateError: string | undefined, beforeSubmitFalse: boolean, hasShippingAddress: boolean): PreSubmit;
93
+ /**
94
+ * A cookie entry's `split("=")[1]`: the text between the first and second "=" (to the end with
95
+ * no second), or "" with no "=". A token holding "=" is cut at it, as before.
96
+ *
97
+ * @ensures exactly the model's SecondEqualsField
98
+ */
99
+ export declare function secondEqualsField(s: string): string;
100
+ /**
101
+ * A saved checkout entry is expired once more than `ttl` ms have passed since it was saved.
102
+ *
103
+ * @ensures result ⟺ now − savedAt > ttl
104
+ */
105
+ export declare function isExpired(now: number, savedAt: number, ttl: number): boolean;
106
+ /**
107
+ * A query is persisted iff it has a string head that is listed and it succeeded.
108
+ *
109
+ * @ensures exactly the model's ShouldPersist, with the listing already looked up
110
+ */
111
+ export declare function shouldPersistOf(hasHead: boolean, succeeded: boolean, listed: boolean): boolean;
112
+ /**
113
+ * 2ⁿ.
114
+ *
115
+ * @ensures result = 2ⁿ, the model's Pow2
116
+ */
117
+ export declare function pow2(n: number): number;
118
+ /**
119
+ * A stock fetch's retry delay: 1000 · 2ⁿ ms, at most 10 s (n ≥ 4 is always the cap).
120
+ *
121
+ * @ensures exactly the model's StockRetryDelay
122
+ */
123
+ export declare function stockRetryDelay(attemptIndex: number): number;
124
+ /**
125
+ * useStock fetches only when enabled (default true) and given a uid.
126
+ *
127
+ * @ensures exactly the model's StockEnabled
128
+ */
129
+ export declare function stockEnabled(enabled: boolean | undefined, uidSet: boolean): boolean;
130
+ //# 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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"}
@@ -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;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":"/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 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"]}
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;AAEpD,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"}
@@ -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
+ export type { CacheProvider, CacheTierConfig } from "@simpleapps-com/augur-core";
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 in ms. Default: 24 hours. */
26
+ maxAge?: number;
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 in ms. Default: 1000. */
34
+ throttleMs?: number;
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;AAGH,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEjF,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,0DAA0D;IAC1D,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"]}
package/dist/web.d.ts CHANGED
@@ -1,60 +1,4 @@
1
- import * as react_jsx_runtime from 'react/jsx-runtime';
2
- import * as react from 'react';
3
- import { ReactNode } from 'react';
4
- import { ImageConfig, ImageUrlOptions } from '@simpleapps-com/augur-utils';
5
-
6
- /**
7
- * Returns whether the screen is mobile-sized.
8
- * Uses `useSyncExternalStore` for proper SSR support.
9
- *
10
- * - SSR-safe: returns false on server, updates on client after hydration
11
- * - Single listener: one resize listener regardless of component count
12
- * - Throttled: resize events throttled to prevent excessive re-renders
13
- */
14
- declare function useIsMobile(): boolean;
15
- interface MobileProviderProps {
16
- children: ReactNode;
17
- }
18
- /**
19
- * Optional provider that tracks hydration state.
20
- * Wrap your app with this if you need to conditionally render
21
- * mobile-only content after hydration.
22
- */
23
- declare function MobileProvider({ children }: MobileProviderProps): react_jsx_runtime.JSX.Element;
24
- /**
25
- * Returns true only after the client has hydrated.
26
- * Prevents hydration mismatches with conditional rendering.
27
- */
28
- declare function useIsHydrated(): boolean;
29
-
30
- interface UseMobileOptimizedIntersectionOptions {
31
- rootMarginMobile?: string;
32
- rootMarginDesktop?: string;
33
- threshold?: number;
34
- enabled?: boolean;
35
- mobileBreakpoint?: number;
36
- }
37
- /**
38
- * IntersectionObserver hook with mobile-optimized root margins.
39
- * Uses larger margins on mobile for more aggressive prefetching/lazy loading.
40
- */
41
- declare const useMobileOptimizedIntersection: ({ rootMarginMobile, rootMarginDesktop, threshold, enabled, mobileBreakpoint, }?: UseMobileOptimizedIntersectionOptions) => {
42
- ref: react.RefObject<HTMLDivElement | null>;
43
- isIntersecting: boolean;
44
- };
45
-
46
- interface UseImageWithFallbackResult {
47
- src: string;
48
- isLoading: boolean;
49
- hasError: boolean;
50
- }
51
- /**
52
- * Preloads an agr.media image and shows a fallback while loading.
53
- *
54
- * 1. Returns the default image immediately.
55
- * 2. Preloads the real image via `new Image()`.
56
- * 3. Swaps to the real URL on success; keeps the fallback on error.
57
- */
58
- declare function useImageWithFallback(config: ImageConfig, imagePath: string | undefined, options?: ImageUrlOptions): UseImageWithFallbackResult;
59
-
60
- export { MobileProvider, useImageWithFallback, useIsHydrated, useIsMobile, useMobileOptimizedIntersection };
1
+ export { useIsMobile, MobileProvider, useIsHydrated } from "./web/use-mobile-detection";
2
+ export { useMobileOptimizedIntersection } from "./web/use-mobile-optimized-intersection";
3
+ export { useImageWithFallback } from "./web/use-image-with-fallback";
4
+ //# sourceMappingURL=web.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}