@shoppexio/storefront 1.0.102 → 1.0.104

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   customerWarrantyClaimSchema,
   customerWarrantyListSchema,
   storefrontStorageKey
-} from "./chunk-ESI3HWQF.js";
+} from "./chunk-BW2EO2WP.js";
 
 // ../sdk/src/core/errors.ts
 var CURRENCY_UNAVAILABLE_ERROR_CODE = "errors.storefront.currency_unavailable";
@@ -273,27 +273,9 @@ function buildEndpoint(template, params) {
 }
 
 // ../sdk/src/core/telemetry.ts
-var CONNECTION_ID_STORAGE_PREFIX = "presence_connection_";
 var CLIENT_ERROR_DEDUPE_WINDOW_MS = 15e3;
 var CLIENT_ERROR_TEXT_MAX_LENGTH = 500;
 var CLIENT_ERROR_URL_MAX_LENGTH = 2e3;
-function createPresenceConnectionId() {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  return `spx_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
-}
-function getStorefrontConnectionId(storeSlug) {
-  if (typeof window === "undefined") return null;
-  const storageKey2 = `${CONNECTION_ID_STORAGE_PREFIX}${storeSlug}`;
-  const existing = getItem(storageKey2);
-  if (existing && existing.trim()) {
-    return existing;
-  }
-  const nextId = createPresenceConnectionId();
-  setItem(storageKey2, nextId);
-  return nextId;
-}
 function getRecentClientErrorKey(payload) {
   return [
     payload.method,
@@ -323,7 +305,6 @@ async function reportStorefrontClientError(payload) {
   const body = JSON.stringify({
     event_type: "client_error",
     referer: document.referrer || void 0,
-    connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
     client_error: {
       source: payload.source ?? "sdk",
       phase: payload.phase ?? "request",
@@ -855,266 +836,747 @@ async function captureAffiliateFromUrl(param = "ref") {
   return holdsOtherCode ? held.code : code;
 }
 
-// ../sdk/src/utils/cart-line-id.ts
-function hashString(value) {
-  let hash = 2166136261;
-  for (let i = 0; i < value.length; i += 1) {
-    hash ^= value.charCodeAt(i);
-    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+// ../contracts/src/storefront-consent-choice.ts
+var COOKIE_CONSENT_VERSION = 1;
+var COOKIE_CONSENT_COOKIE = "shoppex_consent";
+var COOKIE_CONSENT_CHECKOUT_HASH_KEY = "shoppex_consent";
+var COOKIE_CONSENT_VALUE = new RegExp(`^v${COOKIE_CONSENT_VERSION}\\.f([01])\\.a([01])\\.m([01])$`);
+function parseCookieConsentValue(value) {
+  const match = value ? COOKIE_CONSENT_VALUE.exec(value) : null;
+  return match ? { functional: match[1] === "1", analytics: match[2] === "1", marketing: match[3] === "1" } : null;
+}
+
+// ../sdk/src/core/analytics-session.ts
+var ANALYTICS_SESSION_IDLE_MS = 30 * 60 * 1e3;
+var ANALYTICS_VISITS_WINDOW_MS = 30 * 24 * 60 * 60 * 1e3;
+var ANALYTICS_VISITS_MAX = 20;
+var MAX_ENGAGED_MS_PER_PAGE = 30 * 60 * 1e3;
+var UTM_STORAGE_PREFIX = "shoppex:utm:";
+var analyticsSessionKey = (storeSlug) => `analytics_session_${storeSlug}`;
+var analyticsVisitsKey = (storeSlug) => `analytics_visits_${storeSlug}`;
+function pageLanding() {
+  let r = "";
+  try {
+    r = document.referrer ? new URL(document.referrer).hostname : "";
+  } catch {
   }
-  return (hash >>> 0).toString(16);
+  const params = new URLSearchParams(window.location?.search ?? "");
+  const u = ["source", "medium", "campaign"].map((key) => params.get(`utm_${key}`)?.trim().toLowerCase() ?? "").join("|");
+  return { r: r === window.location?.hostname ? "" : r, u: u === "||" ? "" : u };
 }
-function normalizeAddons(addons) {
-  if (!addons?.length) return [];
-  return [...addons].map((addon) => ({ id: addon.id, quantity: addon.quantity ?? 1 })).sort((a, b) => a.id.localeCompare(b.id));
+function readAnalyticsConsent() {
+  if (typeof document === "undefined" || typeof navigator === "undefined") return "unknown";
+  const privacy = navigator;
+  if (privacy.globalPrivacyControl === true || privacy.doNotTrack === "1") return "declined";
+  const prefix = `${COOKIE_CONSENT_COOKIE}=`;
+  let raw;
+  try {
+    raw = document.cookie.split(/;\s*/).find((part) => part.startsWith(prefix))?.slice(prefix.length);
+  } catch {
+    return "unknown";
+  }
+  const choice = parseCookieConsentValue(raw ?? null);
+  if (!choice) return "unknown";
+  return choice.analytics ? "granted" : "declined";
 }
-function normalizeCustomFields(fields) {
-  if (!fields) return {};
-  const entries = Object.entries(fields).filter(([, value]) => typeof value === "string").sort(([a], [b]) => a.localeCompare(b));
-  return Object.fromEntries(entries);
+function readVisits(storeSlug, now) {
+  const stored = getItem(analyticsVisitsKey(storeSlug));
+  if (!Array.isArray(stored)) return [];
+  return stored.filter((visit) => typeof visit?.id === "string" && typeof visit.at === "number" && now - visit.at < ANALYTICS_VISITS_WINDOW_MS);
 }
-function computeCartLineId(input) {
-  const payload = {
-    product_id: input.product_id,
-    variant_id: input.variant_id,
-    price_variant_id: input.price_variant_id ?? null,
-    addons: normalizeAddons(input.addons),
-    custom_fields: normalizeCustomFields(input.custom_fields),
-    unit_price: typeof input.price_data?.unit_price === "number" && Number.isFinite(input.price_data.unit_price) ? input.price_data.unit_price : null,
-    pay_what_you_want_price: typeof input.pay_what_you_want_price === "number" && Number.isFinite(input.pay_what_you_want_price) ? input.pay_what_you_want_price : null
-  };
-  return hashString(JSON.stringify(payload));
+function forgetAnalyticsData(storeSlug) {
+  removeItem(analyticsSessionKey(storeSlug), "sessionStorage");
+  removeItem(analyticsVisitsKey(storeSlug));
 }
-function ensureCartLineId(item) {
-  if (typeof item.line_id === "string" && item.line_id.trim()) {
-    return item;
+function analyticsSessionId(storeSlug, options, now = Date.now()) {
+  removeItem(`presence_connection_${storeSlug}`);
+  if (readAnalyticsConsent() !== "granted") {
+    forgetAnalyticsData(storeSlug);
+    return null;
   }
-  return { ...item, line_id: computeCartLineId(item) };
+  const stored = getItem(analyticsSessionKey(storeSlug), "sessionStorage");
+  const live = stored && typeof stored.id === "string" && typeof stored.at === "number" && now - stored.at < ANALYTICS_SESSION_IDLE_MS ? stored.id : null;
+  if (!options.touch) return live;
+  const landing = pageLanding();
+  const newLanding = landing.r && landing.r !== stored?.r || landing.u && landing.u !== stored?.u;
+  if (live && !newLanding) {
+    setItem(analyticsSessionKey(storeSlug), { ...stored, id: live, at: now }, "sessionStorage");
+    return live;
+  }
+  if (typeof crypto === "undefined" || typeof crypto.randomUUID !== "function") return null;
+  if (landing.r) {
+    try {
+      globalThis.localStorage.removeItem(storefrontStorageKey(`${UTM_STORAGE_PREFIX}${storeSlug}`));
+    } catch {
+    }
+  }
+  const id = crypto.randomUUID();
+  setItem(analyticsSessionKey(storeSlug), { id, at: now, ...landing }, "sessionStorage");
+  setItem(
+    analyticsVisitsKey(storeSlug),
+    [{ id, at: now }, ...readVisits(storeSlug, now)].slice(0, ANALYTICS_VISITS_MAX)
+  );
+  return id;
+}
+function checkoutAttribution(storeSlug, now = Date.now()) {
+  const consent = readAnalyticsConsent();
+  if (consent === "declined") {
+    forgetAnalyticsData(storeSlug);
+    return { declined: true };
+  }
+  if (consent === "unknown") return void 0;
+  const sessionIds = readVisits(storeSlug, now).map((visit) => visit.id);
+  return sessionIds.length > 0 ? { session_ids: sessionIds } : void 0;
+}
+var engagedMs = 0;
+var visibleSince = null;
+var clockInstalled = false;
+var pageViewed = false;
+var pageSession = null;
+function markPageViewed(sessionId) {
+  pageViewed = true;
+  pageSession = sessionId;
+}
+function currentPageSession() {
+  return pageSession;
+}
+function isPageViewed() {
+  return pageViewed;
+}
+function settleClock(now) {
+  if (visibleSince !== null) {
+    engagedMs += now - visibleSince;
+    visibleSince = document.visibilityState === "visible" ? now : null;
+  }
+}
+var consentListenerInstalled = false;
+function onAnalyticsConsent(onYes) {
+  if (consentListenerInstalled || typeof window === "undefined") return;
+  consentListenerInstalled = true;
+  window.addEventListener("shoppex:consent", () => {
+    if (readAnalyticsConsent() === "granted") onYes();
+  });
 }
-
-// ../contracts/src/catalog-unit-price.ts
-var CATALOG_UNIT_PRICE_DECIMAL_PLACES = 3;
-var PAYABLE_AMOUNT_DECIMAL_PLACES = 2;
-var CATALOG_UNIT_PRICE_FORMAT_OPTIONS = {
-  maximumFractionDigits: CATALOG_UNIT_PRICE_DECIMAL_PLACES
-};
-function roundPayableAmount(value) {
-  if (!Number.isFinite(value)) return value;
-  const sign = value < 0 ? -1 : 1;
-  const shifted = shiftDecimal(Math.abs(value), PAYABLE_AMOUNT_DECIMAL_PLACES);
-  const rounded = Math.round(shifted);
-  if (rounded === 0) return 0;
-  return sign * shiftDecimal(rounded, -PAYABLE_AMOUNT_DECIMAL_PLACES);
+function installEngagedClock(onHidden) {
+  if (clockInstalled || typeof document === "undefined") return;
+  clockInstalled = true;
+  visibleSince = document.visibilityState === "visible" ? Date.now() : null;
+  document.addEventListener("visibilitychange", () => {
+    const now = Date.now();
+    if (document.visibilityState === "visible") {
+      visibleSince ?? (visibleSince = now);
+      return;
+    }
+    settleClock(now);
+    visibleSince = null;
+    onHidden();
+  });
+  window.addEventListener("pagehide", () => {
+    settleClock(Date.now());
+    visibleSince = null;
+    onHidden();
+  });
+  window.addEventListener("pageshow", (event) => {
+    if (event.persisted && document.visibilityState === "visible") visibleSince = Date.now();
+  });
 }
-function shiftDecimal(value, places) {
-  const [coefficient, currentExponent = "0"] = String(value).split("e");
-  return Number(`${coefficient}e${Number(currentExponent) + places}`);
+function takeEngagedMs(now = Date.now()) {
+  settleClock(now);
+  const taken = Math.min(Math.max(0, Math.round(engagedMs)), MAX_ENGAGED_MS_PER_PAGE);
+  engagedMs = 0;
+  return taken;
 }
 
-// ../sdk/src/modules/cart.ts
-var STORAGE_KEYS = {
-  cart: "cart",
-  cartBackup: "cart_backup",
-  meta: "cart_meta",
-  metaBackup: "cart_backup_meta",
-  coupon: "cart_coupon",
-  couponBackup: "cart_coupon_backup"
-};
-function getStorageKey(type) {
-  return `${STORAGE_KEYS[type]}_${getConfig().storeSlug}`;
-}
-function cartStorageArea() {
-  return getConfig().preview ? "sessionStorage" : "localStorage";
+// ../sdk/src/core/attribution.ts
+var TTL_MS = 30 * 24 * 60 * 60 * 1e3;
+var UTM_KEYS = ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+var MAX_VALUE_LENGTH = 255;
+function readFromUrl(search) {
+  let params;
+  try {
+    params = new URLSearchParams(search);
+  } catch {
+    return {};
+  }
+  const utm = {};
+  for (const key of UTM_KEYS) {
+    const value = params.get(key)?.trim();
+    if (value) {
+      utm[key] = value.slice(0, MAX_VALUE_LENGTH);
+    }
+  }
+  return utm;
 }
-function readCartStorage(type) {
-  return getItem(getStorageKey(type), cartStorageArea());
+function storageKey(storeSlug) {
+  return `${UTM_STORAGE_PREFIX}${storeSlug}`;
 }
-function writeCartStorage(type, value) {
-  setItem(getStorageKey(type), value, cartStorageArea());
+function readStored(storeSlug) {
+  try {
+    const raw = window.localStorage.getItem(storefrontStorageKey(storageKey(storeSlug)));
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed.at !== "number" || typeof parsed.utm !== "object") return {};
+    if (Date.now() - parsed.at > TTL_MS) {
+      window.localStorage.removeItem(storefrontStorageKey(storageKey(storeSlug)));
+      return {};
+    }
+    const utm = {};
+    for (const key of UTM_KEYS) {
+      const value = parsed.utm?.[key];
+      if (typeof value === "string" && value.length > 0) {
+        utm[key] = value.slice(0, MAX_VALUE_LENGTH);
+      }
+    }
+    return utm;
+  } catch {
+    return {};
+  }
 }
-function removeCartStorage(type) {
-  removeItem(getStorageKey(type), cartStorageArea());
+function writeStored(storeSlug, utm) {
+  try {
+    const payload = { utm, at: Date.now() };
+    window.localStorage.setItem(storefrontStorageKey(storageKey(storeSlug)), JSON.stringify(payload));
+  } catch {
+  }
 }
-function hashString2(value) {
-  let hash = 2166136261;
-  for (let i = 0; i < value.length; i += 1) {
-    hash ^= value.charCodeAt(i);
-    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+function resolveUtmParameters(storeSlug) {
+  if (typeof window === "undefined" || typeof window.location === "undefined") {
+    return void 0;
   }
-  return (hash >>> 0).toString(16);
+  const fromUrl = readFromUrl(window.location.search);
+  if (readAnalyticsConsent() !== "granted") {
+    try {
+      window.localStorage.removeItem(storefrontStorageKey(storageKey(storeSlug)));
+    } catch {
+    }
+    return Object.keys(fromUrl).length > 0 ? fromUrl : void 0;
+  }
+  if (Object.keys(fromUrl).length > 0) {
+    writeStored(storeSlug, fromUrl);
+    return fromUrl;
+  }
+  const stored = readStored(storeSlug);
+  return Object.keys(stored).length > 0 ? stored : void 0;
 }
-function computeChecksum(cart) {
-  return hashString2(JSON.stringify(cart));
+
+// ../sdk/src/core/page-path.ts
+var MAX_PATH_LENGTH = 256;
+function resolveStorefrontPagePath() {
+  if (typeof window === "undefined") return void 0;
+  let pathname;
+  try {
+    const location = window.location;
+    pathname = typeof location?.pathname === "string" && location.pathname ? location.pathname : new URL(String(location?.href ?? "")).pathname;
+  } catch {
+    return void 0;
+  }
+  if (!pathname || !pathname.startsWith("/")) return void 0;
+  return pathname.slice(0, MAX_PATH_LENGTH);
 }
-function normalizeQuantity(value) {
-  if (!Number.isFinite(value)) {
-    throw new CartError("quantity must be a finite number");
+
+// ../sdk/src/core/page-tracker.ts
+var PLATFORM_PAGE_TRACKER_FLAG = "__shoppexPageTracker";
+function isPlatformPageTrackerActive() {
+  if (typeof window === "undefined") return false;
+  try {
+    return Boolean(window[PLATFORM_PAGE_TRACKER_FLAG]);
+  } catch {
+    return false;
   }
-  return Math.floor(value);
 }
-function normalizeCouponCode(value) {
-  const normalized = value?.trim().toUpperCase();
-  return normalized ? normalized : null;
+
+// ../sdk/src/modules/analytics.ts
+var CONFIRMED_CART_STORAGE_PREFIX = "reported_cart_";
+var IN_FLIGHT_CART_STORAGE_PREFIX = "reporting_cart_";
+var CART_SEQUENCE_STORAGE_PREFIX = "presence_cart_seq_";
+var CART_CLAIM_TTL_MS = 1e4;
+function confirmedCartKey(storeSlug) {
+  return `${CONFIRMED_CART_STORAGE_PREFIX}${storeSlug}`;
 }
-function getStoredCartCode() {
-  const raw = readCartStorage("coupon");
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+function inFlightCartKey(storeSlug) {
+  return `${IN_FLIGHT_CART_STORAGE_PREFIX}${storeSlug}`;
+}
+function cartSequenceKey(storeSlug) {
+  return `${CART_SEQUENCE_STORAGE_PREFIX}${storeSlug}`;
+}
+function cartSnapshot(cartValue, itemCount) {
+  return `${cartValue ?? ""}|${itemCount ?? ""}`;
+}
+function isCartSequence(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+var CART_SEQUENCE_SCOPE_MAX_LENGTH = 64;
+function readCartCounter(storeSlug) {
+  const counter = getItem(cartSequenceKey(storeSlug));
+  if (!counter || typeof counter.scope !== "string" || counter.scope.length === 0 || counter.scope.length > CART_SEQUENCE_SCOPE_MAX_LENGTH || !isCartSequence(counter.seq)) {
     return null;
   }
-  const record = raw;
-  const code = typeof record.code === "string" ? normalizeCouponCode(record.code) : null;
-  const source = record.source === "COUPON" || record.source === "AFFILIATE" ? record.source : null;
-  return code && source ? { code, source } : null;
+  return counter;
 }
-function normalizeCartItems(value) {
-  if (!Array.isArray(value)) return [];
-  const normalized = [];
-  for (const entry of value) {
-    if (!entry || typeof entry !== "object") continue;
-    const record = entry;
-    const productId = typeof record.product_id === "string" ? record.product_id.trim() : "";
-    const variantId = typeof record.variant_id === "string" ? record.variant_id.trim() : "";
-    const quantity = Number(record.quantity);
-    if (!productId || !variantId || !Number.isFinite(quantity) || quantity < 1) {
-      continue;
-    }
-    const item = {
-      line_id: "",
-      product_id: productId,
-      variant_id: variantId,
-      quantity: Math.floor(quantity)
-    };
-    if (typeof record.price_variant_id === "string") {
-      item.price_variant_id = record.price_variant_id;
-    }
-    if (record.price_data && typeof record.price_data === "object") {
-      const priceData = record.price_data;
-      if (typeof priceData.unit_price === "number" && Number.isFinite(priceData.unit_price)) {
-        item.price_data = { unit_price: priceData.unit_price };
-      }
-    }
-    if (typeof record.pay_what_you_want_price === "number" && Number.isFinite(record.pay_what_you_want_price)) {
-      item.pay_what_you_want_price = record.pay_what_you_want_price;
-    }
-    if (Array.isArray(record.addons)) {
-      item.addons = record.addons;
-    }
-    if (record.custom_fields && typeof record.custom_fields === "object" && !Array.isArray(record.custom_fields)) {
-      item.custom_fields = record.custom_fields;
-    }
-    if (typeof record.title === "string") {
-      item.title = record.title;
-    }
-    if (typeof record.variant_title === "string") {
-      item.variant_title = record.variant_title;
-    }
-    if (typeof record.image_url === "string") {
-      item.image_url = record.image_url;
-    }
-    if (Array.isArray(record.addon_labels)) {
-      item.addon_labels = record.addon_labels.filter((label) => typeof label === "string");
-    }
-    if (typeof record.max_quantity === "number" && Number.isFinite(record.max_quantity)) {
-      item.max_quantity = record.max_quantity;
-    }
-    if (typeof record.min_quantity === "number" && Number.isFinite(record.min_quantity)) {
-      item.min_quantity = record.min_quantity;
-    }
-    clampQuantityToBounds(item);
-    const storedLineId = typeof record.line_id === "string" ? record.line_id.trim() : "";
-    item.line_id = storedLineId || computeCartLineId(item);
-    normalized.push(ensureCartLineId(item));
-  }
-  return normalized;
+var lastCartOrder = null;
+function nextCartOrder(storeSlug) {
+  const stored = readCartCounter(storeSlug);
+  const scope = stored?.scope ?? lastCartOrder?.scope ?? createClaimToken();
+  const floor = Math.max(stored?.seq ?? 0, lastCartOrder?.scope === scope ? lastCartOrder.seq : 0);
+  const order2 = { scope, seq: Math.max(Date.now(), floor + 1) };
+  lastCartOrder = order2;
+  setItem(cartSequenceKey(storeSlug), order2);
+  return order2;
 }
-function getCartMetadata() {
-  return readCartStorage("meta");
+function cartSequenceLocks() {
+  if (typeof navigator === "undefined") return null;
+  const locks = navigator.locks;
+  return locks && typeof locks.request === "function" ? locks : null;
 }
-function getCartCoupon() {
-  return getStoredCartCode()?.code ?? null;
+function reserveCartOrder(storeSlug) {
+  const take = () => nextCartOrder(storeSlug);
+  const locks = cartSequenceLocks();
+  if (!locks) return Promise.resolve(take());
+  return locks.request(cartSequenceKey(storeSlug), take).catch(take);
 }
-function getCartCouponSource() {
-  return getStoredCartCode()?.source ?? null;
+function readConfirmedCart(storeSlug) {
+  const confirmed = getItem(confirmedCartKey(storeSlug));
+  if (!confirmed || typeof confirmed.snapshot !== "string" || !isCartSequence(confirmed.seq)) return null;
+  return confirmed;
 }
-function setCartCoupon(coupon, source = "COUPON") {
-  const normalizedCoupon = normalizeCouponCode(coupon);
-  if (!normalizedCoupon) {
-    removeCartStorage("coupon");
+function readInFlightCart(storeSlug) {
+  const claim = getItem(inFlightCartKey(storeSlug));
+  if (!claim || typeof claim.snapshot !== "string" || !isCartSequence(claim.seq) || typeof claim.token !== "string" || typeof claim.at !== "number") {
     return null;
   }
-  writeCartStorage("coupon", { code: normalizedCoupon, source });
-  return normalizedCoupon;
+  return claim;
 }
-function clearCartCoupon() {
-  removeCartStorage("coupon");
+function isCartReportedOrInFlight(storeSlug, snapshot) {
+  const confirmed = readConfirmedCart(storeSlug);
+  const claim = readInFlightCart(storeSlug);
+  const liveClaim = claim && Date.now() - claim.at < CART_CLAIM_TTL_MS ? claim : null;
+  const expected = liveClaim && (!confirmed || liveClaim.seq > confirmed.seq) ? liveClaim : confirmed;
+  return expected?.snapshot === snapshot;
 }
-function writeCart(cart) {
-  const normalizedCart = normalizeCartItems(cart);
-  writeCartStorage("cart", normalizedCart);
-  const now = Date.now();
-  const previous = getCartMetadata();
-  const nextMeta = {
-    created_at: previous?.created_at ?? now,
-    last_modified: now,
-    version: (previous?.version ?? 0) + 1,
-    checksum: computeChecksum(normalizedCart)
+function createClaimToken() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+  return `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`;
+}
+function claimCartReport(storeSlug, seq, cartValue, itemCount) {
+  const snapshot = cartSnapshot(cartValue, itemCount);
+  const token = createClaimToken();
+  setItem(inFlightCartKey(storeSlug), { snapshot, seq, token, at: Date.now() });
+  return (delivered) => {
+    if (delivered) {
+      const confirmed = readConfirmedCart(storeSlug);
+      if (!confirmed || seq > confirmed.seq) setItem(confirmedCartKey(storeSlug), { snapshot, seq });
+    }
+    if (readInFlightCart(storeSlug)?.token === token) removeItem(inFlightCartKey(storeSlug));
   };
-  writeCartStorage("meta", nextMeta);
-  if (normalizedCart.length === 0) {
-    clearCartCoupon();
+}
+var cartSendTail = Promise.resolve();
+var latestCartRequest = 0;
+function enqueueCartSend(send) {
+  const request2 = ++latestCartRequest;
+  const run = () => send(() => request2 === latestCartRequest);
+  cartSendTail = cartSendTail.then(run, run);
+  return cartSendTail;
+}
+async function postPing(body) {
+  const config = getConfig();
+  const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
+  let timer;
+  const timedOut = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      resolve(false);
+    }, CART_CLAIM_TTL_MS);
+  });
+  try {
+    const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
+      storeSlug: config.storeSlug
+    });
+    const delivered = fetch(`${config.apiBaseUrl}${endpoint}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: controller?.signal
+    }).then((response) => response.ok);
+    return await Promise.race([delivered, timedOut]);
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
   }
 }
