@usethrottle/catalog 1.2.0 → 1.3.0

package/dist/react.js

@@ -15,14 +15,15 @@ import {
   useRelated,
   useReviews,
   useSuggest
-} from "./chunk-JNBKKAMP.js";
+} from "./chunk-CADIHOIR.js";
 import {
   CatalogError,
   RateLimitedError,
   SDK_VERSION,
   THROTTLE_CHECKOUT_URL,
+  formatMoney,
   isCatalogError
-} from "./chunk-55G4ZTD5.js";
+} from "./chunk-3DLH56OX.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/react/use-cart.ts
@@ -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",
@@ -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()
@@ -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,9 +179,27 @@ 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;
@@ -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 storage.setFor?.(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 }))
@@ -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 = box.get().cart?.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) {
@@ -480,9 +504,15 @@ function createController(home) {
     const outgoing = 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,21 +555,60 @@ 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 (cart?.currency.toUpperCase() === code) return;
+      let target;
+      let moved;
       try {
-        await create(signal, options, items, true);
+        target = await findTarget(signal, code, storage) ?? 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 = box.get().cart?.currency;
+      await live(signal, storage.remove());
+      if (shown !== void 0)
+        await live(signal, storage.removeFor?.(shown.toUpperCase()));
       currency = void 0;
       reset();
     }
@@ -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 = view.cart?.currency ?? controller.wanted(options) ?? "";
+  const format = (minor) => formatMoney(minor, shownCurrency);
+  return { ...view, ...actions, format };
 }
 
 // src/react/use-submit-review.ts

package/dist/server.cjs

@@ -9,14 +9,14 @@
 
 
 
-var _chunkB2DYAHNRcjs = require('./chunk-B2DYAHNR.cjs');
+var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/server/tags.ts
 function catalogTags(route, handle) {
-  const tags = [_chunkB2DYAHNRcjs.CACHE_TAG, `${_chunkB2DYAHNRcjs.CACHE_TAG}:${route}`];
-  if (handle !== void 0) tags.push(`${_chunkB2DYAHNRcjs.CACHE_TAG}:${route}:${handle}`);
-  return tags.filter((tag) => tag.length <= _chunkB2DYAHNRcjs.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 {
@@ -78,9 +78,9 @@ function createServerCatalogClient(options) {
     keyInQuery: _ignored,
     ...rest
   } = options;
-  const revalidate = _nullishCoalesce(_optionalChain([next, 'optionalAccess', _ => _.revalidate]), () => ( _chunkB2DYAHNRcjs.DEFAULT_REVALIDATE_S));
+  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, () => ( _chunkB2DYAHNRcjs.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(
@@ -92,7 +92,7 @@ function createServerCatalogClient(options) {
     );
     return base !== void 0 ? base(input, out) : globalThis.fetch(input, out);
   };
-  return _chunkB2DYAHNRcjs.createCatalogClient.call(void 0, {
+  return _chunk2YQNMBDIcjs.createCatalogClient.call(void 0, {
     ...rest,
     fetch: serverFetch
   });
@@ -112,16 +112,16 @@ async function syncCatalogGeneration(input) {
 
 // src/server/paging.ts
 function bounds(opts) {
-  const pageSize = _nullishCoalesce(opts.pageSize, () => ( _chunkB2DYAHNRcjs.LIST_PAGE_SIZE));
-  const max = _nullishCoalesce(opts.max, () => ( _chunkB2DYAHNRcjs.LIST_MAX_HANDLES));
-  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > _chunkB2DYAHNRcjs.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, _chunkB2DYAHNRcjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -191,7 +191,7 @@ function listAllCollectionHandles(client, opts = {}) {
 }
 async function listAllCategoryHandles(client, opts = {}) {
   const { categories } = await client.categories.tree({
-    depth: _chunkB2DYAHNRcjs.CATEGORY_TREE_MAX_DEPTH,
+    depth: _chunk2YQNMBDIcjs.CATEGORY_TREE_MAX_DEPTH,
     ...call(opts.signal)
   });
   const out = [];
@@ -213,4 +213,4 @@ async function listAllCategoryHandles(client, opts = {}) {
 
 
 
-exports.SDK_VERSION = _chunkB2DYAHNRcjs.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,7 +1,8 @@
 export { S as SDK_VERSION } from './version-ev3p03v2.cjs';
 import { CatalogClient } from './index.cjs';
 import { CatalogClientOptions, NextFetchOptions } from './index.cjs';
-import './contract-types-BPSzY_Co.cjs';
+import '@usethrottle/money';
+import './contract-types-BRyonOYH.cjs';
 
 type ServerCatalogClientOptions = Omit<CatalogClientOptions, 'keyInQuery'> & {
     /** `revalidate` defaults to 60 seconds; `tags` are appended to the route's own. */

package/dist/server.d.ts

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

package/dist/server.js

@@ -9,7 +9,7 @@ import {
   SDK_VERSION,
   TAG_MAX_CHARS,
   createCatalogClient
-} from "./chunk-55G4ZTD5.js";
+} from "./chunk-3DLH56OX.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/server/tags.ts

package/dist/{types-BTrqSprj.d.cts → types-BfveENg1.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, 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][];
 
@@ -141,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;
@@ -198,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;
@@ -212,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>;
@@ -290,7 +326,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 +335,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 +346,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 { 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-BlYCKzB8.d.ts → types-D0PywKnN.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, 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][];
 
@@ -141,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;
@@ -198,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;
@@ -212,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>;
@@ -290,7 +326,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 +335,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 +346,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 { 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-BPSzY_Co.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-BPSzY_Co.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-QOEBuYlp.d.ts → use-query-CR7r5tam.d.ts}

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/catalog",
-  "version": "1.2.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": {
@@ -88,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"