@loamly/tracker 2.0.1 → 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.1";
+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)
@@ -1852,50 +1874,66 @@ function init(userConfig = {}) {
   });
   spaRouter.start();
   setupUnloadHandlers();
+  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");
@@ -2197,6 +2235,39 @@ function getAgenticResult() {
 function isTrackerInitialized() {
   return initialized;
 }
+function reportHealth(status, errorMessage) {
+  if (!config.apiKey) return;
+  try {
+    const healthData = {
+      workspace_id: config.apiKey,
+      status,
+      error_message: errorMessage || null,
+      version: VERSION,
+      url: typeof window !== "undefined" ? window.location.href : null,
+      user_agent: typeof navigator !== "undefined" ? navigator.userAgent : null,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      features: {
+        scroll_tracker: !!scrollTracker,
+        time_tracker: !!timeTracker,
+        form_tracker: !!formTracker,
+        spa_router: !!spaRouter,
+        behavioral_ml: !!behavioralClassifier,
+        focus_blur: !!focusBlurAnalyzer,
+        agentic: !!agenticAnalyzer,
+        ping_service: !!pingService,
+        event_queue: !!eventQueue
+      }
+    };
+    safeFetch(endpoint(DEFAULT_CONFIG.endpoints.health), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(healthData)
+    }).catch(() => {
+    });
+    log("Health reported:", status);
+  } catch {
+  }
+}
 function reset() {
   log("Resetting tracker");
   pingService?.stop();
@@ -2246,7 +2317,8 @@ var loamly = {
   getAgentic: getAgenticResult,
   isInitialized: isTrackerInitialized,
   reset,
-  debug: setDebug
+  debug: setDebug,
+  reportHealth
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {