@remember-web/sse 0.1.0-alpha.1

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

@@ -0,0 +1,51 @@
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+
+/**
+ * @description SseClient·WorkerSseClient가 공유하는 구독·발행 코어.
+ * 리스너 예외를 격리합니다 — 하나가 던져도 나머지 리스너와 호출자의 정리 로직이 중단되지 않게.
+ */
+var createEmitter = function createEmitter(logger) {
+  var handlers = new Map();
+  var statusListeners = new Set();
+  var safeCall = function safeCall(listener, value) {
+    try {
+      listener(value);
+    } catch (error) {
+      logger === null || logger === void 0 || logger.warn('sse: 리스너 예외를 격리했습니다', error);
+    }
+  };
+  return {
+    on: function on(type, handler) {
+      var _handlers$get;
+      var set = (_handlers$get = handlers.get(type)) !== null && _handlers$get !== void 0 ? _handlers$get : new Set();
+      set.add(handler);
+      handlers.set(type, set);
+      return function () {
+        set["delete"](handler);
+      };
+    },
+    onStatus: function onStatus(listener) {
+      statusListeners.add(listener);
+      return function () {
+        statusListeners["delete"](listener);
+      };
+    },
+    emit: function emit(type, payload) {
+      var _handlers$get2;
+      (_handlers$get2 = handlers.get(type)) === null || _handlers$get2 === void 0 || _handlers$get2.forEach(function (handler) {
+        return safeCall(handler, payload);
+      });
+    },
+    emitStatus: function emitStatus(status) {
+      statusListeners.forEach(function (listener) {
+        return safeCall(listener, status);
+      });
+    },
+    handlerTypes: function handlerTypes() {
+      return _toConsumableArray(handlers.keys());
+    }
+  };
+};
+
+export { createEmitter };
+//# sourceMappingURL=emitter.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.esm.js","sources":["../../../src/core/emitter.ts"],"sourcesContent":["import type {\n  SseEventHandler,\n  SseLogger,\n  SseStatus,\n  Unsubscribe,\n} from './types';\n\n/**\n * @description SseClient·WorkerSseClient가 공유하는 구독·발행 코어.\n * 리스너 예외를 격리합니다 — 하나가 던져도 나머지 리스너와 호출자의 정리 로직이 중단되지 않게.\n */\nexport const createEmitter = (logger?: SseLogger) => {\n  const handlers = new Map<string, Set<SseEventHandler<unknown>>>();\n  const statusListeners = new Set<(status: SseStatus) => void>();\n\n  const safeCall = <T>(listener: (value: T) => void, value: T): void => {\n    try {\n      listener(value);\n    } catch (error) {\n      logger?.warn('sse: 리스너 예외를 격리했습니다', error);\n    }\n  };\n\n  return {\n    on: (type: string, handler: SseEventHandler<unknown>): Unsubscribe => {\n      const set = handlers.get(type) ?? new Set();\n\n      set.add(handler);\n      handlers.set(type, set);\n\n      return () => {\n        set.delete(handler);\n      };\n    },\n\n    onStatus: (listener: (status: SseStatus) => void): Unsubscribe => {\n      statusListeners.add(listener);\n\n      return () => {\n        statusListeners.delete(listener);\n      };\n    },\n\n    emit: (type: string, payload: unknown): void => {\n      handlers.get(type)?.forEach((handler) => safeCall(handler, payload));\n    },\n\n    emitStatus: (status: SseStatus): void => {\n      statusListeners.forEach((listener) => safeCall(listener, status));\n    },\n\n    handlerTypes: (): string[] => [...handlers.keys()],\n  };\n};\n\nexport type Emitter = ReturnType<typeof createEmitter>;\n"],"names":["createEmitter","logger","handlers","Map","statusListeners","Set","safeCall","listener","value","error","warn","on","type","handler","_handlers$get","set","get","add","onStatus","emit","payload","_handlers$get2","forEach","emitStatus","status","handlerTypes","_toConsumableArray","keys"],"mappings":";;AAOA;AACA;AACA;AACA;IACaA,aAAa,GAAG,SAAhBA,aAAaA,CAAIC,MAAkB,EAAK;AACnD,EAAA,IAAMC,QAAQ,GAAG,IAAIC,GAAG,EAAyC;AACjE,EAAA,IAAMC,eAAe,GAAG,IAAIC,GAAG,EAA+B;EAE9D,IAAMC,QAAQ,GAAG,SAAXA,QAAQA,CAAOC,QAA4B,EAAEC,KAAQ,EAAW;IACpE,IAAI;MACFD,QAAQ,CAACC,KAAK,CAAC;KAChB,CAAC,OAAOC,KAAK,EAAE;MACdR,MAAM,KAAA,IAAA,IAANA,MAAM,KAAA,MAAA,IAANA,MAAM,CAAES,IAAI,CAAC,qBAAqB,EAAED,KAAK,CAAC;AAC5C;GACD;EAED,OAAO;AACLE,IAAAA,EAAE,EAAE,SAAAA,EAAAA,CAACC,IAAY,EAAEC,OAAiC,EAAkB;AAAA,MAAA,IAAAC,aAAA;AACpE,MAAA,IAAMC,GAAG,GAAA,CAAAD,aAAA,GAAGZ,QAAQ,CAACc,GAAG,CAACJ,IAAI,CAAC,MAAA,IAAA,IAAAE,aAAA,KAAA,MAAA,GAAAA,aAAA,GAAI,IAAIT,GAAG,EAAE;AAE3CU,MAAAA,GAAG,CAACE,GAAG,CAACJ,OAAO,CAAC;AAChBX,MAAAA,QAAQ,CAACa,GAAG,CAACH,IAAI,EAAEG,GAAG,CAAC;AAEvB,MAAA,OAAO,YAAM;QACXA,GAAG,CAAA,QAAA,CAAO,CAACF,OAAO,CAAC;OACpB;KACF;AAEDK,IAAAA,QAAQ,EAAE,SAAAA,QAAAA,CAACX,QAAqC,EAAkB;AAChEH,MAAAA,eAAe,CAACa,GAAG,CAACV,QAAQ,CAAC;AAE7B,MAAA,OAAO,YAAM;QACXH,eAAe,CAAA,QAAA,CAAO,CAACG,QAAQ,CAAC;OACjC;KACF;AAEDY,IAAAA,IAAI,EAAE,SAAAA,IAAAA,CAACP,IAAY,EAAEQ,OAAgB,EAAW;AAAA,MAAA,IAAAC,cAAA;AAC9C,MAAA,CAAAA,cAAA,GAAAnB,QAAQ,CAACc,GAAG,CAACJ,IAAI,CAAC,MAAA,IAAA,IAAAS,cAAA,eAAlBA,cAAA,CAAoBC,OAAO,CAAC,UAACT,OAAO,EAAA;AAAA,QAAA,OAAKP,QAAQ,CAACO,OAAO,EAAEO,OAAO,CAAC;OAAA,CAAC;KACrE;AAEDG,IAAAA,UAAU,EAAE,SAAAA,UAAAA,CAACC,MAAiB,EAAW;AACvCpB,MAAAA,eAAe,CAACkB,OAAO,CAAC,UAACf,QAAQ,EAAA;AAAA,QAAA,OAAKD,QAAQ,CAACC,QAAQ,EAAEiB,MAAM,CAAC;OAAA,CAAC;KAClE;IAEDC,YAAY,EAAE,SAAAA,YAAAA,GAAA;AAAA,MAAA,OAAAC,kBAAA,CAAoBxB,QAAQ,CAACyB,IAAI,EAAE,CAAA;AAAA;GAClD;AACH;;;;"}

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

