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

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

@@ -1,5 +1,5 @@
 /**
- * 审计操作类型
+ * 审计操作类型（兼容性别名，映射到 OperationType）
  */
 export declare enum AuditOperation {
     CREATE = "CREATE",
@@ -8,12 +8,12 @@ export declare enum AuditOperation {
     RESTORE = "RESTORE"
 }
 /**
- * 事务状态
+ * 事务状态（设计文档标准命名）
  */
-export declare enum TransactionStatus {
-    PENDING = "PENDING",
-    COMMITTED = "COMMITTED",
-    ROLLED_BACK = "ROLLED_BACK"
+export declare enum AuditTransactionStatus {
+    PENDING = "pending",
+    COMMITTED = "committed",
+    ROLLED_BACK = "rolled_back"
 }
 /**
  * 恢复策略
@@ -40,3 +40,11 @@ export declare enum MaskingStrategy {
     MASK = "MASK",
     PARTIAL = "PARTIAL"
 }
+/**
+ * 变更类型（设计文档标准命名）
+ */
+export declare enum ChangeType {
+    ADDED = "added",// 新增字段
+    REMOVED = "removed",// 删除字段
+    MODIFIED = "modified"
+}

package/audit/enums/audit.enums.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.TransactionStatus = exports.AuditOperation = void 0;
+exports.ChangeType = exports.MaskingStrategy = exports.RecordStrategy = exports.RecoveryStrategy = exports.AuditTransactionStatus = exports.AuditOperation = void 0;
 /**
- * 审计操作类型
+ * 审计操作类型（兼容性别名，映射到 OperationType）
  */
 var AuditOperation;
 (function (AuditOperation) {
@@ -12,14 +12,14 @@ var AuditOperation;
     AuditOperation["RESTORE"] = "RESTORE";
 })(AuditOperation || (exports.AuditOperation = AuditOperation = {}));
 /**
- * 事务状态
+ * 事务状态（设计文档标准命名）
  */
-var TransactionStatus;
-(function (TransactionStatus) {
-    TransactionStatus["PENDING"] = "PENDING";
-    TransactionStatus["COMMITTED"] = "COMMITTED";
-    TransactionStatus["ROLLED_BACK"] = "ROLLED_BACK";
-})(TransactionStatus || (exports.TransactionStatus = TransactionStatus = {}));
+var AuditTransactionStatus;
+(function (AuditTransactionStatus) {
+    AuditTransactionStatus["PENDING"] = "pending";
+    AuditTransactionStatus["COMMITTED"] = "committed";
+    AuditTransactionStatus["ROLLED_BACK"] = "rolled_back";
+})(AuditTransactionStatus || (exports.AuditTransactionStatus = AuditTransactionStatus = {}));
 /**
  * 恢复策略
  */
@@ -48,3 +48,12 @@ var MaskingStrategy;
     MaskingStrategy["MASK"] = "MASK";
     MaskingStrategy["PARTIAL"] = "PARTIAL";
 })(MaskingStrategy || (exports.MaskingStrategy = MaskingStrategy = {}));
+/**
+ * 变更类型（设计文档标准命名）
+ */
+var ChangeType;
+(function (ChangeType) {
+    ChangeType["ADDED"] = "added";
+    ChangeType["REMOVED"] = "removed";
+    ChangeType["MODIFIED"] = "modified";
+})(ChangeType || (exports.ChangeType = ChangeType = {}));

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 {};

package/audit/examples/decorator-value-mapping.example.js

