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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-omni/core",
-  "version": "4.1.3-12",
+  "version": "4.1.3-13",
   "description": "A comprehensive NestJS framework for building enterprise-grade applications with best practices",
   "main": "index.js",
   "types": "index.d.ts",
@@ -36,7 +36,7 @@
   "author": "Jinpy",
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=18.0.0",
+    "node": ">=22.0.0",
     "npm": ">=9.0.0"
   },
   "devDependencies": {
@@ -45,6 +45,7 @@
     "@types/express-session": "^1.18.2",
     "@types/lodash": "^4.17.20",
     "@types/node": "^24.9.1",
+    "@types/sharp": "^0.31.1",
     "@types/sprintf-js": "^1.1.4",
     "@types/uuid": "^11.0.0",
     "sqlite3": "^5.1.7",
@@ -66,7 +67,7 @@
     "@sentry/profiling-node": "^10.22.0",
     "@songkeys/nestjs-redis": "^11.0.0",
     "@songkeys/nestjs-redis-health": "^11.0.0",
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
     "bcrypt": "^6.0.0",
     "body-parser": "^2.2.0",
@@ -96,6 +97,9 @@
     "source-map-support": "^0.5.21",
     "sprintf-js": "^1.1.3",
     "typeorm": "^0.3.27",
-    "uuid": "^13.0.0"
-  }
+    "uuid": "^13.0.0",
+    "fast-csv": "^5.0.5",
+    "xlsx": "git+https://git.sheetjs.com/sheetjs/sheetjs.git#v0.20.3"
+  },
+  "peerDependencies": {}
 }

package/tsconfig.build.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "removeComments": false,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test",
+    "tests",
+    "**/*.spec.ts",
+    "**/*.test.ts"
+  ]
+}

package/cache/dependencies/db.dependency.d.ts

@@ -1,60 +0,0 @@
-import { DataSource } from 'typeorm';
-import type { CacheDependency } from '../interfaces/cache-dependency.interface';
-/**
- * Database-based cache dependency
- *
- * This dependency monitors database query results. When the query result changes,
- * the cache becomes invalid.
- *
- * Common use case: Monitor MAX(updated_at) or COUNT(*) to detect data changes.
- *
- * @example
- * ```typescript
- * // Invalidate cache when user data changes
- * @Cacheable({
- *   key: (id) => `user:${id}:profile`,
- *   dependencies: [
- *     new DbDependency(
- *       'SELECT updated_at FROM users WHERE id = ?',
- *       (id) => [id]
- *     )
- *   ]
- * })
- * async getUserProfile(id: string) { }
- *
- * // Invalidate when any user in tenant changes
- * @Cacheable({
- *   key: (tenantId) => `users:list:${tenantId}`,
- *   dependencies: [
- *     new DbDependency(
- *       'SELECT MAX(updated_at) FROM users WHERE tenant_id = ?',
- *       (tenantId) => [tenantId]
- *     )
- *   ]
- * })
- * async getUserList(tenantId: string) { }
- * ```
- */
-export declare class DbDependency implements CacheDependency {
-    private readonly sql;
-    private readonly paramsFactory?;
-    private readonly name?;
-    private static dataSource;
-    constructor(sql: string, paramsFactory?: (...args: any[]) => any[], name?: string);
-    /**
-     * Set the TypeORM DataSource for database queries
-     * This should be called once during application initialization
-     */
-    static setDataSource(dataSource: DataSource): void;
-    /**
-     * Get the current DataSource
-     */
-    static getDataSource(): DataSource | null;
-    getKey(): string;
-    getData(): Promise<any>;
-    isChanged(oldData: any): Promise<boolean>;
-    /**
-     * Simple hash code generation for strings
-     */
-    private hashCode;
-}

package/file-upload/decorators/csv-data.decorator.d.ts

