@grafana/faro-react-native 1.0.0-alpha.1 → 1.0.0

package/dist/esm/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 { VERSION } from '@grafana/faro-core';\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 */\nexport interface SessionAttributes {\n  /** SDK version (e.g., \"2.0.2\") */\n  faro_sdk_version: string;\n\n  /** React Native version (e.g., \"0.75.1\") */\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\") */\n  device_manufacturer: string;\n\n  /** Raw model identifier (e.g., \"iPhone16,1\", \"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 (e.g., \"iPhone\", \"samsung\") */\n  device_brand: string;\n\n  /** Whether device is physical or emulator (\"true\" or \"false\") */\n  device_is_physical: string;\n\n  /** Unique device ID (UUID) */\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\n/**\n * Get React Native version from Platform\n * Returns \"unknown\" if not available\n */\nfunction getReactNativeVersion(): string {\n  try {\n    // Platform.constants.reactNativeVersion is an object like { major: 0, minor: 75, patch: 1 }\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\n/**\n * Get device ID using react-native-device-info\n * Returns unique device identifier or 'unknown' on error\n */\nasync function getDeviceId(): Promise<string> {\n  try {\n    // getUniqueId returns a UUID that persists across app installations\n    return await DeviceInfo.getUniqueId();\n  } catch (_error) {\n    return 'unknown';\n  }\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\n/**\n * Get all session attributes\n * These attributes are automatically included with every telemetry event\n *\n * Core attributes matching Flutter SDK:\n * - faro_sdk_version, react_native_version\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  try {\n    // Get device ID asynchronously\n    const deviceId = await getDeviceId();\n    const deviceOsDetail = await getDeviceOsDetail();\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 deviceName = DeviceInfo.getDeviceNameSync();\n    const brand = DeviceInfo.getBrand();\n    const isEmulator = DeviceInfo.isEmulatorSync();\n    const isTablet = DeviceInfo.isTablet();\n\n    // Memory info\n    const totalMemory = DeviceInfo.getTotalMemorySync();\n    const usedMemory = DeviceInfo.getUsedMemorySync();\n\n    // React Native version (equivalent to dart_version in Flutter)\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      faro_sdk_version: VERSION,\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      device_id: deviceId,\n      device_type: isTablet ? 'tablet' : 'mobile',\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\n    return attributes;\n  } catch (_error) {\n    // If anything fails, return minimal attributes\n    return {\n      faro_sdk_version: VERSION,\n      react_native_version: getReactNativeVersion(),\n      device_os: Platform.OS === 'ios' ? 'iOS' : 'Android',\n      device_os_version: 'unknown',\n      device_os_detail: 'unknown',\n      device_manufacturer: 'unknown',\n      device_model: 'unknown',\n      device_model_name: 'unknown',\n      device_brand: 'unknown',\n      device_is_physical: 'true',\n      device_id: 'unknown',\n      device_type: 'mobile',\n      device_memory_total: '0',\n      device_memory_used: '0',\n    };\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\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\") */\n  device_manufacturer?: string;\n\n  /** Raw model identifier (e.g., \"iPhone16,1\", \"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 (e.g., \"iPhone\", \"samsung\") */\n  device_brand?: string;\n\n  /** Whether device is physical or emulator (\"true\" or \"false\") */\n  device_is_physical?: string;\n\n  /** Unique device ID (UUID) */\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\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\n/**\n * Get device ID using react-native-device-info\n * Returns unique device identifier or 'unknown' on error\n */\nasync function getDeviceId(): Promise<string> {\n  try {\n    // getUniqueId returns a UUID that persists across app installations\n    return await DeviceInfo.getUniqueId();\n  } catch (_error) {\n    return 'unknown';\n  }\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\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  try {\n    // Get device ID asynchronously\n    const deviceId = await getDeviceId();\n    const deviceOsDetail = await getDeviceOsDetail();\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 deviceName = DeviceInfo.getDeviceNameSync();\n    const brand = DeviceInfo.getBrand();\n    const isEmulator = DeviceInfo.isEmulatorSync();\n    const isTablet = DeviceInfo.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      device_id: deviceId,\n      device_type: isTablet ? 'tablet' : 'mobile',\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\n    return attributes;\n  } catch (_error) {\n    return minimalSessionDeviceAttributes();\n  }\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 getSessionAttributes();\n  } catch {\n    return minimalSessionDeviceAttributes();\n  }\n}\n"]}

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