@@ -0,0 +1,414 @@
+"use strict";
+/**
+ * 装饰器值映射完整示例
+ *
+ * 本示例演示如何使用 @AuditField 装饰器的 valueLabels 功能
+ * 实现字段值的多语言显示和映射
+ */
+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.InventoryEntity = exports.UserEntity = exports.OrderEntity = exports.ProductEntity = void 0;
+const typeorm_1 = require("typeorm");
+const entity_audit_decorator_1 = require("../decorators/entity-audit.decorator");
+// ============================================
+// 示例 1: 电商产品实体
+// ============================================
+let ProductEntity = class ProductEntity {
+};
+exports.ProductEntity = ProductEntity;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '产品名称', en: 'Product Name' },
+    }),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "name", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'decimal', precision: 10, scale: 2 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '价格', en: 'Price' },
+        formatter: (value) => `¥${parseFloat(value).toFixed(2)}`,
+    }),
+    __metadata("design:type", Number)
+], ProductEntity.prototype, "price", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'decimal', precision: 10, scale: 2 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '成本价', en: 'Cost Price' },
+        sensitive: true,
+    }),
+    __metadata("design:type", Number)
+], ProductEntity.prototype, "costPrice", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '库存', en: 'Stock' },
+        formatter: (value) => `${value} 件`,
+    }),
+    __metadata("design:type", Number)
+], ProductEntity.prototype, "stock", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['active', 'inactive', 'out_of_stock', 'discontinued'],
+        default: 'active',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '状态', en: 'Status' },
+        valueLabels: {
+            active: { zh: '在售', en: 'Active', ja: '販売中' },
+            inactive: { zh: '停售', en: 'Inactive', ja: '販売停止' },
+            out_of_stock: { zh: '缺货', en: 'Out of Stock', ja: '在庫切れ' },
+            discontinued: { zh: '已停产', en: 'Discontinued', ja: '廃盤' },
+        },
+    }),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '是否推荐', en: 'Featured' },
+        valueLabels: {
+            true: { zh: '是', en: 'Yes', ja: 'はい' },
+            false: { zh: '否', en: 'No', ja: 'いいえ' },
+        },
+    }),
+    __metadata("design:type", Boolean)
+], ProductEntity.prototype, "isFeatured", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['physical', 'digital', 'service'],
+        default: 'physical',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '产品类型', en: 'Product Type' },
+        valueLabels: {
+            physical: { zh: '实物', en: 'Physical', ja: '物理商品' },
+            digital: { zh: '数字产品', en: 'Digital', ja: 'デジタル商品' },
+            service: { zh: '服务', en: 'Service', ja: 'サービス' },
+        },
+    }),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "productType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "internalNotes", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], ProductEntity.prototype, "supplierCode", void 0);
+exports.ProductEntity = ProductEntity = __decorate([
+    (0, typeorm_1.Entity)('products'),
+    (0, entity_audit_decorator_1.AuditEntity)({
+        enabled: true,
+        excludeFields: ['internalNotes', 'supplierCode'],
+        maskFields: ['costPrice'],
+    })
+], ProductEntity);
+// ============================================
+// 示例 2: 订单实体
+// ============================================
+let OrderEntity = class OrderEntity {
+};
+exports.OrderEntity = OrderEntity;
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '订单号', en: 'Order Number' },
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "orderSn", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'decimal', precision: 10, scale: 2 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '订单金额', en: 'Order Amount' },
+        formatter: (value) => `¥${parseFloat(value).toFixed(2)}`,
+    }),
+    __metadata("design:type", Number)
+], OrderEntity.prototype, "totalAmount", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['pending', 'confirmed', 'processing', 'shipped', 'delivered', 'cancelled', 'refunded'],
+        default: 'pending',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '订单状态', en: 'Order Status' },
+        valueLabels: {
+            pending: { zh: '待确认', en: 'Pending', ja: '保留中' },
+            confirmed: { zh: '已确认', en: 'Confirmed', ja: '確認済み' },
+            processing: { zh: '处理中', en: 'Processing', ja: '処理中' },
+            shipped: { zh: '已发货', en: 'Shipped', ja: '発送済み' },
+            delivered: { zh: '已送达', en: 'Delivered', ja: '配達済み' },
+            cancelled: { zh: '已取消', en: 'Cancelled', ja: 'キャンセル済み' },
+            refunded: { zh: '已退款', en: 'Refunded', ja: '返金済み' },
+        },
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "orderStatus", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['unpaid', 'partial_paid', 'paid', 'refunded'],
+        default: 'unpaid',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '支付状态', en: 'Payment Status' },
+        valueLabels: {
+            unpaid: { zh: '未支付', en: 'Unpaid', ja: '未払い' },
+            partial_paid: { zh: '部分支付', en: 'Partial Paid', ja: '一部支払い' },
+            paid: { zh: '已支付', en: 'Paid', ja: '支払い済み' },
+            refunded: { zh: '已退款', en: 'Refunded', ja: '返金済み' },
+        },
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "paymentStatus", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['standard', 'express', 'overnight', 'international'],
+        default: 'standard',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '配送方式', en: 'Shipping Method' },
+        valueLabels: {
+            standard: { zh: '标准配送', en: 'Standard', ja: '標準配送' },
+            express: { zh: '加急配送', en: 'Express', ja: '急行配送' },
+            overnight: { zh: '次日达', en: 'Overnight', ja: '翌日配達' },
+            international: { zh: '国际配送', en: 'International', ja: '国際配送' },
+        },
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "shippingMethod", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '客户电话', en: 'Customer Phone' },
+        sensitive: true,
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "customerPhone", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '客户邮箱', en: 'Customer Email' },
+        sensitive: true,
+    }),
+    __metadata("design:type", String)
+], OrderEntity.prototype, "customerEmail", void 0);
+exports.OrderEntity = OrderEntity = __decorate([
+    (0, typeorm_1.Entity)('orders'),
+    (0, entity_audit_decorator_1.AuditEntity)({
+        enabled: true,
+        maskFields: ['customerPhone', 'customerEmail'],
+    })
+], OrderEntity);
+// ============================================
+// 示例 3: 用户实体
+// ============================================
+let UserEntity = class UserEntity {
+};
+exports.UserEntity = UserEntity;
+__decorate([
+    (0, typeorm_1.Column)({ unique: true }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '用户名', en: 'Username' },
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "username", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '邮箱', en: 'Email' },
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "email", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '手机号', en: 'Phone' },
+        sensitive: true,
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "phone", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['active', 'inactive', 'suspended', 'banned'],
+        default: 'inactive',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '账号状态', en: 'Account Status' },
+        valueLabels: {
+            active: { zh: '正常', en: 'Active', ja: '有効' },
+            inactive: { zh: '未激活', en: 'Inactive', ja: '無効' },
+            suspended: { zh: '已暂停', en: 'Suspended', ja: '停止中' },
+            banned: { zh: '已封禁', en: 'Banned', ja: '禁止' },
+        },
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['user', 'vip', 'admin', 'super_admin'],
+        default: 'user',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '角色', en: 'Role' },
+        valueLabels: {
+            user: { zh: '普通用户', en: 'User', ja: '一般ユーザー' },
+            vip: { zh: 'VIP用户', en: 'VIP User', ja: 'VIPユーザー' },
+            admin: { zh: '管理员', en: 'Admin', ja: '管理者' },
+            super_admin: { zh: '超级管理员', en: 'Super Admin', ja: 'スーパー管理者' },
+        },
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "role", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: true }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '邮件通知', en: 'Email Notification' },
+        valueLabels: {
+            true: { zh: '开启', en: 'Enabled', ja: '有効' },
+            false: { zh: '关闭', en: 'Disabled', ja: '無効' },
+        },
+    }),
+    __metadata("design:type", Boolean)
+], UserEntity.prototype, "emailNotificationEnabled", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: true }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '短信通知', en: 'SMS Notification' },
+        valueLabels: {
+            true: { zh: '开启', en: 'Enabled', ja: '有効' },
+            false: { zh: '关闭', en: 'Disabled', ja: '無効' },
+        },
+    }),
+    __metadata("design:type", Boolean)
+], UserEntity.prototype, "smsNotificationEnabled", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['male', 'female', 'other', 'unknown'],
+        default: 'unknown',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '性别', en: 'Gender' },
+        valueLabels: {
+            male: { zh: '男', en: 'Male', ja: '男性' },
+            female: { zh: '女', en: 'Female', ja: '女性' },
+            other: { zh: '其他', en: 'Other', ja: 'その他' },
+            unknown: { zh: '未知', en: 'Unknown', ja: '不明' },
+        },
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "gender", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '密码', en: 'Password' },
+        sensitive: true,
+    }),
+    __metadata("design:type", String)
+], UserEntity.prototype, "password", void 0);
+exports.UserEntity = UserEntity = __decorate([
+    (0, typeorm_1.Entity)('users'),
+    (0, entity_audit_decorator_1.AuditEntity)({
+        enabled: true,
+        maskFields: ['password', 'idCard', 'bankAccount'],
+    })
+], UserEntity);
+// ============================================
+// 示例 4: 库存实体
+// ============================================
+let InventoryEntity = class InventoryEntity {
+};
+exports.InventoryEntity = InventoryEntity;
+__decorate([
+    (0, typeorm_1.Column)(),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '商品编号', en: 'Product Code' },
+    }),
+    __metadata("design:type", String)
+], InventoryEntity.prototype, "productCode", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '可用库存', en: 'Available Stock' },
+        formatter: (value) => `${value} 件`,
+    }),
+    __metadata("design:type", Number)
+], InventoryEntity.prototype, "availableStock", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '锁定库存', en: 'Locked Stock' },
+        formatter: (value) => `${value} 件`,
+    }),
+    __metadata("design:type", Number)
+], InventoryEntity.prototype, "lockedStock", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0 }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '总库存', en: 'Total Stock' },
+        formatter: (value) => `${value} 件`,
+    }),
+    __metadata("design:type", Number)
+], InventoryEntity.prototype, "totalStock", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ['in_stock', 'low_stock', 'out_of_stock'],
+        default: 'in_stock',
+    }),
+    (0, entity_audit_decorator_1.AuditField)({
+        label: { zh: '库存状态', en: 'Stock Status' },
+        valueLabels: {
+            in_stock: { zh: '充足', en: 'In Stock', ja: '在庫あり' },
+            low_stock: { zh: '偏低', en: 'Low Stock', ja: '在庫少' },
+            out_of_stock: { zh: '缺货', en: 'Out of Stock', ja: '在庫切れ' },
+        },
+    }),
+    __metadata("design:type", String)
+], InventoryEntity.prototype, "stockStatus", void 0);
+exports.InventoryEntity = InventoryEntity = __decorate([
+    (0, typeorm_1.Entity)('inventory'),
+    (0, entity_audit_decorator_1.AuditEntity)({
+        enabled: true,
+    })
+], InventoryEntity);
+// ============================================
+// 使用示例
+// ============================================
+const entity_audit_decorator_2 = require("../decorators/entity-audit.decorator");
+// 示例：获取字段标签
+const statusLabelZh = (0, entity_audit_decorator_2.getFieldLabel)(ProductEntity, 'status', 'zh'); // '状态'
+const statusLabelEn = (0, entity_audit_decorator_2.getFieldLabel)(ProductEntity, 'status', 'en'); // 'Status'
+// 示例：获取字段值的标签
+const statusValueZh = (0, entity_audit_decorator_2.getFieldValueLabel)(ProductEntity, 'status', 'active', 'zh'); // '在售'
+const statusValueEn = (0, entity_audit_decorator_2.getFieldValueLabel)(ProductEntity, 'status', 'active', 'en'); // 'Active'
+const statusValueJa = (0, entity_audit_decorator_2.getFieldValueLabel)(ProductEntity, 'status', 'active', 'ja'); // '販売中'
+// 布尔值示例
+const featuredValueZh = (0, entity_audit_decorator_2.getFieldValueLabel)(ProductEntity, 'isFeatured', true, 'zh'); // '是'
+const featuredValueEn = (0, entity_audit_decorator_2.getFieldValueLabel)(ProductEntity, 'isFeatured', false, 'en'); // 'No'
+// 订单状态示例
+const orderStatusZh = (0, entity_audit_decorator_2.getFieldValueLabel)(OrderEntity, 'orderStatus', 'shipped', 'zh'); // '已发货'
+const orderStatusEn = (0, entity_audit_decorator_2.getFieldValueLabel)(OrderEntity, 'orderStatus', 'shipped', 'en'); // 'Shipped'
+// 用户角色示例
+const roleValueZh = (0, entity_audit_decorator_2.getFieldValueLabel)(UserEntity, 'role', 'vip', 'zh'); // 'VIP用户'
+const roleValueEn = (0, entity_audit_decorator_2.getFieldValueLabel)(UserEntity, 'role', 'super_admin', 'en'); // 'Super Admin'

