@kubesense/kubesense-browser-rum-core 1.7.0 → 2.0.0-beta.1

package/esm/domain/trackEventCounts.mjs

@@ -0,0 +1,45 @@
+import { RumEventType } from "../rawRumEvent.types.mjs";
+import "./lifeCycle.mjs";
+import { noop } from "@kubesense/kubesense-browser-core";
+//#region src/domain/trackEventCounts.ts
+function trackEventCounts({ lifeCycle, isChildEvent, onChange: callback = noop }) {
+	const eventCounts = {
+		errorCount: 0,
+		longTaskCount: 0,
+		resourceCount: 0,
+		actionCount: 0,
+		frustrationCount: 0
+	};
+	const subscription = lifeCycle.subscribe(14, (event) => {
+		if (event.type === "view" || event.type === "vital" || !isChildEvent(event)) return;
+		switch (event.type) {
+			case RumEventType.ERROR:
+				eventCounts.errorCount += 1;
+				callback();
+				break;
+			case RumEventType.ACTION:
+				eventCounts.actionCount += 1;
+				if (event.action.frustration) eventCounts.frustrationCount += event.action.frustration.type.length;
+				callback();
+				break;
+			case RumEventType.LONG_TASK:
+				eventCounts.longTaskCount += 1;
+				callback();
+				break;
+			case RumEventType.RESOURCE: if (!event._kubesense?.discarded) {
+				eventCounts.resourceCount += 1;
+				callback();
+			}
+		}
+	});
+	return {
+		stop: () => {
+			subscription.unsubscribe();
+		},
+		eventCounts
+	};
+}
+//#endregion
+export { trackEventCounts };
+
+//# sourceMappingURL=trackEventCounts.mjs.map

package/esm/domain/trackEventCounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackEventCounts.mjs","names":[],"sources":["../../src/domain/trackEventCounts.ts"],"sourcesContent":["import { noop } from '@kubesense/kubesense-browser-core'\nimport { RumEventType } from '../rawRumEvent.types'\nimport type { RumActionEvent, RumErrorEvent, RumLongTaskEvent, RumResourceEvent } from '../rumEvent.types'\nimport type { LifeCycle } from './lifeCycle'\nimport { LifeCycleEventType } from './lifeCycle'\n\nexport interface EventCounts {\n  errorCount: number\n  actionCount: number\n  longTaskCount: number\n  resourceCount: number\n  frustrationCount: number\n}\n\nexport function trackEventCounts({\n  lifeCycle,\n  isChildEvent,\n  onChange: callback = noop,\n}: {\n  lifeCycle: LifeCycle\n  isChildEvent: (event: RumActionEvent | RumErrorEvent | RumLongTaskEvent | RumResourceEvent) => boolean\n  onChange?: () => void\n}) {\n  const eventCounts: EventCounts = {\n    errorCount: 0,\n    longTaskCount: 0,\n    resourceCount: 0,\n    actionCount: 0,\n    frustrationCount: 0,\n  }\n\n  const subscription = lifeCycle.subscribe(LifeCycleEventType.RUM_EVENT_COLLECTED, (event): void => {\n    if (event.type === 'view' || event.type === 'vital' || !isChildEvent(event)) {\n      return\n    }\n    switch (event.type) {\n      case RumEventType.ERROR:\n        eventCounts.errorCount += 1\n        callback()\n        break\n      case RumEventType.ACTION:\n        eventCounts.actionCount += 1\n        if (event.action.frustration) {\n          eventCounts.frustrationCount += event.action.frustration.type.length\n        }\n        callback()\n        break\n      case RumEventType.LONG_TASK:\n        eventCounts.longTaskCount += 1\n        callback()\n        break\n      case RumEventType.RESOURCE:\n        if (!event._kubesense?.discarded) {\n          eventCounts.resourceCount += 1\n          callback()\n        }\n        break\n    }\n  })\n\n  return {\n    stop: () => {\n      subscription.unsubscribe()\n    },\n    eventCounts,\n  }\n}\n"],"mappings":";;;;AAcA,SAAgB,iBAAiB,EAC/B,WACA,cACA,UAAU,WAAW,QAKpB;CACD,MAAM,cAA2B;EAC/B,YAAY;EACZ,eAAe;EACf,eAAe;EACf,aAAa;EACb,kBAAkB;CACpB;CAEA,MAAM,eAAe,UAAU,UAAA,KAAmD,UAAgB;EAChG,IAAI,MAAM,SAAS,UAAU,MAAM,SAAS,WAAW,CAAC,aAAa,KAAK,GACxE;EAEF,QAAQ,MAAM,MAAd;GACE,KAAK,aAAa;IAChB,YAAY,cAAc;IAC1B,SAAS;IACT;GACF,KAAK,aAAa;IAChB,YAAY,eAAe;IAC3B,IAAI,MAAM,OAAO,aACf,YAAY,oBAAoB,MAAM,OAAO,YAAY,KAAK;IAEhE,SAAS;IACT;GACF,KAAK,aAAa;IAChB,YAAY,iBAAiB;IAC7B,SAAS;IACT;GACF,KAAK,aAAa,UAChB,IAAI,CAAC,MAAM,YAAY,WAAW;IAChC,YAAY,iBAAiB;IAC7B,SAAS;GACX;EAEJ;CACF,CAAC;CAED,OAAO;EACL,YAAY;GACV,aAAa,YAAY;EAC3B;EACA;CACF;AACF"}

package/esm/domain/view/bfCacheSupport.mjs

@@ -0,0 +1,12 @@
+import { DOM_EVENT, addEventListener } from "@kubesense/kubesense-browser-core";
+//#region src/domain/view/bfCacheSupport.ts
+function onBFCacheRestore(callback) {
+	const { stop } = addEventListener(window, DOM_EVENT.PAGE_SHOW, (event) => {
+		if (event.persisted) callback(event);
+	}, { capture: true });
+	return stop;
+}
+//#endregion
+export { onBFCacheRestore };
+
+//# sourceMappingURL=bfCacheSupport.mjs.map

package/esm/domain/view/bfCacheSupport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bfCacheSupport.mjs","names":[],"sources":["../../../src/domain/view/bfCacheSupport.ts"],"sourcesContent":["import { addEventListener, DOM_EVENT } from '@kubesense/kubesense-browser-core'\n\nexport function onBFCacheRestore(callback: (event: PageTransitionEvent) => void): () => void {\n  const { stop } = addEventListener(\n    window,\n    DOM_EVENT.PAGE_SHOW,\n    (event: PageTransitionEvent) => {\n      if (event.persisted) {\n        callback(event)\n      }\n    },\n    { capture: true }\n  )\n  return stop\n}\n"],"mappings":";;AAEA,SAAgB,iBAAiB,UAA4D;CAC3F,MAAM,EAAE,SAAS,iBACf,QACA,UAAU,YACT,UAA+B;EAC9B,IAAI,MAAM,WACR,SAAS,KAAK;CAElB,GACA,EAAE,SAAS,KAAK,CAClB;CACA,OAAO;AACT"}

package/esm/domain/view/trackViewEventCounts.mjs

@@ -0,0 +1,17 @@
+import { trackEventCounts } from "../trackEventCounts.mjs";
+//#region src/domain/view/trackViewEventCounts.ts
+function trackViewEventCounts(lifeCycle, viewId, onChange) {
+	const { stop, eventCounts } = trackEventCounts({
+		lifeCycle,
+		isChildEvent: (event) => event.view.id === viewId,
+		onChange
+	});
+	return {
+		stop,
+		eventCounts
+	};
+}
+//#endregion
+export { trackViewEventCounts };
+
+//# sourceMappingURL=trackViewEventCounts.mjs.map

package/esm/domain/view/trackViewEventCounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackViewEventCounts.mjs","names":[],"sources":["../../../src/domain/view/trackViewEventCounts.ts"],"sourcesContent":["import type { LifeCycle } from '../lifeCycle'\nimport { trackEventCounts } from '../trackEventCounts'\n\nexport function trackViewEventCounts(lifeCycle: LifeCycle, viewId: string, onChange: () => void) {\n  const { stop, eventCounts } = trackEventCounts({\n    lifeCycle,\n    isChildEvent: (event) => event.view.id === viewId,\n    onChange,\n  })\n\n  return {\n    stop,\n    eventCounts,\n  }\n}\n"],"mappings":";;AAGA,SAAgB,qBAAqB,WAAsB,QAAgB,UAAsB;CAC/F,MAAM,EAAE,MAAM,gBAAgB,iBAAiB;EAC7C;EACA,eAAe,UAAU,MAAM,KAAK,OAAO;EAC3C;CACF,CAAC;CAED,OAAO;EACL;EACA;CACF;AACF"}

