@loamly/tracker 1.8.0 → 2.0.0

package/dist/index.d.mts

@@ -1,3 +1,65 @@
+/**
+ * Agentic Browser Detection
+ *
+ * LOA-187: Detects AI agentic browsers like Perplexity Comet, ChatGPT Atlas,
+ * and other automated browsing agents.
+ *
+ * Detection methods:
+ * - DOM fingerprinting (Perplexity Comet overlay)
+ * - Mouse movement patterns (teleporting clicks)
+ * - CDP (Chrome DevTools Protocol) automation fingerprint
+ * - navigator.webdriver detection
+ *
+ * @module @loamly/tracker/detection/agentic-browser
+ * @license MIT
+ */
+/**
+ * Agentic detection result
+ */
+interface AgenticDetectionResult {
+    /** Whether Perplexity Comet DOM element was detected */
+    cometDOMDetected: boolean;
+    /** Whether CDP automation was detected */
+    cdpDetected: boolean;
+    /** Mouse movement patterns */
+    mousePatterns: {
+        teleportingClicks: number;
+        totalMovements: number;
+    };
+    /** Overall agentic probability (0-1) */
+    agenticProbability: number;
+    /** Detection signals */
+    signals: string[];
+}
+/**
+ * Agentic Browser Analyzer
+ *
+ * Combines all detection methods into a unified result.
+ */
+declare class AgenticBrowserAnalyzer {
+    private cometDetector;
+    private mouseAnalyzer;
+    private cdpDetector;
+    private initialized;
+    constructor();
+    /**
+     * Initialize all detectors
+     */
+    init(): void;
+    /**
+     * Get current detection result
+     */
+    getResult(): AgenticDetectionResult;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Create and initialize an agentic browser analyzer
+ */
+declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
+
 /**
  * Loamly Tracker Types
  * @module @loamly/tracker
@@ -106,7 +168,18 @@ interface LoamlyTracker {
 /**
  * Loamly Tracker Core
  *
- * Cookie-free, privacy-first analytics with AI traffic detection.
+ * Cookie-free, privacy-first analytics with comprehensive AI traffic detection.
+ *
+ * Features:
+ * - Navigation Timing API (paste vs click detection)
+ * - Behavioral ML Classifier (mouse, scroll, interaction patterns)
+ * - Focus/Blur Sequence Analysis (copy-paste detection)
+ * - Agentic Browser Detection (Comet, CDP, teleporting clicks)
+ * - Advanced Scroll Tracking (30% chunk reporting)
+ * - Universal Form Tracking (HubSpot, Typeform, native)
+ * - SPA Navigation Support (History API hooks)
+ * - Event Queue with Retry (offline support)
+ * - Real-time Ping (heartbeat)
  *
  * @module @loamly/tracker
  */
@@ -114,7 +187,9 @@ interface LoamlyTracker {
 /**
  * The Loamly Tracker instance
  */
-declare const loamly: LoamlyTracker;
+declare const loamly: LoamlyTracker & {
+    getAgentic: () => AgenticDetectionResult | null;
+};
 
 /**
  * Navigation Timing API Detection
@@ -163,68 +238,6 @@ declare function detectAIFromReferrer(referrer: string): AIDetectionResult | nul
  */
 declare function detectAIFromUTM(url: string): AIDetectionResult | null;
 
-/**
- * Agentic Browser Detection
- *
- * LOA-187: Detects AI agentic browsers like Perplexity Comet, ChatGPT Atlas,
- * and other automated browsing agents.
- *
- * Detection methods:
- * - DOM fingerprinting (Perplexity Comet overlay)
- * - Mouse movement patterns (teleporting clicks)
- * - CDP (Chrome DevTools Protocol) automation fingerprint
- * - navigator.webdriver detection
- *
- * @module @loamly/tracker/detection/agentic-browser
- * @license MIT
- */
-/**
- * Agentic detection result
- */
-interface AgenticDetectionResult {
-    /** Whether Perplexity Comet DOM element was detected */
-    cometDOMDetected: boolean;
-    /** Whether CDP automation was detected */
-    cdpDetected: boolean;
-    /** Mouse movement patterns */
-    mousePatterns: {
-        teleportingClicks: number;
-        totalMovements: number;
-    };
-    /** Overall agentic probability (0-1) */
-    agenticProbability: number;
-    /** Detection signals */
-    signals: string[];
-}
-/**
- * Agentic Browser Analyzer
- *
- * Combines all detection methods into a unified result.
- */
-declare class AgenticBrowserAnalyzer {
-    private cometDetector;
-    private mouseAnalyzer;
-    private cdpDetector;
-    private initialized;
-    constructor();
-    /**
-     * Initialize all detectors
-     */
-    init(): void;
-    /**
-     * Get current detection result
-     */
-    getResult(): AgenticDetectionResult;
-    /**
-     * Cleanup resources
-     */
-    destroy(): void;
-}
-/**
- * Create and initialize an agentic browser analyzer
- */
-declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
-
 /**
  * Loamly Tracker Configuration
  *
@@ -232,7 +245,7 @@ declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "1.8.0";
+declare const VERSION = "2.0.0";
 /**
  * Known AI platforms for referrer detection
  */

package/dist/index.d.ts

@@ -1,3 +1,65 @@
+/**
+ * Agentic Browser Detection
+ *
+ * LOA-187: Detects AI agentic browsers like Perplexity Comet, ChatGPT Atlas,
+ * and other automated browsing agents.
+ *
+ * Detection methods:
+ * - DOM fingerprinting (Perplexity Comet overlay)
+ * - Mouse movement patterns (teleporting clicks)
+ * - CDP (Chrome DevTools Protocol) automation fingerprint
+ * - navigator.webdriver detection
+ *
+ * @module @loamly/tracker/detection/agentic-browser
+ * @license MIT
+ */
+/**
+ * Agentic detection result
+ */
+interface AgenticDetectionResult {
+    /** Whether Perplexity Comet DOM element was detected */
+    cometDOMDetected: boolean;
+    /** Whether CDP automation was detected */
+    cdpDetected: boolean;
+    /** Mouse movement patterns */
+    mousePatterns: {
+        teleportingClicks: number;
+        totalMovements: number;
+    };
+    /** Overall agentic probability (0-1) */
+    agenticProbability: number;
+    /** Detection signals */
+    signals: string[];
+}
+/**
+ * Agentic Browser Analyzer
+ *
+ * Combines all detection methods into a unified result.
+ */
+declare class AgenticBrowserAnalyzer {
+    private cometDetector;
+    private mouseAnalyzer;
+    private cdpDetector;
+    private initialized;
+    constructor();
+    /**
+     * Initialize all detectors
+     */
+    init(): void;
+    /**
+     * Get current detection result
+     */
+    getResult(): AgenticDetectionResult;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Create and initialize an agentic browser analyzer
+ */
+declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
+
 /**
  * Loamly Tracker Types
  * @module @loamly/tracker
@@ -106,7 +168,18 @@ interface LoamlyTracker {
 /**
  * Loamly Tracker Core
  *
- * Cookie-free, privacy-first analytics with AI traffic detection.
+ * Cookie-free, privacy-first analytics with comprehensive AI traffic detection.
+ *
+ * Features:
+ * - Navigation Timing API (paste vs click detection)
+ * - Behavioral ML Classifier (mouse, scroll, interaction patterns)
+ * - Focus/Blur Sequence Analysis (copy-paste detection)
+ * - Agentic Browser Detection (Comet, CDP, teleporting clicks)
+ * - Advanced Scroll Tracking (30% chunk reporting)
+ * - Universal Form Tracking (HubSpot, Typeform, native)
+ * - SPA Navigation Support (History API hooks)
+ * - Event Queue with Retry (offline support)
+ * - Real-time Ping (heartbeat)
  *
  * @module @loamly/tracker
  */
@@ -114,7 +187,9 @@ interface LoamlyTracker {
 /**
  * The Loamly Tracker instance
  */
-declare const loamly: LoamlyTracker;
+declare const loamly: LoamlyTracker & {
+    getAgentic: () => AgenticDetectionResult | null;
+};
 
 /**
  * Navigation Timing API Detection
@@ -163,68 +238,6 @@ declare function detectAIFromReferrer(referrer: string): AIDetectionResult | nul
  */
 declare function detectAIFromUTM(url: string): AIDetectionResult | null;
 
-/**
- * Agentic Browser Detection
- *
- * LOA-187: Detects AI agentic browsers like Perplexity Comet, ChatGPT Atlas,
- * and other automated browsing agents.
- *
- * Detection methods:
- * - DOM fingerprinting (Perplexity Comet overlay)
- * - Mouse movement patterns (teleporting clicks)
- * - CDP (Chrome DevTools Protocol) automation fingerprint
- * - navigator.webdriver detection
- *
- * @module @loamly/tracker/detection/agentic-browser
- * @license MIT
- */
-/**
- * Agentic detection result
- */
-interface AgenticDetectionResult {
-    /** Whether Perplexity Comet DOM element was detected */
-    cometDOMDetected: boolean;
-    /** Whether CDP automation was detected */
-    cdpDetected: boolean;
-    /** Mouse movement patterns */
-    mousePatterns: {
-        teleportingClicks: number;
-        totalMovements: number;
-    };
-    /** Overall agentic probability (0-1) */
-    agenticProbability: number;
-    /** Detection signals */
-    signals: string[];
-}
-/**
- * Agentic Browser Analyzer
- *
- * Combines all detection methods into a unified result.
- */
-declare class AgenticBrowserAnalyzer {
-    private cometDetector;
-    private mouseAnalyzer;
-    private cdpDetector;
-    private initialized;
-    constructor();
-    /**
-     * Initialize all detectors
-     */
-    init(): void;
-    /**
-     * Get current detection result
-     */
-    getResult(): AgenticDetectionResult;
-    /**
-     * Cleanup resources
-     */
-    destroy(): void;
-}
-/**
- * Create and initialize an agentic browser analyzer
- */
-declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
-
 /**
  * Loamly Tracker Configuration
  *
@@ -232,7 +245,7 @@ declare function createAgenticAnalyzer(): AgenticBrowserAnalyzer;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "1.8.0";
+declare const VERSION = "2.0.0";
 /**
  * Known AI platforms for referrer detection
  */