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

package/dist/file-upload/decorators/csv-import.decorator.d.ts

@@ -0,0 +1,34 @@
+import { CsvProcessorOptions } from '../processors/csv.processor';
+import { ValidateDataOptions } from './validate-data.decorator';
+/**
+ * CSV 处理装饰器元数据键
+ */
+export declare const CSV_PROCESS_KEY = "csv:process";
+/**
+ * CSV 数据处理选项
+ */
+export interface CsvDataOptions extends CsvProcessorOptions {
+    /** 验证类（使用 class-validator） */
+    validateClass?: any;
+    /** 验证选项 */
+    validation?: ValidateDataOptions;
+    /** 批处理大小 */
+    batchSize?: number;
+    /** 是否异步处理 */
+    async?: boolean;
+}
+/**
+ * CSV 数据处理装饰器
+ * 用于标记方法处理 CSV 文件数据
+ */
+export declare const CsvData: (options?: CsvDataOptions) => import("@nestjs/common").CustomDecorator<string>;
+/**
+ * CSV 批量导入装饰器
+ * 专门用于批量导入场景
+ */
+export declare const CsvImport: (validateClass: any, options?: Omit<CsvDataOptions, "validateClass"> & {
+    /** 目标服务名 */
+    service?: string;
+    /** 目标方法名 */
+    method?: string;
+}) => import("@nestjs/common").CustomDecorator<string>;

package/dist/file-upload/decorators/csv-import.decorator.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CsvImport = exports.CsvData = exports.CSV_PROCESS_KEY = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * CSV 处理装饰器元数据键
+ */
+exports.CSV_PROCESS_KEY = 'csv:process';
+/**
+ * CSV 数据处理装饰器
+ * 用于标记方法处理 CSV 文件数据
+ */
+const CsvData = (options = {}) => {
+    return (0, common_1.SetMetadata)(exports.CSV_PROCESS_KEY, options);
+};
+exports.CsvData = CsvData;
+/**
+ * CSV 批量导入装饰器
+ * 专门用于批量导入场景
+ */
+const CsvImport = (validateClass, options = {}) => {
+    return (0, common_1.SetMetadata)(exports.CSV_PROCESS_KEY, Object.assign(Object.assign({}, options), { validateClass, type: 'import' }));
+};
+exports.CsvImport = CsvImport;

package/dist/file-upload/decorators/examples/column-mapping.example.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 用户导入DTO示例
+ * 展示如何使用列序号、列名和Excel列名进行映射
+ */
+export declare class UserImportDto {
+    /**
+     * 使用列名映射（推荐，更易读）
+     * CSV: 通过表头"姓名"找到列
+     * Excel: 通过表头"姓名"或列名"A"找到列
+     */
+    name: string;
+    /**
+     * 使用列序号映射（从0开始）
+     * CSV: 第2列（索引为1）
+     * Excel: 第2列（B列）
+     */
+    age: number;
+    /**
+     * 使用Excel列名映射
+     * CSV: 如果没有表头，需要使用数字索引
+     * Excel: 可以直接使用列名"C"
+     */
+    email: string;
+    /**
+     * 混合使用不同的映射方式
+     */
+    phone?: string;
+    /**
+     * 使用较大的列索引
+     */
+    address?: string;
+    /**
+     * 使用更大的Excel列名（如AA, AB等）
+     */
+    notes?: string;
+}
+/**
+ * 产品导入DTO示例
+ */
+export declare class ProductImportDto {
+    /**
+     * 产品名称 - 第1列
+     */
+    name: string;
+    /**
+     * 价格 - 第2列
+     */
+    price: number;
+    /**
+     * 库存 - 第3列
+     */
+    stock: number;
+    /**
+     * 描述 - 第4列（可选）
+     */
+    description?: string;
+}
+/**
+ * 使用说明：
+ *
+ * 1. CSV文件：
+ *    - 如果CSV有表头，建议使用列名（如 @CSVColumn('姓名')）
+ *    - 如果CSV没有表头，使用数字索引（如 @CSVColumn(0) 表示第1列）
+ *
+ * 2. Excel文件：
+ *    - 可以使用列名（如 @ExcelColumn('姓名')）
+ *    - 可以使用数字索引（如 @ExcelColumn(0) 表示第1列）
+ *    - 可以使用Excel列名（如 @ExcelColumn('A') 表示A列）
+ *    - 数字索引会自动转换为对应的Excel列名（0 -> A, 1 -> B, 26 -> AA）
+ *
+ * 3. 最佳实践：
+ *    - 优先使用列名，代码更易读
+ *    - 对于无表头的CSV文件，使用数字索引
+ *    - 对于Excel文件，推荐使用Excel列名（A, B, C）或数字索引
+ *    - 可以混合使用不同的映射方式
+ */ 

