@vio-live/web-sdk 0.29.0 → 0.33.0

package/dist/core/index.d.ts

@@ -185,6 +185,12 @@ interface SponsorCommerceBlock {
     channelId?: string | null;
     paymentMethods?: string[];
 }
+/** One of a brand's promises («Rask levering» / «2-5 virkedager»), with a line icon of the SDK's set. */
+interface SponsorHighlight {
+    icon: string;
+    title: string;
+    text?: string | null;
+}
 interface Sponsor {
     id: number;
     name: string;
@@ -197,6 +203,8 @@ interface Sponsor {
     termsUrl?: string | null;
     /** The brand's returns / refund policy page. */
     refundPolicyUrl?: string | null;
+    /** The brand's promises (Settings → Brand): up to three, shown under the buy zone of the product detail. */
+    highlights?: SponsorHighlight[] | null;
     commerce: SponsorCommerceBlock;
 }
 /**
@@ -481,6 +489,19 @@ interface CommerceClientOptions {
     /** Per-sponsor commerce apiKey (from bootstrap.primarySponsor.commerce.apiKey). */
     apiKey: string;
 }
+/** One shipping rate of a product for a country, tax included. */
+interface ProductShippingRate {
+    id: string;
+    name: string;
+    /** Major units, tax included when the backend says it. */
+    price: number;
+    currency: string;
+    default: boolean;
+    /** What the brand wrote for the rate — in practice its delivery time («Leveringstid 1-5 dager»); '' when none. */
+    description: string;
+    /** The carrier's logo for the rate (https), '' when none. */
+    logoUrl: string;
+}
 interface GetProductsByIdsOptions {
     product_ids: number[];
     currency?: string | null;
@@ -506,6 +527,16 @@ declare class ChannelProduct {
      * price and no images. `useCache: false` neither reads nor writes it.
      */
     getSellerCompany(productId: number): Promise<string | null>;
+    /**
+     * The product's shipping rates for the page's market (or `country`),
+     * cheapest first; `[]` when it has none there, `null` when they could not
+     * be read. Never throws. Never from the cache, for the reason given at
+     * getSellerCompany.
+     */
+    getShippingRates(productId: number, options?: {
+        currency?: string | null;
+        country?: string | null;
+    }): Promise<ProductShippingRate[] | null>;
 }
 declare class Channel {
     readonly product: ChannelProduct;
@@ -596,6 +627,15 @@ interface SponsorCartState {
     currency: string;
     /** Backend (Vio Commerce) cart id, once created. */
     cartId?: string;
+    /**
+     * The commerce channel the backend cart was created on (the sponsor's
+     * block for the campaign the first line came from). Every later cart and
+     * checkout call for this cart uses THAT channel's key; when the bootstrap
+     * no longer lists it, the cart is created again on the current channel with
+     * its lines. Absent on carts created before 0.33 (they keep the sponsor's
+     * first block, as then, and learn it on the next call).
+     */
+    channelId?: string;
     shippingCountry?: string;
     subtotal?: number;
     shipping?: number;
@@ -603,385 +643,88 @@ interface SponsorCartState {
 }
 
 /**
- * CartManager — multi-sponsor cart state.
+ * What the commerce gateway may not know yet.
  *
- * Mirrors iOS's `CartManager` + `cartsBySponsor`. Holds local state in
- * memory and persists to localStorage. Reactive: dispatches a `change`
- * CustomEvent that UI components subscribe to (Web Components react via
- * `requestUpdate()`).
+ * The SDK ships ahead of the gateway more than once a quarter: a selection
+ * (`buyer_ref`, 2026-10-19), an argument (`origin` on the cart lines,
+ * `attribution` on the checkout — ADR-0035 phase B). A gateway that does not
+ * have the field refuses the WHOLE operation at validation — before anything
+ * runs, with no `data` — so each such operation is sent again without the
+ * field, once, and the answer remembered for the page load. An operation that
+ * DID run and failed is never repeated: for a mutation that would be a second
+ * charge, a second line in the cart.
  *
- * The backend cart (Vio Commerce GraphQL CreateCart / AddItem / UpdateItem /
- * DeleteItem) is kept in sync optimistically from here; since 0.26 every add
- * and every increase tells it where the units come from (`origin`, ADR-0035
- * phase B) so the order is born attributed — see `origin-wire.ts`.
+ * One mechanism for all of them, so the next field costs a token here and a
+ * call to `withGatewayFeature`, not a new copy of the retry.
  */
+type GatewayFeature = 'buyer_ref' | 'line_origin' | 'checkout_attribution';
+/** Whether this page load still expects the gateway to know `feature` (false once it refused it). */
+declare function gatewayHas(feature: GatewayFeature): boolean;
+/** Forget what this page load learned (tests). One feature, or all of them. */
+declare function resetGatewayFeatures(feature?: GatewayFeature): void;
+/**
+ * True when `err` is the gateway refusing something it does not know, named
+ * `token` (`Cannot query field "buyer_ref" on type …`, `Unknown argument
+ * "origin" on field …`, `Unknown type "CartLineOriginInput"`, `Field "origin" is
+ * not defined by type "LineItemInput"`): a validation error, with no `data`
+ * and no `path` because nothing ran — safe to send again without it, a
+ * mutation included. Anything that ran (data present, or an error with a
+ * path) or any other message is not.
+ */
+declare function isUnknownTokenError(err: unknown, token: string): boolean;
+/** `isUnknownTokenError` for any of the names a feature goes by. */
+declare function isUnknownFeatureError(err: unknown, feature: GatewayFeature): boolean;
+/**
+ * Runs `request(true)` (the operation with the feature); when the gateway
+ * does not know it, `request(false)` (without it) — and from then on, for
+ * this page load, straight to the latter. Said once in the console: a
+ * gateway behind the SDK is worth knowing about, and so is a renamed type.
+ */
+declare function withGatewayFeature<T>(feature: GatewayFeature, request: (supported: boolean) => Promise<T>): Promise<T>;
 
-interface CartChangeDetail {
-    cartsBySponsor: Map<number, SponsorCartState>;
-    itemCount: number;
-}
 /**
- * Detail of `vio:cart-updated` (on `document`): a sponsor's cart as it stands
- * after this tab learned of it from somewhere other than its own taps —
- * `source: 'server'`: GetCart, applied right before a checkout is built on it
- * (`refreshFromServer`); `source: 'storage'`: another tab of the same site
- * wrote it (an add there, a payment that cleared it). The lines are copies.
+ * A line origin as Commerce receives it (ADR-0035 phase B): `origin` on each
+ * line of `AddItem` and, when the quantity goes UP, on `UpdateItem` — the
+ * origin of the units that update adds. shopcart keeps every origin of a
+ * line with its units (`cart_item.origins`) and writes the order from them:
+ * `order_item.campaign_id` / `location_id` / `component_kind`, and the
+ * order's page when the checkout does not name one.
+ *
+ * snake_case on the wire, the caps of shopcart's `LineOriginDto` enforced
+ * here, once. Pure: `lineOriginWire()` takes the origin and the page.
  */
-interface CartUpdatedDetail {
-    sponsorId: number;
-    cartId?: string;
-    items: CartLineItem[];
-    itemCount: number;
-    subtotal: number;
-    currency: string;
-    source: 'server' | 'storage';
-}
-interface AddProductOptions {
-    product: Product;
-    sponsorId: number;
-    sponsorName?: string;
-    quantity?: number;
-    variantId?: number;
-    /** Where these units come from (`Vio.attribution(slot)`); see `CartOrigin`. */
-    origin?: CartOrigin;
+
+/** The largest `Int` GraphQL coerces; a bigger id would fail the whole mutation. */
+declare const GRAPHQL_INT_MAX = 2147483647;
+/** `LineOriginDto` (shopcart `cart/dtos/send/line-origin.dto.ts`). */
+interface LineOriginWire {
+    campaign_id?: number;
+    location_id?: string;
+    component_kind?: string;
+    content_url?: string;
+    content_title?: string;
 }
-/** Minimal product shape — for callers who only have e.g. mock data, not a full Product. */
-interface AddManualOptions {
-    productId: number;
-    sponsorId: number;
-    sponsorName?: string;
-    brand: string;
-    name: string;
-    unitPrice: number;
-    currency: string;
-    imageUrl: string;
-    quantity?: number;
-    variantId?: number;
-    /** Where these units come from (`Vio.attribution(slot)`); see `CartOrigin`. */
-    origin?: CartOrigin;
+/** The caps of `LineOriginDto` — a longer value is refused whole by the API, so it is cut here. */
+declare const LINE_ORIGIN_CAPS: Readonly<{
+    locationId: 100;
+    componentKind: 32;
+    contentUrl: 2048;
+    contentTitle: 255;
+}>;
+/** The page the units are added from, for an origin that does not carry its own. */
+interface OriginPage {
+    contentUrl?: string;
+    contentTitle?: string;
 }
-declare class CartManager extends EventTarget {
-    private cartsBySponsor;
-    /** In-flight CreateCart per sponsor — two quick adds must share ONE backend
-     * cart (two CreateCarts split the items and one silently disappears). */
-    private cartIdPromises;
-    /** Monotonic mutation counter per sponsor + last applied response, so a
-     * slow response can't overwrite the state of a newer one. */
-    private mutationSeq;
-    private appliedSeq;
-    /** In-flight AddItem/UpdateItem/DeleteItem per sponsor. Callers that need
-     * the backend cart to reflect a just-made change (e.g. fetching shippings
-     * right after an add) should `await waitForCartMutations(sponsorId)` first
-     * — otherwise they can race the mutation and see the cart from before it
-     * 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 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>;
-    /**
-     * 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>;
+interface LineOriginWireOptions {
+    /** The current page, for an origin that does not carry its own. */
+    page?: OriginPage;
     /**
-     * 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`).
-     * `opts.authoritative` is a GetCart taken with nothing of this tab's in
-     * flight (`refreshFromServer`): an empty answer then means the cart IS
-     * empty, and the local lines go — not an add still on its way.
-     */
-    updateFromBackendCart(sponsorId: number, backendCart: {
-        cart_id?: string;
-        currency?: string;
-        shipping_country?: string;
-        subtotal?: number;
-        shipping?: number;
-        available_shipping_countries?: string[];
-        line_items?: Array<{
-            id: string;
-            product_id: number;
-            variant_id?: number | string | null;
-            variant_title?: string | null;
-            brand?: string | null;
-            title?: string | null;
-            quantity: number;
-            image?: string | {
-                url?: string;
-            } | null;
-            imageUrl?: string | null;
-            image_url?: string | null;
-            price?: {
-                amount?: number;
-                amount_incl_taxes?: number | null;
-                currency_code?: string;
-            } | null;
-            shipping?: unknown;
-            available_shippings?: unknown[];
-        }>;
-    }, opts?: {
-        settling?: Promise<unknown>;
-        authoritative?: boolean;
-    }): 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
-     * (not the product base), so different combinations are priced correctly. */
-    addProduct(opts: AddProductOptions): CartLineItem;
-    /** Add a manually-specified line item (no Product DTO). */
-    addManual(opts: AddManualOptions): CartLineItem;
-    /** Quantity intents for lines whose backend id hasn't arrived yet — replayed
-     * when the AddItem response reconciles (keyed by product::variant). */
-    private pendingQtyIntents;
-    private intentKey;
-    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. Targets that arrive while one is in flight queue behind it as
-     * steps (`queueStep`): reduced like the line's origins, sent in order once
-     * the current request settles — one request per queued increase from a
-     * different origin, one for a net decrease — so the server ends on the
-     * last intent, credits every increase to its own origin, 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;
-    /** Refresh the local cart from the backend (source of truth). */
-    fetchCartFromBackend(sponsorId: number): Promise<unknown>;
-    /**
-     * The cart as the server has it, for the moment a checkout is about to be
-     * built on it: what the shopper is about to pay must be what the page shows.
-     * Waits for this tab's own mutations (their answers are the server's too),
-     * then applies GetCart as it is — a line another tab added, one it removed,
-     * an empty cart — and tells the page: `change` for the drawer, and
-     * `vio:cart-updated` on `document` (`source: 'server'`) for a host that
-     * draws its own. A mutation that starts while the server is answering makes
-     * that answer old: it is asked once more. Nothing to ask without a backend
-     * cart. A GetCart that fails leaves the local state as it was and does not
-     * throw — the checkout then goes on with the lines the last mutation
-     * answered, as it always did. Resolves with the sponsor's cart.
-     */
-    refreshFromServer(sponsorId: number): Promise<SponsorCartState | undefined>;
-    /** `vio:cart-updated` on `document` — see `CartUpdatedDetail`. */
-    private emitCartUpdated;
-    /**
-     * Another tab of the site wrote the carts: adopt what it wrote, sponsor by
-     * sponsor — its lines and its backend cart id, or nothing when it cleared
-     * the cart (a payment) — except for a sponsor this tab is mid-write for:
-     * its own answer lands in a moment and is persisted then, over whatever
-     * the other tab had. `key` is null when the other tab cleared the whole
-     * storage. Says `change` (the drawer) and `vio:cart-updated` per sponsor
-     * that changed (`source: 'storage'`); nothing when nothing did.
-     */
-    private onStorage;
-    /** Line items grouped by supplier (shipping is per-supplier server-side). */
-    fetchLineItemsBySupplier(sponsorId: number): Promise<unknown>;
-    /** Set the chosen shipping option per supplier on the backend cart. */
-    updateShippingsBySupplier(sponsorId: number, data: Array<{
-        shipping_id: string;
-        supplier_id: number;
-    }>): Promise<unknown>;
-    getAllCarts(): Map<number, SponsorCartState>;
-    getCart(sponsorId: number): SponsorCartState | undefined;
-    get itemCount(): number;
-    subtotalForSponsor(sponsorId: number): number;
-    get totalAcrossSponsors(): number;
-    get primaryCurrency(): string;
-    formatTotal(): string;
-    private persist;
-    private loadFromStorage;
-    private emit;
-}
-/**
- * Only the attribution fields, trimmed; `{}` when nothing is known. The kind
- * of element is kept as Commerce and the collector name it (`card`,
- * `carousel`, `detail` — `componentKindOf`), from `componentKind` or from
- * the `componentTemplateId` an element's attribution carries (`product-card`);
- * the page as origin + path (`contentUrl`) and its title, within Commerce's caps.
- */
-declare function normalizeOrigin(origin: CartOrigin | null | undefined): CartOrigin;
-/** Two origins are the same place when campaign, slot, content and kind of element all match (the page's URL and title are attributes of the place, not its identity). */
-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[];
-
-/**
- * Who sells — the sponsor's (brand's) display identity: its name and logo.
- *
- * ONE rule for every place that names a sponsor (the product detail, the
- * carousel's retailer line, the cart, the checkout header, the confirmation,
- * the payment event and `getOrderReference`): the bootstrap's sponsor block —
- * the config's primary and secondaries, then every `campaigns[]` primary and
- * secondaries, first match — and, when the bootstrap does not know the id,
- * what this tab remembered of the checkout, then the cart's `sponsorName`.
- *
- * In a checkout and on its confirmation the sponsor is the CHECKOUT's (the
- * cart's sponsor, the one the order is with), never the page's attribution:
- * an article of brand A may sell a product of brand B.
- *
- * Pure helpers and a tiny per-checkout memory in `sessionStorage`; no DOM.
- */
-
-/** What a sponsor looks like to a shopper. `name` is the brand's display name. */
-interface SponsorIdentity {
-    id: number;
-    name: string;
-    /** The brand's logo, as the bootstrap gives it (never rewritten); `null` when it has none. */
-    logoUrl: string | null;
-    avatarUrl: string | null;
-    /** The brand's purchase terms page — https only; `null` when it has none. */
-    termsUrl?: string | null;
-    /** The brand's returns / refund policy page — https only; `null` when it has none. */
-    refundPolicyUrl?: string | null;
-}
-/** The sponsor of a checkout / an order as events and `getOrderReference` carry it. */
-type CheckoutSponsor = Pick<SponsorIdentity, 'id' | 'name' | 'logoUrl'>;
-/** `sessionStorage` key of the per-checkout memory. */
-declare const CHECKOUT_SPONSOR_STORAGE_KEY = "vio.checkoutSponsor.v1";
-/**
- * The identity of a sponsor from a bootstrap (`findSponsorIn`): its trimmed
- * name and its logo / avatar URLs as given (an empty string is `null`).
- * `null` when the bootstrap does not know the id, or the block says neither
- * a name nor a logo. Pure, never throws.
- */
-declare function sponsorIdentityFrom(boot: BootstrapResponse | null | undefined, sponsorId: number | string | null | undefined): SponsorIdentity | null;
-
-/**
- * What the commerce gateway may not know yet.
- *
- * The SDK ships ahead of the gateway more than once a quarter: a selection
- * (`buyer_ref`, 2026-10-19), an argument (`origin` on the cart lines,
- * `attribution` on the checkout — ADR-0035 phase B). A gateway that does not
- * have the field refuses the WHOLE operation at validation — before anything
- * runs, with no `data` — so each such operation is sent again without the
- * field, once, and the answer remembered for the page load. An operation that
- * DID run and failed is never repeated: for a mutation that would be a second
- * charge, a second line in the cart.
- *
- * One mechanism for all of them, so the next field costs a token here and a
- * call to `withGatewayFeature`, not a new copy of the retry.
- */
-type GatewayFeature = 'buyer_ref' | 'line_origin' | 'checkout_attribution';
-/** Whether this page load still expects the gateway to know `feature` (false once it refused it). */
-declare function gatewayHas(feature: GatewayFeature): boolean;
-/** Forget what this page load learned (tests). One feature, or all of them. */
-declare function resetGatewayFeatures(feature?: GatewayFeature): void;
-/**
- * True when `err` is the gateway refusing something it does not know, named
- * `token` (`Cannot query field "buyer_ref" on type …`, `Unknown argument
- * "origin" on field …`, `Unknown type "CartLineOriginInput"`, `Field "origin" is
- * not defined by type "LineItemInput"`): a validation error, with no `data`
- * and no `path` because nothing ran — safe to send again without it, a
- * mutation included. Anything that ran (data present, or an error with a
- * path) or any other message is not.
- */
-declare function isUnknownTokenError(err: unknown, token: string): boolean;
-/** `isUnknownTokenError` for any of the names a feature goes by. */
-declare function isUnknownFeatureError(err: unknown, feature: GatewayFeature): boolean;
-/**
- * Runs `request(true)` (the operation with the feature); when the gateway
- * does not know it, `request(false)` (without it) — and from then on, for
- * this page load, straight to the latter. Said once in the console: a
- * gateway behind the SDK is worth knowing about, and so is a renamed type.
- */
-declare function withGatewayFeature<T>(feature: GatewayFeature, request: (supported: boolean) => Promise<T>): Promise<T>;
-
-/**
- * A line origin as Commerce receives it (ADR-0035 phase B): `origin` on each
- * line of `AddItem` and, when the quantity goes UP, on `UpdateItem` — the
- * origin of the units that update adds. shopcart keeps every origin of a
- * line with its units (`cart_item.origins`) and writes the order from them:
- * `order_item.campaign_id` / `location_id` / `component_kind`, and the
- * order's page when the checkout does not name one.
- *
- * snake_case on the wire, the caps of shopcart's `LineOriginDto` enforced
- * here, once. Pure: `lineOriginWire()` takes the origin and the page.
- */
-
-/** The largest `Int` GraphQL coerces; a bigger id would fail the whole mutation. */
-declare const GRAPHQL_INT_MAX = 2147483647;
-/** `LineOriginDto` (shopcart `cart/dtos/send/line-origin.dto.ts`). */
-interface LineOriginWire {
-    campaign_id?: number;
-    location_id?: string;
-    component_kind?: string;
-    content_url?: string;
-    content_title?: string;
-}
-/** The caps of `LineOriginDto` — a longer value is refused whole by the API, so it is cut here. */
-declare const LINE_ORIGIN_CAPS: Readonly<{
-    locationId: 100;
-    componentKind: 32;
-    contentUrl: 2048;
-    contentTitle: 255;
-}>;
-/** The page the units are added from, for an origin that does not carry its own. */
-interface OriginPage {
-    contentUrl?: string;
-    contentTitle?: string;
-}
-interface LineOriginWireOptions {
-    /** The current page, for an origin that does not carry its own. */
-    page?: OriginPage;
-    /**
-     * The surface's privacy mode. Only on a `standard` surface do the slot
-     * (`location_id`) and the page (`content_url`, `content_title`) travel —
-     * which screen a unit was sold from is what `minimal` keeps private, the
-     * same promise the collector keeps for the events. `campaign_id` and
-     * `component_kind` always do. Default `unknown`: fail closed.
+     * The surface's privacy mode. Only on a `standard` surface do the slot
+     * (`location_id`) and the page (`content_url`, `content_title`) travel —
+     * which screen a unit was sold from is what `minimal` keeps private, the
+     * same promise the collector keeps for the events. `campaign_id` and
+     * `component_kind` always do. Default `unknown`: fail closed.
      */
     privacyMode?: SurfacePrivacyMode | 'unknown';
 }
@@ -1206,6 +949,63 @@ declare function autoSlotDisplayName(kind: SlotKind, ordinal: number, scopeName?
 /** A scope value fit for an id: trimmed, inner whitespace → `-`. */
 declare function normalizeScope(scope: string | null | undefined): string;
 
+/**
+ * Who sells — the sponsor's (brand's) display identity: its name and logo.
+ *
+ * ONE rule for every place that names a sponsor (the product detail, the
+ * carousel's retailer line, the cart, the checkout header, the confirmation,
+ * the payment event and `getOrderReference`): the bootstrap's sponsor block —
+ * the config's primary and secondaries, then every `campaigns[]` primary and
+ * secondaries, first match — and, when the bootstrap does not know the id,
+ * what this tab remembered of the checkout, then the cart's `sponsorName`.
+ *
+ * In a checkout and on its confirmation the sponsor is the CHECKOUT's (the
+ * cart's sponsor, the one the order is with), never the page's attribution:
+ * an article of brand A may sell a product of brand B.
+ *
+ * Pure helpers and a tiny per-checkout memory in `sessionStorage`; no DOM.
+ */
+
+/** What a sponsor looks like to a shopper. `name` is the brand's display name. */
+interface SponsorIdentity {
+    id: number;
+    name: string;
+    /** The brand's logo, as the bootstrap gives it (never rewritten); `null` when it has none. */
+    logoUrl: string | null;
+    avatarUrl: string | null;
+    /** The brand's purchase terms page — https only; `null` when it has none. */
+    termsUrl?: string | null;
+    /** The brand's returns / refund policy page — https only; `null` when it has none. */
+    refundPolicyUrl?: string | null;
+    /** The brand's promises (at most three, each with a title); absent when it has none. */
+    highlights?: SponsorHighlight[];
+}
+/** The sponsor of a checkout / an order as events and `getOrderReference` carry it. */
+type CheckoutSponsor = Pick<SponsorIdentity, 'id' | 'name' | 'logoUrl'>;
+/** `sessionStorage` key of the per-checkout memory. */
+declare const CHECKOUT_SPONSOR_STORAGE_KEY = "vio.checkoutSponsor.v1";
+/**
+ * Where a sponsor sells right now: the campaign in context (`campaignId` —
+ * the element's `vio-campaign`, an ancestor's `data-vio-campaign`, the
+ * click's `campaignId`, `Vio.init`'s, in that order of precedence) or the
+ * channel a cart was created on (`channelId`).
+ */
+interface SponsorCommerceContext {
+    campaignId?: CampaignHint;
+    channelId?: string | number | null;
+}
+/** A sponsor block that can sell: it carries a commerce block with an API key. */
+type SellingSponsor = Sponsor & {
+    commerce: SponsorCommerceBlock;
+};
+/**
+ * The identity of a sponsor from a bootstrap (`findSponsorIn`): its trimmed
+ * name and its logo / avatar URLs as given (an empty string is `null`).
+ * `null` when the bootstrap does not know the id, or the block says neither
+ * a name nor a logo. Pure, never throws.
+ */
+declare function sponsorIdentityFrom(boot: BootstrapResponse | null | undefined, sponsorId: number | string | null | undefined): SponsorIdentity | null;
+
 /**
  * Vio.analytics — the web SDK's half of the Vio Analytics pipeline.
  *
@@ -1331,6 +1131,21 @@ interface AnalyticsStartOptions {
      * its own rotating session.
      */
     sessionId?: string;
+    /**
+     * Dejar de capturar QUÉ contenido se está viendo: sin `content_url`,
+     * `content_title`, `content_id` ni nombre/marca de producto. Default false
+     * (se captura).
+     *
+     * Para superficies donde el contenido ES el dato sensible — una app de
+     * salud: la pantalla abierta y el producto comprado revelan la condición
+     * aunque el dispositivo sea anónimo. El funnel se sigue midiendo: ids de
+     * campaña y componente, cantidades e importes.
+     *
+     * El colector lo aplica igual del lado del servidor para las surfaces
+     * marcadas (`client_apps.privacy_mode = 'minimal'`); este interruptor evita
+     * que el dato salga del dispositivo.
+     */
+    privateContent?: boolean;
     /** Send to the Vio collector. Default true. */
     collector?: boolean;
     /** Also push GA4 e-commerce events to window.dataLayer (publisher feature). */
@@ -1362,6 +1177,14 @@ declare class AnalyticsManager extends EventTarget {
     private client;
     /** The landing it was read from — persisted later when consent arrives after the first event. */
     private landing;
+    /**
+     * Internal traffic (ADR-0041): `client.internal: true` on every event while
+     * set. Read once (`?vio_internal=1|0`, else `localStorage`) at `Vio.init()`
+     * or on the first event; `setInternal()` changes it. `null` = not read yet.
+     */
+    private internal;
+    /** The console line for testers goes out once per page load. */
+    private internalAnnounced;
     /** Checkouts (`c:<id>`) and orders (`o:<number>`) this page load reported a `purchase` for: one each. */
     private readonly purchased;
     /** Checkouts this page load reported an `add_payment_info` for: one each. */
@@ -1392,6 +1215,24 @@ declare class AnalyticsManager extends EventTarget {
     stop(): void;
     /** Attach the partner's user id (opaque) to all subsequent events. */
     identify(externalUserId: string | null): void;
+    /**
+     * Mark (or unmark) this browser as Vio's own traffic (ADR-0041): while
+     * marked, every event carries `client.internal: true` and the collector's
+     * reads leave it out. Remembered in `localStorage` (`vio.internal.v1`) —
+     * the same mark `?vio_internal=1` / `?vio_internal=0` sets on any page.
+     */
+    setInternal(internal: boolean): void;
+    /** Whether this browser is marked as internal traffic (reads the mark the first time). */
+    get isInternal(): boolean;
+    /**
+     * Read the mark: the page's `?vio_internal=1|0` (remembered), else what the
+     * browser remembers. Once per page load — `Vio.init()` calls it so a page
+     * with the parameter marks the browser even if it never starts analytics;
+     * `force` reads again.
+     */
+    syncInternal(force?: boolean): boolean;
+    /** One console line when marked, so a tester can see the mark took. */
+    private announceInternal;
     /** Queue one event. Works pre-init and pre-start (SSR: no-op). */
     track(name: AnalyticsEventName, opts?: TrackOptions): void;
     /** The sinks and the queue for one built event — `track`'s second half. */
@@ -1410,6 +1251,11 @@ declare class AnalyticsManager extends EventTarget {
         /** Called the one time the impression is tracked (e.g. to fire a
          *  companion view_item_list). */
         onImpression?: () => void;
+        /** What the element shows, read when the impression fires: its
+         *  products go out as `commerce.items` (the collector counts a
+         *  per-product impression from them, ADR-0041). Nothing when it
+         *  answers no items. */
+        commerce?: () => AnalyticsCommerce | null | undefined;
     }): () => void;
     /** Force a flush (mostly for tests). */
     flush(): Promise<void>;
@@ -1721,190 +1567,531 @@ interface CheckoutAttributionInput {
     /** Where the session came in (`resolveLanding()`): referrer, utm, landing page. */
     landing?: Landing | null;
     /**
-     * The surface's privacy mode. Only on a `standard` surface do the page
-     * (`content_url`, `content_title`) and the entry context travel: which
-     * screen the sale was made on and why the shopper was there is what
-     * `minimal` keeps private — the same promise the collector keeps for the
-     * events. `unknown` (it could not be learnt) counts as `minimal`: what can
-     * reveal it is only sent when the surface is known to allow it. The surface
-     * and the campaign always travel.
+     * The surface's privacy mode. Only on a `standard` surface do the page
+     * (`content_url`, `content_title`) and the entry context travel: which
+     * screen the sale was made on and why the shopper was there is what
+     * `minimal` keeps private — the same promise the collector keeps for the
+     * events. `unknown` (it could not be learnt) counts as `minimal`: what can
+     * reveal it is only sent when the surface is known to allow it. The surface
+     * and the campaign always travel.
+     */
+    privacyMode?: SurfacePrivacyMode | 'unknown';
+}
+/**
+ * The attribution for the wire, or `undefined` when there is nothing to say.
+ * The campaign is the page's; without one, the campaign that explains most
+ * units of the cart under the same rule `purchase` is split by (ties: the
+ * higher value, then the first). The page (origin + path) and the entry go
+ * only on a `standard` surface.
+ */
+declare function checkoutAttributionOf(input: CheckoutAttributionInput): CheckoutAttributionWire | undefined;
+/** The landing as `entry`, capped; `undefined` when it says nothing. */
+declare function entryContextOf(landing: Landing | null | undefined): EntryContextWire | undefined;
+/**
+ * The campaign that explains most units of the cart — over the slices
+ * `purchase` is split by, so the order names the campaign the biggest
+ * purchase event names. Ties go to the higher value, then to the first
+ * slice. Units nobody attributes (a slice without campaign) never win.
+ */
+declare function dominantCampaignOf(slices: ReadonlyArray<CartSlice> | null | undefined): number | undefined;
+
+/**
+ * Vipps MobilePay Payment Adapter — GraphQL Integration & Types.
+ *
+ * Vipps payment integration uses 2 GraphQL operations:
+ *
+ * 1. `CreatePaymentVipps` mutation:
+ *    Initiates a Vipps payment session for a checkout and returns `payment_url`.
+ *
+ * 2. `GetVippsStatus` query:
+ *    Queries Vipps payment state directly for a checkout (`state`).
+ */
+
+/**
+ * GraphQL mutation to create a Vipps payment session.
+ */
+declare const CREATE_PAYMENT_VIPPS_MUTATION = "\nmutation CreatePaymentVipps($checkoutId: String!, $email: String, $returnUrl: String!, $express: Boolean) {\n  Payment {\n    CreatePaymentVipps(checkout_id: $checkoutId, email: $email, return_url: $returnUrl, express: $express) {\n      payment_url\n      reference\n      express\n      reason\n    }\n  }\n}\n";
+/**
+ * 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      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. */
+    email?: string;
+    returnUrl: string;
+    /**
+     * `true` asks for Express — address and delivery chosen inside the Vipps
+     * app. When the cart cannot have it, no payment is created and the answer
+     * says `express: false` with the reason; the caller then opens the
+     * ordinary checkout.
+     */
+    express?: boolean;
+}
+interface CreatePaymentVippsResponse {
+    /** Absent when Express was asked for and refused. */
+    payment_url?: string;
+    /** The reference the seller reads in its Vipps portal. */
+    reference?: string;
+    express?: boolean;
+    reason?: string;
+}
+interface GetVippsStatusVariables extends Record<string, unknown> {
+    checkoutId: string;
+}
+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;
+/**
+ * Executes the `CreatePaymentVipps` GraphQL mutation.
+ */
+declare function createPaymentVipps(variables: CreatePaymentVippsVariables | Record<string, unknown>, options?: CartQueryOptions): Promise<CreatePaymentVippsResponse | null>;
+/**
+ * Executes the `GetVippsStatus` GraphQL query.
+ */
+declare function getVippsStatus(variables: GetVippsStatusVariables | Record<string, unknown>, options?: CartQueryOptions): Promise<VippsStatusResult | null>;
+
+declare const CREATE_CART_MUTATION = "\nmutation CreateCart($customerSessionId: String!, $currency: String!, $shippingCountry: String) {\n  Cart {\n    CreateCart(customer_session_id: $customerSessionId, currency: $currency, shipping_country: $shippingCountry) {\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 ADD_ITEM_MUTATION = "\nmutation AddItem($cartId: String!, $lineItems: [LineItemInput!]!) {\n  Cart {\n    AddItem(cart_id: $cartId, line_items: $lineItems) {\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 DELETE_ITEM_MUTATION = "\nmutation DeleteItem($cartId: String!, $cartItemId: String!) {\n  Cart {\n    DeleteItem(cart_id: $cartId, cart_item_id: $cartItemId) {\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 UPDATE_ITEM_MUTATION: string;
+/** `UpdateItem` with the `origin` of the added units (`CartLineOriginInput`, snake_case fields — see `lineOriginWire`). */
+declare const UPDATE_ITEM_WITH_ORIGIN_MUTATION: string;
+declare const GET_CART_QUERY = "\nquery GetCart($cartId: String!) {\n  Cart {\n    GetCart(cart_id: $cartId) {\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 GET_LINE_ITEMS_BY_SUPPLIER_QUERY = "\nquery GetLineItemsBySupplier($cartId: String!) {\n  Cart {\n    GetLineItemsBySupplier(cart_id: $cartId) {\n      supplier {\n        id\n        name\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      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      }\n    }\n  }\n}\n";
+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: string;
+/** `CreateCheckout` with the checkout's `attribution` (`CheckoutAttributionInput`, snake_case fields — see `checkoutAttributionOf`). */
+declare const CREATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION: string;
+declare const UPDATE_CHECKOUT_MUTATION: string;
+/** `UpdateCheckout` with the checkout's `attribution` (`CheckoutAttributionInput`). */
+declare const UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION: string;
+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 {
+    endpoint?: string;
+    apiKey?: string;
+    /** Sponsor commerce key — goes in the Authorization header. */
+    commerceKey?: string;
+    /** True when the commerce key came from a resolved sponsor (bootstrap).
+     * False = we fell back to the host apiKey — writes like CreateCart should
+     * NOT proceed with the wrong key (the cart would be orphaned). */
+    sponsorResolved?: boolean;
+    /** The commerce channel of the key (`commerce.channelId` of the block it came from), when known. */
+    channelId?: string;
+    /**
+     * True when a channel was asked for (`ctx.channelId`) and the bootstrap no
+     * longer lists it for the sponsor: the call must not go out with another
+     * channel's key — a cart on that channel is rebuilt on the current one.
+     */
+    channelMissing?: boolean;
+}
+/** Which channel's key a cart / checkout call takes (see `getCartGraphQLOptions`). */
+interface CartKeyContext {
+    /** The channel the cart (or checkout) lives on: only that channel's key. */
+    channelId?: string | number | null;
+    /** The campaign in context (candidates in precedence order); `null` = none at all, not even `Vio.init`'s. */
+    campaignId?: number | string | null | ReadonlyArray<number | string | null | undefined>;
+    /** A channel the bootstrap no longer lists still answers with the key this page saw for it (an open checkout). */
+    retired?: boolean;
+}
+/**
+ * Resolve endpoint + keys for cart GraphQL calls. Awaits Vio.bootstrap() once
+ * if it hasn't run yet (the sponsor commerce keys come from bootstrap), then
+ * uses the sponsor's commerce apiKey (via the Vio facade on globalThis,
+ * avoiding an import cycle); falls back to the host apiKey.
+ */
+declare function getCartGraphQLOptions(sponsorId?: number, ctx?: CartKeyContext): Promise<CartQueryOptions>;
+/**
+ * Stable per-browser customer session id (backend CreateCart requires one).
+ * Never throws: where storage is refused (in-app browsers) the id lives in
+ * this page's memory — still one per shopper, never the shared
+ * `cs_session_default` every storage-less browser used to send.
+ */
+declare function getCustomerSessionId(): string;
+interface GraphQLEnvelope {
+    data?: Record<string, Record<string, unknown>> | null;
+    errors?: Array<{
+        message?: string;
+        path?: unknown;
+    }>;
+}
+/** 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.
+ * 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>;
+/**
+ * `AddItem`. A line may carry `origin` (`LineOriginWire`: where its units
+ * come from — ADR-0035 phase B). A gateway that predates the field refuses
+ * the whole mutation at validation (`LineItemInput` has no `origin`), so the
+ * lines are sent again without it, once per page load — see gateway-features.
+ */
+declare function addItem(cartId: string, lineItems: unknown[], options?: CartQueryOptions): Promise<any>;
+declare function deleteItem(cartId: string, cartItemId: string, options?: CartQueryOptions): Promise<any>;
+/**
+ * `UpdateItem`. `extra.origin` is where the units a quantity INCREASE adds
+ * come from (ADR-0035 phase B); the server credits the new units to it. Sent
+ * only with it; a gateway that predates the argument gets the legacy
+ * mutation instead, once per page load — see gateway-features.
+ */
+declare function updateItem(cartId: string, cartItemId: string, shippingId?: string | null, qty?: number | null, options?: CartQueryOptions, extra?: {
+    origin?: LineOriginWire;
+}): Promise<any>;
+declare function getCart(cartId: string, options?: CartQueryOptions): Promise<any>;
+declare function getLineItemsBySupplier(cartId: string, options?: CartQueryOptions): Promise<any>;
+declare function updateShippingsBySupplier(cartId: string, data: unknown[], options?: CartQueryOptions): Promise<any>;
+/**
+ * `CreateCheckout`. With `extra.attribution` (`CheckoutAttributionWire`:
+ * the surface, the page's campaign, the page and the entry — ADR-0035 phase
+ * B) the checkout is born attributed; a gateway that predates the argument
+ * gets the legacy mutation, once per page load — see gateway-features.
+ */
+declare function createCheckout(cartId: string, options?: CartQueryOptions, extra?: {
+    attribution?: CheckoutAttributionWire;
+}): Promise<any>;
+/**
+ * `UpdateCheckout`. `variables.attribution` (`CheckoutAttributionWire`) is
+ * merged key by key over what the checkout has; a gateway that predates the
+ * argument gets the legacy mutation without it, once per page load.
+ */
+declare function updateCheckout(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
+declare function getCheckout(checkoutId: string, options?: CartQueryOptions): Promise<any>;
+/** What a checkout says of itself after paying: its Vio order number, once the order exists, and its buyer reference. */
+interface CheckoutReference {
+    orderNumber: number | null;
+    buyerRef: string | null;
+}
+/** The order number (null while the order does not exist yet) and the buyer reference (null when the API does not say it). */
+declare function getCheckoutReference(checkoutId: string, options?: CartQueryOptions): Promise<CheckoutReference>;
+declare function getAvailablePaymentMethods(options?: CartQueryOptions): Promise<any>;
+declare const CREATE_PAYMENT_STRIPE_MUTATION = "\nmutation CreatePaymentStripe($checkoutId: String!, $successUrl: String!, $paymentMethod: String!, $email: String!) {\n  Payment {\n    CreatePaymentStripe(checkout_id: $checkoutId, success_url: $successUrl, payment_method: $paymentMethod, email: $email) {\n      order_id\n      checkout_url\n    }\n  }\n}\n";
+declare function createPaymentStripe(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
+
+/**
+ * CartManager — multi-sponsor cart state.
+ *
+ * Mirrors iOS's `CartManager` + `cartsBySponsor`. Holds local state in
+ * memory and persists to localStorage. Reactive: dispatches a `change`
+ * CustomEvent that UI components subscribe to (Web Components react via
+ * `requestUpdate()`).
+ *
+ * The backend cart (Vio Commerce GraphQL CreateCart / AddItem / UpdateItem /
+ * DeleteItem) is kept in sync optimistically from here; since 0.26 every add
+ * and every increase tells it where the units come from (`origin`, ADR-0035
+ * phase B) so the order is born attributed — see `origin-wire.ts`.
+ */
+
+interface CartChangeDetail {
+    cartsBySponsor: Map<number, SponsorCartState>;
+    itemCount: number;
+}
+/**
+ * Detail of `vio:cart-updated` (on `document`): a sponsor's cart as it stands
+ * after this tab learned of it from somewhere other than its own taps —
+ * `source: 'server'`: GetCart, applied right before a checkout is built on it
+ * (`refreshFromServer`); `source: 'storage'`: another tab of the same site
+ * wrote it (an add there, a payment that cleared it). The lines are copies.
+ */
+interface CartUpdatedDetail {
+    sponsorId: number;
+    cartId?: string;
+    items: CartLineItem[];
+    itemCount: number;
+    subtotal: number;
+    currency: string;
+    source: 'server' | 'storage';
+}
+interface AddProductOptions {
+    product: Product;
+    sponsorId: number;
+    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 {
+    productId: number;
+    sponsorId: number;
+    sponsorName?: string;
+    brand: string;
+    name: string;
+    unitPrice: number;
+    currency: string;
+    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;
+    /** In-flight CreateCart per sponsor — two quick adds must share ONE backend
+     * cart (two CreateCarts split the items and one silently disappears). */
+    private cartIdPromises;
+    /** Monotonic mutation counter per sponsor + last applied response, so a
+     * slow response can't overwrite the state of a newer one. */
+    private mutationSeq;
+    private appliedSeq;
+    /** In-flight AddItem/UpdateItem/DeleteItem per sponsor. Callers that need
+     * the backend cart to reflect a just-made change (e.g. fetching shippings
+     * right after an add) should `await waitForCartMutations(sponsorId)` first
+     * — otherwise they can race the mutation and see the cart from before it
+     * 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;
+    /**
+     * Bumped per sponsor each time its backend cart is dropped because its
+     * channel went away: the lines as they stood then (`carryOver`) go to the
+     * new backend cart, so an add whose local units were already counted in
+     * them must not send its own AddItem as well (see `addManual`).
+     */
+    private rebuildEpoch;
+    /** The lines to give the next backend cart of a sponsor, after its channel went away. */
+    private carryOver;
+    /** The storage key of this connection's carts. */
+    private readonly storageKey;
+    /**
+     * Whether this is the page's connection now. A manager left behind by a
+     * re-init (another key) still finishes its requests and keeps its own
+     * carts, but says nothing to the page: no `vio:cart-*` events.
+     */
+    private active;
+    constructor(scope?: string);
+    /** The page's connection is (or is no longer) this one; see `active`. */
+    setActive(active: boolean): void;
+    /** Tell the listeners what this connection's carts hold now (after the page switched to it). */
+    announce(): void;
+    private nextSeq;
+    /** 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>;
+    /**
+     * 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;
+    /**
+     * The options of a sponsor's backend cart: the key of the channel it was
+     * created on (`channelMissing` when the bootstrap no longer lists it). A
+     * cart from before channels were remembered keeps the sponsor's first
+     * block, as when it was created, and remembers that channel from now on.
+     */
+    private cartOptions;
+    /**
+     * The backend cart to call for a sponsor, with the key of its channel. When
+     * the bootstrap no longer lists that channel the stale cart is dropped and a
+     * new one is created on the sponsor's current channel with the same lines
+     * (`dropStaleBackendCart` + `ensureCartId`) — never a call with a key of
+     * another channel. `undefined` when there is no backend cart (or none could
+     * be made).
+     */
+    liveCart(sponsorId: number): Promise<{
+        cartId: string;
+        opts: CartQueryOptions;
+    } | undefined>;
+    /**
+     * The channel of a sponsor's cart is gone from the bootstrap (the campaign
+     * moved, a refresh after hours): forget the backend cart and its line ids,
+     * keep the lines, and remember them as they stand now for the next backend
+     * cart (`carryOver`). Queued quantity syncs of the old cart are dropped —
+     * their quantities are in the lines carried.
+     */
+    private dropStaleBackendCart;
+    /** Give a new backend cart the lines of the one whose channel went away — each unit with its own origin. */
+    private replayCarriedLines;
+    /**
+     * Ensure the sponsor cart exists server-side; returns its backend cart id.
+     * A new backend cart is created on the channel of the campaign in context —
+     * `ctx.campaignId` (the add's origin), else the campaign the cart's lines
+     * came from, else `Vio.init`'s — and remembers it (`channelId`). An existing
+     * one whose channel the bootstrap no longer lists is created again on the
+     * current channel, with its lines (`liveCart`).
+     */
+    ensureCartId(sponsorId: number, currency?: string, shippingCountry?: string, ctx?: Pick<CartKeyContext, 'campaignId'>): Promise<string | undefined>;
+    /**
+     * 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`).
+     * `opts.authoritative` is a GetCart taken with nothing of this tab's in
+     * flight (`refreshFromServer`): an empty answer then means the cart IS
+     * empty, and the local lines go — not an add still on its way.
+     */
+    updateFromBackendCart(sponsorId: number, backendCart: {
+        cart_id?: string;
+        currency?: string;
+        shipping_country?: string;
+        subtotal?: number;
+        shipping?: number;
+        available_shipping_countries?: string[];
+        line_items?: Array<{
+            id: string;
+            product_id: number;
+            variant_id?: number | string | null;
+            variant_title?: string | null;
+            brand?: string | null;
+            title?: string | null;
+            quantity: number;
+            image?: string | {
+                url?: string;
+            } | null;
+            imageUrl?: string | null;
+            image_url?: string | null;
+            price?: {
+                amount?: number;
+                amount_incl_taxes?: number | null;
+                currency_code?: string;
+            } | null;
+            shipping?: unknown;
+            available_shippings?: unknown[];
+        }>;
+    }, opts?: {
+        settling?: Promise<unknown>;
+        authoritative?: boolean;
+    }): 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
+     * (not the product base), so different combinations are priced correctly. */
+    addProduct(opts: AddProductOptions): CartLineItem;
+    /** Add a manually-specified line item (no Product DTO). */
+    addManual(opts: AddManualOptions): CartLineItem;
+    /** Quantity intents for lines whose backend id hasn't arrived yet — replayed
+     * when the AddItem response reconciles (keyed by product::variant). */
+    private pendingQtyIntents;
+    private intentKey;
+    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. Targets that arrive while one is in flight queue behind it as
+     * steps (`queueStep`): reduced like the line's origins, sent in order once
+     * the current request settles — one request per queued increase from a
+     * different origin, one for a net decrease — so the server ends on the
+     * last intent, credits every increase to its own origin, 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;
+    /** Refresh the local cart from the backend (source of truth). */
+    fetchCartFromBackend(sponsorId: number): Promise<unknown>;
+    /**
+     * The cart as the server has it, for the moment a checkout is about to be
+     * built on it: what the shopper is about to pay must be what the page shows.
+     * Waits for this tab's own mutations (their answers are the server's too),
+     * then applies GetCart as it is — a line another tab added, one it removed,
+     * an empty cart — and tells the page: `change` for the drawer, and
+     * `vio:cart-updated` on `document` (`source: 'server'`) for a host that
+     * draws its own. A mutation that starts while the server is answering makes
+     * that answer old: it is asked once more. Nothing to ask without a backend
+     * cart. A GetCart that fails leaves the local state as it was and does not
+     * throw — the checkout then goes on with the lines the last mutation
+     * answered, as it always did. Resolves with the sponsor's cart.
      */
-    privacyMode?: SurfacePrivacyMode | 'unknown';
-}
-/**
- * The attribution for the wire, or `undefined` when there is nothing to say.
- * The campaign is the page's; without one, the campaign that explains most
- * units of the cart under the same rule `purchase` is split by (ties: the
- * higher value, then the first). The page (origin + path) and the entry go
- * only on a `standard` surface.
- */
-declare function checkoutAttributionOf(input: CheckoutAttributionInput): CheckoutAttributionWire | undefined;
-/** The landing as `entry`, capped; `undefined` when it says nothing. */
-declare function entryContextOf(landing: Landing | null | undefined): EntryContextWire | undefined;
-/**
- * The campaign that explains most units of the cart — over the slices
- * `purchase` is split by, so the order names the campaign the biggest
- * purchase event names. Ties go to the higher value, then to the first
- * slice. Units nobody attributes (a slice without campaign) never win.
- */
-declare function dominantCampaignOf(slices: ReadonlyArray<CartSlice> | null | undefined): number | undefined;
-
-/**
- * Vipps MobilePay Payment Adapter — GraphQL Integration & Types.
- *
- * Vipps payment integration uses 2 GraphQL operations:
- *
- * 1. `CreatePaymentVipps` mutation:
- *    Initiates a Vipps payment session for a checkout and returns `payment_url`.
- *
- * 2. `GetVippsStatus` query:
- *    Queries Vipps payment state directly for a checkout (`state`).
- */
-
-/**
- * GraphQL mutation to create a Vipps payment session.
- */
-declare const CREATE_PAYMENT_VIPPS_MUTATION = "\nmutation CreatePaymentVipps($checkoutId: String!, $email: String, $returnUrl: String!, $express: Boolean) {\n  Payment {\n    CreatePaymentVipps(checkout_id: $checkoutId, email: $email, return_url: $returnUrl, express: $express) {\n      payment_url\n      reference\n      express\n      reason\n    }\n  }\n}\n";
-/**
- * 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      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. */
-    email?: string;
-    returnUrl: string;
+    refreshFromServer(sponsorId: number): Promise<SponsorCartState | undefined>;
+    /** `vio:cart-updated` on `document` — see `CartUpdatedDetail`. */
+    private emitCartUpdated;
     /**
-     * `true` asks for Express — address and delivery chosen inside the Vipps
-     * app. When the cart cannot have it, no payment is created and the answer
-     * says `express: false` with the reason; the caller then opens the
-     * ordinary checkout.
+     * Another tab of the site wrote the carts: adopt what it wrote, sponsor by
+     * sponsor — its lines and its backend cart id, or nothing when it cleared
+     * the cart (a payment) — except for a sponsor this tab is mid-write for:
+     * its own answer lands in a moment and is persisted then, over whatever
+     * the other tab had. `key` is null when the other tab cleared the whole
+     * storage. Says `change` (the drawer) and `vio:cart-updated` per sponsor
+     * that changed (`source: 'storage'`); nothing when nothing did.
      */
-    express?: boolean;
-}
-interface CreatePaymentVippsResponse {
-    /** Absent when Express was asked for and refused. */
-    payment_url?: string;
-    /** The reference the seller reads in its Vipps portal. */
-    reference?: string;
-    express?: boolean;
-    reason?: string;
-}
-interface GetVippsStatusVariables extends Record<string, unknown> {
-    checkoutId: string;
-}
-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;
-/**
- * Executes the `CreatePaymentVipps` GraphQL mutation.
- */
-declare function createPaymentVipps(variables: CreatePaymentVippsVariables | Record<string, unknown>, options?: CartQueryOptions): Promise<CreatePaymentVippsResponse | null>;
-/**
- * Executes the `GetVippsStatus` GraphQL query.
- */
-declare function getVippsStatus(variables: GetVippsStatusVariables | Record<string, unknown>, options?: CartQueryOptions): Promise<VippsStatusResult | null>;
-
-declare const CREATE_CART_MUTATION = "\nmutation CreateCart($customerSessionId: String!, $currency: String!, $shippingCountry: String) {\n  Cart {\n    CreateCart(customer_session_id: $customerSessionId, currency: $currency, shipping_country: $shippingCountry) {\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 ADD_ITEM_MUTATION = "\nmutation AddItem($cartId: String!, $lineItems: [LineItemInput!]!) {\n  Cart {\n    AddItem(cart_id: $cartId, line_items: $lineItems) {\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 DELETE_ITEM_MUTATION = "\nmutation DeleteItem($cartId: String!, $cartItemId: String!) {\n  Cart {\n    DeleteItem(cart_id: $cartId, cart_item_id: $cartItemId) {\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 UPDATE_ITEM_MUTATION: string;
-/** `UpdateItem` with the `origin` of the added units (`CartLineOriginInput`, snake_case fields — see `lineOriginWire`). */
-declare const UPDATE_ITEM_WITH_ORIGIN_MUTATION: string;
-declare const GET_CART_QUERY = "\nquery GetCart($cartId: String!) {\n  Cart {\n    GetCart(cart_id: $cartId) {\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 GET_LINE_ITEMS_BY_SUPPLIER_QUERY = "\nquery GetLineItemsBySupplier($cartId: String!) {\n  Cart {\n    GetLineItemsBySupplier(cart_id: $cartId) {\n      supplier {\n        id\n        name\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      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      }\n    }\n  }\n}\n";
-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: string;
-/** `CreateCheckout` with the checkout's `attribution` (`CheckoutAttributionInput`, snake_case fields — see `checkoutAttributionOf`). */
-declare const CREATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION: string;
-declare const UPDATE_CHECKOUT_MUTATION: string;
-/** `UpdateCheckout` with the checkout's `attribution` (`CheckoutAttributionInput`). */
-declare const UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION: string;
-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 {
-    endpoint?: string;
-    apiKey?: string;
-    /** Sponsor commerce key — goes in the Authorization header. */
-    commerceKey?: string;
-    /** True when the commerce key came from a resolved sponsor (bootstrap).
-     * False = we fell back to the host apiKey — writes like CreateCart should
-     * NOT proceed with the wrong key (the cart would be orphaned). */
-    sponsorResolved?: boolean;
-}
-/**
- * Resolve endpoint + keys for cart GraphQL calls. Awaits Vio.bootstrap() once
- * if it hasn't run yet (the sponsor commerce keys come from bootstrap), then
- * uses the sponsor's commerce apiKey (via the Vio facade on globalThis,
- * avoiding an import cycle); falls back to the host apiKey.
- */
-declare function getCartGraphQLOptions(sponsorId?: number): Promise<CartQueryOptions>;
-/** Stable per-browser customer session id (backend CreateCart requires one). */
-declare function getCustomerSessionId(): string;
-interface GraphQLEnvelope {
-    data?: Record<string, Record<string, unknown>> | null;
-    errors?: Array<{
-        message?: string;
-        path?: unknown;
-    }>;
+    private onStorage;
+    /** Line items grouped by supplier (shipping is per-supplier server-side). */
+    fetchLineItemsBySupplier(sponsorId: number): Promise<unknown>;
+    /** Set the chosen shipping option per supplier on the backend cart. */
+    updateShippingsBySupplier(sponsorId: number, data: Array<{
+        shipping_id: string;
+        supplier_id: number;
+    }>): Promise<unknown>;
+    getAllCarts(): Map<number, SponsorCartState>;
+    getCart(sponsorId: number): SponsorCartState | undefined;
+    get itemCount(): number;
+    subtotalForSponsor(sponsorId: number): number;
+    get totalAcrossSponsors(): number;
+    get primaryCurrency(): string;
+    formatTotal(): string;
+    /**
+     * Keep the carts for the next page and the other tabs. Where storage
+     * refuses (in-app browsers, private modes) nothing throws (safe-storage.ts):
+     * the carts stay in this manager's own map, the add to cart and the
+     * checkout go on, and the cart just does not survive a reload there.
+     */
+    private persist;
+    private loadFromStorage;
+    private emit;
 }
-/** 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.
- * 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>;
-/**
- * `AddItem`. A line may carry `origin` (`LineOriginWire`: where its units
- * come from — ADR-0035 phase B). A gateway that predates the field refuses
- * the whole mutation at validation (`LineItemInput` has no `origin`), so the
- * lines are sent again without it, once per page load — see gateway-features.
- */
-declare function addItem(cartId: string, lineItems: unknown[], options?: CartQueryOptions): Promise<any>;
-declare function deleteItem(cartId: string, cartItemId: string, options?: CartQueryOptions): Promise<any>;
-/**
- * `UpdateItem`. `extra.origin` is where the units a quantity INCREASE adds
- * come from (ADR-0035 phase B); the server credits the new units to it. Sent
- * only with it; a gateway that predates the argument gets the legacy
- * mutation instead, once per page load — see gateway-features.
- */
-declare function updateItem(cartId: string, cartItemId: string, shippingId?: string | null, qty?: number | null, options?: CartQueryOptions, extra?: {
-    origin?: LineOriginWire;
-}): Promise<any>;
-declare function getCart(cartId: string, options?: CartQueryOptions): Promise<any>;
-declare function getLineItemsBySupplier(cartId: string, options?: CartQueryOptions): Promise<any>;
-declare function updateShippingsBySupplier(cartId: string, data: unknown[], options?: CartQueryOptions): Promise<any>;
 /**
- * `CreateCheckout`. With `extra.attribution` (`CheckoutAttributionWire`:
- * the surface, the page's campaign, the page and the entry — ADR-0035 phase
- * B) the checkout is born attributed; a gateway that predates the argument
- * gets the legacy mutation, once per page load — see gateway-features.
+ * Only the attribution fields, trimmed; `{}` when nothing is known. The kind
+ * of element is kept as Commerce and the collector name it (`card`,
+ * `carousel`, `detail` — `componentKindOf`), from `componentKind` or from
+ * the `componentTemplateId` an element's attribution carries (`product-card`);
+ * the page as origin + path (`contentUrl`) and its title, within Commerce's caps.
  */
-declare function createCheckout(cartId: string, options?: CartQueryOptions, extra?: {
-    attribution?: CheckoutAttributionWire;
-}): Promise<any>;
+declare function normalizeOrigin(origin: CartOrigin | null | undefined): CartOrigin;
+/** Two origins are the same place when campaign, slot, content and kind of element all match (the page's URL and title are attributes of the place, not its identity). */
+declare function sameOrigin(a: CartOrigin, b: CartOrigin): boolean;
 /**
- * `UpdateCheckout`. `variables.attribution` (`CheckoutAttributionWire`) is
- * merged key by key over what the checkout has; a gateway that predates the
- * argument gets the legacy mutation without it, once per page load.
+ * 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 updateCheckout(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
-declare function getCheckout(checkoutId: string, options?: CartQueryOptions): Promise<any>;
-/** What a checkout says of itself after paying: its Vio order number, once the order exists, and its buyer reference. */
-interface CheckoutReference {
-    orderNumber: number | null;
-    buyerRef: string | null;
-}
-/** The order number (null while the order does not exist yet) and the buyer reference (null when the API does not say it). */
-declare function getCheckoutReference(checkoutId: string, options?: CartQueryOptions): Promise<CheckoutReference>;
-declare function getAvailablePaymentMethods(options?: CartQueryOptions): Promise<any>;
-declare const CREATE_PAYMENT_STRIPE_MUTATION = "\nmutation CreatePaymentStripe($checkoutId: String!, $successUrl: String!, $paymentMethod: String!, $email: String!) {\n  Payment {\n    CreatePaymentStripe(checkout_id: $checkoutId, success_url: $successUrl, payment_method: $paymentMethod, email: $email) {\n      order_id\n      checkout_url\n    }\n  }\n}\n";
-declare function createPaymentStripe(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
+declare function lineOrigins(line: Pick<CartLineItem, 'origins' | 'quantity'>): CartLineOrigin[];
 
 /**
  * Stripe on our own page — the Payment Element, no redirect.
@@ -2493,6 +2680,8 @@ interface CheckoutAddress {
     postalCode: string;
     city: string;
     country?: string;
+    /** Mobile number (Norwegian, 8 digits, optional +47) — sent as `phone` + `phone_code`. */
+    phone?: string;
 }
 interface CheckoutState {
     /** Sponsor id whose cart is being checked out. */
@@ -2509,6 +2698,8 @@ interface CheckoutState {
     currency: string;
     /** Backend checkout id (Vio Commerce CreateCheckout). */
     checkoutId?: string;
+    /** The commerce channel the checkout lives on (its cart's): every call for it uses that channel's key. */
+    channelId?: string;
     /** Full backend checkout payload (untyped upstream). */
     checkout?: unknown;
     /** Klarna Payments session id (native GraphQL flow). */
@@ -2637,6 +2828,17 @@ declare class CheckoutManager extends EventTarget {
      */
     private get state();
     private set state(value);
+    /**
+     * The options of a call for a sponsor's cart or checkout: the key of the
+     * channel the checkout lives on — what this tab remembered for the
+     * checkout (a return from a redirect, after the cart was cleared), the open
+     * checkout's, else the cart's — even if a bootstrap refresh no longer lists
+     * it (an open checkout keeps paying with its own key). Without any, the
+     * sponsor's block as `getCartGraphQLOptions` resolves it.
+     */
+    private gqlOptions;
+    /** See `gqlOptions`. */
+    private channelOf;
     /** The last checkout + identity written to the memory — the state is set on every keystroke of the form. */
     private lastRememberedSponsor;
     /** Backend checkouts this page load announced with `vio:checkout-created`: one event each. */
@@ -2709,6 +2911,13 @@ declare class CheckoutManager extends EventTarget {
      * page load; never throws.
      */
     private announceCheckout;
+    /**
+     * Nothing is created or paid for a cart that is empty or totals 0 — as
+     * the SERVER has it (the callers read it from the server first). Throws,
+     * so a payment button ends in its error path, never at a provider asking
+     * for 0 kr.
+     */
+    private assertPayableCart;
     /** Update the backend checkout (terms are re-asserted unless overridden; the attribution rides along unless the caller gives its own). */
     updateCheckout(variables: Record<string, unknown>, sponsorId?: number): Promise<any>;
     getCheckout(checkoutId: string, sponsorId?: number): Promise<any>;
@@ -2800,6 +3009,11 @@ declare class CheckoutManager extends EventTarget {
      * so the caller can open the ordinary checkout instead. Without the flag
      * the backend decides: Express while the cart has no delivery yet, a
      * plain payment once the shopper chose one in our form.
+     *
+     * `express: false` is the checkout's standard path (2026-10-28): the
+     * form's address — name, street, mobile — goes on the checkout before the
+     * payment is created, and the delivery already chosen on the cart is what
+     * Vipps charges for.
      */
     startVippsPayment(sponsorId?: number, formData?: unknown, options?: {
         express?: boolean;
@@ -3179,9 +3393,23 @@ declare function resolveContent(init?: ContentInit | null, doc?: Document | null
 type PrivacyAnswer = SurfacePrivacyMode | 'unknown';
 declare class VioFacade {
     private apiInstance;
+    /** Commerce clients by sponsor AND key: one sponsor may sell on several channels (one per campaign). */
     private commerceClients;
     private bootstrapPromise;
     private cachedBootstrap;
+    /** When the cached bootstrap arrived (ms epoch). */
+    private bootstrapAt;
+    /** A refresh of the bootstrap in flight (`refreshStaleBootstrap`). */
+    private bootstrapRefresh;
+    private bootstrapRefreshFailedAt;
+    /** The `visibilitychange` listener is installed once per page. */
+    private visibilityHooked;
+    /**
+     * Every selling block this page has seen, by `sponsorId:channelId` — so a
+     * checkout opened on a channel keeps its key after a bootstrap refresh no
+     * longer lists that channel (`sponsorCommerce(…, { retired: true })`).
+     */
+    private seenChannels;
     /** Last bootstrap failure — short backoff so cart mutations don't hammer a
      * dead endpoint on every call. */
     private bootstrapFailedAt;
@@ -3203,7 +3431,17 @@ declare class VioFacade {
     /** Each cap warns once per page load. */
     private warnedLocationCap;
     private warnedDeclarationCap;
-    private cartManager;
+    /**
+     * One cart manager per connection (environment + key), each with its own
+     * storage entry; `Vio.cart` is a stable front for the current one, so a
+     * re-init with another key switches carts without the page re-subscribing.
+     * A manager left behind keeps its carts (they come back if the page switches
+     * back) and finishes its requests into ITS carts, never the new one's.
+     */
+    private cartManagers;
+    private cartScope;
+    private cartFront;
+    private readonly cartEvents;
     private checkoutManager;
     private analyticsManager;
     /** What the surface answered of its privacy mode (`GET /v2/mobile/surface`) and when; `unknown` expires after a minute. */
@@ -3225,6 +3463,15 @@ declare class VioFacade {
     get config(): ResolvedConfig;
     /** Multi-sponsor cart manager. Reactive — listen via addEventListener('change', ...). */
     get cart(): CartManager;
+    /** The cart manager of the page's connection now (created on first use). */
+    private currentCartManager;
+    /**
+     * `Vio.cart`: every property and method is the current connection's
+     * manager's; the listeners live on the front, so they survive a switch.
+     */
+    private makeCartFront;
+    /** After `init`: the carts are the new connection's. Says `change` when that switched them. */
+    private switchCartScope;
     /** Checkout flow manager. Subscribes to cart state via the CartManager; asks here for the order's attribution. */
     get checkout(): CheckoutManager;
     /**
@@ -3245,6 +3492,20 @@ declare class VioFacade {
      */
     bootstrap(): Promise<BootstrapResponse>;
     get bootstrapCache(): BootstrapResponse | null;
+    /** A bootstrap becomes the page's: when it arrived, the channels it lists, and the tab-visible refresh. */
+    private adoptBootstrap;
+    /**
+     * The bootstrap is cached for the page's life, but a tab can stay open for
+     * days: when it becomes visible again and the cached one is older than
+     * five minutes, it is fetched again (new campaigns, channels). The old one
+     * stays until the new one arrives — and stays if the refresh fails. Carts
+     * keep their lines; a cart whose channel the new bootstrap no longer lists
+     * is moved to the current channel the next time it is used (CartManager),
+     * and an open checkout keeps paying with the key of its own channel.
+     */
+    private hookVisibility;
+    /** Fetch the bootstrap again when the cached one is older than `maxAgeMs`; never throws, never clears the cache. */
+    private refreshStaleBootstrap;
     /**
      * Who a sponsor is to a shopper — `{ id, name, logoUrl, avatarUrl }` — by
      * the ONE rule every element uses (`sponsorIdentityFrom`): the live
@@ -3262,10 +3523,32 @@ declare class VioFacade {
         checkoutId?: string | null;
     }): SponsorIdentity | null;
     /**
-     * Get a CommerceClient scoped to a specific sponsor (via bootstrap).
-     * Throws if bootstrap hasn't been called or the sponsor is unknown.
-     */
-    commerceFor(sponsorId: number): CommerceClient;
+     * The block a sponsor sells with — its `commerce.apiKey` and `channelId` —
+     * by the rule one article = one campaign = one channel = one sponsor (see
+     * `sponsorCommerceIn`): `ctx.channelId` → that channel's block only (a cart
+     * created on a channel is only called with its key); else the campaign in
+     * context — `ctx.campaignId` candidates (the click's, the element's
+     * `vio-campaign`, an ancestor's `data-vio-campaign`), then
+     * `Vio.init({ campaignId })` — when the sponsor takes part in it; else the
+     * sponsor's first block that sells (the behaviour before). `campaignId:
+     * null` means no campaign at all, not even `Vio.init`'s. `retired: true`
+     * also answers a channel the current bootstrap no longer lists with the
+     * block this page saw for it (an open checkout after a bootstrap refresh).
+     * Blocks with `commerce: null` are skipped. `null` when none; never throws.
+     */
+    sponsorCommerce(sponsorId: number | string | null | undefined, ctx?: SponsorCommerceContext & {
+        retired?: boolean;
+    }): SellingSponsor | null;
+    /**
+     * Get a CommerceClient scoped to a sponsor (via bootstrap) — on the
+     * channel of the campaign in context (`ctx.campaignId`, the element's
+     * candidates first; see `sponsorCommerce`) or of `ctx.channelId`. Without
+     * `ctx`, the page's campaign (`Vio.init`) when the sponsor takes part in
+     * it, else the sponsor's first selling block, as before. Clients are kept
+     * per sponsor and key. Throws if bootstrap hasn't been called or nothing of
+     * the sponsor sells there.
+     */
+    commerceFor(sponsorId: number, ctx?: SponsorCommerceContext): CommerceClient;
     /** Get a CommerceClient using an explicit commerce apiKey (skip bootstrap). */
     commerceWithKey(commerceApiKey: string): CommerceClient;
     /**
@@ -3375,9 +3658,10 @@ declare class VioFacade {
      * The attribution of the order a sponsor's cart is about to become
      * (ADR-0035 phase B) — what `CreateCheckout` / `UpdateCheckout` send as
      * `attribution` and shopcart writes on the order: the surface (its SDK
-     * key), the page's campaign (`pageCampaign()`; without one, the campaign
-     * that explains most units of the cart under the same rule `purchase` is
-     * split by — `cartSlices`) and, on a surface KNOWN to be `standard`
+     * key), the campaign of the order — always one the cart's sponsor takes part
+     * in (`orderCampaign`: the cart lines' own campaign, else the page's;
+     * without one, the campaign that explains most units of the cart under the
+     * same rule `purchase` is split by — `cartSlices`) and, on a surface KNOWN to be `standard`
      * (`privacyModeNow`), the page (`content()`'s url as origin + path, and
      * title) and where the session came in: the landing the session REMEMBERS
      * (`storedLanding`, else the one analytics resolved on this page) — never
@@ -3386,6 +3670,17 @@ declare class VioFacade {
      * limits. `undefined` when there is nothing to say; never throws.
      */
     orderAttribution(sponsorId?: number): CheckoutAttributionWire | undefined;
+    /**
+     * The campaign an order of `sponsorId` is credited to — one article = one
+     * campaign = one sponsor, so it is always one the sponsor takes part in:
+     * the campaign the cart's own lines were added from (their origins; the one
+     * that explains most units), else the page's — the elements' campaigns on
+     * the page (`vio-campaign` / `data-vio-campaign`, in document order), then
+     * `Vio.init({ campaignId })` — the first one active with that sponsor.
+     * `undefined` when neither says one (the slices then decide). Without a
+     * sponsor, the page's campaign as before.
+     */
+    private orderCampaign;
     /** The landing the session remembers: what the first page stored, else what analytics resolved on this page load (consent pending); null otherwise. */
     private rememberedLanding;
     /**
@@ -3435,6 +3730,46 @@ declare const BUYER_REF_MAX_LENGTH = 128;
 /** The reference when `value` is one; `undefined` for anything else (never an email). */
 declare function normalizeBuyerRef(value: unknown): string | undefined;
 
+/**
+ * Internal traffic (ADR-0041 §5): a browser of Vio's own people — Angelo,
+ * Michael, the agents, a tester — marks itself so its visits never count.
+ *
+ * Opening ANY page that runs the SDK with `?vio_internal=1` marks the browser
+ * (`localStorage`, `vio.internal.v1`); `?vio_internal=0` clears the mark.
+ * While marked, every analytics event carries `client.internal: true` and the
+ * collector's reads leave it out. A host can do the same from code with
+ * `Vio.analytics.setInternal(true | false)`.
+ *
+ * The mark is the tester's own explicit choice, not a tracking identifier: it
+ * is written even before consent (`requireConsent`), like a preference.
+ *
+ * Pure like `client-context.ts`: takes the globals it reads (defaults to the
+ * real ones) and never throws — in-app browsers and sandboxed frames throw on
+ * `localStorage` access, and then the page simply is not marked.
+ */
+
+/** Where the browser remembers it is internal (per origin, across sessions). */
+declare const INTERNAL_KEY = "vio.internal.v1";
+/** The URL parameter that marks (`1`) or clears (`0`) the browser. */
+declare const INTERNAL_PARAM = "vio_internal";
+interface InternalEnvironment {
+    location?: {
+        search?: unknown;
+    } | null;
+    /** The persistent memory; `null` = none (SSR, blocked, in-app browser). */
+    storage?: StorageLike | null;
+}
+/**
+ * Whether this browser is internal: the URL's `vio_internal` decides (and is
+ * remembered) when it is `1` or `0`; otherwise what is remembered. Any other
+ * value of the parameter is ignored.
+ */
+declare function resolveInternal(env?: InternalEnvironment): boolean;
+/** What the browser remembers (`false` without storage). */
+declare function readInternal(storage?: StorageLike | null | undefined): boolean;
+/** Remember (or forget) the mark. Never throws. */
+declare function writeInternal(internal: boolean, storage?: StorageLike | null | undefined): void;
+
 /**
  * SDK version reported in analytics events (`sdk_version`) and available
  * to consumers. Kept as a constant (not a package.json import) so the
@@ -3442,7 +3777,7 @@ declare function normalizeBuyerRef(value: unknown): string | undefined;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.29.0";
+declare const SDK_VERSION = "0.33.0";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.
@@ -3471,4 +3806,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, BUYER_REF_MAX_LENGTH, type BootstrapCampaign, type BootstrapCampaignEntry, type BootstrapCampaignStatus, type BootstrapResponse, type BootstrapSlot, CHECKOUT_ATTRIBUTION_CAPS, CHECKOUT_SPONSOR_STORAGE_KEY, CLIENT_LANDING_URL_MAX_LENGTH, CONTENT_URL_MAX_LENGTH, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_CHECKOUT_WITH_ATTRIBUTION_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 CartUpdatedDetail, type CheckoutAddress, type CheckoutAttributionInput, type CheckoutAttributionWire, type CheckoutChangeDetail, CheckoutManager, type CheckoutManagerDeps, type CheckoutOpenDetail, type CheckoutReference, type CheckoutSponsor, type CheckoutState, type ClientContext, CommerceClient, Configuration, type ContentRef, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type EntryContextWire, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GRAPHQL_INT_MAX, type GatewayFeature, type GetVippsStatusVariables, type ImageSize, LINE_ORIGIN_CAPS, type Landing, type LineOriginWire, type LineOriginWireOptions, type ManifestLocation, type ManifestRequest, type ManifestResult, type OrderReference, type OriginPage, 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 PurchaseIds, type RegisterSlotOptions, type ResolvedConfig, SDK_VERSION, type SlotInput, type SlotKind, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type SponsorIdentity, type SurfacePrivacyMode, type SurfaceResponse, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_ITEM_WITH_ORIGIN_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, buyerRefOf, campaignCandidates, capContentUrl, cartSlicesFrom, checkApplePayAvailability, checkoutAttributionOf, componentKindOf, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, dominantCampaignOf, ensureVippsButton, entryContextOf, executeCartGraphQL, formatPrice, gatewayHas, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCheckoutReference, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, isUnknownFeatureError, isUnknownTokenError, landingUrl, lineOriginWire, lineOrigins, normalizeBuyerRef, normalizeOrigin, normalizeScope, normalizeSlotKind, originAndPath, primaryImageUrl, purchaseFromPaymentSuccess, purchaseIdsOf, resetGatewayFeatures, resolveCampaignId, resolveClientContext, resolveContent, resolveLanding, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, sponsorIdentityFrom, storedLanding, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes, withGatewayFeature };
+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, BUYER_REF_MAX_LENGTH, type BootstrapCampaign, type BootstrapCampaignEntry, type BootstrapCampaignStatus, type BootstrapResponse, type BootstrapSlot, CHECKOUT_ATTRIBUTION_CAPS, CHECKOUT_SPONSOR_STORAGE_KEY, CLIENT_LANDING_URL_MAX_LENGTH, CONTENT_URL_MAX_LENGTH, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_CHECKOUT_WITH_ATTRIBUTION_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 CartUpdatedDetail, type CheckoutAddress, type CheckoutAttributionInput, type CheckoutAttributionWire, type CheckoutChangeDetail, CheckoutManager, type CheckoutManagerDeps, type CheckoutOpenDetail, type CheckoutReference, type CheckoutSponsor, type CheckoutState, type ClientContext, CommerceClient, Configuration, type ContentRef, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type EntryContextWire, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, GRAPHQL_INT_MAX, type GatewayFeature, type GetVippsStatusVariables, INTERNAL_KEY, INTERNAL_PARAM, type ImageSize, LINE_ORIGIN_CAPS, type Landing, type LineOriginWire, type LineOriginWireOptions, type ManifestLocation, type ManifestRequest, type ManifestResult, type OrderReference, type OriginPage, 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 PurchaseIds, type RegisterSlotOptions, type ResolvedConfig, SDK_VERSION, type SlotInput, type SlotKind, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type SponsorIdentity, type SurfacePrivacyMode, type SurfaceResponse, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_CHECKOUT_WITH_ATTRIBUTION_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_ITEM_WITH_ORIGIN_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, buyerRefOf, campaignCandidates, capContentUrl, cartSlicesFrom, checkApplePayAvailability, checkoutAttributionOf, componentKindOf, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, dominantCampaignOf, ensureVippsButton, entryContextOf, executeCartGraphQL, formatPrice, gatewayHas, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCheckoutReference, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, isUnknownFeatureError, isUnknownTokenError, landingUrl, lineOriginWire, lineOrigins, normalizeBuyerRef, normalizeOrigin, normalizeScope, normalizeSlotKind, originAndPath, primaryImageUrl, purchaseFromPaymentSuccess, purchaseIdsOf, readInternal, resetGatewayFeatures, resolveCampaignId, resolveClientContext, resolveContent, resolveInternal, resolveLanding, resolveSlotCampaign, sameOrigin, showApplePaySheet, sponsorCampaignEntry, sponsorIdentityFrom, storedLanding, toCampaignId, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes, withGatewayFeature, writeInternal };