@tagadapay/plugin-sdk 3.0.12 → 3.0.15

package/dist/v2/core/utils/deviceInfo.js

@@ -1,91 +1,5 @@
-/**
- * Get basic browser information from user agent
- */
-function getBrowserInfo() {
-    const userAgent = navigator.userAgent;
-    // Chrome
-    if (userAgent.includes('Chrome')) {
-        const match = /Chrome\/(\d+)/.exec(userAgent);
-        return { name: 'Chrome', version: match ? match[1] : 'unknown' };
-    }
-    // Firefox
-    if (userAgent.includes('Firefox')) {
-        const match = /Firefox\/(\d+)/.exec(userAgent);
-        return { name: 'Firefox', version: match ? match[1] : 'unknown' };
-    }
-    // Safari
-    if (userAgent.includes('Safari') && !userAgent.includes('Chrome')) {
-        const match = /Version\/(\d+)/.exec(userAgent);
-        return { name: 'Safari', version: match ? match[1] : 'unknown' };
-    }
-    // Edge
-    if (userAgent.includes('Edge')) {
-        const match = /Edge\/(\d+)/.exec(userAgent);
-        return { name: 'Edge', version: match ? match[1] : 'unknown' };
-    }
-    return { name: 'unknown', version: 'unknown' };
-}
-/**
- * Get basic OS information from user agent
- */
-function getOSInfo() {
-    const userAgent = navigator.userAgent;
-    // Windows
-    if (userAgent.includes('Windows')) {
-        if (userAgent.includes('Windows NT 10.0'))
-            return { name: 'Windows', version: '10' };
-        if (userAgent.includes('Windows NT 6.3'))
-            return { name: 'Windows', version: '8.1' };
-        if (userAgent.includes('Windows NT 6.2'))
-            return { name: 'Windows', version: '8' };
-        if (userAgent.includes('Windows NT 6.1'))
-            return { name: 'Windows', version: '7' };
-        return { name: 'Windows', version: 'unknown' };
-    }
-    // macOS
-    if (userAgent.includes('Mac OS X')) {
-        const match = /Mac OS X (\d+[._]\d+)/.exec(userAgent);
-        return { name: 'macOS', version: match ? match[1].replace('_', '.') : 'unknown' };
-    }
-    // iOS
-    if (userAgent.includes('iPhone') || userAgent.includes('iPad')) {
-        const match = /OS (\d+[._]\d+)/.exec(userAgent);
-        return { name: 'iOS', version: match ? match[1].replace('_', '.') : 'unknown' };
-    }
-    // Android
-    if (userAgent.includes('Android')) {
-        const match = /Android (\d+[.\d]*)/.exec(userAgent);
-        return { name: 'Android', version: match ? match[1] : 'unknown' };
-    }
-    // Linux
-    if (userAgent.includes('Linux')) {
-        return { name: 'Linux', version: 'unknown' };
-    }
-    return { name: 'unknown', version: 'unknown' };
-}
-/**
- * Get device information
- */
-function getDeviceInfo() {
-    const userAgent = navigator.userAgent;
-    // Mobile devices
-    if (userAgent.includes('iPhone')) {
-        return { type: 'mobile', model: 'iPhone' };
-    }
-    if (userAgent.includes('iPad')) {
-        return { type: 'tablet', model: 'iPad' };
-    }
-    if (userAgent.includes('Android')) {
-        if (userAgent.includes('Mobile')) {
-            return { type: 'mobile', model: 'Android' };
-        }
-        else {
-            return { type: 'tablet', model: 'Android' };
-        }
-    }
-    // Desktop (no specific device info)
-    return undefined;
-}
+import { UAParser } from '@ua-parser-js/pro-enterprise';
+import { isBot, isChromeFamily, isStandalonePWA, isAppleSilicon, } from '@ua-parser-js/pro-enterprise/helpers';
 /**
  * Get screen resolution
  */
