@grafana/faro-react-native 1.3.1 → 1.4.0

package/android/src/test/java/com/grafana/faro/reactnative/FaroCrashSessionStoreTest.kt

@@ -0,0 +1,268 @@
+package com.grafana.faro.reactnative
+
+import android.content.Context
+import androidx.test.core.app.ApplicationProvider
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE, sdk = [30])
+class FaroCrashSessionStoreTest {
+
+    private lateinit var context: Context
+
+    @Before
+    fun setUp() {
+        context = ApplicationProvider.getApplicationContext()
+        context.getSharedPreferences(
+            "com.grafana.faro.crash_session_store",
+            Context.MODE_PRIVATE,
+        ).edit().clear().commit()
+    }
+
+    @Test
+    fun recordSessionContext_preservesFirstActivationForSessionUpdates() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L)
+        recordSession("session-a", activatedAtMs = 2_000L, nowMs = 2_000L)
+
+        val contexts = FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 2_000L)
+
+        assertEquals(1, contexts.size)
+        assertEquals(1_000L, contexts.single().activatedAtMs)
+        assertEquals(2_000L, contexts.single().updatedAtMs)
+    }
+
+    @Test
+    fun findMatchingContext_usesLatestSessionBeforeCrashInSameProcess() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L)
+        recordSession("session-b", activatedAtMs = 3_000L, nowMs = 3_000L)
+
+        val sessionA = FaroCrashSessionStore.findMatchingContext(
+            context,
+            crashTimestampMs = 2_000L,
+            pid = 101,
+            processName = "com.example.app",
+            nowMs = 4_000L,
+        )
+        val sessionB = FaroCrashSessionStore.findMatchingContext(
+            context,
+            crashTimestampMs = 4_000L,
+            pid = 101,
+            processName = "com.example.app",
+            nowMs = 4_000L,
+        )
+
+        assertEquals("session-a", sessionA?.sessionId)
+        assertEquals("session-b", sessionB?.sessionId)
+    }
+
+    @Test
+    fun findMatchingContext_doesNotCrossProcessBoundaries() {
+        recordSession(
+            sessionId = "session-a",
+            activatedAtMs = 1_000L,
+            nowMs = 1_000L,
+            pid = 101,
+        )
+        recordSession(
+            sessionId = "session-b",
+            activatedAtMs = 2_000L,
+            nowMs = 2_000L,
+            pid = 202,
+        )
+
+        val match = FaroCrashSessionStore.findMatchingContext(
+            context,
+            crashTimestampMs = 3_000L,
+            pid = 101,
+            processName = "com.example.app",
+            nowMs = 3_000L,
+        )
+
+        assertEquals("session-a", match?.sessionId)
+    }
+
+    @Test
+    fun acknowledgeReports_removesOnlyItsOwnSessionContext() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L, pid = 101)
+        recordSession("session-b", activatedAtMs = 2_000L, nowMs = 2_000L, pid = 202)
+        val contexts = FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 3_000L)
+        val sessionA = contexts.first { it.sessionId == "session-a" }
+        val sessionB = contexts.first { it.sessionId == "session-b" }
+
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            reportId = "report-a",
+            crashTimestampMs = 1_500L,
+            sessionContext = sessionA,
+            usesPendingTrace = true,
+            nowMs = 3_000L,
+        )
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            reportId = "report-b",
+            crashTimestampMs = 2_500L,
+            sessionContext = sessionB,
+            usesPendingTrace = false,
+            nowMs = 3_000L,
+        )
+
+        val result = FaroCrashSessionStore.acknowledgeReports(
+            context,
+            reportIds = listOf("report-a"),
+            nowMs = 4_000L,
+        )
+
+        val remaining = FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 4_000L)
+        assertTrue(result.clearPendingTrace)
+        assertTrue(FaroCrashSessionStore.isReportAcknowledged(context, "report-a", nowMs = 4_000L))
+        assertFalse(FaroCrashSessionStore.isReportAcknowledged(context, "report-b", nowMs = 4_000L))
+        assertEquals(listOf("session-b"), remaining.map { it.sessionId })
+        assertEquals(
+            "session-b",
+            FaroCrashSessionStore.contextForPendingReport(context, "report-b", nowMs = 4_000L)?.sessionId,
+        )
+    }
+
+    @Test
+    fun acknowledgeReports_keepsContextReferencedByAnotherPendingReport() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L)
+        val sessionA = FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 2_000L).single()
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            "report-a",
+            1_500L,
+            sessionA,
+            usesPendingTrace = false,
+            nowMs = 2_000L,
+        )
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            "report-b",
+            1_600L,
+            sessionA,
+            usesPendingTrace = false,
+            nowMs = 2_000L,
+        )
+
+        FaroCrashSessionStore.acknowledgeReports(context, listOf("report-a"), nowMs = 3_000L)
+
+        assertEquals(
+            "session-a",
+            FaroCrashSessionStore.contextForPendingReport(context, "report-b", nowMs = 3_000L)?.sessionId,
+        )
+    }
+
+    @Test
+    fun acknowledgeReports_clearsSharedTraceOnlyAfterLastReferencingReport() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L)
+        val sessionA = FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 2_000L).single()
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            "report-a",
+            1_500L,
+            sessionA,
+            usesPendingTrace = true,
+            nowMs = 2_000L,
+        )
+        FaroCrashSessionStore.rememberPendingReport(
+            context,
+            "report-b",
+            1_600L,
+            sessionA,
+            usesPendingTrace = true,
+            nowMs = 2_000L,
+        )
+
+        val first = FaroCrashSessionStore.acknowledgeReports(context, listOf("report-a"), nowMs = 3_000L)
+        val second = FaroCrashSessionStore.acknowledgeReports(context, listOf("report-b"), nowMs = 4_000L)
+
+        assertTrue(first.persisted)
+        assertFalse(first.clearPendingTrace)
+        assertTrue(second.persisted)
+        assertTrue(second.clearPendingTrace)
+    }
+
+    @Test
+    fun acknowledgeReports_canTombstoneAnIgnoredReportWithoutPendingContext() {
+        val result = FaroCrashSessionStore.acknowledgeReports(
+            context,
+            reportIds = listOf("ignored-report"),
+            nowMs = 1_000L,
+        )
+
+        assertTrue(result.persisted)
+        assertFalse(result.clearPendingTrace)
+        assertTrue(FaroCrashSessionStore.isReportAcknowledged(context, "ignored-report", nowMs = 1_000L))
+    }
+
+    @Test
+    fun sessionContextExpiresOnlyAfterSevenDayBoundary() {
+        val sevenDays = FaroCrashSessionStore.MAX_CONTEXT_AGE_MS
+        recordSession("at-boundary", activatedAtMs = 1L, nowMs = 1_000L)
+
+        assertEquals(
+            1,
+            FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 1_000L + sevenDays).size,
+        )
+        assertTrue(
+            FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 1_001L + sevenDays).isEmpty(),
+        )
+    }
+
+    @Test
+    fun malformedStorageDoesNotPreventNewContextFromBeingRecorded() {
+        context.getSharedPreferences(
+            "com.grafana.faro.crash_session_store",
+            Context.MODE_PRIVATE,
+        ).edit().putString("session_contexts", "not-json").commit()
+
+        assertTrue(recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L))
+        assertEquals(
+            "session-a",
+            FaroCrashSessionStore.sessionContextsForTest(context, nowMs = 1_000L).single().sessionId,
+        )
+    }
+
+    @Test
+    fun findMatchingContext_returnsNullWithoutUsableProcessIdentity() {
+        recordSession("session-a", activatedAtMs = 1_000L, nowMs = 1_000L)
+
+        val match = FaroCrashSessionStore.findMatchingContext(
+            context,
+            crashTimestampMs = 2_000L,
+            pid = 0,
+            processName = "",
+            nowMs = 2_000L,
+        )
+
+        assertNull(match)
+    }
+
+    private fun recordSession(
+        sessionId: String,
+        activatedAtMs: Long,
+        nowMs: Long,
+        pid: Int = 101,
+    ): Boolean {
+        return FaroCrashSessionStore.recordSessionContext(
+            context = context,
+            sessionId = sessionId,
+            activatedAtMs = activatedAtMs,
+            isSampled = true,
+            appVersion = "1.0.0",
+            appRelease = "42",
+            appBundleId = "com.example.app@42@1.0.0",
+            nowMs = nowMs,
+            pid = pid,
+            processName = "com.example.app",
+        )
+    }
+}

