@vio-live/web-sdk 0.9.0 → 0.10.0

package/dist/core/index.d.ts

@@ -802,6 +802,37 @@ interface QliroOrder {
     total_price?: number;
 }
 
+/**
+ * Qliro's browser-side protocol (`q1`).
+ *
+ * The embedded widget publishes a `q1` object on the window and calls a
+ * globally-defined `q1Ready` once it has rendered. Everything the customer
+ * does inside the iframe — picking a shipping method, changing their address,
+ * having a payment declined — is only observable through these listeners.
+ * Without them the widget is a black box: the customer can change the
+ * shipping and our own summary keeps showing the old total.
+ *
+ * Two rules from Qliro's documentation shape this module:
+ *
+ * 1. **Lock before touching the backend.** Otherwise the customer can
+ *    complete the purchase while the order is still being synchronized.
+ * 2. **Compare before unlocking.** Otherwise a second change interrupts the
+ *    synchronization of the first.
+ *
+ * We compare on `MerchantUpdateVersion`, the token Qliro echoes back through
+ * `onOrderUpdated`, rather than on totals. Totals cannot be the test here: in
+ * the modes where Qliro owns the shipping amount our total and Qliro's
+ * legitimately differ, and the customer would sit locked out of a checkout
+ * that is in fact up to date.
+ */
+
+interface QliroSyncResult {
+    order_id: string;
+    /** Token to wait for in `onOrderUpdated` before unlocking. */
+    update_version: string;
+    total_price: number;
+}
+
 /**
  * Walley (former Collector) — embedded checkout via Vio Commerce.
  *
@@ -951,6 +982,8 @@ declare class CheckoutManager extends EventTarget {
     private applePayPublishableKey;
     private applePayConnectedAccount;
     private klarnaAvailableCache;
+    /** Live q1 listeners while a Qliro widget is mounted. */
+    private qliroController;
     private klarnaOrderInFlight;
     /** Last backend shippings fetched (per-supplier), for UI reuse. */
     private lastFetchedShippings;
