/**
 * Auth Interface - 认证接口定义
 *
 * 定义统一的认证接口，支持API Key和OAuth认证
 */
import type { ApiKeyAuth, OAuthAuth } from '../core/api/provider-config.js';
/**
 * 认证提供者接口
 *
 * 统一的认证接口，支持不同类型的认证方式
 */
export interface IAuthProvider {
    readonly type: 'apikey' | 'oauth';
    /**
     * 初始化认证
     */
    initialize(): Promise<void>;
    /**
     * 构建认证头部
     */
    buildHeaders(): Record<string, string>;
    /**
     * 验证凭证
     */
    validateCredentials(): Promise<boolean>;
    /**
     * 刷新凭证 (可选)
     */
    refreshCredentials?(): Promise<void>;
    /**
     * 清理资源
     */
    cleanup(): Promise<void>;
    /**
     * 获取认证状态
     */
    getStatus(): AuthStatus;
}
/**
 * 认证状态
 */
export interface AuthStatus {
    isAuthenticated: boolean;
    isValid: boolean;
    lastValidated: number;
    expiresAt?: number;
    error?: string;
}
/**
 * 认证结果
 */
export interface AuthResult {
    success: boolean;
    headers: Record<string, string>;
    error?: string;
    metadata?: Record<string, unknown>;
}
/**
 * 认证配置
 */
export type AuthConfig = ApiKeyAuth | OAuthAuth;
/**
 * 认证凭证存储
 */
export interface TokenStorage {
    access_token: string;
    refresh_token?: string;
    expires_at?: number;
    token_type?: string;
    scope?: string;
    created_at: number;
    updated_at: number;
    metadata?: Record<string, unknown>;
}
/**
 * 认证错误类型
 */
export declare enum AuthErrorType {
    INVALID_CREDENTIALS = "invalid_credentials",
    TOKEN_EXPIRED = "token_expired",
    NETWORK_ERROR = "network_error",
    CONFIGURATION_ERROR = "configuration_error",
    UNKNOWN_ERROR = "unknown_error"
}
/**
 * 认证错误
 */
export interface AuthError extends Error {
    type: AuthErrorType;
    details?: Record<string, unknown>;
    retryable: boolean;
}
/**
 * OAuth客户端接口
 */
export interface IOAuthClient {
    /**
     * 初始化OAuth客户端
     */
    initialize(): Promise<void>;
    /**
     * 获取访问令牌
     */
    getAccessToken(): Promise<string>;
    /**
     * 刷新访问令牌
     */
    refreshToken(refreshToken: string): Promise<TokenStorage>;
    /**
     * 完成OAuth流程
     */
    completeOAuthFlow(): Promise<TokenStorage>;
    /**
     * 保存令牌
     */
    saveToken(token: TokenStorage | null): Promise<void>;
    /**
     * 加载令牌
     */
    loadToken(): Promise<TokenStorage | null>;
    /**
     * 获取当前令牌
     */
    getToken(): TokenStorage | null;
    /**
     * 更新令牌存储
     */
    updateTokenStorage(storage: TokenStorage, tokenData: unknown): void;
}
/**
 * API Key认证工厂
 */
export interface ApiKeyAuthFactory {
    create(config: ApiKeyAuth): IAuthProvider;
}
/**
 * OAuth认证工厂
 */
export interface OAuthAuthFactory {
    create(config: OAuthAuth, providerType: string): IAuthProvider;
}