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

package/validators/common-validators.js

@@ -0,0 +1,249 @@
+"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;
+};
+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;
+const class_validator_1 = require("class-validator");
+const lodash_1 = require("lodash");
+const nestjs_i18n_1 = require("nestjs-i18n");
+/**
+ * 验证密码格式（只允许字母、数字和特定特殊字符）
+ *
+ * @param validationOptions 验证选项
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @IsPassword({ message: 'Invalid password format' })
+ *   password: string;
+ * }
+ * ```
+ */
+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);
+                },
+            },
+        });
+    };
+}
+/**
+ * 验证手机号码（支持指定国家/地区）
+ *
+ * @param validationOptions 验证选项，可以指定 region
+ *
+ * @example
+ * ```typescript
+ * class ContactDto {
+ *   @IsPhoneNumber({ region: 'CN' })
+ *   phone: string;
+ * }
+ * ```
+ */
+function IsPhoneNumber(validationOptions) {
+    return (0, class_validator_1.IsPhoneNumber)(validationOptions === null || validationOptions === void 0 ? void 0 : validationOptions.region, Object.assign({ message: 'error.phoneNumber' }, validationOptions));
+}
+/**
+ * 验证临时文件路径（必须以 tmp/ 开头）
+ *
+ * @param validationOptions 验证选项
+ *
+ * @example
+ * ```typescript
+ * class FileDto {
+ *   @IsTmpKey()
+ *   filePath: string; // 必须是 'tmp/...'
+ * }
+ * ```
+ */
+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';
+                },
+            },
+        });
+    };
+}
+/**
+ * 允许字段为 undefined，如果不是 undefined 才执行其他验证
+ *
+ * @param options 验证选项
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @IsUndefinable()
+ *   @IsString()
+ *   nickname?: string; // undefined 或字符串
+ * }
+ * ```
+ */
+function IsUndefinable(options) {
+    return (0, class_validator_1.ValidateIf)((obj, value) => value !== undefined, options);
+}
+/**
+ * 允许字段为空值（null、undefined 或空字符串），如果不为空才执行其他验证
+ *
+ * @param options 验证选项
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @IsEmptyable()
+ *   @IsEmail()
+ *   email?: string; // 可以为空，或者必须是有效邮箱
+ * }
+ * ```
+ */
+function IsEmptyable(options) {
+    return (0, class_validator_1.ValidateIf)((obj, value) => !(value === null ||
+        value === undefined ||
+        ((0, lodash_1.isString)(value) && value.trim() === '')), options);
+}
+/**
+ * 允许字段为 null，如果不是 null 才执行其他验证
+ *
+ * @param options 验证选项
+ *
+ * @example
+ * ```typescript
+ * class UserDto {
+ *   @IsNullable()
+ *   @IsNumber()
+ *   age?: number | null; // null 或数字
+ * }
+ * ```
+ */
+function IsNullable(options) {
+    return (0, class_validator_1.ValidateIf)((obj, value) => value !== null, options);
+}
+/**
+ * 验证 HTTP/HTTPS URL
+ *
+ * @param validationOptions 验证选项
+ *
+ * @example
+ * ```typescript
+ * class WebsiteDto {
+ *   @IsHttpUrl({ message: 'Invalid URL' })
+ *   url: string;
+ * }
+ * ```
+ */
+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://';
+                },
+            },
+        });
+    };
+}
+/**
+ * Validator constraint for AtLeastOneField decorator
+ */
+let AtLeastOneFieldConstraint = class AtLeastOneFieldConstraint {
+    validate(value, args) {
+        const object = args.object;
+        const [requiredProperties] = args.constraints;
+        // Check if at least one property has a value
+        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(', ')}`;
+    }
+};
+exports.AtLeastOneFieldConstraint = AtLeastOneFieldConstraint;
+exports.AtLeastOneFieldConstraint = AtLeastOneFieldConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'atLeastOneField', async: false })
+], AtLeastOneFieldConstraint);
+/**
+ * 验证至少提供指定字段中的一个
+ *
+ * @param properties 要检查的属性名数组
+ * @param validationOptions 验证选项
+ *
+ * @example
+ * ```typescript
+ * class ContactDto {
+ *   @AtLeastOneField(['email', 'phone'], {
+ *     message: 'Either email or phone must be provided'
+ *   })
+ *   email?: string;
+ *
+ *   phone?: string;
+ * }
+ * ```
+ *
+ * @example
+ * 使用虚拟字段（推荐用于类级别验证）：
+ * ```typescript
+ * class ContactDto {
+ *   @AtLeastOneField(['email', 'phone'])
+ *   _atLeastOne: any; // 虚拟字段用于验证
+ *
+ *   email?: string;
+ *   phone?: string;
+ * }
+ * ```
+ */
+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,
+        });
+    };
+}

package/validators/custom-validate.examples.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @CustomValidate 使用示例
+ *
+ * 这个文件包含了各种使用场景的示例代码
+ */
 import { Repository } from 'typeorm';
 import { ValidationContext } from '../validators/custom-validate.validator';
 export declare class Example1_InlineValidation {
@@ -16,9 +21,21 @@ export declare class Example2_EntityMethod {
 export declare class ExampleValidationService {
     private readonly userRepository;
     constructor(userRepository: Repository<any>);
+    /**
+     * 检查用户名是否可用
+     */
     usernameAvailable(username: string): Promise<boolean>;
+    /**
+     * 检查邮箱格式
+     */
     validateEmail(email: string): boolean;
+    /**
+     * 检查数值范围（带额外参数）
+     */
     checkRange(value: number, context: ValidationContext, min: number, max: number): boolean;
+    /**
+     * 复杂的业务验证
+     */
     validateBusinessRule(value: any, context: ValidationContext): Promise<boolean>;
 }
 export declare class Example3_ServiceValidation {
@@ -53,7 +70,13 @@ export declare class Example7_DynamicMessage {
     discount: number;
 }
 export declare class ThirdPartyValidationService {
+    /**
+     * 验证地址是否真实存在
+     */
     validateAddress(address: string): Promise<boolean>;
+    /**
+     * 验证税号是否有效
+     */
     validateTaxId(taxId: string, context: ValidationContext): Promise<boolean>;
 }
 export declare class Example8_ThirdPartyAPI {

package/validators/custom-validate.examples.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * @CustomValidate 使用示例
+ *
+ * 这个文件包含了各种使用场景的示例代码
+ */
 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);
@@ -26,6 +31,14 @@ const common_1 = require("@nestjs/common");
 const typeorm_1 = require("@nestjs/typeorm");
 const typeorm_2 = require("typeorm");
 const custom_validate_validator_1 = require("../validators/custom-validate.validator");
+// ============================================================================
+// Mock Entity（需要在使用前定义）
+// ============================================================================
+class UserEntity {
+}
+// ============================================================================
+// 示例 1: 内联函数验证
+// ============================================================================
 class Example1_InlineValidation {
 }
 exports.Example1_InlineValidation = Example1_InlineValidation;
@@ -42,15 +55,21 @@ __decorate([
 ], Example1_InlineValidation.prototype, "code", void 0);
 __decorate([
     (0, custom_validate_validator_1.CustomValidate)((value, context) => {
+        // 可以访问其他属性
         const minValue = context.object.minPrice || 0;
         return value > minValue;
     }, { message: '最大价格必须大于最小价格' }),
     __metadata("design:type", Number)
 ], Example1_InlineValidation.prototype, "maxPrice", void 0);
+// ============================================================================
+// 示例 2: Entity 方法验证
+// ============================================================================
 class Example2_EntityMethod {
+    // 同步验证方法
     validateVersion(value) {
         return /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(value);
     }
+    // 异步验证方法（可访问 this）
     checkDates(value, context) {
         return __awaiter(this, void 0, void 0, function* () {
             return value >= this.createdAt;
@@ -68,10 +87,17 @@ __decorate([
     (0, custom_validate_validator_1.CustomValidate)('checkDates'),
     __metadata("design:type", Date)
 ], Example2_EntityMethod.prototype, "publishedAt", void 0);
+// ============================================================================
+// 示例 3: Service 验��
+// ============================================================================
+// 验证 Service
 let ExampleValidationService = class ExampleValidationService {
     constructor(userRepository) {
         this.userRepository = userRepository;
     }
+    /**
+     * 检查用户名是否可用
+     */
     usernameAvailable(username) {
         return __awaiter(this, void 0, void 0, function* () {
             const count = yield this.userRepository.count({
@@ -80,14 +106,24 @@ let ExampleValidationService = class ExampleValidationService {
             return count === 0;
         });
     }
+    /**
+     * 检查邮箱格式
+     */
     validateEmail(email) {
         return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
     }
+    /**
+     * 检查数值范围（带额外参数）
+     */
     checkRange(value, context, min, max) {
         return value >= min && value <= max;
     }
+    /**
+     * 复杂的业务验证
+     */
     validateBusinessRule(value, context) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 复杂的业务逻辑
             const user = yield this.userRepository.findOne({
                 where: { id: context.object.userId },
                 relations: ['profile', 'permissions']
@@ -95,6 +131,7 @@ let ExampleValidationService = class ExampleValidationService {
             if (!user) {
                 return false;
             }
+            // 可以访问关联数据进行复杂验证
             return user.profile.isVerified && user.permissions.length > 0;
         });
     }
@@ -105,6 +142,7 @@ exports.ExampleValidationService = ExampleValidationService = __decorate([
     __param(0, (0, typeorm_1.InjectRepository)(UserEntity)),
     __metadata("design:paramtypes", [typeorm_2.Repository])
 ], ExampleValidationService);
+// 使用 Service 验证
 class Example3_ServiceValidation {
 }
 exports.Example3_ServiceValidation = Example3_ServiceValidation;
@@ -124,6 +162,9 @@ __decorate([
     (0, custom_validate_validator_1.CustomValidate)([ExampleValidationService, 'validateBusinessRule'], { message: '业务规则验证失败' }),
     __metadata("design:type", String)
 ], Example3_ServiceValidation.prototype, "businessField", void 0);
+// ============================================================================
+// 示例 4: 延迟引用（解决循环依赖）
+// ============================================================================
 class Example4_LazyReference {
 }
 exports.Example4_LazyReference = Example4_LazyReference;
@@ -131,14 +172,19 @@ __decorate([
     (0, custom_validate_validator_1.CustomValidate)([() => ExampleValidationService, 'usernameAvailable'], { message: '用户名已存在' }),
     __metadata("design:type", String)
 ], Example4_LazyReference.prototype, "username", void 0);
+// ============================================================================
+// 示例 5: 复杂验证场景
+// ============================================================================
 class Example5_ComplexValidation {
 }
 exports.Example5_ComplexValidation = Example5_ComplexValidation;
 __decorate([
     (0, custom_validate_validator_1.CustomValidate)((value, context) => __awaiter(void 0, void 0, void 0, function* () {
+        // 条件1：长度检查
         if (value.length < 8) {
             return false;
         }
+        // 条件2：复杂度检查
         const hasUpperCase = /[A-Z]/.test(value);
         const hasLowerCase = /[a-z]/.test(value);
         const hasNumber = /\d/.test(value);
@@ -146,6 +192,7 @@ __decorate([
         if (!(hasUpperCase && hasLowerCase && hasNumber && hasSpecial)) {
             return false;
         }
+        // 条件3���异步检查（是否在弱密码列表中）
         const response = yield fetch(`/api/check-weak-password`, {
             method: 'POST',
             body: JSON.stringify({ password: value }),
@@ -164,13 +211,17 @@ __decorate([
 ], Example5_ComplexValidation.prototype, "confirmPassword", void 0);
 __decorate([
     (0, custom_validate_validator_1.CustomValidate)((value, context) => {
+        // 只有当 requiresApproval 为 true 时才验证 approverId
         if (context.object.requiresApproval) {
             return value && value.length > 0;
         }
-        return true;
+        return true; // 不需要审批时，总是通过
     }, { message: '需要审批时必须指定审批人' }),
     __metadata("design:type", String)
 ], Example5_ComplexValidation.prototype, "approverId", void 0);
+// ============================================================================
+// 示例 6: 文件验证
+// ============================================================================
 let FileValidationService = class FileValidationService {
     constructor() {
         this.allowedMimeTypes = [
@@ -179,7 +230,7 @@ let FileValidationService = class FileValidationService {
             'image/gif',
             'application/pdf'
         ];
-        this.maxFileSize = 5 * 1024 * 1024;
+        this.maxFileSize = 5 * 1024 * 1024; // 5MB
     }
     checkFileType(mimeType) {
         return this.allowedMimeTypes.includes(mimeType);
@@ -190,6 +241,8 @@ let FileValidationService = class FileValidationService {
     }
     checkFileHash(hash) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 检查文件是否已存在（防重复上传）
+            // 实际实现：查询数据库
             return true;
         });
     }
@@ -206,13 +259,17 @@ __decorate([
     __metadata("design:type", String)
 ], Example6_FileUpload.prototype, "mimeType", void 0);
 __decorate([
-    (0, custom_validate_validator_1.CustomValidate)([FileValidationService, 'checkFileSize', 10 * 1024 * 1024], { message: '文件大小不能超过 10MB' }),
+    (0, custom_validate_validator_1.CustomValidate)([FileValidationService, 'checkFileSize', 10 * 1024 * 1024], // 10MB
+    { message: '文件大小不能超过 10MB' }),
     __metadata("design:type", Number)
 ], Example6_FileUpload.prototype, "size", void 0);
 __decorate([
     (0, custom_validate_validator_1.CustomValidate)([FileValidationService, 'checkFileHash'], { message: '文件已存在' }),
     __metadata("design:type", String)
 ], Example6_FileUpload.prototype, "hash", void 0);
+// ============================================================================
+// 示例 7: 动态错误消息
+// ============================================================================
 class Example7_DynamicMessage {
 }
 exports.Example7_DynamicMessage = Example7_DynamicMessage;
@@ -231,7 +288,13 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], Example7_DynamicMessage.prototype, "discount", void 0);
+// ============================================================================
+// 示例 8: 使用第三方 API 验证
+// ============================================================================
 let ThirdPartyValidationService = class ThirdPartyValidationService {
+    /**
+     * 验证地址是否真实存在
+     */
     validateAddress(address) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -245,6 +308,9 @@ let ThirdPartyValidationService = class ThirdPartyValidationService {
             }
         });
     }
+    /**
+     * 验证税号是否有效
+     */
     validateTaxId(taxId, context) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -278,28 +344,36 @@ __decorate([
     (0, custom_validate_validator_1.CustomValidate)([ThirdPartyValidationService, 'validateTaxId'], { message: '税号无效' }),
     __metadata("design:type", String)
 ], Example8_ThirdPartyAPI.prototype, "taxId", void 0);
+// ============================================================================
+// 示例 9: 性能优化 - 缓存
+// ============================================================================
 let CachedValidationService = class CachedValidationService {
     constructor() {
         this.cache = new Map();
-        this.cacheTTL = 5 * 60 * 1000;
+        this.cacheTTL = 5 * 60 * 1000; // 5分钟
     }
     expensiveValidation(value) {
         return __awaiter(this, void 0, void 0, function* () {
             const now = Date.now();
+            // 检查缓存
             const cached = this.cache.get(value);
             if (cached && (now - cached.timestamp) < this.cacheTTL) {
                 console.log(`[Cache Hit] Value: ${value}`);
                 return cached.result;
             }
+            // 执行昂贵的验证
             console.log(`[Cache Miss] Performing validation for: ${value}`);
             const result = yield this.doExpensiveCheck(value);
+            // 更新缓存
             this.cache.set(value, { result, timestamp: now });
+            // 清理过期缓存
             this.cleanExpiredCache();
             return result;
         });
     }
     doExpensiveCheck(value) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 模拟耗时操作（数据库查询、外部 API 等）
             yield new Promise(resolve => setTimeout(resolve, 1000));
             return true;
         });
@@ -324,5 +398,3 @@ __decorate([
     (0, custom_validate_validator_1.CustomValidate)([CachedValidationService, 'expensiveValidation'], { message: '验证失败' }),
     __metadata("design:type", String)
 ], Example9_CachedValidation.prototype, "field", void 0);
-class UserEntity {
-}

package/validators/custom-validate.validator.d.ts

@@ -1,26 +1,133 @@
 import type { ValidationArguments, ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
 import { ModuleRef } from '@nestjs/core';
+/**
+ * 验证上下文，传递给验证函数
+ */
 export interface ValidationContext {
+    /** 当前验证的值 */
     value: any;
+    /** 当前对象实例 */
     object: any;
+    /** 属性名 */
     property: string;
+    /** 约束参数（包含验证函数和额外参数） */
     constraints: any[];
+    /** 类名 */
     targetName: string;
+    /** 所有验证参数（原始 ValidationArguments） */
     args: ValidationArguments;
 }
+/**
+ * 验证函数类型
+ * @param value 当前验证的值
+ * @param context 验证上下文
+ * @param extraArgs 额外参数（可选）
+ * @returns boolean 或 Promise<boolean>
+ */
 export type ValidatorFunction = (value: any, context: ValidationContext, ...extraArgs: any[]) => boolean | Promise<boolean>;
+/**
+ * 验证约束类型
+ *
+ * 支持以下几种形式：
+ * 1. 直接函数：(value, context) => boolean
+ * 2. Entity 方法名：'methodName'
+ * 3. Service + 方法名：[ServiceClass, 'methodName']
+ * 4. 延迟引用 Service：[() => ServiceClass, 'methodName']
+ * 5. 带额外参数：[ServiceClass, 'methodName', arg1, arg2, ...]
+ */
 export type ValidationConstraint = ValidatorFunction | string | [Function | (() => Function), string, ...any[]];
+/**
+ * 装饰器选项
+ */
 export interface CustomValidateOptions extends ValidationOptions {
+    /** 错误消息（支持字符串、函数、i18n key） */
     message?: string | ((args: ValidationArguments) => string);
+    /** 是否异步（可选，会自动检测） */
     async?: boolean;
 }
 export declare class CustomValidateValidator implements ValidatorConstraintInterface {
     private readonly moduleRef;
     constructor(moduleRef: ModuleRef);
+    /**
+     * 验证入口
+     */
     validate(value: any, args: ValidationArguments): Promise<boolean>;
+    /**
+     * 调用内联函数
+     */
     private callFunction;
+    /**
+     * 调用 Entity 方法
+     */
     private callEntityMethod;
+    /**
+     * 调用 Service 方法
+     */
     private callServiceMethod;
+    /**
+     * 默认错误消息
+     */
     defaultMessage(args: ValidationArguments): string;
 }
+/**
+ * @CustomValidate 装饰器
+ *
+ * 支持多种验证方式的灵活验证装饰器
+ *
+ * @example
+ * // 1. 内联函数（同步）
+ * @CustomValidate(
+ *   (value) => value > 0,
+ *   { message: '价格必须大于0' }
+ * )
+ * price: number;
+ *
+ * @example
+ * // 2. 内联函数（异步）
+ * @CustomValidate(
+ *   async (value, context) => {
+ *     const response = await fetch(`/api/check/${value}`);
+ *     return response.ok;
+ *   }
+ * )
+ * username: string;
+ *
+ * @example
+ * // 3. Entity 方法
+ * @CustomValidate('validateVersion')
+ * version: string;
+ *
+ * validateVersion(value: string): boolean {
+ *   return /^\d+\.\d+\.\d+$/.test(value);
+ * }
+ *
+ * @example
+ * // 4. Service 方法
+ * @CustomValidate([UserValidationService, 'checkUsername'])
+ * username: string;
+ *
+ * @example
+ * // 5. 延迟引用（解决循环依赖）
+ * @CustomValidate([() => UserValidationService, 'checkUsername'])
+ * username: string;
+ *
+ * @example
+ * // 6. 带额外参数
+ * @CustomValidate(
+ *   [ValidationService, 'checkRange', 0, 100],
+ *   { message: '价格必须在 0-100 之间' }
+ * )
+ * price: number;
+ *
+ * @example
+ * // 7. 使用 i18n
+ * @CustomValidate(
+ *   (value) => value.length >= 6,
+ *   { message: 'validation.PASSWORD_TOO_SHORT' }
+ * )
+ * password: string;
+ *
+ * @param constraint 验证约束（函数、方法名、或 [Service, 方法名]）
+ * @param validationOptions 验证选项
+ */
 export declare function CustomValidate(constraint: ValidationConstraint, validationOptions?: CustomValidateOptions): PropertyDecorator;