@safaricom-mxl/web-sdk 0.0.16 → 0.0.18

package/dist/managers/MXLUserSessionManager/constants.cjs

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/managers/MXLUserSessionManager/constants.ts
+const MXL_USER_SESSION_STATE_KEY = "mxl_user_session_state";
+/**
+* Bump when UserSessionState's shape changes incompatibly. Persisted blobs
+* whose schemaVersion doesn't match are discarded on read.
+*/
+const USER_SESSION_STATE_SCHEMA_VERSION = 1;
+const MXL_USER_SESSION_NUMBER_KEY = "mxl_user_session_number";
+const MXL_SESSION_PART_NUMBER_KEY = "mxl_session_part_number";
+const MXL_PERMANENT_PROPERTIES_KEY = "mxl_permanent_properties";
+const MXL_LAST_END_USER_SESSION_TS_KEY = "mxl_last_end_user_session_ts";
+const MXL_TAB_STORAGE_KEY = "mxl_tab";
+const MXL_TAB_ACTIVITY_STORAGE_KEY = "mxl_tab_activity";
+const SESSION_PART_SPAN_NAME = "mxl-session-part";
+const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS = 720 * 60;
+const MIN_USER_SESSION_MAX_DURATION_SECONDS = 3600;
+const MAX_USER_SESSION_MAX_DURATION_SECONDS = 1440 * 60;
+const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 1800;
+const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;
+const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 1440 * 60;
+const END_USER_SESSION_COOLDOWN_MS = 5 * 1e3;
+/**
+* Default upper bound on how often the activity handler runs; prevents
+* mousemove from re-arming the inactivity timer for every sub-second event.
+*/
+const DEFAULT_ACTIVITY_THROTTLE_MS = 30 * 1e3;
+/** Default input events that count as user interaction with a foreground tab. */
+const DEFAULT_ACTIVITY_EVENTS = [
+	"keydown",
+	"mousedown",
+	"mousemove",
+	"scroll"
+];
+//#endregion
+exports.DEFAULT_ACTIVITY_EVENTS = DEFAULT_ACTIVITY_EVENTS;
+exports.DEFAULT_ACTIVITY_THROTTLE_MS = DEFAULT_ACTIVITY_THROTTLE_MS;
+exports.DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS;
+exports.DEFAULT_USER_SESSION_MAX_DURATION_SECONDS = DEFAULT_USER_SESSION_MAX_DURATION_SECONDS;
+exports.END_USER_SESSION_COOLDOWN_MS = END_USER_SESSION_COOLDOWN_MS;
+exports.MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS;
+exports.MAX_USER_SESSION_MAX_DURATION_SECONDS = MAX_USER_SESSION_MAX_DURATION_SECONDS;
+exports.MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS;
+exports.MIN_USER_SESSION_MAX_DURATION_SECONDS = MIN_USER_SESSION_MAX_DURATION_SECONDS;
+exports.MXL_LAST_END_USER_SESSION_TS_KEY = MXL_LAST_END_USER_SESSION_TS_KEY;
+exports.MXL_PERMANENT_PROPERTIES_KEY = MXL_PERMANENT_PROPERTIES_KEY;
+exports.MXL_SESSION_PART_NUMBER_KEY = MXL_SESSION_PART_NUMBER_KEY;
+exports.MXL_TAB_ACTIVITY_STORAGE_KEY = MXL_TAB_ACTIVITY_STORAGE_KEY;
+exports.MXL_TAB_STORAGE_KEY = MXL_TAB_STORAGE_KEY;
+exports.MXL_USER_SESSION_NUMBER_KEY = MXL_USER_SESSION_NUMBER_KEY;
+exports.MXL_USER_SESSION_STATE_KEY = MXL_USER_SESSION_STATE_KEY;
+exports.SESSION_PART_SPAN_NAME = SESSION_PART_SPAN_NAME;
+exports.USER_SESSION_STATE_SCHEMA_VERSION = USER_SESSION_STATE_SCHEMA_VERSION;
+
+//# sourceMappingURL=constants.cjs.map

package/dist/managers/MXLUserSessionManager/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/managers/MXLUserSessionManager/constants.ts"],"sourcesContent":["export const MXL_USER_SESSION_STATE_KEY = 'mxl_user_session_state';\n/**\n * Bump when UserSessionState's shape changes incompatibly. Persisted blobs\n * whose schemaVersion doesn't match are discarded on read.\n */\nexport const USER_SESSION_STATE_SCHEMA_VERSION = 1;\nexport const MXL_USER_SESSION_NUMBER_KEY = 'mxl_user_session_number';\nexport const MXL_SESSION_PART_NUMBER_KEY = 'mxl_session_part_number';\nexport const MXL_PERMANENT_PROPERTIES_KEY = 'mxl_permanent_properties';\nexport const MXL_LAST_END_USER_SESSION_TS_KEY = 'mxl_last_end_user_session_ts';\n\nexport const MXL_TAB_STORAGE_KEY = 'mxl_tab';\nexport const MXL_TAB_ACTIVITY_STORAGE_KEY = 'mxl_tab_activity';\n\nexport const SESSION_PART_SPAN_NAME = 'mxl-session-part';\n\nexport const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS = 12 * 60 * 60;\nexport const MIN_USER_SESSION_MAX_DURATION_SECONDS = 1 * 60 * 60;\nexport const MAX_USER_SESSION_MAX_DURATION_SECONDS = 24 * 60 * 60;\n\nexport const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30 * 60;\nexport const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;\nexport const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 24 * 60 * 60;\n\n// Anti-spam guard: minimum interval between successful endUserSession calls.\n// Persists across page refreshes so a refresh-and-call loop can't manufacture\n// Session boundaries faster than this.\nexport const END_USER_SESSION_COOLDOWN_MS = 5 * 1000;\n\n/**\n * Default upper bound on how often the activity handler runs; prevents\n * mousemove from re-arming the inactivity timer for every sub-second event.\n */\nexport const DEFAULT_ACTIVITY_THROTTLE_MS = 30 * 1000;\n\n/** Default input events that count as user interaction with a foreground tab. */\nexport const DEFAULT_ACTIVITY_EVENTS: readonly string[] = [\n  'keydown',\n  'mousedown',\n  'mousemove',\n  'scroll',\n];\n"],"mappings":";;AAAA,MAAa,6BAA6B;;;;;AAK1C,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAC3C,MAAa,+BAA+B;AAC5C,MAAa,mCAAmC;AAEhD,MAAa,sBAAsB;AACnC,MAAa,+BAA+B;AAE5C,MAAa,yBAAyB;AAEtC,MAAa,4CAA4C,MAAU;AACnE,MAAa,wCAAwC;AACrD,MAAa,wCAAwC,OAAU;AAE/D,MAAa,kDAAkD;AAC/D,MAAa,8CAA8C;AAC3D,MAAa,8CAA8C,OAAU;AAKrE,MAAa,+BAA+B,IAAI;;;;;AAMhD,MAAa,+BAA+B,KAAK;;AAGjD,MAAa,0BAA6C;CACxD;CACA;CACA;CACA;CACD"}

package/dist/managers/MXLUserSessionManager/constants.d.cts

