@usethrottle/catalog 1.2.0 → 1.4.0

package/dist/server.js

@@ -1,96 +1,84 @@
 import {
-  CACHE_TAG,
+  DEFAULT_CACHE_POLICY,
+  cacheKindForPath,
+  catalogTags,
+  observeGeneration,
+  pendingMinGeneration,
+  policyToNext,
+  scopesToTags,
+  storefrontRoute,
+  tagsForUrl
+} from "./chunk-SN6STYPW.js";
+import {
   CATEGORY_TREE_MAX_DEPTH,
   CatalogError,
   DEFAULT_BASE_URL,
-  DEFAULT_REVALIDATE_S,
   LIST_MAX_HANDLES,
   LIST_PAGE_SIZE,
   SDK_VERSION,
-  TAG_MAX_CHARS,
   createCatalogClient
-} from "./chunk-55G4ZTD5.js";
+} from "./chunk-VJHA7J7B.js";
 import "./chunk-PKBMQBKP.js";
 
-// src/server/tags.ts
-function catalogTags(route, handle) {
-  const tags = [CACHE_TAG, `${CACHE_TAG}:${route}`];
-  if (handle !== void 0) tags.push(`${CACHE_TAG}:${route}:${handle}`);
-  return tags.filter((tag) => tag.length <= TAG_MAX_CHARS);
-}
-function decode(segment) {
-  try {
-    return decodeURIComponent(segment);
-  } catch {
-    return segment;
-  }
-}
-function tagsForUrl(url, storefront) {
-  const path = 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;
-  }
-}
-
 // 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;
   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 = cacheKindForPath(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 = next?.revalidate ?? DEFAULT_REVALIDATE_S;
+  const named = /* @__PURE__ */ new Map();
+  for (const [kind, policy] of Object.entries(cachePolicy ?? {}))
+    if (policy !== void 0)
+      named.set(kind, policyToNext(policy));
+  const policies = (kind) => named.get(kind) ?? (next?.revalidate === void 0 ? policyToNext(DEFAULT_CACHE_POLICY[kind]) : { revalidate: next.revalidate });
+  const floorKey = namedFloorKey ?? rest.publishableKey;
   const extraTags = next?.tags ?? [];
   const storefront = `${(rest.baseUrl ?? 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) && storefrontRoute(target.slice(storefront.length))?.route === "config";
+    const floor = isConfig ? pendingMinGeneration(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 {
+          observeGeneration(
+            (await response.clone().json()).generation,
+            floorKey
+          );
+        } catch {
+        }
+      return response;
+    });
   };
   return createCatalogClient({
     ...rest,
@@ -205,12 +193,16 @@ async function listAllCategoryHandles(client, opts = {}) {
   return out;
 }
 export {
+  DEFAULT_CACHE_POLICY,
   SDK_VERSION,
+  cacheKindForPath,
   catalogTags,
   createServerCatalogClient,
   listAllCategoryHandles,
   listAllCollectionHandles,
   listAllProductHandles,
+  policyToNext,
+  scopesToTags,
   staticProductParams,
   syncCatalogGeneration
 };

package/dist/{types-BlYCKzB8.d.ts → types-jNpOwEUw.d.cts}

@@ -1,4 +1,5 @@
-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-BPSzY_Co.js';
+import { CurrencyCode } from '@usethrottle/money';
+import { C as CartCheckAnswer, j as CartCreateRequest, i as CartCreateAnswer, d as StorefrontListAnswer, g as StorefrontProductAnswer, u as StorefrontRelatedAnswer, r as StorefrontFilterValuesAnswer, l as StorefrontCategoriesAnswer, m as StorefrontCategoryAnswer, x as StorefrontTagsAnswer, o as StorefrontCollectionsAnswer, n as StorefrontCollectionAnswer, w as StorefrontSuggestAnswer, p as StorefrontConfigAnswer, S as StorefrontSettings, t as StorefrontPagesAnswer, s as StorefrontPageAnswer, v as StorefrontReviewsAnswer, f as ReviewEligibilityAnswer, a as ReviewSubmitInput, R as ReviewSubmitAnswer } from './contract-types-D2-SSPM9.cjs';
 
 type QueryPairs = [string, string][];
 
@@ -35,6 +36,13 @@ type CatalogClientOptions = {
      * the header.
      */
     keyInQuery?: boolean;
+    /**
+     * A preview token (from the dashboard's preview link). Settings and pages
+     * reads then send it as `X-Storefront-Preview` and answer the draft: they
+     * are never cached, here or in the `cache` store. A token that does not
+     * verify is a `401` `PREVIEW_EXPIRED`. Other routes never carry it.
+     */
+    previewToken?: string;
 };
 /** Next.js's `fetch` cache options; the SDK never imports Next. */
 type NextFetchOptions = {
@@ -56,6 +64,14 @@ type CallOptions = {
      */
     next?: NextFetchOptions;
 };
+/** Options of the reads that answer settings (`config`, `settings`, `pages`). */
+type SettingsCallOptions = CallOptions & {
+    /**
+     * The storefront generation the caller knows exists (a change notice names
+     * it). Above the one the edge holds, the answer is read fresh.
+     */
+    minGeneration?: number;
+};
 type RequestSpec = {
     method: 'GET' | 'POST';
     /** Already encoded, starting with `/`. */
@@ -84,6 +100,8 @@ type RequestSpec = {
      * options). A POST takes them in its body, from `context()`.
      */
     context?: 'priced' | 'locale';
+    /** The route answers a draft to a preview token, so the client sends one. */
+    preview?: boolean;
 };
 
 /** A list sort the catalog knows. */
@@ -141,7 +159,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;
@@ -198,6 +216,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;
@@ -212,6 +256,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>;
@@ -273,6 +326,24 @@ type CartsNamespace = {
         throttleBaseUrl?: string;
     }): CartSession;
 };
+/** `settings()`: the storefront settings and what versions them. */
+type StorefrontSettingsResult = {
+    settings: StorefrontSettings;
+    settingsVersion: number;
+    generation: number;
+};
+/**
+ * `client.settings()`. The document may later be assembled from more than one
+ * extension (site design and catalog display); callers always read it through
+ * here, so its source can move without a change in the store.
+ */
+type SettingsNamespace = (call?: SettingsCallOptions) => Promise<StorefrontSettingsResult>;
+type PagesNamespace = {
+    /** The published pages, in the store's order. */
+    list(call?: SettingsCallOptions): Promise<StorefrontPagesAnswer>;
+    /** One page; an unknown handle is a `404` `PAGE_NOT_FOUND`. */
+    get(handle: string, call?: SettingsCallOptions): Promise<StorefrontPageAnswer>;
+};
 type CatalogNamespaces = {
     readonly products: ProductsNamespace;
     readonly filters: FiltersNamespace;
@@ -282,7 +353,9 @@ type CatalogNamespaces = {
     readonly suggest: (q: string, opts?: {
         limit?: number;
     } & CallOptions) => Promise<StorefrontSuggestAnswer>;
-    readonly config: (call?: CallOptions) => Promise<StorefrontConfigAnswer>;
+    readonly config: (call?: SettingsCallOptions) => Promise<StorefrontConfigAnswer>;
+    readonly settings: SettingsNamespace;
+    readonly pages: PagesNamespace;
     readonly reviews: ReviewsNamespace;
     readonly carts: CartsNamespace;
 };
@@ -290,7 +363,7 @@ type CatalogNamespaces = {
 type OpenCartRef = {
     sessionId: string;
     cartId: string;
-    currency: string;
+    currency: CurrencyCode;
 };
 /**
  * Where a signed-in customer's cart is found (P8-R14). Structural: the SDK
@@ -299,9 +372,9 @@ type OpenCartRef = {
  * `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. Known limit: a write within 30 s of
- * a read that predates another device's merge, or after a re-read that
- * failed, reopens the emptied cart.
+ * 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: {
@@ -310,4 +383,4 @@ type CustomerCartSource = {
     whenClaimSettled(): Promise<void>;
 };
 
-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, CallOptions as b, CartCheckout as c, CartCheckoutInput as d, CartSession as e, CartSessionBranding as f, CartSessionDetail as g, CartSessionSnapshot as h, CartsNamespace as i, CatalogClientOptions as j, CatalogHttpCache as k, CatalogHttpCacheEntry as l, CatalogNamespaces as m, CategoriesNamespace as n, CollectionsNamespace as o, CustomerTokenSource as p, FiltersNamespace as q, ProductsNamespace as r, ReviewsNamespace as s, StorefrontSort as t, TagsNamespace as u, ThrottleLine as v, RequestSpec as w };
+export type { TagsNamespace as A, ThrottleLine as B, CustomerCartSource as C, RequestSpec as D, 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, PagesNamespace as t, ProductsNamespace as u, ReviewsNamespace as v, SettingsCallOptions as w, SettingsNamespace as x, StorefrontSettingsResult as y, StorefrontSort as z };

package/dist/{types-BTrqSprj.d.cts → types-z57bkjjB.d.ts}

@@ -1,4 +1,5 @@
-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-BPSzY_Co.cjs';
+import { CurrencyCode } from '@usethrottle/money';
+import { C as CartCheckAnswer, j as CartCreateRequest, i as CartCreateAnswer, d as StorefrontListAnswer, g as StorefrontProductAnswer, u as StorefrontRelatedAnswer, r as StorefrontFilterValuesAnswer, l as StorefrontCategoriesAnswer, m as StorefrontCategoryAnswer, x as StorefrontTagsAnswer, o as StorefrontCollectionsAnswer, n as StorefrontCollectionAnswer, w as StorefrontSuggestAnswer, p as StorefrontConfigAnswer, S as StorefrontSettings, t as StorefrontPagesAnswer, s as StorefrontPageAnswer, v as StorefrontReviewsAnswer, f as ReviewEligibilityAnswer, a as ReviewSubmitInput, R as ReviewSubmitAnswer } from './contract-types-D2-SSPM9.js';
 
 type QueryPairs = [string, string][];
 
@@ -35,6 +36,13 @@ type CatalogClientOptions = {
      * the header.
      */
     keyInQuery?: boolean;
+    /**
+     * A preview token (from the dashboard's preview link). Settings and pages
+     * reads then send it as `X-Storefront-Preview` and answer the draft: they
+     * are never cached, here or in the `cache` store. A token that does not
+     * verify is a `401` `PREVIEW_EXPIRED`. Other routes never carry it.
+     */
+    previewToken?: string;
 };
 /** Next.js's `fetch` cache options; the SDK never imports Next. */
 type NextFetchOptions = {
@@ -56,6 +64,14 @@ type CallOptions = {
      */
     next?: NextFetchOptions;
 };
+/** Options of the reads that answer settings (`config`, `settings`, `pages`). */
+type SettingsCallOptions = CallOptions & {
+    /**
+     * The storefront generation the caller knows exists (a change notice names
+     * it). Above the one the edge holds, the answer is read fresh.
+     */
+    minGeneration?: number;
+};
 type RequestSpec = {
     method: 'GET' | 'POST';
     /** Already encoded, starting with `/`. */
@@ -84,6 +100,8 @@ type RequestSpec = {
      * options). A POST takes them in its body, from `context()`.
      */
     context?: 'priced' | 'locale';
+    /** The route answers a draft to a preview token, so the client sends one. */
+    preview?: boolean;
 };
 
 /** A list sort the catalog knows. */
@@ -141,7 +159,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;
@@ -198,6 +216,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;
@@ -212,6 +256,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>;
@@ -273,6 +326,24 @@ type CartsNamespace = {
         throttleBaseUrl?: string;
     }): CartSession;
 };