@@ -1,44 +0,0 @@
-import { CsvDataOptions } from '../interfaces/file-upload-options.interface';
-/**
- * CSV 列映射元数据键
- */
-export declare const CSV_COLUMN_METADATA = "csv:column";
-/**
- * CSV 列名映射装饰器
- * @example
- * ```typescript
- * export class OrderImportDto {
- *   @CsvColumn('订单号')
- *   @IsString()
- *   orderNo: string;
- * }
- * ```
- */
-export declare function CsvColumn(columnName: string): PropertyDecorator;
-/**
- * CSV 数据参数装饰器
- * @example
- * ```typescript
- * @Post('import/csv')
- * @FileUpload({ types: [FileType.CSV] })
- * async importCsv(@CsvData(OrderImportDto) orders: OrderImportDto[]) {
- *   await this.orderService.batchCreate(orders);
- *   return { count: orders.length };
- * }
- * ```
- */
-export declare const CsvData: (...dataOrPipes: (import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>> | {
-    dto: any;
-    options?: CsvDataOptions;
-})[]) => ParameterDecorator;
-/**
- * 辅助函数：获取 DTO 的 CSV 列映射
- */
-export declare function getCsvColumnMapping(dto: any): Map<string, string>;
-/**
- * 辅助函数：解析和验证 CSV 数据
- */
-export declare function parseAndValidateCsvData<T extends object>(rawData: any[], dtoClass: new () => T, options?: CsvDataOptions): Promise<{
-    data: T[];
-    errors: any[];
-}>;

package/file-upload/decorators/csv-data.decorator.js

@@ -1,131 +0,0 @@
-"use strict";
-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());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CsvData = exports.CSV_COLUMN_METADATA = void 0;
-exports.CsvColumn = CsvColumn;
-exports.getCsvColumnMapping = getCsvColumnMapping;
-exports.parseAndValidateCsvData = parseAndValidateCsvData;
-const common_1 = require("@nestjs/common");
-const class_transformer_1 = require("class-transformer");
-const class_validator_1 = require("class-validator");
-/**
- * CSV 列映射元数据键
- */
-exports.CSV_COLUMN_METADATA = 'csv:column';
-/**
- * CSV 列名映射装饰器
- * @example
- * ```typescript
- * export class OrderImportDto {
- *   @CsvColumn('订单号')
- *   @IsString()
- *   orderNo: string;
- * }
- * ```
- */
-function CsvColumn(columnName) {
-    return (target, propertyKey) => {
-        Reflect.defineMetadata(exports.CSV_COLUMN_METADATA, columnName, target, propertyKey);
-    };
-}
-/**
- * CSV 数据参数装饰器
- * @example
- * ```typescript
- * @Post('import/csv')
- * @FileUpload({ types: [FileType.CSV] })
- * async importCsv(@CsvData(OrderImportDto) orders: OrderImportDto[]) {
- *   await this.orderService.batchCreate(orders);
- *   return { count: orders.length };
- * }
- * ```
- */
-exports.CsvData = (0, common_1.createParamDecorator)((data, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-    const request = ctx.switchToHttp().getRequest();
-    const file = request.file;
-    if (!file) {
-        throw new Error('No file uploaded');
-    }
-    // 这里将在 interceptor 中处理 CSV 解析
-    // 当前只返回文件信息，实际解析逻辑在 FileUploadInterceptor 中
-    return {
-        _csvData: true,
-        dto: data,
-        file,
-        options: data === null || data === void 0 ? void 0 : data['options'],
-    };
-}));
-/**
- * 辅助函数：获取 DTO 的 CSV 列映射
- */
-function getCsvColumnMapping(dto) {
-    const mapping = new Map();
-    const prototype = dto.prototype;
-    if (!prototype) {
-        return mapping;
-    }
-    const propertyKeys = Object.getOwnPropertyNames(prototype);
-    for (const propertyKey of propertyKeys) {
-        const columnName = Reflect.getMetadata(exports.CSV_COLUMN_METADATA, prototype, propertyKey);
-        if (columnName) {
-            mapping.set(columnName, propertyKey);
-        }
-    }
-    return mapping;
-}
-/**
- * 辅助函数：解析和验证 CSV 数据
- */
-function parseAndValidateCsvData(rawData_1, dtoClass_1) {
-    return __awaiter(this, arguments, void 0, function* (rawData, dtoClass, options = {}) {
-        const { skipEmptyLines = true, skipHeader = false } = options;
-        const data = [];
-        const errors = [];
-        const mapping = getCsvColumnMapping(dtoClass);
-        const startIndex = skipHeader ? 1 : 0;
-        for (let i = startIndex; i < rawData.length; i++) {
-            const row = rawData[i];
-            // 跳过空行
-            if (skipEmptyLines && isEmptyRow(row)) {
-                continue;
-            }
-            const obj = {};
-            // 映射列名到属性名
-            for (const [columnName, propertyKey] of mapping.entries()) {
-                obj[propertyKey] = row[columnName];
-            }
-            // 转换为 DTO 实例
-            const instance = (0, class_transformer_1.plainToInstance)(dtoClass, obj);
-            // 验证
-            const validationErrors = yield (0, class_validator_1.validate)(instance);
-            if (validationErrors.length > 0) {
-                errors.push({
-                    row: i + 1,
-                    data: obj,
-                    errors: validationErrors,
-                });
-            }
-            else {
-                data.push(instance);
-            }
-        }
-        return { data, errors };
-    });
-}
-/**
- * 检查是否为空行
- */
-function isEmptyRow(row) {
-    if (!row)
-        return true;
-    const values = Object.values(row);
-    return values.every((val) => !val || String(val).trim() === '');
-}

