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

package/decorators/translate.decorator.js

@@ -5,6 +5,7 @@ exports.StaticTranslate = StaticTranslate;
 exports.DynamicTranslate = DynamicTranslate;
 exports.STATIC_TRANSLATION_DECORATOR_KEY = 'custom:static-translate';
 exports.DYNAMIC_TRANSLATION_DECORATOR_KEY = 'custom:dynamic-translate';
+// FIXME: This is a temporary solution to get the translation decorator working.
 function StaticTranslate(data = {}) {
     return (target, key) => {
         Reflect.defineMetadata(exports.STATIC_TRANSLATION_DECORATOR_KEY, data, target, key);

package/decorators/user.decorator.js

@@ -14,6 +14,7 @@ function getOmniAuthData(request, key) {
     const headers = request.headers;
     let user;
     const configService = new config_1.ConfigService(request);
+    // 未通过网关透传用户信息且处于local开发环境，则从配置获取用户信息
     if ((0, lodash_1.isEmpty)(headers['x-user-id']) && (0, lodash_1.isEmpty)(headers['x-app-id'])) {
         if (process.env.NODE_ENV === 'dev' || process.env.MOCK_ENABLED === 'true') {
             user = {

package/decorators/validator.decorators.d.ts

@@ -1,18 +1,8 @@
-import type { ValidationOptions } from 'class-validator';
-import { IsPhoneNumber as isPhoneNumber, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
-export declare function IsPassword(validationOptions?: ValidationOptions): PropertyDecorator;
-export declare function IsPhoneNumber(validationOptions?: ValidationOptions & {
-    region?: Parameters<typeof isPhoneNumber>[0];
-}): PropertyDecorator;
-export declare function IsTmpKey(validationOptions?: ValidationOptions): PropertyDecorator;
-export declare function IsUndefinable(options?: ValidationOptions): PropertyDecorator;
-export declare function IsEmptyable(options?: ValidationOptions): PropertyDecorator;
-export declare function IsNullable(options?: ValidationOptions): PropertyDecorator;
-export declare function IsHttpUrl(validationOptions?: ValidationOptions): (object: any, propertyName: string) => void;
-export declare class AtLeastOneFieldConstraint implements ValidatorConstraintInterface {
-    validate(value: any, args: ValidationArguments): boolean;
-    defaultMessage(args: ValidationArguments): string;
-}
-export declare function AtLeastOneField(properties: string[], validationOptions?: ValidationOptions): PropertyDecorator;
-export declare function CustomValidation<T = any>(validationCallback: (value: T, args: ValidationArguments) => boolean | Promise<boolean>, validationOptions?: ValidationOptions): PropertyDecorator;
-export declare function CustomValidationMethod(methodName: string, validationOptions?: ValidationOptions): PropertyDecorator;
+/**
+ * Validator decorators
+ *
+ * 所有验证装饰器已迁移到 validators 目录
+ * 此文件仅用于重新导出，保持导入路径的一致性
+ */
+export * from '../validators/common-validators';
+export * from '../validators/custom-validate.validator';

package/decorators/validator.decorators.js

@@ -1,193 +1,25 @@
 "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());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AtLeastOneFieldConstraint = void 0;
-exports.IsPassword = IsPassword;
-exports.IsPhoneNumber = IsPhoneNumber;
-exports.IsTmpKey = IsTmpKey;
-exports.IsUndefinable = IsUndefinable;
-exports.IsEmptyable = IsEmptyable;
-exports.IsNullable = IsNullable;
-exports.IsHttpUrl = IsHttpUrl;
-exports.AtLeastOneField = AtLeastOneField;
-exports.CustomValidation = CustomValidation;
-exports.CustomValidationMethod = CustomValidationMethod;
-const class_validator_1 = require("class-validator");
-const lodash_1 = require("lodash");
-const nestjs_i18n_1 = require("nestjs-i18n");
-function IsPassword(validationOptions) {
-    return (object, propertyName) => {
-        (0, class_validator_1.registerDecorator)({
-            propertyName,
-            name: 'isPassword',
-            target: object.constructor,
-            constraints: [],
-            options: validationOptions,
-            validator: {
-                validate(value) {
-                    return /^[\d!#$%&*@A-Z^a-z]*$/.test(value);
-                },
-            },
-        });
-    };
-}
-function IsPhoneNumber(validationOptions) {
-    return (0, class_validator_1.IsPhoneNumber)(validationOptions === null || validationOptions === void 0 ? void 0 : validationOptions.region, Object.assign({ message: 'error.phoneNumber' }, validationOptions));
-}
-function IsTmpKey(validationOptions) {
-    return (object, propertyName) => {
-        (0, class_validator_1.registerDecorator)({
-            propertyName,
-            name: 'tmpKey',
-            target: object.constructor,
-            options: validationOptions,
-            validator: {
-                validate(value) {
-                    return (0, lodash_1.isString)(value) && /^tmp\//.test(value);
-                },
-                defaultMessage() {
-                    return 'error.invalidTmpKey';
-                },
-            },
-        });
-    };
-}
-function IsUndefinable(options) {
-    return (0, class_validator_1.ValidateIf)((obj, value) => value !== undefined, options);
-}
-function IsEmptyable(options) {
-    return (0, class_validator_1.ValidateIf)((obj, value) => !(value === null ||
-        value === undefined ||
-        ((0, lodash_1.isString)(value) && value.trim() === '')), options);
-}
-function IsNullable(options) {
-    return (0, class_validator_1.ValidateIf)((obj, value) => value !== null, options);
-}
-function IsHttpUrl(validationOptions) {
-    return function (object, propertyName) {
-        (0, class_validator_1.registerDecorator)({
-            name: 'isHttpUrl',
-            target: object.constructor,
-            propertyName: propertyName,
-            options: validationOptions,
-            validator: {
-                validate(value) {
-                    const httpUrlPattern = /^(https?:\/\/)/i;
-                    return typeof value === 'string' && httpUrlPattern.test(value);
-                },
-                defaultMessage() {
-                    return 'URL must start with http:// or https://';
-                },
-            },
-        });
-    };
-}
-let AtLeastOneFieldConstraint = class AtLeastOneFieldConstraint {
-    validate(value, args) {
-        const object = args.object;
-        const [requiredProperties] = args.constraints;
-        return requiredProperties.some((property) => {
-            const propValue = object[property];
-            return (propValue !== null &&
-                propValue !== undefined &&
-                propValue !== '' &&
-                !(Array.isArray(propValue) && propValue.length === 0));
-        });
-    }
-    defaultMessage(args) {
-        const [requiredProperties] = args.constraints;
-        return `At least one of the following fields must be provided: ${requiredProperties.join(', ')}`;
+/**
+ * Validator decorators
+ *
+ * 所有验证装饰器已迁移到 validators 目录
+ * 此文件仅用于重新导出，保持导入路径的一致性
+ */
+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);
 };
-exports.AtLeastOneFieldConstraint = AtLeastOneFieldConstraint;
-exports.AtLeastOneFieldConstraint = AtLeastOneFieldConstraint = __decorate([
-    (0, class_validator_1.ValidatorConstraint)({ name: 'atLeastOneField', async: false })
-], AtLeastOneFieldConstraint);
-function AtLeastOneField(properties, validationOptions) {
-    return function (object, propertyName) {
-        (0, class_validator_1.registerDecorator)({
-            target: object.constructor,
-            propertyName: propertyName,
-            options: Object.assign({ message: (0, nestjs_i18n_1.i18nValidationMessage)('validation.AT_LEAST_ONE_FIELD', {
-                    properties: properties.join(', '),
-                }) }, validationOptions),
-            constraints: [properties],
-            validator: AtLeastOneFieldConstraint,
-        });
-    };
-}
-function CustomValidation(validationCallback, validationOptions) {
-    return function (object, propertyName) {
-        (0, class_validator_1.registerDecorator)({
-            name: 'customValidation',
-            target: object.constructor,
-            propertyName,
-            options: Object.assign({ message: (0, nestjs_i18n_1.i18nValidationMessage)('validation.CUSTOM_VALIDATION') }, validationOptions),
-            validator: {
-                validate(value, args) {
-                    return __awaiter(this, void 0, void 0, function* () {
-                        try {
-                            return yield validationCallback(value, args);
-                        }
-                        catch (error) {
-                            console.error('CustomValidation error:', error);
-                            return false;
-                        }
-                    });
-                },
-                defaultMessage(args) {
-                    return `Validation failed for ${args.property}`;
-                },
-            },
-        });
-    };
-}
-function CustomValidationMethod(methodName, validationOptions) {
-    return function (object, propertyName) {
-        (0, class_validator_1.registerDecorator)({
-            name: 'customValidationMethod',
-            target: object.constructor,
-            propertyName,
-            constraints: [methodName],
-            options: Object.assign({ message: (0, nestjs_i18n_1.i18nValidationMessage)('validation.CUSTOM_VALIDATION_METHOD') }, validationOptions),
-            validator: {
-                validate(value, args) {
-                    return __awaiter(this, void 0, void 0, function* () {
-                        const [method] = args.constraints;
-                        const object = args.object;
-                        if (typeof object[method] !== 'function') {
-                            console.error(`CustomValidationMethod: Method '${method}' not found on object`);
-                            return false;
-                        }
-                        try {
-                            const result = yield object[method](value, args);
-                            return Boolean(result);
-                        }
-                        catch (error) {
-                            console.error(`CustomValidationMethod error in '${method}':`, error);
-                            return false;
-                        }
-                    });
-                },
-                defaultMessage(args) {
-                    const [method] = args.constraints;
-                    return `Validation failed for ${args.property} using method ${method}`;
-                },
-            },
-        });
-    };
-}
+Object.defineProperty(exports, "__esModule", { value: true });
+// 重新导出所有验证装饰器
+__exportStar(require("../validators/common-validators"), exports);
+__exportStar(require("../validators/custom-validate.validator"), exports);

package/file-upload/controllers/file-access.controller.d.ts

@@ -0,0 +1,23 @@
+import { StreamableFile } from '@nestjs/common';
+import { Response } from 'express';
+import { FileService } from '../services/file.service';
+/**
+ * 文件访问控制器
+ * 提供文件下载和预览功能
+ * 注意：Controller 仅负责 HTTP 层逻辑，业务逻辑在 FileService
+ */
+export declare class FileAccessController {
+    private readonly fileService;
+    private readonly logger;
+    constructor(fileService: FileService);
+    /**
+     * 通过文件 ID 下载/访问文件
+     * GET /files/:id
+     */
+    getFile(id: string, res: Response): Promise<StreamableFile>;
+    /**
+     * 通过文件 ID 下载文件（强制下载）
+     * GET /files/:id/download
+     */
+    downloadFile(id: string, res: Response): Promise<StreamableFile>;
+}

package/file-upload/controllers/file-access.controller.js

@@ -0,0 +1,128 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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 FileAccessController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileAccessController = void 0;
+const common_1 = require("@nestjs/common");
+const file_service_1 = require("../services/file.service");
+/**
+ * 文件访问控制器
+ * 提供文件下载和预览功能
+ * 注意：Controller 仅负责 HTTP 层逻辑，业务逻辑在 FileService
+ */
+let FileAccessController = FileAccessController_1 = class FileAccessController {
+    constructor(fileService) {
+        this.fileService = fileService;
+        this.logger = new common_1.Logger(FileAccessController_1.name);
+    }
+    /**
+     * 通过文件 ID 下载/访问文件
+     * GET /files/:id
+     */
+    getFile(id, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // 从数据库获取文件记录
+            const fileEntity = yield this.fileService.findById(id);
+            if (!fileEntity) {
+                throw new common_1.NotFoundException(`文件不存在: ${id}`);
+            }
+            // 检查文件是否可访问
+            if (fileEntity.status !== 'completed') {
+                throw new common_1.NotFoundException(`文件尚未准备就绪: ${id}`);
+            }
+            // 对象存储：重定向到预签名 URL
+            if (['s3', 'oss', 'minio', 'cdn'].includes(fileEntity.storageProvider)) {
+                try {
+                    const signedUrl = yield this.fileService.getSignedUrl(id);
+                    res.redirect(302, signedUrl);
+                    return;
+                }
+                catch (error) {
+                    this.logger.error(`Failed to get signed URL for file ${id}: ${error.message}`);
+                    throw new common_1.NotFoundException(`无法访问文件: ${id}`);
+                }
+            }
+            // 本地存储：流式返回
+            if (fileEntity.storageProvider === 'local') {
+                try {
+                    const stream = yield this.fileService.getFileStream(id);
+                    res.set({
+                        'Content-Type': fileEntity.mimeType,
+                        'Content-Length': fileEntity.size.toString(),
+                    });
+                    return new common_1.StreamableFile(stream);
+                }
+                catch (error) {
+                    this.logger.error(`Failed to stream file ${id}: ${error.message}`);
+                    throw new common_1.NotFoundException(`无法访问文件: ${id}`);
+                }
+            }
+            // 不支持的存储类型
+            throw new common_1.NotFoundException(`不支持的存储类型: ${fileEntity.storageProvider}`);
+        });
+    }
+    /**
+     * 通过文件 ID 下载文件（强制下载）
+     * GET /files/:id/download
+     */
+    downloadFile(id, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const fileEntity = yield this.fileService.findById(id);
+            if (!fileEntity) {
+                throw new common_1.NotFoundException(`文件不存在: ${id}`);
+            }
+            if (fileEntity.status !== 'completed') {
+                throw new common_1.NotFoundException(`文件尚未准备就绪: ${id}`);
+            }
+            // 设置下载响应头
+            res.set({
+                'Content-Disposition': `attachment; filename="${encodeURIComponent(fileEntity.originalName)}"`,
+            });
+            // 复用 getFile 逻辑
+            return this.getFile(id, res);
+        });
+    }
+};
+exports.FileAccessController = FileAccessController;
+__decorate([
+    (0, common_1.Get)(':id'),
+    (0, common_1.Header)('Cache-Control', 'public, max-age=31536000') // 缓存1年
+    ,
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], FileAccessController.prototype, "getFile", null);
+__decorate([
+    (0, common_1.Get)(':id/download'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], FileAccessController.prototype, "downloadFile", null);
+exports.FileAccessController = FileAccessController = FileAccessController_1 = __decorate([
+    (0, common_1.Controller)('files'),
+    __metadata("design:paramtypes", [file_service_1.FileService])
+], FileAccessController);

package/file-upload/decorators/column.decorator.d.ts

@@ -0,0 +1,151 @@
+import 'reflect-metadata';
+/**
+ * CSV列名映射元数据键
+ */
+export declare const CSV_COLUMN_METADATA = "csv:column";
+/**
+ * Excel列名映射元数据键
+ */
+export declare const EXCEL_COLUMN_METADATA = "excel:column";
+/**
+ * 列标识类型
+ * 可以是列名（字符串）、列序号（数字）或Excel列名（A, B, C）
+ */
+export type ColumnIdentifier = string | number;
+/**
+ * CSV列装饰器
+ * 用于指定CSV文件中列与DTO属性的映射关系
+ * 支持列名、列序号（从0开始）或Excel列名（A, B, C）
+ *
+ * @example
+ * ```typescript
+ * export class UserImportDto {
+ *   @CSVColumn('姓名')  // 使用列名
+ *   @CSVColumn(0)       // 使用列序号（第一列）
+ *   @CSVColumn('A')     // 使用Excel列名
+ *   @IsString()
+ *   @Length(2, 50)
+ *   name: string;
+ *
+ *   @CSVColumn('年龄')  // 使用列名
+ *   @CSVColumn(1)       // 使用列序号（第二列）
+ *   @CSVColumn('B')     // 使用Excel列名
+ *   @IsNumber()
+ *   @Min(0)
+ *   @Max(150)
+ *   age: number;
+ * }
+ * ```
+ */
+export declare function CSVColumn(columnIdentifier: ColumnIdentifier): PropertyDecorator;
+/**
+ * Excel列装饰器
+ * 用于指定Excel文件中列与DTO属性的映射关系
+ * 支持列名、列序号（从0开始）或Excel列名（A, B, C）
+ *
+ * @example
+ * ```typescript
+ * export class ProductImportDto {
+ *   @ExcelColumn('产品名称')  // 使用列名
+ *   @ExcelColumn(0)           // 使用列序号（第一列）
+ *   @ExcelColumn('A')         // 使用Excel列名
+ *   @IsString()
+ *   @Length(2, 200)
+ *   name: string;
+ *
+ *   @ExcelColumn('价格')     // 使用列名
+ *   @ExcelColumn(1)           // 使用列序号（第二列）
+ *   @ExcelColumn('B')         // 使用Excel列名
+ *   @IsNumber()
+ *   @Min(0)
+ *   price: number;
+ * }
+ * ```
+ */
+export declare function ExcelColumn(columnIdentifier: ColumnIdentifier): PropertyDecorator;
+/**
+ * 获取CSV列映射信息
+ * 返回列标识到属性名的映射Map
+ *
+ * @param dtoClass DTO类
+ * @returns Map<列标识, 属性名>
+ */
+export declare function getCsvColumnMapping(dtoClass: any): Map<ColumnIdentifier, string>;
+/**
+ * 获取Excel列映射信息
+ * 返回列标识到属性名的映射Map
+ *
+ * @param dtoClass DTO类
+ * @returns Map<列标识, 属性名>
+ */
+export declare function getExcelColumnMapping(dtoClass: any): Map<ColumnIdentifier, string>;
+/**
+ * Excel列名转数字（A=0, B=1, ..., AA=26, AB=27）
+ */
+export declare function excelColumnToNumber(columnLetter: string): number;
+/**
+ * 处理行数据
+ * 将原始数据行转换为DTO实例，支持多语言错误信息
+ * 支持列名、列序号和Excel列名（A, B, C）
+ *
+ * @param rowData 原始行数据
+ * @param dtoClass DTO类
+ * @param columnMapping 列映射
+ * @param type 数据类型（csv/excel）
+ * @returns 转换结果
+ */
+export declare function processRowWithMapping<T>(rowData: any, dtoClass: new () => T, columnMapping: Map<ColumnIdentifier, string>, type: 'csv' | 'excel'): {
+    instance: T;
+    errors: ValidationError[];
+};
+/**
+ * 数字转Excel列名（0=A, 1=B, ..., 26=AA, 27=AB）
+ */
+export declare function numberToExcelColumn(num: number): string;
+/**
+ * 验证错误接口
+ */
+interface ValidationError {
+    property: string;
+    value: any;
+    constraints: {
+        [key: string]: {
+            message: string;
+            values?: any[];
+        };
+    };
+}
+/**
+ * 格式化验证错误为多语言
+ * 支持中英文错误信息
+ *
+ * @param errors class-validator错误数组
+ * @returns 格式化后的错误信息
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string[];
+/**
+ * 创建CSV数据导入结果
+ * @param data 成功导入的数据
+ * @param errors 错误信息
+ * @param totalRows 总行数
+ * @param headers 表头信息
+ * @returns 导入结果对象
+ */
+export declare function createImportResult<T>(data: T[], errors: {
+    row: number;
+    errors: string[];
+    data: any;
+}[], totalRows: number, headers?: string[]): {
+    success: boolean;
+    data: T[];
+    errors: {
+        row: number;
+        errors: string[];
+        data: any;
+    }[];
+    totalCount: number;
+    successCount: number;
+    errorCount: number;
+    headers?: string[];
+};
+export {};