@remember-web/sse 0.1.0-alpha.1

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

@@ -0,0 +1,42 @@
+import type { GoawayPayload } from './types';
+/**
+ * @description 스트림이 끊긴 이유.
+ * goaway는 서버가 예고하고 닫는 정상 종료라 백오프 없이 즉시 재수립하고,
+ * goaway-close는 서버가 재연결하지 말라고 한 것이라 루프를 끝냅니다.
+ */
+export type StreamOutcome = 'error' | 'goaway' | 'goaway-close';
+/**
+ * @description 끊김의 전말 — goaway 계열에만 페이로드가 붙습니다.
+ * 유니온으로 묶어 "outcome이 goaway일 때만 payload가 있다"를 타입이 강제하게 합니다.
+ */
+export type StreamClosure = {
+    outcome: 'error';
+} | {
+    outcome: 'goaway' | 'goaway-close';
+    goaway: GoawayPayload;
+};
+/**
+ * @description 한 EventSource에 리스너를 이미 건 이벤트 이름들 — 중복 부착을 막는 장부입니다.
+ * 소스가 바뀌면 리스너도 함께 사라지므로, 이 장부는 소스와 수명을 같이해야 합니다.
+ */
+export type AttachedEvents = Set<string>;
+/**
+ * @description 도메인 이벤트 리스너를 소스에 1회 부착합니다 — SDK 예약 이벤트는 소비처로 흘리지 않습니다
+ */
+export declare const attachDomainListener: (source: EventSource, attachedEvents: AttachedEvents, type: string, deliver: (type: string, payload: unknown) => void) => void;
+export interface StreamHooks {
+    helloTimeoutMs: number;
+    /** @description hello 프레임 수신 — 수립으로 인정하면 true를 반환해 타임아웃을 해제시킵니다 */
+    onHello: () => boolean;
+    /**
+     * @description 끊김 확정 — resolve 전에 동기로 호출됩니다 (정리·상태 전이는 호출자 몫).
+     * goaway면 페이로드가 함께 옵니다: 소비처가 reason으로 안내를 정하도록 그대로 넘깁니다.
+     */
+    onClosed: (closure: StreamClosure) => void;
+}
+/**
+ * @description 콜백 세계(EventSource 이벤트·타이머·abort)를 Promise 하나로 바꾸는 경계 어댑터.
+ * 아래 결말 4개 중 먼저 발생하는 것으로 정확히 한 번 끝나고, hello는 결말이 아니라 수립 신호입니다.
+ */
+export declare const streamUntilClosed: (source: EventSource, signal: AbortSignal, hooks: StreamHooks) => Promise<StreamOutcome>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACpB;IAAE,OAAO,EAAE,QAAQ,GAAG,cAAc,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AA2BzC;;GAEG;AACH,eAAO,MAAM,oBAAoB,WACvB,WAAW,wCAEb,MAAM,WACH,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,KAChD,IAYF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WACpB,WAAW,UACX,WAAW,SACZ,WAAW,KACjB,QAAQ,aAAa,CAiDpB,CAAC"}

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

@@ -0,0 +1,128 @@
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _typeof from '@babel/runtime/helpers/typeof';
+import { isSubscribableEvent, SERVER_CONNECTION_EVENTS } from './eventNames.esm.js';
+import { isGoawayReason, isGoawayAction } from './types.esm.js';
+
+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; }
+
+/**
+ * @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(parsed) !== 'object' || parsed === null) {
+    return {};
+  }
+  var _ref = parsed,
+    reason = _ref.reason,
+    action = _ref.action;
+  return _objectSpread(_objectSpread({}, isGoawayReason(reason) && {
+    reason: reason
+  }), isGoawayAction(action) && {
+    action: action
+  });
+};
+
+/**
+ * @description 도메인 이벤트 리스너를 소스에 1회 부착합니다 — SDK 예약 이벤트는 소비처로 흘리지 않습니다
+ */
+var attachDomainListener = function attachDomainListener(source, attachedEvents, type, deliver) {
+  if (attachedEvents.has(type)) {
+    return;
+  }
+  if (!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(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(SERVER_CONNECTION_EVENTS.hello, function () {
+      if (settled) {
+        return;
+      }
+      if (hooks.onHello()) {
+        clearTimeout(helloTimer);
+      }
+    });
+  });
+};
+
+export { attachDomainListener, streamUntilClosed };
+//# sourceMappingURL=stream.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.esm.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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"}

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

