mega-framework 0.1.6 → 0.1.7

package/src/core/ajv-mapper.js

@@ -15,6 +15,16 @@ const SENSITIVE_FIELD_RE = /(password|secret|token)/i
 /** PII 마스킹된 value 표기. */
 const REDACTED = '[REDACTED]'
 
+/**
+ * envelope `details` 배열 상한 (ADR-193 — allErrors DoS 방어의 응답측 bound).
+ *
+ * allErrors:true 는 위반을 전수 수집하므로(@fastify/ajv-compiler 디폴트가 allErrors:false 인 이유 =
+ * DoS 가능성 명시) 악의적 페이로드가 수천 개 위반을 만들 수 있다. 입력측은 Fastify bodyLimit
+ * (기본 1 MiB)이 막고, 응답·로그측은 이 cap 이 막는다 — 초과분은 잘라내되 silent 가 아니라
+ * `rule:'truncated'` 합성 항목으로 생략 개수를 명시한다.
+ */
+export const MAX_VALIDATION_DETAILS = 20
+
 /**
  * Fastify 가 던진 AJV 검증 에러 객체 → MegaValidationError 로 매핑.
  *
@@ -30,7 +40,17 @@ const REDACTED = '[REDACTED]'
  */
 export function ajvErrorToValidationError(err) {
   if (!err || !Array.isArray(err.validation)) return null
-  const details = err.validation.map((e) => ajvItemToDetail(e))
+  const omitted = Math.max(0, err.validation.length - MAX_VALIDATION_DETAILS)
+  const details = err.validation.slice(0, MAX_VALIDATION_DETAILS).map((e) => ajvItemToDetail(e))
+  if (omitted > 0) {
+    // cap 초과는 silent 절단 금지 — 생략 개수를 합성 항목으로 명시(클라이언트·로그 양쪽에서 보임).
+    details.push({
+      field: '',
+      rule: 'truncated',
+      value: { omitted },
+      message: `... and ${omitted} more validation errors (details capped at ${MAX_VALIDATION_DETAILS})`,
+    })
+  }
   const context = err.validationContext ?? 'request'
   return new MegaValidationError('validation.failed', `Validation failed for ${context}`, {
     details,
@@ -45,10 +65,15 @@ export function ajvErrorToValidationError(err) {
  */
 function ajvItemToDetail(e) {
   // instancePath 예: '/email' → field = 'email'. '/items/0/name' → 'items[0].name'
-  const field = ajvPathToField(e.instancePath || e.dataPath || '')
+  let field = ajvPathToField(e.instancePath || e.dataPath || '')
   // ADR-090: required 같은 키워드는 instancePath 가 부모라 params.missingProperty 가 실제 필드.
   // 마스킹 판단은 instancePath 필드 + missingProperty 둘 다 본다.
   const missing = e.params && typeof e.params.missingProperty === 'string' ? e.params.missingProperty : ''
+  // required 위반의 field 는 누락 필드 경로로 보정 — 루트 required 면 field 가 '' 라 클라이언트가
+  // 어느 필드인지 알 수 없던 것을 missingProperty 로 채운다(ADR-188). 부모 경로가 있으면 dot 연결.
+  if (e.keyword === 'required' && missing) {
+    field = field ? `${field}.${missing}` : missing
+  }
   const isSensitive = SENSITIVE_FIELD_RE.test(field) || SENSITIVE_FIELD_RE.test(missing)
   return {
     field,