@coralogix/browser 3.2.0 → 3.4.1

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 3.4.1 (2026-03-25)
+
+### 🩹 Fixes
+
+- Improve MFE stacktrace metadata extraction stability
+- Fix potential infinite loop in navigation tracking
+
+## 3.4.0 (2026-02-26)
+
+### 🚀 Features
+
+- add numeric ID grouping to default URL blueprinter
+
+## 3.3.0 (2026-02-24)
+
+### 🚀 Features
+
+- Enrich spans with RUM context (cx_rum) to improve RUM–Tracing correlation.
+
 ## 3.2.0 (2026-02-05)
 
 - Create new zoneless CDN for Angular consumers

package/index.esm2.js

@@ -369,6 +369,12 @@ var CACHED_METADATA_KEY = '__cx_metadata__';
 var ERROR_INSTRUMENTATION_VERSION = '1';
 var STACK_LIMIT = 4096;
 var MESSAGE_LIMIT = 1024;
+var MFE_PATH_PATTERN = /https?:\/\/.*\//;
+function extractMfePath(fileName) {
+    var _a;
+    var _b = __read$1((_a = fileName.match(MFE_PATH_PATTERN)) !== null && _a !== void 0 ? _a : [], 1), mfePath = _b[0];
+    return mfePath;
+}
 var ERROR_INSTRUMENTATION_NAME = 'errors';
 var ErrorAttributes = {
     TYPE: 'error_type',
@@ -455,32 +461,32 @@ function addLabelForMFE(span, lastFrame) {
 }
 function extractMetadataFromMfeStacktrace() {
     return __awaiter(this, arguments, void 0, function (fileName) {
-        var metadata, cachedMetadata, MFE_METADATA_KEY, _a, mfePath, response, _b, e_1;
+        var metadata, cachedMetadata, MFE_METADATA_KEY, mfePath, response, _a, e_1;
         if (fileName === void 0) { fileName = ''; }
-        return __generator(this, function (_c) {
-            switch (_c.label) {
+        return __generator(this, function (_b) {
+            switch (_b.label) {
                 case 0:
                     cachedMetadata = CxGlobal[CACHED_METADATA_KEY];
                     MFE_METADATA_KEY = 'cx-metadata.json';
-                    _a = __read$1(fileName.match(/https?:\/\/.*\//), 1), mfePath = _a[0];
+                    mfePath = extractMfePath(fileName);
                     if (!mfePath) return [3, 7];
                     response = void 0;
                     if (!!(cachedMetadata === null || cachedMetadata === void 0 ? void 0 : cachedMetadata.has(mfePath))) return [3, 6];
-                    _c.label = 1;
+                    _b.label = 1;
                 case 1:
-                    _c.trys.push([1, 4, , 5]);
+                    _b.trys.push([1, 4, , 5]);
                     return [4, fetch("".concat(mfePath).concat(MFE_METADATA_KEY), {
                             cache: 'no-cache',
                         })];
                 case 2:
-                    response = _c.sent();
-                    _b = [{}];
+                    response = _b.sent();
+                    _a = [{}];
                     return [4, response.json()];
                 case 3:
-                    metadata = __assign.apply(void 0, [__assign.apply(void 0, _b.concat([(_c.sent())])), { mfePath: mfePath }]);
+                    metadata = __assign.apply(void 0, [__assign.apply(void 0, _a.concat([(_b.sent())])), { mfePath: mfePath }]);
                     return [3, 5];
                 case 4:
-                    e_1 = _c.sent();
+                    e_1 = _b.sent();
                     if (getSdkConfig().debug) {
                         console.warn('Coralogix Browser SDK - Error fetching metadata', e_1);
                     }
@@ -490,7 +496,7 @@ function extractMetadataFromMfeStacktrace() {
                     return [3, 7];
                 case 6:
                     metadata = cachedMetadata === null || cachedMetadata === void 0 ? void 0 : cachedMetadata.get(mfePath);
-                    _c.label = 7;
+                    _b.label = 7;
                 case 7: return [2, metadata];
             }
         });
@@ -2490,9 +2496,25 @@ var idPatterns = [
         replacement: ID_MASK_KEY,
     },
 ];
+var PATH_ID_PLACEHOLDER = '/{id}';
+var NUMERIC_PATH_SEGMENT_REGEX = /\/(?![vV]\d{1,2}\/)([^/\d?]*\d+[^/?]*)/g;
+function replaceNumericPathSegments(url) {
+    var replacePath = function (s) { return s.replace(NUMERIC_PATH_SEGMENT_REGEX, PATH_ID_PLACEHOLDER); };
+    try {
+        var origin_1 = new URL(url).origin;
+        if (origin_1 === 'null' || !url.startsWith(origin_1))
+            return url;
+        return origin_1 + replacePath(url.slice(origin_1.length));
+    }
+    catch (_a) {
+        return replacePath(url);
+    }
+}
 var defaultUrlBlueprinters = {
     pageUrlBlueprinters: [
-        function (url) { return replacePatternsInUrl({ patterns: idPatterns, url: url }); },
+        function (url) {
+            return replaceNumericPathSegments(replacePatternsInUrl({ patterns: idPatterns, url: url }));
+        },
     ],
 };
 var OPTIONS_DEFAULTS = {
@@ -2794,26 +2816,6 @@ function rateForTBTMetricValue(value) {
             return 'good';
     }
 }
-function flattenAttributes(attributes) {
-    var e_4, _a;
-    var customLabels = JSON.parse(attributes[CoralogixAttributes.CUSTOM_LABELS]);
-    var flatAttributes = omit(attributes, CoralogixAttributes.CUSTOM_LABELS);
-    try {
-        for (var _b = __values$1(Object.entries(customLabels)), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var _d = __read$1(_c.value, 2), key = _d[0], value = _d[1];
-            flatAttributes[key] =
-                typeof value !== 'string' ? JSON.stringify(value) : value;
-        }
-    }
-    catch (e_4_1) { e_4 = { error: e_4_1 }; }
-    finally {
-        try {
-            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-        }
-        finally { if (e_4) throw e_4.error; }
-    }
-    return flatAttributes;
-}
 var getCircularReplacer = function () {
     var seen = new WeakSet();
     return function (key, value) {
@@ -4152,7 +4154,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.2.0';
+var SDK_VERSION = '3.4.1';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -4218,6 +4220,54 @@ function editableToCxRumEvent(editable, cxRumEvent) {
     return __assign(__assign(__assign({}, cxRumEvent), editable), { session_context: __assign(__assign({}, cxRumEvent.session_context), editable.session_context) });
 }
 
+function buildCxRumSpanAttributes(attrs) {
+    var e_1, _a;
+    var result = {};
+    try {
+        for (var _b = __values$1(Object.entries(attrs)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read$1(_c.value, 2), key = _d[0], value = _d[1];
+            if (value !== undefined && value !== null) {
+                result[key] = value;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return result;
+}
+function flattenToAttributes(obj, prefix) {
+    var e_2, _a;
+    var result = {};
+    if (!obj)
+        return result;
+    try {
+        for (var _b = __values$1(Object.entries(obj)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read$1(_c.value, 2), key = _d[0], value = _d[1];
+            if (value != null) {
+                result["".concat(prefix).concat(key)] = typeof value === 'string' ? value : JSON.stringify(value);
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return result;
+}
+function buildRumContextAttributes(cxRumEvent, resolvedLabels) {
+    var session_context = cxRumEvent.session_context, page_context = cxRumEvent.page_context, event_context = cxRumEvent.event_context, error_context = cxRumEvent.error_context, network_request_context = cxRumEvent.network_request_context;
+    var prefixedLabels = flattenToAttributes(resolvedLabels, 'cx_rum.labels.');
+    return buildCxRumSpanAttributes(__assign(__assign({ 'cx_rum.browser_sdk.version': cxRumEvent.browser_sdk.version, 'cx_rum.platform': cxRumEvent.platform, 'cx_rum.environment': cxRumEvent.environment, 'cx_rum.version_metadata.app_name': cxRumEvent.version_metadata.app_name, 'cx_rum.version_metadata.app_version': cxRumEvent.version_metadata.app_version }, prefixedLabels), { 'cx_rum.session_context.os': session_context === null || session_context === void 0 ? void 0 : session_context.os, 'cx_rum.session_context.osVersion': session_context === null || session_context === void 0 ? void 0 : session_context.osVersion, 'cx_rum.session_context.browser': session_context === null || session_context === void 0 ? void 0 : session_context.browser, 'cx_rum.session_context.browserVersion': session_context === null || session_context === void 0 ? void 0 : session_context.browserVersion, 'cx_rum.session_context.device': session_context === null || session_context === void 0 ? void 0 : session_context.device, 'cx_rum.session_context.user_agent': session_context === null || session_context === void 0 ? void 0 : session_context.user_agent, 'cx_rum.session_context.user_email': session_context === null || session_context === void 0 ? void 0 : session_context.user_email, 'cx_rum.session_context.user_id': session_context === null || session_context === void 0 ? void 0 : session_context.user_id, 'cx_rum.session_context.user_name': session_context === null || session_context === void 0 ? void 0 : session_context.user_name, 'cx_rum.page_context.page_fragments': page_context === null || page_context === void 0 ? void 0 : page_context.page_fragments, 'cx_rum.page_context.page_url_blueprint': page_context === null || page_context === void 0 ? void 0 : page_context.page_url_blueprint, 'cx_rum.event_context.type': event_context === null || event_context === void 0 ? void 0 : event_context.type, 'cx_rum.event_context.severity': event_context === null || event_context === void 0 ? void 0 : event_context.severity, 'cx_rum.error_context.error_type': error_context === null || error_context === void 0 ? void 0 : error_context.error_type, 'cx_rum.error_context.error_message': error_context === null || error_context === void 0 ? void 0 : error_context.error_message, 'cx_rum.network_request_context.fragments': network_request_context === null || network_request_context === void 0 ? void 0 : network_request_context.fragments, 'cx_rum.network_request_context.url': network_request_context === null || network_request_context === void 0 ? void 0 : network_request_context.url, 'cx_rum.network_request_context.status_code': network_request_context === null || network_request_context === void 0 ? void 0 : network_request_context.status_code, 'cx_rum.network_request_context.method': network_request_context === null || network_request_context === void 0 ? void 0 : network_request_context.method }));
+}
+
 var CoralogixSpanMapProcessor = (function () {
     function CoralogixSpanMapProcessor() {
         this.sdkConfig = getSdkConfig();
@@ -4304,6 +4354,7 @@ var CoralogixSpanMapProcessor = (function () {
                     }, labels: labels, environment: attributes[CoralogixAttributes.ENVIRONMENT] || '' }),
             },
         };
+        var resolvedLabels = this.resolveLabels(cxSpan.text.cx_rum);
         if (shouldAddOtelAttr(span)) {
             cxSpan.text.cx_rum.spanId = spanId;
             cxSpan.text.cx_rum.traceId = traceId;
@@ -4313,8 +4364,6 @@ var CoralogixSpanMapProcessor = (function () {
                     spanId: spanId,
                     traceId: traceId,
                     parentSpanId: parentSpanId,
-                    name: name,
-                    attributes: __assign(__assign(__assign({}, flattenAttributes(attributes)), this.resolveLabels(cxSpan.text.cx_rum)), { sessionId: sessionId }),
                     startTime: startTime,
                     endTime: endTime,
                     status: severity === CoralogixLogSeverity.Error
@@ -4322,6 +4371,8 @@ var CoralogixSpanMapProcessor = (function () {
                     kind: kind,
                     duration: duration,
                     sessionId: sessionId,
+                    name: name,
+                    attributes: buildRumContextAttributes(cxSpan.text.cx_rum, resolvedLabels),
                 },
                 otelResource: {
                     attributes: resourceAttributes,
@@ -4329,7 +4380,7 @@ var CoralogixSpanMapProcessor = (function () {
             };
         }
         this.resolveContextFromSpan(cxSpan, span, eventType);
-        cxSpan.text.cx_rum.labels = this.resolveLabels(cxSpan.text.cx_rum);
+        cxSpan.text.cx_rum.labels = resolvedLabels;
         return cxSpan;
     };
     CoralogixSpanMapProcessor.prototype.resolveContextFromSpan = function (cxSpan, span, eventType) {
@@ -4454,14 +4505,17 @@ var CoralogixSpanMapProcessor = (function () {
         return {};
     };
     CoralogixSpanMapProcessor.prototype.resolveLabels = function (cxRumEvent) {
-        var _a, _b;
+        var _a, _b, _c;
         var allLabels = cxRumEvent.labels;
         var labelProviders = (_a = this.sdkConfig) === null || _a === void 0 ? void 0 : _a.labelProviders;
         if (labelProviders === null || labelProviders === void 0 ? void 0 : labelProviders.length) {
             var pageUrlLabelProviders = getInternalRumData(PAGE_URL_LABEL_PROVIDERS_KEY);
             var networkUrlLabelProviders = getInternalRumData(NETWORK_URL_LABEL_PROVIDERS_KEY);
             var networkRequestFragment = (_b = cxRumEvent.network_request_context) === null || _b === void 0 ? void 0 : _b.fragments;
-            var labelsFromProviders = __assign(__assign({}, this.getLabelsByLabelProviders(pageUrlLabelProviders, cxRumEvent, cxRumEvent.page_context.page_fragments)), (networkRequestFragment
+            var pageFragment = (_c = cxRumEvent.page_context) === null || _c === void 0 ? void 0 : _c.page_fragments;
+            var labelsFromProviders = __assign(__assign({}, (pageFragment
+                ? this.getLabelsByLabelProviders(pageUrlLabelProviders, cxRumEvent, pageFragment)
+                : {})), (networkRequestFragment
                 ? this.getLabelsByLabelProviders(networkUrlLabelProviders, cxRumEvent, networkRequestFragment)
                 : {}));
             allLabels = __assign(__assign({}, allLabels), labelsFromProviders);
@@ -4625,22 +4679,32 @@ var SnapshotManager = (function () {
 
 var CoralogixNavigationProcessor = (function () {
     function CoralogixNavigationProcessor() {
+        this.isResolving = false;
     }
     CoralogixNavigationProcessor.prototype.forceFlush = function () {
         return Promise.resolve();
     };
     CoralogixNavigationProcessor.prototype.onEnd = function (span) { };
     CoralogixNavigationProcessor.prototype.onStart = function (span) {
-        var pageContext = resolvePageContext(location.href);
-        if (pageContext) {
-            span[CoralogixAttributes.PAGE_CONTEXT] = pageContext;
-            var currentPageFragment = getSessionManager().currentPageFragment;
-            var page_fragments = pageContext.page_fragments;
-            if (currentPageFragment !== page_fragments) {
-                getSessionManager().updateCurrentPage(page_fragments);
-                span[CoralogixAttributes.IS_NAVIGATION_EVENT] = true;
+        if (this.isResolving) {
+            return;
+        }
+        this.isResolving = true;
+        try {
+            var pageContext = resolvePageContext(location.href);
+            if (pageContext) {
+                span[CoralogixAttributes.PAGE_CONTEXT] = pageContext;
+                var currentPageFragment = getSessionManager().currentPageFragment;
+                var page_fragments = pageContext.page_fragments;
+                if (currentPageFragment !== page_fragments) {
+                    getSessionManager().updateCurrentPage(page_fragments);
+                    span[CoralogixAttributes.IS_NAVIGATION_EVENT] = true;
+                }
             }
         }
+        finally {
+            this.isResolving = false;
+        }
     };
     CoralogixNavigationProcessor.prototype.shutdown = function () {
         return Promise.resolve();

package/package.json

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

package/src/instrumentations/CoralogixErrorInstrumentation.d.ts

@@ -1,5 +1,6 @@
 import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instrumentation';
 import { CoralogixRumLabels } from '../types';
+export declare function extractMfePath(fileName: string): string | undefined;
 export declare const ERROR_INSTRUMENTATION_NAME = "errors";
 export declare const ErrorAttributes: {
     TYPE: string;

package/src/otel/rum-span-attributes.types.d.ts

@@ -0,0 +1,30 @@
+import type { Attributes } from '@opentelemetry/api';
+import type { CoralogixRumLabels, CxRumEvent } from '../types';
+export interface CxRumSpanAttributes extends Attributes {
+    'cx_rum.browser_sdk.version'?: string;
+    'cx_rum.platform'?: string;
+    'cx_rum.environment'?: string;
+    'cx_rum.version_metadata.app_name'?: string;
+    'cx_rum.version_metadata.app_version'?: string;
+    'cx_rum.session_context.os'?: string;
+    'cx_rum.session_context.osVersion'?: string;
+    'cx_rum.session_context.browser'?: string;
+    'cx_rum.session_context.browserVersion'?: string;
+    'cx_rum.session_context.device'?: string;
+    'cx_rum.session_context.user_agent'?: string;
+    'cx_rum.session_context.user_email'?: string;
+    'cx_rum.session_context.user_id'?: string;
+    'cx_rum.session_context.user_name'?: string;
+    'cx_rum.page_context.page_fragments'?: string;
+    'cx_rum.page_context.page_url_blueprint'?: string;
+    'cx_rum.event_context.type'?: string;
+    'cx_rum.event_context.severity'?: number;
+    'cx_rum.error_context.error_type'?: string;
+    'cx_rum.error_context.error_message'?: string;
+    'cx_rum.network_request_context.fragments'?: string;
+    'cx_rum.network_request_context.url'?: string;
+    'cx_rum.network_request_context.status_code'?: number;
+    'cx_rum.network_request_context.method'?: string;
+}
+export declare function buildCxRumSpanAttributes(attrs: CxRumSpanAttributes): Attributes;
+export declare function buildRumContextAttributes(cxRumEvent: CxRumEvent, resolvedLabels: CoralogixRumLabels): Attributes;

package/src/processors/CoralogixNavigationProcessor.d.ts

@@ -1,5 +1,6 @@
 import { ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';
 export declare class CoralogixNavigationProcessor implements SpanProcessor {
+    private isResolving;
     forceFlush(): Promise<void>;
     onEnd(span: ReadableSpan): void;
     onStart(span: Span): void;

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.2.0";
+export declare const SDK_VERSION = "3.4.1";