package/esm/domain/view/trackViews.mjs

@@ -0,0 +1,230 @@
+import { ViewLoadingType } from "../../rawRumEvent.types.mjs";
+import "../lifeCycle.mjs";
+import { trackViewEventCounts } from "./trackViewEventCounts.mjs";
+import { trackInitialViewMetrics } from "./viewMetrics/trackInitialViewMetrics.mjs";
+import { trackCommonViewMetrics } from "./viewMetrics/trackCommonViewMetrics.mjs";
+import { onBFCacheRestore } from "./bfCacheSupport.mjs";
+import { trackBfcacheMetrics } from "./viewMetrics/trackBfcacheMetrics.mjs";
+import { ONE_MINUTE, clocksNow, clocksOrigin, elapsed, isRelativeTime, relativeToClocks, timeStampNow } from "@kubesense/kubesense-js-core/time";
+import { Observable, PageExitReason, clearInterval, createContextManager, display, generateUUID, mockable, noop, setInterval, setTimeout, shallowClone, throttle } from "@kubesense/kubesense-browser-core";
+//#region src/domain/view/trackViews.ts
+const THROTTLE_VIEW_UPDATE_PERIOD = 3e3;
+const SESSION_KEEP_ALIVE_INTERVAL = 5 * ONE_MINUTE;
+const KEEP_TRACKING_AFTER_VIEW_DELAY = 5 * ONE_MINUTE;
+function trackViews(lifeCycle, domMutationObservable, windowOpenObservable, configuration, locationChangeObservable, areViewsTrackedAutomatically, initialViewOptions) {
+	const activeViews = /* @__PURE__ */ new Set();
+	let currentView = startNewView(ViewLoadingType.INITIAL_LOAD, clocksOrigin(), initialViewOptions);
+	let stopOnBFCacheRestore;
+	startViewLifeCycle();
+	let locationChangeSubscription;
+	if (areViewsTrackedAutomatically) {
+		locationChangeSubscription = renewViewOnLocationChange(locationChangeObservable);
+		stopOnBFCacheRestore = onBFCacheRestore((pageshowEvent) => {
+			currentView.end();
+			const startClocks = relativeToClocks(pageshowEvent.timeStamp);
+			currentView = startNewView(ViewLoadingType.BF_CACHE, startClocks, void 0);
+		});
+	}
+	function startNewView(loadingType, startClocks, viewOptions) {
+		const newlyCreatedView = newView(lifeCycle, domMutationObservable, windowOpenObservable, configuration, loadingType, startClocks, viewOptions);
+		activeViews.add(newlyCreatedView);
+		newlyCreatedView.stopObservable.subscribe(() => {
+			activeViews.delete(newlyCreatedView);
+		});
+		return newlyCreatedView;
+	}
+	function startViewLifeCycle() {
+		lifeCycle.subscribe(11, () => {
+			currentView = startNewView(ViewLoadingType.SESSION_RENEWAL, void 0, {
+				name: currentView.name,
+				service: currentView.service,
+				version: currentView.version,
+				context: currentView.contextManager.getContext()
+			});
+		});
+		lifeCycle.subscribe(10, ({ endClocks }) => {
+			currentView.end({
+				sessionIsActive: false,
+				endClocks
+			});
+		});
+	}
+	function renewViewOnLocationChange(locationChangeObservable) {
+		return locationChangeObservable.subscribe(({ oldLocation, newLocation }) => {
+			if (areDifferentLocation(oldLocation, newLocation)) {
+				currentView.end();
+				currentView = startNewView(ViewLoadingType.ROUTE_CHANGE);
+			}
+		});
+	}
+	return {
+		addTiming: (name, time = timeStampNow()) => {
+			currentView.addTiming(name, time);
+		},
+		setLoadingTime: (callTimestamp) => currentView.setLoadingTime(callTimestamp),
+		startView: (options, startClocks) => {
+			currentView.end({ endClocks: startClocks });
+			currentView = startNewView(ViewLoadingType.ROUTE_CHANGE, startClocks, options);
+		},
+		setViewContext: (context) => {
+			currentView.contextManager.setContext(context);
+		},
+		setViewContextProperty: (key, value) => {
+			currentView.contextManager.setContextProperty(key, value);
+		},
+		setViewName: (name) => {
+			currentView.setViewName(name);
+		},
+		getViewContext: () => currentView.contextManager.getContext(),
+		stop: () => {
+			if (locationChangeSubscription) locationChangeSubscription.unsubscribe();
+			if (stopOnBFCacheRestore) stopOnBFCacheRestore();
+			currentView.end();
+			activeViews.forEach((view) => view.stop());
+		}
+	};
+}
+function newView(lifeCycle, domMutationObservable, windowOpenObservable, configuration, loadingType, startClocks = clocksNow(), viewOptions) {
+	const id = generateUUID();
+	const stopObservable = new Observable();
+	const customTimings = {};
+	let documentVersion = 0;
+	let endClocks;
+	const location = shallowClone(mockable(window.location));
+	const contextManager = createContextManager();
+	let sessionIsActive = true;
+	let name = viewOptions?.name;
+	const service = viewOptions?.service || configuration.service;
+	const version = viewOptions?.version || configuration.version;
+	const context = viewOptions?.context;
+	const handlingStack = viewOptions?.handlingStack;
+	if (context) contextManager.setContext(context);
+	const viewCreatedEvent = {
+		id,
+		name,
+		startClocks,
+		service,
+		version,
+		context,
+		url: viewOptions?.url
+	};
+	lifeCycle.notify(1, viewCreatedEvent);
+	lifeCycle.notify(2, viewCreatedEvent);
+	const { throttled, cancel: cancelScheduleViewUpdate } = throttle(triggerViewUpdate, THROTTLE_VIEW_UPDATE_PERIOD, { leading: false });
+	const { setLoadEvent, setViewEnd, stop: stopCommonViewMetricsTracking, stopINPTracking, getCommonViewMetrics, setLoadingTime } = trackCommonViewMetrics(lifeCycle, domMutationObservable, windowOpenObservable, configuration, scheduleViewUpdate, loadingType, startClocks);
+	const { stop: stopInitialViewMetricsTracking, initialViewMetrics } = loadingType === ViewLoadingType.INITIAL_LOAD ? trackInitialViewMetrics(configuration, startClocks, setLoadEvent, scheduleViewUpdate) : {
+		stop: noop,
+		initialViewMetrics: {}
+	};
+	if (loadingType === ViewLoadingType.BF_CACHE) trackBfcacheMetrics(startClocks, initialViewMetrics, scheduleViewUpdate);
+	const { stop: stopEventCountsTracking, eventCounts } = trackViewEventCounts(lifeCycle, id, scheduleViewUpdate);
+	const keepAliveIntervalId = setInterval(triggerViewUpdate, SESSION_KEEP_ALIVE_INTERVAL);
+	const pageMayExitSubscription = lifeCycle.subscribe(12, (reason) => {
+		if (reason === PageExitReason.UNLOADING || reason === PageExitReason.PAGEHIDE) triggerViewUpdate(true);
+	});
+	triggerViewUpdate();
+	contextManager.changeObservable.subscribe(scheduleViewUpdate);
+	function triggerBeforeViewUpdate() {
+		lifeCycle.notify(3, {
+			id,
+			name,
+			context: contextManager.getContext(),
+			startClocks,
+			sessionIsActive
+		});
+	}
+	function scheduleViewUpdate() {
+		triggerBeforeViewUpdate();
+		throttled();
+	}
+	function triggerViewUpdate(forceInactive = false) {
+		cancelScheduleViewUpdate();
+		triggerBeforeViewUpdate();
+		documentVersion += 1;
+		const currentEnd = endClocks === void 0 ? timeStampNow() : endClocks.timeStamp;
+		lifeCycle.notify(4, {
+			customTimings,
+			documentVersion,
+			id,
+			name,
+			service,
+			version,
+			context: contextManager.getContext(),
+			loadingType,
+			location,
+			handlingStack,
+			startClocks,
+			commonViewMetrics: getCommonViewMetrics(),
+			initialViewMetrics,
+			duration: elapsed(startClocks.timeStamp, currentEnd),
+			isActive: !forceInactive && endClocks === void 0,
+			sessionIsActive,
+			eventCounts
+		});
+	}
+	return {
+		get name() {
+			return name;
+		},
+		service,
+		version,
+		contextManager,
+		stopObservable,
+		end(options = {}) {
+			if (endClocks) return;
+			endClocks = options.endClocks ?? clocksNow();
+			if (endClocks.relative < startClocks.relative) endClocks = startClocks;
+			sessionIsActive = options.sessionIsActive ?? true;
+			lifeCycle.notify(5, { endClocks });
+			lifeCycle.notify(6, { endClocks });
+			clearInterval(keepAliveIntervalId);
+			setViewEnd(endClocks.relative);
+			stopCommonViewMetricsTracking();
+			pageMayExitSubscription.unsubscribe();
+			triggerViewUpdate();
+			setTimeout(() => {
+				this.stop();
+			}, KEEP_TRACKING_AFTER_VIEW_DELAY);
+		},
+		stop() {
+			stopInitialViewMetricsTracking();
+			stopEventCountsTracking();
+			stopINPTracking();
+			stopObservable.notify();
+		},
+		addTiming(name, time) {
+			if (endClocks) return;
+			const relativeTime = isRelativeTime(time) ? time : elapsed(startClocks.timeStamp, time);
+			customTimings[sanitizeTiming(name)] = relativeTime;
+			scheduleViewUpdate();
+		},
+		setLoadingTime,
+		setViewName(updatedName) {
+			name = updatedName;
+			triggerViewUpdate();
+		}
+	};
+}
+/**
+* Timing name is used as facet path that must contain only letters, digits, or the characters - _ . @ $
+*/
+function sanitizeTiming(name) {
+	const sanitized = name.replace(/[^a-zA-Z0-9-_.@$]/g, "_");
+	if (sanitized !== name) display.warn(`Invalid timing name: ${name}, sanitized to: ${sanitized}`);
+	return sanitized;
+}
+function areDifferentLocation(currentLocation, otherLocation) {
+	return currentLocation.pathname !== otherLocation.pathname || !isHashAnAnchor(otherLocation.hash) && getPathFromHash(otherLocation.hash) !== getPathFromHash(currentLocation.hash);
+}
+function isHashAnAnchor(hash) {
+	const correspondingId = hash.substring(1);
+	return correspondingId !== "" && !!document.getElementById(correspondingId);
+}
+function getPathFromHash(hash) {
+	const index = hash.indexOf("?");
+	return index < 0 ? hash : hash.slice(0, index);
+}
+//#endregion
+export { KEEP_TRACKING_AFTER_VIEW_DELAY, SESSION_KEEP_ALIVE_INTERVAL, THROTTLE_VIEW_UPDATE_PERIOD, trackViews };
+
+//# sourceMappingURL=trackViews.mjs.map