package/file-upload/decorators/excel-data.decorator.d.ts

@@ -1,44 +0,0 @@
-import { ExcelDataOptions } from '../interfaces/file-upload-options.interface';
-/**
- * Excel 列映射元数据键
- */
-export declare const EXCEL_COLUMN_METADATA = "excel:column";
-/**
- * Excel 列名映射装饰器
- * @example
- * ```typescript
- * export class UserImportDto {
- *   @ExcelColumn('姓名')
- *   @IsString()
- *   name: string;
- * }
- * ```
- */
-export declare function ExcelColumn(columnName: string): PropertyDecorator;
-/**
- * Excel 数据参数装饰器
- * @example
- * ```typescript
- * @Post('import/excel')
- * @FileUpload({ types: [FileType.Excel] })
- * async importExcel(@ExcelData(UserImportDto) users: UserImportDto[]) {
- *   await this.userService.batchCreate(users);
- *   return { count: users.length };
- * }
- * ```
- */
-export declare const ExcelData: (...dataOrPipes: (import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>> | {
-    dto: any;
-    options?: ExcelDataOptions;
-})[]) => ParameterDecorator;
-/**
- * 辅助函数：获取 DTO 的 Excel 列映射
- */
-export declare function getExcelColumnMapping(dto: any): Map<string, string>;
-/**
- * 辅助函数：解析和验证 Excel 数据
- */
-export declare function parseAndValidateExcelData<T extends object>(rawData: any[], dtoClass: new () => T, options?: ExcelDataOptions): Promise<{
-    data: T[];
-    errors: any[];
-}>;

package/file-upload/decorators/excel-data.decorator.js

