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

package/audit/services/index.d.ts

@@ -3,3 +3,6 @@ export * from './audit-strategy.service';
 export * from './entity-audit.service';
 export * from './transaction-audit.service';
 export * from './multi-database.service';
+export * from './operation-description.service';
+export * from './manual-audit-log.service';
+export * from './audit-action.service';

package/audit/services/index.js

@@ -19,3 +19,6 @@ __exportStar(require("./audit-strategy.service"), exports);
 __exportStar(require("./entity-audit.service"), exports);
 __exportStar(require("./transaction-audit.service"), exports);
 __exportStar(require("./multi-database.service"), exports);
+__exportStar(require("./operation-description.service"), exports);
+__exportStar(require("./manual-audit-log.service"), exports);
+__exportStar(require("./audit-action.service"), exports);

package/audit/services/manual-audit-log.service.d.ts

@@ -2,20 +2,20 @@ import { Repository, DataSource } from 'typeorm';
 import { ManualOperationLogEntity, EntityTransactionEntity } from '../entities';
 import { AuditContextService } from './audit-context.service';
 import { ManualLogOptions } from '../interfaces';
+import { AuditTransactionStatus } from '../enums';
 /**
  * 手动审计日志服务
  *
- * 提供全局静态方法，在任意地方手动记录操作日志
+ * 提供标准的依赖注入方式记录操作日志
  */
 export declare class ManualAuditLogService {
     private readonly manualLogRepository;
     private readonly transactionRepository;
     private readonly contextService;
     private readonly dataSource;
-    private static instance;
     constructor(manualLogRepository: Repository<ManualOperationLogEntity>, transactionRepository: Repository<EntityTransactionEntity>, contextService: AuditContextService, dataSource: DataSource);
     /**
-     * 全局静态方法：记录操作日志
+     * 记录操作日志
      *
      * @description
      * 支持三种记录模式：
@@ -25,7 +25,7 @@ export declare class ManualAuditLogService {
      *
      * @example
      * // 模式1：模板键模式
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'user.login',
      *   descriptionParams: {
      *     username: 'john.doe',
@@ -35,13 +35,13 @@ export declare class ManualAuditLogService {
      *
      * @example
      * // 模式2：直接描述模式（字符串）
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   description: '用户登录系统',
      * });
      *
      * @example
      * // 模式2：直接描述模式（多语言）
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   description: {
      *     zh: '用户登录系统',
      *     en: 'User logged in',
@@ -50,7 +50,7 @@ export declare class ManualAuditLogService {
      *
      * @example
      * // 模式3：内联模板模式
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   descriptionTemplate: {
      *     zh: '用户 {username} 在 {time} 登录了系统',
      *     en: 'User {username} logged in at {time}',
@@ -61,52 +61,52 @@ export declare class ManualAuditLogService {
      *   },
      * });
      */
-    static log(options: ManualLogOptions): Promise<ManualOperationLogEntity>;
+    log(options: ManualLogOptions): Promise<ManualOperationLogEntity>;
     /**
      * 实例方法：记录操作日志
      */
     logOperation(options: ManualLogOptions): Promise<ManualOperationLogEntity>;
     /**
-     * 静态方法：带事务记录
+     * 开始事务
      *
      * @example
      * ```typescript
-     * const txId = await ManualAuditLogService.beginTransaction('user-123', 'John Doe');
+     * const txId = await this.manualAuditLogService.beginTransaction('user-123', 'John Doe');
      *
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'order.create',
      *   descriptionParams: { orderId: 'order-1' },
      *   transactionId: txId,
      *   autoCreateTransaction: false,
      * });
      *
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'payment.process',
      *   descriptionParams: { paymentId: 'pay-1' },
      *   transactionId: txId,
      *   autoCreateTransaction: false,
      * });
      *
-     * await ManualAuditLogService.commitTransaction(txId);
+     * await this.manualAuditLogService.commitTransaction(txId);
      * ```
      */
-    static beginTransaction(userId?: string, username?: string): Promise<string>;
+    beginTransaction(userId?: string, username?: string): Promise<string>;
     /**
-     * 静态方法：提交事务
+     * 提交事务
      */
-    static commitTransaction(transactionId: string): Promise<void>;
+    commitTransaction(transactionId: string): Promise<void>;
     /**
-     * 静态方法：回滚事务
+     * 回滚事务
      */
-    static rollbackTransaction(transactionId: string): Promise<void>;
+    rollbackTransaction(transactionId: string): Promise<void>;
     /**
      * 创建事务
      */
-    private createTransaction;
+    createTransaction(userId?: string, username?: string): Promise<string>;
     /**
      * 更新事务状态
      */
-    private updateTransactionStatus;
+    updateTransactionStatus(transactionId: string, status: AuditTransactionStatus): Promise<void>;
     /**
      * 生成事务ID
      */
@@ -120,7 +120,7 @@ export declare class ManualAuditLogService {
      * @example
      * ```typescript
      * // 混合使用多种模式
-     * await ManualAuditLogService.logBatch([
+     * await this.manualAuditLogService.logBatch([
      *   {
      *     templateKey: 'product.update',
      *     descriptionParams: { productId: 'p1', field: 'price' },
@@ -138,11 +138,11 @@ export declare class ManualAuditLogService {
      * ]);
      * ```
      */
-    static logBatch(operations: ManualLogOptions[], sharedTransactionId?: string): Promise<ManualOperationLogEntity[]>;
+    logBatch(operations: ManualLogOptions[], sharedTransactionId?: string): Promise<ManualOperationLogEntity[]>;
     /**
      * 查询操作日志
      */
-    static findLogs(options: {
+    findLogs(options: {
         templateKey?: string;
         userId?: string;
         transactionId?: string;

package/audit/services/manual-audit-log.service.js

@@ -20,7 +20,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var ManualAuditLogService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ManualAuditLogService = void 0;
 const common_1 = require("@nestjs/common");
@@ -33,19 +32,17 @@ const crypto_1 = require("crypto");
 /**
  * 手动审计日志服务
  *
- * 提供全局静态方法，在任意地方手动记录操作日志
+ * 提供标准的依赖注入方式记录操作日志
  */
-let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogService {
+let ManualAuditLogService = class ManualAuditLogService {
     constructor(manualLogRepository, transactionRepository, contextService, dataSource) {
         this.manualLogRepository = manualLogRepository;
         this.transactionRepository = transactionRepository;
         this.contextService = contextService;
         this.dataSource = dataSource;
-        // 设置静态实例
-        ManualAuditLogService_1.instance = this;
     }
     /**
-     * 全局静态方法：记录操作日志
+     * 记录操作日志
      *
      * @description
      * 支持三种记录模式：
@@ -55,7 +52,7 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      *
      * @example
      * // 模式1：模板键模式
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'user.login',
      *   descriptionParams: {
      *     username: 'john.doe',
@@ -65,13 +62,13 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      *
      * @example
      * // 模式2：直接描述模式（字符串）
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   description: '用户登录系统',
      * });
      *
      * @example
      * // 模式2：直接描述模式（多语言）
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   description: {
      *     zh: '用户登录系统',
      *     en: 'User logged in',
@@ -80,7 +77,7 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      *
      * @example
      * // 模式3：内联模板模式
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   descriptionTemplate: {
      *     zh: '用户 {username} 在 {time} 登录了系统',
      *     en: 'User {username} logged in at {time}',
@@ -91,12 +88,9 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      *   },
      * });
      */
-    static log(options) {
+    log(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized. Make sure AuditModule is imported.');
-            }
-            return ManualAuditLogService_1.instance.logOperation(options);
+            return this.logOperation(options);
         });
     }
     /**
@@ -104,7 +98,7 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      */
     logOperation(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { templateKey, description, descriptionTemplate, descriptionParams, userId, username, requestIp, rollbackActions, transactionId, autoCreateTransaction = true, } = options;
+            const { templateKey, description, descriptionTemplate, descriptionParams, userId, username, requestIp, transactionId, autoCreateTransaction = true, } = options;
             // 验证参数：至少提供一种模式
             if (!templateKey && !description && !descriptionTemplate) {
                 throw new Error('ManualAuditLogService.log() requires one of: templateKey, description, or descriptionTemplate');
@@ -140,63 +134,53 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
                 userId: finalUserId,
                 username: finalUsername,
                 requestIp: finalRequestIp,
-                rollbackActions: rollbackActions || [],
             });
             return this.manualLogRepository.save(manualLog);
         });
     }
     /**
-     * 静态方法：带事务记录
+     * 开始事务
      *
      * @example
      * ```typescript
-     * const txId = await ManualAuditLogService.beginTransaction('user-123', 'John Doe');
+     * const txId = await this.manualAuditLogService.beginTransaction('user-123', 'John Doe');
      *
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'order.create',
      *   descriptionParams: { orderId: 'order-1' },
      *   transactionId: txId,
      *   autoCreateTransaction: false,
      * });
      *
-     * await ManualAuditLogService.log({
+     * await this.manualAuditLogService.log({
      *   templateKey: 'payment.process',
      *   descriptionParams: { paymentId: 'pay-1' },
      *   transactionId: txId,
      *   autoCreateTransaction: false,
      * });
      *
-     * await ManualAuditLogService.commitTransaction(txId);
+     * await this.manualAuditLogService.commitTransaction(txId);
      * ```
      */
-    static beginTransaction(userId, username) {
+    beginTransaction(userId, username) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized');
-            }
-            return ManualAuditLogService_1.instance.createTransaction(userId, username);
+            return this.createTransaction(userId, username);
         });
     }
     /**
-     * 静态方法：提交事务
+     * 提交事务
      */
