@fingerprintiq/js 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -4,6 +4,16 @@ interface FingerprintIQConfig {
     endpoint?: string;
     timeout?: number;
     detectWallets?: boolean;
+    cache?: CacheConfig | false;
+}
+interface IdentifyOptions {
+    tag?: unknown;
+    linkedId?: string;
+    timeout?: number;
+}
+interface CacheConfig {
+    storage: "sessionStorage" | "localStorage";
+    ttl?: number;
 }
 interface SignalResult<T = unknown> {
     value: T;
@@ -379,28 +389,117 @@ interface ClientSignals {
     virtualization: SignalResult<VirtualizationSignal> | null;
     rooted: SignalResult<RootedSignal> | null;
 }
+interface Verdicts {
+    bot: {
+        result: boolean;
+        probability: number;
+    };
+    vpn: {
+        result: boolean;
+        confidence: number;
+    };
+    tor: {
+        result: boolean;
+    };
+    proxy: {
+        result: boolean;
+    };
+    incognito: {
+        result: boolean;
+    };
+    tampering: {
+        result: boolean;
+        anomalyScore: number;
+    };
+    headless: {
+        result: boolean;
+    };
+    virtualMachine: {
+        result: boolean;
+    };
+    devtools: {
+        result: boolean;
+    };
+    privacyBrowser: {
+        result: boolean;
+        name: string | null;
+    };
+    highActivity: {
+        result: boolean;
+    };
+    ipBlocklist: {
+        result: boolean;
+    };
+    velocity?: {
+        distinctIp: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+        distinctCountry: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+        events: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+    };
+}
+interface IpLocation {
+    country: string;
+    city: string;
+    region: string;
+    latitude: number;
+    longitude: number;
+}
+interface SybilRisk {
+    score: number;
+    level: string;
+    reasons: string[];
+}
 interface IdentifyResponse {
+    requestId: string;
     visitorId: string;
     confidence: number;
     botProbability: number;
-    signals: Record<string, unknown>;
-    wallets?: WalletSignal;
-    timestamp: number;
+    suspectScore: number;
     visitCount: number;
     firstSeenAt: number;
+    lastSeenAt: number | null;
+    riskFactors: string[];
+    verdicts: Verdicts;
+    ip: string;
+    ipLocation: IpLocation;
+    sybilRisk?: SybilRisk;
+    web3?: {
+        walletsDetected: string[];
+        connectedWallets: unknown[];
+        sybilAnalysis: unknown;
+    };
+    timestamp: number;
+    cacheHit?: boolean;
+    /** Base64-encoded AES-256-GCM encrypted payload containing full event data. Only present when a sealed key is active. Decrypt server-side with @fingerprintiq/server. */
+    sealedResult?: string;
 }
 
 declare function getDiscoveredAddresses(): string[];
-declare function requestWalletConnection(): Promise<string | null>;
+declare function requestWalletConnection(wallet?: string): Promise<string | null>;
 
 declare class FingerprintIQ {
     private readonly apiKey;
     private readonly endpoint;
     private readonly timeout;
     private readonly detectWallets;
+    private readonly cache;
     constructor(config: FingerprintIQConfig);
     private ensureClientHintsBootstrapped;
-    identify(): Promise<IdentifyResponse>;
+    identify(options?: IdentifyOptions): Promise<IdentifyResponse>;
+    private getCacheKey;
+    private readCache;
+    private writeCache;
 }
 
-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 };
+export { type AudioSignal, type BehavioralRiskSignal, type CacheConfig, 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 IdentifyOptions, type IdentifyResponse, type IntegritySignal, type IntlSignal, type IpLocation, 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 SybilRisk, type TimezoneSignal, type UAClientHintsBrand, type UAClientHintsSignal, type Verdicts, type WalletSignal, type WasmTimingSignal, type WebGLSignal, type WebGPUSignal, type WebRTCSignal, type WindowFeaturesSignal, type WorkerScopeSignal, FingerprintIQ as default, getDiscoveredAddresses, requestWalletConnection };

package/dist/index.d.ts