@@ -0,0 +1,31 @@
+//#region src/managers/MXLUserSessionManager/constants.d.ts
+declare const MXL_USER_SESSION_STATE_KEY = "mxl_user_session_state";
+/**
+ * Bump when UserSessionState's shape changes incompatibly. Persisted blobs
+ * whose schemaVersion doesn't match are discarded on read.
+ */
+declare const USER_SESSION_STATE_SCHEMA_VERSION = 1;
+declare const MXL_USER_SESSION_NUMBER_KEY = "mxl_user_session_number";
+declare const MXL_SESSION_PART_NUMBER_KEY = "mxl_session_part_number";
+declare const MXL_PERMANENT_PROPERTIES_KEY = "mxl_permanent_properties";
+declare const MXL_LAST_END_USER_SESSION_TS_KEY = "mxl_last_end_user_session_ts";
+declare const MXL_TAB_STORAGE_KEY = "mxl_tab";
+declare const MXL_TAB_ACTIVITY_STORAGE_KEY = "mxl_tab_activity";
+declare const SESSION_PART_SPAN_NAME = "mxl-session-part";
+declare const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const MIN_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const MAX_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS: number;
+declare const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;
+declare const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS: number;
+declare const END_USER_SESSION_COOLDOWN_MS: number;
+/**
+ * Default upper bound on how often the activity handler runs; prevents
+ * mousemove from re-arming the inactivity timer for every sub-second event.
+ */
+declare const DEFAULT_ACTIVITY_THROTTLE_MS: number;
+/** Default input events that count as user interaction with a foreground tab. */
+declare const DEFAULT_ACTIVITY_EVENTS: readonly string[];
+//#endregion
+export { DEFAULT_ACTIVITY_EVENTS, DEFAULT_ACTIVITY_THROTTLE_MS, DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, DEFAULT_USER_SESSION_MAX_DURATION_SECONDS, END_USER_SESSION_COOLDOWN_MS, MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MAX_USER_SESSION_MAX_DURATION_SECONDS, MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MIN_USER_SESSION_MAX_DURATION_SECONDS, MXL_LAST_END_USER_SESSION_TS_KEY, MXL_PERMANENT_PROPERTIES_KEY, MXL_SESSION_PART_NUMBER_KEY, MXL_TAB_ACTIVITY_STORAGE_KEY, MXL_TAB_STORAGE_KEY, MXL_USER_SESSION_NUMBER_KEY, MXL_USER_SESSION_STATE_KEY, SESSION_PART_SPAN_NAME, USER_SESSION_STATE_SCHEMA_VERSION };
+//# sourceMappingURL=constants.d.cts.map

package/dist/managers/MXLUserSessionManager/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","names":[],"sources":["../../../src/managers/MXLUserSessionManager/constants.ts"],"mappings":";cAAa,0BAAA;AAAb;;;;AAAA,cAKa,iCAAA;AAAA,cACA,2BAAA;AAAA,cACA,2BAAA;AAAA,cACA,4BAAA;AAAA,cACA,gCAAA;AAAA,cAEA,mBAAA;AAAA,cACA,4BAAA;AAAA,cAEA,sBAAA;AAAA,cAEA,yCAAA;AAAA,cACA,qCAAA;AAAA,cACA,qCAAA;AAAA,cAEA,+CAAA;AAAA,cACA,2CAAA;AAAA,cACA,2CAAA;AAAA,cAKA,4BAAA;;AAnBb;;;cAyBa,4BAAA;;cAGA,uBAAA"}

package/dist/managers/MXLUserSessionManager/constants.d.ts

@@ -0,0 +1,31 @@
+//#region src/managers/MXLUserSessionManager/constants.d.ts
+declare const MXL_USER_SESSION_STATE_KEY = "mxl_user_session_state";
+/**
+ * Bump when UserSessionState's shape changes incompatibly. Persisted blobs
+ * whose schemaVersion doesn't match are discarded on read.
+ */
+declare const USER_SESSION_STATE_SCHEMA_VERSION = 1;
+declare const MXL_USER_SESSION_NUMBER_KEY = "mxl_user_session_number";
+declare const MXL_SESSION_PART_NUMBER_KEY = "mxl_session_part_number";
+declare const MXL_PERMANENT_PROPERTIES_KEY = "mxl_permanent_properties";
+declare const MXL_LAST_END_USER_SESSION_TS_KEY = "mxl_last_end_user_session_ts";
+declare const MXL_TAB_STORAGE_KEY = "mxl_tab";
+declare const MXL_TAB_ACTIVITY_STORAGE_KEY = "mxl_tab_activity";
+declare const SESSION_PART_SPAN_NAME = "mxl-session-part";
+declare const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const MIN_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const MAX_USER_SESSION_MAX_DURATION_SECONDS: number;
+declare const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS: number;
+declare const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;
+declare const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS: number;
+declare const END_USER_SESSION_COOLDOWN_MS: number;
+/**
+ * Default upper bound on how often the activity handler runs; prevents
+ * mousemove from re-arming the inactivity timer for every sub-second event.
+ */
+declare const DEFAULT_ACTIVITY_THROTTLE_MS: number;
+/** Default input events that count as user interaction with a foreground tab. */
+declare const DEFAULT_ACTIVITY_EVENTS: readonly string[];
+//#endregion
+export { DEFAULT_ACTIVITY_EVENTS, DEFAULT_ACTIVITY_THROTTLE_MS, DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, DEFAULT_USER_SESSION_MAX_DURATION_SECONDS, END_USER_SESSION_COOLDOWN_MS, MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MAX_USER_SESSION_MAX_DURATION_SECONDS, MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MIN_USER_SESSION_MAX_DURATION_SECONDS, MXL_LAST_END_USER_SESSION_TS_KEY, MXL_PERMANENT_PROPERTIES_KEY, MXL_SESSION_PART_NUMBER_KEY, MXL_TAB_ACTIVITY_STORAGE_KEY, MXL_TAB_STORAGE_KEY, MXL_USER_SESSION_NUMBER_KEY, MXL_USER_SESSION_STATE_KEY, SESSION_PART_SPAN_NAME, USER_SESSION_STATE_SCHEMA_VERSION };
+//# sourceMappingURL=constants.d.ts.map

package/dist/managers/MXLUserSessionManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../../src/managers/MXLUserSessionManager/constants.ts"],"mappings":";cAAa,0BAAA;AAAb;;;;AAAA,cAKa,iCAAA;AAAA,cACA,2BAAA;AAAA,cACA,2BAAA;AAAA,cACA,4BAAA;AAAA,cACA,gCAAA;AAAA,cAEA,mBAAA;AAAA,cACA,4BAAA;AAAA,cAEA,sBAAA;AAAA,cAEA,yCAAA;AAAA,cACA,qCAAA;AAAA,cACA,qCAAA;AAAA,cAEA,+CAAA;AAAA,cACA,2CAAA;AAAA,cACA,2CAAA;AAAA,cAKA,4BAAA;;AAnBb;;;cAyBa,4BAAA;;cAGA,uBAAA"}

package/dist/managers/MXLUserSessionManager/constants.js

@@ -0,0 +1,37 @@
+//#region src/managers/MXLUserSessionManager/constants.ts
+const MXL_USER_SESSION_STATE_KEY = "mxl_user_session_state";
+/**
+* Bump when UserSessionState's shape changes incompatibly. Persisted blobs
+* whose schemaVersion doesn't match are discarded on read.
+*/
+const USER_SESSION_STATE_SCHEMA_VERSION = 1;
+const MXL_USER_SESSION_NUMBER_KEY = "mxl_user_session_number";
+const MXL_SESSION_PART_NUMBER_KEY = "mxl_session_part_number";
+const MXL_PERMANENT_PROPERTIES_KEY = "mxl_permanent_properties";
+const MXL_LAST_END_USER_SESSION_TS_KEY = "mxl_last_end_user_session_ts";
+const MXL_TAB_STORAGE_KEY = "mxl_tab";
+const MXL_TAB_ACTIVITY_STORAGE_KEY = "mxl_tab_activity";
+const SESSION_PART_SPAN_NAME = "mxl-session-part";
+const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS = 720 * 60;
+const MIN_USER_SESSION_MAX_DURATION_SECONDS = 3600;
+const MAX_USER_SESSION_MAX_DURATION_SECONDS = 1440 * 60;
+const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 1800;
+const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;
+const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 1440 * 60;
+const END_USER_SESSION_COOLDOWN_MS = 5 * 1e3;
+/**
+* Default upper bound on how often the activity handler runs; prevents
+* mousemove from re-arming the inactivity timer for every sub-second event.
+*/
+const DEFAULT_ACTIVITY_THROTTLE_MS = 30 * 1e3;
+/** Default input events that count as user interaction with a foreground tab. */
+const DEFAULT_ACTIVITY_EVENTS = [
+	"keydown",
+	"mousedown",
+	"mousemove",
+	"scroll"
+];
+//#endregion
+export { DEFAULT_ACTIVITY_EVENTS, DEFAULT_ACTIVITY_THROTTLE_MS, DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, DEFAULT_USER_SESSION_MAX_DURATION_SECONDS, END_USER_SESSION_COOLDOWN_MS, MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MAX_USER_SESSION_MAX_DURATION_SECONDS, MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS, MIN_USER_SESSION_MAX_DURATION_SECONDS, MXL_LAST_END_USER_SESSION_TS_KEY, MXL_PERMANENT_PROPERTIES_KEY, MXL_SESSION_PART_NUMBER_KEY, MXL_TAB_ACTIVITY_STORAGE_KEY, MXL_TAB_STORAGE_KEY, MXL_USER_SESSION_NUMBER_KEY, MXL_USER_SESSION_STATE_KEY, SESSION_PART_SPAN_NAME, USER_SESSION_STATE_SCHEMA_VERSION };
+
+//# sourceMappingURL=constants.js.map

