@tagadapay/headless-sdk 1.8.0-rc.0 → 1.9.0

package/dist/stripe/StripeExpressButton.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { UseStripeExpressOptions } from './useStripeExpress.js';
+export type StripeExpressButtonProps = UseStripeExpressOptions & {
+    /** CSS class for the wrapper div. */
+    className?: string;
+    /** Inline style for the wrapper div. */
+    style?: React.CSSProperties;
+};
+/**
+ * Drop-in React component that renders Stripe Express Checkout buttons
+ * (Apple Pay, Google Pay, Link, etc.).
+ *
+ * Internally uses `useStripeExpress` which handles the full flow:
+ * discover config -> load Stripe -> mount ECE -> confirm -> poll -> callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { StripeExpressButton } from '@tagadapay/headless-sdk/stripe';
+ *
+ * <StripeExpressButton
+ *   checkoutSessionId={session.id}
+ *   amount={totals.total}
+ *   currency={totals.currency}
+ *   onSuccess={() => router.push('/confirmation')}
+ *   onError={(msg) => toast.error(msg)}
+ * />
+ * ```
+ */
+export declare function StripeExpressButton({ className, style, ...hookOpts }: StripeExpressButtonProps): import("react/jsx-runtime.js").JSX.Element;
+//# sourceMappingURL=StripeExpressButton.d.ts.map

package/dist/stripe/StripeExpressButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeExpressButton.d.ts","sourceRoot":"","sources":["../../src/stripe/StripeExpressButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAC/D,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,KAAK,EACL,GAAG,QAAQ,EACZ,EAAE,wBAAwB,8CAe1B"}

package/dist/stripe/StripeExpressButton.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useStripeExpress } from './useStripeExpress.js';
+/**
+ * Drop-in React component that renders Stripe Express Checkout buttons
+ * (Apple Pay, Google Pay, Link, etc.).
+ *
+ * Internally uses `useStripeExpress` which handles the full flow:
+ * discover config -> load Stripe -> mount ECE -> confirm -> poll -> callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { StripeExpressButton } from '@tagadapay/headless-sdk/stripe';
+ *
+ * <StripeExpressButton
+ *   checkoutSessionId={session.id}
+ *   amount={totals.total}
+ *   currency={totals.currency}
+ *   onSuccess={() => router.push('/confirmation')}
+ *   onError={(msg) => toast.error(msg)}
+ * />
+ * ```
+ */
+export function StripeExpressButton({ className, style, ...hookOpts }) {
+    const { containerRef, isReady } = useStripeExpress(hookOpts);
+    return (_jsx("div", { ref: containerRef, className: className, style: {
+            visibility: isReady ? 'visible' : 'hidden',
+            minHeight: isReady ? undefined : 0,
+            overflow: isReady ? undefined : 'hidden',
+            ...style,
+        } }));
+}
+//# sourceMappingURL=StripeExpressButton.js.map

package/dist/stripe/StripeExpressButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeExpressButton.js","sourceRoot":"","sources":["../../src/stripe/StripeExpressButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAUzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,SAAS,EACT,KAAK,EACL,GAAG,QAAQ,EACc;IACzB,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7D,OAAO,CACL,cACE,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;YACL,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC1C,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAClC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YACxC,GAAG,KAAK;SACT,GACD,CACH,CAAC;AACJ,CAAC"}

package/dist/stripe/StripeExpressCheckout.d.ts