@@ -0,0 +1,64 @@
+'use strict';
+
+var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _toConsumableArray__default = /*#__PURE__*/_interopDefault(_toConsumableArray);
+
+// 서버가 /v1/events 스트림으로 보내는 연결 수명주기 이벤트 — 도메인 이벤트와 달리 SDK가 소비합니다
+var SERVER_CONNECTION_EVENTS = {
+  hello: 'hello',
+  goaway: 'goaway'
+};
+
+/**
+ * @description SDK가 스스로 발화하는 이벤트 — 재수립(resync)·멈춘 사유(fatal)·미연결 지속(stalled)을 SDK가 알아채 알립니다
+ */
+var SDK_EVENTS = {
+  resync: 'resync',
+  fatal: 'fatal',
+  stalled: 'stalled'
+};
+
+/**
+ * @description 소비처로 배달하는 이름들 — 출처(서버·SDK)와 무관하게 "소비처가 보는가"만 봅니다.
+ * 워커는 구독 장부와 별개로 이 목록을 중계해야 합니다: 장부만 보고 붙이면 소비처에 영영 도달하지 않습니다.
+ * SDK 이벤트는 배달이 곧 존재 이유라 전부 파생합니다 — 나열하면 이름을 늘릴 때 빠뜨릴 자리가 생깁니다.
+ * 서버 연결 이벤트는 SDK가 소비하는 게 기본이라 배달할 것만 골라 넣습니다:
+ * goaway는 SDK가 action으로 재연결을 판단하고, 소비처는 reason으로 안내를 정합니다.
+ */
+var FORWARDED_EVENTS = [].concat(_toConsumableArray__default.default(Object.values(SDK_EVENTS)), [SERVER_CONNECTION_EVENTS.goaway]);
+
+// 멤버십 검사는 Set 파생으로 — Object.hasOwn(Safari 15.4+)이 배포 하한을 만들지 않게 합니다
+var SERVER_CONNECTION_EVENT_NAMES = new Set(Object.values(SERVER_CONNECTION_EVENTS));
+var FORWARDED_EVENT_NAMES = new Set(FORWARDED_EVENTS);
+var isServerConnectionEvent = function isServerConnectionEvent(type) {
+  return SERVER_CONNECTION_EVENT_NAMES.has(type);
+};
+var isForwardedEvent = function isForwardedEvent(type) {
+  return FORWARDED_EVENT_NAMES.has(type);
+};
+
+/**
+ * @description 서버 스트림에 구독을 걸 이름인지 판정합니다 — 연결 이벤트와 중계 목록은 SDK가 소유합니다.
+ * 목록에서 판정을 파생해야 이름을 추가할 때 구독 제외가 따라옵니다: 빠지면 워커가 같은 이벤트를 두 번 배달합니다.
+ */
+var isSubscribableEvent = function isSubscribableEvent(type) {
+  return !isServerConnectionEvent(type) && !isForwardedEvent(type);
+};
+
+/**
+ * @description 구독해도 배달되지 않는 이름인지 판정합니다 — 조용한 무배달 구독을 경고로 알리는 데 씁니다.
+ * 중계 목록에 있으면 SDK가 소비하더라도 소비처에 배달되므로 경고 대상이 아닙니다.
+ */
+var isUndeliverableEvent = function isUndeliverableEvent(type) {
+  return isServerConnectionEvent(type) && !isForwardedEvent(type);
+};
+
+exports.FORWARDED_EVENTS = FORWARDED_EVENTS;
+exports.SDK_EVENTS = SDK_EVENTS;
+exports.SERVER_CONNECTION_EVENTS = SERVER_CONNECTION_EVENTS;
+exports.isSubscribableEvent = isSubscribableEvent;
+exports.isUndeliverableEvent = isUndeliverableEvent;
+//# sourceMappingURL=eventNames.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventNames.cjs.js","sources":["../../../src/core/eventNames.ts"],"sourcesContent":["// 서버가 /v1/events 스트림으로 보내는 연결 수명주기 이벤트 — 도메인 이벤트와 달리 SDK가 소비합니다\nexport const SERVER_CONNECTION_EVENTS = {\n  hello: 'hello',\n  goaway: 'goaway',\n} as const;\n\n/**\n * @description SDK가 스스로 발화하는 이벤트 — 재수립(resync)·멈춘 사유(fatal)·미연결 지속(stalled)을 SDK가 알아채 알립니다\n */\nexport const SDK_EVENTS = {\n  resync: 'resync',\n  fatal: 'fatal',\n  stalled: 'stalled',\n} as const;\n\n/**\n * @description 소비처로 배달하는 이름들 — 출처(서버·SDK)와 무관하게 \"소비처가 보는가\"만 봅니다.\n * 워커는 구독 장부와 별개로 이 목록을 중계해야 합니다: 장부만 보고 붙이면 소비처에 영영 도달하지 않습니다.\n * SDK 이벤트는 배달이 곧 존재 이유라 전부 파생합니다 — 나열하면 이름을 늘릴 때 빠뜨릴 자리가 생깁니다.\n * 서버 연결 이벤트는 SDK가 소비하는 게 기본이라 배달할 것만 골라 넣습니다:\n * goaway는 SDK가 action으로 재연결을 판단하고, 소비처는 reason으로 안내를 정합니다.\n */\nexport const FORWARDED_EVENTS = [\n  ...Object.values(SDK_EVENTS),\n  SERVER_CONNECTION_EVENTS.goaway,\n] as const;\n\n// 멤버십 검사는 Set 파생으로 — Object.hasOwn(Safari 15.4+)이 배포 하한을 만들지 않게 합니다\nconst SERVER_CONNECTION_EVENT_NAMES: ReadonlySet<string> = new Set(\n  Object.values(SERVER_CONNECTION_EVENTS)\n);\n\nconst FORWARDED_EVENT_NAMES: ReadonlySet<string> = new Set(FORWARDED_EVENTS);\n\nconst isServerConnectionEvent = (type: string): boolean =>\n  SERVER_CONNECTION_EVENT_NAMES.has(type);\n\nconst isForwardedEvent = (type: string): boolean =>\n  FORWARDED_EVENT_NAMES.has(type);\n\n/**\n * @description 서버 스트림에 구독을 걸 이름인지 판정합니다 — 연결 이벤트와 중계 목록은 SDK가 소유합니다.\n * 목록에서 판정을 파생해야 이름을 추가할 때 구독 제외가 따라옵니다: 빠지면 워커가 같은 이벤트를 두 번 배달합니다.\n */\nexport const isSubscribableEvent = (type: string): boolean =>\n  !isServerConnectionEvent(type) && !isForwardedEvent(type);\n\n/**\n * @description 구독해도 배달되지 않는 이름인지 판정합니다 — 조용한 무배달 구독을 경고로 알리는 데 씁니다.\n * 중계 목록에 있으면 SDK가 소비하더라도 소비처에 배달되므로 경고 대상이 아닙니다.\n */\nexport const isUndeliverableEvent = (type: string): boolean =>\n  isServerConnectionEvent(type) && !isForwardedEvent(type);\n"],"names":["SERVER_CONNECTION_EVENTS","hello","goaway","SDK_EVENTS","resync","fatal","stalled","FORWARDED_EVENTS","concat","_toConsumableArray","Object","values","SERVER_CONNECTION_EVENT_NAMES","Set","FORWARDED_EVENT_NAMES","isServerConnectionEvent","type","has","isForwardedEvent","isSubscribableEvent","isUndeliverableEvent"],"mappings":";;;;;;;;AAAA;AACO,IAAMA,wBAAwB,GAAG;AACtCC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,MAAM,EAAE;AACV;;AAEA;AACA;AACA;AACO,IAAMC,UAAU,GAAG;AACxBC,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,OAAO,EAAE;AACX;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;IACaC,gBAAgB,GAAA,EAAA,CAAAC,MAAA,CAAAC,mCAAA,CACxBC,MAAM,CAACC,MAAM,CAACR,UAAU,CAAC,IAC5BH,wBAAwB,CAACE,MAAM,CAAA;;AAGjC;AACA,IAAMU,6BAAkD,GAAG,IAAIC,GAAG,CAChEH,MAAM,CAACC,MAAM,CAACX,wBAAwB,CACxC,CAAC;AAED,IAAMc,qBAA0C,GAAG,IAAID,GAAG,CAACN,gBAAgB,CAAC;AAE5E,IAAMQ,uBAAuB,GAAG,SAA1BA,uBAAuBA,CAAIC,IAAY,EAAA;AAAA,EAAA,OAC3CJ,6BAA6B,CAACK,GAAG,CAACD,IAAI,CAAC;AAAA,CAAA;AAEzC,IAAME,gBAAgB,GAAG,SAAnBA,gBAAgBA,CAAIF,IAAY,EAAA;AAAA,EAAA,OACpCF,qBAAqB,CAACG,GAAG,CAACD,IAAI,CAAC;AAAA,CAAA;;AAEjC;AACA;AACA;AACA;IACaG,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAIH,IAAY,EAAA;EAAA,OAC9C,CAACD,uBAAuB,CAACC,IAAI,CAAC,IAAI,CAACE,gBAAgB,CAACF,IAAI,CAAC;AAAA;;AAE3D;AACA;AACA;AACA;IACaI,oBAAoB,GAAG,SAAvBA,oBAAoBA,CAAIJ,IAAY,EAAA;EAAA,OAC/CD,uBAAuB,CAACC,IAAI,CAAC,IAAI,CAACE,gBAAgB,CAACF,IAAI,CAAC;AAAA;;;;;;;;"}

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