-function setCartWithMetadata(cart, metadata) {
-  const normalizedCart = normalizeCartItems(cart);
-  writeCartStorage("cart", normalizedCart);
-  const now = Date.now();
-  const base = metadata ?? getCartMetadata();
-  const nextMeta = {
-    created_at: base?.created_at ?? now,
-    last_modified: now,
-    version: base?.version ?? 1,
-    checksum: computeChecksum(normalizedCart)
+async function trackPageView(cartValue, itemCount) {
+  if (!isInitialized()) return;
+  if (typeof document === "undefined") return;
+  const config = getConfig();
+  const carriesCart = cartValue !== void 0 || itemCount !== void 0;
+  const reservedOrder = carriesCart ? reserveCartOrder(config.storeSlug) : void 0;
+  if (isPlatformPageTrackerActive()) {
+    if (reservedOrder) await enqueueCartSend(async () => sendCartActivity(await reservedOrder, cartValue, itemCount));
+    return;
+  }
+  const sendView = async () => {
+    const order2 = reservedOrder ? await reservedOrder : void 0;
+    const settle = order2 ? claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount) : void 0;
+    const sessionId = analyticsSessionId(config.storeSlug, { touch: true });
+    const previousSession = currentPageSession();
+    if (previousSession && previousSession !== sessionId) reportPageLeave();
+    markPageViewed(sessionId);
+    if (sessionId) installEngagedClock(reportPageLeave);
+    onAnalyticsConsent(startSessionOnConsent);
+    const delivered = await postPing({
+      referer: document.referrer || void 0,
+      cart_value: cartValue,
+      item_count: itemCount,
+      cart_seq: order2?.seq,
+      cart_seq_scope: order2?.scope,
+      session_id: sessionId ?? void 0,
+      // Time on screen of the page before this one (client-side navigation).
+      engaged_ms: sessionId ? takeEngagedMs() || void 0 : void 0,
+      path: resolveStorefrontPagePath(),
+      utm: resolveUtmParameters(config.storeSlug)
+    });
+    settle?.(delivered);
   };
-  writeCartStorage("meta", nextMeta);
+  await (reservedOrder ? enqueueCartSend(sendView) : sendView());
 }
-function getCart() {
-  const raw = readCartStorage("cart");
-  return normalizeCartItems(raw);
+async function trackCartActivity(cartValue, itemCount) {
+  if (!isInitialized()) return;
+  if (typeof document === "undefined") return;
+  const snapshot = cartSnapshot(cartValue, itemCount);
+  const reservedOrder = reserveCartOrder(getConfig().storeSlug);
+  await enqueueCartSend(async (isLatest) => {
+    const order2 = await reservedOrder;
+    if (!isLatest() || isCartReportedOrInFlight(getConfig().storeSlug, snapshot)) return;
+    await sendCartActivity(order2, cartValue, itemCount);
+  });
 }
-function resolveCartLineId(productId, variantId, cart = getCart()) {
-  const matches = cart.filter(
-    (item) => item.product_id === productId && item.variant_id === variantId
-  );
-  if (matches.length === 0) {
-    throw new CartError(`No cart line found for ${productId}/${variantId}`);
-  }
-  return matches[0].line_id;
+async function sendCartActivity(order2, cartValue, itemCount) {
+  const config = getConfig();
+  const settle = claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount);
+  const delivered = await postPing({
+    event_type: "presence",
+    cart_value: cartValue,
+    item_count: itemCount,
+    cart_seq: order2.seq,
+    cart_seq_scope: order2.scope,
+    // A cart marks the analytics session as one that did not bounce.
+    session_id: analyticsSessionId(config.storeSlug, { touch: false }) ?? void 0,
+    path: resolveStorefrontPagePath()
+  });
+  settle(delivered);
 }
-function getCartItemCount() {
-  const cart = getCart();
-  return cart.reduce((sum, item) => sum + item.quantity, 0);
+async function trackProductView(productId) {
+  if (!isInitialized() || typeof document === "undefined" || !productId) return;
+  await sendVisitEvent({ event_type: "product_view", product_id: productId });
 }
-function addToCart(productId, variantId, quantity = 1, options) {
-  if (!productId || !variantId) {
-    throw new CartError("product_id and variant_id are required");
+async function trackCartAdd(productId, variantId, quantity) {
+  if (!isInitialized() || typeof document === "undefined" || quantity < 1) return;
+  await sendVisitEvent({ event_type: "cart_add", product_id: productId, variant_id: variantId, quantity });
+}
+async function sendVisitEvent(body) {
+  const config = getConfig();
+  if (config.preview) return;
+  await postPing({
+    ...body,
+    referer: document.referrer || void 0,
+    session_id: analyticsSessionId(config.storeSlug, { touch: true }) ?? void 0,
+    path: resolveStorefrontPagePath(),
+    utm: resolveUtmParameters(config.storeSlug)
+  });
+}
+function startSessionOnConsent() {
+  const config = getConfig();
+  if (!isPageViewed() || analyticsSessionId(config.storeSlug, { touch: false })) return;
+  const sessionId = analyticsSessionId(config.storeSlug, { touch: true });
+  if (!sessionId) return;
+  markPageViewed(sessionId);
+  installEngagedClock(reportPageLeave);
+  void postPing({
+    event_type: "session_start",
+    referer: document.referrer || void 0,
+    session_id: sessionId,
+    path: resolveStorefrontPagePath(),
+    utm: resolveUtmParameters(config.storeSlug)
+  });
+}
+function reportPageLeave() {
+  const config = getConfig();
+  const sessionId = currentPageSession();
+  const engagedMs2 = takeEngagedMs();
+  if (!sessionId || engagedMs2 === 0 || readAnalyticsConsent() !== "granted") return;
+  try {
+    const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", { storeSlug: config.storeSlug });
+    void fetch(`${config.apiBaseUrl}${endpoint}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ event_type: "page_leave", session_id: sessionId, engaged_ms: engagedMs2 }),
+      keepalive: true
+    }).catch(() => {
+    });
+  } catch {
   }
-  const normalizedQuantity = normalizeQuantity(quantity);
-  if (normalizedQuantity < 1) {
-    throw new CartError("quantity must be at least 1");
+}
+
+// ../sdk/src/utils/cart-line-id.ts
+function hashString(value) {
+  let hash = 2166136261;
+  for (let i = 0; i < value.length; i += 1) {
+    hash ^= value.charCodeAt(i);
+    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
   }
-  const cart = getCart();
-  const lineId = computeCartLineId({
-    product_id: productId,
-    variant_id: variantId,
-    addons: options?.addons,
-    custom_fields: options?.custom_fields,
-    price_variant_id: options?.price_variant_id,
-    price_data: options?.price_data,
-    pay_what_you_want_price: options?.pay_what_you_want_price
-  });
-  const existingIndex = cart.findIndex((item) => item.line_id === lineId);
-  const quantityBeforeAdd = existingIndex >= 0 ? cart[existingIndex].quantity : 0;
-  if (existingIndex >= 0) {
+  return (hash >>> 0).toString(16);
+}
+function normalizeAddons(addons) {
+  if (!addons?.length) return [];
+  return [...addons].map((addon) => ({ id: addon.id, quantity: addon.quantity ?? 1 })).sort((a, b) => a.id.localeCompare(b.id));
+}
+function normalizeCustomFields(fields) {
+  if (!fields) return {};
+  const entries = Object.entries(fields).filter(([, value]) => typeof value === "string").sort(([a], [b]) => a.localeCompare(b));
+  return Object.fromEntries(entries);
+}
+function computeCartLineId(input) {
+  const payload = {
+    product_id: input.product_id,
+    variant_id: input.variant_id,
+    price_variant_id: input.price_variant_id ?? null,
+    addons: normalizeAddons(input.addons),
+    custom_fields: normalizeCustomFields(input.custom_fields),
+    unit_price: typeof input.price_data?.unit_price === "number" && Number.isFinite(input.price_data.unit_price) ? input.price_data.unit_price : null,
+    pay_what_you_want_price: typeof input.pay_what_you_want_price === "number" && Number.isFinite(input.pay_what_you_want_price) ? input.pay_what_you_want_price : null
+  };
+  return hashString(JSON.stringify(payload));
+}
+function ensureCartLineId(item) {
+  if (typeof item.line_id === "string" && item.line_id.trim()) {
+    return item;
+  }
+  return { ...item, line_id: computeCartLineId(item) };
+}
+
+// ../contracts/src/catalog-unit-price.ts
+var CATALOG_UNIT_PRICE_DECIMAL_PLACES = 3;
+var PAYABLE_AMOUNT_DECIMAL_PLACES = 2;
+var CATALOG_UNIT_PRICE_FORMAT_OPTIONS = {
+  maximumFractionDigits: CATALOG_UNIT_PRICE_DECIMAL_PLACES
+};
+function roundPayableAmount(value) {
+  if (!Number.isFinite(value)) return value;
+  const sign = value < 0 ? -1 : 1;
+  const shifted = shiftDecimal(Math.abs(value), PAYABLE_AMOUNT_DECIMAL_PLACES);
+  const rounded = Math.round(shifted);
+  if (rounded === 0) return 0;
+  return sign * shiftDecimal(rounded, -PAYABLE_AMOUNT_DECIMAL_PLACES);
+}
+function shiftDecimal(value, places) {
+  const [coefficient, currentExponent = "0"] = String(value).split("e");
+  return Number(`${coefficient}e${Number(currentExponent) + places}`);
+}
+
+// ../sdk/src/modules/cart.ts
+var STORAGE_KEYS = {
+  cart: "cart",
+  cartBackup: "cart_backup",
+  meta: "cart_meta",
+  metaBackup: "cart_backup_meta",
+  coupon: "cart_coupon",
+  couponBackup: "cart_coupon_backup"
+};
+function getStorageKey(type) {
+  return `${STORAGE_KEYS[type]}_${getConfig().storeSlug}`;
+}
+function cartStorageArea() {
+  return getConfig().preview ? "sessionStorage" : "localStorage";
+}
+function readCartStorage(type) {
+  return getItem(getStorageKey(type), cartStorageArea());
+}
+function writeCartStorage(type, value) {
+  setItem(getStorageKey(type), value, cartStorageArea());
+}
+function removeCartStorage(type) {
+  removeItem(getStorageKey(type), cartStorageArea());
+}
+function hashString2(value) {
+  let hash = 2166136261;
+  for (let i = 0; i < value.length; i += 1) {
+    hash ^= value.charCodeAt(i);
+    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+  }
+  return (hash >>> 0).toString(16);
+}
+function computeChecksum(cart) {
+  return hashString2(JSON.stringify(cart));
+}
+function normalizeQuantity(value) {
+  if (!Number.isFinite(value)) {
+    throw new CartError("quantity must be a finite number");
+  }
+  return Math.floor(value);
+}
+function normalizeCouponCode(value) {
+  const normalized = value?.trim().toUpperCase();
+  return normalized ? normalized : null;
+}
+function getStoredCartCode() {
+  const raw = readCartStorage("coupon");
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return null;
+  }
+  const record = raw;
+  const code = typeof record.code === "string" ? normalizeCouponCode(record.code) : null;
+  const source = record.source === "COUPON" || record.source === "AFFILIATE" ? record.source : null;
+  return code && source ? { code, source } : null;
+}
+function normalizeCartItems(value) {
+  if (!Array.isArray(value)) return [];
+  const normalized = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const record = entry;
+    const productId = typeof record.product_id === "string" ? record.product_id.trim() : "";
+    const variantId = typeof record.variant_id === "string" ? record.variant_id.trim() : "";
+    const quantity = Number(record.quantity);
+    if (!productId || !variantId || !Number.isFinite(quantity) || quantity < 1) {
+      continue;
+    }
+    const item = {
+      line_id: "",
+      product_id: productId,
+      variant_id: variantId,
+      quantity: Math.floor(quantity)
+    };
+    if (typeof record.price_variant_id === "string") {
+      item.price_variant_id = record.price_variant_id;
+    }
+    if (record.price_data && typeof record.price_data === "object") {
+      const priceData = record.price_data;
+      if (typeof priceData.unit_price === "number" && Number.isFinite(priceData.unit_price)) {
+        item.price_data = { unit_price: priceData.unit_price };
+      }
+    }
+    if (typeof record.pay_what_you_want_price === "number" && Number.isFinite(record.pay_what_you_want_price)) {
+      item.pay_what_you_want_price = record.pay_what_you_want_price;
+    }
+    if (Array.isArray(record.addons)) {
+      item.addons = record.addons;
+    }
+    if (record.custom_fields && typeof record.custom_fields === "object" && !Array.isArray(record.custom_fields)) {
+      item.custom_fields = record.custom_fields;
+    }
+    if (typeof record.title === "string") {
+      item.title = record.title;
+    }
+    if (typeof record.variant_title === "string") {
+      item.variant_title = record.variant_title;
+    }
+    if (typeof record.image_url === "string") {
+      item.image_url = record.image_url;
+    }
+    if (Array.isArray(record.addon_labels)) {
+      item.addon_labels = record.addon_labels.filter((label) => typeof label === "string");
+    }
+    if (typeof record.max_quantity === "number" && Number.isFinite(record.max_quantity)) {
+      item.max_quantity = record.max_quantity;
+    }
+    if (typeof record.min_quantity === "number" && Number.isFinite(record.min_quantity)) {
+      item.min_quantity = record.min_quantity;
+    }
+    clampQuantityToBounds(item);
+    const storedLineId = typeof record.line_id === "string" ? record.line_id.trim() : "";
+    item.line_id = storedLineId || computeCartLineId(item);
+    normalized.push(ensureCartLineId(item));
+  }
+  return normalized;
+}
+function getCartMetadata() {
+  return readCartStorage("meta");
+}
+function getCartCoupon() {
+  return getStoredCartCode()?.code ?? null;
+}
+function getCartCouponSource() {
+  return getStoredCartCode()?.source ?? null;
+}
+function setCartCoupon(coupon, source = "COUPON") {
+  const normalizedCoupon = normalizeCouponCode(coupon);
+  if (!normalizedCoupon) {
+    removeCartStorage("coupon");
+    return null;
+  }
+  writeCartStorage("coupon", { code: normalizedCoupon, source });
+  return normalizedCoupon;
+}
+function clearCartCoupon() {
+  removeCartStorage("coupon");
+}
+function writeCart(cart) {
+  const normalizedCart = normalizeCartItems(cart);
+  writeCartStorage("cart", normalizedCart);
+  const now = Date.now();
+  const previous = getCartMetadata();
+  const nextMeta = {
+    created_at: previous?.created_at ?? now,
+    last_modified: now,
+    version: (previous?.version ?? 0) + 1,
+    checksum: computeChecksum(normalizedCart)
+  };
+  writeCartStorage("meta", nextMeta);
+  if (normalizedCart.length === 0) {
+    clearCartCoupon();
+  }
+}
+function setCartWithMetadata(cart, metadata) {
+  const normalizedCart = normalizeCartItems(cart);
+  writeCartStorage("cart", normalizedCart);
+  const now = Date.now();
+  const base = metadata ?? getCartMetadata();
+  const nextMeta = {
+    created_at: base?.created_at ?? now,
+    last_modified: now,
+    version: base?.version ?? 1,
+    checksum: computeChecksum(normalizedCart)
+  };
+  writeCartStorage("meta", nextMeta);
+}
+function getCart() {
+  const raw = readCartStorage("cart");
+  return normalizeCartItems(raw);
+}
+function resolveCartLineId(productId, variantId, cart = getCart()) {
+  const matches = cart.filter(
+    (item) => item.product_id === productId && item.variant_id === variantId
+  );
+  if (matches.length === 0) {
+    throw new CartError(`No cart line found for ${productId}/${variantId}`);
+  }
+  return matches[0].line_id;
+}
+function getCartItemCount() {
+  const cart = getCart();
+  return cart.reduce((sum, item) => sum + item.quantity, 0);
+}
+function addToCart(productId, variantId, quantity = 1, options) {
+  if (!productId || !variantId) {
+    throw new CartError("product_id and variant_id are required");
+  }
+  const normalizedQuantity = normalizeQuantity(quantity);
+  if (normalizedQuantity < 1) {
+    throw new CartError("quantity must be at least 1");
+  }
+  const cart = getCart();
+  const lineId = computeCartLineId({
+    product_id: productId,
+    variant_id: variantId,
+    addons: options?.addons,
+    custom_fields: options?.custom_fields,
+    price_variant_id: options?.price_variant_id,
+    price_data: options?.price_data,
+    pay_what_you_want_price: options?.pay_what_you_want_price
+  });
+  const existingIndex = cart.findIndex((item) => item.line_id === lineId);
+  const quantityBeforeAdd = existingIndex >= 0 ? cart[existingIndex].quantity : 0;
+  if (existingIndex >= 0) {
     cart[existingIndex].quantity += normalizedQuantity;
     if (options?.addons) {
       cart[existingIndex].addons = options.addons;
@@ -1160,6 +1622,7 @@ function addToCart(productId, variantId, quantity = 1, options) {
   if (intendedQuantity > quantityBeforeAdd && persistedLine?.quantity === intendedQuantity) {
     const cartAffiliateCode = getCartCouponSource() === "AFFILIATE" ? getCartCoupon() : null;
     void trackAffiliateEvent("add_to_cart", cartAffiliateCode ? { code: cartAffiliateCode } : void 0);
+    void trackCartAdd(productId, variantId, intendedQuantity - quantityBeforeAdd);
   }
 }
 function clampQuantityToBounds(item) {
@@ -1247,6 +1710,8 @@ function setCartItem(productId, variantId, quantity = 1, options) {
   clampQuantityToBounds(pushed);
   cart.push(pushed);
   writeCart(cart);
+  const persistedLine = getCart().find((item) => item.line_id === lineId);
+  if (persistedLine) void trackCartAdd(productId, variantId, persistedLine.quantity);
 }
 function updateCartItem(lineId, updates) {
   const cart = getCart();
@@ -1337,439 +1802,175 @@ function createCartBackup() {
     writeCartStorage("metaBackup", metadata);
   } else {
     const now = Date.now();
-    writeCartStorage("metaBackup", {
-      created_at: now,
-      last_modified: now,
-      version: 1,
-      checksum: computeChecksum(cart)
-    });
-  }
-}
-function restoreCartFromBackup() {
-  const backupRaw = readCartStorage("cartBackup");
-  const backup = normalizeCartItems(backupRaw);
-  const backupMeta = readCartStorage("metaBackup");
-  const backupCoupon = readCartStorage("couponBackup");
-  if (backup && backup.length > 0) {
-    setCartWithMetadata(backup, backupMeta);
-    if (backupCoupon && typeof backupCoupon === "object" && !Array.isArray(backupCoupon)) {
-      const record = backupCoupon;
-      const source = record.source === "COUPON" || record.source === "AFFILIATE" ? record.source : null;
-      if (typeof record.code === "string" && source) {
-        setCartCoupon(record.code, source);
-      } else {
-        clearCartCoupon();
-      }
-    } else {
-      clearCartCoupon();
-    }
-    return true;
-  }
-  return false;
-}
-function mergeBaskets(items) {
-  const cart = getCart();
-  for (const incoming of items) {
-    const productId = typeof incoming.product_id === "string" ? incoming.product_id.trim() : "";
-    const variantId = typeof incoming.variant_id === "string" ? incoming.variant_id.trim() : "";
-    if (!productId || !variantId) {
-      continue;
-    }
-    let normalizedQuantity;
-    try {
-      normalizedQuantity = normalizeQuantity(incoming.quantity);
-    } catch {
-      continue;
-    }
-    if (normalizedQuantity < 1) {
-      continue;
-    }
-    const mergedLine = ensureCartLineId({
-      ...incoming,
-      line_id: incoming.line_id ?? computeCartLineId(incoming),
-      product_id: productId,
-      variant_id: variantId,
-      quantity: normalizedQuantity
-    });
-    const index = cart.findIndex((item) => item.line_id === mergedLine.line_id);
-    if (index >= 0) {
-      cart[index].quantity = Math.max(cart[index].quantity, normalizedQuantity);
-      clampQuantityToBounds(cart[index]);
-    } else {
-      clampQuantityToBounds(mergedLine);
-      cart.push(mergedLine);
-    }
-  }
-  writeCart(cart);
-  return cart;
-}
-function moveBasketItem(fromProductId, fromVariantId, toProductId, toVariantId) {
-  const cart = getCart();
-  const fromIndex = cart.findIndex(
-    (item) => item.product_id === fromProductId && item.variant_id === fromVariantId
-  );
-  if (fromIndex < 0) {
-    throw new CartError("Item not found in cart");
-  }
-  const [fromItem] = cart.splice(fromIndex, 1);
-  const toLineId = computeCartLineId({
-    ...fromItem,
-    product_id: toProductId,
-    variant_id: toVariantId
-  });
-  const toIndex = cart.findIndex((item) => item.line_id === toLineId);
-  if (toIndex >= 0) {
-    cart[toIndex].quantity += fromItem.quantity;
-    clampQuantityToBounds(cart[toIndex]);
-  } else {
-    const moved = ensureCartLineId({
-      ...fromItem,
-      product_id: toProductId,
-      variant_id: toVariantId,
-      line_id: toLineId
-    });
-    clampQuantityToBounds(moved);
-    cart.push(moved);
-  }
-  writeCart(cart);
-}
-function validateCartIntegrity() {
-  const cart = getCart();
-  const metadata = getCartMetadata();
-  const checksum = computeChecksum(cart);
-  if (!metadata) {
-    setCartWithMetadata(cart, null);
-    return true;
-  }
-  return metadata.checksum === checksum;
-}
-function getCartStats() {
-  const cart = getCart();
-  const integrityValid = validateCartIntegrity();
-  const metadata = getCartMetadata();
-  const backup = readCartStorage("cartBackup") ?? [];
-  const hasCompletePriceSnapshots = cart.length > 0 && cart.every((item) => typeof item.price_data?.unit_price === "number");
-  const totalPrice = cart.reduce((sum, item) => {
-    const unitPrice = item.price_data?.unit_price ?? 0;
-    return sum + roundPayableAmount(unitPrice * item.quantity);
-  }, 0);
-  return {
-    item_count: cart.length,
-    total_quantity: cart.reduce((sum, item) => sum + item.quantity, 0),
-    last_modified: metadata?.last_modified ?? 0,
-    version: metadata?.version ?? 0,
-    has_backup: backup.length > 0,
-    integrity_valid: integrityValid,
-    total_price: roundPayableAmount(totalPrice),
-    total_price_is_estimate: cart.length > 0 && !hasCompletePriceSnapshots
-  };
-}
-function getCartPayload(coupon) {
-  const config = getConfig();
-  const normalizedCoupon = normalizeCouponCode(coupon) ?? getCartCoupon() ?? void 0;
-  return {
-    store_slug: config.storeSlug,
-    items: getCart(),
-    coupon: normalizedCoupon
-  };
-}
-function getAmbientAffiliateCodeForQuote() {
-  const storedCode = getCartCoupon();
-  const storedSource = getCartCouponSource();
-  if (storedSource === "AFFILIATE" && storedCode) {
-    return storedCode.trim().toLowerCase();
-  }
-  return getAffiliateCode();
-}
-var latestQuoteToken = null;
-var quoteSequence = 0;
-function getLatestQuoteToken() {
-  return latestQuoteToken;
-}
-function clearLatestQuoteToken() {
-  latestQuoteToken = null;
-  quoteSequence += 1;
-}
-async function quoteCart(coupon, currency) {
-  const sequence = quoteSequence += 1;
-  const payload = getCartPayload(coupon);
-  const normalizedCurrency = normalizeRequestedCurrency(currency) ?? resolveBuyerCurrency(getConfig().currency);
-  const response = await post("/v1/storefront/cart/quote", {
-    shop_slug: payload.store_slug,
-    cart: payload.items,
-    coupon: payload.coupon,
-    affiliate_code: getAmbientAffiliateCodeForQuote() ?? void 0,
-    currency: normalizedCurrency ?? void 0
-  });
-  if (sequence !== quoteSequence) return response;
-  if (response.success) {
-    latestQuoteToken = typeof response.data?.quote_token === "string" ? response.data.quote_token : null;
-  }
-  return response;
-}
-
-// ../sdk/src/core/attribution.ts
-var STORAGE_PREFIX2 = "shoppex:utm:";
-var TTL_MS = 30 * 24 * 60 * 60 * 1e3;
-var UTM_KEYS = ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
-var MAX_VALUE_LENGTH = 255;
-function readFromUrl(search) {
-  let params;
-  try {
-    params = new URLSearchParams(search);
-  } catch {
-    return {};
-  }
-  const utm = {};
-  for (const key of UTM_KEYS) {
-    const value = params.get(key)?.trim();
-    if (value) {
-      utm[key] = value.slice(0, MAX_VALUE_LENGTH);
-    }
-  }
-  return utm;
-}
-function storageKey(storeSlug) {
-  return `${STORAGE_PREFIX2}${storeSlug}`;
-}
-function readStored(storeSlug) {
-  try {
-    const raw = window.localStorage.getItem(storefrontStorageKey(storageKey(storeSlug)));
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed.at !== "number" || typeof parsed.utm !== "object") return {};
-    if (Date.now() - parsed.at > TTL_MS) {
-      window.localStorage.removeItem(storefrontStorageKey(storageKey(storeSlug)));
-      return {};
-    }
-    const utm = {};
-    for (const key of UTM_KEYS) {
-      const value = parsed.utm?.[key];
-      if (typeof value === "string" && value.length > 0) {
-        utm[key] = value.slice(0, MAX_VALUE_LENGTH);
-      }
-    }
-    return utm;
-  } catch {
-    return {};
-  }
-}
-function writeStored(storeSlug, utm) {
-  try {
-    const payload = { utm, at: Date.now() };
-    window.localStorage.setItem(storefrontStorageKey(storageKey(storeSlug)), JSON.stringify(payload));
-  } catch {
-  }
-}
-function resolveUtmParameters(storeSlug) {
-  if (typeof window === "undefined" || typeof window.location === "undefined") {
-    return void 0;
-  }
-  const fromUrl = readFromUrl(window.location.search);
-  if (Object.keys(fromUrl).length > 0) {
-    writeStored(storeSlug, fromUrl);
-    return fromUrl;
-  }
-  const stored = readStored(storeSlug);
-  return Object.keys(stored).length > 0 ? stored : void 0;
-}
-
-// ../sdk/src/core/page-path.ts
-var MAX_PATH_LENGTH = 256;
-function resolveStorefrontPagePath() {
-  if (typeof window === "undefined") return void 0;
-  let pathname;
-  try {
-    const location = window.location;
-    pathname = typeof location?.pathname === "string" && location.pathname ? location.pathname : new URL(String(location?.href ?? "")).pathname;
-  } catch {
-    return void 0;
-  }
-  if (!pathname || !pathname.startsWith("/")) return void 0;
-  return pathname.slice(0, MAX_PATH_LENGTH);
-}
-
-// ../sdk/src/core/page-tracker.ts
-var PLATFORM_PAGE_TRACKER_FLAG = "__shoppexPageTracker";
-function isPlatformPageTrackerActive() {
-  if (typeof window === "undefined") return false;
-  try {
-    return Boolean(window[PLATFORM_PAGE_TRACKER_FLAG]);
-  } catch {
-    return false;
-  }
-}
-
-// ../sdk/src/modules/analytics.ts
-var CONFIRMED_CART_STORAGE_PREFIX = "reported_cart_";
-var IN_FLIGHT_CART_STORAGE_PREFIX = "reporting_cart_";
-var CART_SEQUENCE_STORAGE_PREFIX = "presence_cart_seq_";
-var CART_CLAIM_TTL_MS = 1e4;
-function confirmedCartKey(storeSlug) {
-  return `${CONFIRMED_CART_STORAGE_PREFIX}${storeSlug}`;
-}
-function inFlightCartKey(storeSlug) {
-  return `${IN_FLIGHT_CART_STORAGE_PREFIX}${storeSlug}`;
-}
-function cartSequenceKey(storeSlug) {
-  return `${CART_SEQUENCE_STORAGE_PREFIX}${storeSlug}`;
-}
-function cartSnapshot(cartValue, itemCount) {
-  return `${cartValue ?? ""}|${itemCount ?? ""}`;
-}
-function isCartSequence(value) {
-  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
-var CART_SEQUENCE_SCOPE_MAX_LENGTH = 64;
-function readCartCounter(storeSlug) {
-  const counter = getItem(cartSequenceKey(storeSlug));
-  if (!counter || typeof counter.scope !== "string" || counter.scope.length === 0 || counter.scope.length > CART_SEQUENCE_SCOPE_MAX_LENGTH || !isCartSequence(counter.seq)) {
-    return null;
-  }
-  return counter;
-}
-var lastCartOrder = null;
-function nextCartOrder(storeSlug) {
-  const stored = readCartCounter(storeSlug);
-  const scope = stored?.scope ?? lastCartOrder?.scope ?? createClaimToken();
-  const floor = Math.max(stored?.seq ?? 0, lastCartOrder?.scope === scope ? lastCartOrder.seq : 0);
-  const order2 = { scope, seq: Math.max(Date.now(), floor + 1) };
-  lastCartOrder = order2;
-  setItem(cartSequenceKey(storeSlug), order2);
-  return order2;
-}
-function cartSequenceLocks() {
-  if (typeof navigator === "undefined") return null;
-  const locks = navigator.locks;
-  return locks && typeof locks.request === "function" ? locks : null;
-}
-function reserveCartOrder(storeSlug) {
-  const take = () => nextCartOrder(storeSlug);
-  const locks = cartSequenceLocks();
-  if (!locks) return Promise.resolve(take());
-  return locks.request(cartSequenceKey(storeSlug), take).catch(take);
-}
-function readConfirmedCart(storeSlug) {
-  const confirmed = getItem(confirmedCartKey(storeSlug));
-  if (!confirmed || typeof confirmed.snapshot !== "string" || !isCartSequence(confirmed.seq)) return null;
-  return confirmed;
-}
-function readInFlightCart(storeSlug) {
-  const claim = getItem(inFlightCartKey(storeSlug));
-  if (!claim || typeof claim.snapshot !== "string" || !isCartSequence(claim.seq) || typeof claim.token !== "string" || typeof claim.at !== "number") {
-    return null;
-  }
-  return claim;
-}
-function isCartReportedOrInFlight(storeSlug, snapshot) {
-  const confirmed = readConfirmedCart(storeSlug);
-  const claim = readInFlightCart(storeSlug);
-  const liveClaim = claim && Date.now() - claim.at < CART_CLAIM_TTL_MS ? claim : null;
-  const expected = liveClaim && (!confirmed || liveClaim.seq > confirmed.seq) ? liveClaim : confirmed;
-  return expected?.snapshot === snapshot;
-}
-function createClaimToken() {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
-  return `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`;
+    writeCartStorage("metaBackup", {
+      created_at: now,
+      last_modified: now,
+      version: 1,
+      checksum: computeChecksum(cart)
+    });
+  }
 }
-function claimCartReport(storeSlug, seq, cartValue, itemCount) {
-  const snapshot = cartSnapshot(cartValue, itemCount);
-  const token = createClaimToken();
-  setItem(inFlightCartKey(storeSlug), { snapshot, seq, token, at: Date.now() });
-  return (delivered) => {
-    if (delivered) {
-      const confirmed = readConfirmedCart(storeSlug);
-      if (!confirmed || seq > confirmed.seq) setItem(confirmedCartKey(storeSlug), { snapshot, seq });
+function restoreCartFromBackup() {
+  const backupRaw = readCartStorage("cartBackup");
+  const backup = normalizeCartItems(backupRaw);
+  const backupMeta = readCartStorage("metaBackup");
+  const backupCoupon = readCartStorage("couponBackup");
+  if (backup && backup.length > 0) {
+    setCartWithMetadata(backup, backupMeta);
+    if (backupCoupon && typeof backupCoupon === "object" && !Array.isArray(backupCoupon)) {
+      const record = backupCoupon;
+      const source = record.source === "COUPON" || record.source === "AFFILIATE" ? record.source : null;
+      if (typeof record.code === "string" && source) {
+        setCartCoupon(record.code, source);
+      } else {
+        clearCartCoupon();
+      }
+    } else {
+      clearCartCoupon();
     }
-    if (readInFlightCart(storeSlug)?.token === token) removeItem(inFlightCartKey(storeSlug));
-  };
+    return true;
+  }
+  return false;
 }
-var cartSendTail = Promise.resolve();
-var latestCartRequest = 0;
-function enqueueCartSend(send) {
-  const request2 = ++latestCartRequest;
-  const run = () => send(() => request2 === latestCartRequest);
-  cartSendTail = cartSendTail.then(run, run);
-  return cartSendTail;
+function mergeBaskets(items) {
+  const cart = getCart();
+  for (const incoming of items) {
+    const productId = typeof incoming.product_id === "string" ? incoming.product_id.trim() : "";
+    const variantId = typeof incoming.variant_id === "string" ? incoming.variant_id.trim() : "";
+    if (!productId || !variantId) {
+      continue;
+    }
+    let normalizedQuantity;
+    try {
+      normalizedQuantity = normalizeQuantity(incoming.quantity);
+    } catch {
+      continue;
+    }
+    if (normalizedQuantity < 1) {
+      continue;
+    }
+    const mergedLine = ensureCartLineId({
+      ...incoming,
+      line_id: incoming.line_id ?? computeCartLineId(incoming),
+      product_id: productId,
+      variant_id: variantId,
+      quantity: normalizedQuantity
+    });
+    const index = cart.findIndex((item) => item.line_id === mergedLine.line_id);
+    if (index >= 0) {
+      cart[index].quantity = Math.max(cart[index].quantity, normalizedQuantity);
+      clampQuantityToBounds(cart[index]);
+    } else {
+      clampQuantityToBounds(mergedLine);
+      cart.push(mergedLine);
+    }
+  }
+  writeCart(cart);
+  return cart;
 }
-async function postPing(body) {
-  const config = getConfig();
-  const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
-  let timer;
-  const timedOut = new Promise((resolve) => {
-    timer = setTimeout(() => {
-      controller?.abort();
-      resolve(false);
-    }, CART_CLAIM_TTL_MS);
+function moveBasketItem(fromProductId, fromVariantId, toProductId, toVariantId) {
+  const cart = getCart();
+  const fromIndex = cart.findIndex(
+    (item) => item.product_id === fromProductId && item.variant_id === fromVariantId
+  );
+  if (fromIndex < 0) {
+    throw new CartError("Item not found in cart");
+  }
+  const [fromItem] = cart.splice(fromIndex, 1);
+  const toLineId = computeCartLineId({
+    ...fromItem,
+    product_id: toProductId,
+    variant_id: toVariantId
   });
-  try {
-    const endpoint = buildEndpoint("/v1/storefront/shops/:storeSlug/ping", {
-      storeSlug: config.storeSlug
+  const toIndex = cart.findIndex((item) => item.line_id === toLineId);
+  if (toIndex >= 0) {
+    cart[toIndex].quantity += fromItem.quantity;
+    clampQuantityToBounds(cart[toIndex]);
+  } else {
+    const moved = ensureCartLineId({
+      ...fromItem,
+      product_id: toProductId,
+      variant_id: toVariantId,
+      line_id: toLineId
     });
-    const delivered = fetch(`${config.apiBaseUrl}${endpoint}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body),
-      signal: controller?.signal
-    }).then((response) => response.ok);
-    return await Promise.race([delivered, timedOut]);
-  } catch {
-    return false;
-  } finally {
-    clearTimeout(timer);
+    clampQuantityToBounds(moved);
+    cart.push(moved);
+  }
+  writeCart(cart);
+}
+function validateCartIntegrity() {
+  const cart = getCart();
+  const metadata = getCartMetadata();
+  const checksum = computeChecksum(cart);
+  if (!metadata) {
+    setCartWithMetadata(cart, null);
+    return true;
   }
+  return metadata.checksum === checksum;
 }
-async function trackPageView(cartValue, itemCount) {
-  if (!isInitialized()) return;
-  if (typeof document === "undefined") return;
+function getCartStats() {
+  const cart = getCart();
+  const integrityValid = validateCartIntegrity();
+  const metadata = getCartMetadata();
+  const backup = readCartStorage("cartBackup") ?? [];
+  const hasCompletePriceSnapshots = cart.length > 0 && cart.every((item) => typeof item.price_data?.unit_price === "number");
+  const totalPrice = cart.reduce((sum, item) => {
+    const unitPrice = item.price_data?.unit_price ?? 0;
+    return sum + roundPayableAmount(unitPrice * item.quantity);
+  }, 0);
+  return {
+    item_count: cart.length,
+    total_quantity: cart.reduce((sum, item) => sum + item.quantity, 0),
+    last_modified: metadata?.last_modified ?? 0,
+    version: metadata?.version ?? 0,
+    has_backup: backup.length > 0,
+    integrity_valid: integrityValid,
+    total_price: roundPayableAmount(totalPrice),
+    total_price_is_estimate: cart.length > 0 && !hasCompletePriceSnapshots
+  };
+}
+function getCartPayload(coupon) {
   const config = getConfig();
-  const carriesCart = cartValue !== void 0 || itemCount !== void 0;
-  const reservedOrder = carriesCart ? reserveCartOrder(config.storeSlug) : void 0;
-  if (isPlatformPageTrackerActive()) {
-    if (reservedOrder) await enqueueCartSend(async () => sendCartActivity(await reservedOrder, cartValue, itemCount));
-    return;
-  }
-  const sendView = async () => {
-    const order2 = reservedOrder ? await reservedOrder : void 0;
-    const settle = order2 ? claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount) : void 0;
-    const delivered = await postPing({
-      referer: document.referrer || void 0,
-      cart_value: cartValue,
-      item_count: itemCount,
-      cart_seq: order2?.seq,
-      cart_seq_scope: order2?.scope,
-      connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
-      path: resolveStorefrontPagePath(),
-      utm: resolveUtmParameters(config.storeSlug)
-    });
-    settle?.(delivered);
+  const normalizedCoupon = normalizeCouponCode(coupon) ?? getCartCoupon() ?? void 0;
+  return {
+    store_slug: config.storeSlug,
+    items: getCart(),
+    coupon: normalizedCoupon
   };
-  await (reservedOrder ? enqueueCartSend(sendView) : sendView());
 }
-async function trackCartActivity(cartValue, itemCount) {
-  if (!isInitialized()) return;
-  if (typeof document === "undefined") return;
-  const snapshot = cartSnapshot(cartValue, itemCount);
-  const reservedOrder = reserveCartOrder(getConfig().storeSlug);
-  await enqueueCartSend(async (isLatest) => {
-    const order2 = await reservedOrder;
-    if (!isLatest() || isCartReportedOrInFlight(getConfig().storeSlug, snapshot)) return;
-    await sendCartActivity(order2, cartValue, itemCount);
-  });
+function getAmbientAffiliateCodeForQuote() {
+  const storedCode = getCartCoupon();
+  const storedSource = getCartCouponSource();
+  if (storedSource === "AFFILIATE" && storedCode) {
+    return storedCode.trim().toLowerCase();
+  }
+  return getAffiliateCode();
 }
-async function sendCartActivity(order2, cartValue, itemCount) {
-  const config = getConfig();
-  const settle = claimCartReport(config.storeSlug, order2.seq, cartValue, itemCount);
-  const delivered = await postPing({
-    event_type: "presence",
-    cart_value: cartValue,
-    item_count: itemCount,
-    cart_seq: order2.seq,
-    cart_seq_scope: order2.scope,
-    connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
-    path: resolveStorefrontPagePath()
+var latestQuoteToken = null;
+var quoteSequence = 0;
+function getLatestQuoteToken() {
+  return latestQuoteToken;
+}
+function clearLatestQuoteToken() {
+  latestQuoteToken = null;
+  quoteSequence += 1;
+}
+async function quoteCart(coupon, currency) {
+  const sequence = quoteSequence += 1;
+  const payload = getCartPayload(coupon);
+  const normalizedCurrency = normalizeRequestedCurrency(currency) ?? resolveBuyerCurrency(getConfig().currency);
+  const response = await post("/v1/storefront/cart/quote", {
+    shop_slug: payload.store_slug,
+    cart: payload.items,
+    coupon: payload.coupon,
+    affiliate_code: getAmbientAffiliateCodeForQuote() ?? void 0,
+    currency: normalizedCurrency ?? void 0
   });
-  settle(delivered);
+  if (sequence !== quoteSequence) return response;
+  if (response.success) {
+    latestQuoteToken = typeof response.data?.quote_token === "string" ? response.data.quote_token : null;
+  }
+  return response;
 }
 
 // ../sdk/src/storefront-storage-sdk.ts
@@ -1815,7 +2016,8 @@ var storefrontStorageSdk = {
   trackAffiliateEvent,
   // Analytics
   trackPageView,
-  trackCartActivity
+  trackCartActivity,
+  trackProductView
 };
 
 // ../../node_modules/.bun/openapi-fetch@0.17.0/node_modules/openapi-fetch/dist/index.mjs
@@ -2663,16 +2865,6 @@ function isSafeHttpsRedirectTemplateUrl(url) {
   }
 }
 
-// ../contracts/src/storefront-consent-choice.ts
-var COOKIE_CONSENT_VERSION = 1;
-var COOKIE_CONSENT_COOKIE = "shoppex_consent";
-var COOKIE_CONSENT_CHECKOUT_HASH_KEY = "shoppex_consent";
-var COOKIE_CONSENT_VALUE = new RegExp(`^v${COOKIE_CONSENT_VERSION}\\.f([01])\\.a([01])\\.m([01])$`);
-function parseCookieConsentValue(value) {
-  const match = value ? COOKIE_CONSENT_VALUE.exec(value) : null;
-  return match ? { functional: match[1] === "1", analytics: match[2] === "1", marketing: match[3] === "1" } : null;
-}
-
 // ../sdk/src/modules/checkout.ts
 var CheckoutCreateError = class _CheckoutCreateError extends Error {
   constructor(message, options = {}) {
@@ -2971,7 +3163,10 @@ async function performCheckout(resolvedOptions) {
     // automatically so the server can refuse an invoice priced above it.
     // Undefined when nothing has been quoted this session — the endpoint
     // treats that exactly as an older SDK.
-    quote_token: resolvedOptions.quoteToken !== void 0 ? resolvedOptions.quoteToken ?? void 0 : getLatestQuoteToken() ?? void 0
+    quote_token: resolvedOptions.quoteToken !== void 0 ? resolvedOptions.quoteToken ?? void 0 : getLatestQuoteToken() ?? void 0,
+    // Where the buyer came from: their analytics sessions after a yes on the
+    // cookie banner, `declined` after a no. The server looks up the sources.
+    attribution: checkoutAttribution(config.storeSlug)
   };
   const createAttempt = acquireCheckoutCreateIdempotency(checkoutRequestTarget, createIntent);
   const response = await post(
@@ -3820,7 +4015,6 @@ async function touchStorefrontPresence() {
     {
       event_type: "presence",
       referer: document.referrer || void 0,
-      connection_id: getStorefrontConnectionId(config.storeSlug) ?? void 0,
       path: resolveStorefrontPagePath(),
       utm: resolveUtmParameters(config.storeSlug)
     },
@@ -4421,19 +4615,29 @@ function createTicket(payload) {
     body: {
       ...payload.title !== void 0 ? { title: payload.title } : {},
       message: payload.message,
-      ...payload.invoice_id !== void 0 ? { invoice_id: payload.invoice_id } : {}
+      ...payload.invoice_id !== void 0 ? { invoice_id: payload.invoice_id } : {},
+      ...payload.attachment_ids?.length ? { attachment_ids: payload.attachment_ids } : {}
     }
   });
 }
 function ticket(uniqid) {
   return requestCustomer(`/tickets/${encodeURIComponent(uniqid)}`);
 }
-function replyToTicket(uniqid, message) {
+function replyToTicket(uniqid, message, attachmentIds = []) {
   return requestCustomer(`/tickets/${encodeURIComponent(uniqid)}/reply`, {
     method: "POST",
-    body: { message }
+    body: attachmentIds.length > 0 ? { message, attachment_ids: attachmentIds } : { message }
   });
 }
+function uploadTicketImage(file, ticket2) {
+  const form = new FormData();
+  form.append("file", file);
+  if (ticket2) form.append("ticket", ticket2);
+  return requestCustomer("/ticket-attachments", { method: "POST", formData: form });
+}
+function discardTicketImage(id) {
+  return requestCustomer(`/ticket-attachments/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
 function updateProfile(patch) {
   return requestCustomer("/profile", {
     method: "POST",
@@ -4559,6 +4763,8 @@ var shoppex = {
   createTicket,
   ticket,
   replyToTicket,
+  uploadTicketImage,
+  discardTicketImage,
   updateProfile,
   updateAvatar,
   removeAvatar,
@@ -4616,6 +4822,7 @@ export {
   createTicket,
   dashboard,
   src_default as default,
+  discardTicketImage,
   emailPreferences,
   enrollAsReseller,
   ensureCartLineId,
@@ -4683,11 +4890,13 @@ export {
   touchStorefrontPresence,
   trackCartActivity,
   trackPageView,
+  trackProductView,
   undoSubscriptionCancel,
   updateAvatar,
   updateEmailPreferences,
   updateNotificationPreferences,
   updateProfile,
+  uploadTicketImage,
   validateStorefrontCustomFieldValue,
   verifyOtp,
   warranties