@kubesense/kubesense-browser-logs 0.0.0-stage → 2.0.0-beta.1

package/cjs/boot/logsPublicApi.d.ts

@@ -0,0 +1,231 @@
+import type { TrackingConsent, PublicApi, ContextManager, Account, Context, User } from '@kubesense/kubesense-browser-core';
+import type { LogsInitConfiguration } from '../domain/configuration';
+import type { HandlerType } from '../domain/logger';
+import type { StatusType } from '../domain/logger/isAuthorized';
+import { Logger } from '../domain/logger';
+import type { InternalContext } from '../domain/contexts/internalContext';
+import type { StartLogsResult } from './startLogs';
+export interface LoggerConfiguration {
+    level?: StatusType;
+    handler?: HandlerType | HandlerType[];
+    context?: object;
+}
+/**
+ * Public API for the Logs browser SDK.
+ *
+ * See [Browser Log Collection](https://docs.kubesense.ai/logs/log_collection/javascript) for further information.
+ *
+ * @category Main
+ */
+export interface LogsPublicApi extends PublicApi {
+    /**
+     * The default logger
+     *
+     * @category Logger
+     */
+    logger: Logger;
+    /**
+     * Init the Logs browser SDK.
+     *
+     * See [Browser Log Collection](https://docs.kubesense.ai/logs/log_collection/javascript) for further information.
+     *
+     * @category Init
+     * @param initConfiguration - Configuration options of the SDK
+     */
+    init: (initConfiguration: LogsInitConfiguration) => void;
+    /**
+     * Set the tracking consent of the current user.
+     *
+     * Logs will be sent only if it is set to "granted". This value won't be stored by the library
+     * across page loads: you will need to call this method or set the appropriate `trackingConsent`
+     * field in the init() method at each page load.
+     *
+     * If this method is called before the init() method, the provided value will take precedence
+     * over the one provided as initialization parameter.
+     *
+     * See [User tracking consent](https://docs.kubesense.ai/logs/log_collection/javascript/#user-tracking-consent) for further information.
+     *
+     * @category Privacy
+     * @param trackingConsent - The user tracking consent
+     */
+    setTrackingConsent: (trackingConsent: TrackingConsent) => void;
+    /**
+     * Set the global context information to all events, stored in `@context`
+     * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.
+     *
+     * @category Context - Global Context
+     * @param context - Global context
+     */
+    setGlobalContext: (context: any) => void;
+    /**
+     * Get the global Context
+     *
+     * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.
+     *
+     * @category Context - Global Context
+     */
+    getGlobalContext: () => Context;
+    /**
+     * Set or update a global context property, stored in `@context.<key>`
+     *
+     * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.
+     *
+     * @category Context - Global Context
+     * @param key - Key of the property
+     * @param value - Value of the property
+     */
+    setGlobalContextProperty: (key: any, value: any) => void;
+    /**
+     * Remove a global context property
+     *
+     * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.
+     *
+     * @category Context - Global Context
+     */
+    removeGlobalContextProperty: (key: any) => void;
+    /**
+     * Clear the global context
+     *
+     * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.
+     *
+     * @category Context - Global Context
+     */
+    clearGlobalContext: () => void;
+    /**
+     * Set user information to all events, stored in `@usr`
+     *
+     * See [User session](https://docs.kubesense.ai/logs/log_collection/javascript/#user-context) for further information.
+     *
+     * @category Context - User
+     * @param newUser - User information
+     */
+    setUser(newUser: User & {
+        id: string;
+    }): void;
+    /**
+     * Set user information to all events, stored in `@usr`
+     *
+     * @category Context - User
+     * @deprecated You must specify a user id, favor using {@link setUser} instead
+     * @param newUser - User information with optional id
+     */
+    setUser(newUser: User): void;
+    /**
+     * Get user information
+     *
+     * See [User session](https://docs.kubesense.ai/logs/log_collection/javascript/#user-context) for further information.
+     *
+     * @category Context - User
+     * @returns User information
+     */
+    getUser: () => Context;
+    /**
+     * Set or update the user property, stored in `@usr.<key>`
+     *
+     * See [User session](https://docs.kubesense.ai/logs/log_collection/javascript/#user-context) for further information.
+     *
+     * @category Context - User
+     * @param key - Key of the property
+     * @param property - Value of the property
+     */
+    setUserProperty: (key: any, property: any) => void;
+    /**
+     * Remove a user property
+     *
+     * @category Context - User
+     * @param key - Key of the property to remove
+     * @see [User session](https://docs.kubesense.ai/logs/log_collection/javascript/#user-context) for further information.
+     */
+    removeUserProperty: (key: any) => void;
+    /**
+     * Clear all user information
+     *
+     * See [User session](https://docs.kubesense.ai/logs/log_collection/javascript/#user-context) for further information.
+     *
+     * @category Context - User
+     */
+    clearUser: () => void;
+    /**
+     * Set account information to all events, stored in `@account`
+     *
+     * @category Context - Account
+     * @param newAccount - Account information
+     */
+    setAccount: (newAccount: Account) => void;
+    /**
+     * Get account information
+     *
+     * @category Context - Account
+     * @returns Account information
+     */
+    getAccount: () => Context;
+    /**
+     * Set or update the account property, stored in `@account.<key>`
+     *
+     * @category Context - Account
+     * @param key - Key of the property
+     * @param property - Value of the property
+     */
+    setAccountProperty: (key: string, property: any) => void;
+    /**
+     * Remove an account property
+     *
+     * @category Context - Account
+     * @param key - Key of the property to remove
+     */
+    removeAccountProperty: (key: string) => void;
+    /**
+     * Clear all account information
+     *
+     * @category Context - Account
+     * @returns Clear all account information
+     */
+    clearAccount: () => void;
+    /**
+     * The KubeSense browser logs SDK contains a default logger `KUBESENSE_LOGS.logger`, but this API allows to create different ones.
+     *
+     * See [Define multiple loggers](https://docs.kubesense.ai/logs/log_collection/javascript/#define-multiple-loggers) for further information.
+     *
+     * @category Logger
+     * @param name - Name of the logger
+     * @param conf - Configuration of the logger (level, handler, context)
+     */
+    createLogger: (name: string, conf?: LoggerConfiguration) => Logger;
+    /**
+     * Get a logger
+     *
+     * See [Define multiple loggers](https://docs.kubesense.ai/logs/log_collection/javascript/#define-multiple-loggers) for further information.
+     *
+     * @category Logger
+     * @param name - Name of the logger
+     */
+    getLogger: (name: string) => Logger | undefined;
+    /**
+     * Get the init configuration
+     *
+     * @category Init
+     * @returns The init configuration
+     */
+    getInitConfiguration: () => LogsInitConfiguration | undefined;
+    /**
+     * [Internal API] Get the internal SDK context
+     *
+     * See [Access internal context](https://docs.kubesense.ai/logs/log_collection/javascript/#access-internal-context) for further information.
+     *
+     * @internal
+     */
+    getInternalContext: (startTime?: number) => InternalContext | undefined;
+}
+export interface Strategy {
+    init: (initConfiguration: LogsInitConfiguration, publicApi: LogsPublicApi, errorStack?: string) => void;
+    initConfiguration: LogsInitConfiguration | undefined;
+    globalContext: ContextManager;
+    accountContext: ContextManager;
+    userContext: ContextManager;
+    getInternalContext: StartLogsResult['getInternalContext'];
+    handleLog: StartLogsResult['handleLog'];
+}
+export interface LogsPublicApiOptions {
+    sdkName?: string;
+}
+export declare function makeLogsPublicApi(options?: LogsPublicApiOptions): LogsPublicApi;

