@multiplayer-app/session-recorder-common 1.3.31 → 1.3.33

package/dist/esnext/type/crash-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crash-buffer.d.ts","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,GAAG,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,GAAG,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAA;AAE1E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,iCAAiC,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,4BAA4B,EAAE,CAAA;IAC3C,SAAS,EAAE,0BAA0B,EAAE,CAAA;IACvC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,WAAW,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,EAAE,CAAC,CACD,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,MAAM,IAAI,CAAA;IACb,GAAG,CAAC,CACF,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,IAAI,CAAA;CACR;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,OAAO,CAAA;CAC7B"}
+{"version":3,"file":"crash-buffer.d.ts","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,GAAG,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,GAAG,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAA;AAE1E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,iCAAiC,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,4BAA4B,EAAE,CAAA;IACtC,KAAK,EAAE,0BAA0B,EAAE,CAAA;CACpC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,WAAW,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,EAAE,CAAC,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACpH,GAAG,CAAC,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;CAChH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,OAAO,CAAA;CAC7B"}

package/dist/esnext/type/crash-buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"crash-buffer.js","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"","sourcesContent":["export type CrashBufferAttrs = {\n  sessionAttributes?: Record<string, any>\n  resourceAttributes?: Record<string, any>\n  userAttributes?: any\n}\n\nexport type CrashBufferRrwebEventPayload = {\n  ts: number\n  isFullSnapshot?: boolean\n  event: any\n}\n\nexport type CrashBufferOtelSpanPayload = {\n  ts: number\n  span: any\n}\n\n/**\n * Batch append payload for OTEL spans.\n * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,\n * just provided as an array to allow implementations to persist efficiently.\n */\nexport type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]\n\nexport type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload\n\nexport type CrashBufferEventName = 'error-span-appended'\n\nexport type CrashBufferEventMap = {\n  'error-span-appended': CrashBufferErrorSpanAppendedEvent\n}\n\nexport type CrashBufferSnapshot = {\n  rrwebEvents: CrashBufferRrwebEventPayload[]\n  otelSpans: CrashBufferOtelSpanPayload[]\n  attrs: CrashBufferAttrs | null\n  windowMs: number\n  fromTs: number\n  toTs: number\n}\n\n/**\n * Shared CrashBuffer contract used across browser + react-native implementations.\n *\n * Notes:\n * - `windowMs` is optional because browser implementations usually bake the window into the instance,\n *   while React Native typically passes it per call.\n * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.\n */\nexport interface CrashBuffer {\n  setAttrs(attrs: CrashBufferAttrs): Promise<void>\n  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>\n  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>\n  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>\n  clear(): Promise<void>\n  pruneOlderThan?(cutoffTs: number): Promise<void>\n  on?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): () => void\n  off?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): void\n}\n\n/**\n * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).\n */\nexport interface CrashBufferLifecycle extends CrashBuffer {\n  setActive(active: boolean): void\n  needsFullSnapshot(): boolean\n}\n"]}
+{"version":3,"file":"crash-buffer.js","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"","sourcesContent":["export type CrashBufferAttrs = {\n  sessionAttributes?: Record<string, any>\n  resourceAttributes?: Record<string, any>\n  userAttributes?: any\n}\n\nexport type CrashBufferRrwebEventPayload = {\n  ts: number\n  isFullSnapshot?: boolean\n  event: any\n}\n\nexport type CrashBufferOtelSpanPayload = {\n  ts: number\n  span: any\n}\n\n/**\n * Batch append payload for OTEL spans.\n * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,\n * just provided as an array to allow implementations to persist efficiently.\n */\nexport type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]\n\nexport type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload\n\nexport type CrashBufferEventName = 'error-span-appended'\n\nexport type CrashBufferEventMap = {\n  'error-span-appended': CrashBufferErrorSpanAppendedEvent\n}\n\nexport type CrashBufferSnapshot = {\n  startedAt: number\n  stoppedAt: number\n  events: CrashBufferRrwebEventPayload[]\n  spans: CrashBufferOtelSpanPayload[]\n}\n\n/**\n * Shared CrashBuffer contract used across browser + react-native implementations.\n *\n * Notes:\n * - `windowMs` is optional because browser implementations usually bake the window into the instance,\n *   while React Native typically passes it per call.\n * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.\n */\nexport interface CrashBuffer {\n  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>\n  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>\n  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>\n  clear(): Promise<void>\n  pruneOlderThan?(cutoffTs: number): Promise<void>\n  on?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): () => void\n  off?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): void\n}\n\n/**\n * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).\n */\nexport interface CrashBufferLifecycle extends CrashBuffer {\n  setActive(active: boolean): void\n  needsFullSnapshot(): boolean\n}\n"]}