@@ -0,0 +1,31 @@
+export declare const SERVER_CONNECTION_EVENTS: {
+    readonly hello: "hello";
+    readonly goaway: "goaway";
+};
+/**
+ * @description SDK가 스스로 발화하는 이벤트 — 재수립(resync)·멈춘 사유(fatal)·미연결 지속(stalled)을 SDK가 알아채 알립니다
+ */
+export declare const SDK_EVENTS: {
+    readonly resync: "resync";
+    readonly fatal: "fatal";
+    readonly stalled: "stalled";
+};
+/**
+ * @description 소비처로 배달하는 이름들 — 출처(서버·SDK)와 무관하게 "소비처가 보는가"만 봅니다.
+ * 워커는 구독 장부와 별개로 이 목록을 중계해야 합니다: 장부만 보고 붙이면 소비처에 영영 도달하지 않습니다.
+ * SDK 이벤트는 배달이 곧 존재 이유라 전부 파생합니다 — 나열하면 이름을 늘릴 때 빠뜨릴 자리가 생깁니다.
+ * 서버 연결 이벤트는 SDK가 소비하는 게 기본이라 배달할 것만 골라 넣습니다:
+ * goaway는 SDK가 action으로 재연결을 판단하고, 소비처는 reason으로 안내를 정합니다.
+ */
+export declare const FORWARDED_EVENTS: readonly [...("resync" | "fatal" | "stalled")[], "goaway"];
+/**
+ * @description 서버 스트림에 구독을 걸 이름인지 판정합니다 — 연결 이벤트와 중계 목록은 SDK가 소유합니다.
+ * 목록에서 판정을 파생해야 이름을 추가할 때 구독 제외가 따라옵니다: 빠지면 워커가 같은 이벤트를 두 번 배달합니다.
+ */
+export declare const isSubscribableEvent: (type: string) => boolean;
+/**
+ * @description 구독해도 배달되지 않는 이름인지 판정합니다 — 조용한 무배달 구독을 경고로 알리는 데 씁니다.
+ * 중계 목록에 있으면 SDK가 소비하더라도 소비처에 배달되므로 경고 대상이 아닙니다.
+ */
+export declare const isUndeliverableEvent: (type: string) => boolean;
+//# sourceMappingURL=eventNames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventNames.d.ts","sourceRoot":"","sources":["../../../src/core/eventNames.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,4DAGnB,CAAC;AAeX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,SAAU,MAAM,KAAG,OACQ,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,OACM,CAAC"}

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