package/audit/index.d.ts

@@ -2,8 +2,12 @@ export * from './entities';
 export * from './enums';
 export * from './interfaces';
 export * from './dto';
-export * from './decorators';
+export { AuditEntity, AuditField, getEntityAuditConfig, getFieldAuditConfig, getFieldLabel, getFieldValueLabel, getEntityLabel, ENTITY_AUDIT_OPTIONS, FIELD_AUDIT_OPTIONS, } from './decorators/entity-audit.decorator';
+export { AuditController, AuditMethod, CONTROLLER_AUDIT_OPTIONS, METHOD_AUDIT_OPTIONS, } from './decorators/audit-controller.decorator';
+export { AuditLog, getAuditOperationConfig, hasAuditOperation, AUDIT_OPERATION_OPTIONS, } from './decorators/audit-operation.decorator';
+export { AuditAction, AuditActionOptions, AuditActionMetadata, AUDIT_ACTION_METADATA, } from './decorators/audit-action.decorator';
 export * from './services';
+export { registerEntityClass, getEntityClass } from './services/entity-audit.service';
 export * from './subscribers';
 export * from './interceptors';
 export * from './controllers';

package/audit/index.js

@@ -14,6 +14,7 @@ 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 });
+exports.getEntityClass = exports.registerEntityClass = exports.AUDIT_ACTION_METADATA = exports.AuditAction = exports.AUDIT_OPERATION_OPTIONS = exports.hasAuditOperation = exports.getAuditOperationConfig = exports.AuditLog = exports.METHOD_AUDIT_OPTIONS = exports.CONTROLLER_AUDIT_OPTIONS = exports.AuditMethod = exports.AuditController = exports.FIELD_AUDIT_OPTIONS = exports.ENTITY_AUDIT_OPTIONS = exports.getEntityLabel = exports.getFieldValueLabel = exports.getFieldLabel = exports.getFieldAuditConfig = exports.getEntityAuditConfig = exports.AuditField = exports.AuditEntity = void 0;
 // Entities
 __exportStar(require("./entities"), exports);
 // Enums
