Struct AuthHeader 

#[non_exhaustive]
pub struct AuthHeader<'a> { /* private fields */ }

Single HTTP (name, value) header pair, returned by AuthProvider::auth_header (bd:JMAP-6r7c.62, bd:JMAP-6r7c.20).

The wrapper exists for two purposes:

1. Compile-time secret-typing. AuthHeader’s Debug impl redacts the header value to "[REDACTED]". A future AuthProvider impl that writes tracing::trace!(?header, "injecting") cannot leak the credential through that path because the wrapper’s Debug output never contains the value bytes. The pre-bd:JMAP-6r7c.62 shape (Option<(&str, &str)>) had no such guard — a string tuple formats verbatim via ?-syntax.
2. Bounded API surface. The wrapper packages exactly one (name, value) pair. The trait’s signature does not admit a list, a sequence, or a per-request-computed value. This is the intentional limitation: AuthProvider covers “static, per-connection single-header auth schemes” only (Bearer, Basic, mTLS via TransportConfig). Schemes that need multiple request-dependent headers (AWS SigV4, OAuth request signing) or async credential refresh require a different abstraction — currently, custom TransportConfig impls that wire per-request middleware (bd:JMAP-6r7c.20).

Construct via AuthHeader::new — both name and value are caller-supplied borrows; the wrapper stashes them as-is. The constructor does not validate HTTP-header-value syntax; downstream consumers (e.g. connect_ws) validate at the call site and surface ClientError::InvalidArgument for invalid bytes.

Implementations

impl<'a> AuthHeader<'a>

pub fn new(name: &'a str, value: &'a str) -> Self

Construct an AuthHeader from a header name and value borrow.

pub fn name(&self) -> &'a str

Borrow the header name. Lowercase-ASCII per RFC 9110 §5.1.

pub fn expose_value(&self) -> &'a str

Borrow the header value.

Do not log this return value. The value is credential material; see the type-level rustdoc. The constructor name is deliberately explicit (expose_value) so a call site reveals the intent — a tracing::* line that references header.expose_value() is visible in code review, whereas a ?header formatter is not.

Trait Implementations

impl<'a> Clone for AuthHeader<'a>

fn clone(&self) -> AuthHeader<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for AuthHeader<'a>

impl Debug for AuthHeader<'_>

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

Formats the value using the given formatter.