@usethrottle/catalog 1.2.0 → 1.4.0

package/dist/next.cjs

@@ -0,0 +1,180 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkPZ3SFYH4cjs = require('./chunk-PZ3SFYH4.cjs');
+
+
+
+var _chunkJ2GHGQY6cjs = require('./chunk-J2GHGQY6.cjs');
+require('./chunk-ETV4XYOV.cjs');
+
+// 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 |= (_nullishCoalesce(left[i], () => ( 0))) ^ (_nullishCoalesce(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]) => _nullishCoalesce(v, () => ( "")));
+    const digests = parts.filter(([k]) => k === "v1").map(([, v]) => _nullishCoalesce(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 = _nullishCoalesce(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 (e) {
+    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 (e2) {
+    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 <= _chunkJ2GHGQY6cjs.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 Promise.resolve().then(() => _interopRequireWildcard(require("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 = _nullishCoalesce(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 = _chunkPZ3SFYH4cjs.scopesToTags.call(void 0, notice.scopes);
+    const revalidate = await _asyncNullishCoalesce(options.revalidateTag, async () => ( await defaultRevalidateTag()));
+    for (const tag of tags) revalidate(tag);
+    _chunkPZ3SFYH4cjs.noteMinGeneration.call(void 0, 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 Promise.resolve().then(() => _interopRequireWildcard(require("next/headers")));
+  const store = await cookies();
+  const value = _optionalChain([store, 'access', _2 => _2.get, 'call', _3 => _3(PREVIEW_COOKIE), 'optionalAccess', _4 => _4.value]);
+  return value === void 0 || value === "" ? void 0 : value;
+}
+
+
+
+
+
+
+exports.SDK_VERSION = _chunkJ2GHGQY6cjs.SDK_VERSION; exports.createRevalidateHandler = createRevalidateHandler; exports.getPreviewToken = getPreviewToken; exports.noteMinGeneration = _chunkPZ3SFYH4cjs.noteMinGeneration; exports.previewMiddleware = previewMiddleware;

package/dist/next.d.cts

@@ -0,0 +1,60 @@
+export { S as SDK_VERSION } from './version-ev3p03v2.cjs';
+
+type CreateRevalidateHandlerOptions = {
+    /**
+     * The webhook's signing secret; pass `process.env` straight in. A list
+     * accepts any of them, so a rotated secret can be added before the old one
+     * is removed. Checked on each request, not here: an unset variable at
+     * `next build` time must not fail the build. With no secret a request is
+     * answered 500 and nothing is revalidated.
+     */
+    secret: string | undefined | readonly (string | undefined)[];
+    /**
+     * Whose floor the notice's generation raises (see `noteMinGeneration`).
+     * Omitted, it applies to every client in the process: right for one store.
+     * With several stores, pass the `publishableKey` of this store's server
+     * client (or the `floorKey` that client names).
+     */
+    floorKey?: string;
+    /**
+     * Called once per cache tag to clear. Defaults to `revalidateTag` from
+     * `next/cache`.
+     */
+    revalidateTag?: (tag: string) => void;
+};
+/**
+ * The route handler for the catalog's `storefront.changed` webhook. It checks
+ * the `x-catalog-signature` header (HMAC-SHA256 over `<t>.<body>`, 300 s
+ * tolerance, any of the given secrets), clears the cache tags of the event's
+ * scopes and notes its generation so the next `/config` read is fresh.
+ * Answers 200 `{ revalidated }`, 401 for a missing or wrong signature, 400
+ * for a body that is not a change notice, 413 for a body over 64 KB and 500
+ * when no secret is set. A `test` event is acknowledged
+ * (`{ revalidated: [] }`) and does nothing else.
+ */
+declare function createRevalidateHandler(options: CreateRevalidateHandlerOptions): (req: Request) => Promise<Response>;
+
+/**
+ * For Next middleware: a request with `?throttle_preview=<token>` is answered
+ * with a 307 to the same URL without that parameter and the token in an
+ * HTTP-only `SameSite=None; Secure` cookie (one hour), so it works inside the
+ * dashboard's preview iframe. Any other request returns `null`.
+ */
+declare function previewMiddleware(req: Request): Response | null;
+/**
+ * The preview token of the current request (the `throttle_preview` cookie),
+ * for `createServerCatalogClient({ previewToken })`. Reads `cookies()` from
+ * `next/headers`, which is a promise in Next 15 and later and a plain object
+ * in Next 14. Call it where Next allows a request-scoped read.
+ */
+declare function getPreviewToken(): Promise<string | undefined>;
+
+/**
+ * Records `generation` as the minimum the next `/config` read of `floorKey`'s
+ * store (every store, when omitted) must reach. The largest value noted stays
+ * until a `/config` answer reaches it.
+ */
+declare function noteMinGeneration(generation: number, floorKey?: string): void;
+
+export { createRevalidateHandler, getPreviewToken, noteMinGeneration, previewMiddleware };
+export type { CreateRevalidateHandlerOptions };

package/dist/next.d.ts

@@ -0,0 +1,60 @@
+export { S as SDK_VERSION } from './version-ev3p03v2.js';
+
+type CreateRevalidateHandlerOptions = {
+    /**
+     * The webhook's signing secret; pass `process.env` straight in. A list
+     * accepts any of them, so a rotated secret can be added before the old one
+     * is removed. Checked on each request, not here: an unset variable at
+     * `next build` time must not fail the build. With no secret a request is
+     * answered 500 and nothing is revalidated.
+     */
+    secret: string | undefined | readonly (string | undefined)[];
+    /**
+     * Whose floor the notice's generation raises (see `noteMinGeneration`).
+     * Omitted, it applies to every client in the process: right for one store.
+     * With several stores, pass the `publishableKey` of this store's server
+     * client (or the `floorKey` that client names).
+     */
+    floorKey?: string;
+    /**
+     * Called once per cache tag to clear. Defaults to `revalidateTag` from
+     * `next/cache`.
+     */
+    revalidateTag?: (tag: string) => void;
+};
+/**
+ * The route handler for the catalog's `storefront.changed` webhook. It checks
+ * the `x-catalog-signature` header (HMAC-SHA256 over `<t>.<body>`, 300 s
+ * tolerance, any of the given secrets), clears the cache tags of the event's
+ * scopes and notes its generation so the next `/config` read is fresh.
+ * Answers 200 `{ revalidated }`, 401 for a missing or wrong signature, 400
+ * for a body that is not a change notice, 413 for a body over 64 KB and 500
+ * when no secret is set. A `test` event is acknowledged
+ * (`{ revalidated: [] }`) and does nothing else.
+ */
+declare function createRevalidateHandler(options: CreateRevalidateHandlerOptions): (req: Request) => Promise<Response>;
+
+/**
+ * For Next middleware: a request with `?throttle_preview=<token>` is answered
+ * with a 307 to the same URL without that parameter and the token in an
+ * HTTP-only `SameSite=None; Secure` cookie (one hour), so it works inside the
+ * dashboard's preview iframe. Any other request returns `null`.
+ */
+declare function previewMiddleware(req: Request): Response | null;
+/**
+ * The preview token of the current request (the `throttle_preview` cookie),
+ * for `createServerCatalogClient({ previewToken })`. Reads `cookies()` from
+ * `next/headers`, which is a promise in Next 15 and later and a plain object
+ * in Next 14. Call it where Next allows a request-scoped read.
+ */
+declare function getPreviewToken(): Promise<string | undefined>;
+
+/**
+ * Records `generation` as the minimum the next `/config` read of `floorKey`'s
+ * store (every store, when omitted) must reach. The largest value noted stays
+ * until a `/config` answer reaches it.
+ */
+declare function noteMinGeneration(generation: number, floorKey?: string): void;
+
+export { createRevalidateHandler, getPreviewToken, noteMinGeneration, previewMiddleware };
+export type { CreateRevalidateHandlerOptions };

package/dist/next.js

@@ -0,0 +1,180 @@
+import {
+  noteMinGeneration,
+  scopesToTags
+} from "./chunk-SN6STYPW.js";
+import {
+  SDK_VERSION,
+  TAG_MAX_CHARS
+} from "./chunk-VJHA7J7B.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 _chunkTDMDOHD3cjs = require('./chunk-TDMDOHD3.cjs');
-require('./chunk-B2DYAHNR.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 = _chunkTDMDOHD3cjs.defined.call(void 0, { q: options.q, limit: options.limit });
-  return _chunkTDMDOHD3cjs.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 = _chunkTDMDOHD3cjs.defined.call(void 0, { limit: options.limit, cursor: options.cursor });
-  return _chunkTDMDOHD3cjs.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 = _chunkTDMDOHD3cjs.useCustomerKey.call(void 0, );
-  return _chunkTDMDOHD3cjs.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,8 +1,9 @@
 import { CatalogClient } from './index.cjs';
 import { QueryOptions, QueryResult } from './react.cjs';
-import './types-BTrqSprj.cjs';
-import './contract-types-BPSzY_Co.cjs';
-import './catalog-error-yTBMAdCv.cjs';
+import './types-jNpOwEUw.cjs';
+import '@usethrottle/money';
+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']>> & {
@@ -18,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,8 +1,9 @@
 import { CatalogClient } from './index.js';
 import { QueryOptions, QueryResult } from './react.js';
-import './types-BlYCKzB8.js';
-import './contract-types-BPSzY_Co.js';
-import './catalog-error-7DCsTyB2.js';
+import './types-z57bkjjB.js';
+import '@usethrottle/money';
+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']>> & {
@@ -18,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-JNBKKAMP.js";
-import "./chunk-55G4ZTD5.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
 };