@usethrottle/catalog 1.1.0 → 1.3.0

package/dist/react.js

@@ -1,454 +1,33 @@
 "use client";
 import {
-  CACHE_MAX_ENTRIES,
+  CatalogProvider,
+  catalogQueryKey,
+  createMemoryCartStorage,
+  useCatalog,
+  useCatalogContext,
+  useCategories,
+  useCollection,
+  useConfig,
+  useCustomerKey,
+  useFilterValues,
+  useProduct,
+  useProducts,
+  useRelated,
+  useReviews,
+  useSuggest
+} from "./chunk-CADIHOIR.js";
+import {
   CatalogError,
-  INDEXING_REVALIDATE_MS,
-  RATE_LIMIT_DEFAULT_RETRY_S,
   RateLimitedError,
   SDK_VERSION,
-  STALE_MS,
-  SUGGEST_DEBOUNCE_MS,
-  SUGGEST_MIN_CHARS,
   THROTTLE_CHECKOUT_URL,
+  formatMoney,
   isCatalogError
-} from "./chunk-JK2UY4CD.js";
+} from "./chunk-3DLH56OX.js";
 import "./chunk-PKBMQBKP.js";
 
-// src/react/provider.tsx
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useMemo,
-  useRef
-} from "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 = options.now ?? Date.now;
-  const entries = /* @__PURE__ */ new Map();
-  let until = 0;
-  let cause;
-  let pauseTimer;
-  const pausedError = () => new RateLimitedError({
-    code: cause?.code ?? "RATE_LIMITED",
-    message: cause?.message ?? "Too many requests.",
-    statusCode: 429,
-    source: cause?.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 < 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 = STALE_MS } = {}) {
-    const entry = touch(key);
-    entry.run = run;
-    if (entry.promise !== void 0 && !entry.flight?.signal.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 = box.result ?? {
-          notModified: false,
-          data: value,
-          etag: null
-        };
-        entry.etag = result.etag ?? void 0;
-        if (result.notModified) {
-          update(entry, {
-            error: void 0,
-            isValidating: false,
-            fetchedAt: now()
-          });
-          return;
-        }
-        if (result.data?.indexing === true) {
-          if (!entry.indexing) later(key, entry, 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 = (error.retryAfterSeconds ?? 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);
-      entry.flight?.abort();
-      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) entry.flight?.abort();
-        });
-      };
-    },
-    get: (key, initial, stale) => key === null ? EMPTY : (entries.get(key) ?? (initial === void 0 ? void 0 : touch(key, initial, stale)))?.snap ?? EMPTY,
-    getServer(key, initial, stale) {
-      if (key === null || initial === void 0) return EMPTY;
-      const entry = entries.get(key) ?? touch(key, initial, stale);
-      return 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
-import { jsx } from "react/jsx-runtime";
-function createMemoryCartStorage() {
-  let id = null;
-  return {
-    get: () => id,
-    set: (value) => {
-      id = value;
-    },
-    remove: () => {
-      id = null;
-    }
-  };
-}
-var CatalogContext = createContext(null);
-function useCatalogContext() {
-  const value = useContext(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 = props.customerKey ?? null;
-  const mounted = useRef(null);
-  const store = useMemo(() => {
-    const next = createStore(client);
-    next.pause(mounted.current?.pausedUntil() ?? 0);
-    return next;
-  }, [client, customerKey]);
-  useEffect(() => {
-    mounted.current = store;
-    return () => {
-      mounted.current = null;
-      void Promise.resolve().then(() => {
-        if (mounted.current !== store) store.dispose();
-      });
-    };
-  }, [store]);
-  const memory = useMemo(createMemoryCartStorage, []);
-  const cartStorage = rest.cartStorage ?? memory;
-  const shared = useRef({}).current;
-  const cart = useMemo(
-    () => ({ shared }),
-    [shared, client, rest.throttleBaseUrl]
-  );
-  const urls = rest.cartUrls;
-  const value = useMemo(
-    () => ({ ...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,
-      urls?.returnUrl,
-      urls?.cancelUrl,
-      urls?.storefrontUrl
-    ]
-  );
-  cart.context = value;
-  shared.home = cart;
-  return /* @__PURE__ */ jsx(CatalogContext.Provider, { value, children });
-}
-function useCatalog() {
-  return useCatalogContext().client;
-}
-
-// src/react/use-query.ts
-import { useCallback, useEffect as useEffect2, useRef as useRef2, useSyncExternalStore } from "react";
-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(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 : `${customerKey ?? ""}\0${catalogQueryKey(route, params)}`;
-  const first = useRef2({ store, key });
-  const initial = first.current.store === store && first.current.key === key ? options.initialData : void 0;
-  const subscribe = useCallback(
-    (listener) => key === null ? unsubscribe() : store.subscribe(key, listener),
-    [store, key]
-  );
-  const stale = customerKey !== null;
-  const snap = useSyncExternalStore(
-    subscribe,
-    () => store.get(key, initial, stale),
-    () => store.getServer(key, initial, stale)
-  );
-  const staleMs = options.staleTimeMs;
-  useEffect2(() => {
-    if (key !== null && run !== null)
-      void store.fetch(key, run, staleMs === void 0 ? {} : { staleMs });
-  }, [store, key, staleMs]);
-  const refetch = useCallback(
-    () => 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
-import { useEffect as useEffect3, useMemo as useMemo2, useSyncExternalStore as useSyncExternalStore2 } from "react";
-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 = useMemo2(() => {
-    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);
-      }
-    };
-  }, []);
-  useEffect3(() => {
-    const timer = setTimeout(() => box.set(q), ms);
-    return () => clearTimeout(timer);
-  }, [box, q, ms]);
-  return useSyncExternalStore2(box.subscribe, box.get, box.get);
-}
-function useSuggest(q, options = {}) {
-  const settled = useDebounced(q, options.debounceMs ?? SUGGEST_DEBOUNCE_MS);
-  const extra = defined({ limit: options.limit });
-  const long = (value) => value.trim().length >= 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
-  );
-}
-
 // src/react/use-cart.ts
