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

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

package/file-upload/exceptions/file-upload.exception.d.ts

@@ -0,0 +1,57 @@
+import { HttpException, HttpStatus } from '@nestjs/common';
+/**
+ * 文件上传基础异常类
+ */
+export declare class FileUploadException extends HttpException {
+    readonly code: string;
+    readonly details?: any;
+    constructor(message: string, code: string, details?: any, status?: HttpStatus);
+}
+/**
+ * 文件大小超限异常
+ */
+export declare class FileSizeExceededException extends FileUploadException {
+    constructor(actualSize: number, maxSize: number);
+}
+/**
+ * 文件类型不允许异常
+ */
+export declare class FileTypeNotAllowedException extends FileUploadException {
+    constructor(mimeType: string, allowedTypes: string[]);
+}
+/**
+ * 文件扩展名不允许异常
+ */
+export declare class FileExtensionNotAllowedException extends FileUploadException {
+    constructor(extension: string, allowedExtensions: string[]);
+}
+/**
+ * 文件签名不匹配异常
+ */
+export declare class FileSignatureMismatchException extends FileUploadException {
+    constructor(error: string, reportedMime: string, detectedMime?: string);
+}
+/**
+ * 文件损坏异常
+ */
+export declare class CorruptedFileException extends FileUploadException {
+    constructor(mimeType: string, errors: string[]);
+}
+/**
+ * 恶意文件异常
+ */
+export declare class MaliciousFileException extends FileUploadException {
+    constructor(threats: string[]);
+}
+/**
+ * 存储异常
+ */
+export declare class StorageException extends FileUploadException {
+    constructor(operation: string, error: Error);
+}
+/**
+ * 无效文件名异常
+ */
+export declare class InvalidFilenameException extends FileUploadException {
+    constructor(filename: string);
+}

package/file-upload/exceptions/file-upload.exception.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidFilenameException = exports.StorageException = exports.MaliciousFileException = exports.CorruptedFileException = exports.FileSignatureMismatchException = exports.FileExtensionNotAllowedException = exports.FileTypeNotAllowedException = exports.FileSizeExceededException = exports.FileUploadException = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 文件上传基础异常类
+ */
+class FileUploadException extends common_1.HttpException {
+    constructor(message, code, details, status = common_1.HttpStatus.BAD_REQUEST) {
+        super({
+            message,
+            code,
+            details,
+            timestamp: new Date().toISOString(),
+        }, status);
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.FileUploadException = FileUploadException;
+/**
+ * 文件大小超限异常
+ */
+class FileSizeExceededException extends FileUploadException {
+    constructor(actualSize, maxSize) {
+        const actualSizeMB = Math.round((actualSize / 1024 / 1024) * 100) / 100;
+        const maxSizeMB = Math.round((maxSize / 1024 / 1024) * 100) / 100;
+        super(`File size ${actualSizeMB}MB exceeds maximum allowed size ${maxSizeMB}MB`, 'FILE_SIZE_EXCEEDED', {
+            actualSize,
+            maxSize,
+            actualSizeMB,
+            maxSizeMB,
+        });
+    }
+}
+exports.FileSizeExceededException = FileSizeExceededException;
+/**
+ * 文件类型不允许异常
+ */
+class FileTypeNotAllowedException extends FileUploadException {
+    constructor(mimeType, allowedTypes) {
+        super(`File type '${mimeType}' is not allowed`, 'FILE_TYPE_NOT_ALLOWED', {
+            mimeType,
+            allowedTypes,
+        });
+    }
+}
+exports.FileTypeNotAllowedException = FileTypeNotAllowedException;
+/**
+ * 文件扩展名不允许异常
+ */
+class FileExtensionNotAllowedException extends FileUploadException {
+    constructor(extension, allowedExtensions) {
+        super(`File extension '${extension}' is not allowed`, 'FILE_EXTENSION_NOT_ALLOWED', {
+            extension,
+            allowedExtensions,
+        });
+    }
+}
+exports.FileExtensionNotAllowedException = FileExtensionNotAllowedException;
+/**
+ * 文件签名不匹配异常
+ */
+class FileSignatureMismatchException extends FileUploadException {
+    constructor(error, reportedMime, detectedMime) {
+        super(`File signature verification failed: ${error}`, 'FILE_SIGNATURE_MISMATCH', {
+            error,
+            reportedMime,
+            detectedMime,
+        }, common_1.HttpStatus.UNPROCESSABLE_ENTITY);
+    }
+}
+exports.FileSignatureMismatchException = FileSignatureMismatchException;
+/**
+ * 文件损坏异常
+ */
+class CorruptedFileException extends FileUploadException {
+    constructor(mimeType, errors) {
+        super('File appears to be corrupted or invalid', 'CORRUPTED_FILE', {
+            mimeType,
+            errors,
+        }, common_1.HttpStatus.UNPROCESSABLE_ENTITY);
+    }
+}
+exports.CorruptedFileException = CorruptedFileException;
+/**
+ * 恶意文件异常
+ */
+class MaliciousFileException extends FileUploadException {
+    constructor(threats) {
+        super('Potentially malicious file detected', 'MALICIOUS_FILE', {
+            threats,
+        }, common_1.HttpStatus.FORBIDDEN);
+    }
+}
+exports.MaliciousFileException = MaliciousFileException;
+/**
+ * 存储异常
+ */
+class StorageException extends FileUploadException {
+    constructor(operation, error) {
+        super(`Storage operation failed: ${operation}`, 'STORAGE_ERROR', Object.assign({ operation, error: error.message }, (process.env.NODE_ENV !== 'prod' &&
+            process.env.NODE_ENV !== 'prod' && {
+            stack: error.stack,
+            name: error.name,
+        })), common_1.HttpStatus.INTERNAL_SERVER_ERROR);
+    }
+}
+exports.StorageException = StorageException;
+/**
+ * 无效文件名异常
+ */
+class InvalidFilenameException extends FileUploadException {
+    constructor(filename) {
+        super('Invalid or dangerous filename', 'INVALID_FILENAME', {
+            filename,
+        });
+    }
+}
+exports.InvalidFilenameException = InvalidFilenameException;

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

@@ -0,0 +1 @@
+export * from './file-upload.exception';

package/file-upload/exceptions/index.js

@@ -0,0 +1,17 @@
+"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-upload.exception"), exports);

