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

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/{index.d.ts → dist/index.d.ts}

@@ -1,3 +1,4 @@
+export * from './common';
 export * from './constants';
 export * from './decorators';
 export * from './exceptions';
@@ -7,10 +8,10 @@ export * from './interceptors';
 export * from './shared';
 export * from './middlewares';
 export * from './validators';
-export * from './common';
 export * from './validator-json';
 export * from './helpers';
 export * from './providers';
+export * from './transaction';
 export * from './redis-lock';
 export * from './cache';
 export * from './http-client';
@@ -18,3 +19,4 @@ export * from './vault';
 export * from './setup';
 export * from './health-checker';
 export * from './audit';
+export * from './file-upload';

package/{index.js → dist/index.js}

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // Core modules
+__exportStar(require("./common"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./decorators"), exports);
 __exportStar(require("./exceptions"), exports);
@@ -24,10 +25,10 @@ __exportStar(require("./interceptors"), exports);
 __exportStar(require("./shared"), exports);
 __exportStar(require("./middlewares"), exports);
 __exportStar(require("./validators"), exports);
-__exportStar(require("./common"), exports);
 __exportStar(require("./validator-json"), exports);
 __exportStar(require("./helpers"), exports);
 __exportStar(require("./providers"), exports);
+__exportStar(require("./transaction"), exports);
 // Lock module
 __exportStar(require("./redis-lock"), exports);
 // Cache module
@@ -42,3 +43,5 @@ __exportStar(require("./setup"), exports);
 __exportStar(require("./health-checker"), exports);
 // Audit module
 __exportStar(require("./audit"), exports);
+// File upload module
+__exportStar(require("./file-upload"), exports);

package/dist/interfaces/IApiFile.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/IFile.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/ITranslationDecoratorInterface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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/{setup → dist/setup}/bootstrap.setup.d.ts

@@ -1,2 +1,3 @@
+import "../common/boilerplate.polyfill";
 import type { NestExpressApplication } from '@nestjs/platform-express';
 export declare function bootstrapSetup(AppModule: any, SetupSwagger: any): Promise<NestExpressApplication<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>>;

package/{setup → dist/setup}/bootstrap.setup.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootstrapSetup = bootstrapSetup;
+require("../common/boilerplate.polyfill");
 const Sentry = require("@sentry/nestjs");
 const profiling_node_1 = require("@sentry/profiling-node");
 const dotenv = require("dotenv");

package/dist/shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from './service-registry.module';
+export * from './services';

package/{shared → dist/shared}/index.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./serviceRegistryModule"), exports);
+__exportStar(require("./service-registry.module"), exports);
 __exportStar(require("./services"), exports);

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

@@ -27,8 +27,6 @@ const typeorm_1 = require("@nestjs/typeorm");
 const schedule_1 = require("@nestjs/schedule");
 const setup_1 = require("@sentry/nestjs/setup");
 const cache_1 = require("../cache");
-const transactional_1 = require("@nestjs-cls/transactional");
-const transactional_adapter_typeorm_1 = require("@nestjs-cls/transactional-adapter-typeorm");
 const nestjs_i18n_1 = require("nestjs-i18n");
 const health_checker_1 = require("../health-checker");
 const nestjs_redis_1 = require("@songkeys/nestjs-redis");
@@ -38,9 +36,9 @@ 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.ValidatorService,
     services_1.GeneratorService,
     services_1.TranslationService,
     validators_1.IsExistsValidator,
@@ -88,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) {
@@ -100,15 +115,6 @@ if (services_1.ApiConfigService.toBoolean(process.env.DB_ENABLED, true)) {
             };
         },
         global: true,
-        plugins: [
-            new transactional_1.ClsPluginTransactional({
-                imports: [typeorm_1.TypeOrmModule],
-                adapter: new transactional_adapter_typeorm_1.TransactionalAdapterTypeOrm({
-                    dataSourceToken: (0, typeorm_1.getDataSourceToken)(),
-                }),
-                enableTransactionProxy: true,
-            }),
-        ]
     }));
 }
 if (services_1.ApiConfigService.toBoolean(process.env.BULL_ENABLED)) {

package/{shared → dist/shared}/services/index.d.ts

@@ -1,4 +1,3 @@
 export * from './api-config.service';
 export * from './generator.service';
 export * from './translation.service';
-export * from './validator.service';

package/{shared → dist/shared}/services/index.js

@@ -17,4 +17,3 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./api-config.service"), exports);
 __exportStar(require("./generator.service"), exports);
 __exportStar(require("./translation.service"), exports);
-__exportStar(require("./validator.service"), exports);

package/dist/transaction/__tests__/mocks.d.ts

@@ -0,0 +1,9 @@
+import { TransactionStatus } from '../transaction-manager';
+/**
+ * 创建 Mock TransactionStatus
+ */
+export declare function createMockTransactionStatus(overrides?: Partial<TransactionStatus>): TransactionStatus;
+/**
+ * 创建 Mock EntityManager
+ */
+export declare function createMockEntityManager(): any;