@vio-live/web-sdk 0.32.0 → 0.33.0

package/dist/core/index.d.ts

@@ -627,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;
@@ -634,393 +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;
-    /**
-     * 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;
-}
-/**
- * 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 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";
-/**
- * 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';
 }
@@ -1245,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.
  *
@@ -1806,195 +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).
- * 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;
-    }>;
+    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.
@@ -2601,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). */
@@ -2729,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. */
@@ -3283,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;
@@ -3307,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. */
@@ -3329,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;
     /**
@@ -3349,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
@@ -3366,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;
     /**
@@ -3479,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
@@ -3490,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;
     /**
@@ -3586,7 +3777,7 @@ declare function writeInternal(internal: boolean, storage?: StorageLike | null |
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.32.0";
+declare const SDK_VERSION = "0.33.0";
 
 /**
  * Vipps MobilePay's own button, the way the design guidelines ask for it.