package/file-upload/file-upload.module.d.ts

@@ -0,0 +1,89 @@
+import { DynamicModule } from '@nestjs/common';
+import { IFileProcessor } from './interfaces/file-processor.interface';
+import { LocalStorageOptions, S3StorageOptions } from './interfaces/storage-provider.interface';
+import { CustomFileTypes } from './interfaces/custom-file-type.interface';
+import { MaliciousDetectorOptions } from './services/malicious-file-detector.service';
+/**
+ * 文件上传模块配置选项（增强版）
+ */
+export interface FileUploadModuleOptions {
+    /** 默认配置 */
+    defaults?: {
+        maxSize?: number;
+        types?: string[];
+        scan?: boolean | 'auto';
+    };
+    /** 安全配置 */
+    security?: {
+        /** 病毒扫描配置 */
+        virusScan?: {
+            enabled: boolean;
+            endpoint?: string;
+        };
+        /** 速率限制 */
+        rateLimit?: {
+            max: number;
+            window: number;
+        };
+    };
+    /** 存储配置 */
+    storage?: {
+        /** 默认存储提供者 */
+        default?: 'local' | 's3' | 'oss' | 'minio';
+        /** 本地存储配置 */
+        local?: LocalStorageOptions;
+        /** S3 存储配置 */
+        s3?: S3StorageOptions;
+        /** OSS 存储配置 (待实现) */
+        oss?: any;
+        /** MinIO 存储配置 (待实现) */
+        minio?: any;
+    };
+    /** 自定义文件类型 */
+    customFileTypes?: CustomFileTypes;
+    /** 是否启用文件签名验证（默认 true） */
+    validateSignature?: boolean;
+    /** 签名验证配置 */
+    signatureValidation?: {
+        maxReadBytes?: number;
+        strict?: boolean;
+        tolerance?: number;
+    };
+    /** 恶意文件检测配置（增强） */
+    maliciousDetection?: MaliciousDetectorOptions;
+    /** TypeORM 相关配置 */
+    database?: {
+        /** 是否自动创建表（默认 true） */
+        autoCreateTable?: boolean;
+        /** 数据库模式 */
+        schema?: string;
+        /** 表前缀 */
+        tablePrefix?: string;
+    };
+    /** 自定义处理器 */
+    processors?: Array<new (...args: any[]) => IFileProcessor>;
+}
+/**
+ * 异步配置选项
+ */
+export interface FileUploadModuleAsyncOptions {
+    useFactory: (...args: any[]) => Promise<FileUploadModuleOptions> | FileUploadModuleOptions;
+    inject?: any[];
+}
+/**
+ * 文件上传模块（增强版）
+ */
+export declare class FileUploadModule {
+    /**
+     * 同步配置模块
+     */
+    static forRoot(options?: FileUploadModuleOptions): DynamicModule;
+    /**
+     * 异步配置模块
+     */
+    static forRootAsync(asyncOptions: FileUploadModuleAsyncOptions): DynamicModule;
+    /**
+     * 创建存储提供者
+     */
+    private static createStorageProviders;
+}