@remember-web/sse 0.1.0-alpha.1

package/src/worker/ticketDelegate.ts

@@ -0,0 +1,80 @@
+import type { TicketResponseMessage } from './protocol';
+
+import type { TicketResult } from '../core/ticket';
+import { TICKET_NETWORK_FAILURE, TICKET_TIMEOUT_MS } from '../core/ticket';
+
+// 탭↔워커 postMessage 왕복 여유분 — 실측 아닌 임의값입니다
+const PORT_ROUNDTRIP_SLACK_MS = 2000;
+
+// 탭의 발급 제한보다 늦게 끝나야 합니다 — 탭이 스스로 실패를 알려줄 기회를 먼저 줍니다
+export const TICKET_RESPONSE_TIMEOUT_MS =
+  TICKET_TIMEOUT_MS + PORT_ROUNDTRIP_SLACK_MS;
+
+type Resolve = (result: TicketResult) => void;
+
+/**
+ * @description 티켓 발급을 탭에 위임합니다 — 토큰은 탭에 남고 워커는 발급 결과만 받습니다.
+ * 워커가 코어 연결 루프를 그대로 쓸 수 있도록, 요청·응답 왕복을 Promise 하나로 바꿉니다.
+ */
+export const createTicketDelegate = (requestFromTab: () => void) => {
+  // 왕복은 한 번에 하나 — 겹친 요청은 탭에 다시 묻지 않고 이 결과를 함께 받습니다
+  let pending: {
+    resolvers: Resolve[];
+    timer: ReturnType<typeof setTimeout>;
+  } | null = null;
+
+  const finish = (result: TicketResult): void => {
+    if (pending === null) {
+      return;
+    }
+    const { resolvers, timer } = pending;
+    pending = null;
+    clearTimeout(timer);
+    resolvers.forEach((resolve) => resolve(result));
+  };
+
+  const startNewRequest = (resolve: Resolve): void => {
+    pending = {
+      resolvers: [resolve],
+      timer: setTimeout(
+        () => finish(TICKET_NETWORK_FAILURE),
+        TICKET_RESPONSE_TIMEOUT_MS
+      ),
+    };
+
+    try {
+      requestFromTab();
+    } catch {
+      finish(TICKET_NETWORK_FAILURE);
+    }
+  };
+
+  const joinInFlight = (resolve: Resolve): void => {
+    pending?.resolvers.push(resolve);
+  };
+
+  return {
+    request: (): Promise<TicketResult> =>
+      new Promise<TicketResult>((resolve) => {
+        if (pending === null) {
+          startNewRequest(resolve);
+          return;
+        }
+        joinInFlight(resolve);
+      }),
+
+    /** @description 다음 연결이 이 왕복에 합류해 응답 없이 기다리지 않게 끊습니다 */
+    cancel: (): void => finish(TICKET_NETWORK_FAILURE),
+
+    /** @description 시간 제한 뒤 도착한 응답은 pending이 비어 있어 무시됩니다 */
+    settle: (message: TicketResponseMessage): void => {
+      const result: TicketResult = message.ok
+        ? { ok: true, ticket: message.ticket }
+        : { ok: false, error: message.error };
+
+      finish(result);
+    },
+  };
+};
+
+export type TicketDelegate = ReturnType<typeof createTicketDelegate>;

package/src/worker/workerConnection.ts