package/esm/domain/view/trackViews.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackViews.mjs","names":[],"sources":["../../../src/domain/view/trackViews.ts"],"sourcesContent":["import {\n  ONE_MINUTE,\n  elapsed,\n  timeStampNow,\n  clocksNow,\n  clocksOrigin,\n  relativeToClocks,\n  isRelativeTime,\n} from '@kubesense/kubesense-js-core/time'\nimport type { Duration, TimeStamp, ClocksState, RelativeTime } from '@kubesense/kubesense-js-core/time'\nimport type { Subscription, Context, ContextValue } from '@kubesense/kubesense-browser-core'\nimport {\n  noop,\n  PageExitReason,\n  shallowClone,\n  generateUUID,\n  throttle,\n  display,\n  setInterval,\n  clearInterval,\n  setTimeout,\n  Observable,\n  createContextManager,\n  mockable,\n} from '@kubesense/kubesense-browser-core'\nimport type { ViewCustomTimings } from '../../rawRumEvent.types'\nimport { ViewLoadingType } from '../../rawRumEvent.types'\nimport type { LifeCycle } from '../lifeCycle'\nimport { LifeCycleEventType } from '../lifeCycle'\nimport type { EventCounts } from '../trackEventCounts'\nimport type { LocationChange } from '../../browser/locationChangeObservable'\nimport type { RumConfiguration, RumInitConfiguration } from '../configuration'\nimport type { RumMutationRecord } from '../../browser/domMutationObservable'\nimport { trackViewEventCounts } from './trackViewEventCounts'\nimport { trackInitialViewMetrics } from './viewMetrics/trackInitialViewMetrics'\nimport type { InitialViewMetrics } from './viewMetrics/trackInitialViewMetrics'\nimport type { CommonViewMetrics } from './viewMetrics/trackCommonViewMetrics'\nimport { trackCommonViewMetrics } from './viewMetrics/trackCommonViewMetrics'\nimport { onBFCacheRestore } from './bfCacheSupport'\nimport { trackBfcacheMetrics } from './viewMetrics/trackBfcacheMetrics'\n\nexport interface ViewEvent {\n  id: string\n  name?: string\n  service?: string\n  version?: string\n  context?: Context\n  location: Readonly<Location>\n  handlingStack?: string\n  commonViewMetrics: CommonViewMetrics\n  initialViewMetrics: InitialViewMetrics\n  customTimings: ViewCustomTimings\n  eventCounts: EventCounts\n  documentVersion: number\n  startClocks: ClocksState\n  duration: Duration\n  isActive: boolean\n  sessionIsActive: boolean\n  loadingType: ViewLoadingType\n}\n\nexport interface ViewCreatedEvent {\n  id: string\n  name?: string\n  service?: string\n  version?: string\n  context?: Context\n  startClocks: ClocksState\n  url?: string\n}\n\nexport interface BeforeViewUpdateEvent {\n  id: string\n  name?: string\n  context?: Context\n  startClocks: ClocksState\n  sessionIsActive: boolean\n}\n\nexport interface ViewEndedEvent {\n  endClocks: ClocksState\n}\n\nexport const THROTTLE_VIEW_UPDATE_PERIOD = 3000\nexport const SESSION_KEEP_ALIVE_INTERVAL = 5 * ONE_MINUTE\n\n// Some events or metrics can be captured after the end of the view. To avoid missing those;\n// an arbitrary delay is added for stopping their tracking after the view ends.\n//\n// Ideally, we would not stop and keep tracking events or metrics until the end of the session.\n// But this might have a small performance impact if there are many many views.\n// So let's have a fairly short delay improving the situation in most cases and avoid impacting performances too much.\nexport const KEEP_TRACKING_AFTER_VIEW_DELAY = 5 * ONE_MINUTE\n\nexport interface ViewOptions {\n  name?: string\n  service?: RumInitConfiguration['service']\n  version?: RumInitConfiguration['version']\n  context?: Context\n  handlingStack?: string\n  url?: string\n}\n\nexport function trackViews(\n  lifeCycle: LifeCycle,\n  domMutationObservable: Observable<RumMutationRecord[]>,\n  windowOpenObservable: Observable<void>,\n  configuration: RumConfiguration,\n  locationChangeObservable: Observable<LocationChange>,\n  areViewsTrackedAutomatically: boolean,\n  initialViewOptions?: ViewOptions\n) {\n  const activeViews: Set<ReturnType<typeof newView>> = new Set()\n  let currentView = startNewView(ViewLoadingType.INITIAL_LOAD, clocksOrigin(), initialViewOptions)\n  let stopOnBFCacheRestore: (() => void) | undefined\n\n  startViewLifeCycle()\n\n  let locationChangeSubscription: Subscription\n  if (areViewsTrackedAutomatically) {\n    locationChangeSubscription = renewViewOnLocationChange(locationChangeObservable)\n    stopOnBFCacheRestore = onBFCacheRestore((pageshowEvent) => {\n      currentView.end()\n      const startClocks = relativeToClocks(pageshowEvent.timeStamp as RelativeTime)\n      currentView = startNewView(ViewLoadingType.BF_CACHE, startClocks, undefined)\n    })\n  }\n\n  function startNewView(loadingType: ViewLoadingType, startClocks?: ClocksState, viewOptions?: ViewOptions) {\n    const newlyCreatedView = newView(\n      lifeCycle,\n      domMutationObservable,\n      windowOpenObservable,\n      configuration,\n      loadingType,\n      startClocks,\n      viewOptions\n    )\n    activeViews.add(newlyCreatedView)\n    newlyCreatedView.stopObservable.subscribe(() => {\n      activeViews.delete(newlyCreatedView)\n    })\n    return newlyCreatedView\n  }\n\n  function startViewLifeCycle() {\n    lifeCycle.subscribe(LifeCycleEventType.SESSION_RENEWED, () => {\n      currentView = startNewView(ViewLoadingType.SESSION_RENEWAL, undefined, {\n        // Renew view on session renewal\n        name: currentView.name,\n        service: currentView.service,\n        version: currentView.version,\n        context: currentView.contextManager.getContext(),\n      })\n    })\n\n    lifeCycle.subscribe(LifeCycleEventType.SESSION_EXPIRED, ({ endClocks }) => {\n      currentView.end({ sessionIsActive: false, endClocks })\n    })\n  }\n\n  function renewViewOnLocationChange(locationChangeObservable: Observable<LocationChange>) {\n    return locationChangeObservable.subscribe(({ oldLocation, newLocation }) => {\n      if (areDifferentLocation(oldLocation, newLocation)) {\n        currentView.end()\n        currentView = startNewView(ViewLoadingType.ROUTE_CHANGE)\n      }\n    })\n  }\n\n  return {\n    addTiming: (name: string, time: RelativeTime | TimeStamp = timeStampNow()) => {\n      currentView.addTiming(name, time)\n    },\n    setLoadingTime: (callTimestamp?: TimeStamp) => currentView.setLoadingTime(callTimestamp),\n    startView: (options?: ViewOptions, startClocks?: ClocksState) => {\n      currentView.end({ endClocks: startClocks })\n      currentView = startNewView(ViewLoadingType.ROUTE_CHANGE, startClocks, options)\n    },\n    setViewContext: (context: Context) => {\n      currentView.contextManager.setContext(context)\n    },\n    setViewContextProperty: (key: string, value: ContextValue) => {\n      currentView.contextManager.setContextProperty(key, value)\n    },\n    setViewName: (name: string) => {\n      currentView.setViewName(name)\n    },\n    getViewContext: () => currentView.contextManager.getContext(),\n\n    stop: () => {\n      if (locationChangeSubscription) {\n        locationChangeSubscription.unsubscribe()\n      }\n      if (stopOnBFCacheRestore) {\n        stopOnBFCacheRestore()\n      }\n      currentView.end()\n      activeViews.forEach((view) => view.stop())\n    },\n  }\n}\n\nfunction newView(\n  lifeCycle: LifeCycle,\n  domMutationObservable: Observable<RumMutationRecord[]>,\n  windowOpenObservable: Observable<void>,\n  configuration: RumConfiguration,\n  loadingType: ViewLoadingType,\n  startClocks: ClocksState = clocksNow(),\n  viewOptions?: ViewOptions\n) {\n  // Setup initial values\n  const id = generateUUID()\n  const stopObservable = new Observable<void>()\n  const customTimings: ViewCustomTimings = {}\n  let documentVersion = 0\n  let endClocks: ClocksState | undefined\n  const location = shallowClone(mockable(window.location))\n  const contextManager = createContextManager()\n\n  let sessionIsActive = true\n  let name = viewOptions?.name\n  const service = viewOptions?.service || configuration.service\n  const version = viewOptions?.version || configuration.version\n  const context = viewOptions?.context\n  const handlingStack = viewOptions?.handlingStack\n\n  if (context) {\n    contextManager.setContext(context)\n  }\n\n  const viewCreatedEvent = {\n    id,\n    name,\n    startClocks,\n    service,\n    version,\n    context,\n    url: viewOptions?.url,\n  }\n  lifeCycle.notify(LifeCycleEventType.BEFORE_VIEW_CREATED, viewCreatedEvent)\n  lifeCycle.notify(LifeCycleEventType.VIEW_CREATED, viewCreatedEvent)\n\n  // Update the view every time the measures are changing\n  const { throttled, cancel: cancelScheduleViewUpdate } = throttle(triggerViewUpdate, THROTTLE_VIEW_UPDATE_PERIOD, {\n    leading: false,\n  })\n\n  const {\n    setLoadEvent,\n    setViewEnd,\n    stop: stopCommonViewMetricsTracking,\n    stopINPTracking,\n    getCommonViewMetrics,\n    setLoadingTime,\n  } = trackCommonViewMetrics(\n    lifeCycle,\n    domMutationObservable,\n    windowOpenObservable,\n    configuration,\n    scheduleViewUpdate,\n    loadingType,\n    startClocks\n  )\n\n  const { stop: stopInitialViewMetricsTracking, initialViewMetrics } =\n    loadingType === ViewLoadingType.INITIAL_LOAD\n      ? trackInitialViewMetrics(configuration, startClocks, setLoadEvent, scheduleViewUpdate)\n      : { stop: noop, initialViewMetrics: {} as InitialViewMetrics }\n\n  // Start BFCache-specific metrics when restoring from BFCache\n  if (loadingType === ViewLoadingType.BF_CACHE) {\n    trackBfcacheMetrics(startClocks, initialViewMetrics, scheduleViewUpdate)\n  }\n\n  const { stop: stopEventCountsTracking, eventCounts } = trackViewEventCounts(lifeCycle, id, scheduleViewUpdate)\n\n  // Session keep alive\n  const keepAliveIntervalId = setInterval(triggerViewUpdate, SESSION_KEEP_ALIVE_INTERVAL)\n\n  const pageMayExitSubscription = lifeCycle.subscribe(LifeCycleEventType.PREPARE_URGENT_FLUSH, (reason) => {\n    // beforeunload is the unreliable half of this: it is skipped on mobile and\n    // when a tab is discarded, while pagehide fires on the paths it misses. The\n    // replay recorder already flushes on every exit reason, which is how a\n    // session ends up with a segment recorded after the last view update the\n    // backend ever saw — the view then stays active, and the session's duration\n    // is reported without its final and usually longest view.\n    if (reason === PageExitReason.UNLOADING || reason === PageExitReason.PAGEHIDE) {\n      // Force the final emission's isActive=false without mutating endClocks.\n      // Why this matters: the regular triggerViewUpdate computes\n      // `isActive: endClocks === undefined`, which is `true` here because we\n      // haven't called end(). If we leave the final pre-unload event with\n      // isActive=true the view sits in rum_view_raw permanently active —\n      // the backend cron only aggregates inactive views, so the view stays\n      // invisible to rum_view (and session aggregations) until a 10-minute\n      // stale-view fallback force-finalizes it.\n      // Why not just set endClocks here: beforeunload is not guaranteed to\n      // be followed by an actual unload (the user can cancel navigation in\n      // some flows). If we permanently set endClocks, setViewEnd() would\n      // also fire — which calls stopViewInteractionCount() and stops INP /\n      // interaction tracking for the rest of the page's life, and any later\n      // addTiming() calls are silently dropped (see the endClocks guard in\n      // addTiming). Forcing the override only on this one emission keeps\n      // the view fully recoverable if the page survives.\n      triggerViewUpdate(true)\n    }\n  })\n\n  // Initial view update\n  triggerViewUpdate()\n\n  // View context update should always be throttled\n  contextManager.changeObservable.subscribe(scheduleViewUpdate)\n\n  function triggerBeforeViewUpdate() {\n    lifeCycle.notify(LifeCycleEventType.BEFORE_VIEW_UPDATED, {\n      id,\n      name,\n      context: contextManager.getContext(),\n      startClocks,\n      sessionIsActive,\n    })\n  }\n\n  function scheduleViewUpdate() {\n    triggerBeforeViewUpdate()\n    throttled()\n  }\n\n  function triggerViewUpdate(forceInactive = false) {\n    cancelScheduleViewUpdate()\n    triggerBeforeViewUpdate()\n\n    documentVersion += 1\n    const currentEnd = endClocks === undefined ? timeStampNow() : endClocks.timeStamp\n    lifeCycle.notify(LifeCycleEventType.VIEW_UPDATED, {\n      customTimings,\n      documentVersion,\n      id,\n      name,\n      service,\n      version,\n      context: contextManager.getContext(),\n      loadingType,\n      location,\n      handlingStack,\n      startClocks,\n      commonViewMetrics: getCommonViewMetrics(),\n      initialViewMetrics,\n      duration: elapsed(startClocks.timeStamp, currentEnd),\n      // forceInactive is set by the page-unload handler so the final emission\n      // is marked inactive without permanently ending the view (see comment\n      // there). All other call sites use the natural endClocks-based check.\n      isActive: !forceInactive && endClocks === undefined,\n      sessionIsActive,\n      eventCounts,\n    })\n  }\n\n  return {\n    get name() {\n      return name\n    },\n    service,\n    version,\n    contextManager,\n    stopObservable,\n    end(options: { endClocks?: ClocksState; sessionIsActive?: boolean } = {}) {\n      if (endClocks) {\n        // view already ended\n        return\n      }\n      endClocks = options.endClocks ?? clocksNow()\n      // A session timeout is dated to when it happened (see getSessionEndClocks), which can\n      // precede a view a late-running tab started afterwards. A view never ends before it starts.\n      if (endClocks.relative < startClocks.relative) {\n        endClocks = startClocks\n      }\n      sessionIsActive = options.sessionIsActive ?? true\n\n      lifeCycle.notify(LifeCycleEventType.VIEW_ENDED, { endClocks })\n      lifeCycle.notify(LifeCycleEventType.AFTER_VIEW_ENDED, { endClocks })\n      clearInterval(keepAliveIntervalId)\n      setViewEnd(endClocks.relative)\n      stopCommonViewMetricsTracking()\n      pageMayExitSubscription.unsubscribe()\n      triggerViewUpdate()\n      setTimeout(() => {\n        this.stop()\n      }, KEEP_TRACKING_AFTER_VIEW_DELAY)\n    },\n    stop() {\n      stopInitialViewMetricsTracking()\n      stopEventCountsTracking()\n      stopINPTracking()\n      stopObservable.notify()\n    },\n    addTiming(name: string, time: RelativeTime | TimeStamp) {\n      if (endClocks) {\n        return\n      }\n      const relativeTime = isRelativeTime(time) ? time : elapsed(startClocks.timeStamp, time)\n      customTimings[sanitizeTiming(name)] = relativeTime\n      scheduleViewUpdate()\n    },\n    setLoadingTime,\n    setViewName(updatedName: string) {\n      name = updatedName\n      triggerViewUpdate()\n    },\n  }\n}\n\n/**\n * Timing name is used as facet path that must contain only letters, digits, or the characters - _ . @ $\n */\nfunction sanitizeTiming(name: string) {\n  const sanitized = name.replace(/[^a-zA-Z0-9-_.@$]/g, '_')\n  if (sanitized !== name) {\n    display.warn(`Invalid timing name: ${name}, sanitized to: ${sanitized}`)\n  }\n  return sanitized\n}\n\nfunction areDifferentLocation(currentLocation: Location, otherLocation: Location) {\n  return (\n    currentLocation.pathname !== otherLocation.pathname ||\n    (!isHashAnAnchor(otherLocation.hash) &&\n      getPathFromHash(otherLocation.hash) !== getPathFromHash(currentLocation.hash))\n  )\n}\n\nfunction isHashAnAnchor(hash: string) {\n  const correspondingId = hash.substring(1)\n  // check if the correspondingId is empty because on Firefox an empty string passed to getElementById() prints a consol warning\n  return correspondingId !== '' && !!document.getElementById(correspondingId)\n}\n\nfunction getPathFromHash(hash: string) {\n  const index = hash.indexOf('?')\n  return index < 0 ? hash : hash.slice(0, index)\n}\n"],"mappings":"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"}

