@loamly/tracker 2.0.1 → 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 */
@@ -189,6 +213,7 @@ interface LoamlyTracker {
  */
 declare const loamly: LoamlyTracker & {
     getAgentic: () => AgenticDetectionResult | null;
+    reportHealth: (status: 'initialized' | 'error' | 'ready', errorMessage?: string) => void;
 };
 
 /**
@@ -245,7 +270,7 @@ declare function detectAIFromUTM(url: string): AIDetectionResult | null;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "2.0.1";
+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 */
@@ -189,6 +213,7 @@ interface LoamlyTracker {
  */
 declare const loamly: LoamlyTracker & {
     getAgentic: () => AgenticDetectionResult | null;
+    reportHealth: (status: 'initialized' | 'error' | 'ready', errorMessage?: string) => void;
 };
 
 /**
@@ -245,7 +270,7 @@ declare function detectAIFromUTM(url: string): AIDetectionResult | null;
  * @license MIT
  * @see https://github.com/loamly/loamly
  */
-declare const VERSION = "2.0.1";
+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.1";
+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)
@@ -1817,50 +1839,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");
@@ -2162,6 +2200,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();
@@ -2211,7 +2282,8 @@ var loamly = {
   getAgentic: getAgenticResult,
   isInitialized: isTrackerInitialized,
   reset,
-  debug: setDebug
+  debug: setDebug,
+  reportHealth
 };
 export {
   AI_BOT_PATTERNS,