@tagadapay/plugin-sdk 3.0.12 → 3.0.14

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

@@ -87,9 +87,9 @@ export function useCheckoutQuery(options = {}) {
             await refetch();
         }
     }, [refetch, checkoutToken]);
-    // Initialize checkout mutation
+    // Initialize checkout mutation (async mode for fast response)
     const initMutation = useMutation({
-        mutationFn: (params) => {
+        mutationFn: async (params) => {
             const requestBody = {
                 ...params,
                 storeId: params.storeId || storeId,
@@ -101,7 +101,12 @@ export function useCheckoutQuery(options = {}) {
                     currency: params.customer?.currency ?? currency.code,
                 },
             };
-            return checkoutResource.initCheckout(requestBody);
+            // Use async mode for fast response (~50ms vs 2-5s)
+            const asyncResponse = await checkoutResource.initCheckoutAsync(requestBody);
+            return {
+                checkoutToken: asyncResponse.checkoutToken,
+                checkoutSession: {}, // Will be populated when getCheckout is called
+            };
         },
         onSuccess: (response) => {
             // Update URL with checkout token
@@ -257,9 +262,12 @@ export function useCheckoutQuery(options = {}) {
             await waitForSession();
             const result = await initMutation.mutateAsync(params);
             // Update internal token state so the query can fetch the checkout data
+            // The query will automatically refetch when token changes, and getCheckout()
+            // will automatically wait for async completion (via SDK skipAsyncWait=false)
             setInternalToken(result.checkoutToken);
+            // Return immediately with token
+            // checkoutSession will be populated by the query once background processing completes
             return {
-                checkoutUrl: result.checkoutUrl,
                 checkoutSession: checkout?.checkoutSession ?? {},
                 checkoutToken: result.checkoutToken,
             };

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

@@ -339,12 +339,31 @@ export function useFunnel(options = {}) {
         onSuccess: (result) => {
             if (!context)
                 return;
+            // 🔥 Fire-and-forget mode: Just acknowledge, no navigation
+            if (result.queued) {
+                // Update session ID if changed
+                if (result.sessionId && result.sessionId !== context.sessionId) {
+                    const newContext = {
+                        ...context,
+                        sessionId: result.sessionId,
+                    };
+                    const enrichedContext = enrichContext(newContext);
+                    setContext(enrichedContext);
+                    document.cookie = `funnelSessionId=${result.sessionId}; path=/; max-age=86400; SameSite=Lax`;
+                }
+                return; // Early return for fire-and-forget
+            }
             // 🔄 Handle session recovery (if backend created a new session)
             let recoveredSessionId;
             if (result.sessionId && result.sessionId !== context.sessionId) {
                 console.warn(`🔄 Funnel: Session recovered! Old: ${context.sessionId}, New: ${result.sessionId}`);
                 recoveredSessionId = result.sessionId;
             }
+            // Validate required fields for normal navigation
+            if (!result.stepId) {
+                console.warn('Funnel: Navigation result missing stepId');
+                return;
+            }
             // Update local context
             const newContext = {
                 ...context,
@@ -366,13 +385,13 @@ export function useFunnel(options = {}) {
                 document.cookie = `funnelSessionId=${recoveredSessionId}; path=/; max-age=86400; SameSite=Lax`;
                 console.log(`🍪 Funnel: Updated cookie with recovered session ID: ${recoveredSessionId}`);
             }
-            // Create typed navigation result
+            // Create typed navigation result (only if we have URL)
             const navigationResult = {
                 stepId: result.stepId,
-                action: {
+                action: result.url ? {
                     type: 'redirect', // Default action type
                     url: result.url
-                },
+                } : undefined,
                 context: enrichedContext,
                 tracking: result.tracking
             };
@@ -384,18 +403,27 @@ export function useFunnel(options = {}) {
                     shouldPerformDefaultNavigation = false;
                 }
             }
-            // Perform default navigation if not overridden
-            if (shouldPerformDefaultNavigation && navigationResult.action.url) {
-                // Add URL parameters for cross-domain session continuity
-                const urlWithParams = addSessionParams(navigationResult.action.url, enrichedContext.sessionId, effectiveFunnelId || options.funnelId);
-                const updatedAction = { ...navigationResult.action, url: urlWithParams };
-                performNavigation(updatedAction);
+            // Perform default navigation if not overridden and we have an action with URL
+            if (shouldPerformDefaultNavigation && navigationResult.action?.url) {
+                const action = navigationResult.action; // Type narrowing
+                const actionUrl = action.url; // Extract URL for type narrowing
+                if (actionUrl) {
+                    // Add URL parameters for cross-domain session continuity
+                    const urlWithParams = addSessionParams(actionUrl, enrichedContext.sessionId, effectiveFunnelId || options.funnelId);
+                    const updatedAction = {
+                        type: action.type || 'redirect', // Ensure type is defined
+                        url: urlWithParams,
+                        data: action.data,
+                    };
+                    performNavigation(updatedAction);
+                }
             }
             // Skip background refreshes if we are navigating away (full page reload)
             // This prevents "lingering" requests from the old page context
+            const action = navigationResult.action;
             const isFullNavigation = shouldPerformDefaultNavigation &&
-                navigationResult.action.url &&
-                (navigationResult.action.type === 'redirect' || navigationResult.action.type === 'replace');
+                action?.url &&
+                (action.type === 'redirect' || action.type === 'replace');
             if (!isFullNavigation) {
                 // Fetch debug data if in debug mode
                 if (debugMode) {

package/dist/v2/react/hooks/usePreviewOffer.d.ts

@@ -76,9 +76,9 @@ export interface UsePreviewOfferResult {
         checkoutUrl: string;
     }>;
     toCheckout: (mainOrderId?: string) => Promise<{
-        checkoutSessionId?: string;
-        checkoutToken?: string;
-        checkoutUrl: string;
+        checkoutToken: string;
+        customerId: string;
+        status: 'processing';
     }>;
 }
 export declare function usePreviewOffer(options: UsePreviewOfferOptions): UsePreviewOfferResult;

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

@@ -7,12 +7,16 @@
  * 3. Recalculating totals on-the-fly without backend calls
  * 4. NO checkout session creation - perfect for browsing/previewing
  */
-import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useQuery } from '@tanstack/react-query';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { OffersResource } from '../../core/resources/offers';
 import { getGlobalApiClient } from './useApiQuery';
 export function usePreviewOffer(options) {
     const { offerId, currency: requestedCurrency = 'USD', initialSelections = {} } = options;
+    const queryParamsCurrency = typeof window !== 'undefined'
+        ? new URLSearchParams(window.location.search).get('currency') || undefined
+        : undefined;
+    const effectiveCurrency = queryParamsCurrency || requestedCurrency;
     const offersResource = useMemo(() => new OffersResource(getGlobalApiClient()), []);
     // Track user selections (variant + quantity per product)
     const [selections, setSelections] = useState(initialSelections);
@@ -35,14 +39,14 @@ export function usePreviewOffer(options) {
     }, [selections]);
     // 🎯 ONE API CALL - Fetch offer + preview in one request
     const { data, isLoading, isFetching, error } = useQuery({
-        queryKey: ['offer-preview', offerId, requestedCurrency, lineItemsForPreview],
+        queryKey: ['offer-preview', offerId, effectiveCurrency, lineItemsForPreview],
         queryFn: async () => {
             console.log('🔍 [usePreviewOffer] Fetching preview:', {
                 offerId,
-                currency: requestedCurrency,
+                currency: effectiveCurrency,
                 lineItems: lineItemsForPreview,
             });
-            const result = await offersResource.previewOffer(offerId, requestedCurrency, lineItemsForPreview);
+            const result = await offersResource.previewOffer(offerId, effectiveCurrency, lineItemsForPreview);
             console.log('✅ [usePreviewOffer] Preview result:', result);
             // Extract offer and preview from unified response
             const offer = result.offer || null;
@@ -66,7 +70,7 @@ export function usePreviewOffer(options) {
                 totalAmount: preview.totalAmount || 0,
                 totalAdjustedAmount: preview.totalAdjustedAmount || 0,
                 totalPromotionAmount: preview.totalPromotionAmount || 0,
-                currency: preview.currency || requestedCurrency,
+                currency: preview.currency || effectiveCurrency,
                 options: preview.options || {},
             };
             return { offer, summary };
@@ -200,7 +204,7 @@ export function usePreviewOffer(options) {
             return [];
         const currentItem = summary.items.find((i) => i.productId === productId);
         const activePriceId = currentItem?.priceId;
-        const currency = summary.currency || requestedCurrency;
+        const currency = summary.currency || effectiveCurrency;
         return summary.options[productId].map((variant) => {
             // Find matching price or use first
             let unitAmount = 0;
@@ -222,7 +226,7 @@ export function usePreviewOffer(options) {
                 currency,
             };
         });
-    }, [summary, requestedCurrency]);
+    }, [summary, effectiveCurrency]);
     // Pay for the offer with current selections
     const pay = useCallback(async (mainOrderId) => {
         if (isPaying) {
@@ -230,7 +234,7 @@ export function usePreviewOffer(options) {
         }
         setIsPaying(true);
         try {
-            const result = await offersResource.payPreviewedOffer(offerId, requestedCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId);
+            const result = await offersResource.payPreviewedOffer(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId);
             console.log('[usePreviewOffer] Payment initiated:', result);
             return {
                 checkoutUrl: result.checkout.checkoutUrl,
@@ -243,20 +247,21 @@ export function usePreviewOffer(options) {
         finally {
             setIsPaying(false);
         }
-    }, [offerId, requestedCurrency, lineItemsForPreview, offersResource, isPaying]);
-    // Create checkout session without paying (for landing pages)
+    }, [offerId, effectiveCurrency, lineItemsForPreview, offersResource, isPaying]);
+    // Create checkout session without paying (for landing pages) - async mode for fast response
     const toCheckout = useCallback(async (mainOrderId) => {
         if (isPaying) {
             throw new Error('Operation already in progress');
         }
         setIsPaying(true);
         try {
-            const result = await offersResource.toCheckout(offerId, requestedCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId);
-            console.log('[usePreviewOffer] Checkout session created:', result);
+            // Use async mode for fast response (~50ms vs 2-5s)
+            const result = await offersResource.toCheckoutAsync(offerId, effectiveCurrency, lineItemsForPreview, typeof window !== 'undefined' ? window.location.href : undefined, mainOrderId);
+            console.log('[usePreviewOffer] Checkout session created (async):', result);
             return {
-                checkoutSessionId: result.checkoutSessionId,
                 checkoutToken: result.checkoutToken,
-                checkoutUrl: result.checkoutUrl,
+                customerId: result.customerId,
+                status: result.status,
             };
         }
         catch (error) {
@@ -266,7 +271,7 @@ export function usePreviewOffer(options) {
         finally {
             setIsPaying(false);
         }
-    }, [offerId, requestedCurrency, lineItemsForPreview, offersResource, isPaying]);
+    }, [offerId, effectiveCurrency, lineItemsForPreview, offersResource, isPaying]);
     return {
         offer,
         isLoading,

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

@@ -54,19 +54,27 @@ export const useTranslation = (options = {}) => {
     const { defaultLanguage = 'en', currentLanguage } = options;
     // Get the current language from query params, browser, or fallback to default
     const locale = useMemo(() => {
+        // Normalizes language codes like 'fr-FR' or 'pt_BR' to just 'fr' / 'pt'
+        const normalizeLanguageCode = (code) => {
+            if (!code)
+                return undefined;
+            return code.split(/[-_]/)[0].toLowerCase();
+        };
         if (currentLanguage)
             return currentLanguage;
         // Check for language query parameter
         if (typeof window !== 'undefined') {
             const urlParams = new URLSearchParams(window.location.search);
             const langFromQuery = urlParams.get('locale');
-            if (langFromQuery)
-                return langFromQuery;
+            const normalizedFromQuery = normalizeLanguageCode(langFromQuery);
+            if (normalizedFromQuery)
+                return normalizedFromQuery;
         }
         // Try to get browser language
         if (typeof navigator !== 'undefined') {
-            const browserLang = navigator.language.split('-')[0]; // e.g., 'en-US' -> 'en'
-            return browserLang;
+            const browserLang = normalizeLanguageCode(navigator.language); // e.g., 'en-US' -> 'en'
+            if (browserLang)
+                return browserLang;
         }
         return defaultLanguage;
     }, [defaultLanguage, currentLanguage]);

package/dist/v2/standalone/index.d.ts

@@ -8,12 +8,13 @@
  */
 import { TagadaClient, TagadaClientConfig, TagadaState } from '../core/client';
 import { ApiClient } from '../core/resources/apiClient';
+import { CheckoutResource } from '../core/resources/checkout';
 /**
  * Factory function to create a Tagada Client instance.
  * Features (like funnel) can be toggled via the config.
  */
 export declare function createTagadaClient(config?: TagadaClientConfig): TagadaClient;
-export { TagadaClient, ApiClient };
+export { TagadaClient, ApiClient, CheckoutResource };
 export type { TagadaClientConfig, TagadaState };
 export { FunnelActionType } from '../core/resources/funnel';
 export type { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../core/resources/funnel';

package/dist/v2/standalone/index.js

@@ -8,6 +8,7 @@
  */
 import { TagadaClient } from '../core/client';
 import { ApiClient } from '../core/resources/apiClient';
+import { CheckoutResource } from '../core/resources/checkout';
 /**
  * Factory function to create a Tagada Client instance.
  * Features (like funnel) can be toggled via the config.
@@ -16,7 +17,7 @@ export function createTagadaClient(config = {}) {
     return new TagadaClient(config);
 }
 // Re-export Core Classes
-export { TagadaClient, ApiClient };
+export { TagadaClient, ApiClient, CheckoutResource };
 export { FunnelActionType } from '../core/resources/funnel';
 // Re-export Utilities
 export * from '../core/utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "3.0.12",
+  "version": "3.0.14",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -73,7 +73,9 @@
     "@basis-theory/basis-theory-react": "^1.32.5",
     "@basis-theory/web-threeds": "^1.0.1",
     "@google-pay/button-react": "^3.0.10",
+    "@tagadapay/plugin-sdk": "link:",
     "@tanstack/react-query": "^5.90.2",
+    "@ua-parser-js/pro-enterprise": "^2.0.6",
     "axios": "^1.10.0",
     "iso3166-2-db": "^2.3.11",
     "path-to-regexp": "^8.2.0",