[G1-Sync] Manual knowledge update

10_Wiki/Topics/Programming & Language/서드파티 라이브러리 및 API 연동.md

@@ -1,5 +1,5 @@
 ---
-id: P-REINFORCE-AUTO-ACB5DA
+id: [[P-Reinforce]]-AUTO-ACB5DA
 category: "10_Wiki/💡 Topics/Programming & Language"
 confidence_score: 0.90
 tags: [auto-reinforced]
@@ -17,7 +17,7 @@ github_commit: "[P-Reinforce] Continuous Worker - 서드파티 라이브러리
   외부 API나 서드파티에서 들어오는 데이터는 시스템의 경계(Boundary) 지점에서 `Zod`와 같은 런타임 검증 라이브러리를 통해 잘 정의된 타입으로 파싱되어야 합니다 [1-4]. 단순한 유효성 검사를 넘어, 알 수 없는 데이터를 완전히 타입이 지정된 데이터(예: 브랜디드 타입)로 변환함으로써 시스템 내부 로직으로 신뢰할 수 있는 데이터만 유입되도록 강제해야 합니다 [4, 5].
 
 * **안전한 API 응답 처리 패턴:**
-  API 응답을 처리할 때 식별 가능한 유니온(Discriminated Unions)을 활용하면 성공, 실패, 로딩 등 다양한 응답 상태를 안전하고 빈틈없이 모델링할 수 있습니다 [6, 7]. 또한 외부 백엔드 API 데이터를 프론트엔드 모델로 매핑할 때는 `satisfies` 연산자를 활용하는 것이 좋습니다. 이를 통해 초과 속성 검사(Excess Property Checking)를 강제하여 오타나 원치 않는 잉여 데이터가 유입되는 것을 방지하면서도 구체적인 타입을 유지할 수 있습니다 [8-10].
+  API 응답을 처리할 때 식별 가능한 유니온([[Discriminated Unions]])을 활용하면 성공, 실패, 로딩 등 다양한 응답 상태를 안전하고 빈틈없이 모델링할 수 있습니다 [6, 7]. 또한 외부 백엔드 API 데이터를 프론트엔드 모델로 매핑할 때는 `satisfies` 연산자를 활용하는 것이 좋습니다. 이를 통해 초과 속성 검사([[Excess Property Checking]])를 강제하여 오타나 원치 않는 잉여 데이터가 유입되는 것을 방지하면서도 구체적인 타입을 유지할 수 있습니다 [8-10].
 
 * **서드파티 연동 SDK 설계 (Facade 패턴):**
   외부 연동사가 사용하는 SDK를 설계할 때는 퍼사드(Facade) 패턴을 적용하여 사용자의 인지 부하를 줄이고 암묵적인 의존성을 제거해야 합니다 [5, 11, 12]. 복잡한 인증, 재시도, 리소스 정리(Cleanup) 로직을 내부로 숨기고 사용자의 자연스러운 목적을 나타내는 고수준(High-level) 인터페이스를 제공하는 것이 핵심입니다 [12]. 동시에 세밀한 제어가 필요한 20%의 특수 케이스를 위해 저수준(Low-level) API를 탈출구(Escape Hatch)로 함께 제공하여 유연성을 확보해야 합니다 [13, 14].