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

package/cjs/domain/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/domain/hooks.ts"],"names":[],"mappings":";;;AASA,8EAAiE;AAqBpD,QAAA,WAAW,GAAG,CAAA,sCAA8B,CAAA,CAAA"}
+{"version":3,"file":"hooks.js","names":["createHook"],"sources":["../../src/domain/hooks.ts"],"sourcesContent":["import type { Duration, RelativeTime } from '@kubesense/kubesense-js-core/time'\nimport type { TelemetryEvent } from '@kubesense/kubesense-browser-core'\nimport { createHook } from '@kubesense/kubesense-js-core/assembly'\nimport type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport type { RecursivePartial } from '@kubesense/kubesense-js-core/util'\nimport type { RumEvent } from '../rumEvent.types'\nimport type { RawRumEvent } from '../rawRumEvent.types'\nimport type { RumEventDomainContext } from '../domainContext.types'\n\n// Define a partial RUM event type.\n// Ensuring the `type` field is always present improves type checking, especially in conditional logic in hooks (e.g., `if (eventType === 'view')`).\nexport type DefaultRumEventAttributes = RecursivePartial<RumEvent> & { type: RumEvent['type'] }\nexport type DefaultTelemetryEventAttributes = RecursivePartial<TelemetryEvent>\n\ntype DeepReadonly<T> = {\n  readonly [K in keyof T]: DeepReadonly<T[K]>\n}\n\n// Use readonly and DeepReadonly to prevents assemble hook callbacks from mutating the inputs.\n// DeepReadonly is only applied to objects rather than the entire AssembleHookParams to avoid casts for primitives.\nexport interface AssembleHookParams {\n  readonly eventType: RumEvent['type']\n  rawRumEvent: DeepReadonly<RawRumEvent>\n  domainContext: DeepReadonly<RumEventDomainContext<RawRumEvent['type']>>\n  readonly startTime: RelativeTime\n  readonly duration?: Duration | undefined\n}\n\nexport type AssembleHook = Hook<AssembleHookParams, DefaultRumEventAttributes>\nexport type AssembleTelemetryHook = Hook<{ startTime: RelativeTime }, DefaultTelemetryEventAttributes>\n\nexport interface Hooks {\n  assembleEventDefaults: AssembleHook\n  assembleTelemetry: AssembleTelemetryHook\n  assembleEvent: AssembleHook\n}\n\nexport function createHooks(): Hooks {\n  return {\n    assembleEventDefaults: createHook(),\n    assembleTelemetry: createHook(),\n    assembleEvent: createHook(),\n  }\n}\n"],"mappings":";;AAqCA,SAAgB,cAAqB;CACnC,OAAO;EACL,wBAAA,GAAuBA,sCAAAA,WAAAA,CAAW;EAClC,oBAAA,GAAmBA,sCAAAA,WAAAA,CAAW;EAC9B,gBAAA,GAAeA,sCAAAA,WAAAA,CAAW;CAC5B;AACF"}

package/cjs/domain/lifeCycle.d.ts

@@ -1,10 +1,16 @@
-import type { Context, Duration, PageMayExitEvent, RawError, RelativeTime } from '@kubesense/kubesense-browser-core';
+import type { ClocksState, Duration } from '@kubesense/kubesense-js-core/time';
+import type { Context, RawError, UrgentFlushReason } from '@kubesense/kubesense-browser-core';
 import { AbstractLifeCycle } from '@kubesense/kubesense-browser-core';
 import type { RumEventDomainContext } from '../domainContext.types';
 import type { RawRumEvent, AssembledRumEvent } from '../rawRumEvent.types';
 import type { RequestCompleteEvent, RequestStartEvent } from './requestCollection';
+import type { WebSocketCompleteEvent } from './resource/webSocketCollection';
 import type { AutoAction } from './action/actionCollection';
 import type { ViewEvent, ViewCreatedEvent, ViewEndedEvent, BeforeViewUpdateEvent } from './view/trackViews';
