Files

T

Antigravity Agent 504fd5fb42 [G1-Sync] Manual knowledge update

2026-05-10 22:08:15 +09:00

6.7 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

Parse, Don't Validate

매 한 줄

"매 unsafe input 매 한번 parse → 매 typed value 매 produce, 매 downstream 매 다시 검증 의 X". 매 2019 Alexis King (lexi-lambda) 의 Haskell post 의 origin. 매 핵심 idea: 매 validation 매 boolean 의 throw — 매 information 의 lose. 매 parsing 매 validated 형식 의 새 type 의 produce — 매 type system 의 매 invariant 의 carry.

매 핵심

매 validate 의 problem

// 매 anti-pattern
function isNonEmpty<T>(arr: T[]): boolean { return arr.length > 0; }

function head<T>(arr: T[]): T {
  if (!isNonEmpty(arr)) throw new Error("empty!");
  return arr[0];  // 매 type system 매 still T | undefined
}

매 isNonEmpty check 후 매 type 매 T[] (그대로) — 매 information lost.
매 head 매 매번 다시 check or throw.
매 caller 매 invariant 의 untracked.

매 parse 의 solution

type NonEmpty<T> = readonly [T, ...T[]];

function parseNonEmpty<T>(arr: T[]): NonEmpty<T> | null {
  return arr.length > 0 ? (arr as NonEmpty<T>) : null;
}

function head<T>(arr: NonEmpty<T>): T {
  return arr[0];  // 매 항상 safe — type system 의 guarantee
}

매 parse 결과 매 새 type — 매 invariant 가 매 type 에 baked in.
매 downstream 매 trust — 매 re-check 의 X.

매 응용

API request body validation (Zod / Effect Schema).
ID type discrimination (UserId vs OrderId).
URL / Email parsing.
Smart constructor (private constructor + parse function).
Domain modeling (PositiveNumber, NonEmptyString).

💻 패턴

1. Branded type (TypeScript)

type Brand<T, B> = T & { readonly __brand: B };
type Email = Brand<string, 'Email'>;

function parseEmail(s: string): Email | null {
  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(s) ? (s as Email) : null;
}

function sendMail(to: Email, body: string) { /* 매 trust to */ }

const raw = "user@example.com";
const email = parseEmail(raw);
if (!email) throw new Error("bad email");
sendMail(email, "hi");      // 매 OK
sendMail(raw, "hi");        // 매 type error

2. Zod schema (parse-style)

import { z } from 'zod';

const UserSchema = z.object({
  id: z.string().uuid(),
  email: z.string().email(),
  age: z.number().int().min(0).max(150),
});

type User = z.infer<typeof UserSchema>;  // 매 fully-typed

app.post('/users', (req, res) => {
  const result = UserSchema.safeParse(req.body);
  if (!result.success) return res.status(400).json(result.error);
  createUser(result.data);  // 매 trust — User type 매 guaranteed
});

3. Effect Schema (2026 의 매 modern)

import { Schema as S } from "effect";

const PositiveInt = S.Int.pipe(S.positive(), S.brand("PositiveInt"));
type PositiveInt = S.Schema.Type<typeof PositiveInt>;

const decode = S.decodeUnknownSync(PositiveInt);
const x = decode(42);   // 매 PositiveInt
const y = decode(-1);   // 매 throws ParseError

4. Smart constructor (Haskell-style)

class NonEmptyList<T> {
  private constructor(public readonly items: readonly T[]) {}

  static parse<T>(items: readonly T[]): NonEmptyList<T> | null {
    return items.length > 0 ? new NonEmptyList(items) : null;
  }

  get head(): T { return this.items[0]; }   // 매 always safe
  get tail(): readonly T[] { return this.items.slice(1); }
}

5. Discriminated ID type

type UserId = Brand<string, 'UserId'>;
type OrderId = Brand<string, 'OrderId'>;

function getUser(id: UserId): User { /*...*/ }
function getOrder(id: OrderId): Order { /*...*/ }

const uid = parseUserId(req.params.id);
if (!uid) throw new Error();
getUser(uid);                     // 매 OK
getOrder(uid);                    // 매 type error 매 prevent mix-up

6. Parse at boundary, trust within

// 매 boundary (HTTP / DB / file IO)
const userOrErr = UserSchema.safeParse(rawJson);

// 매 internal — User type 매 항상 valid
function processUser(u: User) {
  // 매 u.email 매 valid email — 매 re-check 의 X
  // 매 u.age 매 0-150 매 — 매 re-check 의 X
}

7. Refinement chain

const NonEmptyString = z.string().min(1).brand<'NonEmptyString'>();
const EmailString = NonEmptyString.refine(
  s => /^[^@]+@[^@]+$/.test(s)
).brand<'Email'>();
type Email = z.infer<typeof EmailString>;

매 결정 기준

상황	Apply parse-don't-validate?
Trust boundary (HTTP / DB / file)	Yes — 매 must
ID across multiple types	Yes — 매 brand to prevent mix
Hot path internal-only	Optional — perf trade-off
Quick script / prototype	Skip — overhead > value
Domain primitive (Money, Date)	Yes — 매 invariant carrying

기본값: 매 boundary 의 매 Zod (or Effect Schema) parse + 매 internal 의 매 inferred type 으로 trust.

🔗 Graph

부모: Type-Driven Design · Domain Modeling
변형: Refinement Type · Dependent Type · Smart Constructor
응용: Zod · Effect Schema · Branded Type · ADT (Algebraic Data Type)
Adjacent: Validation · Type Narrowing · Make Illegal States Unrepresentable

🤖 LLM 활용

언제: 매 API server / public library 의 매 input validation. 매 ID mix-up bug 매 routine 한 codebase. 매 domain rule 매 type-encode 가능 한 경우. 언제 X: 매 internal-only quick script. 매 highly dynamic JSON 의 schema 가 unknown. 매 perf-critical hot loop (parse overhead).

❌ 안티패턴

Validate 후 raw type 의 pass: 매 invariant 매 lose. 매 항상 새 type 의 return.
Parse 매 boundary X 의 매 매 layer 의 repeat: 매 perf 손실 + 매 동일 logic 의 duplicate.
Brand 의 매 runtime check 의 X: 매 cast 매 type-only — 매 parse function 매 항상 runtime check 포함.
Optional 의 abuse: 매 email?: string — 매 invariant 매 unclear. 매 명확한 Email | null.
Throw on parse fail (preference): 매 Result type / safeParse 의 매 prefer — 매 caller flow 매 explicit.

🧪 검증 / 중복

Verified (Alexis King "Parse, Don't Validate" 2019, Zod 4 / Effect 3.x docs 2026-05).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — Branded types + Zod/Effect Schema 의 modern parse pattern

6.7 KiB Raw Blame History