@sentori/react-native

@sentori/react-native

React Native SDK for Sentori. Captures JS errors, iOS NSException, Android uncaught Java/Kotlin exceptions, and ships them through a batched HTTP transport.

Install

bun add @sentori/react-native
# or npm / yarn / pnpm

Peer dependencies:

Package	Required for
react >= 18	always
react-native >= 0.74	always
expo-modules-core >= 2.0	native crash capture only (optional)
@react-native-async-storage/async-storage >= 1.23	offline retry queue (optional)

The optional ones are graceful no-ops when absent: pure-RN-without-Expo is supported, just without native crash capture.

Initialize

import { sentori } from '@sentori/react-native'

sentori.init({
  token: 'st_pk_<your project token>',
  release: 'myapp@1.2.3+456',
  ingestUrl: 'https://sentori.your-host.com', // optional
})

Option	Type	Required	Default
token	string	yes	— (must start with st_pk_)
release	string	yes	format <name>@<version>+<build>
environment	string	no	'dev' if __DEV__, else 'prod'
ingestUrl	string	no	https://ingest.sentori.golia.jp
capture	object	no	all sources on

capture toggles (all default true):

• globalErrors: ErrorUtils.setGlobalHandler
• promiseRejections: HermesInternal.enablePromiseRejectionTracker
• network: fetch wrapper that adds net breadcrumbs (auth params auto-redacted)

Capture API

sentori.captureError(error, extras?)

try {
  doSomething()
} catch (e) {
  sentori.captureError(e as Error, {
    tags: { screen: 'Checkout' },
    user: { id: 'u_abc' },
    fingerprint: ['order-checkout-failure'],
  })
}

sentori.setUser(user) / sentori.getUser()

sentori.setUser({ id: 'u_abc', anonymous: false })
sentori.setUser(null) // clear

sentori.addBreadcrumb(input)

sentori.addBreadcrumb({
  type: 'user',
  data: { action: 'tap', target: 'submit' },
})

Types: nav / net / log / user / custom. Ring buffer caps at 100 entries.

sentori.ErrorBoundary

<sentori.ErrorBoundary fallback={<Crashed />}>
  <App />
</sentori.ErrorBoundary>

fallback can be a node or a function (error, reset) => ReactNode.

Native crash capture

iOS NSException + Android Thread.UncaughtExceptionHandler are captured natively, written to disk, and drained on the next launch.

Expo Go does not support custom Expo modules. To enable native capture, switch the host app to a development build:

bunx expo prebuild
cd ios && bundle exec pod install && cd ..
bun run ios     # or `bun run android`

The crash file location:

• iOS: <Documents>/sentori/pending/<uuid>.json
• Android: <filesDir>/sentori/pending/<uuid>.json

sentori.init reads + deletes those files on startup and pipes the events through the same HTTP transport as JS errors.

For testing the round-trip:

import { triggerNativeCrash } from '@sentori/react-native'
triggerNativeCrash()  // closes the app on real crashes

After the relaunch, the server stdout (and dashboard) shows a platform: ios or platform: android event.

Source maps

Build a production bundle, then upload its .map so the server can symbolicate frames at view time:

sentori-cli upload sourcemap \
  --release "myapp@1.2.3+456" \
  --token "st_pk_..." \
  --ingest-url "https://sentori.your-host.com" \
  ./bundle/index.android.bundle.map

The dashboard’s issue detail Stack section has a symbolicated / raw toggle (default symbolicated).

What this SDK does NOT do (v0.1)

• Native signal-based crashes (SIGSEGV / SIGABRT) — only NSException on iOS, only Thread.UncaughtExceptionHandler on Android.
• ANR detection on Android.
• Session replay, profiling, distributed tracing (the traceId / spanId slots are reserved in the schema but unused).
• iOS XCTest / Android Robolectric coverage of the native modules.