+import type { DurationVitalStart } from './vital/vitalCollection';
+import type { TrackedEventData } from './eventTracker';
+import type { ActionEventData } from './action/trackManualActions';
+import type { SessionExpiredEvent } from './session/session.types';
 export declare const enum LifeCycleEventType {
     AUTO_ACTION_COMPLETED = 0,
     BEFORE_VIEW_CREATED = 1,
@@ -15,14 +21,18 @@ export declare const enum LifeCycleEventType {
     AFTER_VIEW_ENDED = 6,
     REQUEST_STARTED = 7,
     REQUEST_COMPLETED = 8,
-    SESSION_EXPIRED = 9,
-    SESSION_RENEWED = 10,
-    PAGE_MAY_EXIT = 11,
-    RAW_RUM_EVENT_COLLECTED = 12,
-    RUM_EVENT_COLLECTED = 13,
-    RAW_ERROR_COLLECTED = 14
+    WEBSOCKET_COMPLETED = 9,
+    SESSION_EXPIRED = 10,
+    SESSION_RENEWED = 11,
+    PREPARE_URGENT_FLUSH = 12,
+    RAW_RUM_EVENT_COLLECTED = 13,
+    RUM_EVENT_COLLECTED = 14,
+    RAW_ERROR_COLLECTED = 15,
+    ACTION_STARTED = 16,
+    DURATION_VITAL_STARTED = 17
 }
 declare const LifeCycleEventTypeAsConst: {
+    ACTION_STARTED: LifeCycleEventType.ACTION_STARTED;
     AUTO_ACTION_COMPLETED: LifeCycleEventType.AUTO_ACTION_COMPLETED;
     BEFORE_VIEW_CREATED: LifeCycleEventType.BEFORE_VIEW_CREATED;
     VIEW_CREATED: LifeCycleEventType.VIEW_CREATED;
@@ -32,14 +42,17 @@ declare const LifeCycleEventTypeAsConst: {
     AFTER_VIEW_ENDED: LifeCycleEventType.AFTER_VIEW_ENDED;
     REQUEST_STARTED: LifeCycleEventType.REQUEST_STARTED;
     REQUEST_COMPLETED: LifeCycleEventType.REQUEST_COMPLETED;
+    WEBSOCKET_COMPLETED: LifeCycleEventType.WEBSOCKET_COMPLETED;
     SESSION_EXPIRED: LifeCycleEventType.SESSION_EXPIRED;
     SESSION_RENEWED: LifeCycleEventType.SESSION_RENEWED;
-    PAGE_MAY_EXIT: LifeCycleEventType.PAGE_MAY_EXIT;
+    PREPARE_URGENT_FLUSH: LifeCycleEventType.PREPARE_URGENT_FLUSH;
     RAW_RUM_EVENT_COLLECTED: LifeCycleEventType.RAW_RUM_EVENT_COLLECTED;
     RUM_EVENT_COLLECTED: LifeCycleEventType.RUM_EVENT_COLLECTED;
     RAW_ERROR_COLLECTED: LifeCycleEventType.RAW_ERROR_COLLECTED;
+    DURATION_VITAL_STARTED: LifeCycleEventType.DURATION_VITAL_STARTED;
 };
 export interface LifeCycleEventMap {
+    [LifeCycleEventTypeAsConst.ACTION_STARTED]: TrackedEventData<ActionEventData>;
     [LifeCycleEventTypeAsConst.AUTO_ACTION_COMPLETED]: AutoAction;
     [LifeCycleEventTypeAsConst.BEFORE_VIEW_CREATED]: ViewCreatedEvent;
     [LifeCycleEventTypeAsConst.VIEW_CREATED]: ViewCreatedEvent;
@@ -49,20 +62,21 @@ export interface LifeCycleEventMap {
     [LifeCycleEventTypeAsConst.AFTER_VIEW_ENDED]: ViewEndedEvent;
     [LifeCycleEventTypeAsConst.REQUEST_STARTED]: RequestStartEvent;
     [LifeCycleEventTypeAsConst.REQUEST_COMPLETED]: RequestCompleteEvent;
-    [LifeCycleEventTypeAsConst.SESSION_EXPIRED]: void;
+    [LifeCycleEventTypeAsConst.WEBSOCKET_COMPLETED]: WebSocketCompleteEvent;
+    [LifeCycleEventTypeAsConst.SESSION_EXPIRED]: SessionExpiredEvent;
     [LifeCycleEventTypeAsConst.SESSION_RENEWED]: void;
-    [LifeCycleEventTypeAsConst.PAGE_MAY_EXIT]: PageMayExitEvent;
+    [LifeCycleEventTypeAsConst.PREPARE_URGENT_FLUSH]: UrgentFlushReason;
     [LifeCycleEventTypeAsConst.RAW_RUM_EVENT_COLLECTED]: RawRumEventCollectedData;
     [LifeCycleEventTypeAsConst.RUM_EVENT_COLLECTED]: AssembledRumEvent;
     [LifeCycleEventTypeAsConst.RAW_ERROR_COLLECTED]: {
         error: RawError;
         customerContext?: Context;
     };
+    [LifeCycleEventTypeAsConst.DURATION_VITAL_STARTED]: DurationVitalStart;
 }
 export interface RawRumEventCollectedData<E extends RawRumEvent = RawRumEvent> {
-    startTime: RelativeTime;
+    startClocks: ClocksState;
     duration?: Duration;
-    customerContext?: Context;
     rawRumEvent: E;
     domainContext: RumEventDomainContext<E['type']>;
 }

package/cjs/domain/lifeCycle.js

@@ -1,6 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LifeCycle = void 0;
-const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
-exports.LifeCycle = (kubesense_browser_core_1.AbstractLifeCycle);
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+//#region src/domain/lifeCycle.ts
+let LifeCycleEventType = /* @__PURE__ */ function(LifeCycleEventType) {
+	LifeCycleEventType[LifeCycleEventType["AUTO_ACTION_COMPLETED"] = 0] = "AUTO_ACTION_COMPLETED";
+	LifeCycleEventType[LifeCycleEventType["BEFORE_VIEW_CREATED"] = 1] = "BEFORE_VIEW_CREATED";
+	LifeCycleEventType[LifeCycleEventType["VIEW_CREATED"] = 2] = "VIEW_CREATED";
+	LifeCycleEventType[LifeCycleEventType["BEFORE_VIEW_UPDATED"] = 3] = "BEFORE_VIEW_UPDATED";
+	LifeCycleEventType[LifeCycleEventType["VIEW_UPDATED"] = 4] = "VIEW_UPDATED";
+	LifeCycleEventType[LifeCycleEventType["VIEW_ENDED"] = 5] = "VIEW_ENDED";
+	LifeCycleEventType[LifeCycleEventType["AFTER_VIEW_ENDED"] = 6] = "AFTER_VIEW_ENDED";
+	LifeCycleEventType[LifeCycleEventType["REQUEST_STARTED"] = 7] = "REQUEST_STARTED";
+	LifeCycleEventType[LifeCycleEventType["REQUEST_COMPLETED"] = 8] = "REQUEST_COMPLETED";
+	LifeCycleEventType[LifeCycleEventType["WEBSOCKET_COMPLETED"] = 9] = "WEBSOCKET_COMPLETED";
+	LifeCycleEventType[LifeCycleEventType["SESSION_EXPIRED"] = 10] = "SESSION_EXPIRED";
+	LifeCycleEventType[LifeCycleEventType["SESSION_RENEWED"] = 11] = "SESSION_RENEWED";
+	LifeCycleEventType[LifeCycleEventType["PREPARE_URGENT_FLUSH"] = 12] = "PREPARE_URGENT_FLUSH";
+	LifeCycleEventType[LifeCycleEventType["RAW_RUM_EVENT_COLLECTED"] = 13] = "RAW_RUM_EVENT_COLLECTED";
+	LifeCycleEventType[LifeCycleEventType["RUM_EVENT_COLLECTED"] = 14] = "RUM_EVENT_COLLECTED";
+	LifeCycleEventType[LifeCycleEventType["RAW_ERROR_COLLECTED"] = 15] = "RAW_ERROR_COLLECTED";
+	LifeCycleEventType[LifeCycleEventType["ACTION_STARTED"] = 16] = "ACTION_STARTED";
+	LifeCycleEventType[LifeCycleEventType["DURATION_VITAL_STARTED"] = 17] = "DURATION_VITAL_STARTED";
+	return LifeCycleEventType;
+}({});
+const LifeCycle = _kubesense_kubesense_browser_core.AbstractLifeCycle;
+//#endregion
+exports.LifeCycle = LifeCycle;
+exports.LifeCycleEventType = LifeCycleEventType;
+
 //# sourceMappingURL=lifeCycle.js.map

package/cjs/domain/lifeCycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifeCycle.js","sourceRoot":"","sources":["../../src/domain/lifeCycle.ts"],"names":[],"mappings":";;;AACA,8EAAqE;AAoGxD,QAAA,SAAS,GAAG,CAAA,0CAAoC,CAAA,CAAA"}
+{"version":3,"file":"lifeCycle.js","names":["AbstractLifeCycle"],"sources":["../../src/domain/lifeCycle.ts"],"sourcesContent":["import type { ClocksState, Duration } from '@kubesense/kubesense-js-core/time'\nimport type { Context, RawError, UrgentFlushReason } from '@kubesense/kubesense-browser-core'\nimport { AbstractLifeCycle } from '@kubesense/kubesense-browser-core'\nimport type { RumEventDomainContext } from '../domainContext.types'\nimport type { RawRumEvent, AssembledRumEvent } from '../rawRumEvent.types'\nimport type { RequestCompleteEvent, RequestStartEvent } from './requestCollection'\nimport type { WebSocketCompleteEvent } from './resource/webSocketCollection'\nimport type { AutoAction } from './action/actionCollection'\nimport type { ViewEvent, ViewCreatedEvent, ViewEndedEvent, BeforeViewUpdateEvent } from './view/trackViews'\nimport type { DurationVitalStart } from './vital/vitalCollection'\nimport type { TrackedEventData } from './eventTracker'\nimport type { ActionEventData } from './action/trackManualActions'\nimport type { SessionExpiredEvent } from './session/session.types'\n\nexport const enum LifeCycleEventType {\n  // Contexts (like viewHistory) should be opened using prefixed BEFORE_XXX events and closed using prefixed AFTER_XXX events\n  // It ensures the context is available during the non prefixed event callbacks\n  AUTO_ACTION_COMPLETED,\n  BEFORE_VIEW_CREATED,\n  VIEW_CREATED,\n  BEFORE_VIEW_UPDATED,\n  VIEW_UPDATED,\n  VIEW_ENDED,\n  AFTER_VIEW_ENDED,\n  REQUEST_STARTED,\n  REQUEST_COMPLETED,\n  WEBSOCKET_COMPLETED,\n\n  // The SESSION_EXPIRED lifecycle event has been introduced to represent when a session has expired\n  // and trigger cleanup tasks related to this, prior to renewing the session. Its implementation is\n  // slightly naive: it is not triggered as soon as the session is expired, but rather just before\n  // notifying that the session is renewed. Thus, the session id is already set to the newly renewed\n  // session.\n  //\n  // This implementation is \"good enough\" for our use-cases. Improving this is not trivial,\n  // primarily because multiple instances of the SDK may be managing the same session cookie at\n  // the same time, for example when using Logs and RUM on the same page, or opening multiple tabs\n  // on the same domain.\n  SESSION_EXPIRED,\n  SESSION_RENEWED,\n  PREPARE_URGENT_FLUSH,\n  RAW_RUM_EVENT_COLLECTED,\n  RUM_EVENT_COLLECTED,\n  RAW_ERROR_COLLECTED,\n  ACTION_STARTED,\n  DURATION_VITAL_STARTED,\n}\n\n// This is a workaround for an issue occurring when the Browser SDK is included in a TypeScript\n// project configured with `isolatedModules: true`. Even if the const enum is declared in this\n// module, we cannot use it directly to define the EventMap interface keys (TS error: \"Cannot access\n// ambient const enums when the '--isolatedModules' flag is provided.\").\n//\n// Using a plain enum would fix the issue, but would also add 2KB to the minified bundle. By using\n// this workaround, we can keep using a const enum without impacting the bundle size (since it is a\n// \"declare\" statement, it will only be used during typecheck and completely ignored when building\n// JavaScript).\n//\n// See issues:\n// * https://github.com/microsoft/TypeScript/issues/54152\ndeclare const LifeCycleEventTypeAsConst: {\n  ACTION_STARTED: LifeCycleEventType.ACTION_STARTED\n  AUTO_ACTION_COMPLETED: LifeCycleEventType.AUTO_ACTION_COMPLETED\n  BEFORE_VIEW_CREATED: LifeCycleEventType.BEFORE_VIEW_CREATED\n  VIEW_CREATED: LifeCycleEventType.VIEW_CREATED\n  BEFORE_VIEW_UPDATED: LifeCycleEventType.BEFORE_VIEW_UPDATED\n  VIEW_UPDATED: LifeCycleEventType.VIEW_UPDATED\n  VIEW_ENDED: LifeCycleEventType.VIEW_ENDED\n  AFTER_VIEW_ENDED: LifeCycleEventType.AFTER_VIEW_ENDED\n  REQUEST_STARTED: LifeCycleEventType.REQUEST_STARTED\n  REQUEST_COMPLETED: LifeCycleEventType.REQUEST_COMPLETED\n  WEBSOCKET_COMPLETED: LifeCycleEventType.WEBSOCKET_COMPLETED\n  SESSION_EXPIRED: LifeCycleEventType.SESSION_EXPIRED\n  SESSION_RENEWED: LifeCycleEventType.SESSION_RENEWED\n  PREPARE_URGENT_FLUSH: LifeCycleEventType.PREPARE_URGENT_FLUSH\n  RAW_RUM_EVENT_COLLECTED: LifeCycleEventType.RAW_RUM_EVENT_COLLECTED\n  RUM_EVENT_COLLECTED: LifeCycleEventType.RUM_EVENT_COLLECTED\n  RAW_ERROR_COLLECTED: LifeCycleEventType.RAW_ERROR_COLLECTED\n  DURATION_VITAL_STARTED: LifeCycleEventType.DURATION_VITAL_STARTED\n}\n\n// Note: this interface needs to be exported even if it is not used outside of this module, else TS\n// fails to build the rum-core package with error TS4058\nexport interface LifeCycleEventMap {\n  [LifeCycleEventTypeAsConst.ACTION_STARTED]: TrackedEventData<ActionEventData>\n  [LifeCycleEventTypeAsConst.AUTO_ACTION_COMPLETED]: AutoAction\n  [LifeCycleEventTypeAsConst.BEFORE_VIEW_CREATED]: ViewCreatedEvent\n  [LifeCycleEventTypeAsConst.VIEW_CREATED]: ViewCreatedEvent\n  [LifeCycleEventTypeAsConst.BEFORE_VIEW_UPDATED]: BeforeViewUpdateEvent\n  [LifeCycleEventTypeAsConst.VIEW_UPDATED]: ViewEvent\n  [LifeCycleEventTypeAsConst.VIEW_ENDED]: ViewEndedEvent\n  [LifeCycleEventTypeAsConst.AFTER_VIEW_ENDED]: ViewEndedEvent\n  [LifeCycleEventTypeAsConst.REQUEST_STARTED]: RequestStartEvent\n  [LifeCycleEventTypeAsConst.REQUEST_COMPLETED]: RequestCompleteEvent\n  [LifeCycleEventTypeAsConst.WEBSOCKET_COMPLETED]: WebSocketCompleteEvent\n  [LifeCycleEventTypeAsConst.SESSION_EXPIRED]: SessionExpiredEvent\n  [LifeCycleEventTypeAsConst.SESSION_RENEWED]: void\n  [LifeCycleEventTypeAsConst.PREPARE_URGENT_FLUSH]: UrgentFlushReason\n  [LifeCycleEventTypeAsConst.RAW_RUM_EVENT_COLLECTED]: RawRumEventCollectedData\n  [LifeCycleEventTypeAsConst.RUM_EVENT_COLLECTED]: AssembledRumEvent\n  [LifeCycleEventTypeAsConst.RAW_ERROR_COLLECTED]: {\n    error: RawError\n    customerContext?: Context\n  }\n  [LifeCycleEventTypeAsConst.DURATION_VITAL_STARTED]: DurationVitalStart\n}\n\nexport interface RawRumEventCollectedData<E extends RawRumEvent = RawRumEvent> {\n  startClocks: ClocksState\n  duration?: Duration\n  rawRumEvent: E\n  domainContext: RumEventDomainContext<E['type']>\n}\n\nexport const LifeCycle = AbstractLifeCycle<LifeCycleEventMap>\nexport type LifeCycle = AbstractLifeCycle<LifeCycleEventMap>\n"],"mappings":";;AAcA,IAAkB,qBAAX,yBAAA,oBAAA;CAGL,mBAAA,mBAAA,2BAAA,KAAA;CACA,mBAAA,mBAAA,yBAAA,KAAA;CACA,mBAAA,mBAAA,kBAAA,KAAA;CACA,mBAAA,mBAAA,yBAAA,KAAA;CACA,mBAAA,mBAAA,kBAAA,KAAA;CACA,mBAAA,mBAAA,gBAAA,KAAA;CACA,mBAAA,mBAAA,sBAAA,KAAA;CACA,mBAAA,mBAAA,qBAAA,KAAA;CACA,mBAAA,mBAAA,uBAAA,KAAA;CACA,mBAAA,mBAAA,yBAAA,KAAA;CAYA,mBAAA,mBAAA,qBAAA,MAAA;CACA,mBAAA,mBAAA,qBAAA,MAAA;CACA,mBAAA,mBAAA,0BAAA,MAAA;CACA,mBAAA,mBAAA,6BAAA,MAAA;CACA,mBAAA,mBAAA,yBAAA,MAAA;CACA,mBAAA,mBAAA,yBAAA,MAAA;CACA,mBAAA,mBAAA,oBAAA,MAAA;CACA,mBAAA,mBAAA,4BAAA,MAAA;;AACF,EAAA,CAAA,CAAA;AAoEA,MAAa,YAAYA,kCAAAA"}

package/cjs/domain/limitModification.d.ts

@@ -1,8 +1,12 @@
 import type { Context } from '@kubesense/kubesense-browser-core';
-export type ModifiableFieldPaths = Record<string, 'string' | 'object'>;
+export type ModifiableFieldPaths = Record<string, 'string' | 'object' | 'array'>;
 /**
  * Allows declaring and enforcing modifications to specific fields of an object.
  * Only supports modifying properties of an object (even if nested in an array).
  * Does not support array manipulation (adding/removing items).
+ *
+ * Modifications of the object are sanitized only if the field was actually changed by the modifier function (i.e., value is different).
+ * This ensures consistent SDK behavior regardless of whether limitModification is called.
+ * Only string fields are handled this way, object fields are sanitized regardless of whether the modifier function was called or not.
  */
 export declare function limitModification<T extends Context, Result>(object: T, modifiableFieldPaths: ModifiableFieldPaths, modifier: (object: T) => Result): Result | undefined;

package/cjs/domain/limitModification.js

@@ -1,46 +1,42 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.limitModification = limitModification;
-const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
+let _kubesense_kubesense_js_core_util = require("@kubesense/kubesense-js-core/util");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+//#region src/domain/limitModification.ts
 /**
- * Allows declaring and enforcing modifications to specific fields of an object.
- * Only supports modifying properties of an object (even if nested in an array).
- * Does not support array manipulation (adding/removing items).
- */
+* Allows declaring and enforcing modifications to specific fields of an object.
+* Only supports modifying properties of an object (even if nested in an array).
+* Does not support array manipulation (adding/removing items).
+*
+* Modifications of the object are sanitized only if the field was actually changed by the modifier function (i.e., value is different).
+* This ensures consistent SDK behavior regardless of whether limitModification is called.
+* Only string fields are handled this way, object fields are sanitized regardless of whether the modifier function was called or not.
+*/
 function limitModification(object, modifiableFieldPaths, modifier) {
-    const clone = (0, kubesense_browser_core_1.deepClone)(object);
-    const result = modifier(clone);
-    (0, kubesense_browser_core_1.objectEntries)(modifiableFieldPaths).forEach(([fieldPath, fieldType]) => 
-    // Traverse both object and clone simultaneously up to the path and apply the modification from the clone to the original object when the type is valid
-    setValueAtPath(object, clone, fieldPath.split(/\.|(?=\[\])/), fieldType));
-    return result;
+	const clone = (0, _kubesense_kubesense_js_core_util.deepClone)(object);
+	const result = modifier(clone);
+	(0, _kubesense_kubesense_browser_core.objectEntries)(modifiableFieldPaths).forEach(([fieldPath, fieldType]) => setValueAtPath(object, clone, fieldPath.split(/\.|(?=\[\])/), fieldType));
+	return result;
 }
 function setValueAtPath(object, clone, pathSegments, fieldType) {
-    const [field, ...restPathSegments] = pathSegments;
-    if (field === '[]') {
-        if (Array.isArray(object) && Array.isArray(clone)) {
-            object.forEach((item, i) => setValueAtPath(item, clone[i], restPathSegments, fieldType));
-        }
-        return;
-    }
-    if (!isValidObject(object) || !isValidObject(clone)) {
-        return;
-    }
-    if (restPathSegments.length > 0) {
-        return setValueAtPath(object[field], clone[field], restPathSegments, fieldType);
-    }
-    setNestedValue(object, field, clone[field], fieldType);
+	const [field, ...restPathSegments] = pathSegments;
+	if (field === "[]") {
+		if (Array.isArray(object) && Array.isArray(clone)) object.forEach((item, i) => setValueAtPath(item, clone[i], restPathSegments, fieldType));
+		return;
+	}
+	if (!isValidObject(object) || !isValidObject(clone)) return;
+	if (restPathSegments.length > 0) return setValueAtPath(object[field], clone[field], restPathSegments, fieldType);
+	setNestedValue(object, field, clone[field], fieldType);
 }
 function setNestedValue(object, field, value, fieldType) {
-    const newType = (0, kubesense_browser_core_1.getType)(value);
-    if (newType === fieldType) {
-        object[field] = (0, kubesense_browser_core_1.sanitize)(value);
-    }
-    else if (fieldType === 'object' && (newType === 'undefined' || newType === 'null')) {
-        object[field] = {};
-    }
+	if (object[field] === value) return;
+	const newType = (0, _kubesense_kubesense_js_core_util.getType)(value);
+	if (newType === fieldType) object[field] = (0, _kubesense_kubesense_browser_core.sanitize)(value);
+	else if (fieldType === "object" && (newType === "undefined" || newType === "null")) object[field] = {};
+	else if (fieldType === "array" && (newType === "undefined" || newType === "null")) object[field] = [];
 }
 function isValidObject(object) {
-    return (0, kubesense_browser_core_1.getType)(object) === 'object';
+	return (0, _kubesense_kubesense_js_core_util.getType)(object) === "object";
 }
+//#endregion
+exports.limitModification = limitModification;
+
 //# sourceMappingURL=limitModification.js.map

package/cjs/domain/limitModification.js.map

@@ -1 +1 @@
-{"version":3,"file":"limitModification.js","sourceRoot":"","sources":["../../src/domain/limitModification.ts"],"names":[],"mappings":";;AAUA,8CAcC;AAxBD,8EAA+F;AAK/F;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,MAAS,EACT,oBAA0C,EAC1C,QAA+B;IAE/B,MAAM,KAAK,GAAG,IAAA,kCAAS,EAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE9B,IAAA,sCAAa,EAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE;IACrE,uJAAuJ;IACvJ,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,CACzE,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,cAAc,CAAC,MAAe,EAAE,KAAc,EAAE,YAAsB,EAAE,SAA8B;IAC7G,MAAM,CAAC,KAAK,EAAE,GAAG,gBAAgB,CAAC,GAAG,YAAY,CAAA;IAEjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAA;QAC1F,CAAC;QAED,OAAM;IACR,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAM;IACR,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;IACjF,CAAC;IAED,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,cAAc,CACrB,MAA+B,EAC/B,KAAa,EACb,KAAc,EACd,SAA8B;IAE9B,MAAM,OAAO,GAAG,IAAA,gCAAO,EAAC,KAAK,CAAC,CAAA;IAE9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,iCAAQ,EAAC,KAAK,CAAC,CAAA;IACjC,CAAC;SAAM,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,MAAM,CAAC,EAAE,CAAC;QACrF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,OAAO,IAAA,gCAAO,EAAC,MAAM,CAAC,KAAK,QAAQ,CAAA;AACrC,CAAC"}
+{"version":3,"file":"limitModification.js","names":["deepClone","getType","sanitize"],"sources":["../../src/domain/limitModification.ts"],"sourcesContent":["import { sanitize, objectEntries } from '@kubesense/kubesense-browser-core'\nimport type { Context } from '@kubesense/kubesense-browser-core'\nimport { deepClone, getType } from '@kubesense/kubesense-js-core/util'\n\nexport type ModifiableFieldPaths = Record<string, 'string' | 'object' | 'array'>\n\n/**\n * Allows declaring and enforcing modifications to specific fields of an object.\n * Only supports modifying properties of an object (even if nested in an array).\n * Does not support array manipulation (adding/removing items).\n *\n * Modifications of the object are sanitized only if the field was actually changed by the modifier function (i.e., value is different).\n * This ensures consistent SDK behavior regardless of whether limitModification is called.\n * Only string fields are handled this way, object fields are sanitized regardless of whether the modifier function was called or not.\n */\nexport function limitModification<T extends Context, Result>(\n  object: T,\n  modifiableFieldPaths: ModifiableFieldPaths,\n  modifier: (object: T) => Result\n): Result | undefined {\n  const clone = deepClone(object)\n  const result = modifier(clone)\n\n  objectEntries(modifiableFieldPaths).forEach(([fieldPath, fieldType]) =>\n    // Traverse both object and clone simultaneously up to the path and apply the modification from the clone to the original object when the type is valid\n    setValueAtPath(object, clone, fieldPath.split(/\\.|(?=\\[\\])/), fieldType)\n  )\n\n  return result\n}\n\nfunction setValueAtPath(\n  object: unknown,\n  clone: unknown,\n  pathSegments: string[],\n  fieldType: 'string' | 'object' | 'array'\n) {\n  const [field, ...restPathSegments] = pathSegments\n\n  if (field === '[]') {\n    if (Array.isArray(object) && Array.isArray(clone)) {\n      object.forEach((item, i) => setValueAtPath(item, clone[i], restPathSegments, fieldType))\n    }\n\n    return\n  }\n\n  if (!isValidObject(object) || !isValidObject(clone)) {\n    return\n  }\n\n  if (restPathSegments.length > 0) {\n    return setValueAtPath(object[field], clone[field], restPathSegments, fieldType)\n  }\n\n  setNestedValue(object, field, clone[field], fieldType)\n}\n\nfunction setNestedValue(\n  object: Record<string, unknown>,\n  field: string,\n  value: unknown,\n  fieldType: 'string' | 'object' | 'array'\n) {\n  if (object[field] === value) {\n    return\n  }\n\n  const newType = getType(value)\n\n  if (newType === fieldType) {\n    object[field] = sanitize(value)\n  } else if (fieldType === 'object' && (newType === 'undefined' || newType === 'null')) {\n    object[field] = {}\n  } else if (fieldType === 'array' && (newType === 'undefined' || newType === 'null')) {\n    object[field] = []\n  }\n}\n\nfunction isValidObject(object: unknown): object is Record<string, unknown> {\n  return getType(object) === 'object'\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAgB,kBACd,QACA,sBACA,UACoB;CACpB,MAAM,SAAA,GAAQA,kCAAAA,UAAAA,CAAU,MAAM;CAC9B,MAAM,SAAS,SAAS,KAAK;CAE7B,CAAA,GAAA,kCAAA,cAAA,CAAc,oBAAoB,CAAC,CAAC,SAAS,CAAC,WAAW,eAEvD,eAAe,QAAQ,OAAO,UAAU,MAAM,aAAa,GAAG,SAAS,CACzE;CAEA,OAAO;AACT;AAEA,SAAS,eACP,QACA,OACA,cACA,WACA;CACA,MAAM,CAAC,OAAO,GAAG,oBAAoB;CAErC,IAAI,UAAU,MAAM;EAClB,IAAI,MAAM,QAAQ,MAAM,KAAK,MAAM,QAAQ,KAAK,GAC9C,OAAO,SAAS,MAAM,MAAM,eAAe,MAAM,MAAM,IAAI,kBAAkB,SAAS,CAAC;EAGzF;CACF;CAEA,IAAI,CAAC,cAAc,MAAM,KAAK,CAAC,cAAc,KAAK,GAChD;CAGF,IAAI,iBAAiB,SAAS,GAC5B,OAAO,eAAe,OAAO,QAAQ,MAAM,QAAQ,kBAAkB,SAAS;CAGhF,eAAe,QAAQ,OAAO,MAAM,QAAQ,SAAS;AACvD;AAEA,SAAS,eACP,QACA,OACA,OACA,WACA;CACA,IAAI,OAAO,WAAW,OACpB;CAGF,MAAM,WAAA,GAAUC,kCAAAA,QAAAA,CAAQ,KAAK;CAE7B,IAAI,YAAY,WACd,OAAO,UAAA,GAASC,kCAAAA,SAAAA,CAAS,KAAK;MACzB,IAAI,cAAc,aAAa,YAAY,eAAe,YAAY,SAC3E,OAAO,SAAS,CAAC;MACZ,IAAI,cAAc,YAAY,YAAY,eAAe,YAAY,SAC1E,OAAO,SAAS,CAAC;AAErB;AAEA,SAAS,cAAc,QAAoD;CACzE,QAAA,GAAOD,kCAAAA,QAAAA,CAAQ,MAAM,MAAM;AAC7B"}

package/cjs/domain/longTask/longTaskCollection.d.ts

@@ -1,18 +1,5 @@
-import type { RelativeTime, ClocksState, Duration } from '@kubesense/kubesense-browser-core';
 import type { LifeCycle } from '../lifeCycle';
-import { RumPerformanceEntryType } from '../../browser/performanceObservable';
 import type { RumConfiguration } from '../configuration';
-export declare const LONG_TASK_ID_HISTORY_TIME_OUT_DELAY: number;
-export interface LongTaskContext {
-    id: string;
-    startClocks: ClocksState;
-    duration: Duration;
-    entryType: RumPerformanceEntryType.LONG_ANIMATION_FRAME | RumPerformanceEntryType.LONG_TASK;
-}
-export interface LongTaskContexts {
-    findLongTasks: (startTime: RelativeTime) => LongTaskContext[];
-}
 export declare function startLongTaskCollection(lifeCycle: LifeCycle, configuration: RumConfiguration): {
     stop: () => void;
-    longTaskContexts: LongTaskContexts;
 };

package/cjs/domain/longTask/longTaskCollection.js

@@ -1,91 +1,79 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LONG_TASK_ID_HISTORY_TIME_OUT_DELAY = void 0;
-exports.startLongTaskCollection = startLongTaskCollection;
-const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
-const rawRumEvent_types_1 = require("../../rawRumEvent.types");
-const performanceObservable_1 = require("../../browser/performanceObservable");
-exports.LONG_TASK_ID_HISTORY_TIME_OUT_DELAY = kubesense_browser_core_1.SESSION_TIME_OUT_DELAY;
+const require_rawRumEvent_types = require("../../rawRumEvent.types.js");
+require("../lifeCycle.js");
+const require_performanceObservable = require("../../browser/performanceObservable.js");
+let _kubesense_kubesense_js_core_time = require("@kubesense/kubesense-js-core/time");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+//#region src/domain/longTask/longTaskCollection.ts
 function startLongTaskCollection(lifeCycle, configuration) {
-    const history = (0, kubesense_browser_core_1.createValueHistory)({
-        expireDelay: exports.LONG_TASK_ID_HISTORY_TIME_OUT_DELAY,
-    });
-    const entryType = (0, performanceObservable_1.supportPerformanceTimingEvent)(performanceObservable_1.RumPerformanceEntryType.LONG_ANIMATION_FRAME)
-        ? performanceObservable_1.RumPerformanceEntryType.LONG_ANIMATION_FRAME
-        : performanceObservable_1.RumPerformanceEntryType.LONG_TASK;
-    const subscription = (0, performanceObservable_1.createPerformanceObservable)(configuration, {
-        type: entryType,
-        buffered: true,
-    }).subscribe((entries) => {
-        for (const entry of entries) {
-            if (!configuration.trackLongTasks) {
-                break;
-            }
-            const startClocks = (0, kubesense_browser_core_1.relativeToClocks)(entry.startTime);
-            const taskId = (0, kubesense_browser_core_1.generateUUID)();
-            const rawRumEvent = processEntry(entry, startClocks, taskId);
-            lifeCycle.notify(12 /* LifeCycleEventType.RAW_RUM_EVENT_COLLECTED */, {
-                rawRumEvent,
-                startTime: startClocks.relative,
-                duration: entry.duration,
-                domainContext: { performanceEntry: entry },
-            });
-            history.add({ id: taskId, startClocks, duration: entry.duration, entryType }, startClocks.relative);
-            history.closeActive((0, kubesense_browser_core_1.addDuration)(startClocks.relative, entry.duration));
-        }
-    });
-    const longTaskContexts = {
-        findLongTasks: (startTime) => history.findAll(startTime),
-    };
-    return {
-        stop: () => {
-            subscription.unsubscribe();
-            history.stop();
-        },
-        longTaskContexts,
-    };
+	const entryType = require_performanceObservable.supportPerformanceTimingEvent("long-animation-frame") ? "long-animation-frame" : "longtask";
+	const subscription = require_performanceObservable.createPerformanceObservable({
+		type: entryType,
+		buffered: true
+	}).subscribe((entries) => {
+		for (const entry of entries) {
+			if (!configuration.trackLongTasks) break;
+			const startClocks = (0, _kubesense_kubesense_js_core_time.relativeToClocks)(entry.startTime);
+			const rawRumEvent = processEntry(entry, startClocks);
+			lifeCycle.notify(13, {
+				rawRumEvent,
+				startClocks,
+				duration: entry.duration,
+				domainContext: { performanceEntry: entry }
+			});
+		}
+	});
+	return { stop: () => subscription.unsubscribe() };
 }
-function processEntry(entry, startClocks, taskId) {
-    const baseEvent = {
-        date: startClocks.timeStamp,
-        type: rawRumEvent_types_1.RumEventType.LONG_TASK,
-        _kubesense: { discarded: false },
-    };
-    if (entry.entryType === performanceObservable_1.RumPerformanceEntryType.LONG_TASK) {
-        return {
-            ...baseEvent,
-            long_task: {
-                id: taskId,
-                entry_type: rawRumEvent_types_1.RumLongTaskEntryType.LONG_TASK,
-                duration: (0, kubesense_browser_core_1.toServerDuration)(entry.duration),
-            },
-        };
-    }
-    return {
-        ...baseEvent,
-        long_task: {
-            id: taskId,
-            entry_type: rawRumEvent_types_1.RumLongTaskEntryType.LONG_ANIMATION_FRAME,
-            duration: (0, kubesense_browser_core_1.toServerDuration)(entry.duration),
-            blocking_duration: (0, kubesense_browser_core_1.toServerDuration)(entry.blockingDuration),
-            first_ui_event_timestamp: (0, kubesense_browser_core_1.toServerDuration)(entry.firstUIEventTimestamp),
-            render_start: (0, kubesense_browser_core_1.toServerDuration)(entry.renderStart),
-            style_and_layout_start: (0, kubesense_browser_core_1.toServerDuration)(entry.styleAndLayoutStart),
-            start_time: (0, kubesense_browser_core_1.toServerDuration)(entry.startTime),
-            scripts: entry.scripts.map((script) => ({
-                duration: (0, kubesense_browser_core_1.toServerDuration)(script.duration),
-                pause_duration: (0, kubesense_browser_core_1.toServerDuration)(script.pauseDuration),
-                forced_style_and_layout_duration: (0, kubesense_browser_core_1.toServerDuration)(script.forcedStyleAndLayoutDuration),
-                start_time: (0, kubesense_browser_core_1.toServerDuration)(script.startTime),
-                execution_start: (0, kubesense_browser_core_1.toServerDuration)(script.executionStart),
-                source_url: script.sourceURL,
-                source_function_name: script.sourceFunctionName,
-                source_char_position: script.sourceCharPosition,
-                invoker: script.invoker,
-                invoker_type: script.invokerType,
-                window_attribution: script.windowAttribution,
-            })),
-        },
-    };
+function processEntry(entry, startClocks) {
+	const id = (0, _kubesense_kubesense_browser_core.generateUUID)();
+	const duration = (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.duration);
+	const baseEvent = {
+		date: startClocks.timeStamp,
+		type: require_rawRumEvent_types.RumEventType.LONG_TASK,
+		_kubesense: { discarded: false }
+	};
+	if (entry.entryType === "longtask") return {
+		...baseEvent,
+		long_task: {
+			id,
+			entry_type: require_rawRumEvent_types.RumLongTaskEntryType.LONG_TASK,
+			duration
+		}
+	};
+	const scriptUrls = entry.scripts.map((script) => script.sourceURL).filter((url) => !!url);
+	const debugIdByUrl = (0, _kubesense_kubesense_browser_core.buildDebugIdByUrl)(scriptUrls);
+	return {
+		...baseEvent,
+		_kubesense: {
+			discarded: false,
+			debug_ids: debugIdByUrl
+		},
+		long_task: {
+			id,
+			entry_type: require_rawRumEvent_types.RumLongTaskEntryType.LONG_ANIMATION_FRAME,
+			duration,
+			blocking_duration: (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.blockingDuration),
+			first_ui_event_timestamp: (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.firstUIEventTimestamp),
+			render_start: (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.renderStart),
+			style_and_layout_start: (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.styleAndLayoutStart),
+			start_time: (0, _kubesense_kubesense_js_core_time.toServerDuration)(entry.startTime),
+			scripts: entry.scripts.map((script) => ({
+				duration: (0, _kubesense_kubesense_js_core_time.toServerDuration)(script.duration),
+				pause_duration: (0, _kubesense_kubesense_js_core_time.toServerDuration)(script.pauseDuration),
+				forced_style_and_layout_duration: (0, _kubesense_kubesense_js_core_time.toServerDuration)(script.forcedStyleAndLayoutDuration),
+				start_time: (0, _kubesense_kubesense_js_core_time.toServerDuration)(script.startTime),
+				execution_start: (0, _kubesense_kubesense_js_core_time.toServerDuration)(script.executionStart),
+				source_url: script.sourceURL,
+				source_function_name: script.sourceFunctionName,
+				source_char_position: script.sourceCharPosition,
+				invoker: script.invoker,
+				invoker_type: script.invokerType,
+				window_attribution: script.windowAttribution
+			}))
+		}
+	};
 }
+//#endregion
+exports.startLongTaskCollection = startLongTaskCollection;
+
 //# sourceMappingURL=longTaskCollection.js.map

package/cjs/domain/longTask/longTaskCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"longTaskCollection.js","sourceRoot":"","sources":["../../../src/domain/longTask/longTaskCollection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"longTaskCollection.js","names":["supportPerformanceTimingEvent","createPerformanceObservable","relativeToClocks","generateUUID","toServerDuration","RumEventType","RumLongTaskEntryType","buildDebugIdByUrl"],"sources":["../../../src/domain/longTask/longTaskCollection.ts"],"sourcesContent":["import type { ClocksState } from '@kubesense/kubesense-js-core/time'\nimport { toServerDuration, relativeToClocks } from '@kubesense/kubesense-js-core/time'\nimport { generateUUID, buildDebugIdByUrl } from '@kubesense/kubesense-browser-core'\nimport type { RawRumLongTaskEvent, RawRumLongAnimationFrameEvent } from '../../rawRumEvent.types'\nimport { RumEventType, RumLongTaskEntryType } from '../../rawRumEvent.types'\nimport type { LifeCycle } from '../lifeCycle'\nimport { LifeCycleEventType } from '../lifeCycle'\nimport {\n  createPerformanceObservable,\n  RumPerformanceEntryType,\n  supportPerformanceTimingEvent,\n} from '../../browser/performanceObservable'\nimport type {\n  RumPerformanceLongAnimationFrameTiming,\n  RumPerformanceLongTaskTiming,\n  RumPerformanceScriptTiming,\n} from '../../browser/performanceObservable'\nimport type { RumConfiguration } from '../configuration'\n\nexport function startLongTaskCollection(lifeCycle: LifeCycle, configuration: RumConfiguration) {\n  const entryType = supportPerformanceTimingEvent(RumPerformanceEntryType.LONG_ANIMATION_FRAME)\n    ? RumPerformanceEntryType.LONG_ANIMATION_FRAME\n    : RumPerformanceEntryType.LONG_TASK\n\n  const subscription = createPerformanceObservable({\n    type: entryType,\n    buffered: true,\n  }).subscribe((entries) => {\n    for (const entry of entries) {\n      if (!configuration.trackLongTasks) {\n        break\n      }\n\n      const startClocks = relativeToClocks(entry.startTime)\n      const rawRumEvent = processEntry(entry, startClocks)\n\n      lifeCycle.notify(LifeCycleEventType.RAW_RUM_EVENT_COLLECTED, {\n        rawRumEvent,\n        startClocks,\n        duration: entry.duration,\n        domainContext: { performanceEntry: entry },\n      })\n    }\n  })\n\n  return {\n    stop: () => subscription.unsubscribe(),\n  }\n}\n\nfunction processEntry(\n  entry: RumPerformanceLongTaskTiming | RumPerformanceLongAnimationFrameTiming,\n  startClocks: ClocksState\n): RawRumLongTaskEvent | RawRumLongAnimationFrameEvent {\n  const id = generateUUID()\n  const duration = toServerDuration(entry.duration)\n\n  const baseEvent = {\n    date: startClocks.timeStamp,\n    type: RumEventType.LONG_TASK,\n    _kubesense: { discarded: false },\n  }\n\n  if (entry.entryType === RumPerformanceEntryType.LONG_TASK) {\n    return {\n      ...baseEvent,\n      long_task: {\n        id,\n        entry_type: RumLongTaskEntryType.LONG_TASK,\n        duration,\n      },\n    }\n  }\n  const scriptUrls = entry.scripts.map((script) => script.sourceURL).filter((url): url is string => !!url)\n  const debugIdByUrl = buildDebugIdByUrl(scriptUrls)\n\n  return {\n    ...baseEvent,\n    _kubesense: { discarded: false, debug_ids: debugIdByUrl },\n    long_task: {\n      id,\n      entry_type: RumLongTaskEntryType.LONG_ANIMATION_FRAME,\n      duration,\n      blocking_duration: toServerDuration(entry.blockingDuration),\n      first_ui_event_timestamp: toServerDuration(entry.firstUIEventTimestamp),\n      render_start: toServerDuration(entry.renderStart),\n      style_and_layout_start: toServerDuration(entry.styleAndLayoutStart),\n      start_time: toServerDuration(entry.startTime),\n      scripts: entry.scripts.map((script: RumPerformanceScriptTiming) => ({\n        duration: toServerDuration(script.duration),\n        pause_duration: toServerDuration(script.pauseDuration),\n        forced_style_and_layout_duration: toServerDuration(script.forcedStyleAndLayoutDuration),\n        start_time: toServerDuration(script.startTime),\n        execution_start: toServerDuration(script.executionStart),\n        source_url: script.sourceURL,\n        source_function_name: script.sourceFunctionName,\n        source_char_position: script.sourceCharPosition,\n        invoker: script.invoker,\n        invoker_type: script.invokerType,\n        window_attribution: script.windowAttribution,\n      })),\n    },\n  }\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,wBAAwB,WAAsB,eAAiC;CAC7F,MAAM,YAAYA,8BAAAA,8BAAAA,sBAA0E,IAAA,yBAAA;CAI5F,MAAM,eAAeC,8BAAAA,4BAA4B;EAC/C,MAAM;EACN,UAAU;CACZ,CAAC,CAAC,CAAC,WAAW,YAAY;EACxB,KAAK,MAAM,SAAS,SAAS;GAC3B,IAAI,CAAC,cAAc,gBACjB;GAGF,MAAM,eAAA,GAAcC,kCAAAA,iBAAAA,CAAiB,MAAM,SAAS;GACpD,MAAM,cAAc,aAAa,OAAO,WAAW;GAEnD,UAAU,OAAA,IAAmD;IAC3D;IACA;IACA,UAAU,MAAM;IAChB,eAAe,EAAE,kBAAkB,MAAM;GAC3C,CAAC;EACH;CACF,CAAC;CAED,OAAO,EACL,YAAY,aAAa,YAAY,EACvC;AACF;AAEA,SAAS,aACP,OACA,aACqD;CACrD,MAAM,MAAA,GAAKC,kCAAAA,aAAAA,CAAa;CACxB,MAAM,YAAA,GAAWC,kCAAAA,iBAAAA,CAAiB,MAAM,QAAQ;CAEhD,MAAM,YAAY;EAChB,MAAM,YAAY;EAClB,MAAMC,0BAAAA,aAAa;EACnB,YAAY,EAAE,WAAW,MAAM;CACjC;CAEA,IAAI,MAAM,cAAA,YACR,OAAO;EACL,GAAG;EACH,WAAW;GACT;GACA,YAAYC,0BAAAA,qBAAqB;GACjC;EACF;CACF;CAEF,MAAM,aAAa,MAAM,QAAQ,KAAK,WAAW,OAAO,SAAS,CAAC,CAAC,QAAQ,QAAuB,CAAC,CAAC,GAAG;CACvG,MAAM,gBAAA,GAAeC,kCAAAA,kBAAAA,CAAkB,UAAU;CAEjD,OAAO;EACL,GAAG;EACH,YAAY;GAAE,WAAW;GAAO,WAAW;EAAa;EACxD,WAAW;GACT;GACA,YAAYD,0BAAAA,qBAAqB;GACjC;GACA,oBAAA,GAAmBF,kCAAAA,iBAAAA,CAAiB,MAAM,gBAAgB;GAC1D,2BAAA,GAA0BA,kCAAAA,iBAAAA,CAAiB,MAAM,qBAAqB;GACtE,eAAA,GAAcA,kCAAAA,iBAAAA,CAAiB,MAAM,WAAW;GAChD,yBAAA,GAAwBA,kCAAAA,iBAAAA,CAAiB,MAAM,mBAAmB;GAClE,aAAA,GAAYA,kCAAAA,iBAAAA,CAAiB,MAAM,SAAS;GAC5C,SAAS,MAAM,QAAQ,KAAK,YAAwC;IAClE,WAAA,GAAUA,kCAAAA,iBAAAA,CAAiB,OAAO,QAAQ;IAC1C,iBAAA,GAAgBA,kCAAAA,iBAAAA,CAAiB,OAAO,aAAa;IACrD,mCAAA,GAAkCA,kCAAAA,iBAAAA,CAAiB,OAAO,4BAA4B;IACtF,aAAA,GAAYA,kCAAAA,iBAAAA,CAAiB,OAAO,SAAS;IAC7C,kBAAA,GAAiBA,kCAAAA,iBAAAA,CAAiB,OAAO,cAAc;IACvD,YAAY,OAAO;IACnB,sBAAsB,OAAO;IAC7B,sBAAsB,OAAO;IAC7B,SAAS,OAAO;IAChB,cAAc,OAAO;IACrB,oBAAoB,OAAO;GAC7B,EAAE;EACJ;CACF;AACF"}

package/cjs/domain/plugins.d.ts

@@ -1,40 +1,63 @@
-import type { RumPublicApi, Strategy } from '../boot/rumPublicApi';
+import type { RumPublicApi } from '../boot/rumPublicApi';
 import type { StartRumResult } from '../boot/startRum';
 import type { RumInitConfiguration } from './configuration';
+import type { AssembleHook } from './hooks';
 /**
- * onRumStart plugin API options.
+ * onInit plugin API options.
  *
  * @experimental
  */
-export interface OnRumStartOptions {
+export interface RumPluginOnInitOptions {
+    initConfiguration: RumInitConfiguration;
+    publicApi: RumPublicApi;
     /**
-     * @deprecated Use `addEvent` instead.
+     * Register a callback invoked when a RUM event is assembled, so plugins can enrich or override
+     * event fields before they are sent. Callbacks registered in `onInit` run before any event is
+     * assembled, including events buffered during the pre-start phase.
      */
-    strategy?: Strategy;
+    registerAssembleEventHook: AssembleHook['register'];
+}
+/**
+ * onRumStart plugin API options.
+ *
+ * @experimental
+ */
+export interface OnRumStartOptions {
     /**
      * Add an event to the RUM browser SDK.
      */
     addEvent?: StartRumResult['addEvent'];
+    /**
+     * Add a custom error to the RUM browser SDK.
+     */
+    addError?: StartRumResult['addError'];
 }
 /**
  * Plugin interface of the RUM browser SDK.
  *
  * The plugins API is unstable and experimental, and may change without
- * notice. Please use only plugins provided by Kubesense matching the version of the SDK you are
+ * notice. Please use only plugins provided by KubeSense matching the version of the SDK you are
  * using.
  *
+ * `onInit` may abort the SDK initialization by returning (or resolving to) `false`. All plugins'
+ * `onInit` are called concurrently and independently; a Promise defers the actual initialization
+ * until it resolves, but does not delay any other plugin's `onInit` call.
+ *
  * @experimental
  */
 export interface RumPlugin {
     name: string;
     getConfigurationTelemetry?(): Record<string, unknown>;
-    onInit?(options: {
-        initConfiguration: RumInitConfiguration;
-        publicApi: RumPublicApi;
-    }): void;
+    onInit?(options: RumPluginOnInitOptions): false | void | Promise<false | void>;
     onRumStart?(options: OnRumStartOptions): void;
 }
-type MethodNames = 'onInit' | 'onRumStart';
-type MethodParameter<MethodName extends MethodNames> = Parameters<NonNullable<RumPlugin[MethodName]>>[0];
-export declare function callPluginsMethod<MethodName extends MethodNames>(plugins: RumPlugin[] | undefined, methodName: MethodName, parameter: MethodParameter<MethodName>): void;
-export {};
+/**
+ * Calls every plugin's `onInit` method concurrently, without waiting for one to resolve before
+ * calling the next. Stays synchronous as long as no plugin returns a thenable.
+ * Returns `false` if any plugin returned (or resolved to) `false`, `true` otherwise.
+ */
+export declare function callPluginsOnInit(plugins: RumPlugin[] | undefined, parameter: RumPluginOnInitOptions): boolean | Promise<boolean>;
+/**
+ * Calls each plugin's `onRumStart` method in order.
+ */
+export declare function callPluginsOnRumStart(plugins: RumPlugin[] | undefined, options: OnRumStartOptions): void;

package/cjs/domain/plugins.js

@@ -1,15 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.callPluginsMethod = callPluginsMethod;
-function callPluginsMethod(plugins, methodName, parameter) {
-    if (!plugins) {
-        return;
-    }
-    for (const plugin of plugins) {
-        const method = plugin[methodName];
-        if (method) {
-            method(parameter);
-        }
-    }
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+//#region src/domain/plugins.ts
+/**
+* Calls every plugin's `onInit` method concurrently, without waiting for one to resolve before
+* calling the next. Stays synchronous as long as no plugin returns a thenable.
+* Returns `false` if any plugin returned (or resolved to) `false`, `true` otherwise.
+*/
+function callPluginsOnInit(plugins, parameter) {
+	if (!plugins) return true;
+	const results = plugins.map((plugin) => plugin.onInit?.(parameter));
+	if (results.some(_kubesense_kubesense_browser_core.isThenable)) return Promise.all(results).then((results) => !results.includes(false));
+	return !results.includes(false);
 }
+/**
+* Calls each plugin's `onRumStart` method in order.
+*/
+function callPluginsOnRumStart(plugins, options) {
+	for (const plugin of plugins ?? []) plugin.onRumStart?.(options);
+}
+//#endregion
+exports.callPluginsOnInit = callPluginsOnInit;
+exports.callPluginsOnRumStart = callPluginsOnRumStart;
+
 //# sourceMappingURL=plugins.js.map