@vio-live/web-sdk 0.11.1 → 0.21.0

package/dist/core/index.d.ts

@@ -150,14 +150,60 @@ interface Sponsor {
     secondaryColor?: string | null;
     commerce: SponsorCommerceBlock;
 }
+/**
+ * `campaign` of `GET /v2/mobile/config`: the head of the surface's default
+ * campaign (the one `primarySponsor` / `secondarySponsors` belong to).
+ */
+interface BootstrapCampaign {
+    id: number;
+    name: string;
+    logo?: string | null;
+    isActive?: boolean;
+    isPaused?: boolean;
+    startDate?: string | null;
+    endDate?: string | null;
+}
+/** Campaign status as the backend computes it (`[startsAt, endsAt)`). */
+type BootstrapCampaignStatus = 'scheduled' | 'active' | 'paused' | 'ended';
+/** A slot assignment of a campaign on this surface (`campaigns[].slots[]`). */
+interface BootstrapSlot {
+    name: string;
+    platform?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+}
+/**
+ * One entry of `campaigns[]`: every active campaign of the surface, with its
+ * own sponsors — a sponsor may live only in a non-default campaign.
+ */
+interface BootstrapCampaignEntry extends BootstrapCampaign {
+    isDefault?: boolean;
+    status?: BootstrapCampaignStatus;
+    primarySponsor?: Sponsor | null;
+    secondarySponsors?: Sponsor[];
+    slots?: BootstrapSlot[];
+}
 /**
  * Response shape of `GET /v2/mobile/config` (and likely future `/v2/web/config`).
  * Matches the iOS SDK's `SdkBootstrapResponse` model.
+ *
+ * `campaign` + `primarySponsor` + `secondarySponsors` describe the surface's
+ * default campaign; `campaigns[]` lists every active one. There is no
+ * top-level `campaignId` — the id lives in `campaign.id`.
  */
 interface BootstrapResponse {
-    campaignId?: number;
+    endpoints?: {
+        webSocketBase?: string;
+        commerceGraphQL?: string;
+    };
+    campaign?: BootstrapCampaign;
     primarySponsor?: Sponsor;
     secondarySponsors?: Sponsor[];
+    features?: {
+        shoppable?: boolean;
+        lineup?: boolean;
+    };
+    campaigns?: BootstrapCampaignEntry[];
     market?: {
         countryCode: string;
         currencyCode: string;
@@ -196,7 +242,7 @@ declare function formatPrice(amount: number, currency?: string): string;
 declare function primaryImageUrl(product: Product): string | undefined;
 
 /**
- * Vio REST API client — talks to `api-dev.vio.live` (or override).
+ * Vio REST API client — talks to `api-staging.vio.live` (or override).
  *
  * Endpoints (mirrors the iOS SDK's surface):
  *   GET  /v2/mobile/config                                bootstrap (sponsors + market)
@@ -211,7 +257,7 @@ declare function primaryImageUrl(product: Product): string | undefined;
  */
 
 interface VioApiOptions {
-    /** REST API base URL, e.g. `https://api-dev.vio.live`. */
+    /** REST API base URL, e.g. `https://api-staging.vio.live`. */
     apiBase: string;
     /** Top-level Vio apiKey for this client app. */
     apiKey: string;
@@ -280,6 +326,16 @@ declare class ChannelProduct {
      * Returns an empty array if no ids are provided.
      */
     getByIds(options: GetProductsByIdsOptions): Promise<Product[]>;
+    /**
+     * The seller's Company name for one product, or null (none set, or an API
+     * that does not have the field yet). Never throws.
+     *
+     * Never from the cache, on purpose: graphql caches product answers by
+     * path whatever fields the query asked, so this narrow query, written to
+     * the cache, would hand the next full product query a product with no
+     * price and no images. `useCache: false` neither reads nor writes it.
+     */
+    getSellerCompany(productId: number): Promise<string | null>;
 }
 declare class Channel {
     readonly product: ChannelProduct;
@@ -470,6 +526,176 @@ declare class CartManager extends EventTarget {
     private emit;
 }
 
+/**
+ * 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 = "\nmutation UpdateItem($cartId: String!, $cartItemId: String!, $shippingId: String, $qty: Int) {\n  Cart {\n    UpdateItem(cart_id: $cartId, cart_item_id: $cartItemId, shipping_id: $shippingId, qty: $qty) {\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_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 = "\nmutation CreateCheckout($cartId: String!) {\n  Checkout {\n    CreateCheckout(cart_id: $cartId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
+declare const UPDATE_CHECKOUT_MUTATION = "\nmutation UpdateCheckout($checkoutId: String!, $status: String, $successUrl: String, $email: String, $cancelUrl: String, $paymentMethod: String, $shippingAddress: AddressArgs, $billingAddress: AddressArgs, $buyerAcceptsPurchaseConditions: Boolean, $buyerAcceptsTermsConditions: Boolean) {\n  Checkout {\n    UpdateCheckout(checkout_id: $checkoutId, status: $status, success_url: $successUrl, email: $email, cancel_url: $cancelUrl, payment_method: $paymentMethod, shipping_address: $shippingAddress, billing_address: $billingAddress, buyer_accepts_purchase_conditions: $buyerAcceptsPurchaseConditions, buyer_accepts_terms_conditions: $buyerAcceptsTermsConditions) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
+declare const GET_CHECKOUT_QUERY = "\nquery GetCheckout($checkoutId: String!) {\n  Checkout {\n    GetCheckout(checkout_id: $checkoutId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      duplicate_of\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
+declare const GET_AVAILABLE_PAYMENT_METHODS_QUERY = "\nquery Config {\n  Payment {\n    GetAvailablePaymentMethods {\n      config {\n        name\n        type\n        value\n      }\n      name\n    }\n  }\n}\n";
+/** Transport options for a cart/checkout GraphQL call. */
+interface CartQueryOptions {
+    endpoint?: string;
+    apiKey?: string;
+    /** Sponsor commerce key — goes in the Authorization header. */
+    commerceKey?: string;
+    /** True when the commerce key came from a resolved sponsor (bootstrap).
+     * False = we fell back to the host apiKey — writes like CreateCart should
+     * NOT proceed with the wrong key (the cart would be orphaned). */
+    sponsorResolved?: boolean;
+}
+/**
+ * Resolve endpoint + keys for cart GraphQL calls. Awaits Vio.bootstrap() once
+ * if it hasn't run yet (the sponsor commerce keys come from bootstrap), then
+ * uses the sponsor's commerce apiKey (via the Vio facade on globalThis,
+ * avoiding an import cycle); falls back to the host apiKey.
+ */
+declare function getCartGraphQLOptions(sponsorId?: number): Promise<CartQueryOptions>;
+/** Stable per-browser customer session id (backend CreateCart requires one). */
+declare function getCustomerSessionId(): string;
+interface GraphQLEnvelope {
+    data?: Record<string, Record<string, unknown>>;
+    errors?: Array<{
+        message?: string;
+    }>;
+}
+/** 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. */
+declare function executeCartGraphQL(query: string, variables: Record<string, unknown>, options?: CartQueryOptions | number | undefined): Promise<GraphQLEnvelope>;
+declare function createCart(customerSessionId: string, currency: string, shippingCountry?: string | null, options?: CartQueryOptions): Promise<any>;
+declare function addItem(cartId: string, lineItems: unknown[], options?: CartQueryOptions): Promise<any>;
+declare function deleteItem(cartId: string, cartItemId: string, options?: CartQueryOptions): Promise<any>;
+declare function updateItem(cartId: string, cartItemId: string, shippingId?: string | null, qty?: number | null, options?: CartQueryOptions): 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>;
+declare function createCheckout(cartId: string, options?: CartQueryOptions): Promise<any>;
+declare function updateCheckout(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
+declare function getCheckout(checkoutId: string, options?: CartQueryOptions): Promise<any>;
+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>;
+
+/**
+ * Stripe on our own page — the Payment Element, no redirect.
+ *
+ * The older web flow minted a Stripe Payment Link and sent the shopper to a
+ * page hosted by Stripe. This one keeps them here (Angelo, 2026-09-24):
+ *
+ *   1. Vio Commerce creates a PaymentIntent for the checkout
+ *      (`Payment { CreatePaymentIntentStripe }`) and answers with its client
+ *      secret AND the publishable key of the account that minted it — the
+ *      seller's when they brought both keys, ours otherwise. The two are
+ *      halves of one account: the browser confirms with the key what the
+ *      server minted with the secret one.
+ *   2. Stripe's Payment Element is mounted in a LIGHT-DOM container, the way
+ *      the other embedded widgets are. Card fields are Stripe's own iframes,
+ *      so card data never touches this SDK or our servers.
+ *   3. `confirm()` pays. A 3-D Secure challenge opens in Stripe's own modal
+ *      over the page: `redirect: 'if_required'` keeps the shopper here for
+ *      cards, and still redirects for a method that has no other way.
+ *   4. The Commerce order is NOT born here. Stripe's `payment_intent.succeeded`
+ *      webhook creates it, verified server-side; the checkout is polled for
+ *      its status afterwards, exactly as the redirect return does.
+ */
+
+/** What the backend hands over to pay a checkout on our page. */
+interface StripeIntent {
+    /** `pi_..._secret_...`: what the browser confirms. */
+    client_secret: string;
+    /** The key of the SAME account that minted the secret. */
+    publishable_key: string;
+    customer?: string;
+    /**
+     * Stripe Connect (ADR-0022): the seller's connected account, where the
+     * intent lives. The browser must name it or Stripe answers "no such
+     * payment_intent". Absent for every seller not on Connect.
+     */
+    stripe_account?: string;
+}
+/** What `confirm()` answers. The browser's word is never the order. */
+type StripeConfirmOutcome = {
+    status: 'succeeded';
+    paymentIntentId?: string;
+}
+/** Authorised but not settled yet, or Stripe redirected and will return. */
+ | {
+    status: 'pending';
+    paymentIntentId?: string;
+} | {
+    status: 'failed';
+    message?: string;
+    code?: string;
+};
+interface StripeElementHandle {
+    confirm(): Promise<StripeConfirmOutcome>;
+    unmount(): void;
+}
+
 /**
  * Apple Pay on the Web — via Stripe Payment Request API.
  *
@@ -640,105 +866,6 @@ declare global {
     }
 }
 
-/**
- * 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!) {\n  Payment {\n    CreatePaymentVipps(checkout_id: $checkoutId, email: $email, return_url: $returnUrl) {\n      payment_url\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    }\n  }\n}\n";
-interface CreatePaymentVippsVariables extends Record<string, unknown> {
-    checkoutId: string;
-    email: string;
-    returnUrl: string;
-}
-interface CreatePaymentVippsResponse {
-    payment_url: string;
-}
-interface GetVippsStatusVariables extends Record<string, unknown> {
-    checkoutId: string;
-}
-interface VippsStatusResult {
-    state: string;
-}
-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 = "\nmutation UpdateItem($cartId: String!, $cartItemId: String!, $shippingId: String, $qty: Int) {\n  Cart {\n    UpdateItem(cart_id: $cartId, cart_item_id: $cartItemId, shipping_id: $shippingId, qty: $qty) {\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_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 = "\nmutation CreateCheckout($cartId: String!) {\n  Checkout {\n    CreateCheckout(cart_id: $cartId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
-declare const UPDATE_CHECKOUT_MUTATION = "\nmutation UpdateCheckout($checkoutId: String!, $status: String, $successUrl: String, $email: String, $cancelUrl: String, $paymentMethod: String, $shippingAddress: AddressArgs, $billingAddress: AddressArgs, $buyerAcceptsPurchaseConditions: Boolean, $buyerAcceptsTermsConditions: Boolean) {\n  Checkout {\n    UpdateCheckout(checkout_id: $checkoutId, status: $status, success_url: $successUrl, email: $email, cancel_url: $cancelUrl, payment_method: $paymentMethod, shipping_address: $shippingAddress, billing_address: $billingAddress, buyer_accepts_purchase_conditions: $buyerAcceptsPurchaseConditions, buyer_accepts_terms_conditions: $buyerAcceptsTermsConditions) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
-declare const GET_CHECKOUT_QUERY = "\nquery GetCheckout($checkoutId: String!) {\n  Checkout {\n    GetCheckout(checkout_id: $checkoutId) {\n      buyer_accepts_purchase_conditions\n      buyer_accepts_terms_conditions\n      created_at\n      updated_at\n      id\n      deleted_at\n      success_url\n      cancel_url\n      payment_method\n      email\n      status\n      checkout_url\n      origin_payment_id\n      billing_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      shipping_address {\n        id\n        first_name\n        last_name\n        phone_code\n        phone\n        company\n        address1\n        address2\n        city\n        province\n        province_code\n        country\n        country_code\n        zip\n      }\n      available_payment_methods {\n        name\n      }\n      discount_code\n      cart {\n        cart_id\n        customer_session_id\n        shipping_country\n        line_items {\n          id\n          supplier\n          image {\n            id\n            url\n            width\n            height\n          }\n          sku\n          barcode\n          brand\n          product_id\n          title\n          variant_id\n          variant_title\n          variant {\n            option\n            value\n          }\n          quantity\n          price {\n            amount\n            currency_code\n            discount\n            compare_at\n            compare_at_incl_taxes\n            amount_incl_taxes\n            tax_amount\n            tax_rate\n          }\n          shipping {\n            id\n            name\n            description\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n          available_shippings {\n            id\n            name\n            description\n            country_code\n            price {\n              amount\n              currency_code\n              amount_incl_taxes\n              tax_amount\n              tax_rate\n            }\n          }\n        }\n        subtotal\n        shipping\n        currency\n        available_shipping_countries\n      }\n      totals {\n        currency_code\n        subtotal\n        shipping\n        total\n        taxes\n        tax_rate\n        discounts\n      }\n    }\n  }\n}\n";
-declare const GET_AVAILABLE_PAYMENT_METHODS_QUERY = "\nquery Config {\n  Payment {\n    GetAvailablePaymentMethods {\n      config {\n        name\n        type\n        value\n      }\n      name\n    }\n  }\n}\n";
-/** Transport options for a cart/checkout GraphQL call. */
-interface CartQueryOptions {
-    endpoint?: string;
-    apiKey?: string;
-    /** Sponsor commerce key — goes in the Authorization header. */
-    commerceKey?: string;
-    /** True when the commerce key came from a resolved sponsor (bootstrap).
-     * False = we fell back to the host apiKey — writes like CreateCart should
-     * NOT proceed with the wrong key (the cart would be orphaned). */
-    sponsorResolved?: boolean;
-}
-/**
- * Resolve endpoint + keys for cart GraphQL calls. Awaits Vio.bootstrap() once
- * if it hasn't run yet (the sponsor commerce keys come from bootstrap), then
- * uses the sponsor's commerce apiKey (via the Vio facade on globalThis,
- * avoiding an import cycle); falls back to the host apiKey.
- */
-declare function getCartGraphQLOptions(sponsorId?: number): Promise<CartQueryOptions>;
-/** Stable per-browser customer session id (backend CreateCart requires one). */
-declare function getCustomerSessionId(): string;
-interface GraphQLEnvelope {
-    data?: Record<string, Record<string, unknown>>;
-    errors?: Array<{
-        message?: string;
-    }>;
-}
-/** 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. */
-declare function executeCartGraphQL(query: string, variables: Record<string, unknown>, options?: CartQueryOptions | number | undefined): Promise<GraphQLEnvelope>;
-declare function createCart(customerSessionId: string, currency: string, shippingCountry?: string | null, options?: CartQueryOptions): Promise<any>;
-declare function addItem(cartId: string, lineItems: unknown[], options?: CartQueryOptions): Promise<any>;
-declare function deleteItem(cartId: string, cartItemId: string, options?: CartQueryOptions): Promise<any>;
-declare function updateItem(cartId: string, cartItemId: string, shippingId?: string | null, qty?: number | null, options?: CartQueryOptions): 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>;
-declare function createCheckout(cartId: string, options?: CartQueryOptions): Promise<any>;
-declare function updateCheckout(variables: Record<string, unknown>, options?: CartQueryOptions): Promise<any>;
-declare function getCheckout(checkoutId: string, options?: CartQueryOptions): Promise<any>;
-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>;
-
 /**
  * Kustom (former Klarna Checkout) — embedded KCO v3 checkout.
  *
@@ -747,26 +874,64 @@ declare function createPaymentStripe(variables: Record<string, unknown>, options
  *
  *   1. Vio Commerce creates the order (`Payment { CreatePaymentKustom }`,
  *      authed with the sponsor's commerce API key; the seller's own
- *      kco_*_api_* key lives server-side, per seller, never here).
- *   2. The response's `html_snippet` is injected into a container — it
- *      renders Kustom's iframe, which collects address, shipping AND payment
- *      by itself (the widget does everything; no Vio address form).
- *   3. On completion Kustom redirects to the confirmation URL
- *      (`?order_id=…&payment_processor=KUSTOM`), where the SDK re-reads the
- *      order (`Payment { GetKustomOrder }`) and renders its confirmation
- *      snippet — KCO's own receipt.
+ *      kco_*_api_* key lives server-side, per seller, never here). One order
+ *      per checkout: asking again while it is open UPDATES it.
+ *   2. The response's `html_snippet` is injected into a LIGHT-DOM container
+ *      — it renders Kustom's iframe, which collects address, shipping AND
+ *      payment by itself (the widget does everything; no Vio address form).
+ *   3. While it is open, the widget talks through `window._klarnaCheckout`:
+ *      we suspend it around a cart change (`Payment { SyncPaymentKustom }`),
+ *      and listen to its totals so our summary never disagrees with it.
+ *   4. On completion Kustom redirects to the confirmation URL
+ *      (`?order_id=…&payment_processor=KUSTOM&checkout_id=…`), where the SDK
+ *      re-reads the order (`Payment { GetKustomOrder }`) — the backend
+ *      completes it right there — and renders Kustom's own receipt.
  *
- * The Commerce order itself is created server-side by Kustom's push webhook
- * (shopcart /checkout/payment/kustom/ok) — the browser never confirms money.
+ * The Commerce order is created server-side, from what Kustom says it
+ * charged (Order Management), whether the shopper comes back or not (the
+ * push) — the browser never confirms money.
  */
 
-/** KCO order fields the SDK consumes (the full order is much larger). */
+/** A Kustom order as shopcart normalizes it (never Kustom's raw order). */
 interface KustomOrder {
     order_id: string;
+    /** `checkout_incomplete` | `checkout_complete`, lower-cased by the backend. */
     status: string;
     html_snippet: string;
     purchase_country?: string;
     purchase_currency?: string;
+    checkout_id?: string;
+    environment?: string;
+    /** Goods + the shipping shown or charged, decimal. */
+    total_price?: number;
+    shipping_name?: string;
+    shipping_price?: number;
+    /** Whether the Vio Commerce order exists (after completion). */
+    order_created?: boolean;
+    /** Kustom's short shopper-facing reference (after completion). */
+    reference?: string;
+}
+interface KustomShippingChange {
+    id?: string;
+    name?: string;
+    description?: string;
+    /** Minor units, as the widget reports them. */
+    price?: number;
+    tax_amount?: number;
+    tax_rate?: number;
+}
+interface KustomListenerHandlers {
+    /** The iframe rendered. */
+    onLoad?: (data: any) => void;
+    /** The order total the widget shows, in MINOR units. */
+    onOrderTotalChange?: (orderTotalMinor: number) => void;
+    /** The shopper picked a rate inside the widget. */
+    onShippingOptionChange?: (option: KustomShippingChange) => void;
+    /** The shopper could not pay (declined credit…): show another way. */
+    onCannotComplete?: () => void;
+    onNetworkError?: () => void;
+    /** The shopper is about to leave for the confirmation page. */
+    onRedirectInitiated?: () => void;
 }
 
 /**
@@ -872,6 +1037,179 @@ interface WalleyOrder {
     total_price?: number;
 }
 
+/**
+ * Nexi Checkout (formerly Nets Easy) — embedded checkout via Vio Commerce.
+ *
+ * Fourth embedded provider, same category as Kustom/Qliro/Walley: the widget
+ * collects email, phone, addresses AND payment. Two things set it apart and
+ * shape this module:
+ *
+ *   1. There is no html_snippet. `Payment { CreatePaymentNexi }` creates the
+ *      payment server-side (the seller's SECRET key never leaves shopcart)
+ *      and returns the paymentId plus the PUBLIC checkout key; the browser
+ *      loads Nexi's `checkout.js` and mounts `new Dibs.Checkout({…})` in a
+ *      LIGHT-DOM container — Nexi refuses a container inside a shadow root
+ *      or another iframe.
+ *   2. Nexi has no shipping picker. The payment is created with
+ *      `merchantHandlesShippingCost`, so Nexi holds its pay button until we
+ *      price the address the shopper typed: on `address-changed` the widget
+ *      is frozen, `Payment { UpdateNexiShipping }` re-prices for that country
+ *      and pushes the SHIPPING line, and the widget is thawed.
+ *
+ * Completion arrives as the `payment-completed` event — Nexi neither
+ * redirects nor renders a receipt of its own, so the component shows Vio's
+ * confirmation. Some methods inside Nexi (Vipps, Swish, MobilePay) leave the
+ * page and come back to the SAME url with `?paymentId=…` appended; the
+ * pending session is remembered in sessionStorage so the widget can be
+ * re-mounted on that paymentId and finish.
+ *
+ * The Commerce order itself is created server-side by Nexi's webhook
+ * (shopcart /checkout/payment/nexi/ok) — the browser never confirms money.
+ */
+
+/** Normalized Nexi payment (shopcart maps the Payment API). */
+interface NexiOrder {
+    /** Nexi paymentId (32 hex). */
+    order_id: string;
+    /** Created | Reserved | Charged | Cancelled | Terminated | Unknown. */
+    status: string;
+    /** Public checkout key for Dibs.Checkout. */
+    checkout_key: string;
+    /** checkout.js of the seller's environment (test or live). */
+    checkout_js_url: string;
+    purchase_country?: string;
+    purchase_currency?: string;
+    total_price?: number;
+    /**
+     * Shipping to show next to the widget: the purchase country's rates while
+     * no address is known (`reason: AWAITING_ADDRESS`, nothing charged), or what
+     * the payment carries once one was priced (a resumed widget does not
+     * announce its address again).
+     */
+    shipping?: NexiShippingUpdate | null;
+    /** How it was paid ("Visa", "Vipps"…) — once Nexi has the details. */
+    payment_method?: string | null;
+    /** Last four digits of the card. */
+    card_last4?: string | null;
+    /** Where the receipt goes. */
+    email?: string | null;
+}
+interface NexiShippingUpdate {
+    ok: boolean;
+    /**
+     * When !ok: NO_SHIPPING — Vio does not ship to that country; or
+     * AWAITING_ADDRESS — nothing charged yet, `options` are the purchase
+     * country's rates and `shipping_id` the suggested one.
+     */
+    reason?: string;
+    order_id: string;
+    total_price?: number;
+    shipping_name?: string;
+    shipping_price?: number;
+    /** The rate on the payment now. */
+    shipping_id?: string;
+    /**
+     * Every rate the shopper may pick for this address, best first. Nexi has
+     * no shipping picker of its own, so the checkout shows these.
+     */
+    options?: NexiShippingOption[];
+    /** The address it was priced for (alpha-2 country). */
+    country?: string;
+    postal_code?: string;
+    /** market — the checkout's country, priced at creation; consumer — the shopper's address. */
+    address_source?: 'market' | 'consumer' | null;
+    /** Whether this call changed the amount on the payment. */
+    changed?: boolean | null;
+    /**
+     * Client-side only: set when the amount changed as the shopper pressed pay,
+     * so the payment was stopped and the widget reloaded.
+     */
+    repriced_at_pay?: boolean;
+}
+interface NexiShippingOption {
+    id: string;
+    name: string;
+    /** Incl. VAT, decimal. */
+    price: number;
+}
+
+/**
+ * Adyen — payment via Vio Commerce, rendered with Adyen's own Drop-in.
+ *
+ * Adyen is NOT an embedded checkout like Kustom/Qliro/Walley/Nexi: Drop-in
+ * lists payment methods (cards, Vipps, Klarna, Swish…) and charges, and that
+ * is all. It collects no email, address or shipping, so it belongs with the
+ * FORM-FIRST methods (Stripe, Klarna Payments): the shopper fills Vio's form
+ * and picks Vio's shipping first, and only then is there a session. Three
+ * things shape this module:
+ *
+ *   1. A session is an immutable PHOTO of the purchase. `Payment {
+ *      CreatePaymentAdyen }` creates it server-side (the seller's API key
+ *      never leaves shopcart) from the saved checkout, with the final amount,
+ *      and returns the session plus the PUBLIC client key. It is never
+ *      updated: after any change the caller discards it and creates another.
+ *      At "Pay", `ConfirmAdyenPayment` only VERIFIES (lesson 2026-09-17: the
+ *      amount does not change while the PSP charges).
+ *   2. Adyen Web is loaded from Adyen's CDN, version-pinned and with
+ *      Subresource Integrity — never bundled: it weighs more than this whole
+ *      SDK, and publisher pages must only pay for it when Adyen is used.
+ *      Drop-in is real DOM styled by a real stylesheet (not an iframe), so it
+ *      mounts in the LIGHT DOM and its stylesheet goes in `document.head`.
+ *   3. Vipps, Klarna, Trustly and redirect-3DS leave the page and come back
+ *      to `return_url` with `redirectResult` appended. The return is
+ *      finalised on the SERVER (`GetAdyenPayment(redirect_result)`), and the
+ *      return URL names the checkout, so nothing depends on this tab's
+ *      storage — a shopper sent from an in-app browser to Safari still lands
+ *      on a confirmation. Nothing is resumed from storage on a plain open,
+ *      which is how Nexi once opened one cart's payment on another (0.12.2).
+ *
+ * The page's origin must be in the "Allowed origins" of the credential whose
+ * client key is used, or Adyen refuses to render — see `AdyenOriginError`.
+ *
+ * The Commerce order itself is created server-side by Adyen's webhook —
+ * the browser never confirms money.
+ */
+
+/** What `CreatePaymentAdyen` answers: everything Drop-in is created with. */
+interface AdyenSession {
+    order_id: string;
+    session_id: string;
+    session_data: string;
+    client_key: string;
+    environment: 'test' | 'live' | string;
+    country_code: string;
+    /** As ADYEN names it: Norwegian is `no-NO` (`nb-NO` renders in English). */
+    shopper_locale: string;
+    purchase_currency: string;
+    /** Minor units — Drop-in's Pay button. */
+    amount: number;
+    /** Major units, shipping included. */
+    total_price: number;
+    shipping_name?: string | null;
+    shipping_price?: number | null;
+    expires_at?: string | null;
+}
+type AdyenOutcome = 'authorised' | 'pending' | 'refused' | 'cancelled' | 'error' | 'unknown';
+/** Outcome of the session a checkout owns, as Adyen reported it. */
+interface AdyenPayment {
+    order_id: string;
+    status: AdyenOutcome | string;
+    result_code?: string | null;
+    psp_reference?: string | null;
+    payment_method?: string | null;
+    purchase_country?: string | null;
+    purchase_currency?: string | null;
+    total_price?: number | null;
+    shipping_name?: string | null;
+    shipping_price?: number | null;
+    email?: string | null;
+    order_created: boolean;
+}
+interface AdyenResult {
+    resultCode?: string;
+    sessionResult?: string;
+}
+
 /**
  * Checkout types — multi-sponsor compatible.
  *
@@ -879,7 +1217,7 @@ interface WalleyOrder {
  * merchant, same as iOS multi-sponsor model). Multiple sponsors → multiple
  * sequential checkouts.
  */
-type PaymentMethod = 'apple-pay' | 'klarna' | 'vipps' | 'card' | 'stripe' | 'kustom' | 'qliro' | 'walley';
+type PaymentMethod = 'apple-pay' | 'klarna' | 'vipps' | 'card' | 'stripe' | 'kustom' | 'qliro' | 'walley' | 'nexi' | 'adyen';
 interface CheckoutAddress {
     firstName: string;
     lastName: string;
@@ -910,6 +1248,12 @@ interface CheckoutState {
     sessionId?: string;
     /** Klarna Payments client token (native GraphQL flow). */
     clientToken?: string;
+    /**
+     * Which `open()` this state belongs to — a new number every time a checkout
+     * is opened, kept by every later update. An embedded widget belongs to the
+     * session it was mounted in: a new session means a new order.
+     */
+    session?: number;
 }
 
 /**
@@ -975,18 +1319,39 @@ interface KlarnaPaymentsHandle {
 declare class CheckoutManager extends EventTarget {
     private readonly cartManager;
     private state;
+    /** Counts `open()` calls — see CheckoutState.session. */
+    private sessionSeq;
     private applePayAvailableCache;
     /** Gateway hints learned from CreatePaymentApplePay (per session). The
      * backend's gateway_merchant_id may be a publishable key (pk_…) or a Stripe
      * Connect account (acct_…) — stored defensively by prefix. */
     private applePayPublishableKey;
     private applePayConnectedAccount;
+    /** Stripe Connect account of the channel, from its Stripe config. */
+    private stripeConnectAccount;
     private klarnaAvailableCache;
     /** Live q1 listeners while a Qliro widget is mounted. */
     private qliroController;
+    /** Live Dibs.Checkout handle while a Nexi widget is mounted. */
+    private nexiHandle;
+    /** Live Drop-in while an Adyen session is mounted. */
+    private adyenHandle;
+    private stripeHandle;
+    /**
+     * The rate the shopper wants. Before an address it is only remembered (the
+     * suggested one, or their pick); every re-pricing asks for it, and the
+     * backend charges it if it reaches the address.
+     */
+    private nexiPreferredShipping;
+    /** The rates offered before an address was typed. */
+    private nexiShippingPreview;
+    /** What the last `address-changed` was priced with — a picked rate re-prices the same address. */
+    private nexiShippingContext;
     private klarnaOrderInFlight;
     /** Last backend shippings fetched (per-supplier), for UI reuse. */
     private lastFetchedShippings;
+    /** See `lastShippingsResolved`. */
+    private shippingsResolved;
     /** Per-sponsor payment methods cache + in-flight dedupe. */
     private paymentMethodsCache;
     private paymentMethodsPromises;
@@ -998,6 +1363,12 @@ declare class CheckoutManager extends EventTarget {
     /** Update the backend checkout (terms are re-asserted unless overridden). */
     updateCheckout(variables: Record<string, unknown>, sponsorId?: number): Promise<any>;
     getCheckout(checkoutId: string, sponsorId?: number): Promise<any>;
+    /**
+     * The Vio order number (#4497) a checkout became, or null: not born yet,
+     * or an API that does not say it. Never throws — it is a line on a
+     * receipt, and a receipt does not fail for it.
+     */
+    getOrderNumber(checkoutId: string, sponsorId?: number): Promise<number | null>;
     /**
      * Payment methods enabled for the sponsor (backend-configured). Memoised per
      * sponsor with in-flight dedupe — several UI components ask on every open.
@@ -1014,6 +1385,13 @@ declare class CheckoutManager extends EventTarget {
      * this at all.
      */
     fetchAvailableShippings(sponsorId?: number): Promise<KlarnaShippingOption[]>;
+    /**
+     * Whether the last `fetchAvailableShippings` got an answer from the backend,
+     * possibly an empty one, rather than failing or finding no cart. The two
+     * return the same empty list, and only an answer means the cart has
+     * nothing it can ship with.
+     */
+    get lastShippingsResolved(): boolean;
     /** Set the chosen shipping per supplier on the backend cart. */
     updateShippingsBySupplier(data: Array<{
         shipping_id: string;
@@ -1034,21 +1412,51 @@ declare class CheckoutManager extends EventTarget {
      */
     startStripePayment(sponsorId?: number, formData?: unknown): Promise<any>;
     /**
-     * Vipps payment link: same flow as Stripe — CreatePaymentVipps → redirect to
-     * payment_url.
+     * Vipps: create the payment via Vio Commerce and redirect to Vipps'
+     * landing page (on a phone it opens the app; on a desktop it offers to
+     * send the payment to the phone).
+     *
+     * `express: true` asks for Vipps Express — address and delivery chosen
+     * inside the app, the email handed back with the payment — which is what
+     * the Vipps buttons on the product and the cart ask for. When the cart
+     * cannot have it (several suppliers, digital goods, no rate for the
+     * country) the backend creates NO payment and answers `express: false`
+     * with the reason; this resolves with that answer, without redirecting,
+     * so the caller can open the ordinary checkout instead. Without the flag
+     * the backend decides: Express while the cart has no delivery yet, a
+     * plain payment once the shopper chose one in our form.
+     */
+    startVippsPayment(sponsorId?: number, formData?: unknown, options?: {
+        express?: boolean;
+    }): Promise<any>;
+    /**
+     * The Vipps Express button: the shopper taps it and the app opens with
+     * address and delivery already there. Resolves with `{ express: false,
+     * reason }` — and nothing redirected — when this cart cannot have it.
      */
-    startVippsPayment(sponsorId?: number, formData?: unknown): Promise<any>;
+    startVippsExpress(sponsorId?: number): Promise<any>;
     /** Vipps' own payment state for the checkout — see getVippsStatus in
      * cart-queries.ts for why this exists instead of trusting GetCheckout. */
     getVippsStatus(checkoutId: string, sponsorId?: number): Promise<{
         state?: string;
+        duplicate_of?: string | null;
     } | null>;
     /**
      * Kustom (former Klarna Checkout) — create the KCO order via Vio Commerce
      * and render its html_snippet into `container`. The widget collects
      * address, shipping and payment by itself; the SDK renders nothing else.
      */
-    mountKustomCheckout(container: HTMLElement, sponsorId?: number): Promise<KustomOrder>;
+    mountKustomCheckout(container: HTMLElement, sponsorId?: number, handlers?: KustomListenerHandlers): Promise<KustomOrder>;
+    private kustomController;
+    /** Disarm the widget's listeners with the widget they belong to. */
+    destroyKustomListeners(): void;
+    /**
+     * The cart changed under an open Kustom widget: lock it, push the cart
+     * into the SAME order, and let the widget refresh itself. Kustom's own
+     * rule — never a new order for a cart change. The widget auto-resumes
+     * after 10 s if the sync never comes back.
+     */
+    syncKustomOrder(sponsorId?: number): Promise<KustomOrder | null>;
     /** Re-read a Kustom order — used on the confirmation return trip. */
     getKustomOrder(orderId: string, sponsorId?: number): Promise<KustomOrder | null>;
     /** Render a Kustom html_snippet (e.g. the confirmation receipt) into a container. */
@@ -1084,8 +1492,123 @@ declare class CheckoutManager extends EventTarget {
     mountWalleyCheckout(container: HTMLElement, sponsorId?: number, onPurchaseCompleted?: (order: WalleyOrder) => void): Promise<WalleyOrder>;
     /** Re-read the Walley session owned by a checkout — the confirmation trip. */
     getWalleyOrder(checkoutId: string, sponsorId?: number): Promise<WalleyOrder | null>;
+    /**
+     * Mount the Nexi embedded checkout — Nexi's own JS SDK, not a snippet.
+     *
+     * `onCompleted` fires on Nexi's `payment-completed` (no redirect: Nexi
+     * renders no receipt, the component shows Vio's confirmation). Shipping is
+     * Vio's: Nexi holds its pay button until `address-changed` has been
+     * re-priced through `UpdateNexiShipping` — the widget is frozen meanwhile
+     * and `onShipping` reports the outcome (NO_SHIPPING keeps it held).
+     *
+     * A session interrupted by a third-party redirect inside Nexi (Vipps,
+     * Swish, MobilePay) is remembered in sessionStorage and resumed on the
+     * same paymentId instead of creating a new payment — only when `resume`
+     * names it. Every other opening creates a payment for the cart as it is.
+     */
+    mountNexiCheckout(container: HTMLElement, sponsorId?: number, handlers?: {
+        onCompleted?: (order: NexiOrder) => void;
+        onShipping?: (result: NexiShippingUpdate | null, error?: unknown) => void;
+    }, 
+    /**
+     * Set ONLY when the page came back from a redirect inside Nexi
+     * (Vipps/Swish/MobilePay) with `?paymentId=`: resume that payment.
+     */
+    resume?: {
+        paymentId: string;
+    }): Promise<NexiOrder>;
+    /**
+     * The shopper picked another rate from the `options` Nexi's last
+     * re-pricing returned: charge that one instead. Nexi has no shipping picker,
+     * so the checkout shows the rates and calls this. A no-op until an address
+     * has been typed in the widget.
+     */
+    pickNexiShipping(shippingId: string): Promise<void>;
+    /**
+     * `pay-initialized` → confirm the shipping for the address Nexi will ship
+     * to → `payment-order-finalized`.
+     *
+     * The payment already carries a shipping (set at creation, re-priced on
+     * every address and pick), so normally nothing changes and Nexi charges.
+     * When the shopper's address was never announced — Nexi fills it in for a
+     * shopper it recognises — the backend reads it from the payment. If that
+     * changes the amount, the payment is STOPPED and the widget reloaded: an
+     * amount that changes while Nexi charges is what failed on 2026-09-16/17
+     * (payments 085277846ae44f7498ae94e112435d63, f6116e6d68294a88927d35b05d907f10).
+     */
+    private finalizeNexiPayment;
+    /** address-changed → freeze → UpdateNexiShipping → thaw. */
+    private repriceNexiShipping;
+    /** Release the Dibs.Checkout listeners with the widget they belong to. */
+    destroyNexi(): void;
+    /** Re-read the Nexi payment owned by a checkout. */
+    getNexiOrder(checkoutId: string, sponsorId?: number): Promise<NexiOrder | null>;
+    /**
+     * Adyen: FORM-FIRST. Saves the shopper's form and shipping pick on the
+     * checkout (Adyen collects neither), creates a session with that final
+     * amount and mounts Adyen's Drop-in on it. A session is never updated —
+     * after ANY change the caller destroys this mount and calls again.
+     *
+     * At "Pay" the backend only confirms that the session still pays for the
+     * checkout; when it does not, Adyen is stopped and `onReplaced` tells the
+     * caller to remount. Completion is asked of Adyen through the backend
+     * (`GetAdyenPayment`) — the browser's own result is never the answer.
+     */
+    mountAdyenCheckout(container: HTMLElement, sponsorId: number | undefined, formData: unknown, callbacks: {
+        onCompleted: (payment: AdyenPayment | null, session: AdyenSession) => void;
+        onFailed: (result: AdyenResult, session: AdyenSession) => void;
+        /** The session no longer pays for the checkout (reason from the backend). */
+        onReplaced: (reason: string) => void;
+        onError?: (error: unknown) => void;
+    }): Promise<AdyenSession>;
+    /** Unmount Drop-in. Safe to call when nothing is mounted. */
+    destroyAdyen(): void;
+    /**
+     * Outcome of the Adyen session a checkout owns. With `redirectResult` (the
+     * return from Vipps, Klarna, Trustly or a redirect-3DS) the redirect is
+     * finalised on the server.
+     */
+    getAdyenPayment(checkoutId: string, proof?: {
+        sessionResult?: string;
+        redirectResult?: string;
+    }, sponsorId?: number): Promise<AdyenPayment | null>;
     setAddress(address: CheckoutAddress): void;
     selectPaymentMethod(method: PaymentMethod): void;
+    /**
+     * Which Stripe flow this channel offers: `native` pays on our own page,
+     * `link` sends the shopper to a page hosted by Stripe. The channel's two
+     * toggles decide it and the answer travels in the method's config
+     * (api-microservice, `stripe-offer.ts`). A channel that predates that
+     * field answers `link`, which is what every client did before.
+     */
+    /**
+     * Does this channel's Vipps offer Express — the buy-now buttons that open
+     * the app with address and delivery? Vio Commerce announces it as
+     * `config.express` on the Vipps method, the way Stripe announces `mode`;
+     * the seller switches it on its Vipps row. Unknown means yes: Express is
+     * the default, and the backend refuses it with a reason if it cannot.
+     */
+    getVippsExpressEnabled(sponsorId?: number): Promise<boolean>;
+    getStripeMode(sponsorId?: number): Promise<'native' | 'link'>;
+    /**
+     * Stripe's Payment Element, mounted on our own page for a checkout that is
+     * ready to be paid. Creating it mints a PaymentIntent, so it happens when
+     * the shopper asks for the payment step, never while they type.
+     *
+     * The order is not born here: `confirm()` only says what Stripe told the
+     * browser. The `payment_intent.succeeded` webhook creates it server-side,
+     * and the caller then reads the checkout to see it land.
+     */
+    mountStripeCheckout(container: HTMLElement, sponsorId: number | undefined, formData: unknown, callbacks?: {
+        onReady?: () => void;
+        onLoadError?: (message: string) => void;
+    }): Promise<{
+        handle: StripeElementHandle;
+        intent: StripeIntent;
+        checkoutId: string;
+    }>;
+    /** Unmount the Payment Element. Safe when nothing is mounted. */
+    destroyStripe(): void;
     /**
      * The Stripe publishable key for a sponsor, taken from its own commerce
      * channel (`GetAvailablePaymentMethods` → Stripe → config.publishableKey).
@@ -1217,6 +1740,8 @@ declare class CheckoutManager extends EventTarget {
      * (Stripe will route to the platform account in that case).
      */
     private findStripeConnectAccount;
+    /** The sponsor's connected account, read fresh from its channel config. */
+    private resolveStripeConnectAccount;
     private emit;
 }
 
@@ -1250,6 +1775,7 @@ declare class CheckoutManager extends EventTarget {
  *      the publisher-facing feature; NOT part of the Vio pipeline)
  *   3. `vio:analytics` DOM event — always when started (inspector/bridges)
  */
+
 declare const ANALYTICS_EVENT_NAMES: readonly ["view_item_list", "select_item", "view_item", "add_to_cart", "remove_from_cart", "view_cart", "begin_checkout", "purchase", "component_impression", "component_click", "ad_impression", "ad_click", "poll_impression", "contest_impression", "session_start", "session_end", "checkout_error", "sdk_error"];
 type AnalyticsEventName = (typeof ANALYTICS_EVENT_NAMES)[number];
 /** Camel-case for DX; mapped to the snake_case wire format at build time. */
@@ -1406,6 +1932,60 @@ declare class AnalyticsManager extends EventTarget {
     private cartCommerce;
     private findLine;
 }
+/**
+ * The `campaign_id` of an event. In order: the context's explicit id; the
+ * active campaign of `campaigns[]` the event's sponsor takes part in, as its
+ * primary or one of its secondaries — when it is in several, the surface's
+ * default campaign if it is one of them, else the first one the backend
+ * lists; the default campaign (`campaign.id`). `/v2/mobile/config` has no
+ * top-level `campaignId` — reading one is why every event used to leave
+ * with `campaign_id: 0` and the campaigns screen stayed empty.
+ *
+ * A malformed `campaigns[]` (not an array, a null entry) never breaks
+ * `track()`: it falls back to `campaign.id`.
+ */
+declare function resolveCampaignId(ctx: Pick<AnalyticsContext, 'campaignId' | 'sponsorId'>, boot: Pick<BootstrapResponse, 'campaign' | 'campaigns'> | null | undefined): number | undefined;
+/**
+ * `detail` of `vio:payment-success` as the checkout emits it. Four paths,
+ * three shapes: a redirect return (`orderId` = Vio's checkout id), the
+ * confirmation drawer and a provider's own receipt (`result` from the
+ * provider or the backend, plus Vio's `checkoutId`), and Apple Pay express
+ * from the cart (`result` with the backend's `confirmation`, no sponsor).
+ */
+interface PaymentSuccessDetail {
+    method?: string;
+    sponsorId?: number | string;
+    /** Redirect return: Vio's checkout id (the name predates `checkoutId`). */
+    orderId?: string | number;
+    /** Vio's checkout id — from the checkout state or the return URL. */
+    checkoutId?: string | number;
+    result?: PaymentSuccessResult | null;
+}
+/**
+ * What the checkout attaches as `result`. Only `confirmation` carries a Vio
+ * id: the order `ConfirmPaymentApplePay` created. `order.orderId` / `orderId`
+ * are the PROVIDER's references (Qliro's, Walley's — the checkout itself
+ * shows them as `providerRef`), and `chargedTotal` includes shipping on some
+ * methods only. Analytics reads none of those.
+ */
+interface PaymentSuccessResult {
+    confirmation?: {
+        orderId?: string | number | null;
+        status?: string;
+    } | null;
+    [key: string]: unknown;
+}
+/**
+ * The `order_id` of a `purchase`: ALWAYS a Vio id, never a provider's
+ * reference. Normalized across every emitter: `orderId` (redirect return) →
+ * `result.confirmation.orderId` (Apple Pay) → `checkoutId`. `value` and
+ * `currency` are deliberately NOT read from the result: on every path they
+ * come from the cart snapshot (sum of the items, no shipping), so revenue
+ * stays comparable across payment methods — the charged total will arrive
+ * through the server-side `order_paid` event. With nothing to say it
+ * returns `{}`, so the cart snapshot keeps its keys.
+ */
+declare function purchaseFromPaymentSuccess(d: PaymentSuccessDetail): Pick<AnalyticsCommerce, 'orderId'>;
 
 declare class VioFacade {
     private apiInstance;
@@ -1415,6 +1995,10 @@ declare class VioFacade {
     /** Last bootstrap failure — short backoff so cart mutations don't hammer a
      * dead endpoint on every call. */
     private bootstrapFailedAt;
+    /** Bumped by every init(). A bootstrap started under an older configuration
+     * (another key or environment) is still in flight after a re-init; its answer
+     * belongs to that configuration and must not land in this one. */
+    private generation;
     private cartManager;
     private checkoutManager;
     private analyticsManager;
@@ -1430,11 +2014,16 @@ declare class VioFacade {
      * listeners are installed) until an explicit `Vio.analytics.start()`.
      */
     get analytics(): AnalyticsManager;
-    /** Lazy VioApi for REST endpoints on `api-dev.vio.live`. */
+    /** Lazy VioApi for REST endpoints on `api-staging.vio.live`. */
     get api(): VioApi;
     /**
      * Bootstrap — fetches client config and caches it. Dedupes in-flight
      * concurrent requests.
+     *
+     * A request that was started before the last init() (Vev starts with the key
+     * the browser remembers, then the page's own key arrives) answers for a key
+     * that is gone: it neither fills the cache nor arms the failure backoff, and
+     * whoever awaited it gets the current configuration's bootstrap instead.
      */
     bootstrap(): Promise<BootstrapResponse>;
     get bootstrapCache(): BootstrapResponse | null;
@@ -1456,6 +2045,33 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.11.1";
+declare const SDK_VERSION = "0.21.0";
+
+/**
+ * Vipps MobilePay's own button, the way the design guidelines ask for it.
+ *
+ * Vipps publishes a web component (`<vipps-mobilepay-button>`) that draws
+ * the on-brand button and nothing else: it does not start the payment, we
+ * do, on its click. Using it means no logo of ours to keep in step with the
+ * brand rules (ePayment checklist, "Follow the design guidelines",
+ * 2026-10-06). The script is loaded once, on demand, from Vipps' CDN; when
+ * it does not arrive in time — blocked, offline — callers draw the plain
+ * orange button they always had.
+ */
+declare const VIPPS_BUTTON_SCRIPT = "https://cdn.vippsmobilepay.com/js/button/button.js";
+declare const VIPPS_BUTTON_TAG = "vipps-mobilepay-button";
+/**
+ * Resolves true once Vipps' button element is defined, false when its script
+ * failed to load (or, with `timeoutMs`, did not answer in time). Callers draw
+ * their own button meanwhile and swap it for Vipps' when this resolves — the
+ * CDN takes a few seconds on a slow line, and nobody should wait for it.
+ */
+declare function ensureVippsButton(timeoutMs?: number): Promise<boolean>;
+/** The attributes of the official button as Vio uses it (React hosts spread these). */
+declare function vippsButtonAttributes(verb?: 'buy' | 'pay' | 'express' | 'continue', opts?: {
+    stretched?: boolean;
+    compact?: boolean;
+    language?: string;
+}): Record<string, string>;
 
-export { ADD_ITEM_MUTATION, type AddManualOptions, type AddProductOptions, type AnalyticsCommerce, type AnalyticsContext, type AnalyticsEventName, type AnalyticsItemInput, AnalyticsManager, type AnalyticsStartOptions, type ApplePayConfig, type ApplePayResult, type BootstrapResponse, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, type CartChangeDetail, type CartLineItem, CartManager, type CartQueryOptions, type CheckoutAddress, type CheckoutChangeDetail, CheckoutManager, type CheckoutState, CommerceClient, Configuration, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, type GetVippsStatusVariables, type ImageSize, type PaymentCompleteDetail, type PaymentMethod, type PaymentSelectDetail, type PlacementComponent, type Product, type ProductCategory, type ProductImage, type ProductOption, type ProductPrice, type ProductVariant, type ResolvedConfig, SDK_VERSION, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, Vio, VioApi, VioApiError, type VioConfig, type VippsPaymentState, type VippsStatusResult, addItem, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier };
+export { ADD_ITEM_MUTATION, type AddManualOptions, type AddProductOptions, type AnalyticsCommerce, type AnalyticsContext, type AnalyticsEventName, type AnalyticsItemInput, AnalyticsManager, type AnalyticsStartOptions, type ApplePayConfig, type ApplePayResult, type BootstrapCampaign, type BootstrapCampaignEntry, type BootstrapCampaignStatus, type BootstrapResponse, type BootstrapSlot, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, type CartChangeDetail, type CartLineItem, CartManager, type CartQueryOptions, type CheckoutAddress, type CheckoutChangeDetail, CheckoutManager, type CheckoutState, CommerceClient, Configuration, type CreatePaymentVippsResponse, type CreatePaymentVippsVariables, DELETE_ITEM_MUTATION, type Environment, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, type GetVippsStatusVariables, type ImageSize, type PaymentCompleteDetail, type PaymentMethod, type PaymentSelectDetail, type PaymentSuccessDetail, type PaymentSuccessResult, type PlacementComponent, type Product, type ProductCategory, type ProductImage, type ProductOption, type ProductPrice, type ProductVariant, type ResolvedConfig, SDK_VERSION, type Sponsor, type SponsorCartState, type SponsorCommerceBlock, type TrackOptions, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, VIPPS_BUTTON_SCRIPT, VIPPS_BUTTON_TAG, Vio, VioApi, VioApiError, type VioConfig, type VippsPaymentState, type VippsStatusResult, addItem, checkApplePayAvailability, createCart, createCheckout, createCommerceClient, createPaymentStripe, createPaymentVipps, createVioApi, deleteItem, displayPrice, ensureVippsButton, executeCartGraphQL, formatPrice, getAvailablePaymentMethods, getCart, getCartGraphQLOptions, getCheckout, getCustomerSessionId, getGlobalCurrency, getLineItemsBySupplier, getVippsStatus, primaryImageUrl, purchaseFromPaymentSuccess, resolveCampaignId, showApplePaySheet, updateCheckout, updateItem, updateShippingsBySupplier, vippsButtonAttributes };