@qimen-lab/core 0.1.1

package/dist/validation/engine/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./validate"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/validation/engine/validate.d.ts

@@ -0,0 +1,35 @@
+import { ValidationRule, ValidateResult, StringRule, NumberRule, BooleanRule, FileRule, DateRule, ArrayRule, ObjectRule, CompareRule, SplitRule, FormatRule, PasswordRule } from '../types';
+interface RuleRegistry {
+    string: Omit<StringRule, 'type'>;
+    number: Omit<NumberRule, 'type'>;
+    boolean: Omit<BooleanRule, 'type'>;
+    date: Omit<DateRule, 'type'>;
+    array: Omit<ArrayRule, 'type'>;
+    object: Omit<ObjectRule, 'type'>;
+    password: Omit<PasswordRule, 'type'>;
+    compare: Omit<CompareRule, 'type'>;
+    file: Omit<FileRule, 'type'>;
+    split: Omit<SplitRule, 'type'>;
+    format: Omit<FormatRule, 'type'>;
+    email: Omit<FormatRule, 'type' | 'format'>;
+    url: Omit<FormatRule, 'type' | 'format'>;
+    phone: Omit<FormatRule, 'type' | 'format'>;
+    uuid: Omit<FormatRule, 'type' | 'format'>;
+    ipv4: Omit<FormatRule, 'type' | 'format'>;
+    ipv6: Omit<FormatRule, 'type' | 'format'>;
+    macAddress: Omit<FormatRule, 'type' | 'format'>;
+    hexColor: Omit<FormatRule, 'type' | 'format'>;
+    rgbColor: Omit<FormatRule, 'type' | 'format'>;
+    rgbaColor: Omit<FormatRule, 'type' | 'format'>;
+}
+type ValidatorSugar<T> = (value: any, rule: T) => Promise<ValidateResult>;
+type NormalizerSugar<T> = (value: any, fallbackValue: any, rule: T) => Promise<any>;
+export declare const validate: { readonly [K in keyof RuleRegistry]: ValidatorSugar<RuleRegistry[K]>; } & {
+    validate: (value: any, rule: ValidationRule) => Promise<ValidateResult>;
+};
+export declare const assert: { readonly [K in keyof RuleRegistry]: ValidatorSugar<RuleRegistry[K]>; } & {
+    validate: (value: any, rule: ValidationRule) => Promise<void>;
+};
+export declare const normalize: { readonly [K in keyof RuleRegistry]: NormalizerSugar<RuleRegistry[K]>; };
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/validation/engine/validate.d.ts.map

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

package/dist/validation/engine/validate.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize = exports.assert = exports.validate = void 0;
+const core_1 = require("../core");
+const errors_1 = require("../errors");
+const types_1 = require("../types");
+const doValidateWithThrow = async (value, rule, thorwError = false) => {
+    const result = await (0, core_1.doValidate)(value, rule);
+    if (thorwError && !result.isValid) {
+        errors_1.ValidationErrorBuilder.throwIfAny(value, rule, result.errors, { ...result.context });
+    }
+    return result.isValid ? null : result.errors;
+};
+/**
+ * 解析值：处理默认值并返回最终结果
+ */
+const normalizeValue = async (value, defaultValue, rule) => {
+    const result = await (0, core_1.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 };
+types_1.allValidateTypes.forEach(tag => {
+    SCHEMA_MAP[tag] = (r) => ({ ...r, type: tag });
+});
+types_1.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);
+});
+exports.validate = validateRaw;
+exports.assert = assertRaw;
+exports.normalize = normalizeRaw;
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/validation/engine/validate.ts"],"names":[],"mappings":";;;AAAA,kCAAqC;AACrC,sCAAmD;AACnD,oCAgBkB;AAElB,MAAM,mBAAmB,GAAG,KAAK,EAC7B,KAAU,EACV,IAAoB,EACpB,UAAU,GAAG,KAAK,EACK,EAAE;IACzB,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,UAAU,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAChC,+BAAsB,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG,KAAK,EACxB,KAAU,EACV,YAAiB,EACjB,IAAoB,EACR,EAAE;IACd,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAU,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE7C,+CAA+C;IAC/C,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,4CAA4C;QAC5C,qCAAqC;QACrC,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AA0BF,MAAM,YAAY,GAAG;IACjB,KAAK,EAAE,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;CACjF,CAAC;AAEF,MAAM,UAAU,GAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;AAE5C,wBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;IAC3B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH,mBAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;IACvB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAQ;IACrB,QAAQ,EAAE,CAAC,KAAU,EAAE,IAAoB,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;CACnF,CAAC;AAEF,MAAM,YAAY,GAAQ,EAAE,CAAC;AAE7B,MAAM,SAAS,GAAQ,EAAE,CAAC;AAK1B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAM,EAAE,IAAS,EAAE,EAAE,EAAE,CAAC,MAAM,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAM,EAAE,YAAiB,EAAE,IAAS,EAAE,EAAE,EAAE,CACjE,MAAM,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAM,EAAE,IAAS,EAAE,EAAE,EAAE,CAAC,MAAM,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC;AAEU,QAAA,QAAQ,GAAG,WAKvB,CAAC;AAEW,QAAA,MAAM,GAAG,SAIrB,CAAC;AAEW,QAAA,SAAS,GAAG,YAExB,CAAC"}

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