@@ -120,28 +34,82 @@ export function getBrowserLocale() {
     }
 }
 /**
- * Collect all device information
+ * Collect all device information using UAParser
  */
 export function collectDeviceInfo() {
     if (typeof window === 'undefined') {
         // Server-side fallback
         return {
             userAgent: {
-                browser: { name: 'unknown', version: 'unknown' },
-                os: { name: 'unknown', version: 'unknown' },
+                name: '',
+                browser: { major: '', name: '', version: '' },
+                os: { name: '', version: '' },
+                device: undefined,
+                engine: { name: '', version: '' },
+                cpu: { architecture: '' },
             },
             screenResolution: { width: 0, height: 0 },
             timeZone: 'UTC',
+            flags: {
+                isBot: false,
+                isChromeFamily: false,
+                isStandalonePWA: false,
+                isAppleSilicon: false,
+            },
+        };
+    }
+    const parser = new UAParser();
+    const result = parser.getResult();
+    // Enhanced detection using UAParser official helpers
+    let flags;
+    try {
+        flags = {
+            isBot: isBot(result),
+            isChromeFamily: isChromeFamily(result),
+            isStandalonePWA: isStandalonePWA(),
+            isAppleSilicon: isAppleSilicon(result),
+        };
+    }
+    catch (error) {
+        console.error('Failed to compute device flags:', error);
+        flags = {
+            isBot: false,
+            isChromeFamily: false,
+            isStandalonePWA: false,
+            isAppleSilicon: false,
         };
     }
     return {
         userAgent: {
-            browser: getBrowserInfo(),
-            os: getOSInfo(),
-            device: getDeviceInfo(),
+            name: result.ua,
+            browser: {
+                major: result.browser.major || '',
+                name: result.browser.name || '',
+                version: result.browser.version || '',
+                type: result.browser.type,
+            },
+            os: {
+                name: result.os.name || '',
+                version: result.os.version || '',
+            },
+            device: result.device.model || result.device.type || result.device.vendor
+                ? {
+                    model: result.device.model,
+                    type: result.device.type,
+                    vendor: result.device.vendor,
+                }
+                : undefined,
+            engine: {
+                name: result.engine.name || '',
+                version: result.engine.version || '',
+            },
+            cpu: {
+                architecture: result.cpu.architecture || '',
+            },
         },
         screenResolution: getScreenResolution(),
         timeZone: getTimeZone(),
+        flags,
     };
 }
 /**

package/dist/v2/core/utils/previewMode.d.ts

@@ -13,6 +13,9 @@
  * - token: Authentication token (URL > localStorage)
  * - funnelSessionId: Active funnel session (URL > cookie)
  *
+ * ⚠️ Note: authCode is NOT handled here - it has highest priority and is handled
+ * separately in client.ts before all other initialization logic.
+ *
  * Usage examples:
  * - Force production API: ?tagadaClientEnv=production
  * - Force development API: ?tagadaClientEnv=development
@@ -20,6 +23,7 @@
  * - Custom API URL: ?tagadaClientBaseUrl=https://tagada.loclx.io
  * - Combined: ?tagadaClientEnv=local&tagadaClientBaseUrl=https://tagada.loclx.io
  * - Hard reset + production: ?forceReset=true&tagadaClientEnv=production
+ * - Cross-domain auth: ?authCode=ah_... (automatically handled, highest priority)
  */
 /**
  * SDK Override Parameters - centralized across all SDK functions

package/dist/v2/core/utils/previewMode.js

@@ -13,6 +13,9 @@
  * - token: Authentication token (URL > localStorage)
  * - funnelSessionId: Active funnel session (URL > cookie)
  *
+ * ⚠️ Note: authCode is NOT handled here - it has highest priority and is handled
+ * separately in client.ts before all other initialization logic.
+ *
  * Usage examples:
  * - Force production API: ?tagadaClientEnv=production
  * - Force development API: ?tagadaClientEnv=development
@@ -20,6 +23,7 @@
  * - Custom API URL: ?tagadaClientBaseUrl=https://tagada.loclx.io
  * - Combined: ?tagadaClientEnv=local&tagadaClientBaseUrl=https://tagada.loclx.io
  * - Hard reset + production: ?forceReset=true&tagadaClientEnv=production
+ * - Cross-domain auth: ?authCode=ah_... (automatically handled, highest priority)
  */
 import { clearClientToken, setClientToken, getClientToken } from './tokenStorage';
 import { clearFunnelSessionCookie } from './sessionStorage';

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