@@ -4,6 +4,16 @@ interface FingerprintIQConfig {
     endpoint?: string;
     timeout?: number;
     detectWallets?: boolean;
+    cache?: CacheConfig | false;
+}
+interface IdentifyOptions {
+    tag?: unknown;
+    linkedId?: string;
+    timeout?: number;
+}
+interface CacheConfig {
+    storage: "sessionStorage" | "localStorage";
+    ttl?: number;
 }
 interface SignalResult<T = unknown> {
     value: T;
@@ -379,28 +389,117 @@ interface ClientSignals {
     virtualization: SignalResult<VirtualizationSignal> | null;
     rooted: SignalResult<RootedSignal> | null;
 }
+interface Verdicts {
+    bot: {
+        result: boolean;
+        probability: number;
+    };
+    vpn: {
+        result: boolean;
+        confidence: number;
+    };
+    tor: {
+        result: boolean;
+    };
+    proxy: {
+        result: boolean;
+    };
+    incognito: {
+        result: boolean;
+    };
+    tampering: {
+        result: boolean;
+        anomalyScore: number;
+    };
+    headless: {
+        result: boolean;
+    };
+    virtualMachine: {
+        result: boolean;
+    };
+    devtools: {
+        result: boolean;
+    };
+    privacyBrowser: {
+        result: boolean;
+        name: string | null;
+    };
+    highActivity: {
+        result: boolean;
+    };
+    ipBlocklist: {
+        result: boolean;
+    };
+    velocity?: {
+        distinctIp: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+        distinctCountry: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+        events: {
+            "5m": number;
+            "1h": number;
+            "24h": number;
+        };
+    };
+}
+interface IpLocation {
+    country: string;
+    city: string;
+    region: string;
+    latitude: number;
+    longitude: number;
+}
+interface SybilRisk {
+    score: number;
+    level: string;
+    reasons: string[];
+}
 interface IdentifyResponse {
+    requestId: string;
     visitorId: string;
     confidence: number;
     botProbability: number;
-    signals: Record<string, unknown>;
-    wallets?: WalletSignal;
-    timestamp: number;
+    suspectScore: number;
     visitCount: number;
     firstSeenAt: number;
+    lastSeenAt: number | null;
+    riskFactors: string[];
+    verdicts: Verdicts;
+    ip: string;
+    ipLocation: IpLocation;
+    sybilRisk?: SybilRisk;
+    web3?: {
+        walletsDetected: string[];
+        connectedWallets: unknown[];
+        sybilAnalysis: unknown;
+    };
+    timestamp: number;
+    cacheHit?: boolean;
+    /** Base64-encoded AES-256-GCM encrypted payload containing full event data. Only present when a sealed key is active. Decrypt server-side with @fingerprintiq/server. */
+    sealedResult?: string;
 }
 
 declare function getDiscoveredAddresses(): string[];
-declare function requestWalletConnection(): Promise<string | null>;
+declare function requestWalletConnection(wallet?: string): Promise<string | null>;
 
 declare class FingerprintIQ {
     private readonly apiKey;
     private readonly endpoint;
     private readonly timeout;
     private readonly detectWallets;
+    private readonly cache;
     constructor(config: FingerprintIQConfig);
     private ensureClientHintsBootstrapped;
-    identify(): Promise<IdentifyResponse>;
+    identify(options?: IdentifyOptions): Promise<IdentifyResponse>;
+    private getCacheKey;
+    private readCache;
+    private writeCache;
 }
 
-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 };
+export { type AudioSignal, type BehavioralRiskSignal, type CacheConfig, 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 IdentifyOptions, type IdentifyResponse, type IntegritySignal, type IntlSignal, type IpLocation, 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 SybilRisk, type TimezoneSignal, type UAClientHintsBrand, type UAClientHintsSignal, type Verdicts, type WalletSignal, type WasmTimingSignal, type WebGLSignal, type WebGPUSignal, type WebRTCSignal, type WindowFeaturesSignal, type WorkerScopeSignal, FingerprintIQ as default, getDiscoveredAddresses, requestWalletConnection };