@coralogix/browser 3.23.6 → 4.0.0

package/src/constants.d.ts

@@ -4,7 +4,8 @@ export declare const CORALOGIX_LOGS_URL_SUFFIX = "/browser/v1beta/logs";
 export declare const CORALOGIX_RECORDING_URL_SUFFIX = "/sessionrecording";
 export declare const MFE_METADATA_FILE = "cx-metadata.json";
 export declare const MFE_METADATA_URL_PATTERN: RegExp;
-export declare const MAX_INTERACTION_ELEMENT_SIZE = 1024;
+export declare const MAX_INTERACTION_ELEMENT_SIZE = 100;
+export declare const INTERACTION_TEXT_TRUNCATION_MARKER = " [...]";
 export declare const MAX_CHARACTERS = 1024;
 export declare const REQUIRED_CONFIG_KEYS: Array<keyof CoralogixBrowserSdkConfig>;
 export { SDK_CONFIG_KEY, USER_AGENT_KEY } from './tools/global-keys';
@@ -18,6 +19,8 @@ export declare const MASKED_TEXT = "***";
 export declare const MASK_CLASS_DEFAULT = "cx-mask";
 export declare const CX_PREFIX = "cx";
 export declare const ARIA_LABEL_ATTRIBUTE = "aria-label";
+export declare const TITLE_ATTRIBUTE = "title";
+export declare const ALT_ATTRIBUTE = "alt";
 export declare const PASSWORD_INPUT_TYPE: InputType;
 export declare const MASK_INPUT_TYPES_DEFAULT: InputType[];
 export declare const FINGER_PRINT_KEY = "cx-fingerprint";

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

@@ -1,6 +1,5 @@
 import { CustomTracerIgnoredInstruments, GlobalSpan } from './custom-spans.types';
-import { Tracer } from '@opentelemetry/sdk-trace-base';
-import { Span } from '@opentelemetry/api';
+import { Span, Tracer } from '@opentelemetry/api';
 export declare function addGlobalSpanByTraceId(traceId: string, globalSpan: GlobalSpan): void;
 export declare function getGlobalSpanByTraceId(traceId: string): GlobalSpan | undefined;
 export declare function clearGlobalSpanMap(): void;

package/src/helpers.d.ts

@@ -4,10 +4,12 @@ import { CoralogixBrowserSdkConfig, UserAgentData } from './types';
 import { SnapshotManager } from './snapshot/snapshotManager';
 import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
 import type { ClickScreenshotManager } from './instrumentations/screenshot/click-screenshot-manager';
+import type { DomChangeScreenshotTrigger } from './instrumentations/screenshot/dom-change-screenshot-trigger';
 export declare function getSnapshotManager(): SnapshotManager;
 export declare function getSessionManager(): SessionManager;
 export declare function getSessionRecorder(): SessionRecorder | undefined;
 export declare function getClickScreenshotManager(): ClickScreenshotManager | undefined;
+export declare function getDomChangeScreenshotTrigger(): DomChangeScreenshotTrigger | undefined;
 export declare function getSdkConfig(): CoralogixBrowserSdkConfig;
 export declare function getUserAgentData(): UserAgentData;
 export declare function clearMemoryFrom(keys: string[]): void;

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

@@ -3,7 +3,12 @@ export declare const NetworkInstrumentationAttributes: {
     RESPONSE_HEADERS: string;
     RESPONSE_PAYLOAD: string;
     REQUEST_PAYLOAD: string;
+    RESPONSE_CONTENT_LENGTH: string;
+    STATUS_TEXT: string;
+    STATUS_CODE: string;
 };
+export declare const UNKNOWN_STATUS_TEXT = "Unknown";
+export declare const HTTP_STATUS_TEXT: Record<number, string>;
 export declare enum FetchSource {
     FETCH = "fetch"
 }

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

@@ -1,2 +1,5 @@
 import { Span } from '@opentelemetry/api';
 export declare function checkAttachingNetworkSpanToGlobalSpan(span: Span): void;