-    static commitTransaction(transactionId) {
+    commitTransaction(transactionId) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized');
-            }
-            yield ManualAuditLogService_1.instance.updateTransactionStatus(transactionId, enums_1.TransactionStatus.COMMITTED);
+            yield this.updateTransactionStatus(transactionId, enums_1.AuditTransactionStatus.COMMITTED);
         });
     }
     /**
-     * 静态方法：回滚事务
+     * 回滚事务
      */
-    static rollbackTransaction(transactionId) {
+    rollbackTransaction(transactionId) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized');
-            }
-            yield ManualAuditLogService_1.instance.updateTransactionStatus(transactionId, enums_1.TransactionStatus.ROLLED_BACK);
+            yield this.updateTransactionStatus(transactionId, enums_1.AuditTransactionStatus.ROLLED_BACK);
         });
     }
     /**
@@ -210,7 +194,7 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
                 userId: userId || context.userId || 'system',
                 username: username || context.username || 'system',
                 requestIp: context.requestIp || 'unknown',
-                status: enums_1.TransactionStatus.PENDING,
+                status: enums_1.AuditTransactionStatus.PENDING,
                 entities: [],
             });
             const saved = yield this.transactionRepository.save(transaction);
@@ -240,7 +224,7 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      * @example
      * ```typescript
      * // 混合使用多种模式
-     * await ManualAuditLogService.logBatch([
+     * await this.manualAuditLogService.logBatch([
      *   {
      *     templateKey: 'product.update',
      *     descriptionParams: { productId: 'p1', field: 'price' },
@@ -258,22 +242,18 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
      * ]);
      * ```
      */
