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

package/file-upload/index.js

@@ -0,0 +1,77 @@
+"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 });
+exports.BaseRowData = exports.parseAndValidateCsvData = exports.getCsvColumnMapping = exports.CsvColumn = exports.parseAndValidateExcelData = exports.getExcelColumnMapping = exports.ExcelColumn = void 0;
+// Module
+__exportStar(require("./file-upload.module"), exports);
+// Enums
+__exportStar(require("./enums/file-type.enum"), exports);
+// Interfaces
+__exportStar(require("./interfaces/file-upload-options.interface"), exports);
+__exportStar(require("./interfaces/storage-provider.interface"), exports);
+__exportStar(require("./interfaces/file-buffer.interface"), exports);
+__exportStar(require("./interfaces/file-metadata.interface"), exports);
+__exportStar(require("./interfaces/upload-options.interface"), exports);
+__exportStar(require("./interfaces/custom-file-type.interface"), exports);
+__exportStar(require("./interfaces/file-processor.interface"), exports);
+// Note: FileEntity interface is not exported to avoid conflict with TypeORM entity
+// Decorators - 避免冲突，选择性导出
+__exportStar(require("./decorators/file-upload.decorator"), exports);
+// Excel/CSV 列映射装饰器（字段级别）
+var excel_data_decorator_1 = require("./decorators/excel-data.decorator");
+Object.defineProperty(exports, "ExcelColumn", { enumerable: true, get: function () { return excel_data_decorator_1.ExcelColumn; } });
+Object.defineProperty(exports, "getExcelColumnMapping", { enumerable: true, get: function () { return excel_data_decorator_1.getExcelColumnMapping; } });
+Object.defineProperty(exports, "parseAndValidateExcelData", { enumerable: true, get: function () { return excel_data_decorator_1.parseAndValidateExcelData; } });
+var csv_data_decorator_1 = require("./decorators/csv-data.decorator");
+Object.defineProperty(exports, "CsvColumn", { enumerable: true, get: function () { return csv_data_decorator_1.CsvColumn; } });
+Object.defineProperty(exports, "getCsvColumnMapping", { enumerable: true, get: function () { return csv_data_decorator_1.getCsvColumnMapping; } });
+Object.defineProperty(exports, "parseAndValidateCsvData", { enumerable: true, get: function () { return csv_data_decorator_1.parseAndValidateCsvData; } });
+__exportStar(require("./decorators/csv-import.decorator"), exports);
+// Validation decorators
+var validate_data_decorator_1 = require("./decorators/validate-data.decorator");
+Object.defineProperty(exports, "BaseRowData", { enumerable: true, get: function () { return validate_data_decorator_1.BaseRowData; } });
+__exportStar(require("./decorators/validate-data.decorator"), exports);
+__exportStar(require("./decorators/process.decorator"), exports);
+// Interceptors
+__exportStar(require("./interceptors/file-upload.interceptor"), exports);
+// Controllers
+__exportStar(require("./controllers/file-access.controller"), exports);
+// Providers
+__exportStar(require("./providers/local-storage.provider"), exports);
+// Note: S3StorageProvider is not exported to avoid bundling optional AWS SDK dependencies
+// export * from './providers/s3-storage.provider';
+// Services
+__exportStar(require("./services/mime-registry.service"), exports);
+__exportStar(require("./services/file-signature-validator.service"), exports);
+__exportStar(require("./services/malicious-file-detector.service"), exports);
+__exportStar(require("./services/file.service"), exports);
+// Processors
+__exportStar(require("./processors/excel.processor"), exports);
+__exportStar(require("./processors/csv.processor"), exports);
+__exportStar(require("./processors/image.processor"), exports);
+// Entities
+__exportStar(require("./entities/file.entity"), exports);
+__exportStar(require("./entities/file-metadata.entity"), exports);
+// DTOs
+__exportStar(require("./dto/create-file.dto"), exports);
+__exportStar(require("./dto/update-file.dto"), exports);
+__exportStar(require("./dto/find-files.dto"), exports);
+__exportStar(require("./dto/pagination.dto"), exports);
+// Exceptions
+__exportStar(require("./exceptions/file-upload.exception"), exports);
+// Utils
+// Note: DynamicImportUtil is an internal utility not exported to avoid bundling optional dependencies
+// export * from './utils/dynamic-import.util';

package/file-upload/interceptors/file-upload.interceptor.d.ts

@@ -0,0 +1,101 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { IFileProcessor } from '../interfaces/file-processor.interface';
+import { FileService } from '../services/file.service';
+import { FileSignatureValidator } from '../services/file-signature-validator.service';
+import { MaliciousFileDetector } from '../services/malicious-file-detector.service';
+import { MimeRegistryService } from '../services/mime-registry.service';
+/**
+ * 文件上传拦截器（优化版）
+ * 负责创建文件记录、执行钩子、处理器等后置逻辑
+ */
+export declare class FileUploadInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly mimeRegistry;
+    private readonly processors?;
+    private readonly fileService?;
+    private readonly signatureValidator?;
+    private readonly maliciousDetector?;
+    private readonly moduleOptions?;
+    private readonly logger;
+    constructor(reflector: Reflector, mimeRegistry: MimeRegistryService, processors?: Map<string, IFileProcessor>, fileService?: FileService, signatureValidator?: FileSignatureValidator, maliciousDetector?: MaliciousFileDetector, moduleOptions?: any);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<any>>;
+    /**
+     * 判断是否应该跳过验证
+     */
+    private shouldSkipValidation;
+    /**
+     * 验证文件
+     */
+    private validateFile;
+    /**
+     * 批量验证文件类型和扩展名
+     */
+    private validateFileTypeAndExtension;
+    /**
+     * 判断是否需要执行文件签名验证
+     */
+    private shouldPerformSignatureValidation;
+    /**
+     * 验证文件签名
+     */
+    private validateFileSignature;
+    /**
+     * 判断是否需要执行恶意文件检测
+     */
+    private shouldPerformMaliciousCheck;
+    /**
+     * 检测恶意文件
+     */
+    private checkMaliciousFile;
+    /**
+     * 处理文件
+     */
+    private processFile;
+    /**
+     * 创建文件实体
+     */
+    private createFileEntity;
+    /**
+     * 执行处理器
+     */
+    private executeProcessors;
+    /**
+     * 转换为 FileEntity
+     */
+    private convertToFileEntity;
+    /**
+     * 更新成功状态
+     */
+    private updateFileEntityOnSuccess;
+    /**
+     * 清理失败的文件
+     */
+    private cleanupOnFailure;
+    /**
+     * 创建上传上下文
+     */
+    private createUploadContext;
+    /**
+     * 获取处理器
+     */
+    private getProcessor;
+    /**
+     * 生成uploadId
+     */
+    private generateUploadId;
+    /**
+     * 判断是否应该在处理后删除原文件
+     */
+    private shouldDeleteAfterProcess;
+    /**
+     * 将处理器结果保存到 file_metadata 表
+     * 处理器可以通过返回结果中的 metadata 字段来指定要保存的内容
+     */
+    private saveProcessorResultToMetadata;
+    /**
+     * 删除原文件
+     */
+    private deleteOriginalFile;
+}