@seekora-ai/search-sdk 0.2.6 → 0.2.8

package/dist/src/config-loader.d.ts

@@ -1,43 +0,0 @@
-/**
- * Configuration Loader
- *
- * Loads SDK configuration from file or environment variables
- */
-import type { SeekoraClientConfig } from './client';
-import type { LogLevel } from './logger';
-export interface FileConfig {
-    storeId?: string;
-    readSecret?: string;
-    writeSecret?: string;
-    baseUrl?: string;
-    environment?: 'local' | 'stage' | 'production';
-    timeout?: number;
-    logLevel?: LogLevel;
-    logger?: {
-        level?: LogLevel;
-        enableConsole?: boolean;
-        enableFile?: boolean;
-        filePath?: string;
-        format?: 'json' | 'text';
-    };
-}
-/**
- * Load configuration from file
- * Note: File loading is only available in Node.js environment
- * In browser, this will always return null
- */
-export declare function loadConfigFromFile(filePath?: string): FileConfig | null;
-/**
- * Load configuration from environment variables
- * Note: In browser, environment variables are not available via process.env
- * Use window.SEEKORA_CONFIG or pass config directly to client
- */
-export declare function loadConfigFromEnv(): Partial<FileConfig>;
-/**
- * Merge configurations (file config < env config < code config)
- */
-export declare function mergeConfig(fileConfig: FileConfig | null, envConfig: Partial<FileConfig>, codeConfig: Partial<SeekoraClientConfig>): SeekoraClientConfig;
-/**
- * Load and merge all configuration sources
- */
-export declare function loadConfig(codeConfig?: Partial<SeekoraClientConfig>): SeekoraClientConfig;

package/dist/src/config-loader.js