package/cjs/boot/logsPublicApi.js

@@ -0,0 +1,75 @@
+const require_logger = require("../domain/logger.js");
+const require_commonContext = require("../domain/contexts/commonContext.js");
+const require_plugins = require("../domain/plugins.js");
+const require_startLogs = require("./startLogs.js");
+const require_preStartLogs = require("./preStartLogs.js");
+let _kubesense_kubesense_js_core_util = require("@kubesense/kubesense-js-core/util");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+let _kubesense_kubesense_js_core_monitor = require("@kubesense/kubesense-js-core/monitor");
+//#region src/boot/logsPublicApi.ts
+function makeLogsPublicApi(options = {}) {
+	const trackingConsentState = (0, _kubesense_kubesense_browser_core.createTrackingConsentState)();
+	const bufferedDataObservable = (0, _kubesense_kubesense_browser_core.startBufferingData)().observable;
+	let strategy = require_preStartLogs.createPreStartStrategy(require_commonContext.buildCommonContext, trackingConsentState, (configuration, logsSessionManager, hooks) => {
+		const startLogsResult = (0, _kubesense_kubesense_browser_core.mockable)(require_startLogs.startLogs)(configuration, logsSessionManager, require_commonContext.buildCommonContext, bufferedDataObservable, hooks);
+		strategy = createPostStartStrategy(strategy, startLogsResult);
+		require_plugins.callPluginsMethod(configuration.plugins, "onLogsStart", { handleLog: startLogsResult.handleLog });
+		return startLogsResult;
+	}, options.sdkName);
+	const getStrategy = () => strategy;
+	const customLoggers = {};
+	const mainLogger = new require_logger.Logger((...params) => strategy.handleLog(...params));
+	const logsPublicApi = (0, _kubesense_kubesense_browser_core.makePublicApi)({
+		logger: mainLogger,
+		init: (initConfiguration) => {
+			const errorStack = (/* @__PURE__ */ new Error()).stack;
+			(0, _kubesense_kubesense_js_core_monitor.callMonitored)(() => strategy.init(initConfiguration, logsPublicApi, errorStack));
+		},
+		setTrackingConsent: (0, _kubesense_kubesense_js_core_monitor.monitor)((trackingConsent) => {
+			trackingConsentState.update(trackingConsent);
+			(0, _kubesense_kubesense_browser_core.addTelemetryUsage)({
+				feature: "set-tracking-consent",
+				tracking_consent: trackingConsent
+			});
+		}),
+		getGlobalContext: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, _kubesense_kubesense_browser_core.ContextManagerMethod.getContext),
+		setGlobalContext: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContext),
+		setGlobalContextProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContextProperty),
+		removeGlobalContextProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, _kubesense_kubesense_browser_core.ContextManagerMethod.removeContextProperty),
+		clearGlobalContext: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, _kubesense_kubesense_browser_core.ContextManagerMethod.clearContext),
+		createLogger: (0, _kubesense_kubesense_js_core_monitor.monitor)((name, conf = {}) => {
+			customLoggers[name] = new require_logger.Logger((...params) => strategy.handleLog(...params), (0, _kubesense_kubesense_browser_core.sanitize)(name), conf.handler, conf.level, (0, _kubesense_kubesense_browser_core.sanitize)(conf.context));
+			return customLoggers[name];
+		}),
+		getLogger: (0, _kubesense_kubesense_js_core_monitor.monitor)((name) => customLoggers[name]),
+		getInitConfiguration: (0, _kubesense_kubesense_js_core_monitor.monitor)(() => (0, _kubesense_kubesense_js_core_util.deepClone)(strategy.initConfiguration)),
+		getInternalContext: (0, _kubesense_kubesense_js_core_monitor.monitor)((startTime) => strategy.getInternalContext(startTime)),
+		setUser: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContext),
+		getUser: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, _kubesense_kubesense_browser_core.ContextManagerMethod.getContext),
+		setUserProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContextProperty),
+		removeUserProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, _kubesense_kubesense_browser_core.ContextManagerMethod.removeContextProperty),
+		clearUser: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, _kubesense_kubesense_browser_core.ContextManagerMethod.clearContext),
+		setAccount: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContext),
+		getAccount: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, _kubesense_kubesense_browser_core.ContextManagerMethod.getContext),
+		setAccountProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, _kubesense_kubesense_browser_core.ContextManagerMethod.setContextProperty),
+		removeAccountProperty: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, _kubesense_kubesense_browser_core.ContextManagerMethod.removeContextProperty),
+		clearAccount: (0, _kubesense_kubesense_browser_core.defineContextMethod)(getStrategy, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, _kubesense_kubesense_browser_core.ContextManagerMethod.clearContext)
+	});
+	return logsPublicApi;
+}
+function createPostStartStrategy(preStartStrategy, startLogsResult) {
+	return {
+		...preStartStrategy,
+		init: (initConfiguration) => {
+			(0, _kubesense_kubesense_browser_core.displayAlreadyInitializedError)("KUBESENSE_LOGS", initConfiguration);
+		},
+		getInternalContext: startLogsResult.getInternalContext,
+		globalContext: startLogsResult.globalContext,
+		userContext: startLogsResult.userContext,
+		accountContext: startLogsResult.accountContext
+	};
+}
+//#endregion
+exports.makeLogsPublicApi = makeLogsPublicApi;
+
+//# sourceMappingURL=logsPublicApi.js.map

