{"version":3,"file":"WebSocketStream.mjs","sources":["../../../src/api/WebSocketStream.ts"],"sourcesContent":["// https://github.com/CarterLi/websocketstream-polyfill\nimport { ConnectionError } from '../room/errors';\nimport { sleep } from '../room/utils';\nimport TypedPromise from '../utils/TypedPromise';\nimport { getErrorDescription } from './utils';\n\nexport interface WebSocketConnection<T extends ArrayBuffer | string = ArrayBuffer | string> {\n  readable: ReadableStream<T>;\n  writable: WritableStream<T>;\n  protocol: string;\n  extensions: string;\n}\n\nexport interface WebSocketCloseInfo {\n  closeCode?: number;\n  reason?: string;\n}\n\nexport interface WebSocketStreamOptions {\n  protocols?: string[];\n  signal?: AbortSignal;\n}\n\ntype WebsocketError = ReturnType<typeof ConnectionError.websocket>;\n\n/**\n * [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) with [Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API)\n *\n * @see https://web.dev/websocketstream/\n */\nexport class WebSocketStream<T extends ArrayBuffer | string = ArrayBuffer | string> {\n  readonly url: string;\n\n  readonly opened: TypedPromise<WebSocketConnection<T>, WebsocketError>;\n\n  readonly closed: TypedPromise<WebSocketCloseInfo, WebsocketError>;\n\n  readonly close: (closeInfo?: WebSocketCloseInfo) => void;\n\n  get readyState(): number {\n    return this.ws.readyState;\n  }\n\n  private ws: WebSocket;\n\n  constructor(url: string, options: WebSocketStreamOptions = {}) {\n    if (options.signal?.aborted) {\n      throw new DOMException('This operation was aborted', 'AbortError');\n    }\n\n    this.url = url;\n\n    const ws = new WebSocket(url, options.protocols ?? []);\n    ws.binaryType = 'arraybuffer';\n    this.ws = ws;\n\n    // React Native has non spec-compliant behavior on close() before open:\n    // iOS sends only `close`, and only once the TCP connect settles.\n    // Android ignores the close and will open the socket anyway.\n    // To fix this, close() before open rejects `opened` immediately.\n    let closeRequested: WebSocketCloseInfo | undefined;\n    let rejectOpened!: (error: WebsocketError) => void;\n\n    const closeWithInfo = (closeInfo: WebSocketCloseInfo = {}) => {\n      if (ws.readyState === WebSocket.CONNECTING) {\n        closeRequested = closeInfo;\n        rejectOpened(ConnectionError.websocket('Websocket closed before the connection opened'));\n      }\n      const { closeCode: code, reason } = closeInfo;\n      ws.close(code, reason === undefined ? undefined : truncateCloseReason(reason));\n    };\n\n    this.opened = new TypedPromise<WebSocketConnection<T>, WebsocketError>((resolve, reject) => {\n      rejectOpened = reject;\n      const rejectHandler = () => {\n        reject(\n          ConnectionError.websocket('Encountered websocket error during connection establishment'),\n        );\n      };\n      // Some WebSocket implementations (React Native on iOS, for one) report a handshake that ends\n      // before the socket opens as a bare `close` event with no `error` before it. Without this\n      // handler `opened` would stay pending forever in that case.\n      const closeBeforeOpenHandler = (ev: CloseEvent) => {\n        reject(\n          ConnectionError.websocket(\n            `Websocket closed during connection establishment with code ${ev.code}${\n              ev.reason ? `: ${ev.reason}` : ''\n            }`,\n          ),\n        );\n      };\n      ws.onopen = () => {\n        if (closeRequested) {\n          // React Native on Android ignored the close() and opened the socket anyway\n          closeWithInfo(closeRequested);\n          return;\n        }\n        resolve({\n          readable: new ReadableStream<T>({\n            start(controller) {\n              ws.onmessage = ({ data }) => {\n                // workaround for RN behavior, browsers drop these messages already\n                if (ws.readyState === WebSocket.OPEN) {\n                  controller.enqueue(data);\n                }\n              };\n              ws.onerror = (e) =>\n                controller.error(ConnectionError.websocket(getErrorDescription(e, 'websocket')));\n              ws.onclose = (ev) => {\n                if (ev.wasClean || ev.code === 1000) {\n                  controller.close();\n                } else {\n                  controller.error(\n                    ConnectionError.websocket(`WS closed unexpectedly with code ${ev.code}`),\n                  );\n                }\n              };\n            },\n            cancel: closeWithInfo,\n          }),\n          writable: new WritableStream<T>({\n            write(chunk) {\n              ws.send(chunk);\n            },\n            abort() {\n              ws.close();\n            },\n            close: closeWithInfo,\n          }),\n          protocol: ws.protocol,\n          extensions: ws.extensions,\n        });\n        ws.removeEventListener('error', rejectHandler);\n        ws.removeEventListener('close', closeBeforeOpenHandler);\n      };\n      ws.addEventListener('error', rejectHandler);\n      ws.addEventListener('close', closeBeforeOpenHandler);\n    });\n\n    this.closed = new TypedPromise<WebSocketCloseInfo, WebsocketError>((resolve, reject) => {\n      const rejectHandler = async () => {\n        const closePromise = new TypedPromise<CloseEvent, never>((res) => {\n          if (ws.readyState === WebSocket.CLOSED) return;\n          else {\n            ws.addEventListener(\n              'close',\n              (closeEv: CloseEvent) => {\n                res(closeEv);\n              },\n              { once: true },\n            );\n          }\n        });\n        const reason = await TypedPromise.race([sleep(250), closePromise]);\n        if (!reason) {\n          reject(\n            ConnectionError.websocket(\n              'Encountered unspecified websocket error without a timely close event',\n            ),\n          );\n        } else {\n          // if we can infer the close reason from the close event then resolve the promise, we don't need to throw\n          resolve(reason);\n        }\n      };\n      ws.addEventListener('close', ({ code, reason }) => {\n        resolve({ closeCode: code, reason });\n        ws.removeEventListener('error', rejectHandler);\n      });\n\n      ws.addEventListener('error', rejectHandler);\n    });\n\n    if (options.signal) {\n      options.signal.onabort = () => closeWithInfo();\n    }\n\n    this.close = closeWithInfo;\n  }\n}\n\n/** `WebSocket.close` throws a `SyntaxError` for a reason longer than this many UTF-8 bytes. */\nconst MAX_CLOSE_REASON_BYTES = 123;\n\nexport function truncateCloseReason(reason: string): string {\n  const encoder = new TextEncoder();\n  if (encoder.encode(reason).length <= MAX_CLOSE_REASON_BYTES) {\n    return reason;\n  }\n  // cut on code point boundaries, so a multi-byte character is never split\n  let truncated = '';\n  let bytes = 0;\n  for (const char of reason) {\n    bytes += encoder.encode(char).length;\n    if (bytes > MAX_CLOSE_REASON_BYTES) {\n      break;\n    }\n    truncated += char;\n  }\n  return truncated;\n}\n"],"names":["WebSocketStream","readyState","ws","constructor","url","options","arguments","length","undefined","signal","_a","aborted","DOMException","WebSocket","_b","protocols","binaryType","closeRequested","rejectOpened","closeWithInfo","closeInfo","CONNECTING","ConnectionError","websocket","code","closeCode","reason","close","truncateCloseReason","opened","TypedPromise","resolve","reject","rejectHandler","closeBeforeOpenHandler","ev","concat","onopen","readable","ReadableStream","start","controller","onmessage","_ref","data","OPEN","enqueue","onerror","e","error","getErrorDescription","onclose","wasClean","cancel","writable","WritableStream","write","chunk","send","abort","protocol","extensions","removeEventListener","addEventListener","closed","__awaiter","closePromise","res","CLOSED","closeEv","once","race","sleep","_ref2","onabort","MAX_CLOSE_REASON_BYTES","encoder","TextEncoder","encode","truncated","bytes","char"],"mappings":"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"}