@usethrottle/catalog 1.3.0 → 1.4.1

package/dist/next.js

@@ -0,0 +1,180 @@
+import {
+  noteMinGeneration,
+  scopesToTags
+} from "./chunk-P3ABGAF5.js";
+import {
+  SDK_VERSION,
+  TAG_MAX_CHARS
+} from "./chunk-STNQNHNZ.js";
+import "./chunk-PKBMQBKP.js";
+
+// src/next/verify.ts
+var HEX_SHA256 = /^[0-9a-fA-F]{64}$/u;
+var TOLERANCE_SECONDS = 300;
+var MAX_V1 = 8;
+var MAX_HEADER_BYTES = 1024;
+var encoder = new TextEncoder();
+async function hmac(secret, payload) {
+  const key = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  return new Uint8Array(
+    await crypto.subtle.sign("HMAC", key, encoder.encode(payload))
+  );
+}
+function fromHex(hex) {
+  return Uint8Array.from(
+    { length: hex.length / 2 },
+    (_, i) => Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16)
+  );
+}
+function constantTimeEqual(left, right) {
+  const length = Math.max(left.length, right.length);
+  let difference = left.length ^ right.length;
+  for (let i = 0; i < length; i += 1)
+    difference |= (left[i] ?? 0) ^ (right[i] ?? 0);
+  return difference === 0;
+}
+async function verifyCatalogWebhook(input) {
+  try {
+    const { secret, rawBody, signature } = input;
+    const now = Math.floor(Date.now() / 1e3);
+    if (secret.length === 0 || rawBody.length === 0 || signature.length === 0 || encoder.encode(signature).byteLength > MAX_HEADER_BYTES)
+      return false;
+    const parts = signature.split(",").map((part) => part.split("="));
+    if (parts.some((part) => part.length !== 2)) return false;
+    const timestamps = parts.filter(([k]) => k === "t").map(([, v]) => v ?? "");
+    const digests = parts.filter(([k]) => k === "v1").map(([, v]) => v ?? "");
+    if (parts.some(([k]) => k !== "t" && k !== "v1") || timestamps.length !== 1 || digests.length === 0 || digests.length > MAX_V1 || digests.some((d) => !HEX_SHA256.test(d)))
+      return false;
+    const timestampText = timestamps[0] ?? "";
+    if (!/^(?:0|[1-9][0-9]*)$/u.test(timestampText)) return false;
+    const timestamp = Number(timestampText);
+    if (!Number.isSafeInteger(timestamp) || Math.abs(now - timestamp) > TOLERANCE_SECONDS)
+      return false;
+    const expected = await hmac(secret, `${timestampText}.${rawBody}`);
+    let matched = false;
+    for (const digest of digests)
+      matched = constantTimeEqual(expected, fromHex(digest)) || matched;
+    return matched;
+  } catch {
+    return false;
+  }
+}
+
+// src/next/revalidate.ts
+var SIGNATURE_HEADER = "x-catalog-signature";
+var MAX_BODY_BYTES = 64 * 1024;
+async function readCapped(req) {
+  const declared = Number(req.headers.get("content-length"));
+  if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) return null;
+  if (req.body === null) return "";
+  const reader = req.body.getReader();
+  const decoder = new TextDecoder();
+  let text = "";
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) return text + decoder.decode();
+    size += value.byteLength;
+    if (size > MAX_BODY_BYTES) {
+      await reader.cancel();
+      return null;
+    }
+    text += decoder.decode(value, { stream: true });
+  }
+}
+var json = (status, body) => new Response(JSON.stringify(body), {
+  status,
+  headers: {
+    "content-type": "application/json",
+    "cache-control": "no-store"
+  }
+});
+function parseNotice(rawBody) {
+  let value;
+  try {
+    value = JSON.parse(rawBody);
+  } catch {
+    return null;
+  }
+  if (typeof value !== "object" || value === null) return null;
+  const event = value;
+  const { generation, scopes } = event;
+  if (event.type !== "storefront.changed" || typeof generation !== "number" || !Number.isSafeInteger(generation) || generation < 0 || !Array.isArray(scopes) || scopes.length === 0 || !scopes.every(
+    (scope) => typeof scope === "string" && scope.length > 0 && scope.length <= TAG_MAX_CHARS
+  ) || event.test !== void 0 && typeof event.test !== "boolean")
+    return null;
+  return {
+    generation,
+    scopes,
+    test: event.test === true
+  };
+}
+async function defaultRevalidateTag() {
+  const { revalidateTag } = await import("next/cache");
+  return (tag) => revalidateTag(tag, { expire: 0 });
+}
+function createRevalidateHandler(options) {
+  return async (req) => {
+    const list = typeof options.secret === "string" || options.secret === void 0 ? [options.secret] : options.secret;
+    const secrets = list.filter(
+      (secret) => typeof secret === "string" && secret !== ""
+    );
+    if (secrets.length === 0)
+      return json(500, {
+        error: "createRevalidateHandler has no signing secret: set the webhook secret (for example THROTTLE_WEBHOOK_SECRET) in this environment."
+      });
+    const rawBody = await readCapped(req);
+    if (rawBody === null) return json(413, { error: "body too large" });
+    const signature = req.headers.get(SIGNATURE_HEADER) ?? "";
+    let verified = false;
+    for (const secret of secrets)
+      verified = await verifyCatalogWebhook({ rawBody, signature, secret }) || verified;
+    if (!verified) return json(401, { error: "invalid signature" });
+    const notice = parseNotice(rawBody);
+    if (notice === null) return json(400, { error: "invalid body" });
+    if (notice.test) return json(200, { revalidated: [] });
+    const tags = scopesToTags(notice.scopes);
+    const revalidate = options.revalidateTag ?? await defaultRevalidateTag();
+    for (const tag of tags) revalidate(tag);
+    noteMinGeneration(notice.generation, options.floorKey);
+    return json(200, { revalidated: tags });
+  };
+}
+
+// src/next/preview.ts
+var PREVIEW_COOKIE = "throttle_preview";
+var PREVIEW_PARAM = "throttle_preview";
+var PREVIEW_MAX_AGE_S = 3600;
+function previewMiddleware(req) {
+  const url = new URL(req.url);
+  const token = url.searchParams.get(PREVIEW_PARAM);
+  if (token === null || token === "") return null;
+  url.searchParams.delete(PREVIEW_PARAM);
+  return new Response(null, {
+    status: 307,
+    headers: {
+      location: url.toString(),
+      "set-cookie": `${PREVIEW_COOKIE}=${encodeURIComponent(token)}; Max-Age=${PREVIEW_MAX_AGE_S}; Path=/; HttpOnly; Secure; SameSite=None`,
+      "cache-control": "no-store"
+    }
+  });
+}
+async function getPreviewToken() {
+  const { cookies } = await import("next/headers");
+  const store = await cookies();
+  const value = store.get(PREVIEW_COOKIE)?.value;
+  return value === void 0 || value === "" ? void 0 : value;
+}
+export {
+  SDK_VERSION,
+  createRevalidateHandler,
+  getPreviewToken,
+  noteMinGeneration,
+  previewMiddleware
+};

