@coralogix/browser 3.23.0 → 3.23.3

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 3.23.3 (2026-08-30)
+
+### 🩹 Fixes
+
+- Stop the INP (Interaction to Next Paint) reporter throwing an uncaught `TypeError` after a back/forward navigation followed by a tab switch
+
+## 3.23.2 (2026-08-20)
+
+### 🩹 Fixes
+
+- Stop reporting `resolved_name` for dead clicks
+- Add an optional `fullData` flag to `CoralogixRum.getResolvedName()`, used by Coralogix's own tooling
+
+## 3.23.1 (2026-08-19)
+
+### 🩹 Fixes
+
+- Stop the public types from pulling `@types/node` into browser TypeScript builds
+
 ## 3.23.0 (2026-08-17)
 
 ### 🚀 Features

package/README.md

@@ -151,6 +151,7 @@ CoralogixRum.setApplicationContext({
 });
 ```
 
+<!-- split title="Sampling" path="configuration/sampling.md" -->
 ### Sampling
 
 #### 1. Basic Sampling - sample % of all sessions
@@ -221,6 +222,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="Logs and errors" path="features/logs-and-errors.md" -->
 ### Sending Custom Logs
 
 ```javascript
@@ -252,6 +255,23 @@ CoralogixRum.log(CoralogixLogSeverity.Info, 'this is a custom log message with i
 });
 ```
 
+#### Stringifying custom log data
+
+By default the `data` you pass to a custom log is sent as a nested structure. Set
+`stringifyCustomLogData` at initialization to send it as a string instead, which is
+useful when `data` holds nested objects or arrays. Circular references are handled
+rather than throwing.
+
+```javascript
+CoralogixRum.init({
+  // ...
+  stringifyCustomLogData: true,
+});
+```
+
+The SDK reads this option once, when it initializes, so it applies to every custom
+log from that point on and cannot be changed per call.
+
 ### Instrumentation's
 
 Turn on/off specific instrumentation, default to all trues.
@@ -273,6 +293,11 @@ CoralogixRum.init({
 });
 ```
 
+> [!NOTE]
+> The `fetch` and `xhr` instrumentations also add the trace context headers to outgoing requests.
+> Turning both off stops trace context propagation as well, even when `traceParentInHeader` is
+> enabled.
+
 ##### Web Vitals: TBT metric
 
 By default, the **TBT** (Total Blocking Time) metric is disabled.
@@ -308,6 +333,8 @@ try {
 }
 ```
 
+<!-- /split -->
+<!-- split title="Session recording" path="features/session-recording.md" -->
 ### Session Recording
 
 Session Recording enhances your user experience monitoring by enabling you to record and visually replay the web browsing activities of your users.
@@ -454,6 +481,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="Configuration options" path="configuration/options.md" -->
 ### Manually Create a New Session
 
 By default the SDK rotates the session automatically — after 15 minutes of inactivity, or once a session reaches 1 hour. Starting with version `3.19.0`, you can also rotate it on demand by calling `CoralogixRum.createNewSession()`, for example when a user logs out, so that subsequent events are attributed to a fresh session.
@@ -686,6 +715,11 @@ CoralogixRum.init({
 });
 ```
 
+> [!NOTE]
+> Trace headers are added by the `fetch` and `xhr` instrumentations, so this feature depends on them.
+> If you set both `instrumentations.fetch` and `instrumentations.xhr` to `false`, no trace headers are
+> sent even with `enabled: true`.
+
 #### propagateTraceHeaderCorsUrls
 
 When the backend domain is different from the app domain, specifying backend domains is necessary. <br>
