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

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

@@ -0,0 +1,350 @@
+"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);
+};
+var FileEntity_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileEntity = void 0;
+const typeorm_1 = require("typeorm");
+const class_transformer_1 = require("class-transformer");
+const filepath_util_1 = require("../utils/filepath.util");
+const filename_util_1 = require("../utils/filename.util");
+/**
+ * 文件实体
+ */
+let FileEntity = FileEntity_1 = class FileEntity {
+    // ========== 便捷方法 ==========
+    /**
+     * 是否为图片
+     */
+    get isImage() {
+        return this.mimeType.startsWith('image/');
+    }
+    /**
+     * 是否为文档
+     */
+    get isDocument() {
+        return (this.mimeType.includes('pdf') ||
+            this.mimeType.includes('word') ||
+            this.mimeType.includes('excel') ||
+            this.mimeType.includes('powerpoint') ||
+            this.mimeType.includes('document') ||
+            this.mimeType.includes('spreadsheet') ||
+            this.mimeType.includes('presentation'));
+    }
+    /**
+     * 是否为视频
+     */
+    get isVideo() {
+        return this.mimeType.startsWith('video/');
+    }
+    /**
+     * 是否为音频
+     */
+    get isAudio() {
+        return this.mimeType.startsWith('audio/');
+    }
+    /**
+     * 是否为CAD文件
+     */
+    get isCAD() {
+        return (this.fileType === 'cad' ||
+            this.mimeType.includes('acad') ||
+            this.mimeType.includes('dwg') ||
+            this.mimeType.includes('dxf') ||
+            this.mimeType.includes('dwf') ||
+            this.mimeType.includes('step') ||
+            this.mimeType.includes('iges'));
+    }
+    /**
+     * 是否为压缩文件
+     */
+    get isArchive() {
+        return (this.fileType === 'archive' ||
+            this.mimeType.includes('zip') ||
+            this.mimeType.includes('rar') ||
+            this.mimeType.includes('gzip') ||
+            this.mimeType.includes('tar') ||
+            this.mimeType.includes('7z'));
+    }
+    /**
+     * 获取人类可读的文件大小
+     */
+    get humanSize() {
+        const bytes = Number(this.size);
+        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+        if (bytes === 0)
+            return '0 Bytes';
+        const i = Math.floor(Math.log(bytes) / Math.log(1024));
+        return Math.round((bytes / Math.pow(1024, i)) * 100) / 100 + ' ' + sizes[i];
+    }
+    /**
+     * 静态方法: 从文件名提取扩展名（使用统一工具类）
+     */
+    static extractExtension(filename) {
+        return filename_util_1.FileNameUtil.extractExtension(filename);
+    }
+    /**
+     * 静态方法: 根据 MIME 类型和扩展名识别文件类型
+     */
+    static detectFileType(mimeType, extension) {
+        // 图片
+        if (mimeType.startsWith('image/')) {
+            return 'image';
+        }
+        // 视频
+        if (mimeType.startsWith('video/')) {
+            return 'video';
+        }
+        // 音频
+        if (mimeType.startsWith('audio/')) {
+            return 'audio';
+        }
+        // CAD 文件
+        if (mimeType.includes('acad') ||
+            mimeType.includes('dwg') ||
+            mimeType.includes('dxf') ||
+            mimeType.includes('dwf') ||
+            mimeType.includes('step') ||
+            mimeType.includes('iges') ||
+            ['.dwg', '.dxf', '.dwf', '.step', '.stp', '.iges', '.igs'].includes(extension.toLowerCase())) {
+            return 'cad';
+        }
+        // 压缩文件
+        if (mimeType.includes('zip') ||
+            mimeType.includes('rar') ||
+            mimeType.includes('gzip') ||
+            mimeType.includes('tar') ||
+            mimeType.includes('7z') ||
+            ['.zip', '.rar', '.gz', '.tar', '.7z'].includes(extension.toLowerCase())) {
+            return 'archive';
+        }
+        // 文档
+        if (mimeType.includes('pdf') ||
+            mimeType.includes('word') ||
+            mimeType.includes('excel') ||
+            mimeType.includes('powerpoint') ||
+            mimeType.includes('document') ||
+            mimeType.includes('spreadsheet') ||
+            mimeType.includes('presentation') ||
+            mimeType.includes('msword') ||
+            mimeType.includes('ms-excel') ||
+            mimeType === 'text/plain' ||
+            mimeType === 'text/csv') {
+            return 'document';
+        }
+        // 默认为 other
+        return 'other';
+    }
+    // ========== 业务方法 ==========
+    /**
+     * 生成访问 URL
+     * 注意：不再使用 getter，改为方法以接收 baseUrl 参数
+     * 建议使用 FileService.getFileUrl() 代替
+     *
+     * @param baseUrl 基础 URL（可选）
+     * @returns 文件访问 URL
+     * @deprecated 请使用 FileService.getFileUrl()
+     */
+    generateUrl(baseUrl) {
+        if (!this.path)
+            return null;
+        switch (this.storageProvider) {
+            case 's3':
+            case 'oss':
+            case 'minio':
+            case 'cdn':
+                // 对象存储返回相对路径，由调用方拼接完整 URL
+                return this.path;
+            case 'local':
+            default:
+                // 本地文件通过 API 访问
+                const apiBase = baseUrl || '';
+                return apiBase ? `${apiBase}/files/${this.id}` : `/files/${this.id}`;
+        }
+    }
+    /**
+     * 获取完整的物理路径（服务器端使用）
+     * 仅用于服务器端访问文件系统
+     */
+    getPhysicalPath() {
+        return filepath_util_1.FilePathUtil.getPhysicalPath(this.path, this.storageProvider);
+    }
+    /**
+     * 自动识别并设置文件类型和扩展名
+     */
+    detectAndSetFileType() {
+        // 如果 extension没有设置，从 originalName 提取
+        if (!this.extension && this.originalName) {
+            this.extension = FileEntity_1.extractExtension(this.originalName);
+        }
+        this.fileType = FileEntity_1.detectFileType(this.mimeType, this.extension || '');
+    }
+    /**
+     * 标记为已完成
+     */
+    markAsCompleted(metadata) {
+        this.status = 'completed';
+        this.tempPath = null;
+        this.errorMessage = null;
+        if (metadata) {
+            this.metadata = Object.assign(Object.assign({}, this.metadata), metadata);
+        }
+    }
+    /**
+     * 标记为失败
+     */
+    markAsFailed(error) {
+        this.status = 'failed';
+        this.errorMessage = error;
+    }
+    /**
+     * 标记为已删除
+     */
+    markAsDeleted() {
+        this.status = 'deleted';
+    }
+    /**
+     * 添加验证数据
+     */
+    addValidationData(data) {
+        if (!this.validationData) {
+            this.validationData = {
+                detectedTypes: [],
+                signatures: [],
+                integrityChecks: [],
+            };
+        }
+        this.validationData = Object.assign(Object.assign({}, this.validationData), data);
+    }
+};
+exports.FileEntity = FileEntity;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], FileEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 500 }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "originalName", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255, nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "filename", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 100 }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "mimeType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        length: 50,
+        nullable: true,
+        comment: '文件类型: image, video, audio, document, cad, archive 等',
+    }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "fileType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        length: 20,
+        nullable: true,
+        comment: '文件后缀名: .jpg, .pdf, .dwg 等',
+    }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "extension", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'bigint', default: 0 }),
+    __metadata("design:type", Number)
+], FileEntity.prototype, "size", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64, nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "checksum", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        nullable: true,
+        type: 'text',
+        comment: '相对路径（相对于存储根目录）',
+    }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "path", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        length: 50,
+        default: 'local',
+        comment: '存储提供商: local, s3, cdn, oss 等',
+    }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "storageProvider", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], FileEntity.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255, nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "bucket", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 500, nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "key", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64, nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "etag", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "uploadId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, type: 'text' }),
+    (0, class_transformer_1.Exclude)(),
+    __metadata("design:type", String)
+], FileEntity.prototype, "tempPath", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'varchar',
+        length: 50,
+        default: 'processing',
+    }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], FileEntity.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], FileEntity.prototype, "validationData", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], FileEntity.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    __metadata("design:type", Date)
+], FileEntity.prototype, "updatedAt", void 0);
+__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    __metadata("design:type", Date)
+], FileEntity.prototype, "deletedAt", void 0);
+exports.FileEntity = FileEntity = FileEntity_1 = __decorate([
+    (0, typeorm_1.Entity)('files'),
+    (0, typeorm_1.Index)(['userId']),
+    (0, typeorm_1.Index)(['uploadId']),
+    (0, typeorm_1.Index)(['status']),
+    (0, typeorm_1.Index)(['fileType']),
+    (0, typeorm_1.Index)(['extension']),
+    (0, typeorm_1.Index)(['storageProvider']),
+    (0, typeorm_1.Index)(['createdAt'])
+], FileEntity);

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

