@multiplayer-app/session-recorder-browser 1.3.22 → 1.3.24

package/README.md

@@ -114,6 +114,14 @@ SessionRecorder.init({
   // should be sent through `exporters`
   sampleTraceRatio: 0,
 
+  // crash buffer: keep a rolling window of rrweb + traces when no recording is active.
+  // when user starts a session or saves (e.g. on error), the buffer is flushed into the session.
+  buffering: {
+    enabled: true,           // enable/disable buffering (default: true)
+    windowMinutes: 1,        // rolling window size in minutes (default: 1)
+    snapshotIntervalMs: 30000 // full snapshot interval while buffering in ms (default: 30000)
+  },
+
   // optional: exporters allow you to send
   // OTLP data to observability platforms
   exporters: [

package/dist/browser/index.js

@@ -25054,7 +25054,7 @@ const CONTINUOUS_DEBUGGING_TIMEOUT = 60000; // 1 minutes
 const DEBUG_SESSION_MAX_DURATION_SECONDS = 10 * 60 + 30; // TODO: move to shared config otel core
 const REMOTE_SESSION_RECORDING_START = 'remote-session-recording:start';
 const REMOTE_SESSION_RECORDING_STOP = 'remote-session-recording:stop';
-const PACKAGE_VERSION_EXPORT = "1.3.22" || 0;
+const PACKAGE_VERSION_EXPORT = "1.3.24" || 0;
 // Regex patterns for OpenTelemetry ignore URLs
 const OTEL_IGNORE_URLS = [
     // Traces endpoint
@@ -25779,8 +25779,8 @@ class CrashBufferSpanProcessor {
                 this._crashBuffer.appendSpans([
                     {
                         ts: span.startTime[0] * 1000 + span.startTime[1] / 1000000,
-                        span: this._serializeSpan(span)
-                    }
+                        span: this._serializeSpan(span),
+                    },
                 ]);
             }
             return;
@@ -26063,13 +26063,14 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+const clientIdGenerator = _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderSdk.getIdGenerator(_multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.MULTIPLAYER_TRACE_CLIENT_ID_LENGTH);
 class TracerBrowserSDK {
     constructor() {
         this.clientId = '';
         this.sessionId = '';
         this.globalErrorListenersRegistered = false;
     }
-    setSessionId(sessionId, sessionType = _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.MANUAL) {
+    _setSessionId(sessionId, sessionType = _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.MANUAL) {
         this.sessionId = sessionId;
         if (!this.idGenerator) {
             throw new Error('Id generator not initialized');
@@ -26078,32 +26079,32 @@ class TracerBrowserSDK {
     }
     init(options) {
         this.config = options;
-        this.clientId = _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderSdk.getIdGenerator(_multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.MULTIPLAYER_TRACE_CLIENT_ID_LENGTH)();
+        this.clientId = clientIdGenerator();
         const { application, version, environment } = this.config;
         this.idGenerator = new _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderIdGenerator();
-        this.setSessionId('', _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.SESSION_CACHE);
+        this._setSessionId('', _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.SESSION_CACHE);
         this.exporter = new _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderBrowserTraceExporter({
             apiKey: options.apiKey,
             url: (0,_helpers__WEBPACK_IMPORTED_MODULE_3__.getExporterEndpoint)(options.exporterEndpoint),
-            usePostMessageFallback: options.usePostMessageFallback
+            usePostMessageFallback: options.usePostMessageFallback,
         });
         this.batchSpanProcessor = new _opentelemetry_sdk_trace_base__WEBPACK_IMPORTED_MODULE_5__.BatchSpanProcessor(this.exporter);
         this.tracerProvider = new _opentelemetry_sdk_trace_web__WEBPACK_IMPORTED_MODULE_6__.WebTracerProvider({
             resource: (0,_opentelemetry_resources__WEBPACK_IMPORTED_MODULE_7__.resourceFromAttributes)({
                 [_opentelemetry_semantic_conventions__WEBPACK_IMPORTED_MODULE_8__.SEMRESATTRS_SERVICE_NAME]: application,
                 [_opentelemetry_semantic_conventions__WEBPACK_IMPORTED_MODULE_8__.SEMRESATTRS_SERVICE_VERSION]: version,
-                [_opentelemetry_semantic_conventions__WEBPACK_IMPORTED_MODULE_8__.SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: environment
+                [_opentelemetry_semantic_conventions__WEBPACK_IMPORTED_MODULE_8__.SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: environment,
             }),
             idGenerator: this.idGenerator,
             sampler: new _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderTraceIdRatioBasedSampler(this.config.sampleTraceRatio),
             spanProcessors: [
                 this._getSpanSessionIdProcessor(),
-                new _CrashBufferSpanProcessor__WEBPACK_IMPORTED_MODULE_4__.CrashBufferSpanProcessor(this.batchSpanProcessor, this.crashBuffer, this.exporter.serializeSpan.bind(this.exporter))
-            ]
+                new _CrashBufferSpanProcessor__WEBPACK_IMPORTED_MODULE_4__.CrashBufferSpanProcessor(this.batchSpanProcessor, this.crashBuffer, this.exporter.serializeSpan.bind(this.exporter)),
+            ],
         });
         this.tracerProvider.register({
             // contextManager: new ZoneContextManager(),
-            propagator: new _opentelemetry_core__WEBPACK_IMPORTED_MODULE_9__.W3CTraceContextPropagator()
+            propagator: new _opentelemetry_core__WEBPACK_IMPORTED_MODULE_9__.W3CTraceContextPropagator(),
         });
         (0,_opentelemetry_instrumentation__WEBPACK_IMPORTED_MODULE_10__.registerInstrumentations)({
             tracerProvider: this.tracerProvider,
@@ -26131,7 +26132,7 @@ class TracerBrowserSDK {
                                     requestBody,
                                     responseBody,
                                     requestHeaders,
-                                    responseHeaders
+                                    responseHeaders,
                                 };
                                 (0,_helpers__WEBPACK_IMPORTED_MODULE_3__.processHttpPayload)(payload, this.config, span);
                             }
@@ -26139,7 +26140,7 @@ class TracerBrowserSDK {
                                 // eslint-disable-next-line
                                 console.error('[MULTIPLAYER_SESSION_RECORDER] Failed to capture xml-http payload', error);
                             }
-                        }
+                        },
                     },
                     '@opentelemetry/instrumentation-fetch': {
                         clearTimingResources: true,
@@ -26180,7 +26181,7 @@ class TracerBrowserSDK {
                                     requestBody,
                                     responseBody,
                                     requestHeaders,
-                                    responseHeaders
+                                    responseHeaders,
                                 };
                                 (0,_helpers__WEBPACK_IMPORTED_MODULE_3__.processHttpPayload)(payload, this.config, span);
                             }
@@ -26188,7 +26189,7 @@ class TracerBrowserSDK {
                                 // eslint-disable-next-line
                                 console.error('[MULTIPLAYER_SESSION_RECORDER] Failed to capture fetch payload', error);
                             }
-                        }
+                        },
                     },
                     '@opentelemetry/instrumentation-user-interaction': {
                         shouldPreventSpanCreation: (_event, element, span) => {
@@ -26201,10 +26202,10 @@ class TracerBrowserSDK {
                                 span.setAttribute(`target.attribute.${attribute.name}`, attribute.value);
                             });
                             return false;
-                        }
-                    }
-                })
-            ]
+                        },
+                    },
+                }),
+            ],
         });
         this._registerGlobalErrorListeners();
     }
