@vio-live/web-sdk 0.21.0 → 0.23.1

package/dist/core/index.d.ts

@@ -11,11 +11,31 @@ import { GraphQLClient } from 'graphql-request';
  * them from env vars / their config and passes them to `Vio.init`.
  */
 type Environment = 'development' | 'testing' | 'production';
+/**
+ * Platform type of the surface this page belongs to (ADR-0027). It travels
+ * with every slot declaration and as `?platform=` on the bootstrap, so the
+ * campaigns service only answers with the slot assignments of this platform.
+ */
+type VioPlatform = 'web' | 'custom-web' | 'vev';
 interface VioConfig {
     /** Vio API key for this client app (from the Vio dashboard). */
     apiKey: string;
     /** Target environment. Defaults to 'development'. */
     environment?: Environment;
+    /**
+     * Platform type of this surface: `web` (the no-code snippet), `custom-web`
+     * (the SDK integrated by code) or `vev`. Defaults to `web`.
+     */
+    platform?: VioPlatform;
+    /**
+     * The host's own id for the content (article, page) this SDK instance is
+     * rendered in — the first choice of `Vio.content()`, ahead of the URL query,
+     * the `vio:content-id` meta, the canonical URL and the pathname. Goes on
+     * every analytics event as `content_id`.
+     */
+    contentId?: string | number;
+    /** Human-readable title of that content (`content_title`); see `contentId`. */
+    contentTitle?: string;
     /** Override REST API base. Defaults are env-aware. */
     apiBase?: string;
     /** Override GraphQL base. Defaults are env-aware. */
@@ -48,6 +68,9 @@ interface VioConfig {
 interface ResolvedConfig {
     apiKey: string;
     environment: Environment;
+    platform: VioPlatform;
+    contentId?: string | number;
+    contentTitle?: string;
     apiBase: string;
     graphQLBase: string;
     eventsBase: string;
@@ -209,6 +232,56 @@ interface BootstrapResponse {
         currencyCode: string;
     };
 }
+/**
+ * A slot this page declares to the campaigns service (ADR-0027 / ADR-0034):
+ * `id` is the slot name (≤ 100 chars, what `vio-slot` carries and what the
+ * dashboard assigns a campaign to); `displayName` is only for the dashboard.
+ */
+interface ManifestLocation {
+    id: string;
+    displayName?: string;
+}
+/**
+ * Where something happened, as `Vio.attribution(slot)` answers it — the ONE
+ * attribution shape the SDK elements, Vev and Replit all use: the place
+ * (`slot`), the campaign that place shows right now and its primary sponsor,
+ * and the content (article) the page is. Everything optional: `{}` before the
+ * bootstrap, except the content.
+ */
+interface Attribution {
+    slot?: string;
+    campaignId?: number;
+    sponsorId?: number;
+    contentId?: string;
+    contentTitle?: string;
+}
+/** Body of `POST /v2/mobile/components/manifest`. */
+interface ManifestRequest {
+    platform: string;
+    /**
+     * `merge` upserts the slots without deprecating those of other pages (a
+     * surface on the web has many pages, each knowing only its own blocks);
+     * `replace` (the native SDKs' mode) deprecates whatever is not listed.
+     */
+    mode: 'merge' | 'replace';
+    locations: ManifestLocation[];
+}
+/** Response of `POST /v2/mobile/components/manifest`. */
+interface ManifestResult {
+    clientAppId: number;
+    platform: string;
+    mode: 'merge' | 'replace';
+    locations: Array<{
+        id: number | string;
+        locationId: string;
+        displayName?: string | null;
+    }>;
+    deprecatedCount: number;
+    warnings: Array<{
+        kind: string;
+        detail: string;
+    }>;
+}
 /**
  * A placement component returned by `/v2/mobile/campaigns/:id/components`.
  * Used by `<vio-product-carousel campaign-id="...">` to know which products
@@ -269,14 +342,24 @@ declare class VioApi {
     /**
      * 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.
      */
-    bootstrap(): Promise<BootstrapResponse>;
+    bootstrap(platform?: string): Promise<BootstrapResponse>;
+    /**
+     * 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.
+     */
+    declareManifest(body: ManifestRequest): Promise<ManifestResult>;
     /**
      * Get placement components for a campaign. Used by the carousel auto-fetch
      * mode (`<vio-product-carousel campaign-id="36" location="news-favorites">`).
      */
     getComponents(campaignId: number | string): Promise<PlacementComponent[]>;
     private get;
+    private post;
 }
 declare class VioApiError extends Error {
     readonly status: number;
@@ -356,6 +439,21 @@ declare function createCommerceClient(options: CommerceClientOptions): CommerceC
  * Mirrors the iOS SDK's `SponsorCart` + `CartLineItem` structure so the
  * mental model stays consistent across platforms.
  */
+/**
+ * Where a unit in the cart came from (ADR-0027 / ADR-0034): the campaign
+ * the place showed when it was added, the place (`slot`) and the content
+ * (article). What `Vio.attribution(slot)` answers, minus the sponsor and the
+ * title. The purchase is split per campaign from these.
+ */
+interface CartOrigin {
+    campaignId?: number;
+    slot?: string;
+    contentId?: string;
+}
+/** One origin of a line and how many of its units came from it. */
+interface CartLineOrigin extends CartOrigin {
+    quantity: number;
+}
 interface CartLineItem {
     /** Unique local id for this line item (used for update/remove). */
     id: string;
@@ -379,6 +477,12 @@ interface CartLineItem {
     imageUrl: string;
     /** Quantity. */
     quantity: number;
+    /**
+     * Where the units came from, most recent last; their quantities add up to
+     * `quantity`. Absent on carts persisted before origins existed — read them
+     * through `lineOrigins()`, which fills the gap with an empty origin.
+     */
+    origins?: CartLineOrigin[];
     /** Selected shipping for this line (backend cart). */
     shipping?: unknown;
     /** Shipping options offered by the backend for this line. */
@@ -420,6 +524,8 @@ interface AddProductOptions {
     sponsorName?: string;
     quantity?: number;
     variantId?: number;
+    /** Where these units come from (`Vio.attribution(slot)`); see `CartOrigin`. */
+    origin?: CartOrigin;
 }
 /** Minimal product shape — for callers who only have e.g. mock data, not a full Product. */
 interface AddManualOptions {
@@ -433,6 +539,8 @@ interface AddManualOptions {
     imageUrl: string;
     quantity?: number;
     variantId?: number;
+    /** Where these units come from (`Vio.attribution(slot)`); see `CartOrigin`. */
+    origin?: CartOrigin;
 }
 declare class CartManager extends EventTarget {
     private cartsBySponsor;
@@ -450,18 +558,52 @@ declare class CartManager extends EventTarget {
      * landed (Alan, 2026-08-18: shippings queried before AddItem settled,
      * came back empty). */
     private inFlightMutations;
+    /** 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.) */
+    private qtySyncs;
     constructor();
     private nextSeq;
-    /** 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. */
     waitForCartMutations(sponsorId: number): Promise<void>;
-    /** Apply a backend response only if no newer response was applied already. */
+    /**
+     * 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;
+    /** The quantity a line is heading to (pending beats in flight), or
+     * undefined when no quantity sync is active for it. */
+    private intendedQuantity;
+    /** Apply a backend response only if no newer response was applied already.
+     * Returns false when it was discarded as stale. */
     private applyBackendCart;
+    /** 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. */
+    private reconcileLineFromResponse;
     /** Surface a cart sync problem to hosts/UI (and the console). */
     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;
@@ -490,6 +632,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
@@ -501,7 +645,28 @@ declare class CartManager extends EventTarget {
      * when the AddItem response reconciles (keyed by product::variant). */
     private pendingQtyIntents;
     private intentKey;
-    updateQuantity(lineItemId: string, sponsorId: number, quantity: number): void;
+    private findLine;
+    /** 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: string, sponsorId: number, delta: number, opts?: {
+        origin?: CartOrigin;
+    }): void;
+    /** 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: string, sponsorId: number, quantity: number, opts?: {
+        origin?: CartOrigin;
+    }): void;
+    /** 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. */
+    private syncQuantity;
     removeItem(lineItemId: string, sponsorId: number): void;
     clearSponsorCart(sponsorId: number): void;
     clearAllCarts(): void;
@@ -525,6 +690,16 @@ declare class CartManager extends EventTarget {
     private loadFromStorage;
     private emit;
 }
+/** Only the three attribution fields, trimmed; `{}` when nothing is known. */
+declare function normalizeOrigin(origin: CartOrigin | null | undefined): CartOrigin;
+/** Two origins are the same place when campaign, slot and content all match. */
+declare function sameOrigin(a: CartOrigin, b: CartOrigin): boolean;
+/**
+ * The origins of a line for reporting: what it carries, plus an empty origin
+ * for any units it does not account for (a cart persisted before origins
+ * existed, a server-side bump). Their quantities add up to the line's.
+ */
+declare function lineOrigins(line: Pick<CartLineItem, 'origins' | 'quantity'>): CartLineOrigin[];
 
 /**
  * Vipps MobilePay Payment Adapter — GraphQL Integration & Types.
@@ -624,7 +799,8 @@ interface GraphQLEnvelope {
 }
 /** Execute a GraphQL query/mutation against the configured commerce endpoint.
  * Callers that skip `getCartGraphQLOptions()` (or pass a bare sponsorId) get
- * it resolved here instead of silently sending an unauthenticated request. */
+ * it resolved here instead of silently sending an unauthenticated request.
+ * Rejects after `CART_GRAPHQL_TIMEOUT_MS` (and aborts the fetch). */
 declare function executeCartGraphQL(query: string, variables: Record<string, unknown>, options?: CartQueryOptions | number | undefined): Promise<GraphQLEnvelope>;
 declare function createCart(customerSessionId: string, currency: string, shippingCountry?: string | null, options?: CartQueryOptions): Promise<any>;
 declare function addItem(cartId: string, lineItems: unknown[], options?: CartQueryOptions): Promise<any>;
@@ -1801,6 +1977,14 @@ interface AnalyticsContext {
     /** Código corto del fallo (`sdk_error` / `checkout_error`). */
     errorCode?: string;
     variant?: string;
+    /**
+     * The slot (ADR-0027) the component sits in — its `vio-slot`. Attribution
+     * follows it: the event's `campaign_id` is the campaign assigned to the slot
+     * right now, before the sponsor rule. On the wire it fills `location_id`
+     * when no explicit `locationId` is given (a slot IS a location id to the
+     * campaigns service).
+     */
+    slot?: string;
 }
 interface AnalyticsItemInput {
     productId: number | string;
@@ -1928,23 +2112,45 @@ declare class AnalyticsManager extends EventTarget {
      * writes ZERO tracking code for the commerce funnel.
      */
     private installAutoListeners;
+    /** The lines of the cart (current, else the pre-clear snapshot), optionally one sponsor's. */
+    private cartLines;
+    /**
+     * 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 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;
 }
 /**
  * The `campaign_id` of an event. In order: the context's explicit id; 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 backend
- * lists; the default campaign (`campaign.id`). `/v2/mobile/config` has no
- * top-level `campaignId` — reading one is why every event used to leave
- * with `campaign_id: 0` and the campaigns screen stayed empty.
+ * campaign assigned to the context's `slot` right now (ADR-0027 — only an
+ * open assignment for the init platform counts, see `findSlotAssignment`);
+ * 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
+ * backend lists; the default campaign (`campaign.id`). `/v2/mobile/config`
+ * has no top-level `campaignId` — reading one is why every event used to
+ * leave with `campaign_id: 0` and the campaigns screen stayed empty.
  *
  * 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'>, 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): 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
@@ -1955,6 +2161,13 @@ declare function resolveCampaignId(ctx: Pick<AnalyticsContext, 'campaignId' | 's
 interface PaymentSuccessDetail {
     method?: string;
     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;
     /** Redirect return: Vio's checkout id (the name predates `checkoutId`). */
     orderId?: string | number;
     /** Vio's checkout id — from the checkout state or the return URL. */
@@ -1987,6 +2200,130 @@ interface PaymentSuccessResult {
  */
 declare function purchaseFromPaymentSuccess(d: PaymentSuccessDetail): Pick<AnalyticsCommerce, 'orderId'>;
 
+/**
+ * Content (article) attribution — the other half of "where did this happen".
+ *
+ * The SLOT says the place on the page (`carousel-1`, `hero`); the CONTENT says
+ * the article/page the place was rendered in. One Vev design serves thousands
+ * of article URLs, so the article must not leak into the slot id — it travels
+ * on every analytics event as `content_id` / `content_title` instead, and this
+ * module finds it without the editor doing anything.
+ *
+ * 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()` resolves it live on every call —
+ * an SPA route change or a new title is seen on the next event.
+ */
+interface ContentRef {
+    id?: string;
+    title?: string;
+}
+interface ContentInit {
+    contentId?: string | number | null;
+    contentTitle?: string | null;
+}
+/**
+ * Id: `Vio.init({ contentId })` → `?vio_content=` → `<meta name="vio:content-id">`
+ * → `<link rel="canonical">` href or `<meta property="og:url">` (without query
+ * and hash) → `location.pathname`.
+ * Title: `Vio.init({ contentTitle })` → `?vio_content_title=` →
+ * `<meta name="vio:content-title">` → `<meta property="og:title">` → `document.title`.
+ */
+declare function resolveContent(init?: ContentInit | null, doc?: Document | null | undefined, loc?: Location | {
+    href?: string;
+    pathname?: string;
+    search?: string;
+} | 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`).
+ *
+ * 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;
+};
+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;
+
+/**
+ * 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).
+ *
+ * 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.
+ */
+
+/** 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;
     private commerceClients;
@@ -1999,10 +2336,31 @@ 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. */
+    private slotRegistry;
+    /** Pending debounced declaration of the registry. */
+    private slotDeclareTimer;
+    /** A name appeared (or the key changed) since the registry was last declared. */
+    private slotsDirty;
+    /** 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;
     init(config: VioConfig): void;
+    /**
+     * 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(): ContentRef;
     get isInitialized(): boolean;
     get config(): ResolvedConfig;
     /** Multi-sponsor cart manager. Reactive — listen via addEventListener('change', ...). */
@@ -2034,6 +2392,63 @@ declare class VioFacade {
     commerceFor(sponsorId: number): CommerceClient;
     /** Get a CommerceClient using an explicit commerce apiKey (skip bootstrap). */
     commerceWithKey(commerceApiKey: string): CommerceClient;
+    /**
+     * 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.
+     */
+    declareSlots(slots: ReadonlyArray<SlotInput>, opts?: {
+        force?: boolean;
+    }): Promise<ManifestResult | 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: string, displayName?: string): () => 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;
+    /**
+     * 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?: string | null, hint?: {
+        sponsorId?: number | string;
+    }): 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[];
+    private scheduleSlotDeclaration;
     private findSponsor;
 }
 declare const Vio: VioFacade;
@@ -2045,7 +2460,7 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.21.0";
+declare const SDK_VERSION = "0.23.1";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.
@@ -2074,4 +2489,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 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, CartManager, type CartQueryOptions, type CheckoutAddress, type CheckoutChangeDetail, CheckoutManager, type CheckoutState, CommerceClient, Configuration, 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 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 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 VippsPaymentState, type VippsStatusResult, addItem, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, 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 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, addItem, autoSlotDisplayName, autoSlotId, 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, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };

package/dist/core/index.js

@@ -1,4 +1,4 @@
-import '../chunk-PZUOMOLF.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, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from '../chunk-WTVGVDZX.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, addItem, autoSlotDisplayName, autoSlotId, 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, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from '../chunk-BRJMT7P4.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, BootstrapCampaign, BootstrapCampaignEntry, BootstrapCampaignStatus, BootstrapResponse, BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartChangeDetail, CartLineItem, CartManager, CartQueryOptions, CheckoutAddress, CheckoutChangeDetail, CheckoutManager, CheckoutState, CommerceClient, Configuration, 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, PaymentCompleteDetail, PaymentMethod, PaymentSelectDetail, PaymentSuccessDetail, PaymentSuccessResult, PlacementComponent, Product, ProductCategory, ProductImage, ProductOption, ProductPrice, ProductVariant, ResolvedConfig, SDK_VERSION, 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, VippsPaymentState, VippsStatusResult, addItem, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, 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, 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, addItem, autoSlotDisplayName, autoSlotId, 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, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './core/index.js';
 import 'graphql-request';

package/dist/index.js

@@ -1,4 +1,4 @@
-import './chunk-PZUOMOLF.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, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './chunk-WTVGVDZX.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, addItem, autoSlotDisplayName, autoSlotId, 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, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes } from './chunk-BRJMT7P4.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map