Struct OmbracClient 

pub struct OmbracClient { /* private fields */ }

OmbracClient provides a simple, easy-to-use API for starting and managing the ombrac client using QUIC transport.

This struct hides all transport-specific implementation details and provides a clean interface for external users.

Example

use ombrac_client::{OmbracClient, ServiceConfig};
use std::sync::Arc;

let config = Arc::new(ServiceConfig {
    secret: "my-secret".to_string(),
    server: "server.example.com:8080".to_string(),
    auth_option: None,
    endpoint: Default::default(),
    transport: Default::default(),
    logging: Default::default(),
});

let client = OmbracClient::build(config).await?;
// ... use client ...
client.shutdown().await;

Implementations

impl OmbracClient

pub async fn build(config: Arc<ServiceConfig>) -> Result<Self>

Builds a new client instance from the configuration.

This method:

1. Creates a QUIC client from the transport configuration
2. Establishes connection with authentication
3. Spawns endpoint tasks if configured
4. Returns an OmbracClient handle for lifecycle management

Arguments

• config - The service configuration containing transport, endpoint, and secret settings

Returns

A configured OmbracClient instance ready to use, or an error if configuration is invalid or client setup fails.

pub async fn rebind(&self) -> Result<()>

Rebind the transport to a new socket to ensure a clean state for reconnection.

pub fn client(&self) -> &Arc<Client<QuicClient, QuicConnection>>

pub async fn shutdown(self)

Gracefully shuts down the client.

This method will:

1. Send a shutdown signal to stop accepting new connections
2. Wait for all endpoint tasks to finish gracefully
3. Close existing connections

Example

client.shutdown().await;