@usethrottle/catalog 1.1.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; }
 
 
 
@@ -11,449 +11,28 @@
 
 
 
-var _chunk4ORXUW2Ucjs = require('./chunk-4ORXUW2U.cjs');
-require('./chunk-ETV4XYOV.cjs');
 
-// src/react/provider.tsx
 
 
 
+var _chunkGU63WFXIcjs = require('./chunk-GU63WFXI.cjs');
 
 
 
-var _react = require('react');
 
-// src/react/store.ts
-var HOOK_CALL = Symbol.for("@usethrottle/catalog.hookCall");
-var EMPTY = {
-  data: void 0,
-  error: void 0,
-  isValidating: false,
-  fetchedAt: void 0
-};
-var done = Promise.resolve();
-function createStore(client, options = {}) {
-  const now = _nullishCoalesce(options.now, () => ( Date.now));
-  const entries = /* @__PURE__ */ new Map();
-  let until = 0;
-  let cause;
-  let pauseTimer;
-  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,
-    source: _nullishCoalesce(_optionalChain([cause, 'optionalAccess', _3 => _3.source]), () => ( "catalog")),
-    retryAfterSeconds: Math.ceil((until - now()) / 1e3)
-  });
-  const update = (entry, patch) => {
-    entry.snap = { ...entry.snap, ...patch };
-    for (const listener of [...entry.subs]) listener();
-  };
-  const touch = (key, initial, stale = false) => {
-    let entry = entries.get(key);
-    if (entry !== void 0) {
-      entries.delete(key);
-    } else {
-      entry = {
-        snap: initial === void 0 ? EMPTY : { ...EMPTY, data: initial, fetchedAt: stale ? void 0 : now() },
-        subs: /* @__PURE__ */ new Set()
-      };
-      for (const [oldKey, old] of entries) {
-        if (entries.size < _chunk4ORXUW2Ucjs.CACHE_MAX_ENTRIES) break;
-        if (old.subs.size === 0 && old.flight === void 0) {
-          clearTimeout(old.timer);
-          entries.delete(oldKey);
-        }
-      }
-    }
-    entries.set(key, entry);
-    return entry;
-  };
-  const later = (key, entry, ms) => {
-    entry.indexing = true;
-    clearTimeout(entry.timer);
-    entry.timer = setTimeout(() => {
-      if (entries.get(key) === entry && entry.subs.size > 0 && entry.run)
-        void fetchKey(key, entry.run, { force: true });
-      else entry.indexing = false;
-    }, 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]))
-      return entry.promise;
-    if (now() < until) {
-      if (entry.snap.data === void 0 && entry.snap.error === void 0)
-        update(entry, { error: pausedError() });
-      return done;
-    }
-    const at = entry.snap.fetchedAt;
-    if (!force && at !== void 0 && now() - at < staleMs) return done;
-    const controller = new AbortController();
-    const box = entry.etag === void 0 ? {} : { etag: entry.etag };
-    const current = () => {
-      if (entry.flight !== controller) return false;
-      entry.flight = entry.promise = void 0;
-      if (!controller.signal.aborted) return true;
-      update(entry, { isValidating: false });
-      return false;
-    };
-    entry.flight = controller;
-    update(entry, { isValidating: true });
-    let pending;
-    try {
-      pending = run(client, {
-        signal: controller.signal,
-        [HOOK_CALL]: box
-      });
-    } catch (error) {
-      pending = Promise.reject(error);
-    }
-    const promise = pending.then(
-      (value) => {
-        if (!current()) return;
-        const result = _nullishCoalesce(box.result, () => ( {
-          notModified: false,
-          data: value,
-          etag: null
-        }));
-        entry.etag = _nullishCoalesce(result.etag, () => ( void 0));
-        if (result.notModified) {
-          update(entry, {
-            error: void 0,
-            isValidating: false,
-            fetchedAt: now()
-          });
-          return;
-        }
-        if (_optionalChain([result, 'access', _7 => _7.data, 'optionalAccess', _8 => _8.indexing]) === true) {
-          if (!entry.indexing) later(key, entry, _chunk4ORXUW2Ucjs.INDEXING_REVALIDATE_MS);
-        } else {
-          entry.indexing = false;
-        }
-        update(entry, {
-          data: result.data,
-          error: void 0,
-          isValidating: false,
-          fetchedAt: now()
-        });
-      },
-      (error) => {
-        if (!current()) return;
-        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)
-          later(key, entry, retryMs);
-        update(entry, { error, isValidating: false });
-      }
-    );
-    entry.promise = promise;
-    return promise;
-  }
-  function pause(untilMs, error) {
-    if (untilMs <= Math.max(until, now())) return;
-    until = untilMs;
-    cause = error;
-    clearTimeout(pauseTimer);
-    pauseTimer = setTimeout(() => {
-      until = 0;
-      for (const [key, entry] of [...entries]) {
-        if (entry.subs.size > 0 && entry.run)
-          void fetchKey(key, entry.run, { force: true });
-      }
-    }, untilMs - now());
-  }
-  function clear() {
-    for (const [key, entry] of [...entries]) {
-      clearTimeout(entry.timer);
-      _optionalChain([entry, 'access', _9 => _9.flight, 'optionalAccess', _10 => _10.abort, 'call', _11 => _11()]);
-      if (entry.subs.size === 0) {
-        entries.delete(key);
-      } else {
-        entry.etag = entry.flight = entry.promise = void 0;
-        entry.indexing = false;
-        update(entry, EMPTY);
-      }
-    }
-  }
-  return {
-    subscribe(key, listener) {
-      const entry = touch(key);
-      entry.subs.add(listener);
-      return () => {
-        entry.subs.delete(listener);
-        void done.then(() => {
-          if (entry.subs.size === 0) _optionalChain([entry, 'access', _12 => _12.flight, 'optionalAccess', _13 => _13.abort, 'call', _14 => _14()]);
-        });
-      };
-    },
-    get: (key, initial, stale) => key === null ? EMPTY : _nullishCoalesce(_optionalChain([(_nullishCoalesce(entries.get(key), () => ( (initial === void 0 ? void 0 : touch(key, initial, stale))))), 'optionalAccess', _15 => _15.snap]), () => ( EMPTY)),
-    getServer(key, initial, stale) {
-      if (key === null || initial === void 0) return EMPTY;
-      const entry = _nullishCoalesce(entries.get(key), () => ( touch(key, initial, stale)));
-      return _nullishCoalesce(entry.server, () => ( (entry.server = { ...EMPTY, data: initial })));
-    },
-    fetch: fetchKey,
-    clear,
-    pause,
-    pausedUntil: () => until > now() ? until : 0,
-    dispose() {
-      clearTimeout(pauseTimer);
-      until = 0;
-      clear();
-      for (const entry of entries.values()) entry.subs.clear();
-      entries.clear();
-    }
-  };
-}
 
