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

package/esm/rawRumEvent.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawRumEvent.types.mjs","names":[],"sources":["../src/rawRumEvent.types.ts"],"sourcesContent":["import type { Duration, ServerDuration, TimeStamp } from '@kubesense/kubesense-js-core/time'\nimport type {\n  ErrorSource,\n  ErrorHandling,\n  ResourceType,\n  RawErrorCause,\n  DefaultPrivacyLevel,\n  Csp,\n  Context,\n  DebugIdEntry,\n} from '@kubesense/kubesense-browser-core'\nimport type { GraphQlMetadata } from './domain/resource/graphql'\nimport type { PageState } from './domain/contexts/pageStateHistory'\nimport type {\n  RumActionEvent,\n  RumErrorEvent,\n  RumLongTaskEvent,\n  RumResourceEvent,\n  RumViewEvent,\n  RumVitalEvent,\n} from './rumEvent.types'\n\nexport const RumEventType = {\n  ACTION: 'action',\n  ERROR: 'error',\n  LONG_TASK: 'long_task',\n  VIEW: 'view',\n  VIEW_UPDATE: 'view_update',\n  RESOURCE: 'resource',\n  VITAL: 'vital',\n} as const\n\nexport type RumEventType = (typeof RumEventType)[keyof typeof RumEventType]\n\nexport type AssembledRumEvent = (\n  RumViewEvent | RumActionEvent | RumResourceEvent | RumErrorEvent | RumVitalEvent | RumLongTaskEvent\n) &\n  Context\n\nexport const RumLongTaskEntryType = {\n  LONG_TASK: 'long-task',\n  LONG_ANIMATION_FRAME: 'long-animation-frame',\n} as const\n\nexport type RumLongTaskEntryType = (typeof RumLongTaskEntryType)[keyof typeof RumLongTaskEntryType]\n\nexport interface RawRumResourceEvent {\n  date: TimeStamp\n  type: typeof RumEventType.RESOURCE\n  resource: {\n    type: ResourceType\n    id: string\n    duration?: ServerDuration\n    url: string\n    method?: string\n    status_code?: number\n    size?: number\n    encoded_body_size?: number\n    decoded_body_size?: number\n    transfer_size?: number\n    render_blocking_status?: string\n    redirect?: ResourceEntryDetailsElement\n    dns?: ResourceEntryDetailsElement\n    connect?: ResourceEntryDetailsElement\n    ssl?: ResourceEntryDetailsElement\n    worker?: ResourceEntryDetailsElement\n    first_byte?: ResourceEntryDetailsElement\n    download?: ResourceEntryDetailsElement\n    protocol?: string\n    delivery_type?: DeliveryType\n    graphql?: GraphQlMetadata\n    websocket?: WebSocketResourceProperties\n    request?: ResourceRequest\n    response?: ResourceResponse\n    provider?: {\n      domain?: string\n      name?: string\n      type?:\n        | 'ad'\n        | 'advertising'\n        | 'analytics'\n        | 'cdn'\n        | 'content'\n        | 'customer-success'\n        | 'first party'\n        | 'hosting'\n        | 'marketing'\n        | 'other'\n        | 'social'\n        | 'tag-manager'\n        | 'utility'\n        | 'video'\n    }\n  }\n  _kubesense: {\n    trace_id?: string\n    span_id?: string // not available for initial document tracing\n    rule_psr?: number\n    discarded?: boolean\n    page_states?: PageStateServerEntry[]\n  }\n  context?: Context\n}\n\nexport interface WebSocketResourceProperties {\n  connection_id: string\n  handshake_succeeded: boolean\n  start_time: TimeStamp\n  end_time: TimeStamp\n  start_view_id?: string\n  end_view_id?: string\n  tracking_end_reason: 'close_event' | 'session_end'\n  close_code?: number\n  close_reason?: string\n  was_clean?: boolean\n  messages_in: { count: number; size: number }\n  messages_out: { count: number; size: number }\n  time_to_first_message_in?: ServerDuration\n  time_to_first_message_out?: ServerDuration\n  last_message_in_at?: TimeStamp\n  longest_inbound_silence: ServerDuration\n  inbound_idle_duration_before_close?: ServerDuration\n  buffered_amount_max: number\n  protocol?: string\n  setup_duration: ServerDuration\n}\n\nexport type NetworkHeaders = Record<string, string>\n\nexport interface ResourceRequest {\n  headers?: NetworkHeaders\n}\n\nexport interface ResourceResponse {\n  headers?: NetworkHeaders\n}\n\nexport interface ResourceEntryDetailsElement {\n  duration: ServerDuration\n  start: ServerDuration\n}\n\nexport interface RawRumErrorEvent {\n  date: TimeStamp\n  type: typeof RumEventType.ERROR\n  error: {\n    id: string\n    type?: string\n    stack?: string\n    handling_stack?: string\n    component_stack?: string\n    fingerprint?: string\n    source: ErrorSource\n    message: string\n    handling?: ErrorHandling\n    causes?: RawErrorCause[]\n    source_type: 'browser'\n    csp?: Csp\n  }\n  _kubesense?: {\n    debug_ids?: DebugIdEntry[]\n    discarded?: boolean\n  }\n  view?: {\n    in_foreground: boolean\n  }\n  context?: Context\n}\n\nexport interface RawRumViewEvent {\n  date: TimeStamp\n  type: typeof RumEventType.VIEW\n  view: {\n    loading_type: ViewLoadingType\n    first_byte?: ServerDuration\n    first_contentful_paint?: ServerDuration\n    interaction_to_next_paint?: ServerDuration\n    interaction_to_next_paint_time?: ServerDuration\n    interaction_to_next_paint_target_selector?: string\n    cumulative_layout_shift?: number\n    cumulative_layout_shift_time?: ServerDuration\n    cumulative_layout_shift_target_selector?: string\n    custom_timings?: {\n      [key: string]: ServerDuration\n    }\n    largest_contentful_paint?: ServerDuration\n    largest_contentful_paint_target_selector?: string\n    dom_interactive?: ServerDuration\n    dom_content_loaded?: ServerDuration\n    dom_complete?: ServerDuration\n    load_event?: ServerDuration\n    loading_time?: ServerDuration\n    time_spent: ServerDuration\n    is_active: boolean\n    name?: string\n    error: Count\n    action: Count\n    long_task: Count\n    resource: Count\n    frustration: Count\n    performance?: ViewPerformanceData\n  }\n  display?: ViewDisplay\n  privacy?: {\n    replay_level: DefaultPrivacyLevel\n  }\n  _kubesense: {\n    document_version: number\n    replay_stats?: ReplayStats\n    page_states?: PageStateServerEntry[]\n    cls?: {\n      device_pixel_ratio: number\n    }\n    configuration: {\n      start_session_replay_recording_manually: boolean\n      remote_configuration_id?: string\n    }\n  }\n  device?: {\n    locale?: string\n    locales?: readonly string[]\n    time_zone?: string\n  }\n}\n\nexport interface RawRumViewUpdateEvent {\n  date: TimeStamp\n  type: typeof RumEventType.VIEW_UPDATE\n  view: Partial<RawRumViewEvent['view']>\n  _kubesense: Partial<RawRumViewEvent['_kubesense']> & {\n    document_version: number\n  }\n  display?: Partial<ViewDisplay>\n  privacy?: RawRumViewEvent['privacy']\n  device?: RawRumViewEvent['device']\n  feature_flags?: Context\n}\n\ninterface ViewDisplay {\n  scroll: {\n    max_depth?: number\n    max_depth_scroll_top?: number\n    max_scroll_height?: number\n    max_scroll_height_time?: ServerDuration\n  }\n}\n\nexport interface ViewPerformanceData {\n  cls?: {\n    score: number\n    timestamp?: ServerDuration\n    target_selector?: string\n    previous_rect?: RumRect\n    current_rect?: RumRect\n  }\n  fcp?: {\n    timestamp: number\n  }\n  inp?: {\n    duration: ServerDuration\n    timestamp?: ServerDuration\n    target_selector?: string\n    sub_parts?: {\n      input_delay: ServerDuration\n      processing_duration: ServerDuration\n      presentation_delay: ServerDuration\n    }\n  }\n  lcp?: {\n    timestamp: ServerDuration\n    target_selector?: string\n    resource_url?: string\n    sub_parts?: {\n      load_delay: ServerDuration\n      load_time: ServerDuration\n      render_delay: ServerDuration\n    }\n  }\n}\n\nexport interface RumRect {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\nexport interface PageStateServerEntry {\n  state: PageState\n  start: ServerDuration\n  [k: string]: unknown\n}\n\nexport const ViewLoadingType = {\n  INITIAL_LOAD: 'initial_load',\n  ROUTE_CHANGE: 'route_change',\n  SESSION_RENEWAL: 'session_renewal',\n  BF_CACHE: 'bf_cache',\n} as const\n\nexport type ViewLoadingType = (typeof ViewLoadingType)[keyof typeof ViewLoadingType]\n\nexport interface ViewCustomTimings {\n  [key: string]: Duration\n}\n\nexport interface ReplayStats {\n  records_count: number\n  resources_count: number\n  segments_count: number\n  segments_total_raw_size: number\n}\n\ninterface Count {\n  count: number\n}\n\nexport interface RawRumLongTaskEvent {\n  date: TimeStamp\n  type: typeof RumEventType.LONG_TASK\n  long_task: {\n    id: string\n    entry_type: typeof RumLongTaskEntryType.LONG_TASK\n    duration: ServerDuration\n  }\n  _kubesense: {\n    discarded: boolean\n  }\n}\n\nexport type DeliveryType = 'cache' | 'navigational-prefetch' | 'other'\n\nexport type InvokerType =\n  'user-callback' | 'event-listener' | 'resolve-promise' | 'reject-promise' | 'classic-script' | 'module-script'\n\nexport interface RawRumLongAnimationFrameEvent {\n  date: TimeStamp\n  type: typeof RumEventType.LONG_TASK // LoAF are ingested as Long Task\n  long_task: {\n    id: string\n    entry_type: typeof RumLongTaskEntryType.LONG_ANIMATION_FRAME\n    duration: ServerDuration\n    blocking_duration: ServerDuration\n    first_ui_event_timestamp: ServerDuration\n    render_start: ServerDuration\n    style_and_layout_start: ServerDuration\n    start_time: ServerDuration\n    scripts: Array<{\n      duration: ServerDuration\n      pause_duration: ServerDuration\n      forced_style_and_layout_duration: ServerDuration\n      start_time: ServerDuration\n      execution_start: ServerDuration\n      source_url: string\n      source_function_name: string\n      source_char_position: number\n      invoker: string\n      invoker_type: InvokerType\n      window_attribution: string\n    }>\n  }\n  _kubesense: {\n    discarded: boolean\n    debug_ids?: DebugIdEntry[]\n  }\n}\n\nexport interface RawRumActionEvent {\n  date: TimeStamp\n  type: typeof RumEventType.ACTION\n  action: {\n    id: string\n    type: ActionType\n    loading_time?: ServerDuration\n    frustration?: {\n      type: FrustrationType[]\n    }\n    error?: Count\n    long_task?: Count\n    resource?: Count\n    target: {\n      name: string\n    }\n  }\n  view?: {\n    in_foreground: boolean\n  }\n  _kubesense?: {\n    action?: {\n      target?: {\n        selector?: string\n        width?: number\n        height?: number\n        composed_path_selector?: string\n      }\n      name_source?: string\n      position?: {\n        x: number\n        y: number\n      }\n      pointer_up_delay?: Duration\n    }\n  }\n  context?: Context\n}\n\nexport const ActionType = {\n  CLICK: 'click',\n  CUSTOM: 'custom',\n  TAP: 'tap',\n  SCROLL: 'scroll',\n  SWIPE: 'swipe',\n  APPLICATION_START: 'application_start',\n  BACK: 'back',\n} as const\n\nexport type ActionType = (typeof ActionType)[keyof typeof ActionType]\n\nexport const FrustrationType = {\n  RAGE_CLICK: 'rage_click',\n  ERROR_CLICK: 'error_click',\n  DEAD_CLICK: 'dead_click',\n} as const\n\nexport type FrustrationType = (typeof FrustrationType)[keyof typeof FrustrationType]\n\nexport interface RawRumVitalEvent {\n  date: TimeStamp\n  type: typeof RumEventType.VITAL\n  vital: {\n    id: string\n    name: string\n    type: VitalType\n    step_type?: string\n    operation_key?: string\n    failure_reason?: string\n    description?: string\n    duration?: number\n  }\n  _kubesense?: {\n    vital: {\n      computed_value: true\n    }\n  }\n  context?: Context\n}\n\nexport const VitalType = {\n  DURATION: 'duration',\n  OPERATION_STEP: 'operation_step',\n} as const\n\nexport type VitalType = (typeof VitalType)[keyof typeof VitalType]\n\nexport type RawRumEvent =\n  | RawRumErrorEvent\n  | RawRumResourceEvent\n  | RawRumViewEvent\n  | RawRumViewUpdateEvent\n  | RawRumLongTaskEvent\n  | RawRumLongAnimationFrameEvent\n  | RawRumActionEvent\n  | RawRumVitalEvent\n"],"mappings":";AAsBA,MAAa,eAAe;CAC1B,QAAQ;CACR,OAAO;CACP,WAAW;CACX,MAAM;CACN,aAAa;CACb,UAAU;CACV,OAAO;AACT;AASA,MAAa,uBAAuB;CAClC,WAAW;CACX,sBAAsB;AACxB;AA2PA,MAAa,kBAAkB;CAC7B,cAAc;CACd,cAAc;CACd,iBAAiB;CACjB,UAAU;AACZ;AA4GA,MAAa,aAAa;CACxB,OAAO;CACP,QAAQ;CACR,KAAK;CACL,QAAQ;CACR,OAAO;CACP,mBAAmB;CACnB,MAAM;AACR;AAIA,MAAa,kBAAkB;CAC7B,YAAY;CACZ,aAAa;CACb,YAAY;AACd;AAyBA,MAAa,YAAY;CACvB,UAAU;CACV,gBAAgB;AAClB"}

package/esm/transport/formDataTransport.mjs

@@ -0,0 +1,48 @@
+import "../domain/lifeCycle.mjs";
+import { clocksNow } from "@kubesense/kubesense-js-core/time";
+import { DEFAULT_ERROR_TYPE, ErrorSource, addTelemetryDebug, createHttpRequest, jsonStringify, objectEntries } from "@kubesense/kubesense-browser-core";
+import { createEndpointBuilder } from "@kubesense/kubesense-js-core/transport";
+//#region src/transport/formDataTransport.ts
+function createFormDataTransport(configuration, lifeCycle, createEncoder, streamId) {
+	const reportError = (message) => {
+		lifeCycle.notify(15, { error: {
+			message,
+			type: DEFAULT_ERROR_TYPE,
+			source: ErrorSource.AGENT,
+			startClocks: clocksNow()
+		} });
+		addTelemetryDebug("Error reported to customer", { "error.message": message });
+	};
+	const httpRequest = createHttpRequest([createEndpointBuilder(configuration, "profile")], reportError);
+	const encoder = createEncoder(streamId);
+	return { async send({ event, ...attachments }) {
+		const formData = new FormData();
+		const serializedEvent = jsonStringify(event);
+		if (!serializedEvent) throw new Error("Failed to serialize event");
+		formData.append("event", new Blob([serializedEvent], { type: "application/json" }), "event.json");
+		let bytesCount = serializedEvent.length;
+		for (const [key, value] of objectEntries(attachments)) {
+			const serializedValue = jsonStringify(value);
+			if (!serializedValue) throw new Error("Failed to serialize attachment");
+			const result = await encode(encoder, serializedValue);
+			bytesCount += result.outputBytesCount;
+			formData.append(key, new Blob([result.output]), key);
+		}
+		httpRequest.send({
+			data: formData,
+			bytesCount
+		});
+	} };
+}
+function encode(encoder, data) {
+	return new Promise((resolve) => {
+		encoder.write(data);
+		encoder.finish((encoderResult) => {
+			resolve(encoderResult);
+		});
+	});
+}
+//#endregion
+export { createFormDataTransport };
+
+//# sourceMappingURL=formDataTransport.mjs.map

package/esm/transport/formDataTransport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formDataTransport.mjs","names":[],"sources":["../../src/transport/formDataTransport.ts"],"sourcesContent":["import type {\n  Uint8ArrayBuffer,\n  Encoder,\n  EncoderResult,\n  DeflateEncoderStreamId,\n  Context,\n} from '@kubesense/kubesense-browser-core'\nimport {\n  addTelemetryDebug,\n  createHttpRequest,\n  jsonStringify,\n  objectEntries,\n  ErrorSource,\n  DEFAULT_ERROR_TYPE,\n} from '@kubesense/kubesense-browser-core'\nimport { clocksNow } from '@kubesense/kubesense-js-core/time'\nimport { createEndpointBuilder } from '@kubesense/kubesense-js-core/transport'\nimport type { RumConfiguration } from '../domain/configuration'\nimport type { LifeCycle } from '../domain/lifeCycle'\nimport { LifeCycleEventType } from '../domain/lifeCycle'\n\n/**\n * transport payload consist of an event and one or more attachments\n */\nexport interface TransportPayload {\n  event: Context\n  [key: string]: Context\n}\n\nexport interface Transport<T extends TransportPayload> {\n  send: (data: T) => Promise<void>\n}\n\nexport function createFormDataTransport<T extends TransportPayload>(\n  configuration: RumConfiguration,\n  lifeCycle: LifeCycle,\n  createEncoder: (streamId: DeflateEncoderStreamId) => Encoder,\n  streamId: DeflateEncoderStreamId\n) {\n  const reportError = (message: string) => {\n    lifeCycle.notify(LifeCycleEventType.RAW_ERROR_COLLECTED, {\n      error: { message, type: DEFAULT_ERROR_TYPE, source: ErrorSource.AGENT, startClocks: clocksNow() },\n    })\n\n    // monitor-until: forever, to keep an eye on the errors reported to customers\n    addTelemetryDebug('Error reported to customer', { 'error.message': message })\n  }\n\n  const httpRequest = createHttpRequest([createEndpointBuilder(configuration, 'profile')], reportError)\n\n  const encoder = createEncoder(streamId)\n\n  return {\n    async send({ event, ...attachments }: T) {\n      const formData = new FormData()\n      const serializedEvent = jsonStringify(event)\n\n      if (!serializedEvent) {\n        throw new Error('Failed to serialize event')\n      }\n\n      formData.append('event', new Blob([serializedEvent], { type: 'application/json' }), 'event.json')\n\n      let bytesCount = serializedEvent.length\n\n      for (const [key, value] of objectEntries(attachments as Record<string, Context>)) {\n        const serializedValue = jsonStringify(value)\n\n        if (!serializedValue) {\n          throw new Error('Failed to serialize attachment')\n        }\n\n        const result = await encode(encoder, serializedValue)\n\n        bytesCount += result.outputBytesCount\n        formData.append(key, new Blob([result.output]), key)\n      }\n\n      httpRequest.send({\n        data: formData,\n        bytesCount,\n      })\n    },\n  }\n}\n\nfunction encode<T extends string | Uint8ArrayBuffer>(encoder: Encoder<T>, data: string): Promise<EncoderResult<T>> {\n  return new Promise((resolve) => {\n    encoder.write(data)\n\n    encoder.finish((encoderResult) => {\n      resolve(encoderResult)\n    })\n  })\n}\n"],"mappings":";;;;;AAiCA,SAAgB,wBACd,eACA,WACA,eACA,UACA;CACA,MAAM,eAAe,YAAoB;EACvC,UAAU,OAAA,IAA+C,EACvD,OAAO;GAAE;GAAS,MAAM;GAAoB,QAAQ,YAAY;GAAO,aAAa,UAAU;EAAE,EAClG,CAAC;EAGD,kBAAkB,8BAA8B,EAAE,iBAAiB,QAAQ,CAAC;CAC9E;CAEA,MAAM,cAAc,kBAAkB,CAAC,sBAAsB,eAAe,SAAS,CAAC,GAAG,WAAW;CAEpG,MAAM,UAAU,cAAc,QAAQ;CAEtC,OAAO,EACL,MAAM,KAAK,EAAE,OAAO,GAAG,eAAkB;EACvC,MAAM,WAAW,IAAI,SAAS;EAC9B,MAAM,kBAAkB,cAAc,KAAK;EAE3C,IAAI,CAAC,iBACH,MAAM,IAAI,MAAM,2BAA2B;EAG7C,SAAS,OAAO,SAAS,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,MAAM,mBAAmB,CAAC,GAAG,YAAY;EAEhG,IAAI,aAAa,gBAAgB;EAEjC,KAAK,MAAM,CAAC,KAAK,UAAU,cAAc,WAAsC,GAAG;GAChF,MAAM,kBAAkB,cAAc,KAAK;GAE3C,IAAI,CAAC,iBACH,MAAM,IAAI,MAAM,gCAAgC;GAGlD,MAAM,SAAS,MAAM,OAAO,SAAS,eAAe;GAEpD,cAAc,OAAO;GACrB,SAAS,OAAO,KAAK,IAAI,KAAK,CAAC,OAAO,MAAM,CAAC,GAAG,GAAG;EACrD;EAEA,YAAY,KAAK;GACf,MAAM;GACN;EACF,CAAC;CACH,EACF;AACF;AAEA,SAAS,OAA4C,SAAqB,MAAyC;CACjH,OAAO,IAAI,SAAS,YAAY;EAC9B,QAAQ,MAAM,IAAI;EAElB,QAAQ,QAAQ,kBAAkB;GAChC,QAAQ,aAAa;EACvB,CAAC;CACH,CAAC;AACH"}

package/esm/transport/startRumBatch.mjs

@@ -0,0 +1,132 @@
+import { RumEventType } from "../rawRumEvent.types.mjs";
+import "../domain/lifeCycle.mjs";
+import { diffMerge } from "../domain/view/viewDiff.mjs";
+import { combine } from "@kubesense/kubesense-js-core/util";
+import { DeflateEncoderStreamId, createBatch, sendToExtension } from "@kubesense/kubesense-browser-core";
+import { createEndpointBuilder, createReplicaEndpointBuilder } from "@kubesense/kubesense-js-core/transport";
+function computeAssembledViewDiff(current, last) {
+	const diff = diffMerge(current, last, {
+		replaceKeys: /* @__PURE__ */ new Set([
+			"view.custom_timings",
+			"context",
+			"connectivity",
+			"usr",
+			"device",
+			"privacy"
+		]),
+		appendKeys: /* @__PURE__ */ new Set(["_kubesense.page_states"]),
+		ignoreKeys: /* @__PURE__ */ new Set([
+			"date",
+			"type",
+			"application",
+			"session",
+			"view.id",
+			"view.url",
+			"_kubesense.document_version",
+			"_kubesense.format_version"
+		])
+	});
+	if (!diff) return;
+	return combine(diff, {
+		type: RumEventType.VIEW_UPDATE,
+		date: current.date,
+		application: current.application,
+		session: current.session,
+		view: {
+			id: current.view.id,
+			url: current.view.url
+		},
+		_kubesense: {
+			document_version: current._kubesense.document_version,
+			format_version: current._kubesense.format_version
+		}
+	});
+}
+/**
+* Dispatches assembled RUM events to the batch. VIEW events are handled specially:
+* intermediate updates either replace the full VIEW already in the batch, or are
+* aggregated into a single view_update diff against the last flushed state.
+*/
+function createBatchDispatcher(batch, enableViewUpdates) {
+	let lastSentView;
+	let batchBase;
+	let batchHasFullView = false;
+	let viewUpdatesSinceCheckpoint = 0;
+	const { unsubscribe } = batch.flushObservable.subscribe(() => {
+		batchHasFullView = false;
+		batchBase = lastSentView;
+	});
+	return {
+		dispatch: (serverRumEvent) => {
+			if (serverRumEvent.type !== RumEventType.VIEW) {
+				batch.add(serverRumEvent);
+				return;
+			}
+			if (!enableViewUpdates) {
+				batch.upsert(serverRumEvent, serverRumEvent.view.id);
+				return;
+			}
+			const viewId = serverRumEvent.view.id;
+			if (!serverRumEvent.view.is_active) {
+				if (viewId === lastSentView?.view.id) {
+					lastSentView = void 0;
+					batchBase = void 0;
+					batchHasFullView = false;
+					viewUpdatesSinceCheckpoint = 0;
+				}
+				batch.upsert(serverRumEvent, viewId);
+				return;
+			}
+			if (viewId !== lastSentView?.view.id) {
+				viewUpdatesSinceCheckpoint = 0;
+				batch.upsert(serverRumEvent, viewId);
+				lastSentView = serverRumEvent;
+				batchHasFullView = !batch.isEmpty;
+				return;
+			}
+			lastSentView = serverRumEvent;
+			if (batchHasFullView) {
+				batch.upsert(serverRumEvent, viewId);
+				return;
+			}
+			viewUpdatesSinceCheckpoint += 1;
+			if (viewUpdatesSinceCheckpoint >= 100) {
+				viewUpdatesSinceCheckpoint = 0;
+				batch.upsert(serverRumEvent, viewId);
+				batchHasFullView = !batch.isEmpty;
+				return;
+			}
+			if (batchBase) {
+				const diff = computeAssembledViewDiff(serverRumEvent, batchBase);
+				if (diff) {
+					sendToExtension("rum", diff);
+					batch.upsert(diff, viewId);
+				}
+			}
+		},
+		stop: unsubscribe
+	};
+}
+function startRumBatch(configuration, lifeCycle, reportError, sessionExpireObservable, createEncoder) {
+	const endpoints = [createEndpointBuilder(configuration, "rum")];
+	const replicaEndpoint = createReplicaEndpointBuilder(configuration, "rum");
+	if (replicaEndpoint) endpoints.push(replicaEndpoint);
+	const batch = createBatch({
+		encoder: createEncoder(DeflateEncoderStreamId.RUM),
+		endpoints,
+		reportError
+	});
+	sessionExpireObservable.subscribe(() => batch.forceFlush("session_expire"));
+	const { dispatch, stop: stopDispatcher } = createBatchDispatcher(batch, configuration.betaEnableViewUpdates);
+	lifeCycle.subscribe(14, dispatch);
+	const stopBatch = batch.stop.bind(batch);
+	batch.stop = () => {
+		stopDispatcher();
+		stopBatch();
+	};
+	return batch;
+}
+//#endregion
+export { computeAssembledViewDiff, createBatchDispatcher, startRumBatch };
+
+//# sourceMappingURL=startRumBatch.mjs.map

package/esm/transport/startRumBatch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRumBatch.mjs","names":[],"sources":["../../src/transport/startRumBatch.ts"],"sourcesContent":["import type { Observable, Encoder, Context } from '@kubesense/kubesense-browser-core'\nimport { createBatch, DeflateEncoderStreamId, sendToExtension } from '@kubesense/kubesense-browser-core'\nimport { combine } from '@kubesense/kubesense-js-core/util'\nimport { createEndpointBuilder, createReplicaEndpointBuilder } from '@kubesense/kubesense-js-core/transport'\nimport type { RumConfiguration } from '../domain/configuration'\nimport type { LifeCycle } from '../domain/lifeCycle'\nimport { LifeCycleEventType } from '../domain/lifeCycle'\nimport type { AssembledRumEvent } from '../rawRumEvent.types'\nimport type { RumViewEvent, RumViewUpdateEvent } from '../rumEvent.types'\nimport { RumEventType } from '../rawRumEvent.types'\nimport { diffMerge } from '../domain/view/viewDiff'\n\nexport const PARTIAL_VIEW_UPDATE_CHECKPOINT_INTERVAL = 100\n\nexport type AssembledViewDiff = Omit<RumViewUpdateEvent, 'view' | '_kubesense'> & {\n  view: Partial<RumViewEvent['view']> & { id: string; url: string }\n  _kubesense?: { document_version: number; format_version: number; [k: string]: unknown }\n}\n\nexport function computeAssembledViewDiff(current: RumViewEvent, last: RumViewEvent): AssembledViewDiff | undefined {\n  const diff = diffMerge(current, last, {\n    // context, connectivity, usr, device, privacy are objects — use REPLACE to avoid partial updates\n    replaceKeys: new Set(['view.custom_timings', 'context', 'connectivity', 'usr', 'device', 'privacy']),\n    appendKeys: new Set(['_kubesense.page_states']),\n    // Ignore always-required fields — they are added back via combine regardless of changes\n    ignoreKeys: new Set([\n      'date',\n      'type',\n      'application',\n      'session',\n      'view.id',\n      'view.url',\n      '_kubesense.document_version',\n      '_kubesense.format_version',\n    ]),\n  })\n\n  if (!diff) {\n    return undefined\n  }\n\n  // Merge always-required fields on top of the diff for backend routing\n  return combine(diff, {\n    type: RumEventType.VIEW_UPDATE,\n    date: current.date,\n    application: current.application,\n    session: current.session,\n    view: {\n      id: current.view.id,\n      url: current.view.url,\n    },\n    _kubesense: {\n      document_version: current._kubesense.document_version,\n      format_version: current._kubesense.format_version,\n    },\n  })\n}\n\n/**\n * Dispatches assembled RUM events to the batch. VIEW events are handled specially:\n * intermediate updates either replace the full VIEW already in the batch, or are\n * aggregated into a single view_update diff against the last flushed state.\n */\nexport function createBatchDispatcher(\n  batch: Pick<ReturnType<typeof createBatch>, 'flushObservable' | 'isEmpty' | 'add' | 'upsert'>,\n  enableViewUpdates: boolean\n): { dispatch: (event: AssembledRumEvent) => void; stop: () => void } {\n  let lastSentView: RumViewEvent | undefined\n  // Base used to compute the aggregate diff for the current batch's view_update.\n  // Reset to lastSentView on each flush (= what the backend received in the previous batch).\n  let batchBase: RumViewEvent | undefined\n  // True when the current batch already contains a full VIEW event for the active view.\n  // Reset to false on each flush.\n  let batchHasFullView = false\n  let viewUpdatesSinceCheckpoint = 0\n\n  // On flush: advance batchBase to lastSentView (what the backend now has) and clear the flag.\n  // lastSentView is set AFTER batch.upsert() in the new-view and checkpoint paths so that if\n  // upsert() triggers a sync flush, the subscriber captures the previous view (what the backend\n  // actually received), not the one being added.\n  const { unsubscribe } = batch.flushObservable.subscribe(() => {\n    batchHasFullView = false\n    batchBase = lastSentView\n  })\n\n  return {\n    dispatch: (serverRumEvent: AssembledRumEvent) => {\n      if (serverRumEvent.type !== RumEventType.VIEW) {\n        // Non-view events: always append\n        batch.add(serverRumEvent)\n        return\n      }\n\n      if (!enableViewUpdates) {\n        // Feature OFF: existing behavior — upsert full view\n        batch.upsert(serverRumEvent, serverRumEvent.view.id)\n        return\n      }\n\n      const viewId = serverRumEvent.view.id\n\n      // View ended (is_active: false) — always send a full VIEW.\n      // Checked before the new-view guard so that a stale view-end for an old view\n      // (arriving after a new view has already started) is handled correctly: we upsert\n      // it without touching the state of the current view.\n      if (!serverRumEvent.view.is_active) {\n        if (viewId === lastSentView?.view.id) {\n          // Current view ended — reset all state\n          lastSentView = undefined\n          batchBase = undefined\n          batchHasFullView = false\n          viewUpdatesSinceCheckpoint = 0\n        }\n        batch.upsert(serverRumEvent, viewId)\n        return\n      }\n\n      // New view started\n      if (viewId !== lastSentView?.view.id) {\n        viewUpdatesSinceCheckpoint = 0\n        batch.upsert(serverRumEvent, viewId)\n        // lastSentView set AFTER upsert: if upsert triggers a sync flush, the subscriber\n        // captures the old lastSentView as batchBase (what the backend actually received),\n        // not the new view that hasn't been sent yet.\n        lastSentView = serverRumEvent\n        // If upsert triggered an after-add flush (e.g. messages_limit), the VIEW was sent\n        // and the batch is now empty — isEmpty is true. Otherwise the VIEW is in the batch.\n        batchHasFullView = !batch.isEmpty\n        return\n      }\n\n      // Intermediate update\n      lastSentView = serverRumEvent\n\n      if (batchHasFullView) {\n        // Optimization 1: batch already has a full VIEW — replace it with the latest full view.\n        // This is equivalent to the non-experimental upsert behavior for in-flight batches.\n        batch.upsert(serverRumEvent, viewId)\n        return\n      }\n\n      // Optimization 2: no full VIEW in the current batch — compute an aggregate diff from\n      // batchBase (last state the backend received) and upsert it under the same key as the VIEW.\n      // Each update replaces the previous aggregate, so the batch always contains at most one\n      // view_update per view ID.\n      //\n      // Note: view_update events are created here, post-assembly, bypassing\n      // RAW_RUM_EVENT_COLLECTED → assembly → RUM_EVENT_COLLECTED. They intentionally skip\n      // beforeSend — view_update is an internal bandwidth optimization, not a customer-visible type.\n\n      // Checkpoint: periodically send a full VIEW for backend reliability.\n      // When the checkpoint fires, upsert(VIEW) replaces any pending view_update (same key).\n      viewUpdatesSinceCheckpoint += 1\n      if (viewUpdatesSinceCheckpoint >= PARTIAL_VIEW_UPDATE_CHECKPOINT_INTERVAL) {\n        viewUpdatesSinceCheckpoint = 0\n        batch.upsert(serverRumEvent, viewId)\n        batchHasFullView = !batch.isEmpty\n        return\n      }\n\n      if (batchBase) {\n        const diff = computeAssembledViewDiff(serverRumEvent, batchBase)\n        if (diff) {\n          sendToExtension('rum', diff)\n          batch.upsert(diff as unknown as Context, viewId)\n        }\n      }\n    },\n    stop: unsubscribe,\n  }\n}\n\nexport function startRumBatch(\n  configuration: RumConfiguration,\n  lifeCycle: LifeCycle,\n  reportError: (message: string) => void,\n  sessionExpireObservable: Observable<void>,\n  createEncoder: (streamId: DeflateEncoderStreamId) => Encoder\n) {\n  const endpoints = [createEndpointBuilder(configuration, 'rum')]\n  const replicaEndpoint = createReplicaEndpointBuilder(configuration, 'rum')\n  if (replicaEndpoint) {\n    endpoints.push(replicaEndpoint)\n  }\n\n  const batch = createBatch({\n    encoder: createEncoder(DeflateEncoderStreamId.RUM),\n    endpoints,\n    reportError,\n  })\n  sessionExpireObservable.subscribe(() => batch.forceFlush('session_expire'))\n\n  const { dispatch, stop: stopDispatcher } = createBatchDispatcher(batch, configuration.betaEnableViewUpdates)\n  lifeCycle.subscribe(LifeCycleEventType.RUM_EVENT_COLLECTED, dispatch)\n\n  const stopBatch = batch.stop.bind(batch)\n  batch.stop = () => {\n    stopDispatcher()\n    stopBatch()\n  }\n\n  return batch\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,yBAAyB,SAAuB,MAAmD;CACjH,MAAM,OAAO,UAAU,SAAS,MAAM;EAEpC,6BAAa,IAAI,IAAI;GAAC;GAAuB;GAAW;GAAgB;GAAO;GAAU;EAAS,CAAC;EACnG,4BAAY,IAAI,IAAI,CAAC,wBAAwB,CAAC;EAE9C,4BAAY,IAAI,IAAI;GAClB;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;CACH,CAAC;CAED,IAAI,CAAC,MACH;CAIF,OAAO,QAAQ,MAAM;EACnB,MAAM,aAAa;EACnB,MAAM,QAAQ;EACd,aAAa,QAAQ;EACrB,SAAS,QAAQ;EACjB,MAAM;GACJ,IAAI,QAAQ,KAAK;GACjB,KAAK,QAAQ,KAAK;EACpB;EACA,YAAY;GACV,kBAAkB,QAAQ,WAAW;GACrC,gBAAgB,QAAQ,WAAW;EACrC;CACF,CAAC;AACH;;;;;;AAOA,SAAgB,sBACd,OACA,mBACoE;CACpE,IAAI;CAGJ,IAAI;CAGJ,IAAI,mBAAmB;CACvB,IAAI,6BAA6B;CAMjC,MAAM,EAAE,gBAAgB,MAAM,gBAAgB,gBAAgB;EAC5D,mBAAmB;EACnB,YAAY;CACd,CAAC;CAED,OAAO;EACL,WAAW,mBAAsC;GAC/C,IAAI,eAAe,SAAS,aAAa,MAAM;IAE7C,MAAM,IAAI,cAAc;IACxB;GACF;GAEA,IAAI,CAAC,mBAAmB;IAEtB,MAAM,OAAO,gBAAgB,eAAe,KAAK,EAAE;IACnD;GACF;GAEA,MAAM,SAAS,eAAe,KAAK;GAMnC,IAAI,CAAC,eAAe,KAAK,WAAW;IAClC,IAAI,WAAW,cAAc,KAAK,IAAI;KAEpC,eAAe,KAAA;KACf,YAAY,KAAA;KACZ,mBAAmB;KACnB,6BAA6B;IAC/B;IACA,MAAM,OAAO,gBAAgB,MAAM;IACnC;GACF;GAGA,IAAI,WAAW,cAAc,KAAK,IAAI;IACpC,6BAA6B;IAC7B,MAAM,OAAO,gBAAgB,MAAM;IAInC,eAAe;IAGf,mBAAmB,CAAC,MAAM;IAC1B;GACF;GAGA,eAAe;GAEf,IAAI,kBAAkB;IAGpB,MAAM,OAAO,gBAAgB,MAAM;IACnC;GACF;GAaA,8BAA8B;GAC9B,IAAI,8BAAA,KAAuE;IACzE,6BAA6B;IAC7B,MAAM,OAAO,gBAAgB,MAAM;IACnC,mBAAmB,CAAC,MAAM;IAC1B;GACF;GAEA,IAAI,WAAW;IACb,MAAM,OAAO,yBAAyB,gBAAgB,SAAS;IAC/D,IAAI,MAAM;KACR,gBAAgB,OAAO,IAAI;KAC3B,MAAM,OAAO,MAA4B,MAAM;IACjD;GACF;EACF;EACA,MAAM;CACR;AACF;AAEA,SAAgB,cACd,eACA,WACA,aACA,yBACA,eACA;CACA,MAAM,YAAY,CAAC,sBAAsB,eAAe,KAAK,CAAC;CAC9D,MAAM,kBAAkB,6BAA6B,eAAe,KAAK;CACzE,IAAI,iBACF,UAAU,KAAK,eAAe;CAGhC,MAAM,QAAQ,YAAY;EACxB,SAAS,cAAc,uBAAuB,GAAG;EACjD;EACA;CACF,CAAC;CACD,wBAAwB,gBAAgB,MAAM,WAAW,gBAAgB,CAAC;CAE1E,MAAM,EAAE,UAAU,MAAM,mBAAmB,sBAAsB,OAAO,cAAc,qBAAqB;CAC3G,UAAU,UAAA,IAAkD,QAAQ;CAEpE,MAAM,YAAY,MAAM,KAAK,KAAK,KAAK;CACvC,MAAM,aAAa;EACjB,eAAe;EACf,UAAU;CACZ;CAEA,OAAO;AACT"}

package/esm/transport/startRumEventBridge.mjs

@@ -0,0 +1,13 @@
+import "../domain/lifeCycle.mjs";
+import { getEventBridge } from "@kubesense/kubesense-browser-core";
+//#region src/transport/startRumEventBridge.ts
+function startRumEventBridge(lifeCycle) {
+	const bridge = getEventBridge();
+	lifeCycle.subscribe(14, (serverRumEvent) => {
+		bridge.send("rum", serverRumEvent);
+	});
+}
+//#endregion
+export { startRumEventBridge };
+
+//# sourceMappingURL=startRumEventBridge.mjs.map

package/esm/transport/startRumEventBridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRumEventBridge.mjs","names":[],"sources":["../../src/transport/startRumEventBridge.ts"],"sourcesContent":["import { getEventBridge } from '@kubesense/kubesense-browser-core'\nimport type { LifeCycle } from '../domain/lifeCycle'\nimport { LifeCycleEventType } from '../domain/lifeCycle'\nimport type { RumEvent } from '../rumEvent.types'\n\nexport function startRumEventBridge(lifeCycle: LifeCycle) {\n  const bridge = getEventBridge<'rum', RumEvent>()!\n\n  lifeCycle.subscribe(LifeCycleEventType.RUM_EVENT_COLLECTED, (serverRumEvent) => {\n    bridge.send('rum', serverRumEvent)\n  })\n}\n"],"mappings":";;;AAKA,SAAgB,oBAAoB,WAAsB;CACxD,MAAM,SAAS,eAAgC;CAE/C,UAAU,UAAA,KAAmD,mBAAmB;EAC9E,OAAO,KAAK,OAAO,cAAc;CACnC,CAAC;AACH"}

package/package.json

@@ -1,8 +1,6 @@
 {
   "name": "@kubesense/kubesense-browser-rum-core",
-  "version": "1.8.0",
-  "description": "Shared RUM event-collection logic for the Kubesense Browser SDK (consumed by the rum and rum-slim packages).",
-  "license": "Apache-2.0",
+  "version": "2.0.0-beta.1",
   "keywords": [
     "kubesense",
     "browser",
@@ -12,21 +10,32 @@
     "observability",
     "core"
   ],
+  "description": "Shared RUM event-collection logic for the Kubesense Browser SDK (consumed by the rum and rum-slim packages).",
+  "license": "Apache-2.0",
   "main": "cjs/index.js",
-  "module": "esm/index.js",
+  "module": "esm/index.mjs",
   "types": "cjs/index.d.ts",
+  "files": [
+    "cjs",
+    "esm",
+    "src",
+    "!src/**/*.spec.ts",
+    "!src/**/*.specHelper.ts"
+  ],
   "scripts": {
-    "build": "node ../../scripts/build/build-package.ts --modules"
+    "build": "node ../../scripts/build/build-package.ts --modules",
+    "prepack": "yarn build"
   },
   "dependencies": {
-    "@kubesense/kubesense-browser-core": "1.8.0"
+    "@kubesense/kubesense-browser-core": "2.0.0-beta.1",
+    "@kubesense/kubesense-js-core": "2.0.0-beta.1"
   },
   "devDependencies": {
-    "ajv": "8.17.1"
+    "ajv": "8.20.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/kubesense-ai/kubesense-browser-sdk.git",
+    "url": "git+https://github.com/kubesense-ai/kubesense-browser-sdk.git",
     "directory": "packages/rum-core"
   },
   "volta": {
@@ -34,6 +43,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "gitHead": "2f848090fb06a6f220ea3349c2eb8a18e0d8c390"
-}
+  }
+}