@usethrottle/catalog 0.1.1 → 1.1.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
-import { S as StorefrontCategoryNode, a as StorefrontListAnswer, b as StorefrontListProduct, c as StorefrontProductAnswer } from './types-DYfIvIaI.cjs';
-export { C as CallOptions, d as CartCheckAnswer, e as CartCheckRequest, f as CartCheckout, g as CartCheckoutInput, h as CartCreateAnswer, i as CartCreateRequest, j as CartSession, k as CartSessionBranding, l as CartSessionDetail, m as CartSessionSnapshot, n as CartsNamespace, o as CatalogClientOptions, p as CatalogContractErrorCode, q as CatalogHttpCache, r as CatalogHttpCacheEntry, s as CatalogNamespaces, t as CategoriesNamespace, u as CollectionsNamespace, v as CustomerTokenSource, F as FieldsOption, w as FiltersNamespace, N as NextFetchOptions, P as ProductsNamespace, x as ProductsQuery, R as Redirect, y as ReviewEligibilityAnswer, z as ReviewSubmitAnswer, A as ReviewSubmitInput, B as ReviewsNamespace, D as SessionCallOptions, E as StorefrontCategoriesAnswer, G as StorefrontCategoryAnswer, H as StorefrontCollectionAnswer, I as StorefrontCollectionsAnswer, J as StorefrontConfigAnswer, K as StorefrontFilterValuesAnswer, L as StorefrontRelatedAnswer, M as StorefrontReviewsAnswer, O as StorefrontSort, Q as StorefrontSuggestAnswer, T as StorefrontTagsAnswer, U as TagsNamespace, V as ThrottleCart, W as ThrottleLine } from './types-DYfIvIaI.cjs';
-export { C as CatalogClient, S as SDK_VERSION, c as createCatalogClient } from './client-BNtBTEyh.cjs';
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as ThrottleCartCode, i as TimeoutError, j as isCatalogError } from './catalog-error-DO6ANrGR.cjs';
+import { S as StorefrontCategoryNode, a as StorefrontListAnswer, b as StorefrontListProduct, c as StorefrontProductAnswer } from './contract-types-DhiThMEr.cjs';
+export { C as CartCheckAnswer, d as CartCheckRequest, e as CartCreateAnswer, f as CartCreateRequest, g as CatalogContractErrorCode, R as ReviewEligibilityAnswer, h as ReviewSubmitAnswer, i as ReviewSubmitInput, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, l as StorefrontCollectionAnswer, m as StorefrontCollectionsAnswer, n as StorefrontConfigAnswer, o as StorefrontFilterValuesAnswer, p as StorefrontRelatedAnswer, q as StorefrontReviewsAnswer, r as StorefrontSuggestAnswer, s as StorefrontTagsAnswer } from './contract-types-DhiThMEr.cjs';
+export { C as CatalogClient, S as SDK_VERSION, c as createCatalogClient } from './client-BAoq6jmM.cjs';
+export { C as CallOptions, a as CartCheckout, b as CartCheckoutInput, c as CartSession, d as CartSessionBranding, e as CartSessionDetail, f as CartSessionSnapshot, g as CartsNamespace, h as CatalogClientOptions, i as CatalogHttpCache, j as CatalogHttpCacheEntry, k as CatalogNamespaces, l as CategoriesNamespace, m as CategoryTreeDepth, n as CollectionsNamespace, o as CustomerTokenSource, F as FieldsOption, p as FiltersNamespace, N as NextFetchOptions, P as ProductsNamespace, q as ProductsQuery, R as Redirect, r as ReviewsNamespace, S as SessionCallOptions, s as StorefrontSort, T as TagsNamespace, t as ThrottleCart, u as ThrottleLine } from './types-DsjoG8ce.cjs';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, j as ThrottleCartCode, T as TimeoutError, i as isCatalogError } from './catalog-error-s1BINNkt.cjs';
 
 /** A product as `products.get` answers it (the full projection). */
 type StorefrontProduct = StorefrontProductAnswer['product'];

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { S as StorefrontCategoryNode, a as StorefrontListAnswer, b as StorefrontListProduct, c as StorefrontProductAnswer } from './types-DYfIvIaI.js';
-export { C as CallOptions, d as CartCheckAnswer, e as CartCheckRequest, f as CartCheckout, g as CartCheckoutInput, h as CartCreateAnswer, i as CartCreateRequest, j as CartSession, k as CartSessionBranding, l as CartSessionDetail, m as CartSessionSnapshot, n as CartsNamespace, o as CatalogClientOptions, p as CatalogContractErrorCode, q as CatalogHttpCache, r as CatalogHttpCacheEntry, s as CatalogNamespaces, t as CategoriesNamespace, u as CollectionsNamespace, v as CustomerTokenSource, F as FieldsOption, w as FiltersNamespace, N as NextFetchOptions, P as ProductsNamespace, x as ProductsQuery, R as Redirect, y as ReviewEligibilityAnswer, z as ReviewSubmitAnswer, A as ReviewSubmitInput, B as ReviewsNamespace, D as SessionCallOptions, E as StorefrontCategoriesAnswer, G as StorefrontCategoryAnswer, H as StorefrontCollectionAnswer, I as StorefrontCollectionsAnswer, J as StorefrontConfigAnswer, K as StorefrontFilterValuesAnswer, L as StorefrontRelatedAnswer, M as StorefrontReviewsAnswer, O as StorefrontSort, Q as StorefrontSuggestAnswer, T as StorefrontTagsAnswer, U as TagsNamespace, V as ThrottleCart, W as ThrottleLine } from './types-DYfIvIaI.js';
-export { C as CatalogClient, S as SDK_VERSION, c as createCatalogClient } from './client-CHLvULRQ.js';
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as ThrottleCartCode, i as TimeoutError, j as isCatalogError } from './catalog-error-BWUoZCzY.js';
+import { S as StorefrontCategoryNode, a as StorefrontListAnswer, b as StorefrontListProduct, c as StorefrontProductAnswer } from './contract-types-DhiThMEr.js';
+export { C as CartCheckAnswer, d as CartCheckRequest, e as CartCreateAnswer, f as CartCreateRequest, g as CatalogContractErrorCode, R as ReviewEligibilityAnswer, h as ReviewSubmitAnswer, i as ReviewSubmitInput, j as StorefrontCategoriesAnswer, k as StorefrontCategoryAnswer, l as StorefrontCollectionAnswer, m as StorefrontCollectionsAnswer, n as StorefrontConfigAnswer, o as StorefrontFilterValuesAnswer, p as StorefrontRelatedAnswer, q as StorefrontReviewsAnswer, r as StorefrontSuggestAnswer, s as StorefrontTagsAnswer } from './contract-types-DhiThMEr.js';
+export { C as CatalogClient, S as SDK_VERSION, c as createCatalogClient } from './client-c2F-eCaL.js';
+export { C as CallOptions, a as CartCheckout, b as CartCheckoutInput, c as CartSession, d as CartSessionBranding, e as CartSessionDetail, f as CartSessionSnapshot, g as CartsNamespace, h as CatalogClientOptions, i as CatalogHttpCache, j as CatalogHttpCacheEntry, k as CatalogNamespaces, l as CategoriesNamespace, m as CategoryTreeDepth, n as CollectionsNamespace, o as CustomerTokenSource, F as FieldsOption, p as FiltersNamespace, N as NextFetchOptions, P as ProductsNamespace, q as ProductsQuery, R as Redirect, r as ReviewsNamespace, S as SessionCallOptions, s as StorefrontSort, T as TagsNamespace, t as ThrottleCart, u as ThrottleLine } from './types-xQLID-4j.js';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, j as ThrottleCartCode, T as TimeoutError, i as isCatalogError } from './catalog-error-C_zLOtYA.js';
 
 /** A product as `products.get` answers it (the full projection). */
 type StorefrontProduct = StorefrontProductAnswer['product'];

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   TimeoutError,
   createCatalogClient,
   isCatalogError