@@ -0,0 +1,134 @@
+import type { TicketDelegate } from './ticketDelegate';
+
+import { FORWARDED_EVENTS } from '../core/eventNames';
+import { SseClient } from '../core/SseClient';
+import type { SseClientOptions, SseStatus, Unsubscribe } 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;
+}
+
+const isDeadStatus = (status: SseStatus): boolean =>
+  status === 'fatal' || status === 'closed';
+
+/**
+ * @description 모든 탭이 함께 쓰는 워커의 연결 하나 — 수립·정리와 구독 부착을 맡습니다.
+ * 탭 장부(hub)는 "탭이 남았는가"만 판단하고, 그 판단을 연결에 적용하는 방법은 여기서만 압니다.
+ */
+export const createWorkerConnection = ({
+  options,
+  ticketDelegate,
+  onStatus,
+  onEvent,
+}: WorkerConnectionDeps) => {
+  const subscriptions = new Set<string>();
+  // 하나로 묶어 셋이 따로 노는 상태를 표현 불가능하게 만듭니다
+  let active: {
+    client: SseClient;
+    detachStatus: Unsubscribe;
+    baseUrl: string;
+  } | null = null;
+  // 인스턴스보다 오래 삽니다 — 재수립 판정이 SseClient 수명에 묶이면 접힌 뒤 복구에서 resync가 사라집니다
+  let hasOpenedBefore = false;
+
+  const attach = (client: SseClient, event: string): void => {
+    client.on(event, (payload) => onEvent(event, payload));
+  };
+
+  const open = (baseUrl: string): void => {
+    // 워커 스코프에는 토큰이 없습니다 — 티켓은 issueTicket으로 탭에 위임하므로 이 값은 쓰이지 않습니다
+    const client = new SseClient(
+      { ...options, baseUrl, getAuthToken: () => null },
+      { issueTicket: ticketDelegate.request, hasOpenedBefore }
+    );
+    const detachStatus = client.onStatus((next) => {
+      // open에 닿았다는 건 hello를 받았다는 뜻입니다 — 인스턴스가 바뀌어도 이 사실은 남아야 합니다
+      if (next === 'open') {
+        hasOpenedBefore = true;
+      }
+      // 이 리스너에 닿는 closed는 goaway(action: close)뿐입니다(자체 close는 먼저 detach) —
+      // 서버가 세션을 끝냈으니 직결 경로(#endSession)와 같은 판정으로 다음 연결은 첫 연결입니다
+      if (next === 'closed') {
+        hasOpenedBefore = false;
+      }
+      onStatus(next);
+    });
+    active = { client, detachStatus, baseUrl };
+
+    FORWARDED_EVENTS.forEach((event) => attach(client, event));
+    subscriptions.forEach((event) => attach(client, event));
+    client.connect();
+  };
+
+  /**
+   * @description 연결을 접습니다. endSession이면 재수립 판정도 함께 되돌립니다.
+   * 탭이 모두 스스로 떠났으면 세션이 끝난 것이고, 다음 탭에게는 첫 연결입니다 —
+   * 이어서 두면 신규 탭이 놓친 구간도 없이 resync를 받습니다.
+   */
+  const close = ({ endSession = false } = {}): void => {
+    if (endSession) {
+      hasOpenedBefore = false;
+    }
+
+    if (active === null) {
+      return;
+    }
+    // 정리 중 나오는 closed는 워커 내부 사정입니다 — 탭에 전하기 전에 통지를 끊습니다
+    active.detachStatus();
+    active.client.disconnect();
+    active = null;
+
+    ticketDelegate.cancel();
+    // 연결이 없어졌다는 사실은 알려야 합니다 — 안 그러면 뒤에 합류한 탭이 낡은 open 스냅샷을 받습니다
+    onStatus('idle');
+  };
+
+  return {
+    ensureOpen: (baseUrl: string): void => {
+      if (active !== null && isDeadStatus(active.client.status)) {
+        close();
+      }
+
+      if (active === null) {
+        open(baseUrl);
+        return;
+      }
+
+      // 선 연결을 그대로 씁니다 — 다른 baseUrl로 붙으려던 탭은 그 사실을 알 길이 없어 알립니다
+      if (baseUrl !== active.baseUrl) {
+        options.logger?.warn(
+          `sse: 이미 ${active.baseUrl}로 연결돼 있어 baseUrl(${baseUrl})을 무시합니다`
+        );
+      }
+    },
+
+    close,
+
+    /** @description 선 연결에는 즉시, 이후 연결에는 수립 시점에 붙습니다 */
+    subscribe: (event: string): void => {
+      if (subscriptions.has(event)) {
+        return;
+      }
+
+      subscriptions.add(event);
+      if (active !== null) {
+        attach(active.client, event);
+      }
+    },
+
+    subscribedEvents: (): string[] => [...subscriptions],
+  };
+};
+
+export type WorkerConnection = ReturnType<typeof createWorkerConnection>;