@@ -0,0 +1,54 @@
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+
+// 서버가 /v1/events 스트림으로 보내는 연결 수명주기 이벤트 — 도메인 이벤트와 달리 SDK가 소비합니다
+var SERVER_CONNECTION_EVENTS = {
+  hello: 'hello',
+  goaway: 'goaway'
+};
+
+/**
+ * @description SDK가 스스로 발화하는 이벤트 — 재수립(resync)·멈춘 사유(fatal)·미연결 지속(stalled)을 SDK가 알아채 알립니다
+ */
+var SDK_EVENTS = {
+  resync: 'resync',
+  fatal: 'fatal',
+  stalled: 'stalled'
+};
+
+/**
+ * @description 소비처로 배달하는 이름들 — 출처(서버·SDK)와 무관하게 "소비처가 보는가"만 봅니다.
+ * 워커는 구독 장부와 별개로 이 목록을 중계해야 합니다: 장부만 보고 붙이면 소비처에 영영 도달하지 않습니다.
+ * SDK 이벤트는 배달이 곧 존재 이유라 전부 파생합니다 — 나열하면 이름을 늘릴 때 빠뜨릴 자리가 생깁니다.
+ * 서버 연결 이벤트는 SDK가 소비하는 게 기본이라 배달할 것만 골라 넣습니다:
+ * goaway는 SDK가 action으로 재연결을 판단하고, 소비처는 reason으로 안내를 정합니다.
+ */
+var FORWARDED_EVENTS = [].concat(_toConsumableArray(Object.values(SDK_EVENTS)), [SERVER_CONNECTION_EVENTS.goaway]);
+
+// 멤버십 검사는 Set 파생으로 — Object.hasOwn(Safari 15.4+)이 배포 하한을 만들지 않게 합니다
+var SERVER_CONNECTION_EVENT_NAMES = new Set(Object.values(SERVER_CONNECTION_EVENTS));
+var FORWARDED_EVENT_NAMES = new Set(FORWARDED_EVENTS);
+var isServerConnectionEvent = function isServerConnectionEvent(type) {
+  return SERVER_CONNECTION_EVENT_NAMES.has(type);
+};
+var isForwardedEvent = function isForwardedEvent(type) {
+  return FORWARDED_EVENT_NAMES.has(type);
+};
+
+/**
+ * @description 서버 스트림에 구독을 걸 이름인지 판정합니다 — 연결 이벤트와 중계 목록은 SDK가 소유합니다.
+ * 목록에서 판정을 파생해야 이름을 추가할 때 구독 제외가 따라옵니다: 빠지면 워커가 같은 이벤트를 두 번 배달합니다.
+ */
+var isSubscribableEvent = function isSubscribableEvent(type) {
+  return !isServerConnectionEvent(type) && !isForwardedEvent(type);
+};
+
+/**
+ * @description 구독해도 배달되지 않는 이름인지 판정합니다 — 조용한 무배달 구독을 경고로 알리는 데 씁니다.
+ * 중계 목록에 있으면 SDK가 소비하더라도 소비처에 배달되므로 경고 대상이 아닙니다.
+ */
+var isUndeliverableEvent = function isUndeliverableEvent(type) {
+  return isServerConnectionEvent(type) && !isForwardedEvent(type);
+};
+
+export { FORWARDED_EVENTS, SDK_EVENTS, SERVER_CONNECTION_EVENTS, isSubscribableEvent, isUndeliverableEvent };
+//# sourceMappingURL=eventNames.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventNames.esm.js","sources":["../../../src/core/eventNames.ts"],"sourcesContent":["// 서버가 /v1/events 스트림으로 보내는 연결 수명주기 이벤트 — 도메인 이벤트와 달리 SDK가 소비합니다\nexport const SERVER_CONNECTION_EVENTS = {\n  hello: 'hello',\n  goaway: 'goaway',\n} as const;\n\n/**\n * @description SDK가 스스로 발화하는 이벤트 — 재수립(resync)·멈춘 사유(fatal)·미연결 지속(stalled)을 SDK가 알아채 알립니다\n */\nexport const SDK_EVENTS = {\n  resync: 'resync',\n  fatal: 'fatal',\n  stalled: 'stalled',\n} as const;\n\n/**\n * @description 소비처로 배달하는 이름들 — 출처(서버·SDK)와 무관하게 \"소비처가 보는가\"만 봅니다.\n * 워커는 구독 장부와 별개로 이 목록을 중계해야 합니다: 장부만 보고 붙이면 소비처에 영영 도달하지 않습니다.\n * SDK 이벤트는 배달이 곧 존재 이유라 전부 파생합니다 — 나열하면 이름을 늘릴 때 빠뜨릴 자리가 생깁니다.\n * 서버 연결 이벤트는 SDK가 소비하는 게 기본이라 배달할 것만 골라 넣습니다:\n * goaway는 SDK가 action으로 재연결을 판단하고, 소비처는 reason으로 안내를 정합니다.\n */\nexport const FORWARDED_EVENTS = [\n  ...Object.values(SDK_EVENTS),\n  SERVER_CONNECTION_EVENTS.goaway,\n] as const;\n\n// 멤버십 검사는 Set 파생으로 — Object.hasOwn(Safari 15.4+)이 배포 하한을 만들지 않게 합니다\nconst SERVER_CONNECTION_EVENT_NAMES: ReadonlySet<string> = new Set(\n  Object.values(SERVER_CONNECTION_EVENTS)\n);\n\nconst FORWARDED_EVENT_NAMES: ReadonlySet<string> = new Set(FORWARDED_EVENTS);\n\nconst isServerConnectionEvent = (type: string): boolean =>\n  SERVER_CONNECTION_EVENT_NAMES.has(type);\n\nconst isForwardedEvent = (type: string): boolean =>\n  FORWARDED_EVENT_NAMES.has(type);\n\n/**\n * @description 서버 스트림에 구독을 걸 이름인지 판정합니다 — 연결 이벤트와 중계 목록은 SDK가 소유합니다.\n * 목록에서 판정을 파생해야 이름을 추가할 때 구독 제외가 따라옵니다: 빠지면 워커가 같은 이벤트를 두 번 배달합니다.\n */\nexport const isSubscribableEvent = (type: string): boolean =>\n  !isServerConnectionEvent(type) && !isForwardedEvent(type);\n\n/**\n * @description 구독해도 배달되지 않는 이름인지 판정합니다 — 조용한 무배달 구독을 경고로 알리는 데 씁니다.\n * 중계 목록에 있으면 SDK가 소비하더라도 소비처에 배달되므로 경고 대상이 아닙니다.\n */\nexport const isUndeliverableEvent = (type: string): boolean =>\n  isServerConnectionEvent(type) && !isForwardedEvent(type);\n"],"names":["SERVER_CONNECTION_EVENTS","hello","goaway","SDK_EVENTS","resync","fatal","stalled","FORWARDED_EVENTS","concat","_toConsumableArray","Object","values","SERVER_CONNECTION_EVENT_NAMES","Set","FORWARDED_EVENT_NAMES","isServerConnectionEvent","type","has","isForwardedEvent","isSubscribableEvent","isUndeliverableEvent"],"mappings":";;AAAA;AACO,IAAMA,wBAAwB,GAAG;AACtCC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,MAAM,EAAE;AACV;;AAEA;AACA;AACA;AACO,IAAMC,UAAU,GAAG;AACxBC,EAAAA,MAAM,EAAE,QAAQ;AAChBC,EAAAA,KAAK,EAAE,OAAO;AACdC,EAAAA,OAAO,EAAE;AACX;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;IACaC,gBAAgB,GAAA,EAAA,CAAAC,MAAA,CAAAC,kBAAA,CACxBC,MAAM,CAACC,MAAM,CAACR,UAAU,CAAC,IAC5BH,wBAAwB,CAACE,MAAM,CAAA;;AAGjC;AACA,IAAMU,6BAAkD,GAAG,IAAIC,GAAG,CAChEH,MAAM,CAACC,MAAM,CAACX,wBAAwB,CACxC,CAAC;AAED,IAAMc,qBAA0C,GAAG,IAAID,GAAG,CAACN,gBAAgB,CAAC;AAE5E,IAAMQ,uBAAuB,GAAG,SAA1BA,uBAAuBA,CAAIC,IAAY,EAAA;AAAA,EAAA,OAC3CJ,6BAA6B,CAACK,GAAG,CAACD,IAAI,CAAC;AAAA,CAAA;AAEzC,IAAME,gBAAgB,GAAG,SAAnBA,gBAAgBA,CAAIF,IAAY,EAAA;AAAA,EAAA,OACpCF,qBAAqB,CAACG,GAAG,CAACD,IAAI,CAAC;AAAA,CAAA;;AAEjC;AACA;AACA;AACA;IACaG,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAIH,IAAY,EAAA;EAAA,OAC9C,CAACD,uBAAuB,CAACC,IAAI,CAAC,IAAI,CAACE,gBAAgB,CAACF,IAAI,CAAC;AAAA;;AAE3D;AACA;AACA;AACA;IACaI,oBAAoB,GAAG,SAAvBA,oBAAoBA,CAAIJ,IAAY,EAAA;EAAA,OAC/CD,uBAAuB,CAACC,IAAI,CAAC,IAAI,CAACE,gBAAgB,CAACF,IAAI,CAAC;AAAA;;;;"}

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

