@vio-live/web-sdk 0.23.0 → 0.24.0

package/dist/core/index.d.ts

@@ -36,6 +36,17 @@ interface VioConfig {
     contentId?: string | number;
     /** Human-readable title of that content (`content_title`); see `contentId`. */
     contentTitle?: string;
+    /**
+     * The campaign this PAGE belongs to (ADR-0034, amendment 3) — an editorial
+     * page (a Vev article, a Replit article) that is part of one campaign. Its
+     * slots are declared with it (the micro assigns them unless the dashboard
+     * already did) and, until that round-trips, the elements already resolve to
+     * it: assignment → page campaign → default. DOM alternative, inheritable:
+     * `data-vio-campaign` on any ancestor, or `vio-campaign` on the element.
+     */
+    campaignId?: number;
+    /** Log the SDK's slot/attribution decisions at `console.debug` (manifest assignments per slot). */
+    debug?: boolean;
     /** Override REST API base. Defaults are env-aware. */
     apiBase?: string;
     /** Override GraphQL base. Defaults are env-aware. */
@@ -71,6 +82,8 @@ interface ResolvedConfig {
     platform: VioPlatform;
     contentId?: string | number;
     contentTitle?: string;
+    campaignId?: number;
+    debug: boolean;
     apiBase: string;
     graphQLBase: string;
     eventsBase: string;
@@ -194,6 +207,8 @@ interface BootstrapSlot {
     platform?: string | null;
     startDate?: string | null;
     endDate?: string | null;
+    /** Who assigned it: the dashboard (always wins) or a page's own campaign (campaigns micro PR #16). */
+    source?: 'dashboard' | 'page' | null;
 }
 /**
  * One entry of `campaigns[]`: every active campaign of the surface, with its
@@ -240,6 +255,8 @@ interface BootstrapResponse {
 interface ManifestLocation {
     id: string;
     displayName?: string;
+    /** The campaign this location belongs to when it differs from the page's (`ManifestRequest.campaignId`). */
+    campaignId?: number;
 }
 /**
  * Where something happened, as `Vio.attribution(slot)` answers it — the ONE
@@ -265,6 +282,12 @@ interface ManifestRequest {
      */
     mode: 'merge' | 'replace';
     locations: ManifestLocation[];
+    /**
+     * The campaign the PAGE belongs to (`Vio.init({ campaignId })`): the micro
+     * assigns every declared location to it (`source: 'page'`) unless the
+     * dashboard already assigned that slot.
+     */
+    campaignId?: number;
 }
 /** Response of `POST /v2/mobile/components/manifest`. */
 interface ManifestResult {
@@ -275,6 +298,12 @@ interface ManifestResult {
         id: number | string;
         locationId: string;
         displayName?: string | null;
+        /**
+         * What the micro did with the page's campaign for this slot: `created` /
+         * `kept` / `replaced` a page assignment, `dashboard` (the dashboard's
+         * assignment stands — the page's campaign is ignored there), `none`.
+         */
+        assignment?: 'created' | 'kept' | 'replaced' | 'dashboard' | 'none';
     }>;
     deprecatedCount: number;
     warnings: Array<{
@@ -573,6 +602,13 @@ declare class CartManager extends EventTarget {
      * waiting (a quantity intent replayed by an AddItem reconcile). No-op if
      * nothing is pending. */
     waitForCartMutations(sponsorId: number): Promise<void>;
+    /**
+     * 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.
+     */
+    private hasMutationsInFlight;
     /** Register a backend mutation so `waitForCartMutations` can await it. */
     private trackMutation;
     private qtySyncKey;
@@ -592,7 +628,11 @@ declare class CartManager extends EventTarget {
     private emitError;
     /** Ensure the sponsor cart exists server-side; returns its backend cart id. */
     ensureCartId(sponsorId: number, currency?: string, shippingCountry?: string): Promise<string | undefined>;
-    /** Overwrite local cart state with the backend cart response (source of truth). */
+    /**
+     * 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: number, backendCart: {
         cart_id?: string;
         currency?: string;
@@ -621,6 +661,8 @@ declare class CartManager extends EventTarget {
             shipping?: unknown;
             available_shippings?: unknown[];
         }>;
+    }, opts?: {
+        settling?: Promise<unknown>;
     }): void;
     /** Add a Product DTO to a sponsor's cart. Bumps quantity if already present.
      * When a variantId is given, the line uses the VARIANT's price / image / title
@@ -1908,6 +1950,96 @@ declare class CheckoutManager extends EventTarget {
     private emit;
 }
 
+/**
+ * Slots — the pure half of ADR-0027 / ADR-0034 on the web.
+ *
+ * A slot is a NAME for a place on a page. The page declares its slots to the
+ * campaigns service (`Vio.declareSlots()` / `Vio.registerSlot()` in client.ts),
+ * the dashboard assigns a campaign to each one, optionally with a date window,
+ * and `GET /v2/mobile/config` answers with `campaigns[].slots[]` — only the
+ * assignments whose window is open NOW. Whatever no slot names shows the
+ * surface's default campaign (`campaign`).
+ *
+ * Everything here is side-effect free and never throws on a malformed
+ * bootstrap: a broken `campaigns[]` must never blank a product block or break
+ * `track()`.
+ */
+
+/** What `Vio.declareSlots()` accepts per slot. */
+type SlotInput = string | {
+    id: string;
+    displayName?: string;
+    campaignId?: number;
+};
+type BootLike = Pick<BootstrapResponse, 'campaign' | 'campaigns' | 'primarySponsor' | 'secondarySponsors'>;
+/**
+ * The campaign a slot shows right now. Among the `status === 'active'`
+ * entries of `campaigns[]`, the one with an assignment named `slot` for this
+ * platform (`platform` null on the assignment, or equal to `platform`) whose
+ * window contains `now` (`startDate <= now < endDate`, null = open). When
+ * several qualify, the surface's default campaign wins, else the first the
+ * backend lists.
+ *
+ * No assignment → the PAGE's campaign (`pageCampaignId`: the element's own
+ * `vio-campaign`, an ancestor's `data-vio-campaign`, or `Vio.init({ campaignId })`)
+ * when `campaigns[]` lists it as active — an editorial page resolves to its
+ * campaign before (and regardless of) the manifest round-trip. Else the
+ * default campaign: the `campaigns[]` entry whose id is `campaign.id`, or a
+ * minimal entry built from `campaign` (+ the top-level sponsors) when the
+ * list does not carry it. No bootstrap → null.
+ */
+declare function resolveSlotCampaign(boot: BootLike | null | undefined, slot: string | null | undefined, now?: number, platform?: string | null, pageCampaignId?: CampaignHint, sponsorId?: number | null): BootstrapCampaignEntry | null;
+/**
+ * The sponsor rule: the active campaign of `campaigns[]` the sponsor takes
+ * part in, as its primary or one of its secondaries — when it is in several,
+ * the surface's default campaign if it is one of them, else the first one
+ * the backend lists. Null when none (or on a malformed list).
+ */
+declare function sponsorCampaignEntry(boot: BootLike | null | undefined, sponsorId: number | null | undefined): BootstrapCampaignEntry | null;
+/**
+ * A page campaign as the callers give it: one id, or the candidates in
+ * precedence order (the element's `vio-campaign`, an ancestor's
+ * `data-vio-campaign`, `Vio.init`'s). An unusable level (invalid, paused,
+ * unknown) falls through to the next one; `0`, `null`, `''` mean unset.
+ */
+type CampaignHint = number | string | null | undefined | ReadonlyArray<number | string | null | undefined>;
+/**
+ * A campaign id as the SDK accepts it: a positive safe integer, given as a
+ * number or as a string of decimal digits (an attribute). Anything else —
+ * `true`, `'0x10'`, `'1e3'`, an array, a float — is "absent".
+ */
+declare function toCampaignId(value: unknown): number | undefined;
+/** The usable ids of a hint, in order, without duplicates. */
+declare function campaignCandidates(hint: CampaignHint): number[];
+/**
+ * The first candidate of `hint` that `campaigns[]` lists as ACTIVE (and, when
+ * `sponsorId` is given, that the sponsor takes part in — primary or
+ * secondary); null when none — a paused, ended or unknown page campaign is
+ * ignored and the resolution moves on.
+ */
+declare function activeCampaignEntry(boot: BootLike | null | undefined, hint: CampaignHint, sponsorId?: number): BootstrapCampaignEntry | null;
+/** The kinds of Vio element that register themselves. */
+type SlotKind = 'card' | 'carousel' | 'detail';
+/**
+ * The id an element gets when the host set no `vio-slot`:
+ * `${scope ? scope + '-' : ''}${kind}-${ordinal + 1}` (`carousel-1`, `card-3`,
+ * `article-123-carousel-1`), `ordinal` being the element's index among the
+ * same-kind Vio elements WITH THE SAME SCOPE, in document order at connect
+ * time. The scope is inherited from the DOM (`vio-scope` on the element, else
+ * the nearest `data-vio-scope` ancestor): a Vev page or a Replit article
+ * (`<body data-vio-scope="article-123">`) gets per-page slots with one line
+ * and no per-element naming; a template that wants slots shared across
+ * articles simply sets no scope. On purpose there is NO page path in the id:
+ * the article goes to analytics as `content_id`, not into the slot. Stable
+ * across reloads while the layout is; a layout change leaves a stale entry,
+ * which ADR-0034 accepts.
+ */
+declare function autoSlotId(kind: SlotKind, ordinal: number, scope?: string | null): string;
+/** `"Carousel 1"`, `"Card 3"` — with ` · ${scopeName}` when the scope has a human label. */
+declare function autoSlotDisplayName(kind: SlotKind, ordinal: number, scopeName?: string | null): string;
+/** A scope value fit for an id: trimmed, inner whitespace → `-`. */
+declare function normalizeScope(scope: string | null | undefined): string;
+
 /**
  * Vio.analytics — the web SDK's half of the Vio Analytics pipeline.
  *
@@ -2102,16 +2234,23 @@ declare class AnalyticsManager extends EventTarget {
     /** The lines of the cart (current, else the pre-clear snapshot), optionally one sponsor's. */
     private cartLines;
     /**
-     * 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.
+     * 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).
      */
     private cartSlices;
-    /** The context of a per-campaign event: the slice's campaign, slot and content, over the event's own. */
+    /**
+     * 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.
+     */
     private sliceContext;
+    /**
+     * 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.
+     */
+    private singleSliceContext;
     /** Current cart → commerce payload; falls back to the pre-clear snapshot. */
     private cartCommerce;
     private findLine;
@@ -2120,6 +2259,8 @@ declare class AnalyticsManager extends EventTarget {
  * The `campaign_id` of an event. In order: the context's explicit id; the
  * campaign assigned to the context's `slot` right now (ADR-0027 — only an
  * open assignment for the init platform counts, see `findSlotAssignment`);
+ * the PAGE's campaign (`opts.pageCampaignId`, else `Vio.init({ campaignId })`)
+ * when `campaigns[]` lists it as active (ADR-0034, amendment 3);
  * the active campaign of `campaigns[]` the event's sponsor takes part in, as
  * its primary or one of its secondaries — when it is in several, the
  * surface's default campaign if it is one of them, else the first one the
@@ -2130,7 +2271,9 @@ declare class AnalyticsManager extends EventTarget {
  * A malformed `campaigns[]` (not an array, a null entry) never breaks
  * `track()`: it falls back to `campaign.id`.
  */
-declare function resolveCampaignId(ctx: Pick<AnalyticsContext, 'campaignId' | 'sponsorId' | 'slot'>, boot: Pick<BootstrapResponse, 'campaign' | 'campaigns'> | null | undefined): number | undefined;
+declare function resolveCampaignId(ctx: Pick<AnalyticsContext, 'campaignId' | 'sponsorId' | 'slot'>, boot: Pick<BootstrapResponse, 'campaign' | 'campaigns'> | null | undefined, opts?: {
+    pageCampaignId?: CampaignHint;
+}): number | undefined;
 /**
  * `detail` of `vio:payment-success` as the checkout emits it. Four paths,
  * three shapes: a redirect return (`orderId` = Vio's checkout id), the
@@ -2143,6 +2286,8 @@ interface PaymentSuccessDetail {
     sponsorId?: number | string;
     /** The slot the purchase started from, when the emitter knows it. */
     slot?: string;
+    /** The campaign the emitter attributed the purchase to (its `Vio.attribution`). */
+    campaignId?: number;
     /** Per-element content override (`vio-content-id` / `vio-content-title`), when the emitter carries one. */
     contentId?: string | number;
     contentTitle?: string;
@@ -2189,8 +2334,8 @@ declare function purchaseFromPaymentSuccess(d: PaymentSuccessDetail): Pick<Analy
  *
  * Pure: `resolveContent()` takes the document and location (defaults to the
  * globals) so it can be tested, never throws, and answers `{}` where there is
- * no DOM (SSR, node tests). `Vio.content()` caches it per page and forgets the
- * cache on every `Vio.init()`.
+ * no DOM (SSR, node tests). `Vio.content()` resolves it live on every call —
+ * an SPA route change or a new title is seen on the next event.
  */
 interface ContentRef {
     id?: string;
@@ -2214,60 +2359,37 @@ declare function resolveContent(init?: ContentInit | null, doc?: Document | null
 } | null | undefined): ContentRef;
 
 /**
- * Slots — the pure half of ADR-0027 / ADR-0034 on the web.
- *
- * A slot is a NAME for a place on a page. The page declares its slots to the
- * campaigns service (`Vio.declareSlots()` / `Vio.registerSlot()` in client.ts),
- * the dashboard assigns a campaign to each one, optionally with a date window,
- * and `GET /v2/mobile/config` answers with `campaigns[].slots[]` — only the
- * assignments whose window is open NOW. Whatever no slot names shows the
- * surface's default campaign (`campaign`).
+ * The cart split per campaign (ADR-0034) — ONE rule, shared by the SDK's own
+ * `begin_checkout` / `purchase` events, by `Vio.cartSlices()` and so by any
+ * host with its own analytics sink (Vev).
  *
- * Everything here is side-effect free and never throws on a malformed
- * bootstrap: a broken `campaigns[]` must never blank a product block or break
- * `track()`.
+ * 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
+ * caller's rule resolves for the line's sponsor (`resolveCampaign`). One slice
+ * per campaign: its items (quantities from the origins, merged per product +
+ * variant), its value with two decimals, and `slot` / `contentId` /
+ * `sponsorId` only when they are the same for the whole slice. A cart with
+ * one campaign is one slice. Pure; never throws on odd lines.
  */
 
-/** What `Vio.declareSlots()` accepts per slot. */
-type SlotInput = string | {
-    id: string;
-    displayName?: string;
-};
-type BootLike = Pick<BootstrapResponse, 'campaign' | 'campaigns' | 'primarySponsor' | 'secondarySponsors'>;
-/**
- * The campaign a slot shows right now. Among the `status === 'active'`
- * entries of `campaigns[]`, the one with an assignment named `slot` for this
- * platform (`platform` null on the assignment, or equal to `platform`) whose
- * window contains `now` (`startDate <= now < endDate`, null = open). When
- * several qualify, the surface's default campaign wins, else the first the
- * backend lists.
- *
- * No slot, or no assignment → the default campaign: the `campaigns[]` entry
- * whose id is `campaign.id`, or a minimal entry built from `campaign` (+ the
- * top-level sponsors) when the list does not carry it. No bootstrap → null.
- */
-declare function resolveSlotCampaign(boot: BootLike | null | undefined, slot: string | null | undefined, now?: number, platform?: string | null): BootstrapCampaignEntry | null;
-/** The kinds of Vio element that register themselves. */
-type SlotKind = 'card' | 'carousel' | 'detail';
-/**
- * The id an element gets when the host set no `vio-slot`:
- * `${scope ? scope + '-' : ''}${kind}-${ordinal + 1}` (`carousel-1`, `card-3`,
- * `article-123-carousel-1`), `ordinal` being the element's index among the
- * same-kind Vio elements WITH THE SAME SCOPE, in document order at connect
- * time. The scope is inherited from the DOM (`vio-scope` on the element, else
- * the nearest `data-vio-scope` ancestor): a Vev page or a Replit article
- * (`<body data-vio-scope="article-123">`) gets per-page slots with one line
- * and no per-element naming; a template that wants slots shared across
- * articles simply sets no scope. On purpose there is NO page path in the id:
- * the article goes to analytics as `content_id`, not into the slot. Stable
- * across reloads while the layout is; a layout change leaves a stale entry,
- * which ADR-0034 accepts.
- */
-declare function autoSlotId(kind: SlotKind, ordinal: number, scope?: string | null): string;
-/** `"Carousel 1"`, `"Card 3"` — with ` · ${scopeName}` when the scope has a human label. */
-declare function autoSlotDisplayName(kind: SlotKind, ordinal: number, scopeName?: string | null): string;
-/** A scope value fit for an id: trimmed, inner whitespace → `-`. */
-declare function normalizeScope(scope: string | null | undefined): string;
+/** An item of a slice — the analytics item shape (ids as given, normalized on the wire). */
+type VioItem = AnalyticsItemInput;
+/** One campaign's share of the cart. */
+interface CartSlice {
+    campaignId?: number;
+    sponsorId?: number;
+    slot?: string;
+    contentId?: string;
+    items: VioItem[];
+    value: number;
+    currency?: string;
+    /** 1-based position of this slice and how many there are. */
+    slice: number;
+    slices: number;
+}
+/** The campaign of a unit without an explicit one: the caller's rule (slot assignment → sponsor → default). */
+type ResolveCampaign = (slot: string | undefined, sponsorId: number) => number | undefined;
+declare function cartSlicesFrom(lines: ReadonlyArray<CartLineItem>, resolveCampaign: ResolveCampaign, fallbackCurrency?: string): CartSlice[];
 
 declare class VioFacade {
     private apiInstance;
@@ -2281,14 +2403,20 @@ declare class VioFacade {
      * (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. */
     private generation;
-    /** Slot ids present on the page (`Vio.registerSlot`): how many elements hold each + its display name. */
+    /** Slot ids present on the page (`Vio.registerSlot`): how many elements hold each, its display name and its own campaign. */
     private slotRegistry;
+    /** Slots already warned about (`dashboard`: the dashboard's assignment stands; `replaced`: this page moved it). */
+    private warnedDashboardSlots;
+    private warnedReplacedSlots;
     /** Pending debounced declaration of the registry. */
     private slotDeclareTimer;
     /** A name appeared (or the key changed) since the registry was last declared. */
     private slotsDirty;
-    /** `Vio.content()` resolved once per page; forgotten on every init(). */
-    private contentCache;
+    /** Manifests POSTed by this page load (abuse / rollout guard, see declareSlots). */
+    private declarationsThisLoad;
+    /** Each cap warns once per page load. */
+    private warnedLocationCap;
+    private warnedDeclarationCap;
     private cartManager;
     private checkoutManager;
     private analyticsManager;
@@ -2296,10 +2424,11 @@ declare class VioFacade {
     /**
      * 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.
+     * 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(): ContentRef;
     get isInitialized(): boolean;
@@ -2347,19 +2476,32 @@ declare class VioFacade {
     /**
      * 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.
+     * the optional display name, and the element's own campaign when it has
+     * one: `vio-campaign` or an ancestor's `data-vio-campaign`). The registry is
+     * declared ONCE, debounced, after the first successful bootstrap — and again
+     * whenever a new id, display name or campaign appears. A `displayName` /
+     * `campaignId` 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: string, displayName?: string): () => void;
+    registerSlot(name: string, displayName?: string, campaignId?: number | string | null): () => void;
     /**
      * 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?: string | null): BootstrapCampaignEntry | null;
+    campaignForSlot(slot?: string | null, hint?: {
+        campaignId?: CampaignHint;
+        sponsorId?: number | string | null;
+    }): BootstrapCampaignEntry | null;
+    /** The page-campaign candidates in precedence order: the element's (own, ancestor), then `Vio.init`'s. */
+    private pageCampaignCandidates;
+    /**
+     * The campaign the PAGE belongs to (`Vio.init({ campaignId })`, ADR-0034
+     * amendment 3), as the last bootstrap lists it — only when it is there and
+     * active; `null` otherwise (no page campaign, paused, unknown, no bootstrap).
+     */
+    pageCampaign(): BootstrapCampaignEntry | null;
     /**
      * THE attribution helper — the SDK elements, Vev and Replit all use this
      * one. For a place (`slot`): the campaign it shows right now
@@ -2370,12 +2512,45 @@ declare class VioFacade {
      *
      * `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.
+     * cascade analytics uses (slot assignment → page campaign → the sponsor's
+     * active campaign → default), so what the cart remembers matches what the
+     * events say — the page campaign applies there only when that sponsor takes
+     * part in it. `hint.campaignId` — the element's own page campaign
+     * candidates (`vio-campaign`, an ancestor's `data-vio-campaign`), ahead of
+     * `Vio.init`'s; an unusable one falls through to the next; `0` = unset.
      */
     attribution(slot?: string | null, hint?: {
         sponsorId?: number | string;
+        campaignId?: CampaignHint;
     }): Attribution;
+    /**
+     * 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?: number, opts?: {
+        items?: CartLineItem[];
+    }): CartSlice[];
+    /**
+     * What the micro did with the page's campaign per slot (`assignment`):
+     * `console.debug` when `Vio.init({ debug: true })`; a warning once per
+     * slot when the dashboard's own assignment stands (only for a slot this
+     * page actually sent a campaign for) and once per slot when this page moved
+     * it from an earlier page assignment (`replaced`).
+     */
+    private reportAssignments;
+    /**
+     * The memory keys of the sent locations whose campaign the micro did not
+     * take up: every location when a campaign was sent and no answer carries
+     * `assignment` (an older micro), or the ones answered `none` for a campaign
+     * the bootstrap lists as active. They are remembered with the 1 h TTL.
+     */
+    private campaignNotTakenUp;
     private scheduleSlotDeclaration;
     private findSponsor;
 }
@@ -2388,7 +2563,7 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.23.0";
+declare const SDK_VERSION = "0.24.0";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.
@@ -2417,4 +2592,4 @@ declare function vippsButtonAttributes(verb?: 'buy' | 'pay' | 'express' | 'conti
     language?: string;
 }): Record<string, string>;
 
-export { ADD_ITEM_MUTATION, type AddManualOptions, type AddProductOptions, type AnalyticsCommerce, type AnalyticsContext, type AnalyticsEventName, type AnalyticsItemInput, AnalyticsManager, type AnalyticsStartOptions, type ApplePayConfig, type ApplePayResult, type Attribution, type BootstrapCampaign, type BootstrapCampaignEntry, type BootstrapCampaignStatus, type BootstrapResponse, type BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, type CartChangeDetail, type CartLineItem, type CartLineOrigin, CartManager, type CartOrigin, type CartQueryOptions, type CheckoutAddress, type CheckoutChangeDetail, CheckoutManager, type CheckoutState, CommerceClient, Configuration, type ContentRef, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, type GetVippsStatusVariables, type ImageSize, type ManifestLocation, type ManifestRequest, type ManifestResult, type PaymentCompleteDetail, type PaymentMethod, type PaymentSelectDetail, type PaymentSuccessDetail, type PaymentSuccessResult, type PlacementComponent, type Product, type ProductCategory, type ProductImage, type ProductOption, type ProductPrice, type ProductVariant, type ResolvedConfig, SDK_VERSION, type SlotInput, type SlotKind, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, type VioConfig, type VioPlatform, type VippsPaymentState, type VippsStatusResult, addItem, autoSlotDisplayName, autoSlotId, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };
+export { ADD_ITEM_MUTATION, type AddManualOptions, type AddProductOptions, type AnalyticsCommerce, type AnalyticsContext, type AnalyticsEventName, type AnalyticsItemInput, AnalyticsManager, type AnalyticsStartOptions, type ApplePayConfig, type ApplePayResult, type Attribution, type BootstrapCampaign, type BootstrapCampaignEntry, type BootstrapCampaignStatus, type BootstrapResponse, type BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, type CampaignHint, type CartChangeDetail, type CartLineItem, type CartLineOrigin, CartManager, type CartOrigin, type CartQueryOptions, type CartSlice, type CheckoutAddress, type CheckoutChangeDetail, CheckoutManager, type CheckoutState, CommerceClient, Configuration, type ContentRef, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, type GetVippsStatusVariables, type ImageSize, type ManifestLocation, type ManifestRequest, type ManifestResult, type PaymentCompleteDetail, type PaymentMethod, type PaymentSelectDetail, type PaymentSuccessDetail, type PaymentSuccessResult, type PlacementComponent, type Product, type ProductCategory, type ProductImage, type ProductOption, type ProductPrice, type ProductVariant, type ResolvedConfig, SDK_VERSION, type SlotInput, type SlotKind, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, type VioConfig, type VioItem, type VioPlatform, type VippsPaymentState, type VippsStatusResult, activeCampaignEntry, addItem, autoSlotDisplayName, autoSlotId, campaignCandidates, cartSlicesFrom, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };

package/dist/core/index.js

@@ -1,4 +1,4 @@
-import '../chunk-25QECQDS.js';
-export { ADD_ITEM_MUTATION, 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, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, addItem, autoSlotDisplayName, autoSlotId, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from '../chunk-AMDI7KH3.js';
+import '../chunk-45YKS5UG.js';
+export { ADD_ITEM_MUTATION, 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, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, activeCampaignEntry, addItem, autoSlotDisplayName, autoSlotId, campaignCandidates, cartSlicesFrom, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from '../chunk-AXJKB2CW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { ADD_ITEM_MUTATION, AddManualOptions, AddProductOptions, AnalyticsCommerce, AnalyticsContext, AnalyticsEventName, AnalyticsItemInput, AnalyticsManager, AnalyticsStartOptions, ApplePayConfig, ApplePayResult, Attribution, BootstrapCampaign, BootstrapCampaignEntry, BootstrapCampaignStatus, BootstrapResponse, BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartChangeDetail, CartLineItem, CartLineOrigin, CartManager, CartOrigin, CartQueryOptions, CheckoutAddress, CheckoutChangeDetail, CheckoutManager, CheckoutState, CommerceClient, Configuration, ContentRef, CreatePaymentVippsResponse, CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GetVippsStatusVariables, ImageSize, ManifestLocation, ManifestRequest, ManifestResult, PaymentCompleteDetail, PaymentMethod, PaymentSelectDetail, PaymentSuccessDetail, PaymentSuccessResult, PlacementComponent, Product, ProductCategory, ProductImage, ProductOption, ProductPrice, ProductVariant, ResolvedConfig, SDK_VERSION, SlotInput, SlotKind, Sponsor, SponsorCartState, SponsorCommerceBlock, TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, VioConfig, VioPlatform, VippsPaymentState, VippsStatusResult, addItem, autoSlotDisplayName, autoSlotId, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './core/index.js';
+export { ADD_ITEM_MUTATION, AddManualOptions, AddProductOptions, AnalyticsCommerce, AnalyticsContext, AnalyticsEventName, AnalyticsItemInput, AnalyticsManager, AnalyticsStartOptions, ApplePayConfig, ApplePayResult, Attribution, BootstrapCampaign, BootstrapCampaignEntry, BootstrapCampaignStatus, BootstrapResponse, BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CampaignHint, CartChangeDetail, CartLineItem, CartLineOrigin, CartManager, CartOrigin, CartQueryOptions, CartSlice, CheckoutAddress, CheckoutChangeDetail, CheckoutManager, CheckoutState, CommerceClient, Configuration, ContentRef, CreatePaymentVippsResponse, CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GetVippsStatusVariables, ImageSize, ManifestLocation, ManifestRequest, ManifestResult, PaymentCompleteDetail, PaymentMethod, PaymentSelectDetail, PaymentSuccessDetail, PaymentSuccessResult, PlacementComponent, Product, ProductCategory, ProductImage, ProductOption, ProductPrice, ProductVariant, ResolvedConfig, SDK_VERSION, SlotInput, SlotKind, Sponsor, SponsorCartState, SponsorCommerceBlock, TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, VioConfig, VioItem, VioPlatform, VippsPaymentState, VippsStatusResult, activeCampaignEntry, addItem, autoSlotDisplayName, autoSlotId, campaignCandidates, cartSlicesFrom, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './core/index.js';
 import 'graphql-request';

package/dist/index.js

@@ -1,4 +1,4 @@
-import './chunk-25QECQDS.js';
-export { ADD_ITEM_MUTATION, 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, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, addItem, autoSlotDisplayName, autoSlotId, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './chunk-AMDI7KH3.js';
+import './chunk-45YKS5UG.js';
+export { ADD_ITEM_MUTATION, 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, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, activeCampaignEntry, addItem, autoSlotDisplayName, autoSlotId, campaignCandidates, cartSlicesFrom, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, lineOrigins, normalizeOrigin, normalizeScope, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, resolveContent, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './chunk-AXJKB2CW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as _lit_react from '@lit/react';
-import { V as VioCart$1, a as VioCheckout$1, b as VioProduct$1, c as VioProductCarousel$1, d as VioProductDetail$1 } from '../tokens-DSYvrBsB.js';
-export { e as VioThemeOverrides, f as VioTokens, g as applyVioTheme } from '../tokens-DSYvrBsB.js';
+import { V as VioCart$1, a as VioCheckout$1, b as VioProduct$1, c as VioProductCarousel$1, d as VioProductDetail$1 } from '../tokens-C3qiGvLV.js';
+export { e as VioThemeOverrides, f as VioTokens, g as applyVioTheme } from '../tokens-C3qiGvLV.js';
 import 'lit-html';
 import 'lit';
 

package/dist/react/index.js

@@ -1,6 +1,6 @@
-import { registerVioElements, VioProduct, VioProductCarousel, VioProductDetail, VioCart, VioCheckout } from '../chunk-COCHGJ2K.js';
-export { VioTokens, applyVioTheme } from '../chunk-COCHGJ2K.js';
-import '../chunk-AMDI7KH3.js';
+import { registerVioElements, VioProduct, VioProductCarousel, VioProductDetail, VioCart, VioCheckout } from '../chunk-N6U65DWG.js';
+export { VioTokens, applyVioTheme } from '../chunk-N6U65DWG.js';
+import '../chunk-AXJKB2CW.js';
 import * as React from 'react';
 
 // node_modules/@lit/react/node/create-component.js