ConnectionRecoveryHandler class

A connection recovery handler with intelligent reconnection management.

Provides intelligent reconnection management with multiple policies and retry strategies for StreamWebSocketClient instances. Automatically handles reconnection based on various conditions like network state, app lifecycle, and connection errors.

The handler monitors connection state changes and applies configurable policies to determine when reconnection should occur, implementing exponential backoff with jitter for optimal retry behavior.

Built-in Policies

The handler automatically includes several reconnection policies:

• WebSocketAutomaticReconnectionPolicy: Checks whether reconnection is enabled based on disconnection source
• InternetAvailabilityReconnectionPolicy: Only allows reconnection when network is available
• BackgroundStateReconnectionPolicy: Prevents reconnection when app is in background

Example

final recoveryHandler = ConnectionRecoveryHandler(
  client: client,
  networkStateProvider: NetworkStateProvider(),
  appLifecycleStateProvider: AppLifecycleStateProvider(),
);