package/android/src/test/java/com/grafana/faro/reactnative/FaroCrashTraceCacheTest.kt

@@ -0,0 +1,52 @@
+package com.grafana.faro.reactnative
+
+import android.content.Context
+import androidx.test.core.app.ApplicationProvider
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertNotNull
+import org.junit.Assert.assertNull
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE, sdk = [30])
+class FaroCrashTraceCacheTest {
+
+    private lateinit var context: Context
+
+    @Before
+    fun setUp() {
+        context = ApplicationProvider.getApplicationContext()
+        context.getSharedPreferences(
+            "com.grafana.faro.crash_trace_cache",
+            Context.MODE_PRIVATE,
+        ).edit().clear().commit()
+    }
+
+    @Test
+    fun timestampMismatchDoesNotClearTraceForLaterMatchingReport() {
+        FaroCrashTraceCache.savePendingCrashTrace(context, "java.lang.RuntimeException", 20_000L)
+        val pending = FaroCrashTraceCache.peekPendingCrashTrace(context, 20_001L)
+
+        assertEquals("", FaroCrashTraceCache.traceForExitTimestamp(context, pending, 1_000L))
+        assertNotNull(FaroCrashTraceCache.peekPendingCrashTrace(context, 20_001L))
+        assertEquals(
+            "java.lang.RuntimeException",
+            FaroCrashTraceCache.traceForExitTimestamp(context, pending, 20_000L),
+        )
+    }
+
+    @Test
+    fun traceExpiresAfterReplayWindow() {
+        val timestamp = 20_000L
+        val replayWindow = FaroCrashSessionStore.MAX_CONTEXT_AGE_MS
+        FaroCrashTraceCache.savePendingCrashTrace(context, "java.lang.RuntimeException", timestamp)
+
+        assertNotNull(FaroCrashTraceCache.peekPendingCrashTrace(context, timestamp + replayWindow))
+        assertNull(FaroCrashTraceCache.peekPendingCrashTrace(context, timestamp + replayWindow + 1L))
+        assertNull(FaroCrashTraceCache.peekPendingCrashTrace(context, timestamp + replayWindow + 1L))
+    }
+}

package/android/src/test/java/com/grafana/faro/reactnative/FaroSessionProcessTest.kt

@@ -0,0 +1,127 @@
+package com.grafana.faro.reactnative
+
+import org.junit.After
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertNull
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+
+class FaroSessionProcessTest {
+
+    @Before
+    fun setUp() {
+        FaroSessionProcess.resetPersistenceClaimForTest()
+    }
+
+    @After
+    fun tearDown() {
+        FaroSessionProcess.resetPersistenceClaimForTest()
+    }
+
+    @Test
+    fun normalizeIdentifier_rejectsMissingProcessNames() {
+        assertNull(FaroSessionProcess.normalizeIdentifier(null))
+        assertNull(FaroSessionProcess.normalizeIdentifier("   "))
+    }
+
+    @Test
+    fun normalizeIdentifier_trimsKnownProcessName() {
+        assertEquals(
+            "com.example.app:worker",
+            FaroSessionProcess.normalizeIdentifier("  com.example.app:worker  "),
+        )
+    }
+
+    @Test
+    fun identifier_usesThePlatformApiOnAndroidPAndNewer() {
+        assertEquals(
+            "com.example.app:worker",
+            FaroSessionProcess.identifier(
+                sdkInt = 28,
+                currentProcessName = { "com.example.app:worker" },
+                legacyProcessName = { error("legacy lookup should not run") },
+            ),
+        )
+    }
+
+    @Test
+    fun identifier_readsTheNullTerminatedCmdlineBeforeAndroidP() {
+        assertEquals(
+            "com.example.app:worker",
+            FaroSessionProcess.identifier(
+                sdkInt = 27,
+                currentProcessName = { error("platform lookup should not run") },
+                legacyProcessName = { "com.example.app:worker\u0000ignored" },
+            ),
+        )
+    }
+
+    @Test
+    fun identifier_failsClosedWhenTheProcessNameCannotBeRead() {
+        assertNull(
+            FaroSessionProcess.identifier(
+                sdkInt = 27,
+                currentProcessName = { error("platform lookup should not run") },
+                legacyProcessName = { throw IllegalStateException("unavailable") },
+            ),
+        )
+    }
+
+    @Test
+    fun isMainProcess_comparesCurrentProcessWithDeclaredMainProcess() {
+        assertEquals(
+            true,
+            FaroSessionProcess.isMainProcess(
+                currentName = "com.example.app",
+                declaredMainName = "com.example.app",
+                packageName = "com.example.app",
+            ),
+        )
+        assertEquals(
+            false,
+            FaroSessionProcess.isMainProcess(
+                currentName = "com.example.app:worker",
+                declaredMainName = "com.example.app",
+                packageName = "com.example.app",
+            ),
+        )
+    }
+
+    @Test
+    fun isMainProcess_usesPackageNameWhenMainProcessIsNotDeclared() {
+        assertEquals(
+            true,
+            FaroSessionProcess.isMainProcess(
+                currentName = "com.example.app",
+                declaredMainName = " ",
+                packageName = "com.example.app",
+            ),
+        )
+    }
+
+    @Test
+    fun isMainProcess_failsClosedWithoutCurrentIdentity() {
+        assertNull(
+            FaroSessionProcess.isMainProcess(
+                currentName = null,
+                declaredMainName = "com.example.app",
+                packageName = "com.example.app",
+            ),
+        )
+    }
+
+    @Test
+    fun claimPersistence_allowsOnlyOneOwnerAtATime() {
+        val firstOwner = Any()
+        val secondOwner = Any()
+
+        assertTrue(FaroSessionProcess.claimPersistence(firstOwner))
+        assertTrue(FaroSessionProcess.claimPersistence(firstOwner))
+        assertFalse(FaroSessionProcess.claimPersistence(secondOwner))
+        assertFalse(FaroSessionProcess.releasePersistence(secondOwner))
+        assertTrue(FaroSessionProcess.releasePersistence(firstOwner))
+        assertTrue(FaroSessionProcess.claimPersistence(secondOwner))
+    }
+}

package/dist/cjs/config/getRNInstrumentations.js

