@loamly/tracker 2.0.2 → 2.1.0

package/dist/index.d.mts

@@ -77,6 +77,30 @@ interface LoamlyConfig {
     disableBehavioral?: boolean;
     /** Custom session timeout in milliseconds (default: 30 minutes) */
     sessionTimeout?: number;
+    /**
+     * Feature flags for lightweight mode
+     * Set to false to reduce initialization overhead
+     */
+    features?: {
+        /** Scroll depth tracking (default: true) */
+        scroll?: boolean;
+        /** Time on page tracking (default: true) */
+        time?: boolean;
+        /** Form interaction tracking (default: true) */
+        forms?: boolean;
+        /** SPA navigation support (default: true) */
+        spa?: boolean;
+        /** Behavioral ML classification (default: true) */
+        behavioralML?: boolean;
+        /** Focus/blur paste detection (default: true) */
+        focusBlur?: boolean;
+        /** Agentic browser detection (default: true) */
+        agentic?: boolean;
+        /** Event queue with retry (default: true) */
+        eventQueue?: boolean;
+        /** Heartbeat ping service (default: false - opt-in) */
+        ping?: boolean;
+    };
 }
 interface TrackEventOptions {
     /** Custom properties to attach to the event */
@@ -246,7 +270,7 @@ declare function detectAIFromUTM(url: string): AIDetectionResult | null;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "2.0.2";
+declare const VERSION = "2.1.0";
 /**
  * Known AI platforms for referrer detection
  */

package/dist/index.d.ts

@@ -77,6 +77,30 @@ interface LoamlyConfig {
     disableBehavioral?: boolean;
     /** Custom session timeout in milliseconds (default: 30 minutes) */
     sessionTimeout?: number;
+    /**
+     * Feature flags for lightweight mode
+     * Set to false to reduce initialization overhead
+     */
+    features?: {
+        /** Scroll depth tracking (default: true) */
+        scroll?: boolean;
+        /** Time on page tracking (default: true) */
+        time?: boolean;
+        /** Form interaction tracking (default: true) */
+        forms?: boolean;
+        /** SPA navigation support (default: true) */
+        spa?: boolean;
+        /** Behavioral ML classification (default: true) */
+        behavioralML?: boolean;
+        /** Focus/blur paste detection (default: true) */
+        focusBlur?: boolean;
+        /** Agentic browser detection (default: true) */
+        agentic?: boolean;
+        /** Event queue with retry (default: true) */
+        eventQueue?: boolean;
+        /** Heartbeat ping service (default: false - opt-in) */
+        ping?: boolean;
+    };
 }
 interface TrackEventOptions {
     /** Custom properties to attach to the event */
@@ -246,7 +270,7 @@ declare function detectAIFromUTM(url: string): AIDetectionResult | null;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "2.0.2";
+declare const VERSION = "2.1.0";
 /**
  * Known AI platforms for referrer detection
  */

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/config.ts
-var VERSION = "2.0.2";
+var VERSION = "2.1.0";
 var DEFAULT_CONFIG = {
   apiHost: "https://app.loamly.ai",
   endpoints: {
@@ -1770,16 +1770,32 @@ function init(userConfig = {}) {
     apiHost: userConfig.apiHost || DEFAULT_CONFIG.apiHost
   };
   debugMode = userConfig.debug ?? false;
+  const features = {
+    scroll: true,
+    time: true,
+    forms: true,
+    spa: true,
+    behavioralML: true,
+    focusBlur: true,
+    agentic: true,
+    eventQueue: true,
+    ping: false,
+    // Opt-in only
+    ...userConfig.features
+  };
   log("Initializing Loamly Tracker v" + VERSION);
+  log("Features:", features);
   visitorId = getVisitorId();
   log("Visitor ID:", visitorId);
   const session = getSessionId();
   sessionId = session.sessionId;
   log("Session ID:", sessionId, session.isNew ? "(new)" : "(existing)");
-  eventQueue = new EventQueue(endpoint(DEFAULT_CONFIG.endpoints.behavioral), {
-    batchSize: DEFAULT_CONFIG.batchSize,
-    batchTimeout: DEFAULT_CONFIG.batchTimeout
-  });
+  if (features.eventQueue) {
+    eventQueue = new EventQueue(endpoint(DEFAULT_CONFIG.endpoints.behavioral), {
+      batchSize: DEFAULT_CONFIG.batchSize,
+      batchTimeout: DEFAULT_CONFIG.batchTimeout
+    });
+  }
   navigationTiming = detectNavigationType();
   log("Navigation timing:", navigationTiming);
   aiDetection = detectAIFromReferrer(document.referrer) || detectAIFromUTM(window.location.href);
@@ -1791,21 +1807,27 @@ function init(userConfig = {}) {
     pageview();
   }
   if (!userConfig.disableBehavioral) {
-    setupAdvancedBehavioralTracking();
+    setupAdvancedBehavioralTracking(features);
+  }
+  if (features.behavioralML) {
+    behavioralClassifier = new BehavioralClassifier(1e4);
+    behavioralClassifier.setOnClassify(handleBehavioralClassification);
+    setupBehavioralMLTracking();
+  }
+  if (features.focusBlur) {
+    focusBlurAnalyzer = new FocusBlurAnalyzer();
+    focusBlurAnalyzer.initTracking();
+    setTimeout(() => {
+      if (focusBlurAnalyzer) {
+        handleFocusBlurAnalysis(focusBlurAnalyzer.analyze());
+      }
+    }, 5e3);
   }
-  behavioralClassifier = new BehavioralClassifier(1e4);
-  behavioralClassifier.setOnClassify(handleBehavioralClassification);
-  setupBehavioralMLTracking();
-  focusBlurAnalyzer = new FocusBlurAnalyzer();
-  focusBlurAnalyzer.initTracking();
-  setTimeout(() => {
-    if (focusBlurAnalyzer) {
-      handleFocusBlurAnalysis(focusBlurAnalyzer.analyze());
-    }
-  }, 5e3);
-  agenticAnalyzer = new AgenticBrowserAnalyzer();
-  agenticAnalyzer.init();
-  if (visitorId && sessionId) {
+  if (features.agentic) {
+    agenticAnalyzer = new AgenticBrowserAnalyzer();
+    agenticAnalyzer.init();
+  }
+  if (features.ping && visitorId && sessionId) {
     pingService = new PingService(sessionId, visitorId, VERSION, {
       interval: DEFAULT_CONFIG.pingInterval,
       endpoint: endpoint(DEFAULT_CONFIG.endpoints.ping)
@@ -1820,48 +1842,63 @@ function init(userConfig = {}) {
   reportHealth("initialized");
   log("Initialization complete");
 }
-function setupAdvancedBehavioralTracking() {
-  scrollTracker = new ScrollTracker({
-    chunks: [30, 60, 90, 100],
-    onChunkReached: (event) => {
-      log("Scroll chunk:", event.chunk);
-      queueEvent("scroll_depth", {
-        depth: event.depth,
-        chunk: event.chunk,
-        time_to_reach_ms: event.time_to_reach_ms
-      });
-    }
-  });
-  scrollTracker.start();
-  timeTracker = new TimeTracker({
-    updateIntervalMs: 1e4,
-    // Report every 10 seconds
-    onUpdate: (event) => {
-      if (event.active_time_ms >= DEFAULT_CONFIG.timeSpentThresholdMs) {
-        queueEvent("time_spent", {
-          active_time_ms: event.active_time_ms,
-          total_time_ms: event.total_time_ms,
-          idle_time_ms: event.idle_time_ms,
-          is_engaged: event.is_engaged
+function setupAdvancedBehavioralTracking(features) {
+  if (features.scroll) {
+    scrollTracker = new ScrollTracker({
+      chunks: [30, 60, 90, 100],
+      onChunkReached: (event) => {
+        log("Scroll chunk:", event.chunk);
+        queueEvent("scroll_depth", {
+          depth: event.depth,
+          chunk: event.chunk,
+          time_to_reach_ms: event.time_to_reach_ms
         });
       }
-    }
-  });
-  timeTracker.start();
-  formTracker = new FormTracker({
-    onFormEvent: (event) => {
-      log("Form event:", event.event_type, event.form_id);
-      queueEvent(event.event_type, {
-        form_id: event.form_id,
-        form_type: event.form_type,
-        field_name: event.field_name,
-        field_type: event.field_type,
-        time_to_submit_ms: event.time_to_submit_ms,
-        is_conversion: event.is_conversion
-      });
-    }
-  });
-  formTracker.start();
+    });
+    scrollTracker.start();
+  }
+  if (features.time) {
+    timeTracker = new TimeTracker({
+      updateIntervalMs: 1e4,
+      // Report every 10 seconds
+      onUpdate: (event) => {
+        if (event.active_time_ms >= DEFAULT_CONFIG.timeSpentThresholdMs) {
+          queueEvent("time_spent", {
+            active_time_ms: event.active_time_ms,
+            total_time_ms: event.total_time_ms,
+            idle_time_ms: event.idle_time_ms,
+            is_engaged: event.is_engaged
+          });
+        }
+      }
+    });
+    timeTracker.start();
+  }
+  if (features.forms) {
+    formTracker = new FormTracker({
+      onFormEvent: (event) => {
+        log("Form event:", event.event_type, event.form_id);
+        queueEvent(event.event_type, {
+          form_id: event.form_id,
+          form_type: event.form_type,
+          field_name: event.field_name,
+          field_type: event.field_type,
+          time_to_submit_ms: event.time_to_submit_ms,
+          is_conversion: event.is_conversion
+        });
+      }
+    });
+    formTracker.start();
+  }
+  if (features.spa) {
+    spaRouter = new SPARouter({
+      onNavigate: (event) => {
+        log("SPA navigation:", event.navigation_type);
+        pageview(event.to_url);
+      }
+    });
+    spaRouter.start();
+  }
   document.addEventListener("click", (e) => {
     const target = e.target;
     const link = target.closest("a");