@dangao/bun-server 1.7.1 → 1.8.0

package/dist/validation/class-validator.d.ts

@@ -0,0 +1,108 @@
+import 'reflect-metadata';
+import type { ValidationRuleDefinition, ClassValidationMetadata, ValidationOptions } from './types';
+import { type ValidationIssue } from './errors';
+/**
+ * 标记类需要验证
+ * 应用此装饰器后，类的实例可以使用 validateObject 函数进行验证
+ */
+export declare function ValidateClass(): ClassDecorator;
+/**
+ * 属性验证装饰器
+ * 用于 DTO 类的属性级别验证
+ *
+ * @example
+ * @ValidateClass()
+ * class CreateUserDto {
+ *   @Property(IsString(), MinLength(2))
+ *   name: string;
+ *
+ *   @Property(IsEmail())
+ *   email: string;
+ *
+ *   @Property(IsOptional(), IsNumber())
+ *   age?: number;
+ * }
+ */
+export declare function Property(...rules: ValidationRuleDefinition[]): PropertyDecorator;
+/**
+ * 获取类的验证元数据
+ */
+export declare function getClassValidationMetadata(target: new () => unknown): ClassValidationMetadata[];
+/**
+ * 检查类是否标记为需要验证
+ */
+export declare function isValidateClass(target: new () => unknown): boolean;
+/**
+ * 验证对象
+ *
+ * @param obj - 要验证的对象
+ * @param targetClass - DTO 类
+ * @param options - 验证选项
+ * @throws {ValidationError} 验证失败时抛出
+ *
+ * @example
+ * @ValidateClass()
+ * class CreateUserDto {
+ *   @Property(IsString(), MinLength(2))
+ *   name: string;
+ *
+ *   @Property(IsEmail())
+ *   email: string;
+ * }
+ *
+ * const dto = { name: 'A', email: 'invalid' };
+ * validateObject(dto, CreateUserDto); // throws ValidationError
+ */
+export declare function validateObject<T>(obj: unknown, targetClass: new () => T, options?: ValidationOptions): void;
+/**
+ * 验证对象并返回验证结果（不抛出异常）
+ *
+ * @param obj - 要验证的对象
+ * @param targetClass - DTO 类
+ * @param options - 验证选项
+ * @returns 验证结果
+ */
+export declare function validateObjectSync<T>(obj: unknown, targetClass: new () => T, options?: ValidationOptions): {
+    valid: boolean;
+    issues: ValidationIssue[];
+};
+/**
+ * 带嵌套类型的属性验证装饰器
+ * 用于嵌套对象验证
+ *
+ * @example
+ * @ValidateClass()
+ * class AddressDto {
+ *   @Property(IsString())
+ *   city: string;
+ * }
+ *
+ * @ValidateClass()
+ * class CreateUserDto {
+ *   @Property(IsString())
+ *   name: string;
+ *
+ *   @NestedProperty(AddressDto)
+ *   address: AddressDto;
+ * }
+ */
+export declare function NestedProperty<T>(nestedClass: new () => T): PropertyDecorator;
+/**
+ * 数组嵌套属性验证装饰器
+ * 用于数组中每个元素的验证
+ *
+ * @example
+ * @ValidateClass()
+ * class ItemDto {
+ *   @Property(IsString())
+ *   name: string;
+ * }
+ *
+ * @ValidateClass()
+ * class OrderDto {
+ *   @ArrayNestedProperty(ItemDto)
+ *   items: ItemDto[];
+ * }
+ */
+export declare function ArrayNestedProperty<T>(nestedClass: new () => T): PropertyDecorator;
+//# sourceMappingURL=class-validator.d.ts.map

package/dist/validation/class-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-validator.d.ts","sourceRoot":"","sources":["../../src/validation/class-validator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,aAAa,IAAI,cAAc,CAI9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,wBAAwB,EAAE,GAAG,iBAAiB,CAuBhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,OAAO,GAAG,uBAAuB,EAAE,CAE/F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,OAAO,GAAG,OAAO,CAElE;AAoGD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,UAAU,CAAC,EACxB,OAAO,GAAE,iBAAsB,GAC9B,IAAI,CAUN;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,UAAU,CAAC,EACxB,OAAO,GAAE,iBAAsB,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAQ/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAyB7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,iBAAiB,CA0BlF"}

package/dist/validation/custom-validator.d.ts