package/dist/file-upload/decorators/examples/column-mapping.example.js

@@ -0,0 +1,122 @@
+"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.ProductImportDto = exports.UserImportDto = void 0;
+const column_decorator_1 = require("../column.decorator");
+const class_validator_1 = require("class-validator");
+/**
+ * 用户导入DTO示例
+ * 展示如何使用列序号、列名和Excel列名进行映射
+ */
+class UserImportDto {
+}
+exports.UserImportDto = UserImportDto;
+__decorate([
+    (0, column_decorator_1.CSVColumn)('姓名'),
+    (0, column_decorator_1.ExcelColumn)('姓名'),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserImportDto.prototype, "name", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)(1),
+    (0, column_decorator_1.ExcelColumn)(1),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(150),
+    __metadata("design:type", Number)
+], UserImportDto.prototype, "age", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)(2) // CSV使用数字索引
+    ,
+    (0, column_decorator_1.ExcelColumn)('C') // Excel使用列名
+    ,
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], UserImportDto.prototype, "email", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)('电话') // CSV使用列名
+    ,
+    (0, column_decorator_1.ExcelColumn)('D') // Excel使用列名
+    ,
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserImportDto.prototype, "phone", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)(4) // 第5列
+    ,
+    (0, column_decorator_1.ExcelColumn)('E') // 或使用Excel列名
+    ,
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserImportDto.prototype, "address", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)(26) // 第27列
+    ,
+    (0, column_decorator_1.ExcelColumn)('AA') // Excel列AA
+    ,
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UserImportDto.prototype, "notes", void 0);
+/**
+ * 产品导入DTO示例
+ */
+class ProductImportDto {
+}
+exports.ProductImportDto = ProductImportDto;
+__decorate([
+    (0, column_decorator_1.CSVColumn)('产品名称'),
+    (0, column_decorator_1.ExcelColumn)(0),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProductImportDto.prototype, "name", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)('价格'),
+    (0, column_decorator_1.ExcelColumn)('B'),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ProductImportDto.prototype, "price", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)('库存数量'),
+    (0, column_decorator_1.ExcelColumn)(2),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ProductImportDto.prototype, "stock", void 0);
+__decorate([
+    (0, column_decorator_1.CSVColumn)(3),
+    (0, column_decorator_1.ExcelColumn)('D'),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProductImportDto.prototype, "description", void 0);
+/**
+ * 使用说明：
+ *
+ * 1. CSV文件：
+ *    - 如果CSV有表头，建议使用列名（如 @CSVColumn('姓名')）
+ *    - 如果CSV没有表头，使用数字索引（如 @CSVColumn(0) 表示第1列）
+ *
+ * 2. Excel文件：
+ *    - 可以使用列名（如 @ExcelColumn('姓名')）
+ *    - 可以使用数字索引（如 @ExcelColumn(0) 表示第1列）
+ *    - 可以使用Excel列名（如 @ExcelColumn('A') 表示A列）
+ *    - 数字索引会自动转换为对应的Excel列名（0 -> A, 1 -> B, 26 -> AA）
+ *
+ * 3. 最佳实践：
+ *    - 优先使用列名，代码更易读
+ *    - 对于无表头的CSV文件，使用数字索引
+ *    - 对于Excel文件，推荐使用Excel列名（A, B, C）或数字索引
+ *    - 可以混合使用不同的映射方式
+ */ 

package/dist/file-upload/decorators/excel-data.decorator.d.ts

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+/**
+ * Excel 列映射装饰器
+ * 用于标记 DTO 类的属性对应的 Excel 列名
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @ExcelColumn('姓名')
+ *   name: string;
+ *
+ *   @ExcelColumn('邮箱')
+ *   email: string;
+ * }
+ * ```
+ */
+export declare function ExcelColumn(columnName: string): PropertyDecorator;
+/**
+ * 获取 Excel 列映射
+ */
+export declare function getExcelColumnMapping(dto: any): Record<string, string>;
+/**
+ * 解析并验证 Excel 数据
+ */
+export declare function parseAndValidateExcelData(data: any[], dto: any, options?: {
+    skipValidation?: boolean;
+}): Promise<{
+    data: any[];
+    errors: any[];
+}>;

package/dist/file-upload/decorators/excel-data.decorator.js

@@ -0,0 +1,85 @@
+"use strict";
+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.ExcelColumn = ExcelColumn;
+exports.getExcelColumnMapping = getExcelColumnMapping;
+exports.parseAndValidateExcelData = parseAndValidateExcelData;
+require("reflect-metadata");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const EXCEL_COLUMN_METADATA_KEY = Symbol('excel:column');
+/**
+ * Excel 列映射装饰器
+ * 用于标记 DTO 类的属性对应的 Excel 列名
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @ExcelColumn('姓名')
+ *   name: string;
+ *
+ *   @ExcelColumn('邮箱')
+ *   email: string;
+ * }
+ * ```
+ */
+function ExcelColumn(columnName) {
+    return (target, propertyKey) => {
+        const existingColumns = Reflect.getMetadata(EXCEL_COLUMN_METADATA_KEY, target.constructor) || {};
+        existingColumns[columnName] = propertyKey;
+        Reflect.defineMetadata(EXCEL_COLUMN_METADATA_KEY, existingColumns, target.constructor);
+    };
+}
+/**
+ * 获取 Excel 列映射
+ */
+function getExcelColumnMapping(dto) {
+    return Reflect.getMetadata(EXCEL_COLUMN_METADATA_KEY, dto) || {};
+}
+/**
+ * 解析并验证 Excel 数据
+ */
+function parseAndValidateExcelData(data, dto, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const columnMapping = getExcelColumnMapping(dto);
+        const results = [];
+        const errors = [];
+        for (let i = 0; i < data.length; i++) {
+            const row = data[i];
+            const mappedData = {};
+            // 映射列名
+            for (const [excelColumn, dtoProperty] of Object.entries(columnMapping)) {
+                if (row.hasOwnProperty(excelColumn)) {
+                    mappedData[dtoProperty] = row[excelColumn];
+                }
+            }
+            // 转换为 DTO 实例
+            const instance = (0, class_transformer_1.plainToInstance)(dto, mappedData);
+            // 验证
+            if (!(options === null || options === void 0 ? void 0 : options.skipValidation)) {
+                const validationErrors = yield (0, class_validator_1.validate)(instance);
+                if (validationErrors.length > 0) {
+                    errors.push({
+                        row: i + 1,
+                        data: row,
+                        errors: validationErrors.map((e) => ({
+                            property: e.property,
+                            constraints: e.constraints,
+                        })),
+                    });
+                    continue;
+                }
+            }
+            results.push(instance);
+        }
+        return { data: results, errors };
+    });
+}

