Home

Nexa Wiki

Nexa는 요청을 선언적으로 조립하고 HTTP 캐시, 요청 신뢰성, 전송 관측을 직접 설계한 Swift 네트워크 라이브러리입니다.

이 Wiki는 기능 목록이 아니라 고려한 문제, 비교한 대안, 선택한 범위의 검증 방식을 기록합니다.

전체 흐름은 Nexa 설계 스토리에서 확인할 수 있습니다. 상세 문서는 상태 공유, 실패 복구, 관측 분리 순서로 읽을 수 있습니다.

HTTP 캐시 일관성: 동일 GET의 완료 응답과 진행 중 요청을 공유하는 범위, TTL과 조건부 재검증의 선택 기준을 설명합니다.
요청 신뢰성과 동시성 제어: HTTP 멱등성에 따른 재시도, Retry-After, 동시에 발생한 HTTP 401의 Bearer 토큰 갱신 공유를 설명합니다.
전송 관측과 응답 분리: URLSessionTaskMetrics를 Sendable 스냅샷으로 전달하고 관측 처리를 응답 반환과 분리한 이유를 설명합니다.

처음 Nexa의 설계를 읽는다면 위 설계 스토리를 먼저 읽으세요. 아래 문서는 이전 논의와 구조 변경의 맥락을 확인할 때 참고하는 기록입니다.