@qimen-lab/core 0.1.3 → 0.1.5

package/dist/validation/core/executor.esm.js

@@ -0,0 +1,87 @@
+/**
+ * 验证执行器
+ *
+ * 使用统一的 pipeline 执行器
+ * 避免重复实现监控、日志等功能
+ *
+ * @module validation/executor
+ */
+import { Pipeline } from '../../pipeline/index.esm.js';
+/**
+ * 验证执行器
+ *
+ * @description 简单封装 pipeline，提供验证专用的执行接口
+ *
+ * @example
+ * import { ValidationExecutor } from '@/validation';
+ *
+ * const executor = new ValidationExecutor();
+ *
+ * // 执行验证管道
+ * const result = await executor.execute(context, processors);
+ *
+ * // 打印报告
+ * executor.printReport(result);
+ */
+export class ValidationExecutor {
+    constructor() {
+        /**
+         * 管道执行器实例
+         */
+        this.pipeline = new Pipeline();
+    }
+    /**
+     * 执行验证管道
+     *
+     * @param context 验证上下文
+     * @param processors 处理器列表
+     * @param ruleType 规则类型（用于日志）
+     * @returns 执行结果
+     *
+     * @example
+     * const processors = Validator.get('string');
+     * const result = await executor.execute(context, processors, 'string');
+     */
+    async execute(context, processors, ruleType) {
+        // 转换为 pipeline 的处理器格式
+        const pipelineProcessors = processors.map(processor => ({
+            name: processor.name,
+            weight: processor.weight,
+            offset: processor.offset,
+            description: processor.description,
+            execute: async (ctx) => {
+                await processor.execute(ctx);
+            },
+        }));
+        // 直接使用 pipeline 执行
+        return await this.pipeline.execute(context, pipelineProcessors, {
+            enableTracking: true,
+            enableTiming: true,
+            breakOnError: false, // 验证不中断，收集所有错误
+            pipelineName: ruleType ? `Validation:${ruleType}` : 'Validation',
+        });
+    }
+    /**
+     * 获取执行统计
+     */
+    getStats() {
+        return this.pipeline.getStats();
+    }
+    /**
+     * 重置统计
+     */
+    resetStats() {
+        this.pipeline.resetStats();
+    }
+    /**
+     * 打印执行报告
+     */
+    printReport(result) {
+        this.pipeline.printReport(result);
+    }
+}
+/**
+ * 默认验证执行器实例
+ */
+export const validationExecutor = new ValidationExecutor();
+//# sourceMappingURL=executor.js.map

package/dist/validation/core/executor.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../src/validation/core/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACI;;WAEG;QACK,aAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAuDtC,CAAC;IArDG;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,OAA0B,EAAE,UAAiB,EAAE,QAAiB;QAC1E,sBAAsB;QACtB,MAAM,kBAAkB,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,OAAO,EAAE,KAAK,EAAE,GAAsB,EAAE,EAAE;gBACtC,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,mBAAmB;QACnB,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE;YAC5D,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,KAAK,EAAE,eAAe;YACpC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC,CAAC,YAAY;SACnE,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,UAAU;QACN,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAW;QACnB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/validation/core/executor.js

