[lucas-zimerman]

📢 Type of change

• Bugfix
• New feature
• Enhancement
• Refactoring

📜 Description

Adds a Sentry-owned symbolication path so DebugSymbolicator no longer depends only on React Native's internal symbolicateStackTrace.

• Metro middleware: new /__sentry/symbolicate route in createSentryMetroMiddleware. It rewrites the URL to Metro's own /symbolicate (keeping any query string) and hands the request to Metro's handler. The body isn't read by our middleware, so Metro parses it as usual.
• App side: symbolicateStackTrace in debugsymbolicatorutils.ts still tries React Native's version first. If it's missing or throws or rejects, it POSTs the stack to ${devServer.url}__sentry/symbolicate using the existing un-instrumented XHR (no breadcrumbs or spans). Failures reject into DebugSymbolicator's existing catch, so nothing reaches the app.
• Constants: SENTRY_SYMBOLICATE_REQUEST_PATH and METRO_SYMBOLICATE_REQUEST_PATH added to metro/constants.ts. The hard-coded __sentry/context path now uses its constant.

No public API changes (API report unchanged).

💡 Motivation and Context

React Native is removing deep imports like react-native/Libraries/Core/Devtools/* from its public API (RFC #894). RN 0.88 already warns at runtime:

Deep imports from the 'react-native' package are deprecated ('react-native/Libraries/Core/Devtools/parseErrorStack')

parseErrorStack already has a Sentry-parser fallback (#5946). This adds the equivalent for symbolicateStackTrace, the second item of #4877.

Refs #4877

💚 How did you test it?

• Unit tests: 8 new tests for the app-side fallback (React Native path used when available, fallback on throw and reject, non-200, invalid JSON, network error, bundle not from Metro, Devtools missing) and 2 for the middleware URL forwarding. yarn test (SDK + tools), lint, circularDepCheck, build:sdk and api-report:check pass.
• Route check against Metro v0.87.1: posted the same bundle frame to /symbolicate and /__sentry/symbolicate; the responses are byte-identical.
• End-to-end on the RN sample (Android emulator, RN 0.88.1, New Architecture): temporarily made React Native's symbolicateStackTrace throw and tapped "Capture exception". The SDK logged the fallback warning and the top frame came back as src/Screens/ErrorsScreen.tsx:79:45 Button.props.onPress, in-app, with the correct context_line. With the change reverted, the normal path still sends the event with no fallback warning.
• Not run on iOS. The change is JS + Metro only, so the path is shared.

📝 Checklist

• I added tests to verify changes.
• No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
• I updated the docs if needed.
• I updated the wizard if needed.
• All tests passing.
• Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec.
• No breaking changes.

🔮 Next steps

• rnlibraries.ts still requires react-native/Libraries/Core/Devtools/{parseErrorStack,symbolicateStackTrace,getDevServer}. Once React Native stops resolving them, Metro could fail to bundle on the unresolved require. A follow-up could make the Sentry parser and /__sentry/symbolicate the defaults and drop those imports.
• getDevServer (used by both fallbacks), Libraries/Promise, Libraries/Utilities/PolyfillFunctions and Libraries/NativeComponent/NativeComponentRegistry are also deep imports.

[github-actions]

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

• fix(core): Fall back to Sentry Metro middleware for debug symbolication by lucas-zimerman and claude in #7031

• build(deps): Bump addressable to 2.9.2 in macOS sample to resolve advisories by antonis and claude in #7029
• chore(deps): bump addressable from 2.9.0 to 2.9.1 in /samples/react-native-tvos by dependabot in #7028
• chore(deps): bump addressable from 2.9.0 to 2.9.1 in /samples/react-native-visionos by dependabot in #7026
• chore(deps): bump addressable from 2.9.0 to 2.9.1 in /samples/react-native by dependabot in #7027
• chore(deps): update Sentry Android Gradle Plugin to v6.27.0 by github-actions in #7025
• build(deps): Bump basic-ftp to 6.2.6 to resolve DoS advisory by antonis and claude in #7024
• build(deps): Bump fast-xml-parser to 5.12.0 to resolve ReDoS advisory by antonis and claude in #7022
• chore(deps): bump node-forge from 1.4.2 to 1.4.3 by dependabot in #7023

---

_{🤖 This preview updates automatically when you update the PR.}

[sentry]

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
Sentry RN	io.sentry.reactnative.sample	8.35.0 (115)	Release

⚙️ sentry-react-native Build Distribution Settings