@@ -822,6 +856,8 @@ export class CustomPropagator implements TextMapPropagator {
 
 ```
 
+<!-- /split -->
+<!-- split title="Before send and transport" path="configuration/before-send-and-transport.md" -->
 ### Before Send
 
 Enable event access and modification before sending to Coralogix, supporting content modification, and event discarding.
@@ -923,6 +959,8 @@ CoralogixRum.init({
 > [!NOTE]
 > The `priority` hint only works in Chromium browsers (Chrome/Edge 101+) and is a no-op elsewhere. We type this option with our own `SdkFetchPriority` alias instead of the DOM `RequestPriority` type, so it still compiles on older TypeScript versions (the SDK supports `>= 4.4.2`).
 
+<!-- /split -->
+<!-- split title="Custom instrumentation" path="features/custom-instrumentation.md" -->
 ### Custom Measurement
 
 Custom measurement allows you to send numeric data to Coralogix for precise monitoring and analysis.
@@ -972,6 +1010,13 @@ CoralogixRum.startTimeMeasure('login', {
 CoralogixRum.endTimeMeasure('login');
 ```
 
+A few behaviours worth knowing:
+
+- Starting a key while a measurement for it is still in progress does nothing, and neither does a blank key: `startTimeMeasure` returns and the running timer is left alone.
+- `endTimeMeasure` takes only the key, so there is no way to pass labels at the end. The object handed to `startTimeMeasure` is held by reference, and at the end it is merged over the SDK's global labels as they stand then - so a later `CoralogixRum.setLabels()` does affect the result.
+- Ending a measurement releases its key, so the same key can be measured again afterwards.
+- Open measurements are dropped the next time you start or end one while the session is idle. The check runs on those calls rather than on a timer, and activity clears the idle flag, so a measurement spanning a short idle gap may still report.
+
 ### Microfrontend support
 
 This feature allows you to track multiple applications on the same page.<br>
@@ -1028,15 +1073,57 @@ const customTracer = CoralogixRum.getCustomTracer({
 // ... your code
 ```
 
+#### When getCustomTracer returns nothing
+
+`getCustomTracer` returns `undefined` rather than throwing, so a missing prerequisite
+shows up as a `TypeError` on the next line instead. It returns nothing when:
+
+- the SDK has not been initialized yet
+- `traceParentInHeader` is not enabled - custom spans need it, and only a debug-level
+  message says so
+- a custom tracer already exists, which logs `Custom tracer already exists`
+
+`startGlobalSpan` behaves the same way: with a global span already open it warns
+`Global span already exists` and returns `undefined`, rather than replacing it.
+
+A few more things worth knowing:
+
+- Every span must be ended explicitly. `endSpan` ends the span and releases it, so a
+  new global span can be started afterwards.
+- Labels are applied to the span they are passed with. A child span created by
+  `startCustomSpan` does not inherit the global span's labels.
+- Open global spans are ended for you when the session resets, which happens after an
+  hour of session time or 15 minutes of inactivity.
+
 ### Traces Exporter
 
 The `tracesExporter` callback gives you full control over how collected trace events are handled.  
 It receives a `TraceExporterData` object containing all trace data that the SDK has collected.
 
+Setting it redirects your traces rather than copying them. The span data is removed from
+what the SDK sends to Coralogix and delivered to your callback instead, so Coralogix stops
+receiving traces until you forward them yourself from inside the callback.
+
+This happens per batch, and only for batches that carry OpenTelemetry span data. When
+one does, the strip applies to every log in it, not only to custom spans: views, errors
+and network events still reach Coralogix as RUM events, but without their
+`instrumentation_data`, the field holding request and response span detail. A batch with
+no span data at all is sent unchanged and your callback is not called for it.
+
+Treat the payload as a subset rather than a mirror. A span missing its trace id, span id,
+name or timestamps is dropped from the conversion, as is one whose timestamps fall
+outside the accepted window - more than an hour ahead or a day behind. Those spans can
+still reach Coralogix inside the RUM payload without a matching entry in what your
+callback receives, so `resource_spans` can be shorter than you expect, or empty.
+
+> [!WARNING]
+> The callback runs inline on the path that sends the RUM payload, and it is not wrapped.
+> An exception escaping your callback also stops that batch reaching Coralogix, so keep
+> your own work inside a `try`/`catch`.
+
 ```ts
 CoralogixRum.init({
   tracesExporter: (data: TraceExporterData) => {
-    // Example: forward traces to your own backend endpoint
     fetch('https://api.mycompany.com/rum-traces', {
       method: 'POST',
       headers: {
@@ -1104,6 +1191,7 @@ You can also manually trigger memory usage data collection.
 CoralogixRum.measureUserAgentSpecificMemory();
 ```
 
+<!-- /split -->
 ## Web Worker Support
 
 Web Worker support enables the capture of events originating from Web Workers, including unhandled errors, custom logs, and other functionalities provided by the SDK.
@@ -1126,8 +1214,14 @@ CoralogixRum.init({
 const worker = new Worker('my-worker.js');
 ```
 
+The SDK also attaches a `CoralogixRum` handle to the worker object it returns, as a
+convenience for logging next to the code that created the worker. It is an alias to the
+same SDK instance, not a per-worker one, so it adds no worker attribution of its own -
+`worker.CoralogixRum.log(...)` and `CoralogixRum.log(...)` do the same thing. Pass a
+label yourself if you need to tell workers apart.
+
 ```javascript
-// Worker code
+// App code, on the main thread
 
 // Log a basic info log
 worker.CoralogixRum.log(CoralogixLogSeverity.Info, 'Test log from worker');
@@ -1139,12 +1233,17 @@ try {
   worker.CoralogixRum.captureError(error, { worker: 'analytics-worker' }, { label1: 'value1' });
 }
 
-// Log messages received in the worker
-self.onmessage = (message) => {
-  worker.CoralogixRum.log(CoralogixLogSeverity.Info, message);
+// Log messages the worker sends back
+worker.onmessage = (message) => {
+  worker.CoralogixRum.log(CoralogixLogSeverity.Info, 'worker message', { data: message.data });
 };
 ```
 
+> [!NOTE]
+> `worker.CoralogixRum` lives on the worker object in the page, not inside the worker
+> script. Worker scope has no Coralogix global, so these calls only work on the main
+> thread.
+
 ## Angular Zone.js Configuration
 
 By default, the SDK runs its internal timers outside Angular's Zone.js to prevent unnecessary change detection cycles. This improves performance by avoiding redundant UI updates triggered by the SDK's background operations.
@@ -1182,7 +1281,8 @@ If you are targeting legacy environments, make sure to use the ES5-compatible ve
 
 https://cdn.rum-ingress-coralogix.com/coralogix/browser/[version]/coralogix-browser-sdk.es5.js
 
-> _**Note: CDN latest has no longer maintained, please use an explicit version instead.**_
+> [!NOTE]
+> The CDN `latest` tag is no longer maintained. Use an explicit version instead.
 
 ### Add the CDN script to your application
 

package/index.esm.js

@@ -7,6 +7,7 @@ import 'error-stack-parser';
 import '@opentelemetry/instrumentation-fetch';
 import '@opentelemetry/instrumentation-xml-http-request';
 import 'web-vitals/attribution';
+import 'web-vitals';
 import '@opentelemetry/api';
 import '@opentelemetry/propagator-b3';
 import '@opentelemetry/propagator-aws-xray';

package/index.esm2.js

@@ -5,7 +5,8 @@ import { InstrumentationBase, registerInstrumentations } from '@opentelemetry/in
 import ErrorStackParser from 'error-stack-parser';
 import { FetchInstrumentation } from '@opentelemetry/instrumentation-fetch';
 import { XMLHttpRequestInstrumentation } from '@opentelemetry/instrumentation-xml-http-request';
-import { onFID, onCLS, onLCP, onFCP, onINP, onTTFB } from 'web-vitals/attribution';
+import { onFID, onCLS, onLCP, onFCP, onTTFB } from 'web-vitals/attribution';
+import { onINP } from 'web-vitals';
 import { createContextKey, baggageEntryMetadataFromString, propagation, diag, trace, isSpanContextValid, TraceFlags, context } from '@opentelemetry/api';
 import { B3Propagator, B3InjectEncoding } from '@opentelemetry/propagator-b3';
 import { AWSXRayPropagator } from '@opentelemetry/propagator-aws-xray';
@@ -389,6 +390,37 @@ function getCustomMergedLabels(labels) {
     return __assign(__assign({}, globalLabels), labels);
 }
 
+var ResourceInitiatorTypes;
+(function (ResourceInitiatorTypes) {
+    ResourceInitiatorTypes["Media"] = "media";
+    ResourceInitiatorTypes["Script"] = "script";
+    ResourceInitiatorTypes["Css"] = "css";
+    ResourceInitiatorTypes["Beacon"] = "beacon";
+    ResourceInitiatorTypes["Img"] = "img";
+    ResourceInitiatorTypes["Font"] = "font";
+    ResourceInitiatorTypes["Doc"] = "doc";
+    ResourceInitiatorTypes["Xhr"] = "xmlhttprequest";
+    ResourceInitiatorTypes["Fetch"] = "fetch";
+    ResourceInitiatorTypes["Iframe"] = "iframe";
+    ResourceInitiatorTypes["Video"] = "video";
+    ResourceInitiatorTypes["Audio"] = "audio";
+    ResourceInitiatorTypes["Track"] = "track";
+    ResourceInitiatorTypes["Other"] = "other";
+})(ResourceInitiatorTypes || (ResourceInitiatorTypes = {}));
+var ErrorSource;
+(function (ErrorSource) {
+    ErrorSource["CONSOLE"] = "console";
+    ErrorSource["WINDOW"] = "window";
+    ErrorSource["UNHANDLED_REJECTION"] = "unhandledrejection";
+    ErrorSource["DOCUMENT"] = "document";
+    ErrorSource["CAPTURED"] = "captured";
+    ErrorSource["WEB_WORKER"] = "web_worker";
+})(ErrorSource || (ErrorSource = {}));
+var LogSource;
+(function (LogSource) {
+    LogSource["CODE"] = "code";
+})(LogSource || (LogSource = {}));
+
 var CACHED_METADATA_KEY = '__cx_metadata__';
 var ERROR_INSTRUMENTATION_VERSION = '1';
 var STACK_FRAME_LIMIT = 50;
@@ -424,15 +456,6 @@ var ErrorAttributes = {
     MESSAGE: 'error_message',
     DATA: 'error_custom_data',
 };
-var ErrorSource;
-(function (ErrorSource) {
-    ErrorSource["CONSOLE"] = "console";
-    ErrorSource["WINDOW"] = "window";
-    ErrorSource["UNHANDLED_REJECTION"] = "unhandledrejection";
-    ErrorSource["DOCUMENT"] = "document";
-    ErrorSource["CAPTURED"] = "captured";
-    ErrorSource["WEB_WORKER"] = "web_worker";
-})(ErrorSource || (ErrorSource = {}));
 function parseStackFrames(err) {
     var stack = err.stack, message = err.message, name = err.name;
     if (!stack) {
@@ -996,6 +1019,14 @@ var NetworkInstrumentationAttributes = {
     RESPONSE_PAYLOAD: 'response_payload',
     REQUEST_PAYLOAD: 'request_payload',
 };
+var FetchSource;
+(function (FetchSource) {
+    FetchSource["FETCH"] = "fetch";
+})(FetchSource || (FetchSource = {}));
+var XHRSource;
+(function (XHRSource) {
+    XHRSource["XHR"] = "xhr";
+})(XHRSource || (XHRSource = {}));
 
 function checkAttachingNetworkSpanToGlobalSpan(span) {
     var activeGlobalSpan = getGlobalSpanByTraceId(span.spanContext().traceId);
@@ -1007,10 +1038,6 @@ function checkAttachingNetworkSpanToGlobalSpan(span) {
     }
 }
 
-var FetchSource;
-(function (FetchSource) {
-    FetchSource["FETCH"] = "fetch";
-})(FetchSource || (FetchSource = {}));
 var CoralogixFetchInstrumentation = (function (_super) {
     __extends(CoralogixFetchInstrumentation, _super);
     function CoralogixFetchInstrumentation(config) {
@@ -1151,10 +1178,6 @@ var CoralogixFetchInstrumentation = (function (_super) {
     return CoralogixFetchInstrumentation;
 }(FetchInstrumentation));
 
-var XHRSource;
-(function (XHRSource) {
-    XHRSource["XHR"] = "xhr";
-})(XHRSource || (XHRSource = {}));
 var CoralogixXhrInstrumentation = (function (_super) {
     __extends(CoralogixXhrInstrumentation, _super);
     function CoralogixXhrInstrumentation(config) {
@@ -1210,10 +1233,6 @@ var CoralogixXhrInstrumentation = (function (_super) {
 }(XMLHttpRequestInstrumentation));
 
 var CUSTOM_INSTRUMENTATION_VERSION = '1';
-var LogSource;
-(function (LogSource) {
-    LogSource["CODE"] = "code";
-})(LogSource || (LogSource = {}));
 var CoralogixCustomLogInstrumentation = (function (_super) {
     __extends(CoralogixCustomLogInstrumentation, _super);
     function CoralogixCustomLogInstrumentation(config) {
@@ -1424,7 +1443,7 @@ var attributionSanitizers = {
         return __assign(__assign({}, rest), { attribution: sanitizedAttribution });
     },
     INP: function (metric) {
-        metric.entries; metric.attribution; var rest = __rest(metric, ["entries", "attribution"]);
+        metric.entries; var rest = __rest(metric, ["entries"]);
         return rest;
     },
 };
@@ -1813,6 +1832,9 @@ function isPerformanceObserverSupported() {
 }
 
 function sanitizeAttribution(metric) {
+    if (metric.name === 'INP') {
+        return attributionSanitizers.INP(metric);
+    }
     if (!('attribution' in metric)) {
         metric.entries; var rest = __rest(metric, ["entries"]);
         return rest;
@@ -1828,8 +1850,6 @@ function sanitizeAttribution(metric) {
             return attributionSanitizers.FID(metric);
         case 'TTFB':
             return attributionSanitizers.TTFB(metric);
-        case 'INP':
-            return attributionSanitizers.INP(metric);
     }
 }
 var CoralogixWebVitalsInstrumentation = (function (_super) {
@@ -1838,6 +1858,13 @@ var CoralogixWebVitalsInstrumentation = (function (_super) {
         var _this = _super.call(this, WEB_VITALS_INSTRUMENTATION_NAME, WEB_VITALS_INSTRUMENTATION_VERSION, config) || this;
         _this.observers = [];
         _this.isSoftNavsEnabled = getSdkConfig().trackSoftNavigations;
+        _this.onReportInp = function (metric) {
+            var _a;
+            if (!((_a = metric === null || metric === void 0 ? void 0 : metric.entries) === null || _a === void 0 ? void 0 : _a.length)) {
+                return;
+            }
+            _this.onReport(metric);
+        };
         _this.onReport = function (metric) {
             if (!metric) {
                 return;
@@ -1882,7 +1909,7 @@ var CoralogixWebVitalsInstrumentation = (function (_super) {
             onFCP(this.onReport, { reportSoftNavs: shouldReportSoftNavs });
         }
         if (this.metrics.inp) {
-            onINP(this.onReport, { reportSoftNavs: shouldReportSoftNavs });
+            onINP(this.onReportInp, { reportSoftNavs: shouldReportSoftNavs });
         }
         if (this.metrics.ttfb) {
             onTTFB(this.onReport, { reportSoftNavs: shouldReportSoftNavs });
@@ -2036,24 +2063,6 @@ function resourceInitiatorTypeIs(value, types) {
     return types.some(function (type) { return type === value; });
 }
 
-var ResourceInitiatorTypes;
-(function (ResourceInitiatorTypes) {
-    ResourceInitiatorTypes["Media"] = "media";
-    ResourceInitiatorTypes["Script"] = "script";
-    ResourceInitiatorTypes["Css"] = "css";
-    ResourceInitiatorTypes["Beacon"] = "beacon";
-    ResourceInitiatorTypes["Img"] = "img";
-    ResourceInitiatorTypes["Font"] = "font";
-    ResourceInitiatorTypes["Doc"] = "doc";
-    ResourceInitiatorTypes["Xhr"] = "xmlhttprequest";
-    ResourceInitiatorTypes["Fetch"] = "fetch";
-    ResourceInitiatorTypes["Iframe"] = "iframe";
-    ResourceInitiatorTypes["Video"] = "video";
-    ResourceInitiatorTypes["Audio"] = "audio";
-    ResourceInitiatorTypes["Track"] = "track";
-    ResourceInitiatorTypes["Other"] = "other";
-})(ResourceInitiatorTypes || (ResourceInitiatorTypes = {}));
-
 function isPatternMatch(str, arr, warnKey) {
     return arr.some(function (item) {
         if (item instanceof RegExp) {
@@ -2279,9 +2288,11 @@ function extractTestId(el) {
     return (el === null || el === void 0 ? void 0 : el.getAttribute(DATA_TEST_ATTRIBUTE)) || '';
 }
 function extractResolvedName(_a) {
-    var element = _a.element, config = _a.config, actionName = _a.actionName, ariaLabel = _a.ariaLabel;
+    var isDeadClick = _a.isDeadClick, element = _a.element, config = _a.config, actionName = _a.actionName, ariaLabel = _a.ariaLabel;
     if (!element)
         return '';
+    if (isDeadClick)
+        return '';
     var resolveName = actionName ||
         maskedTextIfMasked(element, config) ||
         resolveFallbackName(element, ariaLabel, ANCESTOR_SEARCH_DEPTH);
@@ -2687,17 +2698,19 @@ var CoralogixUserInteractionInstrumentation = (function (_super) {
             }
             if (eventTarget instanceof Element) {
                 var clickableElement = findClickableElement(eventTarget);
+                var isDeadClick = clickableElement === null;
                 var elementText = extractMaskedOrTextContent(eventTarget, config);
                 var cxActionName = extractActionName(eventTarget);
                 var ariaLabel = extractAriaLabel(eventTarget);
                 var testId = extractTestId(eventTarget);
                 var resolvedName = extractResolvedName({
+                    isDeadClick: isDeadClick,
                     element: eventTarget,
                     config: config,
                     actionName: cxActionName,
                     ariaLabel: ariaLabel,
                 });
-                span.setAttribute(CoralogixAttributes.IS_DEAD_CLICK, clickableElement === null);
+                span.setAttribute(CoralogixAttributes.IS_DEAD_CLICK, isDeadClick);
                 var _b = eventTarget.getBoundingClientRect(), width = _b.width, height = _b.height;
                 span.setAttribute(CoralogixAttributes.ELEMENT_WIDTH, width);
                 span.setAttribute(CoralogixAttributes.ELEMENT_HEIGHT, height);
@@ -2709,19 +2722,25 @@ var CoralogixUserInteractionInstrumentation = (function (_super) {
                         : false;
                     span.setAttribute(CoralogixAttributes.IS_RAGE_CLICK, isRageClick);
                 }
-                [
+                var spanAttributes = [
                     [CoralogixAttributes.ELEMENT_ID, id],
                     [CoralogixAttributes.ELEMENT_CLASSES, getClassName(eventTarget)],
                     [CoralogixAttributes.TARGET_ELEMENT_TYPE, type],
                     [CoralogixAttributes.ELEMENT_INNER_TEXT, elementText],
                     [CoralogixAttributes.TARGET_ELEMENT, nodeName],
-                    [CoralogixAttributes.RESOLVED_NAME, resolvedName],
+                    [
+                        CoralogixAttributes.RESOLVED_NAME,
+                        isDeadClick ? undefined : resolvedName,
+                    ],
                     [CoralogixAttributes.CX_ACTION_NAME, cxActionName],
                     [CoralogixAttributes.ARIA_LABEL, ariaLabel],
                     [CoralogixAttributes.TEST_ID, testId],
-                ].forEach(function (_a) {
+                ];
+                spanAttributes.forEach(function (_a) {
                     var _b = __read$1(_a, 2), key = _b[0], value = _b[1];
-                    span.setAttribute(key, value);
+                    if (value !== undefined) {
+                        span.setAttribute(key, value);
+                    }
                 });
             }
             span.end();
@@ -5196,7 +5215,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.23.0';
+var SDK_VERSION = '3.23.3';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -5820,6 +5839,31 @@ var spanMapProcessor;
 var navigationProcessor;
 var exporter;
 var timeMeasurementTracker;
+function getResolvedName(element, fullData) {
+    if (fullData === void 0) { fullData = false; }
+    if (!isInited) {
+        console.debug('CoralogixRum must be initiated before resolving element names');
+        return;
+    }
+    try {
+        var isDeadClick = findClickableElement(element) === null;
+        var actionName = extractActionName(element);
+        var ariaLabel = extractAriaLabel(element);
+        var resolvedName = extractResolvedName({
+            isDeadClick: isDeadClick,
+            element: element,
+            config: getSdkConfig(),
+            actionName: actionName,
+            ariaLabel: ariaLabel,
+        });
+        return fullData
+            ? { resolvedName: resolvedName, isDeadClick: isDeadClick, actionName: actionName, ariaLabel: ariaLabel }
+            : resolvedName;
+    }
+    catch (err) {
+        return;
+    }
+}
 var CoralogixRum = {
     get isInited() {
         return isInited;
@@ -6153,23 +6197,7 @@ var CoralogixRum = {
         var _a, _b;
         return (_b = (_a = getSessionManager()) === null || _a === void 0 ? void 0 : _a.getSession()) === null || _b === void 0 ? void 0 : _b.sessionId;
     },
-    getResolvedName: function (element) {
-        if (!isInited) {
-            console.debug('CoralogixRum must be initiated before resolving element names');
-            return;
-        }
-        try {
-            return extractResolvedName({
-                element: element,
-                config: getSdkConfig(),
-                actionName: extractActionName(element),
-                ariaLabel: extractAriaLabel(element),
-            });
-        }
-        catch (err) {
-            return;
-        }
-    },
+    getResolvedName: getResolvedName,
     getViewName: function () {
         var _a;
         if (!isInited) {

package/package.json

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

package/sessionRecorder.esm.js

@@ -7,6 +7,7 @@ import 'error-stack-parser';
 import '@opentelemetry/instrumentation-fetch';
 import '@opentelemetry/instrumentation-xml-http-request';
 import 'web-vitals/attribution';
+import 'web-vitals';
 import '@opentelemetry/api';
 import '@opentelemetry/propagator-b3';
 import '@opentelemetry/propagator-aws-xray';

package/src/coralogix-rum.d.ts

@@ -1,5 +1,5 @@
 import { CoralogixOtelWebType, CoralogixWindow, CxSpan } from './types';
-import { MemoryUsageContext } from './instrumentations/memory-usage';
+import { MemoryUsageContext } from './instrumentations/memory-usage/memory-usage.types';
 declare global {
     interface Worker {
         CoralogixRum: CoralogixOtelWebType;

package/src/instrumentations/CoralogixCustomLogInstrumentation.d.ts

@@ -2,9 +2,6 @@ import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instr
 import { CoralogixLogSeverity } from '../types-external';
 import { CoralogixRumLabels } from '../types';
 export declare const CUSTOM_INSTRUMENTATION_VERSION = "1";
-export declare enum LogSource {
-    CODE = "code"
-}
 interface CustomLogParams {
     severity: CoralogixLogSeverity;
     message: string;

package/src/instrumentations/CoralogixErrorInstrumentation.d.ts

@@ -1,5 +1,6 @@
 import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instrumentation';
 import { CoralogixRumLabels, CxStackFrame } from '../types';
+import { ErrorSource } from './instrumentation.model';
 export declare const STACK_FRAME_LIMIT = 50;
 export declare const STACK_LINE_LIMIT = 1024;
 export declare function sanitizeConsoleErrorStack(stack: string | undefined): string | undefined;
@@ -11,14 +12,6 @@ export declare const ErrorAttributes: {
     MESSAGE: string;
     DATA: string;
 };
-export declare enum ErrorSource {
-    CONSOLE = "console",
-    WINDOW = "window",
-    UNHANDLED_REJECTION = "unhandledrejection",
-    DOCUMENT = "document",
-    CAPTURED = "captured",
-    WEB_WORKER = "web_worker"
-}
 interface CoralogixErrorInstrumentationConfig extends InstrumentationConfig {
     ignoreErrors?: Array<string | RegExp>;
 }

package/src/instrumentations/CoralogixInternalInstrumentation.d.ts

@@ -1,6 +1,6 @@
 import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instrumentation';
+import { CoralogixInternalEvent } from './instrumentation.model';
 export declare const INTERNAL_INSTRUMENTATION_VERSION = "1";
-export type CoralogixInternalEvent = 'init' | 'recording-start' | 'recording-stop' | 'session-end' | 'error';
 export declare class CoralogixInternalInstrumentation extends InstrumentationBase {
     constructor(config: InstrumentationConfig);
     protected init(): void;

package/src/instrumentations/instrumentation.model.d.ts

@@ -20,3 +20,15 @@ export type InternalInstrumentationConfig = {
     confKey: keyof CoralogixOtelWebOptionsInstrumentations | CoralogixEventType;
     disable: boolean;
 };
+export declare enum ErrorSource {
+    CONSOLE = "console",
+    WINDOW = "window",
+    UNHANDLED_REJECTION = "unhandledrejection",
+    DOCUMENT = "document",
+    CAPTURED = "captured",
+    WEB_WORKER = "web_worker"
+}
+export declare enum LogSource {
+    CODE = "code"
+}
+export type CoralogixInternalEvent = 'init' | 'recording-start' | 'recording-stop' | 'session-end' | 'error';

package/src/instrumentations/network/CoralogixFetchInstrumentation.d.ts

@@ -1,7 +1,4 @@
 import { FetchInstrumentation, FetchInstrumentationConfig } from '@opentelemetry/instrumentation-fetch';
-export declare enum FetchSource {
-    FETCH = "fetch"
-}
 export declare class CoralogixFetchInstrumentation extends FetchInstrumentation {
     private networkDataManager;
     private headersManager;

package/src/instrumentations/network/CoralogixXhrInstrumentation.d.ts

@@ -1,7 +1,4 @@
 import { XMLHttpRequestInstrumentation, XMLHttpRequestInstrumentationConfig } from '@opentelemetry/instrumentation-xml-http-request';
-export declare enum XHRSource {
-    XHR = "xhr"
-}
 export declare class CoralogixXhrInstrumentation extends XMLHttpRequestInstrumentation {
     private networkDataManager;
     private headersManager;

package/src/instrumentations/network/constants.d.ts

@@ -4,3 +4,9 @@ export declare const NetworkInstrumentationAttributes: {
     RESPONSE_PAYLOAD: string;
     REQUEST_PAYLOAD: string;
 };
+export declare enum FetchSource {
+    FETCH = "fetch"
+}
+export declare enum XHRSource {
+    XHR = "xhr"
+}

package/src/instrumentations/user-interaction/CoralogixUserInteractionInstrumentation.d.ts

@@ -1,11 +1,7 @@
-import { InstrumentationBase, InstrumentationConfig } from '@opentelemetry/instrumentation';
-import { EventName } from '../../types';
+import { InstrumentationBase } from '@opentelemetry/instrumentation';
+import { CoralogixUserInteractionInstrumentationConfig, UserInteractionEventsConfig } from './user-interaction.types';
 export declare const USER_INTERACTION_INSTRUMENTATION_NAME = "interactions";
 export declare const USER_INTERACTION_INSTRUMENTATION_VERSION = "1";
-export type UserInteractionEventsConfig = Partial<Record<EventName, boolean>>;
-export interface CoralogixUserInteractionInstrumentationConfig extends InstrumentationConfig {
-    events?: UserInteractionEventsConfig;
-}
 export declare const DEFAULT_INSTRUMENTED_EVENTS: UserInteractionEventsConfig;
 export declare class CoralogixUserInteractionInstrumentation extends InstrumentationBase<CoralogixUserInteractionInstrumentationConfig> {
     private readonly rageClicksTracker;

package/src/instrumentations/user-interaction/user-interaction.types.d.ts

@@ -0,0 +1,6 @@
+import { EventName } from '../../types';
+export type UserInteractionEventsConfig = Partial<Record<EventName, boolean>>;
+export interface CoralogixUserInteractionInstrumentationConfig {
+    enabled?: boolean;
+    events?: UserInteractionEventsConfig;
+}

package/src/instrumentations/user-interaction/user-interaction.utils.d.ts

@@ -2,7 +2,8 @@ import { CoralogixBrowserSdkConfig } from '../../types';
 export declare function extractActionName(el: Element | HTMLElement | null): string;
 export declare function extractAriaLabel(el: Element | HTMLElement | null): string;
 export declare function extractTestId(el: Element | HTMLElement | null): string;
-export declare function extractResolvedName({ element, config, actionName, ariaLabel, }: {
+export declare function extractResolvedName({ isDeadClick, element, config, actionName, ariaLabel, }: {
+    isDeadClick: boolean;
     element: Element | HTMLElement | null;
     config: CoralogixBrowserSdkConfig;
     actionName: string;

package/src/instrumentations/web-vitals/CoralogixWebVitalsInstrumentation.d.ts

@@ -8,6 +8,7 @@ export declare class CoralogixWebVitalsInstrumentation extends InstrumentationBa
     private registerToCoreWebVitalMetrics;
     private registerToSoftNavigations;
     private registerToCalculatedWebVitalMetrics;
+    private onReportInp;
     private onReport;
     private registerToTBTMetric;
     private calculateLoadingPageTime;

package/src/instrumentations/web-vitals/web-vitals.types.d.ts

@@ -1,6 +1,6 @@
-import { CLSMetricWithAttribution, FCPMetricWithAttribution, FIDMetricWithAttribution, INPMetricWithAttribution, LCPMetricWithAttribution, Metric, TTFBMetricWithAttribution } from 'web-vitals/attribution';
+import { CLSMetricWithAttribution, FCPMetricWithAttribution, FIDMetricWithAttribution, INPMetricWithAttribution, LCPMetricWithAttribution, Metric, MetricWithAttribution, TTFBMetricWithAttribution } from 'web-vitals/attribution';
+import { INPMetric } from 'web-vitals';
 import { WebVitalsRating } from '../../types';
-import { InstrumentationConfig } from '@opentelemetry/instrumentation';
 export type CustomMetric = {
     name: 'SN' | 'LT' | 'TBT' | 'TTI';
     id: string;
@@ -37,7 +37,7 @@ type SanitizedFIDMetric = Omit<FIDMetricWithAttribution, 'entries' | 'attributio
 export type SanitizedTTFBMetric = Omit<TTFBMetricWithAttribution, 'entries' | 'attribution'> & {
     attribution: Omit<TTFBAttribution, 'navigationEntry'>;
 };
-type SanitizedINPMetric = Omit<INPMetricWithAttribution, 'entries' | 'attribution'>;
+type SanitizedINPMetric = Omit<INPMetric, 'entries'>;
 export type SanitizedMetric = SanitizedLCPMetric | SanitizedFCPMetric | SanitizedCLSMetric | SanitizedFIDMetric | SanitizedTTFBMetric | SanitizedINPMetric | CustomMetric;
 export type SanitizerMap = {
     LCP: (m: LCPMetricWithAttribution) => SanitizedLCPMetric;
@@ -45,8 +45,9 @@ export type SanitizerMap = {
     CLS: (m: CLSMetricWithAttribution) => SanitizedCLSMetric;
     FID: (m: FIDMetricWithAttribution) => SanitizedFIDMetric;
     TTFB: (m: TTFBMetricWithAttribution) => SanitizedTTFBMetric;
-    INP: (m: INPMetricWithAttribution) => SanitizedINPMetric;
+    INP: (m: INPMetric) => SanitizedINPMetric;
 };
+export type ReportedMetric = Exclude<MetricWithAttribution, INPMetricWithAttribution> | INPMetric | CustomMetric;
 export interface CoralogixWebVitalsMetrics {
     lcp: boolean;
     fid: boolean;
@@ -57,7 +58,8 @@ export interface CoralogixWebVitalsMetrics {
     tbt: boolean;
     lt: boolean;
 }
-export interface CoralogixWebVitalsInstrumentationConfig extends InstrumentationConfig {
+export interface CoralogixWebVitalsInstrumentationConfig {
+    enabled?: boolean;
     metrics: Partial<CoralogixWebVitalsMetrics>;
 }
 export declare const ALL_WEB_VITALS_METRICS: CoralogixWebVitalsMetrics;

package/src/internal-event-reporter.d.ts

@@ -1,2 +1,2 @@
-import { CoralogixInternalEvent } from './instrumentations/CoralogixInternalInstrumentation';
+import { CoralogixInternalEvent } from './instrumentations/instrumentation.model';
 export declare const reportInternalEvent: (event: CoralogixInternalEvent, message?: string) => void;

package/src/types.d.ts

@@ -1,22 +1,18 @@
-import { Attributes, TextMapPropagator } from '@opentelemetry/api';
+import { Attributes, HrTime, SpanKind, SpanStatusCode, TextMapPropagator } from '@opentelemetry/api';
 import { CoralogixDomainsApiUrlMap } from './constants';
 import { CoralogixLogSeverity } from './types-external';
-import { ErrorSource } from './instrumentations/CoralogixErrorInstrumentation';
-import { FetchSource } from './instrumentations/network/CoralogixFetchInstrumentation';
-import { XHRSource } from './instrumentations/network/CoralogixXhrInstrumentation';
-import { LogSource } from './instrumentations/CoralogixCustomLogInstrumentation';
-import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
-import { CoralogixUserInteractionInstrumentationConfig } from './instrumentations/user-interaction/CoralogixUserInteractionInstrumentation';
+import { CoralogixInternalEvent, ErrorSource, LogSource } from './instrumentations/instrumentation.model';
+import { FetchSource, XHRSource } from './instrumentations/network/constants';
+import { CoralogixUserInteractionInstrumentationConfig } from './instrumentations/user-interaction/user-interaction.types';
 import { Metric } from 'web-vitals/attribution';
 import { CoralogixWebVitalsInstrumentationConfig } from './instrumentations/web-vitals/web-vitals.types';
 import { SessionConfig, SessionRecordingConfig } from './session/session.model';
-import { CoralogixInternalEvent } from './instrumentations/CoralogixInternalInstrumentation';
 import { SnapshotContext } from './snapshot/snapshot.model';
 import { MetricWithAttribution } from 'web-vitals';
-import { MemoryUsageContext } from './instrumentations/memory-usage';
+import { MemoryUsageContext } from './instrumentations/memory-usage/memory-usage.types';
 import { MFEMetadata } from './mfe/mfe.types';
 import { UrlBasedLabelProvider } from './label-providers/url-based-label-provider';
-import { CustomTracer, CustomTracerIgnoredInstruments } from './custom-spans';
+import { CustomTracer, CustomTracerIgnoredInstruments } from './custom-spans/custom-spans.types';
 import { TraceExporterData } from './traces-exporter/traces-exporter.types';
 export interface CxStackFrame extends Partial<MFEMetadata> {
     fileName?: string;
@@ -176,6 +172,12 @@ export interface CoralogixBrowserSdkConfig {
     runOutsideAngularZone?: boolean;
     sdkFetchPriority?: SdkFetchPriority;
 }
+export interface ResolvedNameDetails {
+    resolvedName: string;
+    isDeadClick: boolean;
+    actionName: string;
+    ariaLabel: string;
+}
 export interface CoralogixOtelWebType extends SendLog {
     init: (options: CoralogixBrowserSdkConfig) => void;
     shutdown: () => void;
@@ -189,7 +191,11 @@ export interface CoralogixOtelWebType extends SendLog {
     measureUserAgentSpecificMemory: () => void;
     getUserContext: () => UserContextConfig | undefined;
     getSessionId: () => string | undefined;
-    getResolvedName: (element: Element) => string | undefined;
+    getResolvedName: {
+        (element: Element, fullData?: false): string | undefined;
+        (element: Element, fullData: true): ResolvedNameDetails | undefined;
+        (element: Element, fullData: boolean): string | ResolvedNameDetails | undefined;
+    };
     getViewName: () => string | undefined;
     getSdkVersion: () => string;
     createNewSession: () => void;
@@ -343,8 +349,21 @@ interface SpanContext {
 interface OtelResource {
     attributes: Attributes;
 }
+interface OtelSpanData extends SpanContext {
+    parentSpanId?: string;
+    name?: string;
+    kind?: SpanKind;
+    attributes?: Attributes;
+    startTime?: HrTime;
+    endTime?: HrTime;
+    duration?: HrTime;
+    status?: {
+        code: SpanStatusCode | number;
+        message?: string;
+    };
+}
 interface InstrumentationData {
-    otelSpan: Partial<ReadableSpan> & SpanContext;
+    otelSpan: OtelSpanData;
     otelResource: OtelResource;
 }
 interface VersionMetaData {

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.23.0";
+export declare const SDK_VERSION = "3.23.3";