@@ -9,7 +9,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validationExecutor = exports.ValidationExecutor = void 0;
-const pipeline_1 = require("@/pipeline");
+const pipeline_1 = require("../../pipeline/index.js");
 /**
  * 验证执行器
  *

package/dist/validation/core/index.esm.js

@@ -0,0 +1,4 @@
+export * from './ValidatorRegistrar';
+export * from './validate';
+export * from './executor';
+//# sourceMappingURL=index.js.map

package/dist/validation/core/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/validation/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/validation/core/validate.esm.js

@@ -0,0 +1,61 @@
+// 对外入口函数：用户只传 value 和 rule
+import { ValidatorRegistrar } from './ValidatorRegistrar';
+import { validationExecutor } from './executor';
+/**
+ * 上下文构造工厂
+ */
+export function createContext(value, rule, partial = {}) {
+    return {
+        // 核心数据
+        value,
+        rawValue: value,
+        rule,
+        path: partial.path || 'root',
+        // 状态控制
+        terminate: false,
+        // 收集桶
+        errors: [],
+        steps: [], // 执行日志记录
+        status: {
+            isUndefined: false,
+            isNull: false,
+            isNaN: false,
+            isEmpty: false,
+            isModified: false,
+        },
+        // 运行时元数据（可以存放临时计算结果，供下游处理器使用）
+        metadata: {},
+        // 混入外部传入的参数（如全局配置、多语言 i18n 等）
+        ...partial,
+    };
+}
+/**
+ * 验证函数
+ *
+ * @description 使用统一的 pipeline 执行器
+ *
+ * @param value 要验证的值
+ * @param rule 验证规则
+ * @param partialContext 部分上下文（可选）
+ * @returns 验证结果
+ */
+export const doValidate = async (value, rule, partialContext = {}) => {
+    // 1. 构造验证上下文
+    const context = createContext(value, rule, partialContext);
+    // 2. 获取验证器注册表
+    const validator = ValidatorRegistrar.getInstance();
+    // 3. 根据 rule.type 获取处理器列表
+    const processors = validator.get(rule.type);
+    // 4. 使用统一的执行器执行验证管道
+    const result = await validationExecutor.execute(context, processors, rule.type);
+    // 5. 合并执行步骤到 context
+    context.steps = result.steps;
+    // 6. 返回验证结果
+    return {
+        isValid: result.isSuccess && context.errors.length === 0,
+        errors: context.errors,
+        value: context.value,
+        context: result.context,
+    };
+};
+//# sourceMappingURL=validate.js.map

package/dist/validation/core/validate.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/validation/core/validate.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAI3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,KAAU,EACV,IAAoB,EACpB,UAAsC,EAAE;IAExC,OAAO;QACH,OAAO;QACP,KAAK;QACL,QAAQ,EAAE,KAAK;QACf,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QAE5B,OAAO;QACP,SAAS,EAAE,KAAK;QAEhB,MAAM;QACN,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE,EAAE,SAAS;QACpB,MAAM,EAAE;YACJ,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,KAAK;SACpB;QAED,8BAA8B;QAC9B,QAAQ,EAAE,EAAE;QAEZ,8BAA8B;QAC9B,GAAG,OAAO;KACb,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,GAAG,EAAE,EAAE,EAAE;IACnF,aAAa;IACb,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAE3D,cAAc;IACd,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;IAEnD,0BAA0B;IAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,oBAAoB;IACpB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhF,qBAAqB;IACrB,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAE7B,YAAY;IACZ,OAAO;QACH,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QACxD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC;AACN,CAAC,CAAC"}

package/dist/validation/engine/index.esm.js

@@ -0,0 +1,2 @@
+export * from './validate';
+//# sourceMappingURL=index.js.map

package/dist/validation/engine/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/validation/engine/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/validation/engine/validate.esm.js

@@ -0,0 +1,48 @@
+import { doValidate } from '../core';
+import { ValidationErrorBuilder } from '../errors';
+import { allValidateTypes, formatTypes, } from '../types';
+const doValidateWithThrow = async (value, rule, thorwError = false) => {
+    const result = await doValidate(value, rule);
+    if (thorwError && !result.isValid) {
+        ValidationErrorBuilder.throwIfAny(value, rule, result.errors, { ...result.context });
+    }
+    return result.isValid ? null : result.errors;
+};
+/**
+ * 解析值：处理默认值并返回最终结果
+ */
+const normalizeValue = async (value, defaultValue, rule) => {
+    const result = await doValidate(value, rule);
+    // 逻辑：只有当“确实有错”且“业务要求必填”时，才动用那个保底的 defaultValue
+    if (result.errors && rule.required) {
+        // 如果此时 defaultValue 也是 undefined，那说明调用者配置失误
+        // 我们可以返回一个 null 或者原值，但逻辑上这里必须有一个确定的值
+        return defaultValue;
+    }
+    return value;
+};
+const specialTypes = {
+    split: (r) => ({ separator: ',', ...r, type: 'split' }),
+};
+const SCHEMA_MAP = { ...specialTypes };
+allValidateTypes.forEach(tag => {
+    SCHEMA_MAP[tag] = (r) => ({ ...r, type: tag });
+});
+formatTypes.forEach(type => {
+    SCHEMA_MAP[type] = (r) => ({ ...r, type: 'format', format: type });
+});
+const validateRaw = {
+    validate: (value, rule) => doValidateWithThrow(value, rule),
+};
+const normalizeRaw = {};
+const assertRaw = {};
+Object.keys(SCHEMA_MAP).forEach(tag => {
+    const factory = SCHEMA_MAP[tag];
+    validateRaw[tag] = async (v, r = {}) => await doValidateWithThrow(v, factory(r));
+    normalizeRaw[tag] = async (v, defaultValue, r = {}) => await normalizeValue(v, defaultValue, factory(r));
+    assertRaw[tag] = async (v, r = {}) => await doValidateWithThrow(v, factory(r), true);
+});
+export const validate = validateRaw;
+export const assert = assertRaw;
+export const normalize = normalizeRaw;
+//# sourceMappingURL=validate.js.map