package/dist/managers/MXLUserSessionManager/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/managers/MXLUserSessionManager/constants.ts"],"sourcesContent":["export const MXL_USER_SESSION_STATE_KEY = 'mxl_user_session_state';\n/**\n * Bump when UserSessionState's shape changes incompatibly. Persisted blobs\n * whose schemaVersion doesn't match are discarded on read.\n */\nexport const USER_SESSION_STATE_SCHEMA_VERSION = 1;\nexport const MXL_USER_SESSION_NUMBER_KEY = 'mxl_user_session_number';\nexport const MXL_SESSION_PART_NUMBER_KEY = 'mxl_session_part_number';\nexport const MXL_PERMANENT_PROPERTIES_KEY = 'mxl_permanent_properties';\nexport const MXL_LAST_END_USER_SESSION_TS_KEY = 'mxl_last_end_user_session_ts';\n\nexport const MXL_TAB_STORAGE_KEY = 'mxl_tab';\nexport const MXL_TAB_ACTIVITY_STORAGE_KEY = 'mxl_tab_activity';\n\nexport const SESSION_PART_SPAN_NAME = 'mxl-session-part';\n\nexport const DEFAULT_USER_SESSION_MAX_DURATION_SECONDS = 12 * 60 * 60;\nexport const MIN_USER_SESSION_MAX_DURATION_SECONDS = 1 * 60 * 60;\nexport const MAX_USER_SESSION_MAX_DURATION_SECONDS = 24 * 60 * 60;\n\nexport const DEFAULT_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30 * 60;\nexport const MIN_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 30;\nexport const MAX_USER_SESSION_INACTIVITY_TIMEOUT_SECONDS = 24 * 60 * 60;\n\n// Anti-spam guard: minimum interval between successful endUserSession calls.\n// Persists across page refreshes so a refresh-and-call loop can't manufacture\n// Session boundaries faster than this.\nexport const END_USER_SESSION_COOLDOWN_MS = 5 * 1000;\n\n/**\n * Default upper bound on how often the activity handler runs; prevents\n * mousemove from re-arming the inactivity timer for every sub-second event.\n */\nexport const DEFAULT_ACTIVITY_THROTTLE_MS = 30 * 1000;\n\n/** Default input events that count as user interaction with a foreground tab. */\nexport const DEFAULT_ACTIVITY_EVENTS: readonly string[] = [\n  'keydown',\n  'mousedown',\n  'mousemove',\n  'scroll',\n];\n"],"mappings":";AAAA,MAAa,6BAA6B;;;;;AAK1C,MAAa,oCAAoC;AACjD,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAC3C,MAAa,+BAA+B;AAC5C,MAAa,mCAAmC;AAEhD,MAAa,sBAAsB;AACnC,MAAa,+BAA+B;AAE5C,MAAa,yBAAyB;AAEtC,MAAa,4CAA4C,MAAU;AACnE,MAAa,wCAAwC;AACrD,MAAa,wCAAwC,OAAU;AAE/D,MAAa,kDAAkD;AAC/D,MAAa,8CAA8C;AAC3D,MAAa,8CAA8C,OAAU;AAKrE,MAAa,+BAA+B,IAAI;;;;;AAMhD,MAAa,+BAA+B,KAAK;;AAGjD,MAAa,0BAA6C;CACxD;CACA;CACA;CACA;CACD"}

package/dist/managers/MXLUserSessionManager/types.d.cts

@@ -0,0 +1,84 @@
+import { ExtendedSpan } from "../../api-traces/api/TraceAPI/types.cjs";
+import { SessionPartEndReason, SessionPartStartReason, UserSessionEndReason, UserSessionManager } from "../../api-sessions/manager/types.cjs";
+import { VisibilityStateDocument } from "../../common/types.cjs";
+import { NamespacedStorage } from "../../utils/NamespacedStorage/NamespacedStorage.cjs";
+import { PerformanceManager } from "../../utils/PerformanceManager/types.cjs";
+import { LimitManagerInternal } from "../MXLLimitManager/types.cjs";
+import { DiagLogger, TracerProvider } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/types.d.ts
+interface UserSessionState {
+  readonly schemaVersion: number;
+  readonly userSessionId: string;
+  readonly previousUserSessionId: string | null;
+  readonly userSessionStartTs: number;
+  readonly userSessionMaxEndTs: number;
+  readonly userSessionNumber: number;
+  readonly userSessionPartIndex: number;
+  readonly maxUserSessionDurationSeconds: number;
+  readonly inactivityTimeoutSeconds: number;
+  readonly inactivityDeadlineTs: number | null;
+  readonly userSessionProperties: Record<string, string>;
+}
+interface UserSessionConfig {
+  maxUserSessionDurationSeconds?: number;
+  inactivityTimeoutSeconds?: number;
+}
+interface UserSessionAttributes {
+  readonly 'mxl.user_session_id': string;
+  readonly 'session.id': string;
+  readonly 'mxl.user_session_previous_id': string;
+  readonly 'session.previous_id': string;
+  readonly 'mxl.user_session_number': number;
+  readonly 'mxl.user_session_part_index': number;
+  readonly 'mxl.session_part_number': number;
+  readonly 'mxl.user_session_start_ts': number;
+  readonly 'mxl.user_session_max_duration_seconds': number;
+  readonly 'mxl.user_session_inactivity_timeout_seconds': number;
+}
+interface UserSessionManagerInternal extends UserSessionManager {
+  getUserSessionAttributes: () => UserSessionAttributes | null;
+  getSessionPartProperties: () => Record<string, string>;
+  getSessionPartId: () => string | null;
+  getSessionPartSpan: () => ExtendedSpan | null;
+  startSessionPartInternal: (reason: SessionPartStartReason) => void;
+  endSessionPartInternal: (reason: SessionPartEndReason, userSessionEndReason?: UserSessionEndReason) => void;
+  incrSessionPartCountForKey: (key: string) => void;
+  incrNextSessionPartCountForKey: (key: string) => void;
+  addSessionPartStartedListener: (listener: () => void) => () => void;
+  addSessionPartEndedListener: (listener: () => void) => () => void;
+  setTracerProvider: (tracerProvider: TracerProvider) => void;
+  recordSDKStartupDuration: (duration: number) => void;
+  /** @internal For tests */
+  _clearMaxDurationTimer: () => void;
+  /** @internal For tests and teardown */
+  _shutdown: () => void;
+}
+type NavigationSource = 'same_origin' | 'external' | 'direct' | 'reload' | 'back_forward';
+interface Tab {
+  experienceId: string;
+  tabId: string;
+  sourceTabId?: string;
+}
+interface TabActivity {
+  experienceId: string;
+  tabId: string;
+  lastActivityMs: number;
+}
+interface MXLUserSessionManagerArgs {
+  diag?: DiagLogger;
+  perf: PerformanceManager;
+  storage: NamespacedStorage;
+  tabStorage: NamespacedStorage;
+  config?: UserSessionConfig;
+  visibilityDoc: VisibilityStateDocument;
+  limitManager: LimitManagerInternal;
+  target?: EventTarget;
+  activityThrottleMs?: number;
+  activityEvents?: readonly string[];
+  referrer?: string;
+  navigationPerformance?: Pick<Performance, 'getEntriesByType'>;
+}
+//#endregion
+export { MXLUserSessionManagerArgs, NavigationSource, Tab, TabActivity, UserSessionAttributes, UserSessionConfig, UserSessionManagerInternal, UserSessionState };
+//# sourceMappingURL=types.d.cts.map