@@ -0,0 +1,17 @@
+import { ErrorBase } from '@/error';
+/**
+ * 重复注册验证器错误
+ * 当尝试注册一个已经存在的验证器时会抛出此错误
+ */
+export declare class DuplicateValidatorError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的 DuplicateValidatorError 实例
+     * @param validatorKey - 发生冲突的验证器键名（唯一标识符）
+     * @param existingValidatorInfo - 已存在验证器的相关信息（可选）
+     * @param context - 其他上下文信息对象（可选）
+     */
+    constructor(validatorKey: string, // 验证器键名，用于标识哪个验证器发生了重复注册
+    existingValidatorInfo?: string, // 已存在验证器的信息，提供关于已注册验证器的详细信息
+    context?: Record<string, any>);
+}
+//# sourceMappingURL=DuplicateValidatorError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateValidatorError.d.ts","sourceRoot":"","sources":["../../../../src/validation/errors/DuplicateValidatorError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IAClD;;;;;OAKG;gBAEC,YAAY,EAAE,MAAM,EAAE,yBAAyB;IAC/C,qBAAqB,CAAC,EAAE,MAAM,EAAE,4BAA4B;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAcpC"}

package/dist/validation/errors/DuplicateValidatorError.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateValidatorError = void 0;
+// 导入基础错误类，用于继承并创建自定义错误类型
+const error_1 = require("@/error");
+/**
+ * 重复注册验证器错误
+ * 当尝试注册一个已经存在的验证器时会抛出此错误
+ */
+class DuplicateValidatorError extends error_1.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, // 展开传入的额外上下文信息
+        });
+    }
+}
+exports.DuplicateValidatorError = DuplicateValidatorError;
+//# sourceMappingURL=DuplicateValidatorError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicateValidatorError.js","sourceRoot":"","sources":["../../../../src/validation/errors/DuplicateValidatorError.ts"],"names":[],"mappings":";;;AAAA,yBAAyB;AACzB,mCAAoC;AAEpC;;;GAGG;AACH,MAAa,uBAAwB,SAAQ,iBAAS;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;AAxBD,0DAwBC"}

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

@@ -0,0 +1,46 @@
+import { ErrorBase } from '@/error';
+/**
+ * 验证错误类
+ * 在数据验证失败时抛出此错误，包含详细的验证错误信息
+ */
+export declare class ValidationError extends ErrorBase {
+    /**
+     * 存储具体的验证错误列表
+     * 每个错误项包含字段名和错误消息
+     */
+    readonly errors: Array<{
+        field: string;
+        message: string;
+    }>;
+    /**
+     * 构造一个新的验证错误实例
+     *
+     * @param message - 错误的主要描述信息
+     * @param code - 错误代码，默认为 'VALIDATION_FAILED'
+     * @param errors - 验证错误详情数组，默认为空数组
+     * @param context - 额外的上下文信息（可选）
+     */
+    constructor(message: string, code?: string | number, errors?: Array<any>, context?: Record<string, any>);
+    /**
+     * 添加单个错误详情到错误列表中
+     *
+     * @param field - 出错的字段名
+     * @param message - 字段验证失败的具体消息
+     * @returns 返回当前实例以支持链式调用
+     */
+    addError(field: string, message: string): this;
+    /**
+     * 检查当前错误实例是否包含任何验证错误
+     *
+     * @returns 如果有错误返回 true，否则返回 false
+     */
+    hasErrors(): boolean;
+    /**
+     * 将错误信息转换为简化对象格式
+     * 格式为 { fieldName: [message1, message2, ...] }
+     *
+     * @returns 按字段分组的错误消息对象
+     */
+    toSimpleObject(): Record<string, string[]>;
+}
+//# sourceMappingURL=ValidationError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../../../src/validation/errors/ValidationError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC1C;;;OAGG;IACH,SAAgB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElE;;;;;;;OAOG;gBAEC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,GAAG,MAA4B,EAC3C,MAAM,GAAE,KAAK,CAAC,GAAG,CAAM,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAWjC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAS9C;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAY7C"}

