@multiplayer-app/session-recorder-browser 1.2.25 → 1.2.26

package/README.md

@@ -259,6 +259,32 @@ SessionRecorder.save()
 SessionRecorder.stop('Finished session') // optional: pass reason for stopping the session
 ```
 
+### Capture exceptions
+
+The browser SDK captures uncaught errors and unhandled promise rejections automatically and turns them into error traces that are linked to your session.
+
+For each error span we record:
+
+- status set to `ERROR`
+- standard exception attributes: `exception.type`, `exception.message`, `exception.stacktrace`
+
+Manual reporting (e.g. inside try/catch or library boundaries):
+
+```javascript
+import SessionRecorder from '@multiplayer-app/session-recorder-browser'
+
+try {
+  // code that may throw
+} catch (err) {
+  SessionRecorder.captureException(err) // Error | unknown | string
+}
+
+// You can also send arbitrary reasons
+SessionRecorder.captureException('Payment form validation failed')
+```
+
+When running in `CONTINUOUS` mode, any captured exception automatically marks the current trace as an error and auto‑saves the rolling window so you can replay the seconds leading up to the failure.
+
 Continuous session recordings may also be saved from within any service or component involved in a trace by adding the attributes below to a span:
 
 ```javascript

package/dist/browser/index.js

@@ -25243,7 +25243,7 @@ const DEFAULT_MAX_HTTP_CAPTURING_PAYLOAD_SIZE = 100000;
 const SESSION_RESPONSE = 'multiplayer-debug-session-response';
 const CONTINUOUS_DEBUGGING_TIMEOUT = 60000; // 1 minutes
 const DEBUG_SESSION_MAX_DURATION_SECONDS = 10 * 60 + 30; // TODO: move to shared config otel core
-const PACKAGE_VERSION_EXPORT = "1.2.25" || 0;
+const PACKAGE_VERSION_EXPORT = "1.2.26" || 0;
 // Regex patterns for OpenTelemetry ignore URLs
 const OTEL_IGNORE_URLS = [
     // Traces endpoint
@@ -26128,6 +26128,9 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _opentelemetry_instrumentation__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! @opentelemetry/instrumentation */ "../../node_modules/@opentelemetry/instrumentation/build/esm/autoLoader.js");
 /* harmony import */ var _opentelemetry_auto_instrumentations_web__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @opentelemetry/auto-instrumentations-web */ "../../node_modules/@opentelemetry/auto-instrumentations-web/build/esm/index.js");
 /* harmony import */ var _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! @multiplayer-app/session-recorder-common */ "../session-recorder-common/dist/esm/index-browser.js");
+/* harmony import */ var _opentelemetry_api__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! @opentelemetry/api */ "../../node_modules/@opentelemetry/api/build/esm/trace-api.js");
+/* harmony import */ var _opentelemetry_api__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! @opentelemetry/api */ "../../node_modules/@opentelemetry/api/build/esm/context-api.js");
+/* harmony import */ var _opentelemetry_api__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! @opentelemetry/api */ "../../node_modules/@opentelemetry/api/build/esm/trace/status.js");
 /* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../config */ "./src/config/index.ts");
 /* harmony import */ var _helpers__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./helpers */ "./src/otel/helpers.ts");
 
@@ -26140,10 +26143,13 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
+
 class TracerBrowserSDK {
     constructor() {
         this.allowedElements = new Set(['A', 'BUTTON']);
         this.sessionId = '';
+        this.globalErrorListenersRegistered = false;
     }
     setSessionId(sessionId, sessionType = _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionType.PLAIN) {
         this.sessionId = sessionId;
@@ -26282,6 +26288,7 @@ class TracerBrowserSDK {
                 }),
             ],
         });
