humanbehavior-js 0.4.12 → 0.4.13

package/dist/cjs/index.cjs

@@ -13181,6 +13181,7 @@ class HumanBehaviorTracker {
      * This is the main entry point - call this once per page
      */
     static init(apiKey, options) {
+        var _a;
         // ✅ SUPPRESS COMMON RRWEB ERRORS FOR CLEAN CONSOLE
         if (isBrowser && (options === null || options === void 0 ? void 0 : options.suppressConsoleErrors) !== false) {
             // Suppress canvas security errors
@@ -13239,6 +13240,8 @@ class HumanBehaviorTracker {
         }
         // Create new tracker instance
         const tracker = new HumanBehaviorTracker(apiKey, options === null || options === void 0 ? void 0 : options.ingestionUrl);
+        // Store canvas recording preference
+        tracker.recordCanvas = (_a = options === null || options === void 0 ? void 0 : options.recordCanvas) !== null && _a !== void 0 ? _a : false;
         // Set redacted fields if specified
         if (options === null || options === void 0 ? void 0 : options.redactFields) {
             tracker.setRedactedFields(options.redactFields);
@@ -13277,6 +13280,7 @@ class HumanBehaviorTracker {
         this.sessionStartTime = Date.now();
         this.rrwebRecord = null;
         this.fullSnapshotTimeout = null;
+        this.recordCanvas = false; // Store canvas recording preference
         if (!apiKey) {
             throw new Error('Human Behavior API Key is required');
         }
@@ -13861,7 +13865,13 @@ class HumanBehaviorTracker {
                     collectFonts: false, // Disable font collection to reduce errors
                     inlineStylesheet: true, // Keep styles for proper session replay
                     recordCrossOriginIframes: false, // Prevent cross-origin iframe errors
-                    recordCanvas: false, // Disabled to prevent large data URIs and canvas errors
+                    // ✅ CANVAS RECORDING - PostHog-style protection against overwhelm
+                    recordCanvas: this.recordCanvas, // Opt-in only
+                    sampling: this.recordCanvas ? { canvas: 4 } : undefined, // 4 FPS throttle
+                    dataURLOptions: this.recordCanvas ? {
+                        type: 'image/webp',
+                        quality: 0.4
+                    } : undefined, // WebP with 40% quality
                     // ✅ FULLSNAPSHOT GENERATION - No periodic snapshots to avoid animation issues
                     // Rely on initial FullSnapshot + navigation-triggered ones only
                 });