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

package/audit/audit.module.d.ts

@@ -1,7 +1,17 @@
 import { DynamicModule } from '@nestjs/common';
 import { AuditConfig } from './interfaces';
+/**
+ * 审计模块
+ */
 export declare class AuditModule {
+    /**
+     * 注册审计模块
+     * @param config 审计配置
+     */
     static forRoot(config?: AuditConfig): DynamicModule;
+    /**
+     * 注册审计模块（异步）
+     */
     static forRootAsync(options: {
         imports?: any[];
         inject?: any[];

package/audit/audit.module.js

@@ -25,11 +25,19 @@ const services_1 = require("./services");
 const subscribers_1 = require("./subscribers");
 const interceptors_1 = require("./interceptors");
 const controllers_1 = require("./controllers");
+/**
+ * 审计模块
+ */
 let AuditModule = AuditModule_1 = class AuditModule {
+    /**
+     * 注册审计模块
+     * @param config 审计配置
+     */
     static forRoot(config) {
         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'];
+        // 创建多个订阅者提供者，每个监听的数据库连接一个
         const subscriberProviders = monitoredConnections.map((connectionName) => ({
             provide: `AUDIT_SUBSCRIBER_${connectionName}`,
             useFactory: (auditService, contextService, auditStrategy, dataSource) => {
@@ -43,6 +51,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 (0, typeorm_1.getDataSourceToken)(connectionName),
             ],
         }));
+        // 创建repository别名提供者，使service能够注入正确连接的repository
         const repositoryProviders = [
             {
                 provide: (0, typeorm_1.getRepositoryToken)(entities_1.EntityAuditLogEntity),
@@ -58,6 +67,20 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 },
                 inject: [(0, typeorm_1.getDataSourceToken)(auditConnectionName)],
             },
+            {
+                provide: (0, typeorm_1.getRepositoryToken)(entities_1.OperationTemplateEntity),
+                useFactory: (dataSource) => {
+                    return dataSource.getRepository(entities_1.OperationTemplateEntity);
+                },
+                inject: [(0, typeorm_1.getDataSourceToken)(auditConnectionName)],
+            },
+            {
+                provide: (0, typeorm_1.getRepositoryToken)(entities_1.ManualOperationLogEntity),
+                useFactory: (dataSource) => {
+                    return dataSource.getRepository(entities_1.ManualOperationLogEntity);
+                },
+                inject: [(0, typeorm_1.getDataSourceToken)(auditConnectionName)],
+            },
             {
                 provide: 'AUDIT_ENTITY_MANAGER',
                 useFactory: (dataSource) => {
@@ -69,7 +92,13 @@ let AuditModule = AuditModule_1 = class AuditModule {
         return {
             module: AuditModule_1,
             imports: [
-                typeorm_1.TypeOrmModule.forFeature([entities_1.EntityAuditLogEntity, entities_1.EntityTransactionEntity], auditConnectionName),
+                // ��计日志存储到指定的数据库连接
+                typeorm_1.TypeOrmModule.forFeature([
+                    entities_1.EntityAuditLogEntity,
+                    entities_1.EntityTransactionEntity,
+                    entities_1.OperationTemplateEntity,
+                    entities_1.ManualOperationLogEntity,
+                ], auditConnectionName),
                 nestjs_cls_1.ClsModule.forRoot({
                     global: true,
                     middleware: { mount: true },
@@ -95,6 +124,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 ...repositoryProviders,
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
+                services_1.OperationDescriptionService,
                 interceptors_1.AuditInterceptor,
                 ...subscriberProviders,
             ],
@@ -104,11 +134,16 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.MultiDatabaseService,
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
+                services_1.OperationDescriptionService,
                 interceptors_1.AuditInterceptor,
             ],
         };
     }
+    /**
+     * 注册审计模块（异步）
+     */
     static forRootAsync(options) {
+        // 创建repository别名提供者，使service能够注入正确连接的repository
         const repositoryProviders = [
             {
                 provide: (0, typeorm_1.getRepositoryToken)(entities_1.EntityAuditLogEntity),
@@ -195,6 +230,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                         const config = yield options.useFactory(...args);
                         const monitoredConnections = ((_a = config === null || config === void 0 ? void 0 : config.connections) === null || _a === void 0 ? void 0 : _a.monitored) || ['default'];
                         const auditConnectionName = ((_b = config === null || config === void 0 ? void 0 : config.connections) === null || _b === void 0 ? void 0 : _b.audit) || 'default';
+                        // 动态注册 TypeORM 实体
                         const typeOrmModule = typeorm_1.TypeOrmModule.forFeature([entities_1.EntityAuditLogEntity, entities_1.EntityTransactionEntity], auditConnectionName);
                         return monitoredConnections;
                     }),
@@ -211,6 +247,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 ...repositoryProviders,
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
+                services_1.OperationDescriptionService,
                 interceptors_1.AuditInterceptor,
             ],
             exports: [
@@ -219,6 +256,7 @@ let AuditModule = AuditModule_1 = class AuditModule {
                 services_1.MultiDatabaseService,
                 services_1.EntityAuditService,
                 services_1.TransactionAuditService,
+                services_1.OperationDescriptionService,
                 interceptors_1.AuditInterceptor,
             ],
         };

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

@@ -4,17 +4,41 @@ import { AuditLogQueryDto, CompareEntitiesDto, RestoreEntityDto, PreCheckRestore
 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/controllers/audit.controller.js

@@ -27,43 +27,67 @@ const swagger_1 = require("@nestjs/swagger");
 const entity_audit_service_1 = require("../services/entity-audit.service");
 const transaction_audit_service_1 = require("../services/transaction-audit.service");
 const dto_1 = require("../dto");
+/**
+ * 审计控制器
+ */
 let AuditController = class AuditController {
     constructor(entityAuditService, transactionAuditService) {
         this.entityAuditService = entityAuditService;
         this.transactionAuditService = transactionAuditService;
     }
+    /**
+     * 查询实体审计日志
+     */
     getAuditLogs(query) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.entityAuditService.getAuditLogs(query);
         });
     }
+    /**
+     * 比较实体版本
+     */
     compareEntities(query) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
             return this.entityAuditService.compareEntities(query.entityType, query.entityId, (_a = query.fromVersion) === null || _a === void 0 ? void 0 : _a.toString(), (_b = query.toVersion) === null || _b === void 0 ? void 0 : _b.toString());
         });
     }
+    /**
+     * 预检查恢复操作
+     */
     preCheckRestore(preCheckDto) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.entityAuditService.preCheckRestore(preCheckDto.entityType, preCheckDto.entityId, preCheckDto.auditLogId);
         });
     }
+    /**
+     * 恢复实体到指定版本
+     */
     restoreEntity(restoreDto) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.entityAuditService.restoreEntity(restoreDto.entityType, restoreDto.entityId, restoreDto.auditLogId, restoreDto.options);
         });
     }
