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

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

package/file-upload/dto/create-file.dto.js

@@ -0,0 +1,112 @@
+"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.CreateFileDto = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * 创建文件DTO
+ */
+class CreateFileDto {
+}
+exports.CreateFileDto = CreateFileDto;
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "originalName", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "filename", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "mimeType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "fileType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "extension", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], CreateFileDto.prototype, "size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "checksum", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "url", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "storageProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "userId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "uploadId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "bucket", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "etag", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "tempPath", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['processing', 'completed', 'failed', 'deleted']),
+    __metadata("design:type", String)
+], CreateFileDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], CreateFileDto.prototype, "validationData", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], CreateFileDto.prototype, "metadata", void 0);

package/file-upload/dto/find-files.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 查找文件DTO
+ */
+export declare class FindFilesDto {
+    userId?: string;
+    mimeType?: string[];
+    uploadId?: string;
+    status?: string;
+    storageProvider?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    search?: string;
+    orderBy?: string;
+    orderDirection?: 'ASC' | 'DESC';
+}

package/file-upload/dto/find-files.dto.js

@@ -0,0 +1,76 @@
+"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.FindFilesDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 查找文件DTO
+ */
+class FindFilesDto {
+    constructor() {
+        this.orderBy = 'createdAt';
+        this.orderDirection = 'DESC';
+    }
+}
+exports.FindFilesDto = FindFilesDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "userId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? (Array.isArray(value) ? value : [value]) : undefined),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], FindFilesDto.prototype, "mimeType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "uploadId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['processing', 'completed', 'failed', 'deleted']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "storageProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "dateFrom", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "dateTo", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "search", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['createdAt', 'updatedAt', 'originalName', 'size']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "orderBy", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(['ASC', 'DESC']),
+    __metadata("design:type", String)
+], FindFilesDto.prototype, "orderDirection", void 0);

package/file-upload/dto/index.d.ts

@@ -0,0 +1,4 @@
+export * from './create-file.dto';
+export * from './update-file.dto';
+export * from './find-files.dto';
+export * from './pagination.dto';

package/file-upload/dto/index.js

@@ -0,0 +1,20 @@
+"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 });
+__exportStar(require("./create-file.dto"), exports);
+__exportStar(require("./update-file.dto"), exports);
+__exportStar(require("./find-files.dto"), exports);
+__exportStar(require("./pagination.dto"), exports);

package/file-upload/dto/pagination.dto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 分页DTO
+ */
+export declare class PaginationDto {
+    page?: number;
+    limit?: number;
+}

package/file-upload/dto/pagination.dto.js

@@ -0,0 +1,39 @@
+"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.PaginationDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+/**
+ * 分页DTO
+ */
+class PaginationDto {
+    constructor() {
+        this.page = 1;
+        this.limit = 20;
+    }
+}
+exports.PaginationDto = PaginationDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => parseInt(value, 10) || 1),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => Math.min(parseInt(value, 10) || 20, 100)),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "limit", void 0);

package/file-upload/dto/update-file.dto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 更新文件DTO
+ */
+export declare class UpdateFileDto {
+    originalName?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+    path?: string;
+    checksum?: string;
+    status?: 'processing' | 'completed' | 'failed' | 'deleted';
+    errorMessage?: string;
+    fileType?: string;
+    extension?: string;
+    validationData?: Record<string, unknown>;
+}

package/file-upload/dto/update-file.dto.js

@@ -0,0 +1,67 @@
+"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.UpdateFileDto = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * 更新文件DTO
+ */
+class UpdateFileDto {
+}
+exports.UpdateFileDto = UpdateFileDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "originalName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "filename", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], UpdateFileDto.prototype, "metadata", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "checksum", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "errorMessage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "fileType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateFileDto.prototype, "extension", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], UpdateFileDto.prototype, "validationData", void 0);

package/file-upload/entities/file-metadata.entity.d.ts

@@ -0,0 +1,25 @@
+import { FileEntity } from './file.entity';
+/**
+ * 文件元数据实体
+ */
+export declare class FileMetadataEntity {
+    id: string;
+    fileId: string;
+    key: string;
+    /**
+     * 元数据值（JSON 字符串）
+     * 支持存储任何 JSON 可序列化的数据
+     */
+    value: string;
+    isPublic: boolean;
+    createdAt: Date;
+    file: FileEntity;
+    /**
+     * 获取值（自动解析 JSON）
+     */
+    getValue<T = any>(): T;
+    /**
+     * 设置值（自动序列化为 JSON 字符串）
+     */
+    setValue(value: any): void;
+}