@@ -1,147 +0,0 @@
-"use strict";
-/**
- * Configuration Loader
- *
- * Loads SDK configuration from file or environment variables
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfigFromFile = loadConfigFromFile;
-exports.loadConfigFromEnv = loadConfigFromEnv;
-exports.mergeConfig = mergeConfig;
-exports.loadConfig = loadConfig;
-// Browser-safe imports - only import fs/path if in Node.js environment
-let fs;
-let path;
-try {
-    // Only import in Node.js environment
-    if (typeof window === 'undefined' && typeof require !== 'undefined') {
-        fs = require('fs');
-        path = require('path');
-    }
-}
-catch (e) {
-    // Ignore - we're in browser environment
-}
-/**
- * Default config file paths (checked in order)
- */
-function getDefaultConfigPaths() {
-    const paths = [
-        '.seekora.json',
-        '.seekora.yaml',
-        '.seekora.yml',
-        'seekora.config.json',
-        'seekora.config.yaml',
-        'seekora.config.yml',
-    ];
-    // Only add home directory paths if we're in Node.js
-    if (path && typeof process !== 'undefined' && process.env) {
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        if (home) {
-            paths.push(path.join(home, '.seekora.json'), path.join(home, '.seekora.yaml'));
-        }
-    }
-    return paths;
-}
-/**
- * Load configuration from file
- * Note: File loading is only available in Node.js environment
- * In browser, this will always return null
- */
-function loadConfigFromFile(filePath) {
-    // File system access is not available in browser
-    if (!fs || typeof window !== 'undefined') {
-        return null;
-    }
-    const pathsToCheck = filePath
-        ? [filePath]
-        : getDefaultConfigPaths();
-    for (const configPath of pathsToCheck) {
-        if (!configPath)
-            continue;
-        try {
-            // Check if file exists
-            if (!fs.existsSync(configPath)) {
-                continue;
-            }
-            const content = fs.readFileSync(configPath, 'utf-8');
-            let config;
-            // Parse based on file extension
-            if (configPath.endsWith('.yaml') || configPath.endsWith('.yml')) {
-                // Try to parse YAML (would need yaml package)
-                // For now, fallback to JSON
-                try {
-                    config = JSON.parse(content);
-                }
-                catch {
-                    // If JSON parse fails, try to use a simple YAML parser
-                    // For production, use 'yaml' or 'js-yaml' package
-                    throw new Error('YAML parsing not fully supported. Use JSON or install yaml package.');
-                }
-            }
-            else {
-                config = JSON.parse(content);
-            }
-            return config;
-        }
-        catch (error) {
-            // Continue to next file if this one fails
-            continue;
-        }
-    }
-    return null;
-}
-/**
- * Load configuration from environment variables
- * Note: In browser, environment variables are not available via process.env
- * Use window.SEEKORA_CONFIG or pass config directly to client
- */
-function loadConfigFromEnv() {
-    // In browser, try to get config from window object
-    if (typeof window !== 'undefined' && window.SEEKORA_CONFIG) {
-        return window.SEEKORA_CONFIG;
-    }
-    // In Node.js, use process.env
-    if (typeof process !== 'undefined' && process.env) {
-        return {
-            storeId: process.env.SEEKORA_STORE_ID,
-            readSecret: process.env.SEEKORA_READ_SECRET,
-            writeSecret: process.env.SEEKORA_WRITE_SECRET,
-            baseUrl: process.env.SEEKORA_BASE_URL,
-            environment: process.env.SEEKORA_ENV,
-            timeout: process.env.SEEKORA_TIMEOUT ? parseInt(process.env.SEEKORA_TIMEOUT, 10) : undefined,
-            logLevel: process.env.SEEKORA_LOG_LEVEL,
-        };
-    }
-    return {};
-}
-/**
- * Merge configurations (file config < env config < code config)
- */
-function mergeConfig(fileConfig, envConfig, codeConfig) {
-    const merged = {};
-    // Start with file config
-    if (fileConfig) {
-        Object.assign(merged, fileConfig);
-    }
-    // Override with env config
-    Object.assign(merged, envConfig);
-    // Override with code config (highest priority)
-    Object.assign(merged, codeConfig);
-    // Validate required fields
-    if (!merged.storeId) {
-        throw new Error('storeId is required. Provide it in config file, environment variable, or code.');
-    }
-    if (!merged.readSecret) {
-        throw new Error('readSecret is required. Provide it in config file, environment variable, or code.');
-    }
-    return merged;
-}
-/**
- * Load and merge all configuration sources
- */
-function loadConfig(codeConfig = {}) {
-    const fileConfig = loadConfigFromFile(codeConfig.configFile);
-    const envConfig = loadConfigFromEnv();
-    return mergeConfig(fileConfig, envConfig, codeConfig);
-}

package/dist/src/config.d.ts

@@ -1,22 +0,0 @@
-/**
- * Seekora SDK Configuration
- *
- * Environment-based configuration for different deployment targets
- */
-export type SeekoraEnvironment = 'local' | 'stage' | 'production';
-export interface EnvironmentConfig {
-    baseUrl: string;
-    name: string;
-}
-/**
- * Environment configurations
- */
-export declare const ENVIRONMENTS: Record<SeekoraEnvironment, EnvironmentConfig>;
-/**
- * Get base URL for environment
- */
-export declare function getBaseUrl(environment?: SeekoraEnvironment, customBaseUrl?: string): string;
-/**
- * Get current environment from config or env var
- */
-export declare function getEnvironment(environment?: SeekoraEnvironment): SeekoraEnvironment;

package/dist/src/config.js

