@vio-live/web-sdk 0.19.0 → 0.23.0

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;
@@ -150,19 +173,115 @@ interface Sponsor {
     secondaryColor?: string | null;
     commerce: SponsorCommerceBlock;
 }
+/**
+ * `campaign` of `GET /v2/mobile/config`: the head of the surface's default
+ * campaign (the one `primarySponsor` / `secondarySponsors` belong to).
+ */
+interface BootstrapCampaign {
+    id: number;
+    name: string;
+    logo?: string | null;
+    isActive?: boolean;
+    isPaused?: boolean;
+    startDate?: string | null;
+    endDate?: string | null;
+}
+/** Campaign status as the backend computes it (`[startsAt, endsAt)`). */
+type BootstrapCampaignStatus = 'scheduled' | 'active' | 'paused' | 'ended';
+/** A slot assignment of a campaign on this surface (`campaigns[].slots[]`). */
+interface BootstrapSlot {
+    name: string;
+    platform?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+}
+/**
+ * One entry of `campaigns[]`: every active campaign of the surface, with its
+ * own sponsors — a sponsor may live only in a non-default campaign.
+ */
+interface BootstrapCampaignEntry extends BootstrapCampaign {
+    isDefault?: boolean;
+    status?: BootstrapCampaignStatus;
+    primarySponsor?: Sponsor | null;
+    secondarySponsors?: Sponsor[];
+    slots?: BootstrapSlot[];
+}
 /**
  * Response shape of `GET /v2/mobile/config` (and likely future `/v2/web/config`).
  * Matches the iOS SDK's `SdkBootstrapResponse` model.
+ *
+ * `campaign` + `primarySponsor` + `secondarySponsors` describe the surface's
+ * default campaign; `campaigns[]` lists every active one. There is no
+ * top-level `campaignId` — the id lives in `campaign.id`.
  */
 interface BootstrapResponse {
-    campaignId?: number;
+    endpoints?: {
+        webSocketBase?: string;
+        commerceGraphQL?: string;
+    };
+    campaign?: BootstrapCampaign;
     primarySponsor?: Sponsor;
     secondarySponsors?: Sponsor[];
+    features?: {
+        shoppable?: boolean;
+        lineup?: boolean;
+    };
+    campaigns?: BootstrapCampaignEntry[];
     market?: {
         countryCode: string;
         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
@@ -223,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;
@@ -310,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;
@@ -333,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. */
@@ -374,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 {
@@ -387,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;
@@ -404,13 +558,36 @@ 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. */
+    /** 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. */
@@ -455,7 +632,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;
@@ -479,6 +677,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.
@@ -499,7 +707,7 @@ declare const CREATE_PAYMENT_VIPPS_MUTATION = "\nmutation CreatePaymentVipps($ch
 /**
  * GraphQL query to fetch current Vipps payment status.
  */
-declare const GET_VIPPS_STATUS_QUERY = "\nquery GetVippsStatus($checkoutId: String!) {\n  Payment {\n    GetVippsStatus(checkout_id: $checkoutId) {\n      state\n    }\n  }\n}\n";
+declare const GET_VIPPS_STATUS_QUERY = "\nquery GetVippsStatus($checkoutId: String!) {\n  Payment {\n    GetVippsStatus(checkout_id: $checkoutId) {\n      state\n      duplicate_of\n    }\n  }\n}\n";
 interface CreatePaymentVippsVariables extends Record<string, unknown> {
     checkoutId: string;
     /** Optional since Express: Vipps hands the email back with the payment. */
@@ -526,6 +734,8 @@ interface GetVippsStatusVariables extends Record<string, unknown> {
 }
 interface VippsStatusResult {
     state: string;
+    /** Set when this checkout was closed as a duplicate: the checkout that paid the cart. */
+    duplicate_of?: string | null;
 }
 type VippsPaymentState = 'CREATED' | 'INITIATED' | 'AUTHORIZED' | 'TERMINATED' | 'EXPIRED' | string;
 /**
@@ -546,7 +756,7 @@ declare const GET_LINE_ITEMS_BY_SUPPLIER_QUERY = "\nquery GetLineItemsBySupplier
 declare const UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION = "\nmutation UpdateShippingsBySupplier($cartId: String!, $data: [DataUpdateShippingsBySupplier!]!) {\n  Cart {\n    UpdateShippingsBySupplier(cart_id: $cartId, data: $data) {\n      cart_id\n      customer_session_id\n      shipping_country\n      line_items {\n        id\n        supplier\n        image {\n          id\n          url\n          width\n          height\n        }\n        sku\n        barcode\n        brand\n        product_id\n        title\n        variant_id\n        variant_title\n        variant {\n          option\n          value\n        }\n        quantity\n        price {\n          amount\n          currency_code\n          discount\n          compare_at\n          compare_at_incl_taxes\n          amount_incl_taxes\n          tax_amount\n          tax_rate\n        }\n        shipping {\n          id\n          name\n          description\n          price {\n            amount\n            currency_code\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n        }\n        available_shippings {\n          id\n          name\n          description\n          country_code\n          price {\n            amount\n            currency_code\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n        }\n      }\n      subtotal\n      shipping\n      currency\n      available_shipping_countries\n    }\n  }\n}\n";
 declare const CREATE_CHECKOUT_MUTATION = "\nmutation CreateCheckout($cartId: String!) {\n  Checkout {\n    CreateCheckout(cart_id: $cartId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
 declare const UPDATE_CHECKOUT_MUTATION = "\nmutation UpdateCheckout($checkoutId: String!, $status: String, $successUrl: String, $email: String, $cancelUrl: String, $paymentMethod: String, $shippingAddress: AddressArgs, $billingAddress: AddressArgs, $buyerAcceptsPurchaseConditions: Boolean, $buyerAcceptsTermsConditions: Boolean) {\n  Checkout {\n    UpdateCheckout(checkout_id: $checkoutId, status: $status, success_url: $successUrl, email: $email, cancel_url: $cancelUrl, payment_method: $paymentMethod, shipping_address: $shippingAddress, billing_address: $billingAddress, buyer_accepts_purchase_conditions: $buyerAcceptsPurchaseConditions, buyer_accepts_terms_conditions: $buyerAcceptsTermsConditions) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
-declare const GET_CHECKOUT_QUERY = "\nquery GetCheckout($checkoutId: String!) {\n  Checkout {\n    GetCheckout(checkout_id: $checkoutId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
+declare const GET_CHECKOUT_QUERY = "\nquery GetCheckout($checkoutId: String!) {\n  Checkout {\n    GetCheckout(checkout_id: $checkoutId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      duplicate_of\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
 declare const GET_AVAILABLE_PAYMENT_METHODS_QUERY = "\nquery Config {\n  Payment {\n    GetAvailablePaymentMethods {\n      config {\n        name\n        type\n        value\n      }\n      name\n    }\n  }\n}\n";
 /** Transport options for a cart/checkout GraphQL call. */
 interface CartQueryOptions {
@@ -576,7 +786,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>;
@@ -1391,6 +1602,7 @@ declare class CheckoutManager extends EventTarget {
      * cart-queries.ts for why this exists instead of trusting GetCheckout. */
     getVippsStatus(checkoutId: string, sponsorId?: number): Promise<{
         state?: string;
+        duplicate_of?: string | null;
     } | null>;
     /**
      * Kustom (former Klarna Checkout) — create the KCO order via Vio Commerce
@@ -1726,6 +1938,7 @@ declare class CheckoutManager extends EventTarget {
  *      the publisher-facing feature; NOT part of the Vio pipeline)
  *   3. `vio:analytics` DOM event — always when started (inspector/bridges)
  */
+
 declare const ANALYTICS_EVENT_NAMES: readonly ["view_item_list", "select_item", "view_item", "add_to_cart", "remove_from_cart", "view_cart", "begin_checkout", "purchase", "component_impression", "component_click", "ad_impression", "ad_click", "poll_impression", "contest_impression", "session_start", "session_end", "checkout_error", "sdk_error"];
 type AnalyticsEventName = (typeof ANALYTICS_EVENT_NAMES)[number];
 /** Camel-case for DX; mapped to the snake_case wire format at build time. */
@@ -1751,6 +1964,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;
@@ -1878,10 +2099,175 @@ 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 (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.
+     */
+    private cartSlices;
+    /** The context of a per-campaign event: the slice's campaign, slot and content, over the event's own. */
+    private sliceContext;
     /** 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
+ * 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' | '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
+ * confirmation drawer and a provider's own receipt (`result` from the
+ * provider or the backend, plus Vio's `checkoutId`), and Apple Pay express
+ * from the cart (`result` with the backend's `confirmation`, no sponsor).
+ */
+interface PaymentSuccessDetail {
+    method?: string;
+    sponsorId?: number | string;
+    /** The slot the purchase started from, when the emitter knows it. */
+    slot?: string;
+    /** 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. */
+    checkoutId?: string | number;
+    result?: PaymentSuccessResult | null;
+}
+/**
+ * What the checkout attaches as `result`. Only `confirmation` carries a Vio
+ * id: the order `ConfirmPaymentApplePay` created. `order.orderId` / `orderId`
+ * are the PROVIDER's references (Qliro's, Walley's — the checkout itself
+ * shows them as `providerRef`), and `chargedTotal` includes shipping on some
+ * methods only. Analytics reads none of those.
+ */
+interface PaymentSuccessResult {
+    confirmation?: {
+        orderId?: string | number | null;
+        status?: string;
+    } | null;
+    [key: string]: unknown;
+}
+/**
+ * The `order_id` of a `purchase`: ALWAYS a Vio id, never a provider's
+ * reference. Normalized across every emitter: `orderId` (redirect return) →
+ * `result.confirmation.orderId` (Apple Pay) → `checkoutId`. `value` and
+ * `currency` are deliberately NOT read from the result: on every path they
+ * come from the cart snapshot (sum of the items, no shipping), so revenue
+ * stays comparable across payment methods — the charged total will arrive
+ * through the server-side `order_paid` event. With nothing to say it
+ * returns `{}`, so the cart snapshot keeps its keys.
+ */
+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()` caches it per page and forgets the
+ * cache on every `Vio.init()`.
+ */
+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;
 
 declare class VioFacade {
     private apiInstance;
@@ -1891,10 +2277,31 @@ declare class VioFacade {
     /** Last bootstrap failure — short backoff so cart mutations don't hammer a
      * dead endpoint on every call. */
     private bootstrapFailedAt;
+    /** Bumped by every init(). A bootstrap started under an older configuration
+     * (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;
+    /** `Vio.content()` resolved once per page; forgotten on every init(). */
+    private contentCache;
     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. Resolved once per page (init option → URL query →
+     * `vio:content-*` metas → canonical/og:url → pathname; see
+     * `resolveContent`), forgotten on every `init()`. Never throws; `{}` without
+     * a document.
+     */
+    content(): ContentRef;
     get isInitialized(): boolean;
     get config(): ResolvedConfig;
     /** Multi-sponsor cart manager. Reactive — listen via addEventListener('change', ...). */
@@ -1911,6 +2318,11 @@ declare class VioFacade {
     /**
      * Bootstrap — fetches client config and caches it. Dedupes in-flight
      * concurrent requests.
+     *
+     * A request that was started before the last init() (Vev starts with the key
+     * the browser remembers, then the page's own key arrives) answers for a key
+     * that is gone: it neither fills the cache nor arms the failure backoff, and
+     * whoever awaited it gets the current configuration's bootstrap instead.
      */
     bootstrap(): Promise<BootstrapResponse>;
     get bootstrapCache(): BootstrapResponse | null;
@@ -1921,6 +2333,50 @@ 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;
+    private scheduleSlotDeclaration;
     private findSponsor;
 }
 declare const Vio: VioFacade;
@@ -1932,7 +2388,7 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.19.0";
+declare const SDK_VERSION = "0.23.0";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.
@@ -1961,4 +2417,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 BootstrapResponse, 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 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, 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 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 };