@seekora-ai/ui-sdk-core 0.2.0 → 0.2.4

package/dist/index.d.ts

@@ -445,5 +445,132 @@ declare class URLRouter {
  */
 declare function createURLRouter(config: URLRouterConfig): URLRouter;
 
-export { LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFocusableElements, getHighlightedValue, getLogger, getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
-export type { CSSVariablesConfig, HighlightOptions, HighlightPart, KeyboardNavigationOptions, KeyboardShortcut, LoggerConfig, Refinement, SearchState, SearchStateManagerConfig, SnippetOptions, URLRouterConfig, URLStateMapping };
+/**
+ * Seekora Device Fingerprinting Module
+ *
+ * A lightweight, dependency-free device fingerprinting solution that collects
+ * various browser and device signals to generate a unique visitor identifier.
+ */
+interface FingerprintConfig {
+    enableCanvas: boolean;
+    enableWebGL: boolean;
+    enableAudio: boolean;
+    enableFonts: boolean;
+    enableHardware: boolean;
+    timeout: number;
+}
+interface FingerprintResult {
+    visitorId: string;
+    confidence: number;
+    components: FingerprintComponents;
+}
+interface FingerprintComponents {
+    canvas: {
+        hash: string;
+        data?: string;
+    };
+    webgl: {
+        renderer: string;
+        vendor: string;
+        hash: string;
+    };
+    audio: {
+        hash: string;
+        value?: number;
+    };
+    fonts: string[];
+    hardware: {
+        concurrency: number;
+        deviceMemory: number;
+        maxTouchPoints: number;
+        platform: string;
+    };
+    screen: {
+        width: number;
+        height: number;
+        colorDepth: number;
+        pixelRatio: number;
+    };
+    browser: {
+        language: string;
+        languages: string[];
+        timezone: string;
+        timezoneOffset: number;
+        cookieEnabled: boolean;
+        doNotTrack: boolean;
+    };
+    adBlockerDetected: boolean;
+    incognitoDetected: boolean;
+}
+declare class Fingerprint {
+    private config;
+    private cachedResult;
+    constructor(config?: Partial<FingerprintConfig>);
+    /**
+     * Get the complete fingerprint result
+     */
+    get(): Promise<FingerprintResult>;
+    /**
+     * Clear the cached result to force re-fingerprinting
+     */
+    clearCache(): void;
+    /**
+     * Collect all fingerprint components
+     */
+    private collectComponents;
+    /**
+     * Canvas fingerprinting - draws various shapes and text, then hashes the result
+     */
+    private getCanvasFingerprint;
+    /**
+     * WebGL fingerprinting - extracts GPU info and renders test triangles
+     */
+    private getWebGLFingerprint;
+    /**
+     * Audio fingerprinting using AudioContext oscillator
+     */
+    private getAudioFingerprint;
+    /**
+     * Font detection by measuring text rendering differences
+     */
+    private detectFonts;
+    /**
+     * Get hardware information
+     */
+    private getHardwareInfo;
+    /**
+     * Get screen information
+     */
+    private getScreenInfo;
+    /**
+     * Get browser information
+     */
+    private getBrowserInfo;
+    /**
+     * Detect if an ad blocker is installed
+     */
+    private detectAdBlocker;
+    /**
+     * Detect if browser is in incognito/private mode
+     */
+    private detectIncognito;
+    /**
+     * Generate a hash from any data
+     */
+    private generateHash;
+    /**
+     * Generate the final visitor ID from all components
+     */
+    private generateVisitorId;
+    /**
+     * Calculate confidence score based on available components
+     */
+    private calculateConfidence;
+}
+/**
+ * Quick fingerprint getter - creates a Fingerprint instance and returns the result
+ */
+declare function getFingerprint(config?: Partial<FingerprintConfig>): Promise<FingerprintResult>;
+
+export { Fingerprint, LogLevel, SearchStateManager, URLRouter, announce, announceFilterChange, announceResults, createFocusTrap, createKeyboardShortcuts, createLogger, createRovingTabIndex, createTheme, createURLRouter, darkThemeVariables, extractField, focusFirstError, formatPrice, generateCompleteStylesheet, generateId, generateThemeStylesheet, getFingerprint, getFocusableElements, getHighlightedValue, getLogger, getNestedValue, getSnippetedValue, getTheme, handleKeyboardNavigation, highContrastThemeVariables, highlightQuery, injectStyles, lightThemeVariables, log, mergeThemes, minimalThemeVariables, parseHighlightedParts, parseQueryHighlightParts, prefersHighContrast, prefersReducedMotion, setAriaDescribedBy, setDefaultLogger, setLogLevel, setLogPrefix, setLogTimestamp, setTheme, stripHighlightTags, themeToCSSVariables };
+export type { CSSVariablesConfig, FingerprintComponents, FingerprintConfig, FingerprintResult, HighlightOptions, HighlightPart, KeyboardNavigationOptions, KeyboardShortcut, LoggerConfig, Refinement, SearchState, SearchStateManagerConfig, SnippetOptions, URLRouterConfig, URLStateMapping };