-    static logBatch(operations, sharedTransactionId) {
+    logBatch(operations, sharedTransactionId) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized');
-            }
             // 创建共享事务ID
-            const transactionId = sharedTransactionId ||
-                (yield ManualAuditLogService_1.instance.createTransaction());
+            const transactionId = sharedTransactionId || (yield this.createTransaction());
             const results = [];
             for (const operation of operations) {
-                const result = yield ManualAuditLogService_1.instance.logOperation(Object.assign(Object.assign({}, operation), { transactionId, autoCreateTransaction: false }));
+                const result = yield this.logOperation(Object.assign(Object.assign({}, operation), { transactionId, autoCreateTransaction: false }));
                 results.push(result);
             }
             // 自动提交事务（如果是自动创建的）
             if (!sharedTransactionId) {
-                yield ManualAuditLogService_1.instance.updateTransactionStatus(transactionId, enums_1.TransactionStatus.COMMITTED);
+                yield this.updateTransactionStatus(transactionId, enums_1.AuditTransactionStatus.COMMITTED);
             }
             return results;
         });
@@ -281,13 +261,10 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
     /**
      * 查询操作日志
      */
-    static findLogs(options) {
+    findLogs(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (!ManualAuditLogService_1.instance) {
-                throw new Error('ManualAuditLogService is not initialized');
-            }
             const { templateKey, userId, transactionId, startTime, endTime, limit = 100 } = options;
-            const query = ManualAuditLogService_1.instance.manualLogRepository
+            const query = this.manualLogRepository
                 .createQueryBuilder('log')
                 .orderBy('log.createdAt', 'DESC')
                 .take(limit);
@@ -311,10 +288,10 @@ let ManualAuditLogService = ManualAuditLogService_1 = class ManualAuditLogServic
     }
 };
 exports.ManualAuditLogService = ManualAuditLogService;
