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

package/audit/audit.module.d.ts

@@ -4,6 +4,7 @@ import { AuditConfig } from './interfaces';
  * 审计模块
  */
 export declare class AuditModule {
+    private static readonly logger;
     /**
      * 注册审计模块
      * @param config 审计配置

package/audit/audit.module.js

@@ -37,9 +37,10 @@ let AuditModule = AuditModule_1 = class AuditModule {
         var _a, _b;
         const auditConnectionName = ((_a = config === null || config === void 0 ? void 0 : config.connections) === null || _a === void 0 ? void 0 : _a.audit) || 'default';
         const monitoredConnections = ((_b = config === null || config === void 0 ? void 0 : config.connections) === null || _b === void 0 ? void 0 : _b.monitored) || ['default'];
-        console.log('[AuditModule] auditConnectionName:', auditConnectionName);
-        console.log('[AuditModule] monitoredConnections:', monitoredConnections);
-        console.log('[AuditModule] config:', JSON.stringify(config === null || config === void 0 ? void 0 : config.connections));
+        if (process.env.NODE_ENV !== 'prod') {
+            this.logger.log(`Initializing AuditModule with connection: ${auditConnectionName}`);
+            this.logger.log(`Monitoring connections: ${monitoredConnections.join(', ')}`);
+        }
         // 创建多个订阅者提供者，每个监听的数据库连接一个
         const subscriberProviders = monitoredConnections.map((connectionName) => ({
             provide: `AUDIT_SUBSCRIBER_${connectionName}`,
@@ -287,6 +288,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
     }
 };
 exports.AuditModule = AuditModule;
+AuditModule.logger = new common_1.Logger(AuditModule_1.name);
 exports.AuditModule = AuditModule = AuditModule_1 = __decorate([
     (0, common_1.Global)(),
     (0, common_1.Module)({})

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

@@ -1,6 +1,6 @@
 import { EntityAuditService } from '../services/entity-audit.service';
 import { TransactionAuditService } from '../services/transaction-audit.service';
-import { AuditLogQueryDto, CompareEntitiesDto, RestoreEntityDto, PreCheckRestoreDto, BeginTransactionDto } from '../dto';
+import { AuditLogQueryDto, AuditActionQueryDto, CompareEntitiesDto, RestoreEntityDto, PreCheckRestoreDto, BeginTransactionDto } from '../dto';
 import { EntityAuditLogEntity } from '../entities';
 import { EntityDifference, PreCheckResult, RestoreResult } from '../interfaces';
 import { PageDto } from '../../common/dto';
@@ -44,7 +44,7 @@ export declare class AuditController {
     /**
      * 查询审计动作汇总记录
      */
-    getAuditActions(userId?: string, username?: string, actionName?: string, success?: string, startTime?: string, endTime?: string, page?: number, limit?: number): Promise<PageDto<import("../entities").AuditActionSummaryEntity>>;
+    getAuditActions(query: AuditActionQueryDto): Promise<PageDto<import("../entities").AuditActionSummaryEntity>>;
     /**
      * 查询单个审计动作的详细信息
      */
@@ -81,15 +81,7 @@ export declare class AuditController {
             createdAt: Date;
             oldValue: Record<string, any>;
             newValue: Record<string, any>;
-            fieldChanges: {
-                field: string;
-                fieldLabel: string;
-                oldValue: any;
-                newValue: any;
-                changeType: "added" | "removed" | "modified" | "unchanged";
-                displayOldValue?: string;
-                displayNewValue?: string;
-            }[];
+            changeDetails: import("../interfaces").ChangeDetail[];
             changedFieldsCount: number;
             changedFields: string[];
         }[];

package/audit/controllers/audit.controller.js

@@ -96,17 +96,17 @@ let AuditController = class AuditController {
     /**
      * 查询审计动作汇总记录
      */
-    getAuditActions(userId_1, username_1, actionName_1, success_1, startTime_1, endTime_1) {
-        return __awaiter(this, arguments, void 0, function* (userId, username, actionName, success, startTime, endTime, page = 1, limit = 20) {
+    getAuditActions(query) {
+        return __awaiter(this, void 0, void 0, function* () {
             return this.entityAuditService.getAuditActions({
-                userId,
-                username,
-                actionName,
-                success: success ? success === 'true' : undefined,
-                startTime: startTime ? new Date(startTime) : undefined,
-                endTime: endTime ? new Date(endTime) : undefined,
-                page,
-                limit,
+                userId: query.userId,
+                username: query.username,
+                actionName: query.actionName,
+                success: query.success,
+                startTime: query.startTime ? new Date(query.startTime) : undefined,
+                endTime: query.endTime ? new Date(query.endTime) : undefined,
+                page: query.page,
+                limit: query.limit,
             });
         });
     }
@@ -187,16 +187,9 @@ __decorate([
     (0, common_1.Get)('actions'),
     (0, swagger_1.ApiOperation)({ summary: '查询审计动作汇总记录' }),
     (0, swagger_1.ApiResponse)({ status: 200, description: '返回审计动作汇总列表' }),
-    __param(0, (0, common_1.Query)('userId')),
-    __param(1, (0, common_1.Query)('username')),
-    __param(2, (0, common_1.Query)('actionName')),
-    __param(3, (0, common_1.Query)('success')),
-    __param(4, (0, common_1.Query)('startTime')),
-    __param(5, (0, common_1.Query)('endTime')),
-    __param(6, (0, common_1.Query)('page')),
-    __param(7, (0, common_1.Query)('limit')),
+    __param(0, (0, common_1.Query)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, String, String, String, String, String, Number, Number]),
+    __metadata("design:paramtypes", [dto_1.AuditActionQueryDto]),
     __metadata("design:returntype", Promise)
 ], AuditController.prototype, "getAuditActions", null);
 __decorate([

package/audit/decorators/audit-operation.decorator.d.ts

@@ -7,7 +7,6 @@ export declare const AUDIT_OPERATION_OPTIONS: unique symbol;
  * 用于手动记录业务操作的审计日志，支持：
  * - 自定义操作模板
  * - 动态描述参数
- * - 回滚操作定义
  * - 自动事务管理
  *
  * @param options 审计操作选项
@@ -20,12 +19,6 @@ export declare const AUDIT_OPERATION_OPTIONS: unique symbol;
  *     username: args[0].username,
  *     approver: result.approver
  *   }),
- *   rollbackActions: (args, result) => [{
- *     type: RollbackActionType.UPDATE,
- *     action: 'reject',
- *     params: { userId: args[0].id },
- *     order: 1
- *   }],
  *   autoTransaction: true
  * })
  * async approveUser(user: User): Promise<ApprovalResult> {

package/audit/decorators/audit-operation.decorator.js

@@ -13,7 +13,6 @@ exports.AUDIT_OPERATION_OPTIONS = Symbol('AUDIT_OPERATION_OPTIONS');
  * 用于手动记录业务操作的审计日志，支持：
  * - 自定义操作模板
  * - 动态描述参数
- * - 回滚操作定义
  * - 自动事务管理
  *
  * @param options 审计操作选项
@@ -26,12 +25,6 @@ exports.AUDIT_OPERATION_OPTIONS = Symbol('AUDIT_OPERATION_OPTIONS');
  *     username: args[0].username,
  *     approver: result.approver
  *   }),
- *   rollbackActions: (args, result) => [{
- *     type: RollbackActionType.UPDATE,
- *     action: 'reject',
- *     params: { userId: args[0].id },
- *     order: 1
- *   }],
  *   autoTransaction: true
  * })
  * async approveUser(user: User): Promise<ApprovalResult> {

package/audit/dto/audit-action-query.dto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 审计动作查询 DTO
+ */
+export declare class AuditActionQueryDto {
+    page?: number;
+    limit?: number;
+    userId?: string;
+    username?: string;
+    actionName?: string;
+    success?: boolean;
+    startTime?: string;
+    endTime?: string;
+}

package/audit/dto/audit-action-query.dto.js

@@ -0,0 +1,77 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditActionQueryDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 审计动作查询 DTO
+ */
+class AuditActionQueryDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 20;
+    }
+}
+exports.AuditActionQueryDto = AuditActionQueryDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '页码', default: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AuditActionQueryDto.prototype, "page", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '每页数量', default: 20 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], AuditActionQueryDto.prototype, "limit", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '用户ID' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '用户名' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "username", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '动作名称' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "actionName", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '是否成功' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Boolean),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AuditActionQueryDto.prototype, "success", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '开始时间' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "startTime", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '结束时间' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AuditActionQueryDto.prototype, "endTime", void 0);