-// src/react/provider.tsx
-var _jsxruntime = require('react/jsx-runtime');
-function createMemoryCartStorage() {
-  let id = null;
-  return {
-    get: () => id,
-    set: (value) => {
-      id = value;
-    },
-    remove: () => {
-      id = null;
-    }
-  };
-}
-var CatalogContext = _react.createContext.call(void 0, null);
-function useCatalogContext() {
-  const value = _react.useContext.call(void 0, CatalogContext);
-  if (value === null)
-    throw new Error("Catalog hooks must be used inside a <CatalogProvider>.");
-  return value;
-}
-function CatalogProvider(props) {
-  const { client, children, ...rest } = props;
-  const customerKey = _nullishCoalesce(props.customerKey, () => ( null));
-  const mounted = _react.useRef.call(void 0, null);
-  const store = _react.useMemo.call(void 0, () => {
-    const next = createStore(client);
-    next.pause(_nullishCoalesce(_optionalChain([mounted, 'access', _16 => _16.current, 'optionalAccess', _17 => _17.pausedUntil, 'call', _18 => _18()]), () => ( 0)));
-    return next;
-  }, [client, customerKey]);
-  _react.useEffect.call(void 0, () => {
-    mounted.current = store;
-    return () => {
-      mounted.current = null;
-      void Promise.resolve().then(() => {
-        if (mounted.current !== store) store.dispose();
-      });
-    };
-  }, [store]);
-  const memory = _react.useMemo.call(void 0, createMemoryCartStorage, []);
-  const cartStorage = _nullishCoalesce(rest.cartStorage, () => ( memory));
-  const shared = _react.useRef.call(void 0, {}).current;
-  const cart = _react.useMemo.call(void 0, 
-    () => ({ shared }),
-    [shared, client, rest.throttleBaseUrl]
-  );
-  const urls = rest.cartUrls;
-  const value = _react.useMemo.call(void 0, 
-    () => ({ ...rest, client, customerKey, store, cartStorage, cart }),
-    // `rest` is spread fresh each render; its fields are the dependencies.
-    [
-      client,
-      customerKey,
-      store,
-      cartStorage,
-      cart,
-      rest.throttleBaseUrl,
-      rest.throttleCheckoutUrl,
-      _optionalChain([urls, 'optionalAccess', _19 => _19.returnUrl]),
-      _optionalChain([urls, 'optionalAccess', _20 => _20.cancelUrl]),
-      _optionalChain([urls, 'optionalAccess', _21 => _21.storefrontUrl])
-    ]
-  );
-  cart.context = value;
-  shared.home = cart;
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, CatalogContext.Provider, { value, children });
-}
-function useCatalog() {
-  return useCatalogContext().client;
-}
-
-// src/react/use-query.ts
-
-function canonical(value) {
-  if (Array.isArray(value)) return value.map(canonical);
-  if (value === null || typeof value !== "object") return value;
-  const out = {};
-  for (const name of Object.keys(value).sort()) {
-    const item = value[name];
-    if (item !== void 0) out[name] = canonical(item);
-  }
-  return out;
-}
-function catalogQueryKey(route, params) {
-  return `${route}:${JSON.stringify(canonical(_nullishCoalesce(params, () => ( null))))}`;
-}
-var noop = () => {
-};
-var unsubscribe = () => noop;
-function useQuery(route, params, run, options = {}) {
-  const { store, customerKey } = useCatalogContext();
-  const key = run === null || options.enabled === false ? null : `${_nullishCoalesce(customerKey, () => ( ""))}\0${catalogQueryKey(route, params)}`;
-  const first = _react.useRef.call(void 0, { store, key });
-  const initial = first.current.store === store && first.current.key === key ? options.initialData : void 0;
-  const subscribe = _react.useCallback.call(void 0, 
-    (listener) => key === null ? unsubscribe() : store.subscribe(key, listener),
-    [store, key]
-  );
-  const stale = customerKey !== null;
-  const snap = _react.useSyncExternalStore.call(void 0, 
-    subscribe,
-    () => store.get(key, initial, stale),
-    () => store.getServer(key, initial, stale)
-  );
-  const staleMs = options.staleTimeMs;
-  _react.useEffect.call(void 0, () => {
-    if (key !== null && run !== null)
-      void store.fetch(key, run, staleMs === void 0 ? {} : { staleMs });
-  }, [store, key, staleMs]);
-  const refetch = _react.useCallback.call(void 0, 
-    () => key === null || run === null ? Promise.resolve() : store.fetch(key, run, { force: true }),
-    [store, key]
-  );
-  return {
-    data: snap.data,
-    error: snap.error,
-    isLoading: key !== null && snap.data === void 0 && snap.error === void 0,
-    isValidating: snap.isValidating,
-    refetch
-  };
-}
 
