react query helper

TYPESCRIPT IN. REUSABLE OPTIONS OUT.

API는 그대로.
쿼리는 준비 끝.

기존 TypeScript API 함수에서 TanStack Query v5 query·mutation·무한 쿼리 옵션과 쿼리 키를 자동 생성하세요. React Query 반복 코드를 줄이고 watch·CI 검증을 연결하는 개발 도구입니다.

생성 코드 살펴보기 ↓시작 가이드 ↗

TanStack Query v5 · TypeScript · React 18 / 19 · MIT

01 / REAL GENERATOR OUTPUT

함수는 유지하고, 반복은 줄이세요.

이 예제는 저장소의 실제 분석기와 코드 생성기로 빌드할 때 만듭니다. 함수를 선택하면 원본과 생성 결과를 대조할 수 있습니다.

기존 API 함수

export const getUser = async (id: string) => ({ id, name: 'Ada' });

자동 생성된 옵션

import { getUser } from "./api";
import { queryOption as __rqh_query, infiniteOption as __rqh_infinite } from "@uiwwsw/react-query-helper";

export const getUserKey = ["users","api","getUser"] as const;
export const getUserQueryOption = __rqh_query(getUserKey, getUser);
export const getUserInfiniteQueryOption = __rqh_infinite(getUserKey, getUser);

실제 서버를 호출하는 화면이 아닌 코드 생성 미리보기입니다. 페이지네이션과 AbortSignal 전달은 API에 맞게 명시적으로 구성합니다.

02 / FROM INSTALL TO CI

한 번 설정하고,
계속 같은 흐름으로.

한 번 생성하고, 개발 중에는 watch로 갱신하고, CI에서는 생성 결과를 검사하세요. useQuery·prefetchQuery·캐시 조회에 동일한 팩토리를 재사용합니다.

npm install @uiwwsw/react-query-helper@^2 @tanstack/react-query react
npx @uiwwsw/react-query-helper init
npx @uiwwsw/react-query-helper generate
npx @uiwwsw/react-query-helper watch
npx @uiwwsw/react-query-helper generate --check

React Query Helper는 무엇을 생성하나요?

TypeScript 최상위 API 함수에서 타입이 있는 쿼리 키와 query·mutation·infinite query 옵션 팩토리를 생성합니다. 기존 HTTP 클라이언트를 유지하며 TanStack Query의 캐시·재시도 동작은 대체하지 않습니다.

설정·페이지네이션·마이그레이션 ↗