@zimic/ws 0.1.0-canary.0

package/LICENSE.md

@@ -0,0 +1,16 @@
+MIT License
+
+Copyright (c) 2025-Present Zimic Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+<p align="center">
+  <img src="../../docs/zimic.png" align="center" width="100px" height="100px">
+</p>
+
+<h1 align="center">
+  @zimic/ws
+</h1>
+
+<p align="center">
+  Next-gen TypeScript-first WebSocket client and server
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@zimic/ws">npm</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://zimic.dev">Docs</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://zimic.dev/docs/examples">Examples</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://github.com/zimicjs/zimic/issues">Issues</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://github.com/orgs/zimicjs/projects/1/views/4">Roadmap</a>
+</p>
+
+<div align="center">
+
+[![CI](https://github.com/zimicjs/zimic/actions/workflows/ci.yaml/badge.svg?branch=canary)](https://github.com/zimicjs/zimic/actions/workflows/ci.yaml)&nbsp;
+[![Coverage](https://img.shields.io/badge/Coverage-100%25-31C654?labelColor=353C43)](https://github.com/zimicjs/zimic/actions)&nbsp;
+[![License](https://img.shields.io/github/license/zimicjs/zimic?color=0E69BE&label=License&labelColor=353C43)](https://github.com/zimicjs/zimic/blob/canary/LICENSE.md)&nbsp;
+[![Stars](https://img.shields.io/github/stars/zimicjs/zimic)](https://github.com/zimicjs/zimic)
+
+[![NPM Downloads - @zimic/ws](https://img.shields.io/npm/dm/@zimic/ws?style=flat&logo=npm&color=0E69BE&label=%20%40zimic%2Fws&labelColor=353C43)](https://www.npmjs.com/package/@zimic/ws)&nbsp;
+[![Bundle size - @zimic/ws](https://badgen.net/bundlephobia/minzip/@zimic/ws?color=0E69BE&labelColor=353C43&label=@zimic/ws%20min%20gzip)](https://bundlephobia.com/package/@zimic/ws)<br />
+
+</div>
+
+---
+
+`@zimic/ws` is a minimal and type-safe WebSocket client and server.
+
+> [!NOTE]
+>
+> Status: 🚧 Alpha
+
+## Highlights
+
+🚧 TODO
+
+**Learn more**:
+
+🚧 TODO

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+declare class WebSocketTimeoutError extends Error {
+    constructor(message: string);
+}
+
+declare class WebSocketCloseTimeoutError extends WebSocketTimeoutError {
+    constructor(reachedTimeout: number);
+}
+
+declare class WebSocketMessageAbortError extends WebSocketTimeoutError {
+    constructor();
+}
+
+declare class WebSocketOpenTimeoutError extends WebSocketTimeoutError {
+    constructor(reachedTimeout: number);
+}
+
+declare const brand: unique symbol;
+/**
+ * A utility type to create a branded type. This is useful for creating types that are distinct from each other even if
+ * they have the same underlying structure. It also helps the TypeScript compiler to reference the type in the generated
+ * declaration files, rather than inlining it.
+ */
+type Branded<Type, Brand extends string> = Type & {
+    [brand]?: Brand;
+};
+
+type JSON = {
+    [key: string]: JSON;
+} | JSON[] | string | number | boolean | null | undefined;
+declare namespace JSON {
+    type Loose = Record<string, any> | Loose[] | string | number | boolean | null | undefined;
+}
+/**
+ * Represents or validates a type that is compatible with JSON.
+ *
+ * **IMPORTANT**: the input of `JSONValue` and all of its internal types must be declared inline or as a type aliases
+ * (`type`). They cannot be interfaces.
+ *
+ * @example
+ *   import { type JSONValue } from '@zimic/http';
+ *
+ *   // Can be used as a standalone type:
+ *   const value: JSONValue = {
+ *     name: 'example',
+ *     tags: ['one', 'two'],
+ *   };
+ *
+ * @example
+ *   import { type JSONValue } from '@zimic/http';
+ *
+ *   // Can be used with a type argument to validate a JSON value:
+ *   type ValidJSON = JSONValue<{
+ *     id: string;
+ *     email: string;
+ *     createdAt: string;
+ *   }>;
+ *
+ *   // This results in a type error:
+ *   type InvalidJSON = JSONValue<{
+ *     id: string;
+ *     email: string;
+ *     createdAt: Date; // `Date` is not a valid JSON value.
+ *     save: () => Promise<void>; // Functions are not valid JSON values.
+ *   }>;
+ */
+type JSONValue<Type extends JSON = JSON> = Type;
+declare namespace JSONValue {
+    /** A loose version of the JSON value type. JSON objects are not strictly typed. */
+    type Loose<Type extends JSON.Loose = JSON.Loose> = Type;
+}
+declare global {
+    interface JSON {
+        readonly value: unique symbol;
+        stringify<Value>(value: Value, replacer?: ((this: any, key: string, value: Value) => any) | (number | string)[] | null, space?: string | number): JSONStringified$1<Value>;
+        parse<Value>(text: JSONStringified$1<Value>, reviver?: (this: any, key: string, value: any) => any): Value;
+    }
+}
+type JSONStringified$1<Value> = string & {
+    [JSON.value]: Value;
+};
+
+/**
+ * Represents a value stringified by `JSON.stringify`, maintaining a type reference to the original type.
+ *
+ * This type is used to validate that the expected stringified body is passed in WebSocket messages.
+ */
+type JSONStringified<Value> = JSONStringified$1<Value>;
+
+type BaseWebSocketSchema = JSONValue | string | Blob | ArrayBufferLike | ArrayBufferView;
+type WebSocketSchema<Schema extends BaseWebSocketSchema = BaseWebSocketSchema> = Branded<Schema, 'WebSocketSchema'>;
+type WebSocketMessageData<Schema extends WebSocketSchema> = Schema extends Blob ? Schema : Schema extends ArrayBufferLike ? Schema : Schema extends ArrayBufferView ? Schema : Schema extends string ? Schema : JSONStringified<Schema>;
+interface WebSocketEventMap<Schema extends WebSocketSchema> {
+    open: Event;
+    message: MessageEvent<WebSocketMessageData<Schema>>;
+    close: CloseEvent;
+    error: Event;
+}
+type WebSocketEventType<Schema extends WebSocketSchema = WebSocketSchema> = keyof WebSocketEventMap<Schema>;
+type WebSocketEvent<Schema extends WebSocketSchema = WebSocketSchema, Type extends WebSocketEventType = WebSocketEventType> = WebSocketEventMap<Schema>[Type];
+
+type WebSocketClientEventListener<Schema extends WebSocketSchema, Type extends WebSocketEventType<Schema>> = (this: WebSocketClient<Schema>, event: WebSocketEvent<Schema, Type>) => unknown;
+declare class WebSocketClient<Schema extends WebSocketSchema> implements Omit<WebSocket, `${string}EventListener` | `on${string}`> {
+    private _url;
+    private protocols?;
+    private socket?;
+    private _binaryType;
+    private _onopen;
+    private _onmessage;
+    private _onclose;
+    private _onerror;
+    private listeners;
+    constructor(_url: string, protocols?: string | string[] | undefined);
+    static CONNECTING: 0;
+    get CONNECTING(): 0;
+    static OPEN: 1;
+    get OPEN(): 1;
+    static CLOSING: 2;
+    get CLOSING(): 2;
+    static CLOSED: 3;
+    get CLOSED(): 3;
+    get binaryType(): "blob" | "arraybuffer";
+    set binaryType(value: 'blob' | 'arraybuffer');
+    get url(): string;
+    get protocol(): string;
+    get extensions(): string;
+    get readyState(): number;
+    get bufferedAmount(): number;
+    open(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    close(code?: number, reason?: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    send(data: WebSocketMessageData<Schema>): void;
+    addEventListener<Type extends WebSocketEventType<Schema>>(type: Type, listener: (this: WebSocketClient<Schema>, event: WebSocketEvent<Schema, Type>) => unknown, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<Type extends WebSocketEventType<Schema>>(type: Type, listener: (this: WebSocketClient<Schema>, event: WebSocketEvent<Schema, Type>) => unknown, options?: boolean | EventListenerOptions): void;
+    get onopen(): WebSocketClientEventListener<Schema, "open"> | null;
+    set onopen(listener: WebSocketClientEventListener<Schema, 'open'> | null);
+    get onmessage(): WebSocketClientEventListener<Schema, "message"> | null;
+    set onmessage(listener: WebSocketClientEventListener<Schema, 'message'> | null);
+    get onclose(): WebSocketClientEventListener<Schema, "close"> | null;
+    set onclose(listener: WebSocketClientEventListener<Schema, 'close'> | null);
+    get onerror(): WebSocketClientEventListener<Schema, "error"> | null;
+    set onerror(listener: WebSocketClientEventListener<Schema, 'error'> | null);
+    private setUnitaryEventListener;
+    dispatchEvent<Type extends WebSocketEventType<Schema>>(event: WebSocketEvent<Schema, Type>): boolean;
+}
+
+export { WebSocketClient, WebSocketCloseTimeoutError, WebSocketMessageAbortError, WebSocketOpenTimeoutError, WebSocketTimeoutError };

package/dist/index.js

@@ -0,0 +1,259 @@
+'use strict';
+
+var NodeWebSocket = require('ws');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var NodeWebSocket__default = /*#__PURE__*/_interopDefault(NodeWebSocket);
+
+// src/errors/WebSocketTimeoutError.ts
+var WebSocketTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WebSocketTimeoutError";
+  }
+};
+
+// src/errors/WebSocketCloseTimeoutError.ts
+var WebSocketCloseTimeoutError = class extends WebSocketTimeoutError {
+  constructor(reachedTimeout) {
+    super(`Web socket close timed out after ${reachedTimeout}ms.`);
+    this.name = "WebSocketCloseTimeoutError";
+  }
+};
+
+// src/errors/WebSocketMessageAbortError.ts
+var WebSocketMessageAbortError = class extends WebSocketTimeoutError {
+  constructor() {
+    super("Web socket message was aborted.");
+    this.name = "WebSocketMessageAbortError";
+  }
+};
+
+// src/errors/WebSocketOpenTimeoutError.ts
+var WebSocketOpenTimeoutError = class extends WebSocketTimeoutError {
+  constructor(reachedTimeout) {
+    super(`Web socket open timed out after ${reachedTimeout}ms.`);
+    this.name = "WebSocketOpenTimeoutError";
+  }
+};
+var isNativeWebSocketAvailable = typeof WebSocket !== "undefined";
+var ClientSocket = isNativeWebSocketAvailable ? WebSocket : NodeWebSocket__default.default;
+
+// src/client/utils/lifecycle.ts
+async function openClientSocket(socket, options = {}) {
+  const { timeout: timeoutDuration } = options;
+  const isAlreadyOpen = socket.readyState === socket.OPEN;
+  if (isAlreadyOpen) {
+    return;
+  }
+  await new Promise((resolve, reject) => {
+    function removeAllSocketListeners() {
+      socket.removeEventListener("open", handleOpenSuccess);
+      socket.removeEventListener("error", handleError);
+      socket.removeEventListener("close", handleError);
+    }
+    function handleError(error) {
+      removeAllSocketListeners();
+      reject(error);
+    }
+    const openTimeout = timeoutDuration === void 0 ? void 0 : setTimeout(() => {
+      const timeoutError = new WebSocketOpenTimeoutError(timeoutDuration);
+      handleError(timeoutError);
+    }, timeoutDuration);
+    function handleOpenSuccess() {
+      removeAllSocketListeners();
+      clearTimeout(openTimeout);
+      resolve();
+    }
+    socket.addEventListener("open", handleOpenSuccess);
+    socket.addEventListener("error", handleError);
+    socket.addEventListener("close", handleError);
+  });
+}
+async function closeClientSocket(socket, options = {}) {
+  const { timeout: timeoutDuration } = options;
+  const isAlreadyClosed = socket.readyState === socket.CLOSED;
+  if (isAlreadyClosed) {
+    return;
+  }
+  await new Promise((resolve, reject) => {
+    function removeAllSocketListeners() {
+      socket.removeEventListener("error", handleError);
+      socket.removeEventListener("close", handleClose);
+    }
+    function handleError(error) {
+      removeAllSocketListeners();
+      reject(error);
+    }
+    const closeTimeout = timeoutDuration === void 0 ? void 0 : setTimeout(() => {
+      const timeoutError = new WebSocketCloseTimeoutError(timeoutDuration);
+      handleError(timeoutError);
+    }, timeoutDuration);
+    function handleClose() {
+      removeAllSocketListeners();
+      clearTimeout(closeTimeout);
+      resolve();
+    }
+    socket.addEventListener("error", handleError);
+    socket.addEventListener("close", handleClose);
+    socket.close(options.code, options.reason);
+  });
+}
+
+// src/client/WebSocketClient.ts
+var WebSocketClient = class _WebSocketClient {
+  constructor(_url, protocols) {
+    this._url = _url;
+    this.protocols = protocols;
+  }
+  socket;
+  _binaryType = "blob";
+  _onopen = null;
+  _onmessage = null;
+  _onclose = null;
+  _onerror = null;
+  listeners = {
+    open: /* @__PURE__ */ new Map(),
+    message: /* @__PURE__ */ new Map(),
+    close: /* @__PURE__ */ new Map(),
+    error: /* @__PURE__ */ new Map()
+  };
+  static CONNECTING = ClientSocket.CONNECTING;
+  get CONNECTING() {
+    return _WebSocketClient.CONNECTING;
+  }
+  static OPEN = ClientSocket.OPEN;
+  get OPEN() {
+    return _WebSocketClient.OPEN;
+  }
+  static CLOSING = ClientSocket.CLOSING;
+  get CLOSING() {
+    return _WebSocketClient.CLOSING;
+  }
+  static CLOSED = ClientSocket.CLOSED;
+  get CLOSED() {
+    return _WebSocketClient.CLOSED;
+  }
+  get binaryType() {
+    return this.socket?.binaryType ?? this._binaryType;
+  }
+  set binaryType(value) {
+    this._binaryType = value;
+    if (this.socket) {
+      this.socket.binaryType = value;
+    }
+  }
+  get url() {
+    return this.socket?.url ?? this._url;
+  }
+  get protocol() {
+    return this.socket?.protocol ?? "";
+  }
+  get extensions() {
+    return this.socket?.extensions ?? "";
+  }
+  get readyState() {
+    return this.socket?.readyState ?? ClientSocket.CLOSED;
+  }
+  get bufferedAmount() {
+    return this.socket?.bufferedAmount ?? 0;
+  }
+  async open(options = {}) {
+    this.socket = new ClientSocket(this._url, this.protocols);
+    if (this.socket.binaryType !== this._binaryType) {
+      this.socket.binaryType = this._binaryType;
+    }
+    await openClientSocket(this.socket, options);
+  }
+  async close(code, reason, options = {}) {
+    if (!this.socket) {
+      return;
+    }
+    try {
+      await closeClientSocket(this.socket, { ...options, code, reason });
+    } finally {
+      this.onopen = null;
+      this.onmessage = null;
+      this.onclose = null;
+      this.onerror = null;
+      for (const [type, listenerToRawListener] of Object.entries(this.listeners)) {
+        for (const rawListener of listenerToRawListener.values()) {
+          this.socket.removeEventListener(type, rawListener);
+        }
+        listenerToRawListener.clear();
+      }
+      this.socket = void 0;
+    }
+  }
+  send(data) {
+    this.socket?.send(data);
+  }
+  addEventListener(type, listener, options) {
+    const rawListener = listener.bind(this);
+    this.socket?.addEventListener(type, rawListener, options);
+    this.listeners[type].set(listener, rawListener);
+  }
+  removeEventListener(type, listener, options) {
+    const rawListener = this.listeners[type].get(listener);
+    if (rawListener) {
+      this.socket?.removeEventListener(type, rawListener, options);
+      this.listeners[type].delete(listener);
+    }
+  }
+  get onopen() {
+    return this._onopen;
+  }
+  set onopen(listener) {
+    this.setUnitaryEventListener("open", listener);
+  }
+  get onmessage() {
+    return this._onmessage;
+  }
+  set onmessage(listener) {
+    this.setUnitaryEventListener("message", listener);
+  }
+  get onclose() {
+    return this._onclose;
+  }
+  set onclose(listener) {
+    this.setUnitaryEventListener("close", listener);
+  }
+  get onerror() {
+    return this._onerror;
+  }
+  set onerror(listener) {
+    this.setUnitaryEventListener("error", listener);
+  }
+  setUnitaryEventListener(type, listener) {
+    if (listener) {
+      const rawListener = listener.bind(this);
+      this.listeners[type].set(listener, rawListener);
+      if (this.socket) {
+        this.socket[`on${type}`] = rawListener;
+      }
+      this[`_on${type}`] = listener;
+    } else {
+      const currentListener = this[`_on${type}`];
+      if (currentListener) {
+        this.listeners[type].delete(currentListener);
+      }
+      if (this.socket) {
+        this.socket[`on${type}`] = null;
+      }
+      this[`_on${type}`] = null;
+    }
+  }
+  dispatchEvent(event) {
+    return this.socket?.dispatchEvent(event) ?? false;
+  }
+};
+var WebSocketClient_default = WebSocketClient;
+
+exports.WebSocketClient = WebSocketClient_default;
+exports.WebSocketCloseTimeoutError = WebSocketCloseTimeoutError;
+exports.WebSocketMessageAbortError = WebSocketMessageAbortError;
+exports.WebSocketOpenTimeoutError = WebSocketOpenTimeoutError;
+exports.WebSocketTimeoutError = WebSocketTimeoutError;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/WebSocketTimeoutError.ts","../src/errors/WebSocketCloseTimeoutError.ts","../src/errors/WebSocketMessageAbortError.ts","../src/errors/WebSocketOpenTimeoutError.ts","../src/client/ClientSocket.ts","../src/client/utils/lifecycle.ts","../src/client/WebSocketClient.ts"],"names":["NodeWebSocket"],"mappings":"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","file":"index.js","sourcesContent":["export class WebSocketTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'WebSocketTimeoutError';\n  }\n}\n","import { WebSocketTimeoutError } from './WebSocketTimeoutError';\n\nexport class WebSocketCloseTimeoutError extends WebSocketTimeoutError {\n  constructor(reachedTimeout: number) {\n    super(`Web socket close timed out after ${reachedTimeout}ms.`);\n    this.name = 'WebSocketCloseTimeoutError';\n  }\n}\n","import { WebSocketTimeoutError } from './WebSocketTimeoutError';\n\nexport class WebSocketMessageAbortError extends WebSocketTimeoutError {\n  constructor() {\n    super('Web socket message was aborted.');\n    this.name = 'WebSocketMessageAbortError';\n  }\n}\n","import { WebSocketTimeoutError } from './WebSocketTimeoutError';\n\nexport class WebSocketOpenTimeoutError extends WebSocketTimeoutError {\n  constructor(reachedTimeout: number) {\n    super(`Web socket open timed out after ${reachedTimeout}ms.`);\n    this.name = 'WebSocketOpenTimeoutError';\n  }\n}\n","import NodeWebSocket from 'ws';\n\n// WebSocket is available natively in browsers and Node.js >=22.\nconst isNativeWebSocketAvailable = typeof WebSocket !== 'undefined';\n\nexport const ClientSocket = (isNativeWebSocketAvailable ? WebSocket : NodeWebSocket) as typeof WebSocket;\nexport type ClientSocket = InstanceType<typeof ClientSocket>;\n","import { WebSocketCloseTimeoutError } from '@/errors/WebSocketCloseTimeoutError';\nimport { WebSocketOpenTimeoutError } from '@/errors/WebSocketOpenTimeoutError';\n\nimport { ClientSocket } from '../ClientSocket';\n\nexport async function openClientSocket(socket: ClientSocket, options: { timeout?: number } = {}) {\n  const { timeout: timeoutDuration } = options;\n\n  const isAlreadyOpen = socket.readyState === socket.OPEN;\n\n  if (isAlreadyOpen) {\n    return;\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    function removeAllSocketListeners() {\n      socket.removeEventListener('open', handleOpenSuccess); // eslint-disable-line @typescript-eslint/no-use-before-define\n      socket.removeEventListener('error', handleError); // eslint-disable-line @typescript-eslint/no-use-before-define\n      socket.removeEventListener('close', handleError); // eslint-disable-line @typescript-eslint/no-use-before-define\n    }\n\n    function handleError(error: unknown) {\n      removeAllSocketListeners();\n      reject(error);\n    }\n\n    const openTimeout =\n      timeoutDuration === undefined\n        ? undefined\n        : setTimeout(() => {\n            const timeoutError = new WebSocketOpenTimeoutError(timeoutDuration);\n            handleError(timeoutError);\n          }, timeoutDuration);\n\n    function handleOpenSuccess() {\n      removeAllSocketListeners();\n      clearTimeout(openTimeout);\n      resolve();\n    }\n\n    socket.addEventListener('open', handleOpenSuccess);\n    socket.addEventListener('error', handleError);\n    socket.addEventListener('close', handleError);\n  });\n}\n\nexport async function closeClientSocket(\n  socket: ClientSocket,\n  options: { code?: number; reason?: string; timeout?: number } = {},\n) {\n  const { timeout: timeoutDuration } = options;\n\n  const isAlreadyClosed = socket.readyState === socket.CLOSED;\n\n  if (isAlreadyClosed) {\n    return;\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    function removeAllSocketListeners() {\n      socket.removeEventListener('error', handleError); // eslint-disable-line @typescript-eslint/no-use-before-define\n      socket.removeEventListener('close', handleClose); // eslint-disable-line @typescript-eslint/no-use-before-define\n    }\n\n    function handleError(error: unknown) {\n      removeAllSocketListeners();\n      reject(error);\n    }\n\n    const closeTimeout =\n      timeoutDuration === undefined\n        ? undefined\n        : setTimeout(() => {\n            const timeoutError = new WebSocketCloseTimeoutError(timeoutDuration);\n            handleError(timeoutError);\n          }, timeoutDuration);\n\n    function handleClose() {\n      removeAllSocketListeners();\n      clearTimeout(closeTimeout);\n      resolve();\n    }\n\n    socket.addEventListener('error', handleError);\n    socket.addEventListener('close', handleClose);\n\n    socket.close(options.code, options.reason);\n  });\n}\n","import { WebSocketEvent, WebSocketEventType, WebSocketMessageData, WebSocketSchema } from '@/types/schema';\n\nimport { ClientSocket } from './ClientSocket';\nimport { closeClientSocket, openClientSocket } from './utils/lifecycle';\n\nexport type WebSocketClientEventListener<Schema extends WebSocketSchema, Type extends WebSocketEventType<Schema>> = (\n  this: WebSocketClient<Schema>,\n  event: WebSocketEvent<Schema, Type>,\n) => unknown;\n\ntype WebSocketClientRawEventListener = (this: ClientSocket, event: Event) => unknown;\n\nclass WebSocketClient<Schema extends WebSocketSchema> implements Omit<\n  WebSocket,\n  `${string}EventListener` | `on${string}`\n> {\n  private socket?: ClientSocket;\n  private _binaryType: BinaryType = 'blob';\n\n  private _onopen: WebSocketClientEventListener<Schema, 'open'> | null = null;\n  private _onmessage: WebSocketClientEventListener<Schema, 'message'> | null = null;\n  private _onclose: WebSocketClientEventListener<Schema, 'close'> | null = null;\n  private _onerror: WebSocketClientEventListener<Schema, 'error'> | null = null;\n\n  private listeners: {\n    [Type in WebSocketEventType<Schema>]: Map<\n      WebSocketClientEventListener<Schema, Type>,\n      WebSocketClientRawEventListener\n    >;\n  } = {\n    open: new Map(),\n    message: new Map(),\n    close: new Map(),\n    error: new Map(),\n  };\n\n  constructor(\n    private _url: string,\n    private protocols?: string | string[],\n  ) {}\n\n  static CONNECTING = ClientSocket.CONNECTING;\n\n  get CONNECTING() {\n    return WebSocketClient.CONNECTING;\n  }\n\n  static OPEN = ClientSocket.OPEN;\n\n  get OPEN() {\n    return WebSocketClient.OPEN;\n  }\n\n  static CLOSING = ClientSocket.CLOSING;\n\n  get CLOSING() {\n    return WebSocketClient.CLOSING;\n  }\n\n  static CLOSED = ClientSocket.CLOSED;\n\n  get CLOSED() {\n    return WebSocketClient.CLOSED;\n  }\n\n  get binaryType() {\n    return this.socket?.binaryType ?? this._binaryType;\n  }\n\n  set binaryType(value: 'blob' | 'arraybuffer') {\n    this._binaryType = value;\n\n    if (this.socket) {\n      this.socket.binaryType = value;\n    }\n  }\n\n  get url() {\n    return this.socket?.url ?? this._url;\n  }\n\n  get protocol() {\n    return this.socket?.protocol ?? '';\n  }\n\n  get extensions() {\n    return this.socket?.extensions ?? '';\n  }\n\n  get readyState() {\n    return this.socket?.readyState ?? ClientSocket.CLOSED;\n  }\n\n  get bufferedAmount() {\n    return this.socket?.bufferedAmount ?? 0;\n  }\n\n  async open(options: { timeout?: number } = {}) {\n    this.socket = new ClientSocket(this._url, this.protocols);\n\n    if (this.socket.binaryType !== this._binaryType) {\n      this.socket.binaryType = this._binaryType;\n    }\n\n    await openClientSocket(this.socket, options);\n  }\n\n  async close(code?: number, reason?: string, options: { timeout?: number } = {}) {\n    if (!this.socket) {\n      return;\n    }\n\n    try {\n      await closeClientSocket(this.socket, { ...options, code, reason });\n    } finally {\n      this.onopen = null;\n      this.onmessage = null;\n      this.onclose = null;\n      this.onerror = null;\n\n      for (const [type, listenerToRawListener] of Object.entries(this.listeners)) {\n        for (const rawListener of listenerToRawListener.values()) {\n          this.socket.removeEventListener(type, rawListener);\n        }\n\n        listenerToRawListener.clear();\n      }\n\n      this.socket = undefined;\n    }\n  }\n\n  send(data: WebSocketMessageData<Schema>) {\n    this.socket?.send(data);\n  }\n\n  addEventListener<Type extends WebSocketEventType<Schema>>(\n    type: Type,\n    listener: (this: WebSocketClient<Schema>, event: WebSocketEvent<Schema, Type>) => unknown,\n    options?: boolean | AddEventListenerOptions,\n  ) {\n    const rawListener = listener.bind(this) as WebSocketClientRawEventListener;\n\n    this.socket?.addEventListener(type, rawListener, options);\n    this.listeners[type].set(listener, rawListener);\n  }\n\n  removeEventListener<Type extends WebSocketEventType<Schema>>(\n    type: Type,\n    listener: (this: WebSocketClient<Schema>, event: WebSocketEvent<Schema, Type>) => unknown,\n    options?: boolean | EventListenerOptions,\n  ) {\n    const rawListener = this.listeners[type].get(listener);\n\n    if (rawListener) {\n      this.socket?.removeEventListener(type, rawListener, options);\n      this.listeners[type].delete(listener);\n    }\n  }\n\n  get onopen() {\n    return this._onopen;\n  }\n\n  set onopen(listener: WebSocketClientEventListener<Schema, 'open'> | null) {\n    this.setUnitaryEventListener('open', listener);\n  }\n\n  get onmessage() {\n    return this._onmessage;\n  }\n\n  set onmessage(listener: WebSocketClientEventListener<Schema, 'message'> | null) {\n    this.setUnitaryEventListener('message', listener);\n  }\n\n  get onclose() {\n    return this._onclose;\n  }\n\n  set onclose(listener: WebSocketClientEventListener<Schema, 'close'> | null) {\n    this.setUnitaryEventListener('close', listener);\n  }\n\n  get onerror() {\n    return this._onerror;\n  }\n\n  set onerror(listener: WebSocketClientEventListener<Schema, 'error'> | null) {\n    this.setUnitaryEventListener('error', listener);\n  }\n\n  private setUnitaryEventListener<Type extends WebSocketEventType<Schema>>(\n    type: Type,\n    listener: WebSocketClientEventListener<Schema, Type> | null,\n  ) {\n    type PrivateUnitaryListener = typeof listener;\n\n    if (listener) {\n      const rawListener = listener.bind(this) as WebSocketClientRawEventListener;\n      this.listeners[type].set(listener, rawListener);\n\n      if (this.socket) {\n        this.socket[`on${type}`] = rawListener;\n      }\n\n      (this[`_on${type}`] as PrivateUnitaryListener) = listener;\n    } else {\n      const currentListener = this[`_on${type}`] as PrivateUnitaryListener;\n\n      if (currentListener) {\n        this.listeners[type].delete(currentListener);\n      }\n\n      if (this.socket) {\n        this.socket[`on${type}`] = null;\n      }\n\n      (this[`_on${type}`] as PrivateUnitaryListener) = null;\n    }\n  }\n\n  dispatchEvent<Type extends WebSocketEventType<Schema>>(event: WebSocketEvent<Schema, Type>) {\n    return this.socket?.dispatchEvent(event) ?? false;\n  }\n}\n\nexport default WebSocketClient;\n"]}