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

package/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/file-upload/decorators/file-upload.decorator.d.ts

@@ -0,0 +1,83 @@
+import { FileUploadOptions } from '../interfaces/file-upload-options.interface';
+/**
+ * 文件上传装饰器元数据键
+ */
+export declare const FILE_UPLOAD_OPTIONS = "file_upload_options";
+/**
+ * 统一的文件上传装饰器
+ *
+ * @example
+ * ```typescript
+ * @Post('upload')
+ * @FileUpload({ types: [FileType.Image, FileType.PDF] })
+ * async upload(@UploadedFile() file: Express.Multer.File) {
+ *   return { url: file.path };
+ * }
+ * ```
+ */
+export declare function FileUpload(options?: FileUploadOptions): MethodDecorator;
+/**
+ * 静态快捷方法命名空间
+ */
+export declare namespace FileUpload {
+    /**
+     * 图片上传
+     * @example
+     * ```typescript
+     * @Post('photos')
+     * @FileUpload.Image()
+     * async uploadPhoto(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Image(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * 头像上传（带默认图片处理）
+     * @example
+     * ```typescript
+     * @Post('users/:id/avatar')
+     * @FileUpload.Avatar()
+     * async uploadAvatar(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Avatar(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * 文档上传
+     * @example
+     * ```typescript
+     * @Post('documents')
+     * @FileUpload.Document()
+     * async uploadDocument(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Document(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * PDF 上传
+     */
+    function PDF(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * Excel 上传
+     */
+    function Excel(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * CSV 上传
+     */
+    function CSV(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * 视频上传
+     */
+    function Video(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * 音频上传
+     */
+    function Audio(options?: Partial<FileUploadOptions>): MethodDecorator;
+    /**
+     * 公开访问的文件上传
+     */
+    function Public(options?: Partial<FileUploadOptions>): MethodDecorator;
+}

package/file-upload/decorators/file-upload.decorator.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_UPLOAD_OPTIONS = void 0;
+exports.FileUpload = FileUpload;
+const common_1 = require("@nestjs/common");
+const platform_express_1 = require("@nestjs/platform-express");
+const multer_1 = require("multer");
+const uuid_1 = require("uuid");
+const file_type_enum_1 = require("../enums/file-type.enum");
+const file_upload_interceptor_1 = require("../interceptors/file-upload.interceptor");
+const filename_util_1 = require("../utils/filename.util");
+const filepath_util_1 = require("../utils/filepath.util");
+/**
+ * 文件上传装饰器元数据键
+ */
+exports.FILE_UPLOAD_OPTIONS = 'file_upload_options';
+/**
+ * 统一的文件上传装饰器
+ *
+ * @example
+ * ```typescript
+ * @Post('upload')
+ * @FileUpload({ types: [FileType.Image, FileType.PDF] })
+ * async upload(@UploadedFile() file: Express.Multer.File) {
+ *   return { url: file.path };
+ * }
+ * ```
+ */
+function FileUpload(options = {}) {
+    const fieldName = options['fieldName'] || 'file';
+    // 配置磁盘存储
+    const storage = (0, multer_1.diskStorage)({
+        destination: (req, file, cb) => {
+            const fullPath = filepath_util_1.FilePathUtil.getFullUploadPath();
+            cb(null, fullPath);
+        },
+        filename: (req, file, cb) => {
+            // 解码 UTF-8 文件名
+            const decodedName = filename_util_1.FileNameUtil.decodeAndNormalize(file.originalname);
+            // 检查是否保留原始文件名
+            if (options.preserveOriginalName) {
+                // 保留原始文件名，但加上时间戳防止冲突
+                const ext = filename_util_1.FileNameUtil.extractExtension(decodedName);
+                const basename = filename_util_1.FileNameUtil.getBaseName(decodedName);
+                const sanitizedBasename = filename_util_1.FileNameUtil.sanitizeOriginal(basename);
+                const timestamp = Date.now();
+                const filename = `${sanitizedBasename}_${timestamp}${ext}`;
+                cb(null, filename);
+            }
+            else {
+                // 生成唯一文件名: uuid + 原始扩展名
+                const ext = filename_util_1.FileNameUtil.extractExtension(decodedName);
+                const uniqueName = `${(0, uuid_1.v4)()}${ext}`;
+                cb(null, uniqueName);
+            }
+        },
+    });
+    return (0, common_1.applyDecorators)(
+    // 设置元数据供 Interceptor 使用
+    (0, common_1.SetMetadata)(exports.FILE_UPLOAD_OPTIONS, options), 
+    // 应用文件拦截器（使用磁盘存储）- 上传文件到磁盘
+    (0, common_1.UseInterceptors)((0, platform_express_1.FileInterceptor)(fieldName, {
+        storage,
+        // 在 Multer 层面限制文件大小，防止大文件攻击
+        limits: {
+            fileSize: options.maxSize || 10 * 1024 * 1024, // 默认 10MB
+            // 限制文件名长度
+            fieldNameSize: 100,
+            // 限制文件字段数量
+            files: 1,
+        },
+    })), 
+    // 应用文件上传拦截器 - 在文件上传后进行所有验证（类型、签名、恶意检测等）
+    (0, common_1.UseInterceptors)(file_upload_interceptor_1.FileUploadInterceptor));
+}
+/**
+ * 静态快捷方法命名空间
+ */
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (FileUpload) {
+    /**
+     * 图片上传
+     * @example
+     * ```typescript
+     * @Post('photos')
+     * @FileUpload.Image()
+     * async uploadPhoto(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Image(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Image], maxSize: 10 * 1024 * 1024 }, options));
+    }
+    FileUpload.Image = Image;
+    /**
+     * 头像上传（带默认图片处理）
+     * @example
+     * ```typescript
+     * @Post('users/:id/avatar')
+     * @FileUpload.Avatar()
+     * async uploadAvatar(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Avatar(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Image], maxSize: 5 * 1024 * 1024, auth: true, image: {
+                resize: { width: 200, height: 200, fit: 'cover' },
+                quality: 85,
+                format: 'jpeg',
+            } }, options));
+    }
+    FileUpload.Avatar = Avatar;
+    /**
+     * 文档上传
+     * @example
+     * ```typescript
+     * @Post('documents')
+     * @FileUpload.Document()
+     * async uploadDocument(@UploadedFile() file: Express.Multer.File) {
+     *   return { url: file.path };
+     * }
+     * ```
+     */
+    function Document(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Document], maxSize: 50 * 1024 * 1024 }, options));
+    }
+    FileUpload.Document = Document;
+    /**
+     * PDF 上传
+     */
+    function PDF(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.PDF], maxSize: 50 * 1024 * 1024 }, options));
+    }
+    FileUpload.PDF = PDF;
+    /**
+     * Excel 上传
+     */
+    function Excel(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Excel], maxSize: 20 * 1024 * 1024 }, options));
+    }
+    FileUpload.Excel = Excel;
+    /**
+     * CSV 上传
+     */
+    function CSV(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.CSV], maxSize: 20 * 1024 * 1024 }, options));
+    }
+    FileUpload.CSV = CSV;
+    /**
+     * 视频上传
+     */
+    function Video(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Video], maxSize: 500 * 1024 * 1024 }, options));
+    }
+    FileUpload.Video = Video;
+    /**
+     * 音频上传
+     */
+    function Audio(options = {}) {
+        return FileUpload(Object.assign({ types: [file_type_enum_1.FileType.Audio], maxSize: 100 * 1024 * 1024 }, options));
+    }
+    FileUpload.Audio = Audio;
+    /**
+     * 公开访问的文件上传
+     */
+    function Public(options = {}) {
+        return FileUpload(Object.assign({ public: true, auth: false }, options));
+    }
+    FileUpload.Public = Public;
+})(FileUpload || (exports.FileUpload = FileUpload = {}));