@@ -26215,13 +26216,13 @@ class TracerBrowserSDK {
         if (!this.tracerProvider) {
             throw new Error('Configuration not initialized. Call init() before start().');
         }
-        this.setSessionId(sessionId, sessionType);
+        this._setSessionId(sessionId, sessionType);
     }
     stop() {
         if (!this.tracerProvider) {
             throw new Error('Configuration not initialized. Call init() before start().');
         }
-        this.setSessionId('', _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.SESSION_CACHE);
+        this._setSessionId('', _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.SESSION_CACHE);
     }
     setApiKey(apiKey) {
         if (!this.exporter) {
@@ -26229,6 +26230,14 @@ class TracerBrowserSDK {
         }
         this.exporter.setApiKey(apiKey);
     }
+    async exportTraces(spans) {
+        var _a;
+        if ((_a = this === null || this === void 0 ? void 0 : this.batchSpanProcessor) === null || _a === void 0 ? void 0 : _a.onEnd) {
+            spans.map((span) => { var _a; return (_a = this === null || this === void 0 ? void 0 : this.batchSpanProcessor) === null || _a === void 0 ? void 0 : _a.onEnd(span); });
+            // return this.batchSpanProcessor.onEnd()
+        }
+        throw new Error('Buffer span processor not initialized');
+    }
     /**
      * Capture an exception as an error span/event.
      * If there is an active span, the exception will be recorded on it.
@@ -26260,14 +26269,6 @@ class TracerBrowserSDK {
         }
         catch (_ignored) { }
     }
-    async exportTraces(spans) {
-        var _a;
-        if ((_a = this === null || this === void 0 ? void 0 : this.batchSpanProcessor) === null || _a === void 0 ? void 0 : _a.onEnd) {
-            spans.map((span) => { var _a; return (_a = this === null || this === void 0 ? void 0 : this.batchSpanProcessor) === null || _a === void 0 ? void 0 : _a.onEnd(span); });
-            // return this.batchSpanProcessor.onEnd()
-        }
-        throw new Error('Buffer span processor not initialized');
-    }
     _recordException(span, error, errorInfo) {
         span.recordException(error);
         span.setStatus({ code: _opentelemetry_api__WEBPACK_IMPORTED_MODULE_13__.SpanStatusCode.ERROR, message: error.message });
@@ -26290,7 +26291,7 @@ class TracerBrowserSDK {
                 if ((_a = this.sessionId) === null || _a === void 0 ? void 0 : _a.length) {
                     span.setAttribute(_multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.ATTR_MULTIPLAYER_SESSION_ID, this.sessionId);
                 }
-            }
+            },
         };
     }
     _registerGlobalErrorListeners() {
@@ -26759,7 +26760,7 @@ class RecorderBrowserSDK {
     constructor() {
         this.intervals = {
             restart: null,
-            bufferSnapshot: null
+            bufferSnapshot: null,
         };
         this.startedAt = '';
         this.stoppedAt = '';
@@ -26801,7 +26802,7 @@ class RecorderBrowserSDK {
                     return;
                 }
                 this._handleLiveSessionEvent(event, ts, sessionId, sessionType);
-            }
+            },
         });
         this.takeFullSnapshot();
         this._setupPeriodicSnapshots(sessionId, sessionType);
@@ -26878,8 +26879,8 @@ class RecorderBrowserSDK {
                 event: {
                     event: packedEvent,
                     eventType: event.type,
-                    timestamp: ts
-                }
+                    timestamp: ts,
+                },
             });
         }
         catch (error) {
@@ -26904,7 +26905,7 @@ class RecorderBrowserSDK {
             eventType: event.type,
             timestamp: ts,
             debugSessionId: sessionId,
-            debugSessionType: sessionType
+            debugSessionType: sessionType,
         });
     }
     /**
@@ -26918,7 +26919,7 @@ class RecorderBrowserSDK {
             sampling: { canvas: 5 },
             recordCanvas: (_c = this.config) === null || _c === void 0 ? void 0 : _c.recordCanvas,
             dataURLOptions: { type: 'image/webp', quality: 0.1 },
-            plugins: [(0,_rrweb_rrweb_plugin_console_record__WEBPACK_IMPORTED_MODULE_3__.getRecordConsolePlugin)({ level: ['log', 'error'] })]
+            plugins: [(0,_rrweb_rrweb_plugin_console_record__WEBPACK_IMPORTED_MODULE_3__.getRecordConsolePlugin)({ level: ['log', 'error'] })],
         };
         if (maskingConfig.maskInputOptions) {
             options.maskInputOptions = maskingConfig.maskInputOptions;
@@ -26980,7 +26981,7 @@ class ApiService {
         this.config = {
             apiKey: '',
             apiBaseUrl: '',
-            exporterEndpoint: ''
+            exporterEndpoint: '',
         };
     }
     /**
@@ -26990,7 +26991,7 @@ class ApiService {
     init(config) {
         this.config = {
             ...this.config,
-            ...config
+            ...config,
         };
     }
     /**
@@ -27084,14 +27085,14 @@ class ApiService {
             body: body ? JSON.stringify(body) : null,
             headers: {
                 'Content-Type': 'application/json',
-                ...(this.config.apiKey && { 'X-Api-Key': this.config.apiKey })
-            }
+                ...(this.config.apiKey && { 'X-Api-Key': this.config.apiKey }),
+            },
         };
         try {
             const response = await fetch(url, {
                 ...params,
                 credentials: 'include',
-                signal
+                signal,
             });
             if (!response.ok) {
                 throw new Error('Network response was not ok: ' + response.statusText);
@@ -27166,7 +27167,7 @@ class CrashBufferService {
         await this._safe(async () => {
             await this.db.setAttrs({
                 tabId: this.tabId,
-                ...attrs
+                ...attrs,
             });
         }, undefined);
     }
@@ -27184,7 +27185,7 @@ class CrashBufferService {
                 tabId: this.tabId,
                 ts: payload.ts,
                 isFullSnapshot: payload.isFullSnapshot,
-                event: payload.event
+                event: payload.event,
             });
         }, undefined);
         if (isFullSnapshot && this.requiresFullSnapshot) {
@@ -27214,7 +27215,7 @@ class CrashBufferService {
                 return {
                     tabId: this.tabId,
                     ts: p.ts,
-                    span: p.span
+                    span: p.span,
                 };
             });
             await this.db.appendSpans(records);
@@ -27263,7 +27264,7 @@ class CrashBufferService {
         const [rrweb, spans, attrs] = await Promise.all([
             this._safe(() => this.db.getRrwebEventsWindow(this.tabId, rrwebFromTs, toTs), []),
             this._safe(() => this.db.getOtelSpansWindow(this.tabId, fromTs, toTs), []),
-            this._safe(() => this.db.getAttrs(this.tabId), null)
+            this._safe(() => this.db.getAttrs(this.tabId), null),
         ]);
         const rrwebSorted = rrweb
             .sort((a, b) => a.ts - b.ts)
@@ -27284,12 +27285,12 @@ class CrashBufferService {
                 ? {
                     sessionAttributes: attrs.sessionAttributes,
                     resourceAttributes: attrs.resourceAttributes,
-                    userAttributes: attrs.userAttributes
+                    userAttributes: attrs.userAttributes,
                 }
                 : null,
             windowMs: this.windowMs,
             fromTs: replayStartTs,
-            toTs
+            toTs,
         };
     }
     async clear() {
@@ -27443,7 +27444,7 @@ class IndexedDBService {
         const db = await this.dbPromise;
         const payload = {
             ...attrs,
-            updatedAt: (_a = attrs.updatedAt) !== null && _a !== void 0 ? _a : Date.now()
+            updatedAt: (_a = attrs.updatedAt) !== null && _a !== void 0 ? _a : Date.now(),
         };
         return new Promise((resolve, reject) => {
             const tx = db.transaction(attrsStore, 'readwrite');
@@ -27686,7 +27687,7 @@ class IndexedDBService {
                     const r = attr.delete(tabId);
                     r.onsuccess = () => res();
                     r.onerror = () => rej(r.error);
-                })
+                }),
             ])
                 .then(() => {
                 // noop
@@ -31040,13 +31041,13 @@ var SessionRecorderIdGenerator = /** @class */ (function () {
         this.generateShortId = (0,_sdk__WEBPACK_IMPORTED_MODULE_1__.getIdGenerator)(8);
         this.sessionShortId = '';
         this.clientId = '';
-        this.sessionType = _type__WEBPACK_IMPORTED_MODULE_0__.SessionType.MANUAL;
+        this.sessionType;
     }
     SessionRecorderIdGenerator.prototype.generateTraceId = function () {
         var traceId = this.generateLongId();
-        if (!this.sessionShortId
-            && !this.sessionType
-            && !this.clientId) {
+        if ((!this.sessionShortId
+            && !this.clientId)
+            || !this.sessionType) {
             return traceId;
         }
         var sessionTypePrefix = _constants_constants_base__WEBPACK_IMPORTED_MODULE_2__.MULTIPLAYER_TRACE_PREFIX_MAP[this.sessionType];
@@ -31058,7 +31059,6 @@ var SessionRecorderIdGenerator = /** @class */ (function () {
         return this.generateShortId();
     };
     SessionRecorderIdGenerator.prototype.setSessionId = function (sessionShortId, sessionType, clientId) {
-        if (sessionType === void 0) { sessionType = _type__WEBPACK_IMPORTED_MODULE_0__.SessionType.MANUAL; }
         if (clientId === void 0) { clientId = ''; }
         if (!clientId &&
             [
@@ -31426,7 +31426,7 @@ var SessionRecorderBrowserTraceExporter = /** @class */ (function () {
             window.postMessage({
                 action: 'traces',
                 type: this.postMessageType,
-                payload: spans.map(function (span) { return _this.serializeSpan(span); })
+                payload: spans.map(function (span) { return _this.serializeSpan(span); }),
             }, this.postMessageTargetOrigin);
             resultCallback({ code: 0 });
         }
@@ -31444,7 +31444,7 @@ var SessionRecorderBrowserTraceExporter = /** @class */ (function () {
             headers: __assign(__assign({ 'Content-Type': 'application/json' }, (this.config.apiKey ? { Authorization: this.config.apiKey } : {})), (this.config.headers || {})),
             timeoutMillis: this.config.timeoutMillis,
             keepAlive: this.config.keepAlive,
-            concurrencyLimit: this.config.concurrencyLimit
+            concurrencyLimit: this.config.concurrencyLimit,
         });
     };
     SessionRecorderBrowserTraceExporter.prototype.setApiKey = function (apiKey) {