@safaricom-mxl/web-sdk 0.0.20 → 0.0.22

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.cjs

@@ -0,0 +1,193 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_constants_attributes = require("../../constants/attributes.cjs");
+const require_managers_MXLUserManager_profileSnapshot = require("../MXLUserManager/profileSnapshot.cjs");
+const require_managers_MXLAnalyticsManager_sessionAnalyticsState = require("./sessionAnalyticsState.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
+let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+//#region src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts
+const SCREEN_VIEW_DEBOUNCE_MS = 50;
+var MXLAnalyticsManager = class {
+	_diag;
+	_logger;
+	_applicationId;
+	_userManager;
+	_userSessionManager;
+	_pageManager;
+	_storage;
+	_sessionAnalytics = new require_managers_MXLAnalyticsManager_sessionAnalyticsState.SessionAnalyticsState();
+	_lastScreenViewPath = null;
+	_screenViewTimer = null;
+	constructor({ applicationId, diag: diagParam, loggerProvider: globalLoggerProviderOverride, pageManager, storage = window.localStorage, userManager, userSessionManager }) {
+		const loggerProvider = globalLoggerProviderOverride ?? _opentelemetry_api_logs.logs;
+		this._diag = diagParam ?? _opentelemetry_api.diag.createComponentLogger({ namespace: "MXLAnalyticsManager" });
+		this._applicationId = applicationId;
+		this._userManager = userManager;
+		this._userSessionManager = userSessionManager;
+		this._pageManager = pageManager;
+		this._storage = storage;
+		this._logger = loggerProvider.getLogger("mxl-web-sdk-analytics");
+	}
+	getSessionAnalyticsState() {
+		return this._sessionAnalytics;
+	}
+	track(name, options = {}) {
+		if (typeof name !== "string" || !name.trim()) {
+			this._diag.warn("track name must be a non-empty string");
+			return;
+		}
+		this._sessionAnalytics.recordTrackEvent();
+		this._emitAnalyticsLog("track", name.trim(), options.properties);
+	}
+	identify(options) {
+		if (!options.profileId?.trim()) {
+			this._diag.warn("identify requires profileId");
+			return;
+		}
+		const merged = require_managers_MXLUserManager_profileSnapshot.mergeProfileSnapshot(require_managers_MXLUserManager_profileSnapshot.loadProfileSnapshot(this._storage), {
+			avatar: options.avatar ?? "",
+			email: options.email ?? "",
+			firstName: options.firstName ?? "",
+			lastName: options.lastName ?? "",
+			profileId: options.profileId.trim(),
+			properties: options.properties ?? {}
+		});
+		if (!require_managers_MXLUserManager_profileSnapshot.saveProfileSnapshot(this._storage, merged)) this._diag.warn("Failed to persist profile snapshot");
+		this._userManager.setUserId(merged.profileId);
+		const props = require_managers_MXLUserManager_profileSnapshot.snapshotToEventProperties(merged);
+		this._emitAnalyticsLog("identify", "identify", props, merged.profileId);
+	}
+	increment({ property, value = 1 }) {
+		const profileId = this._resolveProfileId();
+		if (!profileId) {
+			this._diag.warn("increment requires an identified profile");
+			return;
+		}
+		const existing = require_managers_MXLUserManager_profileSnapshot.loadProfileSnapshot(this._storage);
+		const current = Number.parseFloat(existing?.properties[property] ?? "0");
+		const next = Number.isFinite(current) ? current + value : value;
+		const merged = require_managers_MXLUserManager_profileSnapshot.mergeProfileSnapshot(existing, {
+			profileId,
+			properties: {
+				...existing?.properties ?? {},
+				[property]: String(next),
+				counter_name: property,
+				counter_value: String(next)
+			}
+		});
+		require_managers_MXLUserManager_profileSnapshot.saveProfileSnapshot(this._storage, merged);
+		this._emitAnalyticsLog("increment", property, {
+			counter_name: property,
+			counter_value: String(next)
+		}, profileId);
+	}
+	decrement({ property, value = 1 }) {
+		const profileId = this._resolveProfileId();
+		if (!profileId) {
+			this._diag.warn("decrement requires an identified profile");
+			return;
+		}
+		const existing = require_managers_MXLUserManager_profileSnapshot.loadProfileSnapshot(this._storage);
+		const current = Number.parseFloat(existing?.properties[property] ?? "0");
+		const next = Number.isFinite(current) ? current - Math.abs(value) : -Math.abs(value);
+		const merged = require_managers_MXLUserManager_profileSnapshot.mergeProfileSnapshot(existing, {
+			profileId,
+			properties: {
+				...existing?.properties ?? {},
+				[property]: String(next),
+				counter_name: property,
+				counter_value: String(next)
+			}
+		});
+		require_managers_MXLUserManager_profileSnapshot.saveProfileSnapshot(this._storage, merged);
+		this._emitAnalyticsLog("decrement", property, {
+			counter_name: property,
+			counter_value: String(next)
+		}, profileId);
+	}
+	clear() {
+		require_managers_MXLUserManager_profileSnapshot.clearProfileSnapshot(this._storage);
+		this._userManager.clearUserId();
+	}
+	screenView() {
+		if (this._screenViewTimer) clearTimeout(this._screenViewTimer);
+		this._screenViewTimer = setTimeout(() => {
+			this._screenViewTimer = null;
+			this._emitScreenView();
+		}, SCREEN_VIEW_DEBOUNCE_MS);
+	}
+	buildSessionPartAnalyticsAttributes() {
+		const previous = require_managers_MXLAnalyticsManager_sessionAnalyticsState.loadPreviousSessionSnapshot(this._storage);
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = this._resolveProfileId() ?? deviceId;
+		return this._sessionAnalytics.buildSpanAttributes(profileId, previous);
+	}
+	finalizeSessionPartAnalytics() {
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = this._resolveProfileId() ?? deviceId;
+		const snapshot = this._sessionAnalytics.toRowSnapshot(this._applicationId, profileId, deviceId);
+		require_managers_MXLAnalyticsManager_sessionAnalyticsState.savePreviousSessionSnapshot(this._storage, snapshot);
+	}
+	resetSessionAnalyticsForNewUserSession() {
+		this._sessionAnalytics.reset();
+		require_managers_MXLAnalyticsManager_sessionAnalyticsState.clearPreviousSessionSnapshot(this._storage);
+		this._lastScreenViewPath = null;
+	}
+	_emitScreenView() {
+		const route = this._pageManager.getCurrentRoute();
+		const url = route?.url ?? window.location.href;
+		const path = route?.path ?? window.location.pathname;
+		if (this._lastScreenViewPath === path) return;
+		this._lastScreenViewPath = path;
+		const pageContext = require_managers_MXLAnalyticsManager_sessionAnalyticsState.parsePageContextFromUrl(url);
+		this._sessionAnalytics.recordScreenView(pageContext);
+		this._emitAnalyticsLog("screen_view", "screen_view");
+	}
+	_emitAnalyticsLog(kind, name, properties = {}, profileIdOverride) {
+		const route = this._pageManager.getCurrentRoute();
+		const url = route?.url ?? window.location.href;
+		const path = route?.path ?? window.location.pathname;
+		const title = this._pageManager.getPageLabel() ?? document.title ?? "";
+		let origin = "";
+		try {
+			origin = new URL(url, window.location.origin).origin;
+		} catch {
+			origin = window.location.origin;
+		}
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = profileIdOverride ?? this._resolveProfileId() ?? deviceId;
+		const sessionId = this._userSessionManager.getUserSessionId() ?? "";
+		const attrs = {
+			[require_constants_attributes.KEY_MXL_ANALYTICS_KIND]: kind,
+			[require_constants_attributes.KEY_MXL_ANALYTICS_NAME]: name,
+			[require_constants_attributes.KEY_MXL_APPLICATION_ID]: this._applicationId,
+			[require_constants_attributes.KEY_MXL_DEVICE_ID]: deviceId,
+			[require_constants_attributes.KEY_MXL_PROFILE_ID]: profileId,
+			"mxl.session.id": sessionId,
+			[require_constants_attributes.KEY_MXL_PAGE_PATH]: path,
+			[require_constants_attributes.KEY_MXL_PAGE_URL]: url,
+			[require_constants_attributes.KEY_MXL_PAGE_ORIGIN]: origin,
+			[require_constants_attributes.KEY_MXL_PAGE_TITLE]: title,
+			[require_constants_attributes.KEY_MXL_PAGE_REFERRER]: document.referrer
+		};
+		for (const [key, value] of Object.entries(properties)) {
+			if (value === void 0 || value === null) continue;
+			attrs[`${require_constants_attributes.KEY_PREFIX_MXL_EVENT_PROPERTY}${key}`] = String(value);
+		}
+		this._logger.emit({
+			attributes: attrs,
+			body: name,
+			severityNumber: _opentelemetry_api_logs.SeverityNumber.INFO,
+			severityText: "INFO"
+		});
+	}
+	_resolveProfileId() {
+		const external = this._userManager.getUserId();
+		if (external) return external;
+		return require_managers_MXLUserManager_profileSnapshot.loadProfileSnapshot(this._storage)?.profileId || null;
+	}
+};
+//#endregion
+exports.MXLAnalyticsManager = MXLAnalyticsManager;
+
+//# sourceMappingURL=MXLAnalyticsManager.cjs.map

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLAnalyticsManager.cjs","names":["SessionAnalyticsState","logs","diag","mergeProfileSnapshot","loadProfileSnapshot","saveProfileSnapshot","snapshotToEventProperties","loadPreviousSessionSnapshot","parsePageContextFromUrl","KEY_MXL_ANALYTICS_KIND","KEY_MXL_ANALYTICS_NAME","KEY_MXL_APPLICATION_ID","KEY_MXL_DEVICE_ID","KEY_MXL_PROFILE_ID","KEY_MXL_PAGE_PATH","KEY_MXL_PAGE_URL","KEY_MXL_PAGE_ORIGIN","KEY_MXL_PAGE_TITLE","KEY_MXL_PAGE_REFERRER","KEY_PREFIX_MXL_EVENT_PROPERTY","SeverityNumber"],"sources":["../../../src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts"],"sourcesContent":["import type { Attributes, DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { Logger } from '@opentelemetry/api-logs';\nimport { SeverityNumber, logs } from '@opentelemetry/api-logs';\nimport type {\n  AnalyticsCounterOptions,\n  AnalyticsIdentifyOptions,\n  AnalyticsManagerInternal,\n  AnalyticsTrackOptions,\n} from '../../api-analytics/manager/types';\nimport {\n  KEY_MXL_ANALYTICS_KIND,\n  KEY_MXL_ANALYTICS_NAME,\n  KEY_MXL_APPLICATION_ID,\n  KEY_MXL_DEVICE_ID,\n  KEY_MXL_PAGE_ORIGIN,\n  KEY_MXL_PAGE_PATH,\n  KEY_MXL_PAGE_REFERRER,\n  KEY_MXL_PAGE_TITLE,\n  KEY_MXL_PAGE_URL,\n  KEY_MXL_PROFILE_ID,\n  KEY_PREFIX_MXL_EVENT_PROPERTY,\n  MXL_ANALYTICS_KINDS,\n} from '../../constants/attributes';\nimport type { PageManager } from '../../api-page/manager/types';\nimport type { UserManagerInternal } from '../../api-users/manager/types';\nimport type { UserSessionManagerInternal } from '../MXLUserSessionManager/types';\nimport {\n  clearProfileSnapshot,\n  loadProfileSnapshot,\n  mergeProfileSnapshot,\n  saveProfileSnapshot,\n  snapshotToEventProperties,\n} from '../MXLUserManager/profileSnapshot';\nimport {\n  clearPreviousSessionSnapshot,\n  loadPreviousSessionSnapshot,\n  parsePageContextFromUrl,\n  savePreviousSessionSnapshot,\n  SessionAnalyticsState,\n} from './sessionAnalyticsState';\nimport type { MXLAnalyticsManagerArgs } from './types';\n\nconst SCREEN_VIEW_DEBOUNCE_MS = 50;\n\nexport class MXLAnalyticsManager implements AnalyticsManagerInternal {\n  private readonly _diag: DiagLogger;\n  private readonly _logger: Logger;\n  private readonly _applicationId: string;\n  private readonly _userManager: UserManagerInternal;\n  private readonly _userSessionManager: UserSessionManagerInternal;\n  private readonly _pageManager: PageManager;\n  private readonly _storage: Storage;\n  private readonly _sessionAnalytics = new SessionAnalyticsState();\n  private _lastScreenViewPath: string | null = null;\n  private _screenViewTimer: ReturnType<typeof setTimeout> | null = null;\n\n  public constructor({\n    applicationId,\n    diag: diagParam,\n    loggerProvider: globalLoggerProviderOverride,\n    pageManager,\n    storage = window.localStorage,\n    userManager,\n    userSessionManager,\n  }: MXLAnalyticsManagerArgs) {\n    const loggerProvider = globalLoggerProviderOverride ?? logs;\n\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLAnalyticsManager',\n      });\n    this._applicationId = applicationId;\n    this._userManager = userManager;\n    this._userSessionManager = userSessionManager;\n    this._pageManager = pageManager;\n    this._storage = storage;\n    this._logger = loggerProvider.getLogger('mxl-web-sdk-analytics');\n  }\n\n  public getSessionAnalyticsState(): SessionAnalyticsState {\n    return this._sessionAnalytics;\n  }\n\n  public track(name: string, options: AnalyticsTrackOptions = {}): void {\n    if (typeof name !== 'string' || !name.trim()) {\n      this._diag.warn('track name must be a non-empty string');\n      return;\n    }\n\n    this._sessionAnalytics.recordTrackEvent();\n    this._emitAnalyticsLog(MXL_ANALYTICS_KINDS.Track, name.trim(), options.properties);\n  }\n\n  public identify(options: AnalyticsIdentifyOptions): void {\n    if (!options.profileId?.trim()) {\n      this._diag.warn('identify requires profileId');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const merged = mergeProfileSnapshot(existing, {\n      avatar: options.avatar ?? '',\n      email: options.email ?? '',\n      firstName: options.firstName ?? '',\n      lastName: options.lastName ?? '',\n      profileId: options.profileId.trim(),\n      properties: options.properties ?? {},\n    });\n\n    if (!saveProfileSnapshot(this._storage, merged)) {\n      this._diag.warn('Failed to persist profile snapshot');\n    }\n\n    this._userManager.setUserId(merged.profileId);\n\n    const props = snapshotToEventProperties(merged);\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Identify,\n      'identify',\n      props,\n      merged.profileId,\n    );\n  }\n\n  public increment({ property, value = 1 }: AnalyticsCounterOptions): void {\n    const profileId = this._resolveProfileId();\n    if (!profileId) {\n      this._diag.warn('increment requires an identified profile');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const current = Number.parseFloat(existing?.properties[property] ?? '0');\n    const next = Number.isFinite(current) ? current + value : value;\n    const merged = mergeProfileSnapshot(existing, {\n      profileId,\n      properties: {\n        ...(existing?.properties ?? {}),\n        [property]: String(next),\n        counter_name: property,\n        counter_value: String(next),\n      },\n    });\n    saveProfileSnapshot(this._storage, merged);\n\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Increment,\n      property,\n      {\n        counter_name: property,\n        counter_value: String(next),\n      },\n      profileId,\n    );\n  }\n\n  public decrement({ property, value = 1 }: AnalyticsCounterOptions): void {\n    const profileId = this._resolveProfileId();\n    if (!profileId) {\n      this._diag.warn('decrement requires an identified profile');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const current = Number.parseFloat(existing?.properties[property] ?? '0');\n    const next = Number.isFinite(current)\n      ? current - Math.abs(value)\n      : -Math.abs(value);\n    const merged = mergeProfileSnapshot(existing, {\n      profileId,\n      properties: {\n        ...(existing?.properties ?? {}),\n        [property]: String(next),\n        counter_name: property,\n        counter_value: String(next),\n      },\n    });\n    saveProfileSnapshot(this._storage, merged);\n\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Decrement,\n      property,\n      {\n        counter_name: property,\n        counter_value: String(next),\n      },\n      profileId,\n    );\n  }\n\n  public clear(): void {\n    clearProfileSnapshot(this._storage);\n    this._userManager.clearUserId();\n  }\n\n  public screenView(): void {\n    if (this._screenViewTimer) {\n      clearTimeout(this._screenViewTimer);\n    }\n\n    this._screenViewTimer = setTimeout(() => {\n      this._screenViewTimer = null;\n      this._emitScreenView();\n    }, SCREEN_VIEW_DEBOUNCE_MS);\n  }\n\n  public buildSessionPartAnalyticsAttributes(): Attributes {\n    const previous = loadPreviousSessionSnapshot(this._storage);\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = this._resolveProfileId() ?? deviceId;\n    return this._sessionAnalytics.buildSpanAttributes(profileId, previous);\n  }\n\n  public finalizeSessionPartAnalytics(): void {\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = this._resolveProfileId() ?? deviceId;\n    const snapshot = this._sessionAnalytics.toRowSnapshot(\n      this._applicationId,\n      profileId,\n      deviceId,\n    );\n    savePreviousSessionSnapshot(this._storage, snapshot);\n  }\n\n  public resetSessionAnalyticsForNewUserSession(): void {\n    this._sessionAnalytics.reset();\n    clearPreviousSessionSnapshot(this._storage);\n    this._lastScreenViewPath = null;\n  }\n\n  private _emitScreenView(): void {\n    const route = this._pageManager.getCurrentRoute();\n    const url = route?.url ?? window.location.href;\n    const path = route?.path ?? window.location.pathname;\n\n    if (this._lastScreenViewPath === path) {\n      return;\n    }\n    this._lastScreenViewPath = path;\n\n    const pageContext = parsePageContextFromUrl(url);\n    this._sessionAnalytics.recordScreenView(pageContext);\n\n    this._emitAnalyticsLog(MXL_ANALYTICS_KINDS.ScreenView, 'screen_view');\n  }\n\n  private _emitAnalyticsLog(\n    kind: MXL_ANALYTICS_KINDS,\n    name: string,\n    properties: Record<string, unknown> = {},\n    profileIdOverride?: string,\n  ): void {\n    const route = this._pageManager.getCurrentRoute();\n    const url = route?.url ?? window.location.href;\n    const path = route?.path ?? window.location.pathname;\n    const title = this._pageManager.getPageLabel() ?? document.title ?? '';\n    let origin = '';\n    try {\n      origin = new URL(url, window.location.origin).origin;\n    } catch {\n      origin = window.location.origin;\n    }\n\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = profileIdOverride ?? this._resolveProfileId() ?? deviceId;\n    const sessionId = this._userSessionManager.getUserSessionId() ?? '';\n\n    const attrs: Attributes = {\n      [KEY_MXL_ANALYTICS_KIND]: kind,\n      [KEY_MXL_ANALYTICS_NAME]: name,\n      [KEY_MXL_APPLICATION_ID]: this._applicationId,\n      [KEY_MXL_DEVICE_ID]: deviceId,\n      [KEY_MXL_PROFILE_ID]: profileId,\n      'mxl.session.id': sessionId,\n      [KEY_MXL_PAGE_PATH]: path,\n      [KEY_MXL_PAGE_URL]: url,\n      [KEY_MXL_PAGE_ORIGIN]: origin,\n      [KEY_MXL_PAGE_TITLE]: title,\n      [KEY_MXL_PAGE_REFERRER]: document.referrer,\n    };\n\n    for (const [key, value] of Object.entries(properties)) {\n      if (value === undefined || value === null) {\n        continue;\n      }\n      attrs[`${KEY_PREFIX_MXL_EVENT_PROPERTY}${key}`] = String(value);\n    }\n\n    this._logger.emit({\n      attributes: attrs,\n      body: name,\n      severityNumber: SeverityNumber.INFO,\n      severityText: 'INFO',\n    });\n  }\n\n  private _resolveProfileId(): string | null {\n    const external = this._userManager.getUserId();\n    if (external) {\n      return external;\n    }\n    const snapshot = loadProfileSnapshot(this._storage);\n    return snapshot?.profileId || null;\n  }\n}\n"],"mappings":"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"}

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.cts

@@ -0,0 +1,49 @@
+import { SessionAnalyticsState } from "./sessionAnalyticsState.cjs";
+import { AnalyticsCounterOptions, AnalyticsIdentifyOptions, AnalyticsManagerInternal, AnalyticsTrackOptions } from "../../api-analytics/manager/types.cjs";
+import { MXLAnalyticsManagerArgs } from "./types.cjs";
+import { Attributes } from "@opentelemetry/api";
+
+//#region src/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.ts
+declare class MXLAnalyticsManager implements AnalyticsManagerInternal {
+  private readonly _diag;
+  private readonly _logger;
+  private readonly _applicationId;
+  private readonly _userManager;
+  private readonly _userSessionManager;
+  private readonly _pageManager;
+  private readonly _storage;
+  private readonly _sessionAnalytics;
+  private _lastScreenViewPath;
+  private _screenViewTimer;
+  constructor({
+    applicationId,
+    diag: diagParam,
+    loggerProvider: globalLoggerProviderOverride,
+    pageManager,
+    storage,
+    userManager,
+    userSessionManager
+  }: MXLAnalyticsManagerArgs);
+  getSessionAnalyticsState(): SessionAnalyticsState;
+  track(name: string, options?: AnalyticsTrackOptions): void;
+  identify(options: AnalyticsIdentifyOptions): void;
+  increment({
+    property,
+    value
+  }: AnalyticsCounterOptions): void;
+  decrement({
+    property,
+    value
+  }: AnalyticsCounterOptions): void;
+  clear(): void;
+  screenView(): void;
+  buildSessionPartAnalyticsAttributes(): Attributes;
+  finalizeSessionPartAnalytics(): void;
+  resetSessionAnalyticsForNewUserSession(): void;
+  private _emitScreenView;
+  private _emitAnalyticsLog;
+  private _resolveProfileId;
+}
+//#endregion
+export { MXLAnalyticsManager };
+//# sourceMappingURL=MXLAnalyticsManager.d.cts.map

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLAnalyticsManager.d.cts","names":[],"sources":["../../../src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts"],"mappings":";;;;;;cA6Ca,mBAAA,YAA+B,wBAAA;EAAA,iBACzB,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,cAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,QAAA;EAAA,iBACA,iBAAA;EAAA,QACT,mBAAA;EAAA,QACA,gBAAA;;IAGN,aAAA;IACA,IAAA,EAAM,SAAA;IACN,cAAA,EAAgB,4BAAA;IAChB,WAAA;IACA,OAAA;IACA,WAAA;IACA;EAAA,GACC,uBAAA;EAgBI,wBAAA,CAAA,GAA4B,qBAAA;EAI5B,KAAA,CAAM,IAAA,UAAc,OAAA,GAAS,qBAAA;EAU7B,QAAA,CAAS,OAAA,EAAS,wBAAA;EA+BlB,SAAA,CAAA;IAAY,QAAA;IAAU;EAAA,GAAa,uBAAA;EAgCnC,SAAA,CAAA;IAAY,QAAA;IAAU;EAAA,GAAa,uBAAA;EAkCnC,KAAA,CAAA;EAKA,UAAA,CAAA;EAWA,mCAAA,CAAA,GAAuC,UAAA;EAOvC,4BAAA,CAAA;EAWA,sCAAA,CAAA;EAAA,QAMC,eAAA;EAAA,QAgBA,iBAAA;EAAA,QAkDA,iBAAA;AAAA"}

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.ts

@@ -0,0 +1,49 @@
+import { SessionAnalyticsState } from "./sessionAnalyticsState.js";
+import { AnalyticsCounterOptions, AnalyticsIdentifyOptions, AnalyticsManagerInternal, AnalyticsTrackOptions } from "../../api-analytics/manager/types.js";
+import { MXLAnalyticsManagerArgs } from "./types.js";
+import { Attributes } from "@opentelemetry/api";
+
+//#region src/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.ts
+declare class MXLAnalyticsManager implements AnalyticsManagerInternal {
+  private readonly _diag;
+  private readonly _logger;
+  private readonly _applicationId;
+  private readonly _userManager;
+  private readonly _userSessionManager;
+  private readonly _pageManager;
+  private readonly _storage;
+  private readonly _sessionAnalytics;
+  private _lastScreenViewPath;
+  private _screenViewTimer;
+  constructor({
+    applicationId,
+    diag: diagParam,
+    loggerProvider: globalLoggerProviderOverride,
+    pageManager,
+    storage,
+    userManager,
+    userSessionManager
+  }: MXLAnalyticsManagerArgs);
+  getSessionAnalyticsState(): SessionAnalyticsState;
+  track(name: string, options?: AnalyticsTrackOptions): void;
+  identify(options: AnalyticsIdentifyOptions): void;
+  increment({
+    property,
+    value
+  }: AnalyticsCounterOptions): void;
+  decrement({
+    property,
+    value
+  }: AnalyticsCounterOptions): void;
+  clear(): void;
+  screenView(): void;
+  buildSessionPartAnalyticsAttributes(): Attributes;
+  finalizeSessionPartAnalytics(): void;
+  resetSessionAnalyticsForNewUserSession(): void;
+  private _emitScreenView;
+  private _emitAnalyticsLog;
+  private _resolveProfileId;
+}
+//#endregion
+export { MXLAnalyticsManager };
+//# sourceMappingURL=MXLAnalyticsManager.d.ts.map

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLAnalyticsManager.d.ts","names":[],"sources":["../../../src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts"],"mappings":";;;;;;cA6Ca,mBAAA,YAA+B,wBAAA;EAAA,iBACzB,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,cAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,QAAA;EAAA,iBACA,iBAAA;EAAA,QACT,mBAAA;EAAA,QACA,gBAAA;;IAGN,aAAA;IACA,IAAA,EAAM,SAAA;IACN,cAAA,EAAgB,4BAAA;IAChB,WAAA;IACA,OAAA;IACA,WAAA;IACA;EAAA,GACC,uBAAA;EAgBI,wBAAA,CAAA,GAA4B,qBAAA;EAI5B,KAAA,CAAM,IAAA,UAAc,OAAA,GAAS,qBAAA;EAU7B,QAAA,CAAS,OAAA,EAAS,wBAAA;EA+BlB,SAAA,CAAA;IAAY,QAAA;IAAU;EAAA,GAAa,uBAAA;EAgCnC,SAAA,CAAA;IAAY,QAAA;IAAU;EAAA,GAAa,uBAAA;EAkCnC,KAAA,CAAA;EAKA,UAAA,CAAA;EAWA,mCAAA,CAAA,GAAuC,UAAA;EAOvC,4BAAA,CAAA;EAWA,sCAAA,CAAA;EAAA,QAMC,eAAA;EAAA,QAgBA,iBAAA;EAAA,QAkDA,iBAAA;AAAA"}

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.js

@@ -0,0 +1,191 @@
+import { KEY_MXL_ANALYTICS_KIND, KEY_MXL_ANALYTICS_NAME, KEY_MXL_APPLICATION_ID, KEY_MXL_DEVICE_ID, KEY_MXL_PAGE_ORIGIN, KEY_MXL_PAGE_PATH, KEY_MXL_PAGE_REFERRER, KEY_MXL_PAGE_TITLE, KEY_MXL_PAGE_URL, KEY_MXL_PROFILE_ID, KEY_PREFIX_MXL_EVENT_PROPERTY } from "../../constants/attributes.js";
+import { clearProfileSnapshot, loadProfileSnapshot, mergeProfileSnapshot, saveProfileSnapshot, snapshotToEventProperties } from "../MXLUserManager/profileSnapshot.js";
+import { SessionAnalyticsState, clearPreviousSessionSnapshot, loadPreviousSessionSnapshot, parsePageContextFromUrl, savePreviousSessionSnapshot } from "./sessionAnalyticsState.js";
+import { diag } from "@opentelemetry/api";
+import { SeverityNumber, logs } from "@opentelemetry/api-logs";
+//#region src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts
+const SCREEN_VIEW_DEBOUNCE_MS = 50;
+var MXLAnalyticsManager = class {
+	_diag;
+	_logger;
+	_applicationId;
+	_userManager;
+	_userSessionManager;
+	_pageManager;
+	_storage;
+	_sessionAnalytics = new SessionAnalyticsState();
+	_lastScreenViewPath = null;
+	_screenViewTimer = null;
+	constructor({ applicationId, diag: diagParam, loggerProvider: globalLoggerProviderOverride, pageManager, storage = window.localStorage, userManager, userSessionManager }) {
+		const loggerProvider = globalLoggerProviderOverride ?? logs;
+		this._diag = diagParam ?? diag.createComponentLogger({ namespace: "MXLAnalyticsManager" });
+		this._applicationId = applicationId;
+		this._userManager = userManager;
+		this._userSessionManager = userSessionManager;
+		this._pageManager = pageManager;
+		this._storage = storage;
+		this._logger = loggerProvider.getLogger("mxl-web-sdk-analytics");
+	}
+	getSessionAnalyticsState() {
+		return this._sessionAnalytics;
+	}
+	track(name, options = {}) {
+		if (typeof name !== "string" || !name.trim()) {
+			this._diag.warn("track name must be a non-empty string");
+			return;
+		}
+		this._sessionAnalytics.recordTrackEvent();
+		this._emitAnalyticsLog("track", name.trim(), options.properties);
+	}
+	identify(options) {
+		if (!options.profileId?.trim()) {
+			this._diag.warn("identify requires profileId");
+			return;
+		}
+		const merged = mergeProfileSnapshot(loadProfileSnapshot(this._storage), {
+			avatar: options.avatar ?? "",
+			email: options.email ?? "",
+			firstName: options.firstName ?? "",
+			lastName: options.lastName ?? "",
+			profileId: options.profileId.trim(),
+			properties: options.properties ?? {}
+		});
+		if (!saveProfileSnapshot(this._storage, merged)) this._diag.warn("Failed to persist profile snapshot");
+		this._userManager.setUserId(merged.profileId);
+		const props = snapshotToEventProperties(merged);
+		this._emitAnalyticsLog("identify", "identify", props, merged.profileId);
+	}
+	increment({ property, value = 1 }) {
+		const profileId = this._resolveProfileId();
+		if (!profileId) {
+			this._diag.warn("increment requires an identified profile");
+			return;
+		}
+		const existing = loadProfileSnapshot(this._storage);
+		const current = Number.parseFloat(existing?.properties[property] ?? "0");
+		const next = Number.isFinite(current) ? current + value : value;
+		const merged = mergeProfileSnapshot(existing, {
+			profileId,
+			properties: {
+				...existing?.properties ?? {},
+				[property]: String(next),
+				counter_name: property,
+				counter_value: String(next)
+			}
+		});
+		saveProfileSnapshot(this._storage, merged);
+		this._emitAnalyticsLog("increment", property, {
+			counter_name: property,
+			counter_value: String(next)
+		}, profileId);
+	}
+	decrement({ property, value = 1 }) {
+		const profileId = this._resolveProfileId();
+		if (!profileId) {
+			this._diag.warn("decrement requires an identified profile");
+			return;
+		}
+		const existing = loadProfileSnapshot(this._storage);
+		const current = Number.parseFloat(existing?.properties[property] ?? "0");
+		const next = Number.isFinite(current) ? current - Math.abs(value) : -Math.abs(value);
+		const merged = mergeProfileSnapshot(existing, {
+			profileId,
+			properties: {
+				...existing?.properties ?? {},
+				[property]: String(next),
+				counter_name: property,
+				counter_value: String(next)
+			}
+		});
+		saveProfileSnapshot(this._storage, merged);
+		this._emitAnalyticsLog("decrement", property, {
+			counter_name: property,
+			counter_value: String(next)
+		}, profileId);
+	}
+	clear() {
+		clearProfileSnapshot(this._storage);
+		this._userManager.clearUserId();
+	}
+	screenView() {
+		if (this._screenViewTimer) clearTimeout(this._screenViewTimer);
+		this._screenViewTimer = setTimeout(() => {
+			this._screenViewTimer = null;
+			this._emitScreenView();
+		}, SCREEN_VIEW_DEBOUNCE_MS);
+	}
+	buildSessionPartAnalyticsAttributes() {
+		const previous = loadPreviousSessionSnapshot(this._storage);
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = this._resolveProfileId() ?? deviceId;
+		return this._sessionAnalytics.buildSpanAttributes(profileId, previous);
+	}
+	finalizeSessionPartAnalytics() {
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = this._resolveProfileId() ?? deviceId;
+		const snapshot = this._sessionAnalytics.toRowSnapshot(this._applicationId, profileId, deviceId);
+		savePreviousSessionSnapshot(this._storage, snapshot);
+	}
+	resetSessionAnalyticsForNewUserSession() {
+		this._sessionAnalytics.reset();
+		clearPreviousSessionSnapshot(this._storage);
+		this._lastScreenViewPath = null;
+	}
+	_emitScreenView() {
+		const route = this._pageManager.getCurrentRoute();
+		const url = route?.url ?? window.location.href;
+		const path = route?.path ?? window.location.pathname;
+		if (this._lastScreenViewPath === path) return;
+		this._lastScreenViewPath = path;
+		const pageContext = parsePageContextFromUrl(url);
+		this._sessionAnalytics.recordScreenView(pageContext);
+		this._emitAnalyticsLog("screen_view", "screen_view");
+	}
+	_emitAnalyticsLog(kind, name, properties = {}, profileIdOverride) {
+		const route = this._pageManager.getCurrentRoute();
+		const url = route?.url ?? window.location.href;
+		const path = route?.path ?? window.location.pathname;
+		const title = this._pageManager.getPageLabel() ?? document.title ?? "";
+		let origin = "";
+		try {
+			origin = new URL(url, window.location.origin).origin;
+		} catch {
+			origin = window.location.origin;
+		}
+		const deviceId = this._userManager.getMXLUserId();
+		const profileId = profileIdOverride ?? this._resolveProfileId() ?? deviceId;
+		const sessionId = this._userSessionManager.getUserSessionId() ?? "";
+		const attrs = {
+			[KEY_MXL_ANALYTICS_KIND]: kind,
+			[KEY_MXL_ANALYTICS_NAME]: name,
+			[KEY_MXL_APPLICATION_ID]: this._applicationId,
+			[KEY_MXL_DEVICE_ID]: deviceId,
+			[KEY_MXL_PROFILE_ID]: profileId,
+			"mxl.session.id": sessionId,
+			[KEY_MXL_PAGE_PATH]: path,
+			[KEY_MXL_PAGE_URL]: url,
+			[KEY_MXL_PAGE_ORIGIN]: origin,
+			[KEY_MXL_PAGE_TITLE]: title,
+			[KEY_MXL_PAGE_REFERRER]: document.referrer
+		};
+		for (const [key, value] of Object.entries(properties)) {
+			if (value === void 0 || value === null) continue;
+			attrs[`${KEY_PREFIX_MXL_EVENT_PROPERTY}${key}`] = String(value);
+		}
+		this._logger.emit({
+			attributes: attrs,
+			body: name,
+			severityNumber: SeverityNumber.INFO,
+			severityText: "INFO"
+		});
+	}
+	_resolveProfileId() {
+		const external = this._userManager.getUserId();
+		if (external) return external;
+		return loadProfileSnapshot(this._storage)?.profileId || null;
+	}
+};
+//#endregion
+export { MXLAnalyticsManager };
+
+//# sourceMappingURL=MXLAnalyticsManager.js.map

package/dist/managers/MXLAnalyticsManager/MXLAnalyticsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLAnalyticsManager.js","names":[],"sources":["../../../src/managers/MXLAnalyticsManager/MXLAnalyticsManager.ts"],"sourcesContent":["import type { Attributes, DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { Logger } from '@opentelemetry/api-logs';\nimport { SeverityNumber, logs } from '@opentelemetry/api-logs';\nimport type {\n  AnalyticsCounterOptions,\n  AnalyticsIdentifyOptions,\n  AnalyticsManagerInternal,\n  AnalyticsTrackOptions,\n} from '../../api-analytics/manager/types';\nimport {\n  KEY_MXL_ANALYTICS_KIND,\n  KEY_MXL_ANALYTICS_NAME,\n  KEY_MXL_APPLICATION_ID,\n  KEY_MXL_DEVICE_ID,\n  KEY_MXL_PAGE_ORIGIN,\n  KEY_MXL_PAGE_PATH,\n  KEY_MXL_PAGE_REFERRER,\n  KEY_MXL_PAGE_TITLE,\n  KEY_MXL_PAGE_URL,\n  KEY_MXL_PROFILE_ID,\n  KEY_PREFIX_MXL_EVENT_PROPERTY,\n  MXL_ANALYTICS_KINDS,\n} from '../../constants/attributes';\nimport type { PageManager } from '../../api-page/manager/types';\nimport type { UserManagerInternal } from '../../api-users/manager/types';\nimport type { UserSessionManagerInternal } from '../MXLUserSessionManager/types';\nimport {\n  clearProfileSnapshot,\n  loadProfileSnapshot,\n  mergeProfileSnapshot,\n  saveProfileSnapshot,\n  snapshotToEventProperties,\n} from '../MXLUserManager/profileSnapshot';\nimport {\n  clearPreviousSessionSnapshot,\n  loadPreviousSessionSnapshot,\n  parsePageContextFromUrl,\n  savePreviousSessionSnapshot,\n  SessionAnalyticsState,\n} from './sessionAnalyticsState';\nimport type { MXLAnalyticsManagerArgs } from './types';\n\nconst SCREEN_VIEW_DEBOUNCE_MS = 50;\n\nexport class MXLAnalyticsManager implements AnalyticsManagerInternal {\n  private readonly _diag: DiagLogger;\n  private readonly _logger: Logger;\n  private readonly _applicationId: string;\n  private readonly _userManager: UserManagerInternal;\n  private readonly _userSessionManager: UserSessionManagerInternal;\n  private readonly _pageManager: PageManager;\n  private readonly _storage: Storage;\n  private readonly _sessionAnalytics = new SessionAnalyticsState();\n  private _lastScreenViewPath: string | null = null;\n  private _screenViewTimer: ReturnType<typeof setTimeout> | null = null;\n\n  public constructor({\n    applicationId,\n    diag: diagParam,\n    loggerProvider: globalLoggerProviderOverride,\n    pageManager,\n    storage = window.localStorage,\n    userManager,\n    userSessionManager,\n  }: MXLAnalyticsManagerArgs) {\n    const loggerProvider = globalLoggerProviderOverride ?? logs;\n\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLAnalyticsManager',\n      });\n    this._applicationId = applicationId;\n    this._userManager = userManager;\n    this._userSessionManager = userSessionManager;\n    this._pageManager = pageManager;\n    this._storage = storage;\n    this._logger = loggerProvider.getLogger('mxl-web-sdk-analytics');\n  }\n\n  public getSessionAnalyticsState(): SessionAnalyticsState {\n    return this._sessionAnalytics;\n  }\n\n  public track(name: string, options: AnalyticsTrackOptions = {}): void {\n    if (typeof name !== 'string' || !name.trim()) {\n      this._diag.warn('track name must be a non-empty string');\n      return;\n    }\n\n    this._sessionAnalytics.recordTrackEvent();\n    this._emitAnalyticsLog(MXL_ANALYTICS_KINDS.Track, name.trim(), options.properties);\n  }\n\n  public identify(options: AnalyticsIdentifyOptions): void {\n    if (!options.profileId?.trim()) {\n      this._diag.warn('identify requires profileId');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const merged = mergeProfileSnapshot(existing, {\n      avatar: options.avatar ?? '',\n      email: options.email ?? '',\n      firstName: options.firstName ?? '',\n      lastName: options.lastName ?? '',\n      profileId: options.profileId.trim(),\n      properties: options.properties ?? {},\n    });\n\n    if (!saveProfileSnapshot(this._storage, merged)) {\n      this._diag.warn('Failed to persist profile snapshot');\n    }\n\n    this._userManager.setUserId(merged.profileId);\n\n    const props = snapshotToEventProperties(merged);\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Identify,\n      'identify',\n      props,\n      merged.profileId,\n    );\n  }\n\n  public increment({ property, value = 1 }: AnalyticsCounterOptions): void {\n    const profileId = this._resolveProfileId();\n    if (!profileId) {\n      this._diag.warn('increment requires an identified profile');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const current = Number.parseFloat(existing?.properties[property] ?? '0');\n    const next = Number.isFinite(current) ? current + value : value;\n    const merged = mergeProfileSnapshot(existing, {\n      profileId,\n      properties: {\n        ...(existing?.properties ?? {}),\n        [property]: String(next),\n        counter_name: property,\n        counter_value: String(next),\n      },\n    });\n    saveProfileSnapshot(this._storage, merged);\n\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Increment,\n      property,\n      {\n        counter_name: property,\n        counter_value: String(next),\n      },\n      profileId,\n    );\n  }\n\n  public decrement({ property, value = 1 }: AnalyticsCounterOptions): void {\n    const profileId = this._resolveProfileId();\n    if (!profileId) {\n      this._diag.warn('decrement requires an identified profile');\n      return;\n    }\n\n    const existing = loadProfileSnapshot(this._storage);\n    const current = Number.parseFloat(existing?.properties[property] ?? '0');\n    const next = Number.isFinite(current)\n      ? current - Math.abs(value)\n      : -Math.abs(value);\n    const merged = mergeProfileSnapshot(existing, {\n      profileId,\n      properties: {\n        ...(existing?.properties ?? {}),\n        [property]: String(next),\n        counter_name: property,\n        counter_value: String(next),\n      },\n    });\n    saveProfileSnapshot(this._storage, merged);\n\n    this._emitAnalyticsLog(\n      MXL_ANALYTICS_KINDS.Decrement,\n      property,\n      {\n        counter_name: property,\n        counter_value: String(next),\n      },\n      profileId,\n    );\n  }\n\n  public clear(): void {\n    clearProfileSnapshot(this._storage);\n    this._userManager.clearUserId();\n  }\n\n  public screenView(): void {\n    if (this._screenViewTimer) {\n      clearTimeout(this._screenViewTimer);\n    }\n\n    this._screenViewTimer = setTimeout(() => {\n      this._screenViewTimer = null;\n      this._emitScreenView();\n    }, SCREEN_VIEW_DEBOUNCE_MS);\n  }\n\n  public buildSessionPartAnalyticsAttributes(): Attributes {\n    const previous = loadPreviousSessionSnapshot(this._storage);\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = this._resolveProfileId() ?? deviceId;\n    return this._sessionAnalytics.buildSpanAttributes(profileId, previous);\n  }\n\n  public finalizeSessionPartAnalytics(): void {\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = this._resolveProfileId() ?? deviceId;\n    const snapshot = this._sessionAnalytics.toRowSnapshot(\n      this._applicationId,\n      profileId,\n      deviceId,\n    );\n    savePreviousSessionSnapshot(this._storage, snapshot);\n  }\n\n  public resetSessionAnalyticsForNewUserSession(): void {\n    this._sessionAnalytics.reset();\n    clearPreviousSessionSnapshot(this._storage);\n    this._lastScreenViewPath = null;\n  }\n\n  private _emitScreenView(): void {\n    const route = this._pageManager.getCurrentRoute();\n    const url = route?.url ?? window.location.href;\n    const path = route?.path ?? window.location.pathname;\n\n    if (this._lastScreenViewPath === path) {\n      return;\n    }\n    this._lastScreenViewPath = path;\n\n    const pageContext = parsePageContextFromUrl(url);\n    this._sessionAnalytics.recordScreenView(pageContext);\n\n    this._emitAnalyticsLog(MXL_ANALYTICS_KINDS.ScreenView, 'screen_view');\n  }\n\n  private _emitAnalyticsLog(\n    kind: MXL_ANALYTICS_KINDS,\n    name: string,\n    properties: Record<string, unknown> = {},\n    profileIdOverride?: string,\n  ): void {\n    const route = this._pageManager.getCurrentRoute();\n    const url = route?.url ?? window.location.href;\n    const path = route?.path ?? window.location.pathname;\n    const title = this._pageManager.getPageLabel() ?? document.title ?? '';\n    let origin = '';\n    try {\n      origin = new URL(url, window.location.origin).origin;\n    } catch {\n      origin = window.location.origin;\n    }\n\n    const deviceId = this._userManager.getMXLUserId();\n    const profileId = profileIdOverride ?? this._resolveProfileId() ?? deviceId;\n    const sessionId = this._userSessionManager.getUserSessionId() ?? '';\n\n    const attrs: Attributes = {\n      [KEY_MXL_ANALYTICS_KIND]: kind,\n      [KEY_MXL_ANALYTICS_NAME]: name,\n      [KEY_MXL_APPLICATION_ID]: this._applicationId,\n      [KEY_MXL_DEVICE_ID]: deviceId,\n      [KEY_MXL_PROFILE_ID]: profileId,\n      'mxl.session.id': sessionId,\n      [KEY_MXL_PAGE_PATH]: path,\n      [KEY_MXL_PAGE_URL]: url,\n      [KEY_MXL_PAGE_ORIGIN]: origin,\n      [KEY_MXL_PAGE_TITLE]: title,\n      [KEY_MXL_PAGE_REFERRER]: document.referrer,\n    };\n\n    for (const [key, value] of Object.entries(properties)) {\n      if (value === undefined || value === null) {\n        continue;\n      }\n      attrs[`${KEY_PREFIX_MXL_EVENT_PROPERTY}${key}`] = String(value);\n    }\n\n    this._logger.emit({\n      attributes: attrs,\n      body: name,\n      severityNumber: SeverityNumber.INFO,\n      severityText: 'INFO',\n    });\n  }\n\n  private _resolveProfileId(): string | null {\n    const external = this._userManager.getUserId();\n    if (external) {\n      return external;\n    }\n    const snapshot = loadProfileSnapshot(this._storage);\n    return snapshot?.profileId || null;\n  }\n}\n"],"mappings":"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"}