-// src/react/hooks.ts
 
-function defined(options) {
-  const out = {};
-  for (const name in options) {
-    if (options[name] !== void 0) out[name] = options[name];
-  }
-  return out;
-}
-function useProducts(query = {}, options) {
-  return useQuery(
-    "products",
-    query,
-    (client, call) => client.products.list(query, call),
-    options
-  );
-}
-function useProduct(handle, options = {}) {
-  const extra = defined({ include: options.include });
-  return useQuery(
-    "product",
-    { handle, ...extra },
-    handle === null ? null : (client, call) => client.products.get(handle, { ...call, ...extra }),
-    options
-  );
-}
-function useRelated(handle, options = {}) {
-  const extra = defined({ limit: options.limit });
-  return useQuery(
-    "related",
-    { handle, ...extra },
-    handle === null ? null : (client, call) => client.products.related(handle, { ...call, ...extra }),
-    options
-  );
-}
-function useDebounced(q, ms) {
-  const box = _react.useMemo.call(void 0, () => {
-    const listeners = /* @__PURE__ */ new Set();
-    let value = q;
-    return {
-      get: () => value,
-      set(next) {
-        value = next;
-        for (const listener of [...listeners]) listener();
-      },
-      subscribe(listener) {
-        listeners.add(listener);
-        return () => listeners.delete(listener);
-      }
-    };
-  }, []);
-  _react.useEffect.call(void 0, () => {
-    const timer = setTimeout(() => box.set(q), ms);
-    return () => clearTimeout(timer);
-  }, [box, 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, () => ( _chunk4ORXUW2Ucjs.SUGGEST_DEBOUNCE_MS)));
-  const extra = defined({ limit: options.limit });
-  const long = (value) => value.trim().length >= _chunk4ORXUW2Ucjs.SUGGEST_MIN_CHARS;
-  return useQuery(
-    "suggest",
-    { q: settled, ...extra },
-    long(q) && long(settled) ? (client, call) => client.suggest(settled, { ...call, ...extra }) : null,
-    options
-  );
-}
-function useCategories(options = {}) {
-  const extra = defined({ depth: options.depth });
-  return useQuery(
-    "categories",
-    extra,
-    (client, call) => client.categories.tree({ ...call, ...extra }),
-    options
-  );
-}
-function useCollection(handle, options) {
-  return useQuery(
-    "collection",
-    { handle },
-    handle === null ? null : (client, call) => client.collections.get(handle, call),
-    options
-  );
-}
-function useReviews(handle, options = {}) {
-  const extra = defined({
-    sort: options.sort,
-    rating: options.rating,
-    limit: options.limit,
-    cursor: options.cursor
-  });
-  return useQuery(
-    "reviews",
-    { handle, ...extra },
-    handle === null ? null : (client, call) => client.reviews.list(handle, { ...call, ...extra }),
-    options
-  );
-}
-function useConfig(options) {
-  return useQuery(
-    "config",
-    null,
-    (client, call) => client.config(call),
-    options
-  );
-}
-function useFilterValues(key, query = {}, options) {
-  return useQuery(
-    "filterValues",
-    { key, query },
-    key === null ? null : (client, call) => client.filters.values(key, query, call),
-    options
-  );
-}
+var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
+require('./chunk-ETV4XYOV.cjs');
 
 // src/react/use-cart.ts