package/esm/domain/view/viewCollection.mjs

@@ -0,0 +1,129 @@
+import { RumEventType } from "../../rawRumEvent.types.mjs";
+import "../lifeCycle.mjs";
+import { discardNegativeDuration } from "../discardNegativeDuration.mjs";
+import { trackViews } from "./trackViews.mjs";
+import { toServerDuration } from "@kubesense/kubesense-js-core/time";
+import { getTimeZone, isEmptyObject, mapValues } from "@kubesense/kubesense-browser-core";
+import { DISCARDED } from "@kubesense/kubesense-js-core/assembly";
+//#region src/domain/view/viewCollection.ts
+function startViewCollection(lifeCycle, hooks, configuration, domMutationObservable, pageOpenObservable, locationChangeObservable, recorderApi, viewHistory, initialViewOptions) {
+	lifeCycle.subscribe(4, (view) => lifeCycle.notify(13, processViewUpdate(view, configuration, recorderApi)));
+	hooks.assembleEventDefaults.register(({ startTime, eventType }) => {
+		const view = viewHistory.findView(startTime);
+		if (!view) return DISCARDED;
+		return {
+			type: eventType,
+			service: view.service,
+			version: view.version,
+			context: view.context,
+			view: {
+				id: view.id,
+				name: view.name
+			}
+		};
+	});
+	hooks.assembleTelemetry.register(({ startTime }) => ({ view: { id: viewHistory.findView(startTime)?.id } }));
+	return trackViews(lifeCycle, domMutationObservable, pageOpenObservable, configuration, locationChangeObservable, !configuration.trackViewsManually, initialViewOptions);
+}
+function processViewUpdate(view, configuration, recorderApi) {
+	const replayStats = recorderApi.getReplayStats(view.id);
+	const clsDevicePixelRatio = view.commonViewMetrics?.cumulativeLayoutShift?.devicePixelRatio;
+	const viewEvent = {
+		_kubesense: {
+			document_version: view.documentVersion,
+			replay_stats: replayStats,
+			cls: clsDevicePixelRatio ? { device_pixel_ratio: clsDevicePixelRatio } : void 0,
+			configuration: {
+				start_session_replay_recording_manually: configuration.startSessionReplayRecordingManually,
+				remote_configuration_id: configuration.remoteConfigurationId
+			}
+		},
+		date: view.startClocks.timeStamp,
+		type: RumEventType.VIEW,
+		view: {
+			action: { count: view.eventCounts.actionCount },
+			frustration: { count: view.eventCounts.frustrationCount },
+			cumulative_layout_shift: view.commonViewMetrics.cumulativeLayoutShift?.value,
+			cumulative_layout_shift_time: toServerDuration(view.commonViewMetrics.cumulativeLayoutShift?.time),
+			cumulative_layout_shift_target_selector: view.commonViewMetrics.cumulativeLayoutShift?.targetSelector,
+			first_byte: toServerDuration(view.initialViewMetrics.navigationTimings?.firstByte),
+			dom_complete: toServerDuration(view.initialViewMetrics.navigationTimings?.domComplete),
+			dom_content_loaded: toServerDuration(view.initialViewMetrics.navigationTimings?.domContentLoaded),
+			dom_interactive: toServerDuration(view.initialViewMetrics.navigationTimings?.domInteractive),
+			error: { count: view.eventCounts.errorCount },
+			first_contentful_paint: toServerDuration(view.initialViewMetrics.firstContentfulPaint),
+			interaction_to_next_paint: toServerDuration(view.commonViewMetrics.interactionToNextPaint?.value),
+			interaction_to_next_paint_time: toServerDuration(view.commonViewMetrics.interactionToNextPaint?.time),
+			interaction_to_next_paint_target_selector: view.commonViewMetrics.interactionToNextPaint?.targetSelector,
+			is_active: view.isActive,
+			name: view.name,
+			largest_contentful_paint: toServerDuration(view.initialViewMetrics.largestContentfulPaint?.value),
+			largest_contentful_paint_target_selector: view.initialViewMetrics.largestContentfulPaint?.targetSelector,
+			load_event: toServerDuration(view.initialViewMetrics.navigationTimings?.loadEvent),
+			loading_time: discardNegativeDuration(toServerDuration(view.commonViewMetrics.loadingTime)),
+			loading_type: view.loadingType,
+			long_task: { count: view.eventCounts.longTaskCount },
+			performance: computeViewPerformanceData(view.commonViewMetrics, view.initialViewMetrics),
+			resource: { count: view.eventCounts.resourceCount },
+			time_spent: toServerDuration(view.duration)
+		},
+		display: view.commonViewMetrics.scroll ? { scroll: {
+			max_depth: view.commonViewMetrics.scroll.maxDepth,
+			max_depth_scroll_top: view.commonViewMetrics.scroll.maxDepthScrollTop,
+			max_scroll_height: view.commonViewMetrics.scroll.maxScrollHeight,
+			max_scroll_height_time: toServerDuration(view.commonViewMetrics.scroll.maxScrollHeightTime)
+		} } : void 0,
+		privacy: { replay_level: configuration.defaultPrivacyLevel },
+		device: {
+			locale: navigator.language,
+			locales: navigator.languages,
+			time_zone: getTimeZone()
+		}
+	};
+	if (!isEmptyObject(view.customTimings)) viewEvent.view.custom_timings = mapValues(view.customTimings, toServerDuration);
+	return {
+		rawRumEvent: viewEvent,
+		startClocks: view.startClocks,
+		duration: view.duration,
+		domainContext: {
+			location: view.location,
+			handlingStack: view.handlingStack
+		}
+	};
+}
+function computeViewPerformanceData({ cumulativeLayoutShift, interactionToNextPaint }, { firstContentfulPaint, largestContentfulPaint }) {
+	return {
+		cls: cumulativeLayoutShift && {
+			score: cumulativeLayoutShift.value,
+			timestamp: toServerDuration(cumulativeLayoutShift.time),
+			target_selector: cumulativeLayoutShift.targetSelector,
+			previous_rect: cumulativeLayoutShift.previousRect,
+			current_rect: cumulativeLayoutShift.currentRect
+		},
+		fcp: firstContentfulPaint && { timestamp: toServerDuration(firstContentfulPaint) },
+		inp: interactionToNextPaint && {
+			duration: toServerDuration(interactionToNextPaint.value),
+			timestamp: toServerDuration(interactionToNextPaint.time),
+			target_selector: interactionToNextPaint.targetSelector,
+			sub_parts: interactionToNextPaint.subParts ? {
+				input_delay: toServerDuration(interactionToNextPaint.subParts.inputDelay),
+				processing_duration: toServerDuration(interactionToNextPaint.subParts.processingDuration),
+				presentation_delay: toServerDuration(interactionToNextPaint.subParts.presentationDelay)
+			} : void 0
+		},
+		lcp: largestContentfulPaint && {
+			timestamp: toServerDuration(largestContentfulPaint.value),
+			target_selector: largestContentfulPaint.targetSelector,
+			resource_url: largestContentfulPaint.resourceUrl,
+			sub_parts: largestContentfulPaint.subParts ? {
+				load_delay: toServerDuration(largestContentfulPaint.subParts.loadDelay),
+				load_time: toServerDuration(largestContentfulPaint.subParts.loadTime),
+				render_delay: toServerDuration(largestContentfulPaint.subParts.renderDelay)
+			} : void 0
+		}
+	};
+}
+//#endregion
+export { startViewCollection };
+
+//# sourceMappingURL=viewCollection.mjs.map