@@ -1025,6 +1058,21 @@ declare class CheckoutManager extends EventTarget {
      * html_snippet into `container` (widget-does-everything, like Kustom).
      */
     mountQliroCheckout(container: HTMLElement, sponsorId?: number): Promise<QliroOrder>;
+    /**
+     * Everything the customer does inside the Qliro iframe, re-published as a
+     * DOM event so a host page can follow a checkout it cannot see into.
+     */
+    private onQliroEvent;
+    /**
+     * Push the current cart onto the open Qliro order.
+     *
+     * Call it after changing the cart while the widget is open: it holds
+     * `q1.lock()` across the round trip and unlocks once Qliro confirms it is
+     * showing the new version. A no-op when no Qliro widget is mounted.
+     */
+    syncQliroOrder(): Promise<QliroSyncResult | null>;
+    /** Drop the Qliro listeners and release any lock still held. */
+    destroyQliroListeners(): void;
     /** Re-read the Qliro order owned by a checkout — the confirmation trip. */
     getQliroOrder(checkoutId: string, sponsorId?: number): Promise<QliroOrder | null>;
     /**
@@ -1384,6 +1432,6 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.9.0";
+declare const SDK_VERSION = "0.9.1";
 
 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 };

package/dist/core/index.js

@@ -1,4 +1,4 @@
 import '../chunk-QYQQ5J6E.js';
-export { ADD_ITEM_MUTATION, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, Vio, VioApi, VioApiError, 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 } from '../chunk-SNIF67UB.js';
+export { ADD_ITEM_MUTATION, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, Vio, VioApi, VioApiError, 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 } from '../chunk-PX27CQGX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js

@@ -1,4 +1,4 @@
 import './chunk-QYQQ5J6E.js';
-export { ADD_ITEM_MUTATION, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, Vio, VioApi, VioApiError, 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 } from './chunk-SNIF67UB.js';
+export { ADD_ITEM_MUTATION, AnalyticsManager, CREATE_CART_MUTATION, CREATE_CHECKOUT_MUTATION, CREATE_PAYMENT_STRIPE_MUTATION, CREATE_PAYMENT_VIPPS_MUTATION, CartManager, CheckoutManager, CommerceClient, Configuration, DELETE_ITEM_MUTATION, GET_AVAILABLE_PAYMENT_METHODS_QUERY, GET_CART_QUERY, GET_CHECKOUT_QUERY, GET_LINE_ITEMS_BY_SUPPLIER_QUERY, GET_VIPPS_STATUS_QUERY, SDK_VERSION, UPDATE_CHECKOUT_MUTATION, UPDATE_ITEM_MUTATION, UPDATE_SHIPPINGS_BY_SUPPLIER_MUTATION, Vio, VioApi, VioApiError, 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 } from './chunk-PX27CQGX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as _lit_react from '@lit/react';
-import { V as VioCart$1, a as VioCheckout$1, b as VioProduct$1, c as VioProductCarousel$1, d as VioProductDetail$1 } from '../tokens-CrO2ciCS.js';
-export { e as VioThemeOverrides, f as VioTokens, g as applyVioTheme } from '../tokens-CrO2ciCS.js';
+import { V as VioCart$1, a as VioCheckout$1, b as VioProduct$1, c as VioProductCarousel$1, d as VioProductDetail$1 } from '../tokens-D6PBisUm.js';
+export { e as VioThemeOverrides, f as VioTokens, g as applyVioTheme } from '../tokens-D6PBisUm.js';
 import 'lit-html';
 import 'lit';
 

package/dist/react/index.js

@@ -1,6 +1,6 @@
-import { registerVioElements, VioProduct, VioProductCarousel, VioProductDetail, VioCart, VioCheckout } from '../chunk-OTL6QM3G.js';
-export { VioTokens, applyVioTheme } from '../chunk-OTL6QM3G.js';
-import '../chunk-SNIF67UB.js';
+import { registerVioElements, VioProduct, VioProductCarousel, VioProductDetail, VioCart, VioCheckout } from '../chunk-WIQ53CCM.js';
+export { VioTokens, applyVioTheme } from '../chunk-WIQ53CCM.js';
+import '../chunk-PX27CQGX.js';
 import * as React from 'react';
 
 // node_modules/@lit/react/node/create-component.js

package/dist/{tokens-CrO2ciCS.d.ts → tokens-D6PBisUm.d.ts}

@@ -433,6 +433,19 @@ declare class VioCheckout extends LitElement {
     private unmountKustom;
     private renderKustomPanel;
     /** Mount the Qliro embedded checkout once it's the chosen method. */
+    /**
+     * Container for a third-party embed, living in the LIGHT DOM.
+     *
+     * Qliro's (and Walley's) bootstrap script resolves its mount point from the
+     * document, so a container inside this component's shadow root is invisible
+     * to it and the widget silently never renders — verified against Qliro's
+     * staging widget: identical snippet, light DOM renders the iframe, shadow
+     * DOM renders nothing at all. The element is a child of the host (light DOM)
+     * and is projected back into the panel through a named slot, so the layout
+     * is unchanged. Kustom's KCO snippet resolves its own script's parent, so it
+     * works either way and keeps using the shadow-root container.
+     */
+    private lightContainer;
     private mountQliroIfNeeded;
     private unmountQliro;
     private renderQliroPanel;

package/dist/ui/index.d.ts

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

package/dist/ui/index.js

@@ -1,6 +1,6 @@
-import { registerVioElements } from '../chunk-OTL6QM3G.js';
-export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-OTL6QM3G.js';
-import '../chunk-SNIF67UB.js';
+import { registerVioElements } from '../chunk-WIQ53CCM.js';
+export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-WIQ53CCM.js';
+import '../chunk-PX27CQGX.js';
 
 // src/ui/index.ts
 registerVioElements();

package/package.json

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