Struct ConnectionLifecycle 

pub struct ConnectionLifecycle { /* private fields */ }

Owns the SDK connection lifecycle state and emits validated transitions.

Implementations

impl ConnectionLifecycle

pub const fn new() -> Self

Creates a lifecycle in the ConnectionState::Connecting state.

pub const fn state(&self) -> &ConnectionState

Returns the current connection state.

pub fn observe( &mut self, observer: impl FnMut(&ConnectionEvent) + Send + 'static, )

Registers an observer that is called after each successful transition.

pub fn connect(&mut self) -> Result<(), SdkError>

Transitions from ConnectionState::Disconnected to connecting.

Errors

Returns SdkError when the lifecycle is not disconnected.

pub fn connected(&mut self) -> Result<(), SdkError>

Transitions from connecting or reconnecting to connected.

Errors

Returns SdkError when the lifecycle is disconnected or already connected.

pub fn reconnect_started(&mut self) -> Result<(), SdkError>

Records that an externally authorized real reconnect attempt started.

This method has no delay, timer, retry counter, or authority producer. The remote participant entrypoint obtains one-use attempt authority from liminal-protocol before calling the transport.

Errors

Returns SdkError when reconnecting from the current state is invalid.

pub fn disconnect(&mut self, reason: DisconnectReason) -> Result<(), SdkError>

Transitions to disconnected with the supplied reason.

Errors

Returns SdkError when the lifecycle is already disconnected.

Trait Implementations

impl Debug for ConnectionLifecycle

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConnectionLifecycle

fn default() -> Self

Returns the “default value” for a type.