@vio-live/web-sdk 0.21.0 → 0.23.0

package/dist/{chunk-WTVGVDZX.js → chunk-AMDI7KH3.js}

@@ -46,6 +46,9 @@ var ConfigurationSingleton = class {
     this.resolved = {
       apiKey: input.apiKey,
       environment: env,
+      platform: input.platform ?? "web",
+      contentId: input.contentId,
+      contentTitle: input.contentTitle,
       apiBase: input.apiBase ?? defaults.apiBase,
       graphQLBase: input.graphQLBase ?? defaults.graphQLBase,
       eventsBase: input.eventsBase ?? defaults.eventsBase,
@@ -58,6 +61,7 @@ var ConfigurationSingleton = class {
       const masked = input.apiKey.length > 4 ? "*".repeat(Math.max(0, input.apiKey.length - 4)) + input.apiKey.slice(-4) : "****";
       console.info("[Vio] Initialized", {
         environment: env,
+        platform: this.resolved.platform,
         apiBase: this.resolved.apiBase,
         apiKey: masked,
         stripeConfigured: !!input.stripePublishableKey,
@@ -118,9 +122,21 @@ var VioApi = class {
   /**
    * Bootstrap — fetches client app config (sponsors with commerce keys,
    * default market, campaign id). Called once at SDK init.
+   *
+   * With `platform`, `campaigns[].slots[]` only lists the assignments of that
+   * platform (plus the ones with no platform) — see ADR-0027.
    */
-  async bootstrap() {
-    return this.get("/v2/mobile/config");
+  async bootstrap(platform) {
+    const query = platform ? `?platform=${encodeURIComponent(platform)}` : "";
+    return this.get(`/v2/mobile/config${query}`);
+  }
+  /**
+   * Declare the slots of this page to the campaigns service
+   * (`POST /v2/mobile/components/manifest`, ADR-0034). The web SDK always
+   * sends `mode: 'merge'`; see `Vio.declareSlots()` for the dedupe on top.
+   */
+  async declareManifest(body) {
+    return this.post("/v2/mobile/components/manifest", body);
   }
   /**
    * Get placement components for a campaign. Used by the carousel auto-fetch
@@ -146,6 +162,22 @@ var VioApi = class {
     }
     return await res.json();
   }
+  async post(path, body) {
+    const url = `${this.apiBase}${path}`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "X-API-Key": this.apiKey,
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw new VioApiError(res.status, await safeText(res), `POST ${path}`);
+    }
+    return await res.json();
+  }
 };
 var VioApiError = class extends Error {
   constructor(status, body, endpoint) {
@@ -1385,23 +1417,40 @@ function getCustomerSessionId() {
   }
   return id;
 }
+var CART_GRAPHQL_TIMEOUT_MS = 15e3;
 async function executeCartGraphQL(query, variables, options = {}) {
   const resolvedOptions = typeof options === "number" ? await getCartGraphQLOptions(options) : !options.apiKey && !options.commerceKey ? { ...await getCartGraphQLOptions(), ...options } : options;
   const { endpoint = "https://graph-ql-dev.vio.live", apiKey, commerceKey } = resolvedOptions;
   const headers = { "Content-Type": "application/json" };
   if (apiKey) headers["X-API-Key"] = apiKey;
   if (commerceKey || apiKey) headers["Authorization"] = commerceKey || apiKey;
-  const res = await fetch(endpoint, {
-    method: "POST",
-    headers,
-    body: JSON.stringify({ query, variables })
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+  let timer;
+  const timedOut = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      reject(new Error(`GraphQL request timed out after ${CART_GRAPHQL_TIMEOUT_MS}ms`));
+    }, CART_GRAPHQL_TIMEOUT_MS);
   });
-  const json = await res.json().catch(() => ({}));
-  if (!res.ok || json.errors) {
-    const errMsg = json.errors?.[0]?.message || `GraphQL request failed (HTTP ${res.status})`;
-    throw new Error(errMsg);
+  try {
+    const res = await Promise.race([
+      fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ query, variables }),
+        signal: controller?.signal
+      }),
+      timedOut
+    ]);
+    const json = await Promise.race([res.json().catch(() => ({})), timedOut]);
+    if (!res.ok || json.errors) {
+      const errMsg = json.errors?.[0]?.message || `GraphQL request failed (HTTP ${res.status})`;
+      throw new Error(errMsg);
+    }
+    return json;
+  } finally {
+    clearTimeout(timer);
   }
-  return json;
 }
 async function createCart(customerSessionId, currency, shippingCountry, options) {
   const json = await executeCartGraphQL(
@@ -1581,6 +1630,14 @@ var CartManager = class extends EventTarget {
      * landed (Alan, 2026-08-18: shippings queried before AddItem settled,
      * came back empty). */
     this.inFlightMutations = /* @__PURE__ */ new Map();
+    /** Per-line quantity sync with the backend: at most ONE UpdateItem /
+     * DeleteItem in flight per line. Targets that arrive while one is in flight
+     * are coalesced into `pending` (only the latest survives) and sent when the
+     * current request settles. Keyed by `${sponsorId}:${cartItemId}`.
+     * (Alan, 2026-10-15: a burst of +/− clicks fired one UpdateItem per click
+     * in parallel; each response re-applied the whole backend cart, so an
+     * older one landing after a newer optimistic change rolled the line back.) */
+    this.qtySyncs = /* @__PURE__ */ new Map();
     /** Quantity intents for lines whose backend id hasn't arrived yet — replayed
      * when the AddItem response reconciles (keyed by product::variant). */
     this.pendingQtyIntents = /* @__PURE__ */ new Map();
@@ -1591,21 +1648,75 @@ var CartManager = class extends EventTarget {
     this.mutationSeq.set(sponsorId, n);
     return n;
   }
-  /** Resolves once any in-flight AddItem/UpdateItem/DeleteItem for this
-   * sponsor has settled (success or failure). No-op if nothing is pending. */
+  /** Resolves once every in-flight AddItem/UpdateItem/DeleteItem for this
+   * sponsor has settled (success or failure), including ones started while
+   * waiting (a quantity intent replayed by an AddItem reconcile). No-op if
+   * nothing is pending. */
   async waitForCartMutations(sponsorId) {
-    const p = this.inFlightMutations.get(sponsorId);
-    if (!p) return;
-    try {
-      await p;
-    } catch {
-    }
+    for (; ; ) {
+      const set = this.inFlightMutations.get(sponsorId);
+      if (!set || set.size === 0) return;
+      await Promise.allSettled([...set]);
+    }
+  }
+  /** Register a backend mutation so `waitForCartMutations` can await it. */
+  trackMutation(sponsorId, mutation) {
+    let set = this.inFlightMutations.get(sponsorId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.inFlightMutations.set(sponsorId, set);
+    }
+    const tracked = set;
+    tracked.add(mutation);
+    const untrack = () => {
+      tracked.delete(mutation);
+      if (tracked.size === 0 && this.inFlightMutations.get(sponsorId) === tracked) {
+        this.inFlightMutations.delete(sponsorId);
+      }
+    };
+    mutation.then(untrack, untrack);
   }
-  /** Apply a backend response only if no newer response was applied already. */
+  qtySyncKey(sponsorId, cartItemId) {
+    return `${sponsorId}:${cartItemId}`;
+  }
+  /** The quantity a line is heading to (pending beats in flight), or
+   * undefined when no quantity sync is active for it. */
+  intendedQuantity(sponsorId, cartItemId) {
+    const sync = this.qtySyncs.get(this.qtySyncKey(sponsorId, cartItemId));
+    return sync ? sync.pending ?? sync.sent : void 0;
+  }
+  /** Apply a backend response only if no newer response was applied already.
+   * Returns false when it was discarded as stale. */
   applyBackendCart(sponsorId, backendCart, seq) {
-    if (seq < (this.appliedSeq.get(sponsorId) ?? 0)) return;
+    if (seq < (this.appliedSeq.get(sponsorId) ?? 0)) return false;
     this.appliedSeq.set(sponsorId, seq);
     this.updateFromBackendCart(sponsorId, backendCart);
+    return true;
+  }
+  /** The final answer of a line's sync lost the per-sponsor seq race (another
+   * line answered later): the cart as a whole is stale, but for THIS line it
+   * is the latest word. Copy its quantity (and price) so a server-side clamp
+   * — stock — doesn't leave the optimistic value behind for good, with the
+   * checkout / Apple Pay total built on it. */
+  reconcileLineFromResponse(sponsorId, cartItemId, resCart) {
+    const cart = this.cartsBySponsor.get(sponsorId);
+    const line = cart?.items.find((i) => i.cartItemId === cartItemId || i.id === cartItemId);
+    const server = resCart.line_items?.find((li) => li.id === cartItemId);
+    if (!cart || !line || !server) return;
+    const price = server.price?.amount_incl_taxes ?? server.price?.amount;
+    let changed = false;
+    if (server.quantity !== line.quantity) {
+      line.quantity = server.quantity;
+      line.origins = reconciledOrigins(line.origins, server.quantity);
+      changed = true;
+    }
+    if (price != null && price !== line.unitPrice) {
+      line.unitPrice = price;
+      changed = true;
+    }
+    if (!changed) return;
+    this.persist();
+    this.emit();
   }
   /** Surface a cart sync problem to hosts/UI (and the console). */
   emitError(message, err) {
@@ -1684,6 +1795,7 @@ var CartManager = class extends EventTarget {
     if (backendCart.available_shipping_countries) {
       cart.availableShippingCountries = backendCart.available_shipping_countries;
     }
+    const removedBeforeSync = [];
     if (Array.isArray(backendCart.line_items)) {
       const existingItems = cart.items || [];
       if (backendCart.line_items.length === 0 && existingItems.length > 0) {
@@ -1691,7 +1803,16 @@ var CartManager = class extends EventTarget {
         this.emit();
         return;
       }
-      cart.items = backendCart.line_items.map((li) => {
+      cart.items = backendCart.line_items.flatMap((li) => {
+        const intended = this.intendedQuantity(sponsorId, li.id);
+        if (intended !== void 0 && intended <= 0) return [];
+        const earlyKey = this.intentKey(li.product_id, li.variant_id);
+        const earlyIntent = this.pendingQtyIntents.get(earlyKey);
+        if (earlyIntent !== void 0 && earlyIntent <= 0) {
+          this.pendingQtyIntents.delete(earlyKey);
+          removedBeforeSync.push(li.id);
+          return [];
+        }
         const urlFromBackend = (typeof li.image === "string" ? li.image : li.image?.url) || li.imageUrl || li.image_url || "";
         const matchedLocal = existingItems.find((existing) => {
           const p1 = normId(existing.productId);
@@ -1707,7 +1828,7 @@ var CartManager = class extends EventTarget {
           return false;
         });
         const imageUrl = urlFromBackend || matchedLocal?.imageUrl || "";
-        return {
+        const line = {
           id: li.id,
           cartItemId: li.id,
           productId: li.product_id,
@@ -1718,14 +1839,22 @@ var CartManager = class extends EventTarget {
           unitPrice: li.price?.amount_incl_taxes ?? li.price?.amount ?? matchedLocal?.unitPrice ?? 0,
           currency: li.price?.currency_code || backendCart.currency || matchedLocal?.currency || "NOK",
           imageUrl,
-          quantity: li.quantity,
+          quantity: intended ?? li.quantity,
+          // The server knows nothing about origins: keep the local ones,
+          // squared with the quantity it answered.
+          origins: matchedLocal ? reconciledOrigins(matchedLocal.origins, intended ?? li.quantity) : void 0,
           shipping: li.shipping,
           availableShippings: li.available_shippings
         };
+        return [line];
       });
     }
     this.persist();
     this.emit();
+    const syncedCartId = cart.cartId;
+    if (syncedCartId) {
+      for (const id of removedBeforeSync) this.syncQuantity(sponsorId, syncedCartId, id, 0);
+    }
     if (this.pendingQtyIntents.size > 0) {
       const currentCart = this.cartsBySponsor.get(sponsorId);
       for (const [key, qty] of [...this.pendingQtyIntents]) {
@@ -1761,7 +1890,8 @@ var CartManager = class extends EventTarget {
       currency: price.currency_code,
       imageUrl,
       quantity: opts.quantity,
-      variantId: opts.variantId
+      variantId: opts.variantId,
+      origin: opts.origin
     });
   }
   /** Add a manually-specified line item (no Product DTO). */
@@ -1794,6 +1924,7 @@ var CartManager = class extends EventTarget {
     });
     if (existing) {
       existing.quantity += qty;
+      addOriginQuantity(existing, opts.origin, qty);
     } else {
       const item = {
         id: lineId(),
@@ -1805,7 +1936,8 @@ var CartManager = class extends EventTarget {
         unitPrice: opts.unitPrice,
         currency: opts.currency,
         imageUrl: opts.imageUrl,
-        quantity: qty
+        quantity: qty,
+        origins: [{ ...normalizeOrigin(opts.origin), quantity: qty }]
       };
       cart.items.push(item);
     }
@@ -1836,6 +1968,7 @@ var CartManager = class extends EventTarget {
         const line = c?.items.find((i) => i.id === addedLineId);
         if (c && line) {
           line.quantity -= qty;
+          removeOriginQuantity(line, qty);
           if (line.quantity <= 0) c.items = c.items.filter((i) => i !== line);
           if (c.items.length === 0) this.cartsBySponsor.delete(opts.sponsorId);
           this.persist();
@@ -1844,24 +1977,39 @@ var CartManager = class extends EventTarget {
         this.emitError("AddItem rejected by the backend \u2014 item removed from the cart", err);
       }
     })();
-    this.inFlightMutations.set(opts.sponsorId, mutation);
-    void mutation.finally(() => {
-      if (this.inFlightMutations.get(opts.sponsorId) === mutation) {
-        this.inFlightMutations.delete(opts.sponsorId);
-      }
-    });
+    this.trackMutation(opts.sponsorId, mutation);
     return addedItem;
   }
   intentKey(productId, variantId) {
     return `${normId(productId)}::${normId(variantId)}`;
   }
-  updateQuantity(lineItemId, sponsorId, quantity) {
+  findLine(sponsorId, lineItemId) {
+    return this.cartsBySponsor.get(sponsorId)?.items.find((i) => i.id === lineItemId || i.cartItemId === lineItemId);
+  }
+  /** Change a line's quantity by `delta`, computed on the manager's CURRENT
+   * quantity — not on whatever a UI rendered a moment ago. A burst of +/−
+   * clicks before a re-render therefore asks for 2, 3, 4… and not for the
+   * same target several times. Reaching 0 removes the line. */
+  adjustQuantity(lineItemId, sponsorId, delta, opts = {}) {
+    const item = this.findLine(sponsorId, lineItemId);
+    if (!item) return;
+    this.updateQuantity(lineItemId, sponsorId, item.quantity + delta, opts);
+  }
+  /** Set a line's quantity (0 or less removes it). Optimistic: the local
+   * state and `change` update at once; the backend is synced through
+   * `syncQuantity`, one request in flight per line, latest target wins. */
+  updateQuantity(lineItemId, sponsorId, quantity, opts = {}) {
     const cart = this.cartsBySponsor.get(sponsorId);
     if (!cart) return;
     const item = cart.items.find((i) => i.id === lineItemId || i.cartItemId === lineItemId);
     if (!item) return;
+    const target = quantity > 0 ? quantity : 0;
+    if (target === item.quantity) return;
     const targetItemId = item.cartItemId;
-    if (quantity <= 0) {
+    const removedOrigin = latestOrigin(item);
+    if (target > item.quantity) addOriginQuantity(item, opts.origin, target - item.quantity);
+    else removeOriginQuantity(item, item.quantity - target);
+    if (target <= 0) {
       cart.items = cart.items.filter((i) => i !== item);
       if (typeof document !== "undefined") {
         document.dispatchEvent(
@@ -1875,42 +2023,84 @@ var CartManager = class extends EventTarget {
               price: item.unitPrice,
               quantity: item.quantity,
               currency: item.currency,
-              sponsorId
+              sponsorId,
+              // Attribution of the removed units: their most recent origin.
+              slot: removedOrigin?.slot,
+              campaignId: removedOrigin?.campaignId,
+              contentId: removedOrigin?.contentId
             }
           })
         );
       }
     } else {
-      item.quantity = quantity;
+      item.quantity = target;
     }
     if (cart.items.length === 0) this.cartsBySponsor.delete(sponsorId);
     this.persist();
     this.emit();
     if (!cart.cartId) return;
     if (!targetItemId) {
-      this.pendingQtyIntents.set(this.intentKey(item.productId, item.variantId), quantity);
+      this.pendingQtyIntents.set(this.intentKey(item.productId, item.variantId), target);
       return;
     }
-    const backendCartId = cart.cartId;
-    const seq = this.nextSeq(sponsorId);
-    const mutation = (async () => {
-      try {
-        const gqlOpts = await getCartGraphQLOptions(sponsorId);
-        const resCart = quantity <= 0 ? await deleteItem(backendCartId, targetItemId, gqlOpts) : await updateItem(backendCartId, targetItemId, null, quantity, gqlOpts);
-        if (resCart && Array.isArray(resCart.line_items)) {
-          this.applyBackendCart(sponsorId, resCart, seq);
+    this.syncQuantity(sponsorId, cart.cartId, targetItemId, target);
+  }
+  /** Send a line's target quantity to the backend — ONE request in flight per
+   * line. A target that arrives while one is in flight replaces any earlier
+   * waiting one and goes out when the current request settles, so the server
+   * ends on the last intent and never sees two updates racing each other.
+   * While the sync is active the line keeps its optimistic quantity through
+   * any backend response (see `updateFromBackendCart`); a rejection drops
+   * what was queued and reconciles the cart from the server. */
+  syncQuantity(sponsorId, backendCartId, cartItemId, target) {
+    const key = this.qtySyncKey(sponsorId, cartItemId);
+    const active = this.qtySyncs.get(key);
+    if (active) {
+      active.pending = target;
+      return;
+    }
+    const sync = { sent: target };
+    this.qtySyncs.set(key, sync);
+    const run = (async () => {
+      let next = target;
+      let removalRetried = false;
+      while (next !== void 0) {
+        sync.sent = next;
+        sync.pending = void 0;
+        const seq = this.nextSeq(sponsorId);
+        try {
+          const gqlOpts = await getCartGraphQLOptions(sponsorId);
+          const resCart = next <= 0 ? await deleteItem(backendCartId, cartItemId, gqlOpts) : await updateItem(backendCartId, cartItemId, null, next, gqlOpts);
+          next = sync.pending;
+          if (next === sync.sent) next = void 0;
+          if (next === void 0) this.qtySyncs.delete(key);
+          if (resCart && Array.isArray(resCart.line_items)) {
+            const applied = this.applyBackendCart(sponsorId, resCart, seq);
+            if (!applied && next === void 0) {
+              this.reconcileLineFromResponse(sponsorId, cartItemId, resCart);
+            }
+          }
+        } catch (err) {
+          const retryRemoval = !removalRetried && sync.pending !== void 0 && sync.pending <= 0;
+          next = void 0;
+          if (retryRemoval) {
+            removalRetried = true;
+            sync.sent = 0;
+            sync.pending = void 0;
+            next = 0;
+          } else {
+            this.qtySyncs.delete(key);
+          }
+          this.emitError("Update/DeleteItem failed \u2014 cart re-synced from backend", err);
+          try {
+            await this.fetchCartFromBackend(sponsorId);
+          } catch (fetchErr) {
+            this.emitError("cart re-sync after a rejected Update/DeleteItem failed", fetchErr);
+          }
         }
-      } catch (err) {
-        this.emitError("Update/DeleteItem failed \u2014 cart re-synced from backend", err);
-        void this.fetchCartFromBackend(sponsorId);
       }
     })();
-    this.inFlightMutations.set(sponsorId, mutation);
-    void mutation.finally(() => {
-      if (this.inFlightMutations.get(sponsorId) === mutation) {
-        this.inFlightMutations.delete(sponsorId);
-      }
-    });
+    this.trackMutation(sponsorId, run);
   }
   removeItem(lineItemId, sponsorId) {
     this.updateQuantity(lineItemId, sponsorId, 0);
@@ -2021,6 +2211,68 @@ var CartManager = class extends EventTarget {
     this.dispatchEvent(new CustomEvent("change", { detail }));
   }
 };
+function normalizeOrigin(origin) {
+  const out = {};
+  if (!origin || typeof origin !== "object") return out;
+  const campaignId = Number(origin.campaignId);
+  if (origin.campaignId !== void 0 && origin.campaignId !== null && Number.isFinite(campaignId)) {
+    out.campaignId = campaignId;
+  }
+  if (typeof origin.slot === "string" && origin.slot.trim()) out.slot = origin.slot.trim();
+  if (origin.contentId !== void 0 && origin.contentId !== null && String(origin.contentId).trim()) {
+    out.contentId = String(origin.contentId).trim();
+  }
+  return out;
+}
+function sameOrigin(a, b) {
+  return a.campaignId === b.campaignId && a.slot === b.slot && a.contentId === b.contentId;
+}
+function latestOrigin(line) {
+  const origins = Array.isArray(line.origins) ? line.origins : [];
+  return origins[origins.length - 1];
+}
+function addOriginQuantity(line, origin, qty) {
+  if (!(qty > 0)) return;
+  const origins = Array.isArray(line.origins) ? line.origins : [];
+  const target = origin ? normalizeOrigin(origin) : latestOrigin({ origins });
+  const index = target ? origins.findIndex((o) => sameOrigin(o, target)) : -1;
+  if (index >= 0) {
+    const [found] = origins.splice(index, 1);
+    found.quantity += qty;
+    origins.push(found);
+  } else {
+    origins.push({ ...target ?? {}, quantity: qty });
+  }
+  line.origins = origins;
+}
+function removeOriginQuantity(line, qty) {
+  if (!(qty > 0) || !Array.isArray(line.origins)) return;
+  let left = qty;
+  const origins = line.origins;
+  while (left > 0 && origins.length > 0) {
+    const last = origins[origins.length - 1];
+    const take = Math.min(last.quantity, left);
+    last.quantity -= take;
+    left -= take;
+    if (last.quantity <= 0) origins.pop();
+  }
+}
+function reconciledOrigins(origins, quantity) {
+  if (!Array.isArray(origins)) return void 0;
+  const copy = origins.map((o) => ({ ...o }));
+  const total = copy.reduce((sum, o) => sum + (o.quantity > 0 ? o.quantity : 0), 0);
+  const line = { origins: copy };
+  if (quantity > total) addOriginQuantity(line, void 0, quantity - total);
+  else if (quantity < total) removeOriginQuantity(line, total - quantity);
+  return line.origins;
+}
+function lineOrigins(line) {
+  const known = (Array.isArray(line.origins) ? line.origins : []).filter((o) => o && o.quantity > 0);
+  const total = known.reduce((sum, o) => sum + o.quantity, 0);
+  const quantity = line.quantity > 0 ? line.quantity : 0;
+  if (total >= quantity) return known.map((o) => ({ ...o }));
+  return [...known.map((o) => ({ ...o })), { quantity: quantity - total }];
+}
 
 // src/core/checkout/payments/apple-pay.ts
 var STRIPE_JS_URL = "https://js.stripe.com/v3";
@@ -2218,7 +2470,7 @@ async function prepareApplePay(config) {
 }
 
 // src/core/version.ts
-var SDK_VERSION = "0.21.0";
+var SDK_VERSION = "0.23.0";
 
 // src/core/checkout/payments/stripe-embedded.ts
 var CREATE_PAYMENT_INTENT_STRIPE_MUTATION = `
@@ -2726,8 +2978,8 @@ function renderKustomSnippet(container, htmlSnippet) {
   const scripts = Array.from(container.querySelectorAll("script"));
   for (const oldScript of scripts) {
     const newScript = document.createElement("script");
-    for (const attr of Array.from(oldScript.attributes)) {
-      newScript.setAttribute(attr.name, attr.value);
+    for (const attr2 of Array.from(oldScript.attributes)) {
+      newScript.setAttribute(attr2.name, attr2.value);
     }
     newScript.text = oldScript.text;
     oldScript.parentNode?.replaceChild(newScript, oldScript);
@@ -3785,6 +4037,7 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
   /* eslint-disable @typescript-eslint/no-explicit-any */
   /** Create the backend checkout for the sponsor's cart (auto-accepts terms). */
   async createCheckout(sponsorId) {
+    await this.cartManager.waitForCartMutations(sponsorId);
     const cart = this.cartManager.getCart(sponsorId);
     let cartId = cart?.cartId;
     if (!cartId) {
@@ -3977,6 +4230,7 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
   async prepareRedirectPayment(sponsorId, formData, extraUpdateVars = {}) {
     const spId = sponsorId ?? this.state?.sponsorId;
     if (!spId) throw new Error("[CheckoutManager] no sponsor for payment");
+    await this.cartManager.waitForCartMutations(spId);
     const cart = this.cartManager.getCart(spId);
     let cartId = cart?.cartId;
     if (!cartId) {
@@ -4091,6 +4345,8 @@ var CheckoutManager = class _CheckoutManager extends EventTarget {
    * plain payment once the shopper chose one in our form.
    */
   async startVippsPayment(sponsorId, formData, options = {}) {
+    const waitFor = sponsorId ?? this.state?.sponsorId;
+    if (waitFor) await this.cartManager.waitForCartMutations(waitFor);
     const { spId, checkoutId, emailVal, opts } = await this.prepareRedirectPayment(
       sponsorId,
       formData,
@@ -5588,6 +5844,194 @@ function toSmallestUnit(amount, currency) {
   return Math.round(amount * 100);
 }
 
+// src/core/content.ts
+var CONTENT_ID_QUERY = "vio_content";
+var CONTENT_TITLE_QUERY = "vio_content_title";
+function resolveContent(init, doc = typeof document !== "undefined" ? document : null, loc = typeof location !== "undefined" ? location : null) {
+  try {
+    const query = parseQuery(loc?.search);
+    const id = text(init?.contentId) ?? text(query.get(CONTENT_ID_QUERY)) ?? text(meta(doc, "name", "vio:content-id")) ?? stripQueryAndHash(text(attr(doc, 'link[rel="canonical"]', "href")) ?? text(meta(doc, "property", "og:url"))) ?? text(loc?.pathname);
+    const title = text(init?.contentTitle) ?? text(query.get(CONTENT_TITLE_QUERY)) ?? text(meta(doc, "name", "vio:content-title")) ?? text(meta(doc, "property", "og:title")) ?? text(doc?.title);
+    const out = {};
+    if (id !== void 0) out.id = id;
+    if (title !== void 0) out.title = title.slice(0, 255);
+    return out;
+  } catch {
+    return {};
+  }
+}
+function text(value) {
+  if (value === void 0 || value === null) return void 0;
+  const s = String(value).trim();
+  return s ? s : void 0;
+}
+function parseQuery(search) {
+  try {
+    return new URLSearchParams(typeof search === "string" ? search : "");
+  } catch {
+    return new URLSearchParams();
+  }
+}
+function meta(doc, key, value) {
+  return attr(doc, `meta[${key}="${value}"]`, "content");
+}
+function attr(doc, selector, name) {
+  try {
+    if (!doc || typeof doc.querySelector !== "function") return void 0;
+    const el = doc.querySelector(selector);
+    const v = el?.getAttribute?.(name);
+    return typeof v === "string" ? v : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function stripQueryAndHash(url) {
+  if (!url) return void 0;
+  const cut = url.search(/[?#]/);
+  const clean = cut >= 0 ? url.slice(0, cut) : url;
+  return clean.trim() || void 0;
+}
+
+// src/core/slots.ts
+var SLOT_ID_MAX_LENGTH = 100;
+var SLOT_DECLARATION_TTL_MS = 24 * 60 * 60 * 1e3;
+function resolveSlotCampaign(boot, slot, now = Date.now(), platform) {
+  if (!boot) return null;
+  return findSlotAssignment(boot, slot, now, platform) ?? defaultCampaignEntry(boot);
+}
+function findSlotAssignment(boot, slot, now = Date.now(), platform) {
+  const name = typeof slot === "string" ? slot.trim() : "";
+  if (!boot || !name) return null;
+  try {
+    const matches = activeCampaigns(boot).filter(
+      (c) => slotsOf(c).some((s) => assignmentMatches(s, name, now, platform))
+    );
+    if (matches.length === 0) return null;
+    const defaultId = toNumber(boot.campaign?.id);
+    return matches.find((c) => toNumber(c.id) === defaultId) ?? matches[0] ?? null;
+  } catch {
+    return null;
+  }
+}
+function defaultCampaignEntry(boot) {
+  if (!boot?.campaign || typeof boot.campaign !== "object") return null;
+  const defaultId = toNumber(boot.campaign.id);
+  if (defaultId === void 0) return null;
+  try {
+    const listed = wellFormedCampaigns(boot).find((c) => toNumber(c.id) === defaultId);
+    if (listed) return listed;
+  } catch {
+  }
+  return {
+    ...boot.campaign,
+    isDefault: true,
+    primarySponsor: boot.primarySponsor ?? null,
+    secondarySponsors: Array.isArray(boot.secondarySponsors) ? boot.secondarySponsors : [],
+    slots: []
+  };
+}
+function wellFormedCampaigns(boot) {
+  const list = Array.isArray(boot.campaigns) ? boot.campaigns : [];
+  return list.filter((c) => !!c && typeof c === "object");
+}
+function activeCampaigns(boot) {
+  return wellFormedCampaigns(boot).filter((c) => c.status === "active");
+}
+function slotsOf(campaign) {
+  const slots = Array.isArray(campaign.slots) ? campaign.slots : [];
+  return slots.filter((s) => !!s && typeof s === "object");
+}
+function assignmentMatches(s, name, now, platform) {
+  if (typeof s.name !== "string" || s.name.trim() !== name) return false;
+  if (platform && s.platform != null && s.platform !== platform) return false;
+  const start = parseTime(s.startDate);
+  if (start !== void 0 && start > now) return false;
+  const end = parseTime(s.endDate);
+  if (end !== void 0 && now >= end) return false;
+  return true;
+}
+function parseTime(value) {
+  if (value == null || value === "") return void 0;
+  const t = Date.parse(String(value));
+  return Number.isFinite(t) ? t : void 0;
+}
+function toNumber(value) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
+function normalizeSlotId(value) {
+  if (typeof value !== "string") return "";
+  return value.trim().slice(0, SLOT_ID_MAX_LENGTH);
+}
+function normalizeSlotLocations(slots) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  if (!Array.isArray(slots)) return out;
+  for (const raw of slots) {
+    const id = normalizeSlotId(typeof raw === "string" ? raw : raw?.id);
+    if (!id || seen.has(id)) continue;
+    seen.add(id);
+    const displayName = raw && typeof raw === "object" && typeof raw.displayName === "string" ? raw.displayName.trim() : "";
+    out.push(displayName ? { id, displayName } : { id });
+  }
+  return out;
+}
+function autoSlotId(kind, ordinal, scope) {
+  const prefix = normalizeScope(scope);
+  return `${prefix ? `${prefix}-` : ""}${kind}-${ordinal + 1}`;
+}
+function autoSlotDisplayName(kind, ordinal, scopeName) {
+  const label = `${kind.charAt(0).toUpperCase()}${kind.slice(1)} ${ordinal + 1}`;
+  const name = typeof scopeName === "string" ? scopeName.trim() : "";
+  return name ? `${label} \xB7 ${name}` : label;
+}
+function normalizeScope(scope) {
+  if (typeof scope !== "string") return "";
+  return scope.trim().replace(/\s+/g, "-");
+}
+function slotDeclarationKeys(locations) {
+  return locations.map((l) => l.displayName ? `${l.id}${l.displayName}` : l.id).sort();
+}
+function slotDeclarationStorageKey(platform, apiKey) {
+  return `vio.slots.${platform}.${fnv1a(apiKey)}`;
+}
+function fnv1a(input) {
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash.toString(16).padStart(8, "0");
+}
+function readSlotDeclaration(storageKey) {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const raw = localStorage.getItem(storageKey);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.keys) || typeof parsed.at !== "number") return null;
+    return { keys: parsed.keys.filter((x) => typeof x === "string"), at: parsed.at };
+  } catch {
+    return null;
+  }
+}
+function writeSlotDeclaration(storageKey, memory) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(storageKey, JSON.stringify(memory));
+  } catch {
+  }
+}
+function isSlotDeclarationFresh(memory, keys, now = Date.now()) {
+  if (!memory) return false;
+  if (now - memory.at >= SLOT_DECLARATION_TTL_MS || now < memory.at) return false;
+  if (memory.keys.length !== keys.length) return false;
+  const remembered = [...memory.keys].sort();
+  const wanted = [...keys].sort();
+  return remembered.every((key, i) => key === wanted[i]);
+}
+
 // src/core/analytics/analytics-manager.ts
 var SESSION_TTL_MS = 30 * 60 * 1e3;
 var FLUSH_INTERVAL_MS = 5e3;
@@ -5785,22 +6229,25 @@ var AnalyticsManager = class extends EventTarget {
     if (!anonId) return null;
     const boot = vioBootstrapCache();
     const ctx = opts.context ?? {};
+    const content = ctx.contentId === void 0 || ctx.contentTitle === void 0 ? vioContent() : {};
     const context = compact({
       campaign_id: resolveCampaignId(ctx, boot),
       broadcast_id: ctx.broadcastId,
       campaign_component_id: ctx.campaignComponentId,
       app_placement_id: ctx.appPlacementId,
-      location_id: ctx.locationId,
+      // A slot is a location id to the campaigns service (ADR-0027).
+      location_id: ctx.locationId ?? ctx.slot,
       component_template_id: ctx.componentTemplateId,
       sponsor_id: ctx.sponsorId,
       activation_id: ctx.activationId,
       content_url: ctx.contentUrl ?? (typeof location !== "undefined" ? location.href : void 0),
       // The host's own content id — its join key back onto its reporting.
-      content_id: ctx.contentId,
+      // Explicit on the event, else what the SDK resolved for the page.
+      content_id: ctx.contentId ?? content.id,
       // Deletion-proof reporting: sources have no trash bin — the title
       // snapshotted at event time keeps reports legible if content dies.
       error_code: ctx.errorCode,
-      content_title: ctx.contentTitle ?? (typeof document !== "undefined" && document.title ? document.title.slice(0, 255) : void 0),
+      content_title: ctx.contentTitle ?? content.title ?? (typeof document !== "undefined" && document.title ? document.title.slice(0, 255) : void 0),
       variant: ctx.variant
     });
     const com = opts.commerce;
@@ -5948,7 +6395,7 @@ var AnalyticsManager = class extends EventTarget {
       const d = ev.detail ?? {};
       const line = this.findLine(d.productId, d.variantId);
       this.track("add_to_cart", {
-        context: { sponsorId: d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0 },
+        context: { sponsorId: d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0, slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -5969,7 +6416,7 @@ var AnalyticsManager = class extends EventTarget {
       const d = ev.detail ?? {};
       if (d.productId === void 0) return;
       this.track("remove_from_cart", {
-        context: { sponsorId: d.sponsorId },
+        context: { sponsorId: d.sponsorId, slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -5998,7 +6445,7 @@ var AnalyticsManager = class extends EventTarget {
       if (d.productId === void 0) return;
       const price = Number(d.price);
       this.track("select_item", {
-        context: { sponsorId: d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0 },
+        context: { sponsorId: d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0, slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -6017,18 +6464,38 @@ var AnalyticsManager = class extends EventTarget {
     });
     on("vio:checkout-open", (ev) => {
       const d = ev.detail ?? {};
+      const slices = this.cartSlices(d.sponsorId);
+      if (slices.length > 1) {
+        for (const slice of slices) {
+          this.track("begin_checkout", {
+            context: this.sliceContext(slice, { sponsorId: d.sponsorId, slot: slotOf(d), ...contentOf(d) }),
+            commerce: slice.commerce
+          });
+        }
+        return;
+      }
       const snap = this.cartCommerce(d.sponsorId);
       this.track("begin_checkout", {
-        context: { sponsorId: d.sponsorId },
+        context: { sponsorId: d.sponsorId, slot: slotOf(d), ...contentOf(d) },
         ...snap ? { commerce: snap } : {}
       });
     });
     on("vio:payment-success", (ev) => {
       const d = ev.detail ?? {};
       const sponsorId = d.sponsorId !== void 0 ? Number(d.sponsorId) : void 0;
+      const slices = this.cartSlices(sponsorId);
+      if (slices.length > 1) {
+        for (const slice of slices) {
+          this.track("purchase", {
+            context: this.sliceContext(slice, { sponsorId, slot: slotOf(d), ...contentOf(d) }),
+            commerce: { ...slice.commerce, ...purchaseFromPaymentSuccess(d), paymentMethod: d.method }
+          });
+        }
+        return;
+      }
       const snap = this.cartCommerce(sponsorId);
       this.track("purchase", {
-        context: { sponsorId },
+        context: { sponsorId, slot: slotOf(d), ...contentOf(d) },
         commerce: {
           // value / currency / items: the cart snapshot, on every path.
           ...snap ?? {},
@@ -6039,6 +6506,86 @@ var AnalyticsManager = class extends EventTarget {
       });
     });
   }
+  /** The lines of the cart (current, else the pre-clear snapshot), optionally one sponsor's. */
+  cartLines(sponsorId) {
+    let items = [];
+    const cart = vioCart();
+    if (cart) {
+      cart.getAllCarts().forEach((state, id) => {
+        if (sponsorId === void 0 || id === sponsorId) items.push(...state.items);
+      });
+    }
+    if (items.length === 0 && this.lastCartSnapshot) {
+      items = this.lastCartSnapshot.items.filter(
+        (i) => sponsorId === void 0 || i.sponsorId === sponsorId
+      );
+    }
+    return items;
+  }
+  /**
+   * The cart split per campaign (ADR-0034): every unit of every line goes to
+   * the campaign of its origin — the one the place showed when it was added
+   * — and units without one to the campaign the current rule resolves for
+   * the line's sponsor. One slice per campaign: its items (quantities from
+   * the origins), its value, and the slot / content when they are the same
+   * for the whole slice. A cart with one campaign is one slice.
+   */
+  cartSlices(sponsorId) {
+    const lines = this.cartLines(sponsorId);
+    if (lines.length === 0) return [];
+    const boot = vioBootstrapCache();
+    const slices = /* @__PURE__ */ new Map();
+    for (const line of lines) {
+      for (const origin of lineOrigins(line)) {
+        const campaignId = origin.campaignId ?? resolveCampaignId({ slot: origin.slot, sponsorId: line.sponsorId }, boot);
+        const key = campaignId === void 0 ? "default" : String(campaignId);
+        let slice = slices.get(key);
+        if (!slice) {
+          slice = {
+            campaignId,
+            commerce: { items: [], value: 0, currency: line.currency ?? this.lastCartSnapshot?.currency },
+            slots: /* @__PURE__ */ new Set(),
+            contents: /* @__PURE__ */ new Set(),
+            lines: /* @__PURE__ */ new Map()
+          };
+          slices.set(key, slice);
+        }
+        if (origin.slot) slice.slots.add(origin.slot);
+        if (origin.contentId) slice.contents.add(origin.contentId);
+        const itemKey = `${line.productId}::${line.variantId ?? ""}`;
+        const item = slice.lines.get(itemKey);
+        if (item) item.quantity = (item.quantity ?? 0) + origin.quantity;
+        else {
+          const fresh = {
+            productId: line.productId,
+            name: line.name,
+            brand: line.brand,
+            variantId: line.variantId,
+            price: line.unitPrice,
+            quantity: origin.quantity
+          };
+          slice.lines.set(itemKey, fresh);
+          slice.commerce.items.push(fresh);
+        }
+        slice.commerce.value = (slice.commerce.value ?? 0) + line.unitPrice * origin.quantity;
+      }
+    }
+    return [...slices.values()].map((s) => ({
+      campaignId: s.campaignId,
+      slot: s.slots.size === 1 ? [...s.slots][0] : void 0,
+      contentId: s.contents.size === 1 ? [...s.contents][0] : void 0,
+      commerce: s.commerce
+    }));
+  }
+  /** The context of a per-campaign event: the slice's campaign, slot and content, over the event's own. */
+  sliceContext(slice, base) {
+    return compact({
+      ...base,
+      campaignId: slice.campaignId ?? base.campaignId,
+      slot: slice.slot ?? base.slot,
+      contentId: slice.contentId ?? base.contentId
+    });
+  }
   /** Current cart → commerce payload; falls back to the pre-clear snapshot. */
   cartCommerce(sponsorId) {
     let items = [];
@@ -6124,6 +6671,14 @@ function vioFacade() {
 function vioBootstrapCache() {
   return vioFacade()?.bootstrapCache ?? null;
 }
+function vioContent() {
+  try {
+    const facade = vioFacade();
+    return typeof facade?.content === "function" ? facade.content() : resolveContent();
+  } catch {
+    return {};
+  }
+}
 function vioCart() {
   try {
     return vioFacade()?.cart ?? null;
@@ -6134,7 +6689,12 @@ function vioCart() {
 function resolveCampaignId(ctx, boot) {
   if (ctx.campaignId !== void 0) return ctx.campaignId;
   const defaultId = boot?.campaign?.id;
-  const sponsorId = toNumber(ctx.sponsorId);
+  if (ctx.slot) {
+    const platform = Configuration.isInitialized ? Configuration.get().platform : void 0;
+    const assigned = toNumber2(findSlotAssignment(boot, ctx.slot, Date.now(), platform)?.id);
+    if (assigned !== void 0) return assigned;
+  }
+  const sponsorId = toNumber2(ctx.sponsorId);
   if (sponsorId === void 0) return defaultId;
   try {
     const campaigns = Array.isArray(boot?.campaigns) ? boot.campaigns : [];
@@ -6142,19 +6702,29 @@ function resolveCampaignId(ctx, boot) {
       (c) => !!c && typeof c === "object" && c.status === "active" && campaignSponsorIds(c).includes(sponsorId)
     );
     const chosen = matches.find((c) => c.id === defaultId) ?? matches[0];
-    const chosenId = toNumber(chosen?.id);
+    const chosenId = toNumber2(chosen?.id);
     if (chosenId !== void 0) return chosenId;
   } catch {
   }
   return defaultId;
 }
+function slotOf(detail) {
+  return typeof detail.slot === "string" && detail.slot.trim() ? detail.slot.trim() : void 0;
+}
+function contentOf(detail) {
+  const out = {};
+  if (typeof detail.contentId === "number" && Number.isFinite(detail.contentId)) out.contentId = detail.contentId;
+  else if (typeof detail.contentId === "string" && detail.contentId.trim()) out.contentId = detail.contentId.trim();
+  if (typeof detail.contentTitle === "string" && detail.contentTitle.trim()) out.contentTitle = detail.contentTitle.trim();
+  return out;
+}
 function campaignSponsorIds(campaign) {
   const ids = [];
-  const primary = toNumber(campaign.primarySponsor?.id);
+  const primary = toNumber2(campaign.primarySponsor?.id);
   if (primary !== void 0) ids.push(primary);
   const secondaries = Array.isArray(campaign.secondarySponsors) ? campaign.secondarySponsors : [];
   for (const s of secondaries) {
-    const id = toNumber(s?.id);
+    const id = toNumber2(s?.id);
     if (id !== void 0) ids.push(id);
   }
   return ids;
@@ -6172,7 +6742,7 @@ function firstId(...candidates) {
   }
   return void 0;
 }
-function toNumber(value) {
+function toNumber2(value) {
   if (value === void 0 || value === null || value === "") return void 0;
   const n = Number(value);
   return Number.isFinite(n) ? n : void 0;
@@ -6213,6 +6783,7 @@ function pushGa4(event) {
 }
 
 // src/core/client.ts
+var SLOT_DECLARATION_DEBOUNCE_MS = 1e3;
 var VioFacade = class {
   constructor() {
     this.apiInstance = null;
@@ -6226,6 +6797,14 @@ var VioFacade = class {
      * (another key or environment) is still in flight after a re-init; its answer
      * belongs to that configuration and must not land in this one. */
     this.generation = 0;
+    /** Slot ids present on the page (`Vio.registerSlot`): how many elements hold each + its display name. */
+    this.slotRegistry = /* @__PURE__ */ new Map();
+    /** Pending debounced declaration of the registry. */
+    this.slotDeclareTimer = null;
+    /** A name appeared (or the key changed) since the registry was last declared. */
+    this.slotsDirty = false;
+    /** `Vio.content()` resolved once per page; forgotten on every init(). */
+    this.contentCache = null;
     // Client-side managers — created lazily on first access. They don't
     // need Vio.init() to work (state is purely local).
     this.cartManager = null;
@@ -6241,6 +6820,31 @@ var VioFacade = class {
     this.bootstrapFailedAt = 0;
     this.generation++;
     this.checkoutManager?.clearPaymentMethodsCache();
+    if (this.slotDeclareTimer) {
+      clearTimeout(this.slotDeclareTimer);
+      this.slotDeclareTimer = null;
+    }
+    this.slotsDirty = this.slotRegistry.size > 0;
+    this.contentCache = null;
+  }
+  /**
+   * The content (article, page) this SDK instance is rendered in — what every
+   * analytics event carries as `content_id` / `content_title` when the event
+   * has no explicit one. Resolved once per page (init option → URL query →
+   * `vio:content-*` metas → canonical/og:url → pathname; see
+   * `resolveContent`), forgotten on every `init()`. Never throws; `{}` without
+   * a document.
+   */
+  content() {
+    if (this.contentCache) return this.contentCache;
+    let init;
+    if (Configuration.isInitialized) {
+      const cfg = Configuration.get();
+      init = { contentId: cfg.contentId, contentTitle: cfg.contentTitle };
+    }
+    const resolved = resolveContent(init);
+    if (typeof document !== "undefined") this.contentCache = resolved;
+    return resolved;
   }
   get isInitialized() {
     return Configuration.isInitialized;
@@ -6292,11 +6896,12 @@ var VioFacade = class {
       throw new Error("[Vio] bootstrap recently failed \u2014 backing off");
     }
     const generation = this.generation;
-    const promise = this.api.bootstrap().then(
+    const promise = this.api.bootstrap(Configuration.get().platform).then(
       (res) => {
         if (generation !== this.generation) return this.bootstrap();
         this.cachedBootstrap = res;
         this.bootstrapFailedAt = 0;
+        if (this.slotsDirty) this.scheduleSlotDeclaration();
         return res;
       },
       (err) => {
@@ -6337,14 +6942,176 @@ var VioFacade = class {
     const cfg = Configuration.get();
     return createCommerceClient({ endpoint: cfg.graphQLBase, apiKey: commerceApiKey });
   }
+  // MARK: - Slots (ADR-0027 / ADR-0034)
+  /**
+   * Declare this page's slots to the campaigns service
+   * (`POST /v2/mobile/components/manifest`, `mode: 'merge'`, the init
+   * platform). Best-effort: it NEVER throws — a failure is logged and resolves
+   * `null`. The same set is not re-posted from this browser for 24 h unless
+   * `force` (then `null` also means "skipped, already declared"). Ids are
+   * trimmed, cut at 100 chars, deduped; empties are dropped.
+   */
+  async declareSlots(slots, opts = {}) {
+    try {
+      const locations = normalizeSlotLocations(slots);
+      if (locations.length === 0) return null;
+      if (!Configuration.isInitialized) {
+        warn("declareSlots() before Vio.init() \u2014 nothing declared");
+        return null;
+      }
+      const cfg = Configuration.get();
+      const storageKey = slotDeclarationStorageKey(cfg.platform, cfg.apiKey);
+      const keys = slotDeclarationKeys(locations);
+      const now = Date.now();
+      if (!opts.force && isSlotDeclarationFresh(readSlotDeclaration(storageKey), keys, now)) {
+        return null;
+      }
+      const result = await this.api.declareManifest({
+        platform: cfg.platform,
+        mode: "merge",
+        locations
+      });
+      if (result?.mode === "merge") {
+        writeSlotDeclaration(storageKey, { keys, at: now });
+      } else {
+        warn(
+          "slots declared but the server ignored mode=merge (old server); not caching, will retry next load"
+        );
+      }
+      return result;
+    } catch (err) {
+      warn("declareSlots() failed \u2014", err);
+      return null;
+    }
+  }
+  /**
+   * Register a slot present on the page (the `<vio-*>` elements call it with
+   * their effective id — the host's `vio-slot` or the auto-generated one —
+   * and the optional display name). The registry is declared ONCE, debounced,
+   * after the first successful bootstrap — and again whenever a new id or a
+   * new display name appears. A `displayName` given later for an id already
+   * registered replaces the one kept; `undefined` leaves it alone. The
+   * returned function unregisters; removal never re-declares.
+   */
+  registerSlot(name, displayName) {
+    const id = normalizeSlotId(name);
+    if (!id) return () => {
+    };
+    const label = typeof displayName === "string" && displayName.trim() ? displayName.trim() : void 0;
+    const entry = this.slotRegistry.get(id);
+    let changed = false;
+    if (!entry) {
+      this.slotRegistry.set(id, { count: 1, displayName: label });
+      changed = true;
+    } else {
+      entry.count++;
+      if (label !== void 0 && label !== entry.displayName) {
+        entry.displayName = label;
+        changed = true;
+      }
+    }
+    if (changed) {
+      this.slotsDirty = true;
+      if (this.cachedBootstrap) this.scheduleSlotDeclaration();
+    }
+    let released = false;
+    return () => {
+      if (released) return;
+      released = true;
+      const current = this.slotRegistry.get(id);
+      if (!current) return;
+      if (current.count <= 1) this.slotRegistry.delete(id);
+      else current.count--;
+    };
+  }
+  /**
+   * The campaign a slot shows now, from the last bootstrap: its assigned and
+   * open campaign for the init platform, else the surface's default. With no
+   * slot, the default. `null` before the bootstrap. See `resolveSlotCampaign`.
+   */
+  campaignForSlot(slot) {
+    const platform = Configuration.isInitialized ? Configuration.get().platform : void 0;
+    return resolveSlotCampaign(this.cachedBootstrap, slot ?? null, Date.now(), platform);
+  }
+  /**
+   * THE attribution helper — the SDK elements, Vev and Replit all use this
+   * one. For a place (`slot`): the campaign it shows right now
+   * (`campaignForSlot`: its assignment, else the surface's default) as
+   * `campaignId` + that campaign's primary sponsor as `sponsorId`, plus the
+   * page's content (`content()`). Pure, never throws; `{}` before the
+   * bootstrap, except the content.
+   *
+   * `hint.sponsorId` — when the caller already knows the sponsor (a card with
+   * `sponsor-id`) it is kept as `sponsorId`, and the campaign follows the same
+   * cascade analytics uses (slot assignment → the sponsor's active campaign →
+   * default), so what the cart remembers matches what the events say.
+   */
+  attribution(slot, hint) {
+    const out = {};
+    try {
+      const name = typeof slot === "string" ? slot.trim() : "";
+      if (name) out.slot = name;
+      const boot = this.cachedBootstrap;
+      const hinted = toNumber3(hint?.sponsorId);
+      if (boot) {
+        if (hinted !== void 0) {
+          const campaignId = resolveCampaignId({ slot: name || void 0, sponsorId: hinted }, boot);
+          if (campaignId !== void 0) out.campaignId = campaignId;
+          out.sponsorId = hinted;
+        } else {
+          const campaign = this.campaignForSlot(name || null);
+          const campaignId = toNumber3(campaign?.id);
+          if (campaignId !== void 0) out.campaignId = campaignId;
+          const sponsorId = toNumber3(campaign?.primarySponsor?.id);
+          if (sponsorId !== void 0) out.sponsorId = sponsorId;
+        }
+      } else if (hinted !== void 0) {
+        out.sponsorId = hinted;
+      }
+      const content = this.content();
+      if (content.id) out.contentId = content.id;
+      if (content.title) out.contentTitle = content.title;
+    } catch {
+    }
+    return out;
+  }
+  scheduleSlotDeclaration() {
+    if (this.slotDeclareTimer) clearTimeout(this.slotDeclareTimer);
+    this.slotDeclareTimer = setTimeout(() => {
+      this.slotDeclareTimer = null;
+      this.slotsDirty = false;
+      void this.declareSlots(
+        [...this.slotRegistry.entries()].map(
+          ([id, { displayName }]) => displayName ? { id, displayName } : id
+        )
+      );
+    }, 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;
-    return boot.secondarySponsors?.find((s) => Number(s.id) === id);
+    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;
   }
 };
+function warn(...args) {
+  if (typeof console !== "undefined") console.warn("[Vio]", ...args);
+}
+function toNumber3(value) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) ? n : void 0;
+}
 var _vioGlobal = globalThis;
 var Vio = _vioGlobal.__VIO_FACADE__ ?? (_vioGlobal.__VIO_FACADE__ = new VioFacade());
 
@@ -6397,6 +7164,6 @@ function vippsButtonAttributes(verb = "buy", opts = {}) {
   };
 }
 
-export { ADD_ITEM_MUTATION, ADYEN_RETURN_METHOD, ADYEN_RETURN_QUERY_KEYS, AdyenOriginError, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_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, KUSTOM_RETURN_QUERY_KEYS, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, __decorateClass, addItem, adyenReturnOutcome, adyenReturnParams, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, kustomReturnOutcome, nexiReturnPaymentId, primaryImageUrl, purchaseFromPaymentSuccess, readNexiPending, resolveCampaignId, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };
-//# sourceMappingURL=chunk-WTVGVDZX.js.map
-//# sourceMappingURL=chunk-WTVGVDZX.js.map
+export { ADD_ITEM_MUTATION, ADYEN_RETURN_METHOD, ADYEN_RETURN_QUERY_KEYS, AdyenOriginError, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_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, KUSTOM_RETURN_QUERY_KEYS, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, __decorateClass, addItem, adyenReturnOutcome, adyenReturnParams, autoSlotDisplayName, autoSlotId, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, kustomReturnOutcome, lineOrigins, nexiReturnPaymentId, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, readNexiPending, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };
+//# sourceMappingURL=chunk-AMDI7KH3.js.map
+//# sourceMappingURL=chunk-AMDI7KH3.js.map