@barrysolomon/mobile-react-native 0.1.1-alpha → 0.2.1-alpha

package/ios/Tests/OTelMobileCallSinkTests.swift

@@ -0,0 +1,243 @@
+// Direct unit tests for the PRODUCTION RN-iOS sink, `OTelMobileCallSink`.
+//
+// Historically this file was excluded from every build/test target (it needs
+// `OTelMobileSDK`), so the code that turns RN bridge calls into real OTel
+// spans/logs on iOS had ZERO direct coverage — the #1 RN-iOS risk flagged in
+// the production-readiness review. The package now path-depends on the sibling
+// iOS SDK so the sink compiles, and the sink exposes an `init(telemetry:)`
+// seam. These tests drive the real sink against in-memory exporters and assert
+// the resulting spans/logs — exercising parent linkage, LRU eviction,
+// span-kind / severity mapping, attribute coercion, and the no-crash guards.
+//
+// Runs under `xcodebuild test` / `swift test` where swift-testing resolves.
+
+#if canImport(OTelMobileSDK)
+import Foundation
+import Testing
+import OpenTelemetryApi
+import OpenTelemetrySdk
+@testable import Dash0MobileReactNative
+
+/// Minimal in-memory `SpanExporter`. Paired with `ImmediateSpanProcessor`
+/// (below) so finished spans are readable synchronously, the instant an
+/// `endSpan` / eviction returns.
+private final class CapturingSpanExporter: SpanExporter, @unchecked Sendable {
+    private let lock = NSLock()
+    private var _spans: [SpanData] = []
+    var spans: [SpanData] { lock.lock(); defer { lock.unlock() }; return _spans }
+
+    func export(spans: [SpanData], explicitTimeout: TimeInterval?) -> SpanExporterResultCode {
+        lock.lock(); _spans.append(contentsOf: spans); lock.unlock()
+        return .success
+    }
+    func flush(explicitTimeout: TimeInterval?) -> SpanExporterResultCode { .success }
+    func shutdown(explicitTimeout: TimeInterval?) {}
+}
+
+/// Minimal in-memory `LogRecordExporter` (the SDK's own `InMemoryLogRecordExporter`
+/// has an internal initializer, so we capture here). `SimpleLogRecordProcessor`
+/// calls `export` synchronously on every `emit`.
+private final class CapturingLogRecordExporter: LogRecordExporter, @unchecked Sendable {
+    private let lock = NSLock()
+    private var _records: [ReadableLogRecord] = []
+    var records: [ReadableLogRecord] { lock.lock(); defer { lock.unlock() }; return _records }
+
+    func export(logRecords: [ReadableLogRecord], explicitTimeout: TimeInterval?) -> ExportResult {
+        lock.lock(); _records.append(contentsOf: logRecords); lock.unlock()
+        return .success
+    }
+    func forceFlush(explicitTimeout: TimeInterval?) -> ExportResult { .success }
+    func shutdown(explicitTimeout: TimeInterval?) {}
+}
+
+/// Synchronous span processor for tests. The SDK's `SimpleSpanProcessor`
+/// exports on a background `DispatchQueue`, which races test assertions; this
+/// one exports inline on `onEnd` so a finished span is visible to the exporter
+/// the instant `endSpan` (or an eviction) returns — fully deterministic.
+private final class ImmediateSpanProcessor: SpanProcessor {
+    private let exporter: SpanExporter
+    init(_ exporter: SpanExporter) { self.exporter = exporter }
+    var isStartRequired: Bool { false }
+    var isEndRequired: Bool { true }
+    func onStart(parentContext: SpanContext?, span: ReadableSpan) {}
+    func onEnd(span: ReadableSpan) { _ = exporter.export(spans: [span.toSpanData()], explicitTimeout: nil) }
+    func shutdown(explicitTimeout: TimeInterval?) {}
+    func forceFlush(timeout: TimeInterval?) {}
+}
+
+/// Builds a sink wired to capturing exporters via the test-injection seam, plus
+/// the exporters so tests can assert on what was emitted. `capacity` controls
+/// the live-span LRU cap so eviction is testable without 2048 spans.
+private func makeSink(capacity: Int = OTelMobileCallSink.maxLiveSpans)
+    -> (sink: OTelMobileCallSink, spans: CapturingSpanExporter, logs: CapturingLogRecordExporter) {
+    let spanExporter = CapturingSpanExporter()
+    let tracer = TracerProviderBuilder()
+        .add(spanProcessor: ImmediateSpanProcessor(spanExporter))
+        .build()
+        .get(instrumentationName: "test")
+
+    let logExporter = CapturingLogRecordExporter()
+    let logger = LoggerProviderBuilder()
+        .with(processors: [SimpleLogRecordProcessor(logRecordExporter: logExporter)])
+        .build()
+        .get(instrumentationScopeName: "test")
+
+    let telemetry = SinkTelemetry(
+        tracer: tracer, logger: logger, meter: nil,
+        forceFlush: {}, flushWindow: { _ in }, shutdown: {}
+    )
+    let sink = OTelMobileCallSink(telemetry: telemetry, capacity: capacity)
+    sink.start(BridgeStartConfig(
+        serviceName: "test", serviceVersion: "1.0",
+        endpoint: "https://example.test", authToken: nil, dataset: nil
+    ))
+    return (sink, spanExporter, logExporter)
+}
+
+@Suite("OTelMobileCallSink (RN-iOS production sink)")
+struct OTelMobileCallSinkTests {
+    private let t0: UInt64 = 1_700_000_000_000_000_000
+    private func t(_ offsetNanos: UInt64) -> UInt64 { t0 + offsetNanos }
+
+    /// Spin-wait for a condition. With `ImmediateSpanProcessor` exports are
+    /// synchronous so this returns on the first check; it is retained as a
+    /// small safety margin and to drain (timeout form) when asserting that a
+    /// no-op produced nothing. Returns the final value of `condition`.
+    private func waitFor(_ condition: @autoclosure () -> Bool, timeout: TimeInterval = 3.0) -> Bool {
+        let deadline = Date().addingTimeInterval(timeout)
+        while !condition() && Date() < deadline {
+            RunLoop.current.run(until: Date().addingTimeInterval(0.01))
+        }
+        return condition()
+    }
+
+    @Test("emitLog produces a record with mapped severity, body, and coerced attributes")
+    func emitLogProducesRecord() {
+        let (sink, _, logs) = makeSink()
+        sink.emitLog(name: "app.error", severity: 17,
+                     attributes: ["http.status": 500, "ok": false, "where": "x"],
+                     timeUnixNano: t(0))
+        let records = logs.records
+        #expect(records.count == 1)
+        #expect(records.first?.severity == .error)          // 17 -> ERROR
+        #expect(records.first?.body == .string("app.error"))
+        // RN bridges 500 as an integer-valued NSNumber -> must land as .int.
+        #expect(records.first?.attributes["http.status"] == .int(500))
+        #expect(records.first?.attributes["ok"] == .bool(false))
+    }
+
+    @Test("startSpan + endSpan exports one span with the right name, kind, and status")
+    func spanRoundTrip() {
+        let (sink, spans, _) = makeSink()
+        sink.startSpan(spanId: "a", parentSpanId: nil, name: "GET /x",
+                       spanKind: "CLIENT", attributes: [:], startTimeUnixNano: t(0))
+        #expect(spans.spans.isEmpty)  // not exported until ended
+        sink.endSpan(spanId: "a", status: "OK", statusMessage: nil,
+                     attributes: ["http.method": "GET"], endTimeUnixNano: t(1_000))
+        #expect(waitFor(spans.spans.count == 1))
+        let s = spans.spans[0]
+        #expect(s.name == "GET /x")
+        #expect(s.kind == .client)
+        #expect(s.status == .ok)
+        #expect(s.attributes["http.method"] == .string("GET"))
+    }
+
+    @Test("parent linkage stitches child into the parent's trace")
+    func parentLinkage() {
+        let (sink, spans, _) = makeSink()
+        sink.startSpan(spanId: "p", parentSpanId: nil, name: "screen",
+                       spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(0))
+        sink.startSpan(spanId: "c", parentSpanId: "p", name: "fetch",
+                       spanKind: "CLIENT", attributes: [:], startTimeUnixNano: t(10))
+        sink.endSpan(spanId: "c", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(20))
+        sink.endSpan(spanId: "p", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(30))
+
+        #expect(waitFor(spans.spans.count == 2))
+        let parent = spans.spans.first { $0.name == "screen" }
+        let child = spans.spans.first { $0.name == "fetch" }
+        #expect(parent != nil && child != nil)
+        // Real OTel parent-child linkage: shared trace id + child points at parent.
+        #expect(child?.traceId == parent?.traceId)
+        #expect(child?.parentSpanId == parent?.spanId)
+        // Bridge-supplied JS id mirrored as an attribute for cross-referencing.
+        #expect(child?.attributes["parent.span.id"] == .string("p"))
+    }
+
+    @Test("liveSpans LRU evicts the oldest orphaned span and ends it as ERROR")
+    func evictionEndsOldestAsError() {
+        let (sink, spans, _) = makeSink(capacity: 2)
+        // Three starts, no ends. At capacity 2, starting s3 must evict s1.
+        sink.startSpan(spanId: "s1", parentSpanId: nil, name: "s1", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(0))
+        sink.startSpan(spanId: "s2", parentSpanId: nil, name: "s2", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(10))
+        sink.startSpan(spanId: "s3", parentSpanId: nil, name: "s3", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(20))
+
+        // Only the evicted s1 has been ended (by eviction) and thus exported
+        // (async via SimpleSpanProcessor — wait for it).
+        #expect(waitFor(spans.spans.contains { $0.name == "s1" }))
+        let evicted = spans.spans.first { $0.name == "s1" }
+        #expect(evicted != nil)
+        #expect(evicted?.status != .ok)  // ended as ERROR, not OK
+        if case .error = evicted?.status {} else { Issue.record("evicted span should be ERROR") }
+        #expect(spans.spans.contains { $0.name == "s2" } == false)  // still live, not ended
+
+        // Ending the still-live ones works and does not double-export s1.
+        sink.endSpan(spanId: "s2", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(30))
+        sink.endSpan(spanId: "s3", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(40))
+        #expect(waitFor(spans.spans.count == 3))
+        #expect(spans.spans.filter { $0.name == "s1" }.count == 1)
+    }
+
+    @Test("ending an unknown span id is a safe no-op")
+    func endUnknownSpanNoop() {
+        let (sink, spans, _) = makeSink()
+        sink.endSpan(spanId: "nope", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(0))
+        #expect(spans.spans.isEmpty)
+    }
+
+    @Test("recordMetric with a nil meter is a safe no-op (no crash on non-finite values)")
+    func metricNoMeterNoCrash() {
+        // Sink built WITHOUT a meter (meter: nil) — recordMetric must early-return.
+        // Passing NaN/Inf also exercises that the counter path's value guard would
+        // never trap even if a meter were present.
+        let (sink, _, _) = makeSink()
+        sink.recordMetric(name: "c", instrumentType: "counter", value: .nan, attributes: [:], timeUnixNano: t(0))
+        sink.recordMetric(name: "c", instrumentType: "counter", value: .infinity, attributes: [:], timeUnixNano: t(0))
+        sink.recordMetric(name: "g", instrumentType: "gauge", value: 1.5, attributes: [:], timeUnixNano: t(0))
+        // No assertion needed beyond "did not crash"; reaching here is the pass.
+        #expect(Bool(true))
+    }
+
+    @Test("emit before start / after shutdown is a safe no-op")
+    func lifecycleGuards() {
+        // A sink with injected telemetry only adopts it on start(); before start,
+        // telemetry is nil so emits are no-ops. After shutdown, telemetry is
+        // cleared and live spans drained.
+        let spanExporter = CapturingSpanExporter()
+        let tracer = TracerProviderBuilder()
+            .add(spanProcessor: ImmediateSpanProcessor(spanExporter))
+            .build().get(instrumentationName: "test")
+        let telemetry = SinkTelemetry(tracer: tracer, logger: nil, meter: nil,
+                                      forceFlush: {}, flushWindow: { _ in }, shutdown: {})
+        let sink = OTelMobileCallSink(telemetry: telemetry, capacity: 8)
+
+        // Before start: no-op (telemetry not yet adopted).
+        sink.startSpan(spanId: "x", parentSpanId: nil, name: "x", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(0))
+        sink.endSpan(spanId: "x", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(1))
+
+        // After start: works.
+        sink.start(BridgeStartConfig(serviceName: "s", serviceVersion: nil, endpoint: "https://e.test", authToken: nil, dataset: nil))
+        sink.startSpan(spanId: "y", parentSpanId: nil, name: "y", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(0))
+        sink.endSpan(spanId: "y", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(1))
+        #expect(waitFor(spanExporter.spans.count == 1))
+        #expect(spanExporter.spans.allSatisfy { $0.name == "y" })  // x (pre-start) never exported
+
+        // After shutdown: emits are no-ops again.
+        sink.shutdown()
+        sink.startSpan(spanId: "z", parentSpanId: nil, name: "z", spanKind: "INTERNAL", attributes: [:], startTimeUnixNano: t(0))
+        sink.endSpan(spanId: "z", status: "OK", statusMessage: nil, attributes: [:], endTimeUnixNano: t(1))
+        // Drain the processor queue, then confirm z produced nothing new.
+        _ = waitFor(false, timeout: 0.3)
+        #expect(spanExporter.spans.count == 1)  // unchanged
+    }
+}
+#endif

