@hestjs/validation 0.1.2

package/dist/pipes/validation.pipe.js

@@ -0,0 +1,186 @@
+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);
+};
+import { Injectable } from "@hestjs/core";
+import { Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+import { VALIDATION_METADATA_KEY, } from "../decorators/validation";
+/**
+ * 验证错误
+ */
+export class ValidationError extends Error {
+    field;
+    value;
+    constraint;
+    constructor(message, field, value, constraint) {
+        super(message);
+        this.field = field;
+        this.value = value;
+        this.constraint = constraint;
+        this.name = "ValidationError";
+    }
+}
+/**
+ * 验证异常 - 包含多个验证错误
+ */
+export class ValidationException extends Error {
+    errors;
+    constructor(errors) {
+        super("Validation failed");
+        this.errors = errors;
+        this.name = "ValidationException";
+    }
+    getMessages() {
+        return this.errors.map((error) => error.message);
+    }
+    getFormattedMessage() {
+        return this.errors
+            .map((error) => `${error.field}: ${error.message}`)
+            .join("; ");
+    }
+}
+/**
+ * 验证管道
+ */
+let ValidationPipe = class ValidationPipe {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            whitelist: true,
+            forbidNonWhitelisted: false,
+            transform: true,
+            disableErrorMessages: false,
+            validateCustomDecorators: true,
+            ...options,
+        };
+    }
+    /**
+     * 验证对象
+     */
+    async validate(target, object) {
+        if (!object || typeof object !== "object") {
+            throw new ValidationException([
+                new ValidationError("Invalid input", "root", object, "object"),
+            ]);
+        }
+        const metadata = Reflect.getMetadata(VALIDATION_METADATA_KEY, target);
+        if (!metadata || !metadata.properties.length) {
+            // 如果没有验证元数据，直接返回对象
+            return object;
+        }
+        const errors = [];
+        const result = {};
+        // 创建 TypeBox 对象 schema
+        const schemaProperties = {};
+        const requiredFields = [];
+        for (const prop of metadata.properties) {
+            const propName = String(prop.propertyKey);
+            schemaProperties[propName] = prop.schema;
+            if (!prop.isOptional) {
+                requiredFields.push(propName);
+            }
+        }
+        const objectSchema = Type.Object(schemaProperties, {
+            required: requiredFields,
+            additionalProperties: !this.options.whitelist,
+        });
+        // 使用 TypeBox 进行验证
+        const isValid = Value.Check(objectSchema, object);
+        if (!isValid) {
+            // 获取详细错误
+            const validationErrors = [...Value.Errors(objectSchema, object)];
+            for (const error of validationErrors) {
+                const field = error.path.replace(/^\//, "") || "root";
+                const customMessage = this.getCustomMessage(metadata, field);
+                errors.push(new ValidationError(customMessage || error.message, field, error.value, String(error.type || "validation")));
+            }
+        }
+        if (errors.length > 0) {
+            throw new ValidationException(errors);
+        }
+        // 如果启用了转换，使用 TypeBox 进行类型转换
+        if (this.options.transform) {
+            try {
+                const transformed = Value.Convert(objectSchema, object);
+                return this.filterProperties(transformed, metadata);
+            }
+            catch (error) {
+                // 转换失败，使用原始对象
+                return this.filterProperties(object, metadata);
+            }
+        }
+        return this.filterProperties(object, metadata);
+    }
+    /**
+     * 过滤属性（白名单模式）
+     */
+    filterProperties(object, metadata) {
+        if (!this.options.whitelist) {
+            return object;
+        }
+        const result = {};
+        const allowedProperties = new Set(metadata.properties.map((prop) => String(prop.propertyKey)));
+        for (const [key, value] of Object.entries(object)) {
+            if (allowedProperties.has(key)) {
+                result[key] = value;
+            }
+            else if (this.options.forbidNonWhitelisted) {
+                throw new ValidationException([
+                    new ValidationError(`Property ${key} should not exist`, key, value, "whitelistValidation"),
+                ]);
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取自定义错误消息
+     */
+    getCustomMessage(metadata, field) {
+        const property = metadata.properties.find((prop) => String(prop.propertyKey) === field);
+        return property?.message;
+    }
+    /**
+     * 验证单个值
+     */
+    validateValue(schema, value, fieldName = "value") {
+        const isValid = Value.Check(schema, value);
+        if (!isValid) {
+            const errors = [...Value.Errors(schema, value)];
+            const validationErrors = errors.map((error) => new ValidationError(error.message, fieldName, error.value, String(error.type || "validation")));
+            throw new ValidationException(validationErrors);
+        }
+        if (this.options.transform) {
+            try {
+                return Value.Convert(schema, value);
+            }
+            catch {
+                return value;
+            }
+        }
+        return value;
+    }
+    /**
+     * 创建 DTO 验证装饰器
+     */
+    static createDtoValidator(dtoClass) {
+        return function (target, propertyKey, parameterIndex) {
+            // 这里可以存储参数验证元数据
+            // 实际的验证会在拦截器中进行
+            const existingMetadata = Reflect.getMetadata("validation:parameters", target) || {};
+            existingMetadata[parameterIndex] = dtoClass;
+            Reflect.defineMetadata("validation:parameters", existingMetadata, target);
+        };
+    }
+};
+ValidationPipe = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], ValidationPipe);
+export { ValidationPipe };
+//# sourceMappingURL=validation.pipe.js.map

package/dist/pipes/validation.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.pipe.js","sourceRoot":"","sources":["../../src/pipes/validation.pipe.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.utils.d.ts

@@ -0,0 +1,50 @@
+import { type TSchema } from '@sinclair/typebox';
+/**
+ * 验证工具类
+ */
+export declare class ValidationUtils {
+    private static readonly defaultPipe;
+    /**
+     * 验证对象
+     */
+    static validateObject<T>(target: new () => T, object: any): Promise<T>;
+    /**
+     * 验证值
+     */
+    static validateValue<T>(schema: TSchema, value: any, fieldName?: string): T;
+    /**
+     * 检查对象是否有效
+     */
+    static isValid<T>(target: new () => T, object: any): Promise<boolean>;
+    /**
+     * 获取验证错误而不抛出异常
+     */
+    static getValidationErrors<T>(target: new () => T, object: any): Promise<string[]>;
+    /**
+     * 从类生成 TypeBox Schema
+     */
+    static generateSchema<T>(target: new () => T): TSchema;
+    /**
+     * 类型安全的转换函数
+     */
+    static transform<T>(schema: TSchema, value: any): T;
+    /**
+     * 创建自定义验证装饰器
+     */
+    static createCustomValidator(validator: (value: any) => boolean, message?: string): (target: any, propertyKey: string | symbol) => void;
+    /**
+     * 批量验证多个对象
+     */
+    static validateBatch<T>(target: new () => T, objects: any[]): Promise<{
+        valid: T[];
+        errors: Array<{
+            index: number;
+            errors: string[];
+        }>;
+    }>;
+    /**
+     * 验证部分对象（仅验证存在的字段）
+     */
+    static validatePartial<T>(target: new () => T, object: any): Promise<Partial<T>>;
+}
+//# sourceMappingURL=validation.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../src/utils/validation.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAe,MAAM,mBAAmB,CAAC;AAKpE;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAE3D;;OAEG;WACU,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC;IAI3E;;OAEG;WACU,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E;;OAEG;WACU,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAYxF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO;IAyBtD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAanD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,EAClC,OAAO,GAAE,MAAmC,IAE3B,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM;IAkB5D;;OAEG;WACU,aAAa,CAAC,CAAC,EAC1B,MAAM,EAAE,UAAU,CAAC,EACnB,OAAO,EAAE,GAAG,EAAE,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAuB9E;;OAEG;WACU,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAqCvF"}

package/dist/utils/validation.utils.js

@@ -0,0 +1,162 @@
+import { Type } from '@sinclair/typebox';
+import { Value } from '@sinclair/typebox/value';
+import { ValidationPipe, ValidationException } from '../pipes/validation.pipe';
+import { VALIDATION_METADATA_KEY } from '../decorators/validation';
+/**
+ * 验证工具类
+ */
+export class ValidationUtils {
+    static defaultPipe = new ValidationPipe();
+    /**
+     * 验证对象
+     */
+    static async validateObject(target, object) {
+        return this.defaultPipe.validate(target, object);
+    }
+    /**
+     * 验证值
+     */
+    static validateValue(schema, value, fieldName) {
+        return this.defaultPipe.validateValue(schema, value, fieldName);
+    }
+    /**
+     * 检查对象是否有效
+     */
+    static async isValid(target, object) {
+        try {
+            await this.validateObject(target, object);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * 获取验证错误而不抛出异常
+     */
+    static async getValidationErrors(target, object) {
+        try {
+            await this.validateObject(target, object);
+            return [];
+        }
+        catch (error) {
+            if (error instanceof ValidationException) {
+                return error.getMessages();
+            }
+            return [error instanceof Error ? error.message : 'Unknown validation error'];
+        }
+    }
+    /**
+     * 从类生成 TypeBox Schema
+     */
+    static generateSchema(target) {
+        const metadata = Reflect.getMetadata(VALIDATION_METADATA_KEY, target);
+        if (!metadata || !metadata.properties.length) {
+            return Type.Object({});
+        }
+        const properties = {};
+        const requiredFields = [];
+        for (const prop of metadata.properties) {
+            const propName = String(prop.propertyKey);
+            properties[propName] = prop.schema;
+            if (!prop.isOptional) {
+                requiredFields.push(propName);
+            }
+        }
+        return Type.Object(properties, {
+            required: requiredFields,
+            additionalProperties: false
+        });
+    }
+    /**
+     * 类型安全的转换函数
+     */
+    static transform(schema, value) {
+        try {
+            return Value.Convert(schema, value);
+        }
+        catch (error) {
+            throw new ValidationException([{
+                    message: `Transform failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    field: 'root',
+                    value,
+                    constraint: 'transform'
+                }]);
+        }
+    }
+    /**
+     * 创建自定义验证装饰器
+     */
+    static createCustomValidator(validator, message = 'Custom validation failed') {
+        return function (target, propertyKey) {
+            // 这里可以实现自定义验证逻辑
+            // 为了简化，我们使用一个通用的字符串验证
+            const schema = Type.String();
+            const existingMetadata = Reflect.getMetadata(VALIDATION_METADATA_KEY, target.constructor) || { properties: [] };
+            existingMetadata.properties.push({
+                propertyKey,
+                schema,
+                message,
+            });
+            Reflect.defineMetadata(VALIDATION_METADATA_KEY, existingMetadata, target.constructor);
+        };
+    }
+    /**
+     * 批量验证多个对象
+     */
+    static async validateBatch(target, objects) {
+        const valid = [];
+        const errors = [];
+        for (let i = 0; i < objects.length; i++) {
+            try {
+                const validated = await this.validateObject(target, objects[i]);
+                valid.push(validated);
+            }
+            catch (error) {
+                if (error instanceof ValidationException) {
+                    errors.push({ index: i, errors: error.getMessages() });
+                }
+                else {
+                    errors.push({
+                        index: i,
+                        errors: [error instanceof Error ? error.message : 'Unknown error']
+                    });
+                }
+            }
+        }
+        return { valid, errors };
+    }
+    /**
+     * 验证部分对象（仅验证存在的字段）
+     */
+    static async validatePartial(target, object) {
+        const pipe = new ValidationPipe({
+            whitelist: true,
+            forbidNonWhitelisted: false,
+            transform: true,
+        });
+        // 创建一个只包含存在字段的新类
+        const metadata = Reflect.getMetadata(VALIDATION_METADATA_KEY, target);
+        if (!metadata || !metadata.properties.length) {
+            return object;
+        }
+        // 过滤出存在的属性
+        const existingProps = metadata.properties.filter(prop => object.hasOwnProperty(String(prop.propertyKey)));
+        if (existingProps.length === 0) {
+            return {};
+        }
+        // 创建临时验证元数据
+        const tempMetadata = {
+            properties: existingProps.map(prop => ({
+                ...prop,
+                isOptional: true, // 所有字段都标记为可选
+            }))
+        };
+        // 创建临时类
+        class TempClass {
+        }
+        Reflect.defineMetadata(VALIDATION_METADATA_KEY, tempMetadata, TempClass);
+        return pipe.validate(TempClass, object);
+    }
+}
+//# sourceMappingURL=validation.utils.js.map

package/dist/utils/validation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.js","sourceRoot":"","sources":["../../src/utils/validation.utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@hestjs/validation",
+  "version": "0.1.2",
+  "description": "HestJS Validation Module with TypeBox",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@hestjs/core": "workspace:*",
+    "@sinclair/typebox": "^0.32.15",
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "5.8.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  }
+}