+/** `settings()`: the storefront settings and what versions them. */
+type StorefrontSettingsResult = {
+    settings: StorefrontSettings;
+    settingsVersion: number;
+    generation: number;
+};
+/**
+ * `client.settings()`. The document may later be assembled from more than one
+ * extension (site design and catalog display); callers always read it through
+ * here, so its source can move without a change in the store.
+ */
+type SettingsNamespace = (call?: SettingsCallOptions) => Promise<StorefrontSettingsResult>;
+type PagesNamespace = {
+    /** The published pages, in the store's order. */
+    list(call?: SettingsCallOptions): Promise<StorefrontPagesAnswer>;
+    /** One page; an unknown handle is a `404` `PAGE_NOT_FOUND`. */
+    get(handle: string, call?: SettingsCallOptions): Promise<StorefrontPageAnswer>;
+};
 type CatalogNamespaces = {
     readonly products: ProductsNamespace;
     readonly filters: FiltersNamespace;
@@ -282,7 +353,9 @@ type CatalogNamespaces = {
     readonly suggest: (q: string, opts?: {
         limit?: number;
     } & CallOptions) => Promise<StorefrontSuggestAnswer>;
-    readonly config: (call?: CallOptions) => Promise<StorefrontConfigAnswer>;
+    readonly config: (call?: SettingsCallOptions) => Promise<StorefrontConfigAnswer>;
+    readonly settings: SettingsNamespace;
+    readonly pages: PagesNamespace;
     readonly reviews: ReviewsNamespace;
     readonly carts: CartsNamespace;
 };
@@ -290,7 +363,7 @@ type CatalogNamespaces = {
 type OpenCartRef = {
     sessionId: string;
     cartId: string;
-    currency: string;
+    currency: CurrencyCode;
 };
 /**
  * Where a signed-in customer's cart is found (P8-R14). Structural: the SDK
@@ -299,9 +372,9 @@ type OpenCartRef = {
  * `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. Known limit: a write within 30 s of
- * a read that predates another device's merge, or after a re-read that
- * failed, reopens the emptied cart.
+ * 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: {
@@ -310,4 +383,4 @@ type CustomerCartSource = {
     whenClaimSettled(): Promise<void>;
 };
 
-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, CallOptions as b, CartCheckout as c, CartCheckoutInput as d, CartSession as e, CartSessionBranding as f, CartSessionDetail as g, CartSessionSnapshot as h, CartsNamespace as i, CatalogClientOptions as j, CatalogHttpCache as k, CatalogHttpCacheEntry as l, CatalogNamespaces as m, CategoriesNamespace as n, CollectionsNamespace as o, CustomerTokenSource as p, FiltersNamespace as q, ProductsNamespace as r, ReviewsNamespace as s, StorefrontSort as t, TagsNamespace as u, ThrottleLine as v, RequestSpec as w };
+export type { TagsNamespace as A, ThrottleLine as B, CustomerCartSource as C, RequestSpec as D, 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, PagesNamespace as t, ProductsNamespace as u, ReviewsNamespace as v, SettingsCallOptions as w, SettingsNamespace as x, StorefrontSettingsResult as y, StorefrontSort as z };

package/dist/url.d.cts

@@ -1,5 +1,6 @@
 import { ProductsQuery } from './index.cjs';
-import './contract-types-BPSzY_Co.cjs';
+import '@usethrottle/money';
+import './contract-types-D2-SSPM9.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-BPSzY_Co.js';
+import '@usethrottle/money';
+import './contract-types-D2-SSPM9.js';
 
 /** The shop page's selection as URL state (P6-R16). */
 type ShopQuery = {

package/dist/{use-query-QOEBuYlp.d.ts → use-query-COqRZJnC.d.ts}

@@ -1,4 +1,4 @@
-import { b as CatalogError } from './catalog-error-7DCsTyB2.js';
+import { b as CatalogError } from './catalog-error-BnabMMEy.js';
 
 type QueryResult<T> = {
     data: T | undefined;

package/dist/{use-query-BZgjxGPO.d.cts → use-query-H1xgL3_e.d.cts}

@@ -1,4 +1,4 @@
-import { b as CatalogError } from './catalog-error-yTBMAdCv.cjs';
+import { b as CatalogError } from './catalog-error-BKN5hNWP.cjs';
 
 type QueryResult<T> = {
     data: T | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/catalog",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Storefront SDK for the Throttle Product Catalog: a typed client, React hooks, server helpers and URL helpers.",
   "license": "MIT",
   "repository": {
@@ -56,6 +56,16 @@
         "default": "./dist/server.cjs"
       }
     },
+    "./next": {
+      "import": {
+        "types": "./dist/next.d.ts",
+        "default": "./dist/next.js"
+      },
+      "require": {
+        "types": "./dist/next.d.cts",
+        "default": "./dist/next.cjs"
+      }
+    },
     "./url": {
       "import": {
         "types": "./dist/url.d.ts",
@@ -88,12 +98,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@usethrottle/errors": "^1.1.0"
+    "@usethrottle/errors": "^1.1.0",
+    "@usethrottle/money": "^1.0.0"
   },
   "peerDependencies": {
+    "next": ">=14",
     "react": "^18.2.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
     "react": {
       "optional": true
     }