@@ -0,0 +1,2 @@
+export * from './file.entity';
+export * from './file-metadata.entity';

package/file-upload/entities/index.js

@@ -0,0 +1,18 @@
+"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("./file.entity"), exports);
+__exportStar(require("./file-metadata.entity"), exports);

package/file-upload/enums/file-type.enum.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 文件类型枚举
+ * 提供类型安全的文件类型定义
+ */
+export declare enum FileType {
+    Image = "image",
+    JPEG = "image/jpeg",
+    PNG = "image/png",
+    GIF = "image/gif",
+    WEBP = "image/webp",
+    SVG = "image/svg+xml",
+    BMP = "image/bmp",
+    ICO = "image/x-icon",
+    Document = "document",
+    PDF = "application/pdf",
+    Word = "word",
+    Excel = "excel",
+    CSV = "text/csv",
+    Text = "text/plain",
+    RTF = "application/rtf",
+    Archive = "archive",
+    ZIP = "application/zip",
+    RAR = "application/x-rar-compressed",
+    GZIP = "application/gzip",
+    TAR = "application/x-tar",
+    SEVEN_ZIP = "application/x-7z-compressed",
+    Video = "video",
+    Audio = "audio",
+    MP4 = "video/mp4",
+    MP3 = "audio/mpeg",
+    WAV = "audio/wav",
+    AVI = "video/x-msvideo",
+    MOV = "video/quicktime",
+    WMV = "video/x-ms-wmv",
+    CAD = "cad",
+    DWG = "application/acad",
+    DXF = "application/dxf",
+    DWF = "application/dwf",
+    STEP = "application/step",
+    IGES = "application/iges",
+    JSON = "application/json",
+    XML = "application/xml",
+    HTML = "text/html",
+    JavaScript = "application/javascript",
+    TypeScript = "application/typescript"
+}
+/**
+ * 文件类型到 MIME 类型和扩展名的映射
+ */
+export declare const FILE_TYPE_MAP: Record<string, {
+    mimes: string[];
+    exts: string[];
+}>;
+/**
+ * 文件类型组合预设
+ */
+export declare const FileTypePresets: {
+    /** 办公文档: Word + Excel + PDF */
+    Office: FileType[];
+    /** 媒体文件: Image + Video + Audio */
+    Media: FileType[];
+    /** 数据文件: Excel + CSV + JSON */
+    Data: FileType[];
+    /** 文本文件: Text + CSV + JSON + XML */
+    Text: FileType[];
+    /** 所有文档: PDF + Word + Excel + Text */
+    AllDocuments: FileType[];
+    /** 图片文件: JPEG + PNG + GIF + WEBP */
+    Images: FileType[];
+    /** 压缩文件: ZIP + RAR + GZIP + TAR */
+    Archives: FileType[];
+};