package/dist/managers/MXLUserSessionManager/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/managers/MXLUserSessionManager/types.ts"],"mappings":";;;;;;;;;UAYiB,gBAAA;EAAA,SACN,aAAA;EAAA,SACA,aAAA;EAAA,SACA,qBAAA;EAAA,SACA,kBAAA;EAAA,SACA,mBAAA;EAAA,SACA,iBAAA;EAAA,SACA,oBAAA;EAAA,SACA,6BAAA;EAAA,SACA,wBAAA;EAAA,SACA,oBAAA;EAAA,SACA,qBAAA,EAAuB,MAAA;AAAA;AAAA,UAGjB,iBAAA;EACf,6BAAA;EACA,wBAAA;AAAA;AAAA,UAGe,qBAAA;EAAA,SACN,qBAAA;EAAA,SACA,YAAA;EAAA,SACA,8BAAA;EAAA,SACA,qBAAA;EAAA,SACA,yBAAA;EAAA,SACA,6BAAA;EAAA,SACA,yBAAA;EAAA,SACA,2BAAA;EAAA,SACA,uCAAA;EAAA,SACA,6CAAA;AAAA;AAAA,UAGM,0BAAA,SAAmC,kBAAA;EAClD,wBAAA,QAAgC,qBAAA;EAChC,wBAAA,QAAgC,MAAA;EAChC,gBAAA;EACA,kBAAA,QAA0B,YAAA;EAC1B,wBAAA,GAA2B,MAAA,EAAQ,sBAAA;EACnC,sBAAA,GACE,MAAA,EAAQ,oBAAA,EACR,oBAAA,GAAuB,oBAAA;EAEzB,0BAAA,GAA6B,GAAA;EAC7B,8BAAA,GAAiC,GAAA;EACjC,6BAAA,GAAgC,QAAA;EAChC,2BAAA,GAA8B,QAAA;EAC9B,iBAAA,GAAoB,cAAA,EAAgB,cAAA;EACpC,wBAAA,GAA2B,QAAA;EAfe;EAiB1C,sBAAA;EAhBgC;EAkBhC,SAAA;AAAA;AAAA,KAGU,gBAAA;AAAA,UAOK,GAAA;EACf,YAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,YAAA;EACA,KAAA;EACA,cAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA,GAAO,UAAA;EACP,IAAA,EAAM,kBAAA;EACN,OAAA,EAAS,iBAAA;EACT,UAAA,EAAY,iBAAA;EACZ,MAAA,GAAS,iBAAA;EACT,aAAA,EAAe,uBAAA;EACf,YAAA,EAAc,oBAAA;EACd,MAAA,GAAS,WAAA;EACT,kBAAA;EACA,cAAA;EACA,QAAA;EACA,qBAAA,GAAwB,IAAA,CAAK,WAAA;AAAA"}

package/dist/managers/MXLUserSessionManager/types.d.ts

@@ -0,0 +1,84 @@
+import { ExtendedSpan } from "../../api-traces/api/TraceAPI/types.js";
+import { SessionPartEndReason, SessionPartStartReason, UserSessionEndReason, UserSessionManager } from "../../api-sessions/manager/types.js";
+import { VisibilityStateDocument } from "../../common/types.js";
+import { NamespacedStorage } from "../../utils/NamespacedStorage/NamespacedStorage.js";
+import { PerformanceManager } from "../../utils/PerformanceManager/types.js";
+import { LimitManagerInternal } from "../MXLLimitManager/types.js";
+import { DiagLogger, TracerProvider } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/types.d.ts
+interface UserSessionState {
+  readonly schemaVersion: number;
+  readonly userSessionId: string;
+  readonly previousUserSessionId: string | null;
+  readonly userSessionStartTs: number;
+  readonly userSessionMaxEndTs: number;
+  readonly userSessionNumber: number;
+  readonly userSessionPartIndex: number;
+  readonly maxUserSessionDurationSeconds: number;
+  readonly inactivityTimeoutSeconds: number;
+  readonly inactivityDeadlineTs: number | null;
+  readonly userSessionProperties: Record<string, string>;
+}
+interface UserSessionConfig {
+  maxUserSessionDurationSeconds?: number;
+  inactivityTimeoutSeconds?: number;
+}
+interface UserSessionAttributes {
+  readonly 'mxl.user_session_id': string;
+  readonly 'session.id': string;
+  readonly 'mxl.user_session_previous_id': string;
+  readonly 'session.previous_id': string;
+  readonly 'mxl.user_session_number': number;
+  readonly 'mxl.user_session_part_index': number;
+  readonly 'mxl.session_part_number': number;
+  readonly 'mxl.user_session_start_ts': number;
+  readonly 'mxl.user_session_max_duration_seconds': number;
+  readonly 'mxl.user_session_inactivity_timeout_seconds': number;
+}
+interface UserSessionManagerInternal extends UserSessionManager {
+  getUserSessionAttributes: () => UserSessionAttributes | null;
+  getSessionPartProperties: () => Record<string, string>;
+  getSessionPartId: () => string | null;
+  getSessionPartSpan: () => ExtendedSpan | null;
+  startSessionPartInternal: (reason: SessionPartStartReason) => void;
+  endSessionPartInternal: (reason: SessionPartEndReason, userSessionEndReason?: UserSessionEndReason) => void;
+  incrSessionPartCountForKey: (key: string) => void;
+  incrNextSessionPartCountForKey: (key: string) => void;
+  addSessionPartStartedListener: (listener: () => void) => () => void;
+  addSessionPartEndedListener: (listener: () => void) => () => void;
+  setTracerProvider: (tracerProvider: TracerProvider) => void;
+  recordSDKStartupDuration: (duration: number) => void;
+  /** @internal For tests */
+  _clearMaxDurationTimer: () => void;
+  /** @internal For tests and teardown */
+  _shutdown: () => void;
+}
+type NavigationSource = 'same_origin' | 'external' | 'direct' | 'reload' | 'back_forward';
+interface Tab {
+  experienceId: string;
+  tabId: string;
+  sourceTabId?: string;
+}
+interface TabActivity {
+  experienceId: string;
+  tabId: string;
+  lastActivityMs: number;
+}
+interface MXLUserSessionManagerArgs {
+  diag?: DiagLogger;
+  perf: PerformanceManager;
+  storage: NamespacedStorage;
+  tabStorage: NamespacedStorage;
+  config?: UserSessionConfig;
+  visibilityDoc: VisibilityStateDocument;
+  limitManager: LimitManagerInternal;
+  target?: EventTarget;
+  activityThrottleMs?: number;
+  activityEvents?: readonly string[];
+  referrer?: string;
+  navigationPerformance?: Pick<Performance, 'getEntriesByType'>;
+}
+//#endregion
+export { MXLUserSessionManagerArgs, NavigationSource, Tab, TabActivity, UserSessionAttributes, UserSessionConfig, UserSessionManagerInternal, UserSessionState };
+//# sourceMappingURL=types.d.ts.map

