@usethrottle/catalog 1.1.0 → 1.3.0

package/dist/server.cjs

@@ -9,14 +9,14 @@
 
 
 
-var _chunk4ORXUW2Ucjs = require('./chunk-4ORXUW2U.cjs');
+var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/server/tags.ts
 function catalogTags(route, handle) {
-  const tags = [_chunk4ORXUW2Ucjs.CACHE_TAG, `${_chunk4ORXUW2Ucjs.CACHE_TAG}:${route}`];
-  if (handle !== void 0) tags.push(`${_chunk4ORXUW2Ucjs.CACHE_TAG}:${route}:${handle}`);
-  return tags.filter((tag) => tag.length <= _chunk4ORXUW2Ucjs.TAG_MAX_CHARS);
+  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 {
@@ -72,10 +72,15 @@ function serverInit(url, init, storefront, revalidate, extraTags) {
   return { ...rest, next: { revalidate, tags: [...tags, ...extraTags] } };
 }
 function createServerCatalogClient(options) {
-  const { next, ...rest } = options;
-  const revalidate = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _ => _.revalidate]), () => ( _chunk4ORXUW2Ucjs.DEFAULT_REVALIDATE_S));
+  const {
+    next,
+    // 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 extraTags = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _2 => _2.tags]), () => ( []));
-  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunk4ORXUW2Ucjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
+  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunk2YQNMBDIcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
   const base = rest.fetch;
   const serverFetch = (input, init = {}) => {
     const out = serverInit(
@@ -87,7 +92,7 @@ function createServerCatalogClient(options) {
     );
     return base !== void 0 ? base(input, out) : globalThis.fetch(input, out);
   };
-  return _chunk4ORXUW2Ucjs.createCatalogClient.call(void 0, {
+  return _chunk2YQNMBDIcjs.createCatalogClient.call(void 0, {
     ...rest,
     fetch: serverFetch
   });
@@ -107,16 +112,16 @@ async function syncCatalogGeneration(input) {
 
 // src/server/paging.ts
 function bounds(opts) {
-  const pageSize = _nullishCoalesce(opts.pageSize, () => ( _chunk4ORXUW2Ucjs.LIST_PAGE_SIZE));
-  const max = _nullishCoalesce(opts.max, () => ( _chunk4ORXUW2Ucjs.LIST_MAX_HANDLES));
-  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > _chunk4ORXUW2Ucjs.LIST_PAGE_SIZE)
+  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)
     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, _chunk4ORXUW2Ucjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -186,7 +191,7 @@ function listAllCollectionHandles(client, opts = {}) {
 }
 async function listAllCategoryHandles(client, opts = {}) {
   const { categories } = await client.categories.tree({
-    depth: _chunk4ORXUW2Ucjs.CATEGORY_TREE_MAX_DEPTH,
+    depth: _chunk2YQNMBDIcjs.CATEGORY_TREE_MAX_DEPTH,
     ...call(opts.signal)
   });
   const out = [];
@@ -208,4 +213,4 @@ async function listAllCategoryHandles(client, opts = {}) {
 
 
 
-exports.SDK_VERSION = _chunk4ORXUW2Ucjs.SDK_VERSION; exports.catalogTags = catalogTags; exports.createServerCatalogClient = createServerCatalogClient; exports.listAllCategoryHandles = listAllCategoryHandles; exports.listAllCollectionHandles = listAllCollectionHandles; exports.listAllProductHandles = listAllProductHandles; exports.staticProductParams = staticProductParams; exports.syncCatalogGeneration = syncCatalogGeneration;
+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;

package/dist/server.d.cts

@@ -1,9 +1,10 @@
+export { S as SDK_VERSION } from './version-ev3p03v2.cjs';
 import { CatalogClient } from './index.cjs';
-export { S as SDK_VERSION } from './client-BAoq6jmM.cjs';
 import { CatalogClientOptions, NextFetchOptions } from './index.cjs';
-import './contract-types-DhiThMEr.cjs';
+import '@usethrottle/money';
+import './contract-types-BRyonOYH.cjs';
 
-type ServerCatalogClientOptions = CatalogClientOptions & {
+type ServerCatalogClientOptions = Omit<CatalogClientOptions, 'keyInQuery'> & {
     /** `revalidate` defaults to 60 seconds; `tags` are appended to the route's own. */
     next?: NextFetchOptions;
 };

package/dist/server.d.ts

@@ -1,9 +1,10 @@
+export { S as SDK_VERSION } from './version-ev3p03v2.js';
 import { CatalogClient } from './index.js';
-export { S as SDK_VERSION } from './client-c2F-eCaL.js';
 import { CatalogClientOptions, NextFetchOptions } from './index.js';
-import './contract-types-DhiThMEr.js';
+import '@usethrottle/money';
+import './contract-types-BRyonOYH.js';
 
-type ServerCatalogClientOptions = CatalogClientOptions & {
+type ServerCatalogClientOptions = Omit<CatalogClientOptions, 'keyInQuery'> & {
     /** `revalidate` defaults to 60 seconds; `tags` are appended to the route's own. */
     next?: NextFetchOptions;
 };

package/dist/server.js

@@ -9,7 +9,7 @@ import {
   SDK_VERSION,
   TAG_MAX_CHARS,
   createCatalogClient
-} from "./chunk-JK2UY4CD.js";
+} from "./chunk-3DLH56OX.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/server/tags.ts
@@ -72,7 +72,12 @@ function serverInit(url, init, storefront, revalidate, extraTags) {
   return { ...rest, next: { revalidate, tags: [...tags, ...extraTags] } };
 }
 function createServerCatalogClient(options) {
-  const { next, ...rest } = options;
+  const {
+    next,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- dropped on purpose (P8-R21)
+    keyInQuery: _ignored,
+    ...rest
+  } = options;
   const revalidate = next?.revalidate ?? DEFAULT_REVALIDATE_S;
   const extraTags = next?.tags ?? [];
   const storefront = `${(rest.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/u, "")}/v1/storefront/`;

package/dist/{types-DsjoG8ce.d.cts → types-BfveENg1.d.ts}

@@ -1,4 +1,5 @@
-import { C as CartCheckAnswer, f as CartCreateRequest, e as CartCreateAnswer, a as StorefrontListAnswer, c as StorefrontProductAnswer, p as StorefrontRelatedAnswer, o as StorefrontFilterValuesAnswer, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, s as StorefrontTagsAnswer, m as StorefrontCollectionsAnswer, l as StorefrontCollectionAnswer, r as StorefrontSuggestAnswer, n as StorefrontConfigAnswer, q as StorefrontReviewsAnswer, R as ReviewEligibilityAnswer, i as ReviewSubmitInput, h as ReviewSubmitAnswer } from './contract-types-DhiThMEr.cjs';
+import { CurrencyCode } from '@usethrottle/money';
+import { C as CartCheckAnswer, h as CartCreateRequest, g as CartCreateAnswer, b as StorefrontListAnswer, e as StorefrontProductAnswer, p as StorefrontRelatedAnswer, o as StorefrontFilterValuesAnswer, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, s as StorefrontTagsAnswer, m as StorefrontCollectionsAnswer, l as StorefrontCollectionAnswer, r as StorefrontSuggestAnswer, n as StorefrontConfigAnswer, q as StorefrontReviewsAnswer, d as ReviewEligibilityAnswer, a as ReviewSubmitInput, R as ReviewSubmitAnswer } from './contract-types-BRyonOYH.js';
 
 type QueryPairs = [string, string][];
 
@@ -28,6 +29,13 @@ type CatalogClientOptions = {
         maxWaitSeconds: number;
     };
     headers?: Record<string, string>;
+    /**
+     * Send the publishable key as `?key=` on a GET instead of the
+     * `x-catalog-key` header, so a browser read needs no CORS preflight
+     * (P8-R21). Default `false`: the header is always sent. A POST always sends
+     * the header.
+     */
+    keyInQuery?: boolean;
 };
 /** Next.js's `fetch` cache options; the SDK never imports Next. */
 type NextFetchOptions = {
@@ -64,6 +72,13 @@ type RequestSpec = {
     /** `false` turns off the one indexing retry for this request (P6-R10). */
     indexingRetry?: boolean;
     ifNoneMatch?: string;
+    /**
+     * The answer is the same for every shopper (P8-R22): this implies
+     * `customerToken: 'none'` (no token is read or sent), the cache entry is
+     * the guest partition, and with `keyInQuery` on the request sends no
+     * `If-None-Match`, so its only header is `accept`.
+     */
+    tokenFree?: boolean;
     /**
      * Query context the transport appends to a GET: `'priced'` adds `currency`
      * and `locale`, `'locale'` adds `locale` only (call options over client
@@ -127,7 +142,7 @@ type ThrottleLine = {
 /** Throttle's cart as a cart session answers it; other keys pass through. */
 type ThrottleCart = {
     cartId: string;
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     total: number;
     unitCount: number;
@@ -184,6 +199,32 @@ type CartCheckout = {
 };
 /** Per-call options of a cart-session call. */
 type SessionCallOptions = Pick<CallOptions, 'signal' | 'timeoutMs'>;
+/**
+ * What an absorb reports besides the cart (MC2-R39): lines of the other cart
+ * that could not move (no price in this cart's currency, or a custom line in
+ * another currency), a discount code this cart's currency refuses, and lines
+ * whose prices are unconfirmed until the next refresh or checkout.
+ */
+type CartWarning = {
+    code: 'lines_removed';
+    lines: {
+        referenceId: string | null;
+        code: string;
+    }[];
+    message: string;
+} | {
+    code: 'discount_dropped';
+    discountCode: string;
+    message: string;
+} | {
+    code: 'lines_stale';
+    message: string;
+};
+/** `CartSession.absorb()`'s answer: this session's cart after the move. */
+type CartAbsorb = {
+    cart: ThrottleCart;
+    warnings: CartWarning[];
+};
 /** One Throttle cart session, addressed by its opaque id. */
 type CartSession = {
     readonly id: string;
@@ -198,6 +239,15 @@ type CartSession = {
     refresh(call?: SessionCallOptions): Promise<CartSessionSnapshot>;
     /** Refuses non-http(s) URLs before a request, and never returns a non-http(s) `checkoutUrl`. */
     checkout(input: CartCheckoutInput, call?: SessionCallOptions): Promise<CartCheckout>;
+    /**
+     * Moves the cart of session `fromSessionId` into this session's cart, in
+     * this cart's currency, and closes the other one (`abandoned`, reason
+     * `merged`; a merged cart refuses writes with `409 cart_not_open`).
+     * Throttle never creates a cart or changes a currency or an owner here: a
+     * customer's cart only moves into that customer's cart (`403
+     * cart_owner_mismatch`).
+     */
+    absorb(fromSessionId: string, call?: SessionCallOptions): Promise<CartAbsorb>;
 };
 type ProductsNamespace = {
     list(query?: ProductsQuery, call?: CallOptions): Promise<StorefrontListAnswer>;
@@ -272,5 +322,28 @@ type CatalogNamespaces = {
     readonly reviews: ReviewsNamespace;
     readonly carts: CartsNamespace;
 };
+/** The customer's open cart as Throttle answers it (P8-R14). */
+type OpenCartRef = {
+    sessionId: string;
+    cartId: string;
+    currency: CurrencyCode;
+};
+/**
+ * Where a signed-in customer's cart is found (P8-R14). Structural: the SDK
+ * never holds the Throttle `pk_` and never imports `@usethrottle/auth`.
+ * `getOpenCart` answers the customer's most recently updated open cart in
+ * `currency`, or `null`; `whenClaimSettled` resolves once the sign-in's
+ * guest-cart claim is done, so the merged lines can be read.
+ * Resuming needs a currency: the hook's `currency` option or the client's;
+ * without one `useCart` makes no lookup. A write to a cart another device
+ * merged is refused (`409 cart_not_open`, never reopened), and `useCart`
+ * then looks the customer's cart up.
+ */
+type CustomerCartSource = {
+    getOpenCart(input: {
+        currency: string;
+    }): Promise<OpenCartRef | null>;
+    whenClaimSettled(): Promise<void>;
+};
 
-export type { CallOptions as C, FieldsOption as F, NextFetchOptions as N, ProductsNamespace as P, Redirect as R, SessionCallOptions as S, TagsNamespace as T, CartCheckout as a, CartCheckoutInput as b, CartSession as c, CartSessionBranding as d, CartSessionDetail as e, CartSessionSnapshot as f, CartsNamespace as g, CatalogClientOptions as h, CatalogHttpCache as i, CatalogHttpCacheEntry as j, CatalogNamespaces as k, CategoriesNamespace as l, CategoryTreeDepth as m, CollectionsNamespace as n, CustomerTokenSource as o, FiltersNamespace as p, ProductsQuery as q, ReviewsNamespace as r, StorefrontSort as s, ThrottleCart as t, ThrottleLine as u, RequestSpec as v };
+export type { CustomerCartSource as C, FieldsOption as F, NextFetchOptions as N, OpenCartRef as O, ProductsQuery as P, Redirect as R, SessionCallOptions as S, ThrottleCart as T, CategoryTreeDepth as a, CartWarning as b, CallOptions as c, CartAbsorb as d, CartCheckout as e, CartCheckoutInput as f, CartSession as g, CartSessionBranding as h, CartSessionDetail as i, CartSessionSnapshot as j, CartsNamespace as k, CatalogClientOptions as l, CatalogHttpCache as m, CatalogHttpCacheEntry as n, CatalogNamespaces as o, CategoriesNamespace as p, CollectionsNamespace as q, CustomerTokenSource as r, FiltersNamespace as s, ProductsNamespace as t, ReviewsNamespace as u, StorefrontSort as v, TagsNamespace as w, ThrottleLine as x, RequestSpec as y };

package/dist/{types-xQLID-4j.d.ts → types-D0PywKnN.d.cts}

@@ -1,4 +1,5 @@
-import { C as CartCheckAnswer, f as CartCreateRequest, e as CartCreateAnswer, a as StorefrontListAnswer, c as StorefrontProductAnswer, p as StorefrontRelatedAnswer, o as StorefrontFilterValuesAnswer, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, s as StorefrontTagsAnswer, m as StorefrontCollectionsAnswer, l as StorefrontCollectionAnswer, r as StorefrontSuggestAnswer, n as StorefrontConfigAnswer, q as StorefrontReviewsAnswer, R as ReviewEligibilityAnswer, i as ReviewSubmitInput, h as ReviewSubmitAnswer } from './contract-types-DhiThMEr.js';
+import { CurrencyCode } from '@usethrottle/money';
+import { C as CartCheckAnswer, h as CartCreateRequest, g as CartCreateAnswer, b as StorefrontListAnswer, e as StorefrontProductAnswer, p as StorefrontRelatedAnswer, o as StorefrontFilterValuesAnswer, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, s as StorefrontTagsAnswer, m as StorefrontCollectionsAnswer, l as StorefrontCollectionAnswer, r as StorefrontSuggestAnswer, n as StorefrontConfigAnswer, q as StorefrontReviewsAnswer, d as ReviewEligibilityAnswer, a as ReviewSubmitInput, R as ReviewSubmitAnswer } from './contract-types-BRyonOYH.cjs';
 
 type QueryPairs = [string, string][];
 
@@ -28,6 +29,13 @@ type CatalogClientOptions = {
         maxWaitSeconds: number;
     };
     headers?: Record<string, string>;
+    /**
+     * Send the publishable key as `?key=` on a GET instead of the
+     * `x-catalog-key` header, so a browser read needs no CORS preflight
+     * (P8-R21). Default `false`: the header is always sent. A POST always sends
+     * the header.
+     */
+    keyInQuery?: boolean;
 };
 /** Next.js's `fetch` cache options; the SDK never imports Next. */
 type NextFetchOptions = {
@@ -64,6 +72,13 @@ type RequestSpec = {
     /** `false` turns off the one indexing retry for this request (P6-R10). */
     indexingRetry?: boolean;
     ifNoneMatch?: string;
+    /**
+     * The answer is the same for every shopper (P8-R22): this implies
+     * `customerToken: 'none'` (no token is read or sent), the cache entry is
+     * the guest partition, and with `keyInQuery` on the request sends no
+     * `If-None-Match`, so its only header is `accept`.
+     */
+    tokenFree?: boolean;
     /**
      * Query context the transport appends to a GET: `'priced'` adds `currency`
      * and `locale`, `'locale'` adds `locale` only (call options over client
@@ -127,7 +142,7 @@ type ThrottleLine = {
 /** Throttle's cart as a cart session answers it; other keys pass through. */
 type ThrottleCart = {
     cartId: string;
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     total: number;
     unitCount: number;
@@ -184,6 +199,32 @@ type CartCheckout = {
 };
 /** Per-call options of a cart-session call. */
 type SessionCallOptions = Pick<CallOptions, 'signal' | 'timeoutMs'>;
+/**
+ * What an absorb reports besides the cart (MC2-R39): lines of the other cart
+ * that could not move (no price in this cart's currency, or a custom line in
+ * another currency), a discount code this cart's currency refuses, and lines
+ * whose prices are unconfirmed until the next refresh or checkout.
+ */
+type CartWarning = {
+    code: 'lines_removed';
+    lines: {
+        referenceId: string | null;
+        code: string;
+    }[];
+    message: string;
+} | {
+    code: 'discount_dropped';
+    discountCode: string;
+    message: string;
+} | {
+    code: 'lines_stale';
+    message: string;
+};
+/** `CartSession.absorb()`'s answer: this session's cart after the move. */
+type CartAbsorb = {
+    cart: ThrottleCart;
+    warnings: CartWarning[];
+};
 /** One Throttle cart session, addressed by its opaque id. */
 type CartSession = {
     readonly id: string;
@@ -198,6 +239,15 @@ type CartSession = {
     refresh(call?: SessionCallOptions): Promise<CartSessionSnapshot>;
     /** Refuses non-http(s) URLs before a request, and never returns a non-http(s) `checkoutUrl`. */
     checkout(input: CartCheckoutInput, call?: SessionCallOptions): Promise<CartCheckout>;
+    /**
+     * Moves the cart of session `fromSessionId` into this session's cart, in
+     * this cart's currency, and closes the other one (`abandoned`, reason
+     * `merged`; a merged cart refuses writes with `409 cart_not_open`).
+     * Throttle never creates a cart or changes a currency or an owner here: a
+     * customer's cart only moves into that customer's cart (`403
+     * cart_owner_mismatch`).
+     */
+    absorb(fromSessionId: string, call?: SessionCallOptions): Promise<CartAbsorb>;
 };
 type ProductsNamespace = {
     list(query?: ProductsQuery, call?: CallOptions): Promise<StorefrontListAnswer>;
@@ -272,5 +322,28 @@ type CatalogNamespaces = {
     readonly reviews: ReviewsNamespace;
     readonly carts: CartsNamespace;
 };
+/** The customer's open cart as Throttle answers it (P8-R14). */
+type OpenCartRef = {
+    sessionId: string;
+    cartId: string;
+    currency: CurrencyCode;
+};
+/**
+ * Where a signed-in customer's cart is found (P8-R14). Structural: the SDK
+ * never holds the Throttle `pk_` and never imports `@usethrottle/auth`.
+ * `getOpenCart` answers the customer's most recently updated open cart in
+ * `currency`, or `null`; `whenClaimSettled` resolves once the sign-in's
+ * guest-cart claim is done, so the merged lines can be read.
+ * Resuming needs a currency: the hook's `currency` option or the client's;
+ * without one `useCart` makes no lookup. A write to a cart another device
+ * merged is refused (`409 cart_not_open`, never reopened), and `useCart`
+ * then looks the customer's cart up.
+ */
+type CustomerCartSource = {
+    getOpenCart(input: {
+        currency: string;
+    }): Promise<OpenCartRef | null>;
+    whenClaimSettled(): Promise<void>;
+};
 
-export type { CallOptions as C, FieldsOption as F, NextFetchOptions as N, ProductsNamespace as P, Redirect as R, SessionCallOptions as S, TagsNamespace as T, CartCheckout as a, CartCheckoutInput as b, CartSession as c, CartSessionBranding as d, CartSessionDetail as e, CartSessionSnapshot as f, CartsNamespace as g, CatalogClientOptions as h, CatalogHttpCache as i, CatalogHttpCacheEntry as j, CatalogNamespaces as k, CategoriesNamespace as l, CategoryTreeDepth as m, CollectionsNamespace as n, CustomerTokenSource as o, FiltersNamespace as p, ProductsQuery as q, ReviewsNamespace as r, StorefrontSort as s, ThrottleCart as t, ThrottleLine as u, RequestSpec as v };
+export type { CustomerCartSource as C, FieldsOption as F, NextFetchOptions as N, OpenCartRef as O, ProductsQuery as P, Redirect as R, SessionCallOptions as S, ThrottleCart as T, CategoryTreeDepth as a, CartWarning as b, CallOptions as c, CartAbsorb as d, CartCheckout as e, CartCheckoutInput as f, CartSession as g, CartSessionBranding as h, CartSessionDetail as i, CartSessionSnapshot as j, CartsNamespace as k, CatalogClientOptions as l, CatalogHttpCache as m, CatalogHttpCacheEntry as n, CatalogNamespaces as o, CategoriesNamespace as p, CollectionsNamespace as q, CustomerTokenSource as r, FiltersNamespace as s, ProductsNamespace as t, ReviewsNamespace as u, StorefrontSort as v, TagsNamespace as w, ThrottleLine as x, RequestSpec as y };

package/dist/url.d.cts

@@ -1,5 +1,6 @@
 import { ProductsQuery } from './index.cjs';
-import './contract-types-DhiThMEr.cjs';
+import '@usethrottle/money';
+import './contract-types-BRyonOYH.cjs';
 
 /** The shop page's selection as URL state (P6-R16). */
 type ShopQuery = {

package/dist/url.d.ts

@@ -1,5 +1,6 @@
 import { ProductsQuery } from './index.js';
-import './contract-types-DhiThMEr.js';
+import '@usethrottle/money';
+import './contract-types-BRyonOYH.js';
 
 /** The shop page's selection as URL state (P6-R16). */
 type ShopQuery = {

package/dist/use-query-CR7r5tam.d.ts

@@ -0,0 +1,40 @@
+import { b as CatalogError } from './catalog-error-CSoPS0-d.js';
+
+type QueryResult<T> = {
+    data: T | undefined;
+    error: CatalogError | undefined;
+    /** No data and no error yet, and the hook is enabled. */
+    isLoading: boolean;
+    /** A request for this key is in flight (first load or revalidation). */
+    isValidating: boolean;
+    /** The params object `data` answers (the one the key was built from); the params asked for while `data` is undefined. */
+    dataFor: unknown;
+    /** `data` is the last answer of an earlier key, shown while this one loads (`keepPreviousData`). */
+    isPreviousData: boolean;
+    /** `data` was not confirmed by the latest attempt: a revalidation failed, or a seed is still being revalidated. */
+    isStale: boolean;
+    /** Fetches again now (unless a rate-limit pause holds every read). Never rejects. */
+    refetch(): Promise<void>;
+};
+type QueryOptions<T> = {
+    /** `false` makes no request; `data` stays `undefined`. */
+    enabled?: boolean;
+    /**
+     * Shown at once (SSR hand-off). Treated as fetched at mount when the
+     * provider has no `customerKey`; under a signed-in customer it is
+     * revalidated at once, since a server render is usually anonymous (P6-R51).
+     */
+    initialData?: T;
+    /** Cached data younger than this is not fetched again; default `STALE_MS`. */
+    staleTimeMs?: number;
+    /** Shows the last settled answer while another key loads or fails; never across a `customerKey` change. */
+    keepPreviousData?: boolean;
+};
+/**
+ * The cache key of a read: the route name and its canonical parameters.
+ * Hooks prefix it with the provider's `customerKey` (P6-R14).
+ */
+declare function catalogQueryKey(route: string, params: unknown): string;
+
+export { catalogQueryKey as c };
+export type { QueryOptions as Q, QueryResult as a };

package/dist/use-query-UWf6Pi5g.d.cts

@@ -0,0 +1,40 @@
+import { b as CatalogError } from './catalog-error-BOaSKgY3.cjs';
+
+type QueryResult<T> = {
+    data: T | undefined;
+    error: CatalogError | undefined;
+    /** No data and no error yet, and the hook is enabled. */
+    isLoading: boolean;
+    /** A request for this key is in flight (first load or revalidation). */
+    isValidating: boolean;
+    /** The params object `data` answers (the one the key was built from); the params asked for while `data` is undefined. */
+    dataFor: unknown;
+    /** `data` is the last answer of an earlier key, shown while this one loads (`keepPreviousData`). */
+    isPreviousData: boolean;
+    /** `data` was not confirmed by the latest attempt: a revalidation failed, or a seed is still being revalidated. */
+    isStale: boolean;
+    /** Fetches again now (unless a rate-limit pause holds every read). Never rejects. */
+    refetch(): Promise<void>;
+};
+type QueryOptions<T> = {
+    /** `false` makes no request; `data` stays `undefined`. */
+    enabled?: boolean;
+    /**
+     * Shown at once (SSR hand-off). Treated as fetched at mount when the
+     * provider has no `customerKey`; under a signed-in customer it is
+     * revalidated at once, since a server render is usually anonymous (P6-R51).
+     */
+    initialData?: T;
+    /** Cached data younger than this is not fetched again; default `STALE_MS`. */
+    staleTimeMs?: number;
+    /** Shows the last settled answer while another key loads or fails; never across a `customerKey` change. */
+    keepPreviousData?: boolean;
+};
+/**
+ * The cache key of a read: the route name and its canonical parameters.
+ * Hooks prefix it with the provider's `customerKey` (P6-R14).
+ */
+declare function catalogQueryKey(route: string, params: unknown): string;
+
+export { catalogQueryKey as c };
+export type { QueryOptions as Q, QueryResult as a };

package/dist/version-ev3p03v2.d.cts

@@ -0,0 +1,8 @@
+/**
+ * The package version, baked in at build time (tsup `define`). Under the
+ * package's vitest it is `'0.0.0-test'`; elsewhere (root vitest, `tsc`) the
+ * global is absent and it reads `'0.0.0-dev'`. No JSON import ships.
+ */
+declare const SDK_VERSION: string;
+
+export { SDK_VERSION as S };

package/dist/version-ev3p03v2.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The package version, baked in at build time (tsup `define`). Under the
+ * package's vitest it is `'0.0.0-test'`; elsewhere (root vitest, `tsc`) the
+ * global is absent and it reads `'0.0.0-dev'`. No JSON import ships.
+ */
+declare const SDK_VERSION: string;
+
+export { SDK_VERSION as S };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/catalog",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Storefront SDK for the Throttle Product Catalog: a typed client, React hooks, server helpers and URL helpers.",
   "license": "MIT",
   "repository": {
@@ -36,6 +36,16 @@
         "default": "./dist/react.cjs"
       }
     },
+    "./react/extras": {
+      "import": {
+        "types": "./dist/react-extras.d.ts",
+        "default": "./dist/react-extras.js"
+      },
+      "require": {
+        "types": "./dist/react-extras.d.cts",
+        "default": "./dist/react-extras.cjs"
+      }
+    },
     "./server": {
       "import": {
         "types": "./dist/server.d.ts",
@@ -78,7 +88,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@usethrottle/errors": "^1.1.0"
+    "@usethrottle/errors": "^1.1.0",
+    "@usethrottle/money": "^1.0.0"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0"