@remember-web/sse 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,238 @@
+# @remember-web/sse
+
+티켓 기반 SSE(Server-Sent Events) 수신 클라이언트 SDK입니다.
+
+- **연결은 하나** — SharedWorker로 여러 탭이 SSE 연결 1개를 공유합니다 (미지원 환경은 탭별 연결로 자동 폴백)
+- **알아서 복구** — 끊기면 지수 백오프로 재연결하고, 복구되면 `resync` 신호로 "놓친 구간을 다시 조회하라"고 알립니다
+- **타입은 소비처 소유** — 이벤트 이름·페이로드 타입은 앱이 정의한 맵에서 추론됩니다. SDK는 어떤 도메인 이벤트가 오는지 모릅니다
+
+## 설치
+
+```bash
+npm install @remember-web/sse
+```
+
+## 빠른 시작 (React)
+
+```tsx
+// sse.ts — 앱당 1회, 모듈 스코프에서 호출합니다 (렌더 중 호출 금지)
+import { createSseContext } from '@remember-web/sse/react';
+
+// 이벤트 이름·페이로드는 서버와 앱 사이의 계약입니다 — 여기에 그 계약을 적습니다
+interface AppEventMap {
+  'notification.created': { id: string; title: string };
+}
+
+export const { SseProvider, useSseEvent, useSseStatus } =
+  createSseContext<AppEventMap>();
+```
+
+```tsx
+// App.tsx
+<SseProvider
+  baseUrl="https://api.example.com"
+  getAuthToken={() => auth.accessToken}
+  enabled={isLoggedIn}
+  sharedWorker={() =>
+    new SharedWorker(new URL('@remember-web/sse/worker', import.meta.url), {
+      name: 'app-sse',
+      type: 'module',
+    })
+  }
+>
+  <App />
+</SseProvider>
+```
+
+```tsx
+// 화면 — 이벤트명만 적으면 페이로드 타입이 추론됩니다
+useSseEvent('notification.created', (event) => showToast(event.title));
+
+// 재수립 신호 — 끊겨 있던 사이의 공백은 REST 재조회로 메웁니다
+useSseEvent('resync', () => queryClient.invalidateQueries(...));
+
+const status = useSseStatus(); // 'reconnecting'이면 "연결 중…" 표시 등
+```
+
+이게 전부입니다. 연결·해제는 `SseProvider`가 수명주기에 맞춰 처리하고, 탭이 다시 보일 때의 재개(`attachAutoResume`)도 자동으로 배선됩니다.
+
+## 구조 — 무엇이 어디에 있나
+
+```mermaid
+flowchart TD
+  subgraph TAB ["각 탭"]
+    A["화면 컴포넌트"] --> B["useSseEvent · useSseStatus"]
+    B --> C["SseProvider"]
+    C --> D{"createSseClient()"}
+    D -->|"sharedWorker 미제공<br/>또는 미지원 브라우저"| E["SseClient<br/>(탭별 직접 연결)"]
+    D -->|"sharedWorker 제공"| F["WorkerSseClient<br/>(워커 프록시)"]
+  end
+  subgraph WORKER ["SharedWorker — 모든 탭이 공유"]
+    G["허브<br/>탭 장부·구독 취합·티켓 위임"] --> H["워커 연결<br/>(SseClient 재사용)"]
+  end
+  F -.->|"MessagePort"| G
+  E --> S[("SSE 서버")]
+  H --> S
+```
+
+| 모듈 | 역할 | 소비처가 아는가 |
+|---|---|---|
+| `createSseContext` (react) | 앱 이벤트 맵으로 Provider·훅 세트를 생성 — 타입 추론의 진입점 | ✅ 주 표면 |
+| `createSseClient` (core) | 환경을 보고 두 구현 중 하나를 골라 만드는 단일 생성 진입점 | React 없이 쓸 때만 |
+| `SseClient` | 탭별 직접 연결 — 티켓 발급 → 스트림 유지 → 재연결 루프의 원본 구현 | ❌ 내부 |
+| `WorkerSseClient` | 같은 인터페이스의 탭 측 프록시 — 연결은 워커가 소유, 탭은 메시지로 중계받음 | ❌ 내부 |
+| 워커 허브 | 탭 장부(누가 살아 있나)·구독 취합·티켓 발급 위임(인증 토큰은 탭에만 있음) | ❌ 내부 |
+
+두 구현(`SseClient`·`WorkerSseClient`)은 같은 인터페이스(`SseClientLike`)를 지키므로, **소비처 코드는 어느 경로로 연결됐는지 몰라도 동일하게 동작합니다.**
+
+## 연결의 수명
+
+```mermaid
+sequenceDiagram
+  participant C as 클라이언트
+  participant S as 서버
+  C->>S: POST /v1/events/ticket (인증 토큰)
+  S-->>C: { data: { ticket } } — 수명이 짧아 즉시 사용합니다
+  C->>S: GET /v1/events?ticket=… (EventSource)
+  S-->>C: event: hello
+  Note over C: 이때부터 open — 재수립이면 resync 발화
+  loop 수신 중
+    S-->>C: event: notification.created …
+  end
+  Note over C,S: 끊김 → 백오프 대기 → 티켓부터 다시 (무한 재시도)
+```
+
+`hello`를 받아야 `open`입니다 — HTTP 응답이 열렸다는 것과 이벤트 파이프라인이 연결됐다는 것을 구분하기 위한 서버의 수립 완료 신호입니다.
+
+### 상태
+
+```mermaid
+stateDiagram-v2
+  [*] --> idle
+  idle --> connecting: connect()
+  connecting --> open: hello 수신
+  connecting --> reconnecting: 네트워크성 실패
+  connecting --> fatal: 티켓 거부 · 생성 실패
+  open --> reconnecting: 끊김 · goaway(retry)
+  open --> fatal: 예상 못 한 예외
+  open --> closed: goaway(close)
+  reconnecting --> connecting: 백오프 만료
+```
+
+여기에 더해 **어느 상태에서든 `disconnect()`는 `closed`로** 갑니다. `closed`·`fatal`에서 다시 받으려면 `connect()`를 부릅니다(`fatal`은 `disconnect()`로 정리한 뒤).
+
+## 실패와 회복 — 소비처 계약
+
+`connect()`는 **던지지 않고 Promise도 돌려주지 않습니다.** 실패는 전부 상태(`onStatus`)와 이벤트로 옵니다.
+
+연결에 문제가 생기면 세 이벤트로 알립니다. 구분축은 **"누가 결정했고, 재시도는 어떻게 되나"**입니다.
+
+|  | `stalled` | `fatal` | `goaway` |
+|---|---|---|---|
+| 한 줄로 | 고전 중이라는 신고 | SDK의 포기 선언 | 서버의 작별 인사 |
+| 출처 | SDK 합성 — 와이어에 없음 | SDK 합성 — 와이어에 없음 | **서버 발신** — 와이어의 `event: goaway` |
+| 결정 주체 | SDK — 응답 없는 실패 연속 5회 관찰 | SDK — 재시도 무의미 판정 | 서버 — 산 연결 위에서 예고 |
+| 재시도 | **계속되는 중** (회복되면 자동으로 이어짐) | 없음 — 멈춤 | `action: 'retry'`면 SDK가 즉시 재수립, `'close'`면 종료 |
+| 몇 번 오나 | 미연결 구간마다 1회 — 회복(open) 후 다시 끊기면 또 옴 | 세션당 1회 — 멈추므로 반복 없음 (`disconnect()` → `connect()`로 재개한 뒤에만 다시 올 수 있음) | 서버가 보낼 때마다 — `retry`는 재수립 후 또 올 수 있고, `close`는 그 연결의 마지막 메시지 |
+| 성격 | 항상 이상 | 항상 이상 (`cause`로 사유 구분) | 정상 절차일 수 있음 — 배포·로그아웃·점검 |
+| 소비처가 할 일 | 진행형 안내 | 사유별 안내, 해소 후 `disconnect()` → `connect()` | `action: 'close'`일 때만 `reason`별 안내 |
+
+(`resync`는 에러가 아니라 재수립 후의 데이터 복구 신호라 이 표 밖입니다 — 아래 표의 "재연결 성공" 행 참조.)
+
+상황별 상세 계약:
+
+| 상황 | SDK가 하는 일 | 소비처가 받는 것 | 소비처가 할 일 |
+|---|---|---|---|
+| 네트워크 끊김·서버 5xx·응답 타임아웃 | 지수 백오프(1s→최대 30s, jitter)로 **무한 자동 재연결** | status `reconnecting` | (선택) "연결 중…" 표시 |
+| 네트워크 에러 지속 (오프라인·CORS 차단·접속 거부 등 응답 없는 실패가 연속 5회) | **재시도를 계속하면서** 한 번 알림 | **`stalled` 이벤트** | 네트워크·보안 정책 안내 (fatal이 아닙니다 — 회복되면 자동으로 이어집니다) |
+| 재연결 성공 | 수신 재개 | **`resync` 이벤트** | 끊긴 사이의 공백을 REST 재조회로 메움 |
+| 티켓 발급 401/403 | 멈춤 (자동 재시도 없음) | status `fatal` + **`fatal` 이벤트** `{ cause: 'auth', status }` | 재로그인 유도 |
+| 티켓 발급 429 | 멈춤 | `fatal` 이벤트 `{ cause: 'rate_limit', status: 429 }` | 한도 안내, 잠시 후 재시도 |
+| `getAuthToken` 콜백이 예외를 던짐 | 멈춤 | `fatal` 이벤트 `{ cause: 'auth_callback' }` | 소비처 코드 문제 — 콜백은 실패 시 throw 대신 `null`을 반환해야 합니다 |
+| SharedWorker 생성 차단 (CSP 등) | 멈춤 | `fatal` 이벤트 `{ cause: 'blocked' }` | 환경 안내 |
+| EventSource 생성 실패 (잘못된 `baseUrl` 등) | 멈춤 | `fatal` 이벤트 `{ cause: 'config' }` | 설정 오류 — 재시도해도 되살아나지 않으니 재시도 안내를 하지 마세요 |
+| 그 외 예상 못 한 오류 | 멈춤 | `fatal` 이벤트 `{ cause: 'unknown' }` | 일반 오류 안내 |
+| 서버가 재연결 지시 (배포 등) | 대기 없이 즉시 재수립 | `goaway` 이벤트 (`action: 'retry'`) | 없음 |
+| 서버가 종료 지시 | 재연결하지 않고 닫음 | status `closed` + `goaway` 이벤트 (`action: 'close'`, `reason` 포함) | `reason`별 안내 (로그아웃·점검 등) |
+
+- **`fatal`의 회복 계약**: 사유를 해소한 뒤 `disconnect()` → `connect()` — **회복은 `fatal` 이벤트 핸들러에서 시작하세요.** status 리스너에서 `'fatal'`만 보고 끊으면 워커 경로에선 뒤따라오던 사유가 유실될 수 있습니다. 자동 재개(`attachAutoResume`)는 `fatal`·`closed`를 되살리지 않습니다 — 끊은 의도를 존중합니다.
+- **사유는 발화 순간의 구독자에게만 갑니다** — 재생이 없으므로 `fatal`(과 `goaway`·`stalled`) 핸들러는 화면 단위가 아니라 앱 루트에 고정하세요.
+- **`stalled`는 진행형 통지입니다** — 응답 status가 없는 네트워크성 실패가 hello에 닿지 못한 채 연속 5회 이어지는 순간 1회 발화하고, 그 뒤에도 재시도는 계속됩니다. 브라우저는 오프라인·CORS 차단·접속 거부를 구분해주지 않으므로 사유는 싣지 않고, 서버가 응답한 실패(5xx, 본문이 계약과 다른 200)는 네트워크 문제가 아니라 세지 않고, 연속 판정을 끊습니다. 회복은 별도 이벤트 없이 status가 `open`으로 바뀌는 것으로 알 수 있고, 그때 판정이 리셋되어 다음 구간에 다시 발화합니다.
+- **`resync`가 데이터 복구의 전부입니다.** SDK는 이벤트를 저장·재전송하지 않습니다. 실시간 이벤트는 "지금 일어난 일"의 알림이고, 정합성의 원천은 REST API입니다.
+
+## 이벤트 계약
+
+- **이벤트 이름·페이로드 타입은 소비처 소유입니다.** 서버와 앱 사이의 계약을 `createSseContext<M>`의 맵에 적으면 SDK는 그대로 흘려보냅니다.
+- **예약 이벤트명 5개는 도메인 맵에 쓰지 마세요**: `hello`(SDK가 소비), `resync`·`goaway`·`fatal`·`stalled`(SDK가 발화해 소비처에 배달). 맵에 같은 이름을 정의하면 타입이 충돌합니다.
+- **모르는 이벤트는 무시됩니다** — 서버가 이벤트를 추가해도 구버전 앱은 깨지지 않습니다.
+- **JSON이 아닌 페이로드는 원문 문자열 그대로 배달됩니다** — SDK가 임의로 버리지 않습니다.
+- **핸들러 예외는 격리됩니다** — 한 구독자가 던져도 다른 구독자와 연결에는 영향이 없고, `logger.warn`으로 보고됩니다.
+
+## 탭 간 연결 공유 (SharedWorker)
+
+`sharedWorker` 옵션을 주면 여러 탭이 연결 1개를 공유합니다. 서버 동시 연결 슬롯과 브라우저 연결 수 제한을 아낍니다.
+
+```ts
+sharedWorker: () =>
+  new SharedWorker(new URL('@remember-web/sse/worker', import.meta.url), {
+    name: 'app-sse',
+    type: 'module',
+  })
+```
+
+- **URL은 번들러가 해석해야 하므로** 인스턴스가 아닌 팩토리를 받습니다. `new URL(…, import.meta.url)` 패턴은 Vite·webpack 5가 지원합니다.
+- **미지원 브라우저는 자동으로 탭별 직접 연결로 폴백**합니다 (`logger.warn`으로 알림).
+- 인증 토큰은 워커로 넘어가지 않습니다 — 티켓 발급은 살아 있는 탭 하나에 위임됩니다.
+- 백그라운드 탭이 얼어붙어도(frozen) 밀린 이벤트는 깨어날 때 그대로 배달됩니다. 전 탭이 얼어붙으면 연결을 접고, 깨어난 탭의 `connect()`가 다시 세웁니다 — `SseProvider`가 이 재개를 자동 배선합니다.
+- **배포 주의**: 워커 스크립트가 캐시된 구버전이면 신버전 탭과 잠시 섞일 수 있습니다. 미지의 메시지는 양쪽 다 무시하도록 설계돼 있어 안전하지만, 구버전 워커는 새 이벤트(예: `fatal`)를 중계하지 못할 수 있으니 **치명 실패 처리에는 `onStatus`의 `'fatal'`을 폴백으로** 함께 보세요.
+
+## SSR
+
+생성은 어느 환경에서든 안전합니다 — 브라우저 전역이 없으면 `connect()`는 조용히 no-op이고, 첫 렌더의 status는 `idle`입니다. 훅은 `SseProvider` 안에서만 호출하세요.
+
+## React 없이 쓰기
+
+```ts
+import { createSseClient, wire } from '@remember-web/sse';
+
+const client = createSseClient<AppEventMap>({
+  baseUrl: 'https://api.example.com',
+  getAuthToken: () => auth.accessToken,
+});
+
+// 핸들러 맵 일괄 등록 — 반환 함수 하나로 전부 해제
+const unwire = wire(client, {
+  'notification.created': (event) => badge.increment(),
+  resync: () => badge.refetch(),
+  fatal: ({ cause }) => handleFatal(cause),
+});
+
+client.connect();
+const detach = client.attachAutoResume(); // 탭 복귀 시 자동 재개 (선택)
+
+// 정리
+detach();
+unwire();
+client.disconnect();
+```
+
+`on('fatal')` 같은 구독은 `connect()`보다 먼저 걸어두세요 — 생성 단계에서 동기 발화되는 실패(`blocked`)를 놓치지 않습니다.
+
+## 옵션
+
+| 옵션 | 필수 | 설명 |
+|---|---|---|
+| `baseUrl` | ✅ | SSE 서버 오리진. `POST {baseUrl}/v1/events/ticket`, `GET {baseUrl}/v1/events`를 사용합니다 |
+| `getAuthToken` | ✅ | 티켓 발급 요청의 인증 토큰. 호출 시점마다 불리므로 최신 토큰을 돌려주면 됩니다. `null`이면 인증 헤더 없이 요청. **실패 시 throw 대신 `null`을 반환하세요** — 예외가 새어 나오면 재시도 없이 `fatal { cause: 'auth_callback' }`로 멈춥니다 |
+| `sharedWorker` | | SharedWorker 팩토리 — 제공하면 탭 간 연결 공유, 미제공이면 탭별 직접 연결 |
+| `backoff` | | 재연결 대기 조정: `initialDelayMs`(1000) · `maxDelayMs`(30000) · `multiplier`(2) |
+| `logger` | | `warn`·`error`를 받는 로거. 연결 실패 사유·설정 실수가 여기로 보고됩니다 |
+| `fetch` / `eventSource` | | 주입점 (테스트·특수 환경용). `eventSource`는 워커 경로에는 적용되지 않습니다 |
+
+## 서버 요구 사항
+
+이 SDK는 다음 계약의 서버를 전제합니다.
+
+- `POST /v1/events/ticket` — 인증 토큰을 받고 짧은 수명의 일회용 티켓을 발급 (`{ data: { ticket } }` — 사내 기본 응답 스키마)
+- `GET /v1/events?ticket=…` — `text/event-stream`. 수립 직후 `hello` 이벤트를 1회 전송
+- (선택) `goaway` 이벤트 — `{ action: 'retry' | 'close', reason?: string }`으로 클라이언트에 재연결·종료를 지시

