@fluojs/validation 1.0.5 → 2.0.0

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/validation-issues.d.ts

@@ -0,0 +1,13 @@
+import type { ValidationRuleResult } from '@fluojs/core/request-pipeline';
+import type { ValidationIssue } from '../types.js';
+export declare function normalizeResult(result: ValidationRuleResult, field: string | undefined, source: ValidationIssue['source'], fallback: {
+    readonly code: string;
+    readonly message: string;
+}): ValidationIssue[];
+export declare function joinFieldPath(parent: string, child?: string): string;
+export declare function prefixIssues(issues: readonly ValidationIssue[], fieldPrefix: string, source: ValidationIssue['source']): ValidationIssue[];
+export declare function buildIssue(fallback: {
+    readonly code: string;
+    readonly message: string;
+}, field: string, source: ValidationIssue['source']): ValidationIssue;
+//# sourceMappingURL=validation-issues.d.ts.map

package/dist/internal/validation-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-issues.d.ts","sourceRoot":"","sources":["../../src/internal/validation-issues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAEnG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAenD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,EACjC,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5D,eAAe,EAAE,CAcnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAChC,eAAe,EAAE,CAEnB;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC7D,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAChC,eAAe,CAOjB"}

package/dist/internal/validation-issues.js

@@ -0,0 +1,44 @@
+function normalizeIssue(issue, field, source) {
+  return {
+    code: issue.code,
+    field: issue.field ?? field,
+    message: issue.message,
+    source: issue.source ?? source
+  };
+}
+export function normalizeResult(result, field, source, fallback) {
+  if (result === undefined || result === true) {
+    return [];
+  }
+  if (result === false) {
+    return [{
+      code: fallback.code,
+      field,
+      message: fallback.message,
+      source
+    }];
+  }
+  if (Array.isArray(result)) {
+    return result.map(issue => normalizeIssue(issue, field, source));
+  }
+  return [normalizeIssue(result, field, source)];
+}
+export function joinFieldPath(parent, child) {
+  if (!child) return parent;
+  return child.startsWith('[') ? `${parent}${child}` : `${parent}.${child}`;
+}
+export function prefixIssues(issues, fieldPrefix, source) {
+  return issues.map(issue => ({
+    ...issue,
+    field: joinFieldPath(fieldPrefix, issue.field),
+    source: issue.source ?? source
+  }));
+}
+export function buildIssue(fallback, field, source) {
+  return {
+    code: fallback.code,
+    field,
+    message: fallback.message,
+    source
+  };
+}

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

@@ -12,13 +12,28 @@ export interface ValidationIssue {
     /** Optional metadata source that produced this rule. */
     source?: MetadataSource;
 }
+/** Controls DTO materialization behavior. */
+export interface MaterializeOptions {
+    /** Policy for safe own enumerable input properties not declared by the DTO. */
+    readonly undeclaredProperties?: 'preserve' | 'reject';
+}
 /**
  * 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>;
+    /**
+     * Materializes and validates a value into a typed DTO instance.
+     *
+     * @param value Root value to materialize.
+     * @param target Requested DTO constructor.
+     * @param options Optional materialization policy.
+     */
+    materialize<T>(value: unknown, target: Constructor<T>, options?: MaterializeOptions): MaybePromise<T>;
 }
 //# sourceMappingURL=types.d.ts.map

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,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACvD;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;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACvG"}

package/dist/validation.d.ts

@@ -1,10 +1,10 @@
 import type { Constructor } from '@fluojs/core';
-import type { Validator } from './types.js';
+import type { MaterializeOptions, Validator } from './types.js';
 /**
  * Represents the default validator.
  */
 export declare class DefaultValidator implements Validator {
     validate(value: unknown, target: Constructor): Promise<void>;
-    materialize<T>(value: unknown, target: Constructor<T>): Promise<T>;
+    materialize<T>(value: unknown, target: Constructor<T>, options?: MaterializeOptions): Promise<T>;
 }
 //# sourceMappingURL=validation.d.ts.map

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;AAetB,OAAO,KAAK,EAAE,kBAAkB,EAAmB,SAAS,EAAE,MAAM,YAAY,CAAC;AA+OjF;;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,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;CAqB3G"}