@@ -13,7 +13,6 @@ export interface UseCheckoutQueryResult {
     error: Error | null;
     isSuccess: boolean;
     init: (params: CheckoutInitParams) => Promise<{
-        checkoutUrl: string;
         checkoutSession: any;
         checkoutToken: string;
     }>;

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/react/providers/TagadaProvider.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * TagadaProvider - Main provider component for the Tagada Pay React SDK
  */
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
 import { ApiService } from '../../../react/services/apiService';
 import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from '../../../react/utils/money';
 import { TagadaClient } from '../../core/client';
@@ -211,6 +211,8 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
         formatSimpleMoney,
     }), []);
     const [isDebugDrawerOpen, setIsDebugDrawerOpen] = useState(false);
+    // Track last injected script to prevent duplicate execution
+    const lastInjectedScriptRef = useRef(null);
     // Funnel Methods
     const funnelMethods = useMemo(() => {
         if (!client.funnel) {
@@ -283,6 +285,63 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
             },
         };
     }, [client, state.auth.session, state.store, funnelId, onNavigate]);
+    // Inject funnel script into the page
+    useEffect(() => {
+        // Only run in browser environment
+        if (typeof document === 'undefined') {
+            return;
+        }
+        const scriptContent = funnelState.context?.script;
+        const scriptId = 'tagada-funnel-script';
+        if (!scriptContent || !scriptContent.trim()) {
+            // Clear ref if script is removed
+            lastInjectedScriptRef.current = null;
+            // Remove existing script if it exists
+            const existingScript = document.getElementById(scriptId);
+            if (existingScript) {
+                existingScript.remove();
+            }
+            return;
+        }
+        // Extract script content (remove <script> tags if present)
+        let scriptBody = scriptContent.trim();
+        // Check if script is wrapped in <script> tags
+        const scriptTagMatch = scriptBody.match(/^<script[^>]*>([\s\S]*)<\/script>$/i);
+        if (scriptTagMatch) {
+            scriptBody = scriptTagMatch[1].trim();
+        }
+        // Skip if script body is empty after extraction
+        if (!scriptBody) {
+            return;
+        }
+        // Prevent duplicate injection of the same script content
+        // This handles React StrictMode double-execution in development
+        if (lastInjectedScriptRef.current === scriptBody) {
+            return;
+        }
+        // Remove existing script if it exists (for script updates)
+        const existingScript = document.getElementById(scriptId);
+        if (existingScript) {
+            existingScript.remove();
+        }
+        // Create and inject new script element
+        const scriptElement = document.createElement('script');
+        scriptElement.id = scriptId;
+        scriptElement.textContent = scriptBody;
+        document.body.appendChild(scriptElement);
+        // Track this script content to prevent re-injection (handles React StrictMode double-execution)
+        lastInjectedScriptRef.current = scriptBody;
+        // Cleanup: remove script element but keep ref to prevent re-injection on StrictMode second run
+        return () => {
+            const scriptToRemove = document.getElementById(scriptId);
+            if (scriptToRemove) {
+                scriptToRemove.remove();
+            }
+            // Note: We intentionally DON'T clear lastInjectedScriptRef here
+            // This prevents React StrictMode from re-injecting the same script on the second run
+            // The ref will be cleared when script content actually changes (next effect run)
+        };
+    }, [funnelState.context?.script]);
     const contextValue = {
         client,
         ...state,
@@ -301,6 +360,7 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
         refreshCoordinator,
         money: moneyUtils,
     };
+    console.log('contextValue', contextValue, contextValue.funnel.currentStep);
     // Query Client
     const [queryClient] = useState(() => new QueryClient({
         defaultOptions: {

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.15",
   "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",