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

package/dist/react/hooks/usePayment.js

@@ -0,0 +1,233 @@
+import { useState, useCallback, useRef, useEffect } from 'react';
+import { useHeadlessClient } from '../provider.js';
+import { tryClaimResume } from '../internal/redirectGuard.js';
+/**
+ * React hook for payment processing.
+ *
+ * Handles the full payment lifecycle including 3DS redirects and return-URL detection.
+ *
+ * @example
+ * ```tsx
+ * const { processPayment, isProcessing, error } = usePayment({
+ *   onPaymentSuccess: (result) => router.push('/confirmation'),
+ *   onPaymentFailed: (result) => toast.error(result.error),
+ * });
+ *
+ * // On submit — one function handles everything
+ * const result = await processPayment({
+ *   checkoutSessionId: session.id,
+ *   tagadaToken,
+ * });
+ * ```
+ */
+export function usePayment(options) {
+    const client = useHeadlessClient();
+    const [paymentSetup, setPaymentSetup] = useState(null);
+    const [expressMethods, setExpressMethods] = useState(null);
+    const [storeConfig, setStoreConfig] = useState(null);
+    const [isProcessing, setIsProcessing] = useState(false);
+    const [result, setResult] = useState(null);
+    const [error, setError] = useState(null);
+    const loadedRef = useRef(false);
+    const redirectReturnProcessedRef = useRef(false);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    // ---------------------------------------------------------------------------
+    // Return-URL detection: auto-resume after 3DS / processor redirect
+    // ---------------------------------------------------------------------------
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        if (redirectReturnProcessedRef.current)
+            return;
+        const params = new URLSearchParams(window.location.search);
+        const paymentAction = params.get('paymentAction');
+        const paymentActionStatus = params.get('paymentActionStatus');
+        const paymentId = params.get('paymentId');
+        if (paymentAction !== 'requireAction' || paymentActionStatus !== 'completed' || !paymentId) {
+            return;
+        }
+        redirectReturnProcessedRef.current = true;
+        if (!tryClaimResume(paymentId)) {
+            // Another hook (likely useOffers) already started the resume for this
+            // paymentId; don't double-poll or double-fire callbacks.
+            return;
+        }
+        setIsProcessing(true);
+        setError(null);
+        const resume = async () => {
+            try {
+                const resumeResult = await client.payment.resumeAfterRedirect(paymentId);
+                // Clean payment-related query params from URL
+                const cleanParams = new URLSearchParams(window.location.search);
+                ['paymentAction', 'paymentActionStatus', 'paymentId', 'payment_intent', 'payment_intent_client_secret', 'source_type', 'redirect_status'].forEach((p) => cleanParams.delete(p));
+                const newUrl = cleanParams.toString()
+                    ? `${window.location.pathname}?${cleanParams.toString()}`
+                    : window.location.pathname;
+                window.history.replaceState({}, document.title, newUrl);
+                if (resumeResult.status === 'succeeded') {
+                    optionsRef.current?.onPaymentSuccess?.(resumeResult);
+                }
+                else if (resumeResult.status === 'failed') {
+                    setError(new Error(resumeResult.error));
+                    optionsRef.current?.onPaymentFailed?.(resumeResult);
+                }
+            }
+            catch (err) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                setIsProcessing(false);
+            }
+        };
+        void resume();
+    }, [client]); // eslint-disable-line react-hooks/exhaustive-deps
+    // ---------------------------------------------------------------------------
+    // Load payment setup
+    // ---------------------------------------------------------------------------
+    const loadPaymentSetup = useCallback(async (checkoutSessionId, opts) => {
+        if (loadedRef.current)
+            return;
+        loadedRef.current = true;
+        const setupOpts = opts?.paymentSetupConfig
+            ? { paymentSetupConfig: opts.paymentSetupConfig }
+            : optionsRef.current?.paymentSetupConfig
+                ? { paymentSetupConfig: optionsRef.current.paymentSetupConfig }
+                : undefined;
+        try {
+            const [setup, express, config] = await Promise.all([
+                client.payment.getPaymentSetup(checkoutSessionId, setupOpts),
+                client.payment.getExpressMethods(checkoutSessionId, setupOpts),
+                client.payment.getStoreConfig(),
+            ]);
+            setPaymentSetup(setup);
+            setExpressMethods(express);
+            setStoreConfig(config);
+        }
+        catch (err) {
+            loadedRef.current = false;
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }, [client]);
+    // ---------------------------------------------------------------------------
+    // processPayment — high-level, handles everything
+    // ---------------------------------------------------------------------------
+    const processPayment = useCallback(async (opts) => {
+        setIsProcessing(true);
+        setError(null);
+        try {
+            const payResult = await client.payment.processPayment(opts);
+            if (payResult.status === 'requires_redirect') {
+                // Browser redirect — the hook will resume on return via the useEffect above
+                if (payResult.method === 'POST' && payResult.postData) {
+                    const form = document.createElement('form');
+                    form.method = 'POST';
+                    form.action = payResult.redirectUrl;
+                    for (const [key, value] of Object.entries(payResult.postData)) {
+                        const input = document.createElement('input');
+                        input.type = 'hidden';
+                        input.name = key;
+                        input.value = value;
+                        form.appendChild(input);
+                    }
+                    document.body.appendChild(form);
+                    form.submit();
+                }
+                else {
+                    window.location.href = payResult.redirectUrl;
+                }
+                // Don't setIsProcessing(false) — page is navigating away
+                return payResult;
+            }
+            if (payResult.status === 'succeeded') {
+                optionsRef.current?.onPaymentSuccess?.(payResult);
+            }
+            else if (payResult.status === 'failed') {
+                setError(new Error(payResult.error));
+                optionsRef.current?.onPaymentFailed?.(payResult);
+            }
+            return payResult;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            return { status: 'failed', error: e.message };
+        }
+        finally {
+            setIsProcessing(false);
+        }
+    }, [client]);
+    // ---------------------------------------------------------------------------
+    // Low-level pay (raw API, no action handling)
+    // ---------------------------------------------------------------------------
+    const wrapAsync = useCallback((fn) => async () => {
+        setIsProcessing(true);
+        setError(null);
+        try {
+            const r = await fn();
+            return r;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsProcessing(false);
+        }
+    }, []);
+    const pay = useCallback(async (opts) => {
+        setIsProcessing(true);
+        setError(null);
+        try {
+            const r = await client.payment.pay(opts);
+            setResult(r);
+            return r;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsProcessing(false);
+        }
+    }, [client]);
+    const tokenizeCard = useCallback((card) => client.payment.tokenizeCard(card), [client]);
+    const processApplePay = useCallback(async (opts) => {
+        const fn = wrapAsync(() => client.payment.processApplePay(opts));
+        const r = await fn();
+        setResult(r);
+        return r;
+    }, [client, wrapAsync]);
+    const processGooglePay = useCallback(async (opts) => {
+        const fn = wrapAsync(() => client.payment.processGooglePay(opts));
+        const r = await fn();
+        setResult(r);
+        return r;
+    }, [client, wrapAsync]);
+    const processApm = useCallback(async (opts) => {
+        const fn = wrapAsync(() => client.payment.processApm(opts));
+        const r = await fn();
+        setResult(r);
+        return r;
+    }, [client, wrapAsync]);
+    const pollStatus = useCallback((paymentId) => client.payment.pollPaymentStatus(paymentId), [client]);
+    return {
+        paymentSetup,
+        expressMethods,
+        storeConfig,
+        isProcessing,
+        result,
+        error,
+        loadPaymentSetup,
+        processPayment,
+        pay,
+        tokenizeCard,
+        processApplePay,
+        processGooglePay,
+        processApm,
+        pollStatus,
+    };
+}
+//# sourceMappingURL=usePayment.js.map