@@ -0,0 +1,109 @@
+import type { HeadlessClient } from '../core/client.js';
+import type { StripeExpressOptions, PaymentStatus } from '../core/types.js';
+type EventMap = {
+    ready: {
+        availablePaymentMethods: Record<string, boolean> | undefined;
+    };
+    success: {
+        payment: PaymentStatus;
+        order?: {
+            id: string;
+            checkoutSessionId?: string;
+        };
+    };
+    error: string;
+    cancel: void;
+};
+type EventHandler<K extends keyof EventMap> = (data: EventMap[K]) => void;
+/**
+ * Session-based Stripe Express Checkout integration.
+ *
+ * Mounts the Stripe `ExpressCheckoutElement` (Apple Pay, Google Pay, Link,
+ * Klarna express) into any DOM container, wired to a Tagada
+ * checkout session. Drives the full flow:
+ * mount &rarr; wallet confirm &rarr; backend `payDirect` (`processStripeExpress`)
+ * &rarr; `stripe.confirmPayment` &rarr; poll payment status &rarr; emit `success`.
+ *
+ * **Session-free / partner S2S flow?** Use the lower-level primitive
+ * `startStripeExpressCheckout` exported from `@tagadapay/core-js`
+ * (also re-exported from `@tagadapay/headless-sdk/stripe`). It uses
+ * Stripe's older Payment Request API, stops at tokenization, and
+ * returns a `paymentMethodId` for partner-server-side processing.
+ *
+ * @example
+ * ```ts
+ * import { createHeadlessClient } from '@tagadapay/headless-sdk';
+ * import { StripeExpressCheckout } from '@tagadapay/headless-sdk/stripe';
+ *
+ * const client = createHeadlessClient({ storeId: 'store_xxx' });
+ * const session = await client.checkout.loadSession(checkoutToken);
+ * const express = await client.payment.getExpressMethods(session.id);
+ *
+ * const ece = new StripeExpressCheckout({
+ *   client,
+ *   publishableKey: express.applePay?.publishableKey!,
+ *   processorId: express.applePay?.processorId!,
+ * });
+ *
+ * ece.on('success', ({ payment }) => console.log('Paid!', payment.id));
+ * ece.on('error', (msg) => console.error(msg));
+ *
+ * await ece.mount(document.getElementById('express-container')!, {
+ *   checkoutSessionId: session.id,
+ *   amount: session.totals.total,
+ *   currency: session.totals.currency,
+ * });
+ * ```
+ */
+export declare class StripeExpressCheckout {
+    private stripe;
+    private elements;
+    private expressElement;
+    private container;
+    private isProcessing;
+    private listeners;
+    private readonly client;
+    private readonly publishableKey;
+    private readonly processorId;
+    private readonly enabledMethods;
+    private readonly buttonHeight;
+    private readonly buttonType;
+    private readonly emailRequired;
+    private readonly billingAddressRequired;
+    private readonly shippingAddressRequired;
+    constructor(opts: {
+        client: HeadlessClient;
+    } & StripeExpressOptions);
+    on<K extends keyof EventMap>(event: K, handler: EventHandler<K>): void;
+    off<K extends keyof EventMap>(event: K, handler: EventHandler<K>): void;
+    /**
+     * Load Stripe.js, create Elements, and mount the ExpressCheckoutElement.
+     */
+    mount(container: HTMLElement, opts: {
+        checkoutSessionId: string;
+        amount: number;
+        currency: string;
+    }): Promise<void>;
+    /**
+     * Update the payment amount (e.g. after a cart change).
+     */
+    updateAmount(amount: number, currency?: string): void;
+    /**
+     * Write the wallet-approved contact onto the session before the charge.
+     *
+     * `billingAddressRequired` defaults to true, so Stripe collects an address on
+     * every express purchase; `shippingAddressRequired` adds a delivery address
+     * for carts that ship. Whichever arrives is mapped and stored — a contact
+     * with no street line or no country maps to `undefined` and leaves the
+     * session untouched, so this can never blank an address already entered.
+     */
+    private syncWalletContact;
+    /**
+     * Clean up: unmount the element and release references.
+     */
+    unmount(): void;
+    private emit;
+    private extractClientSecret;
+}
+export {};
+//# sourceMappingURL=StripeExpressCheckout.d.ts.map

