@coralogix/browser 3.7.1 → 3.8.2

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 3.8.2 (2026-05-06)
+
+### 🩹 Fixes
+
+- run web vitals listeners outside zone
+
+## 3.8.1 (2026-05-06)
+
+### 🩹 Fixes
+
+Improve error stack trace handling.
+
+## 3.8.0 (2026-04-27)
+
+### 🚀 Features
+
+- Add support for excluding specific instrumentations from session sampling
+
 ## 3.7.1 (2026-04-26)
 
 ### 🩹 Fixes

package/README.md

@@ -9,7 +9,8 @@
 
    - [Basic Sampling](#1-basic-sampling---sample--of-all-sessions)
    - [Advanced Sampling](#2-advanced-sampling---sample--of-sessions-but-always-track-sessions-with-errors)
-   - [Only Sessions with Errors](#3-only-sessions-with-errors)
+   - [Exclude Specific Instrumentations from Sampling](#3-exclude-specific-instrumentations-from-sampling)
+   - [Only Sessions with Errors](#4-only-sessions-with-errors)
 
 6. [Sending Custom Logs](#sending-custom-logs)
 7. [Instrumentations](#instrumentations)
@@ -162,7 +163,21 @@ CoralogixRum.init({
 });
 ```
 
-#### 3. Only Sessions with Errors
+#### 3. Exclude Specific Instrumentations from Sampling
+
+Keep specific instrumentations running at 100% even when sessions are sampled out. This is useful when you want to reduce data volume with sampling but still capture all errors or custom logs.
+
+```javascript
+CoralogixRum.init({
+  // ...
+  sessionConfig: {
+    sessionSampleRate: 20, // Only 20% of sessions are fully tracked
+    excludeFromSampling: ['custom'], // These will run at 100% regardless of sampling
+  },
+});
+```
+
+#### 4. Only Sessions with Errors
 
 Track only sessions with errors, and send specific instrumentation data immediately even if error is not occurred.
 From Session recording perspective, the SDK will record approximately 10–60s(according to maxRecordTime property) before the error occurred.

package/index.esm2.js

@@ -220,6 +220,7 @@ var DEFAULT_SESSION_CONFIG = {
     onlyWithErrorConfig: {
         enable: false,
     },
+    excludeFromSampling: [],
 };
 var SESSION_IDLE_TIME = 15 * millisecondsPerMinute;
 var SESSION_EXPIRATION_TIME = MILLISECONDS_PER_HOUR;
@@ -373,6 +374,23 @@ var STACK_FRAME_LIMIT = 50;
 var STACK_LINE_LIMIT = 1024;
 var MESSAGE_LIMIT = 1024;
 var MFE_PATH_PATTERN = /https?:\/\/.*\//;
+var V8_HEADER_PATTERN = /^Error\b/;
+function sanitizeConsoleErrorStack(stack) {
+    var _a;
+    if (!stack)
+        return stack;
+    var lines = stack.split('\n');
+    if (lines.length === 0)
+        return stack;
+    if (V8_HEADER_PATTERN.test(lines[0])) {
+        lines = lines.slice(1);
+    }
+    lines = lines.slice(1);
+    if ((_a = getSessionRecorder()) === null || _a === void 0 ? void 0 : _a.isConsoleRecordingActive()) {
+        lines = lines.slice(1);
+    }
+    return lines.join('\n');
+}
 function extractMfePath(fileName) {
     var _a;
     var _b = __read$1((_a = fileName.match(MFE_PATH_PATTERN)) !== null && _a !== void 0 ? _a : [], 1), mfePath = _b[0];
@@ -525,6 +543,7 @@ var _consoleErrorHandler = function (errorInstrumentation) {
                 args[_i] = arguments[_i];
             }
             var stackContextError = new Error();
+            stackContextError.stack = sanitizeConsoleErrorStack(stackContextError.stack);
             errorInstrumentation.report(ErrorSource.CONSOLE, args, stackContextError);
             return original.apply(console, args);
         };
@@ -1384,6 +1403,16 @@ function createCxMutationObserver(callback) {
     var OriginalMutationObserver = getZoneJsOriginalDom(browserWindow, 'MutationObserver');
     return new OriginalMutationObserver(callback);
 }
+function cxRunOutsideZone(fn) {
+    if (!shouldRunOutsideZone()) {
+        return fn();
+    }
+    var zone = getBrowserWindow().Zone;
+    if (zone && zone.root && typeof zone.root.run === 'function') {
+        return zone.root.run(fn);
+    }
+    return fn();
+}
 
 /** Original source: https://www.npmjs.com/package/tti-polyfill?activeTab=code
  * @license Apache-2.0
@@ -1683,11 +1712,13 @@ var CoralogixWebVitalsInstrumentation = (function (_super) {
         if (!isPerformanceObserverSupported()) {
             return _this;
         }
-        _this.registerToCoreWebVitalMetrics();
-        _this.registerToCalculatedWebVitalMetrics();
-        if (_this.isSoftNavsEnabled) {
-            _this.registerToSoftNavigations();
-        }
+        cxRunOutsideZone(function () {
+            _this.registerToCoreWebVitalMetrics();
+            _this.registerToCalculatedWebVitalMetrics();
+            if (_this.isSoftNavsEnabled) {
+                _this.registerToSoftNavigations();
+            }
+        });
         return _this;
     }
     CoralogixWebVitalsInstrumentation.prototype.registerToCoreWebVitalMetrics = function () {
@@ -3390,13 +3421,19 @@ var Request = (function () {
     return Request;
 }());
 
+var PROPAGATE_ONLY = { decision: SamplingDecision.RECORD };
+var EXPORT = { decision: SamplingDecision.RECORD_AND_SAMPLED };
 var CxCustomSampler = (function () {
     function CxCustomSampler() {
     }
-    CxCustomSampler.prototype.shouldSample = function () {
-        return {
-            decision: SamplingDecision.RECORD,
-        };
+    CxCustomSampler.prototype.shouldSample = function (_context, _traceId, _spanName, _spanKind, attributes) {
+        var _a, _b;
+        var excluded = (_b = (_a = getSdkConfig().sessionConfig) === null || _a === void 0 ? void 0 : _a.excludeFromSampling) !== null && _b !== void 0 ? _b : [];
+        var isHttpSpan = Boolean(attributes['http.method']);
+        if (isHttpSpan) {
+            return excluded.includes('fetch') || excluded.includes('xhr') ? EXPORT : PROPAGATE_ONLY;
+        }
+        return excluded.length > 0 ? EXPORT : PROPAGATE_ONLY;
     };
     return CxCustomSampler;
 }());
@@ -3446,28 +3483,61 @@ var isSessionWithError = function () {
     var _a = getSessionManager(), onlySessionWithErrorMode = _a.onlySessionWithErrorMode, cachedLogsSent = _a.cachedLogsSent;
     return onlySessionWithErrorMode && !cachedLogsSent;
 };
-function getResolvedSampler(resolvedOptions) {
-    var sampler = new AlwaysOnSampler();
-    var sessionSampleRate = resolvedOptions.sessionSampleRate, sessionConfig = resolvedOptions.sessionConfig, debug = resolvedOptions.debug, sessionRecordingConfig = resolvedOptions.sessionRecordingConfig;
+function getResolvedSampler() {
+    var config = getSdkConfig();
+    var sessionSampleRate = config.sessionSampleRate, sessionConfig = config.sessionConfig;
     var shouldNotTrackSession = !isSamplingOn(sessionSampleRate) ||
         !isSamplingOn(sessionConfig.sessionSampleRate);
     if (shouldNotTrackSession) {
-        var shouldAlwaysTrackSessionsWithErrors = sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.alwaysTrackSessionsWithErrors;
-        if (shouldAlwaysTrackSessionsWithErrors) {
-            sessionConfig.onlyWithErrorConfig = __assign(__assign({}, sessionConfig.onlyWithErrorConfig), { enable: true });
+        if (sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.alwaysTrackSessionsWithErrors) {
+            return enableErrorOnlyMode();
         }
-        else {
-            if (debug) {
-                console.debug('CoralogixRum: Session tracking is disabled due to sampling rate');
-            }
-            sampler = new CxCustomSampler();
-            if (sessionRecordingConfig) {
-                sessionRecordingConfig.enable = false;
-            }
-            resolvedOptions.instrumentations = __assign(__assign({}, resolvedOptions.instrumentations), { errors: false, custom: false, web_vitals: false, interactions: false, long_tasks: false, resources: false });
+        return handleDroppedSession();
+    }
+    return new AlwaysOnSampler();
+}
+function enableErrorOnlyMode() {
+    var sessionConfig = getSdkConfig().sessionConfig;
+    if (sessionConfig) {
+        sessionConfig.onlyWithErrorConfig = __assign(__assign({}, sessionConfig.onlyWithErrorConfig), { enable: true });
+    }
+    return new AlwaysOnSampler();
+}
+function handleDroppedSession() {
+    var e_1, _a;
+    var _b, _c;
+    var config = getSdkConfig();
+    var sessionRecordingConfig = config.sessionRecordingConfig, sessionConfig = config.sessionConfig, debug = config.debug;
+    if (debug) {
+        console.log('CoralogixRum: Session tracking is disabled due to sampling rate');
+    }
+    if (sessionRecordingConfig) {
+        sessionRecordingConfig.enable = false;
+    }
+    var excluded = (_b = sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.excludeFromSampling) !== null && _b !== void 0 ? _b : [];
+    var nonHttpInstrumentations = [
+        'errors',
+        'custom',
+        'web_vitals',
+        'interactions',
+        'long_tasks',
+        'resources',
+    ];
+    (_c = config.instrumentations) !== null && _c !== void 0 ? _c : (config.instrumentations = {});
+    try {
+        for (var nonHttpInstrumentations_1 = __values$1(nonHttpInstrumentations), nonHttpInstrumentations_1_1 = nonHttpInstrumentations_1.next(); !nonHttpInstrumentations_1_1.done; nonHttpInstrumentations_1_1 = nonHttpInstrumentations_1.next()) {
+            var key = nonHttpInstrumentations_1_1.value;
+            config.instrumentations[key] = excluded.includes(key);
         }
     }
-    return sampler;
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (nonHttpInstrumentations_1_1 && !nonHttpInstrumentations_1_1.done && (_a = nonHttpInstrumentations_1.return)) _a.call(nonHttpInstrumentations_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return new CxCustomSampler();
 }
 
 function isProcessorShouldStop(isActive) {
@@ -4230,7 +4300,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.7.1';
+var SDK_VERSION = '3.8.2';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -4846,7 +4916,7 @@ var CoralogixRum = {
             }
             CxGlobal[USER_AGENT_KEY] = parseUserAgent(navigator.userAgent);
             CxGlobal[SDK_CONFIG_KEY] = resolvedOptions_1;
-            var sampler = getResolvedSampler(resolvedOptions_1);
+            var sampler = getResolvedSampler();
             if (!resolvedOptions_1.debug && !resolvedOptions_1.public_key) {
                 console.warn('rumAuth will be required in the future');
             }
@@ -5243,4 +5313,4 @@ var SessionRecordingEventType;
     SessionRecordingEventType[SessionRecordingEventType["Plugin"] = 6] = "Plugin";
 })(SessionRecordingEventType || (SessionRecordingEventType = {}));
 
-export { BATCH_TIME_DELAY as B, CxGlobal as C, MAX_BATCH_TIME_MS as M, OtelNetworkAttrs as O, PerformanceTypes as P, Request as R, SESSION_RECORDER_SEGMENTS_MAP as S, UrlBasedLabelProvider as U, cxClearTimeout as a, createCxMutationObserver as b, cxSetTimeout as c, cxRequestAnimationFrame as d, cxCancelAnimationFrame as e, cxClearInterval as f, getZoneJsOriginalDom as g, getSdkConfig as h, getNowTime as i, SESSION_RECORDING_NETWORK_ERR0R_MESSAGE as j, cxSetInterval as k, SESSION_RECORDING_DEFAULT_HEADERS as l, SESSION_RECORDING_POSTFIX_URL as m, SESSION_RECORDER_KEY as n, SESSION_RECORDING_DEFAULT_ERROR_MESSAGE as o, CoralogixRum as p, CoralogixLogSeverity as q, SessionRecordingEventType as r, CoralogixEventType as s, UrlType as t };
+export { BATCH_TIME_DELAY as B, CxGlobal as C, MAX_BATCH_TIME_MS as M, OtelNetworkAttrs as O, PerformanceTypes as P, Request as R, SESSION_RECORDER_SEGMENTS_MAP as S, UrlBasedLabelProvider as U, cxClearTimeout as a, createCxMutationObserver as b, cxSetTimeout as c, cxRequestAnimationFrame as d, cxCancelAnimationFrame as e, getSdkConfig as f, getZoneJsOriginalDom as g, cxClearInterval as h, getNowTime as i, SESSION_RECORDING_NETWORK_ERR0R_MESSAGE as j, cxSetInterval as k, SESSION_RECORDING_DEFAULT_HEADERS as l, SESSION_RECORDING_POSTFIX_URL as m, SESSION_RECORDER_KEY as n, SESSION_RECORDING_DEFAULT_ERROR_MESSAGE as o, CoralogixRum as p, CoralogixLogSeverity as q, SessionRecordingEventType as r, CoralogixEventType as s, UrlType as t };

package/package.json

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

package/sessionRecorder.esm.js

@@ -1,5 +1,5 @@
 import { __values, __spreadArray, __read, __assign, __awaiter, __generator, __rest } from 'tslib';
-import { c as cxSetTimeout, a as cxClearTimeout, g as getZoneJsOriginalDom, b as createCxMutationObserver, d as cxRequestAnimationFrame, e as cxCancelAnimationFrame, C as CxGlobal, f as cxClearInterval, h as getSdkConfig, S as SESSION_RECORDER_SEGMENTS_MAP, i as getNowTime, j as SESSION_RECORDING_NETWORK_ERR0R_MESSAGE, k as cxSetInterval, R as Request, l as SESSION_RECORDING_DEFAULT_HEADERS, m as SESSION_RECORDING_POSTFIX_URL, B as BATCH_TIME_DELAY, n as SESSION_RECORDER_KEY, o as SESSION_RECORDING_DEFAULT_ERROR_MESSAGE, M as MAX_BATCH_TIME_MS } from './index.esm2.js';
+import { c as cxSetTimeout, a as cxClearTimeout, g as getZoneJsOriginalDom, b as createCxMutationObserver, d as cxRequestAnimationFrame, e as cxCancelAnimationFrame, C as CxGlobal, f as getSdkConfig, h as cxClearInterval, S as SESSION_RECORDER_SEGMENTS_MAP, i as getNowTime, j as SESSION_RECORDING_NETWORK_ERR0R_MESSAGE, k as cxSetInterval, R as Request, l as SESSION_RECORDING_DEFAULT_HEADERS, m as SESSION_RECORDING_POSTFIX_URL, B as BATCH_TIME_DELAY, n as SESSION_RECORDER_KEY, o as SESSION_RECORDING_DEFAULT_ERROR_MESSAGE, M as MAX_BATCH_TIME_MS } from './index.esm2.js';
 import '@opentelemetry/sdk-trace-base';
 import '@opentelemetry/sdk-trace-web';
 import '@opentelemetry/instrumentation';
@@ -5818,6 +5818,10 @@ var SessionRecorder = (function () {
     SessionRecorder.prototype.getIsAutoStartRecording = function () {
         return this.isAutoStartRecording;
     };
+    SessionRecorder.prototype.isConsoleRecordingActive = function () {
+        var _a;
+        return !!this.recordRef && ((_a = getSdkConfig().sessionRecordingConfig) === null || _a === void 0 ? void 0 : _a.recordConsoleEvents) === true;
+    };
     Object.defineProperty(SessionRecorder.prototype, "recordingStopDueToTimeout", {
         get: function () {
             return this._recordingStopDueToTimeout;

package/src/index.d.ts

@@ -3,3 +3,4 @@ export { CoralogixLogSeverity } from './types-external';
 export { UrlBasedLabelProvider } from './label-providers/url-based-label-provider';
 export * from './types';
 export { SessionRecordingEventType, type RecordEvent, type RecordPluginEvent, } from './session/session.model';
+export type { ExcludableInstrumentation } from './session/session.consts';

package/src/instrumentations/CoralogixErrorInstrumentation.d.ts

@@ -2,6 +2,7 @@ import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instr
 import { CoralogixRumLabels, CxStackFrame } from '../types';
 export declare const STACK_FRAME_LIMIT = 50;
 export declare const STACK_LINE_LIMIT = 1024;
+export declare function sanitizeConsoleErrorStack(stack: string | undefined): string | undefined;
 export declare function extractMfePath(fileName: string): string | undefined;
 export declare const ERROR_INSTRUMENTATION_NAME = "errors";
 export declare const ErrorAttributes: {

package/src/otel/custom-sampler.d.ts

@@ -1,4 +1,5 @@
+import { Attributes } from '@opentelemetry/api';
 import { Sampler, SamplingResult } from '@opentelemetry/sdk-trace-base';
 export declare class CxCustomSampler implements Sampler {
-    shouldSample(): SamplingResult;
+    shouldSample(_context: unknown, _traceId: string, _spanName: string, _spanKind: unknown, attributes: Attributes): SamplingResult;
 }

package/src/session/session.consts.d.ts

@@ -1,4 +1,5 @@
 import { SessionConfig } from './session.model';
+import { CoralogixOtelWebOptionsInstrumentations } from '../types';
 export declare const MAX_BATCH_TIME_MS: number;
 export declare const SESSION_RECORDING_DEFAULT_HEADERS: Record<string, string>;
 export declare const SESSION_RECORDING_DEFAULT_ERROR_MESSAGE: string;
@@ -9,6 +10,7 @@ export declare const SESSION_KEY: string;
 export declare const PREV_SESSION_KEY: string;
 export declare const MUTATION_LIMIT: number;
 export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
+export type ExcludableInstrumentation = keyof CoralogixOtelWebOptionsInstrumentations;
 export declare const SESSION_IDLE_TIME: number;
 export declare const SESSION_EXPIRATION_TIME: number;
 export declare const SESSION_MANAGER_KEY = "rumSessionManager";

package/src/session/session.helper.d.ts

@@ -1,8 +1,7 @@
 import { SessionConfig, SessionRecordingConfig } from './session.model';
-import { CoralogixBrowserSdkConfig } from '../types';
 import { AlwaysOnSampler, Sampler } from '@opentelemetry/sdk-trace-base';
 export declare function resolveSessionConfig(config: SessionConfig | undefined): SessionConfig;
 export declare function resolveSessionRecordingConfig(config: SessionRecordingConfig | undefined): SessionRecordingConfig | undefined;
 export declare function isSamplingOn(threshold: number): boolean;
 export declare const isSessionWithError: () => boolean;
-export declare function getResolvedSampler(resolvedOptions: CoralogixBrowserSdkConfig): AlwaysOnSampler | Sampler;
+export declare function getResolvedSampler(): AlwaysOnSampler | Sampler;

package/src/session/session.model.d.ts

@@ -2,6 +2,7 @@ import { eventWithTime } from '../cx-rrweb/rrweb-types';
 import { SlimDOMOptions } from '../cx-rrweb/rrweb-snapshot';
 import { CoralogixEventType } from '../types';
 import { recordOptions } from '../cx-rrweb/rrweb';
+import type { ExcludableInstrumentation } from './session.consts';
 export interface SessionRecordingConfig extends Omit<recordOptions<eventWithTime>, 'emit' | 'packFn' | 'plugins' | 'hooks' | 'slimDOMOptions'> {
     enable: boolean;
     autoStartSessionRecording: boolean;
@@ -23,6 +24,7 @@ export interface SessionConfig {
     alwaysTrackSessionsWithErrors?: boolean;
     onlyWithErrorConfig?: SessionWithErrorConfig;
     keepSessionAfterReload?: boolean;
+    excludeFromSampling?: ExcludableInstrumentation[];
 }
 export type RecordEvent = eventWithTime;
 export type RecordPluginEvent<T = any> = {

package/src/session/sessionRecorder.d.ts

@@ -28,6 +28,7 @@ export declare class SessionRecorder {
     getSessionHasRecording(): boolean;
     updateSegmentIndexCounter(segmentIndexCounter: Record<string, number>): void;
     getIsAutoStartRecording(): boolean;
+    isConsoleRecordingActive(): boolean;
     set recordingStopDueToTimeout(value: boolean);
     get recordingStopDueToTimeout(): boolean;
     startRecording(): Promise<void>;

package/src/tools/cx-timers.d.ts

@@ -23,3 +23,4 @@ export declare function cxClearInterval(id: ReturnType<typeof setInterval>): voi
 export declare function cxRequestAnimationFrame(callback: FrameRequestCallback): number;
 export declare function cxCancelAnimationFrame(id: number): void;
 export declare function createCxMutationObserver(callback: MutationCallback): MutationObserver;
+export declare function cxRunOutsideZone<T>(fn: () => T): T;

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.7.1";
+export declare const SDK_VERSION = "3.8.2";