@grafana/faro-react-native 1.3.1 → 1.4.0

package/dist/cjs/instrumentations/session/sessionAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionAttributes.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/sessionAttributes.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\nimport DeviceInfo from 'react-native-device-info';\n\nimport type { Meta } from '@grafana/faro-core';\n\nimport { getInstallationId } from './installationId';\n\n/**\n * Session attributes for React Native\n * These attributes are automatically included with every telemetry event\n *\n * Core attributes match Flutter SDK format, with additional mobile-specific\n * monitoring fields (memory, device type, battery, etc.)\n *\n * SDK name, core version, and npm adapter are on Faro meta `sdk` (`getSdkMeta` in `metas/sdk.ts`).\n *\n * `react_native_version` is the host app's React Native **framework** version from `Platform`, not the Faro package.\n */\nexport interface SessionAttributes {\n  /** Host app's React Native framework version (e.g. \"0.75.1\") from `Platform.constants`. */\n  react_native_version: string;\n\n  /** Operating system (\"iOS\" or \"Android\") */\n  device_os?: string;\n\n  /** OS version (e.g., \"17.0\" for iOS, \"15\" for Android) */\n  device_os_version?: string;\n\n  /** Detailed OS info (e.g., \"iOS 17.0\" or \"Android 15 (SDK 35)\") */\n  device_os_detail?: string;\n\n  /** Device manufacturer (e.g., \"apple\", \"samsung\", \"Google\") */\n  device_manufacturer?: string;\n\n  /** Device model in flat session attributes (e.g., \"iPhone 15 Pro\", \"SM-A155F\") */\n  device_model?: string;\n\n  /** Human-readable model name (e.g., \"iPhone 15 Pro\") */\n  device_model_name?: string;\n\n  /** Device brand in flat session attributes (e.g., \"Apple\", \"samsung\") */\n  device_brand?: string;\n\n  /** Whether device is physical or emulator (\"true\" or \"false\") */\n  device_is_physical?: string;\n\n  /** Temporary flat attribute mirroring `app.installationId` during migration. */\n  device_id?: string;\n\n  /** Device type (\"mobile\" or \"tablet\") */\n  device_type?: string;\n\n  /** Total device memory in bytes */\n  device_memory_total?: string;\n\n  /** Currently used memory in bytes */\n  device_memory_used?: string;\n\n  /** Battery level percentage (e.g., \"85\") - empty if unavailable */\n  device_battery_level?: string;\n\n  /** Whether device is charging (\"true\" or \"false\") - empty if unavailable */\n  device_is_charging?: string;\n\n  /** Whether low power mode is enabled (\"true\" or \"false\") - empty if unavailable */\n  device_low_power_mode?: string;\n\n  /** Mobile carrier name (e.g., \"Verizon\") - empty if unavailable */\n  device_carrier?: string;\n}\n\nexport interface PreloadedMobileMeta {\n  sessionAttributes: SessionAttributes;\n  meta: Pick<Meta, 'app' | 'device' | 'os'>;\n}\n\n/**\n * React Native framework version from `Platform.constants` (host app runtime), not `@grafana/faro-react-native` semver.\n */\nfunction getReactNativeVersion(): string {\n  try {\n    const version = Platform.constants.reactNativeVersion;\n    if (version && typeof version === 'object') {\n      const { major, minor, patch, prerelease } = version as {\n        major: number;\n        minor: number;\n        patch: number;\n        prerelease?: number;\n      };\n      let versionString = `${major}.${minor}.${patch}`;\n      if (prerelease) {\n        versionString += `-rc.${prerelease}`;\n      }\n      return versionString;\n    }\n    return 'unknown';\n  } catch (_error) {\n    return 'unknown';\n  }\n}\n\nfunction getStructuredDeviceBrand(model: string, brand: string): string {\n  if (Platform.OS !== 'ios') {\n    return brand;\n  }\n\n  return model.toLowerCase().includes('ipad') ? 'iPad' : 'iPhone';\n}\n\nfunction getStructuredDeviceManufacturer(manufacturer: string): string {\n  return Platform.OS === 'ios' ? manufacturer.toLowerCase() : manufacturer;\n}\n\nfunction getStructuredDeviceModelIdentifier(model: string): string | undefined {\n  // Android getDeviceId() returns a board code, so use Build.MODEL for the Faro\n  // model identifier.\n  if (Platform.OS === 'android') {\n    return model;\n  }\n\n  // React Native reports iPhone and iPadOS apps as Platform.OS === 'ios'.\n  // react-native-device-info exposes the Apple hardware identifier here.\n  if (Platform.OS === 'ios') {\n    return DeviceInfo.getDeviceId();\n  }\n\n  return undefined;\n}\n\nfunction getMobileDeviceType(isTablet: boolean): 'mobile' | 'tablet' | undefined {\n  // iPadOS is still reported as Platform.OS === 'ios'; DeviceInfo.isTablet()\n  // distinguishes iPad/tablet form factor from phone form factor.\n  if (Platform.OS === 'ios' || Platform.OS === 'android') {\n    return isTablet ? 'tablet' : 'mobile';\n  }\n\n  return undefined;\n}\n\n/**\n * Get OS detail string matching Flutter SDK format\n * iOS: \"iOS 17.0\"\n * Android: \"Android 15 (SDK 35)\"\n */\nasync function getDeviceOsDetail(): Promise<string> {\n  const systemName = DeviceInfo.getSystemName();\n  const systemVersion = DeviceInfo.getSystemVersion();\n\n  if (Platform.OS === 'android') {\n    try {\n      const apiLevel = await DeviceInfo.getApiLevel();\n      return `${systemName} ${systemVersion} (SDK ${apiLevel})`;\n    } catch (_error) {\n      return `${systemName} ${systemVersion}`;\n    }\n  }\n\n  return `${systemName} ${systemVersion}`;\n}\n\nasync function getDeviceOsBuildId(): Promise<string | undefined> {\n  try {\n    // RN device-info exposes a useful OS build id on both Android and iOS.\n    // Keep it omitted when unavailable instead of sending \"unknown\".\n    const buildId = await DeviceInfo.getBuildId();\n    return buildId && buildId !== 'unknown' ? buildId : undefined;\n  } catch (_error) {\n    return undefined;\n  }\n}\n\n/**\n * Session attributes without device props when async collection or DeviceInfo is unavailable.\n * No synchronous DeviceInfo reads — use {@link getSessionAttributes} or the package async `initializeFaro`.\n */\nexport function minimalSessionDeviceAttributes(): SessionAttributes {\n  return {\n    react_native_version: getReactNativeVersion(),\n  };\n}\n\n/**\n * Get all session attributes\n * These attributes are automatically included with every telemetry event\n *\n * Core attributes matching Flutter SDK:\n * - react_native_version (RN framework in the host app)\n * - device_os, device_os_version, device_os_detail\n * - device_manufacturer, device_model, device_model_name\n * - device_brand, device_is_physical, device_id\n *\n * Additional monitoring attributes:\n * - device_type (mobile/tablet)\n * - device_memory_total, device_memory_used\n * - device_battery_level, device_is_charging, device_low_power_mode\n * - device_carrier\n */\nexport async function getSessionAttributes(): Promise<SessionAttributes> {\n  return (await collectMobileMeta()).sessionAttributes;\n}\n\nasync function collectMobileMeta(): Promise<PreloadedMobileMeta> {\n  try {\n    const [deviceOsDetail, deviceOsBuildId, installationId] = await Promise.all([\n      getDeviceOsDetail(),\n      getDeviceOsBuildId(),\n      getInstallationId(),\n    ]);\n\n    // Get synchronous device info\n    const systemName = DeviceInfo.getSystemName();\n    const systemVersion = DeviceInfo.getSystemVersion();\n    const manufacturer = DeviceInfo.getManufacturerSync();\n    const model = DeviceInfo.getModel();\n    const modelIdentifier = getStructuredDeviceModelIdentifier(model);\n    const deviceName = DeviceInfo.getDeviceNameSync();\n    const brand = DeviceInfo.getBrand();\n    const isEmulator = DeviceInfo.isEmulatorSync();\n    const isTablet = DeviceInfo.isTablet();\n    const deviceType = getMobileDeviceType(isTablet);\n\n    // Memory info\n    const totalMemory = DeviceInfo.getTotalMemorySync();\n    const usedMemory = DeviceInfo.getUsedMemorySync();\n    const reactNativeVersion = getReactNativeVersion();\n\n    // Try to get async device info (battery, carrier)\n    let batteryLevel: string | undefined;\n    let isCharging: string | undefined;\n    let lowPowerMode: string | undefined;\n    let carrier: string | undefined;\n\n    try {\n      const battery = await DeviceInfo.getBatteryLevel();\n      if (battery >= 0) {\n        batteryLevel = String(Math.round(battery * 100));\n      }\n    } catch (_error) {\n      // Battery info not available\n    }\n\n    try {\n      isCharging = String(await DeviceInfo.isBatteryCharging());\n    } catch (_error) {\n      // Charging status not available\n    }\n\n    try {\n      if ('isPowerSaveMode' in DeviceInfo) {\n        lowPowerMode = String(\n          await (DeviceInfo as typeof DeviceInfo & { isPowerSaveMode: () => Promise<boolean> }).isPowerSaveMode()\n        );\n      }\n    } catch (_error) {\n      // Low power mode not available\n    }\n\n    try {\n      const carrierName = await DeviceInfo.getCarrier();\n      if (carrierName && carrierName !== 'unknown') {\n        carrier = carrierName;\n      }\n    } catch (_error) {\n      // Carrier not available\n    }\n\n    const attributes: SessionAttributes = {\n      react_native_version: reactNativeVersion,\n      device_os: systemName,\n      device_os_version: systemVersion,\n      device_os_detail: deviceOsDetail,\n      device_manufacturer: manufacturer.toLowerCase(),\n      device_model: model,\n      device_model_name: deviceName,\n      device_brand: brand,\n      device_is_physical: String(!isEmulator),\n      ...(installationId ? { device_id: installationId } : {}),\n      ...(deviceType ? { device_type: deviceType } : {}),\n      device_memory_total: String(totalMemory),\n      device_memory_used: String(usedMemory),\n      device_battery_level: batteryLevel,\n      device_is_charging: isCharging,\n      device_low_power_mode: lowPowerMode,\n      device_carrier: carrier,\n    };\n    const appMeta = installationId ? { installationId } : {};\n    const structuredDeviceBrand = getStructuredDeviceBrand(model, brand);\n    const structuredDeviceManufacturer = getStructuredDeviceManufacturer(manufacturer);\n    const osMeta = {\n      ...(deviceOsBuildId ? { build_id: deviceOsBuildId } : {}),\n      detail: deviceOsDetail,\n      name: systemName,\n      version: systemVersion,\n    };\n\n    return {\n      sessionAttributes: attributes,\n      meta: {\n        app: appMeta,\n        device: {\n          brand: structuredDeviceBrand,\n          is_physical: !isEmulator,\n          manufacturer: structuredDeviceManufacturer,\n          ...(modelIdentifier ? { model_identifier: modelIdentifier } : {}),\n          model_name: model,\n          ...(deviceType ? { type: deviceType } : {}),\n        },\n        os: osMeta,\n      },\n    };\n  } catch (_error) {\n    const installationId = await getInstallationId();\n\n    return {\n      sessionAttributes: minimalSessionDeviceAttributes(),\n      meta: {\n        app: installationId ? { installationId } : {},\n      },\n    };\n  }\n}\n\n/**\n * Get structured mobile meta plus flat session attributes for async `initializeFaro`.\n */\nexport async function loadMobileMetaForInit(): Promise<PreloadedMobileMeta> {\n  return collectMobileMeta();\n}\n\n/**\n * Await full async session device attributes (battery, carrier, etc.), then fall back to\n * {@link minimalSessionDeviceAttributes} if anything throws. Used by async `initializeFaro`.\n */\nexport async function loadSessionDeviceAttributesForInit(): Promise<SessionAttributes> {\n  try {\n    return (await loadMobileMetaForInit()).sessionAttributes;\n  } catch {\n    return minimalSessionDeviceAttributes();\n  }\n}\n"]}
+{"version":3,"file":"sessionAttributes.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/sessionAttributes.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\nimport DeviceInfo from 'react-native-device-info';\n\nimport type { Meta } from '@grafana/faro-core';\n\nimport { getInstallationId } from './installationId';\nimport { getSessionProcessInfo } from './sessionProcess';\n\n/**\n * Session attributes for React Native\n * These attributes are automatically included with every telemetry event\n *\n * Core mobile session attributes, with additional monitoring fields\n * (memory, device type, battery, etc.)\n *\n * SDK name, core version, and npm adapter are on Faro meta `sdk` (`getSdkMeta` in `metas/sdk.ts`).\n *\n * `react_native_version` is the host app's React Native **framework** version from `Platform`, not the Faro package.\n */\nexport interface SessionAttributes {\n  /** Host app's React Native framework version (e.g. \"0.75.1\") from `Platform.constants`. */\n  react_native_version: string;\n\n  /** Stable Android process name or Apple bundle identifier for this runtime. */\n  process_name?: string;\n\n  /** Operating system (\"iOS\" or \"Android\") */\n  device_os?: string;\n\n  /** OS version (e.g., \"17.0\" for iOS, \"15\" for Android) */\n  device_os_version?: string;\n\n  /** Detailed OS info (e.g., \"iOS 17.0\" or \"Android 15 (SDK 35)\") */\n  device_os_detail?: string;\n\n  /** Device manufacturer (e.g., \"apple\", \"samsung\", \"Google\") */\n  device_manufacturer?: string;\n\n  /** Device model in flat session attributes (e.g., \"iPhone 15 Pro\", \"SM-A155F\") */\n  device_model?: string;\n\n  /** Human-readable model name (e.g., \"iPhone 15 Pro\") */\n  device_model_name?: string;\n\n  /** Device brand in flat session attributes (e.g., \"Apple\", \"samsung\") */\n  device_brand?: string;\n\n  /** Whether device is physical or emulator (\"true\" or \"false\") */\n  device_is_physical?: string;\n\n  /** Temporary flat attribute mirroring `app.installationId` during migration. */\n  device_id?: string;\n\n  /** Device type (\"mobile\" or \"tablet\") */\n  device_type?: string;\n\n  /** Total device memory in bytes */\n  device_memory_total?: string;\n\n  /** Currently used memory in bytes */\n  device_memory_used?: string;\n\n  /** Battery level percentage (e.g., \"85\") - empty if unavailable */\n  device_battery_level?: string;\n\n  /** Whether device is charging (\"true\" or \"false\") - empty if unavailable */\n  device_is_charging?: string;\n\n  /** Whether low power mode is enabled (\"true\" or \"false\") - empty if unavailable */\n  device_low_power_mode?: string;\n\n  /** Mobile carrier name (e.g., \"Verizon\") - empty if unavailable */\n  device_carrier?: string;\n}\n\nexport interface PreloadedMobileMeta {\n  sessionAttributes: SessionAttributes;\n  meta: Pick<Meta, 'app' | 'device' | 'os'>;\n}\n\n/**\n * React Native framework version from `Platform.constants` (host app runtime), not `@grafana/faro-react-native` semver.\n */\nfunction getReactNativeVersion(): string {\n  try {\n    const version = Platform.constants.reactNativeVersion;\n    if (version && typeof version === 'object') {\n      const { major, minor, patch, prerelease } = version as {\n        major: number;\n        minor: number;\n        patch: number;\n        prerelease?: number;\n      };\n      let versionString = `${major}.${minor}.${patch}`;\n      if (prerelease) {\n        versionString += `-rc.${prerelease}`;\n      }\n      return versionString;\n    }\n    return 'unknown';\n  } catch (_error) {\n    return 'unknown';\n  }\n}\n\nfunction getStructuredDeviceBrand(model: string, brand: string): string {\n  if (Platform.OS !== 'ios') {\n    return brand;\n  }\n\n  return model.toLowerCase().includes('ipad') ? 'iPad' : 'iPhone';\n}\n\nfunction getStructuredDeviceManufacturer(manufacturer: string): string {\n  return Platform.OS === 'ios' ? manufacturer.toLowerCase() : manufacturer;\n}\n\nfunction getStructuredDeviceModelIdentifier(model: string): string | undefined {\n  // Android getDeviceId() returns a board code, so use Build.MODEL for the Faro\n  // model identifier.\n  if (Platform.OS === 'android') {\n    return model;\n  }\n\n  // React Native reports iPhone and iPadOS apps as Platform.OS === 'ios'.\n  // react-native-device-info exposes the Apple hardware identifier here.\n  if (Platform.OS === 'ios') {\n    return DeviceInfo.getDeviceId();\n  }\n\n  return undefined;\n}\n\nfunction getMobileDeviceType(isTablet: boolean): 'mobile' | 'tablet' | undefined {\n  // iPadOS is still reported as Platform.OS === 'ios'; DeviceInfo.isTablet()\n  // distinguishes iPad/tablet form factor from phone form factor.\n  if (Platform.OS === 'ios' || Platform.OS === 'android') {\n    return isTablet ? 'tablet' : 'mobile';\n  }\n\n  return undefined;\n}\n\n/**\n * Get OS detail string for session attributes.\n * iOS: \"iOS 17.0\"\n * Android: \"Android 15 (SDK 35)\"\n */\nasync function getDeviceOsDetail(): Promise<string> {\n  const systemName = DeviceInfo.getSystemName();\n  const systemVersion = DeviceInfo.getSystemVersion();\n\n  if (Platform.OS === 'android') {\n    try {\n      const apiLevel = await DeviceInfo.getApiLevel();\n      return `${systemName} ${systemVersion} (SDK ${apiLevel})`;\n    } catch (_error) {\n      return `${systemName} ${systemVersion}`;\n    }\n  }\n\n  return `${systemName} ${systemVersion}`;\n}\n\nasync function getDeviceOsBuildId(): Promise<string | undefined> {\n  try {\n    // RN device-info exposes a useful OS build id on both Android and iOS.\n    // Keep it omitted when unavailable instead of sending \"unknown\".\n    const buildId = await DeviceInfo.getBuildId();\n    return buildId && buildId !== 'unknown' ? buildId : undefined;\n  } catch (_error) {\n    return undefined;\n  }\n}\n\n/**\n * Session attributes without device props when async collection or DeviceInfo is unavailable.\n * No synchronous DeviceInfo reads — use {@link getSessionAttributes} or the package async `initializeFaro`.\n */\nexport function minimalSessionDeviceAttributes(): SessionAttributes {\n  const processInfo = getSessionProcessInfo();\n  return {\n    react_native_version: getReactNativeVersion(),\n    ...(processInfo == null ? {} : { process_name: processInfo.identifier }),\n  };\n}\n\n/**\n * Get all session attributes\n * These attributes are automatically included with every telemetry event\n *\n * Core session attributes:\n * - react_native_version (RN framework in the host app)\n * - process_name (Android process name or iOS bundle identifier)\n * - device_os, device_os_version, device_os_detail\n * - device_manufacturer, device_model, device_model_name\n * - device_brand, device_is_physical, device_id\n *\n * Additional monitoring attributes:\n * - device_type (mobile/tablet)\n * - device_memory_total, device_memory_used\n * - device_battery_level, device_is_charging, device_low_power_mode\n * - device_carrier\n */\nexport async function getSessionAttributes(): Promise<SessionAttributes> {\n  return (await collectMobileMeta()).sessionAttributes;\n}\n\nasync function collectMobileMeta(): Promise<PreloadedMobileMeta> {\n  try {\n    const [deviceOsDetail, deviceOsBuildId, installationId] = await Promise.all([\n      getDeviceOsDetail(),\n      getDeviceOsBuildId(),\n      getInstallationId(),\n    ]);\n\n    // Get synchronous device info\n    const systemName = DeviceInfo.getSystemName();\n    const systemVersion = DeviceInfo.getSystemVersion();\n    const manufacturer = DeviceInfo.getManufacturerSync();\n    const model = DeviceInfo.getModel();\n    const modelIdentifier = getStructuredDeviceModelIdentifier(model);\n    const deviceName = DeviceInfo.getDeviceNameSync();\n    const brand = DeviceInfo.getBrand();\n    const isEmulator = DeviceInfo.isEmulatorSync();\n    const isTablet = DeviceInfo.isTablet();\n    const deviceType = getMobileDeviceType(isTablet);\n\n    // Memory info\n    const totalMemory = DeviceInfo.getTotalMemorySync();\n    const usedMemory = DeviceInfo.getUsedMemorySync();\n\n    // Try to get async device info (battery, carrier)\n    let batteryLevel: string | undefined;\n    let isCharging: string | undefined;\n    let lowPowerMode: string | undefined;\n    let carrier: string | undefined;\n\n    try {\n      const battery = await DeviceInfo.getBatteryLevel();\n      if (battery >= 0) {\n        batteryLevel = String(Math.round(battery * 100));\n      }\n    } catch (_error) {\n      // Battery info not available\n    }\n\n    try {\n      isCharging = String(await DeviceInfo.isBatteryCharging());\n    } catch (_error) {\n      // Charging status not available\n    }\n\n    try {\n      if ('isPowerSaveMode' in DeviceInfo) {\n        lowPowerMode = String(\n          await (DeviceInfo as typeof DeviceInfo & { isPowerSaveMode: () => Promise<boolean> }).isPowerSaveMode()\n        );\n      }\n    } catch (_error) {\n      // Low power mode not available\n    }\n\n    try {\n      const carrierName = await DeviceInfo.getCarrier();\n      if (carrierName && carrierName !== 'unknown') {\n        carrier = carrierName;\n      }\n    } catch (_error) {\n      // Carrier not available\n    }\n\n    const attributes: SessionAttributes = {\n      ...minimalSessionDeviceAttributes(),\n      device_os: systemName,\n      device_os_version: systemVersion,\n      device_os_detail: deviceOsDetail,\n      device_manufacturer: manufacturer.toLowerCase(),\n      device_model: model,\n      device_model_name: deviceName,\n      device_brand: brand,\n      device_is_physical: String(!isEmulator),\n      ...(installationId ? { device_id: installationId } : {}),\n      ...(deviceType ? { device_type: deviceType } : {}),\n      device_memory_total: String(totalMemory),\n      device_memory_used: String(usedMemory),\n      device_battery_level: batteryLevel,\n      device_is_charging: isCharging,\n      device_low_power_mode: lowPowerMode,\n      device_carrier: carrier,\n    };\n    const appMeta = installationId ? { installationId } : {};\n    const structuredDeviceBrand = getStructuredDeviceBrand(model, brand);\n    const structuredDeviceManufacturer = getStructuredDeviceManufacturer(manufacturer);\n    const osMeta = {\n      ...(deviceOsBuildId ? { build_id: deviceOsBuildId } : {}),\n      detail: deviceOsDetail,\n      name: systemName,\n      version: systemVersion,\n    };\n\n    return {\n      sessionAttributes: attributes,\n      meta: {\n        app: appMeta,\n        device: {\n          brand: structuredDeviceBrand,\n          is_physical: !isEmulator,\n          manufacturer: structuredDeviceManufacturer,\n          ...(modelIdentifier ? { model_identifier: modelIdentifier } : {}),\n          model_name: model,\n          ...(deviceType ? { type: deviceType } : {}),\n        },\n        os: osMeta,\n      },\n    };\n  } catch (_error) {\n    const installationId = await getInstallationId();\n\n    return {\n      sessionAttributes: minimalSessionDeviceAttributes(),\n      meta: {\n        app: installationId ? { installationId } : {},\n      },\n    };\n  }\n}\n\n/**\n * Get structured mobile meta plus flat session attributes for async `initializeFaro`.\n */\nexport async function loadMobileMetaForInit(): Promise<PreloadedMobileMeta> {\n  return collectMobileMeta();\n}\n\n/**\n * Await full async session device attributes (battery, carrier, etc.), then fall back to\n * {@link minimalSessionDeviceAttributes} if anything throws. Used by async `initializeFaro`.\n */\nexport async function loadSessionDeviceAttributesForInit(): Promise<SessionAttributes> {\n  try {\n    return (await loadMobileMetaForInit()).sessionAttributes;\n  } catch {\n    return minimalSessionDeviceAttributes();\n  }\n}\n"]}

