@seekora-ai/search-sdk 0.2.6 → 0.2.8

package/dist/src/context-collector.js

@@ -1,868 +0,0 @@
-"use strict";
-/**
- * Context Collector for Seekora SDK
- *
- * Collects browser context, device information, and fingerprinting
- * for enriching analytics events with comprehensive user environment data.
- *
- * Uses FingerprintJS Open Source for industry-standard device fingerprinting
- * with 50+ browser signals for high accuracy cross-session identification.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextCollector = void 0;
-exports.getDefaultContextCollector = getDefaultContextCollector;
-exports.collectBrowserContext = collectBrowserContext;
-let FingerprintJS = null;
-// Try to load FingerprintJS
-async function loadFingerprintJS() {
-    if (FingerprintJS)
-        return FingerprintJS;
-    try {
-        FingerprintJS = await Promise.resolve().then(() => __importStar(require('@fingerprintjs/fingerprintjs')));
-        return FingerprintJS;
-    }
-    catch {
-        // FingerprintJS not available, will fall back to manual implementation
-        return null;
-    }
-}
-/**
- * Default configuration
- * Fingerprinting is enabled by default with FingerprintJS for best accuracy
- */
-const DEFAULT_CONFIG = {
-    enableFingerprinting: true,
-    useFingerprintJS: true,
-    enableCanvasFingerprint: true,
-    enableWebGLFingerprint: true,
-    enableAudioFingerprint: false,
-    autoCollect: true,
-    cacheDuration: 30000,
-    fingerprintStorageKey: 'seekora_device_fp',
-    enableExtendedComponents: true,
-};
-/**
- * ContextCollector class for gathering browser and device context
- *
- * Uses FingerprintJS Open Source for industry-standard fingerprinting
- * with automatic fallback to manual implementation if unavailable.
- */
-class ContextCollector {
-    constructor(config = {}) {
-        this.cachedContext = null;
-        this.cacheTimestamp = 0;
-        this.cachedFingerprint = null;
-        this.fingerprintJSAgent = null;
-        this.fingerprintJSLoading = null;
-        this.usingFingerprintJS = false;
-        this.config = { ...DEFAULT_CONFIG, ...config };
-        // Load cached fingerprint from storage
-        if (this.config.enableFingerprinting) {
-            this.loadCachedFingerprint();
-            // Pre-load FingerprintJS agent for faster first fingerprint
-            if (this.config.useFingerprintJS && this.isBrowser()) {
-                this.initFingerprintJS();
-            }
-        }
-    }
-    /**
-     * Initialize FingerprintJS agent (async, non-blocking)
-     */
-    async initFingerprintJS() {
-        if (this.fingerprintJSAgent || this.fingerprintJSLoading)
-            return;
-        this.fingerprintJSLoading = (async () => {
-            try {
-                const fpjs = await loadFingerprintJS();
-                if (fpjs) {
-                    this.fingerprintJSAgent = await fpjs.load();
-                    this.usingFingerprintJS = true;
-                    console.debug('[Seekora] FingerprintJS initialized successfully');
-                }
-            }
-            catch (error) {
-                console.debug('[Seekora] FingerprintJS not available, using manual fingerprinting');
-            }
-            return this.fingerprintJSAgent;
-        })();
-        await this.fingerprintJSLoading;
-    }
-    /**
-     * Get FingerprintJS agent, waiting for initialization if needed
-     */
-    async getFingerprintJSAgent() {
-        if (this.fingerprintJSAgent)
-            return this.fingerprintJSAgent;
-        if (this.fingerprintJSLoading) {
-            await this.fingerprintJSLoading;
-            return this.fingerprintJSAgent;
-        }
-        await this.initFingerprintJS();
-        return this.fingerprintJSAgent;
-    }
-    /**
-     * Check if running in browser environment
-     */
-    isBrowser() {
-        return typeof window !== 'undefined' && typeof document !== 'undefined';
-    }
-    /**
-     * Collect complete browser context
-     */
-    async collect() {
-        // Return cached context if still valid
-        if (this.cachedContext && this.config.cacheDuration > 0) {
-            const elapsed = Date.now() - this.cacheTimestamp;
-            if (elapsed < this.config.cacheDuration) {
-                // Update dynamic fields that may have changed
-                this.cachedContext.document_visibility = this.getDocumentVisibility();
-                this.cachedContext.viewport_width = this.getViewportWidth();
-                this.cachedContext.viewport_height = this.getViewportHeight();
-                return this.cachedContext;
-            }
-        }
-        const context = await this.collectFresh();
-        // Cache the context
-        this.cachedContext = context;
-        this.cacheTimestamp = Date.now();
-        return context;
-    }
-    /**
-     * Collect fresh context without caching
-     */
-    async collectFresh() {
-        if (!this.isBrowser()) {
-            return this.getServerContext();
-        }
-        const utm = this.parseUTMParameters();
-        const connection = this.getConnectionInfo();
-        const browserInfo = this.parseBrowserInfo();
-        const context = {
-            // Screen dimensions
-            screen_width: screen.width || 0,
-            screen_height: screen.height || 0,
-            viewport_width: this.getViewportWidth(),
-            viewport_height: this.getViewportHeight(),
-            color_depth: screen.colorDepth || screen.pixelDepth || 24,
-            pixel_ratio: window.devicePixelRatio || 1,
-            // Browser information
-            browser_name: browserInfo.name,
-            browser_version: browserInfo.version,
-            browser_language: navigator.language || 'en',
-            browser_languages: Array.from(navigator.languages || [navigator.language || 'en']),
-            timezone: this.getTimezone(),
-            timezone_offset: new Date().getTimezoneOffset(),
-            // Page context
-            page_url: this.sanitizeUrl(window.location.href),
-            page_path: window.location.pathname,
-            page_title: document.title || '',
-            page_referrer: this.sanitizeUrl(document.referrer || ''),
-            document_visibility: this.getDocumentVisibility(),
-            // UTM parameters
-            ...utm,
-            // Connection information
-            ...connection,
-            // Platform detection
-            platform: this.detectPlatform(),
-            is_mobile: this.isMobile(),
-            is_tablet: this.isTablet(),
-            is_touch_device: this.isTouchDevice(),
-            hardware_concurrency: navigator.hardwareConcurrency,
-            max_touch_points: navigator.maxTouchPoints,
-            device_memory: navigator.deviceMemory,
-        };
-        // Generate fingerprint if enabled
-        if (this.config.enableFingerprinting) {
-            context.device_fingerprint = await this.getOrGenerateFingerprint();
-        }
-        return context;
-    }
-    /**
-     * Get server-side context (for Node.js environments)
-     */
-    getServerContext() {
-        return {
-            screen_width: 0,
-            screen_height: 0,
-            viewport_width: 0,
-            viewport_height: 0,
-            color_depth: 0,
-            pixel_ratio: 1,
-            browser_name: 'node',
-            browser_version: process.version || '',
-            browser_language: 'en',
-            browser_languages: ['en'],
-            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC',
-            timezone_offset: new Date().getTimezoneOffset(),
-            page_url: '',
-            page_path: '',
-            page_title: '',
-            page_referrer: '',
-            document_visibility: 'visible',
-            platform: process.platform || 'unknown',
-            is_mobile: false,
-            is_tablet: false,
-            is_touch_device: false,
-        };
-    }
-    /**
-     * Get viewport width
-     */
-    getViewportWidth() {
-        if (!this.isBrowser())
-            return 0;
-        return window.innerWidth || document.documentElement?.clientWidth || document.body?.clientWidth || 0;
-    }
-    /**
-     * Get viewport height
-     */
-    getViewportHeight() {
-        if (!this.isBrowser())
-            return 0;
-        return window.innerHeight || document.documentElement?.clientHeight || document.body?.clientHeight || 0;
-    }
-    /**
-     * Get document visibility state
-     */
-    getDocumentVisibility() {
-        if (!this.isBrowser())
-            return 'visible';
-        return document.visibilityState || 'visible';
-    }
-    /**
-     * Get timezone name
-     */
-    getTimezone() {
-        try {
-            return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
-        }
-        catch {
-            return 'UTC';
-        }
-    }
-    /**
-     * Parse UTM parameters from URL
-     */
-    parseUTMParameters() {
-        if (!this.isBrowser())
-            return {};
-        try {
-            const params = new URLSearchParams(window.location.search);
-            const result = {};
-            const utmSource = params.get('utm_source');
-            const utmMedium = params.get('utm_medium');
-            const utmCampaign = params.get('utm_campaign');
-            const utmTerm = params.get('utm_term');
-            const utmContent = params.get('utm_content');
-            if (utmSource)
-                result.utm_source = utmSource;
-            if (utmMedium)
-                result.utm_medium = utmMedium;
-            if (utmCampaign)
-                result.utm_campaign = utmCampaign;
-            if (utmTerm)
-                result.utm_term = utmTerm;
-            if (utmContent)
-                result.utm_content = utmContent;
-            // Also check referrer for UTM params (for cross-domain tracking)
-            if (Object.keys(result).length === 0 && document.referrer) {
-                try {
-                    const referrerUrl = new URL(document.referrer);
-                    const referrerParams = new URLSearchParams(referrerUrl.search);
-                    const refUtmSource = referrerParams.get('utm_source');
-                    const refUtmMedium = referrerParams.get('utm_medium');
-                    const refUtmCampaign = referrerParams.get('utm_campaign');
-                    const refUtmTerm = referrerParams.get('utm_term');
-                    const refUtmContent = referrerParams.get('utm_content');
-                    if (refUtmSource)
-                        result.utm_source = refUtmSource;
-                    if (refUtmMedium)
-                        result.utm_medium = refUtmMedium;
-                    if (refUtmCampaign)
-                        result.utm_campaign = refUtmCampaign;
-                    if (refUtmTerm)
-                        result.utm_term = refUtmTerm;
-                    if (refUtmContent)
-                        result.utm_content = refUtmContent;
-                }
-                catch {
-                    // Invalid referrer URL, ignore
-                }
-            }
-            return result;
-        }
-        catch {
-            return {};
-        }
-    }
-    /**
-     * Get connection information from Network Information API
-     */
-    getConnectionInfo() {
-        if (!this.isBrowser())
-            return {};
-        const connection = navigator.connection ||
-            navigator.mozConnection ||
-            navigator.webkitConnection;
-        if (!connection)
-            return {};
-        return {
-            connection_type: connection.type,
-            connection_effective_type: connection.effectiveType,
-            connection_downlink: connection.downlink,
-            connection_rtt: connection.rtt,
-        };
-    }
-    /**
-     * Parse browser name and version from user agent
-     */
-    parseBrowserInfo() {
-        if (!this.isBrowser()) {
-            return { name: 'node', version: process.version || '' };
-        }
-        const ua = navigator.userAgent;
-        let name = 'unknown';
-        let version = '';
-        // Order matters - check more specific browsers first
-        if (ua.includes('Firefox/')) {
-            name = 'firefox';
-            const match = ua.match(/Firefox\/(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        else if (ua.includes('Edg/')) {
-            name = 'edge';
-            const match = ua.match(/Edg\/(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        else if (ua.includes('OPR/') || ua.includes('Opera/')) {
-            name = 'opera';
-            const match = ua.match(/(?:OPR|Opera)\/(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        else if (ua.includes('Chrome/')) {
-            name = 'chrome';
-            const match = ua.match(/Chrome\/(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        else if (ua.includes('Safari/') && !ua.includes('Chrome')) {
-            name = 'safari';
-            const match = ua.match(/Version\/(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        else if (ua.includes('MSIE') || ua.includes('Trident/')) {
-            name = 'ie';
-            const match = ua.match(/(?:MSIE |rv:)(\d+\.?\d*)/);
-            version = match ? match[1] : '';
-        }
-        return { name, version };
-    }
-    /**
-     * Detect platform from user agent
-     */
-    detectPlatform() {
-        if (!this.isBrowser()) {
-            return process.platform || 'unknown';
-        }
-        const ua = navigator.userAgent.toLowerCase();
-        const platform = (navigator.platform || '').toLowerCase();
-        if (ua.includes('android'))
-            return 'android';
-        if (ua.includes('iphone') || ua.includes('ipad') || ua.includes('ipod'))
-            return 'ios';
-        if (platform.includes('mac') || ua.includes('mac os'))
-            return 'macos';
-        if (platform.includes('win') || ua.includes('windows'))
-            return 'windows';
-        if (platform.includes('linux') || ua.includes('linux'))
-            return 'linux';
-        if (ua.includes('cros'))
-            return 'chromeos';
-        return 'unknown';
-    }
-    /**
-     * Check if device is mobile
-     */
-    isMobile() {
-        if (!this.isBrowser())
-            return false;
-        const ua = navigator.userAgent.toLowerCase();
-        return /android|webos|iphone|ipod|blackberry|iemobile|opera mini|mobile/i.test(ua);
-    }
-    /**
-     * Check if device is tablet
-     */
-    isTablet() {
-        if (!this.isBrowser())
-            return false;
-        const ua = navigator.userAgent.toLowerCase();
-        return /ipad|tablet|playbook|silk/i.test(ua) ||
-            (ua.includes('android') && !ua.includes('mobile'));
-    }
-    /**
-     * Check if device supports touch
-     */
-    isTouchDevice() {
-        if (!this.isBrowser())
-            return false;
-        return 'ontouchstart' in window ||
-            navigator.maxTouchPoints > 0 ||
-            navigator.msMaxTouchPoints > 0;
-    }
-    /**
-     * Sanitize URL to remove sensitive query parameters
-     */
-    sanitizeUrl(url) {
-        if (!url)
-            return '';
-        try {
-            const urlObj = new URL(url);
-            const sensitiveParams = ['password', 'token', 'api_key', 'apikey', 'secret', 'auth', 'key'];
-            sensitiveParams.forEach(param => {
-                if (urlObj.searchParams.has(param)) {
-                    urlObj.searchParams.set(param, '[REDACTED]');
-                }
-            });
-            return urlObj.toString();
-        }
-        catch {
-            return url;
-        }
-    }
-    /**
-     * Load cached fingerprint from storage
-     */
-    loadCachedFingerprint() {
-        if (!this.isBrowser())
-            return;
-        try {
-            const stored = localStorage.getItem(this.config.fingerprintStorageKey);
-            if (stored) {
-                this.cachedFingerprint = stored;
-            }
-        }
-        catch {
-            // localStorage not available
-        }
-    }
-    /**
-     * Get or generate device fingerprint
-     */
-    async getOrGenerateFingerprint() {
-        // Return cached fingerprint if available
-        if (this.cachedFingerprint) {
-            return this.cachedFingerprint;
-        }
-        // Generate new fingerprint
-        const fingerprint = await this.generateFingerprint();
-        // Cache it
-        this.cachedFingerprint = fingerprint;
-        // Persist to localStorage
-        if (this.isBrowser()) {
-            try {
-                localStorage.setItem(this.config.fingerprintStorageKey, fingerprint);
-            }
-            catch {
-                // localStorage not available
-            }
-        }
-        return fingerprint;
-    }
-    /**
-     * Generate device fingerprint using FingerprintJS or manual fallback
-     *
-     * FingerprintJS provides ~99.5% accuracy with 50+ browser signals
-     * Manual fallback provides ~70% accuracy with 15+ signals
-     */
-    async generateFingerprint() {
-        // Try FingerprintJS first (preferred)
-        if (this.config.useFingerprintJS && this.isBrowser()) {
-            try {
-                const agent = await this.getFingerprintJSAgent();
-                if (agent) {
-                    const result = await agent.get();
-                    // FingerprintJS provides a visitorId (stable fingerprint)
-                    // and components (individual signals with confidence scores)
-                    console.debug('[Seekora] FingerprintJS fingerprint generated:', {
-                        visitorId: result.visitorId,
-                        confidence: result.confidence?.score,
-                        components: Object.keys(result.components || {}).length
-                    });
-                    return result.visitorId;
-                }
-            }
-            catch (error) {
-                console.debug('[Seekora] FingerprintJS failed, falling back to manual:', error);
-            }
-        }
-        // Fallback to manual fingerprinting
-        return this.generateManualFingerprint();
-    }
-    /**
-     * Generate fingerprint manually using browser characteristics
-     * Used as fallback when FingerprintJS is not available
-     */
-    async generateManualFingerprint() {
-        const components = [];
-        if (!this.isBrowser()) {
-            // Server-side fingerprint (limited)
-            components.push(process.platform || 'unknown', process.version || 'unknown', process.arch || 'unknown');
-            return this.hashComponents(components);
-        }
-        // Screen characteristics
-        components.push(screen.width, screen.height, screen.colorDepth, window.devicePixelRatio || 1, screen.availWidth || 0, screen.availHeight || 0);
-        // Browser characteristics
-        components.push(navigator.language, navigator.languages?.join(',') || '', navigator.hardwareConcurrency || 0, navigator.maxTouchPoints || 0, navigator.deviceMemory || 0, navigator.cookieEnabled ? 1 : 0, navigator.doNotTrack || '');
-        // Timezone
-        components.push(this.getTimezone());
-        // Platform
-        components.push(navigator.platform || '', navigator.vendor || '', navigator.userAgent || '');
-        // Plugins (limited info)
-        if (navigator.plugins) {
-            components.push(navigator.plugins.length);
-            // Add plugin names for extended fingerprinting
-            if (this.config.enableExtendedComponents) {
-                const pluginNames = Array.from(navigator.plugins)
-                    .map(p => p.name)
-                    .sort()
-                    .join(',');
-                components.push(pluginNames);
-            }
-        }
-        // Canvas fingerprint (if enabled)
-        if (this.config.enableCanvasFingerprint) {
-            const canvasHash = this.getCanvasFingerprint();
-            if (canvasHash) {
-                components.push(canvasHash);
-            }
-        }
-        // WebGL fingerprint (if enabled)
-        if (this.config.enableWebGLFingerprint) {
-            const webglHash = this.getWebGLFingerprint();
-            if (webglHash) {
-                components.push(webglHash);
-            }
-        }
-        // Audio fingerprint (if enabled)
-        if (this.config.enableAudioFingerprint) {
-            const audioHash = await this.getAudioFingerprint();
-            if (audioHash) {
-                components.push(audioHash);
-            }
-        }
-        // Extended components for higher uniqueness
-        if (this.config.enableExtendedComponents) {
-            // Add available fonts detection (simplified)
-            const fontHash = this.getFontFingerprint();
-            if (fontHash) {
-                components.push(fontHash);
-            }
-            // Add WebGL parameters
-            const webglParams = this.getWebGLParameters();
-            if (webglParams) {
-                components.push(webglParams);
-            }
-        }
-        return this.hashComponents(components);
-    }
-    /**
-     * Get audio fingerprint using AudioContext
-     */
-    async getAudioFingerprint() {
-        if (!this.isBrowser())
-            return null;
-        try {
-            const AudioContext = window.AudioContext || window.webkitAudioContext;
-            if (!AudioContext)
-                return null;
-            const context = new AudioContext();
-            const oscillator = context.createOscillator();
-            const analyser = context.createAnalyser();
-            const gain = context.createGain();
-            const processor = context.createScriptProcessor(4096, 1, 1);
-            oscillator.type = 'triangle';
-            oscillator.frequency.setValueAtTime(10000, context.currentTime);
-            gain.gain.setValueAtTime(0, context.currentTime);
-            oscillator.connect(analyser);
-            analyser.connect(processor);
-            processor.connect(gain);
-            gain.connect(context.destination);
-            oscillator.start(0);
-            const dataArray = new Float32Array(analyser.frequencyBinCount);
-            analyser.getFloatFrequencyData(dataArray);
-            oscillator.stop();
-            await context.close();
-            // Hash the audio data
-            const audioSum = dataArray.slice(0, 30).reduce((a, b) => a + Math.abs(b), 0);
-            return this.simpleHash(audioSum.toString());
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Get font fingerprint by testing font availability
-     */
-    getFontFingerprint() {
-        if (!this.isBrowser())
-            return null;
-        try {
-            const testFonts = [
-                'Arial', 'Courier New', 'Georgia', 'Helvetica', 'Times New Roman',
-                'Verdana', 'Comic Sans MS', 'Impact', 'Lucida Console', 'Tahoma',
-                'Trebuchet MS', 'Palatino Linotype', 'Century Gothic', 'Garamond'
-            ];
-            const canvas = document.createElement('canvas');
-            const ctx = canvas.getContext('2d');
-            if (!ctx)
-                return null;
-            const testString = 'mmmmmmmmmmlli';
-            const baseFont = 'monospace';
-            ctx.font = `72px ${baseFont}`;
-            const baseWidth = ctx.measureText(testString).width;
-            const availableFonts = [];
-            for (const font of testFonts) {
-                ctx.font = `72px "${font}", ${baseFont}`;
-                const width = ctx.measureText(testString).width;
-                if (width !== baseWidth) {
-                    availableFonts.push(font);
-                }
-            }
-            return this.simpleHash(availableFonts.join(','));
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Get additional WebGL parameters for fingerprinting
-     */
-    getWebGLParameters() {
-        if (!this.isBrowser())
-            return null;
-        try {
-            const canvas = document.createElement('canvas');
-            const gl = canvas.getContext('webgl') || canvas.getContext('experimental-webgl');
-            if (!gl)
-                return null;
-            const params = [
-                gl.getParameter(gl.MAX_VERTEX_ATTRIBS),
-                gl.getParameter(gl.MAX_VERTEX_UNIFORM_VECTORS),
-                gl.getParameter(gl.MAX_VARYING_VECTORS),
-                gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS),
-                gl.getParameter(gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS),
-                gl.getParameter(gl.MAX_TEXTURE_IMAGE_UNITS),
-                gl.getParameter(gl.MAX_FRAGMENT_UNIFORM_VECTORS),
-                gl.getParameter(gl.MAX_CUBE_MAP_TEXTURE_SIZE),
-                gl.getParameter(gl.MAX_RENDERBUFFER_SIZE),
-                gl.getParameter(gl.MAX_VIEWPORT_DIMS)?.toString() || ''
-            ];
-            return this.simpleHash(params.join(','));
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Get canvas fingerprint
-     */
-    getCanvasFingerprint() {
-        if (!this.isBrowser())
-            return null;
-        try {
-            const canvas = document.createElement('canvas');
-            const ctx = canvas.getContext('2d');
-            if (!ctx)
-                return null;
-            canvas.width = 200;
-            canvas.height = 50;
-            // Draw text with various styles
-            ctx.textBaseline = 'top';
-            ctx.font = '14px Arial';
-            ctx.fillStyle = '#f60';
-            ctx.fillRect(125, 1, 62, 20);
-            ctx.fillStyle = '#069';
-            ctx.fillText('Seekora SDK', 2, 15);
-            ctx.fillStyle = 'rgba(102, 204, 0, 0.7)';
-            ctx.fillText('Canvas FP', 4, 17);
-            // Get data URL and hash it
-            const dataUrl = canvas.toDataURL();
-            return this.simpleHash(dataUrl);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Get WebGL fingerprint
-     */
-    getWebGLFingerprint() {
-        if (!this.isBrowser())
-            return null;
-        try {
-            const canvas = document.createElement('canvas');
-            const gl = canvas.getContext('webgl') || canvas.getContext('experimental-webgl');
-            if (!gl)
-                return null;
-            const debugInfo = gl.getExtension('WEBGL_debug_renderer_info');
-            if (!debugInfo)
-                return null;
-            const vendor = gl.getParameter(debugInfo.UNMASKED_VENDOR_WEBGL);
-            const renderer = gl.getParameter(debugInfo.UNMASKED_RENDERER_WEBGL);
-            return this.simpleHash(`${vendor}~${renderer}`);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Hash array of components into a fingerprint string
-     */
-    hashComponents(components) {
-        const str = components.map(c => String(c)).join('|');
-        return this.simpleHash(str);
-    }
-    /**
-     * Simple hash function (djb2 variant)
-     */
-    simpleHash(str) {
-        let hash = 5381;
-        for (let i = 0; i < str.length; i++) {
-            hash = ((hash << 5) + hash) + str.charCodeAt(i);
-            hash = hash & hash; // Convert to 32bit integer
-        }
-        // Convert to hex string and ensure positive
-        return (hash >>> 0).toString(16).padStart(8, '0');
-    }
-    /**
-     * Clear cached context
-     */
-    clearCache() {
-        this.cachedContext = null;
-        this.cacheTimestamp = 0;
-    }
-    /**
-     * Clear cached fingerprint (both in memory and storage)
-     */
-    clearFingerprint() {
-        this.cachedFingerprint = null;
-        if (this.isBrowser()) {
-            try {
-                localStorage.removeItem(this.config.fingerprintStorageKey);
-            }
-            catch {
-                // localStorage not available
-            }
-        }
-    }
-    /**
-     * Get current configuration
-     */
-    getConfig() {
-        return { ...this.config };
-    }
-    /**
-     * Update configuration
-     */
-    updateConfig(config) {
-        this.config = { ...this.config, ...config };
-        this.clearCache();
-    }
-    /**
-     * Check if using FingerprintJS (vs manual implementation)
-     */
-    isUsingFingerprintJS() {
-        return this.usingFingerprintJS;
-    }
-    /**
-     * Get fingerprint info including method used and confidence
-     */
-    async getFingerprintInfo() {
-        if (!this.config.enableFingerprinting) {
-            return {
-                fingerprint: '',
-                method: 'manual',
-                confidence: 0
-            };
-        }
-        // Try FingerprintJS
-        if (this.config.useFingerprintJS && this.isBrowser()) {
-            try {
-                const agent = await this.getFingerprintJSAgent();
-                if (agent) {
-                    const result = await agent.get();
-                    return {
-                        fingerprint: result.visitorId,
-                        method: 'fingerprintjs',
-                        confidence: result.confidence?.score,
-                        componentsCount: Object.keys(result.components || {}).length
-                    };
-                }
-            }
-            catch {
-                // Fall through to manual
-            }
-        }
-        // Manual fallback
-        const fingerprint = await this.generateManualFingerprint();
-        return {
-            fingerprint,
-            method: 'manual',
-            confidence: 0.7, // Estimated accuracy for manual method
-            componentsCount: 15
-        };
-    }
-}
-exports.ContextCollector = ContextCollector;
-/**
- * Default context collector instance
- */
-let defaultCollector = null;
-/**
- * Get or create the default context collector
- */
-function getDefaultContextCollector(config) {
-    if (!defaultCollector) {
-        defaultCollector = new ContextCollector(config);
-    }
-    return defaultCollector;
-}
-/**
- * Collect browser context using the default collector
- */
-async function collectBrowserContext(config) {
-    const collector = getDefaultContextCollector(config);
-    return collector.collect();
-}