Struct TokenCache 

pub struct TokenCache { /* private fields */ }

Thread-safe cache for storing authentication tokens with expiration tracking.

Provides a simple key-value store for authentication tokens that automatically handles expiration checking and cleanup. The cache is designed to be shared across multiple threads and async tasks safely.

Thread Safety

All operations are thread-safe and can be called concurrently from multiple async tasks. The cache uses RwLock for efficient concurrent read access.

Examples

use quetty_server::auth::{TokenCache, CachedToken};
use std::time::{Duration, Instant};

let cache = TokenCache::new();

// Store a token
let token = CachedToken {
    token: "access_token_123".to_string(),
    expires_at: Instant::now() + Duration::from_secs(3600),
};
cache.set("user_123".to_string(), token).await;

// Retrieve a token (returns None if expired)
if let Some(token) = cache.get("user_123").await {
    println!("Token: {}", token);
}

Implementations

impl TokenCache

pub fn new() -> Self

Creates a new empty token cache.

Returns

A new TokenCache instance ready for use

pub async fn get(&self, key: &str) -> Option<String>

Retrieves a valid token from the cache.

Returns the token only if it exists and has not expired. Expired tokens are automatically filtered out.

Arguments

• key - The cache key to look up

Returns

Some(token) if a valid token exists, None if no token exists or it has expired

pub async fn set(&self, key: String, token: CachedToken)

Stores a token in the cache.

Overwrites any existing token with the same key.

Arguments

• key - The cache key to store the token under
• token - The cached token with expiration information

pub async fn invalidate(&self, key: &str)

Removes a specific token from the cache.

Arguments

• key - The cache key to remove

pub async fn clear(&self)

Clears all tokens from the cache.

This is useful for logout operations or when switching authentication contexts.

pub async fn needs_refresh(&self, key: &str) -> bool

Checks if a token needs refresh based on its expiration time.

Returns true if the token doesn’t exist, has expired, or is close to expiring.

Arguments

• key - The cache key to check

Returns

true if the token needs refresh, false if it’s still valid

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 Default for TokenCache

fn default() -> Self

Returns the “default value” for a type.