@barrysolomon/mobile-react-native 0.4.0-alpha → 0.5.2-alpha

package/README.md

@@ -5,7 +5,7 @@ existing native Android (`otel-android-mobile`) and iOS (`otel-ios-mobile`)
 SDKs — native owns buffering, policy evaluation, OTLP export, and crash
 recovery. JS stays thin.
 
-**Version:** `0.4.0-alpha`, published under the `alpha` dist-tag.
+**Version:** `0.5.2-alpha`, published under the `alpha` dist-tag.
 
 **Status:** Validated end-to-end in Dash0. All 4 platforms (Android native,
 iOS native, RN Android, RN iOS) have a UAT matrix of 12/12 cells green.
@@ -17,7 +17,7 @@ iOS native, RN Android, RN iOS) have a UAT matrix of 12/12 cells green.
 # resolves the OLD 0.1.0-alpha — always pin the dist-tag or version):
 npm install @barrysolomon/mobile-react-native@alpha
 # or pin the exact version:
-# npm install @barrysolomon/mobile-react-native@0.4.0-alpha
+# npm install @barrysolomon/mobile-react-native@0.5.2-alpha
 
 cd ios && pod install
 ```
@@ -25,17 +25,21 @@ cd ios && pod install
 This JS package wraps the native SDKs; install those too:
 
 - **iOS** — add the Swift Package `https://github.com/barrysolomon/mobile-otel`
-  at tag `v0.4.0-alpha` to your app target, then copy
+  at tag `v0.5.2-alpha` to your app target, then copy
   `OTelMobileCallSink.swift` (+ `BoundedLiveSpanStore.swift`) from this package
   into your app target and call
   `Dash0MobileModule.installSink { OTelMobileCallSink() }`. The pod intentionally
   excludes the sink because it depends on the SwiftPM SDK delivered on the app
   side.
-- **Android** — `io.opentelemetry.android:mobile:0.4.0-alpha` from GitHub
-  Packages (`https://maven.pkg.github.com/barrysolomon/mobile-otel`). As of
-  0.2.0-alpha the full module set (`mobile-core` + all
-  `mobile-instrumentation-*` modules) publishes there, so the dependency tree
-  resolves.
+- **Android** — `io.github.barrysolomon:mobile:0.5.2-alpha` from the public
+  Maven repo on GitHub Pages
+  (`https://barrysolomon.github.io/mobile-otel/maven`) — no PAT / no
+  authentication required. As of 0.2.0-alpha the full module set
+  (`mobile-core` + all `mobile-instrumentation-*` modules) publishes there, so
+  the dependency tree resolves. (Legacy / transition: the artifact is also
+  still available from GitHub Packages at
+  `https://maven.pkg.github.com/barrysolomon/mobile-otel`, which requires a
+  `read:packages` PAT — prefer the public repo above.)
 
 ## Quickstart
 

package/android/build.gradle