@@ -1,125 +0,0 @@
-"use strict";
-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());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExcelData = exports.EXCEL_COLUMN_METADATA = void 0;
-exports.ExcelColumn = ExcelColumn;
-exports.getExcelColumnMapping = getExcelColumnMapping;
-exports.parseAndValidateExcelData = parseAndValidateExcelData;
-const common_1 = require("@nestjs/common");
-const class_transformer_1 = require("class-transformer");
-const class_validator_1 = require("class-validator");
-/**
- * Excel 列映射元数据键
- */
-exports.EXCEL_COLUMN_METADATA = 'excel:column';
-/**
- * Excel 列名映射装饰器
- * @example
- * ```typescript
- * export class UserImportDto {
- *   @ExcelColumn('姓名')
- *   @IsString()
- *   name: string;
- * }
- * ```
- */
-function ExcelColumn(columnName) {
-    return (target, propertyKey) => {
-        Reflect.defineMetadata(exports.EXCEL_COLUMN_METADATA, columnName, target, propertyKey);
-    };
-}
-/**
- * Excel 数据参数装饰器
- * @example
- * ```typescript
- * @Post('import/excel')
- * @FileUpload({ types: [FileType.Excel] })
- * async importExcel(@ExcelData(UserImportDto) users: UserImportDto[]) {
- *   await this.userService.batchCreate(users);
- *   return { count: users.length };
- * }
- * ```
- */
-exports.ExcelData = (0, common_1.createParamDecorator)((data, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-    const request = ctx.switchToHttp().getRequest();
-    const file = request.file;
-    if (!file) {
-        throw new Error('No file uploaded');
-    }
-    // 这里将在 interceptor 中处理 Excel 解析
-    // 当前只返回文件信息，实际解析逻辑在 FileUploadInterceptor 中
-    return {
-        _excelData: true,
-        dto: data,
-        file,
-        options: data === null || data === void 0 ? void 0 : data['options'],
-    };
-}));
-/**
- * 辅助函数：获取 DTO 的 Excel 列映射
- */
-function getExcelColumnMapping(dto) {
-    const mapping = new Map();
-    const prototype = dto.prototype;
-    if (!prototype) {
-        return mapping;
-    }
-    const propertyKeys = Object.getOwnPropertyNames(prototype);
-    for (const propertyKey of propertyKeys) {
-        const columnName = Reflect.getMetadata(exports.EXCEL_COLUMN_METADATA, prototype, propertyKey);
-        if (columnName) {
-            mapping.set(columnName, propertyKey);
-        }
-    }
-    return mapping;
-}
-/**
- * 辅助函数：解析和验证 Excel 数据
- */
-function parseAndValidateExcelData(rawData_1, dtoClass_1) {
-    return __awaiter(this, arguments, void 0, function* (rawData, dtoClass, options = {}) {
-        const { startRow = 1, maxRows, stopOnError = false } = options;
-        const data = [];
-        const errors = [];
-        const mapping = getExcelColumnMapping(dtoClass);
-        let rowsProcessed = 0;
-        for (let i = startRow; i < rawData.length; i++) {
-            if (maxRows && rowsProcessed >= maxRows) {
-                break;
-            }
-            const row = rawData[i];
-            const obj = {};
-            // 映射列名到属性名
-            for (const [columnName, propertyKey] of mapping.entries()) {
-                obj[propertyKey] = row[columnName];
-            }
-            // 转换为 DTO 实例
-            const instance = (0, class_transformer_1.plainToInstance)(dtoClass, obj);
-            // 验证
-            const validationErrors = yield (0, class_validator_1.validate)(instance);
-            if (validationErrors.length > 0) {
-                errors.push({
-                    row: i + 1,
-                    data: obj,
-                    errors: validationErrors,
-                });
-                if (stopOnError) {
-                    break;
-                }
-            }
-            else {
-                data.push(instance);
-            }
-            rowsProcessed++;
-        }
-        return { data, errors };
-    });
-}

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

@@ -1,4 +0,0 @@
-export * from './file-upload.decorator';
-export * from './excel-data.decorator';
-export * from './csv-data.decorator';
-export * from './process.decorator';

package/file-upload/decorators/index.js

@@ -1,20 +0,0 @@
-"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.decorator"), exports);
-__exportStar(require("./excel-data.decorator"), exports);
-__exportStar(require("./csv-data.decorator"), exports);
-__exportStar(require("./process.decorator"), exports);

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

@@ -1,48 +0,0 @@
-import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
-import { Reflector } from '@nestjs/core';
-import { Observable } from 'rxjs';
-import { IFileProcessor } from '../interfaces/file-upload-options.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 createUploadContext;
-    /**
-     * 获取处理器
-     */
-    private getProcessor;
-    /**
-     * 生成uploadId
-     */
-    private generateUploadId;
-    /**
-     * 计算文件校验和
-     */
-    private calculateChecksum;
-    /**
-     * 验证 MIME 类型
-     */
-    private validateMimeType;
-    /**
-     * 验证扩展名
-     */
-    private validateExtension;
-}