[MSNexploder]

Preserve SCTP SNAP through React Native configuration updates

registerGlobals() enables SCTP SNAP in its peer-connection constructor shim. Later join/reconnect ICE updates omit the option because livekit-client owns a separate configuration object. Native parsing defaults the missing option to false, but SCTP SNAP is immutable, so the ICE update can be rejected.

Change

Extend the existing SctpSnapPeerConnection shim to remember the boolean selected at construction and supply it as the default in setConfiguration(). Explicit constructor false and explicit update values still win. This keeps ownership beside the SDK code that introduces the default; the shared JavaScript SDK and native WebRTC wrapper need no changes.

The native configuration default, equality check, and immutable-field validation explain the rejected update. The React Native constructor shim and JavaScript SDK configuration creation show the concrete path.

Minimal reproduction

import { registerGlobals } from '@livekit/react-native';

registerGlobals();
const pc = new RTCPeerConnection();
pc.setConfiguration({
  iceServers: [{ urls: 'stun:stun.example.org:3478' }],
});

Use the registered global constructor. The STUN URI is a placeholder. Before the fix, construction sends enableSctpSnap: true, but the update omits it. Afterward, both send true.

Testing

The regression uses the real registerGlobals() shim and unpatched WebRTC class with native-boundary mocks. Six cases cover default/explicit values, repeated ICE updates, explicit change requests, separate connections, and frozen update objects.

yarn install --immutable
yarn typescript
yarn lint
yarn test --runInBand
yarn prepare
yarn build-docs --treatWarningsAsErrors

• Before the fix: three regression failures and three passing controls.
• Afterward: all three suites / 11 tests pass.
• Type-check, lint, library build, and strict documentation build pass.

Native join/reconnect validation remains outstanding.

[changeset-bot]

🦋 Changeset detected

Latest commit: bfd2c9b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@livekit/react-native	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.