@tagadapay/headless-sdk 1.3.2 → 1.5.0

package/dist/stripe/StripeExpressCheckout.js

@@ -0,0 +1,198 @@
+const EXPRESS_METHOD_KEYS = ['apple_pay', 'google_pay', 'paypal', 'link', 'klarna_express'];
+/**
+ * Session-based Stripe Express Checkout integration.
+ *
+ * Mounts the Stripe `ExpressCheckoutElement` (Apple Pay, Google Pay, Link,
+ * PayPal, 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;
+    }
+    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',
+                paypal: methodEnabled('paypal') ? 'auto' : 'never',
+                klarna: methodEnabled('klarna_express') ? 'auto' : 'never',
+            },
+            emailRequired: this.emailRequired,
+            billingAddressRequired: this.billingAddressRequired,
+        });
+        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;
+                }
+                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);
+    }
+    /**
+     * 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":"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"}

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,126 @@
+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: 'paypal', entry: express.paypal },
+        { 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

package/dist/stripe/useStripeExpress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripeExpress.js","sourceRoot":"","sources":["../../src/stripe/useStripeExpress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AA2BnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,CAA+B,IAAI,CAAC,CAAC;IAE1D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IAElF,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;IAE5B,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAEzE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,iBAAiB,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO;QAExD,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,QAAQ,GAAiC,IAAI,CAAC;QAElD,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,CACpD,iBAAiB,EACjB,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAE3B,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC,YAAY,EAAE,cAAc,IAAI,CAAC,YAAY,EAAE,WAAW;gBAAE,OAAO;YAExE,QAAQ,GAAG,IAAI,qBAAqB,CAAC;gBACnC,MAAM;gBACN,cAAc,EAAE,YAAY,CAAC,cAAc;gBAC3C,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,cAAc,EAAE,YAAY,CAAC,cAAc;aAC5C,CAAC,CAAC;YAEH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACxB,IAAI,OAAO;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;gBAChC,IAAI,OAAO;oBAAE,eAAe,CAAC,KAAK,CAAC,CAAC;gBACpC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC3B,IAAI,OAAO;oBAAE,eAAe,CAAC,KAAK,CAAC,CAAC;gBACpC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACzB,IAAI,OAAO;oBAAE,eAAe,CAAC,KAAK,CAAC,CAAC;gBACpC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC;YAE1B,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE;oBACzC,iBAAiB;oBACjB,MAAM;oBACN,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QAEZ,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;YAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,kDAAkD;IAEvG,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvB,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,SAAiB,EAAE,WAAoB,EAAE,EAAE;QAC3E,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,OAAuB;IAEvB,MAAM,UAAU,GAAG;QACjB,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE;QAC7C,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/C,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;QACxC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;QACpC,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;KACjD,CAAC;IAEF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,KAAK,EAAE,cAAc,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC/C,MAAM,cAAc,GAAG,UAAU;iBAC9B,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc,CAAC;iBACnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO;gBACL,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,cAAc;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}