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

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

package/file-upload/file-upload.module.js

@@ -0,0 +1,292 @@
+"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 __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());
+    });
+};
+var FileUploadModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileUploadModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const file_upload_interceptor_1 = require("./interceptors/file-upload.interceptor");
+const local_storage_provider_1 = require("./providers/local-storage.provider");
+const mime_registry_service_1 = require("./services/mime-registry.service");
+const file_signature_validator_service_1 = require("./services/file-signature-validator.service");
+const malicious_file_detector_service_1 = require("./services/malicious-file-detector.service");
+const file_service_1 = require("./services/file.service");
+const file_entity_1 = require("./entities/file.entity");
+const file_metadata_entity_1 = require("./entities/file-metadata.entity");
+const file_access_controller_1 = require("./controllers/file-access.controller");
+const csv_processor_1 = require("./processors/csv.processor");
+const excel_processor_1 = require("./processors/excel.processor");
+const image_processor_1 = require("./processors/image.processor");
+/**
+ * 文件上传模块（增强版）
+ */
+let FileUploadModule = FileUploadModule_1 = class FileUploadModule {
+    /**
+     * 同步配置模块
+     */
+    static forRoot(options = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        const providers = [
+            // 核心服务
+            mime_registry_service_1.MimeRegistryService,
+            file_signature_validator_service_1.FileSignatureValidator,
+            // 恶意文件检测器（带配置）
+            {
+                provide: 'MALICIOUS_DETECTOR_OPTIONS',
+                useValue: options.maliciousDetection || {},
+            },
+            malicious_file_detector_service_1.MaliciousFileDetector,
+            // Interceptor
+            file_upload_interceptor_1.FileUploadInterceptor,
+            // 配置
+            {
+                provide: 'FILE_UPLOAD_OPTIONS',
+                useValue: options,
+            },
+        ];
+        // 注册自定义文件类型
+        if (options.customFileTypes) {
+            providers.push({
+                provide: 'CUSTOM_FILE_TYPES',
+                useValue: options.customFileTypes,
+            });
+            // 初始化自定义类型
+            providers.push({
+                provide: 'FILE_TYPE_INITIALIZER',
+                useFactory: (registry) => {
+                    registry.registerCustomFileTypes(options.customFileTypes);
+                    return registry;
+                },
+                inject: [mime_registry_service_1.MimeRegistryService],
+            });
+        }
+        // 注册处理器（内置处理器 + 自定义处理器）
+        const processorMap = new Map();
+        // 自动注册内置处理器
+        try {
+            const csvProcessor = new csv_processor_1.CsvProcessor();
+            const excelProcessor = new excel_processor_1.ExcelProcessor();
+            const imageProcessor = new image_processor_1.ImageProcessor();
+            processorMap.set(csvProcessor.name, csvProcessor);
+            processorMap.set(excelProcessor.name, excelProcessor);
+            processorMap.set(imageProcessor.name, imageProcessor);
+        }
+        catch (error) {
+            // 内置处理器加载失败，忽略（可能是依赖未安装）
+        }
+        // 添加用户自定义处理器
+        if (options.processors && options.processors.length > 0) {
+            for (const ProcessorClass of options.processors) {
+                const processor = new ProcessorClass();
+                processorMap.set(processor.name, processor);
+            }
+        }
+        // 始终提供 FILE_PROCESSORS（即使为空Map）
+        providers.push({
+            provide: 'FILE_PROCESSORS',
+            useValue: processorMap,
+        });
+        // 注册存储提供者
+        if (options.storage) {
+            const storageProviders = this.createStorageProviders(options.storage);
+            providers.push(...storageProviders);
+        }
+        // TypeORM 配置
+        const imports = [];
+        const databaseEnabled = ((_a = options.database) === null || _a === void 0 ? void 0 : _a.autoCreateTable) !== false;
+        if (databaseEnabled) {
+            imports.push(typeorm_1.TypeOrmModule.forFeature([file_entity_1.FileEntity, file_metadata_entity_1.FileMetadataEntity]));
+            providers.push(file_service_1.FileService);
+        }
+        // Build exports array - only export what's actually provided
+        const exports = [
+            mime_registry_service_1.MimeRegistryService,
+            file_signature_validator_service_1.FileSignatureValidator,
+            malicious_file_detector_service_1.MaliciousFileDetector,
+            file_upload_interceptor_1.FileUploadInterceptor,
+            'FILE_UPLOAD_OPTIONS',
+        ];
+        if (databaseEnabled) {
+            exports.push(file_service_1.FileService);
+        }
+        // 始终导出 FILE_PROCESSORS
+        exports.push('FILE_PROCESSORS');
+        if (((_b = options.storage) === null || _b === void 0 ? void 0 : _b.local) ||
+            !((_c = options.storage) === null || _c === void 0 ? void 0 : _c.default) ||
+            ((_d = options.storage) === null || _d === void 0 ? void 0 : _d.default) === 'local') {
+            if ((_e = options.storage) === null || _e === void 0 ? void 0 : _e.local) {
+                exports.push('LOCAL_STORAGE_PROVIDER');
+            }
+        }
+        if ((_f = options.storage) === null || _f === void 0 ? void 0 : _f.s3) {
+            exports.push('S3_STORAGE_PROVIDER');
+        }
+        if (options.storage) {
+            exports.push('STORAGE_PROVIDER');
+        }
+        return {
+            module: FileUploadModule_1,
+            imports,
+            controllers: databaseEnabled ? [file_access_controller_1.FileAccessController] : [],
+            providers,
+            exports,
+            global: true,
+        };
+    }
+    /**
+     * 异步配置模块
+     */
+    static forRootAsync(asyncOptions) {
+        const providers = [
+            // 核心服务
+            mime_registry_service_1.MimeRegistryService,
+            file_signature_validator_service_1.FileSignatureValidator,
+            // 恶意文件检测器配置（异步）
+            {
+                provide: 'MALICIOUS_DETECTOR_OPTIONS',
+                useFactory: (...args) => __awaiter(this, void 0, void 0, function* () {
+                    const options = yield asyncOptions.useFactory(...args);
+                    return options.maliciousDetection || {};
+                }),
+                inject: asyncOptions.inject || [],
+            },
+            malicious_file_detector_service_1.MaliciousFileDetector,
+            // Interceptor
+            file_upload_interceptor_1.FileUploadInterceptor,
+            // 异步配置
+            {
+                provide: 'FILE_UPLOAD_OPTIONS',
+                useFactory: asyncOptions.useFactory,
+                inject: asyncOptions.inject || [],
+            },
+            // 异步处理器注册（内置 + 自定义）
+            {
+                provide: 'FILE_PROCESSORS',
+                useFactory: (...args) => __awaiter(this, void 0, void 0, function* () {
+                    const options = yield asyncOptions.useFactory(...args);
+                    const processorMap = new Map();
+                    // 自动注册内置处理器
+                    try {
+                        const csvProcessor = new csv_processor_1.CsvProcessor();
+                        const excelProcessor = new excel_processor_1.ExcelProcessor();
+                        const imageProcessor = new image_processor_1.ImageProcessor();
+                        processorMap.set(csvProcessor.name, csvProcessor);
+                        processorMap.set(excelProcessor.name, excelProcessor);
+                        processorMap.set(imageProcessor.name, imageProcessor);
+                    }
+                    catch (error) {
+                        // 内置处理器加载失败，忽略
+                    }
+                    // 添加用户自定义处理器
+                    if (options.processors && options.processors.length > 0) {
+                        for (const ProcessorClass of options.processors) {
+                            const processor = new ProcessorClass();
+                            processorMap.set(processor.name, processor);
+                        }
+                    }
+                    return processorMap;
+                }),
+                inject: asyncOptions.inject || [],
+            },
+            // 异步自定义文件类型初始化
+            {
+                provide: 'FILE_TYPE_INITIALIZER',
+                useFactory: (registry, ...args) => __awaiter(this, void 0, void 0, function* () {
+                    const options = yield asyncOptions.useFactory(...args);
+                    if (options.customFileTypes) {
+                        registry.registerCustomFileTypes(options.customFileTypes);
+                    }
+                    return registry;
+                }),
+                inject: [mime_registry_service_1.MimeRegistryService, ...(asyncOptions.inject || [])],
+            },
+        ];
+        const imports = [
+            // 默认开启 TypeORM
+            typeorm_1.TypeOrmModule.forFeature([file_entity_1.FileEntity, file_metadata_entity_1.FileMetadataEntity]),
+        ];
+        providers.push(file_service_1.FileService);
+        // For async, we always provide FILE_PROCESSORS (with empty Map fallback)
+        // Storage providers need to be handled via the options factory
+        return {
+            module: FileUploadModule_1,
+            imports,
+            controllers: [file_access_controller_1.FileAccessController],
+            providers,
+            exports: [
+                mime_registry_service_1.MimeRegistryService,
+                file_signature_validator_service_1.FileSignatureValidator,
+                malicious_file_detector_service_1.MaliciousFileDetector,
+                file_upload_interceptor_1.FileUploadInterceptor,
+                file_service_1.FileService,
+                'FILE_UPLOAD_OPTIONS',
+                'FILE_PROCESSORS',
+            ],
+            global: true,
+        };
+    }
+    /**
+     * 创建存储提供者
+     */
+    static createStorageProviders(storageConfig) {
+        const providers = [];
+        // 本地存储
+        if (storageConfig.local) {
+            providers.push({
+                provide: 'LOCAL_STORAGE_PROVIDER',
+                useFactory: () => __awaiter(this, void 0, void 0, function* () {
+                    const provider = new local_storage_provider_1.LocalStorageProvider(storageConfig.local);
+                    yield provider.initialize();
+                    return provider;
+                }),
+            });
+            // 如果是默认存储
+            if (storageConfig.default === 'local' || !storageConfig.default) {
+                providers.push({
+                    provide: 'STORAGE_PROVIDER',
+                    useExisting: 'LOCAL_STORAGE_PROVIDER',
+                });
+            }
+        }
+        // S3 存储
+        if (storageConfig.s3) {
+            providers.push({
+                provide: 'S3_STORAGE_PROVIDER',
+                useFactory: () => __awaiter(this, void 0, void 0, function* () {
+                    // Lazy load S3StorageProvider to avoid bundling AWS SDK
+                    const { S3StorageProvider } = yield Promise.resolve().then(() => require('./providers/s3-storage.provider'));
+                    const provider = new S3StorageProvider(storageConfig.s3);
+                    yield provider.initialize();
+                    return provider;
+                }),
+            });
+            // 如果是默认存储
+            if (storageConfig.default === 's3') {
+                providers.push({
+                    provide: 'STORAGE_PROVIDER',
+                    useExisting: 'S3_STORAGE_PROVIDER',
+                });
+            }
+        }
+        // TODO: 添加 OSS, MinIO 存储提供者
+        return providers;
+    }
+};
+exports.FileUploadModule = FileUploadModule;
+exports.FileUploadModule = FileUploadModule = FileUploadModule_1 = __decorate([
+    (0, common_1.Module)({})
+], FileUploadModule);

