/* * API 클라이언트 — 백엔드 계약 base URL·JWT 헤더·오류 봉투(success/data/error) 처리. * 근거: _workspace/01_backend_contracts.md §0 (ApiResponse 봉투, 오류 코드→HTTP, 인증 헤더). * 웹 프론트(src/frontend/src/api/client.ts) 패턴과 정합. 시크릿 하드코딩 없음. */ import { API_BASE } from './config'; import { getAttestationToken } from './integrity'; import type { ApiError, ApiErrorCode, ApiResponse } from './types'; /** 봉투 error를 그대로 던지는 오류 타입 — UI는 code로 분기(OTP_REQUIRED·COMPLIANCE_BLOCKED 등). */ export class ApiRequestError extends Error { readonly code: ApiErrorCode | 'NETWORK' | 'UNKNOWN'; readonly httpStatus: number; constructor(code: ApiRequestError['code'], message: string, httpStatus: number) { super(message); this.name = 'ApiRequestError'; this.code = code; this.httpStatus = httpStatus; } } /** 서버 미구현(501/NOT_IMPLEMENTED)·네트워크 장애 등 폴백(degraded) 판정 헬퍼. */ export function isDegraded(e: unknown): boolean { if (!(e instanceof ApiRequestError)) return false; return ( e.code === 'NETWORK' || e.code === 'NOT_IMPLEMENTED' || e.code === 'INTERNAL' || e.httpStatus === 501 || e.httpStatus >= 502 ); } // ── 메모리 내 액세스 토큰 (영속은 AuthContext가 secure-store로 관리) ── let accessToken: string | null = null; export function setAccessToken(token: string | null): void { accessToken = token; } export function getAccessToken(): string | null { return accessToken; } interface RequestOptions { method?: 'GET' | 'POST' | 'PUT' | 'DELETE'; body?: unknown; signal?: AbortSignal; /** 인증 헤더 생략(공개 경로: login·register·forgot·reset·health). */ anonymous?: boolean; } async function request(path: string, opts: RequestOptions = {}): Promise { const headers: Record = { 'Content-Type': 'application/json' }; if (!opts.anonymous && accessToken) headers.Authorization = `Bearer ${accessToken}`; // B2 앱 무결성 토큰(Play Integrity/App Attest) — 발급기 등록 시에만 첨부(미등록 시 null → 무해). // 서버 검증 엔드포인트는 backend-dev 인계(_workspace/08_mobile_security_hardening.md). if (!opts.anonymous) { const attestation = await getAttestationToken(); if (attestation) headers['X-Integrity-Token'] = attestation; } let res: Response; try { res = await fetch(`${API_BASE}${path}`, { method: opts.method ?? 'GET', headers, body: opts.body != null ? JSON.stringify(opts.body) : undefined, signal: opts.signal, }); } catch (e) { if ((e as Error).name === 'AbortError') throw e; throw new ApiRequestError('NETWORK', '네트워크 연결을 확인해 주세요.', 0); } if (res.status === 401) { // 토큰 만료/무효 — 메모리 토큰 정리 (라우터가 로그인으로 유도) accessToken = null; } let payload: ApiResponse | null = null; const text = await res.text(); if (text) { try { payload = JSON.parse(text) as ApiResponse; } catch { payload = null; } } if (!res.ok || (payload && payload.success === false)) { const err: ApiError | null = payload?.error ?? null; throw new ApiRequestError( (err?.code as ApiErrorCode) ?? 'UNKNOWN', err?.message ?? `요청을 처리하지 못했습니다. (${res.status})`, res.status, ); } if (!payload) { return undefined as unknown as T; } return payload.data as T; } export const api = { get: (path: string, opts?: Omit) => request(path, { ...opts, method: 'GET' }), post: (path: string, body?: unknown, opts?: Omit) => request(path, { ...opts, method: 'POST', body }), put: (path: string, body?: unknown, opts?: Omit) => request(path, { ...opts, method: 'PUT', body }), };