package/dist/validation/errors/ValidationError.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+// 导入基础错误类，用于扩展自定义错误类型
+const error_1 = require("@/error");
+/**
+ * 验证错误类
+ * 在数据验证失败时抛出此错误，包含详细的验证错误信息
+ */
+class ValidationError extends error_1.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;
+    }
+}
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=ValidationError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../../../src/validation/errors/ValidationError.ts"],"names":[],"mappings":";;;AAAA,sBAAsB;AACtB,mCAAoC;AAEpC;;;GAGG;AACH,MAAa,eAAgB,SAAQ,iBAAS;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;AAzED,0CAyEC"}

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

@@ -0,0 +1,21 @@
+import { ErrorBase } from '@/error';
+/**
+ * 验证类型未定义错误
+ * 当请求使用一个未定义或不存在的验证类型时抛出此错误
+ *
+ * 通常发生在以下情况：
+ * 1. 尝试使用尚未注册的验证器类型
+ * 2. 验证配置中指定了无效的验证类型名称
+ * 3. 验证规则引用了不存在的验证类型
+ */
+export declare class ValidationTypeNotDefinedError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的验证类型未定义错误实例
+     *
+     * @param message - 错误的详细描述信息，说明具体是什么验证类型未定义
+     * @param context - 可选的上下文信息对象，可用于传递额外的调试信息，
+     *                  如验证器名称、配置详情等
+     */
+    constructor(message: string, context?: Record<string, any>);
+}
+//# sourceMappingURL=ValidationTypeNotDefinedError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationTypeNotDefinedError.d.ts","sourceRoot":"","sources":["../../../../src/validation/errors/ValidationTypeNotDefinedError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,qBAAa,6BAA8B,SAAQ,SAAS;IACxD;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK7D"}

package/dist/validation/errors/ValidationTypeNotDefinedError.js

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

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

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

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

@@ -0,0 +1,21 @@
+import { ErrorBase } from '@/error';
+/**
+ * 验证器未找到错误
+ * 当系统无法找到与指定规则类型相对应的验证器时抛出此错误
+ *
+ * 此错误通常发生在以下情况：
+ * 1. 请求使用尚未注册的验证器类型
+ * 2. 验证规则配置中引用了不存在的验证器
+ * 3. 动态加载验证器时发生问题
+ */
+export declare class ValidatorNotFoundError extends ErrorBase {
+    /**
+     * 构造函数 - 创建一个新的验证器未找到错误实例
+     *
+     * @param type - 找不到的验证器类型名称
+     * @param context - 可选的上下文信息对象，可用于传递额外的调试信息，
+     *                  如字段名、验证规则配置等
+     */
+    constructor(type: string, context?: Record<string, any>);
+}
+//# sourceMappingURL=ValidatorNotFoundError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorNotFoundError.d.ts","sourceRoot":"","sources":["../../../../src/validation/errors/ValidatorNotFoundError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACjD;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAW1D"}

package/dist/validation/errors/ValidatorNotFoundError.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidatorNotFoundError = void 0;
+// 导入基础错误类，用于扩展自定义错误类型
+const error_1 = require("@/error");
+/**
+ * 验证器未找到错误
+ * 当系统无法找到与指定规则类型相对应的验证器时抛出此错误
+ *
+ * 此错误通常发生在以下情况：
+ * 1. 请求使用尚未注册的验证器类型
+ * 2. 验证规则配置中引用了不存在的验证器
+ * 3. 动态加载验证器时发生问题
+ */
+class ValidatorNotFoundError extends error_1.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,
+        });
+    }
+}
+exports.ValidatorNotFoundError = ValidatorNotFoundError;
+//# sourceMappingURL=ValidatorNotFoundError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorNotFoundError.js","sourceRoot":"","sources":["../../../../src/validation/errors/ValidatorNotFoundError.ts"],"names":[],"mappings":";;;AAAA,sBAAsB;AACtB,mCAAoC;AAEpC;;;;;;;;GAQG;AACH,MAAa,sBAAuB,SAAQ,iBAAS;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;AAnBD,wDAmBC"}

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

