@loamly/tracker 2.0.2 → 2.1.1

package/README.md

@@ -30,7 +30,7 @@ Combined with [@loamly/edge](../edge/) for server-side detection, you get **75-8
 ```html
 <script src="https://cdn.jsdelivr.net/npm/@loamly/tracker@2/dist/loamly.iife.min.global.js"></script>
 <script>
-  Loamly.init({ apiKey: 'your-api-key' });
+  Loamly.init({ apiKey: 'your-api-key', workspaceId: 'your-workspace-uuid' });
 </script>
 ```
 
@@ -43,7 +43,7 @@ npm install @loamly/tracker
 ```typescript
 import { loamly } from '@loamly/tracker';
 
-loamly.init({ apiKey: 'your-api-key' });
+loamly.init({ apiKey: 'your-api-key', workspaceId: 'your-workspace-uuid' });
 ```
 
 ## Features
@@ -102,7 +102,8 @@ Initialize the tracker with configuration.
 
 ```typescript
 loamly.init({
-  apiKey: 'your-api-key',        // Required
+  apiKey: 'your-api-key',           // Required
+  workspaceId: 'your-workspace-uuid', // Required for public tracker keys
   apiHost: 'https://app.loamly.ai', // Optional: custom host
   debug: true,                    // Optional: enable console logging
   disableAutoPageview: false,     // Optional: disable auto pageview
@@ -110,6 +111,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.