@fluojs/validation 1.0.4 → 1.0.6

package/dist/internal/decorator-factories.d.ts

@@ -0,0 +1,12 @@
+import type { DtoFieldValidationRule, ValidationDecoratorOptions } from '@fluojs/core/request-pipeline';
+import { type FieldDecoratorFn } from './decorator-metadata.js';
+type ValidatorJsRuleName = Extract<DtoFieldValidationRule, {
+    kind: 'validatorjs';
+}>['validator'];
+export declare function createValidationDecorator(ruleFactory: () => DtoFieldValidationRule): FieldDecoratorFn;
+export declare function createValidationOptionsWithConfigDecorator<T>(ruleFactory: (value: T, options: ValidationDecoratorOptions | undefined) => DtoFieldValidationRule): (value: T, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
+export declare function createFlagValidationDecorator(ruleFactory: (options: ValidationDecoratorOptions | undefined) => DtoFieldValidationRule): (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
+export declare function createArrayValidationDecorator<T>(ruleFactory: (values: readonly T[], options: ValidationDecoratorOptions | undefined) => DtoFieldValidationRule): (values: readonly T[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
+export declare function createValidatorJsDecorator(validator: ValidatorJsRuleName): (args?: readonly unknown[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
+export {};
+//# sourceMappingURL=decorator-factories.d.ts.map

package/dist/internal/decorator-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-factories.d.ts","sourceRoot":"","sources":["../../src/internal/decorator-factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAExG,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,KAAK,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC,WAAW,CAAC,CAAC;AAEjG,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,sBAAsB,GAAG,gBAAgB,CAMrG;AAED,wBAAgB,0CAA0C,CAAC,CAAC,EAC1D,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,0BAA0B,GAAG,SAAS,KAAK,sBAAsB,IAE1F,OAAO,CAAC,EAAE,UAAU,0BAA0B,KAAG,gBAAgB,CAG1E;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,CAAC,OAAO,EAAE,0BAA0B,GAAG,SAAS,KAAK,sBAAsB,IAEhF,UAAU,0BAA0B,KAAG,gBAAgB,CAGhE;AAED,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,0BAA0B,GAAG,SAAS,KAAK,sBAAsB,IAEtG,QAAQ,SAAS,CAAC,EAAE,EAAE,UAAU,0BAA0B,KAAG,gBAAgB,CAGtF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,mBAAmB,IAC/D,OAAO,SAAS,OAAO,EAAE,EAAE,UAAU,0BAA0B,KAAG,gBAAgB,CAQ3F"}

package/dist/internal/decorator-factories.js

@@ -0,0 +1,32 @@
+import { appendStandardDtoValidationRule } from './decorator-metadata.js';
+export function createValidationDecorator(ruleFactory) {
+  const decorator = (_value, context) => {
+    appendStandardDtoValidationRule(context.metadata, context.name, ruleFactory());
+  };
+  return decorator;
+}
+export function createValidationOptionsWithConfigDecorator(ruleFactory) {
+  return (value, options) => {
+    return createValidationDecorator(() => ruleFactory(value, options));
+  };
+}
+export function createFlagValidationDecorator(ruleFactory) {
+  return options => {
+    return createValidationDecorator(() => ruleFactory(options));
+  };
+}
+export function createArrayValidationDecorator(ruleFactory) {
+  return (values, options) => {
+    return createValidationDecorator(() => ruleFactory(values, options));
+  };
+}
+export function createValidatorJsDecorator(validator) {
+  return (args, options) => {
+    return createValidationDecorator(() => ({
+      args,
+      kind: 'validatorjs',
+      validator,
+      ...options
+    }));
+  };
+}

package/dist/internal/decorator-metadata.d.ts

@@ -0,0 +1,7 @@
+import type { MetadataPropertyKey } from '@fluojs/core';
+import type { ClassValidationRule, DtoFieldValidationRule } from '@fluojs/core/request-pipeline';
+export type ClassDecoratorFn = (value: Function, context: ClassDecoratorContext) => void;
+export type FieldDecoratorFn = <This, Value>(value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+export declare function appendStandardDtoValidationRule(metadata: unknown, propertyKey: MetadataPropertyKey, rule: DtoFieldValidationRule): void;
+export declare function appendStandardClassValidationRule(metadata: unknown, rule: ClassValidationRule): void;
+//# sourceMappingURL=decorator-metadata.d.ts.map

package/dist/internal/decorator-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-metadata.d.ts","sourceRoot":"","sources":["../../src/internal/decorator-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;AA8CzH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,mBAAmB,EAChC,IAAI,EAAE,sBAAsB,GAC3B,IAAI,CAGN;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEpG"}

package/dist/internal/decorator-metadata.js

@@ -0,0 +1,38 @@
+const standardDtoValidationMetadataKey = Symbol.for('fluo.standard.dto-validation');
+const standardClassValidationMetadataKey = Symbol.for('fluo.standard.class-validation');
+function getStandardMetadataBag(metadata) {
+  if (metadata === null || metadata === undefined) {
+    throw new Error('Decorator metadata is not available. Ensure your environment supports TC39 decorator metadata (Stage 3).');
+  }
+  return metadata;
+}
+function getStandardDtoValidationMap(metadata) {
+  const bag = getStandardMetadataBag(metadata);
+  const current = bag[standardDtoValidationMetadataKey];
+  if (current && Object.hasOwn(bag, standardDtoValidationMetadataKey)) {
+    return current;
+  }
+  const created = new Map();
+  for (const [propertyKey, rules] of current ?? []) {
+    created.set(propertyKey, [...rules]);
+  }
+  bag[standardDtoValidationMetadataKey] = created;
+  return created;
+}
+function getStandardClassValidationList(metadata) {
+  const bag = getStandardMetadataBag(metadata);
+  const current = bag[standardClassValidationMetadataKey];
+  if (current && Object.hasOwn(bag, standardClassValidationMetadataKey)) {
+    return current;
+  }
+  const created = [...(current ?? [])];
+  bag[standardClassValidationMetadataKey] = created;
+  return created;
+}
+export function appendStandardDtoValidationRule(metadata, propertyKey, rule) {
+  const map = getStandardDtoValidationMap(metadata);
+  map.set(propertyKey, [...(map.get(propertyKey) ?? []), rule]);
+}
+export function appendStandardClassValidationRule(metadata, rule) {
+  getStandardClassValidationList(metadata).push(rule);
+}

package/dist/internal/dto-metadata-cache.d.ts

@@ -0,0 +1,17 @@
+import type { Constructor, MetadataPropertyKey } from '@fluojs/core';
+import { type DtoFieldBindingMetadata, getClassValidationRules, getDtoValidationSchema } from '@fluojs/core/request-pipeline';
+export declare function resolveNestedDto(dto: Constructor | (() => Constructor)): Constructor;
+type DtoValidationSchema = ReturnType<typeof getDtoValidationSchema>;
+export interface CachedDtoMetadata {
+    bindingMap: Map<MetadataPropertyKey, DtoFieldBindingMetadata>;
+    classValidationRules: ReturnType<typeof getClassValidationRules>;
+    dtoValidationSchema: DtoValidationSchema;
+    mergedPropertyKeys: Set<MetadataPropertyKey>;
+    nestedDtoTransforms: readonly {
+        propertyKey: MetadataPropertyKey;
+        target: Constructor;
+    }[];
+}
+export declare function getCachedDtoMetadata(target: Constructor): CachedDtoMetadata;
+export {};
+//# sourceMappingURL=dto-metadata-cache.d.ts.map

package/dist/internal/dto-metadata-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-metadata-cache.d.ts","sourceRoot":"","sources":["../../src/internal/dto-metadata-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,KAAK,uBAAuB,EAE5B,uBAAuB,EAEvB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAMvC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,GAAG,WAAW,CAMpF;AAED,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,GAAG,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;IAC9D,oBAAoB,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IACjE,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,kBAAkB,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC7C,mBAAmB,EAAE,SAAS;QAC5B,WAAW,EAAE,mBAAmB,CAAC;QACjC,MAAM,EAAE,WAAW,CAAC;KACrB,EAAE,CAAC;CACL;AA+BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAyB3E"}

package/dist/internal/dto-metadata-cache.js

@@ -0,0 +1,48 @@
+import { getClassValidationRules, getDtoBindingSchema, getDtoValidationSchema } from '@fluojs/core/request-pipeline';
+function isClassConstructor(dto) {
+  return typeof dto === 'function' && Function.prototype.toString.call(dto).startsWith('class ');
+}
+export function resolveNestedDto(dto) {
+  if (isClassConstructor(dto)) {
+    return dto;
+  }
+  return dto();
+}
+const dtoMetadataCache = new WeakMap();
+function getDtoBindingMap(target) {
+  return new Map(getDtoBindingSchema(target).map(entry => [entry.propertyKey, entry.metadata]));
+}
+function collectNestedDtoTransforms(dtoValidationSchema) {
+  const nestedEntries = [];
+  for (const entry of dtoValidationSchema) {
+    const nestedRule = entry.rules.find(rule => rule.kind === 'nested');
+    if (!nestedRule) {
+      continue;
+    }
+    nestedEntries.push({
+      propertyKey: entry.propertyKey,
+      target: resolveNestedDto(nestedRule.dto)
+    });
+  }
+  return nestedEntries;
+}
+export function getCachedDtoMetadata(target) {
+  const cached = dtoMetadataCache.get(target);
+  if (cached) {
+    return cached;
+  }
+  const bindingMap = getDtoBindingMap(target);
+  const dtoValidationSchema = getDtoValidationSchema(target);
+  const classValidationRules = getClassValidationRules(target);
+  const mergedPropertyKeys = new Set([...bindingMap.keys(), ...dtoValidationSchema.map(entry => entry.propertyKey)]);
+  const nestedDtoTransforms = collectNestedDtoTransforms(dtoValidationSchema);
+  const next = {
+    bindingMap,
+    classValidationRules,
+    dtoValidationSchema,
+    mergedPropertyKeys,
+    nestedDtoTransforms
+  };
+  dtoMetadataCache.set(target, next);
+  return next;
+}

package/dist/internal/object-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function getIterableValues(value: unknown): unknown[] | undefined;
+export declare function isPlainObject(value: unknown): value is Record<PropertyKey, unknown>;
+export declare function assignSafeOwnEnumerableProperties(target: Record<PropertyKey, unknown>, source: Record<PropertyKey, unknown>): void;
+//# sourceMappingURL=object-utils.d.ts.map

package/dist/internal/object-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-utils.d.ts","sourceRoot":"","sources":["../../src/internal/object-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,CAKvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAOnF;AAID,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GACnC,IAAI,CAYN"}

package/dist/internal/object-utils.js

@@ -0,0 +1,25 @@
+export function getIterableValues(value) {
+  if (Array.isArray(value)) return value;
+  if (value instanceof Set) return Array.from(value.values());
+  if (value instanceof Map) return Array.from(value.values());
+  return undefined;
+}
+export function isPlainObject(value) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+const dangerousKeys = new Set(['__proto__', 'constructor', 'prototype']);
+export function assignSafeOwnEnumerableProperties(target, source) {
+  for (const key of Reflect.ownKeys(source)) {
+    if (typeof key === 'string' && dangerousKeys.has(key)) {
+      continue;
+    }
+    if (!Object.prototype.propertyIsEnumerable.call(source, key)) {
+      continue;
+    }
+    target[key] = source[key];
+  }
+}

package/dist/internal/rule-handlers.d.ts

@@ -0,0 +1,19 @@
+import type { DtoFieldValidationRule } from '@fluojs/core/request-pipeline';
+type RuleKind = DtoFieldValidationRule['kind'];
+export type NonCustomRule = Exclude<DtoFieldValidationRule, {
+    kind: 'custom' | 'nested';
+}>;
+type RuleHandler<K extends RuleKind> = {
+    defaultCode: string;
+    describe: (field: string, rule: Extract<DtoFieldValidationRule, {
+        kind: K;
+    }>) => string;
+    validate: (rule: Extract<DtoFieldValidationRule, {
+        kind: K;
+    }>, value: unknown) => boolean;
+};
+export declare function getRuleHandler<K extends RuleKind>(rule: Extract<DtoFieldValidationRule, {
+    kind: K;
+}>): RuleHandler<K>;
+export {};
+//# sourceMappingURL=rule-handlers.d.ts.map

package/dist/internal/rule-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-handlers.d.ts","sourceRoot":"","sources":["../../src/internal/rule-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAK5E,KAAK,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE3F,KAAK,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,sBAAsB,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,MAAM,CAAC;IACxF,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,sBAAsB,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3F,CAAC;AAgNF,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAErH"}

package/dist/internal/rule-handlers.js

@@ -0,0 +1,209 @@
+import { isPlainObject } from './object-utils.js';
+import { runValidatorJs } from './validator-js-adapter.js';
+function isEmptyValue(value) {
+  return value === '' || value === null || value === undefined;
+}
+const ruleHandlers = {
+  validateIf: {
+    defaultCode: 'VALIDATE_IF',
+    describe: field => `${field} is conditionally invalid.`,
+    validate: () => true
+  },
+  defined: {
+    defaultCode: 'REQUIRED',
+    describe: field => `${field} is required.`,
+    validate: (_rule, value) => value !== undefined && value !== null
+  },
+  optional: {
+    defaultCode: 'OPTIONAL',
+    describe: field => `${field} is optional.`,
+    validate: () => true
+  },
+  equals: {
+    defaultCode: 'EQUALS',
+    describe: (field, rule) => `${field} must equal ${String(rule.value)}.`,
+    validate: (rule, value) => value === rule.value
+  },
+  notEquals: {
+    defaultCode: 'NOT_EQUALS',
+    describe: (field, rule) => `${field} must not equal ${String(rule.value)}.`,
+    validate: (rule, value) => value !== rule.value
+  },
+  empty: {
+    defaultCode: 'EMPTY',
+    describe: field => `${field} must be empty.`,
+    validate: (_rule, value) => isEmptyValue(value)
+  },
+  notEmpty: {
+    defaultCode: 'NOT_EMPTY',
+    describe: field => `${field} should not be empty.`,
+    validate: (_rule, value) => !isEmptyValue(value)
+  },
+  in: {
+    defaultCode: 'IN',
+    describe: field => `${field} must be one of the allowed values.`,
+    validate: (rule, value) => rule.values.includes(value)
+  },
+  notIn: {
+    defaultCode: 'NOT_IN',
+    describe: field => `${field} contains a forbidden value.`,
+    validate: (rule, value) => !rule.values.includes(value)
+  },
+  string: {
+    defaultCode: 'INVALID_STRING',
+    describe: field => `${field} must be a string.`,
+    validate: (_rule, value) => typeof value === 'string'
+  },
+  number: {
+    defaultCode: 'INVALID_NUMBER',
+    describe: field => `${field} must be a number.`,
+    validate: (rule, value) => typeof value === 'number' && (rule.allowNaN || !Number.isNaN(value))
+  },
+  boolean: {
+    defaultCode: 'INVALID_BOOLEAN',
+    describe: field => `${field} must be a boolean.`,
+    validate: (_rule, value) => typeof value === 'boolean'
+  },
+  date: {
+    defaultCode: 'INVALID_DATE',
+    describe: field => `${field} must be a Date instance.`,
+    validate: (_rule, value) => value instanceof Date && !Number.isNaN(value.getTime())
+  },
+  array: {
+    defaultCode: 'INVALID_ARRAY',
+    describe: field => `${field} must be an array.`,
+    validate: (_rule, value) => Array.isArray(value)
+  },
+  object: {
+    defaultCode: 'INVALID_OBJECT',
+    describe: field => `${field} must be an object.`,
+    validate: (_rule, value) => isPlainObject(value)
+  },
+  enum: {
+    defaultCode: 'INVALID_ENUM',
+    describe: field => `${field} must be a supported enum value.`,
+    validate: (rule, value) => rule.values.includes(value)
+  },
+  int: {
+    defaultCode: 'INVALID_INT',
+    describe: field => `${field} must be an integer.`,
+    validate: (_rule, value) => typeof value === 'number' && Number.isInteger(value)
+  },
+  divisibleBy: {
+    defaultCode: 'DIVISIBLE_BY',
+    describe: (field, rule) => `${field} must be divisible by ${String(rule.value)}.`,
+    validate: (rule, value) => typeof value === 'number' && !Number.isNaN(value) && value % rule.value === 0
+  },
+  positive: {
+    defaultCode: 'POSITIVE',
+    describe: field => `${field} must be positive.`,
+    validate: (_rule, value) => typeof value === 'number' && value > 0
+  },
+  negative: {
+    defaultCode: 'NEGATIVE',
+    describe: field => `${field} must be negative.`,
+    validate: (_rule, value) => typeof value === 'number' && value < 0
+  },
+  min: {
+    defaultCode: 'MIN',
+    describe: (field, rule) => `${field} must be greater than or equal to ${String(rule.value)}.`,
+    validate: (rule, value) => typeof value === 'number' && !Number.isNaN(value) && value >= rule.value
+  },
+  max: {
+    defaultCode: 'MAX',
+    describe: (field, rule) => `${field} must be less than or equal to ${String(rule.value)}.`,
+    validate: (rule, value) => typeof value === 'number' && !Number.isNaN(value) && value <= rule.value
+  },
+  minDate: {
+    defaultCode: 'MIN_DATE',
+    describe: (field, rule) => `${field} must be on or after ${rule.value.toISOString()}.`,
+    validate: (rule, value) => value instanceof Date && !Number.isNaN(value.getTime()) && value.getTime() >= rule.value.getTime()
+  },
+  maxDate: {
+    defaultCode: 'MAX_DATE',
+    describe: (field, rule) => `${field} must be on or before ${rule.value.toISOString()}.`,
+    validate: (rule, value) => value instanceof Date && !Number.isNaN(value.getTime()) && value.getTime() <= rule.value.getTime()
+  },
+  contains: {
+    defaultCode: 'CONTAINS',
+    describe: (field, rule) => `${field} must contain ${rule.value}.`,
+    validate: (rule, value) => typeof value === 'string' && value.includes(rule.value)
+  },
+  notContains: {
+    defaultCode: 'NOT_CONTAINS',
+    describe: (field, rule) => `${field} must not contain ${rule.value}.`,
+    validate: (rule, value) => typeof value === 'string' && !value.includes(rule.value)
+  },
+  length: {
+    defaultCode: 'LENGTH',
+    describe: field => `${field} must have a valid length.`,
+    validate: (rule, value) => typeof value === 'string' && value.length >= rule.min && (rule.max === undefined || value.length <= rule.max)
+  },
+  minLength: {
+    defaultCode: 'MIN_LENGTH',
+    describe: (field, rule) => `${field} must have length at least ${String(rule.value)}.`,
+    validate: (rule, value) => typeof value === 'string' && value.length >= rule.value
+  },
+  maxLength: {
+    defaultCode: 'MAX_LENGTH',
+    describe: (field, rule) => `${field} must have length at most ${String(rule.value)}.`,
+    validate: (rule, value) => typeof value === 'string' && value.length <= rule.value
+  },
+  nested: {
+    defaultCode: 'INVALID_NESTED',
+    describe: field => `${field} contains invalid nested data.`,
+    validate: () => true
+  },
+  validatorjs: {
+    defaultCode: 'INVALID_FIELD',
+    describe: field => `${field} is invalid.`,
+    validate: (rule, value) => runValidatorJs(rule, value)
+  },
+  arrayContains: {
+    defaultCode: 'ARRAY_CONTAINS',
+    describe: field => `${field} must contain the required values.`,
+    validate: (rule, value) => Array.isArray(value) && rule.values.every(expected => value.includes(expected))
+  },
+  arrayNotContains: {
+    defaultCode: 'ARRAY_NOT_CONTAINS',
+    describe: field => `${field} contains forbidden values.`,
+    validate: (rule, value) => Array.isArray(value) && rule.values.every(expected => !value.includes(expected))
+  },
+  arrayNotEmpty: {
+    defaultCode: 'ARRAY_NOT_EMPTY',
+    describe: field => `${field} must not be an empty array.`,
+    validate: (_rule, value) => Array.isArray(value) && value.length > 0
+  },
+  arrayMinSize: {
+    defaultCode: 'ARRAY_MIN_SIZE',
+    describe: (field, rule) => `${field} must contain at least ${String(rule.value)} items.`,
+    validate: (rule, value) => Array.isArray(value) && value.length >= rule.value
+  },
+  arrayMaxSize: {
+    defaultCode: 'ARRAY_MAX_SIZE',
+    describe: (field, rule) => `${field} must contain at most ${String(rule.value)} items.`,
+    validate: (rule, value) => Array.isArray(value) && value.length <= rule.value
+  },
+  arrayUnique: {
+    defaultCode: 'ARRAY_UNIQUE',
+    describe: field => `${field} must contain unique values.`,
+    validate: (rule, value) => {
+      if (!Array.isArray(value)) return false;
+      const seen = new Set();
+      for (const entry of value) {
+        const key = rule.selector ? rule.selector(entry) : entry;
+        if (seen.has(key)) return false;
+        seen.add(key);
+      }
+      return true;
+    }
+  },
+  custom: {
+    defaultCode: 'INVALID_FIELD',
+    describe: field => `${field} is invalid.`,
+    validate: () => true
+  }
+};
+export function getRuleHandler(rule) {
+  return ruleHandlers[rule.kind];
+}

package/dist/internal/validator-js-adapter.d.ts

@@ -0,0 +1,5 @@
+import type { DtoFieldValidationRule } from '@fluojs/core/request-pipeline';
+export declare function runValidatorJs(rule: Extract<DtoFieldValidationRule, {
+    kind: 'validatorjs';
+}>, value: unknown): boolean;
+//# sourceMappingURL=validator-js-adapter.d.ts.map

package/dist/internal/validator-js-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator-js-adapter.d.ts","sourceRoot":"","sources":["../../src/internal/validator-js-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoDtH"}

package/dist/internal/validator-js-adapter.js

@@ -0,0 +1,88 @@
+import validator from 'validator';
+export function runValidatorJs(rule, value) {
+  if (rule.validator === 'latitude') {
+    return typeof value === 'number' && Number.isFinite(value) && value >= -90 && value <= 90;
+  }
+  if (rule.validator === 'longitude') {
+    return typeof value === 'number' && Number.isFinite(value) && value >= -180 && value <= 180;
+  }
+  if (typeof value !== 'string') {
+    return false;
+  }
+  switch (rule.validator) {
+    case 'alpha':
+      return validator.isAlpha(value);
+    case 'alphanumeric':
+      return validator.isAlphanumeric(value);
+    case 'ascii':
+      return validator.isAscii(value);
+    case 'base64':
+      return validator.isBase64(value);
+    case 'booleanString':
+      return validator.isBoolean(value);
+    case 'currency':
+      return validator.isCurrency(value, rule.args?.[0]);
+    case 'dataURI':
+      return validator.isDataURI(value);
+    case 'dateString':
+      return validator.isISO8601(value);
+    case 'decimal':
+      return validator.isDecimal(value);
+    case 'email':
+      return validator.isEmail(value, rule.args?.[0]);
+    case 'fqdn':
+      return validator.isFQDN(value, rule.args?.[0]);
+    case 'hexColor':
+      return validator.isHexColor(value);
+    case 'hexadecimal':
+      return validator.isHexadecimal(value);
+    case 'ip':
+      return validator.isIP(value, rule.args?.[0]);
+    case 'isbn':
+      return validator.isISBN(value, rule.args?.[0]);
+    case 'issn':
+      return validator.isISSN(value);
+    case 'json':
+      return validator.isJSON(value);
+    case 'jwt':
+      return validator.isJWT(value);
+    case 'locale':
+      return validator.isLocale(value);
+    case 'lowercase':
+      return validator.isLowercase(value);
+    case 'magnetURI':
+      return validator.isMagnetURI(value);
+    case 'matches':
+      return validator.matches(value, rule.args?.[0], rule.args?.[1]);
+    case 'mimeType':
+      return validator.isMimeType(value);
+    case 'mobilePhone':
+      return validator.isMobilePhone(value, rule.args?.[0]);
+    case 'mongoId':
+      return validator.isMongoId(value);
+    case 'numberString':
+      return validator.isNumeric(value);
+    case 'port':
+      return validator.isPort(value);
+    case 'postalCode':
+      return validator.isPostalCode(value, rule.args?.[0] ?? 'any');
+    case 'rgbColor':
+      return validator.isRgbColor(value, rule.args?.[0]);
+    case 'rfc3339':
+      return validator.isRFC3339(value);
+    case 'semVer':
+      return validator.isSemVer(value);
+    case 'uppercase':
+      return validator.isUppercase(value);
+    case 'url':
+      return validator.isURL(value, rule.args?.[0]);
+    case 'uuid':
+      return validator.isUUID(value, rule.args?.[0]);
+    case 'iso8601':
+      return validator.isISO8601(value);
+    case 'latLong':
+      return validator.isLatLong(value);
+    default:
+      return false;
+  }
+}

package/dist/mapped-types.d.ts

@@ -1,4 +1,4 @@
-import { type Constructor } from '@fluojs/core';
+import type { Constructor } from '@fluojs/core';
 type DtoConstructor<T = object> = Constructor<T>;
 /**
  * Derive a DTO class that keeps only the selected properties from a base DTO.

package/dist/mapped-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapped-types.d.ts","sourceRoot":"","sources":["../src/mapped-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,cAAc,CAAC;AAUtB,KAAK,cAAc,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAoEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,cAAc,EAAE,IAAI,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAC5G,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,SAAS,IAAI,EAAE,GACpB,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAcjD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,cAAc,EAAE,IAAI,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAC5G,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,SAAS,IAAI,EAAE,GACpB,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAcjD;AAED,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAC5B,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAC/C,SAAS,CAAC,KAAK,EAAE,MAAM,OAAO,KAAK,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3D,KAAK,oBAAoB,CAAC,SAAS,SAAS,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE9H;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,SAAS,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC,EAC/G,GAAG,QAAQ,EAAE,SAAS,GACrB,cAAc,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAkBjD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,cAAc,EAAE,OAAO,EAAE,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CA6BtH"}
+{"version":3,"file":"mapped-types.d.ts","sourceRoot":"","sources":["../src/mapped-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,cAAc,CAAC;AAUrE,KAAK,cAAc,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAoEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,cAAc,EAAE,IAAI,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAC5G,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,SAAS,IAAI,EAAE,GACpB,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAcjD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,cAAc,EAAE,IAAI,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAC5G,OAAO,EAAE,KAAK,EACd,IAAI,EAAE,SAAS,IAAI,EAAE,GACpB,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAcjD;AAED,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAC5B,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAC/C,SAAS,CAAC,KAAK,EAAE,MAAM,OAAO,KAAK,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3D,KAAK,oBAAoB,CAAC,SAAS,SAAS,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE9H;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,SAAS,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC,EAC/G,GAAG,QAAQ,EAAE,SAAS,GACrB,cAAc,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAkBjD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,cAAc,EAAE,OAAO,EAAE,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CA6BtH"}

package/dist/mapped-types.js

@@ -1,4 +1,4 @@
-import { appendClassValidationRule, appendDtoFieldValidationRule, defineDtoFieldBindingMetadata, getClassValidationRules, getDtoBindingSchema, getDtoValidationSchema } from '@fluojs/core/internal';
+import { appendClassValidationRule, appendDtoFieldValidationRule, defineDtoFieldBindingMetadata, getClassValidationRules, getDtoBindingSchema, getDtoValidationSchema } from '@fluojs/core/request-pipeline';
 function setClassName(target, name) {
   Object.defineProperty(target, 'name', {
     configurable: true,

package/dist/standard-schema.d.ts

@@ -1,5 +1,5 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { CustomClassValidator } from '@fluojs/core/internal';
+import type { CustomClassValidator } from '@fluojs/core/request-pipeline';
 /**
  * Standard Schema v1-compatible validator accepted by `ValidateClass`.
  *

package/dist/standard-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AA0CpG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAkBlF;AA4CD;;;;;GAKG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAgBzG"}
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAI1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AA0CpG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAkBlF;AA4CD;;;;;GAKG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAgBzG"}

package/dist/types.d.ts

@@ -16,7 +16,11 @@ export interface ValidationIssue {
  * Validation engine contract used by HTTP binding and app-level validation flows.
  */
 export interface Validator {
-    /** Validates an existing instance without materializing nested objects. */
+    /**
+     * Validates an existing root DTO or plain object.
+     * Plain nested values may be temporarily materialized for nested DTO rules
+     * without replacing the caller's properties.
+     */
     validate(value: unknown, target: Constructor): MaybePromise<void>;
     /** Materializes and validates a value into a typed DTO instance. */
     materialize<T>(value: unknown, target: Constructor<T>): MaybePromise<T>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,oEAAoE;IACpE,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACzE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,oEAAoE;IACpE,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACzE"}

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,cAAc,CAAC;AAatB,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,YAAY,CAAC;AAsyB7D;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAYzE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,cAAc,CAAC;AAOtB,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,YAAY,CAAC;AAga7D;;GAEG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAYzE"}