package/audit/dto/index.d.ts

@@ -1,4 +1,5 @@
 export * from './audit-log-query.dto';
+export * from './audit-action-query.dto';
 export * from './compare-entities.dto';
 export * from './restore-entity.dto';
 export * from './pre-check-restore.dto';

package/audit/dto/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./audit-log-query.dto"), exports);
+__exportStar(require("./audit-action-query.dto"), exports);
 __exportStar(require("./compare-entities.dto"), exports);
 __exportStar(require("./restore-entity.dto"), exports);
 __exportStar(require("./pre-check-restore.dto"), exports);

package/audit/entities/entity-audit-log.entity.d.ts

@@ -1,6 +1,6 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { AuditOperation } from '../enums';
-import { ChangeDetail, RollbackAction } from '../interfaces';
+import { ChangeDetail } from '../interfaces';
 /**
  * 实体审计日志
  */
@@ -11,19 +11,16 @@ export declare class EntityAuditLogEntity extends AbstractUuidPrimaryEntity {
     oldValue: Record<string, any>;
     newValue: Record<string, any>;
     changedFields: string[];
-    changedFieldPaths: string;
     userId: string;
     username: string;
     requestId: string;
     requestIp: string;
     userAgent: string;
     description: string;
-    hashChain: Record<string, any>;
     auditActionId: string;
     auditActionName: string;
     sequenceInAction: number;
     operationTemplateKey: string;
     descriptionParams: Record<string, any>;
     changeDetails: ChangeDetail[];
-    rollbackActions: RollbackAction[];
 }

