@tagadapay/plugin-sdk 3.0.3 → 3.0.12

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, useRef, useState, } from 'react';
+import { createContext, useCallback, useContext, useEffect, useMemo, 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';
@@ -51,6 +51,9 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
             (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development');
     // Initialize client
     const client = useMemo(() => {
+        // Merge features with defaults, ensuring autoRedirect is always false in provider
+        const mergedFeatures = features ?? { funnel: true };
+        const funnelFeature = mergedFeatures.funnel;
         const config = {
             environment,
             customApiConfig,
@@ -58,9 +61,21 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
             localConfig,
             rawPluginConfig,
             blockUntilSessionReady,
-            // For now we always enable funnel by default; callers can disable via features if needed
-            features: features ?? {
-                funnel: true,
+            features: {
+                ...mergedFeatures,
+                funnel: typeof funnelFeature === 'object'
+                    ? {
+                        ...funnelFeature,
+                        // Always disable auto-redirect in core because we handle it in the provider
+                        // to set pendingRedirect state and prevent UI flashes
+                        autoRedirect: false,
+                    }
+                    : funnelFeature === false
+                        ? false
+                        : {
+                            // Default: enable funnel with auto-redirect disabled
+                            autoRedirect: false,
+                        },
             },
         };
         return new TagadaClient(config);
@@ -70,6 +85,17 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
     useEffect(() => {
         return client.subscribe(setState);
     }, [client]);
+    // Listen for config hot-reload updates
+    useEffect(() => {
+        const cleanup = client.bus.on('CONFIG_UPDATED', () => {
+            // Force re-render when config is updated
+            setState(client.getState());
+            if (state.debugMode) {
+                console.log('[TagadaProvider] Config updated, re-rendering...');
+            }
+        });
+        return cleanup;
+    }, [client, state.debugMode]);
     // Cleanup client on unmount
     useEffect(() => {
         return () => {
@@ -151,39 +177,29 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
             lastUpdated: new Date(),
         });
     }, []);
-    // Refresh Coordinator
-    const checkoutRefreshRefs = useRef(new Set());
-    const orderBumpRefreshRefs = useRef(new Set());
+    // Refresh Coordinator (backed by EventBus in core)
     const refreshCoordinator = useMemo(() => ({
         registerCheckoutRefresh: (refreshFn, name) => {
-            checkoutRefreshRefs.current.add(refreshFn);
+            client.bus.on('CHECKOUT_REFRESH', refreshFn);
         },
         registerOrderBumpRefresh: (refreshFn) => {
-            orderBumpRefreshRefs.current.add(refreshFn);
+            client.bus.on('ORDER_BUMP_REFRESH', refreshFn);
         },
         notifyCheckoutChanged: async () => {
-            if (orderBumpRefreshRefs.current.size > 0) {
-                await Promise.all(Array.from(orderBumpRefreshRefs.current).map((fn) => fn().catch(console.warn)));
-            }
+            await client.bus.emit('ORDER_BUMP_REFRESH'); // Notify bumps that checkout changed? Wait logic
         },
         notifyOrderBumpChanged: async () => {
-            if (checkoutRefreshRefs.current.size > 0) {
-                await Promise.all(Array.from(checkoutRefreshRefs.current).map((fn) => fn().catch(console.warn)));
-            }
+            await client.bus.emit('CHECKOUT_REFRESH'); // Notify checkout that bumps changed
         },
         unregisterCheckoutRefresh: (refreshFn) => {
             if (refreshFn)
-                checkoutRefreshRefs.current.delete(refreshFn);
-            else
-                checkoutRefreshRefs.current.clear();
+                client.bus.off('CHECKOUT_REFRESH', refreshFn);
         },
         unregisterOrderBumpRefresh: (refreshFn) => {
             if (refreshFn)
-                orderBumpRefreshRefs.current.delete(refreshFn);
-            else
-                orderBumpRefreshRefs.current.clear();
+                client.bus.off('ORDER_BUMP_REFRESH', refreshFn);
         },
-    }), []);
+    }), [client]);
     // Money Utils
     const moneyUtils = useMemo(() => ({
         formatMoney,
@@ -212,8 +228,8 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
                 refetch: noopAsync,
             };
         }
-        const next = async (event) => {
-            const result = await client.funnel.navigate(event);
+        // Helper to handle navigation result with optional auto-redirect
+        const handleNavigationResult = (result) => {
             // Call custom onNavigate handler if provided
             let shouldAutoRedirect = true;
             if (onNavigate) {
@@ -230,22 +246,23 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
                 setPendingRedirect(true);
                 window.location.href = result.url;
             }
+        };
+        const next = async (event) => {
+            const result = await client.funnel.navigate(event);
+            handleNavigationResult(result);
             return result;
         };
         const goToStep = async (stepId) => {
-            return await next({
-                type: 'DIRECT_NAVIGATION',
-                data: { targetStepId: stepId },
-            });
+            const result = await client.funnel.goToStep(stepId);
+            handleNavigationResult(result);
+            return result;
         };
-        // Helper to resolve accountId with fallbacks
-        const getAccountId = () => state.store?.accountId || state.pluginConfig?.accountId || state.session?.accountId || '';
         return {
             next,
             goToStep,
             updateContext: (updates) => client.funnel.updateContext(updates),
             initializeSession: async (entryStepId) => {
-                const accountId = getAccountId();
+                const accountId = client.getAccountId();
                 if (!accountId || !state.auth.session || !state.store) {
                     throw new Error('Cannot initialize funnel: missing required data (accountId, session, or store)');
                 }
@@ -253,7 +270,7 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
             },
             endSession: () => client.funnel.endSession(),
             retryInitialization: () => {
-                const accountId = getAccountId();
+                const accountId = client.getAccountId();
                 if (!accountId || !state.auth.session || !state.store) {
                     return Promise.reject(new Error('Cannot retry initialization: missing required data'));
                 }

package/dist/v2/standalone/external-tracker.d.ts

@@ -0,0 +1,119 @@
+/**
+ * TagadaPay External Page Tracker
+ *
+ * A lightweight standalone script for tracking users on external pages
+ * that are part of a Tagadapay funnel but not hosted on the Tagadapay platform.
+ *
+ * ARCHITECTURE:
+ * - Reuses core SDK infrastructure (TagadaClient) for authentication and API handling
+ * - All tracking handled automatically by funnelOrchestrator via autoInitialize() and navigate()
+ * - No separate tracking endpoints needed - unified tracking through orchestrator
+ *
+ * Usage (via CDN):
+ * <script src="https://cdn.jsdelivr.net/npm/@tagadapay/plugin-sdk/dist/external-tracker.min.js"></script>
+ * <script>
+ *   TagadaTracker.init({
+ *     storeId: 'store_xxx',
+ *     accountId: 'acc_xxx',
+ *     funnelId: 'funnel_xxx',  // Optional: detected from URL
+ *     stepId: 'step_xxx',
+ *     stepName: 'External Offer Page',
+ *     stepType: 'external'
+ *   });
+ *
+ *   // Navigate to next step (tracking automatic)
+ *   TagadaTracker.navigate({
+ *     eventType: 'form.submitted',
+ *     eventData: { email: 'user@example.com' }
+ *   });
+ * </script>
+ */
+import type { TagadaClient } from '../core/client';
+export interface TagadaTrackerConfig {
+    /** Store ID (required) */
+    storeId: string;
+    /** Account ID (required for session init) */
+    accountId?: string;
+    /** Funnel ID (optional - can be extracted from URL param) */
+    funnelId?: string;
+    /**
+     * Step ID (REQUIRED for external pages)
+     *
+     * External URLs cannot be mapped to steps via URL matching (only works for Tagadapay-hosted pages).
+     * You must explicitly specify which step this external page represents.
+     */
+    stepId: string;
+    /** Step name (optional - for analytics/debugging) */
+    stepName?: string;
+    /** Step type (optional - e.g., 'landing', 'offer', 'external') */
+    stepType?: string;
+    /** API base URL (defaults to production) */
+    apiBaseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Callback when session is ready */
+    onReady?: (session: ExternalTrackerSession) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+}
+export interface ExternalTrackerSession {
+    sessionId: string;
+    customerId: string;
+    storeId: string;
+    funnelId?: string;
+    currentStepId?: string;
+    cmsToken?: string;
+}
+export interface NavigateOptions {
+    /** Event type for navigation (e.g., 'offer.accepted', 'form.submitted') */
+    eventType: string;
+    /** Event data */
+    eventData?: Record<string, unknown>;
+    /** Override return URL */
+    returnUrl?: string;
+}
+declare class TagadaExternalTracker {
+    private config;
+    private client;
+    private initialized;
+    private initializing;
+    /**
+     * Initialize the tracker using SDK infrastructure
+     */
+    init(config: TagadaTrackerConfig): Promise<ExternalTrackerSession | null>;
+    /**
+     * Get current session from SDK state
+     */
+    getSession(): ExternalTrackerSession | null;
+    /**
+     * Check if tracker is ready
+     */
+    isReady(): boolean;
+    /**
+     * Navigate to next step in funnel using SDK's funnel client
+     */
+    navigate(options: NavigateOptions): Promise<{
+        url: string;
+    } | null>;
+    /**
+     * Get customer ID (for identifying the user)
+     */
+    getCustomerId(): string | null;
+    /**
+     * Get funnel session ID
+     */
+    getFunnelSessionId(): string | null;
+    /**
+     * Build a URL with funnel context parameters
+     * Useful for linking to other external pages while preserving session
+     */
+    buildUrl(baseUrl: string, additionalParams?: Record<string, string>): string;
+    /**
+     * Get the underlying SDK client (for advanced usage)
+     */
+    getClient(): TagadaClient | null;
+    private waitForClientReady;
+    private initializeFunnel;
+}
+declare const TagadaTracker: TagadaExternalTracker;
+export { TagadaTracker, TagadaExternalTracker };

package/dist/v2/standalone/external-tracker.js

@@ -0,0 +1,260 @@
+/**
+ * TagadaPay External Page Tracker
+ *
+ * A lightweight standalone script for tracking users on external pages
+ * that are part of a Tagadapay funnel but not hosted on the Tagadapay platform.
+ *
+ * ARCHITECTURE:
+ * - Reuses core SDK infrastructure (TagadaClient) for authentication and API handling
+ * - All tracking handled automatically by funnelOrchestrator via autoInitialize() and navigate()
+ * - No separate tracking endpoints needed - unified tracking through orchestrator
+ *
+ * Usage (via CDN):
+ * <script src="https://cdn.jsdelivr.net/npm/@tagadapay/plugin-sdk/dist/external-tracker.min.js"></script>
+ * <script>
+ *   TagadaTracker.init({
+ *     storeId: 'store_xxx',
+ *     accountId: 'acc_xxx',
+ *     funnelId: 'funnel_xxx',  // Optional: detected from URL
+ *     stepId: 'step_xxx',
+ *     stepName: 'External Offer Page',
+ *     stepType: 'external'
+ *   });
+ *
+ *   // Navigate to next step (tracking automatic)
+ *   TagadaTracker.navigate({
+ *     eventType: 'form.submitted',
+ *     eventData: { email: 'user@example.com' }
+ *   });
+ * </script>
+ */
+import { createTagadaClient } from './index';
+import { setClientToken } from '../core/utils/tokenStorage';
+// ============================================================================
+// UTILITIES
+// ============================================================================
+function getUrlParam(name) {
+    if (typeof window === 'undefined')
+        return null;
+    const params = new URLSearchParams(window.location.search);
+    return params.get(name);
+}
+function log(debug, ...args) {
+    if (debug) {
+        console.log('[TagadaTracker]', ...args);
+    }
+}
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+class TagadaExternalTracker {
+    constructor() {
+        this.config = null;
+        this.client = null;
+        this.initialized = false;
+        this.initializing = false;
+    }
+    /**
+     * Initialize the tracker using SDK infrastructure
+     */
+    async init(config) {
+        if (this.initialized || this.initializing) {
+            log(config.debug || false, 'Already initialized or initializing');
+            return this.getSession();
+        }
+        this.initializing = true;
+        this.config = {
+            debug: false,
+            ...config,
+        };
+        log(this.config.debug, '🚀 Initializing external tracker with SDK...', config);
+        try {
+            // 1. Check for token in URL and save to storage (bootstrap auth)
+            // TagadaClient will automatically pick it up from storage
+            const urlToken = getUrlParam('token');
+            if (urlToken) {
+                setClientToken(urlToken);
+                log(this.config.debug, '🔑 Bootstrapped token from URL');
+            }
+            // 2. Create TagadaClient
+            this.client = createTagadaClient({
+                debugMode: this.config.debug,
+                features: { funnel: true },
+            });
+            // 3. Wait for client to be ready (load token, init auth state)
+            await this.waitForClientReady();
+            // 4. Auto-initialize funnel session
+            // FunnelClient handles cookies, existing session restoration, etc.
+            // Orchestrator automatically tracks session start and step view
+            const funnelContext = await this.initializeFunnel();
+            log(this.config.debug, '✅ Session initialized (tracking handled by orchestrator):', funnelContext);
+            this.initialized = true;
+            const session = this.getSession();
+            if (session) {
+                this.config.onReady?.(session);
+            }
+            return session;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            log(this.config.debug, '❌ Initialization failed:', err);
+            this.config.onError?.(err);
+            throw err;
+        }
+        finally {
+            this.initializing = false;
+        }
+    }
+    /**
+     * Get current session from SDK state
+     */
+    getSession() {
+        if (!this.client?.funnel?.state.context)
+            return null;
+        const ctx = this.client.funnel.state.context;
+        return {
+            sessionId: ctx.sessionId,
+            customerId: ctx.customerId,
+            storeId: ctx.storeId,
+            funnelId: ctx.funnelId,
+            currentStepId: ctx.currentStepId,
+            cmsToken: this.client.state.token || undefined,
+        };
+    }
+    /**
+     * Check if tracker is ready
+     */
+    isReady() {
+        return this.initialized && !!this.client?.funnel?.state.context;
+    }
+    /**
+     * Navigate to next step in funnel using SDK's funnel client
+     */
+    async navigate(options) {
+        if (!this.isReady()) {
+            throw new Error('Tracker not initialized. Call init() first.');
+        }
+        log(this.config.debug, '🚀 Navigating:', options);
+        try {
+            const result = await this.client.funnel.navigate({
+                type: options.eventType,
+                data: options.eventData || {},
+            });
+            if (result?.url) {
+                log(this.config.debug, '✅ Navigation result:', result.url);
+                // Redirect to the next step
+                if (typeof window !== 'undefined') {
+                    window.location.href = options.returnUrl || result.url;
+                }
+                return { url: result.url };
+            }
+            return null;
+        }
+        catch (error) {
+            log(this.config.debug, '❌ Navigation failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get customer ID (for identifying the user)
+     */
+    getCustomerId() {
+        return this.client?.state.auth.customer?.id || this.client?.funnel?.state.context?.customerId || null;
+    }
+    /**
+     * Get funnel session ID
+     */
+    getFunnelSessionId() {
+        return this.client?.funnel?.state.context?.sessionId || null;
+    }
+    /**
+     * Build a URL with funnel context parameters
+     * Useful for linking to other external pages while preserving session
+     */
+    buildUrl(baseUrl, additionalParams) {
+        const session = this.getSession();
+        if (!session) {
+            return baseUrl;
+        }
+        const url = new URL(baseUrl, typeof window !== 'undefined' ? window.location.origin : undefined);
+        // Add funnel session context
+        url.searchParams.set('funnelSessionId', session.sessionId);
+        if (session.cmsToken) {
+            url.searchParams.set('token', session.cmsToken);
+        }
+        if (session.funnelId) {
+            url.searchParams.set('funnelId', session.funnelId);
+        }
+        url.searchParams.set('storeId', session.storeId);
+        // Add any additional params
+        if (additionalParams) {
+            Object.entries(additionalParams).forEach(([key, value]) => {
+                url.searchParams.set(key, value);
+            });
+        }
+        return url.toString();
+    }
+    /**
+     * Get the underlying SDK client (for advanced usage)
+     */
+    getClient() {
+        return this.client;
+    }
+    // ========================================================================
+    // PRIVATE METHODS
+    // ========================================================================
+    async waitForClientReady() {
+        if (!this.client)
+            return;
+        // Wait for token/auth to be resolved
+        return new Promise((resolve) => {
+            let retries = 0;
+            const checkReady = () => {
+                // Check if initialized OR if we have a token (sometimes isInitialized is lazy)
+                if (this.client?.state.isInitialized || this.client?.state.token) {
+                    resolve();
+                }
+                else if (retries > 40) { // 2 seconds timeout
+                    resolve(); // Proceed anyway (might be anonymous)
+                }
+                else {
+                    retries++;
+                    setTimeout(checkReady, 50);
+                }
+            };
+            checkReady();
+        });
+    }
+    async initializeFunnel() {
+        if (!this.client?.funnel)
+            return null;
+        // Prepare auth session object
+        const authSession = {
+            customerId: this.client.state.auth.customer?.id || 'anon_placeholder',
+            sessionId: this.client.state.auth.session?.sessionId || 'sess_placeholder',
+        };
+        const store = {
+            id: this.config.storeId,
+            accountId: this.config.accountId || '',
+        };
+        // IMPORTANT: For external pages, we must explicitly pass stepId as entryStepId
+        // because URL-to-step mapping won't work for external URLs not hosted on Tagadapay
+        const entryStepId = this.config.stepId;
+        if (!entryStepId) {
+            throw new Error('stepId is required for external page tracking (URL mapping does not work for external pages)');
+        }
+        log(this.config.debug, '🔍 Initializing external page at step:', entryStepId);
+        // Use initialize() (not autoInitialize()) to explicitly specify the step
+        // Orchestrator will automatically track session start and step view at this step
+        return this.client.funnel.initialize(authSession, store, this.config.funnelId || getUrlParam('funnelId') || undefined, entryStepId // ✅ Explicitly tell orchestrator which step we're on
+        );
+    }
+}
+// ============================================================================
+// GLOBAL INSTANCE
+// ============================================================================
+const TagadaTracker = new TagadaExternalTracker();
+export { TagadaTracker, TagadaExternalTracker };
+if (typeof window !== 'undefined') {
+    window.TagadaTracker = TagadaTracker;
+}

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

@@ -18,3 +18,5 @@ export type { TagadaClientConfig, TagadaState };
 export { FunnelActionType } from '../core/resources/funnel';
 export type { FunnelAction, FunnelNavigationResult, SimpleFunnelContext } from '../core/resources/funnel';
 export * from '../core/utils';
+export { TagadaTracker, TagadaExternalTracker, } from './external-tracker';
+export type { TagadaTrackerConfig, ExternalTrackerSession, NavigateOptions, } from './external-tracker';

package/dist/v2/standalone/index.js

@@ -20,3 +20,9 @@ export { TagadaClient, ApiClient };
 export { FunnelActionType } from '../core/resources/funnel';
 // Re-export Utilities
 export * from '../core/utils';
+// ============================================================================
+// EXTERNAL PAGE TRACKER
+// ============================================================================
+// Lightweight tracker for external pages not hosted on Tagadapay
+// NOTE: This is also available as a standalone CDN bundle (external-tracker.min.js)
+export { TagadaTracker, TagadaExternalTracker, } from './external-tracker';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "3.0.3",
+  "version": "3.0.12",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,10 +24,16 @@
       "types": "./dist/v2/standalone/index.d.ts",
       "import": "./dist/v2/standalone/index.js",
       "require": "./dist/v2/standalone/index.js"
+    },
+    "./external-tracker": {
+      "browser": "./dist/external-tracker.min.js",
+      "default": "./dist/external-tracker.min.js"
     }
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && npm run build:cdn",
+    "build:cdn": "node build-cdn.js",
+    "build:ts": "tsc",
     "clean": "rm -rf dist",
     "lint": "echo \"No linting configured\"",
     "test": "jest --no-watchman",
@@ -79,6 +85,7 @@
     "@types/node": "^18.0.0",
     "@types/react": "^19",
     "@types/react-dom": "^19",
+    "esbuild": "^0.24.2",
     "jest": "^29.5.0",
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
@@ -89,7 +96,8 @@
   },
   "files": [
     "dist/**/*",
-    "README.md"
+    "README.md",
+    "build-cdn.js"
   ],
   "repository": {
     "type": "git",

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

@@ -1,12 +0,0 @@
-export function useOffersQuery(options?: {}): {
-    offers: import("../../core/resources/offers").Offer[];
-    isLoading: boolean;
-    error: Error | null;
-    activeSummary: any;
-    isActiveSummaryLoading: boolean;
-    payOffer: (offerId: any, orderId: any) => Promise<void>;
-    preview: (offerId: any) => Promise<any>;
-    getAvailableVariants: (offerId: any, productId: any) => any;
-    selectVariant: (offerId: any, productId: any, variantId: any) => Promise<any>;
-    isLoadingVariants: (offerId: any, productId: any) => any;
-};