@coralogix/browser 3.0.2 → 3.1.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 3.1.0 (2026-01-25)
+
+### 🚀 Features
+- Add optimized mutation handling in session recorder
+
 ## 3.0.2 (2026-01-20)
 
 ### 🩹 Fixes

package/index.esm2.js

@@ -212,7 +212,7 @@ var BATCH_TIME_DELAY = 1000;
 var SESSION_RECORDING_POSTFIX_URL = '/browser/alpha/sessionrecording';
 var SESSION_KEY = 'rum_session';
 var PREV_SESSION_KEY = 'rum_prev_session';
-var MAX_MUTATIONS_FOR_SESSION_RECORDING = 5000;
+var MUTATION_LIMIT = 10000;
 var DEFAULT_SESSION_CONFIG = {
     sessionSampleRate: 100,
     onlyWithErrorConfig: {
@@ -4138,7 +4138,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.0.2';
+var SDK_VERSION = '3.1.0';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -5089,4 +5089,4 @@ var SessionRecordingEventType;
     SessionRecordingEventType[SessionRecordingEventType["Plugin"] = 6] = "Plugin";
 })(SessionRecordingEventType || (SessionRecordingEventType = {}));
 
-export { BATCH_TIME_DELAY as B, CxGlobal as C, MAX_BATCH_TIME_MS as M, OtelNetworkAttrs as O, PerformanceTypes as P, Request as R, SESSION_RECORDER_SEGMENTS_MAP as S, UrlBasedLabelProvider as U, getNowTime as a, SESSION_RECORDING_NETWORK_ERR0R_MESSAGE as b, SESSION_RECORDING_DEFAULT_HEADERS as c, SESSION_RECORDING_POSTFIX_URL as d, SESSION_RECORDER_KEY as e, MAX_MUTATIONS_FOR_SESSION_RECORDING as f, getSdkConfig as g, SESSION_RECORDING_DEFAULT_ERROR_MESSAGE as h, CoralogixRum as i, CoralogixLogSeverity as j, SessionRecordingEventType as k, CoralogixEventType as l, UrlType as m, reportInternalEvent as r };
+export { BATCH_TIME_DELAY as B, CxGlobal as C, MAX_BATCH_TIME_MS as M, OtelNetworkAttrs as O, PerformanceTypes as P, Request as R, SESSION_RECORDER_SEGMENTS_MAP as S, UrlBasedLabelProvider as U, getNowTime as a, SESSION_RECORDING_NETWORK_ERR0R_MESSAGE as b, SESSION_RECORDING_DEFAULT_HEADERS as c, SESSION_RECORDING_POSTFIX_URL as d, SESSION_RECORDER_KEY as e, MUTATION_LIMIT as f, getSdkConfig as g, SESSION_RECORDING_DEFAULT_ERROR_MESSAGE as h, CoralogixRum as i, CoralogixLogSeverity as j, SessionRecordingEventType as k, CoralogixEventType as l, UrlType as m, reportInternalEvent as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralogix/browser",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "Official Coralogix SDK for browsers",
   "license": "Apache-2.0",
   "author": "Coralogix",

package/sessionRecorder.esm.js

@@ -1,5 +1,5 @@
 import { __awaiter, __generator, __assign } from 'tslib';
-import { C as CxGlobal, r as reportInternalEvent, g as getSdkConfig, S as SESSION_RECORDER_SEGMENTS_MAP, a as getNowTime, b as SESSION_RECORDING_NETWORK_ERR0R_MESSAGE, M as MAX_BATCH_TIME_MS, R as Request, c as SESSION_RECORDING_DEFAULT_HEADERS, d as SESSION_RECORDING_POSTFIX_URL, B as BATCH_TIME_DELAY, e as SESSION_RECORDER_KEY, f as MAX_MUTATIONS_FOR_SESSION_RECORDING, h as SESSION_RECORDING_DEFAULT_ERROR_MESSAGE } from './index.esm2.js';
+import { C as CxGlobal, g as getSdkConfig, S as SESSION_RECORDER_SEGMENTS_MAP, a as getNowTime, b as SESSION_RECORDING_NETWORK_ERR0R_MESSAGE, M as MAX_BATCH_TIME_MS, R as Request, c as SESSION_RECORDING_DEFAULT_HEADERS, d as SESSION_RECORDING_POSTFIX_URL, B as BATCH_TIME_DELAY, r as reportInternalEvent, e as SESSION_RECORDER_KEY, f as MUTATION_LIMIT, h as SESSION_RECORDING_DEFAULT_ERROR_MESSAGE } from './index.esm2.js';
 import { record } from 'rrweb';
 import { getRecordConsolePlugin } from '@rrweb/rrweb-plugin-console-record';
 import '@opentelemetry/sdk-trace-base';
@@ -1484,6 +1484,15 @@ var SessionRecorder = (function () {
         this.isErrorOccurred = false;
         this.debugMode = !!((_a = getSdkConfig()) === null || _a === void 0 ? void 0 : _a.debug);
         this._recordingStopDueToTimeout = false;
+        this.onMutation = function (mutations) {
+            var mutationsCount = _this.getMutationCount(mutations);
+            if (mutationsCount > _this.maxMutations) {
+                var message = "Recording stopped: mutation-limit exceeded - mutations: ".concat(mutationsCount, ", limit: ").concat(_this.maxMutations);
+                console.warn("Coralogix Browser SDK - ".concat(message));
+                reportInternalEvent('recording-stop', message);
+                _this.stopRecording();
+            }
+        };
         this.handleRecordEvent = function (event, isCheckout) {
             if (!_this.recordingStopped) {
                 if (_this.onlySessionWithErrorMode) {
@@ -1554,7 +1563,7 @@ var SessionRecorder = (function () {
         this.onlySessionWithErrorMode = onlySessionWithErrorMode;
         this.maxRecordTimeForSessionWithError = maxRecordTimeForSessionWithError;
         this.isAutoStartRecording = autoStartSessionRecording;
-        this.maxMutations = maxMutations !== null && maxMutations !== void 0 ? maxMutations : MAX_MUTATIONS_FOR_SESSION_RECORDING;
+        this.maxMutations = maxMutations !== null && maxMutations !== void 0 ? maxMutations : MUTATION_LIMIT;
         this.recordConfig = this.prepareRecordConfig(recordConfig);
         if (CxGlobal.Worker) {
             this.workerManager = new WorkerManager();
@@ -1606,7 +1615,6 @@ var SessionRecorder = (function () {
                         if (this.debugMode) {
                             console.debug('Coralogix Browser SDK - Session recording started');
                         }
-                        this.startMutationObserver();
                         this.resetBatching();
                         this.recordingStopped = false;
                         this.isErrorOccurred = false;
@@ -1645,31 +1653,12 @@ var SessionRecorder = (function () {
         this.hasRecording = false;
         this.prepareRecordEventsBeforeSend();
         this.clearIntervals();
-        this.stopMutationObserver();
-    };
-    SessionRecorder.prototype.stopMutationObserver = function () {
-        var _a;
-        (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
     };
-    SessionRecorder.prototype.startMutationObserver = function () {
-        var _this = this;
-        this.stopMutationObserver();
-        this.mutationObserver = new MutationObserver(function (mutations) {
-            if (mutations.length > _this.maxMutations) {
-                var message = "Coralogix Browser SDK - Recording stopped due to too many mutations ".concat(mutations.length);
-                console.warn(message);
-                reportInternalEvent('recording-stop', message);
-                _this.stopRecording();
-            }
-        });
-        this.mutationObserver.observe(document, {
-            attributes: false,
-            attributeOldValue: false,
-            characterData: false,
-            characterDataOldValue: false,
-            childList: true,
-            subtree: true,
-        });
+    SessionRecorder.prototype.getMutationCount = function (mutations) {
+        return (mutations.adds.length +
+            mutations.removes.length +
+            mutations.attributes.length +
+            mutations.texts.length);
     };
     SessionRecorder.prototype.clearIntervals = function () {
         if (this.batchingTimeInterval) {
@@ -1679,7 +1668,9 @@ var SessionRecorder = (function () {
     SessionRecorder.prototype.prepareRecordConfig = function (recordConfig) {
         var _a;
         var _b = recordConfig || {}, excludeDOMOptions = _b.excludeDOMOptions, recordConsoleEvents = _b.recordConsoleEvents;
-        this.recordConfig = __assign(__assign({}, recordConfig), { emit: this.handleRecordEvent, checkoutEveryNms: this.onlySessionWithErrorMode
+        this.recordConfig = __assign(__assign({}, recordConfig), { emit: this.handleRecordEvent, hooks: {
+                mutation: this.onMutation,
+            }, checkoutEveryNms: this.onlySessionWithErrorMode
                 ? this.maxRecordTimeForSessionWithError
                 : undefined, slimDOMOptions: __assign(__assign({}, excludeDOMOptions), { script: (_a = excludeDOMOptions === null || excludeDOMOptions === void 0 ? void 0 : excludeDOMOptions.script) !== null && _a !== void 0 ? _a : true }), plugins: recordConsoleEvents ? [getRecordConsolePlugin()] : [] });
         return this.recordConfig;

package/src/session/session.consts.d.ts

@@ -7,7 +7,7 @@ export declare const BATCH_TIME_DELAY: number;
 export declare const SESSION_RECORDING_POSTFIX_URL = "/browser/alpha/sessionrecording";
 export declare const SESSION_KEY: string;
 export declare const PREV_SESSION_KEY: string;
-export declare const MAX_MUTATIONS_FOR_SESSION_RECORDING: number;
+export declare const MUTATION_LIMIT: number;
 export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
 export declare const SESSION_IDLE_TIME: number;
 export declare const SESSION_EXPIRATION_TIME: number;

package/src/session/sessionRecorder.d.ts

@@ -21,7 +21,6 @@ export declare class SessionRecorder {
     private isErrorOccurred;
     private debugMode;
     private _recordingStopDueToTimeout;
-    private mutationObserver;
     private request;
     private workerManager;
     private isWorkerReady;
@@ -35,8 +34,8 @@ export declare class SessionRecorder {
     startRecording(): Promise<void>;
     screenshot(id: string): void;
     stopRecording(): void;
-    private stopMutationObserver;
-    private startMutationObserver;
+    private onMutation;
+    private getMutationCount;
     private clearIntervals;
     private prepareRecordConfig;
     private handleRecordEvent;

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.0.2";
+export declare const SDK_VERSION = "3.1.0";