@@ -0,0 +1,97 @@
+import { AppState } from 'react-native';
+import { faro, stringifyExternalJson } from '@grafana/faro-core';
+import { throttle } from '../../../utils/throttle';
+import { STORAGE_KEY, STORAGE_UPDATE_DELAY } from './sessionConstants';
+import { getSessionMetaUpdateHandler, getUserSessionUpdater } from './sessionManagerUtils';
+function createMmkvInstance() {
+    try {
+        const { MMKV } = require('react-native-mmkv');
+        return new MMKV({ id: 'grafana-faro-react-native-session' });
+    }
+    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.');
+    }
+}
+let mmkvSingleton;
+function getMmkv() {
+    if (mmkvSingleton == null) {
+        mmkvSingleton = createMmkvInstance();
+    }
+    return mmkvSingleton;
+}
+/** @internal */
+export function resetMmkvSingletonForTests() {
+    mmkvSingleton = undefined;
+}
+/**
+ * Persistent session storage backed by MMKV (synchronous reads/writes).
+ * Used when `sessionTracking.persistent` is true.
+ */
+export class MmkvPersistentSessionsManager {
+    constructor() {
+        this.appStateSubscription = null;
+        this.metaUnsubscribe = null;
+        this.updateSession = throttle(() => this.updateUserSession(), STORAGE_UPDATE_DELAY);
+        this.handleAppStateChange = (nextAppState) => {
+            if (nextAppState === 'active') {
+                this.updateSession();
+            }
+        };
+        this.updateUserSession = getUserSessionUpdater({
+            fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,
+            storeUserSession: MmkvPersistentSessionsManager.storeUserSession,
+        });
+        this.init();
+    }
+    static removeUserSession() {
+        var _a, _b;
+        try {
+            getMmkv().remove(STORAGE_KEY);
+        }
+        catch (error) {
+            (_b = (_a = 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);
+        }
+    }
+    static storeUserSession(session) {
+        var _a, _b;
+        try {
+            getMmkv().set(STORAGE_KEY, stringifyExternalJson(session));
+        }
+        catch (error) {
+            (_b = (_a = 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);
+        }
+    }
+    static fetchUserSession() {
+        var _a, _b;
+        try {
+            const storedSession = getMmkv().getString(STORAGE_KEY);
+            if (storedSession) {
+                return JSON.parse(storedSession);
+            }
+            return null;
+        }
+        catch (error) {
+            (_b = (_a = 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;
+        }
+    }
+    init() {
+        this.appStateSubscription = AppState.addEventListener('change', this.handleAppStateChange);
+        const unsubscribe = faro.metas.addListener(getSessionMetaUpdateHandler({
+            fetchUserSession: MmkvPersistentSessionsManager.fetchUserSession,
+            storeUserSession: MmkvPersistentSessionsManager.storeUserSession,
+        }));
+        this.metaUnsubscribe = typeof unsubscribe === 'function' ? unsubscribe : null;
+    }
+    unpatch() {
+        if (this.appStateSubscription) {
+            this.appStateSubscription.remove();
+            this.appStateSubscription = null;
+        }
+        if (this.metaUnsubscribe) {
+            this.metaUnsubscribe();
+            this.metaUnsubscribe = null;
+        }
+    }
+}
+//# sourceMappingURL=MmkvPersistentSessionsManager.js.map

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

@@ -0,0 +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"]}

package/dist/esm/instrumentations/session/sessionManager/getSessionManagerByConfig.js

@@ -1,6 +1,9 @@
-import { PersistentSessionsManager } from './PersistentSessionsManager';
+import { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';
 import { VolatileSessionsManager } from './VolatileSessionManager';
 export function getSessionManagerByConfig(sessionTrackingConfig) {
-    return sessionTrackingConfig.persistent ? PersistentSessionsManager : VolatileSessionsManager;
+    if (!sessionTrackingConfig.persistent) {
+        return VolatileSessionsManager;
+    }
+    return MmkvPersistentSessionsManager;
 }
 //# sourceMappingURL=getSessionManagerByConfig.js.map

package/dist/esm/instrumentations/session/sessionManager/getSessionManagerByConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSessionManagerByConfig.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/getSessionManagerByConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,UAAU,yBAAyB,CAAC,qBAA0D;IAClG,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,uBAAuB,CAAC;AAChG,CAAC","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport { PersistentSessionsManager } from './PersistentSessionsManager';\nimport type { SessionManager } from './types';\nimport { VolatileSessionsManager } from './VolatileSessionManager';\n\nexport function getSessionManagerByConfig(sessionTrackingConfig: Required<Config>['sessionTracking']): SessionManager {\n  return sessionTrackingConfig.persistent ? PersistentSessionsManager : VolatileSessionsManager;\n}\n"]}
+{"version":3,"file":"getSessionManagerByConfig.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/getSessionManagerByConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,UAAU,yBAAyB,CAAC,qBAA0D;IAClG,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,CAAC;QACtC,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,6BAA6B,CAAC;AACvC,CAAC","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';\nimport type { SessionManager } from './types';\nimport { VolatileSessionsManager } from './VolatileSessionManager';\n\nexport function getSessionManagerByConfig(sessionTrackingConfig: Required<Config>['sessionTracking']): SessionManager {\n  if (!sessionTrackingConfig.persistent) {\n    return VolatileSessionsManager;\n  }\n\n  return MmkvPersistentSessionsManager;\n}\n"]}

package/dist/esm/instrumentations/session/sessionManager/index.js

@@ -1,5 +1,5 @@
 export { getSessionManagerByConfig } from './getSessionManagerByConfig';
-export { PersistentSessionsManager } from './PersistentSessionsManager';
+export { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';
 export { isSampled } from './sampling';
 export * from './sessionConstants';
 export * from './sessionManagerUtils';

package/dist/esm/instrumentations/session/sessionManager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { getSessionManagerByConfig } from './getSessionManagerByConfig';\nexport { PersistentSessionsManager } from './PersistentSessionsManager';\nexport { isSampled } from './sampling';\nexport * from './sessionConstants';\nexport * from './sessionManagerUtils';\nexport * from './types';\nexport { VolatileSessionsManager } from './VolatileSessionManager';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { getSessionManagerByConfig } from './getSessionManagerByConfig';\nexport { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';\nexport { isSampled } from './sampling';\nexport * from './sessionConstants';\nexport * from './sessionManagerUtils';\nexport * from './types';\nexport { VolatileSessionsManager } from './VolatileSessionManager';\n"]}

package/dist/esm/instrumentations/session/sessionManager/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { MetaSession } from '@grafana/faro-core';\n\nimport type { PersistentSessionsManager } from './PersistentSessionsManager';\nimport type { VolatileSessionsManager } from './VolatileSessionManager';\n\nexport interface FaroUserSession {\n  sessionId: string;\n  lastActivity: number;\n  started: number;\n  isSampled: boolean;\n  sessionMeta?: MetaSession;\n}\n\nexport type SessionManager = typeof VolatileSessionsManager | typeof PersistentSessionsManager;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/instrumentations/session/sessionManager/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { MetaSession } from '@grafana/faro-core';\n\nimport type { MmkvPersistentSessionsManager } from './MmkvPersistentSessionsManager';\nimport type { VolatileSessionsManager } from './VolatileSessionManager';\n\nexport interface FaroUserSession {\n  sessionId: string;\n  lastActivity: number;\n  started: number;\n  isSampled: boolean;\n  sessionMeta?: MetaSession;\n}\n\nexport type SessionManager = typeof VolatileSessionsManager | typeof MmkvPersistentSessionsManager;\n"]}

package/dist/esm/internalLogger/index.js

@@ -0,0 +1,35 @@
+/**
+ * Internal logger levels - copied from @grafana/faro-core to avoid bundling web code
+ * Keep in sync with @grafana/faro-core's InternalLoggerLevel
+ */
+export var InternalLoggerLevel;
+(function (InternalLoggerLevel) {
+    InternalLoggerLevel[InternalLoggerLevel["OFF"] = 0] = "OFF";
+    InternalLoggerLevel[InternalLoggerLevel["ERROR"] = 1] = "ERROR";
+    InternalLoggerLevel[InternalLoggerLevel["WARN"] = 2] = "WARN";
+    InternalLoggerLevel[InternalLoggerLevel["INFO"] = 3] = "INFO";
+    InternalLoggerLevel[InternalLoggerLevel["VERBOSE"] = 4] = "VERBOSE";
+})(InternalLoggerLevel || (InternalLoggerLevel = {}));
+/**
+ * Log levels for console/logging - copied from @grafana/faro-core to avoid bundling web code
+ * Keep in sync with @grafana/faro-core's LogLevel
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["TRACE"] = "trace";
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["LOG"] = "log";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+export const defaultLogLevel = LogLevel.LOG;
+export const allLogLevels = [
+    LogLevel.TRACE,
+    LogLevel.DEBUG,
+    LogLevel.INFO,
+    LogLevel.LOG,
+    LogLevel.WARN,
+    LogLevel.ERROR,
+];
+//# sourceMappingURL=index.js.map

package/dist/esm/internalLogger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internalLogger/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,2DAAO,CAAA;IACP,+DAAS,CAAA;IACT,6DAAQ,CAAA;IACR,6DAAQ,CAAA;IACR,mEAAW,CAAA;AACb,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,uBAAW,CAAA;IACX,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAsC;IAC7D,QAAQ,CAAC,KAAK;IACd,QAAQ,CAAC,KAAK;IACd,QAAQ,CAAC,IAAI;IACb,QAAQ,CAAC,GAAG;IACZ,QAAQ,CAAC,IAAI;IACb,QAAQ,CAAC,KAAK;CACN,CAAC","sourcesContent":["/**\n * Internal logger levels - copied from @grafana/faro-core to avoid bundling web code\n * Keep in sync with @grafana/faro-core's InternalLoggerLevel\n */\nexport enum InternalLoggerLevel {\n  OFF = 0,\n  ERROR = 1,\n  WARN = 2,\n  INFO = 3,\n  VERBOSE = 4,\n}\n\n/**\n * Log levels for console/logging - copied from @grafana/faro-core to avoid bundling web code\n * Keep in sync with @grafana/faro-core's LogLevel\n */\nexport enum LogLevel {\n  TRACE = 'trace',\n  DEBUG = 'debug',\n  INFO = 'info',\n  LOG = 'log',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\nexport const defaultLogLevel = LogLevel.LOG;\nexport const allLogLevels: ReadonlyArray<Readonly<LogLevel>> = [\n  LogLevel.TRACE,\n  LogLevel.DEBUG,\n  LogLevel.INFO,\n  LogLevel.LOG,\n  LogLevel.WARN,\n  LogLevel.ERROR,\n] as const;\n"]}

package/dist/esm/metas/sdk.js

@@ -1,17 +1,22 @@
-import { faro, VERSION } from '@grafana/faro-core';
+import { VERSION } from '@grafana/faro-core';
+import { FARO_REACT_NATIVE_NPM_NAME, FARO_REACT_NATIVE_NPM_VERSION } from '../generated/faroRNPackageMeta';
 /**
- * SDK meta for React Native
- * Provides information about the Faro SDK and its integrations
+ * SDK meta for React Native.
+ * - `sdk.version`: `@grafana/faro-core` release (same as Faro Web SDK).
+ * - `sdk.name`: integration id (`faro-web` / `faro-react-native`).
+ * - `sdk.integrations`: published `@grafana/faro-react-native` npm name and semver for this build.
  */
 export const getSdkMeta = () => {
     return () => ({
         sdk: {
-            name: '@grafana/faro-react-native',
+            name: 'faro-react-native',
             version: VERSION,
-            integrations: faro.config.instrumentations.map((instrumentation) => ({
-                name: instrumentation.name,
-                version: instrumentation.version,
-            })),
+            integrations: [
+                {
+                    name: FARO_REACT_NATIVE_NPM_NAME,
+                    version: FARO_REACT_NATIVE_NPM_VERSION,
+                },
+            ],
         },
     });
 };

package/dist/esm/metas/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/metas/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgC,EAAE;IAC1D,OAAO,GAAG,EAAE,CAAC,CAAC;QACZ,GAAG,EAAE;YACH,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,eAAkD,EAAE,EAAE,CAAC,CAAC;gBACtG,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,OAAO,EAAE,eAAe,CAAC,OAAO;aACjC,CAAC,CAAC;SACJ;KACF,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { faro, VERSION } from '@grafana/faro-core';\nimport type { Meta, MetaItem } from '@grafana/faro-core';\n\n/**\n * SDK meta for React Native\n * Provides information about the Faro SDK and its integrations\n */\nexport const getSdkMeta = (): MetaItem<Pick<Meta, 'sdk'>> => {\n  return () => ({\n    sdk: {\n      name: '@grafana/faro-react-native',\n      version: VERSION,\n      integrations: faro.config.instrumentations.map((instrumentation: { name: string; version: string }) => ({\n        name: instrumentation.name,\n        version: instrumentation.version,\n      })),\n    },\n  });\n};\n"]}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/metas/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE3G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgC,EAAE;IAC1D,OAAO,GAAG,EAAE,CAAC,CAAC;QACZ,GAAG,EAAE;YACH,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE;gBACZ;oBACE,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,6BAA6B;iBACvC;aACF;SACF;KACF,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { VERSION } from '@grafana/faro-core';\nimport type { Meta, MetaItem } from '@grafana/faro-core';\n\nimport { FARO_REACT_NATIVE_NPM_NAME, FARO_REACT_NATIVE_NPM_VERSION } from '../generated/faroRNPackageMeta';\n\n/**\n * SDK meta for React Native.\n * - `sdk.version`: `@grafana/faro-core` release (same as Faro Web SDK).\n * - `sdk.name`: integration id (`faro-web` / `faro-react-native`).\n * - `sdk.integrations`: published `@grafana/faro-react-native` npm name and semver for this build.\n */\nexport const getSdkMeta = (): MetaItem<Pick<Meta, 'sdk'>> => {\n  return () => ({\n    sdk: {\n      name: 'faro-react-native',\n      version: VERSION,\n      integrations: [\n        {\n          name: FARO_REACT_NATIVE_NPM_NAME,\n          version: FARO_REACT_NATIVE_NPM_VERSION,\n        },\n      ],\n    },\n  });\n};\n"]}

package/dist/esm/testUtils/mockFaroReactNativeTracing.js

@@ -0,0 +1,14 @@
+/**
+ * Jest stub for optional peer `@grafana/faro-react-native-tracing`.
+ * Mapped via moduleNameMapper so tests run without installing the tracing workspace package.
+ */
+import { BaseInstrumentation, VERSION } from '@grafana/faro-core';
+export class TracingInstrumentation extends BaseInstrumentation {
+    constructor() {
+        super(...arguments);
+        this.name = '@grafana/faro-react-native-tracing';
+        this.version = VERSION;
+    }
+    initialize() { }
+}
+//# sourceMappingURL=mockFaroReactNativeTracing.js.map

package/dist/esm/testUtils/mockFaroReactNativeTracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockFaroReactNativeTracing.js","sourceRoot":"","sources":["../../../src/testUtils/mockFaroReactNativeTracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAA/D;;QACW,SAAI,GAAG,oCAAoC,CAAC;QAC5C,YAAO,GAAG,OAAO,CAAC;IAG7B,CAAC;IADC,UAAU,KAAU,CAAC;CACtB","sourcesContent":["/**\n * Jest stub for optional peer `@grafana/faro-react-native-tracing`.\n * Mapped via moduleNameMapper so tests run without installing the tracing workspace package.\n */\nimport { BaseInstrumentation, VERSION } from '@grafana/faro-core';\n\nexport class TracingInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native-tracing';\n  readonly version = VERSION;\n\n  initialize(): void {}\n}\n"]}

package/dist/types/config/makeRNConfig.d.ts

@@ -1,9 +1,11 @@
-import type { Config } from '@grafana/faro-core';
-import type { ReactNativeConfig } from './types';
+import type { SessionAttributes } from '../instrumentations/session/sessionAttributes';
+import type { ReactNativeConfig, ReactNativeFullConfig } from './types';
 /**
  * Creates a full Faro config from React Native flag-based config.
  *
  * Based on flags, builds instrumentations and transports automatically.
  * Client just enables what they need; makeRNConfig does the rest.
+ *
+ * @param preloadedSessionDeviceAttributes Device/session fields for session meta (passed from async `initializeFaro`).
  */
-export declare function makeRNConfig(config: ReactNativeConfig): Config;
+export declare function makeRNConfig(config: ReactNativeConfig, preloadedSessionDeviceAttributes?: SessionAttributes): ReactNativeFullConfig;

package/dist/types/config/types.d.ts

@@ -1,11 +1,15 @@
 import type { Config } from '@grafana/faro-core';
 import type { ANRInstrumentationOptions } from '../instrumentations/anr';
 import type { FrameMonitoringOptions } from '../instrumentations/frameMonitoring';
+import type { SessionAttributes } from '../instrumentations/session/sessionAttributes';
 import type { Sampling } from './sampling';
 /**
  * React Native session tracking config.
  * Extends Config['sessionTracking'] with sampling (Flutter-style) and RN-specific props.
  * Excludes samplingRate and sampler in favor of sampling.
+ *
+ * When `persistent` is true, sessions are stored with [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv)
+ * (synchronous). Add `react-native-mmkv` to your app and rebuild native projects.
  */
 export type ReactNativeSessionTrackingConfig = Omit<NonNullable<Config['sessionTracking']>, 'samplingRate' | 'sampler'> & {
     /**
@@ -65,4 +69,11 @@ type ReactNativeConfigOverrides = {
  * instrumentations and transports inherited from Config for extras (built-ins come from flags).
  */
 export type ReactNativeConfig = Partial<Omit<Config, 'sessionTracking' | 'consoleInstrumentation' | 'userActionsInstrumentation'>> & ReactNativeConfigOverrides;
+/**
+ * Internal full config returned by `makeRNConfig`.
+ * Extends faro-core `Config` with RN-specific fields that instrumentations need at init time.
+ */
+export type ReactNativeFullConfig = Config & {
+    preloadedSessionDeviceAttributes?: SessionAttributes;
+};
 export {};

package/dist/types/generated/faroRNPackageMeta.d.ts

@@ -0,0 +1,5 @@
+/**
+ * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.
+ */
+export declare const FARO_REACT_NATIVE_NPM_NAME: "@grafana/faro-react-native";
+export declare const FARO_REACT_NATIVE_NPM_VERSION: "1.0.0";

package/dist/types/index.d.ts

@@ -7,6 +7,8 @@ export { ErrorMechanism, ErrorsInstrumentation } from './instrumentations/errors
 export type { ErrorMechanismType, ErrorsInstrumentationOptions } from './instrumentations/errors';
 export { ConsoleInstrumentation } from './instrumentations/console';
 export { SessionInstrumentation } from './instrumentations/session';
+export { getSessionAttributes, loadSessionDeviceAttributesForInit, minimalSessionDeviceAttributes, } from './instrumentations/session/sessionAttributes';
+export type { SessionAttributes } from './instrumentations/session/sessionAttributes';
 export { ViewInstrumentation } from './instrumentations/view';
 export { AppStateInstrumentation } from './instrumentations/appState';
 export { UserActionInstrumentation } from './instrumentations/userActions';
@@ -45,4 +47,4 @@ export { ReactNativeNavigationIntegration } from './navigation/v6';
 export { useFaroNavigation, createNavigationStateChangeHandler, getCurrentRoute, getRouteName, onNavigationStateChange, } from './navigation';
 export type { ReactNavigationDependencies, ReactNavigationConfig } from './navigation/types';
 export type { Config, Faro, Instrumentation, Meta, Transport, PushErrorOptions, PushEventOptions, PushLogOptions, PushMeasurementOptions, } from '@grafana/faro-core';
-export { LogLevel } from '@grafana/faro-core';
+export { LogLevel, InternalLoggerLevel, allLogLevels, defaultLogLevel } from './internalLogger';

package/dist/types/initialize.d.ts

@@ -1,3 +1,7 @@
 import { type Faro } from '@grafana/faro-core';
 import type { ReactNativeConfig } from './config/types';
-export declare function initializeFaro(config: ReactNativeConfig): Faro;
+/**
+ * Awaits async device/session attribute collection, then initializes Faro with core `initializeFaro`.
+ * On failure during collection, uses `minimalSessionDeviceAttributes` before init.
+ */
+export declare function initializeFaro(config: ReactNativeConfig): Promise<Faro>;

package/dist/types/instrumentations/anr/instrumentation.d.ts

@@ -31,7 +31,7 @@ import type { ANRInstrumentationOptions } from './types';
  */
 export declare class ANRInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-anr";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private readonly options;
     private pollingIntervalId;
     constructor(options?: ANRInstrumentationOptions);

package/dist/types/instrumentations/appState/index.d.ts

@@ -10,7 +10,7 @@ export declare const EVENT_APP_STATE_CHANGED = "app_lifecycle_changed";
  */
 export declare class AppStateInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-appstate";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private currentState;
     private stateStartTime;
     private appStateSubscription;

package/dist/types/instrumentations/console/index.d.ts

@@ -11,12 +11,13 @@ import { BaseInstrumentation, LogLevel } from '@grafana/faro-core';
  */
 export declare class ConsoleInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-console";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     static defaultDisabledLevels: LogLevel[];
     static consoleErrorPrefix: string;
     private originalConsole;
     private errorSerializer;
     private patchedLevels;
+    private isProcessing;
     initialize(): void;
     /**
      * Restore original console methods

package/dist/types/instrumentations/crashReporting/instrumentation.d.ts

@@ -28,7 +28,7 @@ import type { CrashReportingOptions } from './types';
  */
 export declare class CrashReportingInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-crash";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private readonly options;
     constructor(options?: CrashReportingOptions);
     initialize(): Promise<void>;

package/dist/types/instrumentations/errors/index.d.ts

@@ -35,10 +35,9 @@ export interface ErrorsInstrumentationOptions {
  *
  * @example
  * ```tsx
- * import { initializeFaro } from '@grafana/faro-react-native';
- * import { ErrorsInstrumentation } from '@grafana/faro-react-native';
+ * import { ErrorsInstrumentation, initializeFaro } from '@grafana/faro-react-native';
  *
- * initializeFaro({
+ * await initializeFaro({
  *   // ...config
  *   instrumentations: [
  *     new ErrorsInstrumentation({

package/dist/types/instrumentations/frameMonitoring/instrumentation.d.ts

@@ -40,7 +40,7 @@ import type { FrameMonitoringOptions } from './types';
  */
 export declare class FrameMonitoringInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-frame-monitoring";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private readonly options;
     private pollingIntervalId;
     private eventEmitter;

package/dist/types/instrumentations/http/index.d.ts

@@ -29,7 +29,7 @@ export type { HttpRequestPayload } from './utils';
  */
 export declare class HttpInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-http";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private originalFetch?;
     private ignoredUrls;
     private requests;

package/dist/types/instrumentations/performance/index.d.ts

@@ -43,7 +43,7 @@ import type { PerformanceInstrumentationOptions } from './types';
  */
 export declare class PerformanceInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-performance";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private options;
     private intervalId;
     constructor(options?: PerformanceInstrumentationOptions);

package/dist/types/instrumentations/session/index.d.ts

@@ -5,13 +5,14 @@ import { BaseInstrumentation } from '@grafana/faro-core';
  */
 export declare class SessionInstrumentation extends BaseInstrumentation {
     readonly name = "@grafana/faro-react-native:instrumentation-session";
-    readonly version = "2.2.3";
+    readonly version = "2.3.1";
     private notifiedSession;
     private sessionManagerInstance;
+    private getDefaultSessionDeviceAttributes;
     private sendSessionStartEvent;
     private createInitialSession;
     private registerBeforeSendHook;
-    initialize(): Promise<void>;
+    initialize(): void;
     /**
      * Clean up session manager listeners
      */

package/dist/types/instrumentations/session/sessionAttributes.d.ts

@@ -4,36 +4,38 @@
  *
  * Core attributes match Flutter SDK format, with additional mobile-specific
  * monitoring fields (memory, device type, battery, etc.)
+ *
+ * SDK name, core version, and npm adapter are on Faro meta `sdk` (`getSdkMeta` in `metas/sdk.ts`).
+ *
+ * `react_native_version` is the host app's React Native **framework** version from `Platform`, not the Faro package.
  */
 export interface SessionAttributes {
-    /** SDK version (e.g., "2.0.2") */
-    faro_sdk_version: string;
-    /** React Native version (e.g., "0.75.1") */
+    /** Host app's React Native framework version (e.g. "0.75.1") from `Platform.constants`. */
     react_native_version: string;
     /** Operating system ("iOS" or "Android") */
-    device_os: string;
+    device_os?: string;
     /** OS version (e.g., "17.0" for iOS, "15" for Android) */
-    device_os_version: string;
+    device_os_version?: string;
     /** Detailed OS info (e.g., "iOS 17.0" or "Android 15 (SDK 35)") */
-    device_os_detail: string;
+    device_os_detail?: string;
     /** Device manufacturer (e.g., "apple", "samsung") */
-    device_manufacturer: string;
+    device_manufacturer?: string;
     /** Raw model identifier (e.g., "iPhone16,1", "SM-A155F") */
-    device_model: string;
+    device_model?: string;
     /** Human-readable model name (e.g., "iPhone 15 Pro") */
-    device_model_name: string;
+    device_model_name?: string;
     /** Device brand (e.g., "iPhone", "samsung") */
-    device_brand: string;
+    device_brand?: string;
     /** Whether device is physical or emulator ("true" or "false") */
-    device_is_physical: string;
+    device_is_physical?: string;
     /** Unique device ID (UUID) */
-    device_id: string;
+    device_id?: string;
     /** Device type ("mobile" or "tablet") */
-    device_type: string;
+    device_type?: string;
     /** Total device memory in bytes */
-    device_memory_total: string;
+    device_memory_total?: string;
     /** Currently used memory in bytes */
-    device_memory_used: string;
+    device_memory_used?: string;
     /** Battery level percentage (e.g., "85") - empty if unavailable */
     device_battery_level?: string;
     /** Whether device is charging ("true" or "false") - empty if unavailable */
@@ -43,12 +45,17 @@ export interface SessionAttributes {
     /** Mobile carrier name (e.g., "Verizon") - empty if unavailable */
     device_carrier?: string;
 }
+/**
+ * Session attributes without device props when async collection or DeviceInfo is unavailable.
+ * No synchronous DeviceInfo reads — use {@link getSessionAttributes} or the package async `initializeFaro`.
+ */
+export declare function minimalSessionDeviceAttributes(): SessionAttributes;
 /**
  * Get all session attributes
  * These attributes are automatically included with every telemetry event
  *
  * Core attributes matching Flutter SDK:
- * - faro_sdk_version, react_native_version
+ * - react_native_version (RN framework in the host app)
  * - device_os, device_os_version, device_os_detail
  * - device_manufacturer, device_model, device_model_name
  * - device_brand, device_is_physical, device_id
@@ -60,3 +67,8 @@ export interface SessionAttributes {
  * - device_carrier
  */
 export declare function getSessionAttributes(): Promise<SessionAttributes>;
+/**
+ * Await full async session device attributes (battery, carrier, etc.), then fall back to
+ * {@link minimalSessionDeviceAttributes} if anything throws. Used by async `initializeFaro`.
+ */
+export declare function loadSessionDeviceAttributesForInit(): Promise<SessionAttributes>;

package/dist/types/instrumentations/session/sessionManager/MmkvPersistentSessionsManager.d.ts

@@ -0,0 +1,20 @@
+import type { FaroUserSession } from './types';
+/** @internal */
+export declare function resetMmkvSingletonForTests(): void;
+/**
+ * Persistent session storage backed by MMKV (synchronous reads/writes).
+ * Used when `sessionTracking.persistent` is true.
+ */
+export declare class MmkvPersistentSessionsManager {
+    private updateUserSession;
+    private appStateSubscription;
+    private metaUnsubscribe;
+    constructor();
+    static removeUserSession(): void;
+    static storeUserSession(session: FaroUserSession): void;
+    static fetchUserSession(): FaroUserSession | null;
+    updateSession: () => Promise<void>;
+    private handleAppStateChange;
+    private init;
+    unpatch(): void;
+}