Struct Session 

pub struct Session<C: Connection> { /* private fields */ }

A quic-reverse session over a QUIC connection.

The session provides the main API for:

• Initiating reverse streams to the peer
• Accepting incoming stream requests from the peer
• Managing the session lifecycle

Example

use quic_reverse::{Session, Config, Role};

// Create a session as the client
let session = Session::new(connection, Role::Client, Config::default());

// Start the session (performs negotiation)
let mut handle = session.start().await?;

// Open a reverse stream
let (send, recv) = handle.open("ssh", Metadata::Empty).await?;

Implementations

impl<C: Connection> Session<C>

pub fn new(connection: C, role: Role, config: Config) -> Self

Creates a new session wrapping the given connection.

The session starts in the Init state. Call start to begin negotiation.

pub fn state(&self) -> State

Returns the current session state.

pub fn role(&self) -> Role

Returns the session role.

pub fn negotiated_params(&self) -> Option<NegotiatedParams>

Returns the negotiated parameters, if negotiation has completed.

pub fn is_ready(&self) -> bool

Returns true if the session is ready for stream operations.

pub fn is_disconnected(&self) -> bool

Returns true if the connection was lost.

pub fn connection(&self) -> &C

Returns a reference to the underlying connection.

pub async fn start(&self) -> Result<SessionHandle<C>, Error>

Starts the session by performing negotiation.

This opens the control stream and performs the Hello/HelloAck handshake with the peer. On success, the session transitions to the Ready state.

Errors

Returns an error if:

• The control stream cannot be opened/accepted
• Negotiation fails (version mismatch, timeout, etc.)
• The session is not in the Init state

Trait Implementations

impl<C: Connection> Clone for Session<C>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.