package/dist/managers/MXLUserSessionManager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/managers/MXLUserSessionManager/types.ts"],"mappings":";;;;;;;;;UAYiB,gBAAA;EAAA,SACN,aAAA;EAAA,SACA,aAAA;EAAA,SACA,qBAAA;EAAA,SACA,kBAAA;EAAA,SACA,mBAAA;EAAA,SACA,iBAAA;EAAA,SACA,oBAAA;EAAA,SACA,6BAAA;EAAA,SACA,wBAAA;EAAA,SACA,oBAAA;EAAA,SACA,qBAAA,EAAuB,MAAA;AAAA;AAAA,UAGjB,iBAAA;EACf,6BAAA;EACA,wBAAA;AAAA;AAAA,UAGe,qBAAA;EAAA,SACN,qBAAA;EAAA,SACA,YAAA;EAAA,SACA,8BAAA;EAAA,SACA,qBAAA;EAAA,SACA,yBAAA;EAAA,SACA,6BAAA;EAAA,SACA,yBAAA;EAAA,SACA,2BAAA;EAAA,SACA,uCAAA;EAAA,SACA,6CAAA;AAAA;AAAA,UAGM,0BAAA,SAAmC,kBAAA;EAClD,wBAAA,QAAgC,qBAAA;EAChC,wBAAA,QAAgC,MAAA;EAChC,gBAAA;EACA,kBAAA,QAA0B,YAAA;EAC1B,wBAAA,GAA2B,MAAA,EAAQ,sBAAA;EACnC,sBAAA,GACE,MAAA,EAAQ,oBAAA,EACR,oBAAA,GAAuB,oBAAA;EAEzB,0BAAA,GAA6B,GAAA;EAC7B,8BAAA,GAAiC,GAAA;EACjC,6BAAA,GAAgC,QAAA;EAChC,2BAAA,GAA8B,QAAA;EAC9B,iBAAA,GAAoB,cAAA,EAAgB,cAAA;EACpC,wBAAA,GAA2B,QAAA;EAfe;EAiB1C,sBAAA;EAhBgC;EAkBhC,SAAA;AAAA;AAAA,KAGU,gBAAA;AAAA,UAOK,GAAA;EACf,YAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,YAAA;EACA,KAAA;EACA,cAAA;AAAA;AAAA,UAGe,yBAAA;EACf,IAAA,GAAO,UAAA;EACP,IAAA,EAAM,kBAAA;EACN,OAAA,EAAS,iBAAA;EACT,UAAA,EAAY,iBAAA;EACZ,MAAA,GAAS,iBAAA;EACT,aAAA,EAAe,uBAAA;EACf,YAAA,EAAc,oBAAA;EACd,MAAA,GAAS,WAAA;EACT,kBAAA;EACA,cAAA;EACA,QAAA;EACA,qBAAA,GAAwB,IAAA,CAAK,WAAA;AAAA"}

package/dist/managers/MXLUserSessionManager/utils/activity.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/managers/MXLUserSessionManager/utils/activity.ts
+const isTabEngaged = (visibilityDoc) => visibilityDoc.visibilityState === "visible" && visibilityDoc.hasFocus();
+const addActivityListeners = ({ target, visibilityDoc, activityEvents, onActivity, onVisibilityChange, onFocus, onBlur, onPageShow, onPageHide }) => {
+	for (const event of activityEvents) target.addEventListener(event, onActivity);
+	visibilityDoc.addEventListener?.("visibilitychange", onVisibilityChange);
+	target.addEventListener("focus", onFocus);
+	target.addEventListener("blur", onBlur);
+	target.addEventListener("pageshow", onPageShow);
+	target.addEventListener("pagehide", onPageHide);
+};
+const removeActivityListeners = ({ target, visibilityDoc, activityEvents, onActivity, onVisibilityChange, onFocus, onBlur, onPageShow, onPageHide }) => {
+	for (const event of activityEvents) target.removeEventListener(event, onActivity);
+	visibilityDoc.removeEventListener?.("visibilitychange", onVisibilityChange);
+	target.removeEventListener("focus", onFocus);
+	target.removeEventListener("blur", onBlur);
+	target.removeEventListener("pageshow", onPageShow);
+	target.removeEventListener("pagehide", onPageHide);
+};
+//#endregion
+exports.addActivityListeners = addActivityListeners;
+exports.isTabEngaged = isTabEngaged;
+exports.removeActivityListeners = removeActivityListeners;
+
+//# sourceMappingURL=activity.cjs.map

