README-ko_kr.md

다양한 프레임워크를 위한 강력한 패칭 미들웨어, 유연한 HTTP 클라이언트 관리

English   •   한국어

Query Adaptor란?

Fetch API는 기본적인 기능만 제공하기 때문에 개발자가 필요한 기능을 직접 구현해야 하는 경우가 많아요. 예를 들어 요청 실패 시 자동 재요청, 인증 토큰 갱신, 요청 및 응답 로깅, 요청 취소와 같은 기능은 Fetch API 자체에서는 지원하지 않기 때문에 수동으로 추가해야 했어요. 또한, 동일한 설정을 반복적으로 작성해야 하는 번거로움도 존재해요.

이러한 한계점을 극복하기 위해 개발한 것이 바로 Query Adaptor예요. 이름 그대로 간단하게 질의하듯이 사용할 수 있어 네트워크 통신 로직에 대한 복잡성을 줄여줘요. 간단하게 질의하듯이 선언적으로 사용하여 네트워크 통신에 대한 부담을 덜고, 핵심 로직에 집중하세요!

주요 기능

• 🧰 Fetch API의 확장: Fetch API에서 더 풍부한 기능을 제공해요. Instance, Interceptor, Effect 등의 기능을 통해 복잡한 설정을 최소화하고 유연한 HTTP 통신을 구현할 수 있어요.
• 🧩 다양한 환경 지원: 다양한 환경에서 손쉽게 사용할 수 있도록 설계되었어요. Query Adaptor를 단순히 어댑터처럼 활용하여, Next.js, React Native, Tauri와 같이 특수한 Fetch API 환경에서도 완벽히 동작해요.
• ✨ 강력한 타입 세이프: TypeScript를 100% 지원하며, 정확한 타입추론을 위해 필요한 타입만을 요구해요. 덕분에 불필요한 타입을 최소화하고 강력하게 타입 안정성을 보장해요.

패키지

query-adaptor ·

Query Adaptor의 핵심 기능을 제공해요.

• query
• createQueryAdaptor
• fetchOptions

@query-adaptor/react-query ·

Query Adaptor를 React Query와 쉽게 사용할 수 있도록 도와주는 기능을 제공해요.

• queryFetchFn
• queryFetchKey

공식 문서

공식 문서에 방문하시면 설치, 사용 방법 등 더 자세한 정보를 확인할 수 있어요.

기여하기

해당 프로젝트에 기여하고 싶다면 아래 문서를 참고해주세요.

CONTRIBUTING.md

기여자

라이선스

자세한 사항은 LICENSE를 참고해주세요.

MIT © gwansikk