+export declare function setResponseContentLength(span: Span, contentLength: string | null | undefined): void;
+export declare function setResponseStatusText(span: Span, statusText: string | null | undefined): void;
+export declare function setResponseStatusCode(span: Span, status: number | undefined): void;

package/src/instrumentations/screenshot/dom-change-screenshot-trigger.d.ts

@@ -0,0 +1,28 @@
+import { eventWithTime } from '../../cx-rrweb/rrweb-types';
+import { MirrorNodeResolver } from './dom-change-screenshot.consts';
+export declare class DomChangeScreenshotTrigger {
+    private settled;
+    private quietTimer;
+    private debounceTimer;
+    private lastInteractionAt;
+    private pendingReason;
+    private cachedElementCount;
+    private elementCountRefreshedAt;
+    private lastCaptureAt;
+    private capturesThisView;
+    static unregister(): void;
+    constructor();
+    reset: () => void;
+    onNavigation: () => void;
+    handleRecordEvent: (event: eventWithTime, resolveNode?: MirrorNodeResolver) => void;
+    private isUserInteraction;
+    private handleMutation;
+    private classify;
+    private capture;
+    private getElementCount;
+    private armSettleTimer;
+    private markSettled;
+    private clearTimers;
+    private clearSettleTimer;
+    private clearDebounceTimer;
+}

package/src/instrumentations/screenshot/dom-change-screenshot.consts.d.ts

@@ -0,0 +1,23 @@
+export declare const DOM_CHANGE_SCREENSHOT_TRIGGER_KEY = "rumDomChangeScreenshotTrigger";
+export declare const SETTLE_QUIET_MS = 500;
+export declare const CONTENT_ELEMENT_FLOOR = 50;
+export declare const CHANGE_DEBOUNCE_MS = 400;
+export declare const INTERACTION_TIGHT_MS = 150;
+export declare const INTERACTION_TIGHT_MIN_ELEMENTS = 1;
+export declare const INTERACTION_LOOSE_MS = 1500;
+export declare const INTERACTION_LOOSE_MIN_ELEMENTS = 3;
+export declare const OVERLAY_MAX_DEPTH = 3;
+export declare const MAX_DEPTH_WALK = 40;
+export declare const OVERLAY_MAX_REMOVES_ABSOLUTE = 2;
+export declare const OVERLAY_MAX_REMOVES_FRACTION = 0.1;
+export declare const VIEW_CHANGE_FRACTION = 0.02;
+export declare const VIEW_CHANGE_MIN_WEIGHT = 25;
+export declare const NODE_COUNT_REFRESH_MS = 2000;
+export declare const MIN_CAPTURE_INTERVAL_MS = 2000;
+export declare const MAX_CAPTURES_PER_VIEW = 10;
+export declare const MAX_NODES_FOR_CAPTURE = 20000;
+export type MirrorNodeResolver = (id: number) => Node | null;
+export declare const enum DomChangeReason {
+    Overlay = "dom-overlay",
+    ViewChange = "dom-view-change"
+}

package/src/instrumentations/screenshot/screenshot-gate.d.ts

@@ -0,0 +1 @@
+export declare function canCaptureAutomaticScreenshot(): boolean;

package/src/instrumentations/screenshot/screenshot.utils.d.ts

@@ -1,2 +1,4 @@
 export declare const SCREENSHOT_INSTRUMENTATION_NAME = "screenshot";
 export declare const SCREENSHOT_INSTRUMENTATION_VERSION = "1.0.0";
+export declare const MAX_SCREENSHOT_ACTIONS = 100;
+export declare function collectDomActionNames(limit?: number): string[];

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

@@ -1,13 +1,13 @@
 import { CoralogixBrowserSdkConfig } from '../../types';
