@tagadapay/plugin-sdk 2.8.8 → 2.8.10

package/dist/v2/react/hooks/usePaymentQuery.js

@@ -87,15 +87,28 @@ export function usePaymentQuery() {
                                 },
                                 onSuccess: (successPayment) => {
                                     setIsLoading(false);
-                                    options.onSuccess?.({
+                                    const response = {
                                         paymentId: successPayment.id,
                                         payment: successPayment,
-                                    });
+                                        // Extract order from payment if available (for funnel path resolution)
+                                        order: successPayment.order,
+                                    };
+                                    // Legacy callback (backwards compatibility)
+                                    options.onSuccess?.(response);
+                                    // Funnel-aligned callback (recommended)
+                                    options.onPaymentSuccess?.(response);
                                 },
                                 onFailure: (errorMsg) => {
                                     setError(errorMsg);
                                     setIsLoading(false);
+                                    // Legacy callback (backwards compatibility)
                                     options.onFailure?.(errorMsg);
+                                    // Funnel-aligned callback (recommended)
+                                    options.onPaymentFailed?.({
+                                        code: 'PAYMENT_FAILED',
+                                        message: errorMsg,
+                                        payment,
+                                    });
                                 },
                             });
                         }
@@ -105,22 +118,57 @@ export function usePaymentQuery() {
                         const errorMsg = _error instanceof Error ? _error.message : 'Failed to start 3DS challenge';
                         setError(errorMsg);
                         setIsLoading(false);
+                        // Legacy callback (backwards compatibility)
                         options.onFailure?.(errorMsg);
+                        // Funnel-aligned callback (recommended)
+                        options.onPaymentFailed?.({
+                            code: '3DS_CHALLENGE_FAILED',
+                            message: errorMsg,
+                            payment,
+                        });
                     }
                 }
                 break;
             case 'processor_auth':
             case 'redirect': {
-                if (actionData.metadata?.redirect?.redirectUrl) {
+                // Only auto-redirect if explicitly enabled (disableAutoRedirect: false)
+                // Default behavior: disable redirects and let funnel orchestrator handle navigation
+                const shouldRedirect = options.disableAutoRedirect === false;
+                if (shouldRedirect && actionData.metadata?.redirect?.redirectUrl) {
                     window.location.href = actionData.metadata.redirect.redirectUrl;
                 }
+                else {
+                    // If auto-redirect is disabled AND payment succeeded, call success callbacks
+                    // This allows funnel orchestrator to handle navigation
+                    if (payment.status === 'succeeded') {
+                        setIsLoading(false);
+                        const response = {
+                            paymentId: payment.id,
+                            payment,
+                            // Extract order from payment if available (for funnel path resolution)
+                            order: payment.order,
+                        };
+                        // Legacy callback (backwards compatibility)
+                        options.onSuccess?.(response);
+                        // Funnel-aligned callback (recommended)
+                        options.onPaymentSuccess?.(response);
+                    }
+                }
                 break;
             }
             case 'error': {
                 const errorMsg = actionData.message || 'Payment processing failed';
+                const errorCode = actionData.errorCode || 'PAYMENT_FAILED';
                 setError(errorMsg);
                 setIsLoading(false);
+                // Legacy callback (backwards compatibility)
                 options.onFailure?.(errorMsg);
+                // Funnel-aligned callback (recommended)
+                options.onPaymentFailed?.({
+                    code: errorCode,
+                    message: errorMsg,
+                    payment,
+                });
                 break;
             }
         }
@@ -147,7 +195,15 @@ export function usePaymentQuery() {
             }
             else if (response.payment.status === 'succeeded') {
                 setIsLoading(false);
-                options.onSuccess?.(response);
+                // Ensure order is at response root (extract from payment if needed)
+                const successResponse = {
+                    ...response,
+                    order: response.order || response.payment.order,
+                };
+                // Legacy callback (backwards compatibility)
+                options.onSuccess?.(successResponse);
+                // Funnel-aligned callback (recommended)
+                options.onPaymentSuccess?.(successResponse);
             }
             else {
                 // Start polling for payment status
@@ -157,15 +213,28 @@ export function usePaymentQuery() {
                     },
                     onSuccess: (payment) => {
                         setIsLoading(false);
-                        options.onSuccess?.({
+                        const successResponse = {
                             paymentId: payment.id,
                             payment,
-                        });
+                            // Extract order from payment if available (for funnel path resolution)
+                            order: payment.order,
+                        };
+                        // Legacy callback (backwards compatibility)
+                        options.onSuccess?.(successResponse);
+                        // Funnel-aligned callback (recommended)
+                        options.onPaymentSuccess?.(successResponse);
                     },
                     onFailure: (errorMsg) => {
                         setError(errorMsg);
                         setIsLoading(false);
+                        // Legacy callback (backwards compatibility)
                         options.onFailure?.(errorMsg);
+                        // Funnel-aligned callback (recommended)
+                        options.onPaymentFailed?.({
+                            code: 'PAYMENT_FAILED',
+                            message: errorMsg,
+                            payment: response.payment,
+                        });
                     },
                 });
             }