package/esm/domain/view/viewCollection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewCollection.mjs","names":[],"sources":["../../../src/domain/view/viewCollection.ts"],"sourcesContent":["import type { Observable } from '@kubesense/kubesense-browser-core'\nimport { toServerDuration } from '@kubesense/kubesense-js-core/time'\nimport type { Duration, ServerDuration } from '@kubesense/kubesense-js-core/time'\nimport { getTimeZone, isEmptyObject, mapValues } from '@kubesense/kubesense-browser-core'\nimport { DISCARDED } from '@kubesense/kubesense-js-core/assembly'\nimport { discardNegativeDuration } from '../discardNegativeDuration'\nimport type { RecorderApi } from '../../boot/rumPublicApi'\nimport type { RawRumViewEvent, ViewPerformanceData } from '../../rawRumEvent.types'\nimport { RumEventType } from '../../rawRumEvent.types'\nimport type { LifeCycle, RawRumEventCollectedData } from '../lifeCycle'\nimport { LifeCycleEventType } from '../lifeCycle'\nimport type { LocationChange } from '../../browser/locationChangeObservable'\nimport type { RumConfiguration } from '../configuration'\nimport type { ViewHistory } from '../contexts/viewHistory'\nimport type { DefaultRumEventAttributes, DefaultTelemetryEventAttributes, Hooks } from '../hooks'\nimport type { RumMutationRecord } from '../../browser/domMutationObservable'\nimport { trackViews } from './trackViews'\nimport type { ViewEvent, ViewOptions } from './trackViews'\nimport type { CommonViewMetrics } from './viewMetrics/trackCommonViewMetrics'\nimport type { InitialViewMetrics } from './viewMetrics/trackInitialViewMetrics'\n\nexport function startViewCollection(\n  lifeCycle: LifeCycle,\n  hooks: Hooks,\n  configuration: RumConfiguration,\n  domMutationObservable: Observable<RumMutationRecord[]>,\n  pageOpenObservable: Observable<void>,\n  locationChangeObservable: Observable<LocationChange>,\n  recorderApi: RecorderApi,\n  viewHistory: ViewHistory,\n  initialViewOptions?: ViewOptions\n) {\n  lifeCycle.subscribe(LifeCycleEventType.VIEW_UPDATED, (view) =>\n    lifeCycle.notify(LifeCycleEventType.RAW_RUM_EVENT_COLLECTED, processViewUpdate(view, configuration, recorderApi))\n  )\n\n  hooks.assembleEventDefaults.register(({ startTime, eventType }): DefaultRumEventAttributes | DISCARDED => {\n    const view = viewHistory.findView(startTime)\n\n    if (!view) {\n      return DISCARDED\n    }\n\n    return {\n      type: eventType,\n      service: view.service,\n      version: view.version,\n      context: view.context,\n      view: {\n        id: view.id,\n        name: view.name,\n      },\n    }\n  })\n\n  hooks.assembleTelemetry.register(({ startTime }): DefaultTelemetryEventAttributes => ({\n    view: {\n      id: viewHistory.findView(startTime)?.id,\n    },\n  }))\n\n  return trackViews(\n    lifeCycle,\n    domMutationObservable,\n    pageOpenObservable,\n    configuration,\n    locationChangeObservable,\n    !configuration.trackViewsManually,\n    initialViewOptions\n  )\n}\n\nfunction processViewUpdate(\n  view: ViewEvent,\n  configuration: RumConfiguration,\n  recorderApi: RecorderApi\n): RawRumEventCollectedData<RawRumViewEvent> {\n  const replayStats = recorderApi.getReplayStats(view.id)\n  const clsDevicePixelRatio = view.commonViewMetrics?.cumulativeLayoutShift?.devicePixelRatio\n  const viewEvent: RawRumViewEvent = {\n    _kubesense: {\n      document_version: view.documentVersion,\n      replay_stats: replayStats,\n      cls: clsDevicePixelRatio\n        ? {\n            device_pixel_ratio: clsDevicePixelRatio,\n          }\n        : undefined,\n      configuration: {\n        start_session_replay_recording_manually: configuration.startSessionReplayRecordingManually,\n        remote_configuration_id: configuration.remoteConfigurationId,\n      },\n    },\n    date: view.startClocks.timeStamp,\n    type: RumEventType.VIEW,\n    view: {\n      action: {\n        count: view.eventCounts.actionCount,\n      },\n      frustration: {\n        count: view.eventCounts.frustrationCount,\n      },\n      cumulative_layout_shift: view.commonViewMetrics.cumulativeLayoutShift?.value,\n      cumulative_layout_shift_time: toServerDuration(view.commonViewMetrics.cumulativeLayoutShift?.time),\n      cumulative_layout_shift_target_selector: view.commonViewMetrics.cumulativeLayoutShift?.targetSelector,\n      first_byte: toServerDuration(view.initialViewMetrics.navigationTimings?.firstByte),\n      dom_complete: toServerDuration(view.initialViewMetrics.navigationTimings?.domComplete),\n      dom_content_loaded: toServerDuration(view.initialViewMetrics.navigationTimings?.domContentLoaded),\n      dom_interactive: toServerDuration(view.initialViewMetrics.navigationTimings?.domInteractive),\n      error: {\n        count: view.eventCounts.errorCount,\n      },\n      first_contentful_paint: toServerDuration(view.initialViewMetrics.firstContentfulPaint),\n      interaction_to_next_paint: toServerDuration(view.commonViewMetrics.interactionToNextPaint?.value),\n      interaction_to_next_paint_time: toServerDuration(view.commonViewMetrics.interactionToNextPaint?.time),\n      interaction_to_next_paint_target_selector: view.commonViewMetrics.interactionToNextPaint?.targetSelector,\n      is_active: view.isActive,\n      name: view.name,\n      largest_contentful_paint: toServerDuration(view.initialViewMetrics.largestContentfulPaint?.value),\n      largest_contentful_paint_target_selector: view.initialViewMetrics.largestContentfulPaint?.targetSelector,\n      load_event: toServerDuration(view.initialViewMetrics.navigationTimings?.loadEvent),\n      loading_time: discardNegativeDuration(toServerDuration(view.commonViewMetrics.loadingTime)),\n      loading_type: view.loadingType,\n      long_task: {\n        count: view.eventCounts.longTaskCount,\n      },\n      performance: computeViewPerformanceData(view.commonViewMetrics, view.initialViewMetrics),\n      resource: {\n        count: view.eventCounts.resourceCount,\n      },\n      time_spent: toServerDuration(view.duration),\n    },\n    display: view.commonViewMetrics.scroll\n      ? {\n          scroll: {\n            max_depth: view.commonViewMetrics.scroll.maxDepth,\n            max_depth_scroll_top: view.commonViewMetrics.scroll.maxDepthScrollTop,\n            max_scroll_height: view.commonViewMetrics.scroll.maxScrollHeight,\n            max_scroll_height_time: toServerDuration(view.commonViewMetrics.scroll.maxScrollHeightTime),\n          },\n        }\n      : undefined,\n    privacy: {\n      replay_level: configuration.defaultPrivacyLevel,\n    },\n    device: {\n      locale: navigator.language,\n      locales: navigator.languages,\n      time_zone: getTimeZone(),\n    },\n  }\n\n  if (!isEmptyObject(view.customTimings)) {\n    viewEvent.view.custom_timings = mapValues(\n      view.customTimings,\n      toServerDuration as (duration: Duration) => ServerDuration\n    )\n  }\n\n  return {\n    rawRumEvent: viewEvent,\n    startClocks: view.startClocks,\n    duration: view.duration,\n    domainContext: {\n      location: view.location,\n      handlingStack: view.handlingStack,\n    },\n  }\n}\n\nfunction computeViewPerformanceData(\n  { cumulativeLayoutShift, interactionToNextPaint }: CommonViewMetrics,\n  { firstContentfulPaint, largestContentfulPaint }: InitialViewMetrics\n): ViewPerformanceData {\n  return {\n    cls: cumulativeLayoutShift && {\n      score: cumulativeLayoutShift.value,\n      timestamp: toServerDuration(cumulativeLayoutShift.time),\n      target_selector: cumulativeLayoutShift.targetSelector,\n      previous_rect: cumulativeLayoutShift.previousRect,\n      current_rect: cumulativeLayoutShift.currentRect,\n    },\n    fcp: firstContentfulPaint && { timestamp: toServerDuration(firstContentfulPaint) },\n    inp: interactionToNextPaint && {\n      duration: toServerDuration(interactionToNextPaint.value),\n      timestamp: toServerDuration(interactionToNextPaint.time),\n      target_selector: interactionToNextPaint.targetSelector,\n      sub_parts: interactionToNextPaint.subParts\n        ? {\n            input_delay: toServerDuration(interactionToNextPaint.subParts.inputDelay),\n            processing_duration: toServerDuration(interactionToNextPaint.subParts.processingDuration),\n            presentation_delay: toServerDuration(interactionToNextPaint.subParts.presentationDelay),\n          }\n        : undefined,\n    },\n    lcp: largestContentfulPaint && {\n      timestamp: toServerDuration(largestContentfulPaint.value),\n      target_selector: largestContentfulPaint.targetSelector,\n      resource_url: largestContentfulPaint.resourceUrl,\n      sub_parts: largestContentfulPaint.subParts\n        ? {\n            load_delay: toServerDuration(largestContentfulPaint.subParts.loadDelay),\n            load_time: toServerDuration(largestContentfulPaint.subParts.loadTime),\n            render_delay: toServerDuration(largestContentfulPaint.subParts.renderDelay),\n          }\n        : undefined,\n    },\n  }\n}\n"],"mappings":"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"}