package/dist/src/core/BaseSseClient.cjs.js

@@ -0,0 +1,97 @@
+'use strict';
+
+var _classCallCheck = require('@babel/runtime/helpers/classCallCheck');
+var _createClass = require('@babel/runtime/helpers/createClass');
+var _defineProperty = require('@babel/runtime/helpers/defineProperty');
+var emitter = require('./emitter.cjs.js');
+var eventNames = require('./eventNames.cjs.js');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _classCallCheck__default = /*#__PURE__*/_interopDefault(_classCallCheck);
+var _createClass__default = /*#__PURE__*/_interopDefault(_createClass);
+var _defineProperty__default = /*#__PURE__*/_interopDefault(_defineProperty);
+
+/**
+ * @description 두 구현이 공유하는 구독 표면 — 구독 장부(emitter)를 소유하고 on·onStatus를 확정합니다.
+ * 연결을 어떻게 다루는지는 모릅니다: 구현마다 다른 것만 추상 멤버로 남깁니다.
+ * 같아야 할 것을 한 벌로 두기 위한 클래스입니다 — 두 구현이 각자 배선하다 갈린 이력이 있습니다.
+ */
+var BaseSseClient = /*#__PURE__*/function () {
+  function BaseSseClient(logger) {
+    _classCallCheck__default.default(this, BaseSseClient);
+    _defineProperty__default.default(this, "emitter", void 0);
+    this.logger = logger;
+    this.emitter = emitter.createEmitter(logger);
+  }
+  return _createClass__default.default(BaseSseClient, [{
+    key: "on",
+    value: function on(type, handler) {
+      if (eventNames.isUndeliverableEvent(type)) {
+        var _this$logger;
+        (_this$logger = this.logger) === null || _this$logger === void 0 || _this$logger.warn("sse: '".concat(type, "'\uB294 SDK\uAC00 \uC18C\uBE44\uD558\uB294 \uC608\uC57D \uC774\uBCA4\uD2B8\uB77C \uAD6C\uB3C5\uC774 \uBC30\uB2EC\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4"));
+      }
+      this.registerSubscription(type);
+      return this.emitter.on(type, handler);
+    }
+  }, {
+    key: "onStatus",
+    value: function onStatus(listener) {
+      return this.emitter.onStatus(listener);
+    }
+
+    /**
+     * @description 탭이 돌아올 때 connect()를 다시 부릅니다 — 전원이 얼어붙어 접힌 연결(휴면)은
+     * 깨어난 탭의 이 호출만이 다시 세울 수 있습니다. 연결이 살아 있으면 아무 일도 없습니다.
+     * bfcache 복귀는 visibilitychange가 아니라 pageshow로만 알 수 있어 둘 다 봅니다.
+     * SSR에는 붙일 곳이 없어 아무 일도 하지 않습니다.
+     *
+     * @returns 리스너를 떼는 함수 — 클라이언트를 버릴 때 함께 부르세요
+     */
+  }, {
+    key: "attachAutoResume",
+    value: function attachAutoResume() {
+      var _this = this;
+      if (typeof document === 'undefined' || typeof window === 'undefined') {
+        return function () {};
+      }
+
+      // 되살릴 대상은 idle입니다 — 전원 침묵으로 접힌 휴면이 이 상태입니다(workerConnection.close).
+      // closed(소비처 disconnect·서버 goaway close)는 끊은 의도를 되살리지 않고,
+      // fatal의 회복 계약은 disconnect 후 connect라 자동 재개가 대신할 수 없습니다
+      var notifyAlive = function notifyAlive() {
+        if (_this.status === 'closed' || _this.status === 'fatal') {
+          return;
+        }
+        _this.connect();
+      };
+      var onVisible = function onVisible() {
+        if (document.visibilityState === 'visible') {
+          notifyAlive();
+        }
+      };
+
+      // persisted = bfcache 복귀, 직결 경로용 — Chrome은 SharedWorker 페이지를 bfcache에 넣지 않고,
+      // 넣는 브라우저라면 포트가 이미 죽어 이 connect가 닿지 않습니다(알려진 한계)
+      var onPageShow = function onPageShow(event) {
+        if (event.persisted) {
+          notifyAlive();
+        }
+      };
+      document.addEventListener('visibilitychange', onVisible);
+      window.addEventListener('pageshow', onPageShow);
+      return function () {
+        document.removeEventListener('visibilitychange', onVisible);
+        window.removeEventListener('pageshow', onPageShow);
+      };
+    }
+
+    /**
+     * @description 구독이 등록될 때 각 구현이 할 일 — 열린 소스에 리스너를 붙이거나, 워커에 알리거나.
+     * 연결 전 구독도 여기로 오므로, 아직 붙일 곳이 없으면 조용히 넘어가야 합니다.
+     */
+  }]);
+}();
+
+exports.BaseSseClient = BaseSseClient;
+//# sourceMappingURL=BaseSseClient.cjs.js.map