package/dist/file-upload/decorators/index.d.ts

@@ -0,0 +1,5 @@
+export * from './file-upload.decorator';
+export { ExcelColumn as ExcelColumnDecorator, getExcelColumnMapping as getExcelColumnMappingLegacy, parseAndValidateExcelData } from './excel-data.decorator';
+export { CsvColumn as CsvColumnDecorator, getCsvColumnMapping as getCsvColumnMappingLegacy, parseAndValidateCsvData } from './csv-data.decorator';
+export { CSVColumn, ExcelColumn, getCsvColumnMapping, getExcelColumnMapping, processRowWithMapping, excelColumnToNumber, numberToExcelColumn, ColumnIdentifier } from './column.decorator';
+export * from './process.decorator';

package/dist/file-upload/decorators/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.numberToExcelColumn = exports.excelColumnToNumber = exports.processRowWithMapping = exports.getExcelColumnMapping = exports.getCsvColumnMapping = exports.ExcelColumn = exports.CSVColumn = exports.parseAndValidateCsvData = exports.getCsvColumnMappingLegacy = exports.CsvColumnDecorator = exports.parseAndValidateExcelData = exports.getExcelColumnMappingLegacy = exports.ExcelColumnDecorator = void 0;
+__exportStar(require("./file-upload.decorator"), exports);
+// Excel/CSV 列映射装饰器（字段级别）
+var excel_data_decorator_1 = require("./excel-data.decorator");
+Object.defineProperty(exports, "ExcelColumnDecorator", { enumerable: true, get: function () { return excel_data_decorator_1.ExcelColumn; } });
+Object.defineProperty(exports, "getExcelColumnMappingLegacy", { enumerable: true, get: function () { return excel_data_decorator_1.getExcelColumnMapping; } });
+Object.defineProperty(exports, "parseAndValidateExcelData", { enumerable: true, get: function () { return excel_data_decorator_1.parseAndValidateExcelData; } });
+var csv_data_decorator_1 = require("./csv-data.decorator");
+Object.defineProperty(exports, "CsvColumnDecorator", { enumerable: true, get: function () { return csv_data_decorator_1.CsvColumn; } });
+Object.defineProperty(exports, "getCsvColumnMappingLegacy", { enumerable: true, get: function () { return csv_data_decorator_1.getCsvColumnMapping; } });
+Object.defineProperty(exports, "parseAndValidateCsvData", { enumerable: true, get: function () { return csv_data_decorator_1.parseAndValidateCsvData; } });
+// 列装饰器和相关辅助函数（推荐使用）
+var column_decorator_1 = require("./column.decorator");
+Object.defineProperty(exports, "CSVColumn", { enumerable: true, get: function () { return column_decorator_1.CSVColumn; } });
+Object.defineProperty(exports, "ExcelColumn", { enumerable: true, get: function () { return column_decorator_1.ExcelColumn; } });
+Object.defineProperty(exports, "getCsvColumnMapping", { enumerable: true, get: function () { return column_decorator_1.getCsvColumnMapping; } });
+Object.defineProperty(exports, "getExcelColumnMapping", { enumerable: true, get: function () { return column_decorator_1.getExcelColumnMapping; } });
+Object.defineProperty(exports, "processRowWithMapping", { enumerable: true, get: function () { return column_decorator_1.processRowWithMapping; } });
+Object.defineProperty(exports, "excelColumnToNumber", { enumerable: true, get: function () { return column_decorator_1.excelColumnToNumber; } });
+Object.defineProperty(exports, "numberToExcelColumn", { enumerable: true, get: function () { return column_decorator_1.numberToExcelColumn; } });
+// NOTE: @ExcelDataParam 和 @CsvDataParam 参数装饰器已废弃并移除
+__exportStar(require("./process.decorator"), exports);