@@ -22,8 +22,7 @@ function toRegExpArray(patterns) {
 /**
  * Returns the default set of instrumentations for React Native.
  *
- * Reads all options from the Faro config (single source of truth).
- * Property names are aligned with Flutter SDK FaroConfig:
+ * Reads all options from the Faro config (single source of truth):
  * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals
  * - enableCrashReporting, enableErrorReporting
  * - fetchVitalsInterval, ignoreUrls
@@ -44,7 +43,6 @@ function toRegExpArray(patterns) {
  */
 function getRNInstrumentations(config) {
     if (config === void 0) { config = {}; }
-    // Aligned with Flutter SDK FaroConfig defaults
     var 
     // Error & crash tracking
     _a = config.enableErrorReporting, 
@@ -67,21 +65,21 @@ function getRNInstrumentations(config) {
     // Tracing
     enableTracing = _p === void 0 ? false : _p, _q = config.tracingOptions, tracingOptions = _q === void 0 ? {} : _q;
     var instrumentations = [];
-    // Error reporting (Flutter: enableFlutterErrorReporting)
+    // Error reporting
     if (enableErrorReporting) {
         instrumentations.push(new errors_1.ErrorsInstrumentation({
             releaseBundleFilename: config.releaseBundleFilename,
         }));
     }
-    // Console capture - not in Flutter SDK, RN-specific
+    // Console capture
     if (enableConsoleCapture) {
         instrumentations.push(new console_1.ConsoleInstrumentation());
     }
-    // Sessions - always enabled in Flutter, same here
+    // Sessions
     instrumentations.push(new session_1.SessionInstrumentation());
-    // Views - always enabled in Flutter, same here
+    // Views
     instrumentations.push(new view_1.ViewInstrumentation());
-    // App state - always enabled in Flutter, same here
+    // App state
     instrumentations.push(new appState_1.AppStateInstrumentation());
     // User actions - enabled by default, opt-out via enableUserActions
     if (enableUserActions) {

package/dist/cjs/config/getRNInstrumentations.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRNInstrumentations.js","sourceRoot":"","sources":["../../../src/config/getRNInstrumentations.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { Instrumentation, Patterns } from '@grafana/faro-core';\n\nimport { ANRInstrumentation } from '../instrumentations/anr';\nimport { AppStateInstrumentation } from '../instrumentations/appState';\nimport { ConsoleInstrumentation } from '../instrumentations/console';\nimport { CrashReportingInstrumentation } from '../instrumentations/crashReporting';\nimport { ErrorsInstrumentation } from '../instrumentations/errors';\nimport { FrameMonitoringInstrumentation } from '../instrumentations/frameMonitoring';\nimport { HttpInstrumentation } from '../instrumentations/http';\nimport { PerformanceInstrumentation } from '../instrumentations/performance';\nimport { SessionInstrumentation } from '../instrumentations/session';\nimport { StartupInstrumentation } from '../instrumentations/startup';\nimport { UserActionInstrumentation } from '../instrumentations/userActions';\nimport { ViewInstrumentation } from '../instrumentations/view';\nimport { XHRInstrumentation } from '../instrumentations/xhr';\n\nimport type { ReactNativeConfig } from './types';\n\n/** Convert Patterns (string | RegExp)[] to RegExp[] for instrumentations that require RegExp[]. */\nfunction toRegExpArray(patterns: Patterns): RegExp[] {\n  return patterns.map((p) => (typeof p === 'string' ? new RegExp(p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')) : p));\n}\n\n/**\n * Returns the default set of instrumentations for React Native.\n *\n * Reads all options from the Faro config (single source of truth).\n * Property names are aligned with Flutter SDK FaroConfig:\n * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals\n * - enableCrashReporting, enableErrorReporting\n * - fetchVitalsInterval, ignoreUrls\n *\n * @example\n * ```ts\n * const config: ReactNativeConfig = {\n *   app: { name: 'my-app', version: '1.0.0' },\n *   cpuUsageVitals: true,\n *   memoryUsageVitals: true,\n *   anrTracking: true,\n *   refreshRateVitals: true,\n *   enableCrashReporting: true,\n *   fetchVitalsInterval: 30000,\n *   instrumentations: getRNInstrumentations(config),\n * };\n * ```\n */\nexport function getRNInstrumentations(config: Partial<ReactNativeConfig> = {}): Instrumentation[] {\n  // Aligned with Flutter SDK FaroConfig defaults\n  const {\n    // Error & crash tracking\n    enableErrorReporting = true,\n    enableCrashReporting = false,\n    anrTracking = false,\n    anrOptions = {},\n\n    // Performance vitals\n    cpuUsageVitals = true,\n    memoryUsageVitals = true,\n    refreshRateVitals = false,\n    fetchVitalsInterval = 30000,\n    frameMonitoringOptions = {},\n\n    // Network\n    ignoreUrls = [],\n    enableHttpInstrumentation = {},\n\n    // Console and user actions\n    enableConsoleCapture = true,\n    enableUserActions = true,\n\n    // Tracing\n    enableTracing = false,\n    tracingOptions = {},\n  } = config;\n\n  const instrumentations: Instrumentation[] = [];\n\n  // Error reporting (Flutter: enableFlutterErrorReporting)\n  if (enableErrorReporting) {\n    instrumentations.push(\n      new ErrorsInstrumentation({\n        releaseBundleFilename: config.releaseBundleFilename,\n      })\n    );\n  }\n\n  // Console capture - not in Flutter SDK, RN-specific\n  if (enableConsoleCapture) {\n    instrumentations.push(new ConsoleInstrumentation());\n  }\n\n  // Sessions - always enabled in Flutter, same here\n  instrumentations.push(new SessionInstrumentation());\n\n  // Views - always enabled in Flutter, same here\n  instrumentations.push(new ViewInstrumentation());\n\n  // App state - always enabled in Flutter, same here\n  instrumentations.push(new AppStateInstrumentation());\n\n  // User actions - enabled by default, opt-out via enableUserActions\n  if (enableUserActions) {\n    instrumentations.push(new UserActionInstrumentation());\n  }\n\n  // HTTP/XHR tracking: when tracing is enabled, TracingInstrumentation patches fetch and XHR.\n  // When tracing is disabled, add HttpInstrumentation and/or XHRInstrumentation per enableHttpInstrumentation.\n  if (!enableTracing) {\n    const { fetch: enableFetch = true, xhr: enableXhr = true } = enableHttpInstrumentation;\n    const ignoredUrlsRegExp = toRegExpArray(ignoreUrls);\n    if (enableFetch) {\n      instrumentations.push(new HttpInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n    if (enableXhr) {\n      instrumentations.push(new XHRInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n  }\n\n  // Performance vitals (CPU/memory) - only add if at least one metric is enabled\n  if (cpuUsageVitals || memoryUsageVitals) {\n    const perfInstrumentation = new PerformanceInstrumentation({\n      memoryUsageVitals,\n      cpuUsageVitals,\n      fetchVitalsInterval,\n    });\n    instrumentations.push(perfInstrumentation);\n  }\n\n  // Startup tracking - always enabled\n  instrumentations.push(new StartupInstrumentation());\n\n  // Frame monitoring: enabled when refreshRateVitals is true\n  // The instrumentation reads refreshRateVitals from faro.config (single source of truth)\n  if (refreshRateVitals) {\n    instrumentations.push(new FrameMonitoringInstrumentation(frameMonitoringOptions));\n  }\n\n  // ANR detection (Android only)\n  if (anrTracking && Platform.OS === 'android') {\n    instrumentations.push(new ANRInstrumentation(anrOptions));\n  }\n\n  // Crash reporting\n  if (enableCrashReporting) {\n    instrumentations.push(\n      new CrashReportingInstrumentation({\n        releaseBundleFilename: config.releaseBundleFilename,\n      })\n    );\n  }\n\n  if (enableTracing) {\n    try {\n      const { TracingInstrumentation } = require('@grafana/faro-react-native-tracing');\n      instrumentations.push(new TracingInstrumentation(tracingOptions));\n    } catch {\n      console.warn(\n        '[Faro] enableTracing is true but @grafana/faro-react-native-tracing is not installed. ' +\n          'Add it to use tracing: yarn add @grafana/faro-react-native-tracing'\n      );\n    }\n  }\n\n  return instrumentations;\n}\n"]}
+{"version":3,"file":"getRNInstrumentations.js","sourceRoot":"","sources":["../../../src/config/getRNInstrumentations.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport type { Instrumentation, Patterns } from '@grafana/faro-core';\n\nimport { ANRInstrumentation } from '../instrumentations/anr';\nimport { AppStateInstrumentation } from '../instrumentations/appState';\nimport { ConsoleInstrumentation } from '../instrumentations/console';\nimport { CrashReportingInstrumentation } from '../instrumentations/crashReporting';\nimport { ErrorsInstrumentation } from '../instrumentations/errors';\nimport { FrameMonitoringInstrumentation } from '../instrumentations/frameMonitoring';\nimport { HttpInstrumentation } from '../instrumentations/http';\nimport { PerformanceInstrumentation } from '../instrumentations/performance';\nimport { SessionInstrumentation } from '../instrumentations/session';\nimport { StartupInstrumentation } from '../instrumentations/startup';\nimport { UserActionInstrumentation } from '../instrumentations/userActions';\nimport { ViewInstrumentation } from '../instrumentations/view';\nimport { XHRInstrumentation } from '../instrumentations/xhr';\n\nimport type { ReactNativeConfig } from './types';\n\n/** Convert Patterns (string | RegExp)[] to RegExp[] for instrumentations that require RegExp[]. */\nfunction toRegExpArray(patterns: Patterns): RegExp[] {\n  return patterns.map((p) => (typeof p === 'string' ? new RegExp(p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')) : p));\n}\n\n/**\n * Returns the default set of instrumentations for React Native.\n *\n * Reads all options from the Faro config (single source of truth):\n * - cpuUsageVitals, memoryUsageVitals, anrTracking, refreshRateVitals\n * - enableCrashReporting, enableErrorReporting\n * - fetchVitalsInterval, ignoreUrls\n *\n * @example\n * ```ts\n * const config: ReactNativeConfig = {\n *   app: { name: 'my-app', version: '1.0.0' },\n *   cpuUsageVitals: true,\n *   memoryUsageVitals: true,\n *   anrTracking: true,\n *   refreshRateVitals: true,\n *   enableCrashReporting: true,\n *   fetchVitalsInterval: 30000,\n *   instrumentations: getRNInstrumentations(config),\n * };\n * ```\n */\nexport function getRNInstrumentations(config: Partial<ReactNativeConfig> = {}): Instrumentation[] {\n  const {\n    // Error & crash tracking\n    enableErrorReporting = true,\n    enableCrashReporting = false,\n    anrTracking = false,\n    anrOptions = {},\n\n    // Performance vitals\n    cpuUsageVitals = true,\n    memoryUsageVitals = true,\n    refreshRateVitals = false,\n    fetchVitalsInterval = 30000,\n    frameMonitoringOptions = {},\n\n    // Network\n    ignoreUrls = [],\n    enableHttpInstrumentation = {},\n\n    // Console and user actions\n    enableConsoleCapture = true,\n    enableUserActions = true,\n\n    // Tracing\n    enableTracing = false,\n    tracingOptions = {},\n  } = config;\n\n  const instrumentations: Instrumentation[] = [];\n\n  // Error reporting\n  if (enableErrorReporting) {\n    instrumentations.push(\n      new ErrorsInstrumentation({\n        releaseBundleFilename: config.releaseBundleFilename,\n      })\n    );\n  }\n\n  // Console capture\n  if (enableConsoleCapture) {\n    instrumentations.push(new ConsoleInstrumentation());\n  }\n\n  // Sessions\n  instrumentations.push(new SessionInstrumentation());\n\n  // Views\n  instrumentations.push(new ViewInstrumentation());\n\n  // App state\n  instrumentations.push(new AppStateInstrumentation());\n\n  // User actions - enabled by default, opt-out via enableUserActions\n  if (enableUserActions) {\n    instrumentations.push(new UserActionInstrumentation());\n  }\n\n  // HTTP/XHR tracking: when tracing is enabled, TracingInstrumentation patches fetch and XHR.\n  // When tracing is disabled, add HttpInstrumentation and/or XHRInstrumentation per enableHttpInstrumentation.\n  if (!enableTracing) {\n    const { fetch: enableFetch = true, xhr: enableXhr = true } = enableHttpInstrumentation;\n    const ignoredUrlsRegExp = toRegExpArray(ignoreUrls);\n    if (enableFetch) {\n      instrumentations.push(new HttpInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n    if (enableXhr) {\n      instrumentations.push(new XHRInstrumentation({ ignoredUrls: ignoredUrlsRegExp }));\n    }\n  }\n\n  // Performance vitals (CPU/memory) - only add if at least one metric is enabled\n  if (cpuUsageVitals || memoryUsageVitals) {\n    const perfInstrumentation = new PerformanceInstrumentation({\n      memoryUsageVitals,\n      cpuUsageVitals,\n      fetchVitalsInterval,\n    });\n    instrumentations.push(perfInstrumentation);\n  }\n\n  // Startup tracking - always enabled\n  instrumentations.push(new StartupInstrumentation());\n\n  // Frame monitoring: enabled when refreshRateVitals is true\n  // The instrumentation reads refreshRateVitals from faro.config (single source of truth)\n  if (refreshRateVitals) {\n    instrumentations.push(new FrameMonitoringInstrumentation(frameMonitoringOptions));\n  }\n\n  // ANR detection (Android only)\n  if (anrTracking && Platform.OS === 'android') {\n    instrumentations.push(new ANRInstrumentation(anrOptions));\n  }\n\n  // Crash reporting\n  if (enableCrashReporting) {\n    instrumentations.push(\n      new CrashReportingInstrumentation({\n        releaseBundleFilename: config.releaseBundleFilename,\n      })\n    );\n  }\n\n  if (enableTracing) {\n    try {\n      const { TracingInstrumentation } = require('@grafana/faro-react-native-tracing');\n      instrumentations.push(new TracingInstrumentation(tracingOptions));\n    } catch {\n      console.warn(\n        '[Faro] enableTracing is true but @grafana/faro-react-native-tracing is not installed. ' +\n          'Add it to use tracing: yarn add @grafana/faro-react-native-tracing'\n      );\n    }\n  }\n\n  return instrumentations;\n}\n"]}

package/dist/cjs/config/sampling.js.map

@@ -1 +1 @@
-{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../../../src/config/sampling.ts"],"names":[],"mappings":";;;AA+EA;;;;;;;;;;;;GAYG;AACH;IACE;;;;OAIG;IACH,sBAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE5C,8BAAO,GAAP,UAAQ,QAAyB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACH,mBAAC;AAAD,CAAC,AAXD,IAWC;AAXY,oCAAY;AAazB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACE;;;;;OAKG;IACH,0BAA6B,EAAwC;QAAxC,OAAE,GAAF,EAAE,CAAsC;IAAG,CAAC;IAEzE,kCAAO,GAAP,UAAQ,OAAwB;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACH,uBAAC;AAAD,CAAC,AAZD,IAYC;AAZY,4CAAgB","sourcesContent":["import type { Meta } from '@grafana/faro-core';\n\n/**\n * Context passed to sampling implementations.\n *\n * Provides access to the current metadata state at SDK initialization time,\n * allowing sampling decisions based on session attributes, user info, app\n * environment, and other metadata.\n *\n * This aligns with the Faro Flutter SDK's `SamplingContext` which provides\n * `meta` to the sampler.\n *\n * @example\n * ```ts\n * sampling: SamplingFunction((context) => {\n *   // Sample all beta users\n *   if (context.meta.user?.attributes?.['role'] === 'beta') {\n *     return 1;\n *   }\n *   // Sample 10% of production sessions\n *   if (context.meta.app?.environment === 'production') {\n *     return 0.1;\n *   }\n *   return 1;\n * })\n * ```\n */\nexport interface SamplingContext {\n  /** The current merged metadata state (session, user, app, sdk, view). */\n  meta: Meta;\n}\n\n/**\n * Defines how sessions should be sampled.\n *\n * Implement this interface to provide custom sampling logic. Use one of the\n * built-in implementations:\n * - {@link SamplingRate} for a fixed sampling rate\n * - {@link SamplingFunction} for dynamic sampling based on context\n *\n * @example\n * ```ts\n * // Fixed 10% sampling\n * sessionTracking: {\n *   sampling: new SamplingRate(0.1),\n * }\n *\n * // Dynamic sampling based on context\n * sessionTracking: {\n *   sampling: new SamplingFunction((context) => {\n *     if (context.meta.app?.environment === 'production') {\n *       return 0.1;\n *     }\n *     return 1;\n *   }),\n * }\n *\n * // Custom implementation\n * class BetaUserSampling implements Sampling {\n *   resolve(context: SamplingContext): number {\n *     return context.meta.user?.attributes?.['role'] === 'beta' ? 1 : 0.1;\n *   }\n * }\n * sessionTracking: { sampling: new BetaUserSampling() }\n * ```\n */\nexport interface Sampling {\n  /**\n   * Resolves the sampling rate for the given context.\n   *\n   * @param context - The current metadata state\n   * @returns A value between 0 and 1 (inclusive). Values are clamped to [0, 1].\n   *   - 1: Sample all sessions (100%)\n   *   - 0.5: Sample half of sessions (50%)\n   *   - 0: Sample no sessions (0%)\n   */\n  resolve(context: SamplingContext): number;\n}\n\n/**\n * Fixed sampling rate.\n *\n * Use this when you want a constant sampling probability regardless of\n * session context.\n *\n * @example\n * ```ts\n * sessionTracking: {\n *   sampling: new SamplingRate(0.1), // 10% of sessions\n * }\n * ```\n */\nexport class SamplingRate implements Sampling {\n  /**\n   * Creates a fixed sampling rate.\n   *\n   * @param rate - The fixed sampling rate (0 to 1). Values are clamped to [0, 1].\n   */\n  constructor(public readonly rate: number) {}\n\n  resolve(_context: SamplingContext): number {\n    return Math.max(0, Math.min(1, this.rate));\n  }\n}\n\n/**\n * Dynamic sampling based on context.\n *\n * Use this when you want to make sampling decisions based on session\n * metadata like user attributes, app environment, or other context.\n *\n * @example\n * ```ts\n * sessionTracking: {\n *   sampling: new SamplingFunction((context) => {\n *     // Sample all beta users\n *     if (context.meta.user?.attributes?.['role'] === 'beta') {\n *       return 1;\n *     }\n *     // Sample 10% of production sessions\n *     if (context.meta.app?.environment === 'production') {\n *       return 0.1;\n *     }\n *     return 1;\n *   }),\n * }\n * ```\n */\nexport class SamplingFunction implements Sampling {\n  /**\n   * Creates a dynamic sampler with the given function.\n   *\n   * @param fn - The function that determines the rate based on context.\n   *   Receives a {@link SamplingContext} and should return a rate between 0 and 1.\n   */\n  constructor(private readonly fn: (context: SamplingContext) => number) {}\n\n  resolve(context: SamplingContext): number {\n    return Math.max(0, Math.min(1, this.fn(context)));\n  }\n}\n"]}
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../../../src/config/sampling.ts"],"names":[],"mappings":";;;AA4EA;;;;;;;;;;;;GAYG;AACH;IACE;;;;OAIG;IACH,sBAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE5C,8BAAO,GAAP,UAAQ,QAAyB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACH,mBAAC;AAAD,CAAC,AAXD,IAWC;AAXY,oCAAY;AAazB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACE;;;;;OAKG;IACH,0BAA6B,EAAwC;QAAxC,OAAE,GAAF,EAAE,CAAsC;IAAG,CAAC;IAEzE,kCAAO,GAAP,UAAQ,OAAwB;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACH,uBAAC;AAAD,CAAC,AAZD,IAYC;AAZY,4CAAgB","sourcesContent":["import type { Meta } from '@grafana/faro-core';\n\n/**\n * Context passed to sampling implementations.\n *\n * Provides access to the current metadata state at SDK initialization time,\n * allowing sampling decisions based on session attributes, user info, app\n * environment, and other metadata.\n *\n * @example\n * ```ts\n * sampling: SamplingFunction((context) => {\n *   // Sample all beta users\n *   if (context.meta.user?.attributes?.['role'] === 'beta') {\n *     return 1;\n *   }\n *   // Sample 10% of production sessions\n *   if (context.meta.app?.environment === 'production') {\n *     return 0.1;\n *   }\n *   return 1;\n * })\n * ```\n */\nexport interface SamplingContext {\n  /** The current merged metadata state (session, user, app, sdk, view). */\n  meta: Meta;\n}\n\n/**\n * Defines how sessions should be sampled.\n *\n * Implement this interface to provide custom sampling logic. Use one of the\n * built-in implementations:\n * - {@link SamplingRate} for a fixed sampling rate\n * - {@link SamplingFunction} for dynamic sampling based on context\n *\n * @example\n * ```ts\n * // Fixed 10% sampling\n * sessionTracking: {\n *   sampling: new SamplingRate(0.1),\n * }\n *\n * // Dynamic sampling based on context\n * sessionTracking: {\n *   sampling: new SamplingFunction((context) => {\n *     if (context.meta.app?.environment === 'production') {\n *       return 0.1;\n *     }\n *     return 1;\n *   }),\n * }\n *\n * // Custom implementation\n * class BetaUserSampling implements Sampling {\n *   resolve(context: SamplingContext): number {\n *     return context.meta.user?.attributes?.['role'] === 'beta' ? 1 : 0.1;\n *   }\n * }\n * sessionTracking: { sampling: new BetaUserSampling() }\n * ```\n */\nexport interface Sampling {\n  /**\n   * Resolves the sampling rate for the given context.\n   *\n   * @param context - The current metadata state\n   * @returns A value between 0 and 1 (inclusive). Values are clamped to [0, 1].\n   *   - 1: Sample all sessions (100%)\n   *   - 0.5: Sample half of sessions (50%)\n   *   - 0: Sample no sessions (0%)\n   */\n  resolve(context: SamplingContext): number;\n}\n\n/**\n * Fixed sampling rate.\n *\n * Use this when you want a constant sampling probability regardless of\n * session context.\n *\n * @example\n * ```ts\n * sessionTracking: {\n *   sampling: new SamplingRate(0.1), // 10% of sessions\n * }\n * ```\n */\nexport class SamplingRate implements Sampling {\n  /**\n   * Creates a fixed sampling rate.\n   *\n   * @param rate - The fixed sampling rate (0 to 1). Values are clamped to [0, 1].\n   */\n  constructor(public readonly rate: number) {}\n\n  resolve(_context: SamplingContext): number {\n    return Math.max(0, Math.min(1, this.rate));\n  }\n}\n\n/**\n * Dynamic sampling based on context.\n *\n * Use this when you want to make sampling decisions based on session\n * metadata like user attributes, app environment, or other context.\n *\n * @example\n * ```ts\n * sessionTracking: {\n *   sampling: new SamplingFunction((context) => {\n *     // Sample all beta users\n *     if (context.meta.user?.attributes?.['role'] === 'beta') {\n *       return 1;\n *     }\n *     // Sample 10% of production sessions\n *     if (context.meta.app?.environment === 'production') {\n *       return 0.1;\n *     }\n *     return 1;\n *   }),\n * }\n * ```\n */\nexport class SamplingFunction implements Sampling {\n  /**\n   * Creates a dynamic sampler with the given function.\n   *\n   * @param fn - The function that determines the rate based on context.\n   *   Receives a {@link SamplingContext} and should return a rate between 0 and 1.\n   */\n  constructor(private readonly fn: (context: SamplingContext) => number) {}\n\n  resolve(context: SamplingContext): number {\n    return Math.max(0, Math.min(1, this.fn(context)));\n  }\n}\n"]}

package/dist/cjs/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport type { ANRInstrumentationOptions } from '../instrumentations/anr';\nimport type { FrameMonitoringOptions } from '../instrumentations/frameMonitoring';\nimport type { PreloadedMobileMeta, SessionAttributes } from '../instrumentations/session/sessionAttributes';\n\nimport type { Sampling } from './sampling';\n\n/**\n * React Native session tracking config.\n * Extends Config['sessionTracking'] with sampling (Flutter-style) and RN-specific props.\n * Excludes samplingRate and sampler in favor of sampling.\n *\n * When `persistent` is true, sessions are stored with [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv)\n * (synchronous). Add `react-native-mmkv` to your app and rebuild native projects.\n */\nexport type ReactNativeSessionTrackingConfig = Omit<\n  NonNullable<Config['sessionTracking']>,\n  'samplingRate' | 'sampler'\n> & {\n  /**\n   * Session sampling. Use {@link SamplingRate} for fixed rate or\n   * {@link SamplingFunction} for dynamic sampling.\n   */\n  sampling?: Sampling;\n};\n\n/**\n * Flags for enabling optional built-in transports.\n * FetchTransport is always instantiated when url is provided.\n */\nexport interface EnableTransportsConfig {\n  /** Enable OfflineTransport for caching when offline (default: false) */\n  offline?: boolean;\n  /** Enable ConsoleTransport to log telemetry to Metro console for debugging (default: false) */\n  console?: boolean;\n}\n\n/** RN-specific config: overrides + new props. Omit faro-core props we replace with RN equivalents. */\ntype ReactNativeConfigOverrides = {\n  /** Application metadata (required) */\n  app: Config['app'];\n  sessionTracking?: ReactNativeSessionTrackingConfig;\n  url?: string;\n  apiKey?: string;\n  enableTransports?: EnableTransportsConfig;\n  /**\n   * Which HTTP instrumentations to enable. When tracing is disabled, these control\n   * HttpInstrumentation (fetch) and XHRInstrumentation (xhr). Default: both true.\n   */\n  enableHttpInstrumentation?: {\n    /** HttpInstrumentation - patches fetch API (default: true) */\n    fetch?: boolean;\n    /** XHRInstrumentation - patches XMLHttpRequest (default: true) */\n    xhr?: boolean;\n  };\n  enableTracing?: boolean;\n  /** Passed to TracingInstrumentation. See TracingInstrumentationOptions in @grafana/faro-react-native-tracing. */\n  tracingOptions?: Record<string, unknown>;\n  cpuUsageVitals?: boolean;\n  memoryUsageVitals?: boolean;\n  refreshRateVitals?: boolean;\n  fetchVitalsInterval?: number;\n  frameMonitoringOptions?: FrameMonitoringOptions;\n  enableErrorReporting?: boolean;\n  enableCrashReporting?: boolean;\n  anrTracking?: boolean;\n  anrOptions?: ANRInstrumentationOptions;\n  enableConsoleCapture?: boolean;\n  consoleCaptureOptions?: Config['consoleInstrumentation'];\n  enableUserActions?: boolean;\n  userActionsOptions?: Config['userActionsInstrumentation'];\n  /**\n   * Hermes / minified release stack lines omit a file path. This must match the Metro plugin\n   * source map top-level `file` (default `bundle.js`, or your `sourceMapFile` option there).\n   */\n  releaseBundleFilename?: string;\n};\n\n/**\n * React Native config: Config (omit replaced props) & overrides.\n * Omit: sessionTracking, consoleInstrumentation, userActionsInstrumentation.\n * instrumentations and transports inherited from Config for extras (built-ins come from flags).\n */\nexport type ReactNativeConfig = Partial<\n  Omit<Config, 'sessionTracking' | 'consoleInstrumentation' | 'userActionsInstrumentation'>\n> &\n  ReactNativeConfigOverrides;\n\n/**\n * Internal full config returned by `makeRNConfig`.\n * Extends faro-core `Config` with RN-specific fields that instrumentations need at init time.\n */\nexport type ReactNativeFullConfig = Config & {\n  preloadedMobileMeta?: PreloadedMobileMeta['meta'];\n  preloadedSessionDeviceAttributes?: SessionAttributes;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Config } from '@grafana/faro-core';\n\nimport type { ANRInstrumentationOptions } from '../instrumentations/anr';\nimport type { FrameMonitoringOptions } from '../instrumentations/frameMonitoring';\nimport type { PreloadedMobileMeta, SessionAttributes } from '../instrumentations/session/sessionAttributes';\n\nimport type { Sampling } from './sampling';\n\n/**\n * React Native session tracking config.\n * Extends Config['sessionTracking'] with sampling and RN-specific props.\n * Excludes samplingRate and sampler in favor of sampling.\n *\n * Persistence defaults to true and stores a minimal, versioned record with\n * [react-native-mmkv](https://github.com/mrousavy/react-native-mmkv) (synchronous).\n * Add `react-native-mmkv` to your app and rebuild native projects, or set\n * `persistent` to false to use in-memory sessions.\n */\nexport type ReactNativeSessionTrackingConfig = Omit<\n  NonNullable<Config['sessionTracking']>,\n  'samplingRate' | 'sampler'\n> & {\n  /**\n   * Session sampling. Use {@link SamplingRate} for fixed rate or\n   * {@link SamplingFunction} for dynamic sampling.\n   */\n  sampling?: Sampling;\n};\n\n/**\n * Flags for enabling optional built-in transports.\n * FetchTransport is always instantiated when url is provided.\n */\nexport interface EnableTransportsConfig {\n  /** Enable OfflineTransport for caching when offline (default: false) */\n  offline?: boolean;\n  /** Enable ConsoleTransport to log telemetry to Metro console for debugging (default: false) */\n  console?: boolean;\n}\n\n/** RN-specific config: overrides + new props. Omit faro-core props we replace with RN equivalents. */\ntype ReactNativeConfigOverrides = {\n  /** Application metadata (required) */\n  app: Config['app'];\n  sessionTracking?: ReactNativeSessionTrackingConfig;\n  url?: string;\n  apiKey?: string;\n  enableTransports?: EnableTransportsConfig;\n  /**\n   * Which HTTP instrumentations to enable. When tracing is disabled, these control\n   * HttpInstrumentation (fetch) and XHRInstrumentation (xhr). Default: both true.\n   */\n  enableHttpInstrumentation?: {\n    /** HttpInstrumentation - patches fetch API (default: true) */\n    fetch?: boolean;\n    /** XHRInstrumentation - patches XMLHttpRequest (default: true) */\n    xhr?: boolean;\n  };\n  enableTracing?: boolean;\n  /** Passed to TracingInstrumentation. See TracingInstrumentationOptions in @grafana/faro-react-native-tracing. */\n  tracingOptions?: Record<string, unknown>;\n  cpuUsageVitals?: boolean;\n  memoryUsageVitals?: boolean;\n  refreshRateVitals?: boolean;\n  fetchVitalsInterval?: number;\n  frameMonitoringOptions?: FrameMonitoringOptions;\n  enableErrorReporting?: boolean;\n  enableCrashReporting?: boolean;\n  anrTracking?: boolean;\n  anrOptions?: ANRInstrumentationOptions;\n  enableConsoleCapture?: boolean;\n  consoleCaptureOptions?: Config['consoleInstrumentation'];\n  enableUserActions?: boolean;\n  userActionsOptions?: Config['userActionsInstrumentation'];\n  /**\n   * Hermes / minified release stack lines omit a file path. This must match the Metro plugin\n   * source map top-level `file` (default `bundle.js`, or your `sourceMapFile` option there).\n   */\n  releaseBundleFilename?: string;\n};\n\n/**\n * React Native config: Config (omit replaced props) & overrides.\n * Omit: sessionTracking, consoleInstrumentation, userActionsInstrumentation.\n * instrumentations and transports inherited from Config for extras (built-ins come from flags).\n */\nexport type ReactNativeConfig = Partial<\n  Omit<Config, 'sessionTracking' | 'consoleInstrumentation' | 'userActionsInstrumentation'>\n> &\n  ReactNativeConfigOverrides;\n\n/**\n * Internal full config returned by `makeRNConfig`.\n * Extends faro-core `Config` with RN-specific fields that instrumentations need at init time.\n */\nexport type ReactNativeFullConfig = Config & {\n  preloadedMobileMeta?: PreloadedMobileMeta['meta'];\n  preloadedSessionDeviceAttributes?: SessionAttributes;\n};\n"]}

package/dist/cjs/dataCollection/DataCollectionPolicy.js

@@ -55,8 +55,7 @@ var DEFAULT_STORAGE_KEY = 'faro_enable_data_collection';
  * Controls whether telemetry data is collected and sent.
  * The setting is persisted to AsyncStorage so it survives app restarts.
  *
- * Implementation follows Flutter SDK's DataCollectionPolicy pattern:
- * - Uses AsyncStorage for persistence (matching Flutter's SharedPreferences)
+ * Uses AsyncStorage for persisting data collection policy state.
  * - Provides enable/disable methods
  * - Initializes from persisted value or default
  *

package/dist/cjs/dataCollection/DataCollectionPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataCollectionPolicy.js","sourceRoot":"","sources":["../../../src/dataCollection/DataCollectionPolicy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4HA,gEAIC;AA2BD,wEAKC;AAOD,0DAEC;AAOD,0DAEC;AAlLD,4FAAqE;AAIrE;;GAEG;AACH,IAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAKE,0CAAoB,OAAyC;QAAzC,wBAAA,EAAA,YAAyC;;QAF5C,gBAAW,GAAsC,IAAI,GAAG,EAAE,CAAC;QAG1E,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,cAAc,mCAAI,IAAI,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACU,uCAAM,GAAnB;4DAAoB,OAAyC;;YAAzC,wBAAA,EAAA,YAAyC;;;;wBACrD,MAAM,GAAG,IAAI,gCAAgC,CAAC,OAAO,CAAC,CAAC;wBAC7D,qBAAM,MAAM,CAAC,UAAU,EAAE,EAAA;;wBAAzB,SAAyB,CAAC;wBAC1B,sBAAO,MAAM,EAAC;;;;KACf;IAED,sBAAI,uDAAS;aAAb;YACE,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;;;OAAA;IAEK,iDAAM,GAAZ;;;;;wBACE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;wBACvB,qBAAM,IAAI,CAAC,cAAc,EAAE,EAAA;;wBAA3B,SAA2B,CAAC;wBAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;;;;;KAC1B;IAEK,kDAAO,GAAb;;;;;wBACE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;wBACxB,qBAAM,IAAI,CAAC,cAAc,EAAE,EAAA;;wBAA3B,SAA2B,CAAC;wBAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;;;;;KAC1B;IAED,oDAAS,GAAT,UAAU,QAAsC;QAAhD,iBAQC;QAPC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,iDAAiD;QACjD,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1B,OAAO;YACL,KAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC;IAEa,qDAAU,GAAxB;;;;;;;wBAEwB,qBAAM,uBAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAA;;wBAAzD,WAAW,GAAG,SAA2C;wBAC/D,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;4BACzB,IAAI,CAAC,UAAU,GAAG,WAAW,KAAK,MAAM,CAAC;wBAC3C,CAAC;;;;;;;;;KAIJ;IAEa,yDAAc,GAA5B;;;;;;;wBAEI,qBAAM,uBAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAA;;wBAApE,SAAoE,CAAC;;;;;;;;;KAIxE;IAEO,4DAAiB,GAAzB;QAAA,iBAQC;QAPC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAC,UAAU;YAClC,IAAI,CAAC;gBACH,UAAU,CAAC,KAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,CAAC;YAAC,WAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IACH,uCAAC;AAAD,CAAC,AA3ED,IA2EC;AA3EY,4EAAgC;AA6E7C;;;;;;;GAOG;AACH,SAAsB,0BAA0B;wDAC9C,OAAyC;QAAzC,wBAAA,EAAA,YAAyC;;YAEzC,sBAAO,gCAAgC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAC;;;CACzD;AAED;;;GAGG;AACH,IAAI,YAAY,GAAgC,IAAI,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAsB,8BAA8B;wDAClD,OAAyC;QAAzC,wBAAA,EAAA,YAAyC;;;wBAE1B,qBAAM,0BAA0B,CAAC,OAAO,CAAC,EAAA;;oBAAxD,YAAY,GAAG,SAAyC,CAAC;oBACzD,sBAAO,YAAY,EAAC;;;;CACrB;AAED;;;;GAIG;AACH,SAAgB,uBAAuB;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,MAAmC;IACzE,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC","sourcesContent":["import AsyncStorage from '@react-native-async-storage/async-storage';\n\nimport type { DataCollectionPolicy, DataCollectionPolicyOptions } from './types';\n\n/**\n * Default storage key for the data collection policy.\n */\nconst DEFAULT_STORAGE_KEY = 'faro_enable_data_collection';\n\n/**\n * DataCollectionPolicy implementation using AsyncStorage.\n *\n * Controls whether telemetry data is collected and sent.\n * The setting is persisted to AsyncStorage so it survives app restarts.\n *\n * Implementation follows Flutter SDK's DataCollectionPolicy pattern:\n * - Uses AsyncStorage for persistence (matching Flutter's SharedPreferences)\n * - Provides enable/disable methods\n * - Initializes from persisted value or default\n *\n * @example\n * ```typescript\n * import { createDataCollectionPolicy } from '@grafana/faro-react-native';\n *\n * // Create and initialize the policy\n * const policy = await createDataCollectionPolicy();\n *\n * // Check if enabled\n * if (policy.isEnabled) {\n *   // Data collection is allowed\n * }\n *\n * // User opts out\n * await policy.disable();\n *\n * // User opts back in\n * await policy.enable();\n * ```\n */\nexport class AsyncStorageDataCollectionPolicy implements DataCollectionPolicy {\n  private _isEnabled: boolean;\n  private readonly storageKey: string;\n  private readonly subscribers: Set<(isEnabled: boolean) => void> = new Set();\n\n  private constructor(options: DataCollectionPolicyOptions = {}) {\n    this.storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n    this._isEnabled = options.defaultEnabled ?? true;\n  }\n\n  /**\n   * Create and initialize a DataCollectionPolicy.\n   *\n   * This async factory method loads the persisted value from AsyncStorage.\n   */\n  static async create(options: DataCollectionPolicyOptions = {}): Promise<AsyncStorageDataCollectionPolicy> {\n    const policy = new AsyncStorageDataCollectionPolicy(options);\n    await policy.initialize();\n    return policy;\n  }\n\n  get isEnabled(): boolean {\n    return this._isEnabled;\n  }\n\n  async enable(): Promise<void> {\n    this._isEnabled = true;\n    await this.persistSetting();\n    this.notifySubscribers();\n  }\n\n  async disable(): Promise<void> {\n    this._isEnabled = false;\n    await this.persistSetting();\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (isEnabled: boolean) => void): () => void {\n    this.subscribers.add(callback);\n    // Immediately notify subscriber of current state\n    callback(this._isEnabled);\n\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private async initialize(): Promise<void> {\n    try {\n      const storedValue = await AsyncStorage.getItem(this.storageKey);\n      if (storedValue !== null) {\n        this._isEnabled = storedValue === 'true';\n      }\n    } catch {\n      // If loading fails, use default value\n    }\n  }\n\n  private async persistSetting(): Promise<void> {\n    try {\n      await AsyncStorage.setItem(this.storageKey, String(this._isEnabled));\n    } catch {\n      // If persisting fails, log but don't throw\n    }\n  }\n\n  private notifySubscribers(): void {\n    this.subscribers.forEach((subscriber) => {\n      try {\n        subscriber(this._isEnabled);\n      } catch {\n        // Ignore subscriber errors\n      }\n    });\n  }\n}\n\n/**\n * Factory function to create a DataCollectionPolicy.\n *\n * @example\n * ```typescript\n * const policy = await createDataCollectionPolicy();\n * ```\n */\nexport async function createDataCollectionPolicy(\n  options: DataCollectionPolicyOptions = {}\n): Promise<DataCollectionPolicy> {\n  return AsyncStorageDataCollectionPolicy.create(options);\n}\n\n/**\n * Global data collection policy instance.\n * Must be initialized before use.\n */\nlet globalPolicy: DataCollectionPolicy | null = null;\n\n/**\n * Initialize the global data collection policy.\n *\n * This should be called early in app initialization, before initializeFaro().\n *\n * @example\n * ```typescript\n * import { initializeDataCollectionPolicy, getDataCollectionPolicy } from '@grafana/faro-react-native';\n *\n * // Early in app startup\n * await initializeDataCollectionPolicy();\n *\n * // Later, check if collection is enabled\n * const policy = getDataCollectionPolicy();\n * if (policy?.isEnabled) {\n *   // Initialize Faro\n * }\n * ```\n */\nexport async function initializeDataCollectionPolicy(\n  options: DataCollectionPolicyOptions = {}\n): Promise<DataCollectionPolicy> {\n  globalPolicy = await createDataCollectionPolicy(options);\n  return globalPolicy;\n}\n\n/**\n * Get the global data collection policy.\n *\n * Returns null if not initialized.\n */\nexport function getDataCollectionPolicy(): DataCollectionPolicy | null {\n  return globalPolicy;\n}\n\n/**\n * Set a custom data collection policy.\n *\n * Useful for testing or custom implementations.\n */\nexport function setDataCollectionPolicy(policy: DataCollectionPolicy | null): void {\n  globalPolicy = policy;\n}\n"]}
+{"version":3,"file":"DataCollectionPolicy.js","sourceRoot":"","sources":["../../../src/dataCollection/DataCollectionPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["import AsyncStorage from '@react-native-async-storage/async-storage';\n\nimport type { DataCollectionPolicy, DataCollectionPolicyOptions } from './types';\n\n/**\n * Default storage key for the data collection policy.\n */\nconst DEFAULT_STORAGE_KEY = 'faro_enable_data_collection';\n\n/**\n * DataCollectionPolicy implementation using AsyncStorage.\n *\n * Controls whether telemetry data is collected and sent.\n * The setting is persisted to AsyncStorage so it survives app restarts.\n *\n * Uses AsyncStorage for persisting data collection policy state.\n * - Provides enable/disable methods\n * - Initializes from persisted value or default\n *\n * @example\n * ```typescript\n * import { createDataCollectionPolicy } from '@grafana/faro-react-native';\n *\n * // Create and initialize the policy\n * const policy = await createDataCollectionPolicy();\n *\n * // Check if enabled\n * if (policy.isEnabled) {\n *   // Data collection is allowed\n * }\n *\n * // User opts out\n * await policy.disable();\n *\n * // User opts back in\n * await policy.enable();\n * ```\n */\nexport class AsyncStorageDataCollectionPolicy implements DataCollectionPolicy {\n  private _isEnabled: boolean;\n  private readonly storageKey: string;\n  private readonly subscribers: Set<(isEnabled: boolean) => void> = new Set();\n\n  private constructor(options: DataCollectionPolicyOptions = {}) {\n    this.storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;\n    this._isEnabled = options.defaultEnabled ?? true;\n  }\n\n  /**\n   * Create and initialize a DataCollectionPolicy.\n   *\n   * This async factory method loads the persisted value from AsyncStorage.\n   */\n  static async create(options: DataCollectionPolicyOptions = {}): Promise<AsyncStorageDataCollectionPolicy> {\n    const policy = new AsyncStorageDataCollectionPolicy(options);\n    await policy.initialize();\n    return policy;\n  }\n\n  get isEnabled(): boolean {\n    return this._isEnabled;\n  }\n\n  async enable(): Promise<void> {\n    this._isEnabled = true;\n    await this.persistSetting();\n    this.notifySubscribers();\n  }\n\n  async disable(): Promise<void> {\n    this._isEnabled = false;\n    await this.persistSetting();\n    this.notifySubscribers();\n  }\n\n  subscribe(callback: (isEnabled: boolean) => void): () => void {\n    this.subscribers.add(callback);\n    // Immediately notify subscriber of current state\n    callback(this._isEnabled);\n\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  private async initialize(): Promise<void> {\n    try {\n      const storedValue = await AsyncStorage.getItem(this.storageKey);\n      if (storedValue !== null) {\n        this._isEnabled = storedValue === 'true';\n      }\n    } catch {\n      // If loading fails, use default value\n    }\n  }\n\n  private async persistSetting(): Promise<void> {\n    try {\n      await AsyncStorage.setItem(this.storageKey, String(this._isEnabled));\n    } catch {\n      // If persisting fails, log but don't throw\n    }\n  }\n\n  private notifySubscribers(): void {\n    this.subscribers.forEach((subscriber) => {\n      try {\n        subscriber(this._isEnabled);\n      } catch {\n        // Ignore subscriber errors\n      }\n    });\n  }\n}\n\n/**\n * Factory function to create a DataCollectionPolicy.\n *\n * @example\n * ```typescript\n * const policy = await createDataCollectionPolicy();\n * ```\n */\nexport async function createDataCollectionPolicy(\n  options: DataCollectionPolicyOptions = {}\n): Promise<DataCollectionPolicy> {\n  return AsyncStorageDataCollectionPolicy.create(options);\n}\n\n/**\n * Global data collection policy instance.\n * Must be initialized before use.\n */\nlet globalPolicy: DataCollectionPolicy | null = null;\n\n/**\n * Initialize the global data collection policy.\n *\n * This should be called early in app initialization, before initializeFaro().\n *\n * @example\n * ```typescript\n * import { initializeDataCollectionPolicy, getDataCollectionPolicy } from '@grafana/faro-react-native';\n *\n * // Early in app startup\n * await initializeDataCollectionPolicy();\n *\n * // Later, check if collection is enabled\n * const policy = getDataCollectionPolicy();\n * if (policy?.isEnabled) {\n *   // Initialize Faro\n * }\n * ```\n */\nexport async function initializeDataCollectionPolicy(\n  options: DataCollectionPolicyOptions = {}\n): Promise<DataCollectionPolicy> {\n  globalPolicy = await createDataCollectionPolicy(options);\n  return globalPolicy;\n}\n\n/**\n * Get the global data collection policy.\n *\n * Returns null if not initialized.\n */\nexport function getDataCollectionPolicy(): DataCollectionPolicy | null {\n  return globalPolicy;\n}\n\n/**\n * Set a custom data collection policy.\n *\n * Useful for testing or custom implementations.\n */\nexport function setDataCollectionPolicy(policy: DataCollectionPolicy | null): void {\n  globalPolicy = policy;\n}\n"]}

package/dist/cjs/generated/faroRNPackageMeta.js

@@ -5,5 +5,5 @@ exports.FARO_REACT_NATIVE_NPM_VERSION = exports.FARO_REACT_NATIVE_NPM_NAME = voi
  * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.
  */
 exports.FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native';
-exports.FARO_REACT_NATIVE_NPM_VERSION = '1.3.1';
+exports.FARO_REACT_NATIVE_NPM_VERSION = '1.4.0';
 //# sourceMappingURL=faroRNPackageMeta.js.map

package/dist/cjs/generated/faroRNPackageMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"faroRNPackageMeta.js","sourceRoot":"","sources":["../../../src/generated/faroRNPackageMeta.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,0BAA0B,GAAG,4BAAqC,CAAC;AACnE,QAAA,6BAA6B,GAAG,OAAgB,CAAC","sourcesContent":["/**\n * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.\n */\nexport const FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native' as const;\nexport const FARO_REACT_NATIVE_NPM_VERSION = '1.3.1' as const;\n"]}
+{"version":3,"file":"faroRNPackageMeta.js","sourceRoot":"","sources":["../../../src/generated/faroRNPackageMeta.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,0BAA0B,GAAG,4BAAqC,CAAC;AACnE,QAAA,6BAA6B,GAAG,OAAgB,CAAC","sourcesContent":["/**\n * NPM package identity for this build. Generated by scripts/sync-faro-rn-package-meta.mjs - do not edit.\n */\nexport const FARO_REACT_NATIVE_NPM_NAME = '@grafana/faro-react-native' as const;\nexport const FARO_REACT_NATIVE_NPM_VERSION = '1.4.0' as const;\n"]}