Struct TokenCache 

pub struct TokenCache(/* private fields */);

Thread-safe token cache shared across requests within a single RestStream.

Implementations

impl TokenCache

pub fn new() -> Self

pub async fn invalidate(&self)

Drop any cached token so the next get_or_refresh fetches a fresh one. Called when the API rejects the current token with a 401 — a server-side expiry (or a token with no expires_in, cached as valid forever) that the time-based is_valid check cannot detect (F57).

pub async fn get_or_refresh( &self, client: &Client, token_url: &str, client_id: &str, client_secret: &str, scopes: &[String], expiry_ratio: f64, ) -> Result<String, FaucetError>

Return a valid cached token or fetch a new one.

expiry_ratio is the fraction of the server-reported expires_in lifetime after which the token is proactively refreshed. For example, 0.9 means a token with expires_in = 3600 is refreshed after 3240 s.

Trait Implementations

impl Clone for TokenCache

fn clone(&self) -> TokenCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenCache

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

Formats the value using the given formatter.

impl Default for TokenCache

fn default() -> TokenCache

Returns the “default value” for a type.