@nest-omni/core 4.1.3-3 → 4.1.3-31

package/http-client/http-client.module.js

@@ -18,55 +18,102 @@ var HttpClientModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpClientModule = void 0;
 const common_1 = require("@nestjs/common");
-const schedule_1 = require("@nestjs/schedule");
 const config_1 = require("@nestjs/config");
 const typeorm_1 = require("@nestjs/typeorm");
-const cache_service_1 = require("../cache/cache.service");
 const http_client_service_1 = require("./services/http-client.service");
 const circuit_breaker_service_1 = require("./services/circuit-breaker.service");
 const logging_service_1 = require("./services/logging.service");
-const cache_service_2 = require("./services/cache.service");
 const http_log_query_service_1 = require("./services/http-log-query.service");
 const log_cleanup_service_1 = require("./services/log-cleanup.service");
 const api_client_registry_service_1 = require("./services/api-client-registry.service");
 const entities_1 = require("./entities");
-const cache_options_interface_1 = require("../cache/interfaces/cache-options.interface");
 const redis_lock_service_1 = require("../redis-lock/redis-lock.service");
+const http_client_config_1 = require("./config/http-client.config");
 /**
  * HTTP客户端模块
  * 类似Spring Boot的自动配置机制，集成现有的cache服务
+ *
+ * @example
+ * // 最简单的方式 - 使用所有默认配置
+ * HttpClientModule.forRoot()
+ *
+ * @example
+ * // 只覆盖部分配置
+ * HttpClientModule.forRoot({
+ *   baseURL: 'https://api.example.com',
+ *   timeout: 5000,
+ * })
+ *
+ * @example
+ * // 深度合并配置
+ * HttpClientModule.forRoot({
+ *   logging: {
+ *     logLevel: 'debug',
+ *     // 其他 logging 配置会使用默认值
+ *   },
+ * })
  */
 let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
     /**
      * 动态注册HTTP客户端模块
+     * @param config 用户配置，所有字段都是可选的
+     * @returns DynamicModule
      */
     static forRoot(config = {}) {
-        var _a, _b, _c;
         // 基础服务提供者
         const baseProviders = [
             {
                 provide: 'HTTP_CLIENT_CONFIG',
-                useFactory: (configService, cacheService) => {
+                useFactory: (configService) => {
+                    // 1. 获取环境配置
                     const envConfig = this.loadConfigFromEnvironment(configService);
-                    return Object.assign(Object.assign({}, config), envConfig);
+                    // 2. 根据环境获取基础默认配置
+                    const nodeEnv = configService.get('NODE_ENV', 'development');
+                    const environmentDefaults = (0, http_client_config_1.getHttpClientConfig)(nodeEnv);
+                    // 3. 深度合并: 环境默认值 -> 环境变量配置 -> 用户配置
+                    // 用户配置优先级最高，会覆盖前面的配置
+                    return (0, http_client_config_1.mergeHttpClientConfig)((0, http_client_config_1.mergeHttpClientConfig)(envConfig, environmentDefaults), config);
                 },
-                inject: [config_1.ConfigService, cache_service_1.CacheService],
+                inject: [config_1.ConfigService],
             },
             circuit_breaker_service_1.HttpCircuitBreakerService,
-            logging_service_1.HttpLoggingService,
-            cache_service_2.HttpCacheService,
+            {
+                provide: logging_service_1.HttpLoggingService,
+                useFactory: (httpConfig) => {
+                    var _a, _b;
+                    // Check if database logging is enabled in the config
+                    const databaseLoggingEnabled = (_b = (_a = httpConfig === null || httpConfig === void 0 ? void 0 : httpConfig.logging) === null || _a === void 0 ? void 0 : _a.databaseLogging) === null || _b === void 0 ? void 0 : _b.enabled;
+                    return new logging_service_1.HttpLoggingService();
+                },
+                inject: ['HTTP_CLIENT_CONFIG'],
+            },
             http_log_query_service_1.HttpLogQueryService,
-            log_cleanup_service_1.HttpLogCleanupService,
-            api_client_registry_service_1.ApiClientRegistryService,
+            {
+                provide: log_cleanup_service_1.HttpLogCleanupService,
+                useFactory: (logQueryService, httpConfig) => {
+                    return new log_cleanup_service_1.HttpLogCleanupService(logQueryService, httpConfig.logCleanup || {});
+                },
+                inject: [http_log_query_service_1.HttpLogQueryService, 'HTTP_CLIENT_CONFIG'],
+            },
+            {
+                provide: api_client_registry_service_1.ApiClientRegistryService,
+                useFactory: (circuitBreakerService, loggingService, httpConfig) => {
+                    return new api_client_registry_service_1.ApiClientRegistryService(circuitBreakerService, loggingService, {});
+                },
+                inject: [
+                    circuit_breaker_service_1.HttpCircuitBreakerService,
+                    logging_service_1.HttpLoggingService,
+                    'HTTP_CLIENT_CONFIG',
+                ],
+            },
             {
                 provide: http_client_service_1.HttpClientService,
-                useFactory: (circuitBreakerService, loggingService, cacheService, redisLockService, httpConfig) => {
-                    return new http_client_service_1.HttpClientService(circuitBreakerService, loggingService, cacheService, redisLockService, httpConfig);
+                useFactory: (circuitBreakerService, loggingService, redisLockService, httpConfig) => {
+                    return new http_client_service_1.HttpClientService(circuitBreakerService, loggingService, redisLockService, httpConfig);
                 },
                 inject: [
                     circuit_breaker_service_1.HttpCircuitBreakerService,
                     logging_service_1.HttpLoggingService,
-                    cache_service_2.HttpCacheService,
                     redis_lock_service_1.RedisLockService,
                     'HTTP_CLIENT_CONFIG',
                 ],
@@ -77,19 +124,16 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             http_client_service_1.HttpClientService,
             circuit_breaker_service_1.HttpCircuitBreakerService,
             logging_service_1.HttpLoggingService,
-            cache_service_2.HttpCacheService,
             http_log_query_service_1.HttpLogQueryService,
             log_cleanup_service_1.HttpLogCleanupService,
             api_client_registry_service_1.ApiClientRegistryService,
         ];
-        // 动态导入
-        const dynamicImports = [config_1.ConfigModule];
-        if ((_b = (_a = config.logging) === null || _a === void 0 ? void 0 : _a.databaseLogging) === null || _b === void 0 ? void 0 : _b.enabled) {
-            dynamicImports.push(typeorm_1.TypeOrmModule.forFeature([entities_1.HttpLogEntity]));
-        }
-        if ((_c = config.logCleanup) === null || _c === void 0 ? void 0 : _c.enabled) {
-            dynamicImports.push(schedule_1.ScheduleModule.forRoot());
-        }
+        // 动态导入 - 需要根据最终配置判断
+        // 由于配置是在运行时确定的，我们使用条件导入
+        const dynamicImports = [
+            config_1.ConfigModule,
+            typeorm_1.TypeOrmModule.forFeature([entities_1.HttpLogEntity]), // 始终导入，服务内部根据配置决定是否使用
+        ];
         return {
             module: HttpClientModule_1,
             imports: dynamicImports,
@@ -99,6 +143,17 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
     }
     /**
      * 异步注册HTTP客户端模块
+     * @param config 异步配置，所有字段都是可选的
+     * @returns DynamicModule
+     *
+     * @example
+     * HttpClientModule.forRootAsync({
+     *   useFactory: (configService: ConfigService) => ({
+     *     baseURL: configService.get('API_BASE_URL'),
+     *     timeout: 5000,
+     *   }),
+     *   inject: [ConfigService],
+     * })
      */
     static forRootAsync(config) {
         // 基础服务提供者
@@ -106,27 +161,59 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             {
                 provide: 'HTTP_CLIENT_CONFIG',
                 useFactory: (...args) => __awaiter(this, void 0, void 0, function* () {
+                    // 1. 获取用户配置
                     const userConfig = yield config.useFactory(...args);
-                    const envConfig = this.loadConfigFromEnvironment(args[0]);
-                    return Object.assign(Object.assign({}, userConfig), envConfig);
+                    // 2. 获取环境配置
+                    const configService = args[0];
+                    const envConfig = this.loadConfigFromEnvironment(configService);
+                    // 3. 根据环境获取基础默认配置
+                    const nodeEnv = configService.get('NODE_ENV', 'development');
+                    const environmentDefaults = (0, http_client_config_1.getHttpClientConfig)(nodeEnv);
+                    // 4. 深度合并: 环境默认值 -> 环境变量配置 -> 用户配置
+                    // 用户配置优先级最高，会覆盖前面的配置
+                    const finalConfig = (0, http_client_config_1.mergeHttpClientConfig)((0, http_client_config_1.mergeHttpClientConfig)(envConfig, environmentDefaults), userConfig);
+                    return finalConfig;
                 }),
                 inject: config.inject || [config_1.ConfigService],
             },
             circuit_breaker_service_1.HttpCircuitBreakerService,
-            logging_service_1.HttpLoggingService,
-            cache_service_2.HttpCacheService,
+            {
+                provide: logging_service_1.HttpLoggingService,
+                useFactory: (httpConfig) => {
+                    var _a, _b;
+                    // Check if database logging is enabled in the config
+                    const databaseLoggingEnabled = (_b = (_a = httpConfig === null || httpConfig === void 0 ? void 0 : httpConfig.logging) === null || _a === void 0 ? void 0 : _a.databaseLogging) === null || _b === void 0 ? void 0 : _b.enabled;
+                    return new logging_service_1.HttpLoggingService();
+                },
+                inject: ['HTTP_CLIENT_CONFIG'],
+            },
             http_log_query_service_1.HttpLogQueryService,
-            log_cleanup_service_1.HttpLogCleanupService,
-            api_client_registry_service_1.ApiClientRegistryService,
+            {
+                provide: log_cleanup_service_1.HttpLogCleanupService,
+                useFactory: (logQueryService, httpConfig) => {
+                    return new log_cleanup_service_1.HttpLogCleanupService(logQueryService, httpConfig.logCleanup || {});
+                },
+                inject: [http_log_query_service_1.HttpLogQueryService, 'HTTP_CLIENT_CONFIG'],
+            },
+            {
+                provide: api_client_registry_service_1.ApiClientRegistryService,
+                useFactory: (circuitBreakerService, loggingService, httpConfig) => {
+                    return new api_client_registry_service_1.ApiClientRegistryService(circuitBreakerService, loggingService, {});
+                },
+                inject: [
+                    circuit_breaker_service_1.HttpCircuitBreakerService,
+                    logging_service_1.HttpLoggingService,
+                    'HTTP_CLIENT_CONFIG',
+                ],
+            },
             {
                 provide: http_client_service_1.HttpClientService,
-                useFactory: (circuitBreakerService, loggingService, cacheService, redisLockService, httpConfig) => {
-                    return new http_client_service_1.HttpClientService(circuitBreakerService, loggingService, cacheService, redisLockService, httpConfig);
+                useFactory: (circuitBreakerService, loggingService, redisLockService, httpConfig) => {
+                    return new http_client_service_1.HttpClientService(circuitBreakerService, loggingService, redisLockService, httpConfig);
                 },
                 inject: [
                     circuit_breaker_service_1.HttpCircuitBreakerService,
                     logging_service_1.HttpLoggingService,
-                    cache_service_2.HttpCacheService,
                     redis_lock_service_1.RedisLockService,
                     'HTTP_CLIENT_CONFIG',
                 ],
@@ -137,13 +224,16 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             http_client_service_1.HttpClientService,
             circuit_breaker_service_1.HttpCircuitBreakerService,
             logging_service_1.HttpLoggingService,
-            cache_service_2.HttpCacheService,
             http_log_query_service_1.HttpLogQueryService,
             log_cleanup_service_1.HttpLogCleanupService,
             api_client_registry_service_1.ApiClientRegistryService,
         ];
         // 动态导入
-        const dynamicImports = [config_1.ConfigModule, ...(config.imports || [])];
+        const dynamicImports = [
+            config_1.ConfigModule,
+            typeorm_1.TypeOrmModule.forFeature([entities_1.HttpLogEntity]), // 始终导入，服务内部根据配置决定是否使用
+            ...(config.imports || []),
+        ];
         return {
             module: HttpClientModule_1,
             imports: dynamicImports,
@@ -151,21 +241,32 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             exports: baseExports,
         };
     }
+    /**
+     * 安全地从环境变量解析整数
+     * @param configService NestJS ConfigService
+     * @param key 环境变量键
+     * @param defaultValue 默认值
+     * @returns 解析后的数字或默认值
+     */
+    static parseEnvInt(configService, key, defaultValue) {
+        const value = configService.get(key);
+        if (value === undefined || value === null || value === '') {
+            return defaultValue;
+        }
+        const parsed = parseInt(value, 10);
+        return isNaN(parsed) ? defaultValue : parsed;
+    }
     /**
      * 从环境变量加载配置
      */
     static loadConfigFromEnvironment(configService) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a;
         return {
             baseURL: configService.get('HTTP_CLIENT_BASE_URL'),
-            timeout: configService.get('HTTP_CLIENT_TIMEOUT')
-                ? parseInt(configService.get('HTTP_CLIENT_TIMEOUT'))
-                : undefined,
+            timeout: this.parseEnvInt(configService, 'HTTP_CLIENT_TIMEOUT'),
             retry: {
                 enabled: configService.get('HTTP_CLIENT_RETRY_ENABLED') === 'true',
-                retries: configService.get('HTTP_CLIENT_RETRY_RETRIES')
-                    ? parseInt(configService.get('HTTP_CLIENT_RETRY_RETRIES'))
-                    : undefined,
+                retries: this.parseEnvInt(configService, 'HTTP_CLIENT_RETRY_RETRIES'),
                 retryDelay: configService.get('HTTP_CLIENT_RETRY_DELAY_STRATEGY') ===
                     'exponential'
                     ? (retryCount) => Math.pow(2, retryCount) * 1000
@@ -180,49 +281,12 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             circuitBreaker: {
                 enabled: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_ENABLED') ===
                     'true',
-                failureThreshold: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_FAILURE_THRESHOLD')
-                    ? parseInt(configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_FAILURE_THRESHOLD'))
-                    : 5,
-                recoveryTimeoutMs: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_RECOVERY_TIMEOUT')
-                    ? parseInt(configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_RECOVERY_TIMEOUT'))
-                    : 60000,
-                monitoringPeriodMs: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_MONITORING_PERIOD')
-                    ? parseInt(configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_MONITORING_PERIOD'))
-                    : 10000,
-                minimumThroughputThreshold: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_MINIMUM_THROUGHPUT')
-                    ? parseInt(configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_MINIMUM_THROUGHPUT'))
-                    : 10,
+                failureThreshold: this.parseEnvInt(configService, 'HTTP_CLIENT_CIRCUIT_BREAKER_FAILURE_THRESHOLD', 5),
+                recoveryTimeoutMs: this.parseEnvInt(configService, 'HTTP_CLIENT_CIRCUIT_BREAKER_RECOVERY_TIMEOUT', 60000),
+                monitoringPeriodMs: this.parseEnvInt(configService, 'HTTP_CLIENT_CIRCUIT_BREAKER_MONITORING_PERIOD', 10000),
+                minimumThroughputThreshold: this.parseEnvInt(configService, 'HTTP_CLIENT_CIRCUIT_BREAKER_MINIMUM_THROUGHPUT', 10),
                 countHalfOpenCalls: configService.get('HTTP_CLIENT_CIRCUIT_BREAKER_COUNT_HALF_OPEN') === 'true',
             },
-            cache: {
-                enabled: configService.get('HTTP_CLIENT_CACHE_ENABLED') !== 'false',
-                defaultTtl: configService.get('HTTP_CLIENT_CACHE_DEFAULT_TTL')
-                    ? parseInt(configService.get('HTTP_CLIENT_CACHE_DEFAULT_TTL'))
-                    : 300000,
-                cacheableMethods: ((_b = (_a = configService
-                    .get('HTTP_CLIENT_CACHEABLE_METHODS')) === null || _a === void 0 ? void 0 : _a.split(',')) === null || _b === void 0 ? void 0 : _b.map((method) => method.trim().toUpperCase())) || [
-                    'GET',
-                    'HEAD',
-                ],
-                cacheableStatusCodes: ((_d = (_c = configService
-                    .get('HTTP_CLIENT_CACHEABLE_STATUS_CODES')) === null || _c === void 0 ? void 0 : _c.split(',')) === null || _d === void 0 ? void 0 : _d.map((code) => parseInt(code.trim()))) || [200, 201, 304],
-                options: {
-                    layers: ((_f = (_e = configService
-                        .get('HTTP_CLIENT_CACHE_LAYERS')) === null || _e === void 0 ? void 0 : _e.split(',')) === null || _f === void 0 ? void 0 : _f.map((layer) => {
-                        const trimmed = layer.trim();
-                        switch (trimmed) {
-                            case 'cls':
-                                return cache_options_interface_1.CacheLayer.CLS;
-                            case 'memory':
-                                return cache_options_interface_1.CacheLayer.MEMORY;
-                            case 'redis':
-                                return cache_options_interface_1.CacheLayer.REDIS;
-                            default:
-                                return cache_options_interface_1.CacheLayer.MEMORY;
-                        }
-                    })) || [cache_options_interface_1.CacheLayer.MEMORY],
-                },
-            },
             logging: {
                 enabled: configService.get('HTTP_CLIENT_LOGGING_ENABLED') !== 'false',
                 logRequests: configService.get('HTTP_CLIENT_LOG_REQUESTS') !== 'false',
@@ -230,19 +294,15 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
                 logErrors: configService.get('HTTP_CLIENT_LOG_ERRORS') !== 'false',
                 logHeaders: configService.get('HTTP_CLIENT_LOG_HEADERS') !== 'false',
                 logBody: configService.get('HTTP_CLIENT_LOG_BODY') !== 'false',
-                maxBodyLength: configService.get('HTTP_CLIENT_LOG_MAX_BODY_LENGTH')
-                    ? parseInt(configService.get('HTTP_CLIENT_LOG_MAX_BODY_LENGTH'))
-                    : undefined,
-                sanitizeHeaders: (_g = configService
-                    .get('HTTP_CLIENT_LOG_SANITIZE_HEADERS')) === null || _g === void 0 ? void 0 : _g.split(','),
+                maxBodyLength: this.parseEnvInt(configService, 'HTTP_CLIENT_LOG_MAX_BODY_LENGTH'),
+                sanitize: (_a = configService
+                    .get('HTTP_CLIENT_LOG_SANITIZE')) === null || _a === void 0 ? void 0 : _a.split(','),
                 logLevel: configService.get('HTTP_CLIENT_LOG_LEVEL'),
                 databaseLogging: {
                     enabled: configService.get('HTTP_CLIENT_DB_LOGGING_ENABLED') ===
                         'true',
                     dataSource: configService.get('HTTP_CLIENT_DB_LOGGING_DATA_SOURCE') ||
                         'default',
-                    tableName: configService.get('HTTP_CLIENT_DB_LOGGING_TABLE_NAME') ||
-                        'http_logs',
                 },
             },
             proxy: {

package/http-client/index.d.ts

@@ -1,4 +1,4 @@
-export { HttpClientConfig, RetryConfig, CircuitBreakerConfig, HttpCacheConfig, ProxyConfig, LoggingConfig, InterceptorConfig, ConnectionPoolConfig, HttpContext, HttpInterceptor, HttpMethod, HttpStats, } from './interfaces/http-client-config.interface';
+export { HttpClientConfig, AxiosNativeConfig, SslCertificateConfig, RetryConfig, CircuitBreakerConfig, ProxyConfig, LoggingConfig, InterceptorConfig, ConnectionPoolConfig, HttpContext, HttpInterceptor, HttpMethod, HttpStats, } from './interfaces/http-client-config.interface';
 export * from './interfaces/api-client-config.interface';
 export { HttpLogEntity, RetryRecord } from './entities';
 export * from './decorators';

package/http-client/interfaces/api-client-config.interface.d.ts

@@ -47,6 +47,7 @@ export interface OAuth2Config {
     password?: string;
     redirectUri?: string;
     refreshToken?: string;
+    accessToken?: string;
 }
 /**
  * 自定义鉴权配置
@@ -115,17 +116,36 @@ export interface ResponseTransformerConfig {
 }
 /**
  * API客户端配置
+ * 用于创建多个具有不同配置的 HttpClient 实例
  */
 export interface ApiClientConfig {
     /** API名称（用于标识和日志） */
     name: string;
     /** 基础URL */
     baseURL: string;
-    /** HTTP客户端基础配置 */
-    httpConfig?: HttpClientConfig;
-    /** 鉴权配置 */
+    /**
+     * HttpClient 配置
+     * 包含所有 HttpClientConfig 的配置项（timeout, retry, logging, axiosConfig 等）
+     */
+    httpConfig?: Partial<HttpClientConfig>;
+    /**
+     * 重试配置（快捷方式，会合并到 httpConfig.retry）
+     * @deprecated 使用 httpConfig.retry 代替
+     */
+    retry?: {
+        enabled?: boolean;
+        retries?: number;
+        retryCondition?: (error: any) => boolean;
+    };
+    /**
+     * 鉴权配置
+     * API客户端特有的鉴权功能
+     */
     auth?: AuthConfig;
-    /** 响应转换配置 */
+    /**
+     * 响应转换配置
+     * API客户端特有的响应处理
+     */
     responseTransformer?: ResponseTransformerConfig;
     /** 默认请求头 */
     defaultHeaders?: Record<string, string>;
@@ -137,20 +157,12 @@ export interface ApiClientConfig {
         response?: Array<(response: AxiosResponse) => AxiosResponse | Promise<AxiosResponse>>;
         error?: Array<(error: any) => any>;
     };
-    /** 重试配置（覆盖全局配置） */
-    retry?: {
-        enabled?: boolean;
-        retries?: number;
-        retryCondition?: (error: any) => boolean;
-    };
     /** 是否启用响应验证 */
     enableValidation?: boolean;
     /** 响应时间警告阈值（毫秒） */
     responseTimeWarningThreshold?: number;
     /** 自定义标签（用于分类和查询） */
     tags?: string[];
-    /** 是否启用详细日志 */
-    enableDetailedLogging?: boolean;
 }
 /**
  * API客户端实例配置
@@ -184,94 +196,3 @@ export interface ApiClientRegistryConfig {
     /** 是否启用熔断器 */
     enableCircuitBreaker?: boolean;
 }
-/**
- * API客户端工厂接口
- */
-export interface ApiClientFactory {
-    /**
-     * 创建API客户端实例
-     */
-    createClient<T = any>(config: ApiClientInstanceConfig): T;
-    /**
-     * 获取已注册的客户端
-     */
-    getClient<T = any>(name: string): T;
-    /**
-     * 列出所有已注册的客户端
-     */
-    listClients(): string[];
-    /**
-     * 更新客户端配置
-     */
-    updateClient(name: string, config: Partial<ApiClientConfig>): void;
-    /**
-     * 移除客户端
-     */
-    removeClient(name: string): void;
-}
-/**
- * API客户端接口
- */
-export interface ApiClient {
-    /** 客户端名称 */
-    name: string;
-    /** 客户端配置 */
-    config: ApiClientConfig;
-    /** 基础HTTP请求方法 */
-    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
-    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
-    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
-    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
-    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
-    /** 通用请求方法 */
-    request<T = any>(config: AxiosRequestConfig): Promise<T>;
-    /** 获取客户端统计信息 */
-    getStats(): any;
-    /** 重置统计信息 */
-    resetStats(): void;
-}
-/**
- * 通用API响应格式
- */
-export interface ApiResponse<T = any> {
-    /** 响应数据 */
-    data?: T;
-    /** 响应代码 */
-    code?: number;
-    /** 响应消息 */
-    message?: string;
-    /** 成功标识 */
-    success?: boolean;
-    /** 错误详情 */
-    error?: {
-        code?: string;
-        message?: string;
-        details?: any;
-    };
-    /** 分页信息 */
-    pagination?: {
-        page?: number;
-        pageSize?: number;
-        total?: number;
-        totalPages?: number;
-    };
-    /** 请求ID */
-    requestId?: string;
-    /** 时间戳 */
-    timestamp?: string;
-}
-/**
- * 错误响应格式
- */
-export interface ErrorResponse {
-    /** 错误代码 */
-    code: string | number;
-    /** 错误消息 */
-    message: string;
-    /** 错误详情 */
-    details?: any;
-    /** 堆栈信息 */
-    stack?: string;
-    /** 请求ID */
-    requestId?: string;
-}