+export declare const CLICKABLE_SELECTOR: string;
 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({ isDeadClick, element, config, actionName, ariaLabel, }: {
+export declare function extractResolvedName({ isDeadClick, element, config, actionName, }: {
     isDeadClick: boolean;
     element: Element | HTMLElement | null;
     config: CoralogixBrowserSdkConfig;
     actionName: string;
-    ariaLabel: string;
 }): string;
 export declare function extractMaskedOrTextContent(clickableElement: Element | HTMLElement | null, config: CoralogixBrowserSdkConfig): string;
 export declare function getClassName(element: Element | HTMLElement): string;

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

@@ -30,6 +30,7 @@ export interface CxRumSpanAttributes extends Attributes {
     'cx_rum.network_request_context.url'?: string;
     'cx_rum.network_request_context.status_code'?: number;
     'cx_rum.network_request_context.method'?: string;
+    'cx_rum.network_request_context.response_content_length'?: number;
 }
 export declare function buildCxRumSpanAttributes(attrs: CxRumSpanAttributes): Attributes;
 export declare function buildRumContextAttributes(cxRumEvent: CxRumEvent, resolvedLabels: CoralogixRumLabels): Attributes;

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

@@ -12,6 +12,7 @@ export interface SessionRecordingConfig extends Omit<recordOptions<eventWithTime
     sessionRecordingSampleRate?: number;
     workerUrl?: string;
     immediateFlush?: boolean;
+    captureScreenshotOnDomChange?: boolean;
 }
 export interface SessionWithErrorConfig {
     enable: boolean;

package/src/session/sessionRecorder.d.ts

@@ -29,6 +29,7 @@ export declare class SessionRecorder {
     getSegmentIndexCounter(): Record<string, number>;
     private restoreSegmentIndexCounter;
     getIsAutoStartRecording(): boolean;
+    isRecordingActive(): boolean;
     isConsoleRecordingActive(): boolean;
     set recordingStopDueToTimeout(value: boolean);
     get recordingStopDueToTimeout(): boolean;

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

@@ -0,0 +1,2 @@
+export declare const wrap: <Nodule extends object, FieldName extends keyof Nodule>(nodule: Nodule, name: FieldName, wrapper: (original: Nodule[FieldName], name: FieldName) => Nodule[FieldName]) => Nodule[FieldName] | undefined;
+export declare const unwrap: <Nodule extends object>(nodule: Nodule, name: keyof Nodule) => void;

package/src/types.d.ts

@@ -73,6 +73,7 @@ export interface CustomTargetElement extends HTMLElement {
 export interface ScreenshotContext {
     id: string;
     description?: string;
+    actions?: string[];
 }
 export interface DomContext {
     visibility_state: DocumentVisibilityState;
@@ -234,7 +235,7 @@ export interface NetworkRequestContext {
     subdomain?: string;
     domain?: string;
     status_text: string;
-    response_content_length: string;
+    response_content_length?: number;
     duration: number;
     source: EventSource;
     request_headers?: Map<string, string>;
@@ -430,13 +431,10 @@ export interface PrevSession extends Session {
     hasScreenshot: boolean;
 }
 export declare enum OtelNetworkAttrs {
-    METHOD = "http.method",
-    URL = "http.url",
-    STATUS_CODE = "http.status_code",
-    HOST = "http.host",
-    SCHEME = "http.scheme",
-    STATUS_TEXT = "http.status_text",
-    RESPONSE_CONTENT_LENGTH = "http.response_content_length"
+    METHOD = "http.request.method",
+    URL = "url.full",
+    STATUS_CODE = "http.response.status_code",
+    HOST = "server.address"
 }
 export type Browser = 'Chrome' | 'Edge' | 'Firefox' | 'Safari' | 'Opera' | 'IE' | 'Unknown';
 export type OS = 'Windows' | 'MacOS' | 'Linux' | 'iOS' | 'Android' | 'Tizen' | 'webOS' | 'Unknown';

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.23.6";
+export declare const SDK_VERSION = "4.0.0";