package/dist/react/hooks/usePayment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePayment.js","sourceRoot":"","sources":["../../../src/react/hooks/usePayment.ts"],"names":[],"mappings":"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"}

package/dist/react/hooks/useRx.d.ts

@@ -0,0 +1,64 @@
+import type { RxCaseSummary, RxQuestionsForProduct, RxRequiredForProduct, RxSubmitCaseInput, RxSubmitCaseResult } from '../../core/modules/rx.js';
+export interface UseRxReturn {
+    /** Cases attached to the current order (populated by `pollOrder`). */
+    cases: RxCaseSummary[];
+    /** Result of the last `submitCase` call, kept for the thank-you page. */
+    lastSubmission: RxSubmitCaseResult | null;
+    /** True while ANY rx call is in flight. */
+    isLoading: boolean;
+    error: Error | null;
+    /**
+     * Ask whether a product needs an Rx case before submitting payment.
+     * Storefronts call this at product-page load to decide whether to
+     * render the intake step.
+     */
+    isRequiredForProduct: (productId: string, opts?: {
+        clinicalNetworkId?: string;
+    }) => Promise<RxRequiredForProduct>;
+    /** Fetch network-authored intake questions for a product. */
+    getQuestionsForProduct: (productId: string) => Promise<RxQuestionsForProduct>;
+    /**
+     * Submit a fresh case after the order is paid. The result is also
+     * stored in `lastSubmission` so the thank-you page can read it.
+     */
+    submitCase: (input: RxSubmitCaseInput) => Promise<RxSubmitCaseResult>;
+    /**
+     * Fetch the public summary of every case attached to a paid order.
+     * Useful for the thank-you page or order history.
+     */
+    fetchCasesForOrder: (input: {
+        orderId: string;
+        checkoutToken: string;
+    }) => Promise<RxCaseSummary[]>;
+    /**
+     * Auto-poll the cases for an order until they all reach a terminal
+     * status (approved / shipped / delivered / declined / cancelled /
+     * error). Returns a `stop()` function to cancel the polling.
+     */
+    pollOrder: (input: {
+        orderId: string;
+        checkoutToken: string;
+    }, opts?: {
+        intervalMs?: number;
+        onUpdate?: (cases: RxCaseSummary[]) => void;
+    }) => () => void;
+}
+/**
+ * React hook for Tagada Rx storefronts.
+ *
+ * @example
+ * ```tsx
+ * const { isRequiredForProduct, submitCase, lastSubmission, pollOrder } = useRx();
+ *
+ * useEffect(() => {
+ *   if (orderId && checkoutToken) {
+ *     const stop = pollOrder({ orderId, checkoutToken }, {
+ *       onUpdate: (cases) => setCases(cases),
+ *     });
+ *     return stop;
+ *   }
+ * }, [orderId, checkoutToken, pollOrder]);
+ * ```
+ */
+export declare function useRx(): UseRxReturn;
+//# sourceMappingURL=useRx.d.ts.map

