@remember-web/sse 0.1.0-alpha.1

package/dist/src/worker/protocol.d.ts

@@ -0,0 +1,63 @@
+import type { TicketError } from '../core/ticket';
+import type { SseStatus } from '../core/types';
+/**
+ * @description 탭 프록시(WorkerSseClient) ↔ 워커 허브(hub)가 포트로 주고받는 메시지 어휘와 배선 지도.
+ * 수신 처리가 아직 없는 kind는 미지 kind와 같은 규칙으로 무시됩니다 —
+ * 배포 skew로 신·구 코드가 섞여도 안전하게 (코어의 "미지 이벤트는 무시"와 대칭).
+ *
+ *   subscribe·close            : WorkerSseClient → hub. 배선 완료
+ *   status·event               : hub → WorkerSseClient. 배선 완료 — frozen 탭에게도 계속 보냅니다
+ *                                (밀린 몫은 브라우저가 큐잉했다 배달 — 근거는 portRegistry)
+ *   ping / pong                : hub → 탭 / 탭 → hub. 배선 완료 — 무응답이어도 장부에서 빼지 않고
+ *                                티켓 대상에서만 제외합니다. 전원이 침묵하면 연결을 접습니다(휴면)
+ *   init                       : 탭 → hub. 배선 완료 — 첫 탭의 baseUrl로 연결을 세우고,
+ *                                휴면으로 접힌 연결을 깨어난 탭이 이 신호로 다시 엽니다
+ *   ticket-request / response  : hub → 탭 / 탭 → hub. 배선 완료 — 토큰은 탭에 남고 발급 결과만 오갑니다
+ *
+ * 로그아웃은 서버가 goaway(reason: user_logout)로 알려 모든 탭에 함께 닿습니다 — 탭이 워커에 알리는 kind는 두지 않습니다.
+ */
+/** @description 티켓 위임의 응답 — 토큰이 아니라 발급 결과(티켓 문자열)만 워커로 넘어갑니다 */
+export type TicketResponseMessage = {
+    kind: 'ticket-response';
+    ok: true;
+    ticket: string;
+} | {
+    kind: 'ticket-response';
+    ok: false;
+    error: TicketError;
+};
+export type TabToWorkerMessage = {
+    kind: 'init';
+    baseUrl: string;
+} | {
+    kind: 'subscribe';
+    event: string;
+} | {
+    kind: 'pong';
+} | {
+    kind: 'close';
+} | TicketResponseMessage;
+export type WorkerToTabMessage = {
+    kind: 'event';
+    event: string;
+    payload: unknown;
+} | {
+    kind: 'status';
+    status: SseStatus;
+} | {
+    kind: 'ping';
+} | {
+    kind: 'ticket-request';
+};
+/**
+ * @description 포트로 갓 도착한 메시지 — kind만 믿고 나머지 필드는 검사 전까지 unknown입니다.
+ * 보낸 쪽이 구버전·타 구현일 수 있어, 검사를 빠뜨리면 컴파일이 막히도록 여기서 좁혀둡니다.
+ */
+export type Incoming<M extends {
+    kind: string;
+}> = {
+    [K in keyof M]: K extends 'kind' ? M[K] : unknown;
+};
+/** @description 판정을 메시지 정의 옆에 둡니다 — 필드가 바뀌면 여기도 같이 눈에 띄도록 */
+export declare const isTicketResponse: (message: Incoming<TabToWorkerMessage>) => message is TicketResponseMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/src/worker/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/worker/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAEjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;CAClD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,YAClB,SAAS,kBAAkB,CAAC,qCA+BtC,CAAC"}

package/dist/src/worker/sse.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sse.worker.d.ts.map

package/dist/src/worker/sse.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.worker.d.ts","sourceRoot":"","sources":["../../../src/worker/sse.worker.ts"],"names":[],"mappings":""}

package/dist/src/worker/ticketDelegate.d.ts

