@tagadapay/plugin-sdk 3.0.2 → 3.0.9

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.2",
+  "version": "3.0.9",
   "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;
-};