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

package/esm/boot/preStartRum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preStartRum.mjs","names":[],"sources":["../../src/boot/preStartRum.ts"],"sourcesContent":["import { isWorkerEnvironment } from '@kubesense/kubesense-js-core/util'\nimport { timeStampNow, clocksNow } from '@kubesense/kubesense-js-core/time'\nimport { monitorError } from '@kubesense/kubesense-js-core/monitor'\nimport type { TimeStamp } from '@kubesense/kubesense-js-core/time'\nimport type {\n  TrackingConsentState,\n  DeflateWorker,\n  Context,\n  Telemetry,\n  SessionManager,\n} from '@kubesense/kubesense-browser-core'\nimport {\n  BufferedObservable,\n  display,\n  canUseEventBridge,\n  displayAlreadyInitializedError,\n  willSyntheticsInjectRum,\n  noop,\n  getEventBridge,\n  initFeatureFlags,\n  addTelemetryConfiguration,\n  CustomerContextKey,\n  buildAccountContextManager,\n  buildGlobalContextManager,\n  buildUserContextManager,\n  bufferContextCalls,\n  sanitize,\n  startSessionManager,\n  startSessionManagerStub,\n  startTelemetry,\n  TelemetryService,\n  mockable,\n  startTelemetrySessionContext,\n  addTelemetryDebug,\n  setAllowUntrustedEvents,\n  isAllowedTrackingOrigins,\n} from '@kubesense/kubesense-browser-core'\nimport type { Hooks } from '../domain/hooks'\nimport { createHooks } from '../domain/hooks'\nimport type { RemoteConfigurationMetadata, RumConfiguration, RumInitConfiguration } from '../domain/configuration'\n\nimport {\n  fetchAndApplyRemoteConfiguration,\n  getRemoteConfiguration,\n  getRemoteConfigurationId,\n  validateAndBuildRumConfiguration,\n  serializeRumConfiguration,\n  applyCachedSdkConfiguration,\n  scheduleSdkConfigurationRefresh,\n} from '../domain/configuration'\nimport type { ViewOptions } from '../domain/view/trackViews'\nimport type { OperationOptions, FailureReason } from '../domain/vital/vitalCollection'\nimport { callPluginsOnInit } from '../domain/plugins'\nimport { startTrackingConsentContext } from '../domain/contexts/trackingConsentContext'\nimport type { StartRumResult } from './startRum'\nimport type { RumPublicApiOptions, Strategy } from './rumPublicApi'\n\nexport type DoStartRum = (\n  configuration: RumConfiguration,\n  sessionManager: SessionManager,\n  deflateWorker: DeflateWorker | undefined,\n  initialViewOptions: ViewOptions | undefined,\n  telemetry: Telemetry,\n  hooks: Hooks\n) => StartRumResult\n\nexport function createPreStartStrategy(\n  { ignoreInitIfSyntheticsWillInjectRum = true, startDeflateWorker, sdkName }: RumPublicApiOptions,\n  trackingConsentState: TrackingConsentState,\n  doStartRum: DoStartRum\n): Strategy {\n  const BUFFER_LIMIT = 500\n  const bufferApiCalls = new BufferedObservable<(startRumResult: StartRumResult) => void>(BUFFER_LIMIT, (count) => {\n    // monitor-until: 2026-10-14\n    addTelemetryDebug('preStartRum buffer data lost', { count })\n  })\n\n  // TODO next major: remove the globalContextManager, userContextManager and accountContextManager from preStartStrategy and use an empty context instead\n  const globalContext = buildGlobalContextManager()\n  bufferContextCalls(globalContext, CustomerContextKey.globalContext, bufferApiCalls)\n\n  const userContext = buildUserContextManager()\n  bufferContextCalls(userContext, CustomerContextKey.userContext, bufferApiCalls)\n\n  const accountContext = buildAccountContextManager()\n  bufferContextCalls(accountContext, CustomerContextKey.accountContext, bufferApiCalls)\n\n  let firstStartViewCall:\n    { options: ViewOptions | undefined; callback: (startRumResult: StartRumResult) => void } | undefined\n  let deflateWorker: DeflateWorker | undefined\n\n  let cachedInitConfiguration: RumInitConfiguration | undefined\n  let cachedConfiguration: RumConfiguration | undefined\n  let sessionManager: SessionManager | undefined\n  let telemetry: Telemetry | undefined\n  const hooks = createHooks()\n\n  const trackingConsentStateSubscription = trackingConsentState.observable.subscribe(tryStartRum)\n\n  const emptyContext: Context = {}\n\n  let started = false\n\n  function tryStartRum() {\n    if (started || !cachedInitConfiguration || !cachedConfiguration || !sessionManager || !telemetry) {\n      return\n    }\n\n    trackingConsentStateSubscription.unsubscribe()\n\n    let initialViewOptions: ViewOptions | undefined\n\n    if (cachedConfiguration.trackViewsManually) {\n      if (!firstStartViewCall) {\n        return\n      }\n      // An initial view is always created when starting RUM.\n      // When tracking views automatically, any startView call before RUM start creates an extra\n      // view.\n      // When tracking views manually, we use the ViewOptions from the first startView call as the\n      // initial view options, and we skip the actual startView callback so we don't create an extra\n      // view.\n      initialViewOptions = firstStartViewCall.options\n    }\n\n    const callbackToSkip = cachedConfiguration.trackViewsManually ? firstStartViewCall?.callback : undefined\n\n    const startRumResult = doStartRum(\n      cachedConfiguration,\n      sessionManager,\n      deflateWorker,\n      initialViewOptions,\n      telemetry,\n      hooks\n    )\n\n    started = true\n\n    bufferApiCalls.subscribe((callback) => {\n      if (callback !== callbackToSkip) {\n        callback(startRumResult)\n      }\n    })\n    bufferApiCalls.unbuffer()\n  }\n\n  function doInit(\n    initConfiguration: RumInitConfiguration,\n    errorStack?: string,\n    remoteConfigurationMetadata?: RemoteConfigurationMetadata\n  ) {\n    const eventBridgeAvailable = canUseEventBridge()\n    if (eventBridgeAvailable) {\n      initConfiguration = overrideInitConfigurationForBridge(initConfiguration)\n    }\n\n    const remoteSdkConfigurationEnabled = !!initConfiguration.enableRemoteSdkConfiguration\n\n    // A cached document that stops the SDK from starting must never be a one-way door: without a\n    // refresh on those paths the browser replays the same bad document on every load and can never\n    // learn about a corrected one. This covers a `features.rum: false` switch, an\n    // `allowedTrackingOrigins` list that no longer matches this origin, and settings that fail\n    // validation.\n    const refreshRemoteSdkConfiguration = () => {\n      if (remoteSdkConfigurationEnabled) {\n        scheduleSdkConfigurationRefresh(initConfiguration).catch(monitorError)\n      }\n    }\n\n    if (remoteSdkConfigurationEnabled) {\n      // Reading the cached document is synchronous and network-free, so it does not delay\n      // initialization. The document fetched below only applies from the next page load.\n      const cachedSdkConfiguration = applyCachedSdkConfiguration(initConfiguration, { globalContext, userContext })\n      initConfiguration = cachedSdkConfiguration.initConfiguration\n\n      if (!cachedSdkConfiguration.rumEnabled) {\n        // RUM is switched off from the dashboard. Still refresh the document, otherwise the\n        // switch would be one-way: the SDK could never learn that it has been turned back on.\n        cachedInitConfiguration = initConfiguration\n        refreshRemoteSdkConfiguration()\n        return\n      }\n    }\n\n    // Update the exposed initConfiguration to reflect the bridge and remote configuration overrides\n    cachedInitConfiguration = initConfiguration\n\n    if (cachedConfiguration) {\n      displayAlreadyInitializedError('KUBESENSE_SDK', initConfiguration)\n      return\n    }\n\n    const configuration = validateAndBuildRumConfiguration(initConfiguration, sdkName)\n    if (!configuration || !isAllowedTrackingOrigins(configuration, errorStack ?? '')) {\n      refreshRemoteSdkConfiguration()\n      return\n    }\n\n    if (configuration.compressIntakeRequests && !eventBridgeAvailable && startDeflateWorker) {\n      deflateWorker = startDeflateWorker(\n        configuration,\n        'KubeSense RUM',\n        // Worker initialization can fail asynchronously, especially in Firefox where even CSP\n        // issues are reported asynchronously. For now, the SDK will continue its execution even if\n        // data won't be sent to KubeSense. We could improve this behavior in the future.\n        noop\n      )\n      if (!deflateWorker) {\n        // `startDeflateWorker` should have logged an error message explaining the issue\n        refreshRemoteSdkConfiguration()\n        return\n      }\n    }\n\n    cachedConfiguration = configuration\n\n    trackingConsentState.tryToInit(configuration.trackingConsent)\n\n    trackingConsentState.onGrantedOnce(() => {\n      const { assembleTelemetry: assembleTelemetryHook } = hooks\n      startTrackingConsentContext(assembleTelemetryHook, trackingConsentState)\n      telemetry = mockable(startTelemetry)(TelemetryService.RUM, configuration, assembleTelemetryHook, sdkName)\n\n      if (isWorkerEnvironment) {\n        display.warn('The RUM SDK is not supported in a web or service worker environment.')\n        return\n      }\n\n      const sessionManagerPromise = canUseEventBridge()\n        ? startSessionManagerStub()\n        : mockable(startSessionManager)(configuration, trackingConsentState)\n\n      void sessionManagerPromise\n        .then((newSessionManager) => {\n          if (!newSessionManager) {\n            return\n          }\n          sessionManager = newSessionManager\n          startTelemetrySessionContext(assembleTelemetryHook, sessionManager, {\n            application: { id: configuration.applicationId },\n          })\n          addTelemetryConfiguration(serializeRumConfiguration(initConfiguration, sdkName, remoteConfigurationMetadata))\n\n          tryStartRum()\n\n          // Fire-and-forget, after the SDK is running: refreshes the cache for the next page load.\n          refreshRemoteSdkConfiguration()\n        })\n        .catch(monitorError)\n    })\n  }\n\n  const addOperationStepVital = (\n    name: string,\n    stepType: 'start' | 'end',\n    options?: OperationOptions,\n    failureReason?: FailureReason\n  ) => {\n    bufferApiCalls.notify((startRumResult) =>\n      startRumResult.addOperationStepVital(\n        sanitize(name)!,\n        stepType,\n        sanitize(options) as OperationOptions,\n        sanitize(failureReason) as FailureReason | undefined\n      )\n    )\n  }\n\n  const strategy: Strategy = {\n    init(initConfiguration, publicApi, errorStack) {\n      if (!initConfiguration) {\n        display.error('Missing configuration')\n        return\n      }\n      // Set the experimental feature flags as early as possible, so we can use them in most places\n      initFeatureFlags(initConfiguration.enableExperimentalFeatures)\n      setAllowUntrustedEvents(initConfiguration.allowUntrustedEvents)\n\n      // Expose the initial configuration regardless of initialization success.\n      cachedInitConfiguration = initConfiguration\n\n      // If we are in a Synthetics test configured to automatically inject a RUM instance, we want\n      // to completely discard the customer application RUM instance by ignoring their init() call.\n      // But, we should not ignore the init() call from the Synthetics-injected RUM instance, so the\n      // internal `ignoreInitIfSyntheticsWillInjectRum` option is here to bypass this condition.\n      if (ignoreInitIfSyntheticsWillInjectRum && willSyntheticsInjectRum()) {\n        return\n      }\n\n      const shouldContinue = callPluginsOnInit(initConfiguration.plugins, {\n        initConfiguration,\n        publicApi,\n        registerAssembleEventHook: hooks.assembleEvent.register,\n      })\n\n      if (typeof shouldContinue === 'boolean') {\n        if (shouldContinue) {\n          proceedWithInit()\n        }\n      } else {\n        shouldContinue\n          .then((result) => {\n            if (result) {\n              proceedWithInit()\n            }\n          })\n          .catch(monitorError)\n      }\n\n      function proceedWithInit() {\n        const hasRemoteConfiguration = getRemoteConfigurationId(initConfiguration)\n\n        if (hasRemoteConfiguration) {\n          const supportedContextManagers = { user: userContext, context: globalContext }\n          const isSyncLoading =\n            !!initConfiguration.remoteConfigurationId || !!initConfiguration.remoteConfiguration?.sync\n\n          if (isSyncLoading) {\n            fetchAndApplyRemoteConfiguration(initConfiguration, supportedContextManagers)\n              .then((resolvedInitConfiguration) => {\n                if (resolvedInitConfiguration) {\n                  doInit(resolvedInitConfiguration, errorStack)\n                }\n              })\n              .catch(monitorError)\n          } else {\n            const resolvedRemoteConfiguration = getRemoteConfiguration(initConfiguration, supportedContextManagers)\n\n            if (resolvedRemoteConfiguration) {\n              doInit(resolvedRemoteConfiguration.initConfiguration, errorStack, resolvedRemoteConfiguration.metadata)\n            }\n          }\n        } else {\n          doInit(initConfiguration, errorStack)\n        }\n      }\n    },\n\n    get initConfiguration() {\n      return cachedInitConfiguration\n    },\n\n    getInternalContext: noop as () => undefined,\n\n    stopSession: noop,\n\n    addTiming(name, time = timeStampNow()) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.addTiming(name, time))\n    },\n\n    setLoadingTime: ((callTimestamp: TimeStamp) => {\n      bufferApiCalls.notify((startRumResult) => startRumResult.setLoadingTime(callTimestamp))\n    }) as Strategy['setLoadingTime'],\n\n    startView(options, startClocks = clocksNow()) {\n      const callback = (startRumResult: StartRumResult) => {\n        startRumResult.startView(options, startClocks)\n      }\n      bufferApiCalls.notify(callback)\n\n      if (!firstStartViewCall) {\n        firstStartViewCall = { options, callback }\n        tryStartRum()\n      }\n    },\n\n    setViewName(name) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.setViewName(name))\n    },\n\n    // View context APIs\n\n    setViewContext(context) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.setViewContext(context))\n    },\n\n    setViewContextProperty(key, value) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.setViewContextProperty(key, value))\n    },\n\n    getViewContext: () => emptyContext,\n\n    globalContext,\n    userContext,\n    accountContext,\n\n    addAction(action) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.addAction(action))\n    },\n\n    startAction(name, options) {\n      const startClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.startAction(name, options, startClocks))\n    },\n\n    stopAction(name, options) {\n      const stopClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.stopAction(name, options, stopClocks))\n    },\n\n    startResource(url, options) {\n      const startClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.startResource(url, options, startClocks))\n    },\n\n    stopResource(url, options) {\n      const stopClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.stopResource(url, options, stopClocks))\n    },\n\n    addError(providedError) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.addError(providedError))\n    },\n\n    addFeatureFlagEvaluation(key, value) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.addFeatureFlagEvaluation(key, value))\n    },\n\n    startDurationVital(name, options) {\n      const startClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.startDurationVital(name, options, startClocks))\n    },\n\n    stopDurationVital(name, options) {\n      const stopClocks = clocksNow()\n      bufferApiCalls.notify((startRumResult) => startRumResult.stopDurationVital(name, options, stopClocks))\n    },\n\n    addDurationVital(vital) {\n      bufferApiCalls.notify((startRumResult) => startRumResult.addDurationVital(vital))\n    },\n    addOperationStepVital,\n  }\n\n  return strategy\n}\n\nfunction overrideInitConfigurationForBridge(initConfiguration: RumInitConfiguration): RumInitConfiguration {\n  return {\n    ...initConfiguration,\n    // Resolve the service default here, while the web application id is still available: the\n    // placeholder below would otherwise be used, and it is shared by every bridge session.\n    service: initConfiguration.service || initConfiguration.applicationId,\n    applicationId: '00000000-aaaa-0000-aaaa-000000000000',\n    clientToken: 'empty',\n    sessionSampleRate: 100,\n    defaultPrivacyLevel: initConfiguration.defaultPrivacyLevel ?? getEventBridge()?.getPrivacyLevel(),\n  }\n}\n"],"mappings":"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"}

package/esm/boot/rumPublicApi.mjs

@@ -0,0 +1,271 @@
+import { ActionType, VitalType } from "../rawRumEvent.types.mjs";
+import { DEFAULT_TRACKED_RESOURCE_HEADERS } from "../domain/configuration/configuration.mjs";
+import "../domain/configuration/index.mjs";
+import { callPluginsOnRumStart } from "../domain/plugins.mjs";
+import { createPreStartStrategy } from "./preStartRum.mjs";
+import { startRum } from "./startRum.mjs";
+import { clocksNow, timeStampNow, timeStampToClocks } from "@kubesense/kubesense-js-core/time";
+import { deepClone } from "@kubesense/kubesense-js-core/util";
+import { ContextManagerMethod, CustomerContextKey, addTelemetryUsage, createHandlingStack, createIdentityEncoder, createTrackingConsentState, defineContextMethod, display, displayAlreadyInitializedError, generateUUID, makePublicApi, mockable, sanitize, startBufferingData } from "@kubesense/kubesense-browser-core";
+import { callMonitored, monitor } from "@kubesense/kubesense-js-core/monitor";
+//#region src/boot/rumPublicApi.ts
+function makeRumPublicApi(recorderApi, profilerApi, options = {}) {
+	const trackingConsentState = createTrackingConsentState();
+	const bufferedData = startBufferingData();
+	let strategy = createPreStartStrategy(options, trackingConsentState, (configuration, sessionManager, deflateWorker, initialViewOptions, telemetry, hooks) => {
+		const createEncoder = deflateWorker && options.createDeflateEncoder ? (streamId) => options.createDeflateEncoder(deflateWorker, streamId) : createIdentityEncoder;
+		const startRumResult = mockable(startRum)(configuration, sessionManager, recorderApi, profilerApi, initialViewOptions, createEncoder, bufferedData.observable, telemetry, hooks, options.sdkName);
+		recorderApi.onRumStart(startRumResult.lifeCycle, configuration, sessionManager, startRumResult.viewHistory, deflateWorker, startRumResult.telemetry);
+		profilerApi.onRumStart(startRumResult.lifeCycle, startRumResult.hooks, configuration, sessionManager, startRumResult.viewHistory, createEncoder);
+		strategy = createPostStartStrategy(strategy, startRumResult);
+		callPluginsOnRumStart(configuration.plugins, {
+			addEvent: startRumResult.addEvent,
+			addError: startRumResult.addError
+		});
+		return startRumResult;
+	});
+	const getStrategy = () => strategy;
+	const startView = (options) => {
+		const handlingStack = createHandlingStack("view");
+		callMonitored(() => {
+			const sanitizedOptions = typeof options === "object" ? options : { name: options };
+			strategy.startView({
+				...sanitizedOptions,
+				name: sanitizeStringOption(sanitizedOptions.name, "view name"),
+				service: sanitizeStringOption(sanitizedOptions.service, "view service"),
+				version: sanitizeStringOption(sanitizedOptions.version, "view version"),
+				handlingStack
+			});
+			addTelemetryUsage({ feature: "start-view" });
+		});
+	};
+	const startOperation = (name, options) => {
+		const handlingStack = createHandlingStack("vital");
+		callMonitored(() => {
+			addTelemetryUsage({
+				feature: "add-operation-step-vital",
+				action_type: "start"
+			});
+			strategy.addOperationStepVital(name, "start", {
+				...options,
+				handlingStack
+			});
+		});
+	};
+	const succeedOperation = monitor((name, options) => {
+		addTelemetryUsage({
+			feature: "add-operation-step-vital",
+			action_type: "succeed"
+		});
+		strategy.addOperationStepVital(name, "end", options);
+	});
+	const failOperation = monitor((name, failureReason, options) => {
+		addTelemetryUsage({
+			feature: "add-operation-step-vital",
+			action_type: "fail"
+		});
+		strategy.addOperationStepVital(name, "end", options, failureReason);
+	});
+	const rumPublicApi = makePublicApi({
+		init: (initConfiguration) => {
+			const errorStack = (/* @__PURE__ */ new Error()).stack;
+			callMonitored(() => strategy.init(initConfiguration, rumPublicApi, errorStack));
+		},
+		setTrackingConsent: monitor((trackingConsent) => {
+			trackingConsentState.update(trackingConsent);
+			addTelemetryUsage({
+				feature: "set-tracking-consent",
+				tracking_consent: trackingConsent
+			});
+		}),
+		setViewName: monitor((name) => {
+			strategy.setViewName(sanitizeStringOption(name, "view name"));
+			addTelemetryUsage({ feature: "set-view-name" });
+		}),
+		setViewContext: monitor((context) => {
+			strategy.setViewContext(context);
+			addTelemetryUsage({ feature: "set-view-context" });
+		}),
+		setViewContextProperty: monitor((key, value) => {
+			strategy.setViewContextProperty(key, value);
+			addTelemetryUsage({ feature: "set-view-context-property" });
+		}),
+		getViewContext: monitor(() => {
+			addTelemetryUsage({ feature: "set-view-context-property" });
+			return strategy.getViewContext();
+		}),
+		getInternalContext: monitor((startTime) => strategy.getInternalContext(startTime)),
+		getInitConfiguration: monitor(() => deepClone(strategy.initConfiguration)),
+		addAction: (name, context) => {
+			const handlingStack = createHandlingStack("action");
+			callMonitored(() => {
+				strategy.addAction({
+					name: sanitize(name),
+					context: sanitize(context),
+					startClocks: clocksNow(),
+					type: ActionType.CUSTOM,
+					handlingStack
+				});
+				addTelemetryUsage({ feature: "add-action" });
+			});
+		},
+		startAction: monitor((name, options) => {
+			addTelemetryUsage({ feature: "start-action" });
+			strategy.startAction(sanitize(name), {
+				type: sanitize(options?.type),
+				context: sanitize(options?.context),
+				actionKey: options?.actionKey
+			});
+		}),
+		stopAction: monitor((name, options) => {
+			addTelemetryUsage({ feature: "stop-action" });
+			strategy.stopAction(sanitize(name), {
+				type: sanitize(options?.type),
+				context: sanitize(options?.context),
+				actionKey: options?.actionKey
+			});
+		}),
+		startResource: monitor((url, options) => {
+			addTelemetryUsage({ feature: "start-resource" });
+			strategy.startResource(sanitize(url), {
+				type: sanitize(options?.type),
+				method: sanitize(options?.method),
+				context: sanitize(options?.context),
+				resourceKey: options?.resourceKey
+			});
+		}),
+		stopResource: monitor((url, options) => {
+			addTelemetryUsage({ feature: "stop-resource" });
+			strategy.stopResource(sanitize(url), {
+				type: sanitize(options?.type),
+				statusCode: options?.statusCode,
+				size: options?.size,
+				context: sanitize(options?.context),
+				resourceKey: options?.resourceKey
+			});
+		}),
+		addError: (error, context) => {
+			const handlingStack = createHandlingStack("error");
+			callMonitored(() => {
+				strategy.addError({
+					error,
+					handlingStack,
+					context: sanitize(context),
+					startClocks: clocksNow()
+				});
+				addTelemetryUsage({ feature: "add-error" });
+			});
+		},
+		addTiming: monitor((name, time) => {
+			strategy.addTiming(sanitize(name), time);
+		}),
+		setViewLoadingTime: monitor(() => {
+			const callTimestamp = timeStampNow();
+			strategy.setLoadingTime(callTimestamp);
+			addTelemetryUsage({ feature: "addViewLoadingTime" });
+		}),
+		setGlobalContext: defineContextMethod(getStrategy, CustomerContextKey.globalContext, ContextManagerMethod.setContext, "set-global-context"),
+		getGlobalContext: defineContextMethod(getStrategy, CustomerContextKey.globalContext, ContextManagerMethod.getContext, "get-global-context"),
+		setGlobalContextProperty: defineContextMethod(getStrategy, CustomerContextKey.globalContext, ContextManagerMethod.setContextProperty, "set-global-context-property"),
+		removeGlobalContextProperty: defineContextMethod(getStrategy, CustomerContextKey.globalContext, ContextManagerMethod.removeContextProperty, "remove-global-context-property"),
+		clearGlobalContext: defineContextMethod(getStrategy, CustomerContextKey.globalContext, ContextManagerMethod.clearContext, "clear-global-context"),
+		setUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.setContext, "set-user"),
+		getUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.getContext, "get-user"),
+		setUserProperty: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.setContextProperty, "set-user-property"),
+		removeUserProperty: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.removeContextProperty, "remove-user-property"),
+		clearUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.clearContext, "clear-user"),
+		setAccount: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.setContext, "set-account"),
+		getAccount: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.getContext, "get-account"),
+		setAccountProperty: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.setContextProperty, "set-account-property"),
+		removeAccountProperty: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.removeContextProperty, "remove-account-property"),
+		clearAccount: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.clearContext, "clear-account"),
+		startView,
+		stopSession: monitor(() => {
+			strategy.stopSession();
+			addTelemetryUsage({ feature: "stop-session" });
+		}),
+		addFeatureFlagEvaluation: monitor((key, value) => {
+			strategy.addFeatureFlagEvaluation(sanitize(key), sanitize(value));
+			addTelemetryUsage({ feature: "add-feature-flag-evaluation" });
+		}),
+		getSessionReplayLink: monitor(() => recorderApi.getSessionReplayLink()),
+		startSessionReplayRecording: monitor((options) => {
+			recorderApi.start(options);
+			addTelemetryUsage({
+				feature: "start-session-replay-recording",
+				force: options?.force
+			});
+		}),
+		stopSessionReplayRecording: monitor(() => recorderApi.stop()),
+		addDurationVital: (name, options) => {
+			const handlingStack = createHandlingStack("vital");
+			callMonitored(() => {
+				addTelemetryUsage({ feature: "add-duration-vital" });
+				strategy.addDurationVital({
+					id: generateUUID(),
+					name: sanitize(name),
+					type: VitalType.DURATION,
+					startClocks: timeStampToClocks(options.startTime),
+					duration: options.duration,
+					context: sanitize(options?.context),
+					description: sanitize(options?.description),
+					handlingStack
+				});
+			});
+		},
+		startDurationVital: (name, options) => {
+			const handlingStack = createHandlingStack("vital");
+			callMonitored(() => {
+				addTelemetryUsage({ feature: "start-duration-vital" });
+				strategy.startDurationVital(sanitize(name), {
+					vitalKey: options?.vitalKey,
+					context: sanitize(options?.context),
+					description: sanitize(options?.description),
+					handlingStack
+				});
+			});
+		},
+		stopDurationVital: monitor((name, options) => {
+			addTelemetryUsage({ feature: "stop-duration-vital" });
+			strategy.stopDurationVital(sanitize(name), {
+				vitalKey: options?.vitalKey,
+				context: sanitize(options?.context),
+				description: sanitize(options?.description)
+			});
+		}),
+		startOperation,
+		succeedOperation,
+		failOperation,
+		startFeatureOperation: startOperation,
+		succeedFeatureOperation: succeedOperation,
+		failFeatureOperation: failOperation,
+		DEFAULT_TRACKED_RESOURCE_HEADERS
+	});
+	return rumPublicApi;
+}
+function sanitizeStringOption(value, label) {
+	if (value === void 0) return;
+	if (typeof value !== "string") {
+		display.warn(`Invalid ${label} provided (expected a string, got ${typeof value}). Ignoring.`);
+		return;
+	}
+	return sanitize(value);
+}
+function createPostStartStrategy(preStartStrategy, startRumResult) {
+	return {
+		...preStartStrategy,
+		init: (initConfiguration) => {
+			displayAlreadyInitializedError("KUBESENSE_SDK", initConfiguration);
+		},
+		getInternalContext: startRumResult.getInternalContext,
+		stopSession: startRumResult.stopSession,
+		getViewContext: startRumResult.getViewContext,
+		globalContext: startRumResult.globalContext,
+		userContext: startRumResult.userContext,
+		accountContext: startRumResult.accountContext
+	};
+}
+//#endregion
+export { makeRumPublicApi };
+
+//# sourceMappingURL=rumPublicApi.mjs.map

