@vio-live/web-sdk 0.21.0 → 0.23.1

package/dist/{chunk-WTVGVDZX.js → chunk-BRJMT7P4.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,89 @@ 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]);
     }
   }
-  /** Apply a backend response only if no newer response was applied already. */
-  applyBackendCart(sponsorId, backendCart, seq) {
-    if (seq < (this.appliedSeq.get(sponsorId) ?? 0)) return;
+  /**
+   * True while an AddItem/UpdateItem/DeleteItem of this sponsor OTHER than
+   * `except` has not settled. A mutation applying its own answer passes
+   * itself: its response is current for what IT sent — only the others make
+   * it stale.
+   */
+  hasMutationsInFlight(sponsorId, except) {
+    const set = this.inFlightMutations.get(sponsorId);
+    if (!set || set.size === 0) return false;
+    for (const m of set) if (m !== except) return true;
+    return false;
+  }
+  /** 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);
+  }
+  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, settling) {
+    if (seq < (this.appliedSeq.get(sponsorId) ?? 0)) return false;
     this.appliedSeq.set(sponsorId, seq);
-    this.updateFromBackendCart(sponsorId, backendCart);
+    this.updateFromBackendCart(sponsorId, backendCart, { settling });
+    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, settling) {
+    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;
+      if (!this.hasMutationsInFlight(sponsorId, settling)) {
+        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) {
@@ -1672,8 +1797,12 @@ var CartManager = class extends EventTarget {
     this.cartIdPromises.set(sponsorId, creation);
     return creation;
   }
-  /** Overwrite local cart state with the backend cart response (source of truth). */
-  updateFromBackendCart(sponsorId, backendCart) {
+  /**
+   * Overwrite local cart state with the backend cart response (source of
+   * truth). `opts.settling` is the mutation whose answer this is: it does not
+   * count as "in flight" for the origins (see `hasMutationsInFlight`).
+   */
+  updateFromBackendCart(sponsorId, backendCart, opts = {}) {
     const cart = this.cartsBySponsor.get(sponsorId);
     if (!cart) return;
     if (backendCart.cart_id) cart.cartId = backendCart.cart_id;
@@ -1684,6 +1813,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 +1821,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 +1846,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 +1857,25 @@ 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. They
+          // are squared with its quantity (a stock clamp) only when no OTHER
+          // mutation is in flight for this sponsor — an AddItem answering
+          // while another is pending reports a quantity that is already old
+          // (see `lineOrigins`).
+          origins: matchedLocal ? this.hasMutationsInFlight(sponsorId, opts.settling) ? matchedLocal.origins : 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 +1911,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 +1945,7 @@ var CartManager = class extends EventTarget {
     });
     if (existing) {
       existing.quantity += qty;
+      addOriginQuantity(existing, opts.origin, qty);
     } else {
       const item = {
         id: lineId(),
@@ -1805,7 +1957,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);
     }
@@ -1814,6 +1967,7 @@ var CartManager = class extends EventTarget {
     const addedItem = existing ?? cart.items[cart.items.length - 1];
     const addedLineId = addedItem.id;
     const seq = this.nextSeq(opts.sponsorId);
+    let settling;
     const mutation = (async () => {
       try {
         const cartId = await this.ensureCartId(opts.sponsorId, opts.currency || void 0);
@@ -1828,7 +1982,7 @@ var CartManager = class extends EventTarget {
           ];
           const resCart = await addItem(cartId, lineItemsInput, gqlOpts);
           if (resCart && Array.isArray(resCart.line_items)) {
-            this.applyBackendCart(opts.sponsorId, resCart, seq);
+            this.applyBackendCart(opts.sponsorId, resCart, seq, settling);
           }
         }
       } catch (err) {
@@ -1836,6 +1990,7 @@ var CartManager = class extends EventTarget {
         const line = c?.items.find((i) => i.id === addedLineId);
         if (c && line) {
           line.quantity -= qty;
+          removeFromOrigin(line, opts.origin, 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 +1999,40 @@ 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);
-      }
-    });
+    settling = mutation;
+    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 +2046,86 @@ 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);
+    let settling;
+    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, settling);
+            if (!applied && next === void 0) {
+              this.reconcileLineFromResponse(sponsorId, cartItemId, resCart, settling);
+            }
+          }
+        } 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);
-      }
-    });
+    settling = run;
+    this.trackMutation(sponsorId, run);
   }
   removeItem(lineItemId, sponsorId) {
     this.updateQuantity(lineItemId, sponsorId, 0);
@@ -2021,6 +2236,87 @@ 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 removeFromOrigin(line, origin, qty) {
+  if (!(qty > 0) || !Array.isArray(line.origins)) return;
+  let left = qty;
+  if (origin) {
+    const target = normalizeOrigin(origin);
+    const index = line.origins.findIndex((o) => sameOrigin(o, target));
+    if (index >= 0) {
+      const found = line.origins[index];
+      const take = Math.min(found.quantity, left);
+      found.quantity -= take;
+      left -= take;
+      if (found.quantity <= 0) line.origins.splice(index, 1);
+    }
+  }
+  if (left > 0) removeOriginQuantity(line, left);
+}
+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 }));
+  if (total < quantity) return [...known.map((o) => ({ ...o })), { quantity: quantity - total }];
+  const copy = { origins: known.map((o) => ({ ...o })) };
+  removeOriginQuantity(copy, total - quantity);
+  return copy.origins;
+}
 
 // src/core/checkout/payments/apple-pay.ts
 var STRIPE_JS_URL = "https://js.stripe.com/v3";
