@vio-live/web-sdk 0.2.0 → 0.3.0

package/dist/{vio-checkout-CrC5tvmh.d.ts → vio-checkout-T9R5hpDx.d.ts}

@@ -20,6 +20,14 @@ declare class VioProduct extends LitElement {
     /** Whether the product has selectable variants — the quick-add button then
      * opens the detail to pick one instead of adding directly. */
     hasVariants: boolean;
+    /** Optional raw variants/options from the host — extra signal that a
+     * variant must be picked before adding (selection is mandatory). */
+    variants: unknown[] | undefined;
+    options: unknown[] | undefined;
+    /** Image-only mode: hide the meta block (brand / name / price / retailer)
+     * and show just the image + the quick-add button. Click still opens the
+     * detail. */
+    hideMeta: boolean;
     /** True when this product currently sits in the cart (persistent mark). */
     private inCart;
     /** Total units of this product in the cart (shown as a count when > 1). */
@@ -111,6 +119,14 @@ declare class VioProductDetail extends LitElement {
     private adding;
     /** Apple Pay actually usable (real Stripe + registered domain) — set on load. */
     private applePayOk;
+    /** Payment method names enabled for the sponsor (backend-configured).
+     * null = not loaded yet → all buy buttons render; [] = none enabled. */
+    private availableMethods;
+    /** Race guard: only the latest fetch may write state (two quick taps on
+     * different cards would otherwise let the slow response win). */
+    private fetchSeq;
+    /** Memoised option maps per variant object (recomputed per product). */
+    private optMapCache;
     /** Pre-prepared Apple Pay handle — show() fires synchronously on tap. */
     private applePayHandle;
     private boundProductClick;
@@ -120,12 +136,44 @@ declare class VioProductDetail extends LitElement {
     show(): void;
     close(): void;
     private fetchProduct;
-    /** Resolve the active variant from the selected option values. */
+    /** Which buy buttons to render — backend-configured per sponsor. */
+    private loadAvailablePaymentMethods;
+    /** Backend names arrive as e.g. "Apple Pay" — compare letters only. */
+    private methodEnabled;
+    /**
+     * Build an option-name → value map for a variant, from every shape the feeds
+     * ship: option1/2/3 columns, options/selected_options/variant arrays, plain
+     * object maps, and finally the title (value scan first, position fallback).
+     */
+    private getVariantOptionMap;
+    /** Option values a variant represents (map values ∪ title parts). */
+    private variantOptionValues;
+    /** Does a variant part represent this option value? Exact match, plus a
+     * whole-token match ONLY for numeric values ("30" matches "30 ml") — word
+     * subsets of text values are not matches ("Large" must NOT match
+     * "Extra Large"). */
+    private partMatchesValue;
+    /** Does a variant satisfy every currently-selected option value? */
+    private variantMatchesSelection;
+    /** Sellable quantity for a variant, across the stock field zoo. Boolean
+     * availability flags win; a numeric field wins next; `null` = the feed does
+     * not report stock for this variant (callers fall back to product stock —
+     * never assume "in stock" from absent data). */
+    private getVariantQty;
+    /** Variant stock with the product-level fallback applied (0 = not sellable). */
+    private variantSellableQty;
+    /** Resolve the active variant: full in-stock match → full match → best score
+     * (2 per mapped option match, 1 per title match, +0.5 if in stock). */
     private selectedVariant;
+    /** True if some in-stock variant carries this option value. */
+    private isValueAvailable;
     private get unitPrice();
     private get compareAt();
     private get availableQuantity();
     private stockLabel;
+    /** Pick an option value. If the exact combination doesn't exist, jump to an
+     * in-stock variant that carries the value and adopt its full option map
+     * (keeps the selection always resolvable to a real variant). */
     private selectOption;
     private allImages;
     private get activeImage();
@@ -139,6 +187,10 @@ declare class VioProductDetail extends LitElement {
      * loads immediately. Reuses the working Klarna Payments flow (no express SDK).
      */
     private buyWithKlarna;
+    /** Buy with Vipps — opens the checkout with Vipps preselected. */
+    private buyWithVipps;
+    /** Buy with Stripe — opens the checkout with Stripe preselected. */
+    private buyWithStripe;
     /**
      * Express buy with Apple Pay. Runs synchronously inside the click so the
      * Apple Pay sheet keeps the user gesture: add to cart → open checkout (sets
@@ -168,6 +220,9 @@ declare class VioCart extends LitElement {
     private itemCount;
     /** True when Apple Pay is usable (Safari + device + Stripe configured). */
     private applePayAvailable;
+    /** Payment method names enabled for the sponsor (backend-configured).
+     * null = not loaded yet → all buttons render; [] = none enabled. */
+    private availableMethods;
     /** Set after an Apple Pay express purchase — switches the drawer to the
      * confirmation screen (so the rest of the cart/checkout is not shown). */
     private confirmedOrder;
@@ -175,12 +230,19 @@ declare class VioCart extends LitElement {
     private applePayHandle;
     /** Cart total Apple Pay was last prepared for (avoids redundant prep). */
     private preparedTotal;
+    /** In-flight guard for loadAvailablePaymentMethods. */
+    private loadingPaymentMethods;
     private boundOnCartChange;
     static styles: lit.CSSResult;
     connectedCallback(): void;
     disconnectedCallback(): void;
     close(): void;
     show(): void;
+    /** Which payment buttons to render — backend-configured per sponsor.
+     * Falls back to showing everything if the query fails or none is set. */
+    private loadAvailablePaymentMethods;
+    /** Backend names arrive as e.g. "Apple Pay" — compare letters only. */
+    private methodEnabled;
     updated(changed: Map<string, unknown>): void;
     /** Pre-resolve the Apple Pay sheet for the current cart total. */
     private refreshApplePay;
@@ -193,6 +255,10 @@ declare class VioCart extends LitElement {
      * (betalingsmetode). The host's checkout-open handler closes this cart and
      * opens <vio-checkout> in express mode with Klarna preselected. */
     private onKlarnaExpress;
+    /** Vipps — opens the checkout with Vipps preselected. */
+    private onVipps;
+    /** Stripe — opens the checkout with Stripe preselected. */
+    private onStripe;
     private get totalAcrossSponsors();
     private get primaryCurrency();
     private onIncrement;
@@ -221,6 +287,8 @@ declare class VioCheckout extends LitElement {
     private orderConfirmed;
     private confirmedMethod;
     private paymentError;
+    /** Neutral (non-error) status line: "verifying payment…" / "still processing". */
+    private paymentNotice;
     /** Snapshot of the placed order, for the confirmation screen. */
     private confirmedOrder;
     /** Active Klarna Payments widget handle + the subtotal it was mounted for. */
@@ -234,24 +302,84 @@ declare class VioCheckout extends LitElement {
     private klarnaAuthorizing;
     /** Chosen shipping option id (express flow) — drives the Klarna order total. */
     private selectedShipping;
+    /** Real per-supplier shippings from the backend (empty → static fallback). */
+    private availableShippingsList;
+    /** Payment method names enabled for the sponsor (backend-configured).
+     * null = not loaded yet → all buttons render; [] = none enabled. */
+    private availableMethods;
+    /** Redirecting to the Stripe / Vipps hosted page. */
+    private stripeLoading;
+    private vippsLoading;
     private form;
+    /** In-flight guard for loadAvailablePaymentMethods. */
+    private loadingPaymentMethods;
+    /** In-flight + attempted guards for loadAvailableShippings (change events
+     * fire per keystroke — without these, typing an address hammers the API). */
+    private loadingShippings;
+    private shippingsAttempted;
     private boundOnCheckoutChange;
     private boundOnPaymentComplete;
     private boundOnPaymentError;
     static styles: lit.CSSResult;
     connectedCallback(): void;
+    /**
+     * Detect the redirect return from a hosted payment page (Stripe / Vipps /
+     * Klarna): the return URL carries vio_payment/vio_method/vio_sponsor. On
+     * success: clear that sponsor's cart, show the confirmation drawer, emit
+     * vio:payment-success (analytics/host hooks) and scrub the URL params.
+     */
+    /** Backend checkout statuses that mean the payment went through. */
+    private static readonly PAID_STATUSES;
+    /** Statuses that mean the payment definitively did NOT go through. */
+    private static readonly FAILED_STATUSES;
+    /** Waits between GetCheckout attempts — PSP webhooks (Vipps especially) can
+     * land seconds after the shopper is redirected back, so a single immediate
+     * check misreads a successful charge as unpaid. ~20s total. */
+    private static readonly RETURN_VERIFY_DELAYS_MS;
+    /** Vipps polling cadence — up to 2 minutes. Its webhook can lag well behind
+     * the redirect; this window was verified against a live checkout. */
+    private static readonly VIPPS_STATUS_MAX_ATTEMPTS;
+    private static readonly VIPPS_STATUS_DELAY_MS;
+    /**
+     * Vipps redirects to our return URL the same way on cancel as on success —
+     * the URL alone can't tell them apart, and the generic checkout status can
+     * lag behind Vipps' own webhook. Poll Vipps' own state directly instead:
+     * AUTHORIZED confirms, CREATED means still processing (keep polling),
+     * anything else (including an unrecognized state) is treated as failed —
+     * fail-closed by default rather than guessing.
+     */
+    private pollVippsStatus;
+    /** Shared outcome handler for both the generic (GetCheckout) and the
+     * Vipps-specific (GetVippsStatus) return-verification paths. */
+    private applyReturnOutcome;
+    private checkReturnPaymentStatus;
+    /** Remove our payment-return params from the URL without a reload. */
+    private cleanReturnQueryParams;
     disconnectedCallback(): void;
-    updated(): void;
+    updated(changed: Map<string, unknown>): void;
     close(): void;
     show(): void;
+    /** Fetch the real per-supplier shippings and preselect + persist the first. */
+    private loadAvailableShippings;
+    /** Whether all mandatory Leveringsadresse fields are filled. */
+    private get isAddressValid();
+    /** Whether a valid shipping option is selected (when shippings exist). */
+    private get hasSelectedShipping();
+    /** Which payment buttons to render — backend-configured per sponsor. */
+    private loadAvailablePaymentMethods;
+    /** Backend names arrive as e.g. "Apple Pay" — compare letters only. */
+    private methodEnabled;
     private refreshApplePay;
     private refreshKlarna;
     /** Mount (or re-mount on amount change) the Klarna Payments widget. */
     private mountKlarnaIfNeeded;
     private unmountKlarna;
+    /** Shippings in effect: backend per-supplier when loaded, static otherwise. */
+    private get shippingList();
     /** Selected shipping option (express flow). */
     private get shippingOption();
-    /** Pick a shipping option → re-mounts the Klarna widget with the new total. */
+    /** Pick a shipping option → re-mounts the Klarna widget with the new total.
+     * Also persists the choice on the backend cart (per supplier). */
     private onSelectShipping;
     /** Switch the Klarna widget to a different payment_method_category. */
     private onKlarnaCategory;
@@ -261,11 +389,9 @@ declare class VioCheckout extends LitElement {
     private onApplePay;
     private onPay;
     /**
-     * Complete the order for the selected method (Vipps / Card / plain Klarna).
-     * Apple Pay and Klarna Express finish inside their own sheet/popup, so they
-     * never reach here. No real PSP is wired for Vipps/Card in this iteration —
-     * the capture happens backend-side in the full flow — so this confirms the
-     * order state-only and shows the confirmation screen.
+     * Complete the order for the selected method. Apple Pay and Klarna Express
+     * finish inside their own sheet/popup; Stripe and Vipps redirect to their
+     * hosted pages (via onPay). Anything else confirms state-only.
      */
     private onCompleteOrder;
     /**
@@ -279,7 +405,9 @@ declare class VioCheckout extends LitElement {
     /** True for methods that complete via a separate sheet/widget, not the CTA. */
     private isExpressMethod;
     private orderTotal;
-    /** Shipping cost (major units) applied in express mode, else 0. */
+    /** Shipping cost (major units) whenever a shipping option is in effect —
+     * express always has one; the normal flow has one once the backend
+     * shippings loaded (the choice IS persisted on the cart and charged). */
     private shippingMajor;
     /** Total to charge — items + shipping (express). */
     private payTotalLabel;

package/package.json

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