+    /**
+     * 开始审计事务
+     */
     beginTransaction(beginTransactionDto) {
         return __awaiter(this, void 0, void 0, function* () {
             const transactionId = yield this.transactionAuditService.beginTransaction(beginTransactionDto.description);
             return { transactionId };
         });
     }
+    /**
+     * 提交审计事务
+     */
     commitTransaction(transactionId) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.transactionAuditService.commitTransaction(transactionId);
         });
     }
+    /**
+     * 回滚审计事务
+     */
     rollbackTransaction(transactionId) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.transactionAuditService.rollbackTransaction(transactionId);

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

@@ -1,5 +1,13 @@
 import { ControllerAuditOptions, MethodAuditOptions } from '../interfaces';
 export declare const CONTROLLER_AUDIT_OPTIONS: unique symbol;
 export declare const METHOD_AUDIT_OPTIONS: unique symbol;
-export declare function EntityAuditController(options?: ControllerAuditOptions): ClassDecorator;
+/**
+ * 控制器审计装饰器
+ * @param options 控制器审计选项
+ */
+export declare function AuditController(options?: ControllerAuditOptions): ClassDecorator;
+/**
+ * 方法审计装饰器
+ * @param options 方法审计选项
+ */
 export declare function AuditMethod(options?: MethodAuditOptions): MethodDecorator;

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

@@ -1,15 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.METHOD_AUDIT_OPTIONS = exports.CONTROLLER_AUDIT_OPTIONS = void 0;
-exports.EntityAuditController = EntityAuditController;
+exports.AuditController = AuditController;
 exports.AuditMethod = AuditMethod;
+// 元数据键
 exports.CONTROLLER_AUDIT_OPTIONS = Symbol('CONTROLLER_AUDIT_OPTIONS');
 exports.METHOD_AUDIT_OPTIONS = Symbol('METHOD_AUDIT_OPTIONS');