package/dist/managers/MXLUserSessionManager/utils/activity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.cjs","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/activity.ts"],"sourcesContent":["import type { VisibilityStateDocument } from '../../../common/types';\n\nexport const isTabEngaged = (visibilityDoc: VisibilityStateDocument): boolean =>\n  visibilityDoc.visibilityState === 'visible' && visibilityDoc.hasFocus();\n\nexport interface ActivityListenersArgs {\n  target: EventTarget;\n  visibilityDoc: VisibilityStateDocument;\n  activityEvents: readonly string[];\n  onActivity: (event: Event) => void;\n  onVisibilityChange: (event: Event) => void;\n  onFocus: (event: Event) => void;\n  onBlur: (event: Event) => void;\n  onPageShow: (event: PageTransitionEvent) => void;\n  onPageHide: (event: PageTransitionEvent) => void;\n}\n\nexport const addActivityListeners = ({\n  target,\n  visibilityDoc,\n  activityEvents,\n  onActivity,\n  onVisibilityChange,\n  onFocus,\n  onBlur,\n  onPageShow,\n  onPageHide,\n}: ActivityListenersArgs): void => {\n  for (const event of activityEvents) {\n    target.addEventListener(event, onActivity);\n  }\n  // Tab visibility flips (switch tabs, minimize, OS app switch).\n  visibilityDoc.addEventListener?.('visibilitychange', onVisibilityChange);\n  // Window focus changes (alt-tab, click into DevTools, multi-monitor).\n  target.addEventListener('focus', onFocus);\n  target.addEventListener('blur', onBlur);\n  // Initial page load AND BFCache restore. Distinguished by event.persisted.\n  target.addEventListener('pageshow', onPageShow as EventListener);\n  // Navigation away AND BFCache freeze. Distinguished by event.persisted.\n  target.addEventListener('pagehide', onPageHide as EventListener);\n};\n\nexport const removeActivityListeners = ({\n  target,\n  visibilityDoc,\n  activityEvents,\n  onActivity,\n  onVisibilityChange,\n  onFocus,\n  onBlur,\n  onPageShow,\n  onPageHide,\n}: ActivityListenersArgs): void => {\n  for (const event of activityEvents) {\n    target.removeEventListener(event, onActivity);\n  }\n  visibilityDoc.removeEventListener?.('visibilitychange', onVisibilityChange);\n  target.removeEventListener('focus', onFocus);\n  target.removeEventListener('blur', onBlur);\n  target.removeEventListener('pageshow', onPageShow as EventListener);\n  target.removeEventListener('pagehide', onPageHide as EventListener);\n};\n"],"mappings":";;AAEA,MAAa,gBAAgB,kBAC3B,cAAc,oBAAoB,aAAa,cAAc,UAAU;AAczE,MAAa,wBAAwB,EACnC,QACA,eACA,gBACA,YACA,oBACA,SACA,QACA,YACA,iBACiC;AACjC,MAAK,MAAM,SAAS,eAClB,QAAO,iBAAiB,OAAO,WAAW;AAG5C,eAAc,mBAAmB,oBAAoB,mBAAmB;AAExE,QAAO,iBAAiB,SAAS,QAAQ;AACzC,QAAO,iBAAiB,QAAQ,OAAO;AAEvC,QAAO,iBAAiB,YAAY,WAA4B;AAEhE,QAAO,iBAAiB,YAAY,WAA4B;;AAGlE,MAAa,2BAA2B,EACtC,QACA,eACA,gBACA,YACA,oBACA,SACA,QACA,YACA,iBACiC;AACjC,MAAK,MAAM,SAAS,eAClB,QAAO,oBAAoB,OAAO,WAAW;AAE/C,eAAc,sBAAsB,oBAAoB,mBAAmB;AAC3E,QAAO,oBAAoB,SAAS,QAAQ;AAC5C,QAAO,oBAAoB,QAAQ,OAAO;AAC1C,QAAO,oBAAoB,YAAY,WAA4B;AACnE,QAAO,oBAAoB,YAAY,WAA4B"}

package/dist/managers/MXLUserSessionManager/utils/activity.d.cts

@@ -0,0 +1,40 @@
+import { VisibilityStateDocument } from "../../../common/types.cjs";
+
+//#region src/managers/MXLUserSessionManager/utils/activity.d.ts
+declare const isTabEngaged: (visibilityDoc: VisibilityStateDocument) => boolean;
+interface ActivityListenersArgs {
+  target: EventTarget;
+  visibilityDoc: VisibilityStateDocument;
+  activityEvents: readonly string[];
+  onActivity: (event: Event) => void;
+  onVisibilityChange: (event: Event) => void;
+  onFocus: (event: Event) => void;
+  onBlur: (event: Event) => void;
+  onPageShow: (event: PageTransitionEvent) => void;
+  onPageHide: (event: PageTransitionEvent) => void;
+}
+declare const addActivityListeners: ({
+  target,
+  visibilityDoc,
+  activityEvents,
+  onActivity,
+  onVisibilityChange,
+  onFocus,
+  onBlur,
+  onPageShow,
+  onPageHide
+}: ActivityListenersArgs) => void;
+declare const removeActivityListeners: ({
+  target,
+  visibilityDoc,
+  activityEvents,
+  onActivity,
+  onVisibilityChange,
+  onFocus,
+  onBlur,
+  onPageShow,
+  onPageHide
+}: ActivityListenersArgs) => void;
+//#endregion
+export { ActivityListenersArgs, addActivityListeners, isTabEngaged, removeActivityListeners };
+//# sourceMappingURL=activity.d.cts.map

package/dist/managers/MXLUserSessionManager/utils/activity.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.cts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/activity.ts"],"mappings":";;;cAEa,YAAA,GAAgB,aAAA,EAAe,uBAAA;AAAA,UAG3B,qBAAA;EACf,MAAA,EAAQ,WAAA;EACR,aAAA,EAAe,uBAAA;EACf,cAAA;EACA,UAAA,GAAa,KAAA,EAAO,KAAA;EACpB,kBAAA,GAAqB,KAAA,EAAO,KAAA;EAC5B,OAAA,GAAU,KAAA,EAAO,KAAA;EACjB,MAAA,GAAS,KAAA,EAAO,KAAA;EAChB,UAAA,GAAa,KAAA,EAAO,mBAAA;EACpB,UAAA,GAAa,KAAA,EAAO,mBAAA;AAAA;AAAA,cAGT,oBAAA;EAAwB,MAAA;EAAA,aAAA;EAAA,cAAA;EAAA,UAAA;EAAA,kBAAA;EAAA,OAAA;EAAA,MAAA;EAAA,UAAA;EAAA;AAAA,GAUlC,qBAAA;AAAA,cAeU,uBAAA;EAA2B,MAAA;EAAA,aAAA;EAAA,cAAA;EAAA,UAAA;EAAA,kBAAA;EAAA,OAAA;EAAA,MAAA;EAAA,UAAA;EAAA;AAAA,GAUrC,qBAAA"}

package/dist/managers/MXLUserSessionManager/utils/activity.d.ts

@@ -0,0 +1,40 @@
+import { VisibilityStateDocument } from "../../../common/types.js";
+
+//#region src/managers/MXLUserSessionManager/utils/activity.d.ts
+declare const isTabEngaged: (visibilityDoc: VisibilityStateDocument) => boolean;
+interface ActivityListenersArgs {
+  target: EventTarget;
+  visibilityDoc: VisibilityStateDocument;
+  activityEvents: readonly string[];
+  onActivity: (event: Event) => void;
+  onVisibilityChange: (event: Event) => void;
+  onFocus: (event: Event) => void;
+  onBlur: (event: Event) => void;
+  onPageShow: (event: PageTransitionEvent) => void;
+  onPageHide: (event: PageTransitionEvent) => void;
+}
+declare const addActivityListeners: ({
+  target,
+  visibilityDoc,
+  activityEvents,
+  onActivity,
+  onVisibilityChange,
+  onFocus,
+  onBlur,
+  onPageShow,
+  onPageHide
+}: ActivityListenersArgs) => void;
+declare const removeActivityListeners: ({
+  target,
+  visibilityDoc,
+  activityEvents,
+  onActivity,
+  onVisibilityChange,
+  onFocus,
+  onBlur,
+  onPageShow,
+  onPageHide
+}: ActivityListenersArgs) => void;
+//#endregion
+export { ActivityListenersArgs, addActivityListeners, isTabEngaged, removeActivityListeners };
+//# sourceMappingURL=activity.d.ts.map

package/dist/managers/MXLUserSessionManager/utils/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/activity.ts"],"mappings":";;;cAEa,YAAA,GAAgB,aAAA,EAAe,uBAAA;AAAA,UAG3B,qBAAA;EACf,MAAA,EAAQ,WAAA;EACR,aAAA,EAAe,uBAAA;EACf,cAAA;EACA,UAAA,GAAa,KAAA,EAAO,KAAA;EACpB,kBAAA,GAAqB,KAAA,EAAO,KAAA;EAC5B,OAAA,GAAU,KAAA,EAAO,KAAA;EACjB,MAAA,GAAS,KAAA,EAAO,KAAA;EAChB,UAAA,GAAa,KAAA,EAAO,mBAAA;EACpB,UAAA,GAAa,KAAA,EAAO,mBAAA;AAAA;AAAA,cAGT,oBAAA;EAAwB,MAAA;EAAA,aAAA;EAAA,cAAA;EAAA,UAAA;EAAA,kBAAA;EAAA,OAAA;EAAA,MAAA;EAAA,UAAA;EAAA;AAAA,GAUlC,qBAAA;AAAA,cAeU,uBAAA;EAA2B,MAAA;EAAA,aAAA;EAAA,cAAA;EAAA,UAAA;EAAA,kBAAA;EAAA,OAAA;EAAA,MAAA;EAAA,UAAA;EAAA;AAAA,GAUrC,qBAAA"}

package/dist/managers/MXLUserSessionManager/utils/activity.js

@@ -0,0 +1,22 @@
+//#region src/managers/MXLUserSessionManager/utils/activity.ts
+const isTabEngaged = (visibilityDoc) => visibilityDoc.visibilityState === "visible" && visibilityDoc.hasFocus();
+const addActivityListeners = ({ target, visibilityDoc, activityEvents, onActivity, onVisibilityChange, onFocus, onBlur, onPageShow, onPageHide }) => {
+	for (const event of activityEvents) target.addEventListener(event, onActivity);
+	visibilityDoc.addEventListener?.("visibilitychange", onVisibilityChange);
+	target.addEventListener("focus", onFocus);
+	target.addEventListener("blur", onBlur);
+	target.addEventListener("pageshow", onPageShow);
+	target.addEventListener("pagehide", onPageHide);
+};
+const removeActivityListeners = ({ target, visibilityDoc, activityEvents, onActivity, onVisibilityChange, onFocus, onBlur, onPageShow, onPageHide }) => {
+	for (const event of activityEvents) target.removeEventListener(event, onActivity);
+	visibilityDoc.removeEventListener?.("visibilitychange", onVisibilityChange);
+	target.removeEventListener("focus", onFocus);
+	target.removeEventListener("blur", onBlur);
+	target.removeEventListener("pageshow", onPageShow);
+	target.removeEventListener("pagehide", onPageHide);
+};
+//#endregion
+export { addActivityListeners, isTabEngaged, removeActivityListeners };
+
+//# sourceMappingURL=activity.js.map

package/dist/managers/MXLUserSessionManager/utils/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/activity.ts"],"sourcesContent":["import type { VisibilityStateDocument } from '../../../common/types';\n\nexport const isTabEngaged = (visibilityDoc: VisibilityStateDocument): boolean =>\n  visibilityDoc.visibilityState === 'visible' && visibilityDoc.hasFocus();\n\nexport interface ActivityListenersArgs {\n  target: EventTarget;\n  visibilityDoc: VisibilityStateDocument;\n  activityEvents: readonly string[];\n  onActivity: (event: Event) => void;\n  onVisibilityChange: (event: Event) => void;\n  onFocus: (event: Event) => void;\n  onBlur: (event: Event) => void;\n  onPageShow: (event: PageTransitionEvent) => void;\n  onPageHide: (event: PageTransitionEvent) => void;\n}\n\nexport const addActivityListeners = ({\n  target,\n  visibilityDoc,\n  activityEvents,\n  onActivity,\n  onVisibilityChange,\n  onFocus,\n  onBlur,\n  onPageShow,\n  onPageHide,\n}: ActivityListenersArgs): void => {\n  for (const event of activityEvents) {\n    target.addEventListener(event, onActivity);\n  }\n  // Tab visibility flips (switch tabs, minimize, OS app switch).\n  visibilityDoc.addEventListener?.('visibilitychange', onVisibilityChange);\n  // Window focus changes (alt-tab, click into DevTools, multi-monitor).\n  target.addEventListener('focus', onFocus);\n  target.addEventListener('blur', onBlur);\n  // Initial page load AND BFCache restore. Distinguished by event.persisted.\n  target.addEventListener('pageshow', onPageShow as EventListener);\n  // Navigation away AND BFCache freeze. Distinguished by event.persisted.\n  target.addEventListener('pagehide', onPageHide as EventListener);\n};\n\nexport const removeActivityListeners = ({\n  target,\n  visibilityDoc,\n  activityEvents,\n  onActivity,\n  onVisibilityChange,\n  onFocus,\n  onBlur,\n  onPageShow,\n  onPageHide,\n}: ActivityListenersArgs): void => {\n  for (const event of activityEvents) {\n    target.removeEventListener(event, onActivity);\n  }\n  visibilityDoc.removeEventListener?.('visibilitychange', onVisibilityChange);\n  target.removeEventListener('focus', onFocus);\n  target.removeEventListener('blur', onBlur);\n  target.removeEventListener('pageshow', onPageShow as EventListener);\n  target.removeEventListener('pagehide', onPageHide as EventListener);\n};\n"],"mappings":";AAEA,MAAa,gBAAgB,kBAC3B,cAAc,oBAAoB,aAAa,cAAc,UAAU;AAczE,MAAa,wBAAwB,EACnC,QACA,eACA,gBACA,YACA,oBACA,SACA,QACA,YACA,iBACiC;AACjC,MAAK,MAAM,SAAS,eAClB,QAAO,iBAAiB,OAAO,WAAW;AAG5C,eAAc,mBAAmB,oBAAoB,mBAAmB;AAExE,QAAO,iBAAiB,SAAS,QAAQ;AACzC,QAAO,iBAAiB,QAAQ,OAAO;AAEvC,QAAO,iBAAiB,YAAY,WAA4B;AAEhE,QAAO,iBAAiB,YAAY,WAA4B;;AAGlE,MAAa,2BAA2B,EACtC,QACA,eACA,gBACA,YACA,oBACA,SACA,QACA,YACA,iBACiC;AACjC,MAAK,MAAM,SAAS,eAClB,QAAO,oBAAoB,OAAO,WAAW;AAE/C,eAAc,sBAAsB,oBAAoB,mBAAmB;AAC3E,QAAO,oBAAoB,SAAS,QAAQ;AAC5C,QAAO,oBAAoB,QAAQ,OAAO;AAC1C,QAAO,oBAAoB,YAAY,WAA4B;AACnE,QAAO,oBAAoB,YAAY,WAA4B"}

package/dist/managers/MXLUserSessionManager/utils/state.cjs

@@ -0,0 +1,78 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_managers_MXLUserSessionManager_constants = require("../constants.cjs");
+const require_utils_generateUUID = require("../../../utils/generateUUID.cjs");
+//#region src/managers/MXLUserSessionManager/utils/state.ts
+/**
+* True when the stored state is no longer trustworthy: the device clock
+* jumped backwards past the recorded start, the max-duration deadline has
+* passed, or an inactivity deadline (set when the last part ended) has
+* passed. Inactivity only applies between parts; the deadline is null
+* while a part is active.
+*/
+const isUserSessionExpired = (state, now) => now < state.userSessionStartTs || now >= state.userSessionMaxEndTs || state.inactivityDeadlineTs !== null && now >= state.inactivityDeadlineTs;
+const createUserSessionState = ({ now, previousUserSessionId, maxUserSessionDurationSeconds, inactivityTimeoutSeconds, userSessionNumber }) => ({
+	inactivityDeadlineTs: null,
+	inactivityTimeoutSeconds,
+	maxUserSessionDurationSeconds,
+	previousUserSessionId,
+	schemaVersion: 1,
+	userSessionId: require_utils_generateUUID.generateUUID(),
+	userSessionMaxEndTs: now + maxUserSessionDurationSeconds * 1e3,
+	userSessionNumber,
+	userSessionPartIndex: 0,
+	userSessionProperties: {},
+	userSessionStartTs: now
+});
+/**
+* Treats the schemaVersion stamp as the contract. Every field is written
+* by createUserSessionState (and userSessionProperties is validated at
+* addProperty time), so a matching version means the blob came from this
+* code path and we trust the rest of its shape.
+*/
+const isValidStoredUserSessionState = (state) => state !== null && typeof state === "object" && state.schemaVersion === 1;
+const readUserSessionState = (storage, diag) => {
+	const raw = storage.getItem(require_managers_MXLUserSessionManager_constants.MXL_USER_SESSION_STATE_KEY);
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		if (!isValidStoredUserSessionState(parsed)) throw new Error("stored user session state failed structural validation");
+		return parsed;
+	} catch (error) {
+		diag.error("User session state in storage is corrupt; discarding it", error);
+		storage.removeItem(require_managers_MXLUserSessionManager_constants.MXL_USER_SESSION_STATE_KEY);
+		return null;
+	}
+};
+const readPermanentProperties = (storage, diag) => {
+	const raw = storage.getItem(require_managers_MXLUserSessionManager_constants.MXL_PERMANENT_PROPERTIES_KEY);
+	if (!raw) return {};
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("permanent properties blob is not a plain object");
+		const validated = {};
+		for (const [key, value] of Object.entries(parsed)) if (typeof value === "string") validated[key] = value;
+		return validated;
+	} catch (error) {
+		diag.error("Permanent properties in storage are corrupt; discarding", error);
+		storage.removeItem(require_managers_MXLUserSessionManager_constants.MXL_PERMANENT_PROPERTIES_KEY);
+		return {};
+	}
+};
+/**
+* Empty blobs are removed rather than written so storage stays tidy when
+* the last property is cleared. Returns false on a failed write; callers
+* gate cross-scope flips on this so a failed permanent write doesn't
+* strip the previously-visible user-session-scoped value.
+*/
+const storePermanentProperties = (storage, properties) => {
+	if (Object.keys(properties).length === 0) return storage.removeItem(require_managers_MXLUserSessionManager_constants.MXL_PERMANENT_PROPERTIES_KEY);
+	return storage.setItem(require_managers_MXLUserSessionManager_constants.MXL_PERMANENT_PROPERTIES_KEY, JSON.stringify(properties));
+};
+//#endregion
+exports.createUserSessionState = createUserSessionState;
+exports.isUserSessionExpired = isUserSessionExpired;
+exports.readPermanentProperties = readPermanentProperties;
+exports.readUserSessionState = readUserSessionState;
+exports.storePermanentProperties = storePermanentProperties;
+
+//# sourceMappingURL=state.cjs.map