package/audit/entities/entity-audit-log.entity.js

@@ -40,13 +40,9 @@ __decorate([
     __metadata("design:type", Object)
 ], EntityAuditLogEntity.prototype, "newValue", void 0);
 __decorate([
-    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '变更的字段' }),
+    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '变更的字段列表' }),
     __metadata("design:type", Array)
 ], EntityAuditLogEntity.prototype, "changedFields", void 0);
-__decorate([
-    (0, typeorm_1.Column)({ type: 'text', nullable: true, comment: '变更字段路径' }),
-    __metadata("design:type", String)
-], EntityAuditLogEntity.prototype, "changedFieldPaths", void 0);
 __decorate([
     (0, typeorm_1.Column)({ nullable: true, comment: '操作用户ID' }),
     __metadata("design:type", String)
@@ -71,10 +67,6 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'text', nullable: true, comment: '操作描述' }),
     __metadata("design:type", String)
 ], EntityAuditLogEntity.prototype, "description", void 0);
-__decorate([
-    (0, typeorm_1.Column)({ type: 'json', nullable: true, comment: '哈希链' }),
-    __metadata("design:type", Object)
-], EntityAuditLogEntity.prototype, "hashChain", void 0);
 __decorate([
     (0, typeorm_1.Column)({ nullable: true, comment: '审计动作ID，用于关联同一业务操作的多个实体变化' }),
     __metadata("design:type", String)
@@ -107,14 +99,6 @@ __decorate([
     }),
     __metadata("design:type", Array)
 ], EntityAuditLogEntity.prototype, "changeDetails", void 0);