package/dist/src/sdk/capture-exception.d.ts

@@ -4,4 +4,5 @@
  * @returns {void}
  */
 export declare const captureException: (error: Error, errorInfo?: Record<string, any>) => void;
+export declare const shouldCaptureException: (error: Error, _errorInfo?: Record<string, any>) => boolean;
 //# sourceMappingURL=capture-exception.d.ts.map

package/dist/src/sdk/capture-exception.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-exception.d.ts","sourceRoot":"","sources":["../../../src/sdk/capture-exception.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,KAAK,EACZ,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SAgDhC,CAAA"}
+{"version":3,"file":"capture-exception.d.ts","sourceRoot":"","sources":["../../../src/sdk/capture-exception.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,EAAE,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SA4C7E,CAAA;AAUD,eAAO,MAAM,sBAAsB,GAAI,OAAO,KAAK,EAAE,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,OAkCvF,CAAA"}

package/dist/src/sdk/capture-exception.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.captureException = void 0;
+exports.shouldCaptureException = exports.captureException = void 0;
 const api_1 = require("@opentelemetry/api");
 const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
 const set_resource_attributes_1 = require("./set-resource-attributes");
@@ -10,7 +10,7 @@ const set_resource_attributes_1 = require("./set-resource-attributes");
  * @returns {void}
  */
 const captureException = (error, errorInfo) => {
-    if (!error) {
+    if (!error || !(0, exports.shouldCaptureException)(error)) {
         return;
     }
     const activeContext = api_1.context.active();
@@ -18,7 +18,7 @@ const captureException = (error, errorInfo) => {
     let isNewSpan = false;
     if (!span || !span.isRecording()) {
         span = api_1.trace.getTracer('exception').startSpan(error.name || 'Error', {
-            attributes: Object.assign({ [semantic_conventions_1.ATTR_EXCEPTION_MESSAGE]: error.message, [semantic_conventions_1.ATTR_EXCEPTION_STACKTRACE]: error.stack, [semantic_conventions_1.ATTR_EXCEPTION_TYPE]: error.name }, (0, set_resource_attributes_1.getResourceAttributes)()),
+            attributes: Object.assign({ [semantic_conventions_1.ATTR_EXCEPTION_MESSAGE]: error.message, [semantic_conventions_1.ATTR_EXCEPTION_STACKTRACE]: error.stack, [semantic_conventions_1.ATTR_EXCEPTION_TYPE]: error.name }, (0, set_resource_attributes_1.getResourceAttributes)())
         });
         api_1.trace.setSpan(activeContext, span);
         isNewSpan = true;
@@ -27,7 +27,7 @@ const captureException = (error, errorInfo) => {
         span.setAttributes({
             [semantic_conventions_1.ATTR_EXCEPTION_MESSAGE]: error.message,
             [semantic_conventions_1.ATTR_EXCEPTION_STACKTRACE]: error.stack,
-            [semantic_conventions_1.ATTR_EXCEPTION_TYPE]: error.name,
+            [semantic_conventions_1.ATTR_EXCEPTION_TYPE]: error.name
         });
     }
     if (errorInfo) {
@@ -38,11 +38,46 @@ const captureException = (error, errorInfo) => {
     span.recordException(error);
     span.setStatus({
         code: api_1.SpanStatusCode.ERROR,
-        message: error.message,
+        message: error.message
     });
     if (isNewSpan) {
         span.end();
     }
 };
 exports.captureException = captureException;
+/**
+ * Best-effort deduplication of exceptions that fire multiple times
+ * (e.g. framework handler + global handlers) within a short time window.
+ */
+const exceptionDedupeWindowMs = 2000;
+const recentExceptionFingerprints = new Map();
+const shouldCaptureException = (error, _errorInfo) => {
+    if (!error)
+        return false;
+    const now = Date.now();
+    // Build a fingerprint that is stable enough across repeated emissions
+    // but not so broad that different errors collapse into one.
+    const keyParts = [];
+    keyParts.push(error.name || 'Error');
+    keyParts.push(error.message || '');
+    // First stack line tends to include file/line where it originated.
+    if (typeof error.stack === 'string') {
+        const firstFrame = error.stack.split('\n')[1] || '';
+        keyParts.push(firstFrame.trim());
+    }
+    const fingerprint = keyParts.join('|').slice(0, 500);
+    const lastSeen = recentExceptionFingerprints.get(fingerprint);
+    if (lastSeen && now - lastSeen < exceptionDedupeWindowMs) {
+        return false;
+    }
+    recentExceptionFingerprints.set(fingerprint, now);
+    // Cheap cleanup of old entries to avoid unbounded growth.
+    for (const [key, ts] of recentExceptionFingerprints) {
+        if (now - ts > exceptionDedupeWindowMs * 5) {
+            recentExceptionFingerprints.delete(key);
+        }
+    }
+    return true;
+};
+exports.shouldCaptureException = shouldCaptureException;
 //# sourceMappingURL=capture-exception.js.map

package/dist/src/sdk/capture-exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture-exception.js","sourceRoot":"","sources":["../../../src/sdk/capture-exception.ts"],"names":[],"mappings":";;;AAAA,4CAAmE;AACnE,8EAI4C;AAC5C,uEAAiE;AAEjE;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAC9B,KAAY,EACZ,SAA+B,EAC/B,EAAE;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAM;IACR,CAAC;IAED,MAAM,aAAa,GAAG,aAAO,CAAC,MAAM,EAAE,CAAA;IAEtC,IAAI,IAAI,GAAG,WAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACvC,IAAI,SAAS,GAAG,KAAK,CAAA;IAErB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,IAAI,GAAG,WAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,CAC3C,KAAK,CAAC,IAAI,IAAI,OAAO,EACrB;YACE,UAAU,kBACR,CAAC,6CAAsB,CAAC,EAAE,KAAK,CAAC,OAAO,EACvC,CAAC,gDAAyB,CAAC,EAAE,KAAK,CAAC,KAAK,EACxC,CAAC,0CAAmB,CAAC,EAAE,KAAK,CAAC,IAAI,IAC9B,IAAA,+CAAqB,GAAE,CAC3B;SACF,CACF,CAAA;QACD,WAAK,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;QAClC,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,aAAa,CAAC;YACjB,CAAC,6CAAsB,CAAC,EAAE,KAAK,CAAC,OAAO;YACvC,CAAC,gDAAyB,CAAC,EAAE,KAAK,CAAC,KAAK;YACxC,CAAC,0CAAmB,CAAC,EAAE,KAAK,CAAC,IAAI;SAClC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACjD,IAAI,CAAC,YAAY,CAAC,cAAc,GAAG,EAAE,EAAE,KAAK,CAAC,CAAA;QAC/C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC3B,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE,oBAAc,CAAC,KAAK;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAA;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,EAAE,CAAA;IACZ,CAAC;AACH,CAAC,CAAA;AAlDY,QAAA,gBAAgB,oBAkD5B","sourcesContent":["import { context, trace, SpanStatusCode } from '@opentelemetry/api'\nimport {\n  ATTR_EXCEPTION_MESSAGE,\n  ATTR_EXCEPTION_STACKTRACE,\n  ATTR_EXCEPTION_TYPE,\n} from '@opentelemetry/semantic-conventions'\nimport { getResourceAttributes } from './set-resource-attributes'\n\n/**\n * @description Add error to current span\n * @param {Error} error\n * @returns {void}\n */\nexport const captureException = (\n  error: Error,\n  errorInfo?: Record<string, any>,\n) => {\n  if (!error) {\n    return\n  }\n\n  const activeContext = context.active()\n\n  let span = trace.getSpan(activeContext)\n  let isNewSpan = false\n\n  if (!span || !span.isRecording()) {\n    span = trace.getTracer('exception').startSpan(\n      error.name || 'Error',\n      {\n        attributes: {\n          [ATTR_EXCEPTION_MESSAGE]: error.message,\n          [ATTR_EXCEPTION_STACKTRACE]: error.stack,\n          [ATTR_EXCEPTION_TYPE]: error.name,\n          ...getResourceAttributes(),\n        },\n      },\n    )\n    trace.setSpan(activeContext, span)\n    isNewSpan = true\n  } else {\n    span.setAttributes({\n      [ATTR_EXCEPTION_MESSAGE]: error.message,\n      [ATTR_EXCEPTION_STACKTRACE]: error.stack,\n      [ATTR_EXCEPTION_TYPE]: error.name,\n    })\n  }\n\n  if (errorInfo) {\n    Object.entries(errorInfo).forEach(([key, value]) => {\n      span.setAttribute(`error_info.${key}`, value)\n    })\n  }\n\n  span.recordException(error)\n  span.setStatus({\n    code: SpanStatusCode.ERROR,\n    message: error.message,\n  })\n\n  if (isNewSpan) {\n    span.end()\n  }\n}\n"]}
+{"version":3,"file":"capture-exception.js","sourceRoot":"","sources":["../../../src/sdk/capture-exception.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, trace, SpanStatusCode } from '@opentelemetry/api'\nimport {\n  ATTR_EXCEPTION_MESSAGE,\n  ATTR_EXCEPTION_STACKTRACE,\n  ATTR_EXCEPTION_TYPE\n} from '@opentelemetry/semantic-conventions'\nimport { getResourceAttributes } from './set-resource-attributes'\n\n/**\n * @description Add error to current span\n * @param {Error} error\n * @returns {void}\n */\nexport const captureException = (error: Error, errorInfo?: Record<string, any>) => {\n  if (!error || !shouldCaptureException(error)) {\n    return\n  }\n\n  const activeContext = context.active()\n\n  let span = trace.getSpan(activeContext)\n  let isNewSpan = false\n\n  if (!span || !span.isRecording()) {\n    span = trace.getTracer('exception').startSpan(error.name || 'Error', {\n      attributes: {\n        [ATTR_EXCEPTION_MESSAGE]: error.message,\n        [ATTR_EXCEPTION_STACKTRACE]: error.stack,\n        [ATTR_EXCEPTION_TYPE]: error.name,\n        ...getResourceAttributes()\n      }\n    })\n    trace.setSpan(activeContext, span)\n    isNewSpan = true\n  } else {\n    span.setAttributes({\n      [ATTR_EXCEPTION_MESSAGE]: error.message,\n      [ATTR_EXCEPTION_STACKTRACE]: error.stack,\n      [ATTR_EXCEPTION_TYPE]: error.name\n    })\n  }\n\n  if (errorInfo) {\n    Object.entries(errorInfo).forEach(([key, value]) => {\n      span.setAttribute(`error_info.${key}`, value)\n    })\n  }\n\n  span.recordException(error)\n  span.setStatus({\n    code: SpanStatusCode.ERROR,\n    message: error.message\n  })\n\n  if (isNewSpan) {\n    span.end()\n  }\n}\n\n/**\n * Best-effort deduplication of exceptions that fire multiple times\n * (e.g. framework handler + global handlers) within a short time window.\n */\n\nconst exceptionDedupeWindowMs = 2000\nconst recentExceptionFingerprints = new Map<string, number>()\n\nexport const shouldCaptureException = (error: Error, _errorInfo?: Record<string, any>): boolean => {\n  if (!error) return false\n\n  const now = Date.now()\n\n  // Build a fingerprint that is stable enough across repeated emissions\n  // but not so broad that different errors collapse into one.\n  const keyParts: string[] = []\n  keyParts.push(error.name || 'Error')\n  keyParts.push(error.message || '')\n\n  // First stack line tends to include file/line where it originated.\n  if (typeof error.stack === 'string') {\n    const firstFrame = error.stack.split('\\n')[1] || ''\n    keyParts.push(firstFrame.trim())\n  }\n\n  const fingerprint = keyParts.join('|').slice(0, 500)\n\n  const lastSeen = recentExceptionFingerprints.get(fingerprint)\n  if (lastSeen && now - lastSeen < exceptionDedupeWindowMs) {\n    return false\n  }\n\n  recentExceptionFingerprints.set(fingerprint, now)\n\n  // Cheap cleanup of old entries to avoid unbounded growth.\n  for (const [key, ts] of recentExceptionFingerprints) {\n    if (now - ts > exceptionDedupeWindowMs * 5) {\n      recentExceptionFingerprints.delete(key)\n    }\n  }\n\n  return true\n}\n"]}

package/dist/src/type/crash-buffer.d.ts

@@ -24,12 +24,10 @@ export type CrashBufferEventMap = {
     'error-span-appended': CrashBufferErrorSpanAppendedEvent;
 };
 export type CrashBufferSnapshot = {
-    rrwebEvents: CrashBufferRrwebEventPayload[];
-    otelSpans: CrashBufferOtelSpanPayload[];
-    attrs: CrashBufferAttrs | null;
-    windowMs: number;
-    fromTs: number;
-    toTs: number;
+    startedAt: number;
+    stoppedAt: number;
+    events: CrashBufferRrwebEventPayload[];
+    spans: CrashBufferOtelSpanPayload[];
 };
 /**
  * Shared CrashBuffer contract used across browser + react-native implementations.
@@ -40,7 +38,6 @@ export type CrashBufferSnapshot = {
  * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.
  */
 export interface CrashBuffer {
-    setAttrs(attrs: CrashBufferAttrs): Promise<void>;
     appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>;
     appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>;
     snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>;

package/dist/src/type/crash-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crash-buffer.d.ts","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,GAAG,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,GAAG,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAA;AAE1E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,iCAAiC,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,4BAA4B,EAAE,CAAA;IAC3C,SAAS,EAAE,0BAA0B,EAAE,CAAA;IACvC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,WAAW,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,EAAE,CAAC,CACD,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,MAAM,IAAI,CAAA;IACb,GAAG,CAAC,CACF,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GACrE,IAAI,CAAA;CACR;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,OAAO,CAAA;CAC7B"}
+{"version":3,"file":"crash-buffer.d.ts","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxC,cAAc,CAAC,EAAE,GAAG,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,GAAG,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAA;AAE1E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAA;AAE1E,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,qBAAqB,EAAE,iCAAiC,CAAA;CACzD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,4BAA4B,EAAE,CAAA;IACtC,KAAK,EAAE,0BAA0B,EAAE,CAAA;CACpC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,WAAW,CAAC,OAAO,EAAE,+BAA+B,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,EAAE,CAAC,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACpH,GAAG,CAAC,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;CAChH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,iBAAiB,IAAI,OAAO,CAAA;CAC7B"}

package/dist/src/type/crash-buffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"crash-buffer.js","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"","sourcesContent":["export type CrashBufferAttrs = {\n  sessionAttributes?: Record<string, any>\n  resourceAttributes?: Record<string, any>\n  userAttributes?: any\n}\n\nexport type CrashBufferRrwebEventPayload = {\n  ts: number\n  isFullSnapshot?: boolean\n  event: any\n}\n\nexport type CrashBufferOtelSpanPayload = {\n  ts: number\n  span: any\n}\n\n/**\n * Batch append payload for OTEL spans.\n * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,\n * just provided as an array to allow implementations to persist efficiently.\n */\nexport type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]\n\nexport type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload\n\nexport type CrashBufferEventName = 'error-span-appended'\n\nexport type CrashBufferEventMap = {\n  'error-span-appended': CrashBufferErrorSpanAppendedEvent\n}\n\nexport type CrashBufferSnapshot = {\n  rrwebEvents: CrashBufferRrwebEventPayload[]\n  otelSpans: CrashBufferOtelSpanPayload[]\n  attrs: CrashBufferAttrs | null\n  windowMs: number\n  fromTs: number\n  toTs: number\n}\n\n/**\n * Shared CrashBuffer contract used across browser + react-native implementations.\n *\n * Notes:\n * - `windowMs` is optional because browser implementations usually bake the window into the instance,\n *   while React Native typically passes it per call.\n * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.\n */\nexport interface CrashBuffer {\n  setAttrs(attrs: CrashBufferAttrs): Promise<void>\n  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>\n  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>\n  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>\n  clear(): Promise<void>\n  pruneOlderThan?(cutoffTs: number): Promise<void>\n  on?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): () => void\n  off?(\n    event: CrashBufferEventName,\n    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void\n  ): void\n}\n\n/**\n * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).\n */\nexport interface CrashBufferLifecycle extends CrashBuffer {\n  setActive(active: boolean): void\n  needsFullSnapshot(): boolean\n}\n"]}
+{"version":3,"file":"crash-buffer.js","sourceRoot":"","sources":["../../../src/type/crash-buffer.ts"],"names":[],"mappings":"","sourcesContent":["export type CrashBufferAttrs = {\n  sessionAttributes?: Record<string, any>\n  resourceAttributes?: Record<string, any>\n  userAttributes?: any\n}\n\nexport type CrashBufferRrwebEventPayload = {\n  ts: number\n  isFullSnapshot?: boolean\n  event: any\n}\n\nexport type CrashBufferOtelSpanPayload = {\n  ts: number\n  span: any\n}\n\n/**\n * Batch append payload for OTEL spans.\n * This is intentionally the same per-span shape as `CrashBufferOtelSpanPayload`,\n * just provided as an array to allow implementations to persist efficiently.\n */\nexport type CrashBufferOtelSpanBatchPayload = CrashBufferOtelSpanPayload[]\n\nexport type CrashBufferErrorSpanAppendedEvent = CrashBufferOtelSpanPayload\n\nexport type CrashBufferEventName = 'error-span-appended'\n\nexport type CrashBufferEventMap = {\n  'error-span-appended': CrashBufferErrorSpanAppendedEvent\n}\n\nexport type CrashBufferSnapshot = {\n  startedAt: number\n  stoppedAt: number\n  events: CrashBufferRrwebEventPayload[]\n  spans: CrashBufferOtelSpanPayload[]\n}\n\n/**\n * Shared CrashBuffer contract used across browser + react-native implementations.\n *\n * Notes:\n * - `windowMs` is optional because browser implementations usually bake the window into the instance,\n *   while React Native typically passes it per call.\n * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.\n */\nexport interface CrashBuffer {\n  appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>\n  appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>\n  snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>\n  clear(): Promise<void>\n  pruneOlderThan?(cutoffTs: number): Promise<void>\n  on?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): () => void\n  off?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): void\n}\n\n/**\n * Optional lifecycle controls supported by some CrashBuffer implementations (e.g. browser tabs).\n */\nexport interface CrashBufferLifecycle extends CrashBuffer {\n  setActive(active: boolean): void\n  needsFullSnapshot(): boolean\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplayer-app/session-recorder-common",
-  "version": "1.3.31",
+  "version": "1.3.33",
   "description": "Multiplayer Fullstack Session Recorder - opentelemetry",
   "author": {
     "name": "Multiplayer Software, Inc.",

package/src/sdk/capture-exception.ts

@@ -2,7 +2,7 @@ import { context, trace, SpanStatusCode } from '@opentelemetry/api'
 import {
   ATTR_EXCEPTION_MESSAGE,
   ATTR_EXCEPTION_STACKTRACE,
-  ATTR_EXCEPTION_TYPE,
+  ATTR_EXCEPTION_TYPE
 } from '@opentelemetry/semantic-conventions'
 import { getResourceAttributes } from './set-resource-attributes'
 
@@ -11,11 +11,8 @@ import { getResourceAttributes } from './set-resource-attributes'
  * @param {Error} error
  * @returns {void}
  */
-export const captureException = (
-  error: Error,
-  errorInfo?: Record<string, any>,
-) => {
-  if (!error) {
+export const captureException = (error: Error, errorInfo?: Record<string, any>) => {
+  if (!error || !shouldCaptureException(error)) {
     return
   }
 
@@ -25,24 +22,21 @@ export const captureException = (
   let isNewSpan = false
 
   if (!span || !span.isRecording()) {
-    span = trace.getTracer('exception').startSpan(
-      error.name || 'Error',
-      {
-        attributes: {
-          [ATTR_EXCEPTION_MESSAGE]: error.message,
-          [ATTR_EXCEPTION_STACKTRACE]: error.stack,
-          [ATTR_EXCEPTION_TYPE]: error.name,
-          ...getResourceAttributes(),
-        },
-      },
-    )
+    span = trace.getTracer('exception').startSpan(error.name || 'Error', {
+      attributes: {
+        [ATTR_EXCEPTION_MESSAGE]: error.message,
+        [ATTR_EXCEPTION_STACKTRACE]: error.stack,
+        [ATTR_EXCEPTION_TYPE]: error.name,
+        ...getResourceAttributes()
+      }
+    })
     trace.setSpan(activeContext, span)
     isNewSpan = true
   } else {
     span.setAttributes({
       [ATTR_EXCEPTION_MESSAGE]: error.message,
       [ATTR_EXCEPTION_STACKTRACE]: error.stack,
-      [ATTR_EXCEPTION_TYPE]: error.name,
+      [ATTR_EXCEPTION_TYPE]: error.name
     })
   }
 
@@ -55,10 +49,54 @@ export const captureException = (
   span.recordException(error)
   span.setStatus({
     code: SpanStatusCode.ERROR,
-    message: error.message,
+    message: error.message
   })
 
   if (isNewSpan) {
     span.end()
   }
 }
+
+/**
+ * Best-effort deduplication of exceptions that fire multiple times
+ * (e.g. framework handler + global handlers) within a short time window.
+ */
+
+const exceptionDedupeWindowMs = 2000
+const recentExceptionFingerprints = new Map<string, number>()
+
+export const shouldCaptureException = (error: Error, _errorInfo?: Record<string, any>): boolean => {
+  if (!error) return false
+
+  const now = Date.now()
+
+  // Build a fingerprint that is stable enough across repeated emissions
+  // but not so broad that different errors collapse into one.
+  const keyParts: string[] = []
+  keyParts.push(error.name || 'Error')
+  keyParts.push(error.message || '')
+
+  // First stack line tends to include file/line where it originated.
+  if (typeof error.stack === 'string') {
+    const firstFrame = error.stack.split('\n')[1] || ''
+    keyParts.push(firstFrame.trim())
+  }
+
+  const fingerprint = keyParts.join('|').slice(0, 500)
+
+  const lastSeen = recentExceptionFingerprints.get(fingerprint)
+  if (lastSeen && now - lastSeen < exceptionDedupeWindowMs) {
+    return false
+  }
+
+  recentExceptionFingerprints.set(fingerprint, now)
+
+  // Cheap cleanup of old entries to avoid unbounded growth.
+  for (const [key, ts] of recentExceptionFingerprints) {
+    if (now - ts > exceptionDedupeWindowMs * 5) {
+      recentExceptionFingerprints.delete(key)
+    }
+  }
+
+  return true
+}

package/src/type/crash-buffer.ts

@@ -31,12 +31,10 @@ export type CrashBufferEventMap = {
 }
 
 export type CrashBufferSnapshot = {
-  rrwebEvents: CrashBufferRrwebEventPayload[]
-  otelSpans: CrashBufferOtelSpanPayload[]
-  attrs: CrashBufferAttrs | null
-  windowMs: number
-  fromTs: number
-  toTs: number
+  startedAt: number
+  stoppedAt: number
+  events: CrashBufferRrwebEventPayload[]
+  spans: CrashBufferOtelSpanPayload[]
 }
 
 /**
@@ -48,20 +46,13 @@ export type CrashBufferSnapshot = {
  * - `pruneOlderThan` is optional because browser implementations can handle pruning internally.
  */
 export interface CrashBuffer {
-  setAttrs(attrs: CrashBufferAttrs): Promise<void>
   appendEvent(payload: CrashBufferRrwebEventPayload, windowMs?: number): Promise<void>
   appendSpans(payload: CrashBufferOtelSpanBatchPayload, windowMs?: number): Promise<void>
   snapshot(windowMs?: number, now?: number): Promise<CrashBufferSnapshot>
   clear(): Promise<void>
   pruneOlderThan?(cutoffTs: number): Promise<void>
-  on?(
-    event: CrashBufferEventName,
-    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void
-  ): () => void
-  off?(
-    event: CrashBufferEventName,
-    listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void
-  ): void
+  on?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): () => void
+  off?(event: CrashBufferEventName, listener: (payload: CrashBufferEventMap[CrashBufferEventName]) => void): void
 }
 
 /**