@@ -175,7 +244,13 @@ export function usePaymentQuery() {
             const errorMsg = _error instanceof Error ? _error.message : 'Payment failed';
             setError(errorMsg);
             setIsLoading(false);
+            // Legacy callback (backwards compatibility)
             options.onFailure?.(errorMsg);
+            // Funnel-aligned callback (recommended)
+            options.onPaymentFailed?.({
+                code: 'PAYMENT_PROCESSING_ERROR',
+                message: errorMsg,
+            });
             throw _error;
         }
     }, [paymentsResource, handlePaymentAction, startPolling]);
@@ -205,7 +280,13 @@ export function usePaymentQuery() {
             setIsLoading(false);
             const errorMsg = _error instanceof Error ? _error.message : 'Payment failed';
             setError(errorMsg);
+            // Legacy callback (backwards compatibility)
             options.onFailure?.(errorMsg);
+            // Funnel-aligned callback (recommended)
+            options.onPaymentFailed?.({
+                code: 'CARD_PAYMENT_ERROR',
+                message: errorMsg,
+            });
             throw _error;
         }
     }, [createCardPaymentInstrument, createSession, processPaymentDirect]);
@@ -223,7 +304,13 @@ export function usePaymentQuery() {
             setIsLoading(false);
             const errorMsg = _error instanceof Error ? _error.message : 'Apple Pay payment failed';
             setError(errorMsg);
+            // Legacy callback (backwards compatibility)
             options.onFailure?.(errorMsg);
+            // Funnel-aligned callback (recommended)
+            options.onPaymentFailed?.({
+                code: 'APPLE_PAY_ERROR',
+                message: errorMsg,
+            });
             throw _error;
         }
     }, [createApplePayPaymentInstrument, processPaymentDirect]);
@@ -238,7 +325,13 @@ export function usePaymentQuery() {
             setIsLoading(false);
             const errorMsg = _error instanceof Error ? _error.message : 'Payment failed';
             setError(errorMsg);
+            // Legacy callback (backwards compatibility)
             options.onFailure?.(errorMsg);
+            // Funnel-aligned callback (recommended)
+            options.onPaymentFailed?.({
+                code: 'PAYMENT_INSTRUMENT_ERROR',
+                message: errorMsg,
+            });
             throw _error;
         }
     }, [processPaymentDirect]);

package/dist/v2/react/providers/TagadaProvider.d.ts

@@ -1,23 +1,11 @@
 import { ReactNode } from 'react';
-import { PluginConfig, RawPluginConfig } from '../../../react/hooks/usePluginConfig';
+import { TagadaState } from '../../core/client';
+import { RawPluginConfig } from '../../core/utils/pluginConfig';
+import { Environment, EnvironmentConfig } from '../../core/types';
 import { ApiService } from '../../../react/services/apiService';
-import { AuthState, Currency, Customer, Environment, EnvironmentConfig, Locale, Session, Store } from '../../../react/types';
-import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits } from '../../../react/utils/money';
-interface TagadaContextValue {
-    auth: AuthState;
-    session: Session | null;
-    customer: Customer | null;
-    locale: Locale;
-    currency: Currency;
-    store: Store | null;
-    environment: EnvironmentConfig;
+import { formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency } from '../../../react/utils/money';
+interface TagadaContextValue extends TagadaState {
     apiService: ApiService;
-    isLoading: boolean;
-    isInitialized: boolean;
-    isSessionInitialized: boolean;
-    debugMode: boolean;
-    pluginConfig: PluginConfig;
-    pluginConfigLoading: boolean;
     debugCheckout: {
         isActive: boolean;
         data: any;
@@ -40,7 +28,7 @@ interface TagadaContextValue {
         notifyCheckoutChanged: () => Promise<void>;
         notifyOrderBumpChanged: () => Promise<void>;
         unregisterCheckoutRefresh: (refreshFn?: () => Promise<void>) => void;
-        unregisterOrderBumpRefresh: () => void;
+        unregisterOrderBumpRefresh: (refreshFn?: () => Promise<void>) => void;
     };
     money: {
         formatMoney: typeof formatMoney;
@@ -54,6 +42,11 @@ interface TagadaContextValue {
 }
 interface TagadaProviderProps {
     children: ReactNode;
+    /**
+     * Optional environment override.
+     * ⚠️ Leave undefined for automatic runtime detection (recommended).
+     * Only set this if you need to force a specific environment for testing.
+     */
     environment?: Environment;
     customApiConfig?: Partial<EnvironmentConfig>;
     debugMode?: boolean;
@@ -61,8 +54,7 @@ interface TagadaProviderProps {
     blockUntilSessionReady?: boolean;
     rawPluginConfig?: RawPluginConfig;
 }
-export declare function TagadaProvider({ children, environment, customApiConfig, debugMode, // Remove default, will be set based on environment
-localConfig, blockUntilSessionReady, // Default to new non-blocking behavior
-rawPluginConfig, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function TagadaProvider({ children, environment, customApiConfig, // Ignored for now in TagadaClient, or need to add support
+debugMode, localConfig, blockUntilSessionReady, rawPluginConfig, }: TagadaProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTagadaContext(): TagadaContextValue;
 export {};