@@ -0,0 +1,20 @@
+'use strict';
+
+/**
+ * @description 재시도 대기 Promise — 타이머 만료·abort 중 먼저 발생하는 쪽에서 resolve됩니다.
+ * 어느 경로로 풀리든 타이머와 abort 리스너를 함께 정리합니다.
+ */
+var waitForRetry = function waitForRetry(delayMs, signal) {
+  return new Promise(function (resolve) {
+    var finish = function finish() {
+      clearTimeout(timer);
+      signal.removeEventListener('abort', finish);
+      resolve();
+    };
+    var timer = setTimeout(finish, delayMs);
+    signal.addEventListener('abort', finish);
+  });
+};
+
+exports.waitForRetry = waitForRetry;
+//# sourceMappingURL=retryWait.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retryWait.cjs.js","sources":["../../../src/core/retryWait.ts"],"sourcesContent":["/**\n * @description 재시도 대기 Promise — 타이머 만료·abort 중 먼저 발생하는 쪽에서 resolve됩니다.\n * 어느 경로로 풀리든 타이머와 abort 리스너를 함께 정리합니다.\n */\nexport const waitForRetry = (\n  delayMs: number,\n  signal: AbortSignal\n): Promise<void> =>\n  new Promise((resolve) => {\n    const finish = () => {\n      clearTimeout(timer);\n      signal.removeEventListener('abort', finish);\n      resolve();\n    };\n\n    const timer = setTimeout(finish, delayMs);\n    signal.addEventListener('abort', finish);\n  });\n"],"names":["waitForRetry","delayMs","signal","Promise","resolve","finish","clearTimeout","timer","removeEventListener","setTimeout","addEventListener"],"mappings":";;AAAA;AACA;AACA;AACA;AACO,IAAMA,YAAY,GAAG,SAAfA,YAAYA,CACvBC,OAAe,EACfC,MAAmB,EAAA;AAAA,EAAA,OAEnB,IAAIC,OAAO,CAAC,UAACC,OAAO,EAAK;AACvB,IAAA,IAAMC,MAAM,GAAG,SAATA,MAAMA,GAAS;MACnBC,YAAY,CAACC,KAAK,CAAC;AACnBL,MAAAA,MAAM,CAACM,mBAAmB,CAAC,OAAO,EAAEH,MAAM,CAAC;AAC3CD,MAAAA,OAAO,EAAE;KACV;AAED,IAAA,IAAMG,KAAK,GAAGE,UAAU,CAACJ,MAAM,EAAEJ,OAAO,CAAC;AACzCC,IAAAA,MAAM,CAACQ,gBAAgB,CAAC,OAAO,EAAEL,MAAM,CAAC;AAC1C,GAAC,CAAC;AAAA;;;;"}

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

@@ -0,0 +1,6 @@
+/**
+ * @description 재시도 대기 Promise — 타이머 만료·abort 중 먼저 발생하는 쪽에서 resolve됩니다.
+ * 어느 경로로 풀리든 타이머와 abort 리스너를 함께 정리합니다.
+ */
+export declare const waitForRetry: (delayMs: number, signal: AbortSignal) => Promise<void>;
+//# sourceMappingURL=retryWait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retryWait.d.ts","sourceRoot":"","sources":["../../../src/core/retryWait.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY,YACd,MAAM,UACP,WAAW,KAClB,QAAQ,IAAI,CAUX,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * @description 재시도 대기 Promise — 타이머 만료·abort 중 먼저 발생하는 쪽에서 resolve됩니다.
+ * 어느 경로로 풀리든 타이머와 abort 리스너를 함께 정리합니다.
+ */
+var waitForRetry = function waitForRetry(delayMs, signal) {
+  return new Promise(function (resolve) {
+    var finish = function finish() {
+      clearTimeout(timer);
+      signal.removeEventListener('abort', finish);
+      resolve();
+    };
+    var timer = setTimeout(finish, delayMs);
+    signal.addEventListener('abort', finish);
+  });
+};
+
+export { waitForRetry };
+//# sourceMappingURL=retryWait.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retryWait.esm.js","sources":["../../../src/core/retryWait.ts"],"sourcesContent":["/**\n * @description 재시도 대기 Promise — 타이머 만료·abort 중 먼저 발생하는 쪽에서 resolve됩니다.\n * 어느 경로로 풀리든 타이머와 abort 리스너를 함께 정리합니다.\n */\nexport const waitForRetry = (\n  delayMs: number,\n  signal: AbortSignal\n): Promise<void> =>\n  new Promise((resolve) => {\n    const finish = () => {\n      clearTimeout(timer);\n      signal.removeEventListener('abort', finish);\n      resolve();\n    };\n\n    const timer = setTimeout(finish, delayMs);\n    signal.addEventListener('abort', finish);\n  });\n"],"names":["waitForRetry","delayMs","signal","Promise","resolve","finish","clearTimeout","timer","removeEventListener","setTimeout","addEventListener"],"mappings":"AAAA;AACA;AACA;AACA;AACO,IAAMA,YAAY,GAAG,SAAfA,YAAYA,CACvBC,OAAe,EACfC,MAAmB,EAAA;AAAA,EAAA,OAEnB,IAAIC,OAAO,CAAC,UAACC,OAAO,EAAK;AACvB,IAAA,IAAMC,MAAM,GAAG,SAATA,MAAMA,GAAS;MACnBC,YAAY,CAACC,KAAK,CAAC;AACnBL,MAAAA,MAAM,CAACM,mBAAmB,CAAC,OAAO,EAAEH,MAAM,CAAC;AAC3CD,MAAAA,OAAO,EAAE;KACV;AAED,IAAA,IAAMG,KAAK,GAAGE,UAAU,CAACJ,MAAM,EAAEJ,OAAO,CAAC;AACzCC,IAAAA,MAAM,CAACQ,gBAAgB,CAAC,OAAO,EAAEL,MAAM,CAAC;AAC1C,GAAC,CAAC;AAAA;;;;"}

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