package/cjs/boot/logsPublicApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logsPublicApi.js","names":["createTrackingConsentState","startBufferingData","createPreStartStrategy","buildCommonContext","mockable","startLogs","Logger","makePublicApi","monitor","defineContextMethod","CustomerContextKey","ContextManagerMethod","sanitize","deepClone"],"sources":["../../src/boot/logsPublicApi.ts"],"sourcesContent":["import type {\n  TrackingConsent,\n  PublicApi,\n  ContextManager,\n  Account,\n  Context,\n  User,\n} from '@kubesense/kubesense-browser-core'\nimport {\n  ContextManagerMethod,\n  CustomerContextKey,\n  addTelemetryUsage,\n  makePublicApi,\n  sanitize,\n  displayAlreadyInitializedError,\n  createTrackingConsentState,\n  defineContextMethod,\n  startBufferingData,\n  mockable,\n} from '@kubesense/kubesense-browser-core'\nimport { monitor, callMonitored } from '@kubesense/kubesense-js-core/monitor'\nimport { deepClone } from '@kubesense/kubesense-js-core/util'\nimport type { LogsInitConfiguration } from '../domain/configuration'\nimport type { HandlerType } from '../domain/logger'\nimport type { StatusType } from '../domain/logger/isAuthorized'\nimport { Logger } from '../domain/logger'\nimport { buildCommonContext } from '../domain/contexts/commonContext'\nimport { callPluginsMethod } from '../domain/plugins'\nimport type { InternalContext } from '../domain/contexts/internalContext'\nimport type { StartLogsResult } from './startLogs'\nimport { startLogs } from './startLogs'\nimport { createPreStartStrategy } from './preStartLogs'\n\nexport interface LoggerConfiguration {\n  level?: StatusType\n  handler?: HandlerType | HandlerType[]\n  context?: object\n}\n\n/**\n * Public API for the Logs browser SDK.\n *\n * See [Browser Log Collection](https://docs.kubesense.ai/logs/log_collection/javascript) for further information.\n *\n * @category Main\n */\nexport interface LogsPublicApi extends PublicApi {\n  /**\n   * The default logger\n   *\n   * @category Logger\n   */\n  logger: Logger\n\n  /**\n   * Init the Logs browser SDK.\n   *\n   * See [Browser Log Collection](https://docs.kubesense.ai/logs/log_collection/javascript) for further information.\n   *\n   * @category Init\n   * @param initConfiguration - Configuration options of the SDK\n   */\n  init: (initConfiguration: LogsInitConfiguration) => void\n\n  /**\n   * Set the tracking consent of the current user.\n   *\n   * Logs 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/logs/log_collection/javascript/#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 the global context information to all events, stored in `@context`\n   * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-context) for further information.\n   *\n   * @category Context - Global Context\n   * @param context - Global context\n   */\n  setGlobalContext: (context: any) => void\n\n  /**\n   * Get the global Context\n   *\n   * See [Global context](https://docs.kubesense.ai/logs/log_collection/javascript/#overwrite-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/logs/log_collection/javascript/#overwrite-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/logs/log_collection/javascript/#overwrite-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/logs/log_collection/javascript/#overwrite-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/logs/log_collection/javascript/#user-context) 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/logs/log_collection/javascript/#user-context) 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/logs/log_collection/javascript/#user-context) 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/logs/log_collection/javascript/#user-context) 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/logs/log_collection/javascript/#user-context) 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  /**\n   * The KubeSense browser logs SDK contains a default logger `KUBESENSE_LOGS.logger`, but this API allows to create different ones.\n   *\n   * See [Define multiple loggers](https://docs.kubesense.ai/logs/log_collection/javascript/#define-multiple-loggers) for further information.\n   *\n   * @category Logger\n   * @param name - Name of the logger\n   * @param conf - Configuration of the logger (level, handler, context)\n   */\n  createLogger: (name: string, conf?: LoggerConfiguration) => Logger\n\n  /**\n   * Get a logger\n   *\n   * See [Define multiple loggers](https://docs.kubesense.ai/logs/log_collection/javascript/#define-multiple-loggers) for further information.\n   *\n   * @category Logger\n   * @param name - Name of the logger\n   */\n  getLogger: (name: string) => Logger | undefined\n\n  /**\n   * Get the init configuration\n   *\n   * @category Init\n   * @returns The init configuration\n   */\n  getInitConfiguration: () => LogsInitConfiguration | undefined\n\n  /**\n   * [Internal API] Get the internal SDK context\n   *\n   * See [Access internal context](https://docs.kubesense.ai/logs/log_collection/javascript/#access-internal-context) for further information.\n   *\n   * @internal\n   */\n  getInternalContext: (startTime?: number) => InternalContext | undefined\n}\n\nexport interface Strategy {\n  init: (initConfiguration: LogsInitConfiguration, publicApi: LogsPublicApi, errorStack?: string) => void\n  initConfiguration: LogsInitConfiguration | undefined\n  globalContext: ContextManager\n  accountContext: ContextManager\n  userContext: ContextManager\n  getInternalContext: StartLogsResult['getInternalContext']\n  handleLog: StartLogsResult['handleLog']\n}\n\nexport interface LogsPublicApiOptions {\n  sdkName?: string\n}\n\nexport function makeLogsPublicApi(options: LogsPublicApiOptions = {}): LogsPublicApi {\n  const trackingConsentState = createTrackingConsentState()\n  const bufferedDataObservable = startBufferingData().observable\n\n  let strategy = createPreStartStrategy(\n    buildCommonContext,\n    trackingConsentState,\n    (configuration, logsSessionManager, hooks) => {\n      const startLogsResult = mockable(startLogs)(\n        configuration,\n        logsSessionManager,\n        buildCommonContext,\n        bufferedDataObservable,\n        hooks\n      )\n\n      strategy = createPostStartStrategy(strategy, startLogsResult)\n      callPluginsMethod(configuration.plugins, 'onLogsStart', {\n        handleLog: startLogsResult.handleLog,\n      })\n      return startLogsResult\n    },\n    options.sdkName\n  )\n\n  const getStrategy = () => strategy\n\n  const customLoggers: { [name: string]: Logger | undefined } = {}\n\n  const mainLogger = new Logger((...params) => strategy.handleLog(...params))\n\n  const logsPublicApi: LogsPublicApi = makePublicApi<LogsPublicApi>({\n    logger: mainLogger,\n\n    init: (initConfiguration) => {\n      const errorStack = new Error().stack\n      callMonitored(() => strategy.init(initConfiguration, logsPublicApi, errorStack))\n    },\n\n    setTrackingConsent: monitor((trackingConsent) => {\n      trackingConsentState.update(trackingConsent)\n      addTelemetryUsage({ feature: 'set-tracking-consent', tracking_consent: trackingConsent })\n    }),\n\n    getGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.getContext\n    ),\n    setGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.setContext\n    ),\n\n    setGlobalContextProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.setContextProperty\n    ),\n\n    removeGlobalContextProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.removeContextProperty\n    ),\n\n    clearGlobalContext: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.globalContext,\n      ContextManagerMethod.clearContext\n    ),\n\n    createLogger: monitor((name, conf = {}) => {\n      customLoggers[name] = new Logger(\n        (...params) => strategy.handleLog(...params),\n        sanitize(name),\n        conf.handler,\n        conf.level,\n        sanitize(conf.context) as object\n      )\n\n      return customLoggers[name]\n    }),\n\n    getLogger: monitor((name) => customLoggers[name]),\n\n    getInitConfiguration: monitor(() => deepClone(strategy.initConfiguration)),\n\n    getInternalContext: monitor((startTime) => strategy.getInternalContext(startTime)),\n\n    setUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.setContext),\n\n    getUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.getContext),\n\n    setUserProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.setContextProperty\n    ),\n\n    removeUserProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.userContext,\n      ContextManagerMethod.removeContextProperty\n    ),\n\n    clearUser: defineContextMethod(getStrategy, CustomerContextKey.userContext, ContextManagerMethod.clearContext),\n\n    setAccount: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.setContext),\n\n    getAccount: defineContextMethod(getStrategy, CustomerContextKey.accountContext, ContextManagerMethod.getContext),\n\n    setAccountProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.setContextProperty\n    ),\n\n    removeAccountProperty: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.removeContextProperty\n    ),\n\n    clearAccount: defineContextMethod(\n      getStrategy,\n      CustomerContextKey.accountContext,\n      ContextManagerMethod.clearContext\n    ),\n  })\n\n  return logsPublicApi\n}\n\nfunction createPostStartStrategy(preStartStrategy: Strategy, startLogsResult: StartLogsResult): Strategy {\n  return {\n    ...preStartStrategy,\n    init: (initConfiguration: LogsInitConfiguration) => {\n      displayAlreadyInitializedError('KUBESENSE_LOGS', initConfiguration)\n    },\n    getInternalContext: startLogsResult.getInternalContext,\n    globalContext: startLogsResult.globalContext,\n    userContext: startLogsResult.userContext,\n    accountContext: startLogsResult.accountContext,\n  }\n}\n"],"mappings":"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"}

