@usethrottle/catalog 1.2.0 → 1.3.0

package/dist/react.cjs

@@ -1,5 +1,5 @@
 "use client";
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return 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; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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; }
 
 
 
@@ -15,14 +15,15 @@
 
 
 
-var _chunkTDMDOHD3cjs = require('./chunk-TDMDOHD3.cjs');
+var _chunkGU63WFXIcjs = require('./chunk-GU63WFXI.cjs');
 
 
 
 
 
 
-var _chunkB2DYAHNRcjs = require('./chunk-B2DYAHNR.cjs');
+
+var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/react/use-cart.ts
@@ -39,7 +40,7 @@ function newKey() {
   return out;
 }
 function refuse(message, path) {
-  return new (0, _chunkB2DYAHNRcjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -52,7 +53,7 @@ var UNSAFE = /[\x00-\x20\x7f]/u;
 function isHttpUrl(value) {
   return typeof value === "string" && /^https?:\/\/[^/?#\\]/iu.test(value) && !UNSAFE.test(value);
 }
-var wrap = (error) => _chunkB2DYAHNRcjs.isCatalogError.call(void 0, error) ? error : new (0, _chunkB2DYAHNRcjs.CatalogError)({
+var wrap = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk2YQNMBDIcjs.CatalogError)({
   code: "CLIENT_ERROR",
   message: "The action failed.",
   statusCode: 0,
@@ -63,7 +64,7 @@ var wrap = (error) => _chunkB2DYAHNRcjs.isCatalogError.call(void 0, error) ? err
 function checkPause(store) {
   const until = store.pausedUntil();
   if (until > 0) {
-    throw new (0, _chunkB2DYAHNRcjs.RateLimitedError)({
+    throw new (0, _chunk2YQNMBDIcjs.RateLimitedError)({
       code: "RATE_LIMITED",
       message: "Too many requests.",
       statusCode: 429,
@@ -73,7 +74,7 @@ function checkPause(store) {
   }
 }
 function notePause(store, error) {
-  if (error instanceof _chunkB2DYAHNRcjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
+  if (error instanceof _chunk2YQNMBDIcjs.RateLimitedError && error.source === "catalog" && error.code === "RATE_LIMITED")
     store.pause(Date.now() + error.retryAfterSeconds * 1e3, error);
 }
 function createBox(initial) {
@@ -99,7 +100,8 @@ var EMPTY = {
   cartUrl: null,
   status: "idle",
   error: void 0,
-  pending: false
+  pending: false,
+  warnings: []
 };
 var ENDED = /* @__PURE__ */ new Set([
   "cart_session_expired",
@@ -107,7 +109,7 @@ var ENDED = /* @__PURE__ */ new Set([
   "cart_not_open",
   "cart_not_found"
 ]);
-var ended = (error) => _chunkB2DYAHNRcjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
+var ended = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) && ENDED.has(error.code);
 var converted = (error) => _optionalChain([error, 'access', _2 => _2.details, 'optionalAccess', _3 => _3.reason]) === "converted";
 function itemsOf(cart) {
   const items = /* @__PURE__ */ new Map();
@@ -132,6 +134,7 @@ function createController(home) {
     moving: void 0,
     unremoved: false,
     reads: /* @__PURE__ */ new Map(),
+    slots: /* @__PURE__ */ new Set(),
     abort: new AbortController(),
     writing: Promise.resolve(),
     tail: Promise.resolve()
@@ -150,7 +153,7 @@ function createController(home) {
       throttleBaseUrl === void 0 ? void 0 : { throttleBaseUrl }
     );
   };
-  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunkB2DYAHNRcjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
+  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunk2YQNMBDIcjs.THROTTLE_CHECKOUT_URL))).replace(/\/+$/u, "")}/cart/${encodeURIComponent(id)}`;
   const live = async (signal, value) => {
     const out = await value;
     if (signal.aborted) throw signal.reason;
@@ -168,7 +171,7 @@ function createController(home) {
       if (signal.aborted) throw error;
     }
   }
-  async function find(signal, wantedCurrency) {
+  async function find(signal, wantedCurrency, strict = false) {
     const source = ctx().customerCart;
     if (source === void 0 || wantedCurrency === void 0) return null;
     const asked = wantedCurrency.toUpperCase();
@@ -176,10 +179,28 @@ function createController(home) {
       const found = await live(signal, source.getOpenCart({ currency: asked }));
       return found !== null && found.currency.toUpperCase() === asked ? found : null;
     } catch (error) {
-      if (signal.aborted) throw error;
+      if (signal.aborted || strict) throw error;
       return null;
     }
   }
+  async function findTarget(signal, code, storage) {
+    if (resuming()) {
+      const found = await find(signal, code, true);
+      return found === null ? null : { id: found.sessionId, cartUrl: fallbackUrl(found.sessionId) };
+    }
+    if (ctx().customerKey !== null || storage.getFor === void 0) return null;
+    const id = await live(signal, storage.getFor(code));
+    if (id === null || id === "") return null;
+    try {
+      const answer = await live(signal, session(id).get({ signal }));
+      if (answer.cart.status !== "open" || answer.cart.currency.toUpperCase() !== code)
+        return null;
+    } catch (error) {
+      if (signal.aborted || !ended(error)) throw error;
+      return null;
+    }
+    return { id, cartUrl: fallbackUrl(id) };
+  }
   async function findOnce(signal, storage) {
     var _a2;
     if (!resuming()) return;
@@ -197,13 +218,21 @@ function createController(home) {
     }
     if (found !== null) await soft(signal, () => adopt(signal, found, storage));
   }
+  async function forgetSlots(storage, codes) {
+    for (const code of codes)
+      if (storage.removeFor !== void 0) await storage.removeFor(code);
+      else await _optionalChain([storage, 'access', _15 => _15.setFor, 'optionalCall', _16 => _16(code, "")]);
+  }
+  async function save(signal, storage, id) {
+    const write = storage.set(id);
+    me.writing = Promise.resolve(write).catch(() => void 0);
+    await live(signal, write);
+  }
   async function adopt(signal, found, storage) {
     const id = found.sessionId;
     const answer = await live(signal, session(id).get({ signal }));
     me.reads.set(id, Date.now());
-    const write = storage.set(id);
-    me.writing = Promise.resolve(write).catch(() => void 0);
-    await live(signal, write);
+    await save(signal, storage, id);
     box.set({
       sessionId: id,
       cartUrl: fallbackUrl(id),
@@ -229,7 +258,7 @@ function createController(home) {
     if (converted(error)) reset();
     else box.set({ sessionId: null, cartUrl: null });
   }
-  async function create(signal, options, items, whole = false) {
+  async function start(signal, options, items) {
     const context = ctx();
     const body = {
       items: [...items].map(([sku, quantity]) => ({ sku, quantity }))
@@ -238,9 +267,9 @@ function createController(home) {
     if (chosen !== void 0) body.currency = chosen;
     if (options.locale !== void 0) body.locale = options.locale;
     const urls = context.cartUrls;
-    if (_optionalChain([urls, 'optionalAccess', _15 => _15.returnUrl]) !== void 0) body.returnUrl = urls.returnUrl;
-    if (_optionalChain([urls, 'optionalAccess', _16 => _16.cancelUrl]) !== void 0) body.cancelUrl = urls.cancelUrl;
-    if (_optionalChain([urls, 'optionalAccess', _17 => _17.storefrontUrl]) !== void 0)
+    if (_optionalChain([urls, 'optionalAccess', _17 => _17.returnUrl]) !== void 0) body.returnUrl = urls.returnUrl;
+    if (_optionalChain([urls, 'optionalAccess', _18 => _18.cancelUrl]) !== void 0) body.cancelUrl = urls.cancelUrl;
+    if (_optionalChain([urls, 'optionalAccess', _19 => _19.storefrontUrl]) !== void 0)
       body.storefrontUrl = urls.storefrontUrl;
     let answer;
     try {
@@ -253,28 +282,18 @@ function createController(home) {
       throw error;
     }
     const id = answer.sessionId;
-    const cartUrl = isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id);
-    if (whole) {
-      const snapshot = await live(signal, session(id).get({ signal }));
-      me.reads.set(id, Date.now());
-      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;
-    }
+    return {
+      id,
+      cartUrl: isHttpUrl(answer.cartUrl) ? answer.cartUrl : fallbackUrl(id)
+    };
+  }
+  async function create(signal, options, items) {
+    const storage = ctx().cartStorage;
+    const { id, cartUrl } = await start(signal, options, items);
     box.set({ sessionId: id, cartUrl });
     let unsaved;
     try {
-      const write = context.cartStorage.set(id);
-      me.writing = Promise.resolve(write).catch(() => void 0);
-      await live(signal, write);
+      await save(signal, storage, id);
     } catch (error) {
       if (signal.aborted) throw error;
       unsaved = error;
@@ -432,6 +451,11 @@ function createController(home) {
       if (signal.aborted) return;
       if (fresh && !me.unremoved) await restore(signal, guest, false);
       if (signal.aborted) return;
+      const codes = new Set(me.slots);
+      const shown = _optionalChain([box, 'access', _20 => _20.get, 'call', _21 => _21(), 'access', _22 => _22.cart, 'optionalAccess', _23 => _23.currency]);
+      if (shown !== void 0) codes.add(shown.toUpperCase());
+      await live(signal, forgetSlots(guest, codes));
+      me.slots.clear();
       const id = box.get().sessionId;
       if (id === null) {
         if (box.get().cart === null && !me.unremoved) {
@@ -472,7 +496,7 @@ function createController(home) {
     me.abort = new AbortController();
     me.reads.clear();
     for (const key2 of _nullishCoalesce(home.shared.looked, () => ( [])))
-      if (key2.startsWith(`${was}\0`)) _optionalChain([home, 'access', _18 => _18.shared, 'access', _19 => _19.looked, 'optionalAccess', _20 => _20.delete, 'call', _21 => _21(key2)]);
+      if (key2.startsWith(`${was}\0`)) _optionalChain([home, 'access', _24 => _24.shared, 'access', _25 => _25.looked, 'optionalAccess', _26 => _26.delete, 'call', _27 => _27(key2)]);
     currency = void 0;
     loaded = true;
     reset();
@@ -480,9 +504,15 @@ function createController(home) {
     const outgoing = _nullishCoalesce(prior, () => ( me.seen));
     const left = me.moving;
     me.moving = void 0;
+    const slots = [...me.slots];
+    me.slots.clear();
     const remove = async () => {
       await outgoing.remove();
-      if (left !== void 0 && left !== outgoing) await left.remove();
+      await forgetSlots(outgoing, slots);
+      if (left !== void 0 && left !== outgoing) {
+        await left.remove();
+        await forgetSlots(left, slots);
+      }
     };
     me.tail = me.writing.then(remove).catch(remove).then(
       () => {
@@ -508,6 +538,7 @@ function createController(home) {
     mutate,
     create,
     session,
+    wanted,
     async switchCurrency(signal, options, next) {
       checkPause(ctx().store);
       const storage = ctx().cartStorage;
@@ -524,28 +555,67 @@ function createController(home) {
       }
       const before = currency;
       currency = next;
-      const items = itemsOf(box.get().cart);
-      if (items.size === 0) {
-        if (box.get().sessionId !== null) await live(signal, storage.remove());
-        reset();
+      const code = next.toUpperCase();
+      const from = box.get().sessionId;
+      const cart = box.get().cart;
+      const items = itemsOf(cart);
+      if (from === null || items.size === 0) {
+        if (from !== null) await live(signal, storage.remove());
+        if (items.size === 0) reset();
         return;
       }
+      if (_optionalChain([cart, 'optionalAccess', _28 => _28.currency, 'access', _29 => _29.toUpperCase, 'call', _30 => _30()]) === code) return;
+      let target;
+      let moved;
       try {
-        await create(signal, options, items, true);
+        target = await _asyncNullishCoalesce(await findTarget(signal, code, storage), async () => ( await start(signal, options, /* @__PURE__ */ new Map())));
+        moved = await live(signal, session(target.id).absorb(from, { signal }));
       } catch (error) {
         if (!signal.aborted) currency = before;
         throw error;
       }
+      me.reads.set(target.id, Date.now());
+      box.set({
+        sessionId: target.id,
+        cartUrl: target.cartUrl,
+        cart: moved.cart,
+        status: "ready",
+        error: void 0,
+        warnings: moved.warnings.filter(
+          (warning) => warning.code !== "lines_stale"
+        )
+      });
+      let unsaved;
+      try {
+        await save(signal, storage, target.id);
+      } catch (error) {
+        if (signal.aborted) throw error;
+        unsaved = error;
+        try {
+          await live(signal, storage.remove());
+        } catch (failure) {
+          if (signal.aborted) throw failure;
+        }
+      }
+      if (ctx().customerKey === null && storage.setFor !== void 0) {
+        me.slots.add(code);
+        await live(signal, storage.setFor(code, target.id));
+      }
+      if (unsaved !== void 0) throw unsaved;
     },
     async clear(signal) {
-      await live(signal, ctx().cartStorage.remove());
+      const storage = ctx().cartStorage;
+      const shown = _optionalChain([box, 'access', _31 => _31.get, 'call', _32 => _32(), 'access', _33 => _33.cart, 'optionalAccess', _34 => _34.currency]);
+      await live(signal, storage.remove());
+      if (shown !== void 0)
+        await live(signal, _optionalChain([storage, 'access', _35 => _35.removeFor, 'optionalCall', _36 => _36(shown.toUpperCase())]));
       currency = void 0;
       reset();
     }
   };
 }
 function useCart(options = {}) {
-  const context = _chunkTDMDOHD3cjs.useCatalogContext.call(void 0, );
+  const context = _chunkGU63WFXIcjs.useCatalogContext.call(void 0, );
   const home = context.cart;
   const controller = _nullishCoalesce(home.current, () => ( (home.current = createController(home))));
   const state = _react.useSyncExternalStore.call(void 0, 
@@ -595,8 +665,8 @@ function useCart(options = {}) {
       ),
       checkout: (input) => controller.run(async (signal) => {
         const { cartUrls } = home.context;
-        const returnUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _22 => _22.returnUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _23 => _23.returnUrl])));
-        const cancelUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _24 => _24.cancelUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _25 => _25.cancelUrl])));
+        const returnUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _37 => _37.returnUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _38 => _38.returnUrl])));
+        const cancelUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _39 => _39.cancelUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _40 => _40.cancelUrl])));
         if (returnUrl === void 0 || cancelUrl === void 0)
           throw refuse(
             "checkout() needs returnUrl and cancelUrl, given or from the provider cartUrls."
@@ -619,7 +689,7 @@ function useCart(options = {}) {
               { signal: callSignal }
             );
           } catch (error) {
-            const repriced = _chunkB2DYAHNRcjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _26 => _26.details, 'optionalAccess', _27 => _27.cart]) : void 0;
+            const repriced = _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) && error.code === "cart_prices_changed" ? _optionalChain([error, 'access', _41 => _41.details, 'optionalAccess', _42 => _42.cart]) : void 0;
             if (!callSignal.aborted && typeof repriced === "object" && repriced !== null)
               controller.box.set({ cart: repriced });
             throw error;
@@ -639,7 +709,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, _chunkB2DYAHNRcjs.CatalogError)({
+          throw new (0, _chunk2YQNMBDIcjs.CatalogError)({
             code: "INVALID_RESPONSE",
             message: "Throttle answered a checkout URL that is not http or https.",
             statusCode: 200,
@@ -656,7 +726,9 @@ function useCart(options = {}) {
   }, [controller, home, currency, locale]);
   const owner = controller.owner();
   const view = owner !== void 0 && owner !== null && owner !== customerKey ? { ...EMPTY, pending: state.pending } : state;
-  return { ...view, ...actions };
+  const shownCurrency = _nullishCoalesce(_nullishCoalesce(_optionalChain([view, 'access', _43 => _43.cart, 'optionalAccess', _44 => _44.currency]), () => ( controller.wanted(options))), () => ( ""));
+  const format = (minor) => _chunk2YQNMBDIcjs.formatMoney.call(void 0, minor, shownCurrency);
+  return { ...view, ...actions, format };
 }
 
 // src/react/use-submit-review.ts
@@ -667,7 +739,7 @@ var IDLE = {
   result: void 0
 };
 function useSubmitReview(handle) {
-  const { client, store, customerKey } = _chunkTDMDOHD3cjs.useCatalogContext.call(void 0, );
+  const { client, store, customerKey } = _chunkGU63WFXIcjs.useCatalogContext.call(void 0, );
   const scope = _react.useMemo.call(void 0, 
     () => ({
       box: createBox(IDLE),
@@ -738,4 +810,4 @@ function useSubmitReview(handle) {
 
 
 
-exports.CatalogProvider = _chunkTDMDOHD3cjs.CatalogProvider; exports.SDK_VERSION = _chunkB2DYAHNRcjs.SDK_VERSION; exports.catalogQueryKey = _chunkTDMDOHD3cjs.catalogQueryKey; exports.createMemoryCartStorage = _chunkTDMDOHD3cjs.createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = _chunkTDMDOHD3cjs.useCatalog; exports.useCategories = _chunkTDMDOHD3cjs.useCategories; exports.useCollection = _chunkTDMDOHD3cjs.useCollection; exports.useConfig = _chunkTDMDOHD3cjs.useConfig; exports.useCustomerKey = _chunkTDMDOHD3cjs.useCustomerKey; exports.useFilterValues = _chunkTDMDOHD3cjs.useFilterValues; exports.useProduct = _chunkTDMDOHD3cjs.useProduct; exports.useProducts = _chunkTDMDOHD3cjs.useProducts; exports.useRelated = _chunkTDMDOHD3cjs.useRelated; exports.useReviews = _chunkTDMDOHD3cjs.useReviews; exports.useSubmitReview = useSubmitReview; exports.useSuggest = _chunkTDMDOHD3cjs.useSuggest;
+exports.CatalogProvider = _chunkGU63WFXIcjs.CatalogProvider; exports.SDK_VERSION = _chunk2YQNMBDIcjs.SDK_VERSION; exports.catalogQueryKey = _chunkGU63WFXIcjs.catalogQueryKey; exports.createMemoryCartStorage = _chunkGU63WFXIcjs.createMemoryCartStorage; exports.useCart = useCart; exports.useCatalog = _chunkGU63WFXIcjs.useCatalog; exports.useCategories = _chunkGU63WFXIcjs.useCategories; exports.useCollection = _chunkGU63WFXIcjs.useCollection; exports.useConfig = _chunkGU63WFXIcjs.useConfig; exports.useCustomerKey = _chunkGU63WFXIcjs.useCustomerKey; exports.useFilterValues = _chunkGU63WFXIcjs.useFilterValues; exports.useProduct = _chunkGU63WFXIcjs.useProduct; exports.useProducts = _chunkGU63WFXIcjs.useProducts; exports.useRelated = _chunkGU63WFXIcjs.useRelated; exports.useReviews = _chunkGU63WFXIcjs.useReviews; exports.useSubmitReview = useSubmitReview; exports.useSuggest = _chunkGU63WFXIcjs.useSuggest;

package/dist/react.d.cts

@@ -1,20 +1,32 @@
 export { ReviewEligibility } from './index.cjs';
 import { ReactNode } from 'react';
 import { CatalogClient } from './index.cjs';
-import { C as CustomerCartSource } from './types-BTrqSprj.cjs';
-import { CategoryTreeDepth, ProductsQuery, ThrottleCart } from './index.cjs';
-export { O as OpenCartRef } from './types-BTrqSprj.cjs';
-import { Q as QueryOptions, a as QueryResult } from './use-query-BZgjxGPO.cjs';
-export { c as catalogQueryKey } from './use-query-BZgjxGPO.cjs';
+import { C as CustomerCartSource } from './types-D0PywKnN.cjs';
+import { CategoryTreeDepth, ProductsQuery, ThrottleCart, CartWarning } from './index.cjs';
+export { O as OpenCartRef } from './types-D0PywKnN.cjs';
+import { Q as QueryOptions, a as QueryResult } from './use-query-UWf6Pi5g.cjs';
+export { c as catalogQueryKey } from './use-query-UWf6Pi5g.cjs';
 import { CatalogError } from './admin.cjs';
 import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.cjs';
 export { S as SDK_VERSION } from './version-ev3p03v2.cjs';
+import '@usethrottle/money';
 
-/** Where `useCart` keeps the cart session id (P6-R15). The default is memory only. */
+/**
+ * Where `useCart` keeps the cart session id (P6-R15). The default is memory
+ * only. The optional per-currency slots let a guest's `switchCurrency` find
+ * the cart it already has in that currency (MC2-R41); without them a guest
+ * switch makes a new cart. They hold a guest's carts only: `useCart` never
+ * writes them while signed in, and forgets them on a sign-in, a sign-out or
+ * a customer change (`removeFor`, else `setFor(currency, '')`).
+ */
 type CartStorage = {
     get(): string | null | Promise<string | null>;
     set(id: string): void | Promise<void>;
     remove(): void | Promise<void>;
+    /** The session id last saved for `currency` (upper case), or `null`. */
+    getFor?(currency: string): string | null | Promise<string | null>;
+    setFor?(currency: string, id: string): void | Promise<void>;
+    removeFor?(currency: string): void | Promise<void>;
 };
 /** In memory only: the cart is forgotten on reload. The default `cartStorage`. */
 declare function createMemoryCartStorage(): CartStorage;
@@ -98,6 +110,12 @@ type CartState = {
     error: CatalogError | undefined;
     /** A change is queued or running. */
     pending: boolean;
+    /**
+     * What the last `switchCurrency` could not carry over: `lines_removed`
+     * (lines with no price in the new currency, left behind) and
+     * `discount_dropped` (a code the new currency refuses). Empty otherwise.
+     */
+    warnings: CartWarning[];
 };
 type CartOptions = {
     currency?: string;
@@ -120,14 +138,20 @@ type UseCartResult = CartState & {
         checkoutUrl: string;
     }>;
     /**
-     * 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).
+     * Moves the cart into `currency`, keeping one cart per currency (MC2-R41):
+     * the shopper's open cart in `currency` (the signed-in customer's from
+     * `customerCart`, a guest's from `cartStorage.getFor`), else a new empty
+     * one, absorbs the current cart, which Throttle then closes as merged. Lines
+     * with no price in `currency` stay behind and a discount it refuses is
+     * dropped; both show in `warnings`. If anything fails before the absorb
+     * lands, it rejects and the old cart, its stored id and the old currency
+     * stay (an unused new cart is left to Throttle).
      */
     switchCurrency(currency: string): Promise<void>;
     /** Forgets the cart (no request). */
     clear(): Promise<void>;
+    /** `formatMoney(minor, currency)` in the cart's currency (before a cart, the hook's or the client's). */
+    format(minor: number): string;
 };
 /**
  * The provider's cart (P6-R15). The session id is kept in the provider's

package/dist/react.d.ts

@@ -1,20 +1,32 @@
 export { ReviewEligibility } from './index.js';
 import { ReactNode } from 'react';
 import { CatalogClient } from './index.js';
-import { C as CustomerCartSource } from './types-BlYCKzB8.js';
-import { CategoryTreeDepth, ProductsQuery, ThrottleCart } from './index.js';
-export { O as OpenCartRef } from './types-BlYCKzB8.js';
-import { Q as QueryOptions, a as QueryResult } from './use-query-QOEBuYlp.js';
-export { c as catalogQueryKey } from './use-query-QOEBuYlp.js';
+import { C as CustomerCartSource } from './types-BfveENg1.js';
+import { CategoryTreeDepth, ProductsQuery, ThrottleCart, CartWarning } from './index.js';
+export { O as OpenCartRef } from './types-BfveENg1.js';
+import { Q as QueryOptions, a as QueryResult } from './use-query-CR7r5tam.js';
+export { c as catalogQueryKey } from './use-query-CR7r5tam.js';
 import { CatalogError } from './admin.js';
 import { ReviewSubmitAnswer, ReviewSubmitInput } from './index.js';
 export { S as SDK_VERSION } from './version-ev3p03v2.js';
+import '@usethrottle/money';
 
-/** Where `useCart` keeps the cart session id (P6-R15). The default is memory only. */
+/**
+ * Where `useCart` keeps the cart session id (P6-R15). The default is memory
+ * only. The optional per-currency slots let a guest's `switchCurrency` find
+ * the cart it already has in that currency (MC2-R41); without them a guest
+ * switch makes a new cart. They hold a guest's carts only: `useCart` never
+ * writes them while signed in, and forgets them on a sign-in, a sign-out or
+ * a customer change (`removeFor`, else `setFor(currency, '')`).
+ */
 type CartStorage = {
     get(): string | null | Promise<string | null>;
     set(id: string): void | Promise<void>;
     remove(): void | Promise<void>;
+    /** The session id last saved for `currency` (upper case), or `null`. */
+    getFor?(currency: string): string | null | Promise<string | null>;
+    setFor?(currency: string, id: string): void | Promise<void>;
+    removeFor?(currency: string): void | Promise<void>;
 };
 /** In memory only: the cart is forgotten on reload. The default `cartStorage`. */
 declare function createMemoryCartStorage(): CartStorage;
@@ -98,6 +110,12 @@ type CartState = {
     error: CatalogError | undefined;
     /** A change is queued or running. */
     pending: boolean;
+    /**
+     * What the last `switchCurrency` could not carry over: `lines_removed`
+     * (lines with no price in the new currency, left behind) and
+     * `discount_dropped` (a code the new currency refuses). Empty otherwise.
+     */
+    warnings: CartWarning[];
 };
 type CartOptions = {
     currency?: string;
@@ -120,14 +138,20 @@ type UseCartResult = CartState & {
         checkoutUrl: string;
     }>;
     /**
-     * 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).
+     * Moves the cart into `currency`, keeping one cart per currency (MC2-R41):
+     * the shopper's open cart in `currency` (the signed-in customer's from
+     * `customerCart`, a guest's from `cartStorage.getFor`), else a new empty
+     * one, absorbs the current cart, which Throttle then closes as merged. Lines
+     * with no price in `currency` stay behind and a discount it refuses is
+     * dropped; both show in `warnings`. If anything fails before the absorb
+     * lands, it rejects and the old cart, its stored id and the old currency
+     * stay (an unused new cart is left to Throttle).
      */
     switchCurrency(currency: string): Promise<void>;
     /** Forgets the cart (no request). */
     clear(): Promise<void>;
+    /** `formatMoney(minor, currency)` in the cart's currency (before a cart, the hook's or the client's). */
+    format(minor: number): string;
 };
 /**
  * The provider's cart (P6-R15). The session id is kept in the provider's