package/dist/file-upload/decorators/validate-data.decorator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 验证装饰器元数据键
+ */
+export declare const VALIDATE_DATA_KEY = "validate:data";
+/**
+ * 数据验证配置
+ */
+export interface ValidateDataOptions {
+    /** 验证类 */
+    validateClass?: any;
+    /** 是否验证数组 */
+    isArray?: boolean;
+    /** 验证组 */
+    groups?: string[];
+    /** 是否跳过缺失属性 */
+    skipMissingProperties?: boolean;
+    /** 是否跳过未装饰的属性 */
+    skipUndefinedProperties?: boolean;
+    /** 自定义验证器 */
+    customValidators?: Array<{
+        property: string;
+        validator: (value: any) => boolean | string;
+    }>;
+    /** 转换器 */
+    transformers?: Array<{
+        property: string;
+        transformer: (value: any) => any;
+    }>;
+    /** 错误处理策略 */
+    onError?: 'stop' | 'collect' | 'skip';
+    /** 是否启用自动类型转换 */
+    autoTransform?: boolean;
+}
+/**
+ * 数据验证装饰器
+ * 用于在控制器方法上启用数据验证
+ */
+export declare const ValidateData: (options?: ValidateDataOptions) => import("@nestjs/common").CustomDecorator<string>;
+/**
+ * 批量数据验证装饰器
+ * 用于验证数组数据
+ */
+export declare const ValidateArray: (validateClass: any, options?: Omit<ValidateDataOptions, "isArray" | "validateClass">) => import("@nestjs/common").CustomDecorator<string>;
+/**
+ * 自动验证转换装饰器
+ * 自动应用 class-transformer 的转换
+ */
+export declare const AutoTransform: (options?: {
+    excludeExtraneousValues?: boolean;
+}) => import("@nestjs/common").CustomDecorator<string>;
+/**
+ * Excel/CSV 行数据验证基类
+ * 使用 class-validator 定义验证规则
+ */
+export declare abstract class BaseRowData {
+    /**
+     * 验证行数据
+     * 子类应该使用 class-validator 装饰器定义验证规则
+     */
+    abstract validate(): Promise<string[]>;
+    /**
+     * 转换行数据
+     * 子类可以重写此方法进行数据转换
+     */
+    transform?(): Promise<void>;
+    /**
+     * 清理数据
+     * 子类可以重写此方法进行数据清理
+     */
+    clean?(): Promise<void>;
+}
+/**
+ * 验证结果
+ */
+export interface ValidationResult {
+    /** 是否通过验证 */
+    isValid: boolean;
+    /** 错误列表 */
+    errors: Array<{
+        row?: number;
+        field: string;
+        message: string;
+        value: any;
+        property: string;
+        constraints?: Record<string, string>;
+    }>;
+    /** 转换后的数据 */
+    data?: any;
+    /** 警告信息 */
+    warnings?: string[];
+}

