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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseInstrumentation, dateNow, EVENT_SESSION_START, genShortID, VERSION } from '@grafana/faro-core';\nimport type { Config, Meta, MetaSession, TransportItem } from '@grafana/faro-core';\n\nimport type { ReactNativeSessionTrackingConfig } from '../../config/types';\n\nimport { getSessionAttributes } from './sessionAttributes';\nimport { type FaroUserSession, getSessionManagerByConfig, isSampled } from './sessionManager';\nimport { PersistentSessionsManager } from './sessionManager/PersistentSessionsManager';\nimport { MAX_SESSION_PERSISTENCE_TIME } from './sessionManager/sessionConstants';\nimport { createUserSessionObject, isUserSessionValid } from './sessionManager/sessionManagerUtils';\nimport type { SessionManager } from './sessionManager/types';\n\n/**\n * Session instrumentation for React Native\n * Manages persistent or volatile sessions with expiration and inactivity tracking\n */\nexport class SessionInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-session';\n  readonly version = VERSION;\n\n  // previously notified session, to ensure we don't send session start\n  // event twice for the same session\n  private notifiedSession: MetaSession | undefined;\n  private sessionManagerInstance: InstanceType<SessionManager> | undefined;\n\n  private sendSessionStartEvent(meta: Meta): void {\n    const session = meta.session;\n\n    if (session && session.id !== this.notifiedSession?.id) {\n      this.notifiedSession = session;\n      // no need to add attributes and session id, they are included as part of meta\n      // automatically\n      this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n    }\n  }\n\n  private async createInitialSession(\n    SessionManager: SessionManager,\n    sessionsConfig: Required<Config>['sessionTracking']\n  ): Promise<{\n    initialSession: FaroUserSession;\n    emitSessionStartOnInit: boolean;\n  }> {\n    let storedUserSession: FaroUserSession | null = await SessionManager.fetchUserSession();\n\n    const sessionsConfigTyped = sessionsConfig as ReactNativeSessionTrackingConfig;\n    const maxPersistenceMs = sessionsConfigTyped.maxSessionPersistenceTime ?? MAX_SESSION_PERSISTENCE_TIME;\n\n    if (sessionsConfig.persistent && storedUserSession) {\n      const now = dateNow();\n      const shouldClearPersistentSession = storedUserSession.lastActivity < now - maxPersistenceMs;\n\n      if (shouldClearPersistentSession) {\n        await PersistentSessionsManager.removeUserSession();\n        storedUserSession = null;\n      }\n    }\n\n    // Get default session attributes (device info, SDK version, etc.)\n    // These match the Flutter SDK's default session attributes\n    const defaultAttributes = await getSessionAttributes();\n\n    let emitSessionStartOnInit: boolean;\n    let initialSession: FaroUserSession;\n\n    if (isUserSessionValid(storedUserSession)) {\n      const sessionId = storedUserSession?.sessionId;\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: storedUserSession!.isSampled || false,\n        started: storedUserSession?.started,\n      });\n\n      const storedUserSessionMeta = storedUserSession?.sessionMeta;\n\n      // For resumed sessions we want to merge the previous overrides with the configured ones.\n      // If the same key is present in both, the new one will override the old one.\n      const overrides = { ...sessionsConfig.session?.overrides, ...storedUserSessionMeta?.overrides };\n\n      initialSession.sessionMeta = {\n        ...sessionsConfig.session,\n        id: sessionId,\n        attributes: {\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Merge with stored attributes\n          ...storedUserSessionMeta?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n          // For valid resumed sessions we do not want to recalculate the sampling decision on each init phase.\n          isSampled: initialSession.isSampled.toString(),\n        },\n        overrides,\n      };\n\n      emitSessionStartOnInit = false;\n    } else {\n      const sessionId = sessionsConfig.session?.id ?? genShortID();\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: isSampled(),\n      });\n\n      const overrides = sessionsConfig.session?.overrides;\n\n      initialSession.sessionMeta = {\n        id: sessionId,\n        attributes: {\n          isSampled: initialSession.isSampled.toString(),\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n        },\n        // new session we don't care about previous overrides\n        ...(overrides ? { overrides } : {}),\n      };\n\n      emitSessionStartOnInit = true;\n    }\n\n    return { initialSession, emitSessionStartOnInit };\n  }\n\n  private registerBeforeSendHook(SessionManager: SessionManager) {\n    const { updateSession } = new SessionManager();\n\n    this.transports?.addBeforeSendHooks((item: TransportItem) => {\n      updateSession();\n\n      const attributes = item.meta.session?.attributes;\n\n      if (attributes && attributes?.['isSampled'] === 'true') {\n        let newItem: TransportItem = JSON.parse(JSON.stringify(item));\n\n        const newAttributes = newItem.meta.session?.attributes;\n        delete newAttributes?.['isSampled'];\n\n        if (Object.keys(newAttributes ?? {}).length === 0) {\n          delete newItem.meta.session?.attributes;\n        }\n\n        return newItem;\n      }\n\n      return null;\n    });\n  }\n\n  async initialize(): Promise<void> {\n    this.logDebug('init session instrumentation');\n\n    const sessionTrackingConfig = this.config.sessionTracking;\n\n    if (sessionTrackingConfig?.enabled) {\n      const SessionManager = getSessionManagerByConfig(sessionTrackingConfig);\n\n      this.registerBeforeSendHook(SessionManager);\n\n      const { initialSession, emitSessionStartOnInit } = await this.createInitialSession(\n        SessionManager,\n        sessionTrackingConfig\n      );\n\n      await SessionManager.storeUserSession(initialSession);\n\n      const initialSessionMeta = initialSession.sessionMeta;\n\n      this.notifiedSession = initialSessionMeta;\n      this.api.setSession(initialSessionMeta);\n\n      // Store the session manager instance for cleanup\n      this.sessionManagerInstance = new SessionManager();\n\n      if (emitSessionStartOnInit) {\n        this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n      }\n    }\n\n    this.metas.addListener(this.sendSessionStartEvent.bind(this));\n  }\n\n  /**\n   * Clean up session manager listeners\n   */\n  unpatch(): void {\n    if (this.sessionManagerInstance && 'unpatch' in this.sessionManagerInstance) {\n      this.sessionManagerInstance.unpatch();\n    }\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/instrumentations/session/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseInstrumentation, dateNow, EVENT_SESSION_START, genShortID, VERSION } from '@grafana/faro-core';\nimport type { Config, Meta, MetaSession, TransportItem } from '@grafana/faro-core';\n\nimport type { ReactNativeFullConfig, ReactNativeSessionTrackingConfig } from '../../config/types';\n\nimport { minimalSessionDeviceAttributes, type SessionAttributes } from './sessionAttributes';\nimport { type FaroUserSession, getSessionManagerByConfig, isSampled } from './sessionManager';\nimport { MAX_SESSION_PERSISTENCE_TIME } from './sessionManager/sessionConstants';\nimport { createUserSessionObject, isUserSessionValid } from './sessionManager/sessionManagerUtils';\nimport type { SessionManager } from './sessionManager/types';\n\n/**\n * Session instrumentation for React Native\n * Manages persistent or volatile sessions with expiration and inactivity tracking\n */\nexport class SessionInstrumentation extends BaseInstrumentation {\n  readonly name = '@grafana/faro-react-native:instrumentation-session';\n  readonly version = VERSION;\n\n  // previously notified session, to ensure we don't send session start\n  // event twice for the same session\n  private notifiedSession: MetaSession | undefined;\n  private sessionManagerInstance: InstanceType<SessionManager> | undefined;\n\n  private getDefaultSessionDeviceAttributes(): SessionAttributes {\n    const cfg = this.config as ReactNativeFullConfig;\n    if (cfg.preloadedSessionDeviceAttributes != null) {\n      return cfg.preloadedSessionDeviceAttributes;\n    }\n    return minimalSessionDeviceAttributes();\n  }\n\n  private sendSessionStartEvent(meta: Meta): void {\n    const session = meta.session;\n\n    if (session && session.id !== this.notifiedSession?.id) {\n      this.notifiedSession = session;\n      // no need to add attributes and session id, they are included as part of meta\n      // automatically\n      this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n    }\n  }\n\n  private createInitialSession(\n    SessionManagerClass: SessionManager,\n    sessionsConfig: Required<Config>['sessionTracking']\n  ): {\n    initialSession: FaroUserSession;\n    emitSessionStartOnInit: boolean;\n  } {\n    let storedUserSession = SessionManagerClass.fetchUserSession();\n\n    const sessionsConfigTyped = sessionsConfig as ReactNativeSessionTrackingConfig;\n    const maxPersistenceMs = sessionsConfigTyped.maxSessionPersistenceTime ?? MAX_SESSION_PERSISTENCE_TIME;\n\n    if (sessionsConfig.persistent && storedUserSession) {\n      const now = dateNow();\n      const shouldClearPersistentSession = storedUserSession.lastActivity < now - maxPersistenceMs;\n\n      if (shouldClearPersistentSession) {\n        SessionManagerClass.removeUserSession();\n        storedUserSession = null;\n      }\n    }\n\n    const defaultAttributes = this.getDefaultSessionDeviceAttributes();\n\n    let emitSessionStartOnInit: boolean;\n    let initialSession: FaroUserSession;\n\n    if (isUserSessionValid(storedUserSession)) {\n      const sessionId = storedUserSession?.sessionId;\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: storedUserSession?.isSampled || false,\n        started: storedUserSession?.started,\n      });\n\n      const storedUserSessionMeta = storedUserSession?.sessionMeta;\n\n      // For resumed sessions we want to merge the previous overrides with the configured ones.\n      // If the same key is present in both, the new one will override the old one.\n      const overrides = { ...sessionsConfig.session?.overrides, ...storedUserSessionMeta?.overrides };\n\n      initialSession.sessionMeta = {\n        ...sessionsConfig.session,\n        id: sessionId,\n        attributes: {\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Merge with stored attributes\n          ...storedUserSessionMeta?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n          // For valid resumed sessions we do not want to recalculate the sampling decision on each init phase.\n          isSampled: initialSession.isSampled.toString(),\n        },\n        overrides,\n      };\n\n      emitSessionStartOnInit = false;\n    } else {\n      const sessionId = sessionsConfig.session?.id ?? genShortID();\n\n      initialSession = createUserSessionObject({\n        sessionId,\n        isSampled: isSampled(),\n      });\n\n      const overrides = sessionsConfig.session?.overrides;\n\n      initialSession.sessionMeta = {\n        id: sessionId,\n        attributes: {\n          isSampled: initialSession.isSampled.toString(),\n          // Start with custom attributes from config\n          ...sessionsConfig.session?.attributes,\n          // Default attributes take precedence (matching Flutter SDK behavior)\n          ...defaultAttributes,\n        },\n        // new session we don't care about previous overrides\n        ...(overrides ? { overrides } : {}),\n      };\n\n      emitSessionStartOnInit = true;\n    }\n\n    return { initialSession, emitSessionStartOnInit };\n  }\n\n  private registerBeforeSendHook(SessionManagerClass: SessionManager) {\n    const { updateSession } = new SessionManagerClass();\n\n    this.transports?.addBeforeSendHooks((item: TransportItem) => {\n      updateSession();\n\n      const attributes = item.meta.session?.attributes;\n\n      // Only filter out items when session is explicitly NOT sampled (isSampled='false')\n      // If isSampled='true', remove the attribute before sending (it's internal)\n      // If no isSampled attribute, pass through the item unchanged\n      if (attributes?.['isSampled'] === 'false') {\n        // Session is not sampled - drop this item\n        return null;\n      }\n\n      if (attributes?.['isSampled'] === 'true') {\n        // Session is sampled - remove internal isSampled attribute before sending\n        let newItem: TransportItem = JSON.parse(JSON.stringify(item));\n\n        const newAttributes = newItem.meta.session?.attributes;\n        delete newAttributes?.['isSampled'];\n\n        if (Object.keys(newAttributes ?? {}).length === 0) {\n          delete newItem.meta.session?.attributes;\n        }\n\n        return newItem;\n      }\n\n      // No isSampled attribute or other value - pass through unchanged\n      return item;\n    });\n  }\n\n  initialize(): void {\n    const sessionTrackingConfig = this.config.sessionTracking;\n\n    if (!sessionTrackingConfig?.enabled) {\n      this.metas.addListener(this.sendSessionStartEvent.bind(this));\n      return;\n    }\n\n    const SessionManagerClass = getSessionManagerByConfig(sessionTrackingConfig);\n\n    this.registerBeforeSendHook(SessionManagerClass);\n\n    const { initialSession, emitSessionStartOnInit } = this.createInitialSession(\n      SessionManagerClass,\n      sessionTrackingConfig\n    );\n    SessionManagerClass.storeUserSession(initialSession);\n\n    const initialSessionMeta = initialSession.sessionMeta;\n    this.notifiedSession = initialSessionMeta;\n    this.api.setSession(initialSessionMeta);\n\n    this.sessionManagerInstance = new SessionManagerClass();\n\n    if (emitSessionStartOnInit) {\n      this.api.pushEvent(EVENT_SESSION_START, {}, undefined, { skipDedupe: true });\n    }\n\n    this.metas.addListener(this.sendSessionStartEvent.bind(this));\n  }\n\n  /**\n   * Clean up session manager listeners\n   */\n  unpatch(): void {\n    if (this.sessionManagerInstance && 'unpatch' in this.sessionManagerInstance) {\n      this.sessionManagerInstance.unpatch();\n    }\n  }\n}\n"]}

