[#43] 디바운스를 구현하여 서버 요청을 최소화한다

[opficdev]

🔗 연관된 이슈

• closed 디바운스를 구현하여 서버 요청을 최소화한다 #43

📝 작업 내용

📌 요약

• 성공한 GET 응답을 짧은 TTL 동안 재사용하는 memory cache 추가
• 동시에 실행되는 동일 GET 요청을 하나의 transport 호출로 처리하도록 구성
• 요청 builder 내부 상태 노출 범위 축소 및 README 반영

🔍 상세

• NXClientConfiguration(cache:) 옵션 추가
• NXCache.disabled, NXCache.memory(ttl:) 추가
• NXResponseCacheInterceptor, NXResponseCacheStore, NXRequestCacheKey 추가
• cache 대상 조건을 GET, body 없음, .authorized() 미사용, 성공 status code로 제한
• cache key 기준을 HTTP method, URL, header set으로 구성
• NXRequestBuilder.requestSpec 내부 상태를 private으로 변경
• README.md, README.ko.md에 NXCache 사용 방식 추가

📸 영상 / 이미지 (Optional)

[gemini-code-assist]

Code Review

이번 PR은 성공한 비인증 GET 응답의 캐싱 및 동일 요청 병합을 위한 인메모리 캐시 기능(NXCache)을 도입합니다. 코드 리뷰 결과, NXResponseCacheStore에서 호출자 Task 취소 시 요청 병합이 깨지는 버그와 만료된 캐시가 누적되는 메모리 누수 문제가 발견되었습니다. 이를 해결하기 위해 비동기 Task 내부에서 성공/실패 처리를 수행하고 만료된 캐시를 명시적으로 제거하도록 개선을 요청했습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.