@loafacto/ui 0.7.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,72 @@
1
+ /**
2
+ * 쿠키 인증 fetch 클라이언트 — 플랫폼·hub·macro 가 같은 것을 쓴다.
3
+ *
4
+ * 세 앱은 같은 백엔드(api.loafacto.com)에 같은 httpOnly 쿠키(`lf_access`/`lf_refresh`)로
5
+ * 붙는다. 그런데 그 규칙을 각자 구현해 두고 있었다 —
6
+ *
7
+ * - platform : 명시적 함수 래퍼
8
+ * - hub : `window.fetch` 몽키패치(생짜 fetch 호출이 21 곳이라 그게 최소 변경이었다)
9
+ * - macro : 또 다른 자체 구현
10
+ *
11
+ * 규칙 자체는 셋이 같다. 그래서 **셋 중 하나가 갱신 경합 처리를 놓치면 그 앱만 조용히
12
+ * 로그아웃된다** — 화면이 여럿 동시에 401 을 받으면 갱신 요청이 그 수만큼 나가고,
13
+ * 늦게 도착한 갱신이 이미 회전된 refresh 토큰을 들이밀어 거부되기 때문이다.
14
+ * 여기서는 갱신을 하나로 묶는다(single-flight).
15
+ *
16
+ * 두 가지 사용법을 함께 낸다. 새 코드는 `api()` 를, 이미 생짜 fetch 로 짜인 코드는
17
+ * `install()` 을 쓴다. 둘은 같은 갱신 상태를 공유하므로 섞어 써도 갱신이 두 번 나가지 않는다.
18
+ */
19
+ export declare class ApiError extends Error {
20
+ readonly status: number;
21
+ /** 백엔드가 준 원본 payload. FastAPI 의 `detail` 이 객체일 때 필요하다. */
22
+ readonly detail?: unknown | undefined;
23
+ constructor(status: number, message: string,
24
+ /** 백엔드가 준 원본 payload. FastAPI 의 `detail` 이 객체일 때 필요하다. */
25
+ detail?: unknown | undefined);
26
+ }
27
+ export interface ApiClientOptions {
28
+ /** 백엔드 오리진. 끝 슬래시는 붙이지 않는다. 예: `https://api.loafacto.com` */
29
+ baseUrl: string;
30
+ /** 갱신 엔드포인트. 기본값은 hub 백엔드의 경로다. */
31
+ refreshPath?: string;
32
+ /**
33
+ * 이 요청이 인증 엔드포인트 자신인가. 참이면 401 을 갱신 대상으로 보지 않는다 —
34
+ * 로그인 실패(401)에 갱신을 시도하면 쓸데없는 왕복이 한 번 더 생긴다.
35
+ */
36
+ isAuthPath?: (url: string) => boolean;
37
+ /**
38
+ * 갱신까지 실패해 정말로 로그인이 끊겼을 때 한 번 불린다.
39
+ * hub 의 세션 만료 모달처럼 "다시 로그인" 을 띄우는 자리다.
40
+ * 401 이 여러 개 겹쳐도 **한 번만** 불린다.
41
+ */
42
+ onUnauthorized?: () => void;
43
+ /**
44
+ * 요청이 시작·종료될 때 +1 / -1 로 불린다. 전역 "처리 중" 표시에 쓴다.
45
+ * finally 에서 부르므로 실패해도 반드시 -1 이 온다.
46
+ */
47
+ onActivity?: (delta: 1 | -1) => void;
48
+ }
49
+ export interface ApiRequestOptions {
50
+ method?: string;
51
+ /** 객체면 JSON 으로 직렬화한다. FormData·Blob 은 그대로 보낸다(Content-Type 을 붙이지 않는다). */
52
+ body?: unknown;
53
+ headers?: Record<string, string>;
54
+ signal?: AbortSignal;
55
+ /** 401 을 갱신 대상으로 보지 않는다. */
56
+ noRetry?: boolean;
57
+ }
58
+ export interface ApiClient {
59
+ /** JSON 엔드포인트 호출. 실패하면 ApiError 를 던진다. 204 는 undefined 를 돌려준다. */
60
+ api<T = unknown>(path: string, options?: ApiRequestOptions): Promise<T>;
61
+ /** Response 를 그대로 받고 싶을 때(파일 내려받기 등). 쿠키·갱신은 똑같이 붙는다. */
62
+ request(path: string, options?: ApiRequestOptions): Promise<Response>;
63
+ /**
64
+ * `window.fetch` 를 덮어써서 baseUrl 로 가는 **모든** 요청에 같은 규칙을 건다.
65
+ * 이미 생짜 fetch 로 짜인 코드를 한 줄로 옮길 때 쓴다. 되돌리는 함수를 돌려준다.
66
+ *
67
+ * 여러 번 불러도 한 번만 적용된다 — HMR 로 두 번 실행되면 래퍼가 겹겹이 쌓여
68
+ * 요청 하나에 갱신이 두 번 붙는다.
69
+ */
70
+ install(): () => void;
71
+ }
72
+ export declare function createApiClient(options: ApiClientOptions): ApiClient;