package/dist/react/hooks/useRx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRx.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useRx.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,yEAAyE;IACzE,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,oBAAoB,EAAE,CACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,KAClC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEnC,6DAA6D;IAC7D,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE9E;;;OAGG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEtE;;;OAGG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEpG;;;;OAIG;IACH,SAAS,EAAE,CACT,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EACjD,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;KAAE,KACxE,MAAM,IAAI,CAAC;CACjB;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,IAAI,WAAW,CA+HnC"}

package/dist/react/hooks/useRx.js

@@ -0,0 +1,145 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useHeadlessClient } from '../provider.js';
+const TERMINAL_STATUSES = new Set([
+    'approved',
+    'shipped',
+    'delivered',
+    'declined',
+    'cancelled',
+    'error',
+]);
+/**
+ * React hook for Tagada Rx storefronts.
+ *
+ * @example
+ * ```tsx
+ * const { isRequiredForProduct, submitCase, lastSubmission, pollOrder } = useRx();
+ *
+ * useEffect(() => {
+ *   if (orderId && checkoutToken) {
+ *     const stop = pollOrder({ orderId, checkoutToken }, {
+ *       onUpdate: (cases) => setCases(cases),
+ *     });
+ *     return stop;
+ *   }
+ * }, [orderId, checkoutToken, pollOrder]);
+ * ```
+ */
+export function useRx() {
+    const client = useHeadlessClient();
+    const [cases, setCases] = useState([]);
+    const [lastSubmission, setLastSubmission] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const pollTimerRef = useRef(null);
+    useEffect(() => {
+        return () => {
+            if (pollTimerRef.current)
+                clearInterval(pollTimerRef.current);
+        };
+    }, []);
+    const isRequiredForProduct = useCallback(async (productId, opts) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await client.rx.isRequiredForProduct(productId, opts);
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const getQuestionsForProduct = useCallback(async (productId) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await client.rx.getQuestionsForProduct(productId);
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const submitCase = useCallback(async (input) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const res = await client.rx.submitCase(input);
+            setLastSubmission(res);
+            return res;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const fetchCasesForOrder = useCallback(async (input) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const res = await client.rx.getCasesForOrder(input);
+            setCases(res.cases);
+            return res.cases;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const pollOrder = useCallback(({ orderId, checkoutToken }, opts) => {
+        if (pollTimerRef.current)
+            clearInterval(pollTimerRef.current);
+        const intervalMs = opts?.intervalMs ?? 5000;
+        const tick = async () => {
+            try {
+                const res = await client.rx.getCasesForOrder({ orderId, checkoutToken });
+                setCases(res.cases);
+                opts?.onUpdate?.(res.cases);
+                if (res.cases.length > 0 && res.cases.every((c) => TERMINAL_STATUSES.has(c.status))) {
+                    if (pollTimerRef.current)
+                        clearInterval(pollTimerRef.current);
+                    pollTimerRef.current = null;
+                }
+            }
+            catch (err) {
+                const e = err instanceof Error ? err : new Error(String(err));
+                setError(e);
+            }
+        };
+        void tick();
+        pollTimerRef.current = setInterval(tick, intervalMs);
+        return () => {
+            if (pollTimerRef.current)
+                clearInterval(pollTimerRef.current);
+            pollTimerRef.current = null;
+        };
+    }, [client]);
+    return {
+        cases,
+        lastSubmission,
+        isLoading,
+        error,
+        isRequiredForProduct,
+        getQuestionsForProduct,
+        submitCase,
+        fetchCasesForOrder,
+        pollOrder,
+    };
+}
+//# sourceMappingURL=useRx.js.map

package/dist/react/hooks/useRx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRx.js","sourceRoot":"","sources":["../../../src/react/hooks/useRx.ts"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -0,0 +1,22 @@
+export { TagadaHeadlessProvider, useHeadlessClient } from './provider.js';
+export type { TagadaHeadlessProviderProps } from './provider.js';
+export { useCheckout } from './hooks/useCheckout.js';
+export type { UseCheckoutReturn } from './hooks/useCheckout.js';
+export { usePayment } from './hooks/usePayment.js';
+export type { UsePaymentReturn, UsePaymentOptions } from './hooks/usePayment.js';
+export { useOffers } from './hooks/useOffers.js';
+export type { UseOffersReturn } from './hooks/useOffers.js';
+export { useCustomer } from './hooks/useCustomer.js';
+export type { UseCustomerReturn } from './hooks/useCustomer.js';
+export { useCatalog } from './hooks/useCatalog.js';
+export type { UseCatalogReturn } from './hooks/useCatalog.js';
+export { useRx } from './hooks/useRx.js';
+export type { UseRxReturn } from './hooks/useRx.js';
+export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete.js';
+export type { UseGoogleAutocompleteOptions, UseGoogleAutocompleteReturn } from './hooks/useGoogleAutocomplete.js';
+export { useISOData, useCountryOptions, useRegionOptions } from './hooks/useISOData.js';
+export type { UseISODataReturn } from './hooks/useISOData.js';
+export type { GooglePrediction, GooglePlaceDetails, ExtractedAddress, FormattedAddress, SupportedLanguage, ISOCountry, ISORegion, Currency, } from '../core/helpers/index.js';
+export { formatMoney, CurrencyUtils, ISODataCore, GoogleAutocompleteCore, loadGoogleMapsScript } from '../core/helpers/index.js';
+export type { HeadlessConfig, Environment, CheckoutSession, CheckoutLineItem, CheckoutTotals, CheckoutCustomer, Address, ShippingRate, LineItem, PaymentSetupConfig, PaymentMethodConfig, ExpressMethods, ExpressMethod, StoreConfig, PayResult, PayOptions, PaymentStatus, ProcessPaymentOptions, ProcessPaymentResult, Offer, OfferLineItem, OfferPreview, OfferPreviewItem, OfferPayResult, Customer, Order, Subscription, CatalogProduct, CatalogVariant, CatalogPrice, CurrencyOption, StripeExpressOptions, } from '../core/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAElH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,QAAQ,GACT,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEjI,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,12 @@
+export { TagadaHeadlessProvider, useHeadlessClient } from './provider.js';
+export { useCheckout } from './hooks/useCheckout.js';
+export { usePayment } from './hooks/usePayment.js';
+export { useOffers } from './hooks/useOffers.js';
+export { useCustomer } from './hooks/useCustomer.js';
+export { useCatalog } from './hooks/useCatalog.js';
+export { useRx } from './hooks/useRx.js';
+// Helpers hooks
+export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete.js';
+export { useISOData, useCountryOptions, useRegionOptions } from './hooks/useISOData.js';
+export { formatMoney, CurrencyUtils, ISODataCore, GoogleAutocompleteCore, loadGoogleMapsScript } from '../core/helpers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,gBAAgB;AAChB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAexF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/react/internal/redirectGuard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Try to claim ownership of resuming a payment. Returns `true` if the
+ * caller is the first one to claim it (and should proceed); `false` if
+ * another hook has already claimed it.
+ */
+export declare function tryClaimResume(paymentId: string): boolean;
+/** Reset the guard. Useful in tests and on hard refresh logic. */
+export declare function resetResumeGuard(): void;
+//# sourceMappingURL=redirectGuard.d.ts.map

package/dist/react/internal/redirectGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectGuard.d.ts","sourceRoot":"","sources":["../../../src/react/internal/redirectGuard.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/react/internal/redirectGuard.js

@@ -0,0 +1,25 @@
+/**
+ * Module-level guard preventing two hooks (`usePayment`, `useOffers`) from
+ * both resuming the same payment after a 3DS / processor redirect.
+ *
+ * Each `paymentId` is processed at most once per page load. The first hook
+ * that wins the race calls `client.payment.resumeAfterRedirect` and fires
+ * its callback; the other hook becomes a no-op.
+ */
+const RESUMED_PAYMENT_IDS = new Set();
+/**
+ * Try to claim ownership of resuming a payment. Returns `true` if the
+ * caller is the first one to claim it (and should proceed); `false` if
+ * another hook has already claimed it.
+ */
+export function tryClaimResume(paymentId) {
+    if (RESUMED_PAYMENT_IDS.has(paymentId))
+        return false;
+    RESUMED_PAYMENT_IDS.add(paymentId);
+    return true;
+}
+/** Reset the guard. Useful in tests and on hard refresh logic. */
+export function resetResumeGuard() {
+    RESUMED_PAYMENT_IDS.clear();
+}
+//# sourceMappingURL=redirectGuard.js.map

package/dist/react/internal/redirectGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectGuard.js","sourceRoot":"","sources":["../../../src/react/internal/redirectGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB;IAC9B,mBAAmB,CAAC,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/react/provider.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { HeadlessClient } from '../core/client.js';
+import type { HeadlessConfig, Environment } from '../core/types.js';
+export interface TagadaHeadlessProviderProps {
+    /** Your TagadaPay store ID. */
+    storeId: string;
+    /** Environment. Defaults to "production". */
+    environment?: Environment;
+    /** Public API key for authenticated requests. */
+    apiKey?: string;
+    /** Override the base API URL. */
+    baseUrl?: string;
+    /** Full config object (alternative to individual props). */
+    config?: HeadlessConfig;
+    children: React.ReactNode;
+}
+/**
+ * Root provider for the TagadaPay Headless SDK React integration.
+ * Creates a single HeadlessClient and shares it via context.
+ *
+ * @example
+ * ```tsx
+ * <TagadaHeadlessProvider storeId="store_abc123" environment="production">
+ *   <App />
+ * </TagadaHeadlessProvider>
+ * ```
+ */
+export declare function TagadaHeadlessProvider({ storeId, environment, apiKey, baseUrl, config, children, }: TagadaHeadlessProviderProps): import("react/jsx-runtime.js").JSX.Element;
+/** Access the HeadlessClient from context. Throws if used outside the provider. */
+export declare function useHeadlessClient(): HeadlessClient;
+//# sourceMappingURL=provider.d.ts.map

package/dist/react/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpE,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,WAAW,EACX,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE,2BAA2B,8CAa7B;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD"}

package/dist/react/provider.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+import { createHeadlessClient } from '../core/client.js';
+const TagadaHeadlessContext = createContext(null);
+/**
+ * Root provider for the TagadaPay Headless SDK React integration.
+ * Creates a single HeadlessClient and shares it via context.
+ *
+ * @example
+ * ```tsx
+ * <TagadaHeadlessProvider storeId="store_abc123" environment="production">
+ *   <App />
+ * </TagadaHeadlessProvider>
+ * ```
+ */
+export function TagadaHeadlessProvider({ storeId, environment, apiKey, baseUrl, config, children, }) {
+    const client = useMemo(() => {
+        const cfg = config ?? { storeId, environment, apiKey, baseUrl };
+        return createHeadlessClient(cfg);
+    }, [storeId, environment, apiKey, baseUrl, config]);
+    const value = useMemo(() => ({ client }), [client]);
+    return (_jsx(TagadaHeadlessContext.Provider, { value: value, children: children }));
+}
+/** Access the HeadlessClient from context. Throws if used outside the provider. */
+export function useHeadlessClient() {
+    const ctx = useContext(TagadaHeadlessContext);
+    if (!ctx) {
+        throw new Error('useHeadlessClient must be used within <TagadaHeadlessProvider>');
+    }
+    return ctx.client;
+}
+//# sourceMappingURL=provider.js.map

package/dist/react/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAkB,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAOzE,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAgBrF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,OAAO,EACP,WAAW,EACX,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,GACoB;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,MAAM,GAAG,GAAmB,MAAM,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAChF,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpD,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC"}