@loamly/tracker 2.0.2 → 2.1.0

package/README.md

@@ -110,6 +110,29 @@ loamly.init({
 });
 ```
 
+### Lightweight Mode
+
+Disable specific features to reduce CPU/memory overhead:
+
+```typescript
+loamly.init({
+  apiKey: 'your-api-key',
+  features: {
+    scroll: true,       // Scroll depth tracking (default: true)
+    time: true,         // Time on page tracking (default: true)
+    forms: true,        // Form interaction tracking (default: true)
+    spa: true,          // SPA navigation support (default: true)
+    behavioralML: false, // Behavioral ML classification (default: true) - saves ~2KB CPU
+    focusBlur: true,    // Focus/blur paste detection (default: true)
+    agentic: false,     // Agentic browser detection (default: true) - saves ~1.5KB CPU
+    eventQueue: true,   // Event queue with retry (default: true)
+    ping: false,        // Heartbeat ping service (default: false - opt-in)
+  }
+});
+```
+
+**Note:** All features are included in the bundle (~11KB gzipped). The `features` config only affects runtime initialization, not download size.
+
 ### `track(eventName, options?)`
 
 Track a custom event.

package/dist/index.cjs

@@ -34,7 +34,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/config.ts
-var VERSION = "2.0.2";
+var VERSION = "2.1.0";
 var DEFAULT_CONFIG = {
   apiHost: "https://app.loamly.ai",
   endpoints: {
@@ -1805,16 +1805,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);
@@ -1826,21 +1842,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)
@@ -1855,48 +1877,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");