@vio-live/web-sdk 0.26.1 → 0.28.0

package/dist/{chunk-NXIYIY2D.js → chunk-AFJ5M53F.js}

@@ -2917,6 +2917,160 @@ function lineOrigins(line) {
   return copy.origins;
 }
 
+// src/core/sponsor-identity.ts
+var CHECKOUT_SPONSOR_STORAGE_KEY = "vio.checkoutSponsor.v1";
+var CHECKOUT_SPONSOR_MEMORY_MAX = 20;
+function toSponsorId(value) {
+  if (value === null || value === void 0 || value === "") return void 0;
+  const n = typeof value === "number" ? value : Number(String(value).trim());
+  return Number.isInteger(n) && n > 0 ? n : void 0;
+}
+function urlOrNull(value) {
+  if (typeof value !== "string") return null;
+  const v = value.trim();
+  return v ? v : null;
+}
+function pageUrlOrNull(value) {
+  const v = urlOrNull(value);
+  if (!v) return null;
+  try {
+    return new URL(v).protocol === "https:" ? v : null;
+  } catch {
+    return null;
+  }
+}
+function nameOf(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function findSponsorIn(boot, sponsorId) {
+  const id = toSponsorId(sponsorId);
+  if (id === void 0 || !boot || typeof boot !== "object") return void 0;
+  const match = (s) => !!s && typeof s === "object" && Number(s.id) === id;
+  if (match(boot.primarySponsor)) return boot.primarySponsor;
+  const secondary = Array.isArray(boot.secondarySponsors) ? boot.secondarySponsors.find(match) : void 0;
+  if (secondary) return secondary;
+  const campaigns = Array.isArray(boot.campaigns) ? boot.campaigns : [];
+  for (const c of campaigns) {
+    if (!c || typeof c !== "object") continue;
+    if (match(c.primarySponsor)) return c.primarySponsor;
+    const s = Array.isArray(c.secondarySponsors) ? c.secondarySponsors.find(match) : void 0;
+    if (s) return s;
+  }
+  return void 0;
+}
+function sponsorIdentityFrom(boot, sponsorId) {
+  try {
+    const id = toSponsorId(sponsorId);
+    if (id === void 0) return null;
+    const sponsor = findSponsorIn(boot, id);
+    if (!sponsor) return null;
+    const name = nameOf(sponsor.name);
+    const logoUrl = urlOrNull(sponsor.logoUrl);
+    if (!name && !logoUrl) return null;
+    const termsUrl = pageUrlOrNull(sponsor.termsUrl);
+    const refundPolicyUrl = pageUrlOrNull(sponsor.refundPolicyUrl);
+    return {
+      id,
+      name,
+      logoUrl,
+      avatarUrl: urlOrNull(sponsor.avatarUrl),
+      ...termsUrl ? { termsUrl } : {},
+      ...refundPolicyUrl ? { refundPolicyUrl } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function checkoutSponsorOf(identity) {
+  if (!identity) return void 0;
+  return { id: identity.id, name: identity.name, logoUrl: identity.logoUrl ?? null };
+}
+var inMemory = [];
+var storageRefusedWrite = false;
+function sessionStore() {
+  try {
+    const s = globalThis.sessionStorage;
+    return s && typeof s.getItem === "function" && typeof s.setItem === "function" ? s : null;
+  } catch {
+    return null;
+  }
+}
+function normalizeEntry(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  const checkoutId = typeof r.checkoutId === "string" ? r.checkoutId.trim() : "";
+  const sponsorId = toSponsorId(r.sponsorId);
+  if (!checkoutId || sponsorId === void 0) return null;
+  return { checkoutId, sponsorId, name: nameOf(r.name), logoUrl: urlOrNull(r.logoUrl) };
+}
+function readEntries() {
+  const store = storageRefusedWrite ? null : sessionStore();
+  if (store) {
+    try {
+      const raw = store.getItem(CHECKOUT_SPONSOR_STORAGE_KEY);
+      if (!raw) return [];
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        return parsed.map(normalizeEntry).filter((e) => e !== null);
+      }
+    } catch {
+    }
+  }
+  return inMemory.slice();
+}
+function writeEntries(entries) {
+  inMemory = entries.slice();
+  const store = sessionStore();
+  if (!store) return;
+  try {
+    store.setItem(CHECKOUT_SPONSOR_STORAGE_KEY, JSON.stringify(entries));
+  } catch {
+    storageRefusedWrite = true;
+  }
+}
+function rememberCheckoutSponsor(checkoutId, sponsor) {
+  try {
+    const id = typeof checkoutId === "string" ? checkoutId.trim() : "";
+    const sponsorId = toSponsorId(sponsor?.sponsorId);
+    if (!id || sponsorId === void 0) return;
+    const entries = readEntries();
+    const previous = entries.find((e) => e.checkoutId === id);
+    let name = nameOf(sponsor.name);
+    let logoUrl = urlOrNull(sponsor.logoUrl);
+    if (previous && previous.sponsorId === sponsorId && !name && !logoUrl) {
+      name = previous.name;
+      logoUrl = previous.logoUrl;
+    }
+    const next = entries.filter((e) => e.checkoutId !== id);
+    next.push({ checkoutId: id, sponsorId, name, logoUrl });
+    writeEntries(next.slice(-CHECKOUT_SPONSOR_MEMORY_MAX));
+  } catch {
+  }
+}
+function rememberedCheckoutSponsor(checkoutId) {
+  try {
+    const id = typeof checkoutId === "string" ? checkoutId.trim() : "";
+    if (!id) return null;
+    return readEntries().find((e) => e.checkoutId === id) ?? null;
+  } catch {
+    return null;
+  }
+}
+function rememberedSponsor(sponsorId) {
+  try {
+    const id = toSponsorId(sponsorId);
+    if (id === void 0) return null;
+    const entries = readEntries();
+    for (let i = entries.length - 1; i >= 0; i--) {
+      const e = entries[i];
+      if (e.sponsorId === id && (e.name || e.logoUrl)) return e;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 // src/core/checkout/payments/apple-pay.ts
 var STRIPE_JS_URL = "https://js.stripe.com/v3";
 var stripeJsPromise = null;
@@ -3113,7 +3267,7 @@ async function prepareApplePay(config) {
 }
 
 // src/core/version.ts
-var SDK_VERSION = "0.25.0";
+var SDK_VERSION = "0.28.0";
 
 // src/core/checkout/payments/stripe-embedded.ts
 var CREATE_PAYMENT_INTENT_STRIPE_MUTATION = `
@@ -4614,7 +4768,9 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
     super();
     this.cartManager = cartManager;
     this.deps = deps;
-    this.state = null;
+    this.currentStateValue = null;
+    /** The last checkout + identity written to the memory — the state is set on every keystroke of the form. */
+    this.lastRememberedSponsor = "";
     /** Counts `open()` calls — see CheckoutState.session. */
     this.sessionSeq = 0;
     this.applePayAvailableCache = null;
@@ -4658,6 +4814,18 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
     this.kustomController = null;
     preloadStripeJs();
   }
+  /**
+   * Every write of the state goes through here: a state that names its
+   * backend checkout is remembered with its sponsor (see
+   * `rememberSponsorOfCheckout`), whatever path created the checkout.
+   */
+  get state() {
+    return this.currentStateValue;
+  }
+  set state(next) {
+    this.currentStateValue = next;
+    if (next?.checkoutId && next.sponsorId) this.rememberSponsorOfCheckout(next.checkoutId, next.sponsorId);
+  }
   open(sponsorId) {
     const cart = this.cartManager.getCart(sponsorId);
     if (!cart || cart.items.length === 0) {
@@ -4776,21 +4944,81 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
    * `buyer_id`. Never throws; `null` for whatever the API does not say.
    */
   async getOrderReference(checkoutId, sponsorId) {
-    if (!checkoutId) return { orderNumber: null, buyerRef: null };
-    const inFlight = this.referenceInFlight.get(checkoutId);
-    if (inFlight) return inFlight;
-    const request = (async () => {
+    if (!checkoutId) return this.withSponsor({ orderNumber: null, buyerRef: null }, checkoutId, sponsorId);
+    let request = this.referenceInFlight.get(checkoutId);
+    if (!request) {
+      const asked = (async () => {
+        try {
+          const opts = await getCartGraphQLOptions(
+            sponsorId ?? this.sponsorIdOfCheckout(checkoutId) ?? this.state?.sponsorId
+          );
+          return await getCheckoutReference(checkoutId, opts);
+        } catch {
+          return { orderNumber: null, buyerRef: null };
+        } finally {
+          this.referenceInFlight.delete(checkoutId);
+        }
+      })();
+      this.referenceInFlight.set(checkoutId, asked);
+      request = asked;
+    }
+    return this.withSponsor(await request, checkoutId, sponsorId);
+  }
+  /**
+   * The sponsor of a checkout as `getOrderReference` carries it
+   * (`{ id, name, logoUrl }`): the given sponsor, else the one this tab
+   * remembered for the checkout, else the open checkout's when it IS that
+   * checkout — named by the `Vio.sponsorIdentity` rule. `undefined` when
+   * nothing names it; never throws.
+   */
+  checkoutSponsor(checkoutId, sponsorId) {
+    try {
+      const id = sponsorId ?? this.sponsorIdOfCheckout(checkoutId ?? void 0);
+      const numeric = id === void 0 || id === null || id === "" ? void 0 : Number(id);
+      if (typeof this.deps.sponsorIdentity === "function") {
+        return checkoutSponsorOf(this.deps.sponsorIdentity(numeric, { checkoutId: checkoutId ?? void 0 }));
+      }
+      const memo = rememberedCheckoutSponsor(checkoutId ?? void 0);
+      if (memo && (numeric === void 0 || memo.sponsorId === numeric) && (memo.name || memo.logoUrl)) {
+        return { id: memo.sponsorId, name: memo.name, logoUrl: memo.logoUrl };
+      }
+      return void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /** The sponsor id of a checkout: this tab's memory of it, else the open checkout's when it is that one. */
+  sponsorIdOfCheckout(checkoutId) {
+    if (!checkoutId) return void 0;
+    const memo = rememberedCheckoutSponsor(checkoutId);
+    if (memo) return memo.sponsorId;
+    return this.state?.checkoutId === checkoutId ? this.state.sponsorId : void 0;
+  }
+  withSponsor(reference, checkoutId, sponsorId) {
+    const sponsor = this.checkoutSponsor(checkoutId || void 0, sponsorId);
+    return sponsor ? { ...reference, sponsor } : reference;
+  }
+  /**
+   * Remember whose checkout this is (`rememberCheckoutSponsor`), with the
+   * sponsor's name and logo as known now — so a confirmation after a redirect
+   * or a reload can name the brand. Written again only when something changed.
+   */
+  rememberSponsorOfCheckout(checkoutId, sponsorId) {
+    try {
+      let identity = null;
       try {
-        const opts = await getCartGraphQLOptions(sponsorId ?? this.state?.sponsorId);
-        return await getCheckoutReference(checkoutId, opts);
+        identity = this.deps.sponsorIdentity?.(sponsorId, { checkoutId }) ?? null;
       } catch {
-        return { orderNumber: null, buyerRef: null };
-      } finally {
-        this.referenceInFlight.delete(checkoutId);
-      }
-    })();
-    this.referenceInFlight.set(checkoutId, request);
-    return request;
+        identity = null;
+      }
+      const name = identity?.name || this.cartManager.getCart(sponsorId)?.sponsorName || "";
+      const logoUrl = identity?.logoUrl ?? null;
+      const key = JSON.stringify([checkoutId, sponsorId, name, logoUrl]);
+      if (key === this.lastRememberedSponsor) return;
+      this.lastRememberedSponsor = key;
+      rememberCheckoutSponsor(checkoutId, { sponsorId, name, logoUrl });
+    } catch {
+    }
   }
   /**
    * Payment methods enabled for the sponsor (backend-configured). Memoised per
@@ -5940,7 +6168,12 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
         );
       }
       const buyerRef = normalizeBuyerRef(confirmRes?.[BUYER_REF_FIELD]);
-      return { orderId: confirmRes?.order_id, status: confirmRes?.status, ...buyerRef ? { buyerRef } : {} };
+      return {
+        orderId: confirmRes?.order_id,
+        status: confirmRes?.status,
+        checkoutId,
+        ...buyerRef ? { buyerRef } : {}
+      };
     };
   }
   static {
@@ -6769,6 +7002,8 @@ function hasExplicitCampaign(lines) {
 }
 
 // src/core/analytics/analytics-manager.ts
+var ORDER_NUMBER_BACKOFF_MS = [500, 1e3, 2e3, 3e3, 3e3];
+var ORDER_NUMBER_MAX_WAIT_MS = 1e4;
 var SESSION_TTL_MS = 30 * 60 * 1e3;
 var FLUSH_INTERVAL_MS = 5e3;
 var FLUSH_AT_COUNT = 20;
@@ -6803,6 +7038,12 @@ var AnalyticsManager = class extends EventTarget {
     this.client = null;
     /** The landing it was read from — persisted later when consent arrives after the first event. */
     this.landing = null;
+    /** Checkouts (`c:<id>`) and orders (`o:<number>`) this page load reported a `purchase` for: one each. */
+    this.purchased = /* @__PURE__ */ new Set();
+    /** Purchases still waiting for Vio's order number: each sends at once, with what it has, when called. */
+    this.pendingPurchases = /* @__PURE__ */ new Set();
+    /** Between `pagehide` and `pageshow` (bfcache): nothing waits, it all goes out now. */
+    this.pageHiding = false;
     this.teardown = [];
   }
   /** The landing this manager resolved on this page load (the first event's), or null before it; read only — for the order's entry context when nothing is stored yet. */
@@ -6852,15 +7093,32 @@ var AnalyticsManager = class extends EventTarget {
     this.ensureSession();
     this.flushTimer = setInterval(() => void this.flush(), FLUSH_INTERVAL_MS);
     const onPageHide = () => {
+      this.pageHiding = true;
+      this.settlePendingPurchases();
       this.trackSessionEnd();
       this.flushWithBeacon();
     };
+    const onPageShow = () => {
+      this.pageHiding = false;
+    };
     window.addEventListener("pagehide", onPageHide);
+    window.addEventListener("pageshow", onPageShow);
     this.teardown.push(() => window.removeEventListener("pagehide", onPageHide));
+    this.teardown.push(() => window.removeEventListener("pageshow", onPageShow));
+    if (typeof document !== "undefined" && typeof document.addEventListener === "function") {
+      const onVisibility = () => {
+        if (document.visibilityState !== "hidden" || this.pendingPurchases.size === 0) return;
+        this.settlePendingPurchases();
+        this.flushWithBeacon();
+      };
+      document.addEventListener("visibilitychange", onVisibility);
+      this.teardown.push(() => document.removeEventListener("visibilitychange", onVisibility));
+    }
     if (this.options.autoTrack) this.installAutoListeners();
   }
-  /** Stop timers + listeners (tests / SPA unmount). Queue survives. */
+  /** Stop timers + listeners (tests / SPA unmount). Queue survives — a purchase still waiting for its order number joins it now. */
   stop() {
+    this.settlePendingPurchases();
     if (this.flushTimer) clearInterval(this.flushTimer);
     this.flushTimer = null;
     for (const fn of this.teardown.splice(0)) fn();
@@ -6873,7 +7131,10 @@ var AnalyticsManager = class extends EventTarget {
   /** Queue one event. Works pre-init and pre-start (SSR: no-op). */
   track(name, opts = {}) {
     if (!hasDom()) return;
-    const event = this.buildEvent(name, opts);
+    this.record(this.buildEvent(name, opts));
+  }
+  /** The sinks and the queue for one built event — `track`'s second half. */
+  record(event) {
     if (!event) return;
     if (this.options.debug) {
       console.debug("[Vio.analytics]", event.name, event);
@@ -7020,6 +7281,8 @@ var AnalyticsManager = class extends EventTarget {
       value: com.value,
       currency: com.currency,
       order_id: com.orderId,
+      // A uuid always fits; anything over the collector's 128 is left out, not cut.
+      checkout_id: fitsId(com.checkoutId),
       payment_method: com.paymentMethod,
       // Only a reference survives — never an email, whatever a host passes —
       // and only with consent to persist: a visit measured with ephemeral
@@ -7259,32 +7522,135 @@ var AnalyticsManager = class extends EventTarget {
     });
     on("vio:payment-success", (ev) => {
       const d = ev.detail ?? {};
+      const ids = purchaseIdsOf(d);
+      if (!this.claimPurchase(ids)) return;
       const sponsorId = d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0;
       const base = { sponsorId, campaignId: campaignOf(d), slot: slotOf(d), ...contentOf(d) };
       const { slices, explicit } = this.cartSlices(sponsorId);
-      if (slices.length > 1) {
-        for (const slice of slices) {
-          this.track("purchase", {
-            context: this.sliceContext(slice, base),
-            commerce: { ...sliceCommerce(slice), ...purchaseFromPaymentSuccess(d), paymentMethod: d.method },
-            props: { slice: slice.slice, slices: slice.slices }
-          });
-        }
-        return;
-      }
-      const snap = this.cartCommerce(sponsorId);
-      this.track("purchase", {
-        context: this.singleSliceContext(slices[0], explicit, base),
-        commerce: {
+      const parts = slices.length > 1 ? (
+        // Several campaigns paid in one go: one purchase per campaign — its
+        // items and value, the SAME order_id — so each campaign's revenue is
+        // its own and the order still adds up. `props.slice/slices` lets the
+        // collector count the order once.
+        slices.map((slice) => ({
+          context: this.sliceContext(slice, base),
+          commerce: { ...sliceCommerce(slice), paymentMethod: d.method },
+          props: { slice: slice.slice, slices: slice.slices }
+        }))
+      ) : [
+        {
+          context: this.singleSliceContext(slices[0], explicit, base),
           // value / currency / items: the cart snapshot, on every path.
-          ...snap ?? {},
-          // order_id: Vio's id for the purchase (never the provider's).
-          ...purchaseFromPaymentSuccess(d),
-          paymentMethod: d.method
+          commerce: { ...this.cartCommerce(sponsorId) ?? {}, paymentMethod: d.method }
         }
-      });
+      ];
+      this.reportPurchase(parts, ids, buyerRefOf(d), sponsorId);
     });
   }
+  /**
+   * Claims the purchase of a payment for this page load: false when its
+   * checkout (or its order) already has one, reported or waiting.
+   */
+  claimPurchase(ids) {
+    const keys = [];
+    if (ids.checkoutId) keys.push(`c:${ids.checkoutId}`);
+    if (ids.orderIdKind === "order" && ids.orderId) keys.push(`o:${ids.orderId}`);
+    if (keys.some((key) => this.purchased.has(key))) return false;
+    for (const key of keys) this.purchased.add(key);
+    return true;
+  }
+  /**
+   * Sends the `purchase` event(s) of one payment — ONCE, with Vio's order
+   * number as `order_id` (`props.order_id_kind: 'order'`) and the checkout id
+   * as `checkout_id`. When the payment event did not bring the number (a
+   * redirect return, an order a webhook creates) the checkout is asked for it
+   * — the receipt's own path, `Vio.checkout.getOrderReference` — at once and
+   * after 0.5 / 1 / 2 / 3 / 3 s, for at most 10 s; nothing else waits for it.
+   * Unanswered, or when the page hides or `stop()` comes first, the events go
+   * out with what they have: the checkout id as `order_id`
+   * (`order_id_kind: 'checkout'`), as before — and the late number adds no
+   * second event. The events are BUILT at the payment — its moment (`ts`),
+   * `event_id`, session, page and content — and only the order number (and a
+   * buyer reference the payment did not bring) is filled in when it comes.
+   */
+  reportPurchase(parts, ids, buyerId, sponsorId) {
+    const events = parts.map(
+      (part) => this.buildEvent("purchase", {
+        ...part,
+        commerce: {
+          ...part.commerce,
+          ...ids.orderId !== void 0 ? { orderId: ids.orderId } : {},
+          ...ids.checkoutId !== void 0 ? { checkoutId: ids.checkoutId } : {},
+          ...buyerId !== void 0 ? { buyerId } : {}
+        },
+        ...ids.orderIdKind ? { props: { ...part.props, order_id_kind: ids.orderIdKind } } : {}
+      })
+    );
+    const send = (found = {}) => {
+      if (found.orderNumber) this.purchased.add(`o:${found.orderNumber}`);
+      const lateBuyer = this.canPersist ? normalizeBuyerRef(found.buyerRef) : void 0;
+      for (const event of events) {
+        if (!event) continue;
+        if (found.orderNumber) {
+          event.commerce = { ...event.commerce, order_id: found.orderNumber };
+          event.props = { ...event.props, order_id_kind: "order" };
+        }
+        if (lateBuyer && event.commerce && event.commerce.buyer_id === void 0) {
+          event.commerce = { ...event.commerce, buyer_id: lateBuyer };
+        }
+        this.record(event);
+      }
+    };
+    const ask = ids.orderIdKind === "checkout" ? this.orderReferenceAsker(ids.checkoutId, sponsorId) : null;
+    if (!ask) {
+      send();
+      return;
+    }
+    if (this.isPageHidden()) {
+      send();
+      this.flushWithBeacon();
+      return;
+    }
+    let done = false;
+    const settle = (found) => {
+      if (done) return;
+      done = true;
+      this.pendingPurchases.delete(settleNow);
+      send(found);
+    };
+    const settleNow = () => settle();
+    this.pendingPurchases.add(settleNow);
+    void waitForOrderNumber(ask, () => done).then(settle, () => settle());
+  }
+  /** Sends every purchase still waiting for its order number, at once, with what it has. */
+  settlePendingPurchases() {
+    for (const settle of [...this.pendingPurchases]) settle();
+  }
+  /** Whether the page is hidden or going away (`pagehide` until `pageshow`). */
+  isPageHidden() {
+    if (this.pageHiding) return true;
+    try {
+      return typeof document !== "undefined" && document.visibilityState === "hidden";
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * How a purchase asks a checkout for Vio's order number: through the SDK's
+   * checkout manager (`getOrderReference`, which never throws and shares its
+   * in-flight ask with the receipt's). `null` when there is nothing to ask —
+   * no checkout id, or no checkout manager on this page.
+   */
+  orderReferenceAsker(checkoutId, sponsorId) {
+    if (!checkoutId) return null;
+    try {
+      const checkout = vioFacade()?.checkout;
+      if (!checkout || typeof checkout.getOrderReference !== "function") return null;
+      return () => checkout.getOrderReference(checkoutId, sponsorId || void 0);
+    } catch {
+      return null;
+    }
+  }
   /** The lines of the cart (current, else the pre-clear snapshot), optionally one sponsor's. */
   cartLines(sponsorId) {
     let items = [];
@@ -7518,15 +7884,63 @@ function buyerRefOf(d) {
   }
   return void 0;
 }
-function purchaseFromPaymentSuccess(d) {
+function purchaseIdsOf(d) {
+  if (!d) return {};
   const r = d.result ?? {};
-  const orderId = firstId(d.orderId, r.confirmation?.orderId, d.checkoutId);
+  const legacy = firstId(d.orderId);
+  const legacyIsNumber = legacy !== void 0 && isOrderNumber(legacy);
+  const orderNumber = firstId(d.orderNumber, r.confirmation?.orderId, legacyIsNumber ? legacy : void 0);
+  const checkoutId = firstId(legacyIsNumber ? void 0 : legacy, d.checkoutId, r.confirmation?.checkoutId);
+  if (orderNumber !== void 0) {
+    return { orderId: orderNumber, ...checkoutId !== void 0 ? { checkoutId } : {}, orderIdKind: "order" };
+  }
+  if (checkoutId !== void 0) return { orderId: checkoutId, checkoutId, orderIdKind: "checkout" };
+  return {};
+}
+function purchaseFromPaymentSuccess(d) {
+  const { orderId, checkoutId } = purchaseIdsOf(d);
   const buyerId = buyerRefOf(d);
   return {
     ...orderId !== void 0 ? { orderId } : {},
+    ...checkoutId !== void 0 ? { checkoutId } : {},
     ...buyerId !== void 0 ? { buyerId } : {}
   };
 }
+function isOrderNumber(value) {
+  return /^[1-9][0-9]*$/.test(value);
+}
+async function waitForOrderNumber(ask, stopped) {
+  let deadline;
+  const timeUp = new Promise((resolve) => {
+    deadline = setTimeout(() => resolve(null), ORDER_NUMBER_MAX_WAIT_MS);
+  });
+  let buyerRef;
+  const found = (orderNumber) => ({
+    ...orderNumber ? { orderNumber } : {},
+    ...buyerRef ? { buyerRef } : {}
+  });
+  try {
+    for (let attempt = 0; attempt <= ORDER_NUMBER_BACKOFF_MS.length; attempt++) {
+      if (attempt > 0) {
+        const wait = ORDER_NUMBER_BACKOFF_MS[attempt - 1];
+        const slept = await Promise.race([new Promise((resolve) => setTimeout(() => resolve(true), wait)), timeUp]);
+        if (slept === null) break;
+      }
+      if (stopped()) break;
+      try {
+        const reference = await Promise.race([ask(), timeUp]);
+        if (reference === null) break;
+        buyerRef ??= normalizeBuyerRef(reference?.buyerRef);
+        const orderNumber = firstId(reference?.orderNumber);
+        if (orderNumber !== void 0 && isOrderNumber(orderNumber)) return found(orderNumber);
+      } catch {
+      }
+    }
+    return found();
+  } finally {
+    clearTimeout(deadline);
+  }
+}
 function firstId(...candidates) {
   for (const c of candidates) {
     if (c === void 0 || c === null) continue;
@@ -7744,7 +8158,8 @@ var VioFacade = class {
   get checkout() {
     if (!this.checkoutManager) {
       this.checkoutManager = new CheckoutManager(this.cart, {
-        orderAttribution: (sponsorId) => this.orderAttribution(sponsorId)
+        orderAttribution: (sponsorId) => this.orderAttribution(sponsorId),
+        sponsorIdentity: (sponsorId, opts) => this.sponsorIdentity(sponsorId, opts)
       });
     }
     return this.checkoutManager;
@@ -7805,6 +8220,39 @@ var VioFacade = class {
   get bootstrapCache() {
     return this.cachedBootstrap;
   }
+  /**
+   * Who a sponsor is to a shopper — `{ id, name, logoUrl, avatarUrl }` — by
+   * the ONE rule every element uses (`sponsorIdentityFrom`): the live
+   * bootstrap's sponsor blocks (the config's primary and secondaries, then
+   * every `campaigns[]` primary and secondaries, first match); when the
+   * bootstrap does not know the id (not loaded yet, a redirect return), what
+   * this tab remembered of the checkout (`opts.checkoutId`, else the latest
+   * checkout of that sponsor), then the cart's `sponsorName`. With only
+   * `opts.checkoutId`, the sponsor is the one remembered for that checkout.
+   * In a checkout pass the CHECKOUT's sponsor — never the page's
+   * attribution. URLs as given; an empty logo is `null`. `null` when nothing
+   * names it. Pure over local state, never throws.
+   */
+  sponsorIdentity(sponsorId, opts = {}) {
+    try {
+      let memo;
+      const memoOfCheckout = () => memo === void 0 ? memo = rememberedCheckoutSponsor(opts?.checkoutId ?? void 0) : memo;
+      const id = toSponsorId(sponsorId) ?? memoOfCheckout()?.sponsorId;
+      if (id === void 0) return null;
+      const fromBootstrap = sponsorIdentityFrom(this.cachedBootstrap, id);
+      if (fromBootstrap) return fromBootstrap;
+      const ofCheckout = memoOfCheckout();
+      const remembered = (ofCheckout && ofCheckout.sponsorId === id && (ofCheckout.name || ofCheckout.logoUrl) ? ofCheckout : null) ?? rememberedSponsor(id);
+      if (remembered) {
+        return { id, name: remembered.name, logoUrl: remembered.logoUrl, avatarUrl: null };
+      }
+      const cartName = this.cart.getCart(id)?.sponsorName;
+      const name = typeof cartName === "string" ? cartName.trim() : "";
+      return name ? { id, name, logoUrl: null, avatarUrl: null } : null;
+    } catch {
+      return null;
+    }
+  }
   /**
    * Get a CommerceClient scoped to a specific sponsor (via bootstrap).
    * Throws if bootstrap hasn't been called or the sponsor is unknown.
@@ -8284,20 +8732,7 @@ var VioFacade = class {
     }, SLOT_DECLARATION_DEBOUNCE_MS);
   }
   findSponsor(sponsorId) {
-    const boot = this.cachedBootstrap;
-    if (!boot) return void 0;
-    const id = Number(sponsorId);
-    if (Number(boot.primarySponsor?.id) === id) return boot.primarySponsor;
-    const secondary = boot.secondarySponsors?.find((s) => Number(s.id) === id);
-    if (secondary) return secondary;
-    const campaigns = Array.isArray(boot.campaigns) ? boot.campaigns : [];
-    for (const c of campaigns) {
-      if (!c || typeof c !== "object") continue;
-      if (Number(c.primarySponsor?.id) === id) return c.primarySponsor ?? void 0;
-      const s = Array.isArray(c.secondarySponsors) ? c.secondarySponsors.find((x) => Number(x?.id) === id) : void 0;
-      if (s) return s;
-    }
-    return void 0;
+    return findSponsorIn(this.cachedBootstrap, sponsorId);
   }
 };
 function warn(...args) {
@@ -8358,6 +8793,6 @@ function vippsButtonAttributes(verb = "buy", opts = {}) {
   };
 }
 
-export { ADD_ITEM_MUTATION, ADYEN_RETURN_METHOD, ADYEN_RETURN_QUERY_KEYS, AdyenOriginError, AnalyticsManager, BUYER_REF_MAX_LENGTH, CHECKOUT_ATTRIBUTION_CAPS, CLIENT_LANDING_URL_MAX_LENGTH, CONTENT_URL_MAX_LENGTH, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GRAPHQL_INT_MAX, KUSTOM_RETURN_QUERY_KEYS, LINE_ORIGIN_CAPS, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_ITEM_WITH_ORIGIN_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, __decorateClass, activeCampaignEntry, addItem, adyenReturnOutcome, adyenReturnParams, autoSlotDisplayName, autoSlotId, buyerRefOf, campaignCandidates, capContentUrl, cartSlicesFrom, checkApplePayAvailability, checkoutAttributionOf, componentKindOf, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, dominantCampaignOf, ensureVippsButton, entryContextOf, executeCartGraphQL, formatPrice, gatewayHas, gatewayHasBuyerRef, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCheckoutReference, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, isUnknownFeatureError, isUnknownTokenError, kustomReturnOutcome, landingUrl, lineOriginWire, lineOrigins, nexiReturnPaymentId, normalizeBuyerRef, normalizeOrigin, normalizeScope, normalizeSlotId, normalizeSlotKind, originAndPath, primaryImageUrl, purchaseFromPaymentSuccess, readNexiPending, resetGatewayFeatures, resolveCampaignId, resolveClientContext, resolveContent, resolveLanding, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, storedLanding, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes, withGatewayFeature };
-//# sourceMappingURL=chunk-NXIYIY2D.js.map
-//# sourceMappingURL=chunk-NXIYIY2D.js.map
+export { ADD_ITEM_MUTATION, ADYEN_RETURN_METHOD, ADYEN_RETURN_QUERY_KEYS, AdyenOriginError, AnalyticsManager, BUYER_REF_MAX_LENGTH, CHECKOUT_ATTRIBUTION_CAPS, CHECKOUT_SPONSOR_STORAGE_KEY, CLIENT_LANDING_URL_MAX_LENGTH, CONTENT_URL_MAX_LENGTH, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GRAPHQL_INT_MAX, KUSTOM_RETURN_QUERY_KEYS, LINE_ORIGIN_CAPS, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_ITEM_WITH_ORIGIN_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, __decorateClass, activeCampaignEntry, addItem, adyenReturnOutcome, adyenReturnParams, autoSlotDisplayName, autoSlotId, buyerRefOf, campaignCandidates, capContentUrl, cartSlicesFrom, checkApplePayAvailability, checkoutAttributionOf, checkoutSponsorOf, componentKindOf, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, dominantCampaignOf, ensureVippsButton, entryContextOf, executeCartGraphQL, formatPrice, gatewayHas, gatewayHasBuyerRef, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCheckoutReference, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, isUnknownFeatureError, isUnknownTokenError, kustomReturnOutcome, landingUrl, lineOriginWire, lineOrigins, nexiReturnPaymentId, normalizeBuyerRef, normalizeOrigin, normalizeScope, normalizeSlotId, normalizeSlotKind, originAndPath, primaryImageUrl, purchaseFromPaymentSuccess, purchaseIdsOf, readNexiPending, rememberedCheckoutSponsor, resetGatewayFeatures, resolveCampaignId, resolveClientContext, resolveContent, resolveLanding, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, sponsorIdentityFrom, storedLanding, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes, withGatewayFeature };
+//# sourceMappingURL=chunk-AFJ5M53F.js.map
+//# sourceMappingURL=chunk-AFJ5M53F.js.map