@axeptio/behavior-detection 1.0.2 → 1.1.0

package/dist/cjs/types.d.ts

@@ -1,168 +0,0 @@
-export type EventType = 'tab-visibility' | 'scroll' | 'resize' | 'mouse-move' | 'click' | 'keypress' | 'environment';
-export interface BaseEvent {
-    type: EventType;
-    timestamp: number;
-}
-export interface TabVisibilityEvent extends BaseEvent {
-    type: 'tab-visibility';
-    hidden: boolean;
-}
-export interface ScrollEvent extends BaseEvent {
-    type: 'scroll';
-    x: number;
-    y: number;
-    elementId?: string;
-    deltaY?: number;
-    deltaTime?: number;
-    velocity?: number;
-    isProgrammatic?: boolean;
-}
-export interface ResizeEvent extends BaseEvent {
-    type: 'resize';
-    width: number;
-    height: number;
-    mouseX?: number;
-    mouseY?: number;
-    mouseNearEdge?: boolean;
-    screenWidth: number;
-    screenHeight: number;
-    screenAvailWidth: number;
-    screenAvailHeight: number;
-    devicePixelRatio: number;
-    isFullscreen?: boolean;
-}
-export interface MouseMoveEvent extends BaseEvent {
-    type: 'mouse-move';
-    x: number;
-    y: number;
-    velocityX?: number;
-    velocityY?: number;
-    directionChange?: boolean;
-}
-export interface ClickEvent extends BaseEvent {
-    type: 'click';
-    x: number;
-    y: number;
-    targetX: number;
-    targetY: number;
-    targetWidth: number;
-    targetHeight: number;
-    distanceFromTarget: number;
-    mousePositionBeforeClick?: {
-        x: number;
-        y: number;
-        timestamp: number;
-    };
-    timeSinceLastMouseMove?: number;
-    targetInViewport: boolean;
-    targetVisibleArea: number;
-}
-export interface KeypressEvent extends BaseEvent {
-    type: 'keypress';
-    key: string;
-    timeSinceLastKey?: number;
-}
-export interface EnvironmentEvent extends BaseEvent {
-    type: 'environment';
-    screenWidth: number;
-    screenHeight: number;
-    screenAvailWidth: number;
-    screenAvailHeight: number;
-    windowWidth: number;
-    windowHeight: number;
-    devicePixelRatio: number;
-    colorDepth: number;
-    pixelDepth: number;
-    userAgent: string;
-    platform: string;
-    language: string;
-    languages: string[];
-    hardwareConcurrency?: number;
-    maxTouchPoints: number;
-    vendor: string;
-    hasWebGL: boolean;
-    hasWebRTC: boolean;
-    hasNotifications: boolean;
-    hasGeolocation: boolean;
-    hasIndexedDB: boolean;
-    hasLocalStorage: boolean;
-    hasSessionStorage: boolean;
-    plugins: number;
-    mimeTypes: number;
-    suspiciousRatio?: boolean;
-    suspiciousDimensions?: boolean;
-    featureInconsistency?: boolean;
-}
-export type TrackedEvent = TabVisibilityEvent | ScrollEvent | ResizeEvent | MouseMoveEvent | ClickEvent | KeypressEvent | EnvironmentEvent;
-export interface EventStorage {
-    'tab-visibility': TabVisibilityEvent[];
-    'scroll': ScrollEvent[];
-    'resize': ResizeEvent[];
-    'mouse-move': MouseMoveEvent[];
-    'click': ClickEvent[];
-    'keypress': KeypressEvent[];
-    'environment': EnvironmentEvent[];
-}
-export interface ScoreBreakdown {
-    overall: number;
-    factors: {
-        mouseMovement?: number;
-        clickAccuracy?: number;
-        scrollBehavior?: number;
-        keyboardTiming?: number;
-        tabActivity?: number;
-        resizeBehavior?: number;
-        environmentFingerprint?: number;
-    };
-    weights: {
-        mouseMovement: number;
-        clickAccuracy: number;
-        scrollBehavior: number;
-        keyboardTiming: number;
-        tabActivity: number;
-        resizeBehavior: number;
-        environmentFingerprint: number;
-    };
-}
-export interface ScoreOptions {
-    breakdown?: boolean;
-    auditTrail?: boolean;
-}
-export interface ScoreResult {
-    score: number;
-    breakdown?: ScoreBreakdown;
-    auditTrail?: TrackedEvent[];
-}
-export type ScoringFunction = (events: TrackedEvent[]) => number | undefined;
-export interface BehaviorSettings {
-    sampleRates?: {
-        mouseMove?: number;
-        scroll?: number;
-        keypress?: number;
-    };
-    rollingWindows?: {
-        mouseMove?: number;
-        scroll?: number;
-    };
-    weights?: {
-        mouseMovement?: number;
-        clickAccuracy?: number;
-        scrollBehavior?: number;
-        keyboardTiming?: number;
-        tabActivity?: number;
-        resizeBehavior?: number;
-        environmentFingerprint?: number;
-    };
-    customScorers?: {
-        mouseMovement?: ScoringFunction;
-        clickAccuracy?: ScoringFunction;
-        scrollBehavior?: ScoringFunction;
-        keyboardTiming?: ScoringFunction;
-        tabActivity?: ScoringFunction;
-        resizeBehavior?: ScoringFunction;
-        environmentFingerprint?: ScoringFunction;
-    };
-    clickMouseHistoryWindow?: number;
-    useWebWorker?: boolean;
-}
-export declare const DEFAULT_SETTINGS: Required<BehaviorSettings>;