@@ -1,58 +0,0 @@
-"use strict";
-/**
- * Seekora SDK Configuration
- *
- * Environment-based configuration for different deployment targets
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENVIRONMENTS = void 0;
-exports.getBaseUrl = getBaseUrl;
-exports.getEnvironment = getEnvironment;
-/**
- * Environment configurations
- */
-exports.ENVIRONMENTS = {
-    local: {
-        baseUrl: 'http://localhost:3000',
-        name: 'Local Development',
-    },
-    stage: {
-        baseUrl: 'https://stage-api.seekora.ai/api',
-        name: 'Staging',
-    },
-    production: {
-        baseUrl: 'https://api.seekora.com/api',
-        name: 'Production',
-    },
-};
-/**
- * Get base URL for environment
- */
-function getBaseUrl(environment, customBaseUrl) {
-    if (customBaseUrl) {
-        return customBaseUrl;
-    }
-    // Check environment variable first (Node.js) or window variable (browser)
-    let envFromVar;
-    if (typeof process !== 'undefined' && process.env) {
-        envFromVar = process.env.SEEKORA_ENV;
-    }
-    else if (typeof window !== 'undefined' && window.SEEKORA_ENV) {
-        envFromVar = window.SEEKORA_ENV;
-    }
-    const env = environment || envFromVar || 'stage';
-    return exports.ENVIRONMENTS[env]?.baseUrl || exports.ENVIRONMENTS.stage.baseUrl;
-}
-/**
- * Get current environment from config or env var
- */
-function getEnvironment(environment) {
-    let envFromVar;
-    if (typeof process !== 'undefined' && process.env) {
-        envFromVar = process.env.SEEKORA_ENV;
-    }
-    else if (typeof window !== 'undefined' && window.SEEKORA_ENV) {
-        envFromVar = window.SEEKORA_ENV;
-    }
-    return environment || envFromVar || 'stage';
-}

package/dist/src/context-collector.d.ts