package/dist/cjs/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.js

@@ -1,48 +1,174 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MmkvPersistentSessionsManager = void 0;
 exports.resetMmkvSingletonForTests = resetMmkvSingletonForTests;
 var react_native_1 = require("react-native");
 var faro_core_1 = require("@grafana/faro-core");
-var throttle_1 = require("../../../utils/throttle");
+var sessionActivity_1 = require("../sessionActivity");
+var sessionProcess_1 = require("../sessionProcess");
+var persistentSessionRecord_1 = require("./persistentSessionRecord");
 var sessionConstants_1 = require("./sessionConstants");
 var sessionManagerUtils_1 = require("./sessionManagerUtils");
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function loadMmkvModule() {
+    try {
+        return require('react-native-mmkv');
+    }
+    catch (error) {
+        throw new Error("react-native-mmkv could not be loaded. Install it and rebuild the native project. ".concat(errorMessage(error)));
+    }
+}
+function mmkvConfiguration(mmkv, storageId, isIosExtension) {
+    var _a;
+    if (!isIosExtension) {
+        return { id: storageId };
+    }
+    if (typeof mmkv.createMMKV === 'function') {
+        return { id: storageId, mode: 'multi-process' };
+    }
+    var legacyMultiProcessMode = (_a = mmkv.Mode) === null || _a === void 0 ? void 0 : _a.MULTI_PROCESS;
+    if (typeof legacyMultiProcessMode !== 'number') {
+        throw new Error('Persisting sessions in an iOS extension requires react-native-mmkv v3 or newer.');
+    }
+    return { id: storageId, mode: legacyMultiProcessMode };
+}
 function createMmkvInstance() {
+    // Load MMKV before taking native ownership so a missing dependency cannot
+    // leave the process-wide claim occupied.
+    var mmkv = loadMmkvModule();
+    var processInfo = (0, sessionProcess_1.getSessionProcessInfo)();
+    var storageId = (0, sessionProcess_1.claimSessionPersistenceStorageId)();
+    if (storageId == null || processInfo == null) {
+        throw new Error('Native session-storage coordination is unavailable or already owned by another runtime. Rebuild the native app after upgrading Faro, or use sessionTracking.persistent=false in runtimes that cannot own storage.');
+    }
     try {
-        var MMKV = require('react-native-mmkv').MMKV;
-        return new MMKV({ id: 'grafana-faro-react-native-session' });
+        var configuration = mmkvConfiguration(mmkv, storageId, react_native_1.Platform.OS === 'ios' && !processInfo.isMain);
+        // react-native-mmkv v4 was rewritten to Nitro and removed the `new MMKV()`
+        // class constructor in favor of a `createMMKV()` factory (see the v4 upgrade
+        // guide). Support both so v2/v3 (class) and v4+ (factory) work.
+        if (typeof mmkv.createMMKV === 'function') {
+            return mmkv.createMMKV(configuration);
+        }
+        if (typeof mmkv.MMKV !== 'function') {
+            throw new Error('The installed react-native-mmkv package does not expose a supported storage API.');
+        }
+        return new mmkv.MMKV(configuration);
     }
-    catch (_a) {
-        throw new Error('sessionTracking.persistent is true but react-native-mmkv could not be loaded. Install it: yarn add react-native-mmkv, then rebuild native projects.');
+    catch (error) {
+        (0, sessionProcess_1.releaseSessionPersistenceOwnership)();
+        throw new Error("Session persistence could not be initialized. ".concat(errorMessage(error)));
     }
 }
+// undefined means MMKV has not been resolved; null means it is unavailable.
 var mmkvSingleton;
-function getMmkv() {
-    if (mmkvSingleton == null) {
+// undefined means storage has not been read, null means no persisted state is
+// available, and a session is the live value for this JavaScript runtime.
+var runtimeSession;
+function tryGetMmkv() {
+    var _a, _b;
+    if (mmkvSingleton !== undefined) {
+        return mmkvSingleton;
+    }
+    try {
         mmkvSingleton = createMmkvInstance();
     }
+    catch (error) {
+        mmkvSingleton = null;
+        (_b = (_a = faro_core_1.faro.unpatchedConsole) === null || _a === void 0 ? void 0 : _a.warn) === null || _b === void 0 ? void 0 : _b.call(_a, 'Session persistence is unavailable; using an in-memory session:', error);
+    }
     return mmkvSingleton;
 }
+function removeMmkvValue(mmkv, key) {
+    var compatibleMmkv = mmkv;
+    if (typeof compatibleMmkv.remove === 'function') {
+        compatibleMmkv.remove(key);
+        return;
+    }
+    if (typeof compatibleMmkv.delete === 'function') {
+        compatibleMmkv.delete(key);
+        return;
+    }
+    throw new Error('The installed react-native-mmkv version cannot remove stored values.');
+}
 /** @internal */
 function resetMmkvSingletonForTests() {
     mmkvSingleton = undefined;
+    runtimeSession = undefined;
 }
 /**
  * Persistent session storage backed by MMKV (synchronous reads/writes).
  * Used when `sessionTracking.persistent` is true.
  */
 var MmkvPersistentSessionsManager = /** @class */ (function () {
-    function MmkvPersistentSessionsManager() {
+    function MmkvPersistentSessionsManager(metas) {
+        if (metas === void 0) { metas = faro_core_1.faro.metas; }
         var _this = this;
         this.appStateSubscription = null;
-        this.metaUnsubscribe = null;
-        this.updateSession = (0, throttle_1.throttle)(function () { return _this.updateUserSession(); }, sessionConstants_1.STORAGE_UPDATE_DELAY);
+        this.activityWriteTimer = null;
+        this.hasPendingActivityWrite = false;
+        this.lastActivityWrite = 0;
+        this.wasBackgrounded = react_native_1.AppState.currentState === 'background';
+        this.metaUpdateHandler = null;
+        this.flushActivityWrite = function () {
+            if (_this.activityWriteTimer != null) {
+                clearTimeout(_this.activityWriteTimer);
+                _this.activityWriteTimer = null;
+            }
+            if (!_this.hasPendingActivityWrite) {
+                return;
+            }
+            var session = MmkvPersistentSessionsManager.fetchUserSession();
+            _this.hasPendingActivityWrite = false;
+            if (session == null) {
+                return;
+            }
+            MmkvPersistentSessionsManager.persistSession(session);
+            _this.lastActivityWrite = (0, faro_core_1.dateNow)();
+        };
+        this.recordUserSessionActivity = function (session) {
+            // Keep expiry checks exact in memory while limiting native storage writes.
+            MmkvPersistentSessionsManager.setRuntimeSession(session);
+            _this.hasPendingActivityWrite = true;
+            var elapsed = (0, faro_core_1.dateNow)() - _this.lastActivityWrite;
+            if (_this.lastActivityWrite === 0 || elapsed < 0 || elapsed >= sessionConstants_1.STORAGE_UPDATE_DELAY) {
+                _this.flushActivityWrite();
+                return;
+            }
+            if (_this.activityWriteTimer == null) {
+                _this.activityWriteTimer = setTimeout(_this.flushActivityWrite, sessionConstants_1.STORAGE_UPDATE_DELAY - elapsed);
+            }
+        };
         this.handleAppStateChange = function (nextAppState) {
-            if (nextAppState === 'active') {
-                _this.updateSession();
+            if (nextAppState === 'background') {
+                _this.wasBackgrounded = true;
+                _this.flushActivityWrite();
+                return;
+            }
+            if (nextAppState === 'active' && _this.wasBackgrounded) {
+                _this.wasBackgrounded = false;
+                _this.checkSession(sessionActivity_1.SessionActivityKind.Meaningful);
             }
         };
+        this.metas = metas;
         this.updateUserSession = (0, sessionManagerUtils_1.getUserSessionUpdater)({
+            fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,
+            recordUserSessionActivity: this.recordUserSessionActivity,
+            storeUserSession: MmkvPersistentSessionsManager.storeUserSession,
+        });
+        this.resetUserSession = (0, sessionManagerUtils_1.getUserSessionResetter)({
             fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,
             storeUserSession: MmkvPersistentSessionsManager.storeUserSession,
         });
@@ -50,17 +176,36 @@ var MmkvPersistentSessionsManager = /** @class */ (function () {
     }
     MmkvPersistentSessionsManager.removeUserSession = function () {
         var _a, _b;
+        runtimeSession = null;
+        var mmkv = tryGetMmkv();
+        if (mmkv == null) {
+            return;
+        }
         try {
-            getMmkv().remove(sessionConstants_1.STORAGE_KEY);
+            removeMmkvValue(mmkv, sessionConstants_1.STORAGE_KEY);
         }
         catch (error) {
             (_b = (_a = faro_core_1.faro.unpatchedConsole) === null || _a === void 0 ? void 0 : _a.warn) === null || _b === void 0 ? void 0 : _b.call(_a, 'Failed to remove session from MMKV:', error);
         }
     };
     MmkvPersistentSessionsManager.storeUserSession = function (session) {
+        MmkvPersistentSessionsManager.setRuntimeSession(session);
+        MmkvPersistentSessionsManager.persistSession(session);
+    };
+    MmkvPersistentSessionsManager.setRuntimeSession = function (session) {
+        runtimeSession =
+            session.sessionMeta == null
+                ? session
+                : __assign(__assign({}, session), { sessionMeta: (0, sessionManagerUtils_1.toStorableSessionMeta)(session.sessionMeta) });
+    };
+    MmkvPersistentSessionsManager.persistSession = function (session) {
         var _a, _b;
+        var mmkv = tryGetMmkv();
+        if (mmkv == null) {
+            return;
+        }
         try {
-            getMmkv().set(sessionConstants_1.STORAGE_KEY, (0, faro_core_1.stringifyExternalJson)(session));
+            mmkv.set(sessionConstants_1.STORAGE_KEY, (0, persistentSessionRecord_1.serializePersistentSession)(session));
         }
         catch (error) {
             (_b = (_a = faro_core_1.faro.unpatchedConsole) === null || _a === void 0 ? void 0 : _a.warn) === null || _b === void 0 ? void 0 : _b.call(_a, 'Failed to store session in MMKV:', error);
@@ -68,34 +213,64 @@ var MmkvPersistentSessionsManager = /** @class */ (function () {
     };
     MmkvPersistentSessionsManager.fetchUserSession = function () {
         var _a, _b;
+        if (runtimeSession !== undefined) {
+            return runtimeSession;
+        }
+        var mmkv = tryGetMmkv();
+        if (mmkv == null) {
+            runtimeSession = null;
+            return null;
+        }
         try {
-            var storedSession = getMmkv().getString(sessionConstants_1.STORAGE_KEY);
-            if (storedSession) {
-                return JSON.parse(storedSession);
+            var storedSession = mmkv.getString(sessionConstants_1.STORAGE_KEY);
+            if (storedSession == null) {
+                runtimeSession = null;
+                return null;
             }
-            return null;
+            runtimeSession = (0, persistentSessionRecord_1.parsePersistentSession)(storedSession);
+            if (runtimeSession == null) {
+                removeMmkvValue(mmkv, sessionConstants_1.STORAGE_KEY);
+            }
+            return runtimeSession;
         }
         catch (error) {
+            runtimeSession = null;
             (_b = (_a = faro_core_1.faro.unpatchedConsole) === null || _a === void 0 ? void 0 : _a.warn) === null || _b === void 0 ? void 0 : _b.call(_a, 'Failed to fetch session from MMKV:', error);
             return null;
         }
     };
+    MmkvPersistentSessionsManager.prototype.checkSession = function (activity, currentSession) {
+        return this.updateUserSession(activity, currentSession);
+    };
+    MmkvPersistentSessionsManager.prototype.resetSession = function () {
+        if (this.activityWriteTimer != null) {
+            clearTimeout(this.activityWriteTimer);
+            this.activityWriteTimer = null;
+        }
+        this.hasPendingActivityWrite = false;
+        var session = this.resetUserSession();
+        this.lastActivityWrite = (0, faro_core_1.dateNow)();
+        return session;
+    };
     MmkvPersistentSessionsManager.prototype.init = function () {
         this.appStateSubscription = react_native_1.AppState.addEventListener('change', this.handleAppStateChange);
-        var unsubscribe = faro_core_1.faro.metas.addListener((0, sessionManagerUtils_1.getSessionMetaUpdateHandler)({
+        var metaUpdateHandler = (0, sessionManagerUtils_1.getSessionMetaUpdateHandler)({
             fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,
             storeUserSession: MmkvPersistentSessionsManager.storeUserSession,
-        }));
-        this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : null;
+        });
+        this.metas.addListener(metaUpdateHandler);
+        this.metaUpdateHandler = metaUpdateHandler;
     };
     MmkvPersistentSessionsManager.prototype.unpatch = function () {
+        this.flushActivityWrite();
         if (this.appStateSubscription) {
             this.appStateSubscription.remove();
             this.appStateSubscription = null;
         }
-        if (this.metaUnsubscribe) {
-            this.metaUnsubscribe();
-            this.metaUnsubscribe = null;
+        var metaUpdateHandler = this.metaUpdateHandler;
+        this.metaUpdateHandler = null;
+        if (metaUpdateHandler) {
+            this.metas.removeListener(metaUpdateHandler);
         }
     };
     return MmkvPersistentSessionsManager;

package/dist/cjs/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"MmkvPersistentSessionsManager.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppState, type AppStateStatus } from 'react-native';\nimport type { MMKV } from 'react-native-mmkv';\n\nimport { faro, stringifyExternalJson } from '@grafana/faro-core';\n\nimport { throttle } from '../../../utils/throttle';\n\nimport { STORAGE_KEY, STORAGE_UPDATE_DELAY } from './sessionConstants';\nimport { getSessionMetaUpdateHandler, getUserSessionUpdater } from './sessionManagerUtils';\nimport type { FaroUserSession } from './types';\n\nfunction createMmkvInstance(): MMKV {\n  try {\n    const { MMKV } = require('react-native-mmkv');\n    return new MMKV({ id: 'grafana-faro-react-native-session' });\n  } catch {\n    throw new Error(\n      'sessionTracking.persistent is true but react-native-mmkv could not be loaded. Install it: yarn add react-native-mmkv, then rebuild native projects.'\n    );\n  }\n}\n\nlet mmkvSingleton: MMKV | undefined;\n\nfunction getMmkv(): MMKV {\n  if (mmkvSingleton == null) {\n    mmkvSingleton = createMmkvInstance();\n  }\n  return mmkvSingleton;\n}\n\n/** @internal */\nexport function resetMmkvSingletonForTests(): void {\n  mmkvSingleton = undefined;\n}\n\n/**\n * Persistent session storage backed by MMKV (synchronous reads/writes).\n * Used when `sessionTracking.persistent` is true.\n */\nexport class MmkvPersistentSessionsManager {\n  private updateUserSession: ReturnType<typeof getUserSessionUpdater>;\n  private appStateSubscription: ReturnType<typeof AppState.addEventListener> | null = null;\n  private metaUnsubscribe: (() => void) | null = null;\n\n  constructor() {\n    this.updateUserSession = getUserSessionUpdater({\n      fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,\n      storeUserSession: MmkvPersistentSessionsManager.storeUserSession,\n    });\n\n    this.init();\n  }\n\n  static removeUserSession(): void {\n    try {\n      getMmkv().remove(STORAGE_KEY);\n    } catch (error) {\n      faro.unpatchedConsole?.warn?.('Failed to remove session from MMKV:', error);\n    }\n  }\n\n  static storeUserSession(session: FaroUserSession): void {\n    try {\n      getMmkv().set(STORAGE_KEY, stringifyExternalJson(session));\n    } catch (error) {\n      faro.unpatchedConsole?.warn?.('Failed to store session in MMKV:', error);\n    }\n  }\n\n  static fetchUserSession(): FaroUserSession | null {\n    try {\n      const storedSession = getMmkv().getString(STORAGE_KEY);\n      if (storedSession) {\n        return JSON.parse(storedSession) as FaroUserSession;\n      }\n      return null;\n    } catch (error) {\n      faro.unpatchedConsole?.warn?.('Failed to fetch session from MMKV:', error);\n      return null;\n    }\n  }\n\n  updateSession = throttle(() => this.updateUserSession(), STORAGE_UPDATE_DELAY);\n\n  private handleAppStateChange = (nextAppState: AppStateStatus) => {\n    if (nextAppState === 'active') {\n      this.updateSession();\n    }\n  };\n\n  private init(): void {\n    this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);\n\n    const unsubscribe = faro.metas.addListener(\n      getSessionMetaUpdateHandler({\n        fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,\n        storeUserSession: MmkvPersistentSessionsManager.storeUserSession,\n      })\n    );\n    this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : null;\n  }\n\n  unpatch(): void {\n    if (this.appStateSubscription) {\n      this.appStateSubscription.remove();\n      this.appStateSubscription = null;\n    }\n\n    if (this.metaUnsubscribe) {\n      this.metaUnsubscribe();\n      this.metaUnsubscribe = null;\n    }\n  }\n}\n"]}
+{"version":3,"file":"MmkvPersistentSessionsManager.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppState, type AppStateStatus, Platform } from 'react-native';\nimport type { MMKV } from 'react-native-mmkv';\n\nimport { dateNow, faro } from '@grafana/faro-core';\nimport type { Metas } from '@grafana/faro-core';\n\nimport { SessionActivityKind } from '../sessionActivity';\nimport {\n  claimSessionPersistenceStorageId,\n  getSessionProcessInfo,\n  releaseSessionPersistenceOwnership,\n} from '../sessionProcess';\n\nimport { parsePersistentSession, serializePersistentSession } from './persistentSessionRecord';\nimport { STORAGE_KEY, STORAGE_UPDATE_DELAY } from './sessionConstants';\nimport {\n  getSessionMetaUpdateHandler,\n  getUserSessionResetter,\n  getUserSessionUpdater,\n  toStorableSessionMeta,\n} from './sessionManagerUtils';\nimport type { FaroUserSession } from './types';\n\ntype MmkvConfiguration = {\n  id: string;\n  mode?: number | 'multi-process';\n};\n\ntype MmkvModule = {\n  createMMKV?: (configuration: MmkvConfiguration) => MMKV;\n  MMKV?: new (configuration: MmkvConfiguration) => MMKV;\n  Mode?: { MULTI_PROCESS?: number };\n};\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction loadMmkvModule(): MmkvModule {\n  try {\n    return require('react-native-mmkv') as MmkvModule;\n  } catch (error) {\n    throw new Error(\n      `react-native-mmkv could not be loaded. Install it and rebuild the native project. ${errorMessage(error)}`\n    );\n  }\n}\n\nfunction mmkvConfiguration(mmkv: MmkvModule, storageId: string, isIosExtension: boolean): MmkvConfiguration {\n  if (!isIosExtension) {\n    return { id: storageId };\n  }\n\n  if (typeof mmkv.createMMKV === 'function') {\n    return { id: storageId, mode: 'multi-process' };\n  }\n\n  const legacyMultiProcessMode = mmkv.Mode?.MULTI_PROCESS;\n  if (typeof legacyMultiProcessMode !== 'number') {\n    throw new Error('Persisting sessions in an iOS extension requires react-native-mmkv v3 or newer.');\n  }\n\n  return { id: storageId, mode: legacyMultiProcessMode };\n}\n\nfunction createMmkvInstance(): MMKV {\n  // Load MMKV before taking native ownership so a missing dependency cannot\n  // leave the process-wide claim occupied.\n  const mmkv = loadMmkvModule();\n  const processInfo = getSessionProcessInfo();\n  const storageId = claimSessionPersistenceStorageId();\n  if (storageId == null || processInfo == null) {\n    throw new Error(\n      'Native session-storage coordination is unavailable or already owned by another runtime. Rebuild the native app after upgrading Faro, or use sessionTracking.persistent=false in runtimes that cannot own storage.'\n    );\n  }\n\n  try {\n    const configuration = mmkvConfiguration(mmkv, storageId, Platform.OS === 'ios' && !processInfo.isMain);\n    // react-native-mmkv v4 was rewritten to Nitro and removed the `new MMKV()`\n    // class constructor in favor of a `createMMKV()` factory (see the v4 upgrade\n    // guide). Support both so v2/v3 (class) and v4+ (factory) work.\n    if (typeof mmkv.createMMKV === 'function') {\n      return mmkv.createMMKV(configuration);\n    }\n    if (typeof mmkv.MMKV !== 'function') {\n      throw new Error('The installed react-native-mmkv package does not expose a supported storage API.');\n    }\n    return new mmkv.MMKV(configuration);\n  } catch (error) {\n    releaseSessionPersistenceOwnership();\n    throw new Error(`Session persistence could not be initialized. ${errorMessage(error)}`);\n  }\n}\n\n// undefined means MMKV has not been resolved; null means it is unavailable.\nlet mmkvSingleton: MMKV | null | undefined;\n// undefined means storage has not been read, null means no persisted state is\n// available, and a session is the live value for this JavaScript runtime.\nlet runtimeSession: FaroUserSession | null | undefined;\n\nfunction tryGetMmkv(): MMKV | null {\n  if (mmkvSingleton !== undefined) {\n    return mmkvSingleton;\n  }\n\n  try {\n    mmkvSingleton = createMmkvInstance();\n  } catch (error) {\n    mmkvSingleton = null;\n    faro.unpatchedConsole?.warn?.('Session persistence is unavailable; using an in-memory session:', error);\n  }\n\n  return mmkvSingleton;\n}\n\nfunction removeMmkvValue(mmkv: MMKV, key: string): void {\n  const compatibleMmkv = mmkv as MMKV & {\n    delete?: (storageKey: string) => void;\n    remove?: (storageKey: string) => void;\n  };\n\n  if (typeof compatibleMmkv.remove === 'function') {\n    compatibleMmkv.remove(key);\n    return;\n  }\n  if (typeof compatibleMmkv.delete === 'function') {\n    compatibleMmkv.delete(key);\n    return;\n  }\n\n  throw new Error('The installed react-native-mmkv version cannot remove stored values.');\n}\n\n/** @internal */\nexport function resetMmkvSingletonForTests(): void {\n  mmkvSingleton = undefined;\n  runtimeSession = undefined;\n}\n\n/**\n * Persistent session storage backed by MMKV (synchronous reads/writes).\n * Used when `sessionTracking.persistent` is true.\n */\nexport class MmkvPersistentSessionsManager {\n  private resetUserSession: ReturnType<typeof getUserSessionResetter>;\n  private updateUserSession: ReturnType<typeof getUserSessionUpdater>;\n  private appStateSubscription: ReturnType<typeof AppState.addEventListener> | null = null;\n  private activityWriteTimer: ReturnType<typeof setTimeout> | null = null;\n  private hasPendingActivityWrite = false;\n  private lastActivityWrite = 0;\n  private wasBackgrounded = AppState.currentState === 'background';\n  private metaUpdateHandler: ReturnType<typeof getSessionMetaUpdateHandler> | null = null;\n  private readonly metas: Metas;\n\n  constructor(metas: Metas = faro.metas) {\n    this.metas = metas;\n    this.updateUserSession = getUserSessionUpdater({\n      fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,\n      recordUserSessionActivity: this.recordUserSessionActivity,\n      storeUserSession: MmkvPersistentSessionsManager.storeUserSession,\n    });\n    this.resetUserSession = getUserSessionResetter({\n      fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,\n      storeUserSession: MmkvPersistentSessionsManager.storeUserSession,\n    });\n\n    this.init();\n  }\n\n  static removeUserSession(): void {\n    runtimeSession = null;\n    const mmkv = tryGetMmkv();\n    if (mmkv == null) {\n      return;\n    }\n    try {\n      removeMmkvValue(mmkv, STORAGE_KEY);\n    } catch (error) {\n      faro.unpatchedConsole?.warn?.('Failed to remove session from MMKV:', error);\n    }\n  }\n\n  static storeUserSession(session: FaroUserSession): void {\n    MmkvPersistentSessionsManager.setRuntimeSession(session);\n    MmkvPersistentSessionsManager.persistSession(session);\n  }\n\n  private static setRuntimeSession(session: FaroUserSession): void {\n    runtimeSession =\n      session.sessionMeta == null\n        ? session\n        : {\n            ...session,\n            sessionMeta: toStorableSessionMeta(session.sessionMeta),\n          };\n  }\n\n  private static persistSession(session: FaroUserSession): void {\n    const mmkv = tryGetMmkv();\n    if (mmkv == null) {\n      return;\n    }\n    try {\n      mmkv.set(STORAGE_KEY, serializePersistentSession(session));\n    } catch (error) {\n      faro.unpatchedConsole?.warn?.('Failed to store session in MMKV:', error);\n    }\n  }\n\n  static fetchUserSession(): FaroUserSession | null {\n    if (runtimeSession !== undefined) {\n      return runtimeSession;\n    }\n\n    const mmkv = tryGetMmkv();\n    if (mmkv == null) {\n      runtimeSession = null;\n      return null;\n    }\n\n    try {\n      const storedSession = mmkv.getString(STORAGE_KEY);\n      if (storedSession == null) {\n        runtimeSession = null;\n        return null;\n      }\n\n      runtimeSession = parsePersistentSession(storedSession);\n      if (runtimeSession == null) {\n        removeMmkvValue(mmkv, STORAGE_KEY);\n      }\n      return runtimeSession;\n    } catch (error) {\n      runtimeSession = null;\n      faro.unpatchedConsole?.warn?.('Failed to fetch session from MMKV:', error);\n      return null;\n    }\n  }\n\n  checkSession(activity: SessionActivityKind, currentSession?: FaroUserSession | null): FaroUserSession {\n    return this.updateUserSession(activity, currentSession);\n  }\n\n  resetSession(): FaroUserSession {\n    if (this.activityWriteTimer != null) {\n      clearTimeout(this.activityWriteTimer);\n      this.activityWriteTimer = null;\n    }\n    this.hasPendingActivityWrite = false;\n\n    const session = this.resetUserSession();\n    this.lastActivityWrite = dateNow();\n    return session;\n  }\n\n  private flushActivityWrite = (): void => {\n    if (this.activityWriteTimer != null) {\n      clearTimeout(this.activityWriteTimer);\n      this.activityWriteTimer = null;\n    }\n\n    if (!this.hasPendingActivityWrite) {\n      return;\n    }\n\n    const session = MmkvPersistentSessionsManager.fetchUserSession();\n    this.hasPendingActivityWrite = false;\n    if (session == null) {\n      return;\n    }\n\n    MmkvPersistentSessionsManager.persistSession(session);\n    this.lastActivityWrite = dateNow();\n  };\n\n  private recordUserSessionActivity = (session: FaroUserSession): void => {\n    // Keep expiry checks exact in memory while limiting native storage writes.\n    MmkvPersistentSessionsManager.setRuntimeSession(session);\n    this.hasPendingActivityWrite = true;\n\n    const elapsed = dateNow() - this.lastActivityWrite;\n    if (this.lastActivityWrite === 0 || elapsed < 0 || elapsed >= STORAGE_UPDATE_DELAY) {\n      this.flushActivityWrite();\n      return;\n    }\n\n    if (this.activityWriteTimer == null) {\n      this.activityWriteTimer = setTimeout(this.flushActivityWrite, STORAGE_UPDATE_DELAY - elapsed);\n    }\n  };\n\n  private handleAppStateChange = (nextAppState: AppStateStatus) => {\n    if (nextAppState === 'background') {\n      this.wasBackgrounded = true;\n      this.flushActivityWrite();\n      return;\n    }\n\n    if (nextAppState === 'active' && this.wasBackgrounded) {\n      this.wasBackgrounded = false;\n      this.checkSession(SessionActivityKind.Meaningful);\n    }\n  };\n\n  private init(): void {\n    this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);\n\n    const metaUpdateHandler = getSessionMetaUpdateHandler({\n      fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,\n      storeUserSession: MmkvPersistentSessionsManager.storeUserSession,\n    });\n    this.metas.addListener(metaUpdateHandler);\n    this.metaUpdateHandler = metaUpdateHandler;\n  }\n\n  unpatch(): void {\n    this.flushActivityWrite();\n\n    if (this.appStateSubscription) {\n      this.appStateSubscription.remove();\n      this.appStateSubscription = null;\n    }\n\n    const metaUpdateHandler = this.metaUpdateHandler;\n    this.metaUpdateHandler = null;\n    if (metaUpdateHandler) {\n      this.metas.removeListener(metaUpdateHandler);\n    }\n  }\n}\n"]}

package/dist/cjs/instrumentations/session/sessionManager/VolatileSessionManager.js

@@ -3,24 +3,34 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VolatileSessionsManager = void 0;
 var react_native_1 = require("react-native");
 var faro_core_1 = require("@grafana/faro-core");
-var throttle_1 = require("../../../utils/throttle");
-var sessionConstants_1 = require("./sessionConstants");
+var sessionActivity_1 = require("../sessionActivity");
 var sessionManagerUtils_1 = require("./sessionManagerUtils");
 var VolatileSessionsManager = /** @class */ (function () {
-    function VolatileSessionsManager() {
+    function VolatileSessionsManager(metas) {
+        if (metas === void 0) { metas = faro_core_1.faro.metas; }
         var _this = this;
         this.appStateSubscription = null;
-        this.metaUnsubscribe = null;
-        this.updateSession = (0, throttle_1.throttle)(function () { return _this.updateUserSession(); }, sessionConstants_1.STORAGE_UPDATE_DELAY);
+        this.wasBackgrounded = react_native_1.AppState.currentState === 'background';
+        this.metaUpdateHandler = null;
         this.handleAppStateChange = function (nextAppState) {
-            if (nextAppState === 'active') {
-                _this.updateSession();
+            if (nextAppState === 'background') {
+                _this.wasBackgrounded = true;
+                return;
+            }
+            if (nextAppState === 'active' && _this.wasBackgrounded) {
+                _this.wasBackgrounded = false;
+                _this.checkSession(sessionActivity_1.SessionActivityKind.Meaningful);
             }
         };
+        this.metas = metas;
         this.updateUserSession = (0, sessionManagerUtils_1.getUserSessionUpdater)({
             fetchUserSession: VolatileSessionsManager.fetchUserSession,
             storeUserSession: VolatileSessionsManager.storeUserSession,
         });
+        this.resetUserSession = (0, sessionManagerUtils_1.getUserSessionResetter)({
+            fetchUserSession: VolatileSessionsManager.fetchUserSession,
+            storeUserSession: VolatileSessionsManager.storeUserSession,
+        });
         this.init();
     }
     VolatileSessionsManager.removeUserSession = function () {
@@ -32,15 +42,22 @@ var VolatileSessionsManager = /** @class */ (function () {
     VolatileSessionsManager.fetchUserSession = function () {
         return VolatileSessionsManager.volatileStorage;
     };
+    VolatileSessionsManager.prototype.checkSession = function (activity, currentSession) {
+        return this.updateUserSession(activity, currentSession);
+    };
+    VolatileSessionsManager.prototype.resetSession = function () {
+        return this.resetUserSession();
+    };
     VolatileSessionsManager.prototype.init = function () {
         // Listen to app state changes (equivalent to visibilitychange in web)
         this.appStateSubscription = react_native_1.AppState.addEventListener('change', this.handleAppStateChange);
         // Users can call the setSession() method, so we need to sync this with the in-memory session
-        var unsubscribe = faro_core_1.faro.metas.addListener((0, sessionManagerUtils_1.getSessionMetaUpdateHandler)({
+        var metaUpdateHandler = (0, sessionManagerUtils_1.getSessionMetaUpdateHandler)({
             fetchUserSession: VolatileSessionsManager.fetchUserSession,
             storeUserSession: VolatileSessionsManager.storeUserSession,
-        }));
-        this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : null;
+        });
+        this.metas.addListener(metaUpdateHandler);
+        this.metaUpdateHandler = metaUpdateHandler;
     };
     /**
      * Clean up listeners when the instrumentation is unpatched
@@ -50,9 +67,10 @@ var VolatileSessionsManager = /** @class */ (function () {
             this.appStateSubscription.remove();
             this.appStateSubscription = null;
         }
-        if (this.metaUnsubscribe) {
-            this.metaUnsubscribe();
-            this.metaUnsubscribe = null;
+        var metaUpdateHandler = this.metaUpdateHandler;
+        this.metaUpdateHandler = null;
+        if (metaUpdateHandler) {
+            this.metas.removeListener(metaUpdateHandler);
         }
     };
     VolatileSessionsManager.volatileStorage = null;

package/dist/cjs/instrumentations/session/sessionManager/VolatileSessionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"VolatileSessionManager.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/VolatileSessionManager.ts"],"names":[],"mappings":";;;AAAA,6CAA6D;AAE7D,gDAA0C;AAE1C,oDAAmD;AAEnD,uDAA0D;AAC1D,6DAA2F;AAG3F;IAME;QAAA,iBAOC;QAVO,yBAAoB,GAAwD,IAAI,CAAC;QACjF,oBAAe,GAAwB,IAAI,CAAC;QAuBpD,kBAAa,GAAG,IAAA,mBAAQ,EAAC,cAAM,OAAA,KAAI,CAAC,iBAAiB,EAAE,EAAxB,CAAwB,EAAE,uCAAoB,CAAC,CAAC;QAEvE,yBAAoB,GAAG,UAAC,YAA4B;YAC1D,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC9B,KAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QA1BA,IAAI,CAAC,iBAAiB,GAAG,IAAA,2CAAqB,EAAC;YAC7C,gBAAgB,EAAE,uBAAuB,CAAC,gBAAgB;YAC1D,gBAAgB,EAAE,uBAAuB,CAAC,gBAAgB;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEM,yCAAiB,GAAxB;QACE,uBAAuB,CAAC,eAAe,GAAG,IAAI,CAAC;IACjD,CAAC;IAEM,wCAAgB,GAAvB,UAAwB,OAAwB;QAC9C,uBAAuB,CAAC,eAAe,GAAG,OAAO,CAAC;IACpD,CAAC;IAEM,wCAAgB,GAAvB;QACE,OAAO,uBAAuB,CAAC,eAAe,CAAC;IACjD,CAAC;IAUO,sCAAI,GAAZ;QACE,sEAAsE;QACtE,IAAI,CAAC,oBAAoB,GAAG,uBAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAE3F,6FAA6F;QAC7F,IAAM,WAAW,GAAG,gBAAI,CAAC,KAAK,CAAC,WAAW,CACxC,IAAA,iDAA2B,EAAC;YAC1B,gBAAgB,EAAE,uBAAuB,CAAC,gBAAgB;YAC1D,gBAAgB,EAAE,uBAAuB,CAAC,gBAAgB;SAC3D,CAAC,CACH,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,yCAAO,GAAP;QACE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IA7Dc,uCAAe,GAA2B,IAAI,AAA/B,CAAgC;IA8DhE,8BAAC;CAAA,AA/DD,IA+DC;AA/DY,0DAAuB","sourcesContent":["import { AppState, type AppStateStatus } from 'react-native';\n\nimport { faro } from '@grafana/faro-core';\n\nimport { throttle } from '../../../utils/throttle';\n\nimport { STORAGE_UPDATE_DELAY } from './sessionConstants';\nimport { getSessionMetaUpdateHandler, getUserSessionUpdater } from './sessionManagerUtils';\nimport type { FaroUserSession } from './types';\n\nexport class VolatileSessionsManager {\n  private static volatileStorage: FaroUserSession | null = null;\n  private updateUserSession: ReturnType<typeof getUserSessionUpdater>;\n  private appStateSubscription: ReturnType<typeof AppState.addEventListener> | null = null;\n  private metaUnsubscribe: (() => void) | null = null;\n\n  constructor() {\n    this.updateUserSession = getUserSessionUpdater({\n      fetchUserSession: VolatileSessionsManager.fetchUserSession,\n      storeUserSession: VolatileSessionsManager.storeUserSession,\n    });\n\n    this.init();\n  }\n\n  static removeUserSession(): void {\n    VolatileSessionsManager.volatileStorage = null;\n  }\n\n  static storeUserSession(session: FaroUserSession): void {\n    VolatileSessionsManager.volatileStorage = session;\n  }\n\n  static fetchUserSession(): FaroUserSession | null {\n    return VolatileSessionsManager.volatileStorage;\n  }\n\n  updateSession = throttle(() => this.updateUserSession(), STORAGE_UPDATE_DELAY);\n\n  private handleAppStateChange = (nextAppState: AppStateStatus) => {\n    if (nextAppState === 'active') {\n      this.updateSession();\n    }\n  };\n\n  private init(): void {\n    // Listen to app state changes (equivalent to visibilitychange in web)\n    this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);\n\n    // Users can call the setSession() method, so we need to sync this with the in-memory session\n    const unsubscribe = faro.metas.addListener(\n      getSessionMetaUpdateHandler({\n        fetchUserSession: VolatileSessionsManager.fetchUserSession,\n        storeUserSession: VolatileSessionsManager.storeUserSession,\n      })\n    );\n    this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : null;\n  }\n\n  /**\n   * Clean up listeners when the instrumentation is unpatched\n   */\n  unpatch(): void {\n    if (this.appStateSubscription) {\n      this.appStateSubscription.remove();\n      this.appStateSubscription = null;\n    }\n\n    if (this.metaUnsubscribe) {\n      this.metaUnsubscribe();\n      this.metaUnsubscribe = null;\n    }\n  }\n}\n"]}
+{"version":3,"file":"VolatileSessionManager.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/VolatileSessionManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppState, type AppStateStatus } from 'react-native';\n\nimport { faro } from '@grafana/faro-core';\nimport type { Metas } from '@grafana/faro-core';\n\nimport { SessionActivityKind } from '../sessionActivity';\n\nimport { getSessionMetaUpdateHandler, getUserSessionResetter, getUserSessionUpdater } from './sessionManagerUtils';\nimport type { FaroUserSession } from './types';\n\nexport class VolatileSessionsManager {\n  private static volatileStorage: FaroUserSession | null = null;\n  private resetUserSession: ReturnType<typeof getUserSessionResetter>;\n  private updateUserSession: ReturnType<typeof getUserSessionUpdater>;\n  private appStateSubscription: ReturnType<typeof AppState.addEventListener> | null = null;\n  private wasBackgrounded = AppState.currentState === 'background';\n  private metaUpdateHandler: ReturnType<typeof getSessionMetaUpdateHandler> | null = null;\n  private readonly metas: Metas;\n\n  constructor(metas: Metas = faro.metas) {\n    this.metas = metas;\n    this.updateUserSession = getUserSessionUpdater({\n      fetchUserSession: VolatileSessionsManager.fetchUserSession,\n      storeUserSession: VolatileSessionsManager.storeUserSession,\n    });\n    this.resetUserSession = getUserSessionResetter({\n      fetchUserSession: VolatileSessionsManager.fetchUserSession,\n      storeUserSession: VolatileSessionsManager.storeUserSession,\n    });\n\n    this.init();\n  }\n\n  static removeUserSession(): void {\n    VolatileSessionsManager.volatileStorage = null;\n  }\n\n  static storeUserSession(session: FaroUserSession): void {\n    VolatileSessionsManager.volatileStorage = session;\n  }\n\n  static fetchUserSession(): FaroUserSession | null {\n    return VolatileSessionsManager.volatileStorage;\n  }\n\n  checkSession(activity: SessionActivityKind, currentSession?: FaroUserSession | null): FaroUserSession {\n    return this.updateUserSession(activity, currentSession);\n  }\n\n  resetSession(): FaroUserSession {\n    return this.resetUserSession();\n  }\n\n  private handleAppStateChange = (nextAppState: AppStateStatus) => {\n    if (nextAppState === 'background') {\n      this.wasBackgrounded = true;\n      return;\n    }\n\n    if (nextAppState === 'active' && this.wasBackgrounded) {\n      this.wasBackgrounded = false;\n      this.checkSession(SessionActivityKind.Meaningful);\n    }\n  };\n\n  private init(): void {\n    // Listen to app state changes (equivalent to visibilitychange in web)\n    this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);\n\n    // Users can call the setSession() method, so we need to sync this with the in-memory session\n    const metaUpdateHandler = getSessionMetaUpdateHandler({\n      fetchUserSession: VolatileSessionsManager.fetchUserSession,\n      storeUserSession: VolatileSessionsManager.storeUserSession,\n    });\n    this.metas.addListener(metaUpdateHandler);\n    this.metaUpdateHandler = metaUpdateHandler;\n  }\n\n  /**\n   * Clean up listeners when the instrumentation is unpatched\n   */\n  unpatch(): void {\n    if (this.appStateSubscription) {\n      this.appStateSubscription.remove();\n      this.appStateSubscription = null;\n    }\n\n    const metaUpdateHandler = this.metaUpdateHandler;\n    this.metaUpdateHandler = null;\n    if (metaUpdateHandler) {\n      this.metas.removeListener(metaUpdateHandler);\n    }\n  }\n}\n"]}

package/dist/cjs/instrumentations/session/sessionManager/persistentSessionRecord.js

@@ -0,0 +1,72 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERSISTED_SESSION_SCHEMA_VERSION = void 0;
+exports.serializePersistentSession = serializePersistentSession;
+exports.parsePersistentSession = parsePersistentSession;
+exports.PERSISTED_SESSION_SCHEMA_VERSION = 1;
+function isRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isValidTimestamp(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+function serializePersistentSession(session) {
+    var _a, _b;
+    var previousSession = (_b = (_a = session.sessionMeta) === null || _a === void 0 ? void 0 : _a.attributes) === null || _b === void 0 ? void 0 : _b['previousSession'];
+    var record = {
+        schemaVersion: exports.PERSISTED_SESSION_SCHEMA_VERSION,
+        currentSessionId: session.sessionId,
+        previousSessionId: isNonEmptyString(previousSession) ? previousSession : null,
+        startedAt: session.started,
+        // Preserve the record invariant if the device clock moves backwards after
+        // the session starts.
+        lastActivityAt: Math.max(session.started, session.lastActivity),
+        isSampled: session.isSampled,
+    };
+    return JSON.stringify(record);
+}
+function parsePersistentSession(serialized) {
+    var value;
+    try {
+        value = JSON.parse(serialized);
+    }
+    catch (_a) {
+        return null;
+    }
+    if (!isRecord(value) ||
+        value['schemaVersion'] !== exports.PERSISTED_SESSION_SCHEMA_VERSION ||
+        !isNonEmptyString(value['currentSessionId']) ||
+        !(value['previousSessionId'] === null || isNonEmptyString(value['previousSessionId'])) ||
+        !isValidTimestamp(value['startedAt']) ||
+        !isValidTimestamp(value['lastActivityAt']) ||
+        value['lastActivityAt'] < value['startedAt'] ||
+        typeof value['isSampled'] !== 'boolean') {
+        return null;
+    }
+    var previousSessionId = value['previousSessionId'];
+    return {
+        sessionId: value['currentSessionId'],
+        started: value['startedAt'],
+        lastActivity: value['lastActivityAt'],
+        isSampled: value['isSampled'],
+        sessionMeta: {
+            id: value['currentSessionId'],
+            attributes: __assign({ isSampled: value['isSampled'].toString() }, (previousSessionId == null ? {} : { previousSession: previousSessionId })),
+        },
+    };
+}
+//# sourceMappingURL=persistentSessionRecord.js.map