-import { useEffect as useEffect4, useMemo as useMemo3, useSyncExternalStore as useSyncExternalStore3 } from "react";
+import { useEffect, useMemo, useSyncExternalStore } from "react";
 
 // src/react/mutation.ts
 function newKey() {
@@ -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",
@@ -543,6 +123,8 @@ function itemsOf(cart) {
   return items;
 }
 var skuOf = (cart, lineId) => cart?.lineItems?.find((line) => line.id === lineId)?.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(
@@ -574,12 +159,106 @@ function createController(home) {
     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 (currency ?? options?.currency ?? hinted ?? transport?.context?.().currency)?.toUpperCase();
+  };
+  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 = (_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 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());
+    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 }))
@@ -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() - (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 = 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) 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 home.shared.looked ?? [])
+      if (key2.startsWith(`${was}\0`)) home.shared.looked?.delete(key2);
     currency = void 0;
     loaded = true;
     reset();
@@ -765,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(
       () => {
@@ -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,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();
     }
@@ -830,18 +618,22 @@ function useCart(options = {}) {
   const context = useCatalogContext();
   const home = context.cart;
   const controller = home.current ?? (home.current = createController(home));
-  const state = useSyncExternalStore3(
+  const state = useSyncExternalStore(
     controller.box.subscribe,
     controller.box.get,
     controller.box.get
   );
   const { customerKey } = context;
-  useEffect4(() => {
+  const hooked = options.currency;
+  useEffect(() => {
+    controller.hint(hooked);
+  }, [controller, hooked]);
+  useEffect(() => {
     controller.identify(customerKey);
     controller.load();
   }, [controller, customerKey]);
   const { currency, locale } = options;
-  const actions = useMemo3(() => {
+  const actions = useMemo(() => {
     const opts = {};
     if (currency !== void 0) opts.currency = currency;
     if (locale !== void 0) opts.locale = locale;
@@ -933,12 +725,14 @@ 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 = view.cart?.currency ?? controller.wanted(options) ?? "";
+  const format = (minor) => formatMoney(minor, shownCurrency);
+  return { ...view, ...actions, format };
 }
 
 // src/react/use-submit-review.ts
-import { useCallback as useCallback2, useMemo as useMemo4, useSyncExternalStore as useSyncExternalStore4 } from "react";
+import { useCallback, useMemo as useMemo2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 var IDLE = {
   status: "idle",
   error: void 0,
@@ -946,7 +740,7 @@ var IDLE = {
 };
 function useSubmitReview(handle) {
   const { client, store, customerKey } = useCatalogContext();
-  const scope = useMemo4(
+  const scope = useMemo2(
     () => ({
       box: createBox(IDLE),
       flight: null,
@@ -956,8 +750,8 @@ function useSubmitReview(handle) {
     [handle, customerKey]
   );
   const { box } = scope;
-  const state = useSyncExternalStore4(box.subscribe, box.get, box.get);
-  const submit = useCallback2(
+  const state = useSyncExternalStore2(box.subscribe, box.get, box.get);
+  const submit = useCallback(
     (input) => {
       if (scope.flight !== null) return scope.flight;
       const fail = (error) => {
@@ -992,7 +786,7 @@ function useSubmitReview(handle) {
     },
     [client, store, scope, box, handle]
   );
-  const reset = useCallback2(() => {
+  const reset = useCallback(() => {
     scope.flight = scope.key = null;
     box.set(IDLE);
   }, [scope, box]);
@@ -1008,6 +802,7 @@ export {
   useCategories,
   useCollection,
   useConfig,
+  useCustomerKey,
   useFilterValues,
   useProduct,
   useProducts,