@fluojs/validation 1.0.0-beta.4 → 1.0.1

package/README.ko.md

@@ -26,6 +26,7 @@ pnpm add @fluojs/validation
 - 컨트롤러나 서비스에서 ad hoc parsing 대신 class 기반 검증 규칙을 쓰고 싶을 때
 - `PickType`, `PartialType`, `IntersectionType` 같은 metadata-preserving mapped DTO helper가 필요할 때
 - `@ValidateClass(...)`로 Zod나 Valibot 같은 Standard Schema validator를 붙이고 싶을 때
+- `@fluojs/i18n/validation`으로 명시적으로 localize할 수 있는 안정적인 validation issue code와 path가 필요할 때
 
 ## 빠른 시작
 
@@ -96,6 +97,8 @@ type ValidationIssue = {
 사용합니다. HTTP 바인딩에서 온 규칙은 `source`를 붙이며, standalone validation이나
 Standard Schema 이슈에서는 값이 없을 수 있습니다.
 
+`@fluojs/validation`은 항상 기존 human-readable `message` 값을 방출합니다. Localized message가 필요한 애플리케이션은 validation 실패 후 `@fluojs/i18n/validation`에 opt-in할 수 있습니다. 이 통합은 validator 실행을 바꾸거나 이 패키지를 HTTP locale resolution에 결합하지 않고 `source`, `field`, `code`를 translation key로 매핑합니다.
+
 ### Mapped DTO 헬퍼
 
 ```ts
@@ -110,6 +113,11 @@ class EmailOnlyDto extends PickType(UserDto, ['email']) {}
 class UpdateUserDto extends PartialType(UserDto) {}
 ```
 
+Mapped DTO helper는 위와 같은 문서화된 subclassing 패턴에서도 field-level
+validation 및 binding metadata를 보존합니다. `PickType`, `OmitType`,
+`PartialType`은 생략되었거나 optional이 된 필드에 의존할 수 있는 base
+class-level validator를 derived DTO로 전달하지 않습니다.
+
 ### Standard Schema 지원
 
 Standard Schema adapter는 유효하지 않은 입력을 명시적인 issue로 보고해야 합니다. issue가 없는 검증 결과는 성공으로 처리합니다.
@@ -154,6 +162,7 @@ class RestrictedUserDto {
 ## 관련 패키지
 
 - `@fluojs/http`: request data를 bind한 뒤 이 패키지로 검증합니다.
+- `@fluojs/i18n`: opt-in localized validation issue message를 위한 `@fluojs/i18n/validation`을 제공합니다.
 - `@fluojs/serialization`: response side에서 output DTO를 가공합니다.
 - `@fluojs/core`: validation decorator가 사용하는 metadata primitive를 제공합니다.
 

package/README.md

@@ -26,6 +26,7 @@ pnpm add @fluojs/validation
 - when you want class-based validation rules instead of ad hoc parsing in controllers and services
 - when you need metadata-preserving mapped DTO helpers such as `PickType`, `PartialType`, and `IntersectionType`
 - when you want to attach Standard Schema validators such as Zod or Valibot through `@ValidateClass(...)`
+- when you want stable validation issue codes and paths that can be localized explicitly through `@fluojs/i18n/validation`
 
 ## Quick Start
 
@@ -100,6 +101,8 @@ Nested DTOs use dot paths and collection indexes, such as `address.city` or
 `items[0].name`. HTTP bindings attach `source` when the rule came from request
 metadata; standalone validation and Standard Schema issues may leave it unset.
 
+`@fluojs/validation` always emits its normal human-readable `message` values. Applications that need localized messages can opt into `@fluojs/i18n/validation` after validation fails. That integration maps `source`, `field`, and `code` to translation keys without changing validator execution or coupling this package to HTTP locale resolution.
+
 ### Mapped DTO helpers
 
 ```ts
@@ -114,6 +117,11 @@ class EmailOnlyDto extends PickType(UserDto, ['email']) {}
 class UpdateUserDto extends PartialType(UserDto) {}
 ```
 
+Mapped DTO helpers preserve field-level validation and binding metadata through
+the documented subclassing pattern shown above. `PickType`, `OmitType`, and
+`PartialType` do not carry base class-level validators onto derived DTOs because
+those validators can depend on fields that were omitted or made optional.
+
 ### Standard Schema support
 
 Standard Schema adapters are expected to report invalid input through explicit issues. Validation results without issues are treated as successful.
@@ -158,6 +166,7 @@ Numeric validators, including `@IsLatitude()` and `@IsLongitude()`, validate num
 ## Related Packages
 
 - `@fluojs/http`: binds request data, then uses this package to validate it
+- `@fluojs/i18n`: exposes `@fluojs/i18n/validation` for opt-in localized validation issue messages
 - `@fluojs/serialization`: shapes output DTOs on the response side
 - `@fluojs/core`: provides the metadata primitives used by validation decorators
 

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;AAiEjD;;;;;;;;;;;;;;;;;;;;;;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,CAkCtH"}
+{"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"}

package/dist/mapped-types.js

@@ -24,7 +24,7 @@ function collectDtoKeys(dto) {
   }
   return [...keys];
 }
-function copyDtoMetadata(source, target, include) {
+function copyDtoMetadata(source, target, include, copyClassRules = false) {
   for (const entry of getDtoBindingSchema(source)) {
     if (!include(entry.propertyKey)) {
       continue;
@@ -39,8 +39,10 @@ function copyDtoMetadata(source, target, include) {
       appendDtoFieldValidationRule(target.prototype, entry.propertyKey, rule);
     }
   }
-  for (const rule of getClassValidationRules(source)) {
-    appendClassValidationRule(target, rule);
+  if (copyClassRules) {
+    for (const rule of getClassValidationRules(source)) {
+      appendClassValidationRule(target, rule);
+    }
   }
 }
 
@@ -150,7 +152,7 @@ export function IntersectionType(...baseDtos) {
     }
   });
   for (const BaseDto of baseDtos) {
-    copyDtoMetadata(BaseDto, IntersectionDto, () => true);
+    copyDtoMetadata(BaseDto, IntersectionDto, () => true, true);
   }
   return IntersectionDto;
 }
@@ -200,8 +202,5 @@ export function PartialType(BaseDto) {
       });
     }
   }
-  for (const rule of getClassValidationRules(BaseDto)) {
-    appendClassValidationRule(PartialDto, rule);
-  }
   return PartialDto;
 }

package/package.json

@@ -9,7 +9,7 @@
     "decorators",
     "schema"
   ],
-  "version": "1.0.0-beta.4",
+  "version": "1.0.1",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -42,7 +42,7 @@
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
     "validator": "^13.15.26",
-    "@fluojs/core": "^1.0.0-beta.5"
+    "@fluojs/core": "^1.0.1"
   },
   "devDependencies": {
     "@types/validator": "^13.15.10",