@@ -0,0 +1,56 @@
+'use strict';
+
+/**
+ * @description 상태 전이 규칙을 명시합니다
+ */
+var TRANSITIONS = {
+  idle: {
+    connect: 'connecting',
+    disconnect: 'closed'
+  },
+  connecting: {
+    hello: 'open',
+    retryableFailure: 'reconnecting',
+    fatalFailure: 'fatal',
+    disconnect: 'closed'
+  },
+  open: {
+    retryableFailure: 'reconnecting',
+    fatalFailure: 'fatal',
+    disconnect: 'closed'
+  },
+  reconnecting: {
+    readyToRetry: 'connecting',
+    disconnect: 'closed'
+  },
+  // closed 후 재연결을 열어둔 이유: React StrictMode 재마운트가 같은 인스턴스로 connect→disconnect→connect를 수행합니다
+  closed: {
+    connect: 'connecting'
+  },
+  fatal: {
+    disconnect: 'closed'
+  }
+};
+
+/** @description 연결 상태머신 — 표에 선언된 전이만 수행하고, 전이가 일어날 때 onChange를 호출합니다 */
+var createStatusMachine = function createStatusMachine(onChange) {
+  var status = 'idle';
+  return {
+    get status() {
+      return status;
+    },
+    transition: function transition(event) {
+      var transitions = TRANSITIONS[status];
+      var next = transitions[event];
+      if (next === undefined) {
+        return false;
+      }
+      status = next;
+      onChange(next);
+      return true;
+    }
+  };
+};
+
+exports.createStatusMachine = createStatusMachine;
+//# sourceMappingURL=statusMachine.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statusMachine.cjs.js","sources":["../../../src/core/statusMachine.ts"],"sourcesContent":["import type { SseStatus } from './types';\n\nexport type TransitionEvent =\n  | 'connect'\n  | 'hello'\n  | 'retryableFailure'\n  | 'fatalFailure'\n  | 'readyToRetry'\n  | 'disconnect';\n\n/**\n * @description 상태 전이 규칙을 명시합니다\n */\nconst TRANSITIONS = {\n  idle: { connect: 'connecting', disconnect: 'closed' },\n  connecting: {\n    hello: 'open',\n    retryableFailure: 'reconnecting',\n    fatalFailure: 'fatal',\n    disconnect: 'closed',\n  },\n  open: {\n    retryableFailure: 'reconnecting',\n    fatalFailure: 'fatal',\n    disconnect: 'closed',\n  },\n  reconnecting: { readyToRetry: 'connecting', disconnect: 'closed' },\n  // closed 후 재연결을 열어둔 이유: React StrictMode 재마운트가 같은 인스턴스로 connect→disconnect→connect를 수행합니다\n  closed: { connect: 'connecting' },\n  fatal: { disconnect: 'closed' },\n} satisfies Record<SseStatus, Partial<Record<TransitionEvent, SseStatus>>>;\n\n/** @description 연결 상태머신 — 표에 선언된 전이만 수행하고, 전이가 일어날 때 onChange를 호출합니다 */\nexport const createStatusMachine = (onChange: (status: SseStatus) => void) => {\n  let status: SseStatus = 'idle';\n\n  return {\n    get status(): SseStatus {\n      return status;\n    },\n    transition: (event: TransitionEvent): boolean => {\n      const transitions: Partial<Record<TransitionEvent, SseStatus>> =\n        TRANSITIONS[status];\n      const next = transitions[event];\n      if (next === undefined) {\n        return false;\n      }\n\n      status = next;\n      onChange(next);\n      return true;\n    },\n  };\n};\n\nexport type StatusMachine = ReturnType<typeof createStatusMachine>;\n"],"names":["TRANSITIONS","idle","connect","disconnect","connecting","hello","retryableFailure","fatalFailure","open","reconnecting","readyToRetry","closed","fatal","createStatusMachine","onChange","status","transition","event","transitions","next","undefined"],"mappings":";;AAUA;AACA;AACA;AACA,IAAMA,WAAW,GAAG;AAClBC,EAAAA,IAAI,EAAE;AAAEC,IAAAA,OAAO,EAAE,YAAY;AAAEC,IAAAA,UAAU,EAAE;GAAU;AACrDC,EAAAA,UAAU,EAAE;AACVC,IAAAA,KAAK,EAAE,MAAM;AACbC,IAAAA,gBAAgB,EAAE,cAAc;AAChCC,IAAAA,YAAY,EAAE,OAAO;AACrBJ,IAAAA,UAAU,EAAE;GACb;AACDK,EAAAA,IAAI,EAAE;AACJF,IAAAA,gBAAgB,EAAE,cAAc;AAChCC,IAAAA,YAAY,EAAE,OAAO;AACrBJ,IAAAA,UAAU,EAAE;GACb;AACDM,EAAAA,YAAY,EAAE;AAAEC,IAAAA,YAAY,EAAE,YAAY;AAAEP,IAAAA,UAAU,EAAE;GAAU;AAClE;AACAQ,EAAAA,MAAM,EAAE;AAAET,IAAAA,OAAO,EAAE;GAAc;AACjCU,EAAAA,KAAK,EAAE;AAAET,IAAAA,UAAU,EAAE;AAAS;AAChC,CAA0E;;AAE1E;IACaU,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAIC,QAAqC,EAAK;EAC5E,IAAIC,MAAiB,GAAG,MAAM;EAE9B,OAAO;IACL,IAAIA,MAAMA,GAAc;AACtB,MAAA,OAAOA,MAAM;KACd;AACDC,IAAAA,UAAU,EAAE,SAAAA,UAAAA,CAACC,KAAsB,EAAc;AAC/C,MAAA,IAAMC,WAAwD,GAC5DlB,WAAW,CAACe,MAAM,CAAC;AACrB,MAAA,IAAMI,IAAI,GAAGD,WAAW,CAACD,KAAK,CAAC;MAC/B,IAAIE,IAAI,KAAKC,SAAS,EAAE;AACtB,QAAA,OAAO,KAAK;AACd;AAEAL,MAAAA,MAAM,GAAGI,IAAI;MACbL,QAAQ,CAACK,IAAI,CAAC;AACd,MAAA,OAAO,IAAI;AACb;GACD;AACH;;;;"}

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

