@selwise/widget 0.0.1

package/dist/npm/esm/datalayer/user.js

@@ -0,0 +1,368 @@
+/**
+ * User Tracking Module
+ * Handles user operations tracking (signup, login, logout, profile updates)
+ */
+import { DATA_SOURCE, STORAGE_KEYS, SESSION_TTL_MS } from './constants.js';
+import { testModeLog } from '../utils/logger.js';
+export class UserTracker {
+    constructor(config) {
+        this.userState = null;
+        this.userStorageKey = `${STORAGE_KEYS.DATA_LAYER_STATE}_user`;
+        this.config = config;
+        this.sessionStartTime = Date.now();
+        this.loadUserState();
+        this.initSessionStart();
+    }
+    /**
+     * Initialize session start time
+     */
+    initSessionStart() {
+        try {
+            const stored = sessionStorage.getItem(STORAGE_KEYS.SESSION_START);
+            if (!stored) {
+                sessionStorage.setItem(STORAGE_KEYS.SESSION_START, Date.now().toString());
+            }
+            else {
+                this.sessionStartTime = parseInt(stored, 10);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /**
+     * Load user state from sessionStorage
+     */
+    loadUserState() {
+        try {
+            const stored = sessionStorage.getItem(this.userStorageKey);
+            if (stored) {
+                const parsed = JSON.parse(stored);
+                // Check if session is still valid
+                const now = Date.now();
+                if (now - parsed.lastUpdate < SESSION_TTL_MS) {
+                    this.userState = parsed;
+                    this.log('Loaded user state:', this.userState);
+                }
+                else {
+                    // Session expired, clear state
+                    sessionStorage.removeItem(this.userStorageKey);
+                }
+            }
+        }
+        catch (e) {
+            this.log('Failed to load user state:', e);
+        }
+    }
+    /**
+     * Save user state to sessionStorage
+     */
+    saveUserState() {
+        if (this.userState) {
+            try {
+                this.userState.lastUpdate = Date.now();
+                sessionStorage.setItem(this.userStorageKey, JSON.stringify(this.userState));
+            }
+            catch (e) {
+                this.log('Failed to save user state:', e);
+            }
+        }
+    }
+    /**
+     * Clear user state
+     */
+    clearUserState() {
+        this.userState = null;
+        try {
+            sessionStorage.removeItem(this.userStorageKey);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /**
+     * Hash email for privacy (simple SHA-256 using crypto.subtle if available)
+     */
+    async hashEmail(email) {
+        // Normalize email
+        const normalized = email.toLowerCase().trim();
+        // If SubtleCrypto is available, use SHA-256
+        if (window.crypto && window.crypto.subtle) {
+            try {
+                const encoder = new TextEncoder();
+                const data = encoder.encode(normalized);
+                const hashBuffer = await window.crypto.subtle.digest('SHA-256', data);
+                const hashArray = Array.from(new Uint8Array(hashBuffer));
+                return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+            }
+            catch {
+                // Fall through to simple encoding
+            }
+        }
+        // Fallback: simple base64 encoding (not cryptographically secure)
+        return btoa(normalized);
+    }
+    /**
+     * Track user signup event
+     */
+    async trackUserSignup(userData) {
+        if (!userData)
+            return;
+        const userId = userData.id;
+        const email = userData.email;
+        const hashedEmail = email ? await this.hashEmail(email) : undefined;
+        // Update user state
+        this.userState = {
+            userId,
+            email: hashedEmail,
+            loggedIn: true,
+            newCustomer: userData.newCustomer ?? true,
+            customerSince: userData.customerSince || new Date().toISOString(),
+            lastUpdate: Date.now(),
+        };
+        this.saveUserState();
+        // Call tracker.identify to link user with visitor
+        if (userId) {
+            this.config.tracker.identify(userId, {
+                email: hashedEmail,
+                fullName: userData.fullName,
+                firstName: userData.firstName,
+                lastName: userData.lastName,
+                newCustomer: true,
+            });
+        }
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: window.location.href,
+            referrer: document.referrer,
+            timestamp: Date.now(),
+            userId,
+            email: hashedEmail,
+            fullName: userData.fullName,
+            firstName: userData.firstName,
+            lastName: userData.lastName,
+            gender: userData.gender,
+            age: userData.age,
+            birthday: userData.birthday,
+            newCustomer: true,
+            method: userData.method,
+        };
+        this.config.tracker.track('user_signup', {
+            entityType: 'user',
+            entityId: userId || 'unknown',
+            metadata,
+        });
+        this.log('Tracked user_signup:', userId, metadata);
+    }
+    /**
+     * Track user login event
+     */
+    async trackUserLogin(userData) {
+        if (!userData)
+            return;
+        const userId = userData.id;
+        const email = userData.email;
+        const hashedEmail = email ? await this.hashEmail(email) : undefined;
+        // Update user state
+        this.userState = {
+            userId,
+            email: hashedEmail,
+            loggedIn: true,
+            newCustomer: userData.newCustomer ?? false,
+            customerSince: userData.customerSince,
+            lastUpdate: Date.now(),
+        };
+        this.saveUserState();
+        // Call tracker.identify to link user with visitor
+        if (userId) {
+            this.config.tracker.identify(userId, {
+                email: hashedEmail,
+                fullName: userData.fullName,
+                firstName: userData.firstName,
+                lastName: userData.lastName,
+                newCustomer: userData.newCustomer,
+            });
+        }
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: window.location.href,
+            referrer: document.referrer,
+            timestamp: Date.now(),
+            userId,
+            email: hashedEmail,
+            fullName: userData.fullName,
+            firstName: userData.firstName,
+            lastName: userData.lastName,
+            gender: userData.gender,
+            loggedIn: true,
+            method: userData.method,
+        };
+        this.config.tracker.track('user_login', {
+            entityType: 'user',
+            entityId: userId || 'unknown',
+            metadata,
+        });
+        this.log('Tracked user_login:', userId, metadata);
+    }
+    /**
+     * Track user logout event
+     */
+    trackUserLogout(userData) {
+        const userId = userData?.id || this.userState?.userId;
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: window.location.href,
+            referrer: document.referrer,
+            timestamp: Date.now(),
+            userId,
+            sessionDuration: Date.now() - this.sessionStartTime,
+        };
+        this.config.tracker.track('user_logout', {
+            entityType: 'user',
+            entityId: userId || 'unknown',
+            metadata,
+        });
+        this.log('Tracked user_logout:', userId, metadata);
+        // Clear user state but keep session
+        this.clearUserState();
+        // Reset session start time
+        this.sessionStartTime = Date.now();
+        try {
+            sessionStorage.setItem(STORAGE_KEYS.SESSION_START, Date.now().toString());
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /**
+     * Track user profile update event
+     */
+    async trackUserUpdate(userData) {
+        if (!userData)
+            return;
+        const userId = userData.id || this.userState?.userId;
+        const email = userData.email;
+        const hashedEmail = email ? await this.hashEmail(email) : undefined;
+        // Update user state
+        if (this.userState) {
+            if (userId)
+                this.userState.userId = userId;
+            if (hashedEmail)
+                this.userState.email = hashedEmail;
+            this.userState.lastUpdate = Date.now();
+            this.saveUserState();
+        }
+        const metadata = {
+            dataSource: DATA_SOURCE,
+            pageUrl: window.location.href,
+            referrer: document.referrer,
+            timestamp: Date.now(),
+            userId,
+            email: hashedEmail,
+            fullName: userData.fullName,
+            firstName: userData.firstName,
+            lastName: userData.lastName,
+            gender: userData.gender,
+            age: userData.age,
+            birthday: userData.birthday,
+            updateFields: userData.updateFields,
+        };
+        this.config.tracker.track('user_update', {
+            entityType: 'user',
+            entityId: userId || 'unknown',
+            metadata,
+        });
+        this.log('Tracked user_update:', userId, metadata);
+        // Re-identify with updated data
+        if (userId) {
+            this.config.tracker.identify(userId, {
+                email: hashedEmail,
+                fullName: userData.fullName,
+                firstName: userData.firstName,
+                lastName: userData.lastName,
+            });
+        }
+    }
+    /**
+     * Track general user data (without specific event)
+     */
+    async trackUserData(userData) {
+        if (!userData)
+            return;
+        // If user is logged in, treat as login/update
+        if (userData.loggedIn === true) {
+            if (userData.step === 'signup') {
+                await this.trackUserSignup(userData);
+            }
+            else if (!this.userState?.userId || this.userState.userId !== userData.id) {
+                await this.trackUserLogin(userData);
+            }
+            else {
+                await this.trackUserUpdate(userData);
+            }
+        }
+    }
+    /**
+     * Get current user state
+     */
+    getUserState() {
+        return this.userState;
+    }
+    /**
+     * Check if user is logged in
+     */
+    isLoggedIn() {
+        return this.userState?.loggedIn ?? false;
+    }
+    /**
+     * Get user ID
+     */
+    getUserId() {
+        return this.userState?.userId;
+    }
+    /**
+     * Get session duration
+     */
+    getSessionDuration() {
+        return Date.now() - this.sessionStartTime;
+    }
+    /**
+     * Process a data layer event for user tracking
+     */
+    async processDataLayer(data) {
+        if (!data.user) {
+            this.log('No user data in event:', data.event);
+            return;
+        }
+        switch (data.event) {
+            case 'user_signup':
+                await this.trackUserSignup(data.user);
+                break;
+            case 'user_login':
+                await this.trackUserLogin(data.user);
+                break;
+            case 'user_logout':
+                this.trackUserLogout(data.user);
+                break;
+            case 'user_update':
+                await this.trackUserUpdate(data.user);
+                break;
+            default:
+                await this.trackUserData(data.user);
+        }
+    }
+    /**
+     * Log in debug mode
+     */
+    log(...args) {
+        testModeLog('UserTracker', ...args);
+    }
+    /**
+     * Cleanup
+     */
+    destroy() {
+        // Keep user state in storage for next page load
+        // Don't clear on destroy
+    }
+}
+//# sourceMappingURL=user.js.map

package/dist/npm/esm/datalayer/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../../src/datalayer/user.ts"],"names":[],"mappings":"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"}

package/dist/npm/esm/debug/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Widget debug information
+ */
+export interface WidgetDebugInfo {
+    id: string;
+    name: string;
+    type: string;
+    rendered: boolean;
+    eligibilityChecks: EligibilityCheck[];
+    recommendationInfo?: RecommendationDebugInfo;
+    loadTime: number;
+    renderTime: number;
+}
+/**
+ * Eligibility check result
+ */
+export interface EligibilityCheck {
+    check: string;
+    passed: boolean;
+    reason?: string;
+    details?: any;
+}
+/**
+ * Recommendation debug information
+ */
+export interface RecommendationDebugInfo {
+    strategy: string;
+    productCount: number;
+    appliedRules: string[];
+    excludedProducts: {
+        productId: string;
+        reason: string;
+    }[];
+    fallbackUsed?: boolean;
+    fallbackReason?: string;
+}
+/**
+ * Segment debug information
+ */
+export interface SegmentDebugInfo {
+    segmentId: string;
+    segmentName: string;
+    matched: boolean;
+    type: 'static' | 'dynamic' | 'predictive';
+    rules?: any;
+}
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    totalLoadTime: number;
+    configFetchTime: number;
+    segmentEvalTime: number;
+    renderTime: number;
+}
+/**
+ * DebugOverlay
+ *
+ * Provides a visual debug overlay for development and troubleshooting.
+ * Activate by setting localStorage.setItem('selwise_debug', 'true')
+ */
+export declare class DebugOverlay {
+    private enabled;
+    private container;
+    private widgetDebugData;
+    private segmentDebugData;
+    private performanceMetrics;
+    constructor();
+    /**
+     * Check if debug mode is enabled
+     */
+    private checkDebugMode;
+    /**
+     * Check if debug mode is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Enable debug mode
+     */
+    enable(): void;
+    /**
+     * Disable debug mode
+     */
+    disable(): void;
+    /**
+     * Toggle debug mode
+     */
+    toggle(): void;
+    /**
+     * Log widget debug info
+     */
+    logWidget(info: WidgetDebugInfo): void;
+    /**
+     * Log segment debug info
+     */
+    logSegment(info: SegmentDebugInfo): void;
+    /**
+     * Log performance metrics
+     */
+    logPerformance(metrics: PerformanceMetrics): void;
+    /**
+     * Create or update the debug overlay
+     */
+    createOverlay(): void;
+    /**
+     * Remove the debug overlay
+     */
+    private removeOverlay;
+    /**
+     * Get overlay HTML
+     */
+    private getOverlayHTML;
+    /**
+     * Get overview tab HTML
+     */
+    private getOverviewHTML;
+    /**
+     * Get widgets tab HTML
+     */
+    private getWidgetsHTML;
+    /**
+     * Get single widget HTML
+     */
+    private getWidgetHTML;
+    /**
+     * Get eligibility check HTML
+     */
+    private getCheckHTML;
+    /**
+     * Get recommendation debug HTML
+     */
+    private getRecommendationHTML;
+    /**
+     * Get segments tab HTML
+     */
+    private getSegmentsHTML;
+    /**
+     * Get single segment HTML
+     */
+    private getSegmentHTML;
+    /**
+     * Get performance tab HTML
+     */
+    private getPerformanceHTML;
+    /**
+     * Add CSS styles for the debug overlay
+     */
+    private addStyles;
+    /**
+     * Get CSS styles
+     */
+    private getStyles;
+    /**
+     * Add event listeners for the overlay
+     */
+    private addEventListeners;
+    /**
+     * Switch to a different tab
+     */
+    private switchTab;
+    /**
+     * Show a message in console
+     */
+    private show;
+}
+/**
+ * Get the singleton DebugOverlay instance
+ */
+export declare function getDebugOverlay(): DebugOverlay;
+/**
+ * Initialize debug overlay if debug mode is enabled
+ */
+export declare function initDebugOverlay(): DebugOverlay;