@@ -76,11 +76,15 @@ android {
 repositories {
     google()
     mavenCentral()
-    // The native Android SDK (io.opentelemetry.android:mobile) is this repo's
-    // own artifact, published to the local Maven cache by the demo-app build
-    // (examples/demo-app publishes :otel-android-mobile* to mavenLocal). It is
-    // not on a public repo, so resolve it from mavenLocal for the standalone
-    // test build. Listed last so public deps still come from google()/central.
+    // The native Android SDK (io.github.barrysolomon:mobile) is this repo's own
+    // artifact. It is published to a PUBLIC, no-auth Maven repo on GitHub Pages —
+    // this is what a clean-room consumer resolves it from (see the README RN
+    // section). Host-autolinked builds resolve via the CONSUMER's settings.gradle
+    // repositories (RepositoriesMode.PREFER_SETTINGS ignores this module block),
+    // so the README instructs the consumer to add this same URL there.
+    maven { url "https://barrysolomon.github.io/mobile-otel/maven" }
+    // mavenLocal last: lets a dev who ran `examples/demo-app` publishReleaseToMavenLocal
+    // consume an unreleased build without hitting the network.
     mavenLocal()
 }
 
@@ -90,14 +94,45 @@ repositories {
 // build against the version this package's package.json devDepends on.
 ext.reactAndroidVersion = project.findProperty('Dash0Mobile_reactAndroidVersion') ?: '+'
 
-// Version of the native Android SDK (io.opentelemetry.android:mobile) this RN
-// module depends on. Single source of truth — MUST track the published SDK
-// version (see the publishing convention in examples/demo-app/build.gradle.kts).
-// Kept as a property so a version bump updates one place, not N hardcoded
-// dependency strings (which silently drifted to 0.1.0-alpha vs the published
-// 0.2.0-alpha and broke clean-.m2 CI while passing on caches that still had the
-// old artifact).
-ext.dash0SdkVersion = project.findProperty('Dash0Mobile_sdkVersion') ?: '0.4.0-alpha'
+// Version of the native Android SDK (io.github.barrysolomon:mobile) this RN
+// module depends on. DERIVED from this package's own package.json `version`,
+// which carries the lockstep release version shared by all three artifacts
+// (npm + Android Maven + iOS SwiftPM — see docs/VERSIONING.md). Deriving it
+// means the consumer can never drift from the published SDK: a release bump
+// touches package.json (release-checklist item #1) and this tracks it
+// automatically, instead of being a 4th place a human must remember to edit.
+// A consumer can still pin an explicit SDK build via -PDash0Mobile_sdkVersion.
+//
+// History: a HARDCODED pin here silently drifted from the published version
+// TWICE — 0.1.0 vs 0.2.0, then 0.4.1 vs 0.4.2 — each time breaking clean-.m2
+// CI (the RN-android job) while passing on caches that still held the old
+// artifact. Deriving from package.json removes that failure mode at the root.
+ext.dash0SdkVersion = project.findProperty('Dash0Mobile_sdkVersion')
+        ?: new groovy.json.JsonSlurper().parse(file('../package.json')).version
+
+// Maven groupId of the native Android SDK. Migrated from io.opentelemetry.android
+// (that namespace belongs to the OpenTelemetry project and cannot ship to Maven
+// Central) to io.github.barrysolomon (Central Portal auto-verifies io.github.<user>
+// against GitHub ownership). Consumers can override via -PDash0Mobile_sdkGroupId.
+ext.dash0SdkGroupId = project.findProperty('Dash0Mobile_sdkGroupId') ?: 'io.github.barrysolomon'
+
+// Pin the transitive kotlin-stdlib down to a version our Kotlin compiler can
+// read. io.github.barrysolomon:mobile (>= 0.5.0-alpha) depends on
+// opentelemetry-android 1.5.0, which transitively declares kotlin-stdlib 2.4.0.
+// This module compiles with Kotlin 2.1.20 (matching RN 0.85's bundled Kotlin —
+// see settings.gradle), and a 2.1.x compiler cannot parse 2.4.0 stdlib metadata:
+// FirIncompatibleClassExpressionChecker throws "source must not be null" and the
+// build dies with an internal compiler error. The SDK's own 2.2.10 classes are
+// fine for 2.1.20; only the stdlib jump is fatal.
+//
+// Mirrors the demo-app's subprojects force. This also protects real RN hosts:
+// any consumer on Kotlin 2.1.x autolinking this module would otherwise hit the
+// same ICE. stdlib is backward-compatible, so pinning to 2.2.10 is safe.
+configurations.all {
+    resolutionStrategy {
+        force "org.jetbrains.kotlin:kotlin-stdlib:2.2.10"
+    }
+}
 
 dependencies {
     implementation "com.facebook.react:react-android:$reactAndroidVersion"
@@ -114,7 +149,7 @@ dependencies {
     // (not `compileOnly`) so Kotlin can resolve transitive config classes
     // (TextInputConfig, BreadcrumbConfig, VitalsConfig, etc.) referenced
     // through MobileConfig's constructor signature.
-    implementation "io.opentelemetry.android:mobile:${dash0SdkVersion}"
+    implementation "${dash0SdkGroupId}:mobile:${dash0SdkVersion}"
     implementation 'io.opentelemetry:opentelemetry-api:1.58.0'
 
     testImplementation 'junit:junit:4.13.2'
@@ -123,7 +158,7 @@ dependencies {
     // on Java 25 ("Could not modify all classes ... ReactApplicationContext").
     testImplementation 'org.mockito:mockito-core:5.18.0'
     testImplementation 'org.mockito.kotlin:mockito-kotlin:5.4.0'
-    testImplementation "io.opentelemetry.android:mobile:${dash0SdkVersion}"
+    testImplementation "${dash0SdkGroupId}:mobile:${dash0SdkVersion}"
     testImplementation 'io.opentelemetry:opentelemetry-api:1.58.0'
 
     // Network-interceptor unit tests: real OkHttp + the OTel SDK in-memory

package/android/gradle.properties

@@ -10,10 +10,10 @@ org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8
 # 0.76-stable OkHttpClientProvider APIs and compiles here.)
 Dash0Mobile_standaloneTestBuild=true
 
-# Version of the native Android SDK (io.opentelemetry.android:mobile) this module
-# depends on. MUST match the version the repo publishes (currently 0.4.0-alpha).
-# Single source of truth, read by build.gradle's dash0SdkVersion.
-Dash0Mobile_sdkVersion=0.4.0-alpha
+# NOTE: the native Android SDK version (io.opentelemetry.android:mobile) is NOT
+# pinned here anymore — build.gradle derives it from this package's package.json
+# `version` (the lockstep release version), so the consumer can't drift from the
+# published SDK. Set -PDash0Mobile_sdkVersion only to pin an explicit override.
 
 # Pin the Kotlin version the module's build.gradle reads (it defaults to
 # 2.1.20 and honors this property) so stdlib matches the compiler the

package/android/src/test/java/com/dash0/mobile/reactnative/OTelNetworkInterceptorTest.kt

@@ -369,11 +369,14 @@ private class InvalidContextSpanBuilder : io.opentelemetry.api.trace.SpanBuilder
     override fun setNoParent() = this
     override fun addLink(spanContext: io.opentelemetry.api.trace.SpanContext) = this
     override fun addLink(spanContext: io.opentelemetry.api.trace.SpanContext, attributes: io.opentelemetry.api.common.Attributes) = this
-    override fun setAttribute(key: String, value: String) = this
+    // OTel API 1.63.0 added nullness annotations to SpanBuilder: the object-typed
+    // setAttribute value params are now @Nullable (String? / T?). The primitive
+    // overloads are unannotated (a primitive can't be null), so they stay non-null.
+    override fun setAttribute(key: String, value: String?) = this
     override fun setAttribute(key: String, value: Long) = this
     override fun setAttribute(key: String, value: Double) = this
     override fun setAttribute(key: String, value: Boolean) = this
-    override fun <T : Any?> setAttribute(key: io.opentelemetry.api.common.AttributeKey<T>, value: T) = this
+    override fun <T : Any> setAttribute(key: io.opentelemetry.api.common.AttributeKey<T>, value: T?) = this
     override fun setSpanKind(spanKind: io.opentelemetry.api.trace.SpanKind) = this
     override fun setStartTimestamp(startTimestamp: Long, unit: java.util.concurrent.TimeUnit) = this
     // Span.getInvalid() carries an invalid SpanContext and is a no-op.

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,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;IAYjD,4FAA4F;uBACnE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOxD,4FAA4F;0BAChE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,4FAA4F;gCAC3D,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;IAOlE,4FAA4F;+BAC5D,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"}
+{"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;AA4CD,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;IAYjD,4FAA4F;uBACnE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOxD,4FAA4F;0BAChE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,4FAA4F;gCAC3D,MAAM,GAAc,OAAO,CAAC,IAAI,CAAC;IAOlE,4FAA4F;+BAC5D,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,10 @@ 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.4.0-alpha';
+// Keep in lockstep with package.json `version`. The publish CI job asserts this
+// equals the npm version + git tag + native gradle version
+// (scripts/ci/check-version-parity.sh), so a drift here fails the release.
+const DISTRO_VERSION = '0.5.2-alpha';
 function resolveReactNativeVersion() {
     try {
         // eslint-disable-next-line @typescript-eslint/no-var-requires

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,CA8DZ"}
+{"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,CAuEZ"}

package/lib/instrumentation/navigation.js

@@ -28,7 +28,12 @@ export function installReactNavigationInstrumentation(navRef) {
             return;
         endCurrentSpan();
         currentName = route.name;
-        Dash0Mobile.log('ui.screen_view', { 'screen.name': route.name }, 9);
+        // Semconv screen-name convergence (docs/SEMCONV_AUDIT.md): upstream
+        // opentelemetry-android renamed `screen.name` -> `app.screen.name` in 1.5.0.
+        // RN has a single screen-name emit site (unlike native's ~20), so we emit
+        // the new key directly here alongside the legacy `screen.name` alias rather
+        // than relying on a native choke-point mirror. The legacy alias drops at 1.0.
+        Dash0Mobile.log('ui.screen_view', { 'screen.name': route.name, 'app.screen.name': route.name }, 9);
         currentSpan = Dash0Mobile.startSpan(`page.${route.name}`);
     };
     const unsub = navRef.addListener('state', onState);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@barrysolomon/mobile-react-native",
-  "version": "0.4.0-alpha",
-  "description": "Dash0 Mobile Observability SDK for React Native (JS/TS bridge). For native iOS use the Swift Package at https://github.com/barrysolomon/mobile-otel. For native Android use io.opentelemetry.android:mobile on GitHub Packages.",
+  "version": "0.5.2-alpha",
+  "description": "Dash0 Mobile Observability SDK for React Native (JS/TS bridge) — OpenTelemetry auto-instrumentation for React Native apps: network/fetch spans, JS errors, crash recovery, offline buffering, native Android + iOS SDKs. For native iOS use the Swift Package at https://github.com/barrysolomon/mobile-otel. For native Android use io.github.barrysolomon:mobile from the public Maven repo (https://barrysolomon.github.io/mobile-otel/maven).",
   "main": "lib/index.js",
   "module": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -34,10 +34,20 @@
   "keywords": [
     "react-native",
     "opentelemetry",
+    "otel",
     "observability",
     "dash0",
     "mobile",
-    "rum"
+    "rum",
+    "telemetry",
+    "tracing",
+    "monitoring",
+    "instrumentation",
+    "apm",
+    "crash-reporting",
+    "expo",
+    "android",
+    "ios"
   ],
   "repository": "https://github.com/barrysolomon/mobile-otel",
   "license": "Apache-2.0",

package/src/index.ts

@@ -142,7 +142,10 @@ function resolveNative(): NativeDash0MobileModule | null {
 // 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.4.0-alpha';
+// Keep in lockstep with package.json `version`. The publish CI job asserts this
+// equals the npm version + git tag + native gradle version
+// (scripts/ci/check-version-parity.sh), so a drift here fails the release.
+const DISTRO_VERSION = '0.5.2-alpha';
 
 function resolveReactNativeVersion(): string | undefined {
   try {

package/src/instrumentation/navigation.ts

@@ -40,7 +40,16 @@ export function installReactNavigationInstrumentation(
     endCurrentSpan();
 
     currentName = route.name;
-    Dash0Mobile.log('ui.screen_view', { 'screen.name': route.name }, 9);
+    // Semconv screen-name convergence (docs/SEMCONV_AUDIT.md): upstream
+    // opentelemetry-android renamed `screen.name` -> `app.screen.name` in 1.5.0.
+    // RN has a single screen-name emit site (unlike native's ~20), so we emit
+    // the new key directly here alongside the legacy `screen.name` alias rather
+    // than relying on a native choke-point mirror. The legacy alias drops at 1.0.
+    Dash0Mobile.log(
+      'ui.screen_view',
+      { 'screen.name': route.name, 'app.screen.name': route.name },
+      9,
+    );
     currentSpan = Dash0Mobile.startSpan(`page.${route.name}`);
   };