@@ -0,0 +1,9 @@
+import type { SseStatus } from './types';
+export type TransitionEvent = 'connect' | 'hello' | 'retryableFailure' | 'fatalFailure' | 'readyToRetry' | 'disconnect';
+/** @description 연결 상태머신 — 표에 선언된 전이만 수행하고, 전이가 일어날 때 onChange를 호출합니다 */
+export declare const createStatusMachine: (onChange: (status: SseStatus) => void) => {
+    readonly status: "idle" | "connecting" | "open" | "reconnecting" | "closed" | "fatal";
+    transition: (event: TransitionEvent) => boolean;
+};
+export type StatusMachine = ReturnType<typeof createStatusMachine>;
+//# sourceMappingURL=statusMachine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statusMachine.d.ts","sourceRoot":"","sources":["../../../src/core/statusMachine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,YAAY,CAAC;AAwBjB,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,aAAc,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI;;wBAOjD,eAAe,KAAG,OAAO;CAahD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * @description 상태 전이 규칙을 명시합니다
+ */
+var TRANSITIONS = {
+  idle: {
+    connect: 'connecting',
+    disconnect: 'closed'
+  },
+  connecting: {
+    hello: 'open',
+    retryableFailure: 'reconnecting',
+    fatalFailure: 'fatal',
+    disconnect: 'closed'
+  },
+  open: {
+    retryableFailure: 'reconnecting',
+    fatalFailure: 'fatal',
+    disconnect: 'closed'
+  },
+  reconnecting: {
+    readyToRetry: 'connecting',
+    disconnect: 'closed'
+  },
+  // closed 후 재연결을 열어둔 이유: React StrictMode 재마운트가 같은 인스턴스로 connect→disconnect→connect를 수행합니다
+  closed: {
+    connect: 'connecting'
+  },
+  fatal: {
+    disconnect: 'closed'
+  }
+};
+
+/** @description 연결 상태머신 — 표에 선언된 전이만 수행하고, 전이가 일어날 때 onChange를 호출합니다 */
+var createStatusMachine = function createStatusMachine(onChange) {
+  var status = 'idle';
+  return {
+    get status() {
+      return status;
+    },
+    transition: function transition(event) {
+      var transitions = TRANSITIONS[status];
+      var next = transitions[event];
+      if (next === undefined) {
+        return false;
+      }
+      status = next;
+      onChange(next);
+      return true;
+    }
+  };
+};
+
+export { createStatusMachine };
+//# sourceMappingURL=statusMachine.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"statusMachine.esm.js","sources":["../../../src/core/statusMachine.ts"],"sourcesContent":["import type { SseStatus } from './types';\n\nexport type TransitionEvent =\n  | 'connect'\n  | 'hello'\n  | 'retryableFailure'\n  | 'fatalFailure'\n  | 'readyToRetry'\n  | 'disconnect';\n\n/**\n * @description 상태 전이 규칙을 명시합니다\n */\nconst TRANSITIONS = {\n  idle: { connect: 'connecting', disconnect: 'closed' },\n  connecting: {\n    hello: 'open',\n    retryableFailure: 'reconnecting',\n    fatalFailure: 'fatal',\n    disconnect: 'closed',\n  },\n  open: {\n    retryableFailure: 'reconnecting',\n    fatalFailure: 'fatal',\n    disconnect: 'closed',\n  },\n  reconnecting: { readyToRetry: 'connecting', disconnect: 'closed' },\n  // closed 후 재연결을 열어둔 이유: React StrictMode 재마운트가 같은 인스턴스로 connect→disconnect→connect를 수행합니다\n  closed: { connect: 'connecting' },\n  fatal: { disconnect: 'closed' },\n} satisfies Record<SseStatus, Partial<Record<TransitionEvent, SseStatus>>>;\n\n/** @description 연결 상태머신 — 표에 선언된 전이만 수행하고, 전이가 일어날 때 onChange를 호출합니다 */\nexport const createStatusMachine = (onChange: (status: SseStatus) => void) => {\n  let status: SseStatus = 'idle';\n\n  return {\n    get status(): SseStatus {\n      return status;\n    },\n    transition: (event: TransitionEvent): boolean => {\n      const transitions: Partial<Record<TransitionEvent, SseStatus>> =\n        TRANSITIONS[status];\n      const next = transitions[event];\n      if (next === undefined) {\n        return false;\n      }\n\n      status = next;\n      onChange(next);\n      return true;\n    },\n  };\n};\n\nexport type StatusMachine = ReturnType<typeof createStatusMachine>;\n"],"names":["TRANSITIONS","idle","connect","disconnect","connecting","hello","retryableFailure","fatalFailure","open","reconnecting","readyToRetry","closed","fatal","createStatusMachine","onChange","status","transition","event","transitions","next","undefined"],"mappings":"AAUA;AACA;AACA;AACA,IAAMA,WAAW,GAAG;AAClBC,EAAAA,IAAI,EAAE;AAAEC,IAAAA,OAAO,EAAE,YAAY;AAAEC,IAAAA,UAAU,EAAE;GAAU;AACrDC,EAAAA,UAAU,EAAE;AACVC,IAAAA,KAAK,EAAE,MAAM;AACbC,IAAAA,gBAAgB,EAAE,cAAc;AAChCC,IAAAA,YAAY,EAAE,OAAO;AACrBJ,IAAAA,UAAU,EAAE;GACb;AACDK,EAAAA,IAAI,EAAE;AACJF,IAAAA,gBAAgB,EAAE,cAAc;AAChCC,IAAAA,YAAY,EAAE,OAAO;AACrBJ,IAAAA,UAAU,EAAE;GACb;AACDM,EAAAA,YAAY,EAAE;AAAEC,IAAAA,YAAY,EAAE,YAAY;AAAEP,IAAAA,UAAU,EAAE;GAAU;AAClE;AACAQ,EAAAA,MAAM,EAAE;AAAET,IAAAA,OAAO,EAAE;GAAc;AACjCU,EAAAA,KAAK,EAAE;AAAET,IAAAA,UAAU,EAAE;AAAS;AAChC,CAA0E;;AAE1E;IACaU,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAIC,QAAqC,EAAK;EAC5E,IAAIC,MAAiB,GAAG,MAAM;EAE9B,OAAO;IACL,IAAIA,MAAMA,GAAc;AACtB,MAAA,OAAOA,MAAM;KACd;AACDC,IAAAA,UAAU,EAAE,SAAAA,UAAAA,CAACC,KAAsB,EAAc;AAC/C,MAAA,IAAMC,WAAwD,GAC5DlB,WAAW,CAACe,MAAM,CAAC;AACrB,MAAA,IAAMI,IAAI,GAAGD,WAAW,CAACD,KAAK,CAAC;MAC/B,IAAIE,IAAI,KAAKC,SAAS,EAAE;AACtB,QAAA,OAAO,KAAK;AACd;AAEAL,MAAAA,MAAM,GAAGI,IAAI;MACbL,QAAQ,CAACK,IAAI,CAAC;AACd,MAAA,OAAO,IAAI;AACb;GACD;AACH;;;;"}

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