package/dist/managers/MXLUserSessionManager/utils/state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.cjs","names":["generateUUID","MXL_USER_SESSION_STATE_KEY","MXL_PERMANENT_PROPERTIES_KEY"],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\nimport { generateUUID } from '../../../utils/generateUUID';\nimport {\n  MXL_PERMANENT_PROPERTIES_KEY,\n  MXL_USER_SESSION_STATE_KEY,\n  USER_SESSION_STATE_SCHEMA_VERSION,\n} from '../constants';\nimport type { UserSessionState } from '../types';\n\n/**\n * True when the stored state is no longer trustworthy: the device clock\n * jumped backwards past the recorded start, the max-duration deadline has\n * passed, or an inactivity deadline (set when the last part ended) has\n * passed. Inactivity only applies between parts; the deadline is null\n * while a part is active.\n */\nexport const isUserSessionExpired = (\n  state: UserSessionState,\n  now: number,\n): boolean =>\n  now < state.userSessionStartTs ||\n  now >= state.userSessionMaxEndTs ||\n  (state.inactivityDeadlineTs !== null && now >= state.inactivityDeadlineTs);\n\nexport interface CreateUserSessionStateArgs {\n  now: number;\n  previousUserSessionId: string | null;\n  maxUserSessionDurationSeconds: number;\n  inactivityTimeoutSeconds: number;\n  userSessionNumber: number;\n}\n\nexport const createUserSessionState = ({\n  now,\n  previousUserSessionId,\n  maxUserSessionDurationSeconds,\n  inactivityTimeoutSeconds,\n  userSessionNumber,\n}: CreateUserSessionStateArgs): UserSessionState => ({\n  inactivityDeadlineTs: null,\n  inactivityTimeoutSeconds,\n  maxUserSessionDurationSeconds,\n  previousUserSessionId,\n  schemaVersion: USER_SESSION_STATE_SCHEMA_VERSION,\n  userSessionId: generateUUID(),\n  userSessionMaxEndTs: now + maxUserSessionDurationSeconds * 1000,\n  userSessionNumber,\n  userSessionPartIndex: 0,\n  userSessionProperties: {},\n  userSessionStartTs: now,\n});\n\n/**\n * Treats the schemaVersion stamp as the contract. Every field is written\n * by createUserSessionState (and userSessionProperties is validated at\n * addProperty time), so a matching version means the blob came from this\n * code path and we trust the rest of its shape.\n */\nconst isValidStoredUserSessionState = (\n  state: unknown,\n): state is UserSessionState =>\n  state !== null &&\n  typeof state === 'object' &&\n  (state as { schemaVersion?: unknown }).schemaVersion ===\n    USER_SESSION_STATE_SCHEMA_VERSION;\n\nexport const readUserSessionState = (\n  storage: NamespacedStorage,\n  diag: DiagLogger,\n): UserSessionState | null => {\n  const raw = storage.getItem(MXL_USER_SESSION_STATE_KEY);\n  if (!raw) {\n    return null;\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (!isValidStoredUserSessionState(parsed)) {\n      throw new Error('stored user session state failed structural validation');\n    }\n    return parsed;\n  } catch (error) {\n    diag.error(\n      'User session state in storage is corrupt; discarding it',\n      error,\n    );\n    storage.removeItem(MXL_USER_SESSION_STATE_KEY);\n    return null;\n  }\n};\n\nexport const readPermanentProperties = (\n  storage: NamespacedStorage,\n  diag: DiagLogger,\n): Record<string, string> => {\n  const raw = storage.getItem(MXL_PERMANENT_PROPERTIES_KEY);\n  if (!raw) {\n    return {};\n  }\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    if (\n      parsed === null ||\n      typeof parsed !== 'object' ||\n      Array.isArray(parsed)\n    ) {\n      throw new Error('permanent properties blob is not a plain object');\n    }\n    const validated: Record<string, string> = {};\n    for (const [key, value] of Object.entries(parsed)) {\n      if (typeof value === 'string') {\n        validated[key] = value;\n      }\n    }\n    return validated;\n  } catch (error) {\n    diag.error(\n      'Permanent properties in storage are corrupt; discarding',\n      error,\n    );\n    storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n    return {};\n  }\n};\n\n/**\n * Empty blobs are removed rather than written so storage stays tidy when\n * the last property is cleared. Returns false on a failed write; callers\n * gate cross-scope flips on this so a failed permanent write doesn't\n * strip the previously-visible user-session-scoped value.\n */\nexport const storePermanentProperties = (\n  storage: NamespacedStorage,\n  properties: Record<string, string>,\n): boolean => {\n  if (Object.keys(properties).length === 0) {\n    return storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n  }\n  return storage.setItem(\n    MXL_PERMANENT_PROPERTIES_KEY,\n    JSON.stringify(properties),\n  );\n};\n"],"mappings":";;;;;;;;;;;AAiBA,MAAa,wBACX,OACA,QAEA,MAAM,MAAM,sBACZ,OAAO,MAAM,uBACZ,MAAM,yBAAyB,QAAQ,OAAO,MAAM;AAUvD,MAAa,0BAA0B,EACrC,KACA,uBACA,+BACA,0BACA,yBACmD;CACnD,sBAAsB;CACtB;CACA;CACA;CACA,eAAA;CACA,eAAeA,2BAAAA,cAAc;CAC7B,qBAAqB,MAAM,gCAAgC;CAC3D;CACA,sBAAsB;CACtB,uBAAuB,EAAE;CACzB,oBAAoB;CACrB;;;;;;;AAQD,MAAM,iCACJ,UAEA,UAAU,QACV,OAAO,UAAU,YAChB,MAAsC,kBAAA;AAGzC,MAAa,wBACX,SACA,SAC4B;CAC5B,MAAM,MAAM,QAAQ,QAAQC,iDAAAA,2BAA2B;AACvD,KAAI,CAAC,IACH,QAAO;AAET,KAAI;EACF,MAAM,SAAkB,KAAK,MAAM,IAAI;AACvC,MAAI,CAAC,8BAA8B,OAAO,CACxC,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAWA,iDAAAA,2BAA2B;AAC9C,SAAO;;;AAIX,MAAa,2BACX,SACA,SAC2B;CAC3B,MAAM,MAAM,QAAQ,QAAQC,iDAAAA,6BAA6B;AACzD,KAAI,CAAC,IACH,QAAO,EAAE;AAEX,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MACE,WAAW,QACX,OAAO,WAAW,YAClB,MAAM,QAAQ,OAAO,CAErB,OAAM,IAAI,MAAM,kDAAkD;EAEpE,MAAM,YAAoC,EAAE;AAC5C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,OAAO,UAAU,SACnB,WAAU,OAAO;AAGrB,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAWA,iDAAAA,6BAA6B;AAChD,SAAO,EAAE;;;;;;;;;AAUb,MAAa,4BACX,SACA,eACY;AACZ,KAAI,OAAO,KAAK,WAAW,CAAC,WAAW,EACrC,QAAO,QAAQ,WAAWA,iDAAAA,6BAA6B;AAEzD,QAAO,QAAQ,QACbA,iDAAAA,8BACA,KAAK,UAAU,WAAW,CAC3B"}