import 'server-only'; import { getApiBaseUrl } from '@/lib/env'; /** * 백엔드(edupay-backend) REST 호출 공용 클라이언트 — baseURL 결합, 타임아웃, JSON 헤더, * 공통 응답 봉투 `{ success, code, message, data }` 파싱을 여기서만 다룬다. Repository는 이 * 함수를 통해서만 백엔드를 호출하고, 직접 `fetch()`를 호출하지 않는다. * * ⚠️ 백엔드는 비즈니스 실패(예: 로그인 실패)도 HTTP 200으로 응답하고 응답 봉투의 `success` * 필드로만 성공/실패를 구분한다(실제 호출로 확인됨: POST .../admin/login에 잘못된 계정을 * 넣어도 status 200 + `{success:false, code:300, ...}`가 온다). 그래서 이 모듈은 HTTP status가 * 아니라 `success` 필드를 성공/실패의 유일한 판정 기준으로 삼는다. status가 2xx가 아닌 경우 * (5xx 등 인프라 오류)와 네트워크 실패·타임아웃·JSON 파싱 실패는 모두 "통신 오류"로 뭉뚱그려 * 반환한다 — 상세 사유는 서버 콘솔에만 남기고, 호출부·화면에는 일반화된 메시지만 전달해 * 내부 정보 노출을 막는다. * * 캐시 전략은 이 모듈이 강제하지 않는다 — 호출부(Repository)가 §2.6에 따라 매 호출마다 * `cache`/`next` 옵션을 명시해 전달해야 한다. */ const REQUEST_TIMEOUT_MS = 10_000; const COMMUNICATION_ERROR_CODE = -1; const COMMUNICATION_ERROR_MESSAGE = '서버와 통신할 수 없습니다. 잠시 후 다시 시도해 주세요.'; type BackendEnvelope = { success: boolean; code: number; message: string; data: T | null; }; export type BackendResult = | { ok: true; data: T } | { ok: false; code: number; message: string }; type BackendRequestInit = { method: 'GET' | 'POST'; body?: unknown; /** Next.js `fetch` 확장 옵션 — 호출부가 캐시 전략을 명시하는 용도. 둘 중 하나만 지정한다. */ cache?: RequestCache; next?: { revalidate?: number | false; tags?: string[] }; }; function communicationError(reason: string, detail: unknown): BackendResult { // 실패 상세는 서버 콘솔에만 남기고, 호출부·화면에는 일반화된 메시지만 전달한다. console.error(`[backend-fetch] ${reason}`, detail); return { ok: false, code: COMMUNICATION_ERROR_CODE, message: COMMUNICATION_ERROR_MESSAGE, }; } function resolveUrl(path: string): string { const base = getApiBaseUrl().replace(/\/+$/, ''); const suffix = path.startsWith('/') ? path : `/${path}`; return `${base}${suffix}`; } /** 백엔드 REST 호출 단일 진입점. */ export async function backendFetch( path: string, init: BackendRequestInit ): Promise> { let response: Response; try { response = await fetch(resolveUrl(path), { method: init.method, headers: { 'Content-Type': 'application/json' }, body: init.body !== undefined ? JSON.stringify(init.body) : undefined, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), cache: init.cache, next: init.next, }); } catch (error) { return communicationError('요청 실패(네트워크·타임아웃)', error); } if (!response.ok) { return communicationError(`예상치 못한 HTTP 상태: ${response.status}`, undefined); } let envelope: BackendEnvelope; try { envelope = (await response.json()) as BackendEnvelope; } catch (error) { return communicationError('응답 파싱 실패', error); } if (!envelope.success || envelope.data === null) { return { ok: false, code: envelope.code, message: envelope.message }; } return { ok: true, data: envelope.data }; }