@usethrottle/catalog 1.3.0 → 1.4.0

package/dist/react-extras.cjs

@@ -3,14 +3,14 @@
 
 
 
-var _chunkGU63WFXIcjs = require('./chunk-GU63WFXI.cjs');
-require('./chunk-2YQNMBDI.cjs');
+var _chunkOKWXS3FDcjs = require('./chunk-OKWXS3FD.cjs');
+require('./chunk-J2GHGQY6.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/react/extras/index.ts
 function useTags(options = {}) {
-  const extra = _chunkGU63WFXIcjs.defined.call(void 0, { q: options.q, limit: options.limit });
-  return _chunkGU63WFXIcjs.useQuery.call(void 0, 
+  const extra = _chunkOKWXS3FDcjs.defined.call(void 0, { q: options.q, limit: options.limit });
+  return _chunkOKWXS3FDcjs.useQuery.call(void 0, 
     "tags",
     extra,
     (client, call) => client.tags.list({ ...call, ...extra }),
@@ -18,8 +18,8 @@ function useTags(options = {}) {
   );
 }
 function useCollections(options = {}) {
-  const extra = _chunkGU63WFXIcjs.defined.call(void 0, { limit: options.limit, cursor: options.cursor });
-  return _chunkGU63WFXIcjs.useQuery.call(void 0, 
+  const extra = _chunkOKWXS3FDcjs.defined.call(void 0, { limit: options.limit, cursor: options.cursor });
+  return _chunkOKWXS3FDcjs.useQuery.call(void 0, 
     "collections",
     extra,
     (client, call) => client.collections.list({ ...call, ...extra }),
@@ -27,16 +27,34 @@ function useCollections(options = {}) {
   );
 }
 function useReviewEligibility(handle, options = {}) {
-  const customerKey = _chunkGU63WFXIcjs.useCustomerKey.call(void 0, );
-  return _chunkGU63WFXIcjs.useQuery.call(void 0, 
+  const customerKey = _chunkOKWXS3FDcjs.useCustomerKey.call(void 0, );
+  return _chunkOKWXS3FDcjs.useQuery.call(void 0, 
     "review-eligibility",
     { handle },
     handle === null || customerKey === null ? null : (client, call) => client.reviews.eligibility(handle, call),
     { ...options, staleTimeMs: _nullishCoalesce(options.staleTimeMs, () => ( 0)) }
   );
 }
+function usePages(options) {
+  return _chunkOKWXS3FDcjs.useQuery.call(void 0, 
+    "pages",
+    null,
+    (client, call) => client.pages.list(call),
+    options
+  );
+}
+function usePage(handle, options) {
+  return _chunkOKWXS3FDcjs.useQuery.call(void 0, 
+    "page",
+    { handle },
+    handle === null ? null : (client, call) => client.pages.get(handle, call),
+    options
+  );
+}
+
+
 
 
 
 
-exports.useCollections = useCollections; exports.useReviewEligibility = useReviewEligibility; exports.useTags = useTags;
+exports.useCollections = useCollections; exports.usePage = usePage; exports.usePages = usePages; exports.useReviewEligibility = useReviewEligibility; exports.useTags = useTags;

package/dist/react-extras.d.cts

@@ -1,9 +1,9 @@
 import { CatalogClient } from './index.cjs';
 import { QueryOptions, QueryResult } from './react.cjs';
-import './types-D0PywKnN.cjs';
+import './types-jNpOwEUw.cjs';
 import '@usethrottle/money';
-import './contract-types-BRyonOYH.cjs';
-import './catalog-error-BOaSKgY3.cjs';
+import './contract-types-D2-SSPM9.cjs';
+import './catalog-error-BKN5hNWP.cjs';
 
 type Answer<F extends (...args: never[]) => unknown> = Awaited<ReturnType<F>>;
 declare function useTags(options?: QueryOptions<Answer<CatalogClient['tags']['list']>> & {
@@ -19,5 +19,7 @@ declare function useCollections(options?: QueryOptions<Answer<CatalogClient['col
  * signed out; asks on every mount (`staleTimeMs` 0).
  */
 declare function useReviewEligibility(handle: string | null, options?: QueryOptions<Answer<CatalogClient['reviews']['eligibility']>>): QueryResult<Answer<CatalogClient['reviews']['eligibility']>>;
+declare function usePages(options?: QueryOptions<Answer<CatalogClient['pages']['list']>>): QueryResult<Answer<CatalogClient['pages']['list']>>;
+declare function usePage(handle: string | null, options?: QueryOptions<Answer<CatalogClient['pages']['get']>>): QueryResult<Answer<CatalogClient['pages']['get']>>;
 
-export { useCollections, useReviewEligibility, useTags };
+export { useCollections, usePage, usePages, useReviewEligibility, useTags };

package/dist/react-extras.d.ts

@@ -1,9 +1,9 @@
 import { CatalogClient } from './index.js';
 import { QueryOptions, QueryResult } from './react.js';
-import './types-BfveENg1.js';
+import './types-z57bkjjB.js';
 import '@usethrottle/money';
-import './contract-types-BRyonOYH.js';
-import './catalog-error-CSoPS0-d.js';
+import './contract-types-D2-SSPM9.js';
+import './catalog-error-BnabMMEy.js';
 
 type Answer<F extends (...args: never[]) => unknown> = Awaited<ReturnType<F>>;
 declare function useTags(options?: QueryOptions<Answer<CatalogClient['tags']['list']>> & {
@@ -19,5 +19,7 @@ declare function useCollections(options?: QueryOptions<Answer<CatalogClient['col
  * signed out; asks on every mount (`staleTimeMs` 0).
  */
 declare function useReviewEligibility(handle: string | null, options?: QueryOptions<Answer<CatalogClient['reviews']['eligibility']>>): QueryResult<Answer<CatalogClient['reviews']['eligibility']>>;
+declare function usePages(options?: QueryOptions<Answer<CatalogClient['pages']['list']>>): QueryResult<Answer<CatalogClient['pages']['list']>>;
+declare function usePage(handle: string | null, options?: QueryOptions<Answer<CatalogClient['pages']['get']>>): QueryResult<Answer<CatalogClient['pages']['get']>>;
 
-export { useCollections, useReviewEligibility, useTags };
+export { useCollections, usePage, usePages, useReviewEligibility, useTags };

package/dist/react-extras.js

@@ -3,8 +3,8 @@ import {
   defined,
   useCustomerKey,
   useQuery
-} from "./chunk-CADIHOIR.js";
-import "./chunk-3DLH56OX.js";
+} from "./chunk-3FX2HISB.js";
+import "./chunk-VJHA7J7B.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/react/extras/index.ts
@@ -35,8 +35,26 @@ function useReviewEligibility(handle, options = {}) {
     { ...options, staleTimeMs: options.staleTimeMs ?? 0 }
   );
 }
+function usePages(options) {
+  return useQuery(
+    "pages",
+    null,
+    (client, call) => client.pages.list(call),
+    options
+  );
+}
+function usePage(handle, options) {
+  return useQuery(
+    "page",
+    { handle },
+    handle === null ? null : (client, call) => client.pages.get(handle, call),
+    options
+  );
+}
 export {
   useCollections,
+  usePage,
+  usePages,
   useReviewEligibility,
   useTags
 };

package/dist/react.cjs

@@ -15,15 +15,17 @@
 
 
 
-var _chunkGU63WFXIcjs = require('./chunk-GU63WFXI.cjs');
 
 
+var _chunkOKWXS3FDcjs = require('./chunk-OKWXS3FD.cjs');
 
 
 
 
 
-var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
+
+
+var _chunkJ2GHGQY6cjs = require('./chunk-J2GHGQY6.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/react/use-cart.ts
@@ -40,7 +42,7 @@ function newKey() {
   return out;
 }
 function refuse(message, path) {
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
+  return new (0, _chunkJ2GHGQY6cjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -53,7 +55,7 @@ var UNSAFE = /[\x00-\x20\x7f]/u;
 function isHttpUrl(value) {
   return typeof value === "string" && /^https?:\/\/[^/?#\\]/iu.test(value) && !UNSAFE.test(value);
 }
-var wrap = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk2YQNMBDIcjs.CatalogError)({
+var wrap = (error) => _chunkJ2GHGQY6cjs.isCatalogError.call(void 0, error) ? error : new (0, _chunkJ2GHGQY6cjs.CatalogError)({
   code: "CLIENT_ERROR",
   message: "The action failed.",
   statusCode: 0,
@@ -64,7 +66,7 @@ var wrap = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) ? err
 function checkPause(store) {
   const until = store.pausedUntil();
   if (until > 0) {
-    throw new (0, _chunk2YQNMBDIcjs.RateLimitedError)({
+    throw new (0, _chunkJ2GHGQY6cjs.RateLimitedError)({
       code: "RATE_LIMITED",
       message: "Too many requests.",
       statusCode: 429,
@@ -74,7 +76,7 @@ function checkPause(store) {
   }
 }
 function notePause(store, error) {
-  if (error instanceof _chunk2YQNMBDIcjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
+  if (error instanceof _chunkJ2GHGQY6cjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
     store.pause(Date.now() + error.retryAfterSeconds * 1e3, error);
 }
 function createBox(initial) {
@@ -109,7 +111,7 @@ var ENDED = /* @__PURE__ */ new Set([
   "cart_not_open",
   "cart_not_found"
 ]);
-var ended = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
+var ended = (error) => _chunkJ2GHGQY6cjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
 var converted = (error) => _optionalChain([error, 'access', _2 => _2.details, 'optionalAccess', _3 => _3.reason]) === "converted";
 function itemsOf(cart) {
   const items = /* @__PURE__ */ new Map();
@@ -153,7 +155,7 @@ function createController(home) {
       throttleBaseUrl === void 0 ? void 0 : { throttleBaseUrl }
     );
   };
-  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunk2YQNMBDIcjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
+  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunkJ2GHGQY6cjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
   const live = async (signal, value) => {
     const out = await value;
     if (signal.aborted) throw signal.reason;
@@ -615,7 +617,7 @@ function createController(home) {
   };
 }
 function useCart(options = {}) {
-  const context = _chunkGU63WFXIcjs.useCatalogContext.call(void 0, );
+  const context = _chunkOKWXS3FDcjs.useCatalogContext.call(void 0, );
   const home = context.cart;
   const controller = _nullishCoalesce(home.current, () => ( (home.current = createController(home))));
   const state = _react.useSyncExternalStore.call(void 0, 
@@ -689,7 +691,7 @@ function useCart(options = {}) {
               { signal: callSignal }
             );
           } catch (error) {
-            const repriced = _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _41 => _41.details, 'optionalAccess', _42 => _42.cart]) : void 0;
+            const repriced = _chunkJ2GHGQY6cjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _41 => _41.details, 'optionalAccess', _42 => _42.cart]) : void 0;
             if (!callSignal.aborted && typeof repriced === "object" && repriced !== null)
               controller.box.set({ cart: repriced });
             throw error;
@@ -709,7 +711,7 @@ function useCart(options = {}) {
         if (out === void 0)
           throw _nullishCoalesce(met, () => ( refuse("There is no cart to check out.")));
         if (!isHttpUrl(out.checkoutUrl))
-          throw new (0, _chunk2YQNMBDIcjs.CatalogError)({
+          throw new (0, _chunkJ2GHGQY6cjs.CatalogError)({
             code: "INVALID_RESPONSE",
             message: "Throttle answered a checkout URL that is not http or https.",
             statusCode: 200,
@@ -727,7 +729,7 @@ function useCart(options = {}) {
   const owner = controller.owner();
   const view = owner !== void 0 && owner !== null && owner !== customerKey ? { ...EMPTY, pending: state.pending } : state;
   const shownCurrency = _nullishCoalesce(_nullishCoalesce(_optionalChain([view, 'access', _43 => _43.cart, 'optionalAccess', _44 => _44.currency]), () => ( controller.wanted(options))), () => ( ""));
-  const format = (minor) => _chunk2YQNMBDIcjs.formatMoney.call(void 0, minor, shownCurrency);
+  const format = (minor) => _chunkJ2GHGQY6cjs.formatMoney.call(void 0, minor, shownCurrency);
   return { ...view, ...actions, format };
 }
 
@@ -739,7 +741,7 @@ var IDLE = {
   result: void 0
 };
 function useSubmitReview(handle) {
-  const { client, store, customerKey } = _chunkGU63WFXIcjs.useCatalogContext.call(void 0, );
+  const { client, store, customerKey } = _chunkOKWXS3FDcjs.useCatalogContext.call(void 0, );
   const scope = _react.useMemo.call(void 0, 
     () => ({
       box: createBox(IDLE),
@@ -810,4 +812,6 @@ function useSubmitReview(handle) {
 
 
 
-exports.CatalogProvider = _chunkGU63WFXIcjs.CatalogProvider; exports.SDK_VERSION = _chunk2YQNMBDIcjs.SDK_VERSION; exports.catalogQueryKey = _chunkGU63WFXIcjs.catalogQueryKey; exports.createMemoryCartStorage = _chunkGU63WFXIcjs.createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = _chunkGU63WFXIcjs.useCatalog; exports.useCategories = _chunkGU63WFXIcjs.useCategories; exports.useCollection = _chunkGU63WFXIcjs.useCollection; exports.useConfig = _chunkGU63WFXIcjs.useConfig; exports.useCustomerKey = _chunkGU63WFXIcjs.useCustomerKey; exports.useFilterValues = _chunkGU63WFXIcjs.useFilterValues; exports.useProduct = _chunkGU63WFXIcjs.useProduct; exports.useProducts = _chunkGU63WFXIcjs.useProducts; exports.useRelated = _chunkGU63WFXIcjs.useRelated; exports.useReviews = _chunkGU63WFXIcjs.useReviews; exports.useSubmitReview = useSubmitReview; exports.useSuggest = _chunkGU63WFXIcjs.useSuggest;
+
+
+exports.CatalogProvider = _chunkOKWXS3FDcjs.CatalogProvider; exports.SDK_VERSION = _chunkJ2GHGQY6cjs.SDK_VERSION; exports.catalogQueryKey = _chunkOKWXS3FDcjs.catalogQueryKey; exports.createMemoryCartStorage = _chunkOKWXS3FDcjs.createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = _chunkOKWXS3FDcjs.useCatalog; exports.useCategories = _chunkOKWXS3FDcjs.useCategories; exports.useCollection = _chunkOKWXS3FDcjs.useCollection; exports.useConfig = _chunkOKWXS3FDcjs.useConfig; exports.useCustomerKey = _chunkOKWXS3FDcjs.useCustomerKey; exports.useFilterValues = _chunkOKWXS3FDcjs.useFilterValues; exports.useGenerationWatch = _chunkOKWXS3FDcjs.useGenerationWatch; exports.useProduct = _chunkOKWXS3FDcjs.useProduct; exports.useProducts = _chunkOKWXS3FDcjs.useProducts; exports.useRelated = _chunkOKWXS3FDcjs.useRelated; exports.useReviews = _chunkOKWXS3FDcjs.useReviews; exports.useStorefrontSettings = _chunkOKWXS3FDcjs.useStorefrontSettings; exports.useSubmitReview = useSubmitReview; exports.useSuggest = _chunkOKWXS3FDcjs.useSuggest;

package/dist/react.d.cts

@@ -1,11 +1,11 @@
 export { ReviewEligibility } from './index.cjs';
 import { ReactNode } from 'react';
 import { CatalogClient } from './index.cjs';
-import { C as CustomerCartSource } from './types-D0PywKnN.cjs';
+import { C as CustomerCartSource } from './types-jNpOwEUw.cjs';
 import { CategoryTreeDepth, ProductsQuery, ThrottleCart, CartWarning } from './index.cjs';
-export { O as OpenCartRef } from './types-D0PywKnN.cjs';
-import { Q as QueryOptions, a as QueryResult } from './use-query-UWf6Pi5g.cjs';
-export { c as catalogQueryKey } from './use-query-UWf6Pi5g.cjs';
+export { O as OpenCartRef } from './types-jNpOwEUw.cjs';
+import { Q as QueryOptions, a as QueryResult } from './use-query-H1xgL3_e.cjs';
+export { c as catalogQueryKey } from './use-query-H1xgL3_e.cjs';
 import { CatalogError } from './admin.cjs';
 import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.cjs';
 export { S as SDK_VERSION } from './version-ev3p03v2.cjs';
@@ -99,6 +99,23 @@ declare function useReviews(handle: string | null, options?: QueryOptions<Answer
     cursor?: string;
 }): QueryResult<Answer<ReviewsList>>;
 declare function useConfig(options?: QueryOptions<Answer<CatalogClient['config']>>): QueryResult<Answer<CatalogClient['config']>>;
+/** The storefront settings with what versions them: `{ settings, settingsVersion, generation }`. */
+declare function useStorefrontSettings(options?: QueryOptions<Answer<CatalogClient['settings']>>): QueryResult<Answer<CatalogClient['settings']>>;
+/**
+ * Watches the storefront's generation: every `intervalMs` (60 s), while the
+ * page is visible, it asks `config` (conditionally, so an unchanged answer is
+ * a `304`), and checks at once when the page becomes visible after being
+ * hidden for at least the interval (or before a first answer). When the
+ * generation changes, the provider's cache is invalidated (hooks on screen
+ * keep their data and read again) and every mounted watcher's `onChange` is
+ * called once with the new generation. One timer and one request per
+ * provider however many watchers are mounted (the first one's `intervalMs`
+ * applies). Nothing runs on the server.
+ */
+declare function useGenerationWatch({ intervalMs, onChange, }?: {
+    intervalMs?: number;
+    onChange?: (generation: number) => void;
+}): void;
 /** The values of one filter for a selection. */
 declare function useFilterValues(key: string | null, query?: ProductsQuery, options?: QueryOptions<Answer<CatalogClient['filters']['values']>>): QueryResult<Answer<CatalogClient['filters']['values']>>;
 
@@ -184,5 +201,5 @@ type SubmitReviewResult = SubmitReviewState & {
  */
 declare function useSubmitReview(handle: string): SubmitReviewResult;
 
-export { CatalogProvider, CustomerCartSource, QueryOptions, QueryResult, createMemoryCartStorage, useCart, useCatalog, useCategories, useCollection, useConfig, useCustomerKey, useFilterValues, useProduct, useProducts, useRelated, useReviews, useSubmitReview, useSuggest };
+export { CatalogProvider, CustomerCartSource, QueryOptions, QueryResult, createMemoryCartStorage, useCart, useCatalog, useCategories, useCollection, useConfig, useCustomerKey, useFilterValues, useGenerationWatch, useProduct, useProducts, useRelated, useReviews, useStorefrontSettings, useSubmitReview, useSuggest };
 export type { CartOptions, CartState, CartStorage, CartUrls, CatalogProviderProps, SubmitReviewResult, SubmitReviewState, UseCartResult };

package/dist/react.d.ts

@@ -1,11 +1,11 @@
 export { ReviewEligibility } from './index.js';
 import { ReactNode } from 'react';
 import { CatalogClient } from './index.js';
-import { C as CustomerCartSource } from './types-BfveENg1.js';
+import { C as CustomerCartSource } from './types-z57bkjjB.js';
 import { CategoryTreeDepth, ProductsQuery, ThrottleCart, CartWarning } from './index.js';
-export { O as OpenCartRef } from './types-BfveENg1.js';
-import { Q as QueryOptions, a as QueryResult } from './use-query-CR7r5tam.js';
-export { c as catalogQueryKey } from './use-query-CR7r5tam.js';
+export { O as OpenCartRef } from './types-z57bkjjB.js';
+import { Q as QueryOptions, a as QueryResult } from './use-query-COqRZJnC.js';
+export { c as catalogQueryKey } from './use-query-COqRZJnC.js';
 import { CatalogError } from './admin.js';
 import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.js';
 export { S as SDK_VERSION } from './version-ev3p03v2.js';
@@ -99,6 +99,23 @@ declare function useReviews(handle: string | null, options?: QueryOptions<Answer
     cursor?: string;
 }): QueryResult<Answer<ReviewsList>>;
 declare function useConfig(options?: QueryOptions<Answer<CatalogClient['config']>>): QueryResult<Answer<CatalogClient['config']>>;
+/** The storefront settings with what versions them: `{ settings, settingsVersion, generation }`. */
+declare function useStorefrontSettings(options?: QueryOptions<Answer<CatalogClient['settings']>>): QueryResult<Answer<CatalogClient['settings']>>;
+/**
+ * Watches the storefront's generation: every `intervalMs` (60 s), while the
+ * page is visible, it asks `config` (conditionally, so an unchanged answer is
+ * a `304`), and checks at once when the page becomes visible after being
+ * hidden for at least the interval (or before a first answer). When the
+ * generation changes, the provider's cache is invalidated (hooks on screen
+ * keep their data and read again) and every mounted watcher's `onChange` is
+ * called once with the new generation. One timer and one request per
+ * provider however many watchers are mounted (the first one's `intervalMs`
+ * applies). Nothing runs on the server.
+ */
+declare function useGenerationWatch({ intervalMs, onChange, }?: {
+    intervalMs?: number;
+    onChange?: (generation: number) => void;
+}): void;
 /** The values of one filter for a selection. */
 declare function useFilterValues(key: string | null, query?: ProductsQuery, options?: QueryOptions<Answer<CatalogClient['filters']['values']>>): QueryResult<Answer<CatalogClient['filters']['values']>>;
 
@@ -184,5 +201,5 @@ type SubmitReviewResult = SubmitReviewState & {
  */
 declare function useSubmitReview(handle: string): SubmitReviewResult;
 
-export { CatalogProvider, CustomerCartSource, QueryOptions, QueryResult, createMemoryCartStorage, useCart, useCatalog, useCategories, useCollection, useConfig, useCustomerKey, useFilterValues, useProduct, useProducts, useRelated, useReviews, useSubmitReview, useSuggest };
+export { CatalogProvider, CustomerCartSource, QueryOptions, QueryResult, createMemoryCartStorage, useCart, useCatalog, useCategories, useCollection, useConfig, useCustomerKey, useFilterValues, useGenerationWatch, useProduct, useProducts, useRelated, useReviews, useStorefrontSettings, useSubmitReview, useSuggest };
 export type { CartOptions, CartState, CartStorage, CartUrls, CatalogProviderProps, SubmitReviewResult, SubmitReviewState, UseCartResult };

package/dist/react.js

@@ -10,12 +10,14 @@ import {
   useConfig,
   useCustomerKey,
   useFilterValues,
+  useGenerationWatch,
   useProduct,
   useProducts,
   useRelated,
   useReviews,
+  useStorefrontSettings,
   useSuggest
-} from "./chunk-CADIHOIR.js";
+} from "./chunk-3FX2HISB.js";
 import {
   CatalogError,
   RateLimitedError,
@@ -23,7 +25,7 @@ import {
   THROTTLE_CHECKOUT_URL,
   formatMoney,
   isCatalogError
-} from "./chunk-3DLH56OX.js";
+} from "./chunk-VJHA7J7B.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/react/use-cart.ts
@@ -804,10 +806,12 @@ export {
   useConfig,
   useCustomerKey,
   useFilterValues,
+  useGenerationWatch,
   useProduct,
   useProducts,
   useRelated,
   useReviews,
+  useStorefrontSettings,
   useSubmitReview,
   useSuggest
 };

package/dist/server.cjs

@@ -8,91 +8,79 @@
 
 
 
+var _chunkPZ3SFYH4cjs = require('./chunk-PZ3SFYH4.cjs');
+
+
+
 
-var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
-require('./chunk-ETV4XYOV.cjs');
 
-// src/server/tags.ts
-function catalogTags(route, handle) {
-  const tags = [_chunk2YQNMBDIcjs.CACHE_TAG, `${_chunk2YQNMBDIcjs.CACHE_TAG}:${route}`];
-  if (handle !== void 0) tags.push(`${_chunk2YQNMBDIcjs.CACHE_TAG}:${route}:${handle}`);
-  return tags.filter((tag) => tag.length <= _chunk2YQNMBDIcjs.TAG_MAX_CHARS);
-}
-function decode(segment) {
-  try {
-    return decodeURIComponent(segment);
-  } catch (e) {
-    return segment;
-  }
-}
-function tagsForUrl(url, storefront) {
-  const path = _nullishCoalesce(url.split(/[?#]/u, 1)[0], () => ( ""));
-  if (!path.startsWith(storefront)) return null;
-  const parts = path.slice(storefront.length).split("/");
-  if (parts.length > 3) return null;
-  const [first, segment, sub] = parts;
-  if (segment === void 0) {
-    switch (first) {
-      case "config":
-      case "products":
-      case "categories":
-      case "tags":
-      case "collections":
-      case "suggest":
-        return catalogTags(first);
-      default:
-        return null;
-    }
-  }
-  const handle = decode(segment);
-  if (handle === "") return null;
-  switch (first) {
-    case "filters":
-      return sub === "values" ? catalogTags("filters") : null;
-    case "products":
-      if (sub === "related" || sub === "reviews")
-        return catalogTags(sub, handle);
-      return sub === void 0 ? catalogTags("product", handle) : null;
-    case "categories":
-      return sub === void 0 ? catalogTags("category", handle) : null;
-    case "collections":
-      return sub === void 0 ? catalogTags("collection", handle) : null;
-    default:
-      return null;
-  }
-}
+
+
+
+var _chunkJ2GHGQY6cjs = require('./chunk-J2GHGQY6.cjs');
+require('./chunk-ETV4XYOV.cjs');
 
 // src/server/client.ts
-function serverInit(url, init, storefront, revalidate, extraTags) {
+function serverInit(url, init, storefront, policies, extraTags) {
   const { next, ...rest } = init;
-  const tags = rest.method === "GET" ? tagsForUrl(url, storefront) : null;
+  const tags = rest.method === "GET" ? _chunkPZ3SFYH4cjs.tagsForUrl.call(void 0, url, storefront) : null;
   if (tags === null || rest.cache === "no-store")
     return { ...rest, cache: "no-store" };
   if (next !== void 0) return init;
-  return { ...rest, next: { revalidate, tags: [...tags, ...extraTags] } };
+  const kind = _chunkPZ3SFYH4cjs.cacheKindForPath.call(void 0, url.slice(storefront.length));
+  const policy = kind === null ? "no-store" : policies(kind);
+  if (policy === "no-store") return { ...rest, cache: "no-store" };
+  return {
+    ...rest,
+    next: { revalidate: policy.revalidate, tags: [...tags, ...extraTags] }
+  };
 }
 function createServerCatalogClient(options) {
   const {
     next,
+    cachePolicy,
+    floorKey: namedFloorKey,
     // eslint-disable-next-line @typescript-eslint/no-unused-vars -- dropped on purpose (P8-R21)
     keyInQuery: _ignored,
     ...rest
   } = options;
-  const revalidate = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _ => _.revalidate]), () => ( _chunk2YQNMBDIcjs.DEFAULT_REVALIDATE_S));
+  const named = /* @__PURE__ */ new Map();
+  for (const [kind, policy] of Object.entries(_nullishCoalesce(cachePolicy, () => ( {}))))
+    if (policy !== void 0)
+      named.set(kind, _chunkPZ3SFYH4cjs.policyToNext.call(void 0, policy));
+  const policies = (kind) => _nullishCoalesce(named.get(kind), () => ( (_optionalChain([next, 'optionalAccess', _ => _.revalidate]) === void 0 ? _chunkPZ3SFYH4cjs.policyToNext.call(void 0, _chunkPZ3SFYH4cjs.DEFAULT_CACHE_POLICY[kind]) : { revalidate: next.revalidate })));
+  const floorKey = _nullishCoalesce(namedFloorKey, () => ( rest.publishableKey));
   const extraTags = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _2 => _2.tags]), () => ( []));
-  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunk2YQNMBDIcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
+  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunkJ2GHGQY6cjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
   const base = rest.fetch;
   const serverFetch = (input, init = {}) => {
+    let target = String(input);
+    const isConfig = init.method === "GET" && target.startsWith(storefront) && _optionalChain([_chunkPZ3SFYH4cjs.storefrontRoute.call(void 0, target.slice(storefront.length)), 'optionalAccess', _3 => _3.route]) === "config";
+    const floor = isConfig ? _chunkPZ3SFYH4cjs.pendingMinGeneration.call(void 0, floorKey) : void 0;
+    if (floor !== void 0 && !target.includes("minGeneration="))
+      target += `${target.includes("?") ? "&" : "?"}minGeneration=${floor}`;
     const out = serverInit(
-      String(input),
+      target,
       init,
       storefront,
-      revalidate,
+      policies,
       extraTags
     );
-    return base !== void 0 ? base(input, out) : globalThis.fetch(input, out);
+    const answer = base !== void 0 ? base(target, out) : globalThis.fetch(target, out);
+    if (floor === void 0) return answer;
+    return answer.then(async (response) => {
+      if (response.ok)
+        try {
+          _chunkPZ3SFYH4cjs.observeGeneration.call(void 0, 
+            (await response.clone().json()).generation,
+            floorKey
+          );
+        } catch (e) {
+        }
+      return response;
+    });
   };
-  return _chunk2YQNMBDIcjs.createCatalogClient.call(void 0, {
+  return _chunkJ2GHGQY6cjs.createCatalogClient.call(void 0, {
     ...rest,
     fetch: serverFetch
   });
@@ -112,16 +100,16 @@ async function syncCatalogGeneration(input) {
 
 // src/server/paging.ts
 function bounds(opts) {
-  const pageSize = _nullishCoalesce(opts.pageSize, () => ( _chunk2YQNMBDIcjs.LIST_PAGE_SIZE));
-  const max = _nullishCoalesce(opts.max, () => ( _chunk2YQNMBDIcjs.LIST_MAX_HANDLES));
-  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > _chunk2YQNMBDIcjs.LIST_PAGE_SIZE)
+  const pageSize = _nullishCoalesce(opts.pageSize, () => ( _chunkJ2GHGQY6cjs.LIST_PAGE_SIZE));
+  const max = _nullishCoalesce(opts.max, () => ( _chunkJ2GHGQY6cjs.LIST_MAX_HANDLES));
+  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > _chunkJ2GHGQY6cjs.LIST_PAGE_SIZE)
     throw invalid("pageSize must be a whole number from 1 to 100.");
   if (!Number.isInteger(max) || max < 0)
     throw invalid("max must be a whole number of 0 or more.");
   return { pageSize, max };
 }
 function invalid(message) {
-  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
+  return new (0, _chunkJ2GHGQY6cjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -191,7 +179,7 @@ function listAllCollectionHandles(client, opts = {}) {
 }
 async function listAllCategoryHandles(client, opts = {}) {
   const { categories } = await client.categories.tree({
-    depth: _chunk2YQNMBDIcjs.CATEGORY_TREE_MAX_DEPTH,
+    depth: _chunkJ2GHGQY6cjs.CATEGORY_TREE_MAX_DEPTH,
     ...call(opts.signal)
   });
   const out = [];
@@ -213,4 +201,8 @@ async function listAllCategoryHandles(client, opts = {}) {
 
 
 
-exports.SDK_VERSION = _chunk2YQNMBDIcjs.SDK_VERSION; exports.catalogTags = catalogTags; exports.createServerCatalogClient = createServerCatalogClient; exports.listAllCategoryHandles = listAllCategoryHandles; exports.listAllCollectionHandles = listAllCollectionHandles; exports.listAllProductHandles = listAllProductHandles; exports.staticProductParams = staticProductParams; exports.syncCatalogGeneration = syncCatalogGeneration;
+
+
+
+
+exports.DEFAULT_CACHE_POLICY = _chunkPZ3SFYH4cjs.DEFAULT_CACHE_POLICY; exports.SDK_VERSION = _chunkJ2GHGQY6cjs.SDK_VERSION; exports.cacheKindForPath = _chunkPZ3SFYH4cjs.cacheKindForPath; exports.catalogTags = _chunkPZ3SFYH4cjs.catalogTags; exports.createServerCatalogClient = createServerCatalogClient; exports.listAllCategoryHandles = listAllCategoryHandles; exports.listAllCollectionHandles = listAllCollectionHandles; exports.listAllProductHandles = listAllProductHandles; exports.policyToNext = _chunkPZ3SFYH4cjs.policyToNext; exports.scopesToTags = _chunkPZ3SFYH4cjs.scopesToTags; exports.staticProductParams = staticProductParams; exports.syncCatalogGeneration = syncCatalogGeneration;