@coralogix/browser 1.4.12 → 1.5.0

package/README.md

@@ -1,9 +1,78 @@
+<details>
+  <summary><strong>Table of Contents</strong></summary>
+
+1. [Official Coralogix SDK for Browsers](#official-coralogix-sdk-for-browsers)
+2. [Links](#links)
+3. [Supported Frameworks](#supported-frameworks)
+4. [Usage](#usage)
+5. [Sampling](#sampling)
+
+   - [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)
+
+6. [Sending Custom Logs](#sending-custom-logs)
+7. [Instrumentations](#instrumentations)
+8. [Manually Capture Errors](#manually-capture-errors)
+9. [Session Recording](#session-recording)
+
+   - [Recording Manually](#recording-manually)
+   - [Privacy & Security](#privacy--security)
+   - [Performance](#performance)
+   - [Worker URL](#worker-url)
+   - [Screenshots](#screenshots)
+
+10. [Network Extra Configuration](#network-extra-configuration)
+11. [Multi Page Application](#multi-page-application)
+12. [Ignore Errors](#ignore-errors)
+13. [Ignore URLs](#ignore-urls)
+14. [Mask Elements](#mask-elements)
+15. [Label Providers](#label-providers)
+16. [URL Blueprinters](#url-blueprinters)
+17. [Traces](#traces)
+
+    - [Propagate Trace Header for CORS URLs](#propagatetraceheadercorsurls)
+    - [Allowed Tracing URLs](#allowedtracingurls)
+    - [Extra Propagators (B3 / AWS X-Ray)](#b3--aws-x-ray-propagation)
+
+18. [Before Send](#before-send)
+19. [Proxy URL](#proxy-url)
+20. [Collect IP Data](#collect-ip-data)
+21. [Custom Measurement](#custom-measurement)
+22. [Add Timing](#add-timing)
+23. [Custom Time Measurement](#custom-time-measurement)
+24. [Microfrontend Support](#microfrontend-support)
+
+    - [Pre Requisites](#pre-requisites)
+
+25. [Custom Spans](#custom-spans)
+
+    - [Ignored Instruments](#ignored-instruments)
+
+26. [Soft Navigations (Experimental)](#soft-navigations--experimental)
+27. [Memory Usage (Experimental)](#memory-usage---experimental)
+28. [CDN](#cdn)
+
+    - [Specific Version](#specific-version-recommended)
+    - [Latest Version](#latest-version)
+    - [Add the CDN Script to Your Application](#add-the-cdn-script-to-your-application)
+    - [Initialization](#initialization)
+      - [Via JS File](#via-js-file)
+      - [Via TS File](#via-ts-file)
+
+29. [Flutter Web](#flutter-web)
+
+---
+
+</details>
+
 # Official Coralogix SDK for Browsers
 
 [![npm version](https://img.shields.io/npm/v/@coralogix/browser.svg)](https://www.npmjs.com/package/@coralogix/browser)
 
 ## Links
 
+- [Changelog](https://coralogix.github.io/coralogix-browser-sdk/CHANGELOG.html)
 - [Coralogix Real User Monitoring](https://coralogix.com/docs/real-user-monitoring/)
 
 ## Supported Frameworks
@@ -69,6 +138,7 @@ CoralogixRum.setApplicationContext({
 ### Sampling
 
 #### 1. Basic Sampling - sample % of all sessions
+
 ```javascript
 CoralogixRum.init({
   // ...
@@ -79,18 +149,21 @@ CoralogixRum.init({
 ```
 
 #### 2. Advanced Sampling - sample % of sessions, but always track sessions with errors
+
 This configuration will ensure all sessions with errors are tracked, and a percentage of sessions without errors are also tracked.
+
 ```javascript
 CoralogixRum.init({
   // ...
   sessionConfig: {
     sessionSampleRate: 50,
-    alwaysTrackSessionsWithErrors: true, 
+    alwaysTrackSessionsWithErrors: true,
   },
 });
 ```
 
 #### 3. 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.
 
@@ -118,7 +191,6 @@ CoralogixRum.init({
 });
 ```
 
-
 ### Sending Custom Logs
 
 ```javascript
@@ -155,13 +227,18 @@ CoralogixRum.init({
 
 ### Manually Capture Errors
 
-You can pass an Error object to get it captured as an event.
+You can pass an Error object to capture it as an event.<br>
+Additionally, you can include custom data and labels with the event.
 
 ```javascript
 try {
   // Some code that might throw an error
 } catch (error) {
   CoralogixRum.captureError(error);
+
+  CoralogixRum.captureError(error, { custom_data: { id: '123' } }); // add custom data
+
+  CoralogixRum.captureError(error, { custom_data: { id: '123' } }, { label1: 'value1' }); // add custom data and labels
 }
 ```
 
@@ -244,33 +321,35 @@ CoralogixRum.init({
 ```
 
 #### Worker Url
+
 By default, Session recording uses an inline web worker script to compress data before transmission. For added flexibility, you can host a custom worker script on your own domain. Simply host the following file on your server: [worker.min.js](https://cdn.rum-ingress-coralogix.com/coralogix/browser/latest/worker.min.js)
 
 For a locally hosted worker file:
+
 ```javascript
 CoralogixRum.init({
   // ...
   sessionRecordingConfig: {
     // ...
-    workerUrl: "/assets/worker.min.js"
+    workerUrl: '/assets/worker.min.js',
   },
 });
-
 ```
 
 For an externally hosted worker file:
+
 ```javascript
 CoralogixRum.init({
   // ...
   sessionRecordingConfig: {
     // ...
-      workerUrl: "https://cdn.rum-ingress-coralogix.com/coralogix/browser/latest/worker.min.js"
+    workerUrl: 'https://cdn.rum-ingress-coralogix.com/coralogix/browser/latest/worker.min.js',
   },
 });
-
 ```
 
 #### Screenshots
+
 Screenshot is a feature that allows you to capture a screenshot of the user's screen at the time of an error or based on specific custom logic triggers.<br>
 Note that the Screenshot feature is a subset of session recording and shares the same configurations, including options like masking, sample rate and others.<br>
 `sessionRecordingConfig` must be enabled to use this feature.<br>
@@ -284,14 +363,17 @@ CoralogixRum.init({
   },
 });
 ```
+
 Capture a screenshot manually:
+
 ```javascript
 CoralogixRum.screenshot();
 // or with a description
 CoralogixRum.screenshot('Screenshot after the user logged in');
-````
+```
 
 Capture a screen automatically based on custom logic, using the beforeSend
+
 ```javascript
 CoralogixRum.init({
   // ...
@@ -303,11 +385,10 @@ CoralogixRum.init({
       event.screenshotId = id;
     }
 
-    return event
-  }
+    return event;
+  },
 });
-
-````
+```
 
 ### Network Extra Configuration
 
@@ -317,19 +398,19 @@ The `networkExtraConfig` property is an array of configuration objects, each spe
 CoralogixRum.init({
   networkExtraConfig: [
     {
-      url: 'http://example.com',               // Capture requests to this specific URL or regex pattern
+      url: 'http://example.com', // Capture requests to this specific URL or regex pattern
       reqHeaders: ['Authorization', 'Content-Type'], // Capture 'Authorization' and 'Content-Type' headers in requests
-      resHeaders: ['Cache-Control', 'Date'],   // Capture 'Cache-Control' and 'Date' headers in responses
-      collectReqPayload: true,                    // Collect request payload
-      collectResPayload: false                    // Do not collect response payload
+      resHeaders: ['Cache-Control', 'Date'], // Capture 'Cache-Control' and 'Date' headers in responses
+      collectReqPayload: true, // Collect request payload
+      collectResPayload: false, // Do not collect response payload
     },
   ],
 });
 ```
-#### Important Note
-The server must explicitly permit access to specific headers by listing them in the `Access-Control-Expose-Headers` response header. Due to restrictions in the Fetch and XHR APIs, header retrieval operates on a best-effort basis, meaning that some headers may occasionally be unavailable in the events collected by this integration. Additionally, any large payloads exceeding the allowed size will be dropped.
 
+#### Important Note
 
+The server must explicitly permit access to specific headers by listing them in the `Access-Control-Expose-Headers` response header. Due to restrictions in the Fetch and XHR APIs, header retrieval operates on a best-effort basis, meaning that some headers may occasionally be unavailable in the events collected by this integration. Additionally, any large payloads exceeding the allowed size will be dropped.
 
 ### Multi Page Application
 
@@ -390,7 +471,9 @@ CoralogixRum.init({
   maskClass: 'mask-me', // will mask any clickable element with class 'mask-me'
 });
 ```
+
 Examples of masked elements:
+
 ```javascript
 <button class="cx-mask">
   <span>Some Text</span>
@@ -402,7 +485,7 @@ Examples of masked elements:
 
 <my-button-component class="cx-mask">
    <button>Text</button>
-</my-button-component> 
+</my-button-component>
 
 ```
 
@@ -485,6 +568,7 @@ CoralogixRum.init({
 
 When the backend domain is different from the app domain, specifying backend domains is necessary. <br>
 For example, if the app is hosted on `https://app.com` and the backend is hosted on `https://webapi.com`, you should specify the backend domain.
+
 ```javascript
 CoralogixRum.init({
   // ...
@@ -517,7 +601,9 @@ CoralogixRum.init({
 ```
 
 ### Extra Propagators
+
 #### B3 / AWS X-Ray Propagation
+
 ```javascript
 CoralogixRum.init({
   // ...
@@ -526,7 +612,7 @@ CoralogixRum.init({
     options: {
       // ...
       /* for B3 propagation  */
-      propagateB3TraceHeader: { 
+      propagateB3TraceHeader: {
         singleHeader: true,
         multiHeader: true,
       },
@@ -537,8 +623,7 @@ CoralogixRum.init({
 });
 ```
 
-
-### beforeSend
+### Before Send
 
 Enable event access and modification before sending to Coralogix, supporting content modification, and event discarding.
 
@@ -601,9 +686,9 @@ The timing relates to the time between the page load and the moment the timing i
 For example, you can add a timing for the first click event.
 
 ```javascript
-window.addEventListener('click', function handler(){
+window.addEventListener('click', function handler() {
   window.removeEventListener('click', handler);
-  
+
   CoralogixRum.addTiming('first-click');
 });
 ```
@@ -611,10 +696,11 @@ window.addEventListener('click', function handler(){
 OR
 
 You can provide your own timing.
+
 ```javascript
-window.addEventListener('click', function handler(){
+window.addEventListener('click', function handler() {
   window.removeEventListener('click', handler);
-  
+
   CoralogixRum.addTiming('first-click', 1000);
 });
 ```
@@ -640,6 +726,7 @@ This feature allows you to track multiple applications on the same page.<br>
 <b>Only errors with stacktrace are supported.</b>
 
 #### Pre Requisites
+
 To support microfrontend, you need to install one of these plugins: [webpack](https://www.npmjs.com/package/@coralogix/webpack-plugin), [esbuild](https://www.npmjs.com/package/@coralogix/esbuild-plugin) and include them in your build process.<br>
 Plugins for other bundlers are coming soon.
 
@@ -652,6 +739,36 @@ CoralogixRum.init({
 });
 ```
 
+### Custom Spans
+
+Create your own custom spans to track specific operations in your application.<br>
+Each span will share the same trace ID, which will allow you to create flows in your application and see them in the [Tracing view](https://coralogix.com/docs/user-guides/monitoring-and-insights/distributed-tracing/distributed-tracing/).<br>
+Labels can be added during span creation for additional context.
+
+```javascript
+const customTracer = CoralogixRum.getCustomTracer();
+const globalSpan = customTracer.startGlobalSpan('global-span', { page: 'posts' });
+
+globalSpan.withContext(() => {
+  const customSpan = globalSpan.startCustomSpan('custom-span', { action: 'scroll' });
+  customSpan.endSpan();
+});
+
+// note: End the global span only after the operation is complete.
+globalSpan.endSpan();
+```
+
+#### Ignored Instruments
+
+After creating a global span, some of the instrumented events (network, errors, interactions) will automatically share the same trace ID, unless specifically ignored.
+
+```javascript
+const customTracer = CoralogixRum.getCustomTracer({
+  ignoredInstruments: [CoralogixEventType.NETWORK_REQUEST, CoralogixEventType.ERROR, CoralogixEventType.USER_INTERACTION],
+});
+
+// ... your code
+```
 
 ### Soft Navigations — Experimental
 
@@ -679,10 +796,10 @@ To enable the feature, your website needs to be in a [secure context](https://de
 ```javascript
 CoralogixRum.init({
   // ...
-  memoryUsageConfig:{
-    enabled:true,
-    interval: 300_000 // Defaults to 5 minutes
-  }
+  memoryUsageConfig: {
+    enabled: true,
+    interval: 300_000, // Defaults to 5 minutes
+  },
 });
 ```
 

package/package.json

@@ -1,8 +1,19 @@
 {
   "name": "@coralogix/browser",
-  "version": "1.4.12",
+  "version": "1.5.0",
   "description": "Official Coralogix SDK for browsers",
-  "license": "MIT",
+  "license": "Apache-2.0",
+  "author": "Coralogix",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "official",
+    "coralogix",
+    "sdk",
+    "browser",
+    "javascript"
+  ],
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "0.52.1",

package/src/constants.d.ts

@@ -6,12 +6,12 @@ import { CoralogixCustomLogInstrumentation } from './instrumentations/CoralogixC
 import { CoralogixWebVitalsInstrumentation } from './instrumentations/CoralogixWebVitalsInstrumentation';
 import { CoralogixLongTaskInstrumentation } from './instrumentations/CoralogixLongTaskInstrumentation';
 import { CoralogixResourcesInstrumentation } from './instrumentations/CoralogixResourcesInstrumentation';
-import { CoralogixInternalInstrumentation } from './instrumentations/CoralogixInternalInstrumentation';
-import { CoralogixDOMInstrumentation } from './instrumentations/CoralogixDOMInstrumentation';
 import { CoralogixUserInteractionInstrumentation } from './instrumentations/user-interaction/CoralogixUserInteractionInstrumentation';
 import { CoralogixMemoryUsageInstrumentation } from './instrumentations/memory-usage';
 import { CoralogixScreenshotInstrumentation } from './instrumentations/screenshot/CoralogixScreenshotInstrumentation';
 import { CoralogixCustomMeasurementInstrumentation } from './instrumentations/custom-measurements';
+import { CoralogixInternalInstrumentation } from './instrumentations/CoralogixInternalInstrumentation';
+import { CoralogixDOMInstrumentation } from './instrumentations/CoralogixDOMInstrumentation';
 export declare const CORALOGIX_LOGS_URL_SUFFIX = "/browser/v1beta/logs";
 export declare const CORALOGIX_RECORDING_URL_SUFFIX = "/sessionrecording";
 export declare const MAX_EXPORT_BATCH_SIZE = 50;
@@ -98,6 +98,7 @@ export declare const CoralogixAttributes: {
         TYPE: string;
         STACK: string;
         MESSAGE: string;
+        DATA: string;
     };
     LOG: string;
     CUSTOM_LABELS: string;

package/src/constants.js

@@ -8,13 +8,13 @@ import { CoralogixLongTaskInstrumentation } from './instrumentations/CoralogixLo
 import { CoralogixResourcesInstrumentation } from './instrumentations/CoralogixResourcesInstrumentation';
 import { replacePatternsInUrl } from './utils';
 import { millisecondsPerSecond } from './utils/time';
-import { CoralogixInternalInstrumentation } from './instrumentations/CoralogixInternalInstrumentation';
-import { CoralogixDOMInstrumentation } from './instrumentations/CoralogixDOMInstrumentation';
 import { CoralogixUserInteractionInstrumentation } from './instrumentations/user-interaction/CoralogixUserInteractionInstrumentation';
 import { CoralogixMemoryUsageInstrumentation, MEMORY_USAGE_INSTRUMENTATION_NAME, } from './instrumentations/memory-usage';
 import { CoralogixScreenshotInstrumentation } from './instrumentations/screenshot/CoralogixScreenshotInstrumentation';
 import { SCREENSHOT_INSTRUMENTATION_NAME } from './instrumentations/screenshot/screenshot.utils';
 import { CoralogixCustomMeasurementInstrumentation } from './instrumentations/custom-measurements';
+import { CoralogixInternalInstrumentation } from './instrumentations/CoralogixInternalInstrumentation';
+import { CoralogixDOMInstrumentation } from './instrumentations/CoralogixDOMInstrumentation';
 export const CORALOGIX_LOGS_URL_SUFFIX = '/browser/v1beta/logs';
 export const CORALOGIX_RECORDING_URL_SUFFIX = '/sessionrecording';
 export const MAX_EXPORT_BATCH_SIZE = 50;

package/src/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../libs/browser/src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../libs/browser/src/constants.ts"],"names":[],"mappings":"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"}

package/src/custom-spans/custom-spans.consts.d.ts

@@ -0,0 +1,3 @@
+export declare const GLOBAL_SPAN_KEY = "__globalSpan__";
+export declare const CUSTOM_TRACER_KEY = "__customTracer__";
+export declare const CUSTOM_TRACER_IGNORED_INSTRUMENTS = "__customTracerIgnoredInstruments__";

package/src/custom-spans/custom-spans.consts.js

@@ -0,0 +1,4 @@
+export const GLOBAL_SPAN_KEY = '__globalSpan__';
+export const CUSTOM_TRACER_KEY = '__customTracer__';
+export const CUSTOM_TRACER_IGNORED_INSTRUMENTS = '__customTracerIgnoredInstruments__';
+//# sourceMappingURL=custom-spans.consts.js.map

package/src/custom-spans/custom-spans.consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-spans.consts.js","sourceRoot":"","sources":["../../../../../libs/browser/src/custom-spans/custom-spans.consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,iCAAiC,GAC5C,oCAAoC,CAAC"}

package/src/custom-spans/custom-spans.types.d.ts

@@ -0,0 +1,15 @@
+import { Span } from '@opentelemetry/api';
+import { CoralogixEventType, CoralogixRumLabels } from '../types';
+export interface GlobalSpan {
+    span: Span;
+    withContext: (fn: () => void) => void;
+    endSpan: () => void;
+    startCustomSpan: (name: string, labels?: CoralogixRumLabels) => {
+        span: Span;
+        endSpan: () => void;
+    };
+}
+export interface CustomTracer {
+    startGlobalSpan: (name: string, labels?: CoralogixRumLabels) => GlobalSpan | undefined;
+}
+export type CustomTracerIgnoredInstruments = CoralogixEventType.ERROR | CoralogixEventType.NETWORK_REQUEST | CoralogixEventType.USER_INTERACTION;

package/src/custom-spans/custom-spans.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=custom-spans.types.js.map

package/src/custom-spans/custom-spans.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-spans.types.js","sourceRoot":"","sources":["../../../../../libs/browser/src/custom-spans/custom-spans.types.ts"],"names":[],"mappings":""}

package/src/custom-spans/custom-spans.utils.d.ts

@@ -0,0 +1,13 @@
+import { CustomTracerIgnoredInstruments, GlobalSpan } from './custom-spans.types';
+import { Tracer } from '@opentelemetry/sdk-trace-base';
+import { Span } from '@opentelemetry/api';
+export declare function setGlobalSpan(globalSpan: GlobalSpan): void;
+export declare function getGlobalSpan(): GlobalSpan;
+export declare function clearGlobalSpan(): void;
+export declare function setCustomTracer(customTracer: Tracer): void;
+export declare function getCustomTracer(): Tracer;
+export declare function clearCustomTracer(): void;
+export declare function setCustomTracerIgnoredInstruments(ignoredInstruments: CustomTracerIgnoredInstruments[]): void;
+export declare function getCustomTracerIgnoredInstruments(): CustomTracerIgnoredInstruments[];
+export declare function shouldAttachSpanToGlobalSpan(instrumentationType: CustomTracerIgnoredInstruments): boolean;
+export declare function attachChildSpanToGlobalSpan(name: string): Span;

package/src/custom-spans/custom-spans.utils.js

@@ -0,0 +1,40 @@
+import { CUSTOM_TRACER_IGNORED_INSTRUMENTS, CUSTOM_TRACER_KEY, GLOBAL_SPAN_KEY, } from './custom-spans.consts';
+export function setGlobalSpan(globalSpan) {
+    window[GLOBAL_SPAN_KEY] = globalSpan;
+}
+export function getGlobalSpan() {
+    return window[GLOBAL_SPAN_KEY];
+}
+export function clearGlobalSpan() {
+    delete window[GLOBAL_SPAN_KEY];
+}
+export function setCustomTracer(customTracer) {
+    window[CUSTOM_TRACER_KEY] = customTracer;
+}
+export function getCustomTracer() {
+    return window[CUSTOM_TRACER_KEY];
+}
+export function clearCustomTracer() {
+    delete window[CUSTOM_TRACER_KEY];
+}
+export function setCustomTracerIgnoredInstruments(ignoredInstruments) {
+    window[CUSTOM_TRACER_IGNORED_INSTRUMENTS] = ignoredInstruments;
+}
+export function getCustomTracerIgnoredInstruments() {
+    return window[CUSTOM_TRACER_IGNORED_INSTRUMENTS];
+}
+export function shouldAttachSpanToGlobalSpan(instrumentationType) {
+    var _a;
+    return (getGlobalSpan() &&
+        !((_a = getCustomTracerIgnoredInstruments()) === null || _a === void 0 ? void 0 : _a.includes(instrumentationType)));
+}
+export function attachChildSpanToGlobalSpan(name) {
+    let span;
+    const globalSpan = getGlobalSpan();
+    globalSpan.withContext(() => {
+        const childSpan = globalSpan.startCustomSpan(name);
+        span = childSpan.span;
+    });
+    return span;
+}
+//# sourceMappingURL=custom-spans.utils.js.map

package/src/custom-spans/custom-spans.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-spans.utils.js","sourceRoot":"","sources":["../../../../../libs/browser/src/custom-spans/custom-spans.utils.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,iCAAiC,EACjC,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,UAAU,aAAa,CAAC,UAAsB;IAClD,MAAM,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,MAAM,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,kBAAoD;IAEpD,MAAM,CAAC,iCAAiC,CAAC,GAAG,kBAAkB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,MAAM,CAAC,iCAAiC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,mBAAmD;;IAEnD,OAAO,CACL,aAAa,EAAE;QACf,CAAC,CAAA,MAAA,iCAAiC,EAAE,0CAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,IAAW,CAAC;IAEhB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE;QAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/custom-spans/index.d.ts

@@ -0,0 +1,3 @@
+export * from './custom-spans.consts';
+export * from './custom-spans.types';
+export * from './custom-spans.utils';

package/src/custom-spans/index.js

@@ -0,0 +1,4 @@
+export * from './custom-spans.consts';
+export * from './custom-spans.types';
+export * from './custom-spans.utils';
+//# sourceMappingURL=index.js.map

package/src/custom-spans/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/browser/src/custom-spans/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}