package/dist/cjs/types.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SETTINGS = void 0;
-exports.DEFAULT_SETTINGS = {
-    sampleRates: {
-        mouseMove: 0.1, // Track 10% of mouse moves
-        scroll: 1.0, // Track ALL scrolls - critical for detection
-        keypress: 1.0, // Track all keypresses
-    },
-    rollingWindows: {
-        mouseMove: 30000,
-        scroll: 30000,
-    },
-    weights: {
-        mouseMovement: 0.30, // Increased - continuous behavioral signal
-        clickAccuracy: 0.30, // Increased - critical behavioral signal
-        scrollBehavior: 0.15, // Unchanged
-        keyboardTiming: 0.10, // Slightly reduced
-        tabActivity: 0.05, // Unchanged
-        resizeBehavior: 0.02, // Reduced - less reliable
-        environmentFingerprint: 0.08, // Reduced - static signal, one-time check
-    },
-    customScorers: {},
-    clickMouseHistoryWindow: 1000,
-    useWebWorker: false, // Will implement Web Worker support in phase 2
-};

package/dist/esm/browser-iife.d.ts

@@ -1,5 +0,0 @@
-/**
- * Browser Build (IIFE) - Pure browser bundle without ES module exports
- * Auto-initializing standalone bundle for CDN usage
- */
-export {};

package/dist/esm/browser-iife.js

