@vio-live/web-sdk 0.9.1 → 0.11.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>;
     /**
@@ -1202,7 +1250,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", "view_cart", "begin_checkout", "purchase", "component_impression", "component_click", "ad_impression", "ad_click", "poll_impression", "contest_impression", "session_start", "session_end"];
+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. */
 interface AnalyticsContext {
@@ -1224,6 +1272,8 @@ interface AnalyticsContext {
     contentId?: string | number;
     /** Human-readable content snapshot; auto-filled from document.title. */
     contentTitle?: string;
+    /** Código corto del fallo (`sdk_error` / `checkout_error`). */
+    errorCode?: string;
     variant?: string;
 }
 interface AnalyticsItemInput {
@@ -1249,6 +1299,13 @@ interface TrackOptions {
 interface AnalyticsStartOptions {
     /** Where the SDK is embedded: 'vev' | 'replit' | 'custom' | … Default 'custom'. */
     host?: string;
+    /**
+     * Arrancar en modo cookieless hasta que el host llame `setConsent(true)`.
+     * Default false: el SDK asume que el CMP del publisher ya decidió si nos
+     * carga. Los publishers EU que necesitan medir antes del consentimiento
+     * (o no pueden persistir sin él) ponen true.
+     */
+    requireConsent?: boolean;
     /**
      * Install the automatic funnel listeners (vio:added-to-cart,
      * vio:checkout-open, vio:open-cart, vio:payment-success). Default true.
@@ -1282,6 +1339,9 @@ declare class AnalyticsManager extends EventTarget {
     private retryNotBefore;
     private externalUserId;
     private sessionId;
+    private requireConsent;
+    private consentGranted;
+    private anonIdCache;
     /** Set via start({ sessionId }) — the host owns the session, we follow. */
     private externalSessionId;
     private sessionStartedAt;
@@ -1295,6 +1355,16 @@ declare class AnalyticsManager extends EventTarget {
      * Install listeners + begin flushing. Explicit on purpose (no module
      * side-effects). Safe to call twice (second call only updates options).
      */
+    /**
+     * Consentimiento (ePrivacy/GDPR). Por defecto el SDK asume que el host ya
+     * lo gestionó — su CMP decide si nos carga. Con `requireConsent: true`
+     * arranca en modo **cookieless**: mide la visita con ids efímeros en
+     * memoria y NO escribe nada en localStorage hasta que el host llame
+     * `setConsent(true)`. Retirarlo borra lo persistido.
+     */
+    setConsent(granted: boolean): void;
+    /** ¿Podemos escribir en el dispositivo? */
+    private get canPersist();
     start(options?: AnalyticsStartOptions): void;
     /** Stop timers + listeners (tests / SPA unmount). Queue survives. */
     stop(): void;
@@ -1320,6 +1390,8 @@ declare class AnalyticsManager extends EventTarget {
     /** Force a flush (mostly for tests). */
     flush(): Promise<void>;
     private buildEvent;
+    /** Guarda la sesión solo si podemos escribir en el dispositivo. */
+    private persistSession;
     private anonId;
     /** Rolling session: renewed by activity, rotated after 30 min idle. */
     private ensureSession;
@@ -1384,6 +1456,6 @@ declare const Vio: VioFacade;
  *
  * RELEASE CHECKLIST: bump together with package.json (see CONTRIBUTING).
  */
-declare const SDK_VERSION = "0.9.1";
+declare const SDK_VERSION = "0.11.0";
 
 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-WKJRYYNI.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-U2QG4IVJ.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-WKJRYYNI.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-U2QG4IVJ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.js

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

package/dist/ui/index.js

@@ -1,6 +1,6 @@
-import { registerVioElements } from '../chunk-PRMVVF5C.js';
-export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-PRMVVF5C.js';
-import '../chunk-WKJRYYNI.js';
+import { registerVioElements } from '../chunk-XU5LGUBU.js';
+export { VioCart, VioCheckout, VioProduct, VioProductCarousel, VioProductDetail, VioTokens, applyVioTheme, registerVioElements } from '../chunk-XU5LGUBU.js';
+import '../chunk-U2QG4IVJ.js';
 
 // src/ui/index.ts
 registerVioElements();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vio-live/web-sdk",
-  "version": "0.9.1",
-  "description": "Vio Web SDK \u2014 in-site shoppable + native checkout, designed for editorial commerce sites",
+  "version": "0.11.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",