package/cjs/boot/preStartLogs.d.ts

@@ -0,0 +1,8 @@
+import type { TrackingConsentState, SessionManager } from '@kubesense/kubesense-browser-core';
+import type { Hooks } from '../domain/hooks';
+import type { LogsConfiguration } from '../domain/configuration';
+import type { CommonContext } from '../rawLogsEvent.types';
+import type { Strategy } from './logsPublicApi';
+import type { StartLogsResult } from './startLogs';
+export type DoStartLogs = (configuration: LogsConfiguration, sessionManager: SessionManager, hooks: Hooks) => StartLogsResult;
+export declare function createPreStartStrategy(getCommonContext: () => CommonContext, trackingConsentState: TrackingConsentState, doStartLogs: DoStartLogs, sdkName?: string): Strategy;

package/cjs/boot/preStartLogs.js

@@ -0,0 +1,105 @@
+const require_plugins = require("../domain/plugins.js");
+const require_hooks = require("../domain/hooks.js");
+const require_configuration = require("../domain/configuration.js");
+const require_remoteSdkConfiguration = require("../domain/remoteSdkConfiguration.js");
+const require_trackingConsentContext = require("../domain/contexts/trackingConsentContext.js");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+let _kubesense_kubesense_js_core_monitor = require("@kubesense/kubesense-js-core/monitor");
+let _kubesense_kubesense_js_core_time = require("@kubesense/kubesense-js-core/time");
+//#region src/boot/preStartLogs.ts
+function createPreStartStrategy(getCommonContext, trackingConsentState, doStartLogs, sdkName) {
+	const bufferApiCalls = new _kubesense_kubesense_browser_core.BufferedObservable(500, (count) => {
+		(0, _kubesense_kubesense_browser_core.addTelemetryDebug)("preStartLogs buffer data lost", { count });
+	});
+	const globalContext = (0, _kubesense_kubesense_browser_core.buildGlobalContextManager)();
+	(0, _kubesense_kubesense_browser_core.bufferContextCalls)(globalContext, _kubesense_kubesense_browser_core.CustomerContextKey.globalContext, bufferApiCalls);
+	const accountContext = (0, _kubesense_kubesense_browser_core.buildAccountContextManager)();
+	(0, _kubesense_kubesense_browser_core.bufferContextCalls)(accountContext, _kubesense_kubesense_browser_core.CustomerContextKey.accountContext, bufferApiCalls);
+	const userContext = (0, _kubesense_kubesense_browser_core.buildUserContextManager)();
+	(0, _kubesense_kubesense_browser_core.bufferContextCalls)(userContext, _kubesense_kubesense_browser_core.CustomerContextKey.userContext, bufferApiCalls);
+	let cachedInitConfiguration;
+	let cachedConfiguration;
+	let sessionManager;
+	const hooks = require_hooks.createHooks();
+	const trackingConsentStateSubscription = trackingConsentState.observable.subscribe(tryStartLogs);
+	function tryStartLogs() {
+		if (!cachedConfiguration || !cachedInitConfiguration || !sessionManager) return;
+		trackingConsentStateSubscription.unsubscribe();
+		const startLogsResult = doStartLogs(cachedConfiguration, sessionManager, hooks);
+		bufferApiCalls.subscribe((callback) => callback(startLogsResult));
+		bufferApiCalls.unbuffer();
+	}
+	return {
+		init(initConfiguration, publicApi, errorStack) {
+			if (!initConfiguration) {
+				_kubesense_kubesense_browser_core.display.error("Missing configuration");
+				return;
+			}
+			(0, _kubesense_kubesense_browser_core.initFeatureFlags)(initConfiguration.enableExperimentalFeatures);
+			(0, _kubesense_kubesense_browser_core.setAllowUntrustedEvents)(initConfiguration.allowUntrustedEvents);
+			if ((0, _kubesense_kubesense_browser_core.canUseEventBridge)()) initConfiguration = overrideInitConfigurationForBridge(initConfiguration);
+			const remoteSdkConfigurationEnabled = !!initConfiguration.enableRemoteSdkConfiguration;
+			const refreshRemoteSdkConfiguration = () => {
+				if (remoteSdkConfigurationEnabled) require_remoteSdkConfiguration.scheduleLogsSdkConfigurationRefresh(initConfiguration).catch(_kubesense_kubesense_browser_core.noop);
+			};
+			if (remoteSdkConfigurationEnabled) {
+				const cachedSdkConfiguration = require_remoteSdkConfiguration.applyCachedLogsSdkConfiguration(initConfiguration);
+				initConfiguration = cachedSdkConfiguration.initConfiguration;
+				if (!cachedSdkConfiguration.logsEnabled) {
+					cachedInitConfiguration = initConfiguration;
+					refreshRemoteSdkConfiguration();
+					return;
+				}
+			}
+			cachedInitConfiguration = initConfiguration;
+			if (cachedConfiguration) {
+				(0, _kubesense_kubesense_browser_core.displayAlreadyInitializedError)("KUBESENSE_LOGS", initConfiguration);
+				return;
+			}
+			require_plugins.callPluginsMethod(initConfiguration.plugins, "onInit", {
+				initConfiguration,
+				publicApi,
+				registerAssembleEventHook: hooks.assembleEvent.register
+			});
+			const configuration = require_configuration.validateAndBuildLogsConfiguration(initConfiguration);
+			if (!configuration || !(0, _kubesense_kubesense_browser_core.isAllowedTrackingOrigins)(configuration, errorStack ?? "")) {
+				refreshRemoteSdkConfiguration();
+				return;
+			}
+			cachedConfiguration = configuration;
+			trackingConsentState.tryToInit(configuration.trackingConsent);
+			trackingConsentState.onGrantedOnce(() => {
+				require_trackingConsentContext.startTrackingConsentContext(hooks, trackingConsentState);
+				(0, _kubesense_kubesense_browser_core.mockable)(_kubesense_kubesense_browser_core.startTelemetry)(_kubesense_kubesense_browser_core.TelemetryService.LOGS, configuration, hooks.assembleTelemetry, sdkName);
+				((0, _kubesense_kubesense_browser_core.canUseEventBridge)() ? (0, _kubesense_kubesense_browser_core.startSessionManagerStub)() : (0, _kubesense_kubesense_browser_core.mockable)(_kubesense_kubesense_browser_core.startSessionManager)(configuration, trackingConsentState)).then((newSessionManager) => {
+					if (!newSessionManager) return;
+					sessionManager = newSessionManager;
+					(0, _kubesense_kubesense_browser_core.startTelemetrySessionContext)(hooks.assembleTelemetry, sessionManager);
+					(0, _kubesense_kubesense_browser_core.addTelemetryConfiguration)(require_configuration.serializeLogsConfiguration(initConfiguration));
+					tryStartLogs();
+					refreshRemoteSdkConfiguration();
+				}).catch(_kubesense_kubesense_js_core_monitor.monitorError);
+			});
+		},
+		get initConfiguration() {
+			return cachedInitConfiguration;
+		},
+		globalContext,
+		accountContext,
+		userContext,
+		getInternalContext: _kubesense_kubesense_browser_core.noop,
+		handleLog(message, statusType, handlingStack, context = getCommonContext(), date = (0, _kubesense_kubesense_js_core_time.timeStampNow)()) {
+			bufferApiCalls.notify((startLogsResult) => startLogsResult.handleLog(message, statusType, handlingStack, context, date));
+		}
+	};
+}
+function overrideInitConfigurationForBridge(initConfiguration) {
+	return {
+		...initConfiguration,
+		clientToken: "empty"
+	};
+}
+//#endregion
+exports.createPreStartStrategy = createPreStartStrategy;
+
+//# sourceMappingURL=preStartLogs.js.map