+        this._registerGlobalErrorListeners();
     }
     start(sessionId, sessionType) {
         if (!this.tracerProvider) {
@@ -26301,6 +26308,39 @@ class TracerBrowserSDK {
         }
         this.exporter.setApiKey(apiKey);
     }
+    /**
+     * Capture an exception as an error span/event.
+     * If there is an active span, the exception will be recorded on it.
+     * Otherwise, a short-lived span will be created to hold the exception event.
+     */
+    captureException(error) {
+        if (!error)
+            return;
+        // Try to record on the currently active span first
+        const activeSpan = _opentelemetry_api__WEBPACK_IMPORTED_MODULE_10__.trace.getSpan(_opentelemetry_api__WEBPACK_IMPORTED_MODULE_11__.context.active());
+        if (activeSpan) {
+            try {
+                _multiplayer_app_session_recorder_common__WEBPACK_IMPORTED_MODULE_1__.SessionRecorderSdk.captureException(error);
+                return;
+            }
+            catch (_e) {
+                // fallthrough to creating a dedicated span
+            }
+        }
+        try {
+            const tracer = _opentelemetry_api__WEBPACK_IMPORTED_MODULE_10__.trace.getTracer('session-recorder');
+            const span = tracer.startSpan('exception');
+            span.recordException(error);
+            span.setStatus({ code: _opentelemetry_api__WEBPACK_IMPORTED_MODULE_12__.SpanStatusCode.ERROR, message: error.message });
+            span.end();
+        }
+        catch (_err) {
+            // eslint-disable-next-line no-console
+            if (true) {
+                console.warn('[MULTIPLAYER_SESSION_RECORDER] Failed to capture exception', _err);
+            }
+        }
+    }
     _getSpanSessionIdProcessor() {
         return {
             forceFlush: () => Promise.resolve(),
@@ -26314,6 +26354,28 @@ class TracerBrowserSDK {
             },
         };
     }
+    _registerGlobalErrorListeners() {
+        if (this.globalErrorListenersRegistered)
+            return;
+        if (typeof window === 'undefined')
+            return;
+        const errorHandler = (event) => {
+            const err = (event === null || event === void 0 ? void 0 : event.error) instanceof Error
+                ? event.error
+                : new Error((event === null || event === void 0 ? void 0 : event.message) || 'Script error');
+            this.captureException(err);
+        };
+        const rejectionHandler = (event) => {
+            const reason = (event && 'reason' in event) ? event.reason : undefined;
+            const err = reason instanceof Error
+                ? reason
+                : new Error(typeof reason === 'string' ? reason : 'Unhandled promise rejection');
+            this.captureException(err);
+        };
+        window.addEventListener('error', errorHandler);
+        window.addEventListener('unhandledrejection', rejectionHandler);
+        this.globalErrorListenersRegistered = true;
+    }
 }
 
 
@@ -27523,6 +27585,18 @@ class SessionRecorder extends lib0_observable__WEBPACK_IMPORTED_MODULE_14__.Obse
     set recordingButtonClickHandler(handler) {
         this._sessionWidget.buttonClickExternalHandler = handler;
     }
+    /**
+     * Capture an exception manually and send it as an error trace.
+     */
+    captureException(error) {
+        try {
+            const normalizedError = this._normalizeError(error);
+            this._tracer.captureException(normalizedError);
+        }
+        catch (e) {
+            this.error = (e === null || e === void 0 ? void 0 : e.message) || 'Failed to capture exception';
+        }
+    }
     /**
      * @description Check if session should be started/stopped automatically
      * @param {ISession} [sessionPayload]
@@ -27770,6 +27844,18 @@ class SessionRecorder extends lib0_observable__WEBPACK_IMPORTED_MODULE_14__.Obse
                 break;
         }
     }
+    _normalizeError(error) {
+        if (error instanceof Error)
+            return error;
+        if (typeof error === 'string')
+            return new Error(error);
+        try {
+            return new Error(JSON.stringify(error));
+        }
+        catch (_e) {
+            return new Error(String(error));
+        }
+    }
 }