package/dist/esm/instrumentations/session/sessionAttributes.js

@@ -9,14 +9,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { Platform } from 'react-native';
 import DeviceInfo from 'react-native-device-info';
-import { VERSION } from '@grafana/faro-core';
 /**
- * Get React Native version from Platform
- * Returns "unknown" if not available
+ * React Native framework version from `Platform.constants` (host app runtime), not `@grafana/faro-react-native` semver.
  */
 function getReactNativeVersion() {
     try {
-        // Platform.constants.reactNativeVersion is an object like { major: 0, minor: 75, patch: 1 }
         const version = Platform.constants.reactNativeVersion;
         if (version && typeof version === 'object') {
             const { major, minor, patch, prerelease } = version;
@@ -68,12 +65,21 @@ function getDeviceOsDetail() {
         return `${systemName} ${systemVersion}`;
     });
 }
+/**
+ * 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 function minimalSessionDeviceAttributes() {
+    return {
+        react_native_version: getReactNativeVersion(),
+    };
+}
 /**
  * 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
@@ -102,7 +108,6 @@ export function getSessionAttributes() {
             // Memory info
             const totalMemory = DeviceInfo.getTotalMemorySync();
             const usedMemory = DeviceInfo.getUsedMemorySync();
-            // React Native version (equivalent to dart_version in Flutter)
             const reactNativeVersion = getReactNativeVersion();
             // Try to get async device info (battery, carrier)
             let batteryLevel;
@@ -142,7 +147,6 @@ export function getSessionAttributes() {
                 // Carrier not available
             }
             const attributes = {
-                faro_sdk_version: VERSION,
                 react_native_version: reactNativeVersion,
                 device_os: systemName,
                 device_os_version: systemVersion,
@@ -164,23 +168,21 @@ export function getSessionAttributes() {
             return attributes;
         }
         catch (_error) {
-            // If anything fails, return minimal attributes
-            return {
-                faro_sdk_version: VERSION,
-                react_native_version: getReactNativeVersion(),
-                device_os: Platform.OS === 'ios' ? 'iOS' : 'Android',
-                device_os_version: 'unknown',
-                device_os_detail: 'unknown',
-                device_manufacturer: 'unknown',
-                device_model: 'unknown',
-                device_model_name: 'unknown',
-                device_brand: 'unknown',
-                device_is_physical: 'true',
-                device_id: 'unknown',
-                device_type: 'mobile',
-                device_memory_total: '0',
-                device_memory_used: '0',
-            };
+            return minimalSessionDeviceAttributes();
+        }
+    });
+}
+/**
+ * Await full async session device attributes (battery, carrier, etc.), then fall back to
+ * {@link minimalSessionDeviceAttributes} if anything throws. Used by async `initializeFaro`.
+ */
+export function loadSessionDeviceAttributesForInit() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield getSessionAttributes();
+        }
+        catch (_a) {
+            return minimalSessionDeviceAttributes();
         }
     });
 }

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":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9C,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,mCAAmC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,WAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,qJAAqJ,CACtJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,IAAI,aAA+B,CAAC;AAEpC,SAAS,OAAO;IACd,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,aAAa,GAAG,kBAAkB,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,0BAA0B;IACxC,aAAa,GAAG,SAAS,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,6BAA6B;IAKxC;QAHQ,yBAAoB,GAAwD,IAAI,CAAC;QACjF,oBAAe,GAAwB,IAAI,CAAC;QAwCpD,kBAAa,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAEvE,yBAAoB,GAAG,CAAC,YAA4B,EAAE,EAAE;YAC9D,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QA3CA,IAAI,CAAC,iBAAiB,GAAG,qBAAqB,CAAC;YAC7C,gBAAgB,EAAE,6BAA6B,CAAC,gBAAgB;YAChE,gBAAgB,EAAE,6BAA6B,CAAC,gBAAgB;SACjE,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,MAAM,CAAC,iBAAiB;;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAA,MAAA,IAAI,CAAC,gBAAgB,0CAAE,IAAI,mDAAG,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,OAAwB;;QAC9C,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAA,MAAA,IAAI,CAAC,gBAAgB,0CAAE,IAAI,mDAAG,kCAAkC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB;;QACrB,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,OAAO,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACvD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAoB,CAAC;YACtD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAA,MAAA,IAAI,CAAC,gBAAgB,0CAAE,IAAI,mDAAG,oCAAoC,EAAE,KAAK,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAUO,IAAI;QACV,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAE3F,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CACxC,2BAA2B,CAAC;YAC1B,gBAAgB,EAAE,6BAA6B,CAAC,gBAAgB;YAChE,gBAAgB,EAAE,6BAA6B,CAAC,gBAAgB;SACjE,CAAC,CACH,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,CAAC;IAED,OAAO;QACL,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;CACF","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/esm/util/performanceObserverPolyfill.js