package/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/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/file-upload/decorators/process.decorator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 处理器结果参数装饰器
+ * 用于获取在装饰器中配置的处理器执行结果
+ *
+ * @example
+ * ```typescript
+ * @Post('upload/pdf')
+ * @FileUpload({
+ *   types: [FileType.PDF],
+ *   processor: 'pdf-text'
+ * })
+ * async uploadPdf(
+ *   @UploadedFile() file: Express.Multer.File,
+ *   @ProcessResult() result: { text: string; pageCount: number }
+ * ) {
+ *   return { url: file.path, text: result.text };
+ * }
+ * ```
+ */
+export declare const ProcessResult: (...dataOrPipes: unknown[]) => ParameterDecorator;
+/**
+ * 自定义处理器参数装饰器
+ * 用于在参数级别指定处理器并获取结果
+ *
+ * @example
+ * ```typescript
+ * @Post('upload/pdf')
+ * @FileUpload({ types: [FileType.PDF] })
+ * async uploadPdf(
+ *   @UploadedFile() file: Express.Multer.File,
+ *   @Process('pdf-text', { extractImages: true }) result: any
+ * ) {
+ *   return { url: file.path, text: result.text };
+ * }
+ * ```
+ */
+export declare const Process: (...dataOrPipes: (import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>> | {
+    name: string;
+    options?: any;
+})[]) => ParameterDecorator;

package/file-upload/decorators/process.decorator.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Process = exports.ProcessResult = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 处理器结果参数装饰器
+ * 用于获取在装饰器中配置的处理器执行结果
+ *
+ * @example
+ * ```typescript
+ * @Post('upload/pdf')
+ * @FileUpload({
+ *   types: [FileType.PDF],
+ *   processor: 'pdf-text'
+ * })
+ * async uploadPdf(
+ *   @UploadedFile() file: Express.Multer.File,
+ *   @ProcessResult() result: { text: string; pageCount: number }
+ * ) {
+ *   return { url: file.path, text: result.text };
+ * }
+ * ```
+ */
+exports.ProcessResult = (0, common_1.createParamDecorator)((data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return request._processResult;
+});
+/**
+ * 自定义处理器参数装饰器
+ * 用于在参数级别指定处理器并获取结果
+ *
+ * @example
+ * ```typescript
+ * @Post('upload/pdf')
+ * @FileUpload({ types: [FileType.PDF] })
+ * async uploadPdf(
+ *   @UploadedFile() file: Express.Multer.File,
+ *   @Process('pdf-text', { extractImages: true }) result: any
+ * ) {
+ *   return { url: file.path, text: result.text };
+ * }
+ * ```
+ */
+exports.Process = (0, common_1.createParamDecorator)((data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    // 在 interceptor 中处理
+    request._processParams = {
+        name: (data === null || data === void 0 ? void 0 : data['name']) || data,
+        options: data === null || data === void 0 ? void 0 : data['options'],
+    };
+    return request._processResult;
+});

package/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/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/dto/create-file.dto.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 创建文件DTO
+ */
+export declare class CreateFileDto {
+    originalName: string;
+    filename: string;
+    mimeType: string;
+    fileType?: string;
+    extension?: string;
+    size: number;
+    checksum?: string;
+    path?: string;
+    url?: string;
+    storageProvider?: string;
+    userId?: string;
+    uploadId?: string;
+    bucket?: string;
+    key?: string;
+    etag?: string;
+    tempPath?: string;
+    status?: 'processing' | 'completed' | 'failed' | 'deleted';
+    validationData?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}