@safaricom-mxl/web-sdk 0.0.15 → 0.0.17

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

@@ -0,0 +1,78 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_generateUUID = require("../../../utils/generateUUID.cjs");
+const require_managers_MXLUserSessionManager_constants = require("../constants.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/index';\nimport { generateUUID } from '../../../utils/index';\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"}

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

@@ -0,0 +1,39 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.cjs";
+import { UserSessionState } from "../types.cjs";
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/utils/state.d.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.
+ */
+declare const isUserSessionExpired: (state: UserSessionState, now: number) => boolean;
+interface CreateUserSessionStateArgs {
+  now: number;
+  previousUserSessionId: string | null;
+  maxUserSessionDurationSeconds: number;
+  inactivityTimeoutSeconds: number;
+  userSessionNumber: number;
+}
+declare const createUserSessionState: ({
+  now,
+  previousUserSessionId,
+  maxUserSessionDurationSeconds,
+  inactivityTimeoutSeconds,
+  userSessionNumber
+}: CreateUserSessionStateArgs) => UserSessionState;
+declare const readUserSessionState: (storage: NamespacedStorage, diag: DiagLogger) => UserSessionState | null;
+declare const readPermanentProperties: (storage: NamespacedStorage, diag: DiagLogger) => Record<string, string>;
+/**
+ * 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.
+ */
+declare const storePermanentProperties: (storage: NamespacedStorage, properties: Record<string, string>) => boolean;
+//#endregion
+export { CreateUserSessionStateArgs, createUserSessionState, isUserSessionExpired, readPermanentProperties, readUserSessionState, storePermanentProperties };
+//# sourceMappingURL=state.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.cts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"mappings":";;;;;;;;AAiBA;;;;cAAa,oBAAA,GACX,KAAA,EAAO,gBAAA,EACP,GAAA;AAAA,UAMe,0BAAA;EACf,GAAA;EACA,qBAAA;EACA,6BAAA;EACA,wBAAA;EACA,iBAAA;AAAA;AAAA,cAGW,sBAAA;EAA0B,GAAA;EAAA,qBAAA;EAAA,6BAAA;EAAA,wBAAA;EAAA;AAAA,GAMpC,0BAAA,KAA6B,gBAAA;AAAA,cA4BnB,oBAAA,GACX,OAAA,EAAS,iBAAA,EACT,IAAA,EAAM,UAAA,KACL,gBAAA;AAAA,cAqBU,uBAAA,GACX,OAAA,EAAS,iBAAA,EACT,IAAA,EAAM,UAAA,KACL,MAAA;;;;;;AA7DH;cAkGa,wBAAA,GACX,OAAA,EAAS,iBAAA,EACT,UAAA,EAAY,MAAA"}

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

@@ -0,0 +1,39 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.js";
+import { UserSessionState } from "../types.js";
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/utils/state.d.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.
+ */
+declare const isUserSessionExpired: (state: UserSessionState, now: number) => boolean;
+interface CreateUserSessionStateArgs {
+  now: number;
+  previousUserSessionId: string | null;
+  maxUserSessionDurationSeconds: number;
+  inactivityTimeoutSeconds: number;
+  userSessionNumber: number;
+}
+declare const createUserSessionState: ({
+  now,
+  previousUserSessionId,
+  maxUserSessionDurationSeconds,
+  inactivityTimeoutSeconds,
+  userSessionNumber
+}: CreateUserSessionStateArgs) => UserSessionState;
+declare const readUserSessionState: (storage: NamespacedStorage, diag: DiagLogger) => UserSessionState | null;
+declare const readPermanentProperties: (storage: NamespacedStorage, diag: DiagLogger) => Record<string, string>;
+/**
+ * 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.
+ */
+declare const storePermanentProperties: (storage: NamespacedStorage, properties: Record<string, string>) => boolean;
+//#endregion
+export { CreateUserSessionStateArgs, createUserSessionState, isUserSessionExpired, readPermanentProperties, readUserSessionState, storePermanentProperties };
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"mappings":";;;;;;;;AAiBA;;;;cAAa,oBAAA,GACX,KAAA,EAAO,gBAAA,EACP,GAAA;AAAA,UAMe,0BAAA;EACf,GAAA;EACA,qBAAA;EACA,6BAAA;EACA,wBAAA;EACA,iBAAA;AAAA;AAAA,cAGW,sBAAA;EAA0B,GAAA;EAAA,qBAAA;EAAA,6BAAA;EAAA,wBAAA;EAAA;AAAA,GAMpC,0BAAA,KAA6B,gBAAA;AAAA,cA4BnB,oBAAA,GACX,OAAA,EAAS,iBAAA,EACT,IAAA,EAAM,UAAA,KACL,gBAAA;AAAA,cAqBU,uBAAA,GACX,OAAA,EAAS,iBAAA,EACT,IAAA,EAAM,UAAA,KACL,MAAA;;;;;;AA7DH;cAkGa,wBAAA,GACX,OAAA,EAAS,iBAAA,EACT,UAAA,EAAY,MAAA"}

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