package/file-upload/index.d.ts

@@ -0,0 +1,37 @@
+export * from './file-upload.module';
+export * from './enums/file-type.enum';
+export * from './interfaces/file-upload-options.interface';
+export * from './interfaces/storage-provider.interface';
+export * from './interfaces/file-buffer.interface';
+export * from './interfaces/file-metadata.interface';
+export * from './interfaces/upload-options.interface';
+export * from './interfaces/custom-file-type.interface';
+export * from './interfaces/file-processor.interface';
+import { ProcessResult as _ProcessResult } from './interfaces/processor-options.interface';
+import { ValidationResult as _ValidationResult } from './decorators/validate-data.decorator';
+export { _ProcessResult as ProcessResult };
+export * from './decorators/file-upload.decorator';
+export { ExcelColumn, getExcelColumnMapping, parseAndValidateExcelData } from './decorators/excel-data.decorator';
+export { CsvColumn, getCsvColumnMapping, parseAndValidateCsvData } from './decorators/csv-data.decorator';
+export * from './decorators/csv-import.decorator';
+export { BaseRowData, ValidationResult as ValidationResultType } from './decorators/validate-data.decorator';
+export { _ValidationResult as ValidationResult };
+export * from './decorators/validate-data.decorator';
+export * from './decorators/process.decorator';
+export * from './interceptors/file-upload.interceptor';
+export * from './controllers/file-access.controller';
+export * from './providers/local-storage.provider';
+export * from './services/mime-registry.service';
+export * from './services/file-signature-validator.service';
+export * from './services/malicious-file-detector.service';
+export * from './services/file.service';
+export * from './processors/excel.processor';
+export * from './processors/csv.processor';
+export * from './processors/image.processor';
+export * from './entities/file.entity';
+export * from './entities/file-metadata.entity';
+export * from './dto/create-file.dto';
+export * from './dto/update-file.dto';
+export * from './dto/find-files.dto';
+export * from './dto/pagination.dto';
+export * from './exceptions/file-upload.exception';