@@ -1,157 +0,0 @@
-/**
- * Browser Build (IIFE) - Pure browser bundle without ES module exports
- * Auto-initializing standalone bundle for CDN usage
- */
-import { BehaviorDetector } from './behavior-detector';
-import { MouseStrategy, ScrollStrategy, ClickStrategy, TapStrategy, KeyboardStrategy, EnvironmentStrategy, ResizeStrategy, } from './strategies/index.js';
-/**
- * Detect if the current device is mobile
- */
-function isMobileDevice() {
-    const hasTouchScreen = navigator.maxTouchPoints > 0 || 'ontouchstart' in window;
-    const mobileUA = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
-    const smallScreen = window.innerWidth < 768 && window.innerHeight < 1024;
-    return (hasTouchScreen && smallScreen) || mobileUA;
-}
-class BehaviorDetectionAPI {
-    constructor() {
-        this.detector = null;
-        this.checkInterval = null;
-        this.settings = null;
-    }
-    init(settings) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
-        if (this.detector) {
-            this.stop();
-        }
-        this.settings = settings;
-        this.detector = new BehaviorDetector({
-            pauseOnHidden: settings.pauseOnHidden !== undefined ? settings.pauseOnHidden : true
-        });
-        const isMobile = isMobileDevice();
-        const strategies = settings.strategies || {};
-        const defaultWeights = isMobile ? {
-            mouse: 0,
-            scroll: 0.35,
-            click: 0,
-            tap: 0.35,
-            keyboard: 0.15,
-            environment: 0.10,
-            resize: 0.05,
-        } : {
-            mouse: 0.30,
-            scroll: 0.15,
-            click: 0.30,
-            tap: 0,
-            keyboard: 0.10,
-            environment: 0.08,
-            resize: 0.02,
-        };
-        if (!isMobile && ((_a = strategies.mouse) === null || _a === void 0 ? void 0 : _a.enabled) !== false) {
-            const strategy = new MouseStrategy();
-            const weight = (_c = (_b = strategies.mouse) === null || _b === void 0 ? void 0 : _b.weight) !== null && _c !== void 0 ? _c : defaultWeights.mouse;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (((_d = strategies.scroll) === null || _d === void 0 ? void 0 : _d.enabled) !== false) {
-            const strategy = new ScrollStrategy();
-            const weight = (_f = (_e = strategies.scroll) === null || _e === void 0 ? void 0 : _e.weight) !== null && _f !== void 0 ? _f : defaultWeights.scroll;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (!isMobile && ((_g = strategies.click) === null || _g === void 0 ? void 0 : _g.enabled) !== false) {
-            const strategy = new ClickStrategy();
-            const weight = (_j = (_h = strategies.click) === null || _h === void 0 ? void 0 : _h.weight) !== null && _j !== void 0 ? _j : defaultWeights.click;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (isMobile && ((_k = strategies.tap) === null || _k === void 0 ? void 0 : _k.enabled) !== false) {
-            const strategy = new TapStrategy();
-            const weight = (_m = (_l = strategies.tap) === null || _l === void 0 ? void 0 : _l.weight) !== null && _m !== void 0 ? _m : defaultWeights.tap;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (((_o = strategies.keyboard) === null || _o === void 0 ? void 0 : _o.enabled) !== false) {
-            const strategy = new KeyboardStrategy();
-            const weight = (_q = (_p = strategies.keyboard) === null || _p === void 0 ? void 0 : _p.weight) !== null && _q !== void 0 ? _q : defaultWeights.keyboard;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (((_r = strategies.environment) === null || _r === void 0 ? void 0 : _r.enabled) !== false) {
-            const strategy = new EnvironmentStrategy();
-            const weight = (_t = (_s = strategies.environment) === null || _s === void 0 ? void 0 : _s.weight) !== null && _t !== void 0 ? _t : defaultWeights.environment;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (((_u = strategies.resize) === null || _u === void 0 ? void 0 : _u.enabled) !== false) {
-            const strategy = new ResizeStrategy();
-            const weight = (_w = (_v = strategies.resize) === null || _v === void 0 ? void 0 : _v.weight) !== null && _w !== void 0 ? _w : defaultWeights.resize;
-            this.detector.addStrategy(strategy, weight);
-        }
-        if (settings.autoStart !== false) {
-            this.start();
-        }
-        if (settings.checkMs && settings.checkMs > 0) {
-            this.startPeriodicCheck(settings.checkMs);
-        }
-        if (settings.onReady) {
-            settings.onReady(this);
-        }
-    }
-    start() {
-        if (!this.detector) {
-            return;
-        }
-        this.detector.start();
-    }
-    stop() {
-        if (this.detector) {
-            this.detector.stop();
-        }
-        if (this.checkInterval !== null) {
-            clearInterval(this.checkInterval);
-            this.checkInterval = null;
-        }
-    }
-    async score() {
-        if (!this.detector) {
-            return null;
-        }
-        return this.detector.score({ breakdown: true });
-    }
-    startPeriodicCheck(intervalMs) {
-        if (this.checkInterval !== null) {
-            clearInterval(this.checkInterval);
-        }
-        this.checkInterval = window.setInterval(async () => {
-            var _a, _b;
-            const result = await this.score();
-            if (!result || !this.settings)
-                return;
-            if (this.settings.onScore) {
-                this.settings.onScore(result);
-            }
-            const botThreshold = (_a = this.settings.botThreshold) !== null && _a !== void 0 ? _a : 0.3;
-            const humanThreshold = (_b = this.settings.humanThreshold) !== null && _b !== void 0 ? _b : 0.7;
-            if (result.score < botThreshold && this.settings.ifBot) {
-                this.settings.ifBot(result);
-            }
-            else if (result.score >= humanThreshold && this.settings.ifHuman) {
-                this.settings.ifHuman(result);
-            }
-        }, intervalMs);
-    }
-    getDetector() {
-        return this.detector;
-    }
-}
-// Create global API instance
-const api = new BehaviorDetectionAPI();
-// Auto-initialize if settings are already present
-if (typeof window !== 'undefined') {
-    window.BehaviorDetector = api;
-    const checkAndInit = () => {
-        const settings = window.bdSettings;
-        if (settings) {
-            api.init(settings);
-        }
-    };
-    checkAndInit();
-    if (document.readyState === 'loading') {
-        document.addEventListener('DOMContentLoaded', checkAndInit);
-    }
-}