@@ -2218,7 +2514,7 @@ async function prepareApplePay(config) {
 }
 
 // src/core/version.ts
-var SDK_VERSION = "0.21.0";
+var SDK_VERSION = "0.23.1";
 
 // src/core/checkout/payments/stripe-embedded.ts
 var CREATE_PAYMENT_INTENT_STRIPE_MUTATION = `
@@ -2726,8 +3022,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 +4081,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 +4274,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 +4389,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 +5888,285 @@ 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";
+var CONTENT_ID_MAX_LENGTH = 128;
+var CONTENT_TITLE_MAX_LENGTH = 255;
+function resolveContent(init, doc = typeof document !== "undefined" ? document : null, loc = typeof location !== "undefined" ? location : null) {
+  try {
+    const query = parseQuery(loc?.search);
+    const id = fits(text(init?.contentId)) ?? fits(text(query.get(CONTENT_ID_QUERY))) ?? fits(text(meta(doc, "name", "vio:content-id"))) ?? fits(stripQueryAndHash(text(attr(doc, 'link[rel="canonical"]', "href")))) ?? fits(stripQueryAndHash(text(meta(doc, "property", "og:url")))) ?? fits(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, CONTENT_TITLE_MAX_LENGTH);
+    return out;
+  } catch {
+    return {};
+  }
+}
+function fits(value) {
+  return value !== void 0 && value.length <= CONTENT_ID_MAX_LENGTH ? value : void 0;
+}
+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;
+var SLOT_DECLARATION_FAILURE_TTL_MS = 60 * 60 * 1e3;
+var MAX_LOCATIONS_PER_DECLARATION = 100;
+var MAX_DECLARATIONS_PER_LOAD = 3;
+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).trim();
+}
+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 tail = `${kind}-${ordinal + 1}`;
+  let prefix = normalizeScope(scope);
+  const room = SLOT_ID_MAX_LENGTH - tail.length - 1;
+  if (prefix.length > room) prefix = prefix.slice(0, Math.max(0, room)).replace(/-+$/, "");
+  return `${prefix ? `${prefix}-` : ""}${tail}`;
+}
+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, "-");
+}
+var SLOT_DECLARATION_MEMORY_CAP = 500;
+function slotDeclarationKey(location2) {
+  return location2.displayName ? `${location2.id}${location2.displayName}` : location2.id;
+}
+function pendingSlotKeys(memory, keys, now = Date.now(), ttl = SLOT_DECLARATION_TTL_MS) {
+  return keys.filter((key) => {
+    const at = memory?.[key];
+    if (typeof at !== "number" || !Number.isFinite(at)) return true;
+    return now - at >= ttl || now < at;
+  });
+}
+function rememberSlotKeys(memory, keys, at, cap = SLOT_DECLARATION_MEMORY_CAP) {
+  const next = { ...memory ?? {} };
+  for (const key of keys) next[key] = at;
+  const entries = Object.entries(next);
+  if (entries.length <= cap) return next;
+  entries.sort((a, b) => b[1] - a[1]);
+  return Object.fromEntries(entries.slice(0, cap));
+}
+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) {
+  try {
+    if (typeof localStorage === "undefined") return {};
+    const raw = localStorage.getItem(storageKey);
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    if (Array.isArray(parsed.keys)) return {};
+    const out = {};
+    for (const [key, at] of Object.entries(parsed)) {
+      if (typeof at === "number" && Number.isFinite(at)) out[key] = at;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
+function writeSlotDeclaration(storageKey, memory) {
+  try {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(storageKey, JSON.stringify(memory));
+  } catch {
+  }
+}
+
+// src/core/cart/slices.ts
+function cartSlicesFrom(lines, resolveCampaign, fallbackCurrency) {
+  if (!Array.isArray(lines) || lines.length === 0) return [];
+  const slices = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    if (!line || typeof line !== "object") continue;
+    const sponsorId = Number(line.sponsorId);
+    const unitPrice = Number(line.unitPrice) || 0;
+    for (const origin of lineOrigins(line)) {
+      let campaignId = origin.campaignId;
+      if (campaignId === void 0) {
+        try {
+          campaignId = resolveCampaign(origin.slot, sponsorId);
+        } catch {
+          campaignId = void 0;
+        }
+      }
+      const key = campaignId === void 0 ? "default" : String(campaignId);
+      let slice = slices.get(key);
+      if (!slice) {
+        slice = {
+          campaignId,
+          sponsors: /* @__PURE__ */ new Set(),
+          slots: /* @__PURE__ */ new Set(),
+          contents: /* @__PURE__ */ new Set(),
+          items: /* @__PURE__ */ new Map(),
+          value: 0,
+          currency: line.currency || fallbackCurrency
+        };
+        slices.set(key, slice);
+      }
+      if (Number.isFinite(sponsorId)) slice.sponsors.add(sponsorId);
+      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.items.get(itemKey);
+      if (item) item.quantity = (item.quantity ?? 0) + origin.quantity;
+      else {
+        slice.items.set(itemKey, {
+          productId: line.productId,
+          name: line.name,
+          brand: line.brand,
+          variantId: line.variantId,
+          price: unitPrice,
+          quantity: origin.quantity
+        });
+      }
+      slice.value += unitPrice * origin.quantity;
+    }
+  }
+  const list = [...slices.values()];
+  return list.map((s, i) => ({
+    campaignId: s.campaignId,
+    sponsorId: s.sponsors.size === 1 ? [...s.sponsors][0] : void 0,
+    slot: s.slots.size === 1 ? [...s.slots][0] : void 0,
+    contentId: s.contents.size === 1 ? [...s.contents][0] : void 0,
+    items: [...s.items.values()],
+    value: Math.round(s.value * 100) / 100,
+    currency: s.currency,
+    slice: i + 1,
+    slices: list.length
+  }));
+}
+function hasExplicitCampaign(lines) {
+  return lines.some((line) => lineOrigins(line).some((o) => o.campaignId !== void 0));
+}
+
 // src/core/analytics/analytics-manager.ts
 var SESSION_TTL_MS = 30 * 60 * 1e3;
 var FLUSH_INTERVAL_MS = 5e3;
@@ -5785,22 +6364,34 @@ var AnalyticsManager = class extends EventTarget {
     if (!anonId) return null;
     const boot = vioBootstrapCache();
     const ctx = opts.context ?? {};
+    const explicitContentId = fitsId(ctx.contentId);
+    const content = explicitContentId === 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). An
+      // explicit location id that does not fit gives way to the slot.
+      location_id: fitsId(ctx.locationId) ?? fitsId(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),
+      // Cut to the collector's 2 048 — the query string first, since a long
+      // one is usually the tracking tail, not the page. The other host-given
+      // fields (broadcastId, componentTemplateId, errorCode, variant, …) are
+      // the host's responsibility: the SDK does not touch them.
+      content_url: capUrl(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 when it fits, else what the SDK resolved for
+      // the page (already capped per source), else nothing.
+      content_id: explicitContentId ?? fitsId(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: capTitle(
+        ctx.contentTitle ?? content.title ?? (typeof document !== "undefined" && document.title ? document.title : void 0)
+      ),
       variant: ctx.variant
     });
     const com = opts.commerce;
@@ -5948,7 +6539,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, campaignId: campaignOf(d), slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -5969,7 +6560,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, campaignId: campaignOf(d), slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -5998,7 +6589,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, campaignId: campaignOf(d), slot: slotOf(d), ...contentOf(d) },
         commerce: {
           items: [
             {
@@ -6017,18 +6608,42 @@ var AnalyticsManager = class extends EventTarget {
     });
     on("vio:checkout-open", (ev) => {
       const d = ev.detail ?? {};
+      const base = { sponsorId: d.sponsorId, campaignId: campaignOf(d), slot: slotOf(d), ...contentOf(d) };
+      const { slices, explicit } = this.cartSlices(d.sponsorId);
+      if (slices.length > 1) {
+        for (const slice of slices) {
+          this.track("begin_checkout", {
+            context: this.sliceContext(slice, base),
+            commerce: sliceCommerce(slice),
+            props: { slice: slice.slice, slices: slice.slices }
+          });
+        }
+        return;
+      }
       const snap = this.cartCommerce(d.sponsorId);
       this.track("begin_checkout", {
-        context: { sponsorId: d.sponsorId },
+        context: this.singleSliceContext(slices[0], explicit, base),
         ...snap ? { commerce: snap } : {}
       });
     });
     on("vio:payment-success", (ev) => {
       const d = ev.detail ?? {};
       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: { sponsorId },
+        context: this.singleSliceContext(slices[0], explicit, base),
         commerce: {
           // value / currency / items: the cart snapshot, on every path.
           ...snap ?? {},
@@ -6039,6 +6654,69 @@ 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 — the shared rule of cart/slices.ts over the
+   * current cart (else the pre-clear snapshot), plus whether any unit named
+   * its campaign itself (a cart without origins is reported as before).
+   */
+  cartSlices(sponsorId) {
+    const lines = this.cartLines(sponsorId);
+    if (lines.length === 0) return { slices: [], explicit: false };
+    const boot = vioBootstrapCache();
+    const slices = cartSlicesFrom(
+      lines,
+      (slot, lineSponsorId) => resolveCampaignId({ slot, sponsorId: lineSponsorId }, boot),
+      this.lastCartSnapshot?.currency
+    );
+    return { slices, explicit: hasExplicitCampaign(lines) };
+  }
+  /**
+   * The context of one of several per-campaign events: the slice's campaign,
+   * slot and content — only its own; when the slice spans several slots or
+   * articles the event names none rather than the one the click came from.
+   */
+  sliceContext(slice, base) {
+    return compact({
+      ...base,
+      sponsorId: slice.sponsorId ?? base.sponsorId,
+      campaignId: slice.campaignId,
+      slot: slice.slot,
+      contentId: slice.contentId,
+      // The click's title only describes the click's content: when the slice
+      // is another article (or several), the page's own title applies instead.
+      contentTitle: slice.contentId !== void 0 && slice.contentId === base.contentId ? base.contentTitle : void 0
+    });
+  }
+  /**
+   * The context of a single-campaign checkout/purchase: when the cart's origins
+   * say which campaign they came from, the event says it too (plus the slot /
+   * content when unique) — a cart without origins is exactly as before.
+   */
+  singleSliceContext(slice, explicit, base) {
+    if (!slice || !explicit) return base;
+    return compact({
+      ...base,
+      campaignId: base.campaignId ?? slice.campaignId,
+      slot: base.slot ?? slice.slot,
+      contentId: base.contentId ?? slice.contentId
+    });
+  }
   /** Current cart → commerce payload; falls back to the pre-clear snapshot. */
   cartCommerce(sponsorId) {
     let items = [];
@@ -6124,6 +6802,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,6 +6820,11 @@ function vioCart() {
 function resolveCampaignId(ctx, boot) {
   if (ctx.campaignId !== void 0) return ctx.campaignId;
   const defaultId = boot?.campaign?.id;
+  if (ctx.slot) {
+    const platform = Configuration.isInitialized ? Configuration.get().platform : void 0;
+    const assigned = toNumber(findSlotAssignment(boot, ctx.slot, Date.now(), platform)?.id);
+    if (assigned !== void 0) return assigned;
+  }
   const sponsorId = toNumber(ctx.sponsorId);
   if (sponsorId === void 0) return defaultId;
   try {
@@ -6148,6 +6839,39 @@ function resolveCampaignId(ctx, boot) {
   }
   return defaultId;
 }
+function campaignOf(detail) {
+  return toNumber(detail.campaignId);
+}
+function fitsId(value) {
+  if (value === void 0 || value === null) return void 0;
+  const s = String(value);
+  return s && s.length <= CONTENT_ID_MAX_LENGTH ? value : void 0;
+}
+function capTitle(value) {
+  if (!value) return void 0;
+  return value.length > CONTENT_TITLE_MAX_LENGTH ? value.slice(0, CONTENT_TITLE_MAX_LENGTH) : value;
+}
+var CONTENT_URL_MAX_LENGTH = 2048;
+function capUrl(value) {
+  if (!value) return void 0;
+  if (value.length <= CONTENT_URL_MAX_LENGTH) return value;
+  const cut = value.search(/[?#]/);
+  const withoutQuery = cut >= 0 ? value.slice(0, cut) : value;
+  return withoutQuery.length <= CONTENT_URL_MAX_LENGTH ? withoutQuery : withoutQuery.slice(0, CONTENT_URL_MAX_LENGTH);
+}
+function sliceCommerce(slice) {
+  return { items: slice.items, value: slice.value, currency: slice.currency };
+}
+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);
@@ -6172,11 +6896,6 @@ function firstId(...candidates) {
   }
   return 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 pushGa4(event) {
   const commerceNames = /* @__PURE__ */ new Set([
     "view_item_list",
@@ -6213,6 +6932,7 @@ function pushGa4(event) {
 }
 
 // src/core/client.ts
+var SLOT_DECLARATION_DEBOUNCE_MS = 1e3;
 var VioFacade = class {
   constructor() {
     this.apiInstance = null;
@@ -6226,6 +6946,17 @@ 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;
+    /** Manifests POSTed by this page load (abuse / rollout guard, see declareSlots). */
+    this.declarationsThisLoad = 0;
+    /** Each cap warns once per page load. */
+    this.warnedLocationCap = false;
+    this.warnedDeclarationCap = false;
     // 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 +6972,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.declarationsThisLoad = 0;
+    this.warnedLocationCap = false;
+    this.warnedDeclarationCap = false;
+  }
+  /**
+   * 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: init option → URL query → `vio:content-*` metas →
+   * canonical/og:url → pathname (see `resolveContent`). Resolved LIVE on each
+   * call — a few querySelectors — so an SPA route change, a new canonical or
+   * a new title are seen without any re-init. Never throws; `{}` without a
+   * document.
+   */
+  content() {
+    let init;
+    if (Configuration.isInitialized) {
+      const cfg = Configuration.get();
+      init = { contentId: cfg.contentId, contentTitle: cfg.contentTitle };
+    }
+    return resolveContent(init);
   }
   get isInitialized() {
     return Configuration.isInitialized;
@@ -6292,11 +7048,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 +7094,230 @@ 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 = {}) {
+    let storageKey;
+    let keys = [];
+    let now = Date.now();
+    try {
+      const all = normalizeSlotLocations(slots);
+      if (all.length === 0) return null;
+      if (!Configuration.isInitialized) {
+        warn("declareSlots() before Vio.init() \u2014 nothing declared");
+        return null;
+      }
+      const cfg = Configuration.get();
+      storageKey = slotDeclarationStorageKey(cfg.platform, cfg.apiKey);
+      now = Date.now();
+      const memory = readSlotDeclaration(storageKey);
+      const pending2 = new Set(pendingSlotKeys(memory, all.map(slotDeclarationKey), now));
+      let locations = opts.force ? all : all.filter((l) => pending2.has(slotDeclarationKey(l)));
+      if (locations.length === 0) return null;
+      if (locations.length > MAX_LOCATIONS_PER_DECLARATION) {
+        if (!this.warnedLocationCap) {
+          this.warnedLocationCap = true;
+          warn(
+            `declareSlots(): ${locations.length} slots on one page \u2014 only the first ${MAX_LOCATIONS_PER_DECLARATION} are declared`
+          );
+        }
+        locations = locations.slice(0, MAX_LOCATIONS_PER_DECLARATION);
+      }
+      keys = locations.map(slotDeclarationKey);
+      if (!opts.force && this.declarationsThisLoad >= MAX_DECLARATIONS_PER_LOAD) {
+        if (!this.warnedDeclarationCap) {
+          this.warnedDeclarationCap = true;
+          warn(
+            `declareSlots(): already ${MAX_DECLARATIONS_PER_LOAD} manifests this page load \u2014 further ones are skipped (force: true to override)`
+          );
+        }
+        return null;
+      }
+      this.declarationsThisLoad++;
+      const result = await this.api.declareManifest({
+        platform: cfg.platform,
+        mode: "merge",
+        locations
+      });
+      if (result?.mode === "merge") {
+        writeSlotDeclaration(storageKey, rememberSlotKeys(memory, keys, now));
+      } else {
+        writeSlotDeclaration(storageKey, rememberSlotKeys(memory, keys, failedAt(now)));
+        warn(
+          "slots declared but the server ignored mode=merge (old server); not caching, will retry next load"
+        );
+      }
+      return result;
+    } catch (err) {
+      if (storageKey && keys.length > 0) {
+        writeSlotDeclaration(storageKey, rememberSlotKeys(readSlotDeclaration(storageKey), keys, failedAt(now)));
+      }
+      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 = normalizeSlotId(slot);
+      if (name) out.slot = name;
+      const boot = this.cachedBootstrap;
+      const hinted = toNumber(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 = toNumber(campaign?.id);
+          if (campaignId !== void 0) out.campaignId = campaignId;
+          const sponsorId = toNumber(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;
+  }
+  /**
+   * The cart split per campaign — the SAME rule `begin_checkout` / `purchase`
+   * use, for hosts with their own analytics sink (Vev). Every unit of every
+   * line goes to the campaign of its origin; units without one to the campaign
+   * the current rule resolves for the line's sponsor (slot assignment → the
+   * sponsor's active campaign → default); `slot` / `contentId` / `sponsorId`
+   * only when they are the same for the whole slice; `value` with two
+   * decimals; `slice` / `slices` number the parts. Pure over the current cart
+   * (or over `opts.items`); `[]` when there is nothing.
+   */
+  cartSlices(sponsorId, opts = {}) {
+    try {
+      let lines = [];
+      if (Array.isArray(opts.items)) {
+        lines = opts.items.filter((i) => sponsorId === void 0 || Number(i?.sponsorId) === Number(sponsorId));
+      } else {
+        this.cart.getAllCarts().forEach((state, id) => {
+          if (sponsorId === void 0 || id === Number(sponsorId)) lines.push(...state.items);
+        });
+      }
+      const boot = this.cachedBootstrap;
+      return cartSlicesFrom(
+        lines,
+        (slot, lineSponsorId) => resolveCampaignId({ slot, sponsorId: lineSponsorId }, boot)
+      );
+    } catch {
+      return [];
+    }
+  }
+  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 failedAt(now) {
+  return now - (SLOT_DECLARATION_TTL_MS - SLOT_DECLARATION_FAILURE_TTL_MS);
+}
 var _vioGlobal = globalThis;
 var Vio = _vioGlobal.__VIO_FACADE__ ?? (_vioGlobal.__VIO_FACADE__ = new VioFacade());
 
@@ -6397,6 +7370,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, cartSlicesFrom, 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, normalizeSlotId, primaryImageUrl, purchaseFromPaymentSuccess, readNexiPending, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };
+//# sourceMappingURL=chunk-BRJMT7P4.js.map
+//# sourceMappingURL=chunk-BRJMT7P4.js.map