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

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

@@ -0,0 +1,134 @@
+import type { Offer, OfferPreview, OfferPayResult, ProcessPaymentResult } from '../../core/types.js';
+export interface UseOffersOptions {
+    /**
+     * Called when an offer charge succeeds, including after a 3DS redirect
+     * return. Use this to navigate to the next funnel step
+     * (e.g. `/upsell-2` or `/thank-you`).
+     */
+    onOfferAccepted?: (result: ProcessPaymentResult & {
+        status: 'succeeded';
+    }) => void;
+    /**
+     * Called when an offer charge fails or is declined, including after a
+     * redirect return.
+     */
+    onOfferDeclined?: (result: ProcessPaymentResult & {
+        status: 'failed';
+    }) => void;
+    /**
+     * Disable the in-hook 3DS-return auto-resume. Set this to `true` if you
+     * already mount `usePayment` on the same page — though both hooks use a
+     * shared guard so leaving it `false` is also safe.
+     */
+    disableAutoResume?: boolean;
+}
+export interface UseOffersReturn {
+    /** Current loaded offer. */
+    offer: Offer | null;
+    /** Current preview (pricing breakdown). */
+    preview: OfferPreview | null;
+    /** Whether an operation is in progress (including polling after redirect). */
+    isLoading: boolean;
+    /** Last error. */
+    error: Error | null;
+    /** Get a single offer by ID. */
+    getOffer: (offerId: string) => Promise<Offer>;
+    /** List offers for the store, optionally filtered by type or IDs. */
+    listOffers: (opts?: {
+        type?: 'upsell' | 'orderbump';
+        ids?: string[];
+    }) => Promise<Offer[]>;
+    /** Preview offer pricing (line items with amounts). */
+    previewOffer: (opts: {
+        offerId: string;
+        currency?: string;
+        lineItems?: Array<{
+            variantId: string;
+            quantity: number;
+        }>;
+    }) => Promise<OfferPreview>;
+    /**
+     * **Recommended.** Charge a previewed offer and handle the full
+     * lifecycle (3DS challenge or redirect, polling, return-URL detection).
+     *
+     * Resolves with a typed `ProcessPaymentResult`:
+     *   - `'succeeded'` — charge complete; `onOfferAccepted` callback fired.
+     *   - `'requires_redirect'` — browser is being redirected to the bank;
+     *     the hook will auto-resume on return.
+     *   - `'failed'` — charge declined or error; `onOfferDeclined` fired.
+     *   - `'pending'` — async charge still in flight (rare).
+     */
+    processOfferPayment: (opts: {
+        offerId: string;
+        mainOrderId: string;
+        currency?: string;
+        lineItems?: Array<{
+            variantId: string;
+            quantity: number;
+        }>;
+        returnUrl?: string;
+        paymentInstrumentId?: string;
+    }) => Promise<ProcessPaymentResult>;
+    /**
+     * Low-level pay (returns raw `OfferPayResult`, no automatic 3DS / polling).
+     * Most callers should use `processOfferPayment` instead.
+     */
+    payPreviewedOffer: (opts: {
+        offerId: string;
+        mainOrderId: string;
+        currency?: string;
+        lineItems?: Array<{
+            variantId: string;
+            quantity: number;
+        }>;
+        returnUrl?: string;
+        paymentInstrumentId?: string;
+    }) => Promise<OfferPayResult>;
+    /** Toggle an order bump on/off within a checkout session. */
+    toggleOrderBump: (opts: {
+        checkoutSessionId: string;
+        orderBumpOfferId: string;
+        selected: boolean;
+    }) => Promise<unknown>;
+    /** List post-purchase offers for an order. */
+    listPostPurchaseOffers: (orderId: string) => Promise<Offer[]>;
+    /** Accept a post-purchase offer (only works for offers pre-registered as post-purchase on the order). */
+    acceptPostPurchaseOffer: (opts: {
+        orderId: string;
+        offerId: string;
+        items?: Array<{
+            variantId: string;
+            quantity: number;
+        }>;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Decline a post-purchase offer. */
+    declinePostPurchaseOffer: (opts: {
+        orderId: string;
+        offerId: string;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * React hook for offers — upsells, order bumps, and post-purchase offers.
+ *
+ * @example
+ * ```tsx
+ * const { processOfferPayment, isLoading, error } = useOffers({
+ *   onOfferAccepted: () => navigate('/upsell-2'),
+ *   onOfferDeclined: (res) => toast.error(res.error),
+ * });
+ *
+ * await processOfferPayment({
+ *   offerId: 'offer_xxx',
+ *   mainOrderId: order.id,
+ * });
+ * // 3DS, redirect, return, polling — all handled automatically.
+ * ```
+ */
+export declare function useOffers(options?: UseOffersOptions): UseOffersReturn;
+//# sourceMappingURL=useOffers.d.ts.map

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

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

package/dist/react/hooks/useOffers.js

@@ -0,0 +1,171 @@
+import { useState, useCallback, useRef, useEffect } from 'react';
+import { useHeadlessClient } from '../provider.js';
+import { tryClaimResume } from '../internal/redirectGuard.js';
+/**
+ * React hook for offers — upsells, order bumps, and post-purchase offers.
+ *
+ * @example
+ * ```tsx
+ * const { processOfferPayment, isLoading, error } = useOffers({
+ *   onOfferAccepted: () => navigate('/upsell-2'),
+ *   onOfferDeclined: (res) => toast.error(res.error),
+ * });
+ *
+ * await processOfferPayment({
+ *   offerId: 'offer_xxx',
+ *   mainOrderId: order.id,
+ * });
+ * // 3DS, redirect, return, polling — all handled automatically.
+ * ```
+ */
+export function useOffers(options) {
+    const client = useHeadlessClient();
+    const [offer, setOffer] = useState(null);
+    const [preview, setPreview] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const redirectReturnProcessedRef = useRef(false);
+    // ---------------------------------------------------------------------------
+    // Auto-resume after 3DS / processor redirect (offer-flavored callbacks).
+    // Mirrors usePayment; guarded so the two hooks don't both fire.
+    // ---------------------------------------------------------------------------
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        if (optionsRef.current?.disableAutoResume)
+            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 usePayment) already started the resume.
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        const resume = async () => {
+            try {
+                const result = await client.payment.resumeAfterRedirect(paymentId);
+                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 (result.status === 'succeeded') {
+                    optionsRef.current?.onOfferAccepted?.(result);
+                }
+                else if (result.status === 'failed') {
+                    setError(new Error(result.error));
+                    optionsRef.current?.onOfferDeclined?.(result);
+                }
+            }
+            catch (err) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                setIsLoading(false);
+            }
+        };
+        void resume();
+    }, [client]); // eslint-disable-line react-hooks/exhaustive-deps
+    const wrap = useCallback(async (fn) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, []);
+    const getOffer = useCallback((offerId) => wrap(async () => {
+        const o = await client.offers.getOffer(offerId);
+        setOffer(o);
+        return o;
+    }), [client, wrap]);
+    const listOffers = useCallback((opts) => client.offers.listOffers(opts), [client]);
+    const previewOffer = useCallback((opts) => wrap(async () => {
+        const p = await client.offers.previewOffer(opts);
+        setPreview(p);
+        return p;
+    }), [client, wrap]);
+    const payPreviewedOffer = useCallback((opts) => wrap(() => client.offers.payPreviewedOffer(opts)), [client, wrap]);
+    const processOfferPayment = useCallback(async (opts) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await client.offers.processOfferPayment(opts);
+            if (result.status === 'requires_redirect') {
+                if (result.method === 'POST' && result.postData) {
+                    const form = document.createElement('form');
+                    form.method = 'POST';
+                    form.action = result.redirectUrl;
+                    for (const [key, value] of Object.entries(result.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 = result.redirectUrl;
+                }
+                return result;
+            }
+            if (result.status === 'succeeded') {
+                optionsRef.current?.onOfferAccepted?.(result);
+            }
+            else if (result.status === 'failed') {
+                setError(new Error(result.error));
+                optionsRef.current?.onOfferDeclined?.(result);
+            }
+            return result;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            return { status: 'failed', error: e.message };
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client]);
+    const toggleOrderBump = useCallback((opts) => client.offers.toggleOrderBump(opts), [client]);
+    const listPostPurchaseOffers = useCallback((orderId) => client.offers.listPostPurchaseOffers(orderId), [client]);
+    const acceptPostPurchaseOffer = useCallback((opts) => wrap(() => client.offers.acceptPostPurchaseOffer(opts)), [client, wrap]);
+    const declinePostPurchaseOffer = useCallback((opts) => wrap(() => client.offers.declinePostPurchaseOffer(opts)), [client, wrap]);
+    return {
+        offer,
+        preview,
+        isLoading,
+        error,
+        getOffer,
+        listOffers,
+        previewOffer,
+        processOfferPayment,
+        payPreviewedOffer,
+        toggleOrderBump,
+        listPostPurchaseOffers,
+        acceptPostPurchaseOffer,
+        declinePostPurchaseOffer,
+    };
+}
+//# sourceMappingURL=useOffers.js.map

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

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

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

@@ -0,0 +1,117 @@
+import type { PaymentSetupConfig, ExpressMethods, StoreConfig, PayResult, PayOptions, PaymentStatus, ProcessPaymentOptions, ProcessPaymentResult } from '../../core/types.js';
+import type { ApplePayContact, GooglePayContact } from '../../core/helpers/walletContact.js';
+export interface UsePaymentOptions {
+    /**
+     * Called when a payment succeeds (including after 3DS redirect return).
+     * Use this to navigate to a confirmation page.
+     */
+    onPaymentSuccess?: (result: ProcessPaymentResult & {
+        status: 'succeeded';
+    }) => void;
+    /**
+     * Called when a payment fails (including after redirect return).
+     */
+    onPaymentFailed?: (result: ProcessPaymentResult & {
+        status: 'failed';
+    }) => void;
+    /**
+     * Explicit paymentSetupConfig override.
+     * When provided, the SDK skips both __TGD_STEP_CONFIG__ detection and the API call.
+     * Useful when a developer fetches the config from their own backend.
+     */
+    paymentSetupConfig?: PaymentSetupConfig;
+}
+export interface UsePaymentReturn {
+    /** Full payment setup config (all methods with their enabled/disabled state). */
+    paymentSetup: PaymentSetupConfig | null;
+    /** Express methods (Apple Pay, Google Pay, etc.) with browser availability. */
+    expressMethods: ExpressMethods | null;
+    /** Store-level config (3DS flags, etc.). */
+    storeConfig: StoreConfig | null;
+    /** Whether a payment is currently being processed (including polling after redirect). */
+    isProcessing: boolean;
+    /** Last payment result. */
+    result: PayResult | null;
+    /** Last error. */
+    error: Error | null;
+    /**
+     * Load payment setup for a checkout session. Call this once when the session is ready.
+     * Optionally pass `paymentSetupConfig` to override auto-detection.
+     */
+    loadPaymentSetup: (checkoutSessionId: string, opts?: {
+        paymentSetupConfig?: PaymentSetupConfig;
+    }) => Promise<void>;
+    /**
+     * **Recommended**. Tokenize + pay + handle 3DS/redirects + poll — all in one call.
+     *
+     * - If the payment succeeds immediately, resolves with `{ status: 'succeeded' }`.
+     * - If 3DS redirect is needed, automatically redirects the browser.
+     *   When the user comes back, the hook auto-detects the return and polls.
+     * - If the payment fails, resolves with `{ status: 'failed', error: '...' }`.
+     */
+    processPayment: (opts: ProcessPaymentOptions) => Promise<ProcessPaymentResult>;
+    /** Low-level pay (returns raw API response, no automatic action handling). */
+    pay: (opts: PayOptions) => Promise<PayResult>;
+    /**
+     * Tokenize a card (returns tagadaToken). Requires @tagadapay/core-js.
+     *
+     * PCI note: card data passes through your JS environment.
+     * You are responsible for PCI DSS SAQ-A-EP compliance.
+     */
+    tokenizeCard: (card: {
+        cardNumber: string;
+        expiryDate: string;
+        cvc: string;
+        cardholderName?: string;
+    }) => Promise<{
+        tagadaToken: string;
+        rawToken: Record<string, unknown>;
+    }>;
+    /**
+     * Process Apple Pay. Pass the contacts from `onpaymentauthorized` so the
+     * address approved in the wallet sheet reaches the order (#TAG-1989).
+     */
+    processApplePay: (opts: {
+        checkoutSessionId: string;
+        applePayToken: unknown;
+        billingContact?: ApplePayContact | null;
+        shippingContact?: ApplePayContact | null;
+    }) => Promise<PayResult>;
+    /** Process Google Pay. Pass the wallet addresses for the same reason. */
+    processGooglePay: (opts: {
+        checkoutSessionId: string;
+        googlePayToken: string;
+        billingAddress?: GooglePayContact | null;
+        shippingAddress?: GooglePayContact | null;
+        email?: string;
+    }) => Promise<PayResult>;
+    /** Process redirect-based APM (Klarna, iDEAL, etc.). */
+    processApm: (opts: {
+        checkoutSessionId: string;
+        paymentMethod: string;
+        processorId: string;
+    }) => Promise<PayResult>;
+    /** Poll a payment until terminal status. */
+    pollStatus: (paymentId: string) => Promise<PaymentStatus>;
+}
+/**
+ * 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 declare function usePayment(options?: UsePaymentOptions): UsePaymentReturn;
+//# sourceMappingURL=usePayment.d.ts.map

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

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