export type AuthState = "idle" | "checking" | "valid" | "invalid" | "expired" | "error";
/**
 * 一次鉴权请求的上下文。
 * 可被拦截器逐步加工，类似于请求中间件管道。
 */
export interface AuthRequestContext {
    key: string;
    endpoint: string;
    headers: Record<string, string>;
    metadata: Record<string, string>;
}
/**
 * 鉴权结果模型。
 * - checkedAt: 当前结果生成时间
 * - expiresAt: 授权到期时间（仅 valid / expired 场景常见）
 */
export interface LicenseValidationResult {
    status: Exclude<AuthState, "idle" | "checking">;
    reason: string;
    checkedAt: number;
    expiresAt?: number;
}
export type AuthInterceptor = (context: AuthRequestContext) => AuthRequestContext | Promise<AuthRequestContext>;