/**
 * access_token lifecycle management for wechat-mp
 *
 * Provides centralized token caching, proactive refresh, and error handling.
 */
import type { ResolvedWechatMpAccount } from "./types.js";
/**
 * Get a cached access_token or fetch a new one.
 * @throws Error if appId/appSecret not configured or API call fails
 */
export declare function getAccessToken(account: ResolvedWechatMpAccount): Promise<string>;
/**
 * Clear token cache for an account
 */
export declare function clearAccessTokenCache(account: ResolvedWechatMpAccount): void;
/**
 * Clear all token caches
 */
export declare function clearAllAccessTokenCache(): void;
/**
 * Check if a token needs refresh (expires within 5 minutes)
 */
export declare function shouldRefreshToken(account: ResolvedWechatMpAccount): boolean;
/**
 * Get token cache status
 */
export declare function getTokenCacheStatus(account: ResolvedWechatMpAccount): {
    cached: boolean;
    expiresAt?: number;
    valid?: boolean;
};
/**
 * Force refresh token (clear cache and fetch new)
 */
export declare function refreshToken(account: ResolvedWechatMpAccount): Promise<string>;
/**
 * Check if error code indicates invalid token
 */
export declare function isInvalidTokenError(errcode: number): boolean;
//# sourceMappingURL=token.d.ts.map