package/esm/domain/view/viewDiff.mjs

@@ -0,0 +1,61 @@
+import { isIndexableObject } from "@kubesense/kubesense-js-core/util";
+//#region src/domain/view/viewDiff.ts
+/**
+* Compare two values for deep equality
+*/
+function isEqual(a, b) {
+	if (a === b) return true;
+	if (a === null || typeof a !== "object" || b === null || typeof b !== "object") return a === b;
+	if (Array.isArray(a) && Array.isArray(b)) {
+		if (a.length !== b.length) return false;
+		return a.every((val, idx) => isEqual(val, b[idx]));
+	}
+	if (Array.isArray(a) || Array.isArray(b)) return false;
+	const aObj = a;
+	const bObj = b;
+	const aKeys = Object.keys(aObj);
+	const bKeys = Object.keys(bObj);
+	if (aKeys.length !== bKeys.length) return false;
+	return aKeys.every((key) => bKeys.includes(key) && isEqual(aObj[key], bObj[key]));
+}
+/**
+* MERGE strategy: compare two objects and return an object with only changed fields.
+* Returns undefined if no changes.
+*
+* Default strategy is REPLACE (isEqual check). Exceptions:
+* - Both values are plain objects and key is not in replaceKeys: recurse (MERGE), sub-paths
+* (e.g. 'view.custom_timings') are propagated to the recursive call.
+* - Both values are arrays and key is in appendKeys: include only new trailing elements (APPEND)
+*/
+function diffMerge(current, lastSent, options) {
+	const result = {};
+	const replaceKeys = options?.replaceKeys ?? /* @__PURE__ */ new Set();
+	const appendKeys = options?.appendKeys ?? /* @__PURE__ */ new Set();
+	const ignoreKeys = options?.ignoreKeys ?? /* @__PURE__ */ new Set();
+	for (const key of Object.keys(current)) {
+		if (ignoreKeys.has(key)) continue;
+		const currentVal = current[key];
+		const lastSentVal = lastSent[key];
+		if (!replaceKeys.has(key) && isIndexableObject(currentVal) && isIndexableObject(lastSentVal)) {
+			const nestedDiff = diffMerge(currentVal, lastSentVal, {
+				replaceKeys: extractSubPaths(replaceKeys, key),
+				appendKeys: extractSubPaths(appendKeys, key),
+				ignoreKeys: extractSubPaths(ignoreKeys, key)
+			});
+			if (nestedDiff) result[key] = nestedDiff;
+		} else if (appendKeys.has(key) && Array.isArray(currentVal) && Array.isArray(lastSentVal)) {
+			if (currentVal.length > lastSentVal.length) result[key] = currentVal.slice(lastSentVal.length);
+		} else if (!isEqual(currentVal, lastSentVal)) result[key] = currentVal;
+	}
+	for (const key of Object.keys(lastSent)) if (!(key in current)) result[key] = null;
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function extractSubPaths(keys, prefix) {
+	const result = /* @__PURE__ */ new Set();
+	for (const key of keys) if (key.startsWith(`${prefix}.`)) result.add(key.slice(prefix.length + 1));
+	return result;
+}
+//#endregion
+export { diffMerge, isEqual };
+
+//# sourceMappingURL=viewDiff.mjs.map

package/esm/domain/view/viewDiff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewDiff.mjs","names":[],"sources":["../../../src/domain/view/viewDiff.ts"],"sourcesContent":["import { isIndexableObject } from '@kubesense/kubesense-js-core/util'\n\n/**\n * Compare two values for deep equality\n */\nexport function isEqual(a: unknown, b: unknown): boolean {\n  if (a === b) {\n    return true\n  }\n\n  if (a === null || typeof a !== 'object' || b === null || typeof b !== 'object') {\n    return a === b\n  }\n\n  // Arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) {\n      return false\n    }\n    return a.every((val, idx) => isEqual(val, b[idx]))\n  }\n\n  if (Array.isArray(a) || Array.isArray(b)) {\n    return false\n  }\n\n  // Plain objects\n  const aObj = a as Record<string, unknown>\n  const bObj = b as Record<string, unknown>\n  const aKeys = Object.keys(aObj)\n  const bKeys = Object.keys(bObj)\n\n  if (aKeys.length !== bKeys.length) {\n    return false\n  }\n\n  return aKeys.every((key) => bKeys.includes(key) && isEqual(aObj[key], bObj[key]))\n}\n\n/**\n * Options for controlling diff merge behavior\n */\nexport interface DiffMergeOptions {\n  replaceKeys?: Set<string>\n  appendKeys?: Set<string>\n  ignoreKeys?: Set<string>\n}\n\n/**\n * MERGE strategy: compare two objects and return an object with only changed fields.\n * Returns undefined if no changes.\n *\n * Default strategy is REPLACE (isEqual check). Exceptions:\n * - Both values are plain objects and key is not in replaceKeys: recurse (MERGE), sub-paths\n * (e.g. 'view.custom_timings') are propagated to the recursive call.\n * - Both values are arrays and key is in appendKeys: include only new trailing elements (APPEND)\n */\nexport function diffMerge(\n  current: Record<string, unknown>,\n  lastSent: Record<string, unknown>,\n  options?: DiffMergeOptions\n): Record<string, unknown> | undefined {\n  const result: Record<string, unknown> = {}\n  const replaceKeys = options?.replaceKeys ?? new Set<string>()\n  const appendKeys = options?.appendKeys ?? new Set<string>()\n  const ignoreKeys = options?.ignoreKeys ?? new Set<string>()\n\n  for (const key of Object.keys(current)) {\n    if (ignoreKeys.has(key)) {\n      continue\n    }\n\n    const currentVal = current[key]\n    const lastSentVal = lastSent[key]\n\n    if (!replaceKeys.has(key) && isIndexableObject(currentVal) && isIndexableObject(lastSentVal)) {\n      // Both are plain objects and not marked for replace: recurse (MERGE)\n      const nestedDiff = diffMerge(currentVal, lastSentVal, {\n        replaceKeys: extractSubPaths(replaceKeys, key),\n        appendKeys: extractSubPaths(appendKeys, key),\n        ignoreKeys: extractSubPaths(ignoreKeys, key),\n      })\n      if (nestedDiff) {\n        result[key] = nestedDiff\n      }\n    } else if (appendKeys.has(key) && Array.isArray(currentVal) && Array.isArray(lastSentVal)) {\n      // Array in appendKeys: include only new trailing elements (APPEND)\n      if (currentVal.length > lastSentVal.length) {\n        result[key] = currentVal.slice(lastSentVal.length)\n      }\n    } else if (!isEqual(currentVal, lastSentVal)) {\n      // Default: replace the whole value (REPLACE)\n      result[key] = currentVal\n    }\n  }\n\n  // Deleted keys: present in lastSent but not in current\n  for (const key of Object.keys(lastSent)) {\n    if (!(key in current)) {\n      result[key] = null\n    }\n  }\n\n  return Object.keys(result).length > 0 ? result : undefined\n}\n\nfunction extractSubPaths(keys: Set<string>, prefix: string): Set<string> {\n  const result = new Set<string>()\n  for (const key of keys) {\n    if (key.startsWith(`${prefix}.`)) {\n      result.add(key.slice(prefix.length + 1))\n    }\n  }\n  return result\n}\n"],"mappings":";;;;;AAKA,SAAgB,QAAQ,GAAY,GAAqB;CACvD,IAAI,MAAM,GACR,OAAO;CAGT,IAAI,MAAM,QAAQ,OAAO,MAAM,YAAY,MAAM,QAAQ,OAAO,MAAM,UACpE,OAAO,MAAM;CAIf,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;EACxC,IAAI,EAAE,WAAW,EAAE,QACjB,OAAO;EAET,OAAO,EAAE,OAAO,KAAK,QAAQ,QAAQ,KAAK,EAAE,IAAI,CAAC;CACnD;CAEA,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GACrC,OAAO;CAIT,MAAM,OAAO;CACb,MAAM,OAAO;CACb,MAAM,QAAQ,OAAO,KAAK,IAAI;CAC9B,MAAM,QAAQ,OAAO,KAAK,IAAI;CAE9B,IAAI,MAAM,WAAW,MAAM,QACzB,OAAO;CAGT,OAAO,MAAM,OAAO,QAAQ,MAAM,SAAS,GAAG,KAAK,QAAQ,KAAK,MAAM,KAAK,IAAI,CAAC;AAClF;;;;;;;;;;AAoBA,SAAgB,UACd,SACA,UACA,SACqC;CACrC,MAAM,SAAkC,CAAC;CACzC,MAAM,cAAc,SAAS,+BAAe,IAAI,IAAY;CAC5D,MAAM,aAAa,SAAS,8BAAc,IAAI,IAAY;CAC1D,MAAM,aAAa,SAAS,8BAAc,IAAI,IAAY;CAE1D,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GAAG;EACtC,IAAI,WAAW,IAAI,GAAG,GACpB;EAGF,MAAM,aAAa,QAAQ;EAC3B,MAAM,cAAc,SAAS;EAE7B,IAAI,CAAC,YAAY,IAAI,GAAG,KAAK,kBAAkB,UAAU,KAAK,kBAAkB,WAAW,GAAG;GAE5F,MAAM,aAAa,UAAU,YAAY,aAAa;IACpD,aAAa,gBAAgB,aAAa,GAAG;IAC7C,YAAY,gBAAgB,YAAY,GAAG;IAC3C,YAAY,gBAAgB,YAAY,GAAG;GAC7C,CAAC;GACD,IAAI,YACF,OAAO,OAAO;EAElB,OAAO,IAAI,WAAW,IAAI,GAAG,KAAK,MAAM,QAAQ,UAAU,KAAK,MAAM,QAAQ,WAAW,GAElF;OAAA,WAAW,SAAS,YAAY,QAClC,OAAO,OAAO,WAAW,MAAM,YAAY,MAAM;EAAA,OAE9C,IAAI,CAAC,QAAQ,YAAY,WAAW,GAEzC,OAAO,OAAO;CAElB;CAGA,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,GACpC,IAAI,EAAE,OAAO,UACX,OAAO,OAAO;CAIlB,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,IAAI,SAAS,KAAA;AACnD;AAEA,SAAS,gBAAgB,MAAmB,QAA6B;CACvE,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,WAAW,GAAG,OAAO,EAAE,GAC7B,OAAO,IAAI,IAAI,MAAM,OAAO,SAAS,CAAC,CAAC;CAG3C,OAAO;AACT"}

package/esm/domain/view/viewMetrics/getClsAttributionImpactedArea.mjs

@@ -0,0 +1,30 @@
+//#region src/domain/view/viewMetrics/getClsAttributionImpactedArea.ts
+/**
+* Calculates the area of a rectangle given its width and height
+*/
+const calculateArea = (width, height) => width * height;
+/**
+* Calculates the intersection area between two rectangles
+*/
+const calculateIntersectionArea = (rect1, rect2) => {
+	const left = Math.max(rect1.left, rect2.left);
+	const top = Math.max(rect1.top, rect2.top);
+	const right = Math.min(rect1.right, rect2.right);
+	const bottom = Math.min(rect1.bottom, rect2.bottom);
+	if (left >= right || top >= bottom) return 0;
+	return calculateArea(right - left, bottom - top);
+};
+/**
+* Calculates the total impacted area of a layout shift source
+* This is the sum of the previous and current areas minus their intersection
+*/
+const getClsAttributionImpactedArea = (source) => {
+	const previousArea = calculateArea(source.previousRect.width, source.previousRect.height);
+	const currentArea = calculateArea(source.currentRect.width, source.currentRect.height);
+	const intersectionArea = calculateIntersectionArea(source.previousRect, source.currentRect);
+	return previousArea + currentArea - intersectionArea;
+};
+//#endregion
+export { getClsAttributionImpactedArea };
+
+//# sourceMappingURL=getClsAttributionImpactedArea.mjs.map

package/esm/domain/view/viewMetrics/getClsAttributionImpactedArea.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClsAttributionImpactedArea.mjs","names":[],"sources":["../../../../src/domain/view/viewMetrics/getClsAttributionImpactedArea.ts"],"sourcesContent":["import type { RumLayoutShiftAttribution } from '../../../browser/performanceObservable'\n\n/**\n * Calculates the area of a rectangle given its width and height\n */\nconst calculateArea = (width: number, height: number): number => width * height\n\n/**\n * Calculates the intersection area between two rectangles\n */\nconst calculateIntersectionArea = (rect1: DOMRectReadOnly, rect2: DOMRectReadOnly): number => {\n  const left = Math.max(rect1.left, rect2.left)\n  const top = Math.max(rect1.top, rect2.top)\n  const right = Math.min(rect1.right, rect2.right)\n  const bottom = Math.min(rect1.bottom, rect2.bottom)\n\n  if (left >= right || top >= bottom) {\n    return 0\n  }\n\n  return calculateArea(right - left, bottom - top)\n}\n\n/**\n * Calculates the total impacted area of a layout shift source\n * This is the sum of the previous and current areas minus their intersection\n */\nexport const getClsAttributionImpactedArea = (source: RumLayoutShiftAttribution): number => {\n  const previousArea = calculateArea(source.previousRect.width, source.previousRect.height)\n  const currentArea = calculateArea(source.currentRect.width, source.currentRect.height)\n  const intersectionArea = calculateIntersectionArea(source.previousRect, source.currentRect)\n\n  return previousArea + currentArea - intersectionArea\n}\n"],"mappings":";;;;AAKA,MAAM,iBAAiB,OAAe,WAA2B,QAAQ;;;;AAKzE,MAAM,6BAA6B,OAAwB,UAAmC;CAC5F,MAAM,OAAO,KAAK,IAAI,MAAM,MAAM,MAAM,IAAI;CAC5C,MAAM,MAAM,KAAK,IAAI,MAAM,KAAK,MAAM,GAAG;CACzC,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,MAAM,KAAK;CAC/C,MAAM,SAAS,KAAK,IAAI,MAAM,QAAQ,MAAM,MAAM;CAElD,IAAI,QAAQ,SAAS,OAAO,QAC1B,OAAO;CAGT,OAAO,cAAc,QAAQ,MAAM,SAAS,GAAG;AACjD;;;;;AAMA,MAAa,iCAAiC,WAA8C;CAC1F,MAAM,eAAe,cAAc,OAAO,aAAa,OAAO,OAAO,aAAa,MAAM;CACxF,MAAM,cAAc,cAAc,OAAO,YAAY,OAAO,OAAO,YAAY,MAAM;CACrF,MAAM,mBAAmB,0BAA0B,OAAO,cAAc,OAAO,WAAW;CAE1F,OAAO,eAAe,cAAc;AACtC"}