package/lib/bridge/types.d.ts

@@ -48,6 +48,35 @@ export interface WireframeAutoCapture {
     /** Emit `ui.wireframe.ref` with `mobile.wireframe.id` instead of the full JSON when content matches the last capture. Default `true`. */
     dedupeByContentHash?: boolean;
 }
+/**
+ * Trace sampling strategy passed through the RN bridge into the native SDK's
+ * `SamplingConfig`. Field names and semantics mirror Android's
+ * `io.opentelemetry.android.mobile.sampling.SamplingConfig` and iOS's
+ * `SamplingConfig` factory constructors one-to-one.
+ *
+ *   - `always_on`  → `SamplingConfig.alwaysOn()`  — sample 100% of spans.
+ *   - `always_off` → `SamplingConfig.alwaysOff()` — drop all spans.
+ *   - `dynamic`    → `SamplingConfig.dynamic(normalRate, highPriorityRate)`
+ *     — `normalRate` baseline with `highPriorityRate` for high-priority
+ *     spans (page.* / app.startup).
+ *
+ * RN DEFAULT: when `sampling` is omitted the bridge defaults to `always_on`
+ * (NOT the native SDK's `dynamic(0.1)` default). RN manual spans
+ * (`Dash0Mobile.startSpan()`) are ROOT spans with arbitrary names; a 10%
+ * baseline silently drops ~90% of a user's very first span, which is a
+ * terrible first-run experience and historically read as "spans vanish."
+ * Sampling/rate-limiting for RN architectures belongs in the collector, not
+ * the on-device SDK. Pass an explicit `sampling` to opt back into on-device
+ * sampling. The native-only Android/iOS SDKs keep their `dynamic(0.1)`
+ * default — only the RN-bridged default changes.
+ */
+export interface SamplingConfig {
+    strategy: 'always_on' | 'always_off' | 'dynamic';
+    /** Baseline rate for `dynamic` (0.0–1.0). Ignored for always_on/always_off. */
+    normalRate?: number;
+    /** Rate for high-priority spans under `dynamic` (0.0–1.0). Defaults to 1.0 natively. */
+    highPriorityRate?: number;
+}
 export interface StartConfig {
     serviceName: string;
     serviceVersion?: string;
@@ -59,6 +88,12 @@ export interface StartConfig {
         diskBytes?: number;
     };
     enablePolicyPolling?: boolean;
+    /**
+     * Trace sampling strategy. Defaults to `always_on` on RN (see
+     * {@link SamplingConfig}) — unlike the native SDKs' `dynamic(0.1)` default.
+     * Omit to keep all spans on-device and rate-limit in the collector.
+     */
+    sampling?: SamplingConfig;
     /**
      * Toggles for JS-side auto-instrumentation (fetch/XHR spans, JS error +
      * unhandled rejection logs). Defaults to all-on. RN bridge uses the same

package/lib/bridge/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -7,7 +7,7 @@
  * See docs/epics/REACT_NATIVE_EPIC.md.
  */
 import type { Attributes, NativeDash0MobileModule, SeverityNumber, SpanKind, StartConfig } from './bridge/types';
-export type { Attributes, SeverityNumber, StartConfig } from './bridge/types';
+export type { Attributes, SamplingConfig, SeverityNumber, StartConfig } from './bridge/types';
 export { installReactNavigationInstrumentation } from './instrumentation/navigation';
 export { withTapTelemetry } from './instrumentation/touch';
 export { otel } from './otel-compat';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,UAAU,EAEV,uBAAuB,EACvB,cAAc,EACd,QAAQ,EAER,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,GAAG,IAAI,IAAI,CAAC;CACb;AA8ED,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD;AAyCD,eAAO,MAAM,WAAW;kBACF,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;cA6DrC,MAAM,eAAc,UAAU,aAAiB,cAAc,GAAO,IAAI;oBAwBlE,MAAM,eAAc,UAAU,aAAiB,QAAQ,GAAgB,UAAU;SAsDtF,CAAC,QACJ,MAAM,MACR,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,eAC7B,UAAU,GACtB,OAAO,CAAC,CAAC,CAAC;uBAeL,MAAM,SACL,MAAM,mBACG,SAAS,GAAG,WAAW,GAAG,OAAO,eACrC,UAAU,GACrB,IAAI;yBAYoB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;uBAYxB,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;0BAO5B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gCAOjB,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;+BAOlC,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;gBAO/C,OAAO,CAAC,IAAI,CAAC;CAgBhC,CAAC;AA4DF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAElF;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,UAAU,EAEV,uBAAuB,EAEvB,cAAc,EACd,QAAQ,EAER,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,GAAG,IAAI,IAAI,CAAC;CACb;AA8ED,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD;AAyCD,eAAO,MAAM,WAAW;kBACF,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;cAoFrC,MAAM,eAAc,UAAU,aAAiB,cAAc,GAAO,IAAI;oBAwBlE,MAAM,eAAc,UAAU,aAAiB,QAAQ,GAAgB,UAAU;SAsDtF,CAAC,QACJ,MAAM,MACR,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,eAC7B,UAAU,GACtB,OAAO,CAAC,CAAC,CAAC;uBAeL,MAAM,SACL,MAAM,mBACG,SAAS,GAAG,WAAW,GAAG,OAAO,eACrC,UAAU,GACrB,IAAI;yBAYoB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;uBAYxB,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;0BAO5B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gCAOjB,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;+BAOlC,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;gBAO/C,OAAO,CAAC,IAAI,CAAC;CAgBhC,CAAC;AA6EF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAElF;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}

