Struct TokenManager 

pub struct TokenManager { /* private fields */ }

Manages access_token lifecycle with automatic refresh. Uses single-flight pattern to merge concurrent refresh requests.

Implementations

impl TokenManager

pub fn new(client: WechatClient) -> Self

pub fn builder(client: WechatClient) -> TokenManagerBuilder

pub async fn get_token(&self) -> Result<String, WechatError>

Get access token, using cache if available and not expired.

Automatically fetches a new token if:

• No cached token exists
• Cached token is expired or expiring soon (within refresh buffer)

Uses single-flight pattern to merge concurrent requests.

Returns

The access token string.

Errors

Returns WechatError::Api if WeChat returns an error code. Returns WechatError::Http if network request fails. Returns WechatError::Token if token parsing fails.

pub async fn invalidate(&self)

Invalidate cached token.

Call this when you know the current access token is no longer valid (e.g., after calling the WeChat auth ticket revoke API).

Trait Implementations

impl Debug for TokenManager

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

Formats the value using the given formatter.