@multiplayer-app/session-recorder-common 1.3.32 → 1.3.34

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplayer-app/session-recorder-common",
-  "version": "1.3.32",
+  "version": "1.3.34",
   "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
+}