package/esm/boot/rumPublicApi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rumPublicApi.mjs","names":[],"sources":["../../src/boot/rumPublicApi.ts"],"sourcesContent":["import { timeStampNow, clocksNow, timeStampToClocks } from '@kubesense/kubesense-js-core/time'\nimport { deepClone } from '@kubesense/kubesense-js-core/util'\nimport type { Duration, TimeStamp, RelativeTime } from '@kubesense/kubesense-js-core/time'\nimport type {\n  Context,\n  DeflateWorker,\n  DeflateEncoderStreamId,\n  DeflateEncoder,\n  PublicApi,\n  ContextManager,\n  TrackingConsent,\n  User,\n  Account,\n  RumInternalContext,\n  Telemetry,\n  Encoder,\n  ResourceType,\n  SessionManager,\n} from '@kubesense/kubesense-browser-core'\nimport {\n  ContextManagerMethod,\n  addTelemetryUsage,\n  makePublicApi,\n  createHandlingStack,\n  sanitize,\n  createIdentityEncoder,\n  displayAlreadyInitializedError,\n  createTrackingConsentState,\n  CustomerContextKey,\n  defineContextMethod,\n  startBufferingData,\n  mockable,\n  generateUUID,\n  display,\n} from '@kubesense/kubesense-browser-core'\nimport { monitor, callMonitored } from '@kubesense/kubesense-js-core/monitor'\n\nimport type { LifeCycle } from '../domain/lifeCycle'\nimport type { ViewHistory } from '../domain/contexts/viewHistory'\nimport type { ReplayStats } from '../rawRumEvent.types'\nimport { ActionType, VitalType } from '../rawRumEvent.types'\nimport { DEFAULT_TRACKED_RESOURCE_HEADERS } from '../domain/configuration'\nimport type { RumConfiguration, RumInitConfiguration } from '../domain/configuration'\nimport type { ViewOptions } from '../domain/view/trackViews'\nimport type {\n  AddDurationVitalOptions,\n  DurationVitalOptions,\n  OperationOptions,\n  FeatureOperationOptions,\n  FailureReason,\n} from '../domain/vital/vitalCollection'\nimport { callPluginsOnRumStart } from '../domain/plugins'\nimport type { Hooks } from '../domain/hooks'\nimport type { SdkName } from '../domain/contexts/defaultContext'\nimport type { ActionOptions } from '../domain/action/trackManualActions'\nimport type { ResourceOptions, ResourceStopOptions } from '../domain/resource/trackManualResources'\nimport { createPreStartStrategy } from './preStartRum'\nimport type { StartRumResult } from './startRum'\nimport { startRum } from './startRum'\n\nexport interface StartRecordingOptions {\n  force: boolean\n}\n\n/**\n * Public API for the RUM browser SDK.\n *\n * See [RUM Browser Monitoring Setup](https://docs.kubesense.ai/real_user_monitoring/browser) for further information.\n *\n * @category Main\n */\nexport interface RumPublicApi extends PublicApi {\n  /**\n   * Init the RUM browser SDK.\n   *\n   * See [RUM Browser Monitoring Setup](https://docs.kubesense.ai/real_user_monitoring/browser) for further information.\n   *\n   * @category Init\n   * @param initConfiguration - Configuration options of the SDK\n   * @example\n   * ```ts\n   * kubesenseSdk.init({\n   *   applicationId: '<KUBESENSE_APPLICATION_ID>',\n   *   clientToken: '<KUBESENSE_CLIENT_TOKEN>',\n   *   kubesenseRumEndpoint: '<KUBESENSE_RUM_ENDPOINT>',\n   *   // ...\n   * })\n   * ```\n   */\n  init: (initConfiguration: RumInitConfiguration) => void\n\n  /**\n   * Set the tracking consent of the current user.\n   *\n   * Data will be sent only if it is set to \"granted\". This value won't be stored by the library\n   * across page loads: you will need to call this method or set the appropriate `trackingConsent`\n   * field in the init() method at each page load.\n   *\n   * If this method is called before the init() method, the provided value will take precedence\n   * over the one provided as initialization parameter.\n   *\n   * See [User tracking consent](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-tracking-consent) for further information.\n   *\n   * @category Privacy\n   * @param trackingConsent - The user tracking consent\n   */\n  setTrackingConsent: (trackingConsent: TrackingConsent) => void\n\n  /**\n   * Set View Name.\n   *\n   * Enable to manually change the name of the current view.\n   * See [Override default RUM view names](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#override-default-rum-view-names) for further information.\n   *\n   * @category Context - View\n   * @param name - Name of the view\n   */\n  setViewName: (name: string) => void\n\n  /**\n   * Set View Context.\n   *\n   * Enable to manually set the context of the current view.\n   *\n   * @category Context - View\n   * @param context - Context of the view\n   */\n  setViewContext: (context: Context) => void\n  /**\n   * Set View Context Property.\n   *\n   * Enable to manually set a property of the context of the current view.\n   *\n   * @category Context - View\n   * @param key - key of the property\n   * @param value - value of the property\n   */\n  setViewContextProperty: (key: string, value: any) => void\n\n  /**\n   * Get View Context.\n   *\n   * @category Context - View\n   */\n  getViewContext(): Context\n\n  /**\n   * [Internal API] Get the internal SDK context\n   *\n   * @internal\n   */\n  getInternalContext: (startTime?: number) => RumInternalContext | undefined\n\n  /**\n   * Get the init configuration\n   *\n   * @category Init\n   * @returns RumInitConfiguration | undefined\n   */\n  getInitConfiguration: () => RumInitConfiguration | undefined\n\n  /**\n   * Add a custom action, stored in `@action`\n   *\n   * See [Send RUM Custom Actions](https://docs.kubesense.ai/real_user_monitoring/guide/send-rum-custom-actions) for further information.\n   *\n   * @category Data Collection\n   * @param name - Name of the action\n   * @param context - Context of the action\n   */\n  addAction: (name: string, context?: object) => void\n\n  /**\n   * Start tracking a custom action.\n   *\n   * Call {@link stopAction} with the same name (and optional `actionKey`) to send a RUM action event\n   * with the elapsed duration. Errors and resources triggered between start and stop are associated\n   * with the action.\n   *\n   * @category Data Collection\n   * @param name - Name of the action\n   * @param options - Options of the action (@default type: 'custom')\n   * @example\n   * ```ts\n   * kubesenseSdk.startAction('checkout', { context: { cartId: 'abc' } })\n   * // ... user completes checkout\n   * kubesenseSdk.stopAction('checkout')\n   * ```\n   */\n  startAction: (name: string, options?: ActionOptions) => void\n\n  /**\n   * Stop tracking a custom action started with {@link startAction}.\n   *\n   * Sends a RUM action event with the elapsed duration since the matching start call. Context from\n   * start and stop calls is merged into the event.\n   *\n   * @category Data Collection\n   * @param name - Name of the action\n   * @param options - Options of the action\n   */\n  stopAction: (name: string, options?: ActionOptions) => void\n\n  /**\n   * Start tracking a resource manually.\n   *\n   * Use this for network activity that the SDK cannot automatically instrument. Call {@link stopResource}\n   * with the same URL (and optional `resourceKey`) to send a RUM resource event with the elapsed duration.\n   *\n   * @category Data Collection\n   * @param url - URL of the resource\n   * @param options - Options of the resource (@default type: 'other')\n   * @example\n   * ```ts\n   * kubesenseSdk.startResource('https://api.example.com/users', { type: 'fetch', method: 'POST' })\n   * // ... perform the request\n   * kubesenseSdk.stopResource('https://api.example.com/users', { statusCode: 201 })\n   * ```\n   */\n  startResource: (url: string, options?: ResourceOptions) => void\n\n  /**\n   * Stop tracking a resource started with {@link startResource}.\n   *\n   * Sends a RUM resource event with the elapsed duration since the matching start call. Context from\n   * start and stop calls is merged into the event.\n   *\n   * @category Data Collection\n   * @param url - URL of the resource\n   * @param options - Options of the resource\n   */\n  stopResource: (url: string, options?: ResourceStopOptions) => void\n\n  /**\n   * Add a custom error, stored in `@error`.\n   *\n   * See [Send RUM Custom Actions](https://docs.kubesense.ai/real_user_monitoring/guide/send-rum-custom-actions) for further information.\n   *\n   * @category Data Collection\n   * @param error - Error. Favor sending a [Javascript Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) to have a stack trace attached to the error event.\n   * @param context - Context of the error\n   */\n  addError: (error: unknown, context?: object) => void\n\n  /**\n   * Add a custom timing relative to the start of the current view,\n   * stored in `@view.custom_timings.<timing_name>`\n   *\n   * Note: passing a relative time is discouraged since it is actually used as-is but displayed relative to the view start.\n   * We currently don't provide a way to retrieve the view start time, so it can be challenging to provide a timing relative to the view start.\n   *\n   * @category Data Collection\n   * @param name - Name of the custom timing\n   * @param [time] - Epoch timestamp of the custom timing (if not set, will use current time)\n   */\n  addTiming: (name: string, time?: number) => void\n\n  /**\n   * [Experimental] Manually set the current view's loading time.\n   *\n   * Call this method when the view has finished loading. The loading time is computed as the\n   * elapsed time since the view started. Each call replaces any previously set value (last-call-wins).\n   *\n   * @category Data Collection\n   */\n  setViewLoadingTime: () => void\n\n  /**\n   * Set the global context information to all events, stored in `@context`\n   * See [Global context](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#global-context) for further information.\n   *\n   * @category Context - Global Context\n   * @param context - Global context\n   */\n  setGlobalContext: (context: Context) => void\n\n  /**\n   * Get the global Context\n   *\n   * See [Global context](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#global-context) for further information.\n   *\n   * @category Context - Global Context\n   */\n  getGlobalContext: () => Context\n\n  /**\n   * Set or update a global context property, stored in `@context.<key>`\n   *\n   * See [Global context](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#global-context) for further information.\n   *\n   * @category Context - Global Context\n   * @param key - Key of the property\n   * @param value - Value of the property\n   */\n  setGlobalContextProperty: (key: any, value: any) => void\n\n  /**\n   * Remove a global context property\n   *\n   * See [Global context](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#global-context) for further information.\n   *\n   * @category Context - Global Context\n   */\n  removeGlobalContextProperty: (key: any) => void\n\n  /**\n   * Clear the global context\n   *\n   * See [Global context](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#global-context) for further information.\n   *\n   * @category Context - Global Context\n   */\n  clearGlobalContext(): void\n\n  /**\n   * Set user information to all events, stored in `@usr`\n   *\n   * See [User session](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-session) for further information.\n   *\n   * @category Context - User\n   * @param newUser - User information\n   */\n  setUser(newUser: User & { id: string }): void\n\n  /**\n   * Set user information to all events, stored in `@usr`\n   *\n   * @category Context - User\n   * @deprecated You must specify a user id, favor using {@link setUser} instead\n   * @param newUser - User information with optional id\n   */\n  setUser(newUser: User): void\n\n  /**\n   * Get user information\n   *\n   * See [User session](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-session) for further information.\n   *\n   * @category Context - User\n   * @returns User information\n   */\n  getUser: () => Context\n\n  /**\n   * Set or update the user property, stored in `@usr.<key>`\n   *\n   * See [User session](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-session) for further information.\n   *\n   * @category Context - User\n   * @param key - Key of the property\n   * @param property - Value of the property\n   */\n  setUserProperty: (key: any, property: any) => void\n\n  /**\n   * Remove a user property\n   *\n   * @category Context - User\n   * @param key - Key of the property to remove\n   * @see [User session](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-session) for further information.\n   */\n  removeUserProperty: (key: any) => void\n\n  /**\n   * Clear all user information\n   *\n   * See [User session](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#user-session) for further information.\n   *\n   * @category Context - User\n   */\n  clearUser: () => void\n\n  /**\n   * Set account information to all events, stored in `@account`\n   *\n   * @category Context - Account\n   * @param newAccount - Account information\n   */\n  setAccount: (newAccount: Account) => void\n\n  /**\n   * Get account information\n   *\n   * @category Context - Account\n   * @returns Account information\n   */\n  getAccount: () => Context\n\n  /**\n   * Set or update the account property, stored in `@account.<key>`\n   *\n   * @category Context - Account\n   * @param key - Key of the property\n   * @param property - Value of the property\n   */\n  setAccountProperty: (key: string, property: any) => void\n\n  /**\n   * Remove an account property\n   *\n   * @category Context - Account\n   * @param key - Key of the property to remove\n   */\n  removeAccountProperty: (key: string) => void\n\n  /**\n   * Clear all account information\n   *\n   * @category Context - Account\n   * @returns Clear all account information\n   */\n  clearAccount: () => void\n  /**\n   * Start a view manually.\n   * Enable to manual start a view, use `trackViewsManually: true` init parameter and call `startView()` to create RUM views and be aligned with how you’ve defined them in your SPA application routing.\n   *\n   * See [Override default RUM view names](https://docs.kubesense.ai/real_user_monitoring/browser/advanced_configuration/#override-default-rum-view-names) for further information.\n   *\n   * Context - @category Data Collection\n   *\n   * @param nameOrOptions - The view name, or a {@link ViewOptions} object to configure the view\n   */\n  startView(nameOrOptions?: string | ViewOptions): void\n\n  /**\n   * Stop the session. A new session will start at the next user interaction with the page.\n   *\n   * @category Session\n   */\n  stopSession(): void\n\n  /**\n   * Add a feature flag evaluation,\n   * stored in `@feature_flags.<feature_flag_key>`\n   *\n   * We recommend enabling the intake request compression when using feature flags `compressIntakeRequests: true`.\n   *\n   * See [Feature Flag Tracking](https://docs.kubesense.ai/real_user_monitoring/feature_flag_tracking/) for further information.\n   *\n   * @category Data Collection\n   * @param key - The key of the feature flag.\n   * @param value - The value of the feature flag.\n   */\n  addFeatureFlagEvaluation: (key: string, value: any) => void\n\n  /**\n   * Get the Session Replay Link.\n   *\n   * See [Connect Session Replay To Your Third-Party Tools](https://docs.kubesense.ai/real_user_monitoring/guide/connect-session-replay-to-your-third-party-tools) for further information.\n   *\n   * @category Session Replay\n   */\n  getSessionReplayLink: () => string | undefined\n\n  /**\n   * Start Session Replay recording.\n   * Enable to conditionally start the recording, use the `startSessionReplayRecordingManually:true` init parameter and call `startSessionReplayRecording()`\n   *\n   * See [Browser Session Replay](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser) for further information.\n   *\n   * @category Session Replay\n   */\n  startSessionReplayRecording: (options?: StartRecordingOptions) => void\n\n  /**\n   * Stop Session Replay recording.\n   *\n   * See [Browser Session Replay](https://docs.kubesense.ai/real_user_monitoring/session_replay/browser) for further information.\n   *\n   * @category Session Replay\n   */\n  stopSessionReplayRecording: () => void\n\n  /**\n   * Add a custom duration vital\n   *\n   * @category Vital - Duration\n   * @param name - Name of the custom vital\n   * @param options - Options for the custom vital (startTime, duration, context, description)\n   */\n  addDurationVital: (name: string, options: AddDurationVitalOptions) => void\n\n  /**\n   * Start a custom duration vital.\n   *\n   * If you plan to have multiple durations for the same vital, use the `vitalKey` option to\n   * differentiate them. Provide the same key when calling `stopDurationVital`.\n   *\n   * @category Vital - Duration\n   * @param name - Name of the custom vital\n   * @param options - Options for the custom vital (vitalKey, context, description)\n   * @example\n   * ```ts\n   * // Simple usage\n   * kubesenseSdk.startDurationVital('my-vital')\n   * kubesenseSdk.stopDurationVital('my-vital')\n   *\n   * // Multiple simultaneous vitals with the same name\n   * const key = crypto.randomUUID()\n   * kubesenseSdk.startDurationVital('my-vital', { vitalKey: key })\n   * kubesenseSdk.stopDurationVital('my-vital', { vitalKey: key })\n   * ```\n   */\n  startDurationVital: (name: string, options?: DurationVitalOptions) => void\n\n  /**\n   * Stop a custom duration vital\n   *\n   * @category Vital - Duration\n   * @param name - Name of the custom vital\n   * @param options - Options for the custom vital (vitalKey, context, description)\n   */\n  stopDurationVital: (name: string, options?: DurationVitalOptions) => void\n\n  /**\n   * Start an operation.\n   *\n   * Call {@link succeedOperation} or {@link failOperation} with the same name (and optional\n   * `operationKey`) to send a RUM vital event marking the end of the operation.\n   *\n   * @category Vital - Operation\n   * @param name - Name of the operation\n   * @param options - Options for the operation (operationKey, context, description)\n   * @example\n   * ```ts\n   * kubesenseSdk.startOperation('checkout')\n   * // ... perform the operation\n   * kubesenseSdk.succeedOperation('checkout')\n   * ```\n   */\n  startOperation: (name: string, options?: OperationOptions) => void\n\n  /**\n   * Mark an operation as successful.\n   *\n   * Sends a RUM vital event marking the end of the operation started with {@link startOperation}.\n   *\n   * @category Vital - Operation\n   * @param name - Name of the operation\n   * @param options - Options for the operation (operationKey, context, description)\n   */\n  succeedOperation: (name: string, options?: OperationOptions) => void\n\n  /**\n   * Mark an operation as failed.\n   *\n   * Sends a RUM vital event marking the end of the operation started with {@link startOperation}.\n   *\n   * @category Vital - Operation\n   * @param name - Name of the operation\n   * @param failureReason - Reason for the failure\n   * @param options - Options for the operation (operationKey, context, description)\n   */\n  failOperation: (name: string, failureReason: FailureReason, options?: OperationOptions) => void\n\n  /**\n   * Start a feature operation.\n   *\n   * @category Vital - Feature Operation\n   * @deprecated Use {@link startOperation} instead.\n   * @param name - Name of the operation\n   * @param options - Options for the operation (operationKey, context, description)\n   */\n  startFeatureOperation: (name: string, options?: FeatureOperationOptions) => void\n\n  /**\n   * Mark a feature operation as successful.\n   *\n   * @category Vital - Feature Operation\n   * @deprecated Use {@link succeedOperation} instead.\n   * @param name - Name of the operation\n   * @param options - Options for the operation (operationKey, context, description)\n   */\n  succeedFeatureOperation: (name: string, options?: FeatureOperationOptions) => void\n\n  /**\n   * Mark a feature operation as failed.\n   *\n   * @category Vital - Feature Operation\n   * @deprecated Use {@link failOperation} instead.\n   * @param name - Name of the operation\n   * @param failureReason - Reason for the failure\n   * @param options - Options for the operation (operationKey, context, description)\n   */\n  failFeatureOperation: (name: string, failureReason: FailureReason, options?: FeatureOperationOptions) => void\n\n  /**\n   * List of default headers used by the {@link RumInitConfiguration.trackResourceHeaders | trackResourceHeaders} option.\n   *\n   * @deprecated You can now omit `name` from a MatchHeader entry to include default headers.\n   */\n  DEFAULT_TRACKED_RESOURCE_HEADERS: typeof DEFAULT_TRACKED_RESOURCE_HEADERS\n}\n\nexport interface RecorderApi {\n  start: (options?: StartRecordingOptions) => void\n  stop: () => void\n  onRumStart: (\n    lifeCycle: LifeCycle,\n    configuration: RumConfiguration,\n    sessionManager: SessionManager,\n    viewHistory: ViewHistory,\n    deflateWorker: DeflateWorker | undefined,\n    telemetry: Telemetry\n  ) => void\n  isRecording: () => boolean\n  getReplayStats: (viewId: string) => ReplayStats | undefined\n  getSessionReplayLink: () => string | undefined\n}\n\nexport interface ProfilerApi {\n  stop: () => void\n  onRumStart: (\n    lifeCycle: LifeCycle,\n    hooks: Hooks,\n    configuration: RumConfiguration,\n    sessionManager: SessionManager,\n    viewHistory: ViewHistory,\n    createEncoder: (streamId: DeflateEncoderStreamId) => Encoder\n  ) => void\n}\n\nexport interface RumPublicApiOptions {\n  ignoreInitIfSyntheticsWillInjectRum?: boolean\n  startDeflateWorker?: (\n    configuration: RumConfiguration,\n    source: string,\n    onInitializationFailure: () => void\n  ) => DeflateWorker | undefined\n  createDeflateEncoder?: (worker: DeflateWorker, streamId: DeflateEncoderStreamId) => DeflateEncoder\n  sdkName?: SdkName\n}\n\nexport interface Strategy {\n  init: (initConfiguration: RumInitConfiguration, publicApi: RumPublicApi, errorStack?: string) => void\n  initConfiguration: RumInitConfiguration | undefined\n  getInternalContext: StartRumResult['getInternalContext']\n  stopSession: StartRumResult['stopSession']\n  addTiming: StartRumResult['addTiming']\n  setLoadingTime: StartRumResult['setLoadingTime']\n  startView: StartRumResult['startView']\n  setViewName: StartRumResult['setViewName']\n\n  setViewContext: StartRumResult['setViewContext']\n  setViewContextProperty: StartRumResult['setViewContextProperty']\n  getViewContext: StartRumResult['getViewContext']\n\n  globalContext: ContextManager\n  userContext: ContextManager\n  accountContext: ContextManager\n\n  addAction: StartRumResult['addAction']\n  startAction: StartRumResult['startAction']\n  stopAction: StartRumResult['stopAction']\n  startResource: StartRumResult['startResource']\n  stopResource: StartRumResult['stopResource']\n  addError: StartRumResult['addError']\n  addFeatureFlagEvaluation: StartRumResult['addFeatureFlagEvaluation']\n  startDurationVital: StartRumResult['startDurationVital']\n  stopDurationVital: StartRumResult['stopDurationVital']\n  addDurationVital: StartRumResult['addDurationVital']\n  addOperationStepVital: StartRumResult['addOperationStepVital']\n}\n\nexport function makeRumPublicApi(\n  recorderApi: RecorderApi,\n  profilerApi: ProfilerApi,\n  options: RumPublicApiOptions = {}\n): RumPublicApi {\n  const trackingConsentState = createTrackingConsentState()\n  const bufferedData = startBufferingData()\n\n  let strategy = createPreStartStrategy(\n    options,\n    trackingConsentState,\n    (configuration, sessionManager, deflateWorker, initialViewOptions, telemetry, hooks) => {\n      const createEncoder =\n        deflateWorker && options.createDeflateEncoder\n          ? (streamId: DeflateEncoderStreamId) => options.createDeflateEncoder!(deflateWorker, streamId)\n          : createIdentityEncoder\n\n      const startRumResult = mockable(startRum)(\n        configuration,\n        sessionManager,\n        recorderApi,\n        profilerApi,\n        initialViewOptions,\n        createEncoder,\n        bufferedData.observable,\n        telemetry,\n        hooks,\n        options.sdkName\n      )\n\n      recorderApi.onRumStart(\n        startRumResult.lifeCycle,\n        configuration,\n        sessionManager,\n        startRumResult.viewHistory,\n        deflateWorker,\n        startRumResult.telemetry\n      )\n\n      profilerApi.onRumStart(\n        startRumResult.lifeCycle,\n        startRumResult.hooks,\n        configuration,\n        sessionManager,\n        startRumResult.viewHistory,\n        createEncoder\n      )\n\n      strategy = createPostStartStrategy(strategy, startRumResult)\n\n      callPluginsOnRumStart(configuration.plugins, {\n        addEvent: startRumResult.addEvent,\n        addError: startRumResult.addError,\n      })\n\n      return startRumResult\n    }\n  )\n  const getStrategy = () => strategy\n\n  const startView: {\n    (name?: string): void\n    (options: ViewOptions): void\n  } = (options?: string | ViewOptions) => {\n    const handlingStack = createHandlingStack('view')\n    callMonitored(() => {\n      const sanitizedOptions = typeof options === 'object' ? options : { name: options }\n      strategy.startView({\n        ...sanitizedOptions,\n        name: sanitizeStringOption(sanitizedOptions.name, 'view name'),\n        service: sanitizeStringOption(sanitizedOptions.service, 'view service'),\n        version: sanitizeStringOption(sanitizedOptions.version, 'view version'),\n        handlingStack,\n      })\n      addTelemetryUsage({ feature: 'start-view' })\n    })\n  }\n\n  const startOperation: RumPublicApi['startOperation'] = (name, options) => {\n    const handlingStack = createHandlingStack('vital')\n    callMonitored(() => {\n      addTelemetryUsage({ feature: 'add-operation-step-vital', action_type: 'start' })\n      strategy.addOperationStepVital(name, 'start', { ...options, handlingStack })\n    })\n  }\n\n  const succeedOperation: RumPublicApi['succeedOperation'] = monitor((name, options) => {\n    addTelemetryUsage({ feature: 'add-operation-step-vital', action_type: 'succeed' })\n    strategy.addOperationStepVital(name, 'end', options)\n  })\n\n  const failOperation: RumPublicApi['failOperation'] = monitor((name, failureReason, options) => {\n    addTelemetryUsage({ feature: 'add-operation-step-vital', action_type: 'fail' })\n    strategy.addOperationStepVital(name, 'end', options, failureReason)\n  })\n\n  const rumPublicApi: RumPublicApi = makePublicApi<RumPublicApi>({\n    init: (initConfiguration) => {\n      const errorStack = new Error().stack\n      callMonitored(() => strategy.init(initConfiguration, rumPublicApi, errorStack))\n    },\n\n    setTrackingConsent: monitor((trackingConsent) => {\n      trackingConsentState.update(trackingConsent)\n      addTelemetryUsage({ feature: 'set-tracking-consent', tracking_consent: trackingConsent })\n    }),\n\n    setViewName: monitor((name: string) => {\n      strategy.setViewName(sanitizeStringOption(name, 'view name')!)\n      addTelemetryUsage({ feature: 'set-view-name' })\n    }),\n\n    setViewContext: monitor((context: Context) => {\n      strategy.setViewContext(context)\n      addTelemetryUsage({ feature: 'set-view-context' })\n    }),\n\n    setViewContextProperty: monitor((key: string, value: any) => {\n      strategy.setViewContextProperty(key, value)\n      addTelemetryUsage({ feature: 'set-view-context-property' })\n    }),\n\n    getViewContext: monitor(() => {\n      addTelemetryUsage({ feature: 'set-view-context-property' })\n      return strategy.getViewContext()\n    }),\n\n    getInternalContext: monitor((startTime) => strategy.getInternalContext(startTime)),\n\n    getInitConfiguration: monitor(() => deepClone(strategy.initConfiguration)),\n\n    addAction: (name, context) => {\n      const handlingStack = createHandlingStack('action')\n\n      callMonitored(() => {\n        strategy.addAction({\n          name: sanitize(name)!,\n          context: sanitize(context) as Context,\n          startClocks: clocksNow(),\n          type: ActionType.CUSTOM,\n          handlingStack,\n        })\n        addTelemetryUsage({ feature: 'add-action' })\n      })\n    },\n\n    startAction: monitor((name, options) => {\n      addTelemetryUsage({ feature: 'start-action' })\n      strategy.startAction(sanitize(name)!, {\n        type: sanitize(options?.type) as ActionType | undefined,\n        context: sanitize(options?.context) as Context,\n        actionKey: options?.actionKey,\n      })\n    }),\n\n    stopAction: monitor((name, options) => {\n      addTelemetryUsage({ feature: 'stop-action' })\n      strategy.stopAction(sanitize(name)!, {\n        type: sanitize(options?.type) as ActionType | undefined,\n        context: sanitize(options?.context) as Context,\n        actionKey: options?.actionKey,\n      })\n    }),\n\n    startResource: monitor((url, options) => {\n      addTelemetryUsage({ feature: 'start-resource' })\n      strategy.startResource(sanitize(url)!, {\n        type: sanitize(options?.type) as ResourceType | undefined,\n        method: sanitize(options?.method) as string | undefined,\n        context: sanitize(options?.context) as Context,\n        resourceKey: options?.resourceKey,\n      })\n    }),\n\n    stopResource: monitor((url, options) => {\n      addTelemetryUsage({ feature: 'stop-resource' })\n      strategy.stopResource(sanitize(url)!, {\n        type: sanitize(options?.type) as ResourceType | undefined,\n        statusCode: options?.statusCode,\n        size: options?.size,\n        context: sanitize(options?.context) as Context,\n        resourceKey: options?.resourceKey,\n      })\n    }),\n\n    addError: (error, context) => {\n      const handlingStack = createHandlingStack('error')\n      callMonitored(() => {\n        strategy.addError({\n          error, // Do not sanitize error here, it is needed unserialized by computeRawError()\n          handlingStack,\n          context: sanitize(context) as Context,\n          startClocks: clocksNow(),\n        })\n        addTelemetryUsage({ feature: 'add-error' })\n      })\n    },\n\n    addTiming: monitor((name, time) => {\n      // TODO: next major decide to drop relative time support or update its behaviour\n      strategy.addTiming(sanitize(name)!, time as RelativeTime | TimeStamp | undefined)\n    }),\n\n    setViewLoadingTime: monitor(() => {\n      const callTimestamp = timeStampNow()\n      strategy.setLoadingTime(callTimestamp)\n      addTelemetryUsage({\n        feature: 'addViewLoadingTime',\n      })\n    }),\n\n    setGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.setContext,\n      'set-global-context'\n    ),\n    getGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.getContext,\n      'get-global-context'\n    ),\n    setGlobalContextProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.setContextProperty,\n      'set-global-context-property'\n    ),\n    removeGlobalContextProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.removeContextProperty,\n      'remove-global-context-property'\n    ),\n    clearGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.clearContext,\n      'clear-global-context'\n    ),\n\n    setUser: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.setContext,\n      'set-user'\n    ),\n    getUser: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.getContext,\n      'get-user'\n    ),\n    setUserProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.setContextProperty,\n      'set-user-property'\n    ),\n    removeUserProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.removeContextProperty,\n      'remove-user-property'\n    ),\n    clearUser: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.clearContext,\n      'clear-user'\n    ),\n\n    setAccount: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.setContext,\n      'set-account'\n    ),\n    getAccount: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.getContext,\n      'get-account'\n    ),\n    setAccountProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.setContextProperty,\n      'set-account-property'\n    ),\n    removeAccountProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.removeContextProperty,\n      'remove-account-property'\n    ),\n    clearAccount: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.clearContext,\n      'clear-account'\n    ),\n\n    startView,\n\n    stopSession: monitor(() => {\n      strategy.stopSession()\n      addTelemetryUsage({ feature: 'stop-session' })\n    }),\n\n    addFeatureFlagEvaluation: monitor((key, value) => {\n      strategy.addFeatureFlagEvaluation(sanitize(key)!, sanitize(value))\n      addTelemetryUsage({ feature: 'add-feature-flag-evaluation' })\n    }),\n\n    getSessionReplayLink: monitor(() => recorderApi.getSessionReplayLink()),\n\n    startSessionReplayRecording: monitor((options?: StartRecordingOptions) => {\n      recorderApi.start(options)\n      addTelemetryUsage({ feature: 'start-session-replay-recording', force: options?.force })\n    }),\n\n    stopSessionReplayRecording: monitor(() => recorderApi.stop()),\n\n    addDurationVital: (name, options) => {\n      const handlingStack = createHandlingStack('vital')\n      callMonitored(() => {\n        addTelemetryUsage({ feature: 'add-duration-vital' })\n        strategy.addDurationVital({\n          id: generateUUID(),\n          name: sanitize(name)!,\n          type: VitalType.DURATION,\n          startClocks: timeStampToClocks(options.startTime as TimeStamp),\n          duration: options.duration as Duration,\n          context: sanitize(options?.context) as Context,\n          description: sanitize(options?.description) as string | undefined,\n          handlingStack,\n        })\n      })\n    },\n\n    startDurationVital: (name, options) => {\n      const handlingStack = createHandlingStack('vital')\n      callMonitored(() => {\n        addTelemetryUsage({ feature: 'start-duration-vital' })\n        strategy.startDurationVital(sanitize(name)!, {\n          vitalKey: options?.vitalKey,\n          context: sanitize(options?.context) as Context,\n          description: sanitize(options?.description) as string | undefined,\n          handlingStack,\n        })\n      })\n    },\n\n    stopDurationVital: monitor((name, options) => {\n      addTelemetryUsage({ feature: 'stop-duration-vital' })\n      strategy.stopDurationVital(sanitize(name)!, {\n        vitalKey: options?.vitalKey,\n        context: sanitize(options?.context) as Context,\n        description: sanitize(options?.description) as string | undefined,\n      })\n    }),\n\n    startOperation,\n    succeedOperation,\n    failOperation,\n\n    // Deprecated aliases — kept for backwards compatibility, forward to the renamed APIs above.\n    // TODO: remove in the next major version (RUM-16921).\n    startFeatureOperation: startOperation,\n    succeedFeatureOperation: succeedOperation,\n    failFeatureOperation: failOperation,\n\n    DEFAULT_TRACKED_RESOURCE_HEADERS,\n  })\n\n  return rumPublicApi\n}\n\nfunction sanitizeStringOption(value: unknown, label: string): string | undefined {\n  if (value === undefined) {\n    return undefined\n  }\n  if (typeof value !== 'string') {\n    display.warn(`Invalid ${label} provided (expected a string, got ${typeof value}). Ignoring.`)\n    return undefined\n  }\n  return sanitize(value)\n}\n\nfunction createPostStartStrategy(preStartStrategy: Strategy, startRumResult: StartRumResult): Strategy {\n  return {\n    ...preStartStrategy,\n    init: (initConfiguration: RumInitConfiguration) => {\n      displayAlreadyInitializedError('KUBESENSE_SDK', initConfiguration)\n    },\n    getInternalContext: startRumResult.getInternalContext,\n    stopSession: startRumResult.stopSession,\n    getViewContext: startRumResult.getViewContext,\n    globalContext: startRumResult.globalContext,\n    userContext: startRumResult.userContext,\n    accountContext: startRumResult.accountContext,\n  }\n}\n"],"mappings":"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"}

package/esm/boot/startRum.mjs

@@ -0,0 +1,159 @@
+import { createDOMMutationObservable } from "../browser/domMutationObservable.mjs";
+import { createWindowOpenObservable } from "../browser/windowOpenObservable.mjs";
+import { startInternalContext } from "../domain/contexts/internalContext.mjs";
+import { LifeCycle } from "../domain/lifeCycle.mjs";
+import { startViewHistory } from "../domain/contexts/viewHistory.mjs";
+import { startRequestCollection } from "../domain/requestCollection.mjs";
+import { startWebSocketCollection } from "../domain/resource/webSocketCollection.mjs";
+import { startActionCollection } from "../domain/action/actionCollection.mjs";
+import { startErrorCollection } from "../domain/error/errorCollection.mjs";
+import { startResourceCollection } from "../domain/resource/resourceCollection.mjs";
+import { startViewCollection } from "../domain/view/viewCollection.mjs";
+import { startRumBatch } from "../transport/startRumBatch.mjs";
+import { startRumEventBridge } from "../transport/startRumEventBridge.mjs";
+import { startUrlContexts } from "../domain/contexts/urlContexts.mjs";
+import { createLocationChangeObservable } from "../browser/locationChangeObservable.mjs";
+import { startFeatureFlagContexts } from "../domain/contexts/featureFlagContext.mjs";
+import { startCustomerDataTelemetry } from "../domain/startCustomerDataTelemetry.mjs";
+import { startPageStateHistory } from "../domain/contexts/pageStateHistory.mjs";
+import { startDisplayContext } from "../domain/contexts/displayContext.mjs";
+import { startVitalCollection } from "../domain/vital/vitalCollection.mjs";
+import { startSessionContext } from "../domain/contexts/sessionContext.mjs";
+import { startCiVisibilityContext } from "../domain/contexts/ciVisibilityContext.mjs";
+import { startLongTaskCollection } from "../domain/longTask/longTaskCollection.mjs";
+import { startSyntheticsContext } from "../domain/contexts/syntheticsContext.mjs";
+import { startRumAssembly } from "../domain/assembly.mjs";
+import { startConnectivityContext } from "../domain/contexts/connectivityContext.mjs";
+import { startUserAgentDataContext } from "../domain/contexts/userAgentDataContext.mjs";
+import { startDefaultContext } from "../domain/contexts/defaultContext.mjs";
+import { startEventCollection } from "../domain/event/eventCollection.mjs";
+import { startSourceCodeMfeContext } from "../domain/contexts/sourceCodeMfeContext.mjs";
+import { clocksNow } from "@kubesense/kubesense-js-core/time";
+import { DEFAULT_ERROR_TYPE, ErrorSource, ExperimentalFeature, addTelemetryDebug, canUseEventBridge, createPageMayExitObservable, getSessionEndClocks, isExperimentalFeatureEnabled, sendToExtension, startAccountContext, startGlobalContext, startTabContext, startUserContext } from "@kubesense/kubesense-browser-core";
+//#region src/boot/startRum.ts
+function startRum(configuration, sessionManager, recorderApi, profilerApi, initialViewOptions, createEncoder, bufferedDataObservable, telemetry, hooks, sdkName) {
+	const cleanupTasks = [];
+	const lifeCycle = new LifeCycle();
+	lifeCycle.subscribe(14, (event) => sendToExtension("rum", event));
+	sessionManager.expireObservable.subscribe(() => lifeCycle.notify(10, { endClocks: getSessionEndClocks(sessionManager.findSession()) }));
+	sessionManager.renewObservable.subscribe(() => lifeCycle.notify(11));
+	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 });
+	};
+	if (!canUseEventBridge()) {
+		const batch = startRumBatch(configuration, lifeCycle, reportError, sessionManager.expireObservable, createEncoder);
+		const preparePageExitSubscription = batch.prepareUrgentFlushObservable.subscribe((reason) => {
+			lifeCycle.notify(12, reason);
+		});
+		cleanupTasks.push(() => preparePageExitSubscription.unsubscribe());
+		cleanupTasks.push(() => batch.stop());
+		startCustomerDataTelemetry(telemetry, lifeCycle, batch.flushObservable);
+	} else {
+		startRumEventBridge(lifeCycle);
+		const pageMayExitSubscription = createPageMayExitObservable().subscribe((event) => {
+			lifeCycle.notify(12, event.reason);
+		});
+		cleanupTasks.push(() => pageMayExitSubscription.unsubscribe());
+	}
+	const { stop: stopRumEventCollection, ...startRumEventCollectionResult } = startRumEventCollection(lifeCycle, hooks, configuration, sessionManager, recorderApi, initialViewOptions, bufferedDataObservable, sdkName, reportError);
+	cleanupTasks.push(stopRumEventCollection);
+	bufferedDataObservable.unbuffer();
+	cleanupTasks.push(() => profilerApi.stop());
+	return {
+		...startRumEventCollectionResult,
+		lifeCycle,
+		sessionManager,
+		stopSession: () => sessionManager.expire(),
+		telemetry,
+		stop: () => {
+			cleanupTasks.forEach((task) => task());
+		},
+		hooks
+	};
+}
+function startRumEventCollection(lifeCycle, hooks, configuration, sessionManager, recorderApi, initialViewOptions, bufferedDataObservable, sdkName, reportError) {
+	const cleanupTasks = [];
+	const domMutationObservable = createDOMMutationObservable();
+	const locationChangeObservable = createLocationChangeObservable();
+	const { observable: windowOpenObservable, stop: stopWindowOpen } = createWindowOpenObservable();
+	cleanupTasks.push(stopWindowOpen);
+	const { assembleEventDefaults: assembleHook } = hooks;
+	startDefaultContext(assembleHook, configuration, sdkName);
+	const pageStateHistory = startPageStateHistory(assembleHook);
+	cleanupTasks.push(() => pageStateHistory.stop());
+	const viewHistory = startViewHistory(lifeCycle);
+	cleanupTasks.push(() => viewHistory.stop());
+	const urlContexts = startUrlContexts(lifeCycle, assembleHook, locationChangeObservable);
+	cleanupTasks.push(() => urlContexts.stop());
+	const featureFlagContexts = startFeatureFlagContexts(lifeCycle, assembleHook, configuration);
+	startSessionContext(assembleHook, configuration, sessionManager, recorderApi, viewHistory);
+	startConnectivityContext(assembleHook);
+	startUserAgentDataContext(assembleHook);
+	startTabContext(assembleHook);
+	const globalContext = startGlobalContext(assembleHook, configuration, "rum", true);
+	const userContext = startUserContext(assembleHook, configuration, sessionManager, "rum");
+	const accountContext = startAccountContext(assembleHook, configuration, "rum");
+	const actionCollection = startActionCollection(lifeCycle, hooks, domMutationObservable, windowOpenObservable, configuration);
+	cleanupTasks.push(actionCollection.stop);
+	const eventCollection = startEventCollection(lifeCycle);
+	const displayContext = startDisplayContext(assembleHook);
+	cleanupTasks.push(displayContext.stop);
+	const ciVisibilityContext = startCiVisibilityContext(assembleHook);
+	cleanupTasks.push(ciVisibilityContext.stop);
+	startSyntheticsContext(assembleHook);
+	startRumAssembly(configuration, lifeCycle, hooks, reportError);
+	const { addTiming, setLoadingTime, startView, setViewName, setViewContext, setViewContextProperty, getViewContext, stop: stopViewCollection } = startViewCollection(lifeCycle, hooks, configuration, domMutationObservable, windowOpenObservable, locationChangeObservable, recorderApi, viewHistory, initialViewOptions);
+	startSourceCodeMfeContext(assembleHook);
+	cleanupTasks.push(stopViewCollection);
+	const resourceCollection = startResourceCollection(lifeCycle, configuration);
+	cleanupTasks.push(resourceCollection.stop);
+	const { stop: stopLongTaskCollection } = startLongTaskCollection(lifeCycle, configuration);
+	cleanupTasks.push(stopLongTaskCollection);
+	const { addError } = startErrorCollection(lifeCycle, bufferedDataObservable);
+	startRequestCollection(lifeCycle, configuration, sessionManager, userContext, accountContext, bufferedDataObservable);
+	const vitalCollection = startVitalCollection(lifeCycle, pageStateHistory);
+	if (configuration.trackResources && (configuration.betaTrackWebSockets || isExperimentalFeatureEnabled(ExperimentalFeature.TRACK_WEBSOCKETS))) {
+		const webSocketCollection = startWebSocketCollection(lifeCycle, viewHistory, vitalCollection.addDurationVital);
+		cleanupTasks.push(webSocketCollection.stop);
+	}
+	const internalContext = startInternalContext(configuration.applicationId, sessionManager, viewHistory, actionCollection.actionContexts, urlContexts);
+	return {
+		addAction: actionCollection.addAction,
+		startAction: actionCollection.startAction,
+		stopAction: actionCollection.stopAction,
+		startResource: resourceCollection.startResource,
+		stopResource: resourceCollection.stopResource,
+		addEvent: eventCollection.addEvent,
+		addError,
+		addTiming,
+		setLoadingTime,
+		addFeatureFlagEvaluation: featureFlagContexts.addFeatureFlagEvaluation,
+		startView,
+		setViewContext,
+		setViewContextProperty,
+		getViewContext,
+		setViewName,
+		viewHistory,
+		sessionManager,
+		stopSession: () => sessionManager.expire(),
+		getInternalContext: internalContext.get,
+		startDurationVital: vitalCollection.startDurationVital,
+		stopDurationVital: vitalCollection.stopDurationVital,
+		addDurationVital: vitalCollection.addDurationVital,
+		addOperationStepVital: vitalCollection.addOperationStepVital,
+		globalContext,
+		userContext,
+		accountContext,
+		stop: () => cleanupTasks.forEach((task) => task())
+	};
+}
+//#endregion
+export { startRum, startRumEventCollection };
+
+//# sourceMappingURL=startRum.mjs.map

package/esm/boot/startRum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRum.mjs","names":[],"sources":["../../src/boot/startRum.ts"],"sourcesContent":["import type {\n  Observable,\n  DeflateEncoderStreamId,\n  Encoder,\n  BufferedData,\n  BufferedObservable,\n  Telemetry,\n  SessionManager,\n} from '@kubesense/kubesense-browser-core'\nimport {\n  sendToExtension,\n  createPageMayExitObservable,\n  canUseEventBridge,\n  addTelemetryDebug,\n  startAccountContext,\n  startGlobalContext,\n  startUserContext,\n  startTabContext,\n  ErrorSource,\n  DEFAULT_ERROR_TYPE,\n  isExperimentalFeatureEnabled,\n  ExperimentalFeature,\n  getSessionEndClocks,\n} from '@kubesense/kubesense-browser-core'\nimport { clocksNow } from '@kubesense/kubesense-js-core/time'\nimport { createDOMMutationObservable } from '../browser/domMutationObservable'\nimport { createWindowOpenObservable } from '../browser/windowOpenObservable'\nimport { startInternalContext } from '../domain/contexts/internalContext'\nimport { LifeCycle, LifeCycleEventType } from '../domain/lifeCycle'\nimport { startViewHistory } from '../domain/contexts/viewHistory'\nimport { startRequestCollection } from '../domain/requestCollection'\nimport { startWebSocketCollection } from '../domain/resource/webSocketCollection'\nimport { startActionCollection } from '../domain/action/actionCollection'\nimport { startErrorCollection } from '../domain/error/errorCollection'\nimport { startResourceCollection } from '../domain/resource/resourceCollection'\nimport { startViewCollection } from '../domain/view/viewCollection'\nimport { startRumBatch } from '../transport/startRumBatch'\nimport { startRumEventBridge } from '../transport/startRumEventBridge'\nimport { startUrlContexts } from '../domain/contexts/urlContexts'\nimport { createLocationChangeObservable } from '../browser/locationChangeObservable'\nimport type { RumConfiguration } from '../domain/configuration'\nimport type { ViewOptions } from '../domain/view/trackViews'\nimport { startFeatureFlagContexts } from '../domain/contexts/featureFlagContext'\nimport { startCustomerDataTelemetry } from '../domain/startCustomerDataTelemetry'\nimport { startPageStateHistory } from '../domain/contexts/pageStateHistory'\nimport { startDisplayContext } from '../domain/contexts/displayContext'\nimport { startVitalCollection } from '../domain/vital/vitalCollection'\nimport { startCiVisibilityContext } from '../domain/contexts/ciVisibilityContext'\nimport { startLongTaskCollection } from '../domain/longTask/longTaskCollection'\nimport { startSyntheticsContext } from '../domain/contexts/syntheticsContext'\nimport { startRumAssembly } from '../domain/assembly'\nimport { startSessionContext } from '../domain/contexts/sessionContext'\nimport { startConnectivityContext } from '../domain/contexts/connectivityContext'\nimport { startUserAgentDataContext } from '../domain/contexts/userAgentDataContext'\nimport type { SdkName } from '../domain/contexts/defaultContext'\nimport { startDefaultContext } from '../domain/contexts/defaultContext'\nimport type { Hooks } from '../domain/hooks'\nimport { startEventCollection } from '../domain/event/eventCollection'\nimport { startSourceCodeMfeContext } from '../domain/contexts/sourceCodeMfeContext'\nimport type { RecorderApi, ProfilerApi } from './rumPublicApi'\n\nexport type StartRum = typeof startRum\nexport type StartRumResult = ReturnType<StartRum>\n\nexport function startRum(\n  configuration: RumConfiguration,\n  sessionManager: SessionManager,\n  recorderApi: RecorderApi,\n  profilerApi: ProfilerApi,\n  initialViewOptions: ViewOptions | undefined,\n  createEncoder: (streamId: DeflateEncoderStreamId) => Encoder,\n  bufferedDataObservable: BufferedObservable<BufferedData>,\n  telemetry: Telemetry,\n  hooks: Hooks,\n  sdkName?: SdkName\n) {\n  const cleanupTasks: Array<() => void> = []\n  const lifeCycle = new LifeCycle()\n\n  lifeCycle.subscribe(LifeCycleEventType.RUM_EVENT_COLLECTED, (event) => sendToExtension('rum', event))\n\n  // Dated to when the session ended rather than when this tab noticed: a hidden tab can learn of\n  // a timeout long after it happened, and ending its views then would stretch the session past\n  // SESSION_TIME_OUT_DELAY. The expiring session is still the active one while the observable\n  // notifies (the history is closed after).\n  sessionManager.expireObservable.subscribe(() =>\n    lifeCycle.notify(LifeCycleEventType.SESSION_EXPIRED, {\n      endClocks: getSessionEndClocks(sessionManager.findSession()),\n    })\n  )\n  sessionManager.renewObservable.subscribe(() => lifeCycle.notify(LifeCycleEventType.SESSION_RENEWED))\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    // 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  if (!canUseEventBridge()) {\n    const batch = startRumBatch(configuration, lifeCycle, reportError, sessionManager.expireObservable, createEncoder)\n    const preparePageExitSubscription = batch.prepareUrgentFlushObservable.subscribe((reason) => {\n      lifeCycle.notify(LifeCycleEventType.PREPARE_URGENT_FLUSH, reason)\n    })\n    cleanupTasks.push(() => preparePageExitSubscription.unsubscribe())\n    cleanupTasks.push(() => batch.stop())\n    startCustomerDataTelemetry(telemetry, lifeCycle, batch.flushObservable)\n  } else {\n    startRumEventBridge(lifeCycle)\n    const pageMayExitObservable = createPageMayExitObservable()\n    const pageMayExitSubscription = pageMayExitObservable.subscribe((event) => {\n      lifeCycle.notify(LifeCycleEventType.PREPARE_URGENT_FLUSH, event.reason)\n    })\n    cleanupTasks.push(() => pageMayExitSubscription.unsubscribe())\n  }\n\n  const { stop: stopRumEventCollection, ...startRumEventCollectionResult } = startRumEventCollection(\n    lifeCycle,\n    hooks,\n    configuration,\n    sessionManager,\n    recorderApi,\n    initialViewOptions,\n    bufferedDataObservable,\n    sdkName,\n    reportError\n  )\n  cleanupTasks.push(stopRumEventCollection)\n  bufferedDataObservable.unbuffer()\n\n  // Add Clean-up tasks for Profiler API.\n  cleanupTasks.push(() => profilerApi.stop())\n\n  return {\n    ...startRumEventCollectionResult,\n    lifeCycle,\n    sessionManager,\n    stopSession: () => sessionManager.expire(),\n    telemetry,\n    stop: () => {\n      cleanupTasks.forEach((task) => task())\n    },\n    hooks,\n  }\n}\n\nexport function startRumEventCollection(\n  lifeCycle: LifeCycle,\n  hooks: Hooks,\n  configuration: RumConfiguration,\n  sessionManager: SessionManager,\n  recorderApi: RecorderApi,\n  initialViewOptions: ViewOptions | undefined,\n  bufferedDataObservable: Observable<BufferedData>,\n  sdkName: SdkName | undefined,\n  reportError: (message: string) => void\n) {\n  const cleanupTasks: Array<() => void> = []\n\n  const domMutationObservable = createDOMMutationObservable()\n  const locationChangeObservable = createLocationChangeObservable()\n  const { observable: windowOpenObservable, stop: stopWindowOpen } = createWindowOpenObservable()\n  cleanupTasks.push(stopWindowOpen)\n\n  const { assembleEventDefaults: assembleHook } = hooks\n  startDefaultContext(assembleHook, configuration, sdkName)\n  const pageStateHistory = startPageStateHistory(assembleHook)\n  cleanupTasks.push(() => pageStateHistory.stop())\n  const viewHistory = startViewHistory(lifeCycle)\n  cleanupTasks.push(() => viewHistory.stop())\n  const urlContexts = startUrlContexts(lifeCycle, assembleHook, locationChangeObservable)\n  cleanupTasks.push(() => urlContexts.stop())\n  const featureFlagContexts = startFeatureFlagContexts(lifeCycle, assembleHook, configuration)\n  startSessionContext(assembleHook, configuration, sessionManager, recorderApi, viewHistory)\n  startConnectivityContext(assembleHook)\n  startUserAgentDataContext(assembleHook)\n  startTabContext(assembleHook)\n  const globalContext = startGlobalContext(assembleHook, configuration, 'rum', true)\n  const userContext = startUserContext(assembleHook, configuration, sessionManager, 'rum')\n  const accountContext = startAccountContext(assembleHook, configuration, 'rum')\n\n  const actionCollection = startActionCollection(\n    lifeCycle,\n    hooks,\n    domMutationObservable,\n    windowOpenObservable,\n    configuration\n  )\n  cleanupTasks.push(actionCollection.stop)\n\n  const eventCollection = startEventCollection(lifeCycle)\n\n  const displayContext = startDisplayContext(assembleHook)\n  cleanupTasks.push(displayContext.stop)\n  const ciVisibilityContext = startCiVisibilityContext(assembleHook)\n  cleanupTasks.push(ciVisibilityContext.stop)\n  startSyntheticsContext(assembleHook)\n\n  startRumAssembly(configuration, lifeCycle, hooks, reportError)\n\n  const {\n    addTiming,\n    setLoadingTime,\n    startView,\n    setViewName,\n    setViewContext,\n    setViewContextProperty,\n    getViewContext,\n    stop: stopViewCollection,\n  } = startViewCollection(\n    lifeCycle,\n    hooks,\n    configuration,\n    domMutationObservable,\n    windowOpenObservable,\n    locationChangeObservable,\n    recorderApi,\n    viewHistory,\n    initialViewOptions\n  )\n\n  startSourceCodeMfeContext(assembleHook)\n\n  cleanupTasks.push(stopViewCollection)\n\n  const resourceCollection = startResourceCollection(lifeCycle, configuration)\n  cleanupTasks.push(resourceCollection.stop)\n\n  const { stop: stopLongTaskCollection } = startLongTaskCollection(lifeCycle, configuration)\n  cleanupTasks.push(stopLongTaskCollection)\n\n  const { addError } = startErrorCollection(lifeCycle, bufferedDataObservable)\n\n  startRequestCollection(lifeCycle, configuration, sessionManager, userContext, accountContext, bufferedDataObservable)\n\n  const vitalCollection = startVitalCollection(lifeCycle, pageStateHistory)\n\n  if (\n    configuration.trackResources &&\n    (configuration.betaTrackWebSockets || isExperimentalFeatureEnabled(ExperimentalFeature.TRACK_WEBSOCKETS))\n  ) {\n    const webSocketCollection = startWebSocketCollection(lifeCycle, viewHistory, vitalCollection.addDurationVital)\n    cleanupTasks.push(webSocketCollection.stop)\n  }\n\n  const internalContext = startInternalContext(\n    configuration.applicationId,\n    sessionManager,\n    viewHistory,\n    actionCollection.actionContexts,\n    urlContexts\n  )\n\n  return {\n    addAction: actionCollection.addAction,\n    startAction: actionCollection.startAction,\n    stopAction: actionCollection.stopAction,\n    startResource: resourceCollection.startResource,\n    stopResource: resourceCollection.stopResource,\n    addEvent: eventCollection.addEvent,\n    addError,\n    addTiming,\n    setLoadingTime,\n    addFeatureFlagEvaluation: featureFlagContexts.addFeatureFlagEvaluation,\n    startView,\n    setViewContext,\n    setViewContextProperty,\n    getViewContext,\n    setViewName,\n    viewHistory,\n    sessionManager,\n    stopSession: () => sessionManager.expire(),\n    getInternalContext: internalContext.get,\n    startDurationVital: vitalCollection.startDurationVital,\n    stopDurationVital: vitalCollection.stopDurationVital,\n    addDurationVital: vitalCollection.addDurationVital,\n    addOperationStepVital: vitalCollection.addOperationStepVital,\n    globalContext,\n    userContext,\n    accountContext,\n    stop: () => cleanupTasks.forEach((task) => task()),\n  }\n}\n"],"mappings":"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"}