@@ -17,6 +17,8 @@ const globalObj = (typeof globalThis !== 'undefined' && globalThis) ||
     (typeof global !== 'undefined' && global) ||
     (typeof window !== 'undefined' && window) ||
     {};
+const RESOURCE_ENTRY_TYPE = 'resource';
+const FARO_RESOURCE_TIMING_PATCH = '__faroResourceTimingPatch';
 /**
  * No-op PerformanceObserver that matches the Web API interface.
  * Prevents crashes when React Native's native implementation throws.
@@ -37,14 +39,18 @@ class NoopPerformanceObserver {
 }
 NoopPerformanceObserver.supportedEntryTypes = [];
 /**
- * Apply polyfill on React Native iOS to prevent bad_variant_access crash.
- * Must run before any code that might use PerformanceObserver.
+ * Apply React Native performance API compatibility patches.
+ *
+ * Resource Timing lookup is patched on all platforms because OTel web
+ * instrumentation can probe it. The PerformanceObserver replacement is
+ * iOS-only to avoid the native bad_variant_access crash.
  */
 export function applyPerformanceObserverPolyfill() {
+    const record = globalObj;
+    patchUnsupportedResourceTimingLookup(record);
     if (Platform.OS !== 'ios') {
         return;
     }
-    const record = globalObj;
     const existing = record['PerformanceObserver'];
     if (existing && existing.name === 'NoopPerformanceObserver') {
         return; // Already applied
@@ -56,4 +62,27 @@ export function applyPerformanceObserverPolyfill() {
         // Ignore if global is frozen (e.g. in some test environments)
     }
 }
+function patchUnsupportedResourceTimingLookup(record) {
+    const performance = record['performance'];
+    if (!(performance === null || performance === void 0 ? void 0 : performance.getEntriesByType) || performance.getEntriesByType[FARO_RESOURCE_TIMING_PATCH]) {
+        return;
+    }
+    const originalGetEntriesByType = performance.getEntriesByType.bind(performance);
+    const patchedGetEntriesByType = ((entryType) => {
+        if (entryType === RESOURCE_ENTRY_TYPE) {
+            // OTel web fetch instrumentation probes browser Resource Timing APIs.
+            // React Native does not expose resource entries, and calling through emits
+            // "Deprecated API for given entry type." warnings in development.
+            return [];
+        }
+        return originalGetEntriesByType(entryType);
+    });
+    patchedGetEntriesByType[FARO_RESOURCE_TIMING_PATCH] = true;
+    try {
+        performance.getEntriesByType = patchedGetEntriesByType;
+    }
+    catch (_a) {
+        // Ignore if performance is read-only in a test or host environment.
+    }
+}
 //# sourceMappingURL=performanceObserverPolyfill.js.map

package/dist/esm/util/performanceObserverPolyfill.js.map

@@ -1 +1 @@
-{"version":3,"file":"performanceObserverPolyfill.js","sourceRoot":"","sources":["../../../src/util/performanceObserverPolyfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,SAAS,GACb,CAAC,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC;IACjD,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC;IACzC,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC;IACzC,EAAE,CAAC;AAqBL;;;GAGG;AACH,MAAM,uBAAuB;IAC3B,YACE,SAIS;QAET,+DAA+D;IACjE,CAAC;IAED,OAAO,CAAC,QAAkC;QACxC,QAAQ;IACV,CAAC;IAED,UAAU;QACR,QAAQ;IACV,CAAC;IAED,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;;AAEe,2CAAmB,GAAa,EAAE,CAAC;AAGrD;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,SAAoC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC/C,IAAI,QAAQ,IAAK,QAAyC,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC9F,OAAO,CAAC,kBAAkB;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,uBAAuB,CAAC;IAC1D,CAAC;IAAC,WAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC","sourcesContent":["/**\n * PerformanceObserver polyfill for React Native iOS\n *\n * React Native 0.84's native PerformanceObserver has a bug on iOS that throws\n * `bad_variant_access` when the observer callback runs and calls getEntries().\n * This happens in NativePerformance.createObserver when the native bridge\n * returns data that causes a C++ variant access error.\n *\n * OpenTelemetry's FetchInstrumentation (and other libs) may use PerformanceObserver\n * for resource timing. We provide a no-op polyfill on React Native iOS to prevent\n * the crash while preserving refresh rate vitals and other functionality.\n *\n * @see https://github.com/facebook/react-native/issues (PerformanceObserver iOS)\n */\n\nimport { Platform } from 'react-native';\n\nconst globalObj =\n  (typeof globalThis !== 'undefined' && globalThis) ||\n  (typeof global !== 'undefined' && global) ||\n  (typeof window !== 'undefined' && window) ||\n  {};\n\ninterface PerformanceEntry {\n  readonly duration: number;\n  readonly entryType: string;\n  readonly name: string;\n  readonly startTime: number;\n}\n\ninterface PerformanceObserverEntryList {\n  getEntries(): PerformanceEntry[];\n  getEntriesByName(name: string, type?: string): PerformanceEntry[];\n  getEntriesByType(type: string): PerformanceEntry[];\n}\n\ninterface PerformanceObserverInit {\n  entryTypes?: string[];\n  type?: string;\n  buffered?: boolean;\n}\n\n/**\n * No-op PerformanceObserver that matches the Web API interface.\n * Prevents crashes when React Native's native implementation throws.\n */\nclass NoopPerformanceObserver {\n  constructor(\n    _callback: (\n      list: PerformanceObserverEntryList,\n      observer: NoopPerformanceObserver,\n      options?: PerformanceObserverInit\n    ) => void\n  ) {\n    // Callback is never invoked - avoids triggering the native bug\n  }\n\n  observe(_options?: PerformanceObserverInit): void {\n    // No-op\n  }\n\n  disconnect(): void {\n    // No-op\n  }\n\n  takeRecords(): PerformanceEntry[] {\n    return [];\n  }\n\n  static readonly supportedEntryTypes: string[] = [];\n}\n\n/**\n * Apply polyfill on React Native iOS to prevent bad_variant_access crash.\n * Must run before any code that might use PerformanceObserver.\n */\nexport function applyPerformanceObserverPolyfill(): void {\n  if (Platform.OS !== 'ios') {\n    return;\n  }\n\n  const record = globalObj as Record<string, unknown>;\n  const existing = record['PerformanceObserver'];\n  if (existing && (existing as unknown as { name?: string }).name === 'NoopPerformanceObserver') {\n    return; // Already applied\n  }\n\n  try {\n    record['PerformanceObserver'] = NoopPerformanceObserver;\n  } catch {\n    // Ignore if global is frozen (e.g. in some test environments)\n  }\n}\n"]}
+{"version":3,"file":"performanceObserverPolyfill.js","sourceRoot":"","sources":["../../../src/util/performanceObserverPolyfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,SAAS,GACb,CAAC,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC;IACjD,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC;IACzC,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC;IACzC,EAAE,CAAC;AAEL,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,0BAA0B,GAAG,2BAA2B,CAAC;AAqB/D;;;GAGG;AACH,MAAM,uBAAuB;IAC3B,YACE,SAIS;QAET,+DAA+D;IACjE,CAAC;IAED,OAAO,CAAC,QAAkC;QACxC,QAAQ;IACV,CAAC;IAED,UAAU;QACR,QAAQ;IACV,CAAC;IAED,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;;AAEe,2CAAmB,GAAa,EAAE,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC;IAC9C,MAAM,MAAM,GAAG,SAAoC,CAAC;IACpD,oCAAoC,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC/C,IAAI,QAAQ,IAAK,QAAyC,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC9F,OAAO,CAAC,kBAAkB;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,uBAAuB,CAAC;IAC1D,CAAC;IAAC,WAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC;AAED,SAAS,oCAAoC,CAAC,MAA+B;IAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAI3B,CAAC;IAEd,IAAI,CAAC,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,gBAAgB,CAAA,IAAI,WAAW,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,MAAM,wBAAwB,GAAG,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChF,MAAM,uBAAuB,GAAG,CAAC,CAAC,SAAiB,EAAsB,EAAE;QACzE,IAAI,SAAS,KAAK,mBAAmB,EAAE,CAAC;YACtC,sEAAsE;YACtE,2EAA2E;YAC3E,kEAAkE;YAClE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC,CAAwC,CAAC;IAE1C,uBAAuB,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAAC;IAE3D,IAAI,CAAC;QACH,WAAW,CAAC,gBAAgB,GAAG,uBAAuB,CAAC;IACzD,CAAC;IAAC,WAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC","sourcesContent":["/**\n * PerformanceObserver polyfill for React Native iOS\n *\n * React Native 0.84's native PerformanceObserver has a bug on iOS that throws\n * `bad_variant_access` when the observer callback runs and calls getEntries().\n * This happens in NativePerformance.createObserver when the native bridge\n * returns data that causes a C++ variant access error.\n *\n * OpenTelemetry's FetchInstrumentation (and other libs) may use PerformanceObserver\n * for resource timing. We provide a no-op polyfill on React Native iOS to prevent\n * the crash while preserving refresh rate vitals and other functionality.\n *\n * @see https://github.com/facebook/react-native/issues (PerformanceObserver iOS)\n */\n\nimport { Platform } from 'react-native';\n\nconst globalObj =\n  (typeof globalThis !== 'undefined' && globalThis) ||\n  (typeof global !== 'undefined' && global) ||\n  (typeof window !== 'undefined' && window) ||\n  {};\n\nconst RESOURCE_ENTRY_TYPE = 'resource';\nconst FARO_RESOURCE_TIMING_PATCH = '__faroResourceTimingPatch';\n\ninterface PerformanceEntry {\n  readonly duration: number;\n  readonly entryType: string;\n  readonly name: string;\n  readonly startTime: number;\n}\n\ninterface PerformanceObserverEntryList {\n  getEntries(): PerformanceEntry[];\n  getEntriesByName(name: string, type?: string): PerformanceEntry[];\n  getEntriesByType(type: string): PerformanceEntry[];\n}\n\ninterface PerformanceObserverInit {\n  entryTypes?: string[];\n  type?: string;\n  buffered?: boolean;\n}\n\n/**\n * No-op PerformanceObserver that matches the Web API interface.\n * Prevents crashes when React Native's native implementation throws.\n */\nclass NoopPerformanceObserver {\n  constructor(\n    _callback: (\n      list: PerformanceObserverEntryList,\n      observer: NoopPerformanceObserver,\n      options?: PerformanceObserverInit\n    ) => void\n  ) {\n    // Callback is never invoked - avoids triggering the native bug\n  }\n\n  observe(_options?: PerformanceObserverInit): void {\n    // No-op\n  }\n\n  disconnect(): void {\n    // No-op\n  }\n\n  takeRecords(): PerformanceEntry[] {\n    return [];\n  }\n\n  static readonly supportedEntryTypes: string[] = [];\n}\n\n/**\n * Apply React Native performance API compatibility patches.\n *\n * Resource Timing lookup is patched on all platforms because OTel web\n * instrumentation can probe it. The PerformanceObserver replacement is\n * iOS-only to avoid the native bad_variant_access crash.\n */\nexport function applyPerformanceObserverPolyfill(): void {\n  const record = globalObj as Record<string, unknown>;\n  patchUnsupportedResourceTimingLookup(record);\n\n  if (Platform.OS !== 'ios') {\n    return;\n  }\n\n  const existing = record['PerformanceObserver'];\n  if (existing && (existing as unknown as { name?: string }).name === 'NoopPerformanceObserver') {\n    return; // Already applied\n  }\n\n  try {\n    record['PerformanceObserver'] = NoopPerformanceObserver;\n  } catch {\n    // Ignore if global is frozen (e.g. in some test environments)\n  }\n}\n\nfunction patchUnsupportedResourceTimingLookup(record: Record<string, unknown>): void {\n  const performance = record['performance'] as\n    | {\n        getEntriesByType?: ((entryType: string) => PerformanceEntry[]) & Record<string, boolean>;\n      }\n    | undefined;\n\n  if (!performance?.getEntriesByType || performance.getEntriesByType[FARO_RESOURCE_TIMING_PATCH]) {\n    return;\n  }\n\n  const originalGetEntriesByType = performance.getEntriesByType.bind(performance);\n  const patchedGetEntriesByType = ((entryType: string): PerformanceEntry[] => {\n    if (entryType === RESOURCE_ENTRY_TYPE) {\n      // OTel web fetch instrumentation probes browser Resource Timing APIs.\n      // React Native does not expose resource entries, and calling through emits\n      // \"Deprecated API for given entry type.\" warnings in development.\n      return [];\n    }\n\n    return originalGetEntriesByType(entryType);\n  }) as typeof performance.getEntriesByType;\n\n  patchedGetEntriesByType[FARO_RESOURCE_TIMING_PATCH] = true;\n\n  try {\n    performance.getEntriesByType = patchedGetEntriesByType;\n  } catch {\n    // Ignore if performance is read-only in a test or host environment.\n  }\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.1.0";