-} from "./chunk-I3QRBPWD.js";
+} from "./chunk-JK2UY4CD.js";
 import "./chunk-PKBMQBKP.js";
 export {
   CartLineError,

package/dist/react.cjs

@@ -11,7 +11,7 @@
 
 
 
-var _chunkCR7ILYCTcjs = require('./chunk-CR7ILYCT.cjs');
+var _chunk4ORXUW2Ucjs = require('./chunk-4ORXUW2U.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/react/provider.tsx
@@ -38,7 +38,7 @@ function createStore(client, options = {}) {
   let until = 0;
   let cause;
   let pauseTimer;
-  const pausedError = () => new (0, _chunkCR7ILYCTcjs.RateLimitedError)({
+  const pausedError = () => new (0, _chunk4ORXUW2Ucjs.RateLimitedError)({
     code: _nullishCoalesce(_optionalChain([cause, 'optionalAccess', _ => _.code]), () => ( "RATE_LIMITED")),
     message: _nullishCoalesce(_optionalChain([cause, 'optionalAccess', _2 => _2.message]), () => ( "Too many requests.")),
     statusCode: 429,
@@ -59,7 +59,7 @@ function createStore(client, options = {}) {
         subs: /* @__PURE__ */ new Set()
       };
       for (const [oldKey, old] of entries) {
-        if (entries.size < _chunkCR7ILYCTcjs.CACHE_MAX_ENTRIES) break;
+        if (entries.size < _chunk4ORXUW2Ucjs.CACHE_MAX_ENTRIES) break;
         if (old.subs.size === 0 && old.flight === void 0) {
           clearTimeout(old.timer);
           entries.delete(oldKey);
@@ -78,7 +78,7 @@ function createStore(client, options = {}) {
       else entry.indexing = false;
     }, ms);
   };
-  function fetchKey(key, run, { force = false, staleMs = _chunkCR7ILYCTcjs.STALE_MS } = {}) {
+  function fetchKey(key, run, { force = false, staleMs = _chunk4ORXUW2Ucjs.STALE_MS } = {}) {
     const entry = touch(key);
     entry.run = run;
     if (entry.promise !== void 0 && !_optionalChain([entry, 'access', _4 => _4.flight, 'optionalAccess', _5 => _5.signal, 'access', _6 => _6.aborted]))
@@ -128,7 +128,7 @@ function createStore(client, options = {}) {
           return;
         }
         if (_optionalChain([result, 'access', _7 => _7.data, 'optionalAccess', _8 => _8.indexing]) === true) {
-          if (!entry.indexing) later(key, entry, _chunkCR7ILYCTcjs.INDEXING_REVALIDATE_MS);
+          if (!entry.indexing) later(key, entry, _chunk4ORXUW2Ucjs.INDEXING_REVALIDATE_MS);
         } else {
           entry.indexing = false;
         }
@@ -141,7 +141,7 @@ function createStore(client, options = {}) {
       },
       (error) => {
         if (!current()) return;
-        const retryMs = (_nullishCoalesce(error.retryAfterSeconds, () => ( _chunkCR7ILYCTcjs.RATE_LIMIT_DEFAULT_RETRY_S))) * 1e3;
+        const retryMs = (_nullishCoalesce(error.retryAfterSeconds, () => ( _chunk4ORXUW2Ucjs.RATE_LIMIT_DEFAULT_RETRY_S))) * 1e3;
         if (error.statusCode === 429 && error.code === "RATE_LIMITED")
           pause(now() + retryMs, error);
         else if (error.code === "STOREFRONT_INDEXING" && !entry.indexing)
@@ -389,9 +389,9 @@ function useDebounced(q, ms) {
   return _react.useSyncExternalStore.call(void 0, box.subscribe, box.get, box.get);
 }
 function useSuggest(q, options = {}) {
-  const settled = useDebounced(q, _nullishCoalesce(options.debounceMs, () => ( _chunkCR7ILYCTcjs.SUGGEST_DEBOUNCE_MS)));
+  const settled = useDebounced(q, _nullishCoalesce(options.debounceMs, () => ( _chunk4ORXUW2Ucjs.SUGGEST_DEBOUNCE_MS)));
   const extra = defined({ limit: options.limit });
-  const long = (value) => value.trim().length >= _chunkCR7ILYCTcjs.SUGGEST_MIN_CHARS;
+  const long = (value) => value.trim().length >= _chunk4ORXUW2Ucjs.SUGGEST_MIN_CHARS;
   return useQuery(
     "suggest",
     { q: settled, ...extra },
@@ -461,7 +461,7 @@ function newKey() {
   return out;
 }
 function refuse(message, path) {
-  return new (0, _chunkCR7ILYCTcjs.CatalogError)({
+  return new (0, _chunk4ORXUW2Ucjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -474,7 +474,7 @@ var UNSAFE = /[\x00-\x20\x7f]/u;
 function isHttpUrl(value) {
   return typeof value === "string" && /^https?:\/\/[^/?#\\]/iu.test(value) && !UNSAFE.test(value);
 }
-var wrap = (error) => _chunkCR7ILYCTcjs.isCatalogError.call(void 0, error) ? error : new (0, _chunkCR7ILYCTcjs.CatalogError)({
+var wrap = (error) => _chunk4ORXUW2Ucjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk4ORXUW2Ucjs.CatalogError)({
   code: "CLIENT_ERROR",
   message: "The action failed.",
   statusCode: 0,
@@ -485,7 +485,7 @@ var wrap = (error) => _chunkCR7ILYCTcjs.isCatalogError.call(void 0, error) ? err
 function checkPause(store) {
   const until = store.pausedUntil();
   if (until > 0) {
-    throw new (0, _chunkCR7ILYCTcjs.RateLimitedError)({
+    throw new (0, _chunk4ORXUW2Ucjs.RateLimitedError)({
       code: "RATE_LIMITED",
       message: "Too many requests.",
       statusCode: 429,
@@ -495,7 +495,7 @@ function checkPause(store) {
   }
 }
 function notePause(store, error) {
-  if (error instanceof _chunkCR7ILYCTcjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
+  if (error instanceof _chunk4ORXUW2Ucjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
     store.pause(Date.now() + error.retryAfterSeconds * 1e3, error);
 }
 function createBox(initial) {
@@ -529,7 +529,7 @@ var ENDED = /* @__PURE__ */ new Set([
   "cart_not_open",
   "cart_not_found"
 ]);
-var ended = (error) => _chunkCR7ILYCTcjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
+var ended = (error) => _chunk4ORXUW2Ucjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
 var converted = (error) => _optionalChain([error, 'access', _23 => _23.details, 'optionalAccess', _24 => _24.reason]) === "converted";
 function itemsOf(cart) {
   const items = /* @__PURE__ */ new Map();
@@ -568,7 +568,7 @@ function createController(home) {
       throttleBaseUrl === void 0 ? void 0 : { throttleBaseUrl }
     );
   };
-  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunkCR7ILYCTcjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
+  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunk4ORXUW2Ucjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
   const live = async (signal, value) => {
     const out = await value;
     if (signal.aborted) throw signal.reason;
@@ -579,7 +579,7 @@ function createController(home) {
     if (converted(error)) reset();
     else box.set({ sessionId: null, cartUrl: null });
   }
-  async function create(signal, options, items) {
+  async function create(signal, options, items, whole = false) {
     const context = ctx();
     const body = {
       items: [...items].map(([sku, quantity]) => ({ sku, quantity }))
@@ -603,10 +603,22 @@ function createController(home) {
       throw error;
     }
     const id = answer.sessionId;
-    box.set({
-      sessionId: id,
-      cartUrl: isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id)
-    });
+    const cartUrl = isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id);
+    if (whole) {
+      const snapshot = await live(signal, session(id).get({ signal }));
+      const write = context.cartStorage.set(id);
+      me.writing = Promise.resolve(write).catch(() => void 0);
+      await live(signal, write);
+      box.set({
+        sessionId: id,
+        cartUrl,
+        cart: snapshot.cart,
+        status: "ready",
+        error: void 0
+      });
+      return;
+    }
+    box.set({ sessionId: id, cartUrl });
     let unsaved;
     try {
       const write = context.cartStorage.set(id);
@@ -800,11 +812,10 @@ function createController(home) {
         reset();
         return;
       }
-      const prior = box.get().sessionId;
       try {
-        await create(signal, options, items);
+        await create(signal, options, items, true);
       } catch (error) {
-        if (!signal.aborted && box.get().sessionId === prior) currency = before;
+        if (!signal.aborted) currency = before;
         throw error;
       }
     },
@@ -886,7 +897,7 @@ function useCart(options = {}) {
               { signal: callSignal }
             );
           } catch (error) {
-            const repriced = _chunkCR7ILYCTcjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _37 => _37.details, 'optionalAccess', _38 => _38.cart]) : void 0;
+            const repriced = _chunk4ORXUW2Ucjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _37 => _37.details, 'optionalAccess', _38 => _38.cart]) : void 0;
             if (!callSignal.aborted && typeof repriced === "object" && repriced !== null)
               controller.box.set({ cart: repriced });
             throw error;
@@ -906,7 +917,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, _chunkCR7ILYCTcjs.CatalogError)({
+          throw new (0, _chunk4ORXUW2Ucjs.CatalogError)({
             code: "INVALID_RESPONSE",
             message: "Throttle answered a checkout URL that is not http or https.",
             statusCode: 200,
@@ -1004,4 +1015,4 @@ function useSubmitReview(handle) {
 
 
 
-exports.CatalogProvider = CatalogProvider; exports.SDK_VERSION = _chunkCR7ILYCTcjs.SDK_VERSION; exports.catalogQueryKey = catalogQueryKey; exports.createMemoryCartStorage = createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = useCatalog; exports.useCategories = useCategories; exports.useCollection = useCollection; exports.useConfig = useConfig; exports.useFilterValues = useFilterValues; exports.useProduct = useProduct; exports.useProducts = useProducts; exports.useRelated = useRelated; exports.useReviews = useReviews; exports.useSubmitReview = useSubmitReview; exports.useSuggest = useSuggest;
+exports.CatalogProvider = CatalogProvider; exports.SDK_VERSION = _chunk4ORXUW2Ucjs.SDK_VERSION; exports.catalogQueryKey = catalogQueryKey; exports.createMemoryCartStorage = createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = useCatalog; exports.useCategories = useCategories; exports.useCollection = useCollection; exports.useConfig = useConfig; exports.useFilterValues = useFilterValues; exports.useProduct = useProduct; exports.useProducts = useProducts; exports.useRelated = useRelated; exports.useReviews = useReviews; exports.useSubmitReview = useSubmitReview; exports.useSuggest = useSuggest;

package/dist/react.d.cts

@@ -1,8 +1,9 @@
 import { CatalogClient } from './index.cjs';
-export { S as SDK_VERSION } from './client-BNtBTEyh.cjs';
+export { S as SDK_VERSION } from './client-BAoq6jmM.cjs';
 import { ReactNode } from 'react';
-import { CatalogError } from './index.cjs';
-import { ProductsQuery, ThrottleCart, ReviewSubmitAnswer, ReviewSubmitInput } from './index.cjs';
+import { CatalogError } from './admin.cjs';
+import { CategoryTreeDepth, ProductsQuery, ThrottleCart } from './index.cjs';
+import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.cjs';
 
 /** Where `useCart` keeps the cart session id (P6-R15). The default is memory only. */
 type CartStorage = {
@@ -91,7 +92,7 @@ declare function useSuggest(q: string, options?: QueryOptions<Answer<CatalogClie
     limit?: number;
 }): QueryResult<Answer<CatalogClient['suggest']>>;
 declare function useCategories(options?: QueryOptions<Answer<CatalogClient['categories']['tree']>> & {
-    depth?: 1 | 2 | 3;
+    depth?: CategoryTreeDepth;
 }): QueryResult<Answer<CatalogClient['categories']['tree']>>;
 /** The collection, or `{ redirectTo }` for a renamed handle. */
 declare function useCollection(handle: string | null, options?: QueryOptions<Answer<CatalogClient['collections']['get']>>): QueryResult<Answer<CatalogClient['collections']['get']>>;
@@ -136,7 +137,12 @@ type UseCartResult = CartState & {
     }): Promise<{
         checkoutUrl: string;
     }>;
-    /** A new cart with the current lines in `currency` (BC4); the old one is left to Throttle. */
+    /**
+     * A new cart with the current lines in `currency` (BC4); the old one is
+     * left to Throttle. It lands whole or not at all: if the new cart cannot be
+     * made, read back or saved, it rejects and the old cart, its stored id and
+     * the old currency stay (the unused new cart is left to Throttle).
+     */
     switchCurrency(currency: string): Promise<void>;
     /** Forgets the cart (no request). */
     clear(): Promise<void>;

package/dist/react.d.ts

@@ -1,8 +1,9 @@
 import { CatalogClient } from './index.js';
-export { S as SDK_VERSION } from './client-CHLvULRQ.js';
+export { S as SDK_VERSION } from './client-c2F-eCaL.js';
 import { ReactNode } from 'react';
-import { CatalogError } from './index.js';
-import { ProductsQuery, ThrottleCart, ReviewSubmitAnswer, ReviewSubmitInput } from './index.js';
+import { CatalogError } from './admin.js';
+import { CategoryTreeDepth, ProductsQuery, ThrottleCart } from './index.js';
+import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.js';
 
 /** Where `useCart` keeps the cart session id (P6-R15). The default is memory only. */
 type CartStorage = {
@@ -91,7 +92,7 @@ declare function useSuggest(q: string, options?: QueryOptions<Answer<CatalogClie
     limit?: number;
 }): QueryResult<Answer<CatalogClient['suggest']>>;
 declare function useCategories(options?: QueryOptions<Answer<CatalogClient['categories']['tree']>> & {
-    depth?: 1 | 2 | 3;
+    depth?: CategoryTreeDepth;
 }): QueryResult<Answer<CatalogClient['categories']['tree']>>;
 /** The collection, or `{ redirectTo }` for a renamed handle. */
 declare function useCollection(handle: string | null, options?: QueryOptions<Answer<CatalogClient['collections']['get']>>): QueryResult<Answer<CatalogClient['collections']['get']>>;
@@ -136,7 +137,12 @@ type UseCartResult = CartState & {
     }): Promise<{
         checkoutUrl: string;
     }>;
-    /** A new cart with the current lines in `currency` (BC4); the old one is left to Throttle. */
+    /**
+     * A new cart with the current lines in `currency` (BC4); the old one is
+     * left to Throttle. It lands whole or not at all: if the new cart cannot be
+     * made, read back or saved, it rejects and the old cart, its stored id and
+     * the old currency stay (the unused new cart is left to Throttle).
+     */
     switchCurrency(currency: string): Promise<void>;
     /** Forgets the cart (no request). */
     clear(): Promise<void>;

package/dist/react.js

@@ -11,7 +11,7 @@ import {
   SUGGEST_MIN_CHARS,
   THROTTLE_CHECKOUT_URL,
   isCatalogError
-} from "./chunk-I3QRBPWD.js";
+} from "./chunk-JK2UY4CD.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/react/provider.tsx
@@ -579,7 +579,7 @@ function createController(home) {
     if (converted(error)) reset();
     else box.set({ sessionId: null, cartUrl: null });
   }
-  async function create(signal, options, items) {
+  async function create(signal, options, items, whole = false) {
     const context = ctx();
     const body = {
       items: [...items].map(([sku, quantity]) => ({ sku, quantity }))
@@ -603,10 +603,22 @@ function createController(home) {
       throw error;
     }
     const id = answer.sessionId;
-    box.set({
-      sessionId: id,
-      cartUrl: isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id)
-    });
+    const cartUrl = isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id);
+    if (whole) {
+      const snapshot = await live(signal, session(id).get({ signal }));
+      const write = context.cartStorage.set(id);
+      me.writing = Promise.resolve(write).catch(() => void 0);
+      await live(signal, write);
+      box.set({
+        sessionId: id,
+        cartUrl,
+        cart: snapshot.cart,
+        status: "ready",
+        error: void 0
+      });
+      return;
+    }
+    box.set({ sessionId: id, cartUrl });
     let unsaved;
     try {
       const write = context.cartStorage.set(id);
@@ -800,11 +812,10 @@ function createController(home) {
         reset();
         return;
       }
-      const prior = box.get().sessionId;
       try {
-        await create(signal, options, items);
+        await create(signal, options, items, true);
       } catch (error) {
-        if (!signal.aborted && box.get().sessionId === prior) currency = before;
+        if (!signal.aborted) currency = before;
         throw error;
       }
     },

package/dist/server.cjs

@@ -8,14 +8,15 @@
 
 
 
-var _chunkCR7ILYCTcjs = require('./chunk-CR7ILYCT.cjs');
+
+var _chunk4ORXUW2Ucjs = require('./chunk-4ORXUW2U.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/server/tags.ts
 function catalogTags(route, handle) {
-  const tags = [_chunkCR7ILYCTcjs.CACHE_TAG, `${_chunkCR7ILYCTcjs.CACHE_TAG}:${route}`];
-  if (handle !== void 0) tags.push(`${_chunkCR7ILYCTcjs.CACHE_TAG}:${route}:${handle}`);
-  return tags.filter((tag) => tag.length <= _chunkCR7ILYCTcjs.TAG_MAX_CHARS);
+  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);
 }
 function decode(segment) {
   try {
@@ -72,9 +73,9 @@ function serverInit(url, init, storefront, revalidate, extraTags) {
 }
 function createServerCatalogClient(options) {
   const { next, ...rest } = options;
-  const revalidate = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _ => _.revalidate]), () => ( _chunkCR7ILYCTcjs.DEFAULT_REVALIDATE_S));
+  const revalidate = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _ => _.revalidate]), () => ( _chunk4ORXUW2Ucjs.DEFAULT_REVALIDATE_S));
   const extraTags = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _2 => _2.tags]), () => ( []));
-  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunkCR7ILYCTcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
+  const storefront = `${(_nullishCoalesce(rest.baseUrl, () => ( _chunk4ORXUW2Ucjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "")}/v1/storefront/`;
   const base = rest.fetch;
   const serverFetch = (input, init = {}) => {
     const out = serverInit(
@@ -86,7 +87,7 @@ function createServerCatalogClient(options) {
     );
     return base !== void 0 ? base(input, out) : globalThis.fetch(input, out);
   };
-  return _chunkCR7ILYCTcjs.createCatalogClient.call(void 0, {
+  return _chunk4ORXUW2Ucjs.createCatalogClient.call(void 0, {
     ...rest,
     fetch: serverFetch
   });
@@ -106,16 +107,16 @@ async function syncCatalogGeneration(input) {
 
 // src/server/paging.ts
 function bounds(opts) {
-  const pageSize = _nullishCoalesce(opts.pageSize, () => ( _chunkCR7ILYCTcjs.LIST_PAGE_SIZE));
-  const max = _nullishCoalesce(opts.max, () => ( _chunkCR7ILYCTcjs.LIST_MAX_HANDLES));
-  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > _chunkCR7ILYCTcjs.LIST_PAGE_SIZE)
+  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)
     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, _chunkCR7ILYCTcjs.CatalogError)({
+  return new (0, _chunk4ORXUW2Ucjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -185,7 +186,7 @@ function listAllCollectionHandles(client, opts = {}) {
 }
 async function listAllCategoryHandles(client, opts = {}) {
   const { categories } = await client.categories.tree({
-    depth: 3,
+    depth: _chunk4ORXUW2Ucjs.CATEGORY_TREE_MAX_DEPTH,
     ...call(opts.signal)
   });
   const out = [];
@@ -207,4 +208,4 @@ async function listAllCategoryHandles(client, opts = {}) {
 
 
 
-exports.SDK_VERSION = _chunkCR7ILYCTcjs.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 = _chunk4ORXUW2Ucjs.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,6 +1,7 @@
 import { CatalogClient } from './index.cjs';
-export { S as SDK_VERSION } from './client-BNtBTEyh.cjs';
+export { S as SDK_VERSION } from './client-BAoq6jmM.cjs';
 import { CatalogClientOptions, NextFetchOptions } from './index.cjs';
+import './contract-types-DhiThMEr.cjs';
 
 type ServerCatalogClientOptions = CatalogClientOptions & {
     /** `revalidate` defaults to 60 seconds; `tags` are appended to the route's own. */
@@ -70,7 +71,7 @@ declare function staticProductParams(client: CatalogClient, opts?: {
 }[]>;
 /** Every listed collection handle, following `nextCursor`. */
 declare function listAllCollectionHandles(client: CatalogClient, opts?: ListHandlesOptions): AsyncIterable<string>;
-/** Every listed category handle: the tree at depth 3, depth-first. */
+/** Every listed category handle: the tree at its deepest level, depth-first. */
 declare function listAllCategoryHandles(client: CatalogClient, opts?: {
     signal?: AbortSignal;
 }): Promise<string[]>;

package/dist/server.d.ts

@@ -1,6 +1,7 @@
 import { CatalogClient } from './index.js';
-export { S as SDK_VERSION } from './client-CHLvULRQ.js';
+export { S as SDK_VERSION } from './client-c2F-eCaL.js';
 import { CatalogClientOptions, NextFetchOptions } from './index.js';
+import './contract-types-DhiThMEr.js';
 
 type ServerCatalogClientOptions = CatalogClientOptions & {
     /** `revalidate` defaults to 60 seconds; `tags` are appended to the route's own. */
@@ -70,7 +71,7 @@ declare function staticProductParams(client: CatalogClient, opts?: {
 }[]>;
 /** Every listed collection handle, following `nextCursor`. */
 declare function listAllCollectionHandles(client: CatalogClient, opts?: ListHandlesOptions): AsyncIterable<string>;
-/** Every listed category handle: the tree at depth 3, depth-first. */
+/** Every listed category handle: the tree at its deepest level, depth-first. */
 declare function listAllCategoryHandles(client: CatalogClient, opts?: {
     signal?: AbortSignal;
 }): Promise<string[]>;

package/dist/server.js

@@ -1,5 +1,6 @@
 import {
   CACHE_TAG,
+  CATEGORY_TREE_MAX_DEPTH,
   CatalogError,
   DEFAULT_BASE_URL,
   DEFAULT_REVALIDATE_S,
@@ -8,7 +9,7 @@ import {
   SDK_VERSION,
   TAG_MAX_CHARS,
   createCatalogClient
-} from "./chunk-I3QRBPWD.js";
+} from "./chunk-JK2UY4CD.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/server/tags.ts
@@ -185,7 +186,7 @@ function listAllCollectionHandles(client, opts = {}) {
 }
 async function listAllCategoryHandles(client, opts = {}) {
   const { categories } = await client.categories.tree({
-    depth: 3,
+    depth: CATEGORY_TREE_MAX_DEPTH,
     ...call(opts.signal)
   });
   const out = [];