@@ -0,0 +1,237 @@
+'use strict';
+
+var _typeof = require('@babel/runtime/helpers/typeof');
+var _asyncToGenerator = require('@babel/runtime/helpers/asyncToGenerator');
+var _createClass = require('@babel/runtime/helpers/createClass');
+var _classCallCheck = require('@babel/runtime/helpers/classCallCheck');
+var _possibleConstructorReturn = require('@babel/runtime/helpers/possibleConstructorReturn');
+var _getPrototypeOf = require('@babel/runtime/helpers/getPrototypeOf');
+var _inherits = require('@babel/runtime/helpers/inherits');
+var _wrapNativeSuper = require('@babel/runtime/helpers/wrapNativeSuper');
+var _regeneratorRuntime = require('@babel/runtime/regenerator');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var _typeof__default = /*#__PURE__*/_interopDefault(_typeof);
+var _asyncToGenerator__default = /*#__PURE__*/_interopDefault(_asyncToGenerator);
+var _createClass__default = /*#__PURE__*/_interopDefault(_createClass);
+var _classCallCheck__default = /*#__PURE__*/_interopDefault(_classCallCheck);
+var _possibleConstructorReturn__default = /*#__PURE__*/_interopDefault(_possibleConstructorReturn);
+var _getPrototypeOf__default = /*#__PURE__*/_interopDefault(_getPrototypeOf);
+var _inherits__default = /*#__PURE__*/_interopDefault(_inherits);
+var _wrapNativeSuper__default = /*#__PURE__*/_interopDefault(_wrapNativeSuper);
+var _regeneratorRuntime__default = /*#__PURE__*/_interopDefault(_regeneratorRuntime);
+
+function _callSuper(t, o, e) { return o = _getPrototypeOf__default.default(o), _possibleConstructorReturn__default.default(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf__default.default(t).constructor) : o.apply(t, e)); }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+
+/**
+ * @description 티켓 발급 실패의 분류 — status 부재 = 네트워크성, cause = 네트워크가 아닌 실패의 출처.
+ * 워커 프로토콜이 이 객체를 그대로 실어 나르므로 직렬화 가능한 값만 담습니다.
+ */
+
+var TICKET_TIMEOUT_MS = 10000;
+var TICKET_NETWORK_FAILURE = Object.freeze({
+  ok: false,
+  error: Object.freeze({})
+});
+var TICKET_AUTH_CALLBACK_FAILURE = Object.freeze({
+  ok: false,
+  error: Object.freeze({
+    cause: 'auth_callback'
+  })
+});
+var AuthTokenError = /*#__PURE__*/function (_Error) {
+  function AuthTokenError(message, options) {
+    var _this;
+    _classCallCheck__default.default(this, AuthTokenError);
+    _this = _callSuper(this, AuthTokenError, [message, options]);
+    _this.name = 'AuthTokenError';
+    return _this;
+  }
+  _inherits__default.default(AuthTokenError, _Error);
+  return _createClass__default.default(AuthTokenError);
+}(/*#__PURE__*/_wrapNativeSuper__default.default(Error));
+var resolveAuthToken = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator__default.default(/*#__PURE__*/_regeneratorRuntime__default.default.mark(function _callee(getAuthToken) {
+    return _regeneratorRuntime__default.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _context.prev = 0;
+          _context.next = 3;
+          return getAuthToken();
+        case 3:
+          return _context.abrupt("return", _context.sent);
+        case 6:
+          _context.prev = 6;
+          _context.t0 = _context["catch"](0);
+          throw new AuthTokenError('getAuthToken threw', {
+            cause: _context.t0
+          });
+        case 9:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee, null, [[0, 6]]);
+  }));
+  return function resolveAuthToken(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+var authHeaders = function authHeaders(token) {
+  return token === null ? undefined : {
+    Authorization: "Bearer ".concat(token)
+  };
+};
+var hasTicket = function hasTicket(body) {
+  if (_typeof__default.default(body) !== 'object' || body === null) {
+    return false;
+  }
+  var _ref2 = body,
+    data = _ref2.data;
+  return _typeof__default.default(data) === 'object' && data !== null && typeof data.ticket === 'string';
+};
+
+/**
+ * @description 본문을 계약({ data: { ticket: string } } — 사내 기본 응답 스키마)으로 좁혀 값으로 돌려줍니다 —
+ * 파싱 실패(게이트웨이·프록시가 200으로 주는 HTML 등)와 형태 위반(ticket 부재)을 가르지 않습니다:
+ * 어느 쪽이든 서버가 응답한 본문 계약 위반이고, 경로 생존 증거라 status를 실어 네트워크성 연속 판정을 끊습니다.
+ * 이 분기는 stalled·fatal 어느 쪽에도 닿지 않는 유일한 침묵 실패라 warn을 남깁니다 — 서버 로그에도 흔적이
+ * 없는 실패(서버 입장에선 정상 200)여서 이 로그가 유일한 단서입니다.
+ */
+var parseTicketBody = /*#__PURE__*/function () {
+  var _ref3 = _asyncToGenerator__default.default(/*#__PURE__*/_regeneratorRuntime__default.default.mark(function _callee2(response, logger) {
+    var body;
+    return _regeneratorRuntime__default.default.wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.next = 2;
+          return response.json()["catch"](function () {
+            return null;
+          });
+        case 2:
+          body = _context2.sent;
+          if (hasTicket(body)) {
+            _context2.next = 6;
+            break;
+          }
+          logger === null || logger === void 0 || logger.warn("sse: \uD2F0\uCF13 \uC751\uB2F5(".concat(response.status, ") \uBCF8\uBB38\uC774 \uACC4\uC57D({ data: { ticket } })\uACFC \uB2E4\uB985\uB2C8\uB2E4 \u2014 \uC7AC\uC2DC\uB3C4\uB294 \uACC4\uC18D\uD569\uB2C8\uB2E4"));
+          return _context2.abrupt("return", {
+            ok: false,
+            error: {
+              status: response.status
+            }
+          });
+        case 6:
+          return _context2.abrupt("return", {
+            ok: true,
+            ticket: body.data.ticket
+          });
+        case 7:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return function parseTicketBody(_x2, _x3) {
+    return _ref3.apply(this, arguments);
+  };
+}();
+
+/**
+ * @description 연결 티켓을 발급합니다 — TTL 15s이므로 발급 즉시 연결해야 합니다
+ */
+var issueTicket = /*#__PURE__*/function () {
+  var _ref4 = _asyncToGenerator__default.default(/*#__PURE__*/_regeneratorRuntime__default.default.mark(function _callee3(options) {
+    var _options$fetch;
+    var fetchImpl, token, response, _options$logger;
+    return _regeneratorRuntime__default.default.wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          fetchImpl = (_options$fetch = options.fetch) !== null && _options$fetch !== void 0 ? _options$fetch : globalThis.fetch;
+          _context3.prev = 1;
+          _context3.next = 4;
+          return resolveAuthToken(options.getAuthToken);
+        case 4:
+          token = _context3.sent;
+          _context3.next = 7;
+          return fetchImpl("".concat(options.baseUrl, "/v1/events/ticket"), {
+            method: 'POST',
+            headers: authHeaders(token)
+          });
+        case 7:
+          response = _context3.sent;
+          if (response.ok) {
+            _context3.next = 10;
+            break;
+          }
+          return _context3.abrupt("return", {
+            ok: false,
+            error: {
+              status: response.status
+            }
+          });
+        case 10:
+          _context3.next = 12;
+          return parseTicketBody(response, options.logger);
+        case 12:
+          return _context3.abrupt("return", _context3.sent);
+        case 15:
+          _context3.prev = 15;
+          _context3.t0 = _context3["catch"](1);
+          if (!(_context3.t0 instanceof AuthTokenError)) {
+            _context3.next = 20;
+            break;
+          }
+          // 정지 결정은 SseClient 몫이지만, 로그는 원인 예외가 있는 여기서 한 번만 — 워커 경로에선 탭 스코프라 유일한 기록입니다
+          (_options$logger = options.logger) === null || _options$logger === void 0 || _options$logger.error('sse: getAuthToken이 예외를 던져 멈춥니다 — 콜백은 실패 시 null을 반환해야 합니다', _context3.t0.cause);
+          return _context3.abrupt("return", TICKET_AUTH_CALLBACK_FAILURE);
+        case 20:
+          return _context3.abrupt("return", TICKET_NETWORK_FAILURE);
+        case 21:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3, null, [[1, 15]]);
+  }));
+  return function issueTicket(_x4) {
+    return _ref4.apply(this, arguments);
+  };
+}();
+
+/**
+ * @description 티켓 발급에 시간 제한을 겁니다 — 타임아웃 이후 도착한 응답은 race가 이미 완료돼 무시됩니다
+ */
+var issueTicketWithTimeout = /*#__PURE__*/function () {
+  var _ref5 = _asyncToGenerator__default.default(/*#__PURE__*/_regeneratorRuntime__default.default.mark(function _callee4(options) {
+    var ticketTimer, ticketTimeout, result;
+    return _regeneratorRuntime__default.default.wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          ticketTimeout = new Promise(function (resolve) {
+            ticketTimer = setTimeout(function () {
+              return resolve(TICKET_NETWORK_FAILURE);
+            }, TICKET_TIMEOUT_MS);
+          });
+          _context4.next = 3;
+          return Promise.race([issueTicket(options), ticketTimeout]);
+        case 3:
+          result = _context4.sent;
+          clearTimeout(ticketTimer);
+          return _context4.abrupt("return", result);
+        case 6:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return function issueTicketWithTimeout(_x5) {
+    return _ref5.apply(this, arguments);
+  };
+}();
+
+exports.TICKET_NETWORK_FAILURE = TICKET_NETWORK_FAILURE;
+exports.TICKET_TIMEOUT_MS = TICKET_TIMEOUT_MS;
+exports.issueTicket = issueTicket;
+exports.issueTicketWithTimeout = issueTicketWithTimeout;
+//# sourceMappingURL=ticket.cjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.cjs.js","sources":["../../../src/core/ticket.ts"],"sourcesContent":["import type { FatalCause, SseClientOptions, SseLogger } from './types';\n\n// 티켓 층이 만드는 cause의 단일 원천 — fatal로 그대로 이어지므로 FatalCause의 부분집합이어야 합니다(satisfies가 강제)\nconst TICKET_FAILURE_CAUSES = [\n  'auth_callback',\n] as const satisfies readonly FatalCause[];\n\ntype TicketFailureCause = (typeof TICKET_FAILURE_CAUSES)[number];\n\n/**\n * @description 티켓 발급 실패의 분류 — status 부재 = 네트워크성, cause = 네트워크가 아닌 실패의 출처.\n * 워커 프로토콜이 이 객체를 그대로 실어 나르므로 직렬화 가능한 값만 담습니다.\n */\nexport interface TicketError {\n  status?: number;\n  // 와이어 너머의 신·구 버전이 미지 cause를 보낼 수 있습니다 — 코어는 아는 값만 동등 비교로 골라 씁니다\n  cause?: TicketFailureCause | (string & Record<never, never>);\n}\n\nexport type TicketResult =\n  | { ok: true; ticket: string }\n  | { ok: false; error: TicketError };\n\ntype ServerContractOptions = Pick<\n  SseClientOptions,\n  'baseUrl' | 'getAuthToken' | 'fetch' | 'logger'\n>;\n\nexport const TICKET_TIMEOUT_MS = 10_000;\n\nexport const TICKET_NETWORK_FAILURE: TicketResult = Object.freeze({\n  ok: false,\n  error: Object.freeze({}),\n});\n\nconst TICKET_AUTH_CALLBACK_FAILURE: TicketResult = Object.freeze({\n  ok: false,\n  error: Object.freeze({ cause: 'auth_callback' as const }),\n});\n\nclass AuthTokenError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'AuthTokenError';\n  }\n}\n\nconst resolveAuthToken = async (\n  getAuthToken: ServerContractOptions['getAuthToken']\n): Promise<string | null> => {\n  try {\n    return await getAuthToken();\n  } catch (error) {\n    throw new AuthTokenError('getAuthToken threw', { cause: error });\n  }\n};\n\nconst authHeaders = (token: string | null) =>\n  token === null ? undefined : { Authorization: `Bearer ${token}` };\n\nconst hasTicket = (body: unknown): body is { data: { ticket: string } } => {\n  if (typeof body !== 'object' || body === null) {\n    return false;\n  }\n  const { data } = body as { data?: unknown };\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    typeof (data as { ticket?: unknown }).ticket === 'string'\n  );\n};\n\n/**\n * @description 본문을 계약({ data: { ticket: string } } — 사내 기본 응답 스키마)으로 좁혀 값으로 돌려줍니다 —\n * 파싱 실패(게이트웨이·프록시가 200으로 주는 HTML 등)와 형태 위반(ticket 부재)을 가르지 않습니다:\n * 어느 쪽이든 서버가 응답한 본문 계약 위반이고, 경로 생존 증거라 status를 실어 네트워크성 연속 판정을 끊습니다.\n * 이 분기는 stalled·fatal 어느 쪽에도 닿지 않는 유일한 침묵 실패라 warn을 남깁니다 — 서버 로그에도 흔적이\n * 없는 실패(서버 입장에선 정상 200)여서 이 로그가 유일한 단서입니다.\n */\nconst parseTicketBody = async (\n  response: Response,\n  logger?: SseLogger\n): Promise<TicketResult> => {\n  const body: unknown = await response.json().catch(() => null);\n  if (!hasTicket(body)) {\n    logger?.warn(\n      `sse: 티켓 응답(${response.status}) 본문이 계약({ data: { ticket } })과 다릅니다 — 재시도는 계속합니다`\n    );\n    return { ok: false, error: { status: response.status } };\n  }\n  return { ok: true, ticket: body.data.ticket };\n};\n\n/**\n * @description 연결 티켓을 발급합니다 — TTL 15s이므로 발급 즉시 연결해야 합니다\n */\nexport const issueTicket = async (\n  options: ServerContractOptions\n): Promise<TicketResult> => {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  try {\n    const token = await resolveAuthToken(options.getAuthToken);\n    const response = await fetchImpl(`${options.baseUrl}/v1/events/ticket`, {\n      method: 'POST',\n      headers: authHeaders(token),\n    });\n\n    if (!response.ok) {\n      return { ok: false, error: { status: response.status } };\n    }\n\n    return await parseTicketBody(response, options.logger);\n  } catch (error) {\n    if (error instanceof AuthTokenError) {\n      // 정지 결정은 SseClient 몫이지만, 로그는 원인 예외가 있는 여기서 한 번만 — 워커 경로에선 탭 스코프라 유일한 기록입니다\n      options.logger?.error(\n        'sse: getAuthToken이 예외를 던져 멈춥니다 — 콜백은 실패 시 null을 반환해야 합니다',\n        error.cause\n      );\n      return TICKET_AUTH_CALLBACK_FAILURE;\n    }\n    return TICKET_NETWORK_FAILURE;\n  }\n};\n\n/**\n * @description 티켓 발급에 시간 제한을 겁니다 — 타임아웃 이후 도착한 응답은 race가 이미 완료돼 무시됩니다\n */\nexport const issueTicketWithTimeout = async (\n  options: ServerContractOptions\n): Promise<TicketResult> => {\n  let ticketTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const ticketTimeout = new Promise<TicketResult>((resolve) => {\n    ticketTimer = setTimeout(\n      () => resolve(TICKET_NETWORK_FAILURE),\n      TICKET_TIMEOUT_MS\n    );\n  });\n\n  const result = await Promise.race([issueTicket(options), ticketTimeout]);\n  clearTimeout(ticketTimer);\n\n  return result;\n};\n"],"names":["TICKET_TIMEOUT_MS","TICKET_NETWORK_FAILURE","Object","freeze","ok","error","TICKET_AUTH_CALLBACK_FAILURE","cause","AuthTokenError","_Error","message","options","_this","_classCallCheck","_callSuper","name","_inherits","_createClass","_wrapNativeSuper","Error","resolveAuthToken","_ref","_asyncToGenerator","_regeneratorRuntime","mark","_callee","getAuthToken","wrap","_callee$","_context","prev","next","abrupt","sent","t0","stop","_x","apply","arguments","authHeaders","token","undefined","Authorization","concat","hasTicket","body","_typeof","_ref2","data","ticket","parseTicketBody","_ref3","_callee2","response","logger","_callee2$","_context2","json","warn","status","_x2","_x3","issueTicket","_ref4","_callee3","_options$fetch","fetchImpl","_options$logger","_callee3$","_context3","fetch","globalThis","baseUrl","method","headers","_x4","issueTicketWithTimeout","_ref5","_callee4","ticketTimer","ticketTimeout","result","_callee4$","_context4","Promise","resolve","setTimeout","race","clearTimeout","_x5"],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+import type { SseClientOptions } from './types';
+declare const TICKET_FAILURE_CAUSES: readonly ["auth_callback"];
+type TicketFailureCause = (typeof TICKET_FAILURE_CAUSES)[number];
+/**
+ * @description 티켓 발급 실패의 분류 — status 부재 = 네트워크성, cause = 네트워크가 아닌 실패의 출처.
+ * 워커 프로토콜이 이 객체를 그대로 실어 나르므로 직렬화 가능한 값만 담습니다.
+ */
+export interface TicketError {
+    status?: number;
+    cause?: TicketFailureCause | (string & Record<never, never>);
+}
+export type TicketResult = {
+    ok: true;
+    ticket: string;
+} | {
+    ok: false;
+    error: TicketError;
+};
+type ServerContractOptions = Pick<SseClientOptions, 'baseUrl' | 'getAuthToken' | 'fetch' | 'logger'>;
+export declare const TICKET_TIMEOUT_MS = 10000;
+export declare const TICKET_NETWORK_FAILURE: TicketResult;
+/**
+ * @description 연결 티켓을 발급합니다 — TTL 15s이므로 발급 즉시 연결해야 합니다
+ */
+export declare const issueTicket: (options: ServerContractOptions) => Promise<TicketResult>;
+/**
+ * @description 티켓 발급에 시간 제한을 겁니다 — 타임아웃 이후 도착한 응답은 race가 이미 완료돼 무시됩니다
+ */
+export declare const issueTicketWithTimeout: (options: ServerContractOptions) => Promise<TicketResult>;
+export {};
+//# sourceMappingURL=ticket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../../src/core/ticket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAa,MAAM,SAAS,CAAC;AAGvE,QAAA,MAAM,qBAAqB,4BAEe,CAAC;AAE3C,KAAK,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,kBAAkB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;CAC9D;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAEtC,KAAK,qBAAqB,GAAG,IAAI,CAC/B,gBAAgB,EAChB,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAChD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,eAAO,MAAM,sBAAsB,EAAE,YAGnC,CAAC;AA4DH;;GAEG;AACH,eAAO,MAAM,WAAW,YACb,qBAAqB,KAC7B,QAAQ,YAAY,CA0BtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,YACxB,qBAAqB,KAC7B,QAAQ,YAAY,CActB,CAAC"}