@@ -0,0 +1,202 @@
+import { IValidationError, ValidationErrorContext } from '../types';
+import { ValidationErrorCode } from './codes';
+/**
+ * 错误工厂对象 - 提供便捷的错误创建方法
+ *
+ * 包含各种常见验证错误的创建函数，用于统一错误格式
+ */
+export declare const ValidationErrorBuilder: {
+    /**
+     * 创建基础验证错误对象
+     *
+     * @param code - 错误代码
+     * @param options - 错误选项，包括参数和上下文
+     * @returns 标准化的验证错误对象
+     */
+    createError(code: ValidationErrorCode, options?: any): IValidationError;
+    /**
+     * 创建必填验证错误
+     * 当字段被标记为必需但未提供值时使用
+     *
+     * @param context - 错误上下文信息
+     * @returns 必填错误对象
+     */
+    required(context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建类型不匹配错误
+     * 当值的类型与期望类型不匹配时使用
+     *
+     * @param expectedType - 期望的类型
+     * @param actualType - 实际的类型
+     * @param context - 错误上下文信息
+     * @returns 类型不匹配错误对象
+     */
+    type_mismatch(expectedType: string, actualType: string, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建无效值错误
+     * 当值本身无效时使用（如 NaN、Infinity 等）
+     *
+     * @param value - 无效的值
+     * @param context - 错误上下文信息
+     * @returns 无效值错误对象
+     */
+    invalid_value(value: any, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建值过小错误
+     * 当值小于最小允许值时使用
+     *
+     * @param min - 最小允许值
+     * @param value - 实际值
+     * @param exclusive - 是否为排他比较（不包含边界值）
+     * @param context - 错误上下文信息
+     * @returns 值过小错误对象
+     */
+    too_small(min: number, value: any, exclusive?: boolean, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建值过大错误
+     * 当值大于最大允许值时使用
+     *
+     * @param max - 最大允许值
+     * @param value - 实际值
+     * @param exclusive - 是否为排他比较（不包含边界值）
+     * @param context - 错误上下文信息
+     * @returns 值过大错误对象
+     */
+    too_large(max: number, value: any, exclusive?: boolean, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建超出范围错误
+     * 当值不在指定范围内时使用
+     *
+     * @param min - 最小允许值
+     * @param max - 最大允许值
+     * @param value - 实际值
+     * @param context - 错误上下文信息
+     * @returns 超出范围错误对象
+     */
+    out_of_range(min: number, max: number, value: any, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建格式无效错误
+     * 当值不符合指定格式时使用
+     *
+     * @param field - 字段名称
+     * @param value - 实际值
+     * @param format - 期望的格式
+     * @param context - 错误上下文信息
+     * @returns 格式无效错误对象
+     */
+    invalid_format(field: string, value: any, format: string, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建模式不匹配错误
+     * 当值不匹配正则表达式模式时使用
+     *
+     * @param pattern - 正则表达式模式
+     * @param value - 实际值
+     * @param context - 错误上下文信息
+     * @returns 模式不匹配错误对象
+     */
+    pattern_mismatch(pattern: string | RegExp, value: any, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建不允许值错误
+     * 当值不在允许的值列表中时使用
+     *
+     * @param value - 实际值
+     * @param allowedValues - 允许的值列表
+     * @param context - 错误上下文信息
+     * @returns 不允许值错误对象
+     */
+    not_allowed(value: any, allowedValues: any[], context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建缺少字段错误
+     * 当必需字段不存在时使用
+     *
+     * @param field - 缺少的字段名称
+     * @param context - 错误上下文信息
+     * @returns 缺少字段错误对象
+     */
+    missing_field(field: string, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建重复值错误
+     * 当不允许重复值但出现重复时使用
+     *
+     * @param field - 字段名称
+     * @param value - 重复的值
+     * @param context - 错误上下文信息
+     * @returns 重复值错误对象
+     */
+    duplicate(field: string, value: any, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建条件失败错误
+     * 当条件验证失败时使用
+     *
+     * @param field - 字段名称
+     * @param condition - 条件描述
+     * @param value - 实际值
+     * @param context - 错误上下文信息
+     * @returns 条件失败错误对象
+     */
+    condition_failed(field: string, condition: string, value: any, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建自定义错误
+     * 用于创建自定义验证错误
+     *
+     * @param customCode - 自定义错误代码
+     * @param message - 错误消息
+     * @param context - 错误上下文信息
+     * @returns 自定义错误对象
+     */
+    custom(customCode: string, message: string, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建密码太短错误
+     * 当密码长度不足时使用
+     *
+     * @param minLength - 最小长度要求
+     * @param actualLength - 实际长度
+     * @param context - 错误上下文信息
+     * @returns 密码太短错误对象
+     */
+    password_too_short(minLength: number, actualLength: number, context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建缺少大写字母错误
+     * 当密码缺少大写字母时使用
+     *
+     * @param context - 错误上下文信息
+     * @returns 缺少大写字母错误对象
+     */
+    password_missing_uppercase(context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建缺少小写字母错误
+     * 当密码缺少小写字母时使用
+     *
+     * @param context - 错误上下文信息
+     * @returns 缺少小写字母错误对象
+     */
+    password_missing_lowercase(context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建缺少数字错误
+     * 当密码缺少数字时使用
+     *
+     * @param context - 错误上下文信息
+     * @returns 缺少数字错误对象
+     */
+    password_missing_digit(context?: ValidationErrorContext): IValidationError;
+    /**
+     * 创建缺少特殊字符错误
+     * 当密码缺少特殊字符时使用
+     *
+     * @param context - 错误上下文信息
+     * @returns 缺少特殊字符错误对象
+     */
+    password_missing_special(context?: ValidationErrorContext): IValidationError;
+    /**
+     * 抛出验证错误的辅助函数
+     * 当验证失败时抛出包含详细错误信息的异常
+     *
+     * @param value - 被验证的值
+     * @param rule - 验证规则
+     * @param errors - 验证错误列表
+     * @param context - 验证上下文
+     * @throws ValidationError 包含所有验证错误的异常
+     */
+    throwIfAny(value: any, rule: any, errors: IValidationError[], context?: ValidationErrorContext): void;
+};
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../src/validation/errors/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IAC/B;;;;;;OAMG;sBACe,mBAAmB,YAAY,GAAG,GAAG,gBAAgB;IAQvE;;;;;;OAMG;uBACgB,sBAAsB,GAAG,gBAAgB;IAM5D;;;;;;;;OAQG;gCAEe,MAAM,cACR,MAAM,YACR,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;OAOG;yBACkB,GAAG,YAAY,sBAAsB,GAAG,gBAAgB;IAO7E;;;;;;;;;OASG;mBAEM,MAAM,SACJ,GAAG,cACC,OAAO,YACR,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;;OASG;mBAEM,MAAM,SACJ,GAAG,cACC,OAAO,YACR,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;;OASG;sBAEM,MAAM,OACN,MAAM,SACJ,GAAG,YACA,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;;OASG;0BAEQ,MAAM,SACN,GAAG,UACF,MAAM,YACJ,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;OAQG;8BAEU,MAAM,GAAG,MAAM,SACjB,GAAG,YACA,sBAAsB,GACjC,gBAAgB;IAQnB;;;;;;;;OAQG;uBAEQ,GAAG,iBACK,GAAG,EAAE,YACV,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;OAOG;yBACkB,MAAM,YAAY,sBAAsB,GAAG,gBAAgB;IAOhF;;;;;;;;OAQG;qBACc,MAAM,SAAS,GAAG,YAAY,sBAAsB,GAAG,gBAAgB;IAOxF;;;;;;;;;OASG;4BAEQ,MAAM,aACF,MAAM,SACV,GAAG,YACA,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;OAQG;uBAEa,MAAM,WACT,MAAM,YACL,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;;;OAQG;kCAEY,MAAM,gBACH,MAAM,YACV,sBAAsB,GACjC,gBAAgB;IAOnB;;;;;;OAMG;yCACkC,sBAAsB,GAAG,gBAAgB;IAO9E;;;;;;OAMG;yCACkC,sBAAsB,GAAG,gBAAgB;IAO9E;;;;;;OAMG;qCAC8B,sBAAsB,GAAG,gBAAgB;IAO1E;;;;;;OAMG;uCACgC,sBAAsB,GAAG,gBAAgB;IAO5E;;;;;;;;;OASG;sBAEQ,GAAG,QACJ,GAAG,UACD,gBAAgB,EAAE,YACjB,sBAAsB,GAChC,IAAI;CASV,CAAC"}