@@ -0,0 +1,130 @@
+import type { ValidationRuleDefinition } from './types';
+export interface CustomValidatorOptions {
+    message?: string;
+}
+/**
+ * 创建自定义验证器
+ *
+ * @param name - 验证器名称
+ * @param validate - 验证函数，接收值和可选参数，返回布尔值
+ * @param defaultMessage - 默认错误消息
+ * @returns 验证规则工厂函数
+ *
+ * @example
+ * // 创建手机号验证器
+ * const IsPhoneNumber = createCustomValidator(
+ *   'isPhoneNumber',
+ *   (value) => typeof value === 'string' && /^1[3-9]\d{9}$/.test(value),
+ *   '必须是有效的手机号码'
+ * );
+ *
+ * // 使用
+ * class UserDto {
+ *   @Validate(IsPhoneNumber())
+ *   phone: string;
+ * }
+ *
+ * @example
+ * // 创建带参数的验证器
+ * const IsDivisibleBy = createCustomValidator(
+ *   'isDivisibleBy',
+ *   (value, divisor: number) => typeof value === 'number' && value % divisor === 0,
+ *   (divisor: number) => `必须能被 ${divisor} 整除`
+ * );
+ *
+ * // 使用
+ * class NumberDto {
+ *   @Validate(IsDivisibleBy(5))
+ *   value: number;
+ * }
+ */
+export declare function createCustomValidator<TArgs extends unknown[] = []>(name: string, validate: (value: unknown, ...args: TArgs) => boolean, defaultMessage: string | ((...args: TArgs) => string)): (...args: TArgs) => (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 创建简单自定义验证器（无参数）
+ *
+ * @param name - 验证器名称
+ * @param validate - 验证函数
+ * @param defaultMessage - 默认错误消息
+ * @returns 验证规则工厂函数
+ *
+ * @example
+ * const IsPhoneNumber = createSimpleValidator(
+ *   'isPhoneNumber',
+ *   (value) => typeof value === 'string' && /^1[3-9]\d{9}$/.test(value),
+ *   '必须是有效的手机号码'
+ * );
+ *
+ * // 使用
+ * @Validate(IsPhoneNumber())
+ * phone: string;
+ */
+export declare function createSimpleValidator(name: string, validate: (value: unknown) => boolean, defaultMessage: string): (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 创建正则表达式验证器
+ *
+ * @param name - 验证器名称
+ * @param pattern - 正则表达式
+ * @param defaultMessage - 默认错误消息
+ * @returns 验证规则工厂函数
+ *
+ * @example
+ * const IsSlug = createRegexValidator(
+ *   'isSlug',
+ *   /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+ *   '必须是有效的 slug 格式'
+ * );
+ */
+export declare function createRegexValidator(name: string, pattern: RegExp, defaultMessage: string): (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证中国大陆手机号
+ */
+export declare const IsPhoneNumber: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证中国身份证号
+ */
+export declare const IsIdCard: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证 IP 地址 (IPv4)
+ */
+export declare const IsIPv4: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证端口号
+ */
+export declare const IsPort: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证邮政编码（中国）
+ */
+export declare const IsPostalCode: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证信用卡号（Luhn 算法）
+ */
+export declare const IsCreditCard: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证十六进制颜色值
+ */
+export declare const IsHexColor: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证 MAC 地址
+ */
+export declare const IsMacAddress: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证语义化版本号
+ */
+export declare const IsSemVer: (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 创建能被指定数字整除的验证器
+ */
+export declare const IsDivisibleBy: (divisor: number) => (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 创建范围验证器
+ */
+export declare const IsBetween: (min: number, max: number) => (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证是否包含指定子字符串
+ */
+export declare const Contains: (substring: string) => (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+/**
+ * 验证是否不包含指定子字符串
+ */
+export declare const NotContains: (substring: string) => (options?: CustomValidatorOptions) => ValidationRuleDefinition;
+//# sourceMappingURL=custom-validator.d.ts.map

package/dist/validation/custom-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-validator.d.ts","sourceRoot":"","sources":["../../src/validation/custom-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,OAAO,EAAE,GAAG,EAAE,EAChE,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACrD,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC,GACpD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAAwB,CAapF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EACrC,cAAc,EAAE,MAAM,GACrB,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAAwB,CAMhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAAwB,CAMhE;AAID;;GAEG;AACH,eAAO,MAAM,aAAa,aAxCZ,sBAAsB,KAAK,wBA4CxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,aAjDP,sBAAsB,KAAK,wBA4DxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,aAjEL,sBAAsB,KAAK,wBA6ExC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,aAlFL,sBAAsB,KAAK,wBA+FxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,aApGX,sBAAsB,KAAK,wBAwGxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,aA7GX,sBAAsB,KAAK,wBAmIxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,aAxIT,sBAAsB,KAAK,wBA4IxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,aAjJX,sBAAsB,KAAK,wBAuJxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,aA5JP,sBAAsB,KAAK,wBAoKxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,uBA/MH,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAoN5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,gCAzNC,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBA8N5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,yBAnOE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAwO5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,yBA7OD,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,wBAkP5D,CAAC"}

package/dist/validation/errors.d.ts

@@ -1,8 +1,12 @@
 export interface ValidationIssue {
     /**
-     * 参数索引
+     * 参数索引（参数级别验证使用）
      */
-    index: number;
+    index?: number;
+    /**
+     * 属性路径（类级别验证使用，支持嵌套如 'user.address.city'）
+     */
+    property?: string;
     /**
      * 失败的规则名称
      */
@@ -11,9 +15,25 @@ export interface ValidationIssue {
      * 错误信息
      */
     message: string;
+    /**
+     * 验证失败的值
+     */
+    value?: unknown;
+    /**
+     * 嵌套错误（用于嵌套对象验证）
+     */
+    children?: ValidationIssue[];
 }
 export declare class ValidationError extends Error {
     readonly issues: ValidationIssue[];
     constructor(message: string, issues: ValidationIssue[]);
+    /**
+     * 获取所有错误的扁平化列表
+     */
+    getFlattened(): ValidationIssue[];
+    /**
+     * 转换为简单的错误对象
+     */
+    toJSON(): Record<string, unknown>;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/validation/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/validation/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;CAK9D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/validation/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;IAM7D;;OAEG;IACI,YAAY,IAAI,eAAe,EAAE;IAmBxC;;OAEG;IACI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOzC"}

package/dist/validation/index.d.ts

@@ -1,5 +1,11 @@
 export { Validate, IsString, IsNumber, IsEmail, IsOptional, MinLength, getValidationMetadata, } from './decorators';
-export type { ValidationRuleDefinition, ValidationMetadata } from './types';
+export type { ValidationRuleDefinition, ValidationMetadata, ClassValidationMetadata, ValidationOptions, } from './types';
 export { validateParameters } from './validator';
 export { ValidationError, type ValidationIssue } from './errors';
+export { IsObject, IsNotEmpty, IsNotEmptyObject, ValidateNested, type ObjectRuleOptions, type ValidateNestedOptions, } from './rules/object';
+export { IsArray, ArrayMinSize, ArrayMaxSize, ArrayUnique, ArrayContains, ArrayNotContains, ArrayNotEmpty, type ArrayRuleOptions, } from './rules/array';
+export { IsBoolean, IsInt, IsPositive, IsNegative, Min, Max, IsDate, IsUUID, Length, MaxLength, Matches, IsIn, IsNotIn, IsUrl, IsJSON, Equals, NotEquals, IsDefined, IsAlphanumeric, IsAlpha, IsNumberString, type RuleOptions, type UUIDVersion, } from './rules/common';
+export { ValidateIf, Transform, type ConditionalRuleOptions, } from './rules/conditional';
+export { createCustomValidator, createSimpleValidator, createRegexValidator, IsPhoneNumber, IsIdCard, IsIPv4, IsPort, IsPostalCode, IsCreditCard, IsHexColor, IsMacAddress, IsSemVer, IsDivisibleBy, IsBetween, Contains, NotContains, type CustomValidatorOptions, } from './custom-validator';
+export { ValidateClass, Property, NestedProperty, ArrayNestedProperty, validateObject, validateObjectSync, getClassValidationMetadata, isValidateClass, } from './class-validator';
 //# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAGjE,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,UAAU,EACV,GAAG,EACH,GAAG,EACH,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,SAAS,EACT,cAAc,EACd,OAAO,EACP,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EAEpB,aAAa,EACb,QAAQ,EACR,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,QAAQ,EACR,WAAW,EACX,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/validation/rules/array.d.ts

@@ -0,0 +1,33 @@
+import type { ValidationRuleDefinition } from '../types';
+export interface ArrayRuleOptions {
+    message?: string;
+}
+/**
+ * 验证值是否为数组
+ */
+export declare function IsArray(options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组最小长度
+ */
+export declare function ArrayMinSize(min: number, options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组最大长度
+ */
+export declare function ArrayMaxSize(max: number, options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组元素是否唯一
+ */
+export declare function ArrayUnique(options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组是否包含指定的值
+ */
+export declare function ArrayContains(values: unknown[], options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组是否不包含指定的值
+ */
+export declare function ArrayNotContains(values: unknown[], options?: ArrayRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数组是否为非空数组
+ */
+export declare function ArrayNotEmpty(options?: ArrayRuleOptions): ValidationRuleDefinition;
+//# sourceMappingURL=array.d.ts.map

package/dist/validation/rules/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAMhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAMlG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAMlG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAoBpF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAiBzG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAiB5G;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,wBAAwB,CAMtF"}

package/dist/validation/rules/common.d.ts

@@ -0,0 +1,90 @@
+import type { ValidationRuleDefinition } from '../types';
+export interface RuleOptions {
+    message?: string;
+}
+/**
+ * 验证值是否为布尔值
+ */
+export declare function IsBoolean(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为整数
+ */
+export declare function IsInt(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为正数
+ */
+export declare function IsPositive(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为负数
+ */
+export declare function IsNegative(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数字最小值
+ */
+export declare function Min(min: number, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证数字最大值
+ */
+export declare function Max(max: number, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为日期
+ */
+export declare function IsDate(options?: RuleOptions): ValidationRuleDefinition;
+export type UUIDVersion = '3' | '4' | '5' | 'all';
+/**
+ * 验证值是否为 UUID
+ */
+export declare function IsUUID(version?: UUIDVersion, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证字符串长度
+ */
+export declare function Length(min: number, max?: number, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证字符串最大长度
+ */
+export declare function MaxLength(max: number, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否匹配正则表达式
+ */
+export declare function Matches(pattern: RegExp, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否在指定列表中
+ */
+export declare function IsIn(values: unknown[], options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否不在指定列表中
+ */
+export declare function IsNotIn(values: unknown[], options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为 URL
+ */
+export declare function IsUrl(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为 JSON 字符串
+ */
+export declare function IsJSON(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否相等
+ */
+export declare function Equals(comparison: unknown, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否不相等
+ */
+export declare function NotEquals(comparison: unknown, options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证是否为 null 或 undefined
+ */
+export declare function IsDefined(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证字符串是否只包含字母数字字符
+ */
+export declare function IsAlphanumeric(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证字符串是否只包含字母
+ */
+export declare function IsAlpha(options?: RuleOptions): ValidationRuleDefinition;
+/**
+ * 验证字符串是否只包含数字
+ */
+export declare function IsNumberString(options?: RuleOptions): ValidationRuleDefinition;
+//# sourceMappingURL=common.d.ts.map

package/dist/validation/rules/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM7E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM9E;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMpF;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMpF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAe1E;AAED,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;AASlD;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,WAAmB,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMxG;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAkBrG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM1F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM5F;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM3F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM9F;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAgBzE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAgB1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM/F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMlG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMlF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAM3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,wBAAwB,CAMlF"}

package/dist/validation/rules/conditional.d.ts

@@ -0,0 +1,30 @@
+import type { ValidationRuleDefinition } from '../types';
+export interface ConditionalRuleOptions {
+    message?: string;
+}
+/**
+ * 条件验证装饰器
+ * 只有当条件函数返回 true 时才执行后续验证
+ *
+ * @example
+ * class UpdateUserDto {
+ *   @Validate(ValidateIf((value, obj) => obj.type === 'premium'), IsEmail())
+ *   email?: string;
+ * }
+ */
+export declare function ValidateIf(condition: (value: unknown, obj?: unknown) => boolean, options?: ConditionalRuleOptions): ValidationRuleDefinition;
+/**
+ * 转换装饰器
+ * 在验证前转换值
+ *
+ * @example
+ * class CreateUserDto {
+ *   @Validate(Transform((value) => value?.trim()), IsString())
+ *   name: string;
+ *
+ *   @Validate(Transform((value) => Number(value)), IsInt(), Min(0))
+ *   age: number;
+ * }
+ */
+export declare function Transform(transformFn: (value: unknown) => unknown, options?: ConditionalRuleOptions): ValidationRuleDefinition;
+//# sourceMappingURL=conditional.d.ts.map

package/dist/validation/rules/conditional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/conditional.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,EACrD,OAAO,GAAE,sBAA2B,GACnC,wBAAwB,CAO1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EACxC,OAAO,GAAE,sBAA2B,GACnC,wBAAwB,CAO1B"}

package/dist/validation/rules/index.d.ts

@@ -0,0 +1,5 @@
+export { IsObject, IsNotEmpty, IsNotEmptyObject, ValidateNested, type ObjectRuleOptions, type ValidateNestedOptions, } from './object';
+export { IsArray, ArrayMinSize, ArrayMaxSize, ArrayUnique, ArrayContains, ArrayNotContains, ArrayNotEmpty, type ArrayRuleOptions, } from './array';
+export { IsBoolean, IsInt, IsPositive, IsNegative, Min, Max, IsDate, IsUUID, Length, MaxLength, Matches, IsIn, IsNotIn, IsUrl, IsJSON, Equals, NotEquals, IsDefined, IsAlphanumeric, IsAlpha, IsNumberString, type RuleOptions, type UUIDVersion, } from './common';
+export { ValidateIf, Transform, type ConditionalRuleOptions, } from './conditional';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,UAAU,EACV,GAAG,EACH,GAAG,EACH,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,SAAS,EACT,cAAc,EACd,OAAO,EACP,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC"}

package/dist/validation/rules/object.d.ts

@@ -0,0 +1,30 @@
+import type { ValidationRuleDefinition } from '../types';
+export interface ObjectRuleOptions {
+    message?: string;
+}
+/**
+ * 验证值是否为对象
+ */
+export declare function IsObject(options?: ObjectRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为非空（不是 null、undefined、空字符串、空数组、空对象）
+ */
+export declare function IsNotEmpty(options?: ObjectRuleOptions): ValidationRuleDefinition;
+/**
+ * 验证值是否为非空对象（对象且至少有一个属性）
+ */
+export declare function IsNotEmptyObject(options?: ObjectRuleOptions): ValidationRuleDefinition;
+export interface ValidateNestedOptions {
+    message?: string;
+    /**
+     * 是否对数组每个元素执行验证
+     * @default false
+     */
+    each?: boolean;
+}
+/**
+ * 嵌套对象验证装饰器
+ * 用于标记属性需要嵌套验证
+ */
+export declare function ValidateNested(options?: ValidateNestedOptions): ValidationRuleDefinition;
+//# sourceMappingURL=object.d.ts.map

package/dist/validation/rules/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,wBAAwB,CAMlF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,wBAAwB,CAoBpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,wBAAwB,CAW1F;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,wBAAwB,CAc5F"}

package/dist/validation/types.d.ts

@@ -9,12 +9,35 @@ export interface ValidationRuleDefinition {
     message: string;
     /**
      * 校验函数
+     * @param value - 要验证的值
+     * @param obj - 完整对象（用于条件验证）
      */
-    validate: (value: unknown) => boolean;
+    validate: (value: unknown, obj?: unknown) => boolean;
     /**
      * 是否为可选字段
      */
     optional?: boolean;
+    /**
+     * 条件验证函数
+     * 返回 true 时执行验证，返回 false 时跳过
+     */
+    condition?: (value: unknown, obj?: unknown) => boolean;
+    /**
+     * 转换函数（在验证前执行）
+     */
+    transform?: (value: unknown) => unknown;
+    /**
+     * 是否为嵌套验证
+     */
+    nested?: boolean;
+    /**
+     * 嵌套验证的类型
+     */
+    nestedType?: new () => unknown;
+    /**
+     * 是否对数组每个元素执行嵌套验证
+     */
+    each?: boolean;
 }
 export interface ValidationMetadata {
     /**
@@ -26,4 +49,32 @@ export interface ValidationMetadata {
      */
     rules: ValidationRuleDefinition[];
 }
+/**
+ * 类级别验证元数据
+ */
+export interface ClassValidationMetadata {
+    /**
+     * 属性名
+     */
+    property: string;
+    /**
+     * 规则列表
+     */
+    rules: ValidationRuleDefinition[];
+}
+/**
+ * 验证选项
+ */
+export interface ValidationOptions {
+    /**
+     * 是否在第一个错误时停止验证
+     * @default false
+     */
+    stopAtFirstError?: boolean;
+    /**
+     * 是否跳过缺失的属性
+     * @default false
+     */
+    skipMissingProperties?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/validation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAEvD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAExC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,OAAO,CAAC;IAE/B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC"}