package/dist/stripe/StripeExpressCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeExpressCheckout.d.ts","sourceRoot":"","sources":["../../src/stripe/StripeExpressCheckout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAa,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAcvF,KAAK,QAAQ,GAAG;IACd,KAAK,EAAE;QAAE,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IACxE,OAAO,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;CACd,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAwD;IAEzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;gBAEtC,IAAI,EAAE;QAAE,MAAM,EAAE,cAAc,CAAA;KAAE,GAAG,oBAAoB;IAcnE,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAOtE,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvE;;OAEG;IACG,KAAK,CACT,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,IAAI,CAAC;IA6HhB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAOrD;;;;;;;;OAQG;YACW,iBAAiB;IAsB/B;;OAEG;IACH,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,mBAAmB;CAS5B"}

package/dist/stripe/StripeExpressCheckout.js

@@ -0,0 +1,242 @@
+import { stripeContactToAddress } from '../core/helpers/walletContact.js';
+const EXPRESS_METHOD_KEYS = ['apple_pay', 'google_pay', 'link', 'klarna_express'];
+/**
+ * Session-based Stripe Express Checkout integration.
+ *
+ * Mounts the Stripe `ExpressCheckoutElement` (Apple Pay, Google Pay, Link,
+ * Klarna express) into any DOM container, wired to a Tagada
+ * checkout session. Drives the full flow:
+ * mount → wallet confirm → backend `payDirect` (`processStripeExpress`)
+ * → `stripe.confirmPayment` → poll payment status → emit `success`.
+ *
+ * **Session-free / partner S2S flow?** Use the lower-level primitive
+ * `startStripeExpressCheckout` exported from `@tagadapay/core-js`
+ * (also re-exported from `@tagadapay/headless-sdk/stripe`). It uses
+ * Stripe's older Payment Request API, stops at tokenization, and
+ * returns a `paymentMethodId` for partner-server-side processing.
+ *
+ * @example
+ * ```ts
+ * import { createHeadlessClient } from '@tagadapay/headless-sdk';
+ * import { StripeExpressCheckout } from '@tagadapay/headless-sdk/stripe';
+ *
+ * const client = createHeadlessClient({ storeId: 'store_xxx' });
+ * const session = await client.checkout.loadSession(checkoutToken);
+ * const express = await client.payment.getExpressMethods(session.id);
+ *
+ * const ece = new StripeExpressCheckout({
+ *   client,
+ *   publishableKey: express.applePay?.publishableKey!,
+ *   processorId: express.applePay?.processorId!,
+ * });
+ *
+ * ece.on('success', ({ payment }) => console.log('Paid!', payment.id));
+ * ece.on('error', (msg) => console.error(msg));
+ *
+ * await ece.mount(document.getElementById('express-container')!, {
+ *   checkoutSessionId: session.id,
+ *   amount: session.totals.total,
+ *   currency: session.totals.currency,
+ * });
+ * ```
+ */
+export class StripeExpressCheckout {
+    constructor(opts) {
+        this.stripe = null;
+        this.elements = null;
+        this.expressElement = null;
+        this.container = null;
+        this.isProcessing = false;
+        this.listeners = {};
+        this.client = opts.client;
+        this.publishableKey = opts.publishableKey;
+        this.processorId = opts.processorId;
+        this.enabledMethods = opts.enabledMethods ?? [...EXPRESS_METHOD_KEYS];
+        this.buttonHeight = opts.buttonHeight ?? 48;
+        this.buttonType = opts.buttonType ?? 'buy';
+        this.emailRequired = opts.emailRequired ?? true;
+        this.billingAddressRequired = opts.billingAddressRequired ?? true;
+        // Opt-in: asking for a delivery address in the sheet changes what the buyer
+        // sees, so it stays off until a storefront selling physical goods says yes.
+        this.shippingAddressRequired = opts.shippingAddressRequired ?? false;
+    }
+    on(event, handler) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = new Set();
+        }
+        this.listeners[event].add(handler);
+    }
+    off(event, handler) {
+        this.listeners[event]?.delete(handler);
+    }
+    /**
+     * Load Stripe.js, create Elements, and mount the ExpressCheckoutElement.
+     */
+    async mount(container, opts) {
+        this.container = container;
+        const { loadStripe } = await import('@stripe/stripe-js');
+        const stripe = await loadStripe(this.publishableKey);
+        if (!stripe) {
+            this.emit('error', 'Failed to load Stripe.js');
+            return;
+        }
+        this.stripe = stripe;
+        const amount = Math.max(Math.round(opts.amount), 1);
+        const currency = opts.currency.toLowerCase();
+        this.elements = stripe.elements({
+            mode: 'payment',
+            amount,
+            currency,
+        });
+        const methodEnabled = (key) => this.enabledMethods.includes(key);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Stripe TS types don't expose expressCheckout overload
+        this.expressElement = this.elements.create('expressCheckout', {
+            buttonType: {
+                applePay: this.buttonType,
+                googlePay: this.buttonType,
+            },
+            buttonHeight: this.buttonHeight,
+            paymentMethods: {
+                applePay: methodEnabled('apple_pay') ? 'always' : 'never',
+                googlePay: methodEnabled('google_pay') ? 'always' : 'never',
+                link: methodEnabled('link') ? 'auto' : 'never',
+                klarna: methodEnabled('klarna_express') ? 'auto' : 'never',
+            },
+            emailRequired: this.emailRequired,
+            billingAddressRequired: this.billingAddressRequired,
+            shippingAddressRequired: this.shippingAddressRequired,
+        });
+        this.expressElement.on('ready', ({ availablePaymentMethods }) => {
+            if (availablePaymentMethods) {
+                this.emit('ready', { availablePaymentMethods });
+            }
+        });
+        this.expressElement.on('cancel', () => {
+            this.isProcessing = false;
+            this.emit('cancel', undefined);
+        });
+        this.expressElement.on('confirm', async (event) => {
+            if (this.isProcessing)
+                return;
+            this.isProcessing = true;
+            try {
+                const { error: submitError } = await this.elements.submit();
+                if (submitError) {
+                    this.emit('error', submitError.message ?? 'Validation failed');
+                    this.isProcessing = false;
+                    return;
+                }
+                // The buyer approved an address inside the wallet sheet and this
+                // element owns that sheet, so the address is ours to persist — no
+                // integrator code required (#TAG-1989). Before this, `billingDetails`
+                // arrived on every confirm and was dropped, and the order was created
+                // with NULL addresses.
+                try {
+                    await this.syncWalletContact(opts.checkoutSessionId, event);
+                }
+                catch {
+                    this.emit('error', 'Could not save your address. Please try again.');
+                    this.isProcessing = false;
+                    return;
+                }
+                const payResult = await this.client.payment.processStripeExpress({
+                    checkoutSessionId: opts.checkoutSessionId,
+                    processorId: this.processorId,
+                    paymentMethod: event.expressPaymentType,
+                });
+                const clientSecret = this.extractClientSecret(payResult);
+                if (!clientSecret) {
+                    this.emit('error', 'Express checkout configuration missing — no client secret returned');
+                    this.isProcessing = false;
+                    return;
+                }
+                const { error: confirmError } = await this.stripe.confirmPayment({
+                    elements: this.elements,
+                    clientSecret,
+                    confirmParams: { return_url: window.location.href },
+                    redirect: 'if_required',
+                });
+                if (confirmError) {
+                    this.emit('error', confirmError.message ?? 'Payment confirmation failed');
+                    this.isProcessing = false;
+                    return;
+                }
+                const paymentId = payResult.payment.id;
+                const status = await this.client.payment.pollPaymentStatus(paymentId);
+                if (status.status === 'succeeded') {
+                    this.emit('success', { payment: status, order: status.order });
+                }
+                else {
+                    this.emit('error', `Payment ${status.status}`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : 'Express checkout failed';
+                this.emit('error', msg);
+            }
+            finally {
+                this.isProcessing = false;
+            }
+        });
+        this.expressElement.mount(container);
+    }
+    /**
+     * Update the payment amount (e.g. after a cart change).
+     */
+    updateAmount(amount, currency) {
+        if (!this.elements)
+            return;
+        const update = { amount: Math.max(Math.round(amount), 1) };
+        if (currency)
+            update.currency = currency.toLowerCase();
+        this.elements.update(update);
+    }
+    /**
+     * Write the wallet-approved contact onto the session before the charge.
+     *
+     * `billingAddressRequired` defaults to true, so Stripe collects an address on
+     * every express purchase; `shippingAddressRequired` adds a delivery address
+     * for carts that ship. Whichever arrives is mapped and stored — a contact
+     * with no street line or no country maps to `undefined` and leaves the
+     * session untouched, so this can never blank an address already entered.
+     */
+    async syncWalletContact(checkoutSessionId, event) {
+        const billingAddress = stripeContactToAddress(event.billingDetails);
+        const shippingAddress = stripeContactToAddress(event.shippingAddress);
+        if (!billingAddress && !shippingAddress)
+            return;
+        const customer = {};
+        const email = event.billingDetails?.email ?? event.shippingAddress?.email;
+        const phone = event.billingDetails?.phone ?? event.shippingAddress?.phone;
+        if (email)
+            customer.email = email;
+        if (phone)
+            customer.phone = phone;
+        await this.client.checkout.updateCustomerAndAddress(checkoutSessionId, {
+            customer,
+            shippingAddress,
+            billingAddress,
+        });
+    }
+    /**
+     * Clean up: unmount the element and release references.
+     */
+    unmount() {
+        this.expressElement?.unmount();
+        this.expressElement = null;
+        this.elements = null;
+        this.stripe = null;
+        this.container = null;
+        this.listeners = {};
+    }
+    emit(event, data) {
+        this.listeners[event]?.forEach((handler) => handler(data));
+    }
+    extractClientSecret(payResult) {
+        return payResult.payment?.requireActionData?.metadata?.stripeExpressCheckout
+            ? (payResult.payment.requireActionData.metadata
+                .stripeExpressCheckout.clientSecret)
+            : undefined;
+    }
+}
+//# sourceMappingURL=StripeExpressCheckout.js.map

package/dist/stripe/StripeExpressCheckout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeExpressCheckout.js","sourceRoot":"","sources":["../../src/stripe/StripeExpressCheckout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAsB,MAAM,kCAAkC,CAAC;AAW9F,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAU,CAAC;AAW3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,qBAAqB;IAkBhC,YAAY,IAAuD;QAjB3D,WAAM,GAAkB,IAAI,CAAC;QAC7B,aAAQ,GAA0B,IAAI,CAAC;QACvC,mBAAc,GAAsC,IAAI,CAAC;QACzD,cAAS,GAAuB,IAAI,CAAC;QACrC,iBAAY,GAAG,KAAK,CAAC;QACrB,cAAS,GAAqD,EAAE,CAAC;QAavE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;QACtE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC;QAClE,4EAA4E;QAC5E,4EAA4E;QAC5E,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,IAAI,KAAK,CAAC;IACvE,CAAC;IAED,EAAE,CAA2B,KAAQ,EAAE,OAAwB;QAC7D,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,SAA0C,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAA2B,KAAQ,EAAE,OAAwB;QAC9D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,SAAsB,EACtB,IAAqE;QAErE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC9B,IAAI,EAAE,SAAS;YACf,MAAM;YACN,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEzE,uHAAuH;QACvH,IAAI,CAAC,cAAc,GAAI,IAAI,CAAC,QAAgB,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACrE,UAAU,EAAE;gBACV,QAAQ,EAAE,IAAI,CAAC,UAAU;gBACzB,SAAS,EAAE,IAAI,CAAC,UAAU;aAC3B;YACD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc,EAAE;gBACd,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;gBACzD,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;gBAC3D,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;gBAC9C,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;aAC3D;YACD,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;SACtD,CAA+B,CAAC;QAEjC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,uBAAuB,EAAyD,EAAE,EAAE;YACrH,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACpC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAkB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,KAIxC,EAAE,EAAE;YACH,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAEzB,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,QAAS,CAAC,MAAM,EAAE,CAAC;gBAC7D,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;oBAC/D,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBAED,iEAAiE;gBACjE,kEAAkE;gBAClE,sEAAsE;gBACtE,sEAAsE;gBACtE,uBAAuB;gBACvB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;gBAC9D,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gDAAgD,CAAC,CAAC;oBACrE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC;oBAC/D,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;oBACzC,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,aAAa,EAAE,KAAK,CAAC,kBAAkB;iBACxC,CAAC,CAAC;gBAEH,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;gBACzD,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oEAAoE,CAAC,CAAC;oBACzF,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,cAAc,CAAC;oBAChE,QAAQ,EAAE,IAAI,CAAC,QAAS;oBACxB,YAAY;oBACZ,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;oBACnD,QAAQ,EAAE,aAAa;iBACxB,CAAC,CAAC;gBAEH,IAAI,YAAY,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,6BAA6B,CAAC,CAAC;oBAC1E,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBAEtE,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;gBAC3E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAc,EAAE,QAAiB;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,MAAM,MAAM,GAA4B,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACpF,IAAI,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAoD,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,iBAAiB,CAC7B,iBAAyB,EACzB,KAA0E;QAE1E,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACpE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEtE,IAAI,CAAC,cAAc,IAAI,CAAC,eAAe;YAAE,OAAO;QAEhD,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC;QAC1E,IAAI,KAAK;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QAClC,IAAI,KAAK;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QAElC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAC,iBAAiB,EAAE;YACrE,QAAQ;YACR,eAAe;YACf,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAEO,IAAI,CAA2B,KAAQ,EAAE,IAAiB;QAChE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAE,OAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,CAAC;IAEO,mBAAmB,CAAC,SAAoB;QAC9C,OACE,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAEvC,EAAE,qBAAqB;YACtB,CAAC,CAAC,CAAE,SAAS,CAAC,OAAO,CAAC,iBAAkB,CAAC,QAAmD;iBACvF,qBAAqB,CAAC,YAAY,CAAC;YACxC,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;CACF"}

package/dist/stripe/index.d.ts

@@ -0,0 +1,8 @@
+export { StripeExpressCheckout } from './StripeExpressCheckout.js';
+export { useStripeExpress } from './useStripeExpress.js';
+export type { UseStripeExpressOptions, UseStripeExpressReturn } from './useStripeExpress.js';
+export { StripeExpressButton } from './StripeExpressButton.js';
+export type { StripeExpressButtonProps } from './StripeExpressButton.js';
+export type { StripeExpressOptions } from '../core/types.js';
+export { startStripeExpressCheckout, isStripeExpressAvailable, type StripeExpressOptions as CoreStripeExpressOptions, type StripeExpressShippingAddress, type StripeExpressTokenResult, type StripeExpressCallbacks, } from '@tagadapay/core-js';
+//# sourceMappingURL=index.d.ts.map

package/dist/stripe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAO7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,oBAAoB,IAAI,wBAAwB,EACrD,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/stripe/index.js

@@ -0,0 +1,15 @@
+// ─────────────────────────────────────────────────────────────────
+// Session-based Stripe Express Checkout — drives Stripe's Express
+// Checkout Element (drop-in widget) wired to a checkout session.
+// Used by sites built on `@tagadapay/headless-sdk`.
+// ─────────────────────────────────────────────────────────────────
+export { StripeExpressCheckout } from './StripeExpressCheckout.js';
+export { useStripeExpress } from './useStripeExpress.js';
+export { StripeExpressButton } from './StripeExpressButton.js';
+// ─────────────────────────────────────────────────────────────────
+// Session-free wallet tokenization — re-exported from `@tagadapay/core-js`
+// for partner / S2S flows that don't use a checkout session. Stops at
+// Stripe `paymentMethodId`; the partner forwards it to their server.
+// ─────────────────────────────────────────────────────────────────
+export { startStripeExpressCheckout, isStripeExpressAvailable, } from '@tagadapay/core-js';
+//# sourceMappingURL=index.js.map

package/dist/stripe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stripe/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,kEAAkE;AAClE,iEAAiE;AACjE,oDAAoD;AACpD,oEAAoE;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAK/D,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,qEAAqE;AACrE,oEAAoE;AACpE,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GAKzB,MAAM,oBAAoB,CAAC"}

package/dist/stripe/useStripeExpress.d.ts

@@ -0,0 +1,54 @@
+import type { ExpressMethods, PaymentStatus, PaymentSetupConfig } from '../core/types.js';
+export interface UseStripeExpressOptions {
+    checkoutSessionId: string;
+    amount: number;
+    currency: string;
+    onSuccess?: (result: {
+        payment: PaymentStatus;
+        order?: {
+            id: string;
+            checkoutSessionId?: string;
+        };
+    }) => void;
+    onError?: (error: string) => void;
+    onCancel?: () => void;
+    /** Override payment setup config (skips API discovery). */
+    paymentSetupConfig?: PaymentSetupConfig;
+}
+export interface UseStripeExpressReturn {
+    /** Attach this ref to a <div> — the express buttons will mount inside it. */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** True once the Stripe element has rendered at least one wallet button. */
+    isReady: boolean;
+    /** True while a payment is being confirmed. */
+    isProcessing: boolean;
+    /** Discovered express methods (null while loading). */
+    expressMethods: ExpressMethods | null;
+    /** Update the displayed amount after cart changes. */
+    updateAmount: (amount: number, currency?: string) => void;
+}
+/**
+ * React hook that mounts the Stripe Express Checkout Element into a ref'd container.
+ *
+ * Handles the full lifecycle: discover config -> load Stripe -> mount ECE ->
+ * onConfirm -> processStripeExpress -> stripe.confirmPayment -> poll -> callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { useStripeExpress } from '@tagadapay/headless-sdk/stripe';
+ *
+ * function ExpressSection({ sessionId, totals }) {
+ *   const { containerRef, isReady } = useStripeExpress({
+ *     checkoutSessionId: sessionId,
+ *     amount: totals.total,
+ *     currency: totals.currency,
+ *     onSuccess: () => router.push('/confirmation'),
+ *     onError: (msg) => toast.error(msg),
+ *   });
+ *
+ *   return <div ref={containerRef} style={{ display: isReady ? 'block' : 'none' }} />;
+ * }
+ * ```
+ */
+export declare function useStripeExpress(opts: UseStripeExpressOptions): UseStripeExpressReturn;
+//# sourceMappingURL=useStripeExpress.d.ts.map

package/dist/stripe/useStripeExpress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripeExpress.d.ts","sourceRoot":"","sources":["../../src/stripe/useStripeExpress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7G,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,sDAAsD;IACtD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CAoFtF"}

package/dist/stripe/useStripeExpress.js

@@ -0,0 +1,125 @@
+import { useState, useRef, useEffect, useCallback } from 'react';
+import { useHeadlessClient } from '../react/provider.js';
+import { StripeExpressCheckout } from './StripeExpressCheckout.js';
+/**
+ * React hook that mounts the Stripe Express Checkout Element into a ref'd container.
+ *
+ * Handles the full lifecycle: discover config -> load Stripe -> mount ECE ->
+ * onConfirm -> processStripeExpress -> stripe.confirmPayment -> poll -> callbacks.
+ *
+ * @example
+ * ```tsx
+ * import { useStripeExpress } from '@tagadapay/headless-sdk/stripe';
+ *
+ * function ExpressSection({ sessionId, totals }) {
+ *   const { containerRef, isReady } = useStripeExpress({
+ *     checkoutSessionId: sessionId,
+ *     amount: totals.total,
+ *     currency: totals.currency,
+ *     onSuccess: () => router.push('/confirmation'),
+ *     onError: (msg) => toast.error(msg),
+ *   });
+ *
+ *   return <div ref={containerRef} style={{ display: isReady ? 'block' : 'none' }} />;
+ * }
+ * ```
+ */
+export function useStripeExpress(opts) {
+    const client = useHeadlessClient();
+    const containerRef = useRef(null);
+    const eceRef = useRef(null);
+    const [isReady, setIsReady] = useState(false);
+    const [isProcessing, setIsProcessing] = useState(false);
+    const [expressMethods, setExpressMethods] = useState(null);
+    const callbacksRef = useRef(opts);
+    callbacksRef.current = opts;
+    const { checkoutSessionId, amount, currency, paymentSetupConfig } = opts;
+    useEffect(() => {
+        if (!checkoutSessionId || !containerRef.current)
+            return;
+        let mounted = true;
+        let instance = null;
+        const init = async () => {
+            const express = await client.payment.getExpressMethods(checkoutSessionId, paymentSetupConfig ? { paymentSetupConfig } : undefined);
+            if (!mounted)
+                return;
+            setExpressMethods(express);
+            const stripeMethod = findStripeExpressMethod(express);
+            if (!stripeMethod?.publishableKey || !stripeMethod?.processorId)
+                return;
+            instance = new StripeExpressCheckout({
+                client,
+                publishableKey: stripeMethod.publishableKey,
+                processorId: stripeMethod.processorId,
+                enabledMethods: stripeMethod.enabledMethods,
+            });
+            instance.on('ready', () => {
+                if (mounted)
+                    setIsReady(true);
+            });
+            instance.on('success', (result) => {
+                if (mounted)
+                    setIsProcessing(false);
+                callbacksRef.current.onSuccess?.(result);
+            });
+            instance.on('error', (msg) => {
+                if (mounted)
+                    setIsProcessing(false);
+                callbacksRef.current.onError?.(msg);
+            });
+            instance.on('cancel', () => {
+                if (mounted)
+                    setIsProcessing(false);
+                callbacksRef.current.onCancel?.();
+            });
+            eceRef.current = instance;
+            if (containerRef.current) {
+                await instance.mount(containerRef.current, {
+                    checkoutSessionId,
+                    amount,
+                    currency,
+                });
+            }
+        };
+        void init();
+        return () => {
+            mounted = false;
+            instance?.unmount();
+            eceRef.current = null;
+            setIsReady(false);
+        };
+    }, [client, checkoutSessionId, paymentSetupConfig]); // eslint-disable-line react-hooks/exhaustive-deps
+    useEffect(() => {
+        eceRef.current?.updateAmount(amount, currency);
+    }, [amount, currency]);
+    const updateAmount = useCallback((newAmount, newCurrency) => {
+        eceRef.current?.updateAmount(newAmount, newCurrency);
+    }, []);
+    return { containerRef, isReady, isProcessing, expressMethods, updateAmount };
+}
+/**
+ * Find a Stripe ECE-capable method from the express methods map.
+ * Returns publishableKey, processorId, and list of enabled sub-methods.
+ */
+function findStripeExpressMethod(express) {
+    const allMethods = [
+        { key: 'apple_pay', entry: express.applePay },
+        { key: 'google_pay', entry: express.googlePay },
+        { key: 'link', entry: express.link },
+        { key: 'klarna_express', entry: express.klarna },
+    ];
+    for (const { entry } of allMethods) {
+        if (entry?.publishableKey && entry.processorId) {
+            const enabledMethods = allMethods
+                .filter(({ entry: e }) => e?.available && e.publishableKey === entry.publishableKey)
+                .map(({ key }) => key);
+            return {
+                publishableKey: entry.publishableKey,
+                processorId: entry.processorId,
+                enabledMethods,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=useStripeExpress.js.map