@vio-live/web-sdk 0.27.0 → 0.28.0

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

@@ -2930,6 +2930,15 @@ function urlOrNull(value) {
   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() : "";
 }
@@ -2958,7 +2967,16 @@ function sponsorIdentityFrom(boot, sponsorId) {
     const name = nameOf(sponsor.name);
     const logoUrl = urlOrNull(sponsor.logoUrl);
     if (!name && !logoUrl) return null;
-    return { id, name, logoUrl, avatarUrl: urlOrNull(sponsor.avatarUrl) };
+    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;
   }
@@ -3249,7 +3267,7 @@ async function prepareApplePay(config) {
 }
 
 // src/core/version.ts
-var SDK_VERSION = "0.27.0";
+var SDK_VERSION = "0.28.0";
 
 // src/core/checkout/payments/stripe-embedded.ts
 var CREATE_PAYMENT_INTENT_STRIPE_MUTATION = `
@@ -6150,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 {
@@ -6979,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;
@@ -7013,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. */
@@ -7062,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();
@@ -7083,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);
@@ -7230,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
@@ -7469,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 = [];
@@ -7728,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;
@@ -8589,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, 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, readNexiPending, rememberedCheckoutSponsor, resetGatewayFeatures, resolveCampaignId, resolveClientContext, resolveContent, resolveLanding, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, sponsorIdentityFrom, storedLanding, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes, withGatewayFeature };
-//# sourceMappingURL=chunk-HJRIPCWB.js.map
-//# sourceMappingURL=chunk-HJRIPCWB.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