-__decorate([
-    (0, typeorm_1.Column)({
-        type: 'json',
-        nullable: true,
-        comment: '回滚操作列表',
-    }),
-    __metadata("design:type", Array)
-], EntityAuditLogEntity.prototype, "rollbackActions", void 0);
 exports.EntityAuditLogEntity = EntityAuditLogEntity = __decorate([
     (0, typeorm_1.Entity)('entity_audit_log')
     // 单字段索引

package/audit/entities/manual-operation-log.entity.d.ts

@@ -1,6 +1,5 @@
 import { AbstractUuidPrimaryEntity } from '../../common/abstract.entity';
 import { EntityTransactionEntity } from './entity-transaction.entity';
-import { RollbackAction } from '../interfaces';
 /**
  * 手动操作记录表
  * 用于记录跨实体的复杂业务操作
@@ -14,6 +13,5 @@ export declare class ManualOperationLogEntity extends AbstractUuidPrimaryEntity
     userId: string;
     username: string;
     requestIp: string;
-    rollbackActions: RollbackAction[];
     transaction: EntityTransactionEntity;
 }

package/audit/entities/manual-operation-log.entity.js

@@ -64,14 +64,6 @@ __decorate([
     (0, typeorm_1.Column)({ nullable: true, comment: '操作IP' }),
     __metadata("design:type", String)
 ], ManualOperationLogEntity.prototype, "requestIp", void 0);
-__decorate([
-    (0, typeorm_1.Column)({
-        type: 'json',
-        nullable: true,
-        comment: '回滚操作列表',
-    }),
-    __metadata("design:type", Array)
-], ManualOperationLogEntity.prototype, "rollbackActions", void 0);
 __decorate([
     (0, typeorm_1.ManyToOne)('EntityTransactionEntity', { onDelete: 'CASCADE' }),
     (0, typeorm_1.JoinColumn)({ name: 'transactionId' }),

package/audit/enums/audit.enums.d.ts

@@ -40,14 +40,6 @@ export declare enum MaskingStrategy {
     MASK = "MASK",
     PARTIAL = "PARTIAL"
 }
-/**
- * 回滚操作类型（设计文档标准命名）
- */
-export declare enum RollbackActionType {
-    ENTITY = "entity",// 实体回滚（删除/恢复）
-    FILE = "file",// 文件回滚（删除上传的文件）
-    CUSTOM = "custom"
-}
 /**
  * 变更类型（设计文档标准命名）
  */

package/audit/enums/audit.enums.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChangeType = exports.RollbackActionType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.AuditTransactionStatus = exports.AuditOperation = void 0;
+exports.ChangeType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.AuditTransactionStatus = exports.AuditOperation = void 0;
 /**
  * 审计操作类型（兼容性别名，映射到 OperationType）
  */
@@ -48,15 +48,6 @@ var MaskingStrategy;
     MaskingStrategy["MASK"] = "MASK";
     MaskingStrategy["PARTIAL"] = "PARTIAL";
 })(MaskingStrategy || (exports.MaskingStrategy = MaskingStrategy = {}));
-/**
- * 回滚操作类型（设计文档标准命名）
- */
-var RollbackActionType;
-(function (RollbackActionType) {
-    RollbackActionType["ENTITY"] = "entity";
-    RollbackActionType["FILE"] = "file";
-    RollbackActionType["CUSTOM"] = "custom";
-})(RollbackActionType || (exports.RollbackActionType = RollbackActionType = {}));
 /**
  * 变更类型（设计文档标准命名）
  */

package/audit/examples/decorator-value-mapping.example.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 装饰器值映射完整示例
+ *
+ * 本示例演示如何使用 @AuditField 装饰器的 valueLabels 功能
+ * 实现字段值的多语言显示和映射
+ */
+export declare class ProductEntity {
+    id: string;
+    name: string;
+    price: number;
+    costPrice: number;
+    stock: number;
+    status: string;
+    isFeatured: boolean;
+    productType: string;
+    internalNotes: string;
+    supplierCode: string;
+}
+export declare class OrderEntity {
+    orderSn: string;
+    totalAmount: number;
+    orderStatus: string;
+    paymentStatus: string;
+    shippingMethod: string;
+    customerPhone: string;
+    customerEmail: string;
+}
+export declare class UserEntity {
+    username: string;
+    email: string;
+    phone: string;
+    status: string;
+    role: string;
+    emailNotificationEnabled: boolean;
+    smsNotificationEnabled: boolean;
+    gender: string;
+    password: string;
+}
+export declare class InventoryEntity {
+    productCode: string;
+    availableStock: number;
+    lockedStock: number;
+    totalStock: number;
+    stockStatus: string;
+}
+/**
+ * 当产品状态从 'active' 变为 'out_of_stock' 时，
+ * 审计日志的 changeDetails 会显示：
+ *
+ * 中文 (language=zh):
+ * {
+ *   "fieldName": "状态",
+ *   "changeType": "modified",
+ *   "displayOldValue": "在售",
+ *   "displayNewValue": "缺货",
+ *   "oldValue": "active",
+ *   "newValue": "out_of_stock"
+ * }
+ *
+ * 英文 (language=en):
+ * {
+ *   "fieldName": "Status",
+ *   "changeType": "modified",
+ *   "displayOldValue": "Active",
+ *   "displayNewValue": "Out of Stock",
+ *   "oldValue": "active",
+ *   "newValue": "out_of_stock"
+ * }
+ */
+export {};