package/dist/src/core/BaseSseClient.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSseClient.cjs.js","sources":["../../../src/core/BaseSseClient.ts"],"sourcesContent":["import type { Emitter } from './emitter';\nimport { createEmitter } from './emitter';\nimport { isUndeliverableEvent } from './eventNames';\nimport type {\n  PayloadOf,\n  SseClientLike,\n  SseEventHandler,\n  SseEventMap,\n  SseEventName,\n  SseLogger,\n  SseStatus,\n  Unsubscribe,\n} from './types';\n\n/**\n * @description 두 구현이 공유하는 구독 표면 — 구독 장부(emitter)를 소유하고 on·onStatus를 확정합니다.\n * 연결을 어떻게 다루는지는 모릅니다: 구현마다 다른 것만 추상 멤버로 남깁니다.\n * 같아야 할 것을 한 벌로 두기 위한 클래스입니다 — 두 구현이 각자 배선하다 갈린 이력이 있습니다.\n */\nexport abstract class BaseSseClient<\n  M extends object = SseEventMap,\n> implements SseClientLike<M> {\n  declare readonly __eventMap?: M;\n\n  protected readonly emitter: Emitter;\n\n  constructor(protected readonly logger?: SseLogger) {\n    this.emitter = createEmitter(logger);\n  }\n\n  on<K extends SseEventName<M>>(\n    type: K,\n    handler: SseEventHandler<PayloadOf<M, K>>\n  ): Unsubscribe {\n    if (isUndeliverableEvent(type)) {\n      this.logger?.warn(\n        `sse: '${type}'는 SDK가 소비하는 예약 이벤트라 구독이 배달되지 않습니다`\n      );\n    }\n    this.registerSubscription(type);\n    return this.emitter.on(type, handler as SseEventHandler<unknown>);\n  }\n\n  onStatus(listener: (status: SseStatus) => void): Unsubscribe {\n    return this.emitter.onStatus(listener);\n  }\n\n  /**\n   * @description 탭이 돌아올 때 connect()를 다시 부릅니다 — 전원이 얼어붙어 접힌 연결(휴면)은\n   * 깨어난 탭의 이 호출만이 다시 세울 수 있습니다. 연결이 살아 있으면 아무 일도 없습니다.\n   * bfcache 복귀는 visibilitychange가 아니라 pageshow로만 알 수 있어 둘 다 봅니다.\n   * SSR에는 붙일 곳이 없어 아무 일도 하지 않습니다.\n   *\n   * @returns 리스너를 떼는 함수 — 클라이언트를 버릴 때 함께 부르세요\n   */\n  attachAutoResume(): Unsubscribe {\n    if (typeof document === 'undefined' || typeof window === 'undefined') {\n      return () => {};\n    }\n\n    // 되살릴 대상은 idle입니다 — 전원 침묵으로 접힌 휴면이 이 상태입니다(workerConnection.close).\n    // closed(소비처 disconnect·서버 goaway close)는 끊은 의도를 되살리지 않고,\n    // fatal의 회복 계약은 disconnect 후 connect라 자동 재개가 대신할 수 없습니다\n    const notifyAlive = (): void => {\n      if (this.status === 'closed' || this.status === 'fatal') {\n        return;\n      }\n      this.connect();\n    };\n\n    const onVisible = (): void => {\n      if (document.visibilityState === 'visible') {\n        notifyAlive();\n      }\n    };\n\n    // persisted = bfcache 복귀, 직결 경로용 — Chrome은 SharedWorker 페이지를 bfcache에 넣지 않고,\n    // 넣는 브라우저라면 포트가 이미 죽어 이 connect가 닿지 않습니다(알려진 한계)\n    const onPageShow = (event: PageTransitionEvent): void => {\n      if (event.persisted) {\n        notifyAlive();\n      }\n    };\n\n    document.addEventListener('visibilitychange', onVisible);\n    window.addEventListener('pageshow', onPageShow);\n\n    return () => {\n      document.removeEventListener('visibilitychange', onVisible);\n      window.removeEventListener('pageshow', onPageShow);\n    };\n  }\n\n  /**\n   * @description 구독이 등록될 때 각 구현이 할 일 — 열린 소스에 리스너를 붙이거나, 워커에 알리거나.\n   * 연결 전 구독도 여기로 오므로, 아직 붙일 곳이 없으면 조용히 넘어가야 합니다.\n   */\n  protected abstract registerSubscription(type: string): void;\n\n  abstract get status(): SseStatus;\n  abstract connect(): void;\n  abstract disconnect(): void;\n}\n"],"names":["BaseSseClient","logger","_classCallCheck","_defineProperty","emitter","createEmitter","_createClass","key","value","on","type","handler","isUndeliverableEvent","_this$logger","warn","concat","registerSubscription","onStatus","listener","attachAutoResume","_this","document","window","notifyAlive","status","connect","onVisible","visibilityState","onPageShow","event","persisted","addEventListener","removeEventListener"],"mappings":";;;;;;;;;;;;;;AAcA;AACA;AACA;AACA;AACA;AACA,IAAsBA,aAAa,gBAAA,YAAA;EAOjC,SAAAA,aAAAA,CAA+BC,MAAkB,EAAE;AAAAC,IAAAA,gCAAA,OAAAF,aAAA,CAAA;IAAAG,gCAAA,CAAA,IAAA,EAAA,SAAA,EAAA,MAAA,CAAA;IAAA,IAAA,CAApBF,MAAkB,GAAlBA,MAAkB;AAC/C,IAAA,IAAI,CAACG,OAAO,GAAGC,qBAAa,CAACJ,MAAM,CAAC;AACtC;EAAC,OAAAK,6BAAA,CAAAN,aAAA,EAAA,CAAA;IAAAO,GAAA,EAAA,IAAA;AAAAC,IAAAA,KAAA,EAED,SAAAC,EAAAA,CACEC,IAAO,EACPC,OAAyC,EAC5B;AACb,MAAA,IAAIC,+BAAoB,CAACF,IAAI,CAAC,EAAE;AAAA,QAAA,IAAAG,YAAA;AAC9B,QAAA,CAAAA,YAAA,GAAA,IAAI,CAACZ,MAAM,cAAAY,YAAA,KAAA,MAAA,IAAXA,YAAA,CAAaC,IAAI,CAAA,QAAA,CAAAC,MAAA,CACNL,IAAI,0JACf,CAAC;AACH;AACA,MAAA,IAAI,CAACM,oBAAoB,CAACN,IAAI,CAAC;MAC/B,OAAO,IAAI,CAACN,OAAO,CAACK,EAAE,CAACC,IAAI,EAAEC,OAAmC,CAAC;AACnE;AAAC,GAAA,EAAA;IAAAJ,GAAA,EAAA,UAAA;AAAAC,IAAAA,KAAA,EAED,SAAAS,QAAAA,CAASC,QAAqC,EAAe;AAC3D,MAAA,OAAO,IAAI,CAACd,OAAO,CAACa,QAAQ,CAACC,QAAQ,CAAC;AACxC;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AAPE,GAAA,EAAA;IAAAX,GAAA,EAAA,kBAAA;IAAAC,KAAA,EAQA,SAAAW,gBAAAA,GAAgC;AAAA,MAAA,IAAAC,KAAA,GAAA,IAAA;MAC9B,IAAI,OAAOC,QAAQ,KAAK,WAAW,IAAI,OAAOC,MAAM,KAAK,WAAW,EAAE;QACpE,OAAO,YAAM,EAAE;AACjB;;AAEA;AACA;AACA;AACA,MAAA,IAAMC,WAAW,GAAG,SAAdA,WAAWA,GAAe;QAC9B,IAAIH,KAAI,CAACI,MAAM,KAAK,QAAQ,IAAIJ,KAAI,CAACI,MAAM,KAAK,OAAO,EAAE;AACvD,UAAA;AACF;QACAJ,KAAI,CAACK,OAAO,EAAE;OACf;AAED,MAAA,IAAMC,SAAS,GAAG,SAAZA,SAASA,GAAe;AAC5B,QAAA,IAAIL,QAAQ,CAACM,eAAe,KAAK,SAAS,EAAE;AAC1CJ,UAAAA,WAAW,EAAE;AACf;OACD;;AAED;AACA;AACA,MAAA,IAAMK,UAAU,GAAG,SAAbA,UAAUA,CAAIC,KAA0B,EAAW;QACvD,IAAIA,KAAK,CAACC,SAAS,EAAE;AACnBP,UAAAA,WAAW,EAAE;AACf;OACD;AAEDF,MAAAA,QAAQ,CAACU,gBAAgB,CAAC,kBAAkB,EAAEL,SAAS,CAAC;AACxDJ,MAAAA,MAAM,CAACS,gBAAgB,CAAC,UAAU,EAAEH,UAAU,CAAC;AAE/C,MAAA,OAAO,YAAM;AACXP,QAAAA,QAAQ,CAACW,mBAAmB,CAAC,kBAAkB,EAAEN,SAAS,CAAC;AAC3DJ,QAAAA,MAAM,CAACU,mBAAmB,CAAC,UAAU,EAAEJ,UAAU,CAAC;OACnD;AACH;;AAEA;AACF;AACA;AACA;AAHE,GAAA,CAAA,CAAA;AAAA,CAAA;;;;"}

package/dist/src/core/BaseSseClient.d.ts

@@ -0,0 +1,33 @@
+import type { Emitter } from './emitter';
+import type { PayloadOf, SseClientLike, SseEventHandler, SseEventMap, SseEventName, SseLogger, SseStatus, Unsubscribe } from './types';
+/**
+ * @description 두 구현이 공유하는 구독 표면 — 구독 장부(emitter)를 소유하고 on·onStatus를 확정합니다.
+ * 연결을 어떻게 다루는지는 모릅니다: 구현마다 다른 것만 추상 멤버로 남깁니다.
+ * 같아야 할 것을 한 벌로 두기 위한 클래스입니다 — 두 구현이 각자 배선하다 갈린 이력이 있습니다.
+ */
+export declare abstract class BaseSseClient<M extends object = SseEventMap> implements SseClientLike<M> {
+    protected readonly logger?: SseLogger | undefined;
+    readonly __eventMap?: M;
+    protected readonly emitter: Emitter;
+    constructor(logger?: SseLogger | undefined);
+    on<K extends SseEventName<M>>(type: K, handler: SseEventHandler<PayloadOf<M, K>>): Unsubscribe;
+    onStatus(listener: (status: SseStatus) => void): Unsubscribe;
+    /**
+     * @description 탭이 돌아올 때 connect()를 다시 부릅니다 — 전원이 얼어붙어 접힌 연결(휴면)은
+     * 깨어난 탭의 이 호출만이 다시 세울 수 있습니다. 연결이 살아 있으면 아무 일도 없습니다.
+     * bfcache 복귀는 visibilitychange가 아니라 pageshow로만 알 수 있어 둘 다 봅니다.
+     * SSR에는 붙일 곳이 없어 아무 일도 하지 않습니다.
+     *
+     * @returns 리스너를 떼는 함수 — 클라이언트를 버릴 때 함께 부르세요
+     */
+    attachAutoResume(): Unsubscribe;
+    /**
+     * @description 구독이 등록될 때 각 구현이 할 일 — 열린 소스에 리스너를 붙이거나, 워커에 알리거나.
+     * 연결 전 구독도 여기로 오므로, 아직 붙일 곳이 없으면 조용히 넘어가야 합니다.
+     */
+    protected abstract registerSubscription(type: string): void;
+    abstract get status(): SseStatus;
+    abstract connect(): void;
+    abstract disconnect(): void;
+}
+//# sourceMappingURL=BaseSseClient.d.ts.map

package/dist/src/core/BaseSseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSseClient.d.ts","sourceRoot":"","sources":["../../../src/core/BaseSseClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,8BAAsB,aAAa,CACjC,CAAC,SAAS,MAAM,GAAG,WAAW,CAC9B,YAAW,aAAa,CAAC,CAAC,CAAC;IAKf,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJtC,SAAiB,UAAU,CAAC,EAAE,CAAC,CAAC;IAEhC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEL,MAAM,CAAC,uBAAW;IAIjD,EAAE,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAC1B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACxC,WAAW;IAUd,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,WAAW;IAI5D;;;;;;;OAOG;IACH,gBAAgB,IAAI,WAAW;IAsC/B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE3D,QAAQ,KAAK,MAAM,IAAI,SAAS,CAAC;IACjC,QAAQ,CAAC,OAAO,IAAI,IAAI;IACxB,QAAQ,CAAC,UAAU,IAAI,IAAI;CAC5B"}

package/dist/src/core/BaseSseClient.esm.js

@@ -0,0 +1,89 @@
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import { createEmitter } from './emitter.esm.js';
+import { isUndeliverableEvent } from './eventNames.esm.js';
+
+/**
+ * @description 두 구현이 공유하는 구독 표면 — 구독 장부(emitter)를 소유하고 on·onStatus를 확정합니다.
+ * 연결을 어떻게 다루는지는 모릅니다: 구현마다 다른 것만 추상 멤버로 남깁니다.
+ * 같아야 할 것을 한 벌로 두기 위한 클래스입니다 — 두 구현이 각자 배선하다 갈린 이력이 있습니다.
+ */
+var BaseSseClient = /*#__PURE__*/function () {
+  function BaseSseClient(logger) {
+    _classCallCheck(this, BaseSseClient);
+    _defineProperty(this, "emitter", void 0);
+    this.logger = logger;
+    this.emitter = createEmitter(logger);
+  }
+  return _createClass(BaseSseClient, [{
+    key: "on",
+    value: function on(type, handler) {
+      if (isUndeliverableEvent(type)) {
+        var _this$logger;
+        (_this$logger = this.logger) === null || _this$logger === void 0 || _this$logger.warn("sse: '".concat(type, "'\uB294 SDK\uAC00 \uC18C\uBE44\uD558\uB294 \uC608\uC57D \uC774\uBCA4\uD2B8\uB77C \uAD6C\uB3C5\uC774 \uBC30\uB2EC\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4"));
+      }
+      this.registerSubscription(type);
+      return this.emitter.on(type, handler);
+    }
+  }, {
+    key: "onStatus",
+    value: function onStatus(listener) {
+      return this.emitter.onStatus(listener);
+    }
+
+    /**
+     * @description 탭이 돌아올 때 connect()를 다시 부릅니다 — 전원이 얼어붙어 접힌 연결(휴면)은
+     * 깨어난 탭의 이 호출만이 다시 세울 수 있습니다. 연결이 살아 있으면 아무 일도 없습니다.
+     * bfcache 복귀는 visibilitychange가 아니라 pageshow로만 알 수 있어 둘 다 봅니다.
+     * SSR에는 붙일 곳이 없어 아무 일도 하지 않습니다.
+     *
+     * @returns 리스너를 떼는 함수 — 클라이언트를 버릴 때 함께 부르세요
+     */
+  }, {
+    key: "attachAutoResume",
+    value: function attachAutoResume() {
+      var _this = this;
+      if (typeof document === 'undefined' || typeof window === 'undefined') {
+        return function () {};
+      }
+
+      // 되살릴 대상은 idle입니다 — 전원 침묵으로 접힌 휴면이 이 상태입니다(workerConnection.close).
+      // closed(소비처 disconnect·서버 goaway close)는 끊은 의도를 되살리지 않고,
+      // fatal의 회복 계약은 disconnect 후 connect라 자동 재개가 대신할 수 없습니다
+      var notifyAlive = function notifyAlive() {
+        if (_this.status === 'closed' || _this.status === 'fatal') {
+          return;
+        }
+        _this.connect();
+      };
+      var onVisible = function onVisible() {
+        if (document.visibilityState === 'visible') {
+          notifyAlive();
+        }
+      };
+
+      // persisted = bfcache 복귀, 직결 경로용 — Chrome은 SharedWorker 페이지를 bfcache에 넣지 않고,
+      // 넣는 브라우저라면 포트가 이미 죽어 이 connect가 닿지 않습니다(알려진 한계)
+      var onPageShow = function onPageShow(event) {
+        if (event.persisted) {
+          notifyAlive();
+        }
+      };
+      document.addEventListener('visibilitychange', onVisible);
+      window.addEventListener('pageshow', onPageShow);
+      return function () {
+        document.removeEventListener('visibilitychange', onVisible);
+        window.removeEventListener('pageshow', onPageShow);
+      };
+    }
+
+    /**
+     * @description 구독이 등록될 때 각 구현이 할 일 — 열린 소스에 리스너를 붙이거나, 워커에 알리거나.
+     * 연결 전 구독도 여기로 오므로, 아직 붙일 곳이 없으면 조용히 넘어가야 합니다.
+     */
+  }]);
+}();
+
+export { BaseSseClient };
+//# sourceMappingURL=BaseSseClient.esm.js.map

package/dist/src/core/BaseSseClient.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSseClient.esm.js","sources":["../../../src/core/BaseSseClient.ts"],"sourcesContent":["import type { Emitter } from './emitter';\nimport { createEmitter } from './emitter';\nimport { isUndeliverableEvent } from './eventNames';\nimport type {\n  PayloadOf,\n  SseClientLike,\n  SseEventHandler,\n  SseEventMap,\n  SseEventName,\n  SseLogger,\n  SseStatus,\n  Unsubscribe,\n} from './types';\n\n/**\n * @description 두 구현이 공유하는 구독 표면 — 구독 장부(emitter)를 소유하고 on·onStatus를 확정합니다.\n * 연결을 어떻게 다루는지는 모릅니다: 구현마다 다른 것만 추상 멤버로 남깁니다.\n * 같아야 할 것을 한 벌로 두기 위한 클래스입니다 — 두 구현이 각자 배선하다 갈린 이력이 있습니다.\n */\nexport abstract class BaseSseClient<\n  M extends object = SseEventMap,\n> implements SseClientLike<M> {\n  declare readonly __eventMap?: M;\n\n  protected readonly emitter: Emitter;\n\n  constructor(protected readonly logger?: SseLogger) {\n    this.emitter = createEmitter(logger);\n  }\n\n  on<K extends SseEventName<M>>(\n    type: K,\n    handler: SseEventHandler<PayloadOf<M, K>>\n  ): Unsubscribe {\n    if (isUndeliverableEvent(type)) {\n      this.logger?.warn(\n        `sse: '${type}'는 SDK가 소비하는 예약 이벤트라 구독이 배달되지 않습니다`\n      );\n    }\n    this.registerSubscription(type);\n    return this.emitter.on(type, handler as SseEventHandler<unknown>);\n  }\n\n  onStatus(listener: (status: SseStatus) => void): Unsubscribe {\n    return this.emitter.onStatus(listener);\n  }\n\n  /**\n   * @description 탭이 돌아올 때 connect()를 다시 부릅니다 — 전원이 얼어붙어 접힌 연결(휴면)은\n   * 깨어난 탭의 이 호출만이 다시 세울 수 있습니다. 연결이 살아 있으면 아무 일도 없습니다.\n   * bfcache 복귀는 visibilitychange가 아니라 pageshow로만 알 수 있어 둘 다 봅니다.\n   * SSR에는 붙일 곳이 없어 아무 일도 하지 않습니다.\n   *\n   * @returns 리스너를 떼는 함수 — 클라이언트를 버릴 때 함께 부르세요\n   */\n  attachAutoResume(): Unsubscribe {\n    if (typeof document === 'undefined' || typeof window === 'undefined') {\n      return () => {};\n    }\n\n    // 되살릴 대상은 idle입니다 — 전원 침묵으로 접힌 휴면이 이 상태입니다(workerConnection.close).\n    // closed(소비처 disconnect·서버 goaway close)는 끊은 의도를 되살리지 않고,\n    // fatal의 회복 계약은 disconnect 후 connect라 자동 재개가 대신할 수 없습니다\n    const notifyAlive = (): void => {\n      if (this.status === 'closed' || this.status === 'fatal') {\n        return;\n      }\n      this.connect();\n    };\n\n    const onVisible = (): void => {\n      if (document.visibilityState === 'visible') {\n        notifyAlive();\n      }\n    };\n\n    // persisted = bfcache 복귀, 직결 경로용 — Chrome은 SharedWorker 페이지를 bfcache에 넣지 않고,\n    // 넣는 브라우저라면 포트가 이미 죽어 이 connect가 닿지 않습니다(알려진 한계)\n    const onPageShow = (event: PageTransitionEvent): void => {\n      if (event.persisted) {\n        notifyAlive();\n      }\n    };\n\n    document.addEventListener('visibilitychange', onVisible);\n    window.addEventListener('pageshow', onPageShow);\n\n    return () => {\n      document.removeEventListener('visibilitychange', onVisible);\n      window.removeEventListener('pageshow', onPageShow);\n    };\n  }\n\n  /**\n   * @description 구독이 등록될 때 각 구현이 할 일 — 열린 소스에 리스너를 붙이거나, 워커에 알리거나.\n   * 연결 전 구독도 여기로 오므로, 아직 붙일 곳이 없으면 조용히 넘어가야 합니다.\n   */\n  protected abstract registerSubscription(type: string): void;\n\n  abstract get status(): SseStatus;\n  abstract connect(): void;\n  abstract disconnect(): void;\n}\n"],"names":["BaseSseClient","logger","_classCallCheck","_defineProperty","emitter","createEmitter","_createClass","key","value","on","type","handler","isUndeliverableEvent","_this$logger","warn","concat","registerSubscription","onStatus","listener","attachAutoResume","_this","document","window","notifyAlive","status","connect","onVisible","visibilityState","onPageShow","event","persisted","addEventListener","removeEventListener"],"mappings":";;;;;;AAcA;AACA;AACA;AACA;AACA;AACA,IAAsBA,aAAa,gBAAA,YAAA;EAOjC,SAAAA,aAAAA,CAA+BC,MAAkB,EAAE;AAAAC,IAAAA,eAAA,OAAAF,aAAA,CAAA;IAAAG,eAAA,CAAA,IAAA,EAAA,SAAA,EAAA,MAAA,CAAA;IAAA,IAAA,CAApBF,MAAkB,GAAlBA,MAAkB;AAC/C,IAAA,IAAI,CAACG,OAAO,GAAGC,aAAa,CAACJ,MAAM,CAAC;AACtC;EAAC,OAAAK,YAAA,CAAAN,aAAA,EAAA,CAAA;IAAAO,GAAA,EAAA,IAAA;AAAAC,IAAAA,KAAA,EAED,SAAAC,EAAAA,CACEC,IAAO,EACPC,OAAyC,EAC5B;AACb,MAAA,IAAIC,oBAAoB,CAACF,IAAI,CAAC,EAAE;AAAA,QAAA,IAAAG,YAAA;AAC9B,QAAA,CAAAA,YAAA,GAAA,IAAI,CAACZ,MAAM,cAAAY,YAAA,KAAA,MAAA,IAAXA,YAAA,CAAaC,IAAI,CAAA,QAAA,CAAAC,MAAA,CACNL,IAAI,0JACf,CAAC;AACH;AACA,MAAA,IAAI,CAACM,oBAAoB,CAACN,IAAI,CAAC;MAC/B,OAAO,IAAI,CAACN,OAAO,CAACK,EAAE,CAACC,IAAI,EAAEC,OAAmC,CAAC;AACnE;AAAC,GAAA,EAAA;IAAAJ,GAAA,EAAA,UAAA;AAAAC,IAAAA,KAAA,EAED,SAAAS,QAAAA,CAASC,QAAqC,EAAe;AAC3D,MAAA,OAAO,IAAI,CAACd,OAAO,CAACa,QAAQ,CAACC,QAAQ,CAAC;AACxC;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AAPE,GAAA,EAAA;IAAAX,GAAA,EAAA,kBAAA;IAAAC,KAAA,EAQA,SAAAW,gBAAAA,GAAgC;AAAA,MAAA,IAAAC,KAAA,GAAA,IAAA;MAC9B,IAAI,OAAOC,QAAQ,KAAK,WAAW,IAAI,OAAOC,MAAM,KAAK,WAAW,EAAE;QACpE,OAAO,YAAM,EAAE;AACjB;;AAEA;AACA;AACA;AACA,MAAA,IAAMC,WAAW,GAAG,SAAdA,WAAWA,GAAe;QAC9B,IAAIH,KAAI,CAACI,MAAM,KAAK,QAAQ,IAAIJ,KAAI,CAACI,MAAM,KAAK,OAAO,EAAE;AACvD,UAAA;AACF;QACAJ,KAAI,CAACK,OAAO,EAAE;OACf;AAED,MAAA,IAAMC,SAAS,GAAG,SAAZA,SAASA,GAAe;AAC5B,QAAA,IAAIL,QAAQ,CAACM,eAAe,KAAK,SAAS,EAAE;AAC1CJ,UAAAA,WAAW,EAAE;AACf;OACD;;AAED;AACA;AACA,MAAA,IAAMK,UAAU,GAAG,SAAbA,UAAUA,CAAIC,KAA0B,EAAW;QACvD,IAAIA,KAAK,CAACC,SAAS,EAAE;AACnBP,UAAAA,WAAW,EAAE;AACf;OACD;AAEDF,MAAAA,QAAQ,CAACU,gBAAgB,CAAC,kBAAkB,EAAEL,SAAS,CAAC;AACxDJ,MAAAA,MAAM,CAACS,gBAAgB,CAAC,UAAU,EAAEH,UAAU,CAAC;AAE/C,MAAA,OAAO,YAAM;AACXP,QAAAA,QAAQ,CAACW,mBAAmB,CAAC,kBAAkB,EAAEN,SAAS,CAAC;AAC3DJ,QAAAA,MAAM,CAACU,mBAAmB,CAAC,UAAU,EAAEJ,UAAU,CAAC;OACnD;AACH;;AAEA;AACF;AACA;AACA;AAHE,GAAA,CAAA,CAAA;AAAA,CAAA;;;;"}