@grafana/faro-react-native 1.3.1 → 1.4.1

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/makeRNConfig.js

@@ -124,12 +124,12 @@ function makeRNConfig(config, preloadedMobileMeta, appSymbolsBundleId) {
     var instrumentations = buildInstrumentations(config);
     var installationId = (_c = config.app.installationId) !== null && _c !== void 0 ? _c : preloadedAppMeta === null || preloadedAppMeta === void 0 ? void 0 : preloadedAppMeta.installationId;
     var releaseBundleFilename = config.releaseBundleFilename;
-    // Merge bundleId (from config, Metro, or DeviceInfo) with preloaded app meta
     var bundleIdValue = resolveAppBundleId(config.app, (_d = config.app) === null || _d === void 0 ? void 0 : _d.name, appSymbolsBundleId);
-    var appMetasIfPresent = preloadedAppMeta || bundleIdValue
-        ? [{ app: __assign(__assign({}, preloadedAppMeta), (bundleIdValue && { bundleId: bundleIdValue })) }]
-        : [];
-    return __assign(__assign({ app: __assign(__assign({}, config.app), (installationId && { installationId: installationId })) }, (preloadedMobileMeta != null && {
+    var app = __assign(__assign(__assign(__assign({}, preloadedAppMeta), config.app), (installationId && { installationId: installationId })), (bundleIdValue && { bundleId: bundleIdValue }));
+    // Core merges metadata shallowly. Supply the complete app object so native
+    // metadata cannot replace configured fields such as version and environment.
+    var appMetasIfPresent = preloadedAppMeta || bundleIdValue ? [{ app: app }] : [];
+    return __assign(__assign({ app: app }, (preloadedMobileMeta != null && {
         preloadedMobileMeta: preloadedMobileMeta.meta,
         preloadedSessionDeviceAttributes: preloadedMobileMeta.sessionAttributes,
     })), { dedupe: (_e = config.dedupe) !== null && _e !== void 0 ? _e : true, globalObjectKey: (_f = config.globalObjectKey) !== null && _f !== void 0 ? _f : faro_core_1.defaultGlobalObjectKey, internalLoggerLevel: (_g = config.internalLoggerLevel) !== null && _g !== void 0 ? _g : internalLogger_1.InternalLoggerLevel.ERROR, isolate: (_h = config.isolate) !== null && _h !== void 0 ? _h : false, parseStacktrace: (_j = config.parseStacktrace) !== null && _j !== void 0 ? _j : createParseStacktrace(releaseBundleFilename), paused: (_k = config.paused) !== null && _k !== void 0 ? _k : false, preventGlobalExposure: (_l = config.preventGlobalExposure) !== null && _l !== void 0 ? _l : false, unpatchedConsole: (_m = config.unpatchedConsole) !== null && _m !== void 0 ? _m : faro_core_1.defaultUnpatchedConsole, batching: {

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

@@ -1 +1 @@
-{"version":3,"file":"makeRNConfig.js","sourceRoot":"","sources":["../../../src/config/makeRNConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyGA,oCAyDC;AAlKD,gDAAqF;AAGrF,gFAAsF;AAEtF,gGAA2G;AAC3G,oDAAkE;AAClE,8DAAqE;AACrE,sCAA4C;AAC5C,0CAAgD;AAChD,oCAA0C;AAC1C,iDAAyD;AACzD,6CAAqD;AACrD,iDAAyD;AAEzD,iEAAgE;AAGhE,IAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAEnE;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,SAA8B,EAC9B,OAA2B,EAC3B,kBAA2B;IAE3B,IAAI,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,QAAQ,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC5B,CAAC;IACD,IAAM,OAAO,GAAG,IAAA,2CAAwB,EAAC,OAAO,CAAC,CAAC;IAClD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAyB;;IACxC,IAAA,KAA0D,MAAM,iBAAX,EAArD,gBAAgB,mBAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAA,CAAY;IAEzE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAM,eAAe,GAAyB,EAAE,CAAC;IAEjD,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAClB,IAAI,0BAAgB,CAAC;YACnB,kBAAkB,EAAE,wBAAwB;SAC7C,CAAC,CACH,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,IAAI,CAClB,IAAI,sBAAc,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CACH,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,IAAI,0BAAgB,CAAC,EAAE,KAAK,EAAE,yBAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAM,eAAe,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,CAAC;IAChD,uCAAW,eAAe,SAAK,eAAe,QAAE;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,MAAyB;;IACtD,IAAM,oBAAoB,GAAG,IAAA,6CAAqB,EAAC,MAAM,CAAC,CAAC;IAC3D,IAAM,qBAAqB,GAAG,MAAA,MAAM,CAAC,gBAAgB,mCAAI,EAAE,CAAC;IAC5D,uCAAW,oBAAoB,SAAK,qBAAqB,QAAE;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,qBAAyC;IACtE,OAAO,UAAC,GAAG,IAAK,OAAA,CAAC;QACf,MAAM,EAAE,IAAA,0CAAuB,EAAC,GAAG,EAAE,EAAE,qBAAqB,uBAAA,EAAE,CAAC;KAChE,CAAC,EAFc,CAEd,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,MAAyB,EACzB,mBAAyC,EACzC,kBAA2B;;IAE3B,IAAM,KAAqD,MAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,IAAI,mCAAI,EAAE,EAA7E,gBAAgB,SAAA,EAAK,oBAAoB,cAAhD,OAAkD,CAAkC,CAAC;IAC3F,IAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,IAAM,YAAY,kBAAI,IAAA,gBAAU,GAAE,EAAE,IAAA,kBAAW,GAAE,EAAE,IAAA,sBAAa,GAAE,GAAK,WAAW,OAAC,CAAC;IACpF,IAAM,WAAW,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,EAAE,CAAC;IACvC,IAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,IAAM,cAAc,GAAG,MAAA,MAAM,CAAC,GAAG,CAAC,cAAc,mCAAI,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,cAAc,CAAC;IAErF,IAAM,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAC3D,6EAA6E;IAC7E,IAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAA,MAAM,CAAC,GAAG,0CAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC3F,IAAM,iBAAiB,GACrB,gBAAgB,IAAI,aAAa;QAC/B,CAAC,CAAC,CAAC,EAAE,GAAG,wBAAO,gBAAgB,GAAK,CAAC,aAAa,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAE,EAAE,CAAC;QACvF,CAAC,CAAC,EAAE,CAAC;IAET,2BACE,GAAG,wBACE,MAAM,CAAC,GAAG,GACV,CAAC,cAAc,IAAI,EAAE,cAAc,gBAAA,EAAE,CAAC,KAExC,CAAC,mBAAmB,IAAI,IAAI,IAAI;QACjC,mBAAmB,EAAE,mBAAmB,CAAC,IAAI;QAC7C,gCAAgC,EAAE,mBAAmB,CAAC,iBAAiB;KACxE,CAAC,KACF,MAAM,EAAE,MAAA,MAAM,CAAC,MAAM,mCAAI,IAAI,EAC7B,eAAe,EAAE,MAAA,MAAM,CAAC,eAAe,mCAAI,kCAAsB,EACjE,mBAAmB,EAAE,MAAA,MAAM,CAAC,mBAAmB,mCAAI,oCAAmB,CAAC,KAAK,EAC5E,OAAO,EAAE,MAAA,MAAM,CAAC,OAAO,mCAAI,KAAK,EAChC,eAAe,EAAE,MAAA,MAAM,CAAC,eAAe,mCAAI,qBAAqB,CAAC,qBAAqB,CAAC,EACvF,MAAM,EAAE,MAAA,MAAM,CAAC,MAAM,mCAAI,KAAK,EAC9B,qBAAqB,EAAE,MAAA,MAAM,CAAC,qBAAqB,mCAAI,KAAK,EAC5D,gBAAgB,EAAE,MAAA,MAAM,CAAC,gBAAgB,mCAAI,mCAAuB,EACpE,QAAQ,EAAE;YACR,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,EAAE;SACd,EACD,eAAe,wBACV,+CAA4B,GAC5B,MAAM,CAAC,eAAe,GAE3B,KAAK,gDAAM,YAAY,SAAK,WAAW,SAAK,iBAAiB,SAC7D,gBAAgB,kBAAA,EAChB,UAAU,YAAA,EACV,UAAU,EAAE,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,EACnC,YAAY,EAAE,MAAM,CAAC,YAAY,EACjC,UAAU,EAAE,MAAM,CAAC,UAAU,EAC7B,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EACnD,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,EACrD,sBAAsB,EAAE,MAAM,CAAC,qBAAqB,IACpD;AACJ,CAAC","sourcesContent":["import { defaultGlobalObjectKey, defaultUnpatchedConsole } from '@grafana/faro-core';\nimport type { Config, MetaApp } from '@grafana/faro-core';\n\nimport { getStackFramesFromError } from '../instrumentations/errors/stackTraceParser';\nimport type { PreloadedMobileMeta } from '../instrumentations/session/sessionAttributes';\nimport { defaultSessionTrackingConfig } from '../instrumentations/session/sessionManager/sessionConstants';\nimport { InternalLoggerLevel, LogLevel } from '../internalLogger';\nimport { getMetroInjectedBundleId } from '../metas/appBuildIdentity';\nimport { getPageMeta } from '../metas/page';\nimport { getScreenMeta } from '../metas/screen';\nimport { getSdkMeta } from '../metas/sdk';\nimport { ConsoleTransport } from '../transports/console';\nimport { FetchTransport } from '../transports/fetch';\nimport { OfflineTransport } from '../transports/offline';\n\nimport { getRNInstrumentations } from './getRNInstrumentations';\nimport type { ReactNativeConfig, ReactNativeFullConfig } from './types';\n\nconst DEFAULT_OFFLINE_CACHE_MS = 3 * 24 * 60 * 60 * 1000; // 3 days\n\n/**\n * Resolves `meta.app.bundleId` when it is not already supplied by faro-core from\n * the Metro preamble (`registerInitialMetas` / `__faroBundleId_<appName>`).\n *\n * Priority: explicit `config.app.bundleId` → Metro preamble (core) → DeviceInfo\n * fallback (`applicationId@versionCode@versionName`, same shape Gradle/Metro use).\n */\nfunction resolveAppBundleId(\n  configApp: MetaApp | undefined,\n  appName: string | undefined,\n  appSymbolsBundleId?: string\n): string | undefined {\n  if (configApp?.bundleId) {\n    return configApp.bundleId;\n  }\n  const metroId = getMetroInjectedBundleId(appName);\n  if (metroId) {\n    return metroId;\n  }\n  return appSymbolsBundleId;\n}\n\n/**\n * Builds transports. FetchTransport is always added when url is provided.\n * User can enable offline and console via enableTransports.\n */\nfunction buildTransports(config: ReactNativeConfig): Config['transports'] {\n  const { enableTransports = { offline: false, console: false } } = config;\n\n  if (!config.url) {\n    throw new Error('url is required. Provide the Faro collector URL.');\n  }\n\n  const builtTransports: Config['transports'] = [];\n\n  if (enableTransports.offline) {\n    builtTransports.push(\n      new OfflineTransport({\n        maxCacheDurationMs: DEFAULT_OFFLINE_CACHE_MS,\n      })\n    );\n  }\n\n  builtTransports.push(\n    new FetchTransport({\n      url: config.url,\n      apiKey: config.apiKey,\n    })\n  );\n\n  if (enableTransports.console) {\n    builtTransports.push(new ConsoleTransport({ level: LogLevel.DEBUG }));\n  }\n\n  const extraTransports = config.transports ?? [];\n  return [...builtTransports, ...extraTransports];\n}\n\n/**\n * Builds instrumentations from config flags.\n */\nfunction buildInstrumentations(config: ReactNativeConfig): Config['instrumentations'] {\n  const baseInstrumentations = getRNInstrumentations(config);\n  const extraInstrumentations = config.instrumentations ?? [];\n  return [...baseInstrumentations, ...extraInstrumentations];\n}\n\n/**\n * React Native stacktrace parser. Uses getStackFramesFromError for RN-specific formats.\n */\nfunction createParseStacktrace(releaseBundleFilename: string | undefined): Config['parseStacktrace'] {\n  return (err) => ({\n    frames: getStackFramesFromError(err, { releaseBundleFilename }),\n  });\n}\n\n/**\n * Creates a full Faro config from React Native flag-based config.\n *\n * Based on flags, builds instrumentations and transports automatically.\n * Client just enables what they need; makeRNConfig does the rest.\n *\n * @param preloadedMobileMeta Device/session fields and structured mobile meta (passed from async `initializeFaro`).\n * @param appSymbolsBundleId Encoded `meta.app.bundleId` for server-side symbol retrace.\n */\nexport function makeRNConfig(\n  config: ReactNativeConfig,\n  preloadedMobileMeta?: PreloadedMobileMeta,\n  appSymbolsBundleId?: string\n): ReactNativeFullConfig {\n  const { app: preloadedAppMeta, ...structuredMobileMeta } = preloadedMobileMeta?.meta ?? {};\n  const mobileMetas = Object.keys(structuredMobileMeta).length > 0 ? [structuredMobileMeta] : [];\n  const defaultMetas = [getSdkMeta(), getPageMeta(), getScreenMeta(), ...mobileMetas];\n  const customMetas = config.metas ?? [];\n  const transports = buildTransports(config);\n  const instrumentations = buildInstrumentations(config);\n  const installationId = config.app.installationId ?? preloadedAppMeta?.installationId;\n\n  const releaseBundleFilename = config.releaseBundleFilename;\n  // Merge bundleId (from config, Metro, or DeviceInfo) with preloaded app meta\n  const bundleIdValue = resolveAppBundleId(config.app, config.app?.name, appSymbolsBundleId);\n  const appMetasIfPresent =\n    preloadedAppMeta || bundleIdValue\n      ? [{ app: { ...preloadedAppMeta, ...(bundleIdValue && { bundleId: bundleIdValue }) } }]\n      : [];\n\n  return {\n    app: {\n      ...config.app,\n      ...(installationId && { installationId }),\n    },\n    ...(preloadedMobileMeta != null && {\n      preloadedMobileMeta: preloadedMobileMeta.meta,\n      preloadedSessionDeviceAttributes: preloadedMobileMeta.sessionAttributes,\n    }),\n    dedupe: config.dedupe ?? true,\n    globalObjectKey: config.globalObjectKey ?? defaultGlobalObjectKey,\n    internalLoggerLevel: config.internalLoggerLevel ?? InternalLoggerLevel.ERROR,\n    isolate: config.isolate ?? false,\n    parseStacktrace: config.parseStacktrace ?? createParseStacktrace(releaseBundleFilename),\n    paused: config.paused ?? false,\n    preventGlobalExposure: config.preventGlobalExposure ?? false,\n    unpatchedConsole: config.unpatchedConsole ?? defaultUnpatchedConsole,\n    batching: {\n      enabled: false,\n      sendTimeout: 250,\n      itemLimit: 50,\n    },\n    sessionTracking: {\n      ...defaultSessionTrackingConfig,\n      ...config.sessionTracking,\n    },\n    metas: [...defaultMetas, ...customMetas, ...appMetasIfPresent],\n    instrumentations,\n    transports,\n    ignoreUrls: config.ignoreUrls ?? [],\n    ignoreErrors: config.ignoreErrors,\n    beforeSend: config.beforeSend,\n    preserveOriginalError: config.preserveOriginalError,\n    userActionsInstrumentation: config.userActionsOptions,\n    consoleInstrumentation: config.consoleCaptureOptions,\n  };\n}\n"]}
+{"version":3,"file":"makeRNConfig.js","sourceRoot":"","sources":["../../../src/config/makeRNConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultGlobalObjectKey, defaultUnpatchedConsole } from '@grafana/faro-core';\nimport type { Config, MetaApp } from '@grafana/faro-core';\n\nimport { getStackFramesFromError } from '../instrumentations/errors/stackTraceParser';\nimport type { PreloadedMobileMeta } from '../instrumentations/session/sessionAttributes';\nimport { defaultSessionTrackingConfig } from '../instrumentations/session/sessionManager/sessionConstants';\nimport { InternalLoggerLevel, LogLevel } from '../internalLogger';\nimport { getMetroInjectedBundleId } from '../metas/appBuildIdentity';\nimport { getPageMeta } from '../metas/page';\nimport { getScreenMeta } from '../metas/screen';\nimport { getSdkMeta } from '../metas/sdk';\nimport { ConsoleTransport } from '../transports/console';\nimport { FetchTransport } from '../transports/fetch';\nimport { OfflineTransport } from '../transports/offline';\n\nimport { getRNInstrumentations } from './getRNInstrumentations';\nimport type { ReactNativeConfig, ReactNativeFullConfig } from './types';\n\nconst DEFAULT_OFFLINE_CACHE_MS = 3 * 24 * 60 * 60 * 1000; // 3 days\n\n/**\n * Resolves `meta.app.bundleId` when it is not already supplied by faro-core from\n * the Metro preamble (`registerInitialMetas` / `__faroBundleId_<appName>`).\n *\n * Priority: explicit `config.app.bundleId` → Metro preamble (core) → DeviceInfo\n * fallback (`applicationId@versionCode@versionName`, same shape Gradle/Metro use).\n */\nfunction resolveAppBundleId(\n  configApp: MetaApp | undefined,\n  appName: string | undefined,\n  appSymbolsBundleId?: string\n): string | undefined {\n  if (configApp?.bundleId) {\n    return configApp.bundleId;\n  }\n  const metroId = getMetroInjectedBundleId(appName);\n  if (metroId) {\n    return metroId;\n  }\n  return appSymbolsBundleId;\n}\n\n/**\n * Builds transports. FetchTransport is always added when url is provided.\n * User can enable offline and console via enableTransports.\n */\nfunction buildTransports(config: ReactNativeConfig): Config['transports'] {\n  const { enableTransports = { offline: false, console: false } } = config;\n\n  if (!config.url) {\n    throw new Error('url is required. Provide the Faro collector URL.');\n  }\n\n  const builtTransports: Config['transports'] = [];\n\n  if (enableTransports.offline) {\n    builtTransports.push(\n      new OfflineTransport({\n        maxCacheDurationMs: DEFAULT_OFFLINE_CACHE_MS,\n      })\n    );\n  }\n\n  builtTransports.push(\n    new FetchTransport({\n      url: config.url,\n      apiKey: config.apiKey,\n    })\n  );\n\n  if (enableTransports.console) {\n    builtTransports.push(new ConsoleTransport({ level: LogLevel.DEBUG }));\n  }\n\n  const extraTransports = config.transports ?? [];\n  return [...builtTransports, ...extraTransports];\n}\n\n/**\n * Builds instrumentations from config flags.\n */\nfunction buildInstrumentations(config: ReactNativeConfig): Config['instrumentations'] {\n  const baseInstrumentations = getRNInstrumentations(config);\n  const extraInstrumentations = config.instrumentations ?? [];\n  return [...baseInstrumentations, ...extraInstrumentations];\n}\n\n/**\n * React Native stacktrace parser. Uses getStackFramesFromError for RN-specific formats.\n */\nfunction createParseStacktrace(releaseBundleFilename: string | undefined): Config['parseStacktrace'] {\n  return (err) => ({\n    frames: getStackFramesFromError(err, { releaseBundleFilename }),\n  });\n}\n\n/**\n * Creates a full Faro config from React Native flag-based config.\n *\n * Based on flags, builds instrumentations and transports automatically.\n * Client just enables what they need; makeRNConfig does the rest.\n *\n * @param preloadedMobileMeta Device/session fields and structured mobile meta (passed from async `initializeFaro`).\n * @param appSymbolsBundleId Encoded `meta.app.bundleId` for server-side symbol retrace.\n */\nexport function makeRNConfig(\n  config: ReactNativeConfig,\n  preloadedMobileMeta?: PreloadedMobileMeta,\n  appSymbolsBundleId?: string\n): ReactNativeFullConfig {\n  const { app: preloadedAppMeta, ...structuredMobileMeta } = preloadedMobileMeta?.meta ?? {};\n  const mobileMetas = Object.keys(structuredMobileMeta).length > 0 ? [structuredMobileMeta] : [];\n  const defaultMetas = [getSdkMeta(), getPageMeta(), getScreenMeta(), ...mobileMetas];\n  const customMetas = config.metas ?? [];\n  const transports = buildTransports(config);\n  const instrumentations = buildInstrumentations(config);\n  const installationId = config.app.installationId ?? preloadedAppMeta?.installationId;\n\n  const releaseBundleFilename = config.releaseBundleFilename;\n  const bundleIdValue = resolveAppBundleId(config.app, config.app?.name, appSymbolsBundleId);\n  const app = {\n    ...preloadedAppMeta,\n    ...config.app,\n    ...(installationId && { installationId }),\n    ...(bundleIdValue && { bundleId: bundleIdValue }),\n  };\n  // Core merges metadata shallowly. Supply the complete app object so native\n  // metadata cannot replace configured fields such as version and environment.\n  const appMetasIfPresent = preloadedAppMeta || bundleIdValue ? [{ app }] : [];\n\n  return {\n    app,\n    ...(preloadedMobileMeta != null && {\n      preloadedMobileMeta: preloadedMobileMeta.meta,\n      preloadedSessionDeviceAttributes: preloadedMobileMeta.sessionAttributes,\n    }),\n    dedupe: config.dedupe ?? true,\n    globalObjectKey: config.globalObjectKey ?? defaultGlobalObjectKey,\n    internalLoggerLevel: config.internalLoggerLevel ?? InternalLoggerLevel.ERROR,\n    isolate: config.isolate ?? false,\n    parseStacktrace: config.parseStacktrace ?? createParseStacktrace(releaseBundleFilename),\n    paused: config.paused ?? false,\n    preventGlobalExposure: config.preventGlobalExposure ?? false,\n    unpatchedConsole: config.unpatchedConsole ?? defaultUnpatchedConsole,\n    batching: {\n      enabled: false,\n      sendTimeout: 250,\n      itemLimit: 50,\n    },\n    sessionTracking: {\n      ...defaultSessionTrackingConfig,\n      ...config.sessionTracking,\n    },\n    metas: [...defaultMetas, ...customMetas, ...appMetasIfPresent],\n    instrumentations,\n    transports,\n    ignoreUrls: config.ignoreUrls ?? [],\n    ignoreErrors: config.ignoreErrors,\n    beforeSend: config.beforeSend,\n    preserveOriginalError: config.preserveOriginalError,\n    userActionsInstrumentation: config.userActionsOptions,\n    consoleInstrumentation: config.consoleCaptureOptions,\n  };\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"]}