package/file-upload/enums/file-type.enum.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileTypePresets = exports.FILE_TYPE_MAP = exports.FileType = void 0;
+/**
+ * 文件类型枚举
+ * 提供类型安全的文件类型定义
+ */
+var FileType;
+(function (FileType) {
+    // === 图片类型 ===
+    FileType["Image"] = "image";
+    FileType["JPEG"] = "image/jpeg";
+    FileType["PNG"] = "image/png";
+    FileType["GIF"] = "image/gif";
+    FileType["WEBP"] = "image/webp";
+    FileType["SVG"] = "image/svg+xml";
+    FileType["BMP"] = "image/bmp";
+    FileType["ICO"] = "image/x-icon";
+    // === 文档类型 ===
+    FileType["Document"] = "document";
+    FileType["PDF"] = "application/pdf";
+    FileType["Word"] = "word";
+    FileType["Excel"] = "excel";
+    FileType["CSV"] = "text/csv";
+    FileType["Text"] = "text/plain";
+    FileType["RTF"] = "application/rtf";
+    // === 压缩文件 ===
+    FileType["Archive"] = "archive";
+    FileType["ZIP"] = "application/zip";
+    FileType["RAR"] = "application/x-rar-compressed";
+    FileType["GZIP"] = "application/gzip";
+    FileType["TAR"] = "application/x-tar";
+    FileType["SEVEN_ZIP"] = "application/x-7z-compressed";
+    // === 音视频 ===
+    FileType["Video"] = "video";
+    FileType["Audio"] = "audio";
+    FileType["MP4"] = "video/mp4";
+    FileType["MP3"] = "audio/mpeg";
+    FileType["WAV"] = "audio/wav";
+    FileType["AVI"] = "video/x-msvideo";
+    FileType["MOV"] = "video/quicktime";
+    FileType["WMV"] = "video/x-ms-wmv";
+    // === CAD 文件 ===
+    FileType["CAD"] = "cad";
+    FileType["DWG"] = "application/acad";
+    FileType["DXF"] = "application/dxf";
+    FileType["DWF"] = "application/dwf";
+    FileType["STEP"] = "application/step";
+    FileType["IGES"] = "application/iges";
+    // === 其他 ===
+    FileType["JSON"] = "application/json";
+    FileType["XML"] = "application/xml";
+    FileType["HTML"] = "text/html";
+    FileType["JavaScript"] = "application/javascript";
+    FileType["TypeScript"] = "application/typescript";
+})(FileType || (exports.FileType = FileType = {}));
+/**
+ * 文件类型到 MIME 类型和扩展名的映射
+ */
+exports.FILE_TYPE_MAP = {
+    [FileType.Image]: {
+        mimes: ['image/*'],
+        exts: ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.bmp', '.ico'],
+    },
+    [FileType.JPEG]: {
+        mimes: ['image/jpeg'],
+        exts: ['.jpg', '.jpeg'],
+    },
+    [FileType.PNG]: {
+        mimes: ['image/png'],
+        exts: ['.png'],
+    },
+    [FileType.GIF]: {
+        mimes: ['image/gif'],
+        exts: ['.gif'],
+    },
+    [FileType.WEBP]: {
+        mimes: ['image/webp'],
+        exts: ['.webp'],
+    },
+    [FileType.SVG]: {
+        mimes: ['image/svg+xml'],
+        exts: ['.svg'],
+    },
+    [FileType.Document]: {
+        mimes: [
+            'application/pdf',
+            'application/msword',
+            'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            'application/vnd.ms-excel',
+            'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            'text/plain',
+            'text/csv',
+        ],
+        exts: ['.pdf', '.doc', '.docx', '.xls', '.xlsx', '.txt', '.csv'],
+    },
+    [FileType.PDF]: {
+        mimes: ['application/pdf'],
+        exts: ['.pdf'],
+    },
+    [FileType.Word]: {
+        mimes: [
+            'application/msword',
+            'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        ],
+        exts: ['.doc', '.docx'],
+    },
+    [FileType.Excel]: {
+        mimes: [
+            'application/vnd.ms-excel',
+            'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        ],
+        exts: ['.xls', '.xlsx'],
+    },
+    [FileType.CSV]: {
+        mimes: ['text/csv'],
+        exts: ['.csv'],
+    },
+    [FileType.Text]: {
+        mimes: ['text/plain'],
+        exts: ['.txt'],
+    },
+    [FileType.Archive]: {
+        mimes: [
+            'application/zip',
+            'application/x-rar-compressed',
+            'application/gzip',
+            'application/x-tar',
+            'application/x-7z-compressed',
+        ],
+        exts: ['.zip', '.rar', '.gz', '.tar', '.7z'],
+    },
+    [FileType.ZIP]: {
+        mimes: ['application/zip'],
+        exts: ['.zip'],
+    },
+    [FileType.RAR]: {
+        mimes: ['application/x-rar-compressed'],
+        exts: ['.rar'],
+    },
+    [FileType.Video]: {
+        mimes: ['video/*'],
+        exts: ['.mp4', '.avi', '.mov', '.wmv', '.flv', '.mkv'],
+    },
+    [FileType.Audio]: {
+        mimes: ['audio/*'],
+        exts: ['.mp3', '.wav', '.ogg', '.flac', '.aac'],
+    },
+    [FileType.MP4]: {
+        mimes: ['video/mp4'],
+        exts: ['.mp4'],
+    },
+    [FileType.MP3]: {
+        mimes: ['audio/mpeg'],
+        exts: ['.mp3'],
+    },
+    [FileType.CAD]: {
+        mimes: [
+            'application/acad',
+            'application/x-acad',
+            'application/autocad_dwg',
+            'image/vnd.dwg',
+            'image/vnd.dxf',
+            'application/dxf',
+            'application/x-dxf',
+            'application/dwf',
+            'application/step',
+            'application/iges',
+        ],
+        exts: ['.dwg', '.dxf', '.dwf', '.step', '.stp', '.iges', '.igs'],
+    },
+    [FileType.DWG]: {
+        mimes: [
+            'application/acad',
+            'application/x-acad',
+            'application/autocad_dwg',
+            'image/vnd.dwg',
+        ],
+        exts: ['.dwg'],
+    },
+    [FileType.DXF]: {
+        mimes: ['image/vnd.dxf', 'application/dxf', 'application/x-dxf'],
+        exts: ['.dxf'],
+    },
+    [FileType.JSON]: {
+        mimes: ['application/json'],
+        exts: ['.json'],
+    },
+    [FileType.XML]: {
+        mimes: ['application/xml', 'text/xml'],
+        exts: ['.xml'],
+    },
+};
+/**
+ * 文件类型组合预设
+ */
+exports.FileTypePresets = {
+    /** 办公文档: Word + Excel + PDF */
+    Office: [FileType.Word, FileType.Excel, FileType.PDF],
+    /** 媒体文件: Image + Video + Audio */
+    Media: [FileType.Image, FileType.Video, FileType.Audio],
+    /** 数据文件: Excel + CSV + JSON */
+    Data: [FileType.Excel, FileType.CSV, FileType.JSON],
+    /** 文本文件: Text + CSV + JSON + XML */
+    Text: [FileType.Text, FileType.CSV, FileType.JSON, FileType.XML],
+    /** 所有文档: PDF + Word + Excel + Text */
+    AllDocuments: [FileType.PDF, FileType.Word, FileType.Excel, FileType.Text],
+    /** 图片文件: JPEG + PNG + GIF + WEBP */
+    Images: [FileType.JPEG, FileType.PNG, FileType.GIF, FileType.WEBP],
+    /** 压缩文件: ZIP + RAR + GZIP + TAR */
+    Archives: [FileType.ZIP, FileType.RAR, FileType.GZIP, FileType.TAR],
+};