package/dist/file-upload/decorators/validate-data.decorator.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRowData = exports.AutoTransform = exports.ValidateArray = exports.ValidateData = exports.VALIDATE_DATA_KEY = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 验证装饰器元数据键
+ */
+exports.VALIDATE_DATA_KEY = 'validate:data';
+/**
+ * 数据验证装饰器
+ * 用于在控制器方法上启用数据验证
+ */
+const ValidateData = (options = {}) => {
+    return (0, common_1.SetMetadata)(exports.VALIDATE_DATA_KEY, options);
+};
+exports.ValidateData = ValidateData;
+/**
+ * 批量数据验证装饰器
+ * 用于验证数组数据
+ */
+const ValidateArray = (validateClass, options = {}) => {
+    return (0, common_1.SetMetadata)(exports.VALIDATE_DATA_KEY, Object.assign(Object.assign({}, options), { validateClass, isArray: true }));
+};
+exports.ValidateArray = ValidateArray;
+/**
+ * 自动验证转换装饰器
+ * 自动应用 class-transformer 的转换
+ */
+const AutoTransform = (options = {}) => {
+    return (0, common_1.SetMetadata)('auto:transform', options);
+};
+exports.AutoTransform = AutoTransform;
+/**
+ * Excel/CSV 行数据验证基类
+ * 使用 class-validator 定义验证规则
+ */
+class BaseRowData {
+}
+exports.BaseRowData = BaseRowData;

package/{file-upload → dist/file-upload}/dto/update-file.dto.d.ts