-exports.ManualAuditLogService = ManualAuditLogService = ManualAuditLogService_1 = __decorate([
+exports.ManualAuditLogService = ManualAuditLogService = __decorate([
     (0, common_1.Injectable)(),
-    __param(0, (0, typeorm_1.InjectRepository)(entities_1.ManualOperationLogEntity, 'audit')),
-    __param(1, (0, typeorm_1.InjectRepository)(entities_1.EntityTransactionEntity, 'audit')),
+    __param(0, (0, typeorm_1.InjectRepository)(entities_1.ManualOperationLogEntity)),
+    __param(1, (0, typeorm_1.InjectRepository)(entities_1.EntityTransactionEntity)),
     __metadata("design:paramtypes", [typeorm_2.Repository,
         typeorm_2.Repository,
         audit_context_service_1.AuditContextService,

package/audit/services/multi-database.service.d.ts

@@ -1,4 +1,3 @@
-import { DataSource } from 'typeorm';
 import { ModuleRef } from '@nestjs/core';
 /**
  * 多数据库连接管理服务
@@ -7,10 +6,6 @@ export declare class MultiDatabaseService {
     private readonly moduleRef;
     private readonly config?;
     constructor(moduleRef: ModuleRef, config?: any);
-    /**
-     * 获取指定连接的 DataSource
-     */
-    getDataSource(connectionName?: string): Promise<DataSource>;
     /**
      * 获取所有监听的数据库连接
      */

package/audit/services/multi-database.service.js

@@ -11,19 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-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.MultiDatabaseService = void 0;
 const common_1 = require("@nestjs/common");
-const typeorm_1 = require("@nestjs/typeorm");
 const core_1 = require("@nestjs/core");
 /**
  * 多数据库连接管理服务
@@ -33,20 +23,6 @@ let MultiDatabaseService = class MultiDatabaseService {
         this.moduleRef = moduleRef;
         this.config = config;
     }
-    /**
-     * 获取指定连接的 DataSource
-     */
-    getDataSource() {
-        return __awaiter(this, arguments, void 0, function* (connectionName = 'default') {
-            try {
-                const dataSource = this.moduleRef.get((0, typeorm_1.getDataSourceToken)(connectionName), { strict: false });
-                return dataSource;
-            }
-            catch (error) {
-                throw new Error(`Failed to get DataSource for connection: ${connectionName}`);
-            }
-        });
-    }
     /**
      * 获取所有监听的数据库连接
      */

package/audit/services/operation-description.service.d.ts

@@ -1,6 +1,7 @@
 import { Repository } from 'typeorm';
 import { OperationTemplateEntity, EntityTransactionEntity, EntityAuditLogEntity, ManualOperationLogEntity } from '../entities';
 import { ChangeDetail, TransactionDescription } from '../interfaces';
+import { CacheService } from '../../cache';
 /**
  * 操作描述服务
  * 负责根据模板和参数动态生成多语言描述
@@ -10,8 +11,11 @@ export declare class OperationDescriptionService {
     private readonly transactionRepository;
     private readonly auditLogRepository;
     private readonly manualOperationRepository;
-    private templateCache;
-    constructor(templateRepository: Repository<OperationTemplateEntity>, transactionRepository: Repository<EntityTransactionEntity>, auditLogRepository: Repository<EntityAuditLogEntity>, manualOperationRepository: Repository<ManualOperationLogEntity>);
+    private readonly cacheService;
+    private readonly logger;
+    private readonly CACHE_NAMESPACE;
+    private readonly CACHE_TTL;
+    constructor(templateRepository: Repository<OperationTemplateEntity>, transactionRepository: Repository<EntityTransactionEntity>, auditLogRepository: Repository<EntityAuditLogEntity>, manualOperationRepository: Repository<ManualOperationLogEntity>, cacheService: CacheService);
     /**
      * 动态生成操作名称
      * @param templateKey 模板键
@@ -63,11 +67,18 @@ export declare class OperationDescriptionService {
      */
     private formatDisplayValue;
     /**
-     * 获取操作模板（带缓存）
+     * 获取操作模板（使用统一缓存服务）
      * @param templateKey 模板键
      * @returns 操作模板
      */
     private getOperationTemplate;
+    /**
+     * 获取模板字符串（仅返回模板文本，不填充参数）
+     * @param templateKey 模板键
+     * @param language 语言
+     * @returns 模板字符串
+     */
+    getTemplate(templateKey: string, language?: string): Promise<string | null>;
     /**
      * 清除模板缓存
      */