@remember-web/sse 0.1.0-alpha.1

package/dist/src/createSseClient.cjs.js

@@ -0,0 +1,30 @@
+'use strict';
+
+var SseClient = require('./core/SseClient.cjs.js');
+var WorkerSseClient = require('./worker/WorkerSseClient.cjs.js');
+
+/**
+ * @description 환경에 맞는 SseClientLike 구현을 선택합니다 — sharedWorker 팩토리를 제공하면
+ * 탭 간 연결 공유(WorkerSseClient), 미제공이거나 브라우저가 SharedWorker를 지원하지 않으면
+ * 탭별 직접 연결(SseClient)입니다. 생성 시점에는 능력 검사만 하므로 SSR·워커 스코프에서도 안전합니다.
+ */
+var createSseClient = function createSseClient(options) {
+  if (options.sharedWorker !== undefined) {
+    if (options.eventSource !== undefined) {
+      var _options$logger;
+      (_options$logger = options.logger) === null || _options$logger === void 0 || _options$logger.warn('sse: 워커 경로에서는 eventSource 주입이 적용되지 않습니다 — 스트림은 워커 스코프에서 만들어집니다');
+    }
+    if (typeof SharedWorker !== 'undefined') {
+      return new WorkerSseClient.WorkerSseClient(options);
+    }
+    // document는 브라우저 메인 스레드에만 있습니다 — SSR·워커 스코프의 무의미한 경고를 함께 거릅니다
+    if (typeof document !== 'undefined') {
+      var _options$logger2;
+      (_options$logger2 = options.logger) === null || _options$logger2 === void 0 || _options$logger2.warn('sse: 이 브라우저는 SharedWorker를 지원하지 않습니다 — 탭별 직접 연결로 대체합니다');
+    }
+  }
+  return new SseClient.SseClient(options);
+};
+
+exports.createSseClient = createSseClient;
+//# sourceMappingURL=createSseClient.cjs.js.map