@@ -22,10 +23,36 @@ __exportStar(require("./enums"), exports);
 __exportStar(require("./interfaces"), exports);
 // DTO
 __exportStar(require("./dto"), exports);
-// Decorators
-__exportStar(require("./decorators"), exports);
+// Decorators - explicit exports
+var entity_audit_decorator_1 = require("./decorators/entity-audit.decorator");
+Object.defineProperty(exports, "AuditEntity", { enumerable: true, get: function () { return entity_audit_decorator_1.AuditEntity; } });
+Object.defineProperty(exports, "AuditField", { enumerable: true, get: function () { return entity_audit_decorator_1.AuditField; } });
+Object.defineProperty(exports, "getEntityAuditConfig", { enumerable: true, get: function () { return entity_audit_decorator_1.getEntityAuditConfig; } });
+Object.defineProperty(exports, "getFieldAuditConfig", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldAuditConfig; } });
+Object.defineProperty(exports, "getFieldLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldLabel; } });
+Object.defineProperty(exports, "getFieldValueLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getFieldValueLabel; } });
+Object.defineProperty(exports, "getEntityLabel", { enumerable: true, get: function () { return entity_audit_decorator_1.getEntityLabel; } });
+Object.defineProperty(exports, "ENTITY_AUDIT_OPTIONS", { enumerable: true, get: function () { return entity_audit_decorator_1.ENTITY_AUDIT_OPTIONS; } });
+Object.defineProperty(exports, "FIELD_AUDIT_OPTIONS", { enumerable: true, get: function () { return entity_audit_decorator_1.FIELD_AUDIT_OPTIONS; } });
+var audit_controller_decorator_1 = require("./decorators/audit-controller.decorator");
+Object.defineProperty(exports, "AuditController", { enumerable: true, get: function () { return audit_controller_decorator_1.AuditController; } });
+Object.defineProperty(exports, "AuditMethod", { enumerable: true, get: function () { return audit_controller_decorator_1.AuditMethod; } });
+Object.defineProperty(exports, "CONTROLLER_AUDIT_OPTIONS", { enumerable: true, get: function () { return audit_controller_decorator_1.CONTROLLER_AUDIT_OPTIONS; } });
+Object.defineProperty(exports, "METHOD_AUDIT_OPTIONS", { enumerable: true, get: function () { return audit_controller_decorator_1.METHOD_AUDIT_OPTIONS; } });
+var audit_operation_decorator_1 = require("./decorators/audit-operation.decorator");
+Object.defineProperty(exports, "AuditLog", { enumerable: true, get: function () { return audit_operation_decorator_1.AuditLog; } });
+Object.defineProperty(exports, "getAuditOperationConfig", { enumerable: true, get: function () { return audit_operation_decorator_1.getAuditOperationConfig; } });
+Object.defineProperty(exports, "hasAuditOperation", { enumerable: true, get: function () { return audit_operation_decorator_1.hasAuditOperation; } });
+Object.defineProperty(exports, "AUDIT_OPERATION_OPTIONS", { enumerable: true, get: function () { return audit_operation_decorator_1.AUDIT_OPERATION_OPTIONS; } });
+var audit_action_decorator_1 = require("./decorators/audit-action.decorator");
+Object.defineProperty(exports, "AuditAction", { enumerable: true, get: function () { return audit_action_decorator_1.AuditAction; } });
+Object.defineProperty(exports, "AUDIT_ACTION_METADATA", { enumerable: true, get: function () { return audit_action_decorator_1.AUDIT_ACTION_METADATA; } });
 // Services
 __exportStar(require("./services"), exports);
+// Entity class registry (for decorator value mapping)
+var entity_audit_service_1 = require("./services/entity-audit.service");
+Object.defineProperty(exports, "registerEntityClass", { enumerable: true, get: function () { return entity_audit_service_1.registerEntityClass; } });
+Object.defineProperty(exports, "getEntityClass", { enumerable: true, get: function () { return entity_audit_service_1.getEntityClass; } });
 // Subscribers
 __exportStar(require("./subscribers"), exports);
 // Interceptors

package/audit/interceptors/audit-action.interceptor.d.ts

@@ -0,0 +1,39 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Repository } from 'typeorm';
+import { AuditContextService } from '../services/audit-context.service';
+import { OperationDescriptionService } from '../services/operation-description.service';
+import { AuditActionSummaryEntity } from '../entities';
+/**
+ * 审计动作拦截器
+ * 在请求开始时创建审计动作上下文，在请求结束时生成汇总记录
+ */
+export declare class AuditActionInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly contextService;
+    private readonly summaryRepository;
+    private readonly descriptionService?;
+    private readonly logger;
+    constructor(reflector: Reflector, contextService: AuditContextService, summaryRepository: Repository<AuditActionSummaryEntity>, descriptionService?: OperationDescriptionService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 生成审计汇总记录
+     */
+    private generateSummary;
+    /**
+     * 生成操作描述文本
+     * 优先从 OperationDescriptionService 获取多语言模板
+     * 如果没有，则使用默认格式
+     */
+    private generateDescription;
+    /**
+     * 替换模板中的占位符
+     * 支持格式：{key} 或 {key:format}
+     */
+    private replaceTemplatePlaceholders;
+    /**
+     * 格式化值为字符串
+     */
+    private formatValue;
+}