@vio-live/web-sdk 0.23.1 → 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<{
@@ -1921,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.
  *
@@ -2140,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
@@ -2150,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
@@ -2235,62 +2358,6 @@ declare function resolveContent(init?: ContentInit | null, doc?: Document | null
     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
@@ -2336,8 +2403,11 @@ 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. */
@@ -2406,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
@@ -2429,11 +2512,16 @@ 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`
@@ -2448,6 +2536,21 @@ declare class VioFacade {
     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;
 }
@@ -2460,7 +2563,7 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.23.1";
+declare const SDK_VERSION = "0.24.0";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.
@@ -2489,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 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 };
+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-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';
+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, 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';
+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-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';
+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-DDfZuHF6.js';
-export { e as VioThemeOverrides, f as VioTokens, g as applyVioTheme } from '../tokens-DDfZuHF6.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-UVDOKFGD.js';
-export { VioTokens, applyVioTheme } from '../chunk-UVDOKFGD.js';
-import '../chunk-BRJMT7P4.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

package/dist/{tokens-DDfZuHF6.d.ts → tokens-C3qiGvLV.d.ts}

@@ -36,6 +36,13 @@ declare class VioProduct extends LitElement {
     vioScope: string;
     /** Human label of the scope (` · Title` in the slot name); inherited from `data-vio-scope-name`. */
     vioScopeName: string;
+    /**
+     * The campaign this element's PAGE belongs to (ADR-0034, amendment 3).
+     * Inherited: this attribute, else the nearest ancestor's `data-vio-campaign`,
+     * else `Vio.init({ campaignId })`. A dashboard assignment of the slot wins
+     * over it. Optional.
+     */
+    vioCampaign: string;
     /** Per-element override of the content (article) id the events carry; see `Vio.content()`. */
     vioContentId: string;
     /** Per-element override of the content title. */
@@ -43,6 +50,8 @@ declare class VioProduct extends LitElement {
     private readonly slotRegistration;
     /** The slot id in effect: `vio-slot`, else the auto id (`card-N`). Read-only. */
     get effectiveSlot(): string;
+    /** The element's own page campaign (`vio-campaign` / ancestor), if any; `Vio.init`'s applies otherwise. */
+    get effectiveCampaignId(): number | undefined;
     /** The slot campaign's sponsor as the string the attributes use ('' when unknown). */
     private sponsorFromAttribution;
     private slotAttributes;
@@ -139,6 +148,13 @@ declare class VioProductCarousel extends LitElement {
     vioScope: string;
     /** Human label of the scope (` · Title` in the slot name); inherited from `data-vio-scope-name`. */
     vioScopeName: string;
+    /**
+     * The campaign this element's PAGE belongs to (ADR-0034, amendment 3).
+     * Inherited: this attribute, else the nearest ancestor's `data-vio-campaign`,
+     * else `Vio.init({ campaignId })`. A dashboard assignment of the slot wins
+     * over it. Optional.
+     */
+    vioCampaign: string;
     /** Per-element override of the content (article) id the events carry; see `Vio.content()`. */
     vioContentId: string;
     /** Per-element override of the content title. */
@@ -146,6 +162,8 @@ declare class VioProductCarousel extends LitElement {
     private readonly slotRegistration;
     /** The slot id in effect: `vio-slot`, else the auto id (`carousel-N`). Read-only. */
     get effectiveSlot(): string;
+    /** The element's own page campaign (`vio-campaign` / ancestor), if any; `Vio.init`'s applies otherwise. */
+    get effectiveCampaignId(): number | undefined;
     private slotAttributes;
     /** Attribution every analytics event of this carousel carries (`Vio.attribution` + the content overrides). */
     private attribution;
@@ -207,6 +225,13 @@ declare class VioProductDetail extends LitElement {
     vioScope: string;
     /** Human label of the scope (` · Title` in the slot name); inherited from `data-vio-scope-name`. */
     vioScopeName: string;
+    /**
+     * The campaign this element's PAGE belongs to (ADR-0034, amendment 3).
+     * Inherited: this attribute, else the nearest ancestor's `data-vio-campaign`,
+     * else `Vio.init({ campaignId })`. A dashboard assignment of the slot wins
+     * over it. Optional.
+     */
+    vioCampaign: string;
     /** Per-element override of the content (article) id the events carry; see `Vio.content()`. */
     vioContentId: string;
     /** Per-element override of the content title. */
@@ -216,13 +241,18 @@ declare class VioProductDetail extends LitElement {
     private eventSlot;
     private eventContentId;
     private eventContentTitle;
+    private eventCampaignId;
     private eventProductId;
     /** The card's context applies to the product it opened — not to one the host opened by hand later. */
     private get fromCard();
     /** The slot id in effect for this element: `vio-slot`, else the auto id (`detail-N`). Read-only. */
     get effectiveSlot(): string;
+    /** The element's own page campaign (`vio-campaign` / ancestor), if any; `Vio.init`'s applies otherwise. */
+    get effectiveCampaignId(): number | undefined;
     /** The slot the open product is attributed to: the opening card's, else this element's. */
     private get activeSlot();
+    /** The page-campaign candidates of the open product: the opening card's, then this element's own and its ancestor's. */
+    private get activeCampaignHint();
     private slotAttributes;
     /** Attribution every event of the open product carries (`Vio.attribution` of the opening card's slot, else this element's). */
     private attribution;

package/dist/ui/index.d.ts

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

package/dist/ui/index.js

@@ -1,6 +1,6 @@
-import { registerVioElements } from '../chunk-UVDOKFGD.js';
-export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-UVDOKFGD.js';
-import '../chunk-BRJMT7P4.js';
+import { registerVioElements } from '../chunk-N6U65DWG.js';
+export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-N6U65DWG.js';
+import '../chunk-AXJKB2CW.js';
 
 // src/ui/index.ts
 registerVioElements();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vio-live/web-sdk",
-  "version": "0.23.1",
+  "version": "0.24.0",
   "description": "Vio Web SDK — in-site shoppable + native checkout, designed for editorial commerce sites",
   "type": "module",
   "main": "./dist/index.js",