package/lib/index.js

@@ -105,7 +105,7 @@ function resolveNative() {
 // callers and correlate issues to a specific bridge release. Keep this in
 // sync with package.json on each release.
 const DISTRO_NAME = 'dash0-react-native';
-const DISTRO_VERSION = '0.1.0-alpha';
+const DISTRO_VERSION = '0.2.1-alpha';
 function resolveReactNativeVersion() {
     try {
         // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -136,8 +136,16 @@ export const Dash0Mobile = {
         // iOS URLProtocol / NSException / signal-handler swizzles by default,
         // which collide with RN's new-arch JS event loop.
         const nativeAutoCapture = buildNativeAutoCaptureTokens(config.autoCapture);
+        // RN sampling default: always_on. RN manual spans are root spans with
+        // arbitrary names, so the native SDKs' dynamic(0.1) default would
+        // silently drop ~90% of a user's first span (Loper finding #4). Sampling
+        // for RN architectures belongs in the collector — callers can still opt
+        // into on-device sampling by passing an explicit `sampling`. See the
+        // SamplingConfig doc comment in bridge/types.ts.
+        const sampling = config.sampling ?? { strategy: 'always_on' };
         const mergedConfig = {
             ...config,
+            sampling,
             extraResourceAttributes: {
                 'telemetry.distro.name': DISTRO_NAME,
                 'telemetry.distro.version': DISTRO_VERSION,
@@ -162,7 +170,22 @@ export const Dash0Mobile = {
             if (!isReactNative()) {
                 autoInstrUninstallers.push(installFetchInstrumentation({ ignoredHosts }));
             }
-            autoInstrUninstallers.push(installXhrInstrumentation({ ignoredHosts }));
+            // Android network capture is owned by the native OkHttp interceptor
+            // (OTelNetworkInterceptor), installed pre-JS in Dash0MobilePackage. The
+            // native layer is the only one that sees traffic under Expo SDK 52+ —
+            // expo/fetch routes through OkHttp directly and never touches the JS
+            // `fetch`/`XMLHttpRequest` globals these shims wrap, so the JS XHR shim
+            // sees zero traffic there. The native interceptor also injects a
+            // W3C `traceparent` built from the real native span context, which the
+            // JS shim cannot do. Installing the JS XHR shim on Android on top of the
+            // native interceptor would (for non-Expo apps) double-count every
+            // request. So: gate the JS XHR shim OFF on Android. iOS keeps the JS XHR
+            // shim — its native URLProtocol is opt-in (off by default for RN), and
+            // RN iOS fetch is XHR-backed, so XHR remains the authoritative JS layer
+            // there.
+            if (!isAndroid()) {
+                autoInstrUninstallers.push(installXhrInstrumentation({ ignoredHosts }));
+            }
         }
         if (auto.errors !== false) {
             autoInstrUninstallers.push(installErrorInstrumentation());
@@ -358,6 +381,23 @@ function isReactNative() {
     const nav = globalThis.navigator;
     return nav?.product === 'ReactNative';
 }
+// True only on React Native running on Android. Reads `Platform.OS` from the
+// react-native module rather than a global so it's accurate on both old and
+// new arch. Used to gate OFF the JS `XMLHttpRequest` shim on Android, where
+// the native OkHttp interceptor (OTelNetworkInterceptor) owns network capture
+// and traceparent injection. Any failure to resolve `Platform` (Jest, SSR,
+// non-RN) returns false so those environments keep the JS shim — exactly the
+// behavior the dedup test pins.
+function isAndroid() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const rn = require('react-native');
+        return rn?.Platform?.OS === 'android';
+    }
+    catch {
+        return false;
+    }
+}
 const NATIVE_AUTO_CAPTURE_FLAGS = [
     ['network', 'network'],
     ['errors', 'errors'],

package/lib/instrumentation/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/instrumentation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAsB9C,wBAAgB,2BAA2B,IAAI,MAAM,IAAI,CA+CxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/instrumentation/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAwB9C,wBAAgB,2BAA2B,IAAI,MAAM,IAAI,CAsDxD"}

package/lib/instrumentation/errors.js

@@ -10,7 +10,10 @@
  * policy (loops that throw on every frame shouldn't DoS the collector).
  */
 import { Dash0Mobile } from '../index';
+import { sanitizeMessage, sanitizeStacktrace } from '../redact';
 export const DEDUPE_WINDOW_MS = 5 * 60 * 1000;
+/** Cap on the dedupe map so a high-cardinality error storm can't leak memory. */
+const DEDUPE_MAX_ENTRIES = 256;
 const SEVERITY_ERROR = 17;
 const SEVERITY_FATAL = 21;
 function resolveErrorUtils() {
@@ -36,11 +39,19 @@ export function installErrorInstrumentation() {
         const now = Date.now();
         const lastAt = recentlySeen.get(key);
         if (lastAt === undefined || now - lastAt >= DEDUPE_WINDOW_MS) {
+            // LRU-style insert: re-key so the freshest entries stay, then evict the
+            // oldest if we've blown the cap. Bounds memory under an error storm.
+            recentlySeen.delete(key);
             recentlySeen.set(key, now);
+            if (recentlySeen.size > DEDUPE_MAX_ENTRIES) {
+                const oldest = recentlySeen.keys().next().value;
+                if (oldest !== undefined)
+                    recentlySeen.delete(oldest);
+            }
             Dash0Mobile.log('app.error', {
                 'exception.type': error?.name ?? 'Error',
-                'exception.message': error?.message ?? String(error),
-                'exception.stacktrace': error?.stack ?? '',
+                'exception.message': sanitizeMessage(error?.message ?? String(error)),
+                'exception.stacktrace': sanitizeStacktrace(error?.stack ?? ''),
             }, isFatal ? SEVERITY_FATAL : SEVERITY_ERROR);
         }
         // Always chain — our capture must never swallow crashes from other

package/lib/instrumentation/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/instrumentation/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAoBD,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,0BAA+B,GACtC,MAAM,IAAI,CAsDZ"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/instrumentation/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAoBD,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,0BAA+B,GACtC,MAAM,IAAI,CAsFZ"}

package/lib/instrumentation/fetch.js

@@ -10,6 +10,7 @@
  * OTLP export requests don't generate spans that then need to be exported.
  */
 import { Dash0Mobile } from '../index';
+import { sanitizeUrl } from '../redact';
 function hostFromUrl(url) {
     const match = /^[a-z][a-z0-9+.-]*:\/\/([^/:?#]+)/i.exec(url);
     return match ? match[1].toLowerCase() : null;
@@ -29,47 +30,82 @@ export function installFetchInstrumentation(config = {}) {
     const original = globalThis.fetch;
     const ignored = new Set((config.ignoredHosts ?? []).map(h => h.toLowerCase()));
     const wrapped = async (input, init) => {
-        const url = resolveUrl(input);
-        const host = hostFromUrl(url);
-        if (host && ignored.has(host)) {
+        // Telemetry setup must never break the host's request. Build the span
+        // defensively; on ANY failure fall through to the raw call.
+        let handle;
+        try {
+            const url = resolveUrl(input);
+            const host = hostFromUrl(url);
+            if (host && ignored.has(host)) {
+                return original(input, init);
+            }
+            const method = resolveMethod(input, init);
+            handle = Dash0Mobile.startSpan(method, {
+                'http.request.method': method,
+                'url.full': sanitizeUrl(url),
+                ...(host ? { 'server.address': host } : {}),
+            }, 'CLIENT');
+        }
+        catch (telemetryErr) {
+            // Span setup failed — host request must still proceed unobserved.
+            // eslint-disable-next-line no-console
+            console.warn?.('[@dash0/mobile] fetch instrumentation setup failed', telemetryErr);
             return original(input, init);
         }
-        const method = resolveMethod(input, init);
-        const handle = Dash0Mobile.startSpan(method, {
-            'http.request.method': method,
-            'url.full': url,
-            ...(host ? { 'server.address': host } : {}),
-        }, 'CLIENT');
         try {
             const response = await original(input, init);
-            const status = response?.status;
-            if (typeof status === 'number') {
-                handle.setAttribute('http.response.status_code', status);
-                if (status >= 400) {
-                    handle.setStatus('ERROR', `HTTP ${status}`);
+            try {
+                const status = response?.status;
+                if (typeof status === 'number') {
+                    handle.setAttribute('http.response.status_code', status);
+                    if (status >= 400) {
+                        handle.setStatus('ERROR', `HTTP ${status}`);
+                    }
+                    else {
+                        handle.setStatus('OK');
+                    }
                 }
                 else {
                     handle.setStatus('OK');
                 }
             }
-            else {
-                handle.setStatus('OK');
+            catch {
+                // Telemetry bookkeeping failure must not mask a successful response.
             }
             return response;
         }
         catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            handle.setStatus('ERROR', message);
+            try {
+                const message = err instanceof Error ? err.message : String(err);
+                handle.setStatus('ERROR', message);
+            }
+            catch {
+                // ignore telemetry failure on the error path
+            }
             throw err;
         }
         finally {
-            handle.end();
+            try {
+                handle.end();
+            }
+            catch {
+                // ignore
+            }
         }
     };
-    globalThis.fetch = wrapped;
+    const g = globalThis;
+    // Double-install guard: Fast Refresh / repeated start() would otherwise
+    // stack wrappers and leak the captured `original`.
+    if (g.fetch && g.fetch.__dash0_installed) {
+        return () => { };
+    }
+    wrapped.__dash0_installed = true;
+    g.fetch = wrapped;
     return function uninstall() {
-        if (globalThis.fetch === wrapped) {
-            globalThis.fetch = original;
+        if (g.fetch === wrapped) {
+            g.fetch = original;
         }
+        // Clear the guard so a later install() can re-instrument.
+        delete wrapped.__dash0_installed;
     };
 }

package/lib/instrumentation/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,UAAU,UAAU;IAClB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5D,eAAe,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACjD;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACpC,MAAM,IAAI,CA8BZ"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,UAAU,UAAU;IAClB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5D,eAAe,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACjD;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACpC,MAAM,IAAI,CA8DZ"}

package/lib/instrumentation/navigation.js

@@ -14,26 +14,50 @@ export function installReactNavigationInstrumentation(navRef) {
         return () => { };
     let currentName = null;
     let currentSpan = null;
+    const endCurrentSpan = () => {
+        if (currentSpan) {
+            currentSpan.end();
+            currentSpan = null;
+        }
+    };
     const onState = () => {
         const route = navRef.getCurrentRoute();
         if (!route)
             return;
         if (route.name === currentName)
             return;
-        if (currentSpan) {
-            currentSpan.end();
-            currentSpan = null;
-        }
+        endCurrentSpan();
         currentName = route.name;
         Dash0Mobile.log('ui.screen_view', { 'screen.name': route.name }, 9);
         currentSpan = Dash0Mobile.startSpan(`page.${route.name}`);
     };
     const unsub = navRef.addListener('state', onState);
+    // End the active route span when the app leaves the foreground. Without
+    // this, a span started on the visible screen stays open until the next
+    // route change or uninstall — which on background may be minutes/never,
+    // producing absurd durations. Re-entering 'active' lets the next route
+    // change open a fresh span. AppState is required lazily so non-RN
+    // (Jest/SSR) environments don't need the native module.
+    let appStateSub;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { AppState } = require('react-native');
+        if (AppState && typeof AppState.addEventListener === 'function') {
+            appStateSub = AppState.addEventListener('change', (state) => {
+                if (state === 'background' || state === 'inactive') {
+                    endCurrentSpan();
+                    // Force the next foregrounded route to re-open a span.
+                    currentName = null;
+                }
+            });
+        }
+    }
+    catch {
+        // No AppState available (test/SSR) — background-end is best-effort.
+    }
     return function uninstall() {
         unsub();
-        if (currentSpan) {
-            currentSpan.end();
-            currentSpan = null;
-        }
+        appStateSub?.remove?.();
+        endCurrentSpan();
     };
 }

package/lib/instrumentation/unhandledRejection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unhandledRejection.d.ts","sourceRoot":"","sources":["../../src/instrumentation/unhandledRejection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,wBAAgB,wCAAwC,IAAI,MAAM,IAAI,CA8CrE"}
+{"version":3,"file":"unhandledRejection.d.ts","sourceRoot":"","sources":["../../src/instrumentation/unhandledRejection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,wBAAgB,wCAAwC,IAAI,MAAM,IAAI,CAoDrE"}