@nest-omni/core 4.1.3-12 → 4.1.3-13

package/{http-client → dist/http-client}/services/http-client.service.js

@@ -31,6 +31,7 @@ const context_extractor_util_1 = require("../utils/context-extractor.util");
 const curl_generator_util_1 = require("../utils/curl-generator.util");
 const retry_recorder_util_1 = require("../utils/retry-recorder.util");
 const request_id_util_1 = require("../utils/request-id.util");
+const proxy_environment_util_1 = require("../utils/proxy-environment.util");
 const redis_lock_service_1 = require("../../redis-lock/redis-lock.service");
 /**
  * HTTP客户端服务
@@ -105,12 +106,10 @@ let HttpClientService = HttpClientService_1 = class HttpClientService {
                 // 应用代理配置
                 const proxyConfig = decoratorConfigs.proxy || this.defaultConfig.proxy;
                 if (proxyConfig === null || proxyConfig === void 0 ? void 0 : proxyConfig.enabled) {
-                    enhancedConfig.proxy = {
-                        host: proxyConfig.host,
-                        port: proxyConfig.port,
-                        protocol: proxyConfig.protocol,
-                        auth: proxyConfig.auth,
-                    };
+                    const resolvedProxy = this.resolveProxyConfig(proxyConfig, enhancedConfig.url);
+                    if (resolvedProxy !== false) {
+                        enhancedConfig.proxy = resolvedProxy;
+                    }
                 }
                 // 配置axios-retry的onRetry回调以记录重试
                 if ((_c = this.defaultConfig.retry) === null || _c === void 0 ? void 0 : _c.enabled) {
@@ -136,7 +135,7 @@ let HttpClientService = HttpClientService_1 = class HttpClientService {
                 }
                 // 成功日志
                 if (loggingOptions === null || loggingOptions === void 0 ? void 0 : loggingOptions.enabled) {
-                    const databaseLogging = (loggingOptions === null || loggingOptions === void 0 ? void 0 : loggingOptions.databaseLog) ||
+                    const databaseLogging = (loggingOptions === null || loggingOptions === void 0 ? void 0 : loggingOptions.databaseLogging) ||
                         ((_e = (_d = this.defaultConfig.logging) === null || _d === void 0 ? void 0 : _d.databaseLogging) === null || _e === void 0 ? void 0 : _e.enabled);
                     this.loggingService.logRequestSuccess(response, startTime, requestId, loggingOptions, databaseLogging, retryRecorder.getRecords(), cacheHit, circuitBreakerState, decoratorContext);
                 }
@@ -369,21 +368,14 @@ let HttpClientService = HttpClientService_1 = class HttpClientService {
      * 创建Axios实例并配置axios-retry
      */
     createAxiosInstance() {
-        var _a, _b;
+        var _a;
         const instance = require('axios').create({
             baseURL: this.defaultConfig.baseURL,
             timeout: this.defaultConfig.timeout,
-            proxy: ((_a = this.defaultConfig.proxy) === null || _a === void 0 ? void 0 : _a.enabled)
-                ? {
-                    host: this.defaultConfig.proxy.host,
-                    port: this.defaultConfig.proxy.port,
-                    protocol: this.defaultConfig.proxy.protocol,
-                    auth: this.defaultConfig.proxy.auth,
-                }
-                : undefined,
+            proxy: this.resolveProxyConfig(this.defaultConfig.proxy),
         });
         // 配置axios-retry
-        if ((_b = this.defaultConfig.retry) === null || _b === void 0 ? void 0 : _b.enabled) {
+        if ((_a = this.defaultConfig.retry) === null || _a === void 0 ? void 0 : _a.enabled) {
             (0, axios_retry_1.default)(instance, {
                 retries: this.defaultConfig.retry.retries || 3,
                 retryDelay: this.defaultConfig.retry.retryDelay ||
@@ -594,6 +586,58 @@ let HttpClientService = HttpClientService_1 = class HttpClientService {
         }
         return result;
     }
+    /**
+     * 解析代理配置
+     * 支持从环境变量或手动配置中读取
+     * @param proxyConfig 代理配置
+     * @param targetUrl 目标 URL（用于 NO_PROXY 检查）
+     * @returns 解析后的代理配置，如果不应使用代理则返回 false 或 undefined
+     */
+    resolveProxyConfig(proxyConfig, targetUrl) {
+        if (!(proxyConfig === null || proxyConfig === void 0 ? void 0 : proxyConfig.enabled)) {
+            return undefined;
+        }
+        // 如果启用从环境变量读取
+        if (proxyConfig.fromEnvironment) {
+            // 确定目标协议
+            let protocol = 'http';
+            if (targetUrl) {
+                try {
+                    const url = new URL(targetUrl, this.defaultConfig.baseURL);
+                    protocol = url.protocol === 'https:' ? 'https' : 'http';
+                }
+                catch (error) {
+                    this.logger.warn(`Failed to parse target URL: ${error.message}`);
+                }
+            }
+            // 从环境变量解析
+            const fullUrl = targetUrl
+                ? new URL(targetUrl, this.defaultConfig.baseURL).href
+                : undefined;
+            const envProxy = proxy_environment_util_1.ProxyEnvironmentParser.parseFromEnvironment(protocol, fullUrl);
+            if (envProxy === false) {
+                this.logger.debug('Proxy bypassed based on environment configuration');
+                return false;
+            }
+            return {
+                host: envProxy.host,
+                port: envProxy.port,
+                protocol: envProxy.protocol,
+                auth: envProxy.auth,
+            };
+        }
+        // 使用手动配置
+        if (proxyConfig.host && proxyConfig.port) {
+            return {
+                host: proxyConfig.host,
+                port: proxyConfig.port,
+                protocol: proxyConfig.protocol,
+                auth: proxyConfig.auth,
+            };
+        }
+        this.logger.warn('Proxy is enabled but neither fromEnvironment nor manual configuration is provided');
+        return undefined;
+    }
 };
 exports.HttpClientService = HttpClientService;
 exports.HttpClientService = HttpClientService = HttpClientService_1 = __decorate([

package/{http-client → dist/http-client}/services/logging.service.d.ts

@@ -17,7 +17,7 @@ export declare class HttpLoggingService {
     /**
      * 记录请求成功响应
      */
-    logRequestSuccess(response: AxiosResponse, startTime: number, requestId: string, loggingOptions: any, databaseLogging?: boolean, retryRecords?: any[], cacheHit?: boolean, circuitBreakerState?: string, decoratorContext?: any): void;
+    logRequestSuccess(response: AxiosResponse, startTime: number, requestId: string, loggingOptions: any, databaseLogging?: boolean, retryRecords?: any[], cacheHit?: boolean, circuitBreakerState?: string, decoratorContext?: any): Promise<void>;
     /**
      * 记录请求错误
      */

package/{http-client → dist/http-client}/services/logging.service.js

@@ -26,6 +26,7 @@ const http_log_entity_1 = require("../entities/http-log.entity");
 const request_id_util_1 = require("../utils/request-id.util");
 const context_extractor_util_1 = require("../utils/context-extractor.util");
 const call_stack_extractor_util_1 = require("../utils/call-stack-extractor.util");
+const transaction_1 = require("../../transaction");
 /**
  * HTTP日志服务
  * 基于Spring Boot的请求日志记录机制，集成现有的ContextProvider
@@ -74,71 +75,77 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
     /**
      * 记录请求成功响应
      */
-    logRequestSuccess(response, startTime, requestId, loggingOptions, databaseLogging = false, retryRecords, cacheHit, circuitBreakerState, decoratorContext) {
-        var _a, _b;
-        const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
-        const responseTime = Date.now() - startTime;
-        // 获取当前上下文信息
-        const context = context_extractor_util_1.ContextExtractor.getHttpContext();
-        const logData = {
-            requestId,
-            userId: context.userId,
-            statusCode: response.status,
-            responseTime,
-            headers: logHeaders
-                ? this.sanitizeHeaders(response.headers, sanitizeHeaders)
-                : undefined,
-            body: logBody ? this.sanitizeBody(response.data) : undefined,
-            responseSize: JSON.stringify(response.data).length,
-            cacheHit,
-            circuitBreakerState,
-        };
-        const logMessage = `HTTP Response [${requestId}]: ${response.status} (${responseTime}ms)${cacheHit ? ' [CACHE HIT]' : ''}`;
-        switch ((loggingOptions || {}).logLevel) {
-            case 'debug':
-                this.logger.debug(logMessage, logData);
-                break;
-            case 'info':
-            default:
-                this.logger.log(logMessage, logData);
-                break;
-        }
-        // 数据库日志记录
-        if (databaseLogging && this.logRepository) {
-            // 提取调用信息
-            const callInfo = this.extractCallInfo(decoratorContext, response.config);
-            this.saveToDatabase({
-                id: requestId,
+    logRequestSuccess(response_1, startTime_1, requestId_1, loggingOptions_1) {
+        return __awaiter(this, arguments, void 0, function* (response, startTime, requestId, loggingOptions, databaseLogging = false, retryRecords, cacheHit, circuitBreakerState, decoratorContext) {
+            var _a, _b;
+            const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
+            const responseTime = Date.now() - startTime;
+            // 获取当前上下文信息
+            const context = context_extractor_util_1.ContextExtractor.getHttpContext();
+            const logData = {
                 requestId,
                 userId: context.userId,
-                method: ((_a = response.config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || 'UNKNOWN',
-                url: response.config.url || '',
-                headers: this.sanitizeHeaders(response.config.headers, sanitizeHeaders),
-                body: this.sanitizeBodyAsString(response.config.data),
-                params: response.config.params,
                 statusCode: response.status,
                 responseTime,
-                attemptCount: (retryRecords === null || retryRecords === void 0 ? void 0 : retryRecords.length)
-                    ? Math.max(...retryRecords.map((r) => r.attempt))
-                    : 1,
-                success: true,
-                responseHeaders: this.sanitizeHeaders(response.headers, sanitizeHeaders),
-                responseBody: logBody
-                    ? this.sanitizeBodyAsString(response.data)
+                headers: logHeaders
+                    ? this.sanitizeHeaders(response.headers, sanitizeHeaders)
                     : undefined,
+                body: logBody ? this.sanitizeBody(response.data) : undefined,
                 responseSize: JSON.stringify(response.data).length,
-                requestSize: JSON.stringify(response.config.data).length,
-                serviceName: context.appId,
-                operationName: callInfo.operationName,
-                clientIp: context.clientIp,
-                source: (_b = context.metadata) === null || _b === void 0 ? void 0 : _b.source,
-                tags: context.tags,
-                metadata: logData,
-                retryRecords,
                 cacheHit,
                 circuitBreakerState,
-            });
-        }
+            };
+            const logMessage = `HTTP Response [${requestId}]: ${response.status} (${responseTime}ms)${cacheHit ? ' [CACHE HIT]' : ''}`;
+            switch ((loggingOptions || {}).logLevel) {
+                case 'debug':
+                    this.logger.debug(logMessage, logData);
+                    break;
+                    ``;
+                case 'info':
+                default:
+                    this.logger.log(logMessage, logData);
+                    break;
+            }
+            if (!this.logRepository) {
+                this.logRepository = transaction_1.TransactionContextService.getDataSource().getRepository(loggingOptions.databaseLogging.tableName);
+            }
+            // 数据库日志记录
+            if (databaseLogging && this.logRepository) {
+                // 提取调用信息
+                const callInfo = this.extractCallInfo(decoratorContext, response.config);
+                this.saveToDatabase({
+                    id: requestId,
+                    requestId,
+                    userId: context.userId,
+                    method: ((_a = response.config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || 'UNKNOWN',
+                    url: response.config.url || '',
+                    headers: this.sanitizeHeaders(response.config.headers, sanitizeHeaders),
+                    body: this.sanitizeBodyAsString(response.config.data),
+                    params: response.config.params,
+                    statusCode: response.status,
+                    responseTime,
+                    attemptCount: (retryRecords === null || retryRecords === void 0 ? void 0 : retryRecords.length)
+                        ? Math.max(...retryRecords.map((r) => r.attempt))
+                        : 1,
+                    success: true,
+                    responseHeaders: this.sanitizeHeaders(response.headers, sanitizeHeaders),
+                    responseBody: logBody
+                        ? this.sanitizeBodyAsString(response.data)
+                        : undefined,
+                    responseSize: JSON.stringify(response.data).length,
+                    requestSize: JSON.stringify(response.config.data).length,
+                    serviceName: context.appId,
+                    operationName: callInfo.operationName,
+                    clientIp: context.clientIp,
+                    source: (_b = context.metadata) === null || _b === void 0 ? void 0 : _b.source,
+                    tags: context.tags,
+                    metadata: logData,
+                    retryRecords,
+                    cacheHit,
+                    circuitBreakerState,
+                });
+            }
+        });
     }
     /**
      * 记录请求错误
@@ -389,13 +396,22 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
      */
     saveToDatabase(logEntity) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!this.logRepository)
+            if (!this.logRepository) {
+                this.logger.warn('Log repository not initialized, skipping database logging');
                 return;
+            }
             try {
+                this.logger.debug('Saving HTTP log to database', {
+                    requestId: logEntity.requestId,
+                });
                 yield this.logRepository.save(logEntity);
+                this.logger.debug('Successfully saved HTTP log to database', {
+                    requestId: logEntity.requestId,
+                });
             }
             catch (error) {
                 this.logger.error('Failed to save HTTP log to database', error);
+                this.logger.error('Log entity details', logEntity);
             }
         });
     }

package/{http-client → dist/http-client}/utils/index.d.ts

@@ -2,3 +2,4 @@ export * from './curl-generator.util';
 export * from './retry-recorder.util';
 export * from './context-extractor.util';
 export * from './call-stack-extractor.util';
+export * from './proxy-environment.util';

package/{http-client → dist/http-client}/utils/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./curl-generator.util"), exports);
 __exportStar(require("./retry-recorder.util"), exports);
 __exportStar(require("./context-extractor.util"), exports);
 __exportStar(require("./call-stack-extractor.util"), exports);
+__exportStar(require("./proxy-environment.util"), exports);

package/dist/http-client/utils/proxy-environment.util.d.ts

@@ -0,0 +1,42 @@
+import { ProxyConfig } from '../interfaces/http-client-config.interface';
+/**
+ * 代理环境变量解析工具
+ * 支持标准的代理环境变量：HTTP_PROXY, HTTPS_PROXY, NO_PROXY
+ */
+export declare class ProxyEnvironmentParser {
+    private static readonly logger;
+    /**
+     * 从环境变量解析代理配置
+     * @param protocol 请求协议 (http 或 https)
+     * @param targetUrl 目标 URL（用于检查 NO_PROXY）
+     * @returns 解析后的代理配置，如果不应使用代理则返回 false
+     */
+    static parseFromEnvironment(protocol?: 'http' | 'https', targetUrl?: string): false | Required<Omit<ProxyConfig, 'enabled' | 'fromEnvironment'>>;
+    /**
+     * 解析代理 URL
+     * 支持格式: http://proxy:port, http://user:pass@proxy:port
+     */
+    private static parseProxyUrl;
+    /**
+     * 检查是否应该绕过代理
+     * 基于 NO_PROXY 环境变量
+     */
+    private static shouldBypassProxy;
+    /**
+     * 简单的 IP 地址匹配
+     * 支持精确匹配和 CIDR 表示法
+     */
+    private static isIpMatch;
+    /**
+     * 获取所有代理相关的环境变量
+     */
+    static getProxyEnvironmentVariables(): {
+        HTTP_PROXY?: string;
+        HTTPS_PROXY?: string;
+        NO_PROXY?: string;
+    };
+    /**
+     * 检查是否设置了代理环境变量
+     */
+    static hasProxyEnvironment(): boolean;
+}

package/dist/http-client/utils/proxy-environment.util.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProxyEnvironmentParser = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 代理环境变量解析工具
+ * 支持标准的代理环境变量：HTTP_PROXY, HTTPS_PROXY, NO_PROXY
+ */
+class ProxyEnvironmentParser {
+    /**
+     * 从环境变量解析代理配置
+     * @param protocol 请求协议 (http 或 https)
+     * @param targetUrl 目标 URL（用于检查 NO_PROXY）
+     * @returns 解析后的代理配置，如果不应使用代理则返回 false
+     */
+    static parseFromEnvironment(protocol = 'http', targetUrl) {
+        // 获取代理环境变量 (大写和小写都支持)
+        const proxyEnv = protocol === 'https'
+            ? process.env.HTTPS_PROXY ||
+                process.env.https_proxy ||
+                process.env.HTTP_PROXY ||
+                process.env.http_proxy
+            : process.env.HTTP_PROXY || process.env.http_proxy;
+        // 检查是否应该跳过代理
+        if (targetUrl && this.shouldBypassProxy(targetUrl)) {
+            this.logger.debug(`Bypassing proxy for ${targetUrl} due to NO_PROXY`);
+            return false;
+        }
+        if (!proxyEnv) {
+            this.logger.debug('No proxy environment variable found');
+            return false;
+        }
+        try {
+            const proxyConfig = this.parseProxyUrl(proxyEnv);
+            this.logger.debug(`Parsed proxy configuration from environment: ${JSON.stringify(proxyConfig)}`);
+            return proxyConfig;
+        }
+        catch (error) {
+            this.logger.warn(`Failed to parse proxy URL from environment: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * 解析代理 URL
+     * 支持格式: http://proxy:port, http://user:pass@proxy:port
+     */
+    static parseProxyUrl(proxyUrl) {
+        try {
+            const url = new URL(proxyUrl);
+            const config = {
+                protocol: url.protocol.replace(':', '') || 'http',
+                host: url.hostname,
+                port: url.port ? parseInt(url.port, 10) : url.protocol === 'https:' ? 443 : 80,
+                auth: undefined,
+            };
+            // 解析认证信息
+            if (url.username || url.password) {
+                config.auth = {
+                    username: decodeURIComponent(url.username),
+                    password: decodeURIComponent(url.password),
+                };
+            }
+            return config;
+        }
+        catch (error) {
+            throw new Error(`Invalid proxy URL format: ${proxyUrl}`);
+        }
+    }
+    /**
+     * 检查是否应该绕过代理
+     * 基于 NO_PROXY 环境变量
+     */
+    static shouldBypassProxy(targetUrl) {
+        const noProxy = process.env.NO_PROXY || process.env.no_proxy;
+        if (!noProxy) {
+            return false;
+        }
+        try {
+            const url = new URL(targetUrl);
+            const hostname = url.hostname;
+            // NO_PROXY 可以是逗号分隔的列表
+            const bypassList = noProxy.split(',').map((item) => item.trim().toLowerCase());
+            for (const bypass of bypassList) {
+                if (!bypass)
+                    continue;
+                // 精确匹配
+                if (hostname.toLowerCase() === bypass) {
+                    return true;
+                }
+                // 通配符匹配 (例如 .example.com)
+                if (bypass.startsWith('.') && hostname.toLowerCase().endsWith(bypass)) {
+                    return true;
+                }
+                // 后缀匹配 (例如 example.com 匹配 api.example.com)
+                if (hostname.toLowerCase().endsWith('.' + bypass)) {
+                    return true;
+                }
+                // 特殊值 * 表示所有域名都绕过
+                if (bypass === '*') {
+                    return true;
+                }
+                // IP 地址范围匹配 (简单实现)
+                if (this.isIpMatch(hostname, bypass)) {
+                    return true;
+                }
+            }
+        }
+        catch (error) {
+            this.logger.warn(`Failed to parse target URL for NO_PROXY check: ${error.message}`);
+        }
+        return false;
+    }
+    /**
+     * 简单的 IP 地址匹配
+     * 支持精确匹配和 CIDR 表示法
+     */
+    static isIpMatch(hostname, pattern) {
+        // 精确 IP 匹配
+        if (hostname === pattern) {
+            return true;
+        }
+        // CIDR 匹配 (简化版本，不做完整的 CIDR 计算)
+        if (pattern.includes('/')) {
+            const [baseIp] = pattern.split('/');
+            return hostname.startsWith(baseIp.substring(0, baseIp.lastIndexOf('.')));
+        }
+        return false;
+    }
+    /**
+     * 获取所有代理相关的环境变量
+     */
+    static getProxyEnvironmentVariables() {
+        return {
+            HTTP_PROXY: process.env.HTTP_PROXY || process.env.http_proxy,
+            HTTPS_PROXY: process.env.HTTPS_PROXY || process.env.https_proxy,
+            NO_PROXY: process.env.NO_PROXY || process.env.no_proxy,
+        };
+    }
+    /**
+     * 检查是否设置了代理环境变量
+     */
+    static hasProxyEnvironment() {
+        const vars = this.getProxyEnvironmentVariables();
+        return !!(vars.HTTP_PROXY || vars.HTTPS_PROXY);
+    }
+}
+exports.ProxyEnvironmentParser = ProxyEnvironmentParser;
+ProxyEnvironmentParser.logger = new common_1.Logger(ProxyEnvironmentParser.name);

package/dist/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@nest-omni/core",
+  "version": "4.1.3-13",
+  "description": "A comprehensive NestJS framework for building enterprise-grade applications with best practices",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "jest --passWithNoTests",
+    "test:cache": "jest src/cache --verbose",
+    "test:cache:watch": "jest src/cache --watch",
+    "test:cache:coverage": "jest src/cache --coverage",
+    "lint": "eslint 'src/**/*.ts' --fix"
+  },
+  "bin": {
+    "nest-omni": "nest start",
+    "i18n": "i18n",
+    "gen": "gen"
+  },
+  "keywords": [
+    "nestjs",
+    "framework",
+    "typescript",
+    "decorators",
+    "validation",
+    "interceptors",
+    "filters",
+    "middleware",
+    "enterprise",
+    "omni",
+    "sentry",
+    "health-check",
+    "redis-lock",
+    "pm2"
+  ],
+  "author": "Jinpy",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.0.0",
+    "npm": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@types/compression": "^1.8.1",
+    "@types/express": "^5.0.4",
+    "@types/express-session": "^1.18.2",
+    "@types/lodash": "^4.17.20",
+    "@types/node": "^24.9.1",
+    "@types/sharp": "^0.31.1",
+    "@types/sprintf-js": "^1.1.4",
+    "@types/uuid": "^11.0.0",
+    "sqlite3": "^5.1.7",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@dataui/crud": "^5.3.4",
+    "@dataui/crud-typeorm": "^5.3.4",
+    "@nestjs/bull": "^11.0.4",
+    "@nestjs/common": "^11.1.7",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.1.7",
+    "@nestjs/platform-express": "^11.1.7",
+    "@nestjs/schedule": "^6.0.1",
+    "@nestjs/swagger": "^11.2.1",
+    "@nestjs/terminus": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "@sentry/nestjs": "^10.22.0",
+    "@sentry/profiling-node": "^10.22.0",
+    "@songkeys/nestjs-redis": "^11.0.0",
+    "@songkeys/nestjs-redis-health": "^11.0.0",
+    "axios": "^1.13.2",
+    "axios-retry": "^4.5.0",
+    "bcrypt": "^6.0.0",
+    "body-parser": "^2.2.0",
+    "bull": "^4.16.5",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "compression": "^1.8.1",
+    "connect-redis": "^9.0.0",
+    "dotenv": "^17.2.3",
+    "express": "^5.1.0",
+    "express-session": "^1.18.2",
+    "hygen": "^6.2.11",
+    "ioredis": "^5.8.2",
+    "libphonenumber-js": "^1.12.25",
+    "lodash": "^4.17.21",
+    "mime-types": "^3.0.1",
+    "moment": "^2.30.1",
+    "mysql2": "^3.15.3",
+    "nestjs-cls": "^6.0.1",
+    "nestjs-i18n": "^10.5.1",
+    "nestjs-pino": "^4.4.1",
+    "node-vault": "^0.10.9",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.2",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "source-map-support": "^0.5.21",
+    "sprintf-js": "^1.1.3",
+    "typeorm": "^0.3.27",
+    "uuid": "^13.0.0",
+    "fast-csv": "^5.0.5",
+    "xlsx": "git+https://git.sheetjs.com/sheetjs/sheetjs.git#v0.20.3"
+  },
+  "peerDependencies": {}
+}

package/{shared → dist/shared}/service-registry.module.js

@@ -36,6 +36,7 @@ const redis_lock_1 = require("../redis-lock");
 const typeorm_2 = require("typeorm");
 const vault_1 = require("../vault");
 const validators_1 = require("../validators");
+const transaction_1 = require("../transaction");
 const providers = [
     services_1.ApiConfigService,
     services_1.GeneratorService,
@@ -85,10 +86,27 @@ const modules = [
     }),
 ];
 if (services_1.ApiConfigService.toBoolean(process.env.DB_ENABLED, true)) {
+    // 1. 首先导入 TransactionModule
+    modules.push(transaction_1.TransactionModule.forRoot({
+        defaultDataSource: 'default',
+        enableDynamicRegistration: true,
+    }));
+    // 2. 导入 TypeORM 模块，并在初始化后注册数据源
     modules.push(typeorm_1.TypeOrmModule.forRootAsync({
         inject: [services_1.ApiConfigService],
         useFactory: (config) => config.typeormConfig,
     }));
+    // 3. 添加数据源注册服务，在应用启动时注册 DataSource
+    providers.push({
+        provide: 'DATASOURCE_REGISTRAR',
+        useFactory: (dataSource) => __awaiter(void 0, void 0, void 0, function* () {
+            // 手动注册 default 数据源到 DataSourceUtil
+            (0, transaction_1.addDataSource)('default', dataSource, true);
+            return dataSource;
+        }),
+        inject: [typeorm_2.DataSource],
+    });
+    // 4. 配置 CLS 模块
     modules.push(nestjs_cls_1.ClsModule.forRootAsync({
         imports: [typeorm_1.TypeOrmModule],
         useFactory(args) {