@@ -12,5 +12,4 @@ export declare class UpdateFileDto {
     fileType?: string;
     extension?: string;
     validationData?: Record<string, unknown>;
-    processingData?: Record<string, unknown>;
 }

package/{file-upload → dist/file-upload}/dto/update-file.dto.js

@@ -65,7 +65,3 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", Object)
 ], UpdateFileDto.prototype, "validationData", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    __metadata("design:type", Object)
-], UpdateFileDto.prototype, "processingData", void 0);

package/{file-upload → dist/file-upload}/entities/file-metadata.entity.d.ts

@@ -6,17 +6,20 @@ export declare class FileMetadataEntity {
     id: string;
     fileId: string;
     key: string;
+    /**
+     * 元数据值（JSON 字符串）
+     * 支持存储任何 JSON 可序列化的数据
+     */
     value: string;
-    jsonData: any;
     isPublic: boolean;
     createdAt: Date;
     file: FileEntity;
     /**
-     * 获取值（优先返回JSON数据）
+     * 获取值（自动解析 JSON）
      */
     getValue<T = any>(): T;
     /**
-     * 设置值（同时保存到JSON和文本字段）
+     * 设置值（自动序列化为 JSON 字符串）
      */
     setValue(value: any): void;
 }

package/{file-upload → dist/file-upload}/entities/file-metadata.entity.js

@@ -18,12 +18,9 @@ const file_entity_1 = require("./file.entity");
 let FileMetadataEntity = class FileMetadataEntity {
     // ========== 便捷方法 ==========
     /**
-     * 获取值（优先返回JSON数据）
+     * 获取值（自动解析 JSON）
      */
     getValue() {
-        if (this.jsonData !== null && this.jsonData !== undefined) {
-            return this.jsonData;
-        }
         if (this.value) {
             try {
                 return JSON.parse(this.value);
@@ -35,10 +32,9 @@ let FileMetadataEntity = class FileMetadataEntity {
         return null;
     }
     /**
-     * 设置值（同时保存到JSON和文本字段）
+     * 设置值（自动序列化为 JSON 字符串）
      */
     setValue(value) {
-        this.jsonData = value;
         this.value = typeof value === 'string' ? value : JSON.stringify(value);
     }
 };
@@ -59,10 +55,6 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'text', nullable: true }),
     __metadata("design:type", String)
 ], FileMetadataEntity.prototype, "value", void 0);
-__decorate([
-    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
-    __metadata("design:type", Object)
-], FileMetadataEntity.prototype, "jsonData", void 0);
 __decorate([
     (0, typeorm_1.Column)({ default: false }),
     __metadata("design:type", Boolean)

package/{file-upload → dist/file-upload}/entities/file.entity.d.ts

@@ -21,6 +21,9 @@ export declare class FileEntity {
     tempPath: string;
     status: 'processing' | 'completed' | 'failed' | 'deleted';
     errorMessage: string;
+    /**
+     * 验证数据（文件签名检测、类型检测等）
+     */
     validationData: {
         detectedTypes: Array<{
             type: string;
@@ -34,16 +37,6 @@ export declare class FileEntity {
         }>;
         integrityChecks: string[];
     };
-    processingData: {
-        processors: Array<{
-            name: string;
-            startTime: Date;
-            endTime?: Date;
-            status: 'pending' | 'completed' | 'failed';
-            result?: any;
-            error?: string;
-        }>;
-    };
     createdAt: Date;
     updatedAt: Date;
     deletedAt: Date;
@@ -118,12 +111,4 @@ export declare class FileEntity {
      * 添加验证数据
      */
     addValidationData(data: Partial<FileEntity['validationData']>): void;
-    /**
-     * 添加处理步骤
-     */
-    addProcessingStep(processor: string): void;
-    /**
-     * 更新处理步骤
-     */
-    updateProcessingStep(processor: string, status: 'completed' | 'failed', result?: any, error?: string): void;
 }