-function EntityAuditController(options) {
+/**
+ * 控制器审计装饰器
+ * @param options 控制器审计选项
+ */
+function AuditController(options) {
     return (target) => {
         Reflect.defineMetadata(exports.CONTROLLER_AUDIT_OPTIONS, options || {}, target);
     };
 }
+/**
+ * 方法审计装饰器
+ * @param options 方法审计选项
+ */
 function AuditMethod(options) {
     return (target, propertyKey, descriptor) => {
         Reflect.defineMetadata(exports.METHOD_AUDIT_OPTIONS, options || {}, descriptor.value);

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

@@ -1,5 +1,50 @@
 import { AuditOperationOptions } from '../interfaces';
 export declare const AUDIT_OPERATION_OPTIONS: unique symbol;
+/**
+ * 方法审计装饰器
+ *
+ * @description
+ * 用于手动记录业务操作的审计日志，支持：
+ * - 自定义操作模板
+ * - 动态描述参数
+ * - 回滚操作定义
+ * - 自动事务管理
+ *
+ * @param options 审计操作选项
+ *
+ * @example
+ * ```typescript
+ * @AuditLog({
+ *   templateKey: 'user.approve',
+ *   descriptionParams: (args, result) => ({
+ *     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> {
+ *   // 业务逻辑
+ * }
+ * ```
+ */
 export declare function AuditLog(options: AuditOperationOptions): MethodDecorator;
+/**
+ * 获取方法的审计配置
+ * @param target 目标类或实例
+ * @param propertyKey 方法名
+ * @returns 审计操作选项
+ */
 export declare function getAuditOperationConfig(target: any, propertyKey: string | symbol): AuditOperationOptions | undefined;
+/**
+ * 检查方法是否配置了审计
+ * @param target 目标类或实例
+ * @param propertyKey 方法名
+ * @returns 是否配置了审计
+ */
 export declare function hasAuditOperation(target: any, propertyKey: string | symbol): boolean;

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

@@ -4,20 +4,69 @@ exports.AUDIT_OPERATION_OPTIONS = void 0;
 exports.AuditLog = AuditLog;
 exports.getAuditOperationConfig = getAuditOperationConfig;
 exports.hasAuditOperation = hasAuditOperation;
+// 元数据键
 exports.AUDIT_OPERATION_OPTIONS = Symbol('AUDIT_OPERATION_OPTIONS');
+/**
+ * 方法审计装饰器
+ *
+ * @description
+ * 用于手动记录业务操作的审计日志，支持：
+ * - 自定义操作模板
+ * - 动态描述参数
+ * - 回滚操作定义
+ * - 自动事务管理
+ *
+ * @param options 审计操作选项
+ *
+ * @example
+ * ```typescript
+ * @AuditLog({
+ *   templateKey: 'user.approve',
+ *   descriptionParams: (args, result) => ({
+ *     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> {
+ *   // 业务逻辑
+ * }
+ * ```
+ */
 function AuditLog(options) {
     return (target, propertyKey, descriptor) => {
+        // 验证必需参数
         if (!options.templateKey) {
             throw new Error(`@AuditLog requires templateKey for method ${String(propertyKey)}`);
         }
+        // 存储元数据
         const methodMetadata = Object.assign(Object.assign({}, options), { methodName: String(propertyKey) });
         Reflect.defineMetadata(exports.AUDIT_OPERATION_OPTIONS, methodMetadata, target, propertyKey);
+        // 返回原始描述符，实际的拦截逻辑由 AuditInterceptor 处理
         return descriptor;
     };
 }
+/**
+ * 获取方法的审计配置
+ * @param target 目标类或实例
+ * @param propertyKey 方法名
+ * @returns 审计操作选项
+ */
 function getAuditOperationConfig(target, propertyKey) {
     return Reflect.getMetadata(exports.AUDIT_OPERATION_OPTIONS, target, propertyKey);
 }
+/**
+ * 检查方法是否配置了审计
+ * @param target 目标类或实例
+ * @param propertyKey 方法名
+ * @returns 是否配置了审计
+ */
 function hasAuditOperation(target, propertyKey) {
     return Reflect.hasMetadata(exports.AUDIT_OPERATION_OPTIONS, target, propertyKey);
 }

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

@@ -1,5 +1,80 @@
 import { EntityAuditConfig, FieldDisplayOptions } from '../interfaces';
 export declare const ENTITY_AUDIT_OPTIONS: unique symbol;
 export declare const FIELD_AUDIT_OPTIONS: unique symbol;
-export declare function EntityAudit(options?: EntityAuditConfig): ClassDecorator;
+/**
+ * 实体审计装饰器
+ *
+ * @description
+ * 支持基础审计配置。
+ * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @param options 审计配置选项
+ *
+ * @example
+ * // 基础用法
+ * @AuditEntity({
+ *   enabled: true,
+ *   excludeFields: ['password'],
+ *   maskFields: ['email']
+ * })
+ *
+ * @example
+ * // 指定模板键
+ * @AuditEntity({
+ *   enabled: true,
+ *   templateKey: 'user',
+ * })
+ */
+export declare function AuditEntity(options?: EntityAuditConfig): ClassDecorator;
+/**
+ * 字段审计装饰器
+ * @param options 字段显示选项（支持多语言 label 和 valueLabels）
+ *
+ * @example
+ * // 单语言
+ * @AuditField({ label: '姓名' })
+ *
+ * @example
+ * // 多语言
+ * @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @example
+ * // 带值标签映射
+ * @AuditField({
+ *   label: { zh: '状态', en: 'Status' },
+ *   valueLabels: {
+ *     active: { zh: '激活', en: 'Active' },
+ *     inactive: { zh: '未激活', en: 'Inactive' }
+ *   }
+ * })
+ */
 export declare function AuditField(options?: FieldDisplayOptions): PropertyDecorator;
+/**
+ * 获取实体审计配置
+ * @param target 目标类
+ * @returns 审计配置
+ */
+export declare function getEntityAuditConfig(target: any): EntityAuditConfig;
+/**
+ * 获取字段审计配置
+ * @param target 目标类
+ * @returns 字段配置映射
+ */
+export declare function getFieldAuditConfig(target: any): Record<string, FieldDisplayOptions>;
+/**
+ * 获取字段的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param language 语言代码（默认：zh）
+ * @returns 字段标签
+ */
+export declare function getFieldLabel(target: any, fieldName: string, language?: string): string;
+/**
+ * 获取字段值的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param value 值
+ * @param language 语言代码（默认：zh）
+ * @returns 值的标签
+ */
+export declare function getFieldValueLabel(target: any, fieldName: string, value: any, language?: string): string;

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

@@ -1,15 +1,87 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FIELD_AUDIT_OPTIONS = exports.ENTITY_AUDIT_OPTIONS = void 0;
-exports.EntityAudit = EntityAudit;
+exports.AuditEntity = AuditEntity;
 exports.AuditField = AuditField;
+exports.getEntityAuditConfig = getEntityAuditConfig;
+exports.getFieldAuditConfig = getFieldAuditConfig;
+exports.getFieldLabel = getFieldLabel;
+exports.getFieldValueLabel = getFieldValueLabel;
+// 元数据键
 exports.ENTITY_AUDIT_OPTIONS = Symbol('ENTITY_AUDIT_OPTIONS');
 exports.FIELD_AUDIT_OPTIONS = Symbol('FIELD_AUDIT_OPTIONS');
-function EntityAudit(options) {
+/**
+ * 实体审计装饰器
+ *
+ * @description
+ * 支持基础审计配置。
+ * 字段标签和值标签请使用 @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @param options 审计配置选项
+ *
+ * @example
+ * // 基础用法
+ * @AuditEntity({
+ *   enabled: true,
+ *   excludeFields: ['password'],
+ *   maskFields: ['email']
+ * })
+ *
+ * @example
+ * // 指定模板键
+ * @AuditEntity({
+ *   enabled: true,
+ *   templateKey: 'user',
+ * })
+ */
+function AuditEntity(options) {
     return (target) => {
-        Reflect.defineMetadata(exports.ENTITY_AUDIT_OPTIONS, options || {}, target);
+        // 处理兼容性：sensitiveFields 别名
+        const mergedOptions = Object.assign(Object.assign({}, options), { 
+            // 合并 sensitiveFields 到 maskFields
+            maskFields: [
+                ...((options === null || options === void 0 ? void 0 : options.maskFields) || []),
+                ...((options === null || options === void 0 ? void 0 : options.sensitiveFields) || []),
+            ] });
+        // 去重
+        if (mergedOptions.maskFields && mergedOptions.maskFields.length > 0) {
+            mergedOptions.maskFields = [...new Set(mergedOptions.maskFields)];
+        }
+        // 存储基础审计元数据
+        Reflect.defineMetadata(exports.ENTITY_AUDIT_OPTIONS, mergedOptions, target);
+        // 如果有 templateKey，同时存储到 entity-log 元数据（兼容性）
+        if (mergedOptions.templateKey) {
+            Reflect.defineMetadata('entity-log:enabled', true, target);
+            Reflect.defineMetadata('entity-log:options', {
+                templateKey: mergedOptions.templateKey,
+                excludeFields: mergedOptions.excludeFields,
+                sensitiveFields: mergedOptions.maskFields,
+            }, target);
+        }
     };
 }
+/**
+ * 字段审计装饰器
+ * @param options 字段显示选项（支持多语言 label 和 valueLabels）
+ *
+ * @example
+ * // 单语言
+ * @AuditField({ label: '姓名' })
+ *
+ * @example
+ * // 多语言
+ * @AuditField({ label: { zh: '姓名', en: 'Name' } })
+ *
+ * @example
+ * // 带值标签映射
+ * @AuditField({
+ *   label: { zh: '状态', en: 'Status' },
+ *   valueLabels: {
+ *     active: { zh: '激活', en: 'Active' },
+ *     inactive: { zh: '未激活', en: 'Inactive' }
+ *   }
+ * })
+ */
 function AuditField(options) {
     return (target, propertyKey) => {
         const existingOptions = Reflect.getMetadata(exports.FIELD_AUDIT_OPTIONS, target.constructor) || {};
@@ -17,3 +89,63 @@ function AuditField(options) {
         Reflect.defineMetadata(exports.FIELD_AUDIT_OPTIONS, existingOptions, target.constructor);
     };
 }
+/**
+ * 获取实体审计配置
+ * @param target 目标类
+ * @returns 审计配置
+ */
+function getEntityAuditConfig(target) {
+    return Reflect.getMetadata(exports.ENTITY_AUDIT_OPTIONS, target) || {};
+}
+/**
+ * 获取字段审计配置
+ * @param target 目标类
+ * @returns 字段配置映射
+ */
+function getFieldAuditConfig(target) {
+    return Reflect.getMetadata(exports.FIELD_AUDIT_OPTIONS, target) || {};
+}
+/**
+ * 获取字段的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param language 语言代码（默认：zh）
+ * @returns 字段标签
+ */
+function getFieldLabel(target, fieldName, language = 'zh') {
+    var _a;
+    const fieldConfig = getFieldAuditConfig(target);
+    const label = (_a = fieldConfig[fieldName]) === null || _a === void 0 ? void 0 : _a.label;
+    if (!label) {
+        return fieldName;
+    }
+    // 如果是字符串，直接返回
+    if (typeof label === 'string') {
+        return label;
+    }
+    // 如果是对象，返回指定语言的值
+    return label[language] || label['zh'] || fieldName;
+}
+/**
+ * 获取字段值的标签（支持多语言）
+ * @param target 目标类
+ * @param fieldName 字段名
+ * @param value 值
+ * @param language 语言代码（默认：zh）
+ * @returns 值的标签
+ */
+function getFieldValueLabel(target, fieldName, value, language = 'zh') {
+    var _a;
+    const fieldConfig = getFieldAuditConfig(target);
+    const valueLabels = (_a = fieldConfig[fieldName]) === null || _a === void 0 ? void 0 : _a.valueLabels;
+    if (!valueLabels || !valueLabels[value]) {
+        return value;
+    }
+    const labelMap = valueLabels[value];
+    // 如果是字符串，直接返回
+    if (typeof labelMap === 'string') {
+        return labelMap;
+    }
+    // 如果是对象，返回指定语言的值
+    return labelMap[language] || labelMap['zh'] || value;
+}

package/audit/decorators/index.d.ts

@@ -1,2 +1,3 @@
 export * from './entity-audit.decorator';
 export * from './audit-controller.decorator';
+export * from './audit-operation.decorator';

package/audit/decorators/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./entity-audit.decorator"), exports);
 __exportStar(require("./audit-controller.decorator"), exports);
+__exportStar(require("./audit-operation.decorator"), exports);

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

@@ -1,4 +1,7 @@
 import { AuditOperation } from '../enums';
+/**
+ * 审计日志查询DTO
+ */
 export declare class AuditLogQueryDto {
     page?: number;
     limit?: number;

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

@@ -14,6 +14,9 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const enums_1 = require("../enums");
+/**
+ * 审计日志查询DTO
+ */
 class AuditLogQueryDto {
     constructor() {
         this.page = 1;

package/audit/dto/begin-transaction.dto.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 开始事务DTO
+ */
 export declare class BeginTransactionDto {
     description: string;
 }