package/dist/validation/engine/validate.esm.js.map

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

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

@@ -1,4 +1,4 @@
-import { ErrorBase } from '@/error';
+import { ErrorBase } from '../../error/index.d.ts';
 /**
  * 重复注册验证器错误
  * 当尝试注册一个已经存在的验证器时会抛出此错误

package/dist/validation/errors/DuplicateValidatorError.esm.js

@@ -0,0 +1,30 @@
+// 导入基础错误类，用于继承并创建自定义错误类型
+import { ErrorBase } from '../../error/index.esm.js';
+/**
+ * 重复注册验证器错误
+ * 当尝试注册一个已经存在的验证器时会抛出此错误
+ */
+export class DuplicateValidatorError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的 DuplicateValidatorError 实例
+     * @param validatorKey - 发生冲突的验证器键名（唯一标识符）
+     * @param existingValidatorInfo - 已存在验证器的相关信息（可选）
+     * @param context - 其他上下文信息对象（可选）
+     */
+    constructor(validatorKey, // 验证器键名，用于标识哪个验证器发生了重复注册
+    existingValidatorInfo, // 已存在验证器的信息，提供关于已注册验证器的详细信息
+    context // 上下文信息（可选），可用于传递其他相关的调试或追踪数据
+    ) {
+        // 根据是否存在 existingValidatorInfo 来构建不同的错误消息
+        const message = existingValidatorInfo
+            ? `Validator with key "${validatorKey}" is already registered. Existing validator: ${existingValidatorInfo}`
+            : `Validator with key "${validatorKey}" is already registered.`;
+        // 调用父类 BaseError 的构造函数，传递错误消息、错误代码和错误上下文
+        super(message, 'DUPLICATE_VALIDATOR', {
+            validatorKey, // 包含验证器键名
+            existingValidatorInfo, // 包含已存在验证器的信息（如果有的话）
+            ...context, // 展开传入的额外上下文信息
+        });
+    }
+}
+//# sourceMappingURL=DuplicateValidatorError.js.map

package/dist/validation/errors/DuplicateValidatorError.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateValidatorError.js","sourceRoot":"","sources":["../../../../src/validation/errors/DuplicateValidatorError.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IAClD;;;;;OAKG;IACH,YACI,YAAoB,EAAE,yBAAyB;IAC/C,qBAA8B,EAAE,4BAA4B;IAC5D,OAA6B,CAAC,8BAA8B;;QAE5D,0CAA0C;QAC1C,MAAM,OAAO,GAAG,qBAAqB;YACjC,CAAC,CAAC,uBAAuB,YAAY,gDAAgD,qBAAqB,EAAE;YAC5G,CAAC,CAAC,uBAAuB,YAAY,0BAA0B,CAAC;QAEpE,yCAAyC;QACzC,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE;YAClC,YAAY,EAAE,UAAU;YACxB,qBAAqB,EAAE,qBAAqB;YAC5C,GAAG,OAAO,EAAE,eAAe;SAC9B,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/validation/errors/DuplicateValidatorError.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DuplicateValidatorError = void 0;
 // 导入基础错误类，用于继承并创建自定义错误类型
