BrowserRealtimeClient class

Browser-only BloomRealtimeChannelClient backed by native browser WebSockets (package:web).

Implements resilient, multiplexed realtime communication for Bloom JS Native applications:

• Channel subscription multiplexing (multiple calls to subscribe share one underlying socket subscription).
• Automatic presence tracking with snapshots, joins, and leaves.
• Heartbeat ping/pong keep-alives (automatically replies to server pings with pong frames).
• Bounded exponential backoff reconnection with jitter on unexpected socket disconnects.
• Automatic channel and presence re-subscription upon reconnecting.

VM / SSR Safety

This class requires browser WebSocket APIs and must only be imported in client-side code via package:bloom_js_native/browser.dart. Do not import in server-side rendering (SSR) code.

Example

final client = BrowserRealtimeClient(
  uri: Uri.parse('wss://api.example.com/ws'),
);

final binding = BloomRealtimeBinding(client: client);
await client.connect();

final chatMessages = binding.channel('chat:general');
final activeUsers = binding.presence('chat:general', userInfo: {'name': 'Alice'});