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

package/{validators → dist/validators}/is-exists.validator.d.ts

@@ -1,10 +1,7 @@
 import type { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
-import type { EntitySchema, FindOptionsWhere, ObjectType } from 'typeorm';
-import { TransactionHost } from '@nestjs-cls/transactional';
-import { TransactionalAdapterTypeOrm } from '@nestjs-cls/transactional-adapter-typeorm';
+import type { DataSource, EntitySchema, FindOptionsWhere, ObjectType } from 'typeorm';
 export declare class IsExistsValidator implements ValidatorConstraintInterface {
-    private readonly transactionHost;
-    constructor(transactionHost: TransactionHost<TransactionalAdapterTypeOrm>);
+    constructor();
     /**
      * 解析 Entity 引用，支持多种形式：
      * 1. Entity 类直接引用
@@ -18,12 +15,29 @@ export declare class IsExistsValidator implements ValidatorConstraintInterface {
      * 例如：appId -> App, userId -> User
      */
     private inferEntityNameFromProperty;
+    /**
+     * 获取数据源
+     * 支持多数据源配置，保持向后兼容
+     */
+    private getDataSource;
     validate<E>(value: string, args: IExistsValidationArguments<E>): Promise<boolean>;
     defaultMessage(args: ValidationArguments): string;
 }
+/**
+ * IsExists 配置选项
+ */
+export interface IsExistsOptions {
+    /**
+     * 数据源名称或 DataSource 实例
+     * 用于多数据源场景，指定使用哪个数据源进行验证
+     * 例如：'readonly', 'report', 或直接传入 DataSource 实例
+     */
+    dataSource?: string | DataSource;
+}
 type ExistsValidationConstraints<E> = [
-    ObjectType<E> | EntitySchema<E> | string | (() => ObjectType<E> | EntitySchema<E> | string),
-    (validationArguments: ValidationArguments) => FindOptionsWhere<E>
+    (ObjectType<E> | EntitySchema<E> | string | (() => ObjectType<E> | EntitySchema<E> | string)),
+    (validationArguments: ValidationArguments) => FindOptionsWhere<E>,
+    IsExistsOptions?
 ];
 interface IExistsValidationArguments<E> extends ValidationArguments {
     constraints: ExistsValidationConstraints<E>;

package/{validators → dist/validators}/is-exists.validator.js

@@ -23,11 +23,10 @@ exports.IsExists = IsExists;
 const class_validator_1 = require("class-validator");
 const nestjs_i18n_1 = require("nestjs-i18n");
 const common_1 = require("@nestjs/common");
-const transactional_1 = require("@nestjs-cls/transactional");
+const transaction_1 = require("../transaction");
+const transaction_2 = require("../transaction");
 let IsExistsValidator = class IsExistsValidator {
-    constructor(transactionHost) {
-        this.transactionHost = transactionHost;
-    }
+    constructor() { }
     /**
      * 解析 Entity 引用，支持多种形式：
      * 1. Entity 类直接引用
@@ -86,12 +85,36 @@ let IsExistsValidator = class IsExistsValidator {
         const entityName = name.charAt(0).toUpperCase() + name.slice(1) + 'Entity';
         return entityName;
     }
+    /**
+     * 获取数据源
+     * 支持多数据源配置，保持向后兼容
+     */
+    getDataSource(dataSourceOrName) {
+        // 1. 如果传入的是 DataSource 实例，直接返回
+        if (dataSourceOrName && typeof dataSourceOrName !== 'string') {
+            return dataSourceOrName;
+        }
+        // 2. 如果传入的是数据源名称，获取对应的数据源
+        if (typeof dataSourceOrName === 'string') {
+            return (0, transaction_2.getDataSource)(dataSourceOrName);
+        }
+        // 3. 默认：尝试从请求上下文获取，然后获取 default 数据源
+        try {
+            return transaction_1.TransactionContextService.getDataSource();
+        }
+        catch (_a) {
+            return (0, transaction_2.getDataSource)('default');
+        }
+    }
     validate(value, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const [entityRef, findCondition] = args.constraints;
+            const [entityRef, findCondition, options] = args.constraints;
             // 解析 Entity 引用
             const entityClass = this.resolveEntity(entityRef, args.property, args.object);
-            const repository = this.transactionHost.tx.getRepository(entityClass);
+            // 获取数据源（支持多数据源）
+            const dataSourceName = (options === null || options === void 0 ? void 0 : options.dataSource) || 'default';
+            const dataSource = this.getDataSource(dataSourceName);
+            const repository = dataSource.getRepository(entityClass);
             args.value = value;
             return ((yield repository.count({
                 where: findCondition(args),
@@ -106,7 +129,7 @@ exports.IsExistsValidator = IsExistsValidator;
 exports.IsExistsValidator = IsExistsValidator = __decorate([
     (0, common_1.Injectable)(),
     (0, class_validator_1.ValidatorConstraint)({ name: 'isExists', async: true }),
-    __metadata("design:paramtypes", [transactional_1.TransactionHost])
+    __metadata("design:paramtypes", [])
 ], IsExistsValidator);
 function IsExists(constraints, validationOptions) {
     return (object, propertyName) => {

package/{validators → dist/validators}/is-unique.validator.d.ts

@@ -1,10 +1,7 @@
 import type { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
-import { EntitySchema, FindOptionsWhere, ObjectType } from 'typeorm';
-import { TransactionHost } from '@nestjs-cls/transactional';
-import { TransactionalAdapterTypeOrm } from '@nestjs-cls/transactional-adapter-typeorm';
+import type { DataSource, EntitySchema, FindOptionsWhere, ObjectType } from 'typeorm';
 export declare class IsUniqueValidator implements ValidatorConstraintInterface {
-    private readonly transactionHost;
-    constructor(transactionHost: TransactionHost<TransactionalAdapterTypeOrm>);
+    constructor();
     /**
      * 解析 Entity 引用，支持多种形式：
      * 1. Entity 类直接引用
@@ -18,6 +15,11 @@ export declare class IsUniqueValidator implements ValidatorConstraintInterface {
      * 例如：appId -> App, userId -> User
      */
     private inferEntityNameFromProperty;
+    /**
+     * 获取数据源
+     * 支持多数据源配置，保持向后兼容
+     */
+    private getDataSource;
     validate<E>(value: string, args: IUniqueValidationArguments<E>): Promise<boolean>;
     defaultMessage(args: ValidationArguments): string;
 }
@@ -31,9 +33,15 @@ export interface IsUniqueOptions {
      * 例如：uniqueKeys: ['id'] 或 uniqueKeys: ['id', 'version']
      */
     uniqueKeys?: string[];
+    /**
+     * 数据源名称或 DataSource 实例
+     * 用于多数据源场景，指定使用哪个数据源进行验证
+     * 例如：'readonly', 'report', 或直接传入 DataSource 实例
+     */
+    dataSource?: string | DataSource;
 }
 type UniqueValidationConstraints<E> = [
-    ObjectType<E> | EntitySchema<E> | string | (() => ObjectType<E> | EntitySchema<E> | string),
+    (ObjectType<E> | EntitySchema<E> | string | (() => ObjectType<E> | EntitySchema<E> | string)),
     (validationArguments: ValidationArguments) => FindOptionsWhere<E>,
     IsUniqueOptions?
 ];

package/{validators → dist/validators}/is-unique.validator.js

@@ -23,11 +23,10 @@ exports.IsUnique = IsUnique;
 const class_validator_1 = require("class-validator");
 const nestjs_i18n_1 = require("nestjs-i18n");
 const common_1 = require("@nestjs/common");
-const transactional_1 = require("@nestjs-cls/transactional");
+const transaction_1 = require("../transaction");
+const transaction_2 = require("../transaction");
 let IsUniqueValidator = class IsUniqueValidator {
-    constructor(transactionHost) {
-        this.transactionHost = transactionHost;
-    }
+    constructor() { }
     /**
      * 解析 Entity 引用，支持多种形式：
      * 1. Entity 类直接引用
@@ -82,12 +81,36 @@ let IsUniqueValidator = class IsUniqueValidator {
         const entityName = name.charAt(0).toUpperCase() + name.slice(1) + 'Entity';
         return entityName;
     }
+    /**
+     * 获取数据源
+     * 支持多数据源配置，保持向后兼容
+     */
+    getDataSource(dataSourceOrName) {
+        // 1. 如果传入的是 DataSource 实例，直接返回
+        if (dataSourceOrName && typeof dataSourceOrName !== 'string') {
+            return dataSourceOrName;
+        }
+        // 2. 如果传入的是数据源名称，获取对应的数据源
+        if (typeof dataSourceOrName === 'string') {
+            return (0, transaction_2.getDataSource)(dataSourceOrName);
+        }
+        // 3. 默认：尝试从请求上下文获取，然后获取 default 数据源
+        try {
+            return transaction_1.TransactionContextService.getDataSource();
+        }
+        catch (_a) {
+            return (0, transaction_2.getDataSource)('default');
+        }
+    }
     validate(value, args) {
         return __awaiter(this, void 0, void 0, function* () {
             const [entityRef, findCondition, options] = args.constraints;
             // 解析 Entity 引用
             const entityClass = this.resolveEntity(entityRef, args.property, args.object);
-            const repository = this.transactionHost.tx.getRepository(entityClass);
+            // 获取数据源（支持多数据源）
+            const dataSourceName = (options === null || options === void 0 ? void 0 : options.dataSource) || 'default';
+            const dataSource = this.getDataSource(dataSourceName);
+            const repository = dataSource.getRepository(entityClass);
             args.value = value;
             let exists;
             const defCon = findCondition(args);
@@ -100,8 +123,7 @@ let IsUniqueValidator = class IsUniqueValidator {
             }
             else {
                 // 2. 使用实体的主键
-                pkCols = repository.metadata
-                    .primaryColumns.map((column) => column.propertyName);
+                pkCols = repository.metadata.primaryColumns.map((column) => column.propertyName);
             }
             // 如果没有主键也没有 uniqueKeys，使用简化逻辑
             // 查询条件本身表示唯一性，只要存在记录就不允许
@@ -118,9 +140,7 @@ let IsUniqueValidator = class IsUniqueValidator {
             });
             if (isNew) {
                 // 新建场景：简单检查是否存在相同值的记录
-                exists =
-                    (yield repository
-                        .count({ where: defCon })) < 1;
+                exists = (yield repository.count({ where: defCon })) < 1;
             }
             else {
                 // 更新场景：需要排除当前记录（通过主键对比）
@@ -158,7 +178,7 @@ exports.IsUniqueValidator = IsUniqueValidator;
 exports.IsUniqueValidator = IsUniqueValidator = __decorate([
     (0, common_1.Injectable)(),
     (0, class_validator_1.ValidatorConstraint)({ name: 'isUnique', async: true }),
-    __metadata("design:paramtypes", [transactional_1.TransactionHost])
+    __metadata("design:paramtypes", [])
 ], IsUniqueValidator);
 function IsUnique(constraints, validationOptions) {
     return function (object, propertyName) {

package/dist/vault/interfaces/vault-options.interface.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-omni/core",
-  "version": "4.1.3-11",
+  "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",
@@ -36,7 +36,7 @@
   "author": "Jinpy",
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=18.0.0",
+    "node": ">=22.0.0",
     "npm": ">=9.0.0"
   },
   "devDependencies": {
@@ -45,15 +45,15 @@
     "@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-cls/transactional": "^3.1.0",
-    "@nestjs-cls/transactional-adapter-typeorm": "^1.3.0",
     "@nestjs/bull": "^11.0.4",
     "@nestjs/common": "^11.1.7",
     "@nestjs/config": "^4.0.2",
@@ -67,7 +67,7 @@
     "@sentry/profiling-node": "^10.22.0",
     "@songkeys/nestjs-redis": "^11.0.0",
     "@songkeys/nestjs-redis-health": "^11.0.0",
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
     "bcrypt": "^6.0.0",
     "body-parser": "^2.2.0",
@@ -89,6 +89,7 @@
     "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",
@@ -97,6 +98,8 @@
     "sprintf-js": "^1.1.3",
     "typeorm": "^0.3.27",
     "uuid": "^13.0.0",
-    "node-vault": "^0.10.9"
-  }
+    "fast-csv": "^5.0.5",
+    "xlsx": "git+https://git.sheetjs.com/sheetjs/sheetjs.git#v0.20.3"
+  },
+  "peerDependencies": {}
 }

package/tsconfig.build.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "removeComments": false,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test",
+    "tests",
+    "**/*.spec.ts",
+    "**/*.test.ts"
+  ]
+}

package/audit/controllers/audit.controller.d.ts

@@ -1,44 +0,0 @@
-import { EntityAuditService } from '../services/entity-audit.service';
-import { TransactionAuditService } from '../services/transaction-audit.service';
-import { AuditLogQueryDto, CompareEntitiesDto, RestoreEntityDto, PreCheckRestoreDto, BeginTransactionDto } from '../dto';
-import { EntityAuditLogEntity } from '../entities';
-import { EntityDifference, PreCheckResult, RestoreResult } from '../interfaces';
-import { PageDto } from '../../common/dto';
-/**
- * 审计控制器
- */
-export declare class AuditController {
-    private readonly entityAuditService;
-    private readonly transactionAuditService;
-    constructor(entityAuditService: EntityAuditService, transactionAuditService: TransactionAuditService);
-    /**
-     * 查询实体审计日志
-     */
-    getAuditLogs(query: AuditLogQueryDto): Promise<PageDto<EntityAuditLogEntity>>;
-    /**
-     * 比较实体版本
-     */
-    compareEntities(query: CompareEntitiesDto): Promise<EntityDifference>;
-    /**
-     * 预检查恢复操作
-     */
-    preCheckRestore(preCheckDto: PreCheckRestoreDto): Promise<PreCheckResult>;
-    /**
-     * 恢复实体到指定版本
-     */
-    restoreEntity(restoreDto: RestoreEntityDto): Promise<RestoreResult>;
-    /**
-     * 开始审计事务
-     */
-    beginTransaction(beginTransactionDto: BeginTransactionDto): Promise<{
-        transactionId: string;
-    }>;
-    /**
-     * 提交审计事务
-     */
-    commitTransaction(transactionId: string): Promise<void>;
-    /**
-     * 回滚审计事务
-     */
-    rollbackTransaction(transactionId: string): Promise<void>;
-}

package/audit/interceptors/index.d.ts

@@ -1 +0,0 @@
-export * from './audit.interceptor';

package/audit/services/audit-context.service.d.ts

@@ -1,25 +0,0 @@
-import { ClsService } from 'nestjs-cls';
-import { AuditContext } from '../interfaces';
-/**
- * 审计上下文服务
- */
-export declare class AuditContextService {
-    private readonly cls;
-    constructor(cls: ClsService);
-    /**
-     * 获取当前上下文
-     */
-    getCurrentContext(): Promise<AuditContext>;
-    /**
-     * 设置上下文
-     */
-    setContext(context: Partial<AuditContext>): void;
-    /**
-     * 清除上下文
-     */
-    clearContext(): void;
-    /**
-     * 获取默认上下文
-     */
-    private getDefaultContext;
-}

package/audit/services/audit-context.service.js

@@ -1,70 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuditContextService = void 0;
-const common_1 = require("@nestjs/common");
-const nestjs_cls_1 = require("nestjs-cls");
-/**
- * 审计上下文服务
- */
-let AuditContextService = class AuditContextService {
-    constructor(cls) {
-        this.cls = cls;
-    }
-    /**
-     * 获取当前上下文
-     */
-    getCurrentContext() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.cls.get('auditContext') || this.getDefaultContext();
-        });
-    }
-    /**
-     * 设置上下文
-     */
-    setContext(context) {
-        const currentContext = this.cls.get('auditContext') || this.getDefaultContext();
-        this.cls.set('auditContext', Object.assign(Object.assign({}, currentContext), context));
-    }
-    /**
-     * 清除上下文
-     */
-    clearContext() {
-        this.cls.set('auditContext', undefined);
-    }
-    /**
-     * 获取默认上下文
-     */
-    getDefaultContext() {
-        return {
-            userId: 'system',
-            username: 'system',
-            requestId: '',
-            requestIp: '',
-            userAgent: '',
-            timestamp: new Date(),
-        };
-    }
-};
-exports.AuditContextService = AuditContextService;
-exports.AuditContextService = AuditContextService = __decorate([
-    (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [nestjs_cls_1.ClsService])
-], AuditContextService);

package/cache/dependencies/db.dependency.d.ts

@@ -1,60 +0,0 @@
-import { DataSource } from 'typeorm';
-import type { CacheDependency } from '../interfaces/cache-dependency.interface';
-/**
- * Database-based cache dependency
- *
- * This dependency monitors database query results. When the query result changes,
- * the cache becomes invalid.
- *
- * Common use case: Monitor MAX(updated_at) or COUNT(*) to detect data changes.
- *
- * @example
- * ```typescript
- * // Invalidate cache when user data changes
- * @Cacheable({
- *   key: (id) => `user:${id}:profile`,
- *   dependencies: [
- *     new DbDependency(
- *       'SELECT updated_at FROM users WHERE id = ?',
- *       (id) => [id]
- *     )
- *   ]
- * })
- * async getUserProfile(id: string) { }
- *
- * // Invalidate when any user in tenant changes
- * @Cacheable({
- *   key: (tenantId) => `users:list:${tenantId}`,
- *   dependencies: [
- *     new DbDependency(
- *       'SELECT MAX(updated_at) FROM users WHERE tenant_id = ?',
- *       (tenantId) => [tenantId]
- *     )
- *   ]
- * })
- * async getUserList(tenantId: string) { }
- * ```
- */
-export declare class DbDependency implements CacheDependency {
-    private readonly sql;
-    private readonly paramsFactory?;
-    private readonly name?;
-    private static dataSource;
-    constructor(sql: string, paramsFactory?: (...args: any[]) => any[], name?: string);
-    /**
-     * Set the TypeORM DataSource for database queries
-     * This should be called once during application initialization
-     */
-    static setDataSource(dataSource: DataSource): void;
-    /**
-     * Get the current DataSource
-     */
-    static getDataSource(): DataSource | null;
-    getKey(): string;
-    getData(): Promise<any>;
-    isChanged(oldData: any): Promise<boolean>;
-    /**
-     * Simple hash code generation for strings
-     */
-    private hashCode;
-}

package/shared/index.d.ts

@@ -1,2 +0,0 @@
-export * from './serviceRegistryModule';
-export * from './services';

package/shared/services/validator.service.d.ts

@@ -1,3 +0,0 @@
-export declare class ValidatorService {
-    isImage(mimeType: string): boolean;
-}

package/shared/services/validator.service.js

@@ -1,20 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidatorService = void 0;
-const common_1 = require("@nestjs/common");
-let ValidatorService = class ValidatorService {
-    isImage(mimeType) {
-        const imageMimeTypes = ['image/jpeg', 'image/png'];
-        return imageMimeTypes.includes(mimeType);
-    }
-};
-exports.ValidatorService = ValidatorService;
-exports.ValidatorService = ValidatorService = __decorate([
-    (0, common_1.Injectable)()
-], ValidatorService);