-
+var _react = require('react');
 
 // src/react/mutation.ts
 function newKey() {
   const webCrypto = globalThis.crypto;
-  if (typeof _optionalChain([webCrypto, 'optionalAccess', _22 => _22.randomUUID]) === "function")
+  if (typeof _optionalChain([webCrypto, 'optionalAccess', _ => _.randomUUID]) === "function")
     return webCrypto.randomUUID();
   let out = "";
   for (let i = 0; i < 32; i += 1)
@@ -461,7 +40,7 @@ function newKey() {
   return out;
 }
 function refuse(message, path) {
-  return new (0, _chunk4ORXUW2Ucjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -474,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) => _chunk4ORXUW2Ucjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk4ORXUW2Ucjs.CatalogError)({
+var wrap = (error) => _chunk2YQNMBDIcjs.isCatalogError.call(void 0, error) ? error : new (0, _chunk2YQNMBDIcjs.CatalogError)({
   code: "CLIENT_ERROR",
   message: "The action failed.",
   statusCode: 0,
@@ -485,7 +64,7 @@ var wrap = (error) => _chunk4ORXUW2Ucjs.isCatalogError.call(void 0, error) ? err
 function checkPause(store) {
   const until = store.pausedUntil();
   if (until > 0) {
-    throw new (0, _chunk4ORXUW2Ucjs.RateLimitedError)({
+    throw new (0, _chunk2YQNMBDIcjs.RateLimitedError)({
       code: "RATE_LIMITED",
       message: "Too many requests.",
       statusCode: 429,
@@ -495,7 +74,7 @@ function checkPause(store) {
   }
 }
 function notePause(store, error) {
-  if (error instanceof _chunk4ORXUW2Ucjs.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) {
@@ -515,13 +94,14 @@ function createBox(initial) {
 }
 
 // src/react/use-cart.ts
-var EMPTY2 = {
+var EMPTY = {
   cart: null,
   sessionId: null,
   cartUrl: null,
   status: "idle",
   error: void 0,
-  pending: false
+  pending: false,
+  warnings: []
 };
 var ENDED = /* @__PURE__ */ new Set([
   "cart_session_expired",
@@ -529,11 +109,11 @@ var ENDED = /* @__PURE__ */ new Set([
   "cart_not_open",
   "cart_not_found"
 ]);
-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";
+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();
-  for (const line of _nullishCoalesce(_optionalChain([cart, 'optionalAccess', _25 => _25.lineItems]), () => ( []))) {
+  for (const line of _nullishCoalesce(_optionalChain([cart, 'optionalAccess', _4 => _4.lineItems]), () => ( []))) {
     if (line.referenceId !== null)
       items.set(
         line.referenceId,
@@ -542,7 +122,9 @@ function itemsOf(cart) {
   }
   return items;
 }
-var skuOf = (cart, lineId) => _nullishCoalesce(_optionalChain([cart, 'optionalAccess', _26 => _26.lineItems, 'optionalAccess', _27 => _27.find, 'call', _28 => _28((line) => line.id === lineId), 'optionalAccess', _29 => _29.referenceId]), () => ( null));
+var skuOf = (cart, lineId) => _nullishCoalesce(_optionalChain([cart, 'optionalAccess', _5 => _5.lineItems, 'optionalAccess', _6 => _6.find, 'call', _7 => _7((line) => line.id === lineId), 'optionalAccess', _8 => _8.referenceId]), () => ( null));
+var CART_REREAD_MS = 3e4;
+var TRANSPORT = Symbol.for("@usethrottle/catalog.transport");
 function createController(home) {
   var _a;
   const ctx = () => home.context;
@@ -551,16 +133,19 @@ function createController(home) {
     seen: void 0,
     moving: void 0,
     unremoved: false,
+    reads: /* @__PURE__ */ new Map(),
+    slots: /* @__PURE__ */ new Set(),
     abort: new AbortController(),
     writing: Promise.resolve(),
     tail: Promise.resolve()
   })));
   const retired = () => home.shared.home !== home;
-  const box = createBox(EMPTY2);
+  const box = createBox(EMPTY);
   let queued = 0;
   let loaded = false;
   let currency;
-  const reset = () => box.set({ ...EMPTY2, pending: queued > 0 });
+  let hinted;
+  const reset = () => box.set({ ...EMPTY, pending: queued > 0 });
   const session = (id) => {
     const { client, throttleBaseUrl } = ctx();
     return client.carts.session(
@@ -568,18 +153,112 @@ function createController(home) {
       throttleBaseUrl === void 0 ? void 0 : { throttleBaseUrl }
     );
   };
-  const fallbackUrl = (id) => `${(_nullishCoalesce(ctx().throttleCheckoutUrl, () => ( _chunk4ORXUW2Ucjs.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;
     return out;
   };
+  const resuming = () => ctx().customerCart !== void 0 && ctx().customerKey !== null;
+  const wanted = (options) => {
+    const transport = ctx().client[TRANSPORT];
+    return _optionalChain([(_nullishCoalesce(_nullishCoalesce(_nullishCoalesce(currency, () => ( _optionalChain([options, 'optionalAccess', _9 => _9.currency]))), () => ( hinted)), () => ( _optionalChain([transport, 'optionalAccess', _10 => _10.context, 'optionalCall', _11 => _11(), 'access', _12 => _12.currency])))), 'optionalAccess', _13 => _13.toUpperCase, 'call', _14 => _14()]);
+  };
+  async function soft(signal, step) {
+    try {
+      await step();
+    } catch (error) {
+      if (signal.aborted) throw error;
+    }
+  }
+  async function find(signal, wantedCurrency, strict = false) {
+    const source = ctx().customerCart;
+    if (source === void 0 || wantedCurrency === void 0) return null;
+    const asked = wantedCurrency.toUpperCase();
+    try {
+      const found = await live(signal, source.getOpenCart({ currency: asked }));
+      return found !== null && found.currency.toUpperCase() === asked ? found : null;
+    } catch (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;
+    const looked = _nullishCoalesce((_a2 = home.shared).looked, () => ( (_a2.looked = /* @__PURE__ */ new Set())));
+    const asked = wanted();
+    if (asked === void 0) return;
+    const key = `${ctx().customerKey}\0${asked}`;
+    if (looked.has(key)) return;
+    looked.add(key);
+    let found = null;
+    try {
+      found = await find(signal, asked);
+    } finally {
+      if (found === null) looked.delete(key);
+    }
+    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());
+    await save(signal, storage, id);
+    box.set({
+      sessionId: id,
+      cartUrl: fallbackUrl(id),
+      cart: answer.cart,
+      status: "ready",
+      error: void 0
+    });
+  }
+  async function supersede(signal, answer, storage) {
+    if (answer.cart.status !== "abandoned" || !resuming()) return;
+    const found = await find(signal, answer.cart.currency);
+    if (found !== null && found.cartId !== answer.cart.cartId)
+      await adopt(signal, found, storage);
+  }
+  async function read(signal, id) {
+    const answer = await live(signal, session(id).get({ signal }));
+    me.reads.set(id, Date.now());
+    box.set({ cart: answer.cart, status: "ready", error: void 0 });
+    return answer;
+  }
   async function endSession(signal, error, storage) {
     await live(signal, storage.remove());
     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 }))
@@ -588,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', _30 => _30.returnUrl]) !== void 0) body.returnUrl = urls.returnUrl;
-    if (_optionalChain([urls, 'optionalAccess', _31 => _31.cancelUrl]) !== void 0) body.cancelUrl = urls.cancelUrl;
-    if (_optionalChain([urls, 'optionalAccess', _32 => _32.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 {
@@ -603,33 +282,25 @@ 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 }));
-      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;
     }
     try {
       const snapshot = await live(signal, session(id).get({ signal }));
+      me.reads.set(id, Date.now());
       box.set({ cart: snapshot.cart, status: "ready", error: void 0 });
     } catch (error) {
       if (!signal.aborted) box.set({ status: "error" });
@@ -640,18 +311,52 @@ function createController(home) {
   async function mutate(signal, options, call, apply) {
     checkPause(ctx().store);
     const storage = ctx().cartStorage;
-    const id = box.get().sessionId;
     let met;
-    if (id !== null) {
+    const attempt = async (id2) => {
       try {
-        const answer = await live(signal, call(session(id), signal));
+        const answer = await live(signal, call(session(id2), signal));
         if (answer !== null)
           box.set({ cart: answer.cart, status: "ready", error: void 0 });
-        return void 0;
+        return true;
       } catch (error) {
         if (signal.aborted || !ended(error)) throw error;
         await endSession(signal, error, storage);
         met = error;
+        return false;
+      }
+    };
+    const stale = box.get().sessionId;
+    if (stale !== null && resuming() && Date.now() - (_nullishCoalesce(me.reads.get(stale), () => ( 0))) > CART_REREAD_MS) {
+      let answer;
+      try {
+        answer = await read(signal, stale);
+      } catch (error) {
+        if (signal.aborted) throw error;
+        if (ended(error)) {
+          await endSession(signal, error, storage);
+          met = error;
+        }
+      }
+      if (answer !== void 0) {
+        const seen = answer;
+        await soft(signal, () => supersede(signal, seen, storage));
+      }
+    }
+    const id = box.get().sessionId;
+    if (id !== null && await attempt(id)) return void 0;
+    if (resuming()) {
+      const found = await find(signal, wanted(options));
+      if (found !== null) {
+        let adopted = true;
+        await soft(signal, async () => {
+          try {
+            await adopt(signal, found, storage);
+          } catch (error) {
+            adopted = false;
+            throw error;
+          }
+        });
+        if (adopted && await attempt(found.sessionId)) return void 0;
       }
     }
     const cart = box.get().cart;
@@ -687,13 +392,16 @@ function createController(home) {
     me.tail = result.catch(() => void 0);
     return result;
   }
-  async function restore(signal, storage = ctx().cartStorage) {
+  async function restore(signal, storage = ctx().cartStorage, look = true) {
     const id = await live(signal, storage.get());
-    if (id === null || id === "") return;
+    if (id === null || id === "") {
+      if (look) await findOnce(signal, storage);
+      return;
+    }
     box.set({ sessionId: id, cartUrl: fallbackUrl(id), status: "loading" });
+    let answer;
     try {
-      const answer = await live(signal, session(id).get({ signal }));
-      box.set({ cart: answer.cart, status: "ready", error: void 0 });
+      answer = await read(signal, id);
     } catch (error) {
       if (signal.aborted) return;
       if (!ended(error)) {
@@ -707,7 +415,10 @@ function createController(home) {
         return;
       }
       reset();
+      if (look) await findOnce(signal, storage);
+      return;
     }
+    if (look) await soft(signal, () => supersede(signal, answer, storage));
   }
   function load() {
     if (loaded) return;
@@ -716,6 +427,17 @@ function createController(home) {
     const signal = me.abort.signal;
     me.tail = me.tail.then(() => me.unremoved ? void 0 : restore(signal)).catch(() => void 0);
   }
+  async function claimSettled(signal) {
+    const source = ctx().customerCart;
+    if (source === void 0) return false;
+    try {
+      await live(signal, source.whenClaimSettled());
+      return true;
+    } catch (error) {
+      if (signal.aborted) throw error;
+      return false;
+    }
+  }
   function follow(guest, fresh) {
     const signal = me.abort.signal;
     me.moving = guest;
@@ -727,18 +449,32 @@ function createController(home) {
     me.tail = me.tail.then(async () => {
       await me.writing;
       if (signal.aborted) return;
-      if (fresh && !me.unremoved) await restore(signal, guest);
+      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) return restore(signal);
+        if (box.get().cart === null && !me.unremoved) {
+          await claimSettled(signal);
+          return restore(signal);
+        }
         return;
       }
       const next = ctx().cartStorage;
       await write(next, id);
-      if (guest === next) return;
-      await live(signal, guest.remove());
-      if (await live(signal, next.get()) !== id) await write(next, id);
+      if (guest !== next) {
+        await live(signal, guest.remove());
+        if (await live(signal, next.get()) !== id) await write(next, id);
+      }
+      if (resuming() && await claimSettled(signal))
+        await soft(
+          signal,
+          async () => supersede(signal, await read(signal, id), next)
+        );
     }).catch((error) => {
       if (!signal.aborted) box.set({ error: wrap(error) });
     }).finally(() => {
@@ -758,6 +494,9 @@ function createController(home) {
     if (was === void 0 || was === null || was === key) return;
     me.abort.abort();
     me.abort = new AbortController();
+    me.reads.clear();
+    for (const key2 of _nullishCoalesce(home.shared.looked, () => ( [])))
+      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();
@@ -765,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(
       () => {
@@ -784,12 +529,16 @@ function createController(home) {
     box,
     /** The customer the cart belongs to (`undefined` before the first look). */
     owner: () => me.owner,
+    hint: (next) => {
+      hinted = next;
+    },
     identify,
     load,
     run,
     mutate,
     create,
     session,
+    wanted,
     async switchCurrency(signal, options, next) {
       checkPause(ctx().store);
       const storage = ctx().cartStorage;
@@ -806,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 = useCatalogContext();
+  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, 
@@ -836,6 +624,10 @@ function useCart(options = {}) {
     controller.box.get
   );
   const { customerKey } = context;
+  const hooked = options.currency;
+  _react.useEffect.call(void 0, () => {
+    controller.hint(hooked);
+  }, [controller, hooked]);
   _react.useEffect.call(void 0, () => {
     controller.identify(customerKey);
     controller.load();
@@ -873,8 +665,8 @@ function useCart(options = {}) {
       ),
       checkout: (input) => controller.run(async (signal) => {
         const { cartUrls } = home.context;
-        const returnUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _33 => _33.returnUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _34 => _34.returnUrl])));
-        const cancelUrl = _nullishCoalesce(_optionalChain([input, 'optionalAccess', _35 => _35.cancelUrl]), () => ( _optionalChain([cartUrls, 'optionalAccess', _36 => _36.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."
@@ -897,7 +689,7 @@ function useCart(options = {}) {
               { signal: callSignal }
             );
           } catch (error) {
-            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;
+            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;
@@ -917,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, _chunk4ORXUW2Ucjs.CatalogError)({
+          throw new (0, _chunk2YQNMBDIcjs.CatalogError)({
             code: "INVALID_RESPONSE",
             message: "Throttle answered a checkout URL that is not http or https.",
             statusCode: 200,
@@ -933,8 +725,10 @@ function useCart(options = {}) {
     };
   }, [controller, home, currency, locale]);
   const owner = controller.owner();
-  const view = owner !== void 0 && owner !== null && owner !== customerKey ? { ...EMPTY2, pending: state.pending } : state;
-  return { ...view, ...actions };
+  const view = owner !== void 0 && owner !== null && owner !== customerKey ? { ...EMPTY, pending: state.pending } : state;
+  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
@@ -945,7 +739,7 @@ var IDLE = {
   result: void 0
 };
 function useSubmitReview(handle) {
-  const { client, store, customerKey } = useCatalogContext();
+  const { client, store, customerKey } = _chunkGU63WFXIcjs.useCatalogContext.call(void 0, );
   const scope = _react.useMemo.call(void 0, 
     () => ({
       box: createBox(IDLE),
@@ -1015,4 +809,5 @@ function useSubmitReview(handle) {
 
 
 
-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;
+
+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;