Upgrade the example app to Expo SDK 57

[majkpal]

Moves examples/react-native/WhipWhepDemo from Expo SDK 54 to SDK 57. This is what Dependabot #284–#287 were really asking for — RN 0.81.4 → 0.86.3, React 19.1 → 19.2.3, reanimated 4.1 → 4.5.1 and worklets 0.5.1 → 0.10.1 are all just the SDK 57 matrix — and it closes out the "left behind" list on #292.

Stacked on #292. The first commit here is that PR; review only 4fbc127. Happy to rebase once #292 lands.

What expo install --fix did

expo@^57, and with it expo-audio, expo-camera, expo-constants, expo-font, expo-keep-awake, expo-linking, expo-router, expo-splash-screen, expo-status-bar, expo-system-ui, expo-web-browser (all now on unified ~57.x), plus react/react-dom 19.2.3, react-native 0.86.3, react-native-gesture-handler ~2.32, react-native-reanimated 4.5.1, react-native-safe-area-context ~5.7, react-native-screens ~4.26, react-native-worklets 0.10.1, @types/react ~19.2.4, typescript ~6.0.3, jest-expo ~57.0.5. app.json gained the expo-splash-screen and expo-status-bar config plugins that SDK 57 requires. Alongside it: jest 30, @types/jest 30 (jest-expo@57 needs them), react-test-renderer 19.2.3 to match React 19, and @react-native/eslint-config ^0.86.3.

What the upgrade actually needed on top

Each of these was a hard failure, not a tidy-up:

• expo-module-scripts ~4.0.5 → ~56.0.3. Not optional. 4.0.5 depends on babel-preset-expo ~12, which hoists to the workspace root and shadows the copy expo@57 ships, so Metro fails bundling react-native itself: Unable to determine event arguments for "onModeChange". 56.0.3 dropped that dependency.
• babel-preset-expo added to the example's devDependencies. Once nothing hoists it to the root, @expo/metro-config can't resolve it from there: Cannot find module 'babel-preset-expo'.
• Type-only imports and re-exports in packages/react-native-client. The tsconfig expo-module-scripts 56 brings turns on verbatimModuleSyntax, isolatedModules and strict. 28 of the 30 resulting errors are mechanical (import type / export type).
• iOS deployment target. The config plugin wrote ios.deploymentTarget unconditionally, downgrading the Expo template's own default (16.4 on SDK 57) to this SDK's 15.1 minimum, which left CocoaPods unable to resolve the Expo pod. It now only raises an existing lower value, and still honours an explicit iphoneDeploymentTarget. The example's app.json no longer pins 15.1 for the same reason.
• useColorScheme(). RN 0.86 widened it to include 'unspecified' and made it non-nullable, so Colors[colorScheme ?? 'light'] no longer type-checks. The example's own hook now collapses it to the two themes it defines.

Two real bugs the stricter config surfaced

Both pre-existing, both in the published SDK's types:

• connect: (ConnectOptions) => Promise<void> on WhepClientViewRef named its parameter after its type, so the argument was silently any. Now connect: (options: ConnectOptions) => Promise<void>.
• RNMobileWhipClientViewModule never declared whipPeerConnectionState, even though useWhipConnectionState reads it. Declared now, mirroring the WHEP module.

Worth a follow-up: neither whipPeerConnectionState nor whepPeerConnectionState actually exists as a native Property on either platform — only cameras does. Both hooks fall back to "unknown" via ?? and then track the change events, so behaviour is unaffected, but the exported whepPeerConnectionState const is permanently undefined. Out of scope here; left as-is rather than changing native behaviour in an upgrade PR.

On the ESM output

build/ now emits ESM rather than CommonJS. That matches how Expo's own SDK 57 modules ship — expo-camera and expo-web-browser both have main pointing at ESM with no "type": "module" — and Metro handles it. The config plugin under plugin/build stays CommonJS, which is what app.plugin.js requires. This resolves the concern I raised on #292.

Testing

• yarn build ✅
• yarn tsc ✅
• yarn lint:check ✅ (only the gitignored, generated expo-env.d.ts)
• yarn docs ✅ (same 4 pre-existing typedoc warnings)
• npx expo export --platform ios ✅
• npx expo prebuild --clean ✅ including pod install
• iOS: xcodebuild -workspace WhipWhepDemo.xcworkspace -scheme WhipWhepDemo -destination 'platform=iOS Simulator,name=iPhone 17' → ** BUILD SUCCEEDED **
• Android: ./gradlew :app:assembleDebug (JDK 17) → BUILD SUCCESSFUL

Not exercised: runtime behaviour against a live WHIP/WHEP server, and the iOS broadcast-extension screen-share path on a physical device. Both native example apps (examples/ios, examples/android) are untouched by this PR.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Upgrades the examples/react-native/WhipWhepDemo Expo app from SDK 54 to SDK 57 and aligns the workspace tooling/types with the stricter TypeScript / module settings brought in by newer Expo module tooling.

Changes:

• Bump the example app to Expo SDK 57 (RN 0.86 / React 19.2) and update related Expo/RN dependencies.
• Adjust react-native-client TS surface (type-only imports/exports and a connect signature fix) for stricter TS settings.
• Update the iOS config plugin deployment-target logic to avoid downgrading Expo’s default deployment target.

Reviewed changes

Copilot reviewed 18 out of 19 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/react-native-client/src/ReactNativeMobileWhipClientViewModule.ts	Type/import updates and native module typing change.
packages/react-native-client/src/ReactNativeMobileWhipClientView.tsx	Convert several imports to type-only.
packages/react-native-client/src/ReactNativeMobileWhepClientView.tsx	Convert several imports to type-only.
packages/react-native-client/src/ReactNativeMobileWhepClient.types.ts	Fix connect parameter naming to avoid any.
packages/react-native-client/src/index.ts	Split value export (VideoParameters) from type exports under stricter TS.
packages/react-native-client/src/hooks/useEventState.ts	Use type-only import for payload typings.
packages/react-native-client/src/hooks/useEvent.ts	Use type-only import for payload typings.
packages/react-native-client/src/hooks/useConnectionState.ts	Use type-only imports for peer-connection state types.
packages/react-native-client/src/hooks/eventPayloadValidator.ts	Use type-only import for payload typings.
packages/react-native-client/plugin/src/withWhipWhepIos.ts	Avoid writing a low deployment target unless explicitly set / needed.
packages/react-native-client/package.json	Update dev tooling deps (expo-module-scripts, typedoc, @types/react).
package.json	Update repo-wide linting/tooling dependency versions.
examples/react-native/WhipWhepDemo/package.json	Upgrade example app dependency matrix to SDK 57 + Jest 30 tooling.
examples/react-native/WhipWhepDemo/hooks/useThemeColor.ts	Route theme selection through local useColorScheme wrapper.
examples/react-native/WhipWhepDemo/hooks/useColorScheme.ts	New wrapper to collapse RN 0.86 useColorScheme() into app themes.
examples/react-native/WhipWhepDemo/app/(tabs)/_layout.tsx	Consume the new useColorScheme wrapper for safe palette indexing.
examples/react-native/WhipWhepDemo/app.json	Remove iOS deployment target pin; add required SDK 57 config plugins.
examples/react-native/WhipWhepDemo/.eslintrc	Remove trailing comma for strict JSON parsing.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 19 out of 20 changed files in this pull request and generated 1 comment.