@@ -0,0 +1,73 @@
+import { generateUUID } from "../../../utils/generateUUID.js";
+import { MXL_PERMANENT_PROPERTIES_KEY, MXL_USER_SESSION_STATE_KEY } from "../constants.js";
+//#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: 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(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(MXL_USER_SESSION_STATE_KEY);
+		return null;
+	}
+};
+const readPermanentProperties = (storage, diag) => {
+	const raw = storage.getItem(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(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(MXL_PERMANENT_PROPERTIES_KEY);
+	return storage.setItem(MXL_PERMANENT_PROPERTIES_KEY, JSON.stringify(properties));
+};
+//#endregion
+export { createUserSessionState, isUserSessionExpired, readPermanentProperties, readUserSessionState, storePermanentProperties };
+
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { NamespacedStorage } from '../../../utils/index';\nimport { generateUUID } from '../../../utils/index';\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,eAAe,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,QAAQ,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,WAAW,2BAA2B;AAC9C,SAAO;;;AAIX,MAAa,2BACX,SACA,SAC2B;CAC3B,MAAM,MAAM,QAAQ,QAAQ,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,WAAW,6BAA6B;AAChD,SAAO,EAAE;;;;;;;;;AAUb,MAAa,4BACX,SACA,eACY;AACZ,KAAI,OAAO,KAAK,WAAW,CAAC,WAAW,EACrC,QAAO,QAAQ,WAAW,6BAA6B;AAEzD,QAAO,QAAQ,QACb,8BACA,KAAK,UAAU,WAAW,CAC3B"}

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

@@ -0,0 +1,132 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_generateUUID = require("../../../utils/generateUUID.cjs");
+const require_resources_appInstanceId = require("../../../resources/appInstanceId.cjs");
+const require_managers_MXLUserSessionManager_constants = require("../constants.cjs");
+//#region src/managers/MXLUserSessionManager/utils/tabTracking.ts
+const processReferrer = (referrer) => {
+	if (!referrer) return {
+		isSameOrigin: false,
+		isValid: false
+	};
+	try {
+		const referrerUrl = new URL(referrer);
+		const currentOrigin = window.location.origin;
+		return {
+			isSameOrigin: referrerUrl.origin === currentOrigin,
+			isValid: true,
+			scrubbedUrl: referrerUrl.origin + referrerUrl.pathname
+		};
+	} catch {
+		return {
+			isSameOrigin: false,
+			isValid: false
+		};
+	}
+};
+const determineNavigationSource = (referrerInfo, navigationPerformance, diag) => {
+	try {
+		const navEntries = navigationPerformance.getEntriesByType("navigation");
+		if (navEntries.length > 0 && navEntries[0]) {
+			const navEntry = navEntries[0];
+			if (navEntry.type === "reload") return "reload";
+			if (navEntry.type === "back_forward") return "back_forward";
+		}
+	} catch (error) {
+		diag.warn("Failed to get navigation type", error);
+	}
+	if (referrerInfo.isValid) return referrerInfo.isSameOrigin ? "same_origin" : "external";
+	return "direct";
+};
+const getTabActivity = (storage, diag) => {
+	try {
+		const stored = storage.getItem(require_managers_MXLUserSessionManager_constants.MXL_TAB_ACTIVITY_STORAGE_KEY);
+		if (!stored) return null;
+		return JSON.parse(stored);
+	} catch (error) {
+		diag.warn("Failed to retrieve tab activity", error);
+		return null;
+	}
+};
+const getTabContext = (navigationSource, sessionStorage, localStorage, diag) => {
+	const tabId = require_resources_appInstanceId.getAppInstanceId(sessionStorage, diag);
+	let sourceTabId;
+	let experienceId;
+	if (navigationSource === "same_origin") {
+		const lastActivity = getTabActivity(localStorage, diag);
+		if (lastActivity) {
+			if (Date.now() - lastActivity.lastActivityMs <= 1e4) {
+				sourceTabId = lastActivity.tabId;
+				({experienceId} = lastActivity);
+			}
+		}
+	}
+	experienceId ??= require_utils_generateUUID.generateUUID();
+	return {
+		navigationSource,
+		tab: {
+			experienceId,
+			sourceTabId,
+			tabId
+		}
+	};
+};
+const initTabContext = ({ sessionStorage, localStorage, referrer, navigationPerformance, diag }) => {
+	const referrerInfo = processReferrer(referrer);
+	const navigationSource = determineNavigationSource(referrerInfo, navigationPerformance, diag);
+	try {
+		const stored = sessionStorage.getItem(require_managers_MXLUserSessionManager_constants.MXL_TAB_STORAGE_KEY);
+		if (stored) return {
+			navigationSource,
+			referrerScrubbedUrl: referrerInfo.isValid && referrerInfo.scrubbedUrl ? referrerInfo.scrubbedUrl : void 0,
+			tab: JSON.parse(stored)
+		};
+	} catch (error) {
+		diag.warn("Failed to retrieve tab data", error);
+	}
+	const tabContext = getTabContext(navigationSource, sessionStorage, localStorage, diag);
+	try {
+		sessionStorage.setItem(require_managers_MXLUserSessionManager_constants.MXL_TAB_STORAGE_KEY, JSON.stringify(tabContext.tab));
+	} catch (error) {
+		diag.warn("Failed to store tab data", error);
+	}
+	return {
+		navigationSource: tabContext.navigationSource,
+		referrerScrubbedUrl: referrerInfo.isValid && referrerInfo.scrubbedUrl ? referrerInfo.scrubbedUrl : void 0,
+		tab: tabContext.tab
+	};
+};
+const storeCurrentTabAsSource = (storage, tab, diag) => {
+	const activity = {
+		experienceId: tab.experienceId,
+		lastActivityMs: Date.now(),
+		tabId: tab.tabId
+	};
+	try {
+		storage.setItem(require_managers_MXLUserSessionManager_constants.MXL_TAB_ACTIVITY_STORAGE_KEY, JSON.stringify(activity));
+	} catch (error) {
+		diag.warn("Failed to save tab activity", error);
+	}
+};
+const setupNewTabClickListeners = (tab, storage, diag) => {
+	const handleNewTabClick = (ev) => {
+		if (ev.button === 1 || ev.ctrlKey || ev.metaKey || ev.shiftKey) {
+			storeCurrentTabAsSource(storage, tab, diag);
+			return;
+		}
+		if (ev.target?.closest("a[target=\"_blank\"], form[target=\"_blank\"], a[rel*=\"noopener\"], a[rel*=\"noreferrer\"]")) storeCurrentTabAsSource(storage, tab, diag);
+	};
+	const options = {
+		capture: true,
+		passive: true
+	};
+	document.addEventListener("auxclick", handleNewTabClick, options);
+	document.addEventListener("click", handleNewTabClick, options);
+};
+//#endregion
+exports.determineNavigationSource = determineNavigationSource;
+exports.initTabContext = initTabContext;
+exports.processReferrer = processReferrer;
+exports.setupNewTabClickListeners = setupNewTabClickListeners;
+exports.storeCurrentTabAsSource = storeCurrentTabAsSource;
+
+//# sourceMappingURL=tabTracking.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabTracking.cjs","names":["MXL_TAB_ACTIVITY_STORAGE_KEY","getAppInstanceId","generateUUID","MXL_TAB_STORAGE_KEY"],"sources":["../../../../src/managers/MXLUserSessionManager/utils/tabTracking.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { getAppInstanceId } from '../../../resources';\nimport { generateUUID } from '../../../utils';\nimport {\n  MXL_TAB_ACTIVITY_STORAGE_KEY,\n  MXL_TAB_STORAGE_KEY,\n} from '../constants';\nimport type { NavigationSource, Tab, TabActivity } from '../types';\n\nexport interface TabContext {\n  tab: Tab;\n  navigationSource: NavigationSource;\n  referrerScrubbedUrl?: string;\n}\n\nexport const processReferrer = (\n  referrer: string,\n): {\n  isValid: boolean;\n  isSameOrigin: boolean;\n  scrubbedUrl?: string;\n} => {\n  if (!referrer) {\n    return { isSameOrigin: false, isValid: false };\n  }\n\n  try {\n    const referrerUrl = new URL(referrer);\n    const currentOrigin = window.location.origin;\n\n    return {\n      isSameOrigin: referrerUrl.origin === currentOrigin,\n      isValid: true,\n      scrubbedUrl: referrerUrl.origin + referrerUrl.pathname,\n    };\n  } catch {\n    return { isSameOrigin: false, isValid: false };\n  }\n};\n\nexport const determineNavigationSource = (\n  referrerInfo: ReturnType<typeof processReferrer>,\n  navigationPerformance: Pick<Performance, 'getEntriesByType'>,\n  diag: DiagLogger,\n): NavigationSource => {\n  try {\n    const navEntries = navigationPerformance.getEntriesByType('navigation');\n    if (navEntries.length > 0 && navEntries[0]) {\n      const navEntry = navEntries[0] as PerformanceNavigationTiming;\n      if (navEntry.type === 'reload') {\n        return 'reload';\n      }\n      if (navEntry.type === 'back_forward') {\n        return 'back_forward';\n      }\n    }\n  } catch (error) {\n    diag.warn('Failed to get navigation type', error);\n  }\n\n  if (referrerInfo.isValid) {\n    return referrerInfo.isSameOrigin ? 'same_origin' : 'external';\n  }\n\n  return 'direct';\n};\n\nconst getTabActivity = (\n  storage: Storage,\n  diag: DiagLogger,\n): TabActivity | null => {\n  try {\n    const stored = storage.getItem(MXL_TAB_ACTIVITY_STORAGE_KEY);\n    if (!stored) {\n      return null;\n    }\n    return JSON.parse(stored) as TabActivity;\n  } catch (error) {\n    diag.warn('Failed to retrieve tab activity', error);\n    return null;\n  }\n};\n\nconst getTabContext = (\n  navigationSource: NavigationSource,\n  sessionStorage: Storage,\n  localStorage: Storage,\n  diag: DiagLogger,\n): Omit<TabContext, 'navigationSource'> & {\n  navigationSource: NavigationSource;\n} => {\n  const tabId = getAppInstanceId(sessionStorage, diag);\n\n  let sourceTabId: string | undefined;\n  let experienceId: string | undefined;\n\n  if (navigationSource === 'same_origin') {\n    const lastActivity = getTabActivity(localStorage, diag);\n    if (lastActivity) {\n      const age = Date.now() - lastActivity.lastActivityMs;\n      if (age <= 10_000) {\n        sourceTabId = lastActivity.tabId;\n        ({ experienceId } = lastActivity);\n      }\n    }\n  }\n\n  experienceId ??= generateUUID();\n\n  return {\n    navigationSource,\n    tab: {\n      experienceId,\n      sourceTabId,\n      tabId,\n    },\n  };\n};\n\nexport const initTabContext = ({\n  sessionStorage,\n  localStorage,\n  referrer,\n  navigationPerformance,\n  diag,\n}: {\n  sessionStorage: Storage;\n  localStorage: Storage;\n  referrer: string;\n  navigationPerformance: Pick<Performance, 'getEntriesByType'>;\n  diag: DiagLogger;\n}): TabContext => {\n  const referrerInfo = processReferrer(referrer);\n  const navigationSource = determineNavigationSource(\n    referrerInfo,\n    navigationPerformance,\n    diag,\n  );\n\n  try {\n    const stored = sessionStorage.getItem(MXL_TAB_STORAGE_KEY);\n    if (stored) {\n      return {\n        navigationSource,\n        referrerScrubbedUrl:\n          referrerInfo.isValid && referrerInfo.scrubbedUrl\n            ? referrerInfo.scrubbedUrl\n            : undefined,\n        tab: JSON.parse(stored) as Tab,\n      };\n    }\n  } catch (error) {\n    diag.warn('Failed to retrieve tab data', error);\n  }\n\n  const tabContext = getTabContext(\n    navigationSource,\n    sessionStorage,\n    localStorage,\n    diag,\n  );\n\n  try {\n    sessionStorage.setItem(MXL_TAB_STORAGE_KEY, JSON.stringify(tabContext.tab));\n  } catch (error) {\n    diag.warn('Failed to store tab data', error);\n  }\n\n  return {\n    navigationSource: tabContext.navigationSource,\n    referrerScrubbedUrl:\n      referrerInfo.isValid && referrerInfo.scrubbedUrl\n        ? referrerInfo.scrubbedUrl\n        : undefined,\n    tab: tabContext.tab,\n  };\n};\n\nexport const storeCurrentTabAsSource = (\n  storage: Storage,\n  tab: Tab,\n  diag: DiagLogger,\n): void => {\n  const activity: TabActivity = {\n    experienceId: tab.experienceId,\n    lastActivityMs: Date.now(),\n    tabId: tab.tabId,\n  };\n\n  try {\n    storage.setItem(MXL_TAB_ACTIVITY_STORAGE_KEY, JSON.stringify(activity));\n  } catch (error) {\n    diag.warn('Failed to save tab activity', error);\n  }\n};\n\nexport const setupNewTabClickListeners = (\n  tab: Tab,\n  storage: Storage,\n  diag: DiagLogger,\n): void => {\n  const handleNewTabClick = (ev: MouseEvent) => {\n    if (ev.button === 1 || ev.ctrlKey || ev.metaKey || ev.shiftKey) {\n      storeCurrentTabAsSource(storage, tab, diag);\n      return;\n    }\n\n    const newTabAnchor = (ev.target as HTMLElement | null)?.closest(\n      'a[target=\"_blank\"], form[target=\"_blank\"], a[rel*=\"noopener\"], a[rel*=\"noreferrer\"]',\n    );\n    if (newTabAnchor) {\n      storeCurrentTabAsSource(storage, tab, diag);\n    }\n  };\n\n  const options = { capture: true, passive: true };\n  document.addEventListener('auxclick', handleNewTabClick, options);\n  document.addEventListener('click', handleNewTabClick, options);\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,33 @@
+import { NavigationSource, Tab } from "../types.cjs";
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/utils/tabTracking.d.ts
+interface TabContext {
+  tab: Tab;
+  navigationSource: NavigationSource;
+  referrerScrubbedUrl?: string;
+}
+declare const processReferrer: (referrer: string) => {
+  isValid: boolean;
+  isSameOrigin: boolean;
+  scrubbedUrl?: string;
+};
+declare const determineNavigationSource: (referrerInfo: ReturnType<typeof processReferrer>, navigationPerformance: Pick<Performance, "getEntriesByType">, diag: DiagLogger) => NavigationSource;
+declare const initTabContext: ({
+  sessionStorage,
+  localStorage,
+  referrer,
+  navigationPerformance,
+  diag
+}: {
+  sessionStorage: Storage;
+  localStorage: Storage;
+  referrer: string;
+  navigationPerformance: Pick<Performance, "getEntriesByType">;
+  diag: DiagLogger;
+}) => TabContext;
+declare const storeCurrentTabAsSource: (storage: Storage, tab: Tab, diag: DiagLogger) => void;
+declare const setupNewTabClickListeners: (tab: Tab, storage: Storage, diag: DiagLogger) => void;
+//#endregion
+export { TabContext, determineNavigationSource, initTabContext, processReferrer, setupNewTabClickListeners, storeCurrentTabAsSource };
+//# sourceMappingURL=tabTracking.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabTracking.d.cts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/tabTracking.ts"],"mappings":";;;;UASiB,UAAA;EACf,GAAA,EAAK,GAAA;EACL,gBAAA,EAAkB,gBAAA;EAClB,mBAAA;AAAA;AAAA,cAGW,eAAA,GACX,QAAA;EAEA,OAAA;EACA,YAAA;EACA,WAAA;AAAA;AAAA,cAoBW,yBAAA,GACX,YAAA,EAAc,UAAA,QAAkB,eAAA,GAChC,qBAAA,EAAuB,IAAA,CAAK,WAAA,uBAC5B,IAAA,EAAM,UAAA,KACL,gBAAA;AAAA,cA2EU,cAAA;EAAkB,cAAA;EAAA,YAAA;EAAA,QAAA;EAAA,qBAAA;EAAA;AAAA;EAO7B,cAAA,EAAgB,OAAA;EAChB,YAAA,EAAc,OAAA;EACd,QAAA;EACA,qBAAA,EAAuB,IAAA,CAAK,WAAA;EAC5B,IAAA,EAAM,UAAA;AAAA,MACJ,UAAA;AAAA,cA+CS,uBAAA,GACX,OAAA,EAAS,OAAA,EACT,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,UAAA;AAAA,cAeK,yBAAA,GACX,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,OAAA,EACT,IAAA,EAAM,UAAA"}

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

@@ -0,0 +1,33 @@
+import { NavigationSource, Tab } from "../types.js";
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserSessionManager/utils/tabTracking.d.ts
+interface TabContext {
+  tab: Tab;
+  navigationSource: NavigationSource;
+  referrerScrubbedUrl?: string;
+}
+declare const processReferrer: (referrer: string) => {
+  isValid: boolean;
+  isSameOrigin: boolean;
+  scrubbedUrl?: string;
+};
+declare const determineNavigationSource: (referrerInfo: ReturnType<typeof processReferrer>, navigationPerformance: Pick<Performance, "getEntriesByType">, diag: DiagLogger) => NavigationSource;
+declare const initTabContext: ({
+  sessionStorage,
+  localStorage,
+  referrer,
+  navigationPerformance,
+  diag
+}: {
+  sessionStorage: Storage;
+  localStorage: Storage;
+  referrer: string;
+  navigationPerformance: Pick<Performance, "getEntriesByType">;
+  diag: DiagLogger;
+}) => TabContext;
+declare const storeCurrentTabAsSource: (storage: Storage, tab: Tab, diag: DiagLogger) => void;
+declare const setupNewTabClickListeners: (tab: Tab, storage: Storage, diag: DiagLogger) => void;
+//#endregion
+export { TabContext, determineNavigationSource, initTabContext, processReferrer, setupNewTabClickListeners, storeCurrentTabAsSource };
+//# sourceMappingURL=tabTracking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabTracking.d.ts","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/tabTracking.ts"],"mappings":";;;;UASiB,UAAA;EACf,GAAA,EAAK,GAAA;EACL,gBAAA,EAAkB,gBAAA;EAClB,mBAAA;AAAA;AAAA,cAGW,eAAA,GACX,QAAA;EAEA,OAAA;EACA,YAAA;EACA,WAAA;AAAA;AAAA,cAoBW,yBAAA,GACX,YAAA,EAAc,UAAA,QAAkB,eAAA,GAChC,qBAAA,EAAuB,IAAA,CAAK,WAAA,uBAC5B,IAAA,EAAM,UAAA,KACL,gBAAA;AAAA,cA2EU,cAAA;EAAkB,cAAA;EAAA,YAAA;EAAA,QAAA;EAAA,qBAAA;EAAA;AAAA;EAO7B,cAAA,EAAgB,OAAA;EAChB,YAAA,EAAc,OAAA;EACd,QAAA;EACA,qBAAA,EAAuB,IAAA,CAAK,WAAA;EAC5B,IAAA,EAAM,UAAA;AAAA,MACJ,UAAA;AAAA,cA+CS,uBAAA,GACX,OAAA,EAAS,OAAA,EACT,GAAA,EAAK,GAAA,EACL,IAAA,EAAM,UAAA;AAAA,cAeK,yBAAA,GACX,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,OAAA,EACT,IAAA,EAAM,UAAA"}

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

@@ -0,0 +1,127 @@
+import { generateUUID } from "../../../utils/generateUUID.js";
+import { getAppInstanceId } from "../../../resources/appInstanceId.js";
+import { MXL_TAB_ACTIVITY_STORAGE_KEY, MXL_TAB_STORAGE_KEY } from "../constants.js";
+//#region src/managers/MXLUserSessionManager/utils/tabTracking.ts
+const processReferrer = (referrer) => {
+	if (!referrer) return {
+		isSameOrigin: false,
+		isValid: false
+	};
+	try {
+		const referrerUrl = new URL(referrer);
+		const currentOrigin = window.location.origin;
+		return {
+			isSameOrigin: referrerUrl.origin === currentOrigin,
+			isValid: true,
+			scrubbedUrl: referrerUrl.origin + referrerUrl.pathname
+		};
+	} catch {
+		return {
+			isSameOrigin: false,
+			isValid: false
+		};
+	}
+};
+const determineNavigationSource = (referrerInfo, navigationPerformance, diag) => {
+	try {
+		const navEntries = navigationPerformance.getEntriesByType("navigation");
+		if (navEntries.length > 0 && navEntries[0]) {
+			const navEntry = navEntries[0];
+			if (navEntry.type === "reload") return "reload";
+			if (navEntry.type === "back_forward") return "back_forward";
+		}
+	} catch (error) {
+		diag.warn("Failed to get navigation type", error);
+	}
+	if (referrerInfo.isValid) return referrerInfo.isSameOrigin ? "same_origin" : "external";
+	return "direct";
+};
+const getTabActivity = (storage, diag) => {
+	try {
+		const stored = storage.getItem(MXL_TAB_ACTIVITY_STORAGE_KEY);
+		if (!stored) return null;
+		return JSON.parse(stored);
+	} catch (error) {
+		diag.warn("Failed to retrieve tab activity", error);
+		return null;
+	}
+};
+const getTabContext = (navigationSource, sessionStorage, localStorage, diag) => {
+	const tabId = getAppInstanceId(sessionStorage, diag);
+	let sourceTabId;
+	let experienceId;
+	if (navigationSource === "same_origin") {
+		const lastActivity = getTabActivity(localStorage, diag);
+		if (lastActivity) {
+			if (Date.now() - lastActivity.lastActivityMs <= 1e4) {
+				sourceTabId = lastActivity.tabId;
+				({experienceId} = lastActivity);
+			}
+		}
+	}
+	experienceId ??= generateUUID();
+	return {
+		navigationSource,
+		tab: {
+			experienceId,
+			sourceTabId,
+			tabId
+		}
+	};
+};
+const initTabContext = ({ sessionStorage, localStorage, referrer, navigationPerformance, diag }) => {
+	const referrerInfo = processReferrer(referrer);
+	const navigationSource = determineNavigationSource(referrerInfo, navigationPerformance, diag);
+	try {
+		const stored = sessionStorage.getItem(MXL_TAB_STORAGE_KEY);
+		if (stored) return {
+			navigationSource,
+			referrerScrubbedUrl: referrerInfo.isValid && referrerInfo.scrubbedUrl ? referrerInfo.scrubbedUrl : void 0,
+			tab: JSON.parse(stored)
+		};
+	} catch (error) {
+		diag.warn("Failed to retrieve tab data", error);
+	}
+	const tabContext = getTabContext(navigationSource, sessionStorage, localStorage, diag);
+	try {
+		sessionStorage.setItem(MXL_TAB_STORAGE_KEY, JSON.stringify(tabContext.tab));
+	} catch (error) {
+		diag.warn("Failed to store tab data", error);
+	}
+	return {
+		navigationSource: tabContext.navigationSource,
+		referrerScrubbedUrl: referrerInfo.isValid && referrerInfo.scrubbedUrl ? referrerInfo.scrubbedUrl : void 0,
+		tab: tabContext.tab
+	};
+};
+const storeCurrentTabAsSource = (storage, tab, diag) => {
+	const activity = {
+		experienceId: tab.experienceId,
+		lastActivityMs: Date.now(),
+		tabId: tab.tabId
+	};
+	try {
+		storage.setItem(MXL_TAB_ACTIVITY_STORAGE_KEY, JSON.stringify(activity));
+	} catch (error) {
+		diag.warn("Failed to save tab activity", error);
+	}
+};
+const setupNewTabClickListeners = (tab, storage, diag) => {
+	const handleNewTabClick = (ev) => {
+		if (ev.button === 1 || ev.ctrlKey || ev.metaKey || ev.shiftKey) {
+			storeCurrentTabAsSource(storage, tab, diag);
+			return;
+		}
+		if (ev.target?.closest("a[target=\"_blank\"], form[target=\"_blank\"], a[rel*=\"noopener\"], a[rel*=\"noreferrer\"]")) storeCurrentTabAsSource(storage, tab, diag);
+	};
+	const options = {
+		capture: true,
+		passive: true
+	};
+	document.addEventListener("auxclick", handleNewTabClick, options);
+	document.addEventListener("click", handleNewTabClick, options);
+};
+//#endregion
+export { determineNavigationSource, initTabContext, processReferrer, setupNewTabClickListeners, storeCurrentTabAsSource };
+
+//# sourceMappingURL=tabTracking.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabTracking.js","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/tabTracking.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { getAppInstanceId } from '../../../resources';\nimport { generateUUID } from '../../../utils';\nimport {\n  MXL_TAB_ACTIVITY_STORAGE_KEY,\n  MXL_TAB_STORAGE_KEY,\n} from '../constants';\nimport type { NavigationSource, Tab, TabActivity } from '../types';\n\nexport interface TabContext {\n  tab: Tab;\n  navigationSource: NavigationSource;\n  referrerScrubbedUrl?: string;\n}\n\nexport const processReferrer = (\n  referrer: string,\n): {\n  isValid: boolean;\n  isSameOrigin: boolean;\n  scrubbedUrl?: string;\n} => {\n  if (!referrer) {\n    return { isSameOrigin: false, isValid: false };\n  }\n\n  try {\n    const referrerUrl = new URL(referrer);\n    const currentOrigin = window.location.origin;\n\n    return {\n      isSameOrigin: referrerUrl.origin === currentOrigin,\n      isValid: true,\n      scrubbedUrl: referrerUrl.origin + referrerUrl.pathname,\n    };\n  } catch {\n    return { isSameOrigin: false, isValid: false };\n  }\n};\n\nexport const determineNavigationSource = (\n  referrerInfo: ReturnType<typeof processReferrer>,\n  navigationPerformance: Pick<Performance, 'getEntriesByType'>,\n  diag: DiagLogger,\n): NavigationSource => {\n  try {\n    const navEntries = navigationPerformance.getEntriesByType('navigation');\n    if (navEntries.length > 0 && navEntries[0]) {\n      const navEntry = navEntries[0] as PerformanceNavigationTiming;\n      if (navEntry.type === 'reload') {\n        return 'reload';\n      }\n      if (navEntry.type === 'back_forward') {\n        return 'back_forward';\n      }\n    }\n  } catch (error) {\n    diag.warn('Failed to get navigation type', error);\n  }\n\n  if (referrerInfo.isValid) {\n    return referrerInfo.isSameOrigin ? 'same_origin' : 'external';\n  }\n\n  return 'direct';\n};\n\nconst getTabActivity = (\n  storage: Storage,\n  diag: DiagLogger,\n): TabActivity | null => {\n  try {\n    const stored = storage.getItem(MXL_TAB_ACTIVITY_STORAGE_KEY);\n    if (!stored) {\n      return null;\n    }\n    return JSON.parse(stored) as TabActivity;\n  } catch (error) {\n    diag.warn('Failed to retrieve tab activity', error);\n    return null;\n  }\n};\n\nconst getTabContext = (\n  navigationSource: NavigationSource,\n  sessionStorage: Storage,\n  localStorage: Storage,\n  diag: DiagLogger,\n): Omit<TabContext, 'navigationSource'> & {\n  navigationSource: NavigationSource;\n} => {\n  const tabId = getAppInstanceId(sessionStorage, diag);\n\n  let sourceTabId: string | undefined;\n  let experienceId: string | undefined;\n\n  if (navigationSource === 'same_origin') {\n    const lastActivity = getTabActivity(localStorage, diag);\n    if (lastActivity) {\n      const age = Date.now() - lastActivity.lastActivityMs;\n      if (age <= 10_000) {\n        sourceTabId = lastActivity.tabId;\n        ({ experienceId } = lastActivity);\n      }\n    }\n  }\n\n  experienceId ??= generateUUID();\n\n  return {\n    navigationSource,\n    tab: {\n      experienceId,\n      sourceTabId,\n      tabId,\n    },\n  };\n};\n\nexport const initTabContext = ({\n  sessionStorage,\n  localStorage,\n  referrer,\n  navigationPerformance,\n  diag,\n}: {\n  sessionStorage: Storage;\n  localStorage: Storage;\n  referrer: string;\n  navigationPerformance: Pick<Performance, 'getEntriesByType'>;\n  diag: DiagLogger;\n}): TabContext => {\n  const referrerInfo = processReferrer(referrer);\n  const navigationSource = determineNavigationSource(\n    referrerInfo,\n    navigationPerformance,\n    diag,\n  );\n\n  try {\n    const stored = sessionStorage.getItem(MXL_TAB_STORAGE_KEY);\n    if (stored) {\n      return {\n        navigationSource,\n        referrerScrubbedUrl:\n          referrerInfo.isValid && referrerInfo.scrubbedUrl\n            ? referrerInfo.scrubbedUrl\n            : undefined,\n        tab: JSON.parse(stored) as Tab,\n      };\n    }\n  } catch (error) {\n    diag.warn('Failed to retrieve tab data', error);\n  }\n\n  const tabContext = getTabContext(\n    navigationSource,\n    sessionStorage,\n    localStorage,\n    diag,\n  );\n\n  try {\n    sessionStorage.setItem(MXL_TAB_STORAGE_KEY, JSON.stringify(tabContext.tab));\n  } catch (error) {\n    diag.warn('Failed to store tab data', error);\n  }\n\n  return {\n    navigationSource: tabContext.navigationSource,\n    referrerScrubbedUrl:\n      referrerInfo.isValid && referrerInfo.scrubbedUrl\n        ? referrerInfo.scrubbedUrl\n        : undefined,\n    tab: tabContext.tab,\n  };\n};\n\nexport const storeCurrentTabAsSource = (\n  storage: Storage,\n  tab: Tab,\n  diag: DiagLogger,\n): void => {\n  const activity: TabActivity = {\n    experienceId: tab.experienceId,\n    lastActivityMs: Date.now(),\n    tabId: tab.tabId,\n  };\n\n  try {\n    storage.setItem(MXL_TAB_ACTIVITY_STORAGE_KEY, JSON.stringify(activity));\n  } catch (error) {\n    diag.warn('Failed to save tab activity', error);\n  }\n};\n\nexport const setupNewTabClickListeners = (\n  tab: Tab,\n  storage: Storage,\n  diag: DiagLogger,\n): void => {\n  const handleNewTabClick = (ev: MouseEvent) => {\n    if (ev.button === 1 || ev.ctrlKey || ev.metaKey || ev.shiftKey) {\n      storeCurrentTabAsSource(storage, tab, diag);\n      return;\n    }\n\n    const newTabAnchor = (ev.target as HTMLElement | null)?.closest(\n      'a[target=\"_blank\"], form[target=\"_blank\"], a[rel*=\"noopener\"], a[rel*=\"noreferrer\"]',\n    );\n    if (newTabAnchor) {\n      storeCurrentTabAsSource(storage, tab, diag);\n    }\n  };\n\n  const options = { capture: true, passive: true };\n  document.addEventListener('auxclick', handleNewTabClick, options);\n  document.addEventListener('click', handleNewTabClick, options);\n};\n"],"mappings":"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"}