@inho-team/api-client

OpenAPI 경로 타입을 유지하는 openapi-fetch 클라이언트를 요청마다 생성합니다. 인증 상태와 갱신 대기열은 인스턴스 안에만 존재합니다.

import { createApiClient, parseApiData } from "@inho-team/api-client";
import { recordSchema } from "./record-schema.js";
import type { paths } from "./generated/schema.js";

const api = createApiClient<paths>({
  baseUrl: "/api/v1",
  getAccessToken: () => session.accessToken,
  refreshAccessToken: async (rawFetch) => {
    const response = await rawFetch("/api/v1/auth/refresh", { method: "POST" });
    return response.ok ? (await response.json()).accessToken : null;
  },
  shouldSkipAuth: (request) => request.url.endsWith("/auth/login"),
});

const result = await api.GET("/records");
const records = parseApiData(result, recordSchema.parse);

갱신 콜백은 전달된 rawFetch를 사용해야 합니다. 이 함수는 클라이언트의 401 재시도 경로를 거치지 않습니다. shouldSkipAuth로 지정한 요청은 토큰 주입과 갱신을 모두 건너뜁니다. SSR에서는 HTTP 요청마다 클라이언트를 생성해야 합니다. 응답의 런타임 검증은 서비스가 소유하는 스키마를 parseApiData에 전달해 수행합니다.

요청의 AbortSignal이 취소되면 공유 중인 토큰 갱신을 기다리던 해당 요청도 즉시 종료합니다. 다른 요청을 위한 갱신 작업은 계속 진행됩니다.