package/cjs/boot/preStartLogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preStartLogs.js","names":["BufferedObservable","buildGlobalContextManager","CustomerContextKey","buildAccountContextManager","buildUserContextManager","createHooks","canUseEventBridge","noop","applyCachedLogsSdkConfiguration","validateAndBuildLogsConfiguration","isAllowedTrackingOrigins","startTelemetry","TelemetryService","startSessionManagerStub","mockable","startSessionManager","serializeLogsConfiguration","monitorError","timeStampNow"],"sources":["../../src/boot/preStartLogs.ts"],"sourcesContent":["import { timeStampNow } from '@kubesense/kubesense-js-core/time'\nimport { monitorError } from '@kubesense/kubesense-js-core/monitor'\nimport type { TrackingConsentState, SessionManager } from '@kubesense/kubesense-browser-core'\nimport {\n  BufferedObservable,\n  canUseEventBridge,\n  display,\n  displayAlreadyInitializedError,\n  initFeatureFlags,\n  noop,\n  buildAccountContextManager,\n  CustomerContextKey,\n  bufferContextCalls,\n  addTelemetryConfiguration,\n  addTelemetryDebug,\n  buildGlobalContextManager,\n  buildUserContextManager,\n  startSessionManager,\n  startSessionManagerStub,\n  startTelemetry,\n  TelemetryService,\n  mockable,\n  startTelemetrySessionContext,\n  setAllowUntrustedEvents,\n  isAllowedTrackingOrigins,\n} from '@kubesense/kubesense-browser-core'\nimport type { Hooks } from '../domain/hooks'\nimport { createHooks } from '../domain/hooks'\nimport type { LogsConfiguration, LogsInitConfiguration } from '../domain/configuration'\nimport { serializeLogsConfiguration, validateAndBuildLogsConfiguration } from '../domain/configuration'\nimport { applyCachedLogsSdkConfiguration, scheduleLogsSdkConfigurationRefresh } from '../domain/remoteSdkConfiguration'\nimport type { CommonContext } from '../rawLogsEvent.types'\nimport { startTrackingConsentContext } from '../domain/contexts/trackingConsentContext'\nimport { callPluginsMethod } from '../domain/plugins'\nimport type { Strategy } from './logsPublicApi'\nimport type { StartLogsResult } from './startLogs'\n\nexport type DoStartLogs = (\n  configuration: LogsConfiguration,\n  sessionManager: SessionManager,\n  hooks: Hooks\n) => StartLogsResult\n\nexport function createPreStartStrategy(\n  getCommonContext: () => CommonContext,\n  trackingConsentState: TrackingConsentState,\n  doStartLogs: DoStartLogs,\n  sdkName?: string\n): Strategy {\n  const BUFFER_LIMIT = 500\n  const bufferApiCalls = new BufferedObservable<(startLogsResult: StartLogsResult) => void>(BUFFER_LIMIT, (count) => {\n    // monitor-until: 2026-10-14\n    addTelemetryDebug('preStartLogs buffer data lost', { count })\n  })\n\n  // TODO next major: remove the globalContext, accountContextManager, userContext from preStartStrategy and use an empty context instead\n  const globalContext = buildGlobalContextManager()\n  bufferContextCalls(globalContext, CustomerContextKey.globalContext, bufferApiCalls)\n\n  const accountContext = buildAccountContextManager()\n  bufferContextCalls(accountContext, CustomerContextKey.accountContext, bufferApiCalls)\n\n  const userContext = buildUserContextManager()\n  bufferContextCalls(userContext, CustomerContextKey.userContext, bufferApiCalls)\n\n  let cachedInitConfiguration: LogsInitConfiguration | undefined\n  let cachedConfiguration: LogsConfiguration | undefined\n  let sessionManager: SessionManager | undefined\n  const hooks = createHooks()\n  const trackingConsentStateSubscription = trackingConsentState.observable.subscribe(tryStartLogs)\n\n  function tryStartLogs() {\n    if (!cachedConfiguration || !cachedInitConfiguration || !sessionManager) {\n      return\n    }\n\n    trackingConsentStateSubscription.unsubscribe()\n    const startLogsResult = doStartLogs(cachedConfiguration, sessionManager, hooks)\n\n    bufferApiCalls.subscribe((callback) => callback(startLogsResult))\n    bufferApiCalls.unbuffer()\n  }\n\n  return {\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      if (canUseEventBridge()) {\n        initConfiguration = overrideInitConfigurationForBridge(initConfiguration)\n      }\n\n      const remoteSdkConfigurationEnabled = !!initConfiguration.enableRemoteSdkConfiguration\n\n      // A cached document that stops Logs 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\n      // never learn about a corrected one.\n      const refreshRemoteSdkConfiguration = () => {\n        if (remoteSdkConfigurationEnabled) {\n          scheduleLogsSdkConfigurationRefresh(initConfiguration).catch(noop)\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 = applyCachedLogsSdkConfiguration(initConfiguration)\n        initConfiguration = cachedSdkConfiguration.initConfiguration\n\n        if (!cachedSdkConfiguration.logsEnabled) {\n          // Logs is switched off from the dashboard. Still refresh the document, otherwise the\n          // switch would be one-way: the SDK could never learn it has been turned back on.\n          cachedInitConfiguration = initConfiguration\n          refreshRemoteSdkConfiguration()\n          return\n        }\n      }\n\n      // Expose the initial configuration regardless of initialization success.\n      cachedInitConfiguration = initConfiguration\n\n      if (cachedConfiguration) {\n        displayAlreadyInitializedError('KUBESENSE_LOGS', initConfiguration)\n        return\n      }\n\n      callPluginsMethod(initConfiguration.plugins, 'onInit', {\n        initConfiguration,\n        publicApi,\n        registerAssembleEventHook: hooks.assembleEvent.register,\n      })\n\n      const configuration = validateAndBuildLogsConfiguration(initConfiguration)\n      if (!configuration || !isAllowedTrackingOrigins(configuration, errorStack ?? '')) {\n        refreshRemoteSdkConfiguration()\n        return\n      }\n\n      cachedConfiguration = configuration\n\n      trackingConsentState.tryToInit(configuration.trackingConsent)\n\n      trackingConsentState.onGrantedOnce(() => {\n        startTrackingConsentContext(hooks, trackingConsentState)\n        mockable(startTelemetry)(TelemetryService.LOGS, configuration, hooks.assembleTelemetry, sdkName)\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(hooks.assembleTelemetry, sessionManager)\n            addTelemetryConfiguration(serializeLogsConfiguration(initConfiguration))\n            tryStartLogs()\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    get initConfiguration() {\n      return cachedInitConfiguration\n    },\n\n    globalContext,\n    accountContext,\n    userContext,\n\n    getInternalContext: noop as () => undefined,\n\n    handleLog(message, statusType, handlingStack, context = getCommonContext(), date = timeStampNow()) {\n      bufferApiCalls.notify((startLogsResult) =>\n        startLogsResult.handleLog(message, statusType, handlingStack, context, date)\n      )\n    },\n  }\n}\n\nfunction overrideInitConfigurationForBridge(initConfiguration: LogsInitConfiguration): LogsInitConfiguration {\n  return { ...initConfiguration, clientToken: 'empty' }\n}\n"],"mappings":"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"}

package/cjs/boot/startLogs.d.ts

@@ -0,0 +1,35 @@
+import type { BufferedObservable, BufferedData, SessionManager } from '@kubesense/kubesense-browser-core';
+import type { LogsConfiguration } from '../domain/configuration';
+import type { CommonContext } from '../rawLogsEvent.types';
+import type { Hooks } from '../domain/hooks';
+export type StartLogs = typeof startLogs;
+export type StartLogsResult = ReturnType<StartLogs>;
+export declare function startLogs(configuration: LogsConfiguration, sessionManager: SessionManager, getCommonContext: () => CommonContext, bufferedDataObservable: BufferedObservable<BufferedData>, hooks: Hooks): {
+    handleLog: (logsMessage: import("../domain/logger").LogsMessage, logger: import("../domain/logger").Logger, handlingStack?: string, savedCommonContext?: CommonContext, savedDate?: import("@kubesense/kubesense-js-core/time").TimeStamp) => void;
+    getInternalContext: (startTime?: number) => import("../entries/main").InternalContext | undefined;
+    accountContext: {
+        getContext: () => import("@kubesense/kubesense-browser-core").Context;
+        setContext: (newContext: unknown) => void;
+        setContextProperty: (key: string, property: any) => void;
+        removeContextProperty: (key: string) => void;
+        clearContext: () => void;
+        changeObservable: import("@kubesense/kubesense-browser-core").Observable<void>;
+    };
+    globalContext: {
+        getContext: () => import("@kubesense/kubesense-browser-core").Context;
+        setContext: (newContext: unknown) => void;
+        setContextProperty: (key: string, property: any) => void;
+        removeContextProperty: (key: string) => void;
+        clearContext: () => void;
+        changeObservable: import("@kubesense/kubesense-browser-core").Observable<void>;
+    };
+    userContext: {
+        getContext: () => import("@kubesense/kubesense-browser-core").Context;
+        setContext: (newContext: unknown) => void;
+        setContextProperty: (key: string, property: any) => void;
+        removeContextProperty: (key: string) => void;
+        clearContext: () => void;
+        changeObservable: import("@kubesense/kubesense-browser-core").Observable<void>;
+    };
+    stop: () => void;
+};

package/cjs/boot/startLogs.js

@@ -0,0 +1,54 @@
+const require_lifeCycle = require("../domain/lifeCycle.js");
+const require_assembly = require("../domain/assembly.js");
+const require_consoleCollection = require("../domain/console/consoleCollection.js");
+const require_reportCollection = require("../domain/report/reportCollection.js");
+const require_networkErrorCollection = require("../domain/networkError/networkErrorCollection.js");
+const require_runtimeErrorCollection = require("../domain/runtimeError/runtimeErrorCollection.js");
+const require_loggerCollection = require("../domain/logger/loggerCollection.js");
+const require_startLogsBatch = require("../transport/startLogsBatch.js");
+const require_startLogsBridge = require("../transport/startLogsBridge.js");
+const require_internalContext = require("../domain/contexts/internalContext.js");
+const require_reportError = require("../domain/reportError.js");
+const require_rumInternalContext = require("../domain/contexts/rumInternalContext.js");
+const require_sessionContext = require("../domain/contexts/sessionContext.js");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+//#region src/boot/startLogs.ts
+const LOGS_STORAGE_KEY = "logs";
+function startLogs(configuration, sessionManager, getCommonContext, bufferedDataObservable, hooks) {
+	const lifeCycle = new require_lifeCycle.LifeCycle();
+	const cleanupTasks = [];
+	lifeCycle.subscribe(1, (log) => (0, _kubesense_kubesense_browser_core.sendToExtension)("logs", log));
+	const reportError = require_reportError.startReportError(lifeCycle);
+	const { assembleEventDefaults: assembleHook } = hooks;
+	require_sessionContext.startSessionContext(assembleHook, configuration, sessionManager);
+	const accountContext = (0, _kubesense_kubesense_browser_core.startAccountContext)(assembleHook, configuration, LOGS_STORAGE_KEY);
+	const userContext = (0, _kubesense_kubesense_browser_core.startUserContext)(assembleHook, configuration, sessionManager, LOGS_STORAGE_KEY);
+	const globalContext = (0, _kubesense_kubesense_browser_core.startGlobalContext)(assembleHook, configuration, LOGS_STORAGE_KEY, false);
+	require_rumInternalContext.startRUMInternalContext(hooks);
+	(0, _kubesense_kubesense_browser_core.startTabContext)(assembleHook);
+	require_networkErrorCollection.startNetworkErrorCollection(configuration, lifeCycle, bufferedDataObservable);
+	require_runtimeErrorCollection.startRuntimeErrorCollection(configuration, lifeCycle, bufferedDataObservable);
+	require_consoleCollection.startConsoleCollection(configuration, lifeCycle, bufferedDataObservable);
+	bufferedDataObservable.unbuffer();
+	require_reportCollection.startReportCollection(configuration, lifeCycle);
+	const { handleLog } = require_loggerCollection.startLoggerCollection(lifeCycle);
+	require_assembly.startLogsAssembly(configuration, lifeCycle, hooks, getCommonContext, reportError);
+	if (!(0, _kubesense_kubesense_browser_core.canUseEventBridge)()) {
+		const { stop: stopLogsBatch } = require_startLogsBatch.startLogsBatch(configuration, lifeCycle, reportError, sessionManager);
+		cleanupTasks.push(() => stopLogsBatch());
+	} else require_startLogsBridge.startLogsBridge(lifeCycle);
+	return {
+		handleLog,
+		getInternalContext: require_internalContext.startInternalContext(sessionManager).get,
+		accountContext,
+		globalContext,
+		userContext,
+		stop: () => {
+			cleanupTasks.forEach((task) => task());
+		}
+	};
+}
+//#endregion
+exports.startLogs = startLogs;
+
+//# sourceMappingURL=startLogs.js.map

package/cjs/boot/startLogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startLogs.js","names":["LifeCycle","sendToExtension","startReportError","startAccountContext","startUserContext","startGlobalContext","startLoggerCollection","canUseEventBridge","startLogsBatch","startInternalContext"],"sources":["../../src/boot/startLogs.ts"],"sourcesContent":["import type { BufferedObservable, BufferedData, SessionManager } from '@kubesense/kubesense-browser-core'\nimport {\n  sendToExtension,\n  canUseEventBridge,\n  startAccountContext,\n  startGlobalContext,\n  startUserContext,\n  startTabContext,\n} from '@kubesense/kubesense-browser-core'\nimport type { LogsConfiguration } from '../domain/configuration'\nimport { startLogsAssembly } from '../domain/assembly'\nimport { startConsoleCollection } from '../domain/console/consoleCollection'\nimport { startReportCollection } from '../domain/report/reportCollection'\nimport { startNetworkErrorCollection } from '../domain/networkError/networkErrorCollection'\nimport { startRuntimeErrorCollection } from '../domain/runtimeError/runtimeErrorCollection'\nimport { LifeCycle, LifeCycleEventType } from '../domain/lifeCycle'\nimport { startLoggerCollection } from '../domain/logger/loggerCollection'\nimport { startLogsBatch } from '../transport/startLogsBatch'\nimport { startLogsBridge } from '../transport/startLogsBridge'\nimport { startInternalContext } from '../domain/contexts/internalContext'\nimport { startReportError } from '../domain/reportError'\nimport type { CommonContext } from '../rawLogsEvent.types'\nimport type { Hooks } from '../domain/hooks'\nimport { startRUMInternalContext } from '../domain/contexts/rumInternalContext'\nimport { startSessionContext } from '../domain/contexts/sessionContext'\n\nconst LOGS_STORAGE_KEY = 'logs'\n\nexport type StartLogs = typeof startLogs\nexport type StartLogsResult = ReturnType<StartLogs>\n\nexport function startLogs(\n  configuration: LogsConfiguration,\n  sessionManager: SessionManager,\n  getCommonContext: () => CommonContext,\n  bufferedDataObservable: BufferedObservable<BufferedData>,\n  hooks: Hooks\n) {\n  const lifeCycle = new LifeCycle()\n  const cleanupTasks: Array<() => void> = []\n\n  lifeCycle.subscribe(LifeCycleEventType.LOG_COLLECTED, (log) => sendToExtension('logs', log))\n\n  const reportError = startReportError(lifeCycle)\n\n  // Start user and account context first to allow overrides from global context\n  const { assembleEventDefaults: assembleHook } = hooks\n  startSessionContext(assembleHook, configuration, sessionManager)\n  const accountContext = startAccountContext(assembleHook, configuration, LOGS_STORAGE_KEY)\n  const userContext = startUserContext(assembleHook, configuration, sessionManager, LOGS_STORAGE_KEY)\n  const globalContext = startGlobalContext(assembleHook, configuration, LOGS_STORAGE_KEY, false)\n  startRUMInternalContext(hooks)\n  startTabContext(assembleHook)\n\n  startNetworkErrorCollection(configuration, lifeCycle, bufferedDataObservable)\n  startRuntimeErrorCollection(configuration, lifeCycle, bufferedDataObservable)\n  startConsoleCollection(configuration, lifeCycle, bufferedDataObservable)\n  bufferedDataObservable.unbuffer()\n  startReportCollection(configuration, lifeCycle)\n  const { handleLog } = startLoggerCollection(lifeCycle)\n\n  startLogsAssembly(configuration, lifeCycle, hooks, getCommonContext, reportError)\n\n  if (!canUseEventBridge()) {\n    const { stop: stopLogsBatch } = startLogsBatch(configuration, lifeCycle, reportError, sessionManager)\n    cleanupTasks.push(() => stopLogsBatch())\n  } else {\n    startLogsBridge(lifeCycle)\n  }\n\n  const internalContext = startInternalContext(sessionManager)\n\n  return {\n    handleLog,\n    getInternalContext: internalContext.get,\n    accountContext,\n    globalContext,\n    userContext,\n    stop: () => {\n      cleanupTasks.forEach((task) => task())\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAM,mBAAmB;AAKzB,SAAgB,UACd,eACA,gBACA,kBACA,wBACA,OACA;CACA,MAAM,YAAY,IAAIA,kBAAAA,UAAU;CAChC,MAAM,eAAkC,CAAC;CAEzC,UAAU,UAAA,IAA6C,SAAA,GAAQC,kCAAAA,gBAAAA,CAAgB,QAAQ,GAAG,CAAC;CAE3F,MAAM,cAAcC,oBAAAA,iBAAiB,SAAS;CAG9C,MAAM,EAAE,uBAAuB,iBAAiB;CAChD,uBAAA,oBAAoB,cAAc,eAAe,cAAc;CAC/D,MAAM,kBAAA,GAAiBC,kCAAAA,oBAAAA,CAAoB,cAAc,eAAe,gBAAgB;CACxF,MAAM,eAAA,GAAcC,kCAAAA,iBAAAA,CAAiB,cAAc,eAAe,gBAAgB,gBAAgB;CAClG,MAAM,iBAAA,GAAgBC,kCAAAA,mBAAAA,CAAmB,cAAc,eAAe,kBAAkB,KAAK;CAC7F,2BAAA,wBAAwB,KAAK;CAC7B,CAAA,GAAA,kCAAA,gBAAA,CAAgB,YAAY;CAE5B,+BAAA,4BAA4B,eAAe,WAAW,sBAAsB;CAC5E,+BAAA,4BAA4B,eAAe,WAAW,sBAAsB;CAC5E,0BAAA,uBAAuB,eAAe,WAAW,sBAAsB;CACvE,uBAAuB,SAAS;CAChC,yBAAA,sBAAsB,eAAe,SAAS;CAC9C,MAAM,EAAE,cAAcC,yBAAAA,sBAAsB,SAAS;CAErD,iBAAA,kBAAkB,eAAe,WAAW,OAAO,kBAAkB,WAAW;CAEhF,IAAI,EAAA,GAACC,kCAAAA,kBAAAA,CAAkB,GAAG;EACxB,MAAM,EAAE,MAAM,kBAAkBC,uBAAAA,eAAe,eAAe,WAAW,aAAa,cAAc;EACpG,aAAa,WAAW,cAAc,CAAC;CACzC,OACE,wBAAA,gBAAgB,SAAS;CAK3B,OAAO;EACL;EACA,oBAJsBC,wBAAAA,qBAAqB,cAIT,CAAC,CAAC;EACpC;EACA;EACA;EACA,YAAY;GACV,aAAa,SAAS,SAAS,KAAK,CAAC;EACvC;CACF;AACF"}

package/cjs/domain/assembly.d.ts

@@ -0,0 +1,5 @@
+import type { CommonContext } from '../rawLogsEvent.types';
+import type { LogsConfiguration } from './configuration';
+import type { LifeCycle } from './lifeCycle';
+import type { Hooks } from './hooks';
+export declare function startLogsAssembly(configuration: LogsConfiguration, lifeCycle: LifeCycle, hooks: Hooks, getCommonContext: () => CommonContext, reportError: (message: string) => void, eventRateLimit?: number): void;

package/cjs/domain/assembly.js

@@ -0,0 +1,35 @@
+const require_logger = require("./logger.js");
+require("./lifeCycle.js");
+let _kubesense_kubesense_js_core_util = require("@kubesense/kubesense-js-core/util");
+let _kubesense_kubesense_browser_core = require("@kubesense/kubesense-browser-core");
+let _kubesense_kubesense_js_core_time = require("@kubesense/kubesense-js-core/time");
+let _kubesense_kubesense_js_core_assembly = require("@kubesense/kubesense-js-core/assembly");
+//#region src/domain/assembly.ts
+function startLogsAssembly(configuration, lifeCycle, hooks, getCommonContext, reportError, eventRateLimit) {
+	const statusWithCustom = require_logger.STATUSES.concat(["custom"]);
+	const logRateLimiters = {};
+	statusWithCustom.forEach((status) => {
+		logRateLimiters[status] = (0, _kubesense_kubesense_browser_core.createEventRateLimiter)(status, reportError, eventRateLimit);
+	});
+	lifeCycle.subscribe(0, ({ rawLogsEvent, savedCommonContext = void 0, domainContext, ktags = [] }) => {
+		const startTime = (0, _kubesense_kubesense_js_core_time.toRelativeTime)(rawLogsEvent.date);
+		const commonContext = savedCommonContext || getCommonContext();
+		const assemblyParams = {
+			startTime,
+			rawLogsEvent,
+			domainContext
+		};
+		const defaultLogsEventAttributes = hooks.assembleEventDefaults.trigger(assemblyParams);
+		if (defaultLogsEventAttributes === _kubesense_kubesense_js_core_assembly.DISCARDED) return;
+		const logsEventAttributes = hooks.assembleEvent.trigger(assemblyParams);
+		if (logsEventAttributes === _kubesense_kubesense_js_core_assembly.DISCARDED) return;
+		const defaultKtags = (0, _kubesense_kubesense_browser_core.buildTags)(configuration);
+		const log = (0, _kubesense_kubesense_js_core_util.combine)({ view: commonContext.view }, defaultLogsEventAttributes, rawLogsEvent, logsEventAttributes, { ktags: defaultKtags.concat(ktags).join(",") });
+		if (configuration.beforeSend?.(log, domainContext) === false || log.origin !== _kubesense_kubesense_browser_core.ErrorSource.AGENT && (logRateLimiters[log.status] ?? logRateLimiters["custom"]).isLimitReached()) return;
+		lifeCycle.notify(1, log);
+	});
+}
+//#endregion
+exports.startLogsAssembly = startLogsAssembly;
+
+//# sourceMappingURL=assembly.js.map