@fingerprintiq/js 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,406 @@
+/** Configuration for the FingerprintIQ SDK */
+interface FingerprintIQConfig {
+    apiKey: string;
+    endpoint?: string;
+    timeout?: number;
+    detectWallets?: boolean;
+}
+interface SignalResult<T = unknown> {
+    value: T;
+    duration: number;
+}
+interface CanvasSignal {
+    hash: string;
+    isFarbled: boolean;
+}
+interface WebGLSignal {
+    renderer: string;
+    vendor: string;
+    extensions: string[];
+    params: Record<string, number>;
+    gpuTimingMs: number | null;
+    isSoftwareRenderer: boolean;
+}
+interface WebGPUSignal {
+    available: boolean;
+    vendor: string;
+    architecture: string;
+    device: string;
+    description: string;
+    features: string[];
+}
+interface AudioSignal {
+    hash: string;
+    sampleRate: number;
+    maxChannelCount: number;
+    isSuspended: boolean;
+}
+interface FontSignal {
+    detected: string[];
+    count: number;
+    isSpoofed: boolean;
+}
+interface WebRTCSignal {
+    localIpHash: string | null;
+    candidateCount: number;
+    candidateTypes: string[];
+    multipleNics: boolean;
+}
+interface WasmTimingSignal {
+    medianMs: number;
+    stddevMs: number;
+}
+interface NavigatorSignal {
+    hardwareConcurrency: number;
+    deviceMemory: number | null;
+    maxTouchPoints: number;
+    languages: string[];
+    platform: string;
+    cookieEnabled: boolean;
+    doNotTrack: string | null;
+    keyboardLayout: string | null;
+    connectionType: string | null;
+    hasBluetooth: boolean;
+    hasUsb: boolean;
+    hasHid: boolean;
+    hasSerial: boolean;
+    hasWakeLock: boolean;
+    hasGpu: boolean;
+    bluetoothAvailable: boolean | null;
+}
+interface MediaSignal {
+    colorScheme: string;
+    contrast: string;
+    forcedColors: boolean;
+    pointer: string;
+    hover: string;
+    displayMode: string;
+    reducedMotion: boolean;
+    colorGamut: string;
+}
+interface ScreenSignal {
+    width: number;
+    height: number;
+    availWidth: number;
+    availHeight: number;
+    colorDepth: number;
+    pixelRatio: number;
+    isFirefoxRfp: boolean;
+}
+interface IntegritySignal {
+    tamperedApis: string[];
+    workerMismatch: boolean;
+    lieScore: number;
+}
+interface WalletSignal {
+    detected: string[];
+    count: number;
+    evmProviders: string[];
+    solanaProviders: string[];
+    multipleWallets: boolean;
+    versions: Record<string, string>;
+}
+interface StorageSignal {
+    localStorage: boolean;
+    sessionStorage: boolean;
+    indexedDb: boolean;
+    cookie: boolean;
+    survivingMechanisms: string[];
+}
+interface MathSignal {
+    values: number[];
+    hash: string;
+}
+interface DOMRectSignal {
+    hash: string;
+    emojiHash: string;
+    rectCount: number;
+}
+interface HeadlessSignal {
+    isHeadless: boolean;
+    markers: string[];
+}
+interface SpeechSignal {
+    voiceCount: number;
+    localVoices: string[];
+    remoteVoiceCount: number;
+    defaultVoice: string | null;
+    hash: string;
+}
+interface IntlSignal {
+    locales: string[];
+    formattedNumber: string;
+    formattedRelativeTime: string;
+    formattedList: string;
+    localeSpoofed: boolean;
+    hash: string;
+}
+interface TimezoneSignal {
+    reported: string;
+    computed: string | null;
+    offsetHistorical: number;
+    isSpoofed: boolean;
+    hash: string;
+}
+interface CssStyleSignal {
+    propertyCount: number;
+    systemColorHash: string;
+    systemFontHash: string;
+    hash: string;
+}
+interface ErrorSignal {
+    messages: string[];
+    hash: string;
+}
+interface WorkerScopeSignal {
+    workerNavigator: {
+        hardwareConcurrency: number;
+        platform: string;
+        languages: string[];
+        userAgent: string;
+    } | null;
+    workerWebGL: {
+        renderer: string;
+        vendor: string;
+    } | null;
+    mismatches: string[];
+}
+interface ResistanceSignal {
+    browser: string | null;
+    extensions: string[];
+    timerPrecisionMs: number;
+}
+interface SvgSignal {
+    hash: string;
+    textLengths: number[];
+}
+interface WindowFeaturesSignal {
+    propertyCount: number;
+    webkitCount: number;
+    mozCount: number;
+    litterKeys: string[];
+    hash: string;
+}
+interface HtmlElementSignal {
+    propertyCount: number;
+    hash: string;
+}
+interface CodecSignal {
+    matrix: Record<string, {
+        canPlay: string;
+        mediaSource: boolean;
+        mediaRecorder: boolean;
+    }>;
+    hash: string;
+}
+interface StatusSignal {
+    timingResolution: number;
+    maxStackSize: number;
+    storageQuotaMB: number | null;
+    battery: {
+        charging: boolean;
+        level: number;
+    } | null;
+    heapLimit: number | null;
+}
+interface PlatformFeaturesSignal {
+    features: Record<string, boolean>;
+    estimatedPlatform: string;
+    hash: string;
+}
+interface UAClientHintsBrand {
+    brand: string;
+    version: string;
+}
+interface UAClientHintsSignal {
+    available: boolean;
+    mobile: boolean | null;
+    platform: string | null;
+    architecture: string | null;
+    bitness: string | null;
+    model: string | null;
+    platformVersion: string | null;
+    wow64: boolean | null;
+    formFactors: string[];
+    brands: UAClientHintsBrand[];
+    fullVersionList: UAClientHintsBrand[];
+    hash: string | null;
+}
+interface CapabilityVectorSignal {
+    pdfViewerEnabled: boolean | null;
+    globalPrivacyControl: boolean | null;
+    hasPdfPlugin: boolean;
+    pluginCount: number | null;
+    hasWebGPU: boolean;
+    hasVirtualKeyboard: boolean;
+    hasSpeechSynthesis: boolean;
+    hasSpeechRecognition: boolean;
+    hasMediaCapabilities: boolean;
+    hasKeyboardLayoutApi: boolean;
+    hasBluetooth: boolean;
+    hasUsb: boolean;
+    hasHid: boolean;
+    hasSerial: boolean;
+    hasHighEntropyUaHints: boolean;
+    suspiciousFlags: string[];
+    hash: string;
+}
+interface GeometryVectorSignal {
+    screen: {
+        width: number;
+        height: number;
+        availWidth: number;
+        availHeight: number;
+    };
+    window: {
+        innerWidth: number;
+        innerHeight: number;
+        outerWidth: number;
+        outerHeight: number;
+        devicePixelRatio: number;
+    };
+    visualViewport: {
+        width: number;
+        height: number;
+        scale: number;
+        offsetLeft: number;
+        offsetTop: number;
+    } | null;
+    orientation: {
+        type: string | null;
+        angle: number | null;
+    };
+    chromeInsetX: number | null;
+    chromeInsetY: number | null;
+    suspiciousFlags: string[];
+    hash: string;
+}
+interface RuntimeVectorSignal {
+    hardwareConcurrency: number;
+    deviceMemory: number | null;
+    timingResolutionMs: number | null;
+    maxStackSize: number | null;
+    storageQuotaMB: number | null;
+    jsHeapUsedMB: number | null;
+    jsHeapTotalMB: number | null;
+    jsHeapLimitMB: number | null;
+    networkRttMs: number | null;
+    downlinkMbps: number | null;
+    saveData: boolean | null;
+    suspiciousFlags: string[];
+    hash: string;
+}
+interface SensorCapabilitiesSignal {
+    apis: Record<string, boolean>;
+    permissionStates: Record<string, string | null>;
+    policyBlocked: string[];
+    availableCount: number;
+    hash: string;
+}
+interface BehavioralRiskSignal {
+    elapsedMs: number;
+    totalEventCount: number;
+    pointerMoveCount: number;
+    pointerDistancePx: number;
+    pointerDirectionChanges: number;
+    pointerStraightness: number | null;
+    clickCount: number;
+    scrollEventCount: number;
+    scrollBurstCount: number;
+    keyEventCount: number;
+    inputEventCount: number;
+    focusTransitions: number;
+    blurTransitions: number;
+    visibilityTransitions: number;
+    meanPointerIntervalMs: number | null;
+    meanKeyIntervalMs: number | null;
+    classification: "insufficient_data" | "low_interaction" | "human_like" | "synthetic_like";
+    riskScore: number;
+    reasons: string[];
+    hash: string;
+}
+interface IncognitoSignal {
+    isPrivate: boolean;
+    method: string | null;
+}
+interface DevToolsSignal {
+    isOpen: boolean;
+    indicators: string[];
+}
+interface VirtualizationSignal {
+    vmDetected: boolean;
+    emulatorDetected: boolean;
+    indicators: string[];
+    confidence: "low" | "medium" | "high";
+}
+interface RootedSignal {
+    detected: boolean;
+    confidence: "low" | "medium";
+    indicators: string[];
+}
+interface ClientSignals {
+    canvas: SignalResult<CanvasSignal> | null;
+    webgl: SignalResult<WebGLSignal> | null;
+    webgpu: SignalResult<WebGPUSignal> | null;
+    audio: SignalResult<AudioSignal> | null;
+    fonts: SignalResult<FontSignal> | null;
+    webrtc: SignalResult<WebRTCSignal> | null;
+    wasmTiming: SignalResult<WasmTimingSignal> | null;
+    navigator: SignalResult<NavigatorSignal> | null;
+    media: SignalResult<MediaSignal> | null;
+    screen: SignalResult<ScreenSignal> | null;
+    integrity: SignalResult<IntegritySignal> | null;
+    wallets: SignalResult<WalletSignal> | null;
+    storage: SignalResult<StorageSignal> | null;
+    math: SignalResult<MathSignal> | null;
+    domRect: SignalResult<DOMRectSignal> | null;
+    headless: SignalResult<HeadlessSignal> | null;
+    speech: SignalResult<SpeechSignal> | null;
+    intl: SignalResult<IntlSignal> | null;
+    timezone: SignalResult<TimezoneSignal> | null;
+    cssStyle: SignalResult<CssStyleSignal> | null;
+    error: SignalResult<ErrorSignal> | null;
+    workerScope: SignalResult<WorkerScopeSignal> | null;
+    resistance: SignalResult<ResistanceSignal> | null;
+    svg: SignalResult<SvgSignal> | null;
+    windowFeatures: SignalResult<WindowFeaturesSignal> | null;
+    htmlElement: SignalResult<HtmlElementSignal> | null;
+    codec: SignalResult<CodecSignal> | null;
+    status: SignalResult<StatusSignal> | null;
+    platformFeatures: SignalResult<PlatformFeaturesSignal> | null;
+    uaClientHints: SignalResult<UAClientHintsSignal> | null;
+    capabilityVector: SignalResult<CapabilityVectorSignal> | null;
+    geometryVector: SignalResult<GeometryVectorSignal> | null;
+    runtimeVector: SignalResult<RuntimeVectorSignal> | null;
+    sensorCapabilities: SignalResult<SensorCapabilitiesSignal> | null;
+    behavioralRisk: SignalResult<BehavioralRiskSignal> | null;
+    incognito: SignalResult<IncognitoSignal> | null;
+    devTools: SignalResult<DevToolsSignal> | null;
+    virtualization: SignalResult<VirtualizationSignal> | null;
+    rooted: SignalResult<RootedSignal> | null;
+}
+interface IdentifyResponse {
+    visitorId: string;
+    confidence: number;
+    botProbability: number;
+    signals: Record<string, unknown>;
+    wallets?: WalletSignal;
+    timestamp: number;
+    visitCount: number;
+    firstSeenAt: number;
+}
+
+declare function getDiscoveredAddresses(): string[];
+declare function requestWalletConnection(): Promise<string | null>;
+
+declare class FingerprintIQ {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly timeout;
+    private readonly detectWallets;
+    constructor(config: FingerprintIQConfig);
+    private ensureClientHintsBootstrapped;
+    identify(): Promise<IdentifyResponse>;
+}
+
+export { type AudioSignal, type BehavioralRiskSignal, type CanvasSignal, type CapabilityVectorSignal, type ClientSignals, type CodecSignal, type CssStyleSignal, type DOMRectSignal, type ErrorSignal, type FingerprintIQConfig, type FontSignal, type GeometryVectorSignal, type HeadlessSignal, type HtmlElementSignal, type IdentifyResponse, type IntegritySignal, type IntlSignal, type MathSignal, type MediaSignal, type NavigatorSignal, type PlatformFeaturesSignal, type ResistanceSignal, type RuntimeVectorSignal, type ScreenSignal, type SensorCapabilitiesSignal, type SpeechSignal, type StatusSignal, type StorageSignal, type SvgSignal, type TimezoneSignal, type UAClientHintsBrand, type UAClientHintsSignal, type WalletSignal, type WasmTimingSignal, type WebGLSignal, type WebGPUSignal, type WebRTCSignal, type WindowFeaturesSignal, type WorkerScopeSignal, FingerprintIQ as default, getDiscoveredAddresses, requestWalletConnection };