package/dist/src/createSseClient.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseClient.cjs.js","sources":["../../src/createSseClient.ts"],"sourcesContent":["import { SseClient } from './core/SseClient';\nimport type {\n  SseClientLike,\n  SseClientOptions,\n  SseEventMap,\n} from './core/types';\nimport { WorkerSseClient } from './worker/WorkerSseClient';\n\n/**\n * @description 환경에 맞는 SseClientLike 구현을 선택합니다 — sharedWorker 팩토리를 제공하면\n * 탭 간 연결 공유(WorkerSseClient), 미제공이거나 브라우저가 SharedWorker를 지원하지 않으면\n * 탭별 직접 연결(SseClient)입니다. 생성 시점에는 능력 검사만 하므로 SSR·워커 스코프에서도 안전합니다.\n */\nexport const createSseClient = <M extends object = SseEventMap>(\n  options: SseClientOptions\n): SseClientLike<M> => {\n  if (options.sharedWorker !== undefined) {\n    if (options.eventSource !== undefined) {\n      options.logger?.warn(\n        'sse: 워커 경로에서는 eventSource 주입이 적용되지 않습니다 — 스트림은 워커 스코프에서 만들어집니다'\n      );\n    }\n    if (typeof SharedWorker !== 'undefined') {\n      return new WorkerSseClient<M>(options);\n    }\n    // document는 브라우저 메인 스레드에만 있습니다 — SSR·워커 스코프의 무의미한 경고를 함께 거릅니다\n    if (typeof document !== 'undefined') {\n      options.logger?.warn(\n        'sse: 이 브라우저는 SharedWorker를 지원하지 않습니다 — 탭별 직접 연결로 대체합니다'\n      );\n    }\n  }\n  return new SseClient<M>(options);\n};\n"],"names":["createSseClient","options","sharedWorker","undefined","eventSource","_options$logger","logger","warn","SharedWorker","WorkerSseClient","document","_options$logger2","SseClient"],"mappings":";;;;;AAQA;AACA;AACA;AACA;AACA;IACaA,eAAe,GAAG,SAAlBA,eAAeA,CAC1BC,OAAyB,EACJ;AACrB,EAAA,IAAIA,OAAO,CAACC,YAAY,KAAKC,SAAS,EAAE;AACtC,IAAA,IAAIF,OAAO,CAACG,WAAW,KAAKD,SAAS,EAAE;AAAA,MAAA,IAAAE,eAAA;AACrC,MAAA,CAAAA,eAAA,GAAAJ,OAAO,CAACK,MAAM,MAAA,IAAA,IAAAD,eAAA,KAAA,MAAA,IAAdA,eAAA,CAAgBE,IAAI,CAClB,gEACF,CAAC;AACH;AACA,IAAA,IAAI,OAAOC,YAAY,KAAK,WAAW,EAAE;AACvC,MAAA,OAAO,IAAIC,+BAAe,CAAIR,OAAO,CAAC;AACxC;AACA;AACA,IAAA,IAAI,OAAOS,QAAQ,KAAK,WAAW,EAAE;AAAA,MAAA,IAAAC,gBAAA;AACnC,MAAA,CAAAA,gBAAA,GAAAV,OAAO,CAACK,MAAM,MAAA,IAAA,IAAAK,gBAAA,KAAA,MAAA,IAAdA,gBAAA,CAAgBJ,IAAI,CAClB,wDACF,CAAC;AACH;AACF;AACA,EAAA,OAAO,IAAIK,mBAAS,CAAIX,OAAO,CAAC;AAClC;;;;"}

package/dist/src/createSseClient.d.ts

@@ -0,0 +1,8 @@
+import type { SseClientLike, SseClientOptions, SseEventMap } from './core/types';
+/**
+ * @description 환경에 맞는 SseClientLike 구현을 선택합니다 — sharedWorker 팩토리를 제공하면
+ * 탭 간 연결 공유(WorkerSseClient), 미제공이거나 브라우저가 SharedWorker를 지원하지 않으면
+ * 탭별 직접 연결(SseClient)입니다. 생성 시점에는 능력 검사만 하므로 SSR·워커 스코프에서도 안전합니다.
+ */
+export declare const createSseClient: <M extends object = SseEventMap>(options: SseClientOptions) => SseClientLike<M>;
+//# sourceMappingURL=createSseClient.d.ts.map

package/dist/src/createSseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseClient.d.ts","sourceRoot":"","sources":["../../src/createSseClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,cAAc,CAAC;AAGtB;;;;GAIG;AACH,eAAO,MAAM,eAAe,4CACjB,gBAAgB,KACxB,cAAc,CAAC,CAkBjB,CAAC"}

package/dist/src/createSseClient.esm.js

@@ -0,0 +1,28 @@
+import { SseClient } from './core/SseClient.esm.js';
+import { WorkerSseClient } from './worker/WorkerSseClient.esm.js';
+
+/**
+ * @description 환경에 맞는 SseClientLike 구현을 선택합니다 — sharedWorker 팩토리를 제공하면
+ * 탭 간 연결 공유(WorkerSseClient), 미제공이거나 브라우저가 SharedWorker를 지원하지 않으면
+ * 탭별 직접 연결(SseClient)입니다. 생성 시점에는 능력 검사만 하므로 SSR·워커 스코프에서도 안전합니다.
+ */
+var createSseClient = function createSseClient(options) {
+  if (options.sharedWorker !== undefined) {
+    if (options.eventSource !== undefined) {
+      var _options$logger;
+      (_options$logger = options.logger) === null || _options$logger === void 0 || _options$logger.warn('sse: 워커 경로에서는 eventSource 주입이 적용되지 않습니다 — 스트림은 워커 스코프에서 만들어집니다');
+    }
+    if (typeof SharedWorker !== 'undefined') {
+      return new WorkerSseClient(options);
+    }
+    // document는 브라우저 메인 스레드에만 있습니다 — SSR·워커 스코프의 무의미한 경고를 함께 거릅니다
+    if (typeof document !== 'undefined') {
+      var _options$logger2;
+      (_options$logger2 = options.logger) === null || _options$logger2 === void 0 || _options$logger2.warn('sse: 이 브라우저는 SharedWorker를 지원하지 않습니다 — 탭별 직접 연결로 대체합니다');
+    }
+  }
+  return new SseClient(options);
+};
+
+export { createSseClient };
+//# sourceMappingURL=createSseClient.esm.js.map

package/dist/src/createSseClient.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseClient.esm.js","sources":["../../src/createSseClient.ts"],"sourcesContent":["import { SseClient } from './core/SseClient';\nimport type {\n  SseClientLike,\n  SseClientOptions,\n  SseEventMap,\n} from './core/types';\nimport { WorkerSseClient } from './worker/WorkerSseClient';\n\n/**\n * @description 환경에 맞는 SseClientLike 구현을 선택합니다 — sharedWorker 팩토리를 제공하면\n * 탭 간 연결 공유(WorkerSseClient), 미제공이거나 브라우저가 SharedWorker를 지원하지 않으면\n * 탭별 직접 연결(SseClient)입니다. 생성 시점에는 능력 검사만 하므로 SSR·워커 스코프에서도 안전합니다.\n */\nexport const createSseClient = <M extends object = SseEventMap>(\n  options: SseClientOptions\n): SseClientLike<M> => {\n  if (options.sharedWorker !== undefined) {\n    if (options.eventSource !== undefined) {\n      options.logger?.warn(\n        'sse: 워커 경로에서는 eventSource 주입이 적용되지 않습니다 — 스트림은 워커 스코프에서 만들어집니다'\n      );\n    }\n    if (typeof SharedWorker !== 'undefined') {\n      return new WorkerSseClient<M>(options);\n    }\n    // document는 브라우저 메인 스레드에만 있습니다 — SSR·워커 스코프의 무의미한 경고를 함께 거릅니다\n    if (typeof document !== 'undefined') {\n      options.logger?.warn(\n        'sse: 이 브라우저는 SharedWorker를 지원하지 않습니다 — 탭별 직접 연결로 대체합니다'\n      );\n    }\n  }\n  return new SseClient<M>(options);\n};\n"],"names":["createSseClient","options","sharedWorker","undefined","eventSource","_options$logger","logger","warn","SharedWorker","WorkerSseClient","document","_options$logger2","SseClient"],"mappings":";;;AAQA;AACA;AACA;AACA;AACA;IACaA,eAAe,GAAG,SAAlBA,eAAeA,CAC1BC,OAAyB,EACJ;AACrB,EAAA,IAAIA,OAAO,CAACC,YAAY,KAAKC,SAAS,EAAE;AACtC,IAAA,IAAIF,OAAO,CAACG,WAAW,KAAKD,SAAS,EAAE;AAAA,MAAA,IAAAE,eAAA;AACrC,MAAA,CAAAA,eAAA,GAAAJ,OAAO,CAACK,MAAM,MAAA,IAAA,IAAAD,eAAA,KAAA,MAAA,IAAdA,eAAA,CAAgBE,IAAI,CAClB,gEACF,CAAC;AACH;AACA,IAAA,IAAI,OAAOC,YAAY,KAAK,WAAW,EAAE;AACvC,MAAA,OAAO,IAAIC,eAAe,CAAIR,OAAO,CAAC;AACxC;AACA;AACA,IAAA,IAAI,OAAOS,QAAQ,KAAK,WAAW,EAAE;AAAA,MAAA,IAAAC,gBAAA;AACnC,MAAA,CAAAA,gBAAA,GAAAV,OAAO,CAACK,MAAM,MAAA,IAAA,IAAAK,gBAAA,KAAA,MAAA,IAAdA,gBAAA,CAAgBJ,IAAI,CAClB,wDACF,CAAC;AACH;AACF;AACA,EAAA,OAAO,IAAIK,SAAS,CAAIX,OAAO,CAAC;AAClC;;;;"}

package/dist/src/index.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+var createSseClient = require('./createSseClient.cjs.js');
+var wire = require('./core/wire.cjs.js');
+
+
+
+exports.createSseClient = createSseClient.createSseClient;
+exports.wire = wire.wire;
+//# sourceMappingURL=index.cjs.js.map

package/dist/src/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export { createSseClient } from './createSseClient';
+export type { BackoffOptions } from './core/backoff';
+export { wire } from './core/wire';
+export type { WireHandlers } from './core/wire';
+export type { FatalCause, FatalPayload, GoawayAction, GoawayPayload, GoawayReason, PayloadOf, SseClientLike, SseClientOptions, SseEventHandler, SseEventMap, SseEventName, SseLogger, SseStatus, Unsubscribe, } from './core/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/src/index.esm.js

@@ -0,0 +1,3 @@
+export { createSseClient } from './createSseClient.esm.js';
+export { wire } from './core/wire.esm.js';
+//# sourceMappingURL=index.esm.js.map

package/dist/src/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/src/react/createSseContext.cjs.js

@@ -0,0 +1,130 @@
+'use strict';
+
+var _defineProperty = require('@babel/runtime/helpers/defineProperty');
+var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
+var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
+var react = require('react');
+var createSseClient = require('../createSseClient.cjs.js');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _defineProperty__default = /*#__PURE__*/_interopDefault(_defineProperty);
+var _slicedToArray__default = /*#__PURE__*/_interopDefault(_slicedToArray);
+var _objectWithoutProperties__default = /*#__PURE__*/_interopDefault(_objectWithoutProperties);
+
+var _excluded = ["enabled", "children"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty__default.default(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var useLatestRef = function useLatestRef(value) {
+  var ref = react.useRef(value);
+  react.useInsertionEffect(function () {
+    ref.current = value;
+  });
+  return ref;
+};
+
+/**
+ * @description 연결 옵션은 마운트 시점 값으로 고정됩니다 — 이후 prop 변경은 무시됩니다.
+ * 단 `getAuthToken`은 마지막 커밋된 렌더의 함수를 호출하므로 인라인 클로저를 넘겨도 안전합니다.
+ */
+
+/**
+ * @description 앱의 이벤트 맵으로 Provider와 훅을 한 번에 생성합니다 — 호출부는 이벤트명만으로 페이로드가 추론됩니다.
+ * 컨텍스트를 팩토리 안에서 만들어 Provider와 훅이 타입으로 결합되며,
+ * 호출마다 제네릭을 명시하는 방식은 TS의 부분 타입 인자 추론 부재로 페이로드가 unknown이 되어 팩토리로 고정합니다.
+ * 컴포넌트 밖 모듈 스코프에서 한 번만 호출하세요 — 렌더 중 호출하면 컨텍스트가 매번 재생성됩니다.
+ *
+ * @example
+ * // 앱당 1회, 모듈 스코프
+ * export const { SseProvider, useSseEvent, useSseStatus } =
+ *   createSseContext<AppEventMap>();
+ *
+ * // 호출부 — 이벤트명만으로 페이로드가 추론됩니다
+ * useSseEvent('demo.created', (event) => showToast(event.id));
+ */
+function createSseContext() {
+  var SseClientContext = /*#__PURE__*/react.createContext(null);
+  var SseProvider = function SseProvider(_ref) {
+    var _ref$enabled = _ref.enabled,
+      enabled = _ref$enabled === void 0 ? true : _ref$enabled,
+      children = _ref.children,
+      options = _objectWithoutProperties__default.default(_ref, _excluded);
+    var getAuthTokenRef = useLatestRef(options.getAuthToken);
+    var _useState = react.useState(function () {
+        return createSseClient.createSseClient(_objectSpread(_objectSpread({}, options), {}, {
+          getAuthToken: function getAuthToken() {
+            return getAuthTokenRef.current();
+          }
+        }));
+      }),
+      _useState2 = _slicedToArray__default.default(_useState, 1),
+      client = _useState2[0];
+    react.useEffect(function () {
+      if (!enabled) {
+        return;
+      }
+      client.connect();
+      // 휴면으로 접힌 연결은 깨어난 탭의 connect만이 다시 세웁니다 — 소비처가 몰라도 복구되게 여기서 붙입니다
+      var detachAutoResume = client.attachAutoResume();
+      return function () {
+        detachAutoResume();
+        client.disconnect();
+      };
+    }, [client, enabled]);
+    return /*#__PURE__*/jsxRuntime.jsx(SseClientContext.Provider, {
+      value: client,
+      children: children
+    });
+  };
+  var useSseClient = function useSseClient() {
+    var client = react.useContext(SseClientContext);
+    if (!client) {
+      throw new Error('SSE 훅은 SseProvider 안에서만 호출할 수 있습니다');
+    }
+    return client;
+  };
+
+  /**
+   * @description 이벤트 구독 훅 — 마운트 동안 구독하고 언마운트에 해제하며, 핸들러는 항상 최신 렌더의 클로저를 봅니다.
+   * @param type 이벤트 이름. 도메인 이벤트 외 예약 4종 —
+   * - `fatal`(SDK의 포기 선언 — 재시도 없이 멈춤, SDK 합성) ·
+   * - `stalled`(재시도가 계속되는 진행형 통지, SDK 합성) ·
+   * - `goaway`(서버의 예고된 끊음 — `action: 'close'`만 안내 대상, 서버 발신) ·
+   * - `resync`(재수립 후 놓친 구간을 REST로 재조회하라는 신호, SDK 합성). 상세는 `WithLifecycle` 문서 참조.
+   * @param handler 이벤트 페이로드를 받는 콜백 — 발화 순간의 구독자에게만 배달되므로 수명주기 핸들러는 앱 루트에 두세요
+   */
+  var useSseEvent = function useSseEvent(type, handler) {
+    var client = useSseClient();
+    var handlerRef = useLatestRef(handler);
+    react.useEffect(function () {
+      return client.on(type, function (payload) {
+        return handlerRef.current(payload);
+      });
+    },
+    // handlerRef는 useRef 정체성이라 재구독을 유발하지 않지만, exhaustive-deps가 커스텀 훅 반환을 안정으로 볼 수 없어 명시합니다
+    [client, type, handlerRef]);
+  };
+  var useSseStatus = function useSseStatus() {
+    var client = useSseClient();
+    var subscribe = react.useCallback(function (onStoreChange) {
+      return client.onStatus(onStoreChange);
+    }, [client]);
+    return react.useSyncExternalStore(subscribe, function () {
+      return client.status;
+    },
+    // 서버/hydration 첫 렌더는 connect() 이전이라 항상 클라이언트 초기 상태입니다
+    function () {
+      return client.status;
+    });
+  };
+  return {
+    SseProvider: SseProvider,
+    useSseClient: useSseClient,
+    useSseEvent: useSseEvent,
+    useSseStatus: useSseStatus
+  };
+}
+
+exports.createSseContext = createSseContext;
+//# sourceMappingURL=createSseContext.cjs.js.map

package/dist/src/react/createSseContext.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseContext.cjs.js","sources":["../../../src/react/createSseContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useInsertionEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\n\nimport type {\n  PayloadOf,\n  SseClientLike,\n  SseClientOptions,\n  SseEventHandler,\n  SseEventMap,\n  SseEventName,\n  SseStatus,\n} from '../core/types';\nimport { createSseClient } from '../createSseClient';\n\n// useEffectEvent(React 19.2+)와 같은 목적의 latest-ref 패턴 — insertion effect는 커밋된 렌더에서만 실행되고 paint 전에 동기 반영됩니다\nconst useLatestRef = <T,>(value: T) => {\n  const ref = useRef(value);\n  useInsertionEffect(() => {\n    ref.current = value;\n  });\n  return ref;\n};\n\n/**\n * @description 연결 옵션은 마운트 시점 값으로 고정됩니다 — 이후 prop 변경은 무시됩니다.\n * 단 `getAuthToken`은 마지막 커밋된 렌더의 함수를 호출하므로 인라인 클로저를 넘겨도 안전합니다.\n */\nexport interface SseProviderProps extends SseClientOptions {\n  /** @description false면 연결하지 않고, 연결 중이면 해제합니다 (로그아웃 등) */\n  enabled?: boolean;\n  children: ReactNode;\n}\n\n/**\n * @description 앱의 이벤트 맵으로 Provider와 훅을 한 번에 생성합니다 — 호출부는 이벤트명만으로 페이로드가 추론됩니다.\n * 컨텍스트를 팩토리 안에서 만들어 Provider와 훅이 타입으로 결합되며,\n * 호출마다 제네릭을 명시하는 방식은 TS의 부분 타입 인자 추론 부재로 페이로드가 unknown이 되어 팩토리로 고정합니다.\n * 컴포넌트 밖 모듈 스코프에서 한 번만 호출하세요 — 렌더 중 호출하면 컨텍스트가 매번 재생성됩니다.\n *\n * @example\n * // 앱당 1회, 모듈 스코프\n * export const { SseProvider, useSseEvent, useSseStatus } =\n *   createSseContext<AppEventMap>();\n *\n * // 호출부 — 이벤트명만으로 페이로드가 추론됩니다\n * useSseEvent('demo.created', (event) => showToast(event.id));\n */\nexport function createSseContext<M extends object = SseEventMap>() {\n  const SseClientContext = createContext<SseClientLike<M> | null>(null);\n\n  const SseProvider = ({\n    enabled = true,\n    children,\n    ...options\n  }: Readonly<SseProviderProps>) => {\n    const getAuthTokenRef = useLatestRef(options.getAuthToken);\n\n    const [client] = useState(() =>\n      createSseClient<M>({\n        ...options,\n        getAuthToken: () => getAuthTokenRef.current(),\n      })\n    );\n\n    useEffect(() => {\n      if (!enabled) {\n        return;\n      }\n      client.connect();\n      // 휴면으로 접힌 연결은 깨어난 탭의 connect만이 다시 세웁니다 — 소비처가 몰라도 복구되게 여기서 붙입니다\n      const detachAutoResume = client.attachAutoResume();\n      return () => {\n        detachAutoResume();\n        client.disconnect();\n      };\n    }, [client, enabled]);\n\n    return (\n      <SseClientContext.Provider value={client}>\n        {children}\n      </SseClientContext.Provider>\n    );\n  };\n\n  const useSseClient = (): SseClientLike<M> => {\n    const client = useContext(SseClientContext);\n    if (!client) {\n      throw new Error('SSE 훅은 SseProvider 안에서만 호출할 수 있습니다');\n    }\n    return client;\n  };\n\n  /**\n   * @description 이벤트 구독 훅 — 마운트 동안 구독하고 언마운트에 해제하며, 핸들러는 항상 최신 렌더의 클로저를 봅니다.\n   * @param type 이벤트 이름. 도메인 이벤트 외 예약 4종 —\n   * - `fatal`(SDK의 포기 선언 — 재시도 없이 멈춤, SDK 합성) ·\n   * - `stalled`(재시도가 계속되는 진행형 통지, SDK 합성) ·\n   * - `goaway`(서버의 예고된 끊음 — `action: 'close'`만 안내 대상, 서버 발신) ·\n   * - `resync`(재수립 후 놓친 구간을 REST로 재조회하라는 신호, SDK 합성). 상세는 `WithLifecycle` 문서 참조.\n   * @param handler 이벤트 페이로드를 받는 콜백 — 발화 순간의 구독자에게만 배달되므로 수명주기 핸들러는 앱 루트에 두세요\n   */\n  const useSseEvent = <K extends SseEventName<M>>(\n    type: K,\n    handler: SseEventHandler<PayloadOf<M, K>>\n  ): void => {\n    const client = useSseClient();\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(\n      () => client.on(type, (payload) => handlerRef.current(payload)),\n      // handlerRef는 useRef 정체성이라 재구독을 유발하지 않지만, exhaustive-deps가 커스텀 훅 반환을 안정으로 볼 수 없어 명시합니다\n      [client, type, handlerRef]\n    );\n  };\n\n  const useSseStatus = (): SseStatus => {\n    const client = useSseClient();\n    const subscribe = useCallback(\n      (onStoreChange: () => void) => client.onStatus(onStoreChange),\n      [client]\n    );\n    return useSyncExternalStore(\n      subscribe,\n      () => client.status,\n      // 서버/hydration 첫 렌더는 connect() 이전이라 항상 클라이언트 초기 상태입니다\n      () => client.status\n    );\n  };\n\n  return { SseProvider, useSseClient, useSseEvent, useSseStatus };\n}\n"],"names":["useLatestRef","value","ref","useRef","useInsertionEffect","current","createSseContext","SseClientContext","createContext","SseProvider","_ref","_ref$enabled","enabled","children","options","_objectWithoutProperties","_excluded","getAuthTokenRef","getAuthToken","_useState","useState","createSseClient","_objectSpread","_useState2","_slicedToArray","client","useEffect","connect","detachAutoResume","attachAutoResume","disconnect","_jsx","Provider","useSseClient","useContext","Error","useSseEvent","type","handler","handlerRef","on","payload","useSseStatus","subscribe","useCallback","onStoreChange","onStatus","useSyncExternalStore","status"],"mappings":"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"}

package/dist/src/react/createSseContext.d.ts

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import type { PayloadOf, SseClientLike, SseClientOptions, SseEventHandler, SseEventMap, SseEventName, SseStatus } from '../core/types';
+/**
+ * @description 연결 옵션은 마운트 시점 값으로 고정됩니다 — 이후 prop 변경은 무시됩니다.
+ * 단 `getAuthToken`은 마지막 커밋된 렌더의 함수를 호출하므로 인라인 클로저를 넘겨도 안전합니다.
+ */
+export interface SseProviderProps extends SseClientOptions {
+    /** @description false면 연결하지 않고, 연결 중이면 해제합니다 (로그아웃 등) */
+    enabled?: boolean;
+    children: ReactNode;
+}
+/**
+ * @description 앱의 이벤트 맵으로 Provider와 훅을 한 번에 생성합니다 — 호출부는 이벤트명만으로 페이로드가 추론됩니다.
+ * 컨텍스트를 팩토리 안에서 만들어 Provider와 훅이 타입으로 결합되며,
+ * 호출마다 제네릭을 명시하는 방식은 TS의 부분 타입 인자 추론 부재로 페이로드가 unknown이 되어 팩토리로 고정합니다.
+ * 컴포넌트 밖 모듈 스코프에서 한 번만 호출하세요 — 렌더 중 호출하면 컨텍스트가 매번 재생성됩니다.
+ *
+ * @example
+ * // 앱당 1회, 모듈 스코프
+ * export const { SseProvider, useSseEvent, useSseStatus } =
+ *   createSseContext<AppEventMap>();
+ *
+ * // 호출부 — 이벤트명만으로 페이로드가 추론됩니다
+ * useSseEvent('demo.created', (event) => showToast(event.id));
+ */
+export declare function createSseContext<M extends object = SseEventMap>(): {
+    SseProvider: ({ enabled, children, ...options }: Readonly<SseProviderProps>) => import("react/jsx-runtime").JSX.Element;
+    useSseClient: () => SseClientLike<M>;
+    useSseEvent: <K extends SseEventName<M>>(type: K, handler: SseEventHandler<PayloadOf<M, K>>) => void;
+    useSseStatus: () => SseStatus;
+};
+//# sourceMappingURL=createSseContext.d.ts.map

package/dist/src/react/createSseContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseContext.d.ts","sourceRoot":"","sources":["../../../src/react/createSseContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYvC,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACV,MAAM,eAAe,CAAC;AAYvB;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW;qDAO1D,SAAS,gBAAgB,CAAC;wBA8BJ,cAAc,CAAC,CAAC;mDAkBjC,CAAC,WACE,gBAAgB,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,KACxC,IAAI;wBAWkB,SAAS;EAenC"}

package/dist/src/react/createSseContext.esm.js

@@ -0,0 +1,122 @@
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
+import { useCallback, useSyncExternalStore, useEffect, useContext, createContext, useState, useRef, useInsertionEffect } from 'react';
+import { createSseClient } from '../createSseClient.esm.js';
+import { jsx } from 'react/jsx-runtime';
+
+var _excluded = ["enabled", "children"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), true).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var useLatestRef = function useLatestRef(value) {
+  var ref = useRef(value);
+  useInsertionEffect(function () {
+    ref.current = value;
+  });
+  return ref;
+};
+
+/**
+ * @description 연결 옵션은 마운트 시점 값으로 고정됩니다 — 이후 prop 변경은 무시됩니다.
+ * 단 `getAuthToken`은 마지막 커밋된 렌더의 함수를 호출하므로 인라인 클로저를 넘겨도 안전합니다.
+ */
+
+/**
+ * @description 앱의 이벤트 맵으로 Provider와 훅을 한 번에 생성합니다 — 호출부는 이벤트명만으로 페이로드가 추론됩니다.
+ * 컨텍스트를 팩토리 안에서 만들어 Provider와 훅이 타입으로 결합되며,
+ * 호출마다 제네릭을 명시하는 방식은 TS의 부분 타입 인자 추론 부재로 페이로드가 unknown이 되어 팩토리로 고정합니다.
+ * 컴포넌트 밖 모듈 스코프에서 한 번만 호출하세요 — 렌더 중 호출하면 컨텍스트가 매번 재생성됩니다.
+ *
+ * @example
+ * // 앱당 1회, 모듈 스코프
+ * export const { SseProvider, useSseEvent, useSseStatus } =
+ *   createSseContext<AppEventMap>();
+ *
+ * // 호출부 — 이벤트명만으로 페이로드가 추론됩니다
+ * useSseEvent('demo.created', (event) => showToast(event.id));
+ */
+function createSseContext() {
+  var SseClientContext = /*#__PURE__*/createContext(null);
+  var SseProvider = function SseProvider(_ref) {
+    var _ref$enabled = _ref.enabled,
+      enabled = _ref$enabled === void 0 ? true : _ref$enabled,
+      children = _ref.children,
+      options = _objectWithoutProperties(_ref, _excluded);
+    var getAuthTokenRef = useLatestRef(options.getAuthToken);
+    var _useState = useState(function () {
+        return createSseClient(_objectSpread(_objectSpread({}, options), {}, {
+          getAuthToken: function getAuthToken() {
+            return getAuthTokenRef.current();
+          }
+        }));
+      }),
+      _useState2 = _slicedToArray(_useState, 1),
+      client = _useState2[0];
+    useEffect(function () {
+      if (!enabled) {
+        return;
+      }
+      client.connect();
+      // 휴면으로 접힌 연결은 깨어난 탭의 connect만이 다시 세웁니다 — 소비처가 몰라도 복구되게 여기서 붙입니다
+      var detachAutoResume = client.attachAutoResume();
+      return function () {
+        detachAutoResume();
+        client.disconnect();
+      };
+    }, [client, enabled]);
+    return /*#__PURE__*/jsx(SseClientContext.Provider, {
+      value: client,
+      children: children
+    });
+  };
+  var useSseClient = function useSseClient() {
+    var client = useContext(SseClientContext);
+    if (!client) {
+      throw new Error('SSE 훅은 SseProvider 안에서만 호출할 수 있습니다');
+    }
+    return client;
+  };
+
+  /**
+   * @description 이벤트 구독 훅 — 마운트 동안 구독하고 언마운트에 해제하며, 핸들러는 항상 최신 렌더의 클로저를 봅니다.
+   * @param type 이벤트 이름. 도메인 이벤트 외 예약 4종 —
+   * - `fatal`(SDK의 포기 선언 — 재시도 없이 멈춤, SDK 합성) ·
+   * - `stalled`(재시도가 계속되는 진행형 통지, SDK 합성) ·
+   * - `goaway`(서버의 예고된 끊음 — `action: 'close'`만 안내 대상, 서버 발신) ·
+   * - `resync`(재수립 후 놓친 구간을 REST로 재조회하라는 신호, SDK 합성). 상세는 `WithLifecycle` 문서 참조.
+   * @param handler 이벤트 페이로드를 받는 콜백 — 발화 순간의 구독자에게만 배달되므로 수명주기 핸들러는 앱 루트에 두세요
+   */
+  var useSseEvent = function useSseEvent(type, handler) {
+    var client = useSseClient();
+    var handlerRef = useLatestRef(handler);
+    useEffect(function () {
+      return client.on(type, function (payload) {
+        return handlerRef.current(payload);
+      });
+    },
+    // handlerRef는 useRef 정체성이라 재구독을 유발하지 않지만, exhaustive-deps가 커스텀 훅 반환을 안정으로 볼 수 없어 명시합니다
+    [client, type, handlerRef]);
+  };
+  var useSseStatus = function useSseStatus() {
+    var client = useSseClient();
+    var subscribe = useCallback(function (onStoreChange) {
+      return client.onStatus(onStoreChange);
+    }, [client]);
+    return useSyncExternalStore(subscribe, function () {
+      return client.status;
+    },
+    // 서버/hydration 첫 렌더는 connect() 이전이라 항상 클라이언트 초기 상태입니다
+    function () {
+      return client.status;
+    });
+  };
+  return {
+    SseProvider: SseProvider,
+    useSseClient: useSseClient,
+    useSseEvent: useSseEvent,
+    useSseStatus: useSseStatus
+  };
+}
+
+export { createSseContext };
+//# sourceMappingURL=createSseContext.esm.js.map

package/dist/src/react/createSseContext.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSseContext.esm.js","sources":["../../../src/react/createSseContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useInsertionEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\n\nimport type {\n  PayloadOf,\n  SseClientLike,\n  SseClientOptions,\n  SseEventHandler,\n  SseEventMap,\n  SseEventName,\n  SseStatus,\n} from '../core/types';\nimport { createSseClient } from '../createSseClient';\n\n// useEffectEvent(React 19.2+)와 같은 목적의 latest-ref 패턴 — insertion effect는 커밋된 렌더에서만 실행되고 paint 전에 동기 반영됩니다\nconst useLatestRef = <T,>(value: T) => {\n  const ref = useRef(value);\n  useInsertionEffect(() => {\n    ref.current = value;\n  });\n  return ref;\n};\n\n/**\n * @description 연결 옵션은 마운트 시점 값으로 고정됩니다 — 이후 prop 변경은 무시됩니다.\n * 단 `getAuthToken`은 마지막 커밋된 렌더의 함수를 호출하므로 인라인 클로저를 넘겨도 안전합니다.\n */\nexport interface SseProviderProps extends SseClientOptions {\n  /** @description false면 연결하지 않고, 연결 중이면 해제합니다 (로그아웃 등) */\n  enabled?: boolean;\n  children: ReactNode;\n}\n\n/**\n * @description 앱의 이벤트 맵으로 Provider와 훅을 한 번에 생성합니다 — 호출부는 이벤트명만으로 페이로드가 추론됩니다.\n * 컨텍스트를 팩토리 안에서 만들어 Provider와 훅이 타입으로 결합되며,\n * 호출마다 제네릭을 명시하는 방식은 TS의 부분 타입 인자 추론 부재로 페이로드가 unknown이 되어 팩토리로 고정합니다.\n * 컴포넌트 밖 모듈 스코프에서 한 번만 호출하세요 — 렌더 중 호출하면 컨텍스트가 매번 재생성됩니다.\n *\n * @example\n * // 앱당 1회, 모듈 스코프\n * export const { SseProvider, useSseEvent, useSseStatus } =\n *   createSseContext<AppEventMap>();\n *\n * // 호출부 — 이벤트명만으로 페이로드가 추론됩니다\n * useSseEvent('demo.created', (event) => showToast(event.id));\n */\nexport function createSseContext<M extends object = SseEventMap>() {\n  const SseClientContext = createContext<SseClientLike<M> | null>(null);\n\n  const SseProvider = ({\n    enabled = true,\n    children,\n    ...options\n  }: Readonly<SseProviderProps>) => {\n    const getAuthTokenRef = useLatestRef(options.getAuthToken);\n\n    const [client] = useState(() =>\n      createSseClient<M>({\n        ...options,\n        getAuthToken: () => getAuthTokenRef.current(),\n      })\n    );\n\n    useEffect(() => {\n      if (!enabled) {\n        return;\n      }\n      client.connect();\n      // 휴면으로 접힌 연결은 깨어난 탭의 connect만이 다시 세웁니다 — 소비처가 몰라도 복구되게 여기서 붙입니다\n      const detachAutoResume = client.attachAutoResume();\n      return () => {\n        detachAutoResume();\n        client.disconnect();\n      };\n    }, [client, enabled]);\n\n    return (\n      <SseClientContext.Provider value={client}>\n        {children}\n      </SseClientContext.Provider>\n    );\n  };\n\n  const useSseClient = (): SseClientLike<M> => {\n    const client = useContext(SseClientContext);\n    if (!client) {\n      throw new Error('SSE 훅은 SseProvider 안에서만 호출할 수 있습니다');\n    }\n    return client;\n  };\n\n  /**\n   * @description 이벤트 구독 훅 — 마운트 동안 구독하고 언마운트에 해제하며, 핸들러는 항상 최신 렌더의 클로저를 봅니다.\n   * @param type 이벤트 이름. 도메인 이벤트 외 예약 4종 —\n   * - `fatal`(SDK의 포기 선언 — 재시도 없이 멈춤, SDK 합성) ·\n   * - `stalled`(재시도가 계속되는 진행형 통지, SDK 합성) ·\n   * - `goaway`(서버의 예고된 끊음 — `action: 'close'`만 안내 대상, 서버 발신) ·\n   * - `resync`(재수립 후 놓친 구간을 REST로 재조회하라는 신호, SDK 합성). 상세는 `WithLifecycle` 문서 참조.\n   * @param handler 이벤트 페이로드를 받는 콜백 — 발화 순간의 구독자에게만 배달되므로 수명주기 핸들러는 앱 루트에 두세요\n   */\n  const useSseEvent = <K extends SseEventName<M>>(\n    type: K,\n    handler: SseEventHandler<PayloadOf<M, K>>\n  ): void => {\n    const client = useSseClient();\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(\n      () => client.on(type, (payload) => handlerRef.current(payload)),\n      // handlerRef는 useRef 정체성이라 재구독을 유발하지 않지만, exhaustive-deps가 커스텀 훅 반환을 안정으로 볼 수 없어 명시합니다\n      [client, type, handlerRef]\n    );\n  };\n\n  const useSseStatus = (): SseStatus => {\n    const client = useSseClient();\n    const subscribe = useCallback(\n      (onStoreChange: () => void) => client.onStatus(onStoreChange),\n      [client]\n    );\n    return useSyncExternalStore(\n      subscribe,\n      () => client.status,\n      // 서버/hydration 첫 렌더는 connect() 이전이라 항상 클라이언트 초기 상태입니다\n      () => client.status\n    );\n  };\n\n  return { SseProvider, useSseClient, useSseEvent, useSseStatus };\n}\n"],"names":["useLatestRef","value","ref","useRef","useInsertionEffect","current","createSseContext","SseClientContext","createContext","SseProvider","_ref","_ref$enabled","enabled","children","options","_objectWithoutProperties","_excluded","getAuthTokenRef","getAuthToken","_useState","useState","createSseClient","_objectSpread","_useState2","_slicedToArray","client","useEffect","connect","detachAutoResume","attachAutoResume","disconnect","_jsx","Provider","useSseClient","useContext","Error","useSseEvent","type","handler","handlerRef","on","payload","useSseStatus","subscribe","useCallback","onStoreChange","onStatus","useSyncExternalStore","status"],"mappings":"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"}

package/dist/src/react/index.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var createSseContext = require('./createSseContext.cjs.js');
+
+
+
+exports.createSseContext = createSseContext.createSseContext;
+//# sourceMappingURL=index.cjs.js.map

package/dist/src/react/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/src/react/index.d.ts

@@ -0,0 +1,3 @@
+export { createSseContext } from './createSseContext';
+export type { SseProviderProps } from './createSseContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/react/index.esm.js

@@ -0,0 +1,2 @@
+export { createSseContext } from './createSseContext.esm.js';
+//# sourceMappingURL=index.esm.js.map

package/dist/src/react/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/src/testing/doubles.d.ts

@@ -0,0 +1,50 @@
+import type { TabToWorkerMessage, WorkerToTabMessage } from '../worker/protocol';
+/** @description EventSource 대역 — 생성분을 정적으로 모아 마지막 인스턴스를 집어낼 수 있게 합니다 */
+export declare class FakeEventSource {
+    readonly url: string;
+    static readonly instances: FakeEventSource[];
+    /** @description 테스트 간 격리 — 재할당 대신 비워, 앞서 넘긴 참조가 옛 배열을 보지 않게 합니다 */
+    static reset(): void;
+    readonly listeners: Map<string, Set<(event: {
+        data?: string;
+    }) => void>>;
+    onerror: ((event: unknown) => void) | null;
+    closed: boolean;
+    constructor(url: string);
+    addEventListener(type: string, listener: (event: {
+        data?: string;
+    }) => void): void;
+    close(): void;
+    dispatch(type: string, data?: string): void;
+    error(): void;
+}
+export declare const lastSource: () => FakeEventSource;
+/**
+ * @description 포트 대역 — 허브 쪽(HubPort)과 탭 쪽(MessagePort) 양쪽 표면을 함께 만족합니다.
+ * 한 포트의 양 끝을 한 객체로 보므로, 허브가 보낸 메시지는 sent에, 탭이 보낸 메시지는 posted에 쌓입니다.
+ */
+export declare class FakePort {
+    /** @description 허브가 이 포트로 보낸 것 */
+    sent: WorkerToTabMessage[];
+    /** @description 탭 프록시가 이 포트로 보낸 것 */
+    posted: TabToWorkerMessage[];
+    closeCount: number;
+    started: boolean;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    get closed(): boolean;
+    postMessage(message: WorkerToTabMessage | TabToWorkerMessage): void;
+    start(): void;
+    close(): void;
+    /** @description 워커가 탭에 보낸 것처럼 프록시의 onmessage를 깨웁니다 */
+    deliver(message: WorkerToTabMessage): void;
+}
+export declare const kindsOf: <K extends "event" | "status" | "ping" | "ticket-request">(port: FakePort, kind: K) => Extract<WorkerToTabMessage, {
+    kind: K;
+}>[];
+/** @description SharedWorker 대역 — 팩토리가 넘겨받는 표면은 port 하나뿐입니다 */
+export declare class FakeSharedWorker {
+    readonly port: FakePort;
+}
+//# sourceMappingURL=doubles.d.ts.map

package/dist/src/testing/doubles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubles.d.ts","sourceRoot":"","sources":["../../../src/testing/doubles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,wEAAwE;AACxE,qBAAa,eAAe;IAed,QAAQ,CAAC,GAAG,EAAE,MAAM;IAdhC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,CAAM;IAElD,mEAAmE;IACnE,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB,QAAQ,CAAC,SAAS,0BAEJ;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GACpC;IACJ,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAClD,MAAM,UAAS;gBAEM,GAAG,EAAE,MAAM;IAIhC,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAC3C,IAAI;IAMP,KAAK,IAAI,IAAI;IAKb,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3C,KAAK,IAAI,IAAI;CAMd;AAED,eAAO,MAAM,UAAU,QAAO,eACK,CAAC;AAEpC;;;GAGG;AACH,qBAAa,QAAQ;IACnB,kCAAkC;IAClC,IAAI,EAAE,kBAAkB,EAAE,CAAM;IAChC,qCAAqC;IACrC,MAAM,EAAE,kBAAkB,EAAE,CAAM;IAClC,UAAU,SAAK;IACf,OAAO,UAAS;IAChB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAE9D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAGD,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI;IAYnE,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;IAIb,sDAAsD;IACtD,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAG3C;AAcD,eAAO,MAAM,OAAO,mEACZ,QAAQ,QACR,CAAC,KACN,QAAQ,kBAAkB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,EAIxC,CAAC;AAEJ,+DAA+D;AAC/D,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,WAAkB;CAChC"}

package/dist/src/testing/harness.d.ts

@@ -0,0 +1,43 @@
+import { SseClient } from '../core/SseClient';
+import type { SseClientOptions } from '../core/types';
+export interface TestEventMap {
+    'demo.created': {
+        id: string;
+    };
+}
+export declare const createFetchMock: () => {
+    fetch: typeof fetch;
+    requests: {
+        url: string;
+        method?: string | undefined;
+        authorization?: string | undefined;
+    }[];
+    ticketRequests: () => {
+        url: string;
+        method?: string | undefined;
+        authorization?: string | undefined;
+    }[];
+    failTicketsWith: (status: number | null) => void;
+};
+export declare const createHarness: (overrides?: Partial<SseClientOptions>) => {
+    fetch: typeof fetch;
+    requests: {
+        url: string;
+        method?: string | undefined;
+        authorization?: string | undefined;
+    }[];
+    ticketRequests: () => {
+        url: string;
+        method?: string | undefined;
+        authorization?: string | undefined;
+    }[];
+    failTicketsWith: (status: number | null) => void;
+    client: SseClient<TestEventMap>;
+};
+/**
+ * @description 재연결 시점을 결정적으로 만드는 준비 — 정리는 vitest.setup.ts가 전역으로 합니다.
+ * 백오프를 기다리는 테스트 파일만 켜세요. React 테스트처럼 실제 타이머가 필요한 곳은 켜지 않습니다.
+ */
+export declare const setupFakeTimers: () => void;
+export declare const openConnection: (client: SseClient<TestEventMap>) => Promise<void>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/src/testing/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/testing/harness.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,eAAO,MAAM,eAAe;;;aACH,MAAM;;;;;aAAN,MAAM;;;;8BAkCD,MAAM,GAAG,IAAI;CAI1C,CAAC;AAEF,eAAO,MAAM,aAAa,eAAgB,QAAQ,gBAAgB,CAAC;;;aAxC1C,MAAM;;;;;aAAN,MAAM;;;;8BAkCD,MAAM,GAAG,IAAI;;CAgB1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,IAMlC,CAAC;AAEF,eAAO,MAAM,cAAc,WAAkB,UAAU,YAAY,CAAC,kBAInE,CAAC"}

package/dist/src/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * from './doubles';
+export * from './harness';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}