package/dist/react-extras.cjs

@@ -3,14 +3,14 @@
 
 
 
-var _chunkGU63WFXIcjs = require('./chunk-GU63WFXI.cjs');
-require('./chunk-2YQNMBDI.cjs');
+var _chunkVOOX3WJYcjs = require('./chunk-VOOX3WJY.cjs');
+require('./chunk-2ODFFMZ4.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 = _chunkVOOX3WJYcjs.defined.call(void 0, { q: options.q, limit: options.limit });
+  return _chunkVOOX3WJYcjs.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 = _chunkVOOX3WJYcjs.defined.call(void 0, { limit: options.limit, cursor: options.cursor });
+  return _chunkVOOX3WJYcjs.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 = _chunkVOOX3WJYcjs.useCustomerKey.call(void 0, );
+  return _chunkVOOX3WJYcjs.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 _chunkVOOX3WJYcjs.useQuery.call(void 0, 
+    "pages",
+    null,
+    (client, call) => client.pages.list(call),
+    options
+  );
+}
+function usePage(handle, options) {
+  return _chunkVOOX3WJYcjs.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-BtBxMbM5.cjs';
 import '@usethrottle/money';
-import './contract-types-BRyonOYH.cjs';
-import './catalog-error-BOaSKgY3.cjs';
+import './contract-types-BJMeJSTz.cjs';
+import './catalog-error-bG1XHquN.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-dKvIfrVH.js';
 import '@usethrottle/money';
-import './contract-types-BRyonOYH.js';
-import './catalog-error-CSoPS0-d.js';
+import './contract-types-BJMeJSTz.js';
+import './catalog-error-c3BVgU6k.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-6K7H7HBD.js";
+import "./chunk-STNQNHNZ.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 _chunkVOOX3WJYcjs = require('./chunk-VOOX3WJY.cjs');
 
 
 
 
 
-var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
+
+
+var _chunk2ODFFMZ4cjs = require('./chunk-2ODFFMZ4.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, _chunk2ODFFMZ4cjs.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) => _chunk2ODFFMZ4cjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk2ODFFMZ4cjs.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, _chunk2ODFFMZ4cjs.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 _chunk2ODFFMZ4cjs.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) => _chunk2ODFFMZ4cjs.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, () => ( _chunk2ODFFMZ4cjs.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 = _chunkVOOX3WJYcjs.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 = _chunk2ODFFMZ4cjs.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, _chunk2ODFFMZ4cjs.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) => _chunk2ODFFMZ4cjs.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 } = _chunkVOOX3WJYcjs.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 = _chunkVOOX3WJYcjs.CatalogProvider; exports.SDK_VERSION = _chunk2ODFFMZ4cjs.SDK_VERSION; exports.catalogQueryKey = _chunkVOOX3WJYcjs.catalogQueryKey; exports.createMemoryCartStorage = _chunkVOOX3WJYcjs.createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = _chunkVOOX3WJYcjs.useCatalog; exports.useCategories = _chunkVOOX3WJYcjs.useCategories; exports.useCollection = _chunkVOOX3WJYcjs.useCollection; exports.useConfig = _chunkVOOX3WJYcjs.useConfig; exports.useCustomerKey = _chunkVOOX3WJYcjs.useCustomerKey; exports.useFilterValues = _chunkVOOX3WJYcjs.useFilterValues; exports.useGenerationWatch = _chunkVOOX3WJYcjs.useGenerationWatch; exports.useProduct = _chunkVOOX3WJYcjs.useProduct; exports.useProducts = _chunkVOOX3WJYcjs.useProducts; exports.useRelated = _chunkVOOX3WJYcjs.useRelated; exports.useReviews = _chunkVOOX3WJYcjs.useReviews; exports.useStorefrontSettings = _chunkVOOX3WJYcjs.useStorefrontSettings; exports.useSubmitReview = useSubmitReview; exports.useSuggest = _chunkVOOX3WJYcjs.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-BtBxMbM5.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-BtBxMbM5.cjs';
+import { Q as QueryOptions, a as QueryResult } from './use-query-C2rfTJd4.cjs';
+export { c as catalogQueryKey } from './use-query-C2rfTJd4.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-dKvIfrVH.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-dKvIfrVH.js';
+import { Q as QueryOptions, a as QueryResult } from './use-query-DeCj1hXt.js';
+export { c as catalogQueryKey } from './use-query-DeCj1hXt.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-6K7H7HBD.js";
 import {
   CatalogError,
   RateLimitedError,
@@ -23,7 +25,7 @@ import {
   THROTTLE_CHECKOUT_URL,
   formatMoney,
   isCatalogError
-} from "./chunk-3DLH56OX.js";
+} from "./chunk-STNQNHNZ.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
 };