Struct AuthClient 

pub struct AuthClient { /* private fields */ }

Provider-neutral check-lock-check authentication and persistent token lifecycle.

Implementations

impl AuthClient

pub fn new( key: String, flow: Arc<dyn TokenProvider>, store: Arc<dyn CredentialStore>, options: AuthOptions, ) -> Self

Bind one credential identity to its acquisition provider and store.

pub fn store_name(&self) -> &'static str

Return the active store’s backend identifier.

pub async fn login(&self) -> Result<Token>

Acquire and persist a new credential under an exclusive refresh lock.

pub async fn token(&self) -> Result<Token>

Load or refresh without starting an interactive login for a missing credential.

pub async fn token_or_login(&self) -> Result<Token>

Load or refresh, permitting login when the store has no credential.

pub async fn force_refresh(&self) -> Result<Token>

Renew even before the refresh window, without forcing an interactive login.

pub async fn refresh_rejected_token( &self, stale_access_token: &str, ) -> Result<Token>

Refresh a rejected token unless another process already replaced it.

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

Delete only this credential while holding the store’s refresh lock.

Trait Implementations

impl AuthSession for AuthClient

fn auth_client(&self) -> &AuthClient

Return the shared client that owns this session’s lifecycle.

fn store_name(&self) -> &'static str

Identify the active credential store.

fn token_with_login<'life0, 'async_trait>( &'life0 self, login: Option<bool>, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Resolve binding login policy: true forces login, false forbids it, None allows it.

fn login<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Explicitly acquire and persist a new credential.

fn token<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Load or renew a credential without initiating an interactive login.

fn token_or_login<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Load or renew a credential, allowing login when none is stored.

fn force_refresh<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Renew the stored credential even when it has not reached its refresh window.

fn refresh_rejected_token<'life0, 'life1, 'async_trait>( &'life0 self, stale: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Reuse another caller’s replacement or renew the rejected credential.

fn logout<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Remove the persisted credential under its refresh lock.