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

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

@@ -0,0 +1,16 @@
+/**
+ * 更新文件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>;
+    processingData?: Record<string, unknown>;
+}

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

@@ -0,0 +1,71 @@
+"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);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], UpdateFileDto.prototype, "processingData", void 0);

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

@@ -0,0 +1,22 @@
+import { FileEntity } from './file.entity';
+/**
+ * 文件元数据实体
+ */
+export declare class FileMetadataEntity {
+    id: string;
+    fileId: string;
+    key: string;
+    value: string;
+    jsonData: any;
+    isPublic: boolean;
+    createdAt: Date;
+    file: FileEntity;
+    /**
+     * 获取值（优先返回JSON数据）
+     */
+    getValue<T = any>(): T;
+    /**
+     * 设置值（同时保存到JSON和文本字段）
+     */
+    setValue(value: any): void;
+}

package/file-upload/entities/file-metadata.entity.js

@@ -0,0 +1,84 @@
+"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.FileMetadataEntity = void 0;
+const typeorm_1 = require("typeorm");
+const file_entity_1 = require("./file.entity");
+/**
+ * 文件元数据实体
+ */
+let FileMetadataEntity = class FileMetadataEntity {
+    // ========== 便捷方法 ==========
+    /**
+     * 获取值（优先返回JSON数据）
+     */
+    getValue() {
+        if (this.jsonData !== null && this.jsonData !== undefined) {
+            return this.jsonData;
+        }
+        if (this.value) {
+            try {
+                return JSON.parse(this.value);
+            }
+            catch (_a) {
+                return this.value;
+            }
+        }
+        return null;
+    }
+    /**
+     * 设置值（同时保存到JSON和文本字段）
+     */
+    setValue(value) {
+        this.jsonData = value;
+        this.value = typeof value === 'string' ? value : JSON.stringify(value);
+    }
+};
+exports.FileMetadataEntity = FileMetadataEntity;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 36 }),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "fileId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 100 }),
+    __metadata("design:type", String)
+], FileMetadataEntity.prototype, "key", void 0);
+__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)
+], FileMetadataEntity.prototype, "isPublic", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], FileMetadataEntity.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => file_entity_1.FileEntity, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'fileId' }),
+    __metadata("design:type", file_entity_1.FileEntity)
+], FileMetadataEntity.prototype, "file", void 0);
+exports.FileMetadataEntity = FileMetadataEntity = __decorate([
+    (0, typeorm_1.Entity)('file_metadata'),
+    (0, typeorm_1.Index)(['fileId']),
+    (0, typeorm_1.Index)(['key']),
+    (0, typeorm_1.Index)(['fileId', 'key'], { unique: true })
+], FileMetadataEntity);

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

@@ -0,0 +1,129 @@
+/**
+ * 文件实体
+ */
+export declare class FileEntity {
+    id: string;
+    originalName: string;
+    filename: string;
+    mimeType: string;
+    fileType: string;
+    extension: string;
+    size: number;
+    checksum: string;
+    path: string;
+    storageProvider: string;
+    metadata: Record<string, any>;
+    bucket: string;
+    key: string;
+    etag: string;
+    userId: string;
+    uploadId: string;
+    tempPath: string;
+    status: 'processing' | 'completed' | 'failed' | 'deleted';
+    errorMessage: string;
+    validationData: {
+        detectedTypes: Array<{
+            type: string;
+            confidence: number;
+            isCustom: boolean;
+        }>;
+        signatures: Array<{
+            type: string;
+            bytes: number[];
+            offset: number;
+        }>;
+        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;
+    /**
+     * 是否为图片
+     */
+    get isImage(): boolean;
+    /**
+     * 是否为文档
+     */
+    get isDocument(): boolean;
+    /**
+     * 是否为视频
+     */
+    get isVideo(): boolean;
+    /**
+     * 是否为音频
+     */
+    get isAudio(): boolean;
+    /**
+     * 是否为CAD文件
+     */
+    get isCAD(): boolean;
+    /**
+     * 是否为压缩文件
+     */
+    get isArchive(): boolean;
+    /**
+     * 获取人类可读的文件大小
+     */
+    get humanSize(): string;
+    /**
+     * 静态方法: 从文件名提取扩展名（使用统一工具类）
+     */
+    static extractExtension(filename: string): string;
+    /**
+     * 静态方法: 根据 MIME 类型和扩展名识别文件类型
+     */
+    static detectFileType(mimeType: string, extension: string): string;
+    /**
+     * 生成访问 URL
+     * 注意：不再使用 getter，改为方法以接收 baseUrl 参数
+     * 建议使用 FileService.getFileUrl() 代替
+     *
+     * @param baseUrl 基础 URL（可选）
+     * @returns 文件访问 URL
+     * @deprecated 请使用 FileService.getFileUrl()
+     */
+    generateUrl(baseUrl?: string): string;
+    /**
+     * 获取完整的物理路径（服务器端使用）
+     * 仅用于服务器端访问文件系统
+     */
+    getPhysicalPath(): string;
+    /**
+     * 自动识别并设置文件类型和扩展名
+     */
+    detectAndSetFileType(): void;
+    /**
+     * 标记为已完成
+     */
+    markAsCompleted(metadata?: any): void;
+    /**
+     * 标记为失败
+     */
+    markAsFailed(error: string): void;
+    /**
+     * 标记为已删除
+     */
+    markAsDeleted(): void;
+    /**
+     * 添加验证数据
+     */
+    addValidationData(data: Partial<FileEntity['validationData']>): void;
+    /**
+     * 添加处理步骤
+     */
+    addProcessingStep(processor: string): void;
+    /**
+     * 更新处理步骤
+     */
+    updateProcessingStep(processor: string, status: 'completed' | 'failed', result?: any, error?: string): void;
+}