Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for Client connection, authentication, and TLS options.

Implementations

impl ClientBuilder

pub fn new(endpoint: impl Into<String>) -> Self

Creates a builder for the supplied server endpoint.

pub fn with_stream_endpoint(self, stream_endpoint: impl Into<String>) -> Self

Configures the WebSocket event-stream endpoint used by subscribe operations: the full URL of the server’s /events/stream route, e.g. ws://127.0.0.1:8080/events/stream (http/https URLs are accepted and protocol-mapped to ws/wss).

There is no default and nothing is derived: the gRPC endpoint and the HTTP/WebSocket listener are separate addresses. Subscribing without this option returns ClientError::InvalidArgument with a precise message.

pub fn with_auth(self, auth: ClientAuth) -> Self

Configures the credential attached to every request.

pub fn with_tls(self, tls: TlsOptions) -> Self

Configures TLS options for the tonic channel.

pub fn with_namespace(self, namespace: impl Into<String>) -> Self

Configures the namespace used by operations unless an operation option overrides it.

pub fn with_subject(self, subject: impl Into<String>) -> Self

Configures the caller subject metadata sent to the server.

pub fn with_authorized_namespaces<I, S>(self, namespaces: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Configures the namespaces advertised in auth metadata.

pub async fn build(self) -> Result<Client, ClientError>

Connects once and returns a cheaply cloneable Client.

Errors

Returns ClientError::Unavailable for malformed endpoints and failed channel/TLS handshakes. Server-side credential rejection is surfaced as ClientError::Unauthenticated when AW returns gRPC Unauthenticated.

Trait Implementations

impl Clone for ClientBuilder

fn clone(&self) -> ClientBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientBuilder

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

Formats the value using the given formatter.

impl From<ClientBuilder> for ClientConfig

fn from(builder: ClientBuilder) -> Self

Converts to this type from the input type.