@tagadapay/plugin-sdk 3.0.9 → 3.0.14

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

@@ -1,16 +1,27 @@
 export interface DeviceInfo {
     userAgent: {
+        name: string;
         browser: {
+            major: string;
             name: string;
             version: string;
+            type?: string;
         };
         os: {
             name: string;
             version: string;
         };
         device?: {
-            type: string;
-            model: string;
+            model?: string;
+            type?: string;
+            vendor?: string;
+        };
+        engine: {
+            name: string;
+            version: string;
+        };
+        cpu: {
+            architecture: string;
         };
     };
     screenResolution: {
@@ -18,13 +29,19 @@ export interface DeviceInfo {
         height: number;
     };
     timeZone: string;
+    flags?: {
+        isBot: boolean;
+        isChromeFamily: boolean;
+        isStandalonePWA: boolean;
+        isAppleSilicon: boolean;
+    };
 }
 /**
  * Get browser locale
  */
 export declare function getBrowserLocale(): string;
 /**
- * Collect all device information
+ * Collect all device information using UAParser
  */
 export declare function collectDeviceInfo(): DeviceInfo;
 /**

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/components/DebugDrawer.js

@@ -79,6 +79,7 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
     const [activeTab, setActiveTab] = useState('overview');
     const [runningScripts, setRunningScripts] = useState(new Set());
     const [scriptResults, setScriptResults] = useState({});
+    const [expandedScriptCategories, setExpandedScriptCategories] = useState({});
     // Handler to jump to a specific step using direct_navigation
     const handleJumpToStep = async (stepId, stepName) => {
         // Try to get sessionId from debug data or context
@@ -187,8 +188,9 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
         const script = context.debugScripts?.find((s) => s.id === scriptId);
         if (!script)
             return;
+        // Clear previous script results so only the current script shows a status
+        setScriptResults({});
         setRunningScripts((prev) => new Set(prev).add(scriptId));
-        setScriptResults((prev) => ({ ...prev, [scriptId]: undefined }));
         try {
             await script.run(context);
             setScriptResults((prev) => ({
@@ -733,51 +735,71 @@ export const DebugDrawer = ({ isOpen, onClose }) => {
                                                 acc[category].push(script);
                                                 return acc;
                                             }, {});
-                                            return Object.entries(grouped).map(([category, scripts]) => (_jsxs("div", { children: [_jsx("div", { style: {
-                                                            fontSize: '11px',
-                                                            color: '#9ca3af',
-                                                            fontWeight: 'bold',
-                                                            marginBottom: '8px',
-                                                            textTransform: 'uppercase',
-                                                            letterSpacing: '0.5px',
-                                                        }, children: category }), _jsx("div", { style: { display: 'grid', gap: '8px' }, children: scripts.map((script) => {
-                                                            const isRunning = runningScripts.has(script.id);
-                                                            const result = scriptResults[script.id];
-                                                            return (_jsxs("div", { style: {
-                                                                    border: '1px solid #374151',
-                                                                    borderRadius: '6px',
-                                                                    padding: '10px 12px',
-                                                                    backgroundColor: '#111827',
-                                                                }, children: [_jsxs("div", { style: {
-                                                                            display: 'flex',
-                                                                            justifyContent: 'space-between',
-                                                                            alignItems: 'flex-start',
-                                                                            gap: '12px',
-                                                                        }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: {
-                                                                                            color: '#f9fafb',
-                                                                                            fontWeight: 'bold',
-                                                                                            fontSize: '12px',
-                                                                                            marginBottom: '4px',
-                                                                                        }, children: script.name }), script.description && (_jsx("div", { style: { fontSize: '11px', color: '#9ca3af' }, children: script.description }))] }), _jsx("button", { onClick: () => handleRunScript(script.id), disabled: isRunning, style: {
-                                                                                    backgroundColor: isRunning ? '#374151' : '#3b82f6',
-                                                                                    color: '#fff',
-                                                                                    border: 'none',
-                                                                                    borderRadius: '4px',
-                                                                                    padding: '6px 12px',
-                                                                                    fontSize: '11px',
-                                                                                    fontWeight: 'bold',
-                                                                                    cursor: isRunning ? 'not-allowed' : 'pointer',
-                                                                                    transition: 'background-color 0.2s',
-                                                                                    minWidth: '60px',
-                                                                                }, children: isRunning ? '⏳' : '▶ Run' })] }), result && (_jsxs("div", { style: {
-                                                                            marginTop: '8px',
-                                                                            padding: '6px 8px',
-                                                                            borderRadius: '4px',
-                                                                            fontSize: '10px',
-                                                                            backgroundColor: result.success ? '#065f46' : '#7f1d1d',
-                                                                            color: result.success ? '#6ee7b7' : '#fca5a5',
-                                                                        }, children: [result.success ? '✅' : '❌', " ", result.message] }))] }, script.id));
-                                                        }) })] }, category)));
+                                            return Object.entries(grouped).map(([category, scripts]) => {
+                                                const isExpanded = expandedScriptCategories[category] ?? false;
+                                                const toggleCategory = () => {
+                                                    setExpandedScriptCategories((prev) => ({
+                                                        ...prev,
+                                                        [category]: !(prev[category] ?? false),
+                                                    }));
+                                                };
+                                                return (_jsxs("div", { children: [_jsx("button", { type: "button", onClick: toggleCategory, style: {
+                                                                display: 'flex',
+                                                                alignItems: 'center',
+                                                                justifyContent: 'space-between',
+                                                                width: '100%',
+                                                                background: 'none',
+                                                                border: 'none',
+                                                                padding: '6px 0',
+                                                                cursor: 'pointer',
+                                                            }, children: _jsxs("div", { style: {
+                                                                    display: 'flex',
+                                                                    alignItems: 'center',
+                                                                    gap: '6px',
+                                                                    fontSize: '11px',
+                                                                    fontWeight: 'bold',
+                                                                    textTransform: 'uppercase',
+                                                                    letterSpacing: '0.5px',
+                                                                    color: '#9ca3af',
+                                                                }, children: [_jsx("span", { style: { fontSize: '10px' }, children: isExpanded ? '▼' : '▶' }), _jsx("span", { children: category }), _jsxs("span", { style: { fontSize: '10px', color: '#6b7280' }, children: ["(", scripts.length, ")"] })] }) }), isExpanded && (_jsx("div", { style: { display: 'grid', gap: '8px', marginTop: '4px' }, children: scripts.map((script) => {
+                                                                const isRunning = runningScripts.has(script.id);
+                                                                const result = scriptResults[script.id];
+                                                                return (_jsxs("div", { style: {
+                                                                        border: '1px solid #374151',
+                                                                        borderRadius: '6px',
+                                                                        padding: '10px 12px',
+                                                                        backgroundColor: '#111827',
+                                                                    }, children: [_jsxs("div", { style: {
+                                                                                display: 'flex',
+                                                                                justifyContent: 'space-between',
+                                                                                alignItems: 'flex-start',
+                                                                                gap: '12px',
+                                                                            }, children: [_jsxs("div", { style: { flex: 1 }, children: [_jsx("div", { style: {
+                                                                                                color: '#f9fafb',
+                                                                                                fontWeight: 'bold',
+                                                                                                fontSize: '12px',
+                                                                                                marginBottom: '4px',
+                                                                                            }, children: script.name }), script.description && (_jsx("div", { style: { fontSize: '11px', color: '#9ca3af' }, children: script.description }))] }), _jsx("button", { onClick: () => handleRunScript(script.id), disabled: isRunning, style: {
+                                                                                        backgroundColor: isRunning ? '#374151' : '#3b82f6',
+                                                                                        color: '#fff',
+                                                                                        border: 'none',
+                                                                                        borderRadius: '4px',
+                                                                                        padding: '6px 12px',
+                                                                                        fontSize: '11px',
+                                                                                        fontWeight: 'bold',
+                                                                                        cursor: isRunning ? 'not-allowed' : 'pointer',
+                                                                                        transition: 'background-color 0.2s',
+                                                                                        minWidth: '60px',
+                                                                                    }, children: isRunning ? '⏳' : '▶ Run' })] }), result && (_jsxs("div", { style: {
+                                                                                marginTop: '8px',
+                                                                                padding: '6px 8px',
+                                                                                borderRadius: '4px',
+                                                                                fontSize: '10px',
+                                                                                backgroundColor: result.success ? '#065f46' : '#7f1d1d',
+                                                                                color: result.success ? '#6ee7b7' : '#fca5a5',
+                                                                            }, children: [result.success ? '✅' : '❌', " ", result.message] }))] }, script.id));
+                                                            }) }))] }, category));
+                                            });
                                         })() })) : (_jsx("p", { style: { color: '#6b7280' }, children: "No debug scripts available" }))] })), activeTab === 'raw' && (_jsxs("div", { children: [_jsx("h3", { style: { margin: '0 0 16px 0', color: '#60a5fa' }, children: "Raw Context Data" }), _jsx("div", { style: { fontSize: '12px' }, children: _jsx(TreeView, { data: context, name: "tagadaContext", maxLevel: 4 }) })] }))] })] })] }));
 };
 export default DebugDrawer;

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;