@kubesense/kubesense-browser-core 1.7.0 → 2.0.0-beta.0

package/esm/domain/context/contextUtils.mjs

@@ -0,0 +1,15 @@
+import { display } from "../../tools/display.mjs";
+import { getType } from "@kubesense/kubesense-js-core/util";
+//#region src/domain/context/contextUtils.ts
+/**
+* Simple check to ensure an object is a valid context
+*/
+function checkContext(maybeContext) {
+	const isValid = getType(maybeContext) === "object";
+	if (!isValid) display.error("Unsupported context:", maybeContext);
+	return isValid;
+}
+//#endregion
+export { checkContext };
+
+//# sourceMappingURL=contextUtils.mjs.map

package/esm/domain/context/contextUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextUtils.mjs","names":[],"sources":["../../../src/domain/context/contextUtils.ts"],"sourcesContent":["import { getType } from '@kubesense/kubesense-js-core/util'\nimport type { Context } from '../../tools/serialisation/context'\nimport { display } from '../../tools/display'\n\n/**\n * Simple check to ensure an object is a valid context\n */\nexport function checkContext(maybeContext: unknown): maybeContext is Context {\n  const isValid = getType(maybeContext) === 'object'\n  if (!isValid) {\n    display.error('Unsupported context:', maybeContext)\n  }\n  return isValid\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aAAa,cAAgD;CAC3E,MAAM,UAAU,QAAQ,YAAY,MAAM;CAC1C,IAAI,CAAC,SACH,QAAQ,MAAM,wBAAwB,YAAY;CAEpD,OAAO;AACT"}

package/esm/domain/context/defineContextMethod.mjs

@@ -0,0 +1,19 @@
+import { addTelemetryUsage } from "../telemetry/telemetry.mjs";
+import { monitor } from "@kubesense/kubesense-js-core/monitor";
+//#region src/domain/context/defineContextMethod.ts
+function defineContextMethod(getStrategy, contextName, methodName, usage) {
+	return monitor((...args) => {
+		if (usage) addTelemetryUsage({ feature: usage });
+		return getStrategy()[contextName][methodName](...args);
+	});
+}
+function bufferContextCalls(preStartContextManager, name, bufferApiCalls) {
+	preStartContextManager.changeObservable.subscribe(() => {
+		const context = preStartContextManager.getContext();
+		bufferApiCalls.notify((startResult) => startResult[name].setContext(context));
+	});
+}
+//#endregion
+export { bufferContextCalls, defineContextMethod };
+
+//# sourceMappingURL=defineContextMethod.mjs.map

package/esm/domain/context/defineContextMethod.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineContextMethod.mjs","names":[],"sources":["../../../src/domain/context/defineContextMethod.ts"],"sourcesContent":["import { monitor } from '@kubesense/kubesense-js-core/monitor'\nimport type { RawTelemetryUsage, RawTelemetryUsageFeature } from '../telemetry'\nimport { addTelemetryUsage } from '../telemetry'\nimport type { BufferedObservable } from '../../tools/observable'\nimport type { ContextManager } from './contextManager'\nimport type { ContextManagerMethod, CustomerContextKey } from './contextConstants'\n\nexport function defineContextMethod<MethodName extends ContextManagerMethod, Key extends CustomerContextKey>(\n  getStrategy: () => Record<Key, ContextManager>,\n  contextName: Key,\n  methodName: MethodName,\n  usage?: RawTelemetryUsageFeature\n): ContextManager[MethodName] {\n  return monitor((...args: any[]) => {\n    if (usage) {\n      addTelemetryUsage({ feature: usage } as RawTelemetryUsage)\n    }\n    return (getStrategy()[contextName][methodName] as (...args: unknown[]) => unknown)(...args)\n  }) as ContextManager[MethodName]\n}\n\nexport function bufferContextCalls<Key extends string, StartResult extends Record<Key, ContextManager>>(\n  preStartContextManager: ContextManager,\n  name: Key,\n  bufferApiCalls: BufferedObservable<(startResult: StartResult) => void>\n) {\n  preStartContextManager.changeObservable.subscribe(() => {\n    const context = preStartContextManager.getContext()\n    bufferApiCalls.notify((startResult) => startResult[name].setContext(context))\n  })\n}\n"],"mappings":";;;AAOA,SAAgB,oBACd,aACA,aACA,YACA,OAC4B;CAC5B,OAAO,SAAS,GAAG,SAAgB;EACjC,IAAI,OACF,kBAAkB,EAAE,SAAS,MAAM,CAAsB;EAE3D,OAAQ,YAAY,CAAC,CAAC,YAAY,CAAC,WAAW,CAAqC,GAAG,IAAI;CAC5F,CAAC;AACH;AAEA,SAAgB,mBACd,wBACA,MACA,gBACA;CACA,uBAAuB,iBAAiB,gBAAgB;EACtD,MAAM,UAAU,uBAAuB,WAAW;EAClD,eAAe,QAAQ,gBAAgB,YAAY,KAAK,CAAC,WAAW,OAAO,CAAC;CAC9E,CAAC;AACH"}

package/esm/domain/context/storeContextManager.mjs

@@ -0,0 +1,36 @@
+import { isEmptyObject, tryJsonParse } from "../../tools/utils/objectUtils.mjs";
+import { addEventListener } from "../../browser/addEventListener.mjs";
+import { combine } from "@kubesense/kubesense-js-core/util";
+//#region src/domain/context/storeContextManager.ts
+const CONTEXT_STORE_KEY_PREFIX = "_kubesense_c";
+const storageListeners = [];
+function storeContextManager(contextManager, productKey, customerDataType) {
+	if (typeof window === "undefined" || typeof localStorage === "undefined") return;
+	const storageKey = buildStorageKey(productKey, customerDataType);
+	storageListeners.push(addEventListener(window, "storage", ({ key }) => {
+		if (storageKey === key) synchronizeWithStorage();
+	}));
+	contextManager.changeObservable.subscribe(dumpToStorage);
+	const contextFromStorage = combine(getFromStorage(), contextManager.getContext());
+	if (!isEmptyObject(contextFromStorage)) contextManager.setContext(contextFromStorage);
+	function synchronizeWithStorage() {
+		contextManager.setContext(getFromStorage());
+	}
+	function dumpToStorage() {
+		localStorage.setItem(storageKey, JSON.stringify(contextManager.getContext()));
+	}
+	function getFromStorage() {
+		const rawContext = localStorage.getItem(storageKey);
+		return rawContext ? tryJsonParse(rawContext) ?? {} : {};
+	}
+}
+function buildStorageKey(productKey, customerDataType) {
+	return `${CONTEXT_STORE_KEY_PREFIX}_${productKey}_${customerDataType}`;
+}
+function removeStorageListeners() {
+	storageListeners.map((listener) => listener.stop());
+}
+//#endregion
+export { buildStorageKey, removeStorageListeners, storeContextManager };
+
+//# sourceMappingURL=storeContextManager.mjs.map

package/esm/domain/context/storeContextManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeContextManager.mjs","names":[],"sources":["../../../src/domain/context/storeContextManager.ts"],"sourcesContent":["import { combine } from '@kubesense/kubesense-js-core/util'\nimport { addEventListener, DOM_EVENT } from '../../browser/addEventListener'\nimport type { Context } from '../../tools/serialisation/context'\nimport { isEmptyObject, tryJsonParse } from '../../tools/utils/objectUtils'\nimport type { ContextManager } from './contextManager'\nimport type { CustomerDataType } from './contextConstants'\n\nconst CONTEXT_STORE_KEY_PREFIX = '_kubesense_c'\n\nconst storageListeners: Array<{ stop: () => void }> = []\n\nexport function storeContextManager(\n  contextManager: ContextManager,\n  productKey: string,\n  customerDataType: CustomerDataType\n) {\n  // window and localStorage are not available in Web Workers or Node.js environments\n  if (typeof window === 'undefined' || typeof localStorage === 'undefined') {\n    return\n  }\n\n  const storageKey = buildStorageKey(productKey, customerDataType)\n\n  storageListeners.push(\n    addEventListener(window, DOM_EVENT.STORAGE, ({ key }) => {\n      if (storageKey === key) {\n        synchronizeWithStorage()\n      }\n    })\n  )\n  contextManager.changeObservable.subscribe(dumpToStorage)\n\n  const contextFromStorage = combine(getFromStorage(), contextManager.getContext())\n  if (!isEmptyObject(contextFromStorage)) {\n    contextManager.setContext(contextFromStorage)\n  }\n\n  function synchronizeWithStorage() {\n    contextManager.setContext(getFromStorage())\n  }\n\n  function dumpToStorage() {\n    localStorage.setItem(storageKey, JSON.stringify(contextManager.getContext()))\n  }\n\n  function getFromStorage() {\n    const rawContext = localStorage.getItem(storageKey)\n    return rawContext ? (tryJsonParse<Context>(rawContext) ?? {}) : {}\n  }\n}\n\nexport function buildStorageKey(productKey: string, customerDataType: CustomerDataType) {\n  return `${CONTEXT_STORE_KEY_PREFIX}_${productKey}_${customerDataType}`\n}\n\nexport function removeStorageListeners() {\n  storageListeners.map((listener) => listener.stop())\n}\n"],"mappings":";;;;AAOA,MAAM,2BAA2B;AAEjC,MAAM,mBAAgD,CAAC;AAEvD,SAAgB,oBACd,gBACA,YACA,kBACA;CAEA,IAAI,OAAO,WAAW,eAAe,OAAO,iBAAiB,aAC3D;CAGF,MAAM,aAAa,gBAAgB,YAAY,gBAAgB;CAE/D,iBAAiB,KACf,iBAAiB,QAAA,YAA4B,EAAE,UAAU;EACvD,IAAI,eAAe,KACjB,uBAAuB;CAE3B,CAAC,CACH;CACA,eAAe,iBAAiB,UAAU,aAAa;CAEvD,MAAM,qBAAqB,QAAQ,eAAe,GAAG,eAAe,WAAW,CAAC;CAChF,IAAI,CAAC,cAAc,kBAAkB,GACnC,eAAe,WAAW,kBAAkB;CAG9C,SAAS,yBAAyB;EAChC,eAAe,WAAW,eAAe,CAAC;CAC5C;CAEA,SAAS,gBAAgB;EACvB,aAAa,QAAQ,YAAY,KAAK,UAAU,eAAe,WAAW,CAAC,CAAC;CAC9E;CAEA,SAAS,iBAAiB;EACxB,MAAM,aAAa,aAAa,QAAQ,UAAU;EAClD,OAAO,aAAc,aAAsB,UAAU,KAAK,CAAC,IAAK,CAAC;CACnE;AACF;AAEA,SAAgB,gBAAgB,YAAoB,kBAAoC;CACtF,OAAO,GAAG,yBAAyB,GAAG,WAAW,GAAG;AACtD;AAEA,SAAgB,yBAAyB;CACvC,iBAAiB,KAAK,aAAa,SAAS,KAAK,CAAC;AACpD"}

package/esm/domain/contexts/accountContext.mjs

@@ -0,0 +1,29 @@
+import { isEmptyObject } from "../../tools/utils/objectUtils.mjs";
+import { createContextManager } from "../context/contextManager.mjs";
+import { storeContextManager } from "../context/storeContextManager.mjs";
+import "../context/contextConstants.mjs";
+import { SKIPPED } from "@kubesense/kubesense-js-core/assembly";
+//#region src/domain/contexts/accountContext.ts
+function startAccountContext(assembleHook, configuration, productKey) {
+	const accountContextManager = buildAccountContextManager();
+	if (configuration.storeContextsAcrossPages) storeContextManager(accountContextManager, productKey, 4);
+	assembleHook.register(() => {
+		const account = accountContextManager.getContext();
+		if (isEmptyObject(account) || !account.id) return SKIPPED;
+		return { account };
+	});
+	return accountContextManager;
+}
+function buildAccountContextManager() {
+	return createContextManager("account", { propertiesConfig: {
+		id: {
+			type: "string",
+			required: true
+		},
+		name: { type: "string" }
+	} });
+}
+//#endregion
+export { buildAccountContextManager, startAccountContext };
+
+//# sourceMappingURL=accountContext.mjs.map

package/esm/domain/contexts/accountContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountContext.mjs","names":[],"sources":["../../../src/domain/contexts/accountContext.ts"],"sourcesContent":["import type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport { SKIPPED } from '@kubesense/kubesense-js-core/assembly'\nimport type { Configuration } from '../configuration'\nimport { CustomerDataType } from '../context/contextConstants'\nimport { storeContextManager } from '../context/storeContextManager'\nimport { isEmptyObject } from '../../tools/utils/objectUtils'\nimport { createContextManager } from '../context/contextManager'\n\n/**\n * Account information for the browser SDK.\n */\nexport interface Account {\n  id: string\n  name?: string | undefined\n  [key: string]: unknown\n}\n\nexport function startAccountContext(assembleHook: Hook<any, any>, configuration: Configuration, productKey: string) {\n  const accountContextManager = buildAccountContextManager()\n\n  if (configuration.storeContextsAcrossPages) {\n    storeContextManager(accountContextManager, productKey, CustomerDataType.Account)\n  }\n\n  assembleHook.register(() => {\n    const account = accountContextManager.getContext() as Account\n\n    if (isEmptyObject(account) || !account.id) {\n      return SKIPPED\n    }\n\n    return {\n      account,\n    }\n  })\n\n  return accountContextManager\n}\n\nexport function buildAccountContextManager() {\n  return createContextManager('account', {\n    propertiesConfig: {\n      id: { type: 'string', required: true },\n      name: { type: 'string' },\n    },\n  })\n}\n"],"mappings":";;;;;;AAiBA,SAAgB,oBAAoB,cAA8B,eAA8B,YAAoB;CAClH,MAAM,wBAAwB,2BAA2B;CAEzD,IAAI,cAAc,0BAChB,oBAAoB,uBAAuB,YAAA,CAAoC;CAGjF,aAAa,eAAe;EAC1B,MAAM,UAAU,sBAAsB,WAAW;EAEjD,IAAI,cAAc,OAAO,KAAK,CAAC,QAAQ,IACrC,OAAO;EAGT,OAAO,EACL,QACF;CACF,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,6BAA6B;CAC3C,OAAO,qBAAqB,WAAW,EACrC,kBAAkB;EAChB,IAAI;GAAE,MAAM;GAAU,UAAU;EAAK;EACrC,MAAM,EAAE,MAAM,SAAS;CACzB,EACF,CAAC;AACH"}

package/esm/domain/contexts/globalContext.mjs

@@ -0,0 +1,20 @@
+import { createContextManager } from "../context/contextManager.mjs";
+import { storeContextManager } from "../context/storeContextManager.mjs";
+import "../context/contextConstants.mjs";
+//#region src/domain/contexts/globalContext.ts
+function startGlobalContext(assembleHook, configuration, productKey, useContextNamespace) {
+	const globalContextManager = buildGlobalContextManager();
+	if (configuration.storeContextsAcrossPages) storeContextManager(globalContextManager, productKey, 2);
+	assembleHook.register(() => {
+		const context = globalContextManager.getContext();
+		return useContextNamespace ? { context } : context;
+	});
+	return globalContextManager;
+}
+function buildGlobalContextManager() {
+	return createContextManager("global context");
+}
+//#endregion
+export { buildGlobalContextManager, startGlobalContext };
+
+//# sourceMappingURL=globalContext.mjs.map

package/esm/domain/contexts/globalContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalContext.mjs","names":[],"sources":["../../../src/domain/contexts/globalContext.ts"],"sourcesContent":["import type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport { CustomerDataType } from '../context/contextConstants'\nimport { storeContextManager } from '../context/storeContextManager'\nimport { createContextManager } from '../context/contextManager'\nimport type { Configuration } from '../configuration'\n\nexport function startGlobalContext(\n  assembleHook: Hook<any, any>,\n  configuration: Configuration,\n  productKey: string,\n  useContextNamespace: boolean\n) {\n  const globalContextManager = buildGlobalContextManager()\n\n  if (configuration.storeContextsAcrossPages) {\n    storeContextManager(globalContextManager, productKey, CustomerDataType.GlobalContext)\n  }\n\n  assembleHook.register(() => {\n    const context = globalContextManager.getContext()\n    return useContextNamespace ? { context } : context\n  })\n\n  return globalContextManager\n}\n\nexport function buildGlobalContextManager() {\n  return createContextManager('global context')\n}\n"],"mappings":";;;;AAMA,SAAgB,mBACd,cACA,eACA,YACA,qBACA;CACA,MAAM,uBAAuB,0BAA0B;CAEvD,IAAI,cAAc,0BAChB,oBAAoB,sBAAsB,YAAA,CAA0C;CAGtF,aAAa,eAAe;EAC1B,MAAM,UAAU,qBAAqB,WAAW;EAChD,OAAO,sBAAsB,EAAE,QAAQ,IAAI;CAC7C,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,4BAA4B;CAC1C,OAAO,qBAAqB,gBAAgB;AAC9C"}

package/esm/domain/contexts/tabContext.mjs

@@ -0,0 +1,27 @@
+import { generateUUID } from "../../tools/utils/stringUtils.mjs";
+//#region src/domain/contexts/tabContext.ts
+const TAB_ID_STORAGE_KEY = "_kubesense_tab_id";
+let cachedTabId;
+function startTabContext(assembleHook) {
+	const tabId = retrieveOrCreateTabId();
+	assembleHook.register(() => ({ tab: { id: tabId } }));
+}
+function retrieveOrCreateTabId() {
+	if (!cachedTabId) cachedTabId = getOrCreateIdInSessionStorage() ?? generateUUID();
+	return cachedTabId;
+}
+function getOrCreateIdInSessionStorage() {
+	try {
+		const existingId = sessionStorage.getItem(TAB_ID_STORAGE_KEY);
+		if (existingId) return existingId;
+		const newId = generateUUID();
+		sessionStorage.setItem(TAB_ID_STORAGE_KEY, newId);
+		return newId;
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { TAB_ID_STORAGE_KEY, startTabContext };
+
+//# sourceMappingURL=tabContext.mjs.map

package/esm/domain/contexts/tabContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabContext.mjs","names":[],"sources":["../../../src/domain/contexts/tabContext.ts"],"sourcesContent":["import type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport { generateUUID } from '../../tools/utils/stringUtils'\n\nexport const TAB_ID_STORAGE_KEY = '_kubesense_tab_id'\n\nlet cachedTabId: string | undefined\n\n// Exported for test cleanup only — allows specs to reset the in-memory cache between tests.\nexport function resetCachedTabId(): void {\n  cachedTabId = undefined\n}\n\nexport function startTabContext(assembleHook: Hook<any, any>) {\n  const tabId = retrieveOrCreateTabId()\n\n  assembleHook.register(() => ({\n    tab: {\n      id: tabId,\n    },\n  }))\n}\n\nfunction retrieveOrCreateTabId(): string {\n  if (!cachedTabId) {\n    cachedTabId = getOrCreateIdInSessionStorage() ?? generateUUID()\n  }\n  return cachedTabId\n}\n\nfunction getOrCreateIdInSessionStorage(): string | undefined {\n  try {\n    const existingId = sessionStorage.getItem(TAB_ID_STORAGE_KEY)\n    if (existingId) {\n      return existingId\n    }\n    const newId = generateUUID()\n    sessionStorage.setItem(TAB_ID_STORAGE_KEY, newId)\n    return newId\n  } catch {\n    // sessionStorage unavailable (e.g. Web Worker, sandboxed iframe, quota exceeded)\n    return undefined\n  }\n}\n"],"mappings":";;AAGA,MAAa,qBAAqB;AAElC,IAAI;AAOJ,SAAgB,gBAAgB,cAA8B;CAC5D,MAAM,QAAQ,sBAAsB;CAEpC,aAAa,gBAAgB,EAC3B,KAAK,EACH,IAAI,MACN,EACF,EAAE;AACJ;AAEA,SAAS,wBAAgC;CACvC,IAAI,CAAC,aACH,cAAc,8BAA8B,KAAK,aAAa;CAEhE,OAAO;AACT;AAEA,SAAS,gCAAoD;CAC3D,IAAI;EACF,MAAM,aAAa,eAAe,QAAQ,kBAAkB;EAC5D,IAAI,YACF,OAAO;EAET,MAAM,QAAQ,aAAa;EAC3B,eAAe,QAAQ,oBAAoB,KAAK;EAChD,OAAO;CACT,QAAQ;EAEN;CACF;AACF"}

package/esm/domain/contexts/telemetrySessionContext.mjs

@@ -0,0 +1,17 @@
+import { SKIPPED } from "@kubesense/kubesense-js-core/assembly";
+//#region src/domain/contexts/telemetrySessionContext.ts
+function startTelemetrySessionContext(assembleTelemetryHook, sessionManager, extraContext) {
+	assembleTelemetryHook.register(({ startTime }) => {
+		const session = sessionManager.findTrackedSession(startTime);
+		if (!session) return SKIPPED;
+		return {
+			session: { id: session.id },
+			anonymous_id: session.anonymousId,
+			...extraContext
+		};
+	});
+}
+//#endregion
+export { startTelemetrySessionContext };
+
+//# sourceMappingURL=telemetrySessionContext.mjs.map

package/esm/domain/contexts/telemetrySessionContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetrySessionContext.mjs","names":[],"sources":["../../../src/domain/contexts/telemetrySessionContext.ts"],"sourcesContent":["import type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport { SKIPPED } from '@kubesense/kubesense-js-core/assembly'\nimport type { SessionManager } from '../session/sessionManager'\nimport type { Context } from '../../tools/serialisation/context'\n\nexport function startTelemetrySessionContext(\n  assembleTelemetryHook: Hook<any, any>,\n  sessionManager: SessionManager,\n  extraContext?: Context\n) {\n  assembleTelemetryHook.register(({ startTime }) => {\n    const session = sessionManager.findTrackedSession(startTime)\n\n    if (!session) {\n      return SKIPPED\n    }\n\n    return {\n      session: {\n        id: session.id,\n      },\n      anonymous_id: session.anonymousId,\n      ...extraContext,\n    }\n  })\n}\n"],"mappings":";;AAKA,SAAgB,6BACd,uBACA,gBACA,cACA;CACA,sBAAsB,UAAU,EAAE,gBAAgB;EAChD,MAAM,UAAU,eAAe,mBAAmB,SAAS;EAE3D,IAAI,CAAC,SACH,OAAO;EAGT,OAAO;GACL,SAAS,EACP,IAAI,QAAQ,GACd;GACA,cAAc,QAAQ;GACtB,GAAG;EACL;CACF,CAAC;AACH"}

package/esm/domain/contexts/userContext.mjs

@@ -0,0 +1,88 @@
+import { isEmptyObject } from "../../tools/utils/objectUtils.mjs";
+import { jsonStringify } from "../../tools/serialisation/jsonStringify.mjs";
+import { createValueHistory } from "../../tools/valueHistory.mjs";
+import { SESSION_TIME_OUT_DELAY } from "../session/sessionConstants.mjs";
+import { createContextManager } from "../context/contextManager.mjs";
+import { storeContextManager } from "../context/storeContextManager.mjs";
+import "../context/contextConstants.mjs";
+import { deepClone } from "@kubesense/kubesense-js-core/util";
+import { clocksOrigin, relativeNow } from "@kubesense/kubesense-js-core/time";
+import { SKIPPED } from "@kubesense/kubesense-js-core/assembly";
+//#region src/domain/contexts/userContext.ts
+const SESSION_OWNER_STORAGE_PREFIX = "_kubesense_session_user";
+/**
+* The user id is sanitized to a string by the context manager, but `getContext()` is typed as
+* `Context`, so non-string values are normalized here rather than stringified blindly.
+*/
+function toUserIdString(userId) {
+	return typeof userId === "string" ? userId : userId === void 0 ? void 0 : jsonStringify(userId);
+}
+function getSessionOwnerKey(productKey) {
+	return `${SESSION_OWNER_STORAGE_PREFIX}_${productKey}`;
+}
+function readSessionOwnerUserId(productKey) {
+	try {
+		return localStorage.getItem(getSessionOwnerKey(productKey)) || void 0;
+	} catch {
+		return;
+	}
+}
+function writeSessionOwnerUserId(productKey, userId) {
+	try {
+		const key = getSessionOwnerKey(productKey);
+		if (userId) localStorage.setItem(key, userId);
+		else localStorage.removeItem(key);
+	} catch {}
+}
+function startUserContext(hook, configuration, sessionManager, productKey) {
+	const userContextManager = buildUserContextManager();
+	if (configuration.storeContextsAcrossPages) storeContextManager(userContextManager, productKey, 1);
+	if (sessionManager.expire) {
+		const initialUserId = userContextManager.getContext().id;
+		const sessionOwnerUserId = readSessionOwnerUserId(productKey);
+		const initialUserIdString = toUserIdString(initialUserId);
+		if (sessionOwnerUserId !== void 0 && initialUserIdString !== void 0 && sessionOwnerUserId !== initialUserIdString) sessionManager.expire();
+		writeSessionOwnerUserId(productKey, initialUserIdString ?? sessionOwnerUserId);
+		let previousUserId = initialUserIdString ?? sessionOwnerUserId;
+		userContextManager.changeObservable.subscribe(() => {
+			const rawCurrentUserId = userContextManager.getContext().id;
+			const currentUserId = toUserIdString(rawCurrentUserId);
+			if (currentUserId !== previousUserId) {
+				sessionManager.expire();
+				writeSessionOwnerUserId(productKey, currentUserId);
+			}
+			previousUserId = currentUserId;
+		});
+	}
+	const userContextHistory = createValueHistory({ expireDelay: SESSION_TIME_OUT_DELAY });
+	userContextHistory.add(userContextManager.getContext(), clocksOrigin().relative);
+	userContextManager.changeObservable.subscribe(() => {
+		const now = relativeNow();
+		userContextHistory.closeActive(now);
+		userContextHistory.add(userContextManager.getContext(), now);
+	});
+	hook.register(({ eventType, startTime }) => {
+		const historicalUser = userContextHistory.find(startTime);
+		const user = historicalUser ? deepClone(historicalUser) : userContextManager.getContext();
+		const session = sessionManager.findTrackedSession(startTime);
+		if (session?.anonymousId && !user.anonymous_id && !!configuration.trackAnonymousUser) user.anonymous_id = session.anonymousId;
+		if (isEmptyObject(user)) return SKIPPED;
+		return {
+			type: eventType,
+			usr: user
+		};
+	});
+	return userContextManager;
+}
+function buildUserContextManager() {
+	return createContextManager("user", { propertiesConfig: {
+		id: { type: "string" },
+		name: { type: "string" },
+		email: { type: "string" },
+		mobile: { type: "string" }
+	} });
+}
+//#endregion
+export { buildUserContextManager, startUserContext };
+
+//# sourceMappingURL=userContext.mjs.map

package/esm/domain/contexts/userContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"userContext.mjs","names":[],"sources":["../../../src/domain/contexts/userContext.ts"],"sourcesContent":["import type { RelativeTime } from '@kubesense/kubesense-js-core/time'\nimport { clocksOrigin, relativeNow } from '@kubesense/kubesense-js-core/time'\nimport type { Hook } from '@kubesense/kubesense-js-core/assembly'\nimport { SKIPPED } from '@kubesense/kubesense-js-core/assembly'\nimport { deepClone } from '@kubesense/kubesense-js-core/util'\nimport { CustomerDataType } from '../context/contextConstants'\nimport { storeContextManager } from '../context/storeContextManager'\nimport { createContextManager } from '../context/contextManager'\nimport type { Configuration } from '../configuration'\nimport { isEmptyObject } from '../../tools/utils/objectUtils'\nimport { jsonStringify } from '../../tools/serialisation/jsonStringify'\nimport type { Context } from '../../tools/serialisation/context'\nimport { createValueHistory } from '../../tools/valueHistory'\nimport { SESSION_TIME_OUT_DELAY } from '../session/sessionConstants'\n\nexport interface User {\n  id?: string | undefined\n  email?: string | undefined\n  name?: string | undefined\n  mobile?: string | undefined\n  [key: string]: unknown\n}\n\nconst SESSION_OWNER_STORAGE_PREFIX = '_kubesense_session_user'\n\n/**\n * The user id is sanitized to a string by the context manager, but `getContext()` is typed as\n * `Context`, so non-string values are normalized here rather than stringified blindly.\n */\nfunction toUserIdString(userId: unknown): string | undefined {\n  return typeof userId === 'string' ? userId : userId === undefined ? undefined : jsonStringify(userId)\n}\n\nfunction getSessionOwnerKey(productKey: string) {\n  return `${SESSION_OWNER_STORAGE_PREFIX}_${productKey}`\n}\n\nfunction readSessionOwnerUserId(productKey: string): string | undefined {\n  try {\n    return localStorage.getItem(getSessionOwnerKey(productKey)) || undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction writeSessionOwnerUserId(productKey: string, userId: string | undefined) {\n  try {\n    const key = getSessionOwnerKey(productKey)\n    if (userId) {\n      localStorage.setItem(key, userId)\n    } else {\n      localStorage.removeItem(key)\n    }\n  } catch {\n    // localStorage may be unavailable (private mode, quota); silently skip\n  }\n}\n\nexport function startUserContext(\n  hook: Hook<{ eventType?: string; startTime: RelativeTime }, { usr?: User }>,\n  configuration: Configuration,\n  sessionManager: {\n    findTrackedSession: (startTime?: RelativeTime) => { anonymousId?: string } | undefined\n    expire?: () => void\n  },\n  productKey: string\n) {\n  const userContextManager = buildUserContextManager()\n\n  if (configuration.storeContextsAcrossPages) {\n    storeContextManager(userContextManager, productKey, CustomerDataType.User)\n  }\n\n  // Expire the session when the user identity changes so that the new user\n  // gets a fresh session and their events are not attributed to the previous user's session.\n  if (sessionManager.expire) {\n    // Cross-page check: when the page reloads while the session cookie is still\n    // valid but the active user has changed (e.g. logout/login between loads),\n    // changeObservable won't fire because the loaded user equals the \"previous\"\n    // user. Compare the persisted session owner against the current user and\n    // expire on mismatch before any events get assembled with a stale session id.\n    const initialUserId = userContextManager.getContext().id\n    const sessionOwnerUserId = readSessionOwnerUserId(productKey)\n    const initialUserIdString = toUserIdString(initialUserId)\n\n    if (\n      sessionOwnerUserId !== undefined &&\n      initialUserIdString !== undefined &&\n      sessionOwnerUserId !== initialUserIdString\n    ) {\n      sessionManager.expire()\n    }\n    writeSessionOwnerUserId(productKey, initialUserIdString ?? sessionOwnerUserId)\n\n    // Seed previousUserId from the owner when current is undefined, so an\n    // app calling setUser(sameOwner) post-load doesn't trigger a spurious expire.\n    let previousUserId: string | undefined = initialUserIdString ?? sessionOwnerUserId\n    userContextManager.changeObservable.subscribe(() => {\n      const rawCurrentUserId = userContextManager.getContext().id\n      const currentUserId = toUserIdString(rawCurrentUserId)\n      if (currentUserId !== previousUserId) {\n        sessionManager.expire!()\n        writeSessionOwnerUserId(productKey, currentUserId)\n      }\n      previousUserId = currentUserId\n    })\n  }\n\n  // Track user context over time so events get attributed to the user that was\n  // active at the event's startTime, not at assembly time. Without this, a view\n  // that started under user A but is assembled after setUser(B) would be tagged\n  // with user B while its session.id still resolves to A's session — producing\n  // a mismatched (session_id, user_id) row downstream.\n  const userContextHistory = createValueHistory<Context>({\n    expireDelay: SESSION_TIME_OUT_DELAY,\n  })\n  userContextHistory.add(userContextManager.getContext(), clocksOrigin().relative)\n  userContextManager.changeObservable.subscribe(() => {\n    const now = relativeNow()\n    userContextHistory.closeActive(now)\n    userContextHistory.add(userContextManager.getContext(), now)\n  })\n\n  hook.register(({ eventType, startTime }) => {\n    const historicalUser = userContextHistory.find(startTime)\n    const user = historicalUser ? deepClone(historicalUser) : userContextManager.getContext()\n    const session = sessionManager.findTrackedSession(startTime)\n\n    if (session?.anonymousId && !user.anonymous_id && !!configuration.trackAnonymousUser) {\n      user.anonymous_id = session.anonymousId\n    }\n\n    if (isEmptyObject(user)) {\n      return SKIPPED\n    }\n\n    return {\n      type: eventType,\n      usr: user,\n    }\n  })\n\n  return userContextManager\n}\n\nexport function buildUserContextManager() {\n  return createContextManager('user', {\n    propertiesConfig: {\n      id: { type: 'string' },\n      name: { type: 'string' },\n      email: { type: 'string' },\n      // Coerced to string like the other identity fields: phone numbers are\n      // routinely passed as JS numbers, and the collector unmarshals\n      // usr.mobile into a string column.\n      mobile: { type: 'string' },\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;AAuBA,MAAM,+BAA+B;;;;;AAMrC,SAAS,eAAe,QAAqC;CAC3D,OAAO,OAAO,WAAW,WAAW,SAAS,WAAW,KAAA,IAAY,KAAA,IAAY,cAAc,MAAM;AACtG;AAEA,SAAS,mBAAmB,YAAoB;CAC9C,OAAO,GAAG,6BAA6B,GAAG;AAC5C;AAEA,SAAS,uBAAuB,YAAwC;CACtE,IAAI;EACF,OAAO,aAAa,QAAQ,mBAAmB,UAAU,CAAC,KAAK,KAAA;CACjE,QAAQ;EACN;CACF;AACF;AAEA,SAAS,wBAAwB,YAAoB,QAA4B;CAC/E,IAAI;EACF,MAAM,MAAM,mBAAmB,UAAU;EACzC,IAAI,QACF,aAAa,QAAQ,KAAK,MAAM;OAEhC,aAAa,WAAW,GAAG;CAE/B,QAAQ,CAER;AACF;AAEA,SAAgB,iBACd,MACA,eACA,gBAIA,YACA;CACA,MAAM,qBAAqB,wBAAwB;CAEnD,IAAI,cAAc,0BAChB,oBAAoB,oBAAoB,YAAA,CAAiC;CAK3E,IAAI,eAAe,QAAQ;EAMzB,MAAM,gBAAgB,mBAAmB,WAAW,CAAC,CAAC;EACtD,MAAM,qBAAqB,uBAAuB,UAAU;EAC5D,MAAM,sBAAsB,eAAe,aAAa;EAExD,IACE,uBAAuB,KAAA,KACvB,wBAAwB,KAAA,KACxB,uBAAuB,qBAEvB,eAAe,OAAO;EAExB,wBAAwB,YAAY,uBAAuB,kBAAkB;EAI7E,IAAI,iBAAqC,uBAAuB;EAChE,mBAAmB,iBAAiB,gBAAgB;GAClD,MAAM,mBAAmB,mBAAmB,WAAW,CAAC,CAAC;GACzD,MAAM,gBAAgB,eAAe,gBAAgB;GACrD,IAAI,kBAAkB,gBAAgB;IACpC,eAAe,OAAQ;IACvB,wBAAwB,YAAY,aAAa;GACnD;GACA,iBAAiB;EACnB,CAAC;CACH;CAOA,MAAM,qBAAqB,mBAA4B,EACrD,aAAa,uBACf,CAAC;CACD,mBAAmB,IAAI,mBAAmB,WAAW,GAAG,aAAa,CAAC,CAAC,QAAQ;CAC/E,mBAAmB,iBAAiB,gBAAgB;EAClD,MAAM,MAAM,YAAY;EACxB,mBAAmB,YAAY,GAAG;EAClC,mBAAmB,IAAI,mBAAmB,WAAW,GAAG,GAAG;CAC7D,CAAC;CAED,KAAK,UAAU,EAAE,WAAW,gBAAgB;EAC1C,MAAM,iBAAiB,mBAAmB,KAAK,SAAS;EACxD,MAAM,OAAO,iBAAiB,UAAU,cAAc,IAAI,mBAAmB,WAAW;EACxF,MAAM,UAAU,eAAe,mBAAmB,SAAS;EAE3D,IAAI,SAAS,eAAe,CAAC,KAAK,gBAAgB,CAAC,CAAC,cAAc,oBAChE,KAAK,eAAe,QAAQ;EAG9B,IAAI,cAAc,IAAI,GACpB,OAAO;EAGT,OAAO;GACL,MAAM;GACN,KAAK;EACP;CACF,CAAC;CAED,OAAO;AACT;AAEA,SAAgB,0BAA0B;CACxC,OAAO,qBAAqB,QAAQ,EAClC,kBAAkB;EAChB,IAAI,EAAE,MAAM,SAAS;EACrB,MAAM,EAAE,MAAM,SAAS;EACvB,OAAO,EAAE,MAAM,SAAS;EAIxB,QAAQ,EAAE,MAAM,SAAS;CAC3B,EACF,CAAC;AACH"}

package/esm/domain/deflate/deflate.types.mjs

@@ -0,0 +1,12 @@
+//#region src/domain/deflate/deflate.types.ts
+let DeflateEncoderStreamId = /* @__PURE__ */ function(DeflateEncoderStreamId) {
+	DeflateEncoderStreamId[DeflateEncoderStreamId["REPLAY"] = 1] = "REPLAY";
+	DeflateEncoderStreamId[DeflateEncoderStreamId["RUM"] = 2] = "RUM";
+	DeflateEncoderStreamId[DeflateEncoderStreamId["TELEMETRY"] = 4] = "TELEMETRY";
+	DeflateEncoderStreamId[DeflateEncoderStreamId["PROFILING"] = 6] = "PROFILING";
+	return DeflateEncoderStreamId;
+}({});
+//#endregion
+export { DeflateEncoderStreamId };
+
+//# sourceMappingURL=deflate.types.mjs.map

package/esm/domain/deflate/deflate.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deflate.types.mjs","names":[],"sources":["../../../src/domain/deflate/deflate.types.ts"],"sourcesContent":["import type { Encoder } from '../../tools/encoder'\nimport type { Uint8ArrayBuffer } from '../../tools/utils/byteUtils'\n\nexport type DeflateWorkerAction =\n  // Action to send when creating the worker to check if the communication is working correctly.\n  // The worker should respond with a 'initialized' response.\n  | {\n      action: 'init'\n    }\n  // Action to send when writing some unfinished data. The worker will respond with a 'wrote'\n  // response, with the same id and measurements of the wrote data bytes count.\n  | {\n      action: 'write'\n      id: number\n      streamId: number\n      data: string\n    }\n  // Action to send when all data has been written and the state of the stream needs to be reset.\n  | {\n      action: 'reset'\n      streamId: number\n    }\n\nexport type DeflateWorkerResponse =\n  // Response to 'init' action\n  | {\n      type: 'initialized'\n      version: string\n    }\n  // Response to 'write' action\n  | {\n      type: 'wrote'\n      id: number\n      streamId: number\n      result: Uint8ArrayBuffer\n      trailer: Uint8ArrayBuffer\n      additionalBytesCount: number\n    }\n  // Could happen at any time when something goes wrong in the worker\n  | {\n      type: 'errored'\n      streamId?: number\n      error: Error | string\n    }\n\nexport interface DeflateWorker extends Worker {\n  postMessage(message: DeflateWorkerAction): void\n}\n\nexport type DeflateEncoder = Encoder<Uint8ArrayBuffer> & { stop: () => void }\n\nexport const enum DeflateEncoderStreamId {\n  REPLAY = 1,\n  RUM = 2,\n  TELEMETRY = 4,\n  PROFILING = 6,\n}\n"],"mappings":";AAmDA,IAAkB,yBAAX,yBAAA,wBAAA;CACL,uBAAA,uBAAA,YAAA,KAAA;CACA,uBAAA,uBAAA,SAAA,KAAA;CACA,uBAAA,uBAAA,eAAA,KAAA;CACA,uBAAA,uBAAA,eAAA,KAAA;;AACF,EAAA,CAAA,CAAA"}

package/esm/domain/error/error.mjs

@@ -0,0 +1,104 @@
+import { computeStackTrace } from "../../tools/stackTrace/computeStackTrace.mjs";
+import { toStackTraceString } from "../../tools/stackTrace/handlingStack.mjs";
+import { jsonStringify } from "../../tools/serialisation/jsonStringify.mjs";
+import { sanitize } from "../../tools/serialisation/sanitize.mjs";
+import { NO_ERROR_STACK_PRESENT_MESSAGE, isError } from "./isError.mjs";
+import { buildDebugIdByUrl } from "../sourceCodeContext.mjs";
+import { isIndexableObject } from "@kubesense/kubesense-js-core/util";
+//#region src/domain/error/error.ts
+/**
+* Used when `error.type` cannot be derived from the collected error. Sending a default rather than
+* nothing keeps those errors groupable and searchable alongside the rest.
+*/
+const DEFAULT_ERROR_TYPE = "Error";
+function computeErrorBase({ originalError, stackTrace, source, useFallbackStack = true, nonErrorPrefix }) {
+	const isErrorInstance = isError(originalError);
+	return {
+		source,
+		type: computeType(stackTrace, originalError),
+		message: computeMessage(stackTrace, isErrorInstance, nonErrorPrefix, originalError),
+		stack: stackTrace ? toStackTraceString(stackTrace) : useFallbackStack ? NO_ERROR_STACK_PRESENT_MESSAGE : void 0
+	};
+}
+/**
+* `error.type` is normally the error class name (`TypeError`, `RangeError`...), read from the `name`
+* property of the collected error. It is unavailable in two cases.
+*
+* No `Error` instance ever reached the SDK, because the application threw, rejected or logged
+* something else: `console.error('message')`, `Promise.reject('reason')`, `addError('message')`. The
+* runtime type of that value is used instead, which also surfaces that a non-`Error` was thrown in
+* the first place.
+*
+* Or a stack trace was collected but tracekit could not extract a name from it, typically the opaque
+* cross-origin `"Script error."`. A real error was raised here, so only its name is missing.
+*/
+function computeType(stackTrace, originalError) {
+	if (stackTrace) return stackTrace.name || "Error";
+	return /\[object (\w+)\]/.exec(Object.prototype.toString.call(originalError))?.[1] ?? "Error";
+}
+function getStackTraceUrls(stackTrace) {
+	return stackTrace?.stack.map((frame) => frame.url).filter((url) => !!url) ?? [];
+}
+function getErrorDebugIds(stackTrace, errorCauses) {
+	const errorCausesUrls = errorCauses.flatMap(({ stackTrace }) => getStackTraceUrls(stackTrace));
+	return buildDebugIdByUrl(getStackTraceUrls(stackTrace).concat(errorCausesUrls));
+}
+function flattenErrorCauses(error) {
+	const chain = [];
+	let current = error.cause;
+	while (current !== void 0 && current !== null && chain.length < 10) {
+		const isCurrentError = isError(current);
+		const stackTrace = isCurrentError ? computeStackTrace(current) : void 0;
+		chain.push({
+			originalError: current,
+			stackTrace
+		});
+		current = isCurrentError ? current.cause : void 0;
+	}
+	return chain;
+}
+function computeRawError({ stackTrace, originalError, handlingStack, componentStack, startClocks, nonErrorPrefix, useFallbackStack = true, source, handling }) {
+	const errorStackTrace = stackTrace ?? (isError(originalError) ? computeStackTrace(originalError) : void 0);
+	const errorCauses = isError(originalError) ? flattenErrorCauses(originalError) : [];
+	const errorBase = computeErrorBase({
+		originalError,
+		stackTrace: errorStackTrace,
+		source,
+		useFallbackStack,
+		nonErrorPrefix
+	});
+	const rawErrorCauses = errorCauses.map(({ originalError, stackTrace }) => computeErrorBase({
+		originalError,
+		stackTrace,
+		source,
+		useFallbackStack: false
+	}));
+	return {
+		startClocks,
+		handling,
+		handlingStack,
+		componentStack,
+		originalError,
+		...errorBase,
+		debugIds: getErrorDebugIds(errorStackTrace, errorCauses),
+		causes: rawErrorCauses.length ? rawErrorCauses : void 0,
+		fingerprint: tryToGetFingerprint(originalError),
+		context: tryToGetErrorContext(originalError)
+	};
+}
+function computeMessage(stackTrace, isErrorInstance, nonErrorPrefix, originalError) {
+	return stackTrace?.message && stackTrace?.name ? stackTrace.message : !isErrorInstance ? nonErrorPrefix ? `${nonErrorPrefix} ${jsonStringify(sanitize(originalError))}` : jsonStringify(sanitize(originalError)) : "Empty message";
+}
+function tryToGetFingerprint(originalError) {
+	return isError(originalError) && "kubesense_fingerprint" in originalError ? String(originalError.kubesense_fingerprint) : void 0;
+}
+function tryToGetErrorContext(originalError) {
+	if (isIndexableObject(originalError)) return originalError.kubesense_context;
+}
+function getFileFromStackTraceString(stack) {
+	return /@ (.+)/.exec(stack)?.[1];
+}
+//#endregion
+export { DEFAULT_ERROR_TYPE, NO_ERROR_STACK_PRESENT_MESSAGE, computeRawError, flattenErrorCauses, getFileFromStackTraceString, getStackTraceUrls, isError, tryToGetErrorContext, tryToGetFingerprint };
+
+//# sourceMappingURL=error.mjs.map

package/esm/domain/error/error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.mjs","names":[],"sources":["../../../src/domain/error/error.ts"],"sourcesContent":["import type { ClocksState } from '@kubesense/kubesense-js-core/time'\nimport { isIndexableObject } from '@kubesense/kubesense-js-core/util'\nimport { sanitize } from '../../tools/serialisation/sanitize'\nimport type { Context } from '../../tools/serialisation/context'\nimport { jsonStringify } from '../../tools/serialisation/jsonStringify'\nimport type { StackTrace } from '../../tools/stackTrace/computeStackTrace'\nimport { computeStackTrace } from '../../tools/stackTrace/computeStackTrace'\nimport { toStackTraceString } from '../../tools/stackTrace/handlingStack'\nimport { buildDebugIdByUrl } from '../sourceCodeContext'\nimport type { ErrorSource, ErrorHandling, RawError, ErrorWithCause, NonErrorPrefix } from './error.types'\nimport { isError, NO_ERROR_STACK_PRESENT_MESSAGE } from './isError'\n\nexport { isError, NO_ERROR_STACK_PRESENT_MESSAGE }\n\n/**\n * Used when `error.type` cannot be derived from the collected error. Sending a default rather than\n * nothing keeps those errors groupable and searchable alongside the rest.\n */\nexport const DEFAULT_ERROR_TYPE = 'Error'\n\ninterface RawErrorParams {\n  stackTrace?: StackTrace\n  originalError: unknown\n  handlingStack?: string\n  componentStack?: string\n  startClocks: ClocksState\n  nonErrorPrefix: NonErrorPrefix\n  useFallbackStack?: boolean\n  source: ErrorSource\n  handling: ErrorHandling\n}\n\nfunction computeErrorBase({\n  originalError,\n  stackTrace,\n  source,\n  useFallbackStack = true,\n  nonErrorPrefix,\n}: {\n  originalError: unknown\n  stackTrace?: StackTrace\n  source: ErrorSource\n  useFallbackStack?: boolean\n  nonErrorPrefix?: NonErrorPrefix\n}) {\n  const isErrorInstance = isError(originalError)\n  return {\n    source,\n    type: computeType(stackTrace, originalError),\n    message: computeMessage(stackTrace, isErrorInstance, nonErrorPrefix, originalError),\n    stack: stackTrace ? toStackTraceString(stackTrace) : useFallbackStack ? NO_ERROR_STACK_PRESENT_MESSAGE : undefined,\n  }\n}\n\n/**\n * `error.type` is normally the error class name (`TypeError`, `RangeError`...), read from the `name`\n * property of the collected error. It is unavailable in two cases.\n *\n * No `Error` instance ever reached the SDK, because the application threw, rejected or logged\n * something else: `console.error('message')`, `Promise.reject('reason')`, `addError('message')`. The\n * runtime type of that value is used instead, which also surfaces that a non-`Error` was thrown in\n * the first place.\n *\n * Or a stack trace was collected but tracekit could not extract a name from it, typically the opaque\n * cross-origin `\"Script error.\"`. A real error was raised here, so only its name is missing.\n */\nfunction computeType(stackTrace: StackTrace | undefined, originalError: unknown): string {\n  if (stackTrace) {\n    return stackTrace.name || DEFAULT_ERROR_TYPE\n  }\n  // `[object String]` -> `String`\n  return /\\[object (\\w+)\\]/.exec(Object.prototype.toString.call(originalError))?.[1] ?? DEFAULT_ERROR_TYPE\n}\n\nexport function getStackTraceUrls(stackTrace: StackTrace | undefined): string[] {\n  return stackTrace?.stack.map((frame) => frame.url).filter((url): url is string => !!url) ?? []\n}\n\nfunction getErrorDebugIds(\n  stackTrace: StackTrace | undefined,\n  errorCauses: Array<{ stackTrace: StackTrace | undefined }>\n) {\n  const errorCausesUrls = errorCauses.flatMap(({ stackTrace }) => getStackTraceUrls(stackTrace))\n  return buildDebugIdByUrl(getStackTraceUrls(stackTrace).concat(errorCausesUrls))\n}\n\nexport function flattenErrorCauses(\n  error: ErrorWithCause\n): Array<{ originalError: unknown; stackTrace: StackTrace | undefined }> {\n  const chain: Array<{ originalError: unknown; stackTrace: StackTrace | undefined }> = []\n  let current: unknown = error.cause\n\n  while (current !== undefined && current !== null && chain.length < 10) {\n    const isCurrentError = isError(current)\n    const stackTrace = isCurrentError ? computeStackTrace(current) : undefined\n    chain.push({ originalError: current, stackTrace })\n    current = isCurrentError ? (current as ErrorWithCause).cause : undefined\n  }\n\n  return chain\n}\n\nexport function computeRawError({\n  stackTrace,\n  originalError,\n  handlingStack,\n  componentStack,\n  startClocks,\n  nonErrorPrefix,\n  useFallbackStack = true,\n  source,\n  handling,\n}: RawErrorParams): RawError {\n  const errorStackTrace = stackTrace ?? (isError(originalError) ? computeStackTrace(originalError) : undefined)\n\n  const errorCauses = isError(originalError) ? flattenErrorCauses(originalError) : []\n\n  const errorBase = computeErrorBase({\n    originalError,\n    stackTrace: errorStackTrace,\n    source,\n    useFallbackStack,\n    nonErrorPrefix,\n  })\n\n  const rawErrorCauses = errorCauses.map(({ originalError, stackTrace }) =>\n    computeErrorBase({ originalError, stackTrace, source, useFallbackStack: false })\n  )\n\n  return {\n    startClocks,\n    handling,\n    handlingStack,\n    componentStack,\n    originalError,\n    ...errorBase,\n    debugIds: getErrorDebugIds(errorStackTrace, errorCauses),\n    causes: rawErrorCauses.length ? rawErrorCauses : undefined,\n    fingerprint: tryToGetFingerprint(originalError),\n    context: tryToGetErrorContext(originalError),\n  }\n}\n\nfunction computeMessage(\n  stackTrace: StackTrace | undefined,\n  isErrorInstance: boolean,\n  nonErrorPrefix: NonErrorPrefix | undefined,\n  originalError: unknown\n) {\n  // Favor stackTrace message only if tracekit has really been able to extract something meaningful (message + name)\n  // TODO rework tracekit integration to avoid scattering error building logic\n  return stackTrace?.message && stackTrace?.name\n    ? stackTrace.message\n    : !isErrorInstance\n      ? nonErrorPrefix\n        ? `${nonErrorPrefix} ${jsonStringify(sanitize(originalError))!}`\n        : jsonStringify(sanitize(originalError))!\n      : 'Empty message'\n}\n\nexport function tryToGetFingerprint(originalError: unknown) {\n  return isError(originalError) && 'kubesense_fingerprint' in originalError\n    ? String(originalError.kubesense_fingerprint)\n    : undefined\n}\n\nexport function tryToGetErrorContext(originalError: unknown) {\n  if (isIndexableObject(originalError)) {\n    return originalError.kubesense_context as Context | undefined\n  }\n}\n\nexport function getFileFromStackTraceString(stack: string) {\n  return /@ (.+)/.exec(stack)?.[1]\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,MAAa,qBAAqB;AAclC,SAAS,iBAAiB,EACxB,eACA,YACA,QACA,mBAAmB,MACnB,kBAOC;CACD,MAAM,kBAAkB,QAAQ,aAAa;CAC7C,OAAO;EACL;EACA,MAAM,YAAY,YAAY,aAAa;EAC3C,SAAS,eAAe,YAAY,iBAAiB,gBAAgB,aAAa;EAClF,OAAO,aAAa,mBAAmB,UAAU,IAAI,mBAAmB,iCAAiC,KAAA;CAC3G;AACF;;;;;;;;;;;;;AAcA,SAAS,YAAY,YAAoC,eAAgC;CACvF,IAAI,YACF,OAAO,WAAW,QAAA;CAGpB,OAAO,mBAAmB,KAAK,OAAO,UAAU,SAAS,KAAK,aAAa,CAAC,CAAC,GAAG,MAAA;AAClF;AAEA,SAAgB,kBAAkB,YAA8C;CAC9E,OAAO,YAAY,MAAM,KAAK,UAAU,MAAM,GAAG,CAAC,CAAC,QAAQ,QAAuB,CAAC,CAAC,GAAG,KAAK,CAAC;AAC/F;AAEA,SAAS,iBACP,YACA,aACA;CACA,MAAM,kBAAkB,YAAY,SAAS,EAAE,iBAAiB,kBAAkB,UAAU,CAAC;CAC7F,OAAO,kBAAkB,kBAAkB,UAAU,CAAC,CAAC,OAAO,eAAe,CAAC;AAChF;AAEA,SAAgB,mBACd,OACuE;CACvE,MAAM,QAA+E,CAAC;CACtF,IAAI,UAAmB,MAAM;CAE7B,OAAO,YAAY,KAAA,KAAa,YAAY,QAAQ,MAAM,SAAS,IAAI;EACrE,MAAM,iBAAiB,QAAQ,OAAO;EACtC,MAAM,aAAa,iBAAiB,kBAAkB,OAAO,IAAI,KAAA;EACjE,MAAM,KAAK;GAAE,eAAe;GAAS;EAAW,CAAC;EACjD,UAAU,iBAAkB,QAA2B,QAAQ,KAAA;CACjE;CAEA,OAAO;AACT;AAEA,SAAgB,gBAAgB,EAC9B,YACA,eACA,eACA,gBACA,aACA,gBACA,mBAAmB,MACnB,QACA,YAC2B;CAC3B,MAAM,kBAAkB,eAAe,QAAQ,aAAa,IAAI,kBAAkB,aAAa,IAAI,KAAA;CAEnG,MAAM,cAAc,QAAQ,aAAa,IAAI,mBAAmB,aAAa,IAAI,CAAC;CAElF,MAAM,YAAY,iBAAiB;EACjC;EACA,YAAY;EACZ;EACA;EACA;CACF,CAAC;CAED,MAAM,iBAAiB,YAAY,KAAK,EAAE,eAAe,iBACvD,iBAAiB;EAAE;EAAe;EAAY;EAAQ,kBAAkB;CAAM,CAAC,CACjF;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,GAAG;EACH,UAAU,iBAAiB,iBAAiB,WAAW;EACvD,QAAQ,eAAe,SAAS,iBAAiB,KAAA;EACjD,aAAa,oBAAoB,aAAa;EAC9C,SAAS,qBAAqB,aAAa;CAC7C;AACF;AAEA,SAAS,eACP,YACA,iBACA,gBACA,eACA;CAGA,OAAO,YAAY,WAAW,YAAY,OACtC,WAAW,UACX,CAAC,kBACC,iBACE,GAAG,eAAe,GAAG,cAAc,SAAS,aAAa,CAAC,MAC1D,cAAc,SAAS,aAAa,CAAC,IACvC;AACR;AAEA,SAAgB,oBAAoB,eAAwB;CAC1D,OAAO,QAAQ,aAAa,KAAK,2BAA2B,gBACxD,OAAO,cAAc,qBAAqB,IAC1C,KAAA;AACN;AAEA,SAAgB,qBAAqB,eAAwB;CAC3D,IAAI,kBAAkB,aAAa,GACjC,OAAO,cAAc;AAEzB;AAEA,SAAgB,4BAA4B,OAAe;CACzD,OAAO,SAAS,KAAK,KAAK,CAAC,GAAG;AAChC"}

package/esm/domain/error/error.types.mjs

@@ -0,0 +1,24 @@
+//#region src/domain/error/error.types.ts
+const ErrorSource = {
+	AGENT: "agent",
+	CONSOLE: "console",
+	CUSTOM: "custom",
+	LOGGER: "logger",
+	NETWORK: "network",
+	SOURCE: "source",
+	REPORT: "report"
+};
+let NonErrorPrefix = /* @__PURE__ */ function(NonErrorPrefix) {
+	NonErrorPrefix["UNCAUGHT"] = "Uncaught";
+	NonErrorPrefix["PROVIDED"] = "Provided";
+	return NonErrorPrefix;
+}({});
+let ErrorHandling = /* @__PURE__ */ function(ErrorHandling) {
+	ErrorHandling["HANDLED"] = "handled";
+	ErrorHandling["UNHANDLED"] = "unhandled";
+	return ErrorHandling;
+}({});
+//#endregion
+export { ErrorHandling, ErrorSource, NonErrorPrefix };
+
+//# sourceMappingURL=error.types.mjs.map

package/esm/domain/error/error.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.types.mjs","names":[],"sources":["../../../src/domain/error/error.types.ts"],"sourcesContent":["import type { ClocksState } from '@kubesense/kubesense-js-core/time'\nimport type { Context } from '../../tools/serialisation/context'\nimport type { DebugIdEntry } from '../sourceCodeContext'\n\n// TS v4.6 introduced Error.cause[1] typed as `Error`. TS v4.8 changed Error.cause to be\n// `unknown`[2].\n//\n// Because we still support TS 3.8, we need to declare our own type. We can remove it once we drop\n// support for TS v4.7 and before. The 'cause' property defined by TS needs to be omitted because\n// we define it with a type `unknown` which is incompatible with TS 4.6 and 4.7.\n//\n// [1]: https://devblogs.microsoft.com/typescript/announcing-typescript-4-6/#target-es2022\n// [2]: https://devblogs.microsoft.com/typescript/announcing-typescript-4-8/#lib-d-ts-updates\nexport interface ErrorWithCause extends Omit<Error, 'cause'> {\n  cause?: unknown\n}\n\nexport interface RawErrorCause {\n  message: string\n  source: ErrorSource\n  type: string\n  stack?: string\n}\n\nexport interface Csp {\n  disposition: 'enforce' | 'report'\n}\n\nexport interface RawError {\n  startClocks: ClocksState\n  message: string\n  type: string\n  stack?: string\n  source: ErrorSource\n  originalError?: unknown\n  handling?: ErrorHandling\n  handlingStack?: string\n  componentStack?: string\n  causes?: RawErrorCause[]\n  fingerprint?: string\n  csp?: Csp\n  context?: Context\n  debugIds?: DebugIdEntry[]\n}\n\nexport const ErrorSource = {\n  AGENT: 'agent',\n  CONSOLE: 'console',\n  CUSTOM: 'custom',\n  LOGGER: 'logger',\n  NETWORK: 'network',\n  SOURCE: 'source',\n  REPORT: 'report',\n} as const\n\nexport const enum NonErrorPrefix {\n  UNCAUGHT = 'Uncaught',\n  PROVIDED = 'Provided',\n}\n\nexport const enum ErrorHandling {\n  HANDLED = 'handled',\n  UNHANDLED = 'unhandled',\n}\n\nexport type ErrorSource = (typeof ErrorSource)[keyof typeof ErrorSource]\n"],"mappings":";AA6CA,MAAa,cAAc;CACzB,OAAO;CACP,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,QAAQ;AACV;AAEA,IAAkB,iBAAX,yBAAA,gBAAA;CACL,eAAA,cAAA;CACA,eAAA,cAAA;;AACF,EAAA,CAAA,CAAA;AAEA,IAAkB,gBAAX,yBAAA,eAAA;CACL,cAAA,aAAA;CACA,cAAA,eAAA;;AACF,EAAA,CAAA,CAAA"}

package/esm/domain/error/isError.mjs

@@ -0,0 +1,13 @@
+//#region src/domain/error/isError.ts
+const NO_ERROR_STACK_PRESENT_MESSAGE = "No stack, consider using an instance of Error";
+function isError(error) {
+	try {
+		return error instanceof Error || Object.prototype.toString.call(error) === "[object Error]";
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { NO_ERROR_STACK_PRESENT_MESSAGE, isError };
+
+//# sourceMappingURL=isError.mjs.map

package/esm/domain/error/isError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isError.mjs","names":[],"sources":["../../../src/domain/error/isError.ts"],"sourcesContent":["// Leaf module for error primitives with no further dependencies, so cross-cutting\n// modules (e.g. telemetry) can use them without pulling in the whole error module\n// and creating import cycles.\n\nexport const NO_ERROR_STACK_PRESENT_MESSAGE = 'No stack, consider using an instance of Error'\n\nexport function isError(error: unknown): error is Error {\n  try {\n    return error instanceof Error || Object.prototype.toString.call(error) === '[object Error]'\n  } catch {\n    return false\n  }\n}\n"],"mappings":";AAIA,MAAa,iCAAiC;AAE9C,SAAgB,QAAQ,OAAgC;CACtD,IAAI;EACF,OAAO,iBAAiB,SAAS,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM;CAC7E,QAAQ;EACN,OAAO;CACT;AACF"}

package/esm/domain/error/trackRuntimeError.mjs

@@ -0,0 +1,49 @@
+import { Observable } from "../../tools/observable.mjs";
+import { noop } from "../../tools/utils/functionUtils.mjs";
+import { computeStackTraceFromOnErrorMessage } from "../../tools/stackTrace/computeStackTrace.mjs";
+import { instrumentMethod } from "../../tools/instrumentMethod.mjs";
+import { isEventSupported } from "../../browser/addEventListener.mjs";
+import { isError } from "./isError.mjs";
+import { ErrorSource } from "./error.types.mjs";
+import { computeRawError } from "./error.mjs";
+import { globalObject } from "@kubesense/kubesense-js-core/util";
+import { clocksNow } from "@kubesense/kubesense-js-core/time";
+//#region src/domain/error/trackRuntimeError.ts
+function trackRuntimeError() {
+	return new Observable((observer) => {
+		const handleRuntimeError = (originalError, stackTrace) => {
+			const rawError = computeRawError({
+				stackTrace,
+				originalError,
+				startClocks: clocksNow(),
+				nonErrorPrefix: "Uncaught",
+				source: ErrorSource.SOURCE,
+				handling: "unhandled"
+			});
+			observer.notify(rawError);
+		};
+		const { stop: stopInstrumentingOnError } = instrumentOnError(handleRuntimeError);
+		const { stop: stopInstrumentingOnUnhandledRejection } = instrumentUnhandledRejection(handleRuntimeError);
+		return () => {
+			stopInstrumentingOnError();
+			stopInstrumentingOnUnhandledRejection();
+		};
+	});
+}
+function instrumentOnError(callback) {
+	return instrumentMethod(globalObject, "onerror", ({ parameters: [messageObj, url, line, column, errorObj] }) => {
+		let stackTrace;
+		if (!isError(errorObj)) stackTrace = computeStackTraceFromOnErrorMessage(messageObj, url, line, column);
+		callback(errorObj ?? messageObj, stackTrace);
+	});
+}
+function instrumentUnhandledRejection(callback) {
+	if (!isEventSupported(globalObject.window, "unhandledrejection")) return { stop: noop };
+	return instrumentMethod(globalObject, "onunhandledrejection", ({ parameters: [e] }) => {
+		callback(e.reason || "Empty reason");
+	});
+}
+//#endregion
+export { instrumentOnError, instrumentUnhandledRejection, trackRuntimeError };
+
+//# sourceMappingURL=trackRuntimeError.mjs.map

package/esm/domain/error/trackRuntimeError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackRuntimeError.mjs","names":[],"sources":["../../../src/domain/error/trackRuntimeError.ts"],"sourcesContent":["import { clocksNow } from '@kubesense/kubesense-js-core/time'\nimport { globalObject } from '@kubesense/kubesense-js-core/util'\nimport { instrumentMethod } from '../../tools/instrumentMethod'\nimport { Observable } from '../../tools/observable'\nimport type { StackTrace } from '../../tools/stackTrace/computeStackTrace'\nimport { computeStackTraceFromOnErrorMessage } from '../../tools/stackTrace/computeStackTrace'\nimport { DOM_EVENT, isEventSupported } from '../../browser/addEventListener'\nimport { noop } from '../../tools/utils/functionUtils'\nimport { computeRawError, isError } from './error'\nimport type { RawError } from './error.types'\nimport { ErrorHandling, ErrorSource, NonErrorPrefix } from './error.types'\n\nexport type UnhandledErrorCallback = (originalError: unknown, stackTrace?: StackTrace) => any\n\nexport function trackRuntimeError() {\n  return new Observable<RawError>((observer) => {\n    const handleRuntimeError = (originalError: unknown, stackTrace?: StackTrace) => {\n      const rawError = computeRawError({\n        stackTrace,\n        originalError,\n        startClocks: clocksNow(),\n        nonErrorPrefix: NonErrorPrefix.UNCAUGHT,\n        source: ErrorSource.SOURCE,\n        handling: ErrorHandling.UNHANDLED,\n      })\n      observer.notify(rawError)\n    }\n    const { stop: stopInstrumentingOnError } = instrumentOnError(handleRuntimeError)\n    const { stop: stopInstrumentingOnUnhandledRejection } = instrumentUnhandledRejection(handleRuntimeError)\n\n    return () => {\n      stopInstrumentingOnError()\n      stopInstrumentingOnUnhandledRejection()\n    }\n  })\n}\n\nexport function instrumentOnError(callback: UnhandledErrorCallback) {\n  return instrumentMethod(globalObject, 'onerror', ({ parameters: [messageObj, url, line, column, errorObj] }) => {\n    let stackTrace\n    if (!isError(errorObj)) {\n      stackTrace = computeStackTraceFromOnErrorMessage(messageObj, url, line, column)\n    }\n    callback(errorObj ?? messageObj, stackTrace)\n  })\n}\n\nexport function instrumentUnhandledRejection(callback: UnhandledErrorCallback) {\n  // Salesforce LWS does not support the unhandledrejection event. https://developer.salesforce.com/tools/lws-distortion-viewer\n  if (!isEventSupported(globalObject.window, DOM_EVENT.UNHANDLED_REJECTION)) {\n    return { stop: noop }\n  }\n\n  return instrumentMethod(globalObject, 'onunhandledrejection', ({ parameters: [e] }) => {\n    callback(e.reason || 'Empty reason')\n  })\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAgB,oBAAoB;CAClC,OAAO,IAAI,YAAsB,aAAa;EAC5C,MAAM,sBAAsB,eAAwB,eAA4B;GAC9E,MAAM,WAAW,gBAAgB;IAC/B;IACA;IACA,aAAa,UAAU;IACvB,gBAAA;IACA,QAAQ,YAAY;IACpB,UAAA;GACF,CAAC;GACD,SAAS,OAAO,QAAQ;EAC1B;EACA,MAAM,EAAE,MAAM,6BAA6B,kBAAkB,kBAAkB;EAC/E,MAAM,EAAE,MAAM,0CAA0C,6BAA6B,kBAAkB;EAEvG,aAAa;GACX,yBAAyB;GACzB,sCAAsC;EACxC;CACF,CAAC;AACH;AAEA,SAAgB,kBAAkB,UAAkC;CAClE,OAAO,iBAAiB,cAAc,YAAY,EAAE,YAAY,CAAC,YAAY,KAAK,MAAM,QAAQ,gBAAgB;EAC9G,IAAI;EACJ,IAAI,CAAC,QAAQ,QAAQ,GACnB,aAAa,oCAAoC,YAAY,KAAK,MAAM,MAAM;EAEhF,SAAS,YAAY,YAAY,UAAU;CAC7C,CAAC;AACH;AAEA,SAAgB,6BAA6B,UAAkC;CAE7E,IAAI,CAAC,iBAAiB,aAAa,QAAA,oBAAqC,GACtE,OAAO,EAAE,MAAM,KAAK;CAGtB,OAAO,iBAAiB,cAAc,yBAAyB,EAAE,YAAY,CAAC,SAAS;EACrF,SAAS,EAAE,UAAU,cAAc;CACrC,CAAC;AACH"}

package/esm/domain/eventRateLimiter/createEventRateLimiter.mjs

@@ -0,0 +1,31 @@
+import { setTimeout } from "../../tools/timer.mjs";
+import { ONE_MINUTE } from "@kubesense/kubesense-js-core/time";
+//#region src/domain/eventRateLimiter/createEventRateLimiter.ts
+const EVENT_RATE_LIMIT = 3e3;
+function createEventRateLimiter(eventType, onLimitReached, limit = EVENT_RATE_LIMIT) {
+	let eventCount = 0;
+	let allowNextEvent = false;
+	return { isLimitReached() {
+		if (eventCount === 0) setTimeout(() => {
+			eventCount = 0;
+		}, ONE_MINUTE);
+		eventCount += 1;
+		if (eventCount <= limit || allowNextEvent) {
+			allowNextEvent = false;
+			return false;
+		}
+		if (eventCount === limit + 1) {
+			allowNextEvent = true;
+			try {
+				onLimitReached(`Reached max number of ${eventType}s by minute: ${limit}`);
+			} finally {
+				allowNextEvent = false;
+			}
+		}
+		return true;
+	} };
+}
+//#endregion
+export { createEventRateLimiter };
+
+//# sourceMappingURL=createEventRateLimiter.mjs.map

package/esm/domain/eventRateLimiter/createEventRateLimiter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEventRateLimiter.mjs","names":[],"sources":["../../../src/domain/eventRateLimiter/createEventRateLimiter.ts"],"sourcesContent":["import { ONE_MINUTE } from '@kubesense/kubesense-js-core/time'\nimport { setTimeout } from '../../tools/timer'\n\nexport type EventRateLimiter = ReturnType<typeof createEventRateLimiter>\n\n// Limit the maximum number of actions, errors and logs per minutes\nconst EVENT_RATE_LIMIT = 3000\n\nexport function createEventRateLimiter(\n  eventType: string,\n  onLimitReached: (message: string) => void,\n  limit = EVENT_RATE_LIMIT\n) {\n  let eventCount = 0\n  let allowNextEvent = false\n\n  return {\n    isLimitReached() {\n      if (eventCount === 0) {\n        setTimeout(() => {\n          eventCount = 0\n        }, ONE_MINUTE)\n      }\n\n      eventCount += 1\n      if (eventCount <= limit || allowNextEvent) {\n        allowNextEvent = false\n        return false\n      }\n\n      if (eventCount === limit + 1) {\n        allowNextEvent = true\n        try {\n          onLimitReached(`Reached max number of ${eventType}s by minute: ${limit}`)\n        } finally {\n          allowNextEvent = false\n        }\n      }\n\n      return true\n    },\n  }\n}\n"],"mappings":";;;AAMA,MAAM,mBAAmB;AAEzB,SAAgB,uBACd,WACA,gBACA,QAAQ,kBACR;CACA,IAAI,aAAa;CACjB,IAAI,iBAAiB;CAErB,OAAO,EACL,iBAAiB;EACf,IAAI,eAAe,GACjB,iBAAiB;GACf,aAAa;EACf,GAAG,UAAU;EAGf,cAAc;EACd,IAAI,cAAc,SAAS,gBAAgB;GACzC,iBAAiB;GACjB,OAAO;EACT;EAEA,IAAI,eAAe,QAAQ,GAAG;GAC5B,iBAAiB;GACjB,IAAI;IACF,eAAe,yBAAyB,UAAU,eAAe,OAAO;GAC1E,UAAU;IACR,iBAAiB;GACnB;EACF;EAEA,OAAO;CACT,EACF;AACF"}