@nest-omni/core 4.1.3-19 → 4.1.3-20

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

@@ -21,49 +21,73 @@ const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const typeorm_1 = require("@nestjs/typeorm");
 const typeorm_2 = require("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;
         // 基础服务提供者
         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,
             {
                 provide: logging_service_1.HttpLoggingService,
-                useFactory: (httpConfig, dataSource) => {
+                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(databaseLoggingEnabled ? dataSource : undefined);
+                    return new logging_service_1.HttpLoggingService();
                 },
                 inject: ['HTTP_CLIENT_CONFIG', typeorm_2.DataSource],
             },
-            cache_service_2.HttpCacheService,
             http_log_query_service_1.HttpLogQueryService,
             {
                 provide: log_cleanup_service_1.HttpLogCleanupService,
@@ -74,26 +98,23 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             },
             {
                 provide: api_client_registry_service_1.ApiClientRegistryService,
-                useFactory: (httpClientService, circuitBreakerService, loggingService, cacheService, httpConfig) => {
-                    return new api_client_registry_service_1.ApiClientRegistryService(httpClientService, circuitBreakerService, loggingService, cacheService, {});
+                useFactory: (circuitBreakerService, loggingService, httpConfig) => {
+                    return new api_client_registry_service_1.ApiClientRegistryService(circuitBreakerService, loggingService, {});
                 },
                 inject: [
-                    http_client_service_1.HttpClientService,
                     circuit_breaker_service_1.HttpCircuitBreakerService,
                     logging_service_1.HttpLoggingService,
-                    cache_service_2.HttpCacheService,
                     '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',
                 ],
@@ -104,16 +125,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]));
-        }
+        // 动态导入 - 需要根据最终配置判断
+        // 由于配置是在运行时确定的，我们使用条件导入
+        const dynamicImports = [
+            config_1.ConfigModule,
+            typeorm_1.TypeOrmModule.forFeature([entities_1.HttpLogEntity]), // 始终导入，服务内部根据配置决定是否使用
+        ];
         return {
             module: HttpClientModule_1,
             imports: dynamicImports,
@@ -123,35 +144,50 @@ 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) {
-        // Determine if database logging will be enabled
-        // We need to check if the config will enable database logging
-        // This is a bit tricky since the config is async, so we'll inject DataSource conditionally later
-        const httpConfig = config.useFactory ? {} : {};
         // 基础服务提供者
         const baseProviders = [
             {
                 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,
             {
                 provide: logging_service_1.HttpLoggingService,
-                useFactory: (httpConfig, dataSource) => {
+                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(databaseLoggingEnabled ? dataSource : undefined);
+                    return new logging_service_1.HttpLoggingService();
                 },
                 inject: ['HTTP_CLIENT_CONFIG', typeorm_2.DataSource],
             },
-            cache_service_2.HttpCacheService,
             http_log_query_service_1.HttpLogQueryService,
             {
                 provide: log_cleanup_service_1.HttpLogCleanupService,
@@ -162,26 +198,23 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
             },
             {
                 provide: api_client_registry_service_1.ApiClientRegistryService,
-                useFactory: (httpClientService, circuitBreakerService, loggingService, cacheService, httpConfig) => {
-                    return new api_client_registry_service_1.ApiClientRegistryService(httpClientService, circuitBreakerService, loggingService, cacheService, {});
+                useFactory: (circuitBreakerService, loggingService, httpConfig) => {
+                    return new api_client_registry_service_1.ApiClientRegistryService(circuitBreakerService, loggingService, {});
                 },
                 inject: [
-                    http_client_service_1.HttpClientService,
                     circuit_breaker_service_1.HttpCircuitBreakerService,
                     logging_service_1.HttpLoggingService,
-                    cache_service_2.HttpCacheService,
                     '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',
                 ],
@@ -192,13 +225,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,
@@ -210,7 +246,7 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
      * 从环境变量加载配置
      */
     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')
@@ -249,35 +285,6 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
                     : 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',
@@ -288,16 +295,14 @@ let HttpClientModule = HttpClientModule_1 = class HttpClientModule {
                 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(','),
+                sanitizeHeaders: (_a = configService
+                    .get('HTTP_CLIENT_LOG_SANITIZE_HEADERS')) === 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, 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;
 }
 /**
  * 自定义鉴权配置
@@ -184,94 +185,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;
-}

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

@@ -1,37 +1,46 @@
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
-import { CacheOptions } from '../../cache/interfaces/cache-options.interface';
 import { LogCleanupConfig } from '../services/log-cleanup.service';
+import { SSRFProtectionConfig, URLValidationConfig } from '../utils/security-validator.util';
 /**
  * HTTP客户端配置接口
  * 基于Spring Boot的@ConfigurationProperties设计理念
+ * 所有字段都是可选的，模块会使用合理的默认值
  */
 export interface HttpClientConfig {
     /** 基础配置 */
     baseURL?: string;
     timeout?: number;
     /** 重试配置 */
-    retry?: RetryConfig;
+    retry?: Partial<RetryConfig>;
     /** 熔断器配置 */
-    circuitBreaker?: CircuitBreakerConfig;
-    /** 缓存配置 */
-    cache?: HttpCacheConfig;
+    circuitBreaker?: Partial<CircuitBreakerConfig>;
     /** 代理配置 */
-    proxy?: ProxyConfig;
+    proxy?: Partial<ProxyConfig>;
     /** 日志配置 */
-    logging?: LoggingConfig;
+    logging?: Partial<LoggingConfig>;
     /** 日志清理配置 */
-    logCleanup?: LogCleanupConfig;
+    logCleanup?: Partial<LogCleanupConfig>;
     /** 拦截器配置 */
-    interceptors?: InterceptorConfig;
+    interceptors?: Partial<InterceptorConfig>;
     /** 连接池配置 */
-    connectionPool?: ConnectionPoolConfig;
+    connectionPool?: Partial<ConnectionPoolConfig>;
+    /** 安全配置 */
+    security?: {
+        /** URL验证配置 */
+        urlValidation?: Partial<URLValidationConfig>;
+        /** SSRF防护配置 */
+        ssrfProtection?: Partial<SSRFProtectionConfig>;
+        /** 是否启用安全验证 */
+        enabled?: boolean;
+    };
 }
 /**
  * 重试配置
  * 基于axios-retry库的配置
+ * 所有字段都是可选的
  */
 export interface RetryConfig {
-    enabled: boolean;
+    enabled?: boolean;
     retries?: number;
     retryDelay?: (retryCount: number) => number;
     retryCondition?: (error: any) => boolean;
@@ -41,37 +50,22 @@ export interface RetryConfig {
 /**
  * 熔断器配置
  * 类似Spring Cloud CircuitBreaker
+ * 所有字段都是可选的
  */
 export interface CircuitBreakerConfig {
-    enabled: boolean;
-    failureThreshold: number;
-    recoveryTimeoutMs: number;
-    monitoringPeriodMs: number;
-    minimumThroughputThreshold: number;
-    countHalfOpenCalls: boolean;
-}
-/**
- * HTTP缓存配置
- * 集成现有的三层缓存架构
- */
-export interface HttpCacheConfig {
-    enabled: boolean;
-    /** 缓存选项，使用core中的CacheOptions */
-    options?: Omit<CacheOptions, 'ttl' | 'namespace'>;
-    /** 默认TTL（毫秒） */
-    defaultTtl?: number;
-    /** 可缓存的方法 */
-    cacheableMethods: string[];
-    /** 可缓存的状态码 */
-    cacheableStatusCodes: number[];
-    /** 自定义缓存键生成器 */
-    keyGenerator?: (config: AxiosRequestConfig) => string;
+    enabled?: boolean;
+    failureThreshold?: number;
+    recoveryTimeoutMs?: number;
+    monitoringPeriodMs?: number;
+    minimumThroughputThreshold?: number;
+    countHalfOpenCalls?: boolean;
 }
 /**
  * 代理配置
+ * 所有字段都是可选的
  */
 export interface ProxyConfig {
-    enabled: boolean;
+    enabled?: boolean;
     /** 是否从环境变量读取代理配置 (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) */
     fromEnvironment?: boolean;
     /** 手动指定的代理主机 (当 fromEnvironment 为 false 时使用) */
@@ -82,47 +76,49 @@ export interface ProxyConfig {
     protocol?: 'http' | 'https';
     /** 代理认证信息 */
     auth?: {
-        username: string;
-        password: string;
+        username?: string;
+        password?: string;
     };
 }
 /**
  * 日志配置
  * 类似Spring Boot的logging配置
+ * 所有字段都是可选的
  */
 export interface LoggingConfig {
-    enabled: boolean;
-    logRequests: boolean;
-    logResponses: boolean;
-    logErrors: boolean;
-    logHeaders: boolean;
-    logBody: boolean;
-    maxBodyLength: number;
-    sanitizeHeaders: string[];
-    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    enabled?: boolean;
+    logRequests?: boolean;
+    logResponses?: boolean;
+    logErrors?: boolean;
+    logHeaders?: boolean;
+    logBody?: boolean;
+    maxBodyLength?: number;
+    sanitizeHeaders?: string[];
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
     databaseLogging?: {
-        enabled: boolean;
-        dataSource: string;
-        tableName: string;
+        enabled?: boolean;
+        dataSource?: string;
     };
 }
 /**
  * 拦截器配置
+ * 所有字段都是可选的
  */
 export interface InterceptorConfig {
-    requestInterceptors: string[];
-    responseInterceptors: string[];
-    errorInterceptors: string[];
+    requestInterceptors?: string[];
+    responseInterceptors?: string[];
+    errorInterceptors?: string[];
 }
 /**
  * 连接池配置
+ * 所有字段都是可选的
  */
 export interface ConnectionPoolConfig {
-    enabled: boolean;
-    maxSockets: number;
-    maxFreeSockets: number;
-    timeoutMs: number;
-    keepAlive: boolean;
+    enabled?: boolean;
+    maxSockets?: number;
+    maxFreeSockets?: number;
+    timeoutMs?: number;
+    keepAlive?: boolean;
 }
 /**
  * HTTP请求上下文
@@ -181,9 +177,4 @@ export interface HttpStats {
     requestsByMethod: Record<HttpMethod, number>;
     requestsByStatus: Record<number, number>;
     circuitBreakerStats: Record<string, any>;
-    cacheStats: {
-        hits: number;
-        misses: number;
-        hitRate: number;
-    };
 }

package/http-client/services/api-client-registry.service.d.ts

@@ -1,24 +1,22 @@
-import { ApiClientConfig, ApiClientInstanceConfig, ApiClientRegistryConfig, AuthType, OAuth2Config, ResponseTransformerConfig } from '../interfaces/api-client-config.interface';
-import { HttpClientService } from './http-client.service';
+import { ApiClientConfig, ApiClientInstanceConfig, ApiClientRegistryConfig, AuthType, ResponseTransformerConfig } from '../interfaces/api-client-config.interface';
 import { HttpCircuitBreakerService } from './circuit-breaker.service';
 import { HttpLoggingService } from './logging.service';
-import { HttpCacheService } from './cache.service';
-export { ApiClientInstanceConfig, AuthType, OAuth2Config, ResponseTransformerConfig, };
+export { ApiClientInstanceConfig, AuthType, ResponseTransformerConfig, };
 /**
  * API客户端注册服务
+ * 负责管理多个 HttpClientService 实例
  */
 export declare class ApiClientRegistryService {
-    private readonly httpClientService;
     private readonly circuitBreakerService;
     private readonly loggingService;
-    private readonly cacheService;
     private readonly logger;
     private readonly clients;
     private readonly clientConfigs;
     private readonly globalDefaults;
-    constructor(httpClientService: HttpClientService, circuitBreakerService: HttpCircuitBreakerService, loggingService: HttpLoggingService, cacheService: HttpCacheService, globalConfig?: ApiClientRegistryConfig);
+    constructor(circuitBreakerService: HttpCircuitBreakerService, loggingService: HttpLoggingService, globalConfig?: ApiClientRegistryConfig);
     /**
      * 创建API客户端实例
+     * 使用 HttpClientService.createApiClient 静态方法创建
      */
     createClient<T = any>(config: ApiClientInstanceConfig): T;
     /**
@@ -75,22 +73,6 @@ export declare class ApiClientRegistryService {
             error?: string;
         }>;
     }>;
-    /**
-     * 创建Axios实例
-     */
-    private createAxiosInstance;
-    /**
-     * 应用鉴权配置
-     */
-    private applyAuthentication;
-    /**
-     * 应用响应转换器
-     */
-    private applyResponseTransformer;
-    /**
-     * 根据路径提取数据
-     */
-    private extractDataByPath;
     /**
      * 合并环境特定配置
      */