@@ -1,273 +0,0 @@
-/**
- * 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.
- */
-/**
- * Browser and device context collected for analytics enrichment
- */
-export interface BrowserContext {
-    screen_width: number;
-    screen_height: number;
-    viewport_width: number;
-    viewport_height: number;
-    color_depth: number;
-    pixel_ratio: number;
-    browser_name: string;
-    browser_version: string;
-    browser_language: string;
-    browser_languages: string[];
-    timezone: string;
-    timezone_offset: number;
-    page_url: string;
-    page_path: string;
-    page_title: string;
-    page_referrer: string;
-    document_visibility: string;
-    utm_source?: string;
-    utm_medium?: string;
-    utm_campaign?: string;
-    utm_term?: string;
-    utm_content?: string;
-    connection_type?: string;
-    connection_effective_type?: string;
-    connection_downlink?: number;
-    connection_rtt?: number;
-    device_fingerprint?: string;
-    platform: string;
-    is_mobile: boolean;
-    is_tablet: boolean;
-    is_touch_device: boolean;
-    hardware_concurrency?: number;
-    max_touch_points?: number;
-    device_memory?: number;
-}
-/**
- * Configuration for context collection
- */
-export interface ContextCollectorConfig {
-    /**
-     * Enable device fingerprinting (generates a stable device ID)
-     * @default true
-     */
-    enableFingerprinting?: boolean;
-    /**
-     * Use FingerprintJS library for high-accuracy fingerprinting (recommended)
-     * Falls back to manual implementation if FingerprintJS is not available
-     * @default true
-     */
-    useFingerprintJS?: boolean;
-    /**
-     * Enable canvas fingerprinting (only used in manual mode)
-     * @default true
-     */
-    enableCanvasFingerprint?: boolean;
-    /**
-     * Enable WebGL fingerprinting (only used in manual mode)
-     * @default true
-     */
-    enableWebGLFingerprint?: boolean;
-    /**
-     * Enable audio fingerprinting (only used in manual mode)
-     * @default false
-     */
-    enableAudioFingerprint?: boolean;
-    /**
-     * Automatically collect context on initialization
-     * @default true
-     */
-    autoCollect?: boolean;
-    /**
-     * Cache context for this many milliseconds (0 = no caching)
-     * @default 30000 (30 seconds)
-     */
-    cacheDuration?: number;
-    /**
-     * Storage key for fingerprint persistence
-     * @default 'seekora_device_fp'
-     */
-    fingerprintStorageKey?: string;
-    /**
-     * Enable extended fingerprint components for higher uniqueness
-     * Includes fonts, plugins, and other signals
-     * @default true
-     */
-    enableExtendedComponents?: boolean;
-}
-/**
- * ContextCollector class for gathering browser and device context
- *
- * Uses FingerprintJS Open Source for industry-standard fingerprinting
- * with automatic fallback to manual implementation if unavailable.
- */
-export declare class ContextCollector {
-    private config;
-    private cachedContext;
-    private cacheTimestamp;
-    private cachedFingerprint;
-    private fingerprintJSAgent;
-    private fingerprintJSLoading;
-    private usingFingerprintJS;
-    constructor(config?: ContextCollectorConfig);
-    /**
-     * Initialize FingerprintJS agent (async, non-blocking)
-     */
-    private initFingerprintJS;
-    /**
-     * Get FingerprintJS agent, waiting for initialization if needed
-     */
-    private getFingerprintJSAgent;
-    /**
-     * Check if running in browser environment
-     */
-    private isBrowser;
-    /**
-     * Collect complete browser context
-     */
-    collect(): Promise<BrowserContext>;
-    /**
-     * Collect fresh context without caching
-     */
-    private collectFresh;
-    /**
-     * Get server-side context (for Node.js environments)
-     */
-    private getServerContext;
-    /**
-     * Get viewport width
-     */
-    private getViewportWidth;
-    /**
-     * Get viewport height
-     */
-    private getViewportHeight;
-    /**
-     * Get document visibility state
-     */
-    private getDocumentVisibility;
-    /**
-     * Get timezone name
-     */
-    private getTimezone;
-    /**
-     * Parse UTM parameters from URL
-     */
-    private parseUTMParameters;
-    /**
-     * Get connection information from Network Information API
-     */
-    private getConnectionInfo;
-    /**
-     * Parse browser name and version from user agent
-     */
-    private parseBrowserInfo;
-    /**
-     * Detect platform from user agent
-     */
-    private detectPlatform;
-    /**
-     * Check if device is mobile
-     */
-    private isMobile;
-    /**
-     * Check if device is tablet
-     */
-    private isTablet;
-    /**
-     * Check if device supports touch
-     */
-    private isTouchDevice;
-    /**
-     * Sanitize URL to remove sensitive query parameters
-     */
-    private sanitizeUrl;
-    /**
-     * Load cached fingerprint from storage
-     */
-    private loadCachedFingerprint;
-    /**
-     * Get or generate device fingerprint
-     */
-    private getOrGenerateFingerprint;
-    /**
-     * 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
-     */
-    private generateFingerprint;
-    /**
-     * Generate fingerprint manually using browser characteristics
-     * Used as fallback when FingerprintJS is not available
-     */
-    private generateManualFingerprint;
-    /**
-     * Get audio fingerprint using AudioContext
-     */
-    private getAudioFingerprint;
-    /**
-     * Get font fingerprint by testing font availability
-     */
-    private getFontFingerprint;
-    /**
-     * Get additional WebGL parameters for fingerprinting
-     */
-    private getWebGLParameters;
-    /**
-     * Get canvas fingerprint
-     */
-    private getCanvasFingerprint;
-    /**
-     * Get WebGL fingerprint
-     */
-    private getWebGLFingerprint;
-    /**
-     * Hash array of components into a fingerprint string
-     */
-    private hashComponents;
-    /**
-     * Simple hash function (djb2 variant)
-     */
-    private simpleHash;
-    /**
-     * Clear cached context
-     */
-    clearCache(): void;
-    /**
-     * Clear cached fingerprint (both in memory and storage)
-     */
-    clearFingerprint(): void;
-    /**
-     * Get current configuration
-     */
-    getConfig(): Required<ContextCollectorConfig>;
-    /**
-     * Update configuration
-     */
-    updateConfig(config: Partial<ContextCollectorConfig>): void;
-    /**
-     * Check if using FingerprintJS (vs manual implementation)
-     */
-    isUsingFingerprintJS(): boolean;
-    /**
-     * Get fingerprint info including method used and confidence
-     */
-    getFingerprintInfo(): Promise<{
-        fingerprint: string;
-        method: 'fingerprintjs' | 'manual';
-        confidence?: number;
-        componentsCount?: number;
-    }>;
-}
-/**
- * Get or create the default context collector
- */
-export declare function getDefaultContextCollector(config?: ContextCollectorConfig): ContextCollector;
-/**
- * Collect browser context using the default collector
- */
-export declare function collectBrowserContext(config?: ContextCollectorConfig): Promise<BrowserContext>;