@@ -0,0 +1,136 @@
+'use strict';
+
+var _defineProperty = require('@babel/runtime/helpers/defineProperty');
+var _typeof = require('@babel/runtime/helpers/typeof');
+var eventNames = require('./eventNames.cjs.js');
+var types = require('./types.cjs.js');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _defineProperty__default = /*#__PURE__*/_interopDefault(_defineProperty);
+var _typeof__default = /*#__PURE__*/_interopDefault(_typeof);
+
+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; }
+
+/**
+ * @description 스트림이 끊긴 이유.
+ * goaway는 서버가 예고하고 닫는 정상 종료라 백오프 없이 즉시 재수립하고,
+ * goaway-close는 서버가 재연결하지 말라고 한 것이라 루프를 끝냅니다.
+ */
+
+/**
+ * @description 끊김의 전말 — goaway 계열에만 페이로드가 붙습니다.
+ * 유니온으로 묶어 "outcome이 goaway일 때만 payload가 있다"를 타입이 강제하게 합니다.
+ */
+
+/**
+ * @description 한 EventSource에 리스너를 이미 건 이벤트 이름들 — 중복 부착을 막는 장부입니다.
+ * 소스가 바뀌면 리스너도 함께 사라지므로, 이 장부는 소스와 수명을 같이해야 합니다.
+ */
+
+var parsePayload = function parsePayload(event) {
+  if (typeof event.data !== 'string' || event.data === '') {
+    return undefined;
+  }
+  try {
+    return JSON.parse(event.data);
+  } catch (_unused) {
+    return event.data;
+  }
+};
+
+// 구버전 서버·잘린 프레임에서는 필드가 없거나 미지 값이 옵니다 — 아는 값만 남기고 나머지는 버립니다
+var toGoawayPayload = function toGoawayPayload(parsed) {
+  if (_typeof__default.default(parsed) !== 'object' || parsed === null) {
+    return {};
+  }
+  var _ref = parsed,
+    reason = _ref.reason,
+    action = _ref.action;
+  return _objectSpread(_objectSpread({}, types.isGoawayReason(reason) && {
+    reason: reason
+  }), types.isGoawayAction(action) && {
+    action: action
+  });
+};
+
+/**
+ * @description 도메인 이벤트 리스너를 소스에 1회 부착합니다 — SDK 예약 이벤트는 소비처로 흘리지 않습니다
+ */
+var attachDomainListener = function attachDomainListener(source, attachedEvents, type, deliver) {
+  if (attachedEvents.has(type)) {
+    return;
+  }
+  if (!eventNames.isSubscribableEvent(type)) {
+    return;
+  }
+  attachedEvents.add(type);
+  source.addEventListener(type, function (event) {
+    deliver(type, parsePayload(event));
+  });
+};
+/**
+ * @description 콜백 세계(EventSource 이벤트·타이머·abort)를 Promise 하나로 바꾸는 경계 어댑터.
+ * 아래 결말 4개 중 먼저 발생하는 것으로 정확히 한 번 끝나고, hello는 결말이 아니라 수립 신호입니다.
+ */
+var streamUntilClosed = function streamUntilClosed(source, signal, hooks) {
+  return new Promise(function (resolve) {
+    var settled = false;
+    var settle = function settle(closure, options) {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(helloTimer);
+      signal.removeEventListener('abort', onAbort);
+      if (options.notifyClosed) {
+        hooks.onClosed(closure);
+      }
+      resolve(closure.outcome);
+    };
+    var helloTimer = setTimeout(function () {
+      return settle({
+        outcome: 'error'
+      }, {
+        notifyClosed: true
+      });
+    }, hooks.helloTimeoutMs);
+    source.addEventListener(eventNames.SERVER_CONNECTION_EVENTS.goaway, function (event) {
+      var goaway = toGoawayPayload(parsePayload(event));
+      settle({
+        outcome: goaway.action === 'close' ? 'goaway-close' : 'goaway',
+        goaway: goaway
+      }, {
+        notifyClosed: true
+      });
+    });
+    source.onerror = function () {
+      return settle({
+        outcome: 'error'
+      }, {
+        notifyClosed: true
+      });
+    };
+    var onAbort = function onAbort() {
+      return settle({
+        outcome: 'error'
+      }, {
+        notifyClosed: false
+      });
+    };
+    signal.addEventListener('abort', onAbort);
+    source.addEventListener(eventNames.SERVER_CONNECTION_EVENTS.hello, function () {
+      if (settled) {
+        return;
+      }
+      if (hooks.onHello()) {
+        clearTimeout(helloTimer);
+      }
+    });
+  });
+};
+
+exports.attachDomainListener = attachDomainListener;
+exports.streamUntilClosed = streamUntilClosed;
+//# sourceMappingURL=stream.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.cjs.js","sources":["../../../src/core/stream.ts"],"sourcesContent":["import { isSubscribableEvent, SERVER_CONNECTION_EVENTS } from './eventNames';\nimport type { GoawayPayload } from './types';\nimport { isGoawayAction, isGoawayReason } from './types';\n\n/**\n * @description 스트림이 끊긴 이유.\n * goaway는 서버가 예고하고 닫는 정상 종료라 백오프 없이 즉시 재수립하고,\n * goaway-close는 서버가 재연결하지 말라고 한 것이라 루프를 끝냅니다.\n */\nexport type StreamOutcome = 'error' | 'goaway' | 'goaway-close';\n\n/**\n * @description 끊김의 전말 — goaway 계열에만 페이로드가 붙습니다.\n * 유니온으로 묶어 \"outcome이 goaway일 때만 payload가 있다\"를 타입이 강제하게 합니다.\n */\nexport type StreamClosure =\n  | { outcome: 'error' }\n  | { outcome: 'goaway' | 'goaway-close'; goaway: GoawayPayload };\n\n/**\n * @description 한 EventSource에 리스너를 이미 건 이벤트 이름들 — 중복 부착을 막는 장부입니다.\n * 소스가 바뀌면 리스너도 함께 사라지므로, 이 장부는 소스와 수명을 같이해야 합니다.\n */\nexport type AttachedEvents = Set<string>;\n\nconst parsePayload = (event: { data?: unknown }): unknown => {\n  if (typeof event.data !== 'string' || event.data === '') {\n    return undefined;\n  }\n  try {\n    return JSON.parse(event.data);\n  } catch {\n    return event.data;\n  }\n};\n\n// 구버전 서버·잘린 프레임에서는 필드가 없거나 미지 값이 옵니다 — 아는 값만 남기고 나머지는 버립니다\nconst toGoawayPayload = (parsed: unknown): GoawayPayload => {\n  if (typeof parsed !== 'object' || parsed === null) {\n    return {};\n  }\n\n  const { reason, action } = parsed as { reason?: unknown; action?: unknown };\n\n  return {\n    ...(isGoawayReason(reason) && { reason }),\n    ...(isGoawayAction(action) && { action }),\n  };\n};\n\n/**\n * @description 도메인 이벤트 리스너를 소스에 1회 부착합니다 — SDK 예약 이벤트는 소비처로 흘리지 않습니다\n */\nexport const attachDomainListener = (\n  source: EventSource,\n  attachedEvents: AttachedEvents,\n  type: string,\n  deliver: (type: string, payload: unknown) => void\n): void => {\n  if (attachedEvents.has(type)) {\n    return;\n  }\n  if (!isSubscribableEvent(type)) {\n    return;\n  }\n\n  attachedEvents.add(type);\n  source.addEventListener(type, (event) => {\n    deliver(type, parsePayload(event));\n  });\n};\n\nexport interface StreamHooks {\n  helloTimeoutMs: number;\n  /** @description hello 프레임 수신 — 수립으로 인정하면 true를 반환해 타임아웃을 해제시킵니다 */\n  onHello: () => boolean;\n  /**\n   * @description 끊김 확정 — resolve 전에 동기로 호출됩니다 (정리·상태 전이는 호출자 몫).\n   * goaway면 페이로드가 함께 옵니다: 소비처가 reason으로 안내를 정하도록 그대로 넘깁니다.\n   */\n  onClosed: (closure: StreamClosure) => void;\n}\n\n/**\n * @description 콜백 세계(EventSource 이벤트·타이머·abort)를 Promise 하나로 바꾸는 경계 어댑터.\n * 아래 결말 4개 중 먼저 발생하는 것으로 정확히 한 번 끝나고, hello는 결말이 아니라 수립 신호입니다.\n */\nexport const streamUntilClosed = (\n  source: EventSource,\n  signal: AbortSignal,\n  hooks: StreamHooks\n): Promise<StreamOutcome> =>\n  new Promise((resolve) => {\n    let settled = false;\n\n    const settle = (\n      closure: StreamClosure,\n      options: { notifyClosed: boolean }\n    ) => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      clearTimeout(helloTimer);\n      signal.removeEventListener('abort', onAbort);\n      if (options.notifyClosed) {\n        hooks.onClosed(closure);\n      }\n      resolve(closure.outcome);\n    };\n\n    const helloTimer = setTimeout(\n      () => settle({ outcome: 'error' }, { notifyClosed: true }),\n      hooks.helloTimeoutMs\n    );\n\n    source.addEventListener(SERVER_CONNECTION_EVENTS.goaway, (event) => {\n      const goaway = toGoawayPayload(parsePayload(event));\n      settle(\n        {\n          outcome: goaway.action === 'close' ? 'goaway-close' : 'goaway',\n          goaway,\n        },\n        { notifyClosed: true }\n      );\n    });\n\n    source.onerror = () => settle({ outcome: 'error' }, { notifyClosed: true });\n\n    const onAbort = () => settle({ outcome: 'error' }, { notifyClosed: false });\n    signal.addEventListener('abort', onAbort);\n\n    source.addEventListener(SERVER_CONNECTION_EVENTS.hello, () => {\n      if (settled) {\n        return;\n      }\n      if (hooks.onHello()) {\n        clearTimeout(helloTimer);\n      }\n    });\n  });\n"],"names":["parsePayload","event","data","undefined","JSON","parse","_unused","toGoawayPayload","parsed","_typeof","_ref","reason","action","_objectSpread","isGoawayReason","isGoawayAction","attachDomainListener","source","attachedEvents","type","deliver","has","isSubscribableEvent","add","addEventListener","streamUntilClosed","signal","hooks","Promise","resolve","settled","settle","closure","options","clearTimeout","helloTimer","removeEventListener","onAbort","notifyClosed","onClosed","outcome","setTimeout","helloTimeoutMs","SERVER_CONNECTION_EVENTS","goaway","onerror","hello","onHello"],"mappings":"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"}