-const error_1 = require("@/error");
+const error_1 = require("../../error/index.js");
 /**
  * 重复注册验证器错误
  * 当尝试注册一个已经存在的验证器时会抛出此错误

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

@@ -1,4 +1,4 @@
-import { ErrorBase } from '@/error';
+import { ErrorBase } from '../../error/index.d.ts';
 /**
  * 验证错误类
  * 在数据验证失败时抛出此错误，包含详细的验证错误信息

package/dist/validation/errors/ValidationError.esm.js

@@ -0,0 +1,64 @@
+// 导入基础错误类，用于扩展自定义错误类型
+import { ErrorBase } from '../../error/index.esm.js';
+/**
+ * 验证错误类
+ * 在数据验证失败时抛出此错误，包含详细的验证错误信息
+ */
+export class ValidationError extends ErrorBase {
+    /**
+     * 构造一个新的验证错误实例
+     *
+     * @param message - 错误的主要描述信息
+     * @param code - 错误代码，默认为 'VALIDATION_FAILED'
+     * @param errors - 验证错误详情数组，默认为空数组
+     * @param context - 额外的上下文信息（可选）
+     */
+    constructor(message, code = 'VALIDATION_FAILED', errors = [], context) {
+        // 将 errors 添加到上下文中以便统一访问
+        const extendedContext = context ? { ...context, errors } : { errors };
+        // 调用基类构造函数
+        super(message, code, extendedContext);
+        this.name = 'ValidationError';
+        this.errors = errors;
+    }
+    /**
+     * 添加单个错误详情到错误列表中
+     *
+     * @param field - 出错的字段名
+     * @param message - 字段验证失败的具体消息
+     * @returns 返回当前实例以支持链式调用
+     */
+    addError(field, message) {
+        this.errors.push({ field, message });
+        // 同步更新上下文中的 errors 保证数据一致性
+        if (this.context) {
+            this.context.errors = this.errors;
+        }
+        return this;
+    }
+    /**
+     * 检查当前错误实例是否包含任何验证错误
+     *
+     * @returns 如果有错误返回 true，否则返回 false
+     */
+    hasErrors() {
+        return this.errors.length > 0;
+    }
+    /**
+     * 将错误信息转换为简化对象格式
+     * 格式为 { fieldName: [message1, message2, ...] }
+     *
+     * @returns 按字段分组的错误消息对象
+     */
+    toSimpleObject() {
+        const result = {};
+        this.errors.forEach(error => {
+            if (!result[error.field]) {
+                result[error.field] = [];
+            }
+            result[error.field].push(error.message);
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=ValidationError.js.map

package/dist/validation/errors/ValidationError.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../../../src/validation/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAO1C;;;;;;;OAOG;IACH,YACI,OAAe,EACf,OAAwB,mBAAmB,EAC3C,SAAqB,EAAE,EACvB,OAA6B;QAE7B,yBAAyB;QACzB,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAEtE,WAAW;QACX,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,KAAa,EAAE,OAAe;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACrC,2BAA2B;QAC3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,SAAS;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,cAAc;QACV,MAAM,MAAM,GAA6B,EAAE,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC7B,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/validation/errors/ValidationError.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidationError = void 0;
 // 导入基础错误类，用于扩展自定义错误类型
-const error_1 = require("@/error");
+const error_1 = require("../../error/index.js");
 /**
  * 验证错误类
  * 在数据验证失败时抛出此错误，包含详细的验证错误信息

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

@@ -1,4 +1,4 @@
-import { ErrorBase } from '@/error';
+import { ErrorBase } from '../../error/index.d.ts';
 /**
  * 验证类型未定义错误
  * 当请求使用一个未定义或不存在的验证类型时抛出此错误

package/dist/validation/errors/ValidationTypeNotDefinedError.esm.js

@@ -0,0 +1,26 @@
+// 导入基础错误类，作为自定义错误类型的基类
+import { ErrorBase } from '../../error/index.esm.js';
+/**
+ * 验证类型未定义错误
+ * 当请求使用一个未定义或不存在的验证类型时抛出此错误
+ *
+ * 通常发生在以下情况：
+ * 1. 尝试使用尚未注册的验证器类型
+ * 2. 验证配置中指定了无效的验证类型名称
+ * 3. 验证规则引用了不存在的验证类型
+ */
+export class ValidationTypeNotDefinedError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的验证类型未定义错误实例
+     *
+     * @param message - 错误的详细描述信息，说明具体是什么验证类型未定义
+     * @param context - 可选的上下文信息对象，可用于传递额外的调试信息，
+     *                  如验证器名称、配置详情等
+     */
+    constructor(message, context) {
+        // 调用父类构造函数，设置固定的错误代码 'VALIDATION_RULE_ERROR'
+        // 这有助于统一识别此类错误
+        super(message, 'VALIDATION_RULE_ERROR', context);
+    }
+}
+//# sourceMappingURL=ValidationTypeNotDefinedError.js.map

package/dist/validation/errors/ValidationTypeNotDefinedError.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationTypeNotDefinedError.js","sourceRoot":"","sources":["../../../../src/validation/errors/ValidationTypeNotDefinedError.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA8B,SAAQ,SAAS;IACxD;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,OAA6B;QACtD,6CAA6C;QAC7C,eAAe;QACf,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACJ"}

package/dist/validation/errors/ValidationTypeNotDefinedError.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidationTypeNotDefinedError = void 0;
 // 导入基础错误类，作为自定义错误类型的基类
-const error_1 = require("@/error");
+const error_1 = require("../../error/index.js");
 /**
  * 验证类型未定义错误
  * 当请求使用一个未定义或不存在的验证类型时抛出此错误

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

@@ -1,4 +1,4 @@
-import { ErrorBase } from '@/error';
+import { ErrorBase } from '../../error/index.d.ts';
 /**
  * 验证器未找到错误
  * 当系统无法找到与指定规则类型相对应的验证器时抛出此错误

package/dist/validation/errors/ValidatorNotFoundError.esm.js

@@ -0,0 +1,31 @@
+// 导入基础错误类，用于扩展自定义错误类型
+import { ErrorBase } from '../../error/index.esm.js';
+/**
+ * 验证器未找到错误
+ * 当系统无法找到与指定规则类型相对应的验证器时抛出此错误
+ *
+ * 此错误通常发生在以下情况：
+ * 1. 请求使用尚未注册的验证器类型
+ * 2. 验证规则配置中引用了不存在的验证器
+ * 3. 动态加载验证器时发生问题
+ */
+export class ValidatorNotFoundError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的验证器未找到错误实例
+     *
+     * @param type - 找不到的验证器类型名称
+     * @param context - 可选的上下文信息对象，可用于传递额外的调试信息，
+     *                  如字段名、验证规则配置等
+     */
+    constructor(type, context) {
+        // 构建描述性的错误消息，明确指出哪种类型的验证器未找到
+        const message = `Validator for rule type "${type}" not found`;
+        // 调用父类构造函数，传递错误消息、固定错误代码和上下文信息
+        // 将 type 添加到上下文中以便调试时更容易识别问题
+        super(message, 'VALIDATOR_NOT_FOUND', {
+            type,
+            ...context,
+        });
+    }
+}
+//# sourceMappingURL=ValidatorNotFoundError.js.map

package/dist/validation/errors/ValidatorNotFoundError.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorNotFoundError.js","sourceRoot":"","sources":["../../../../src/validation/errors/ValidatorNotFoundError.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACjD;;;;;;OAMG;IACH,YAAY,IAAY,EAAE,OAA6B;QACnD,6BAA6B;QAC7B,MAAM,OAAO,GAAG,4BAA4B,IAAI,aAAa,CAAC;QAE9D,+BAA+B;QAC/B,6BAA6B;QAC7B,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE;YAClC,IAAI;YACJ,GAAG,OAAO;SACb,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/validation/errors/ValidatorNotFoundError.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidatorNotFoundError = void 0;
 // 导入基础错误类，用于扩展自定义错误类型
-const error_1 = require("@/error");
+const error_1 = require("../../error/index.js");
 /**
  * 验证器未找到错误
  * 当系统无法找到与指定规则类型相对应的验证器时抛出此错误