@@ -0,0 +1,16 @@
+import type { TicketResponseMessage } from './protocol';
+import type { TicketResult } from '../core/ticket';
+export declare const TICKET_RESPONSE_TIMEOUT_MS: number;
+/**
+ * @description 티켓 발급을 탭에 위임합니다 — 토큰은 탭에 남고 워커는 발급 결과만 받습니다.
+ * 워커가 코어 연결 루프를 그대로 쓸 수 있도록, 요청·응답 왕복을 Promise 하나로 바꿉니다.
+ */
+export declare const createTicketDelegate: (requestFromTab: () => void) => {
+    request: () => Promise<TicketResult>;
+    /** @description 다음 연결이 이 왕복에 합류해 응답 없이 기다리지 않게 끊습니다 */
+    cancel: () => void;
+    /** @description 시간 제한 뒤 도착한 응답은 pending이 비어 있어 무시됩니다 */
+    settle: (message: TicketResponseMessage) => void;
+};
+export type TicketDelegate = ReturnType<typeof createTicketDelegate>;
+//# sourceMappingURL=ticketDelegate.d.ts.map

package/dist/src/worker/ticketDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketDelegate.d.ts","sourceRoot":"","sources":["../../../src/worker/ticketDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOnD,eAAO,MAAM,0BAA0B,QACM,CAAC;AAI9C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mBAAoB,MAAM,IAAI;mBAsC9C,QAAQ,YAAY,CAAC;IASlC,uDAAuD;kBAC3C,IAAI;IAEhB,wDAAwD;sBACtC,qBAAqB,KAAG,IAAI;CAQjD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/src/worker/workerConnection.d.ts

@@ -0,0 +1,28 @@
+import type { TicketDelegate } from './ticketDelegate';
+import type { SseClientOptions, SseStatus } from '../core/types';
+/**
+ * @description 워커 스코프에는 토큰이 없어 getAuthToken을 받지 않습니다 — 티켓은 탭이 발급해 넘겨줍니다
+ */
+export type WorkerConnectionOptions = Pick<SseClientOptions, 'fetch' | 'eventSource' | 'backoff' | 'logger'>;
+interface WorkerConnectionDeps {
+    options: WorkerConnectionOptions;
+    ticketDelegate: TicketDelegate;
+    onStatus: (status: SseStatus) => void;
+    onEvent: (event: string, payload: unknown) => void;
+}
+/**
+ * @description 모든 탭이 함께 쓰는 워커의 연결 하나 — 수립·정리와 구독 부착을 맡습니다.
+ * 탭 장부(hub)는 "탭이 남았는가"만 판단하고, 그 판단을 연결에 적용하는 방법은 여기서만 압니다.
+ */
+export declare const createWorkerConnection: ({ options, ticketDelegate, onStatus, onEvent, }: WorkerConnectionDeps) => {
+    ensureOpen: (baseUrl: string) => void;
+    close: ({ endSession }?: {
+        endSession?: boolean | undefined;
+    }) => void;
+    /** @description 선 연결에는 즉시, 이후 연결에는 수립 시점에 붙습니다 */
+    subscribe: (event: string) => void;
+    subscribedEvents: () => string[];
+};
+export type WorkerConnection = ReturnType<typeof createWorkerConnection>;
+export {};
+//# sourceMappingURL=workerConnection.d.ts.map

package/dist/src/worker/workerConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerConnection.d.ts","sourceRoot":"","sources":["../../../src/worker/workerConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAe,MAAM,eAAe,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,gBAAgB,EAChB,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAC/C,CAAC;AAEF,UAAU,oBAAoB;IAC5B,OAAO,EAAE,uBAAuB,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAKD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oDAKhC,oBAAoB;0BAgEG,MAAM,KAAG,IAAI;;;UAnBQ,IAAI;IAuC/C,kDAAkD;uBAC/B,MAAM,KAAG,IAAI;4BAWV,MAAM,EAAE;CAEjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}