@hedystia/ws 2.3.1

package/.turbo/turbo-build.log

@@ -0,0 +1,50 @@
+$ tsdown --config-loader unrun
+ℹ tsdown v0.22.0 powered by rolldown v1.0.0
+ℹ config file: /home/runner/actions-runner/_work/Hedystia/Hedystia/Packages/websocket/tsdown.config.ts (unrun)
+ℹ entry: src/index.ts, src/client.ts, src/server.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ [CJS] dist/server.cjs        7.36 kB │ gzip: 2.69 kB
+ℹ [CJS] dist/client.cjs        4.12 kB │ gzip: 1.53 kB
+ℹ [CJS] dist/index.cjs         0.87 kB │ gzip: 0.34 kB
+ℹ [CJS] dist/server.cjs.map   12.54 kB │ gzip: 4.06 kB
+ℹ [CJS] dist/client.cjs.map    5.86 kB │ gzip: 2.05 kB
+ℹ [CJS] dist/runtime.cjs.map   2.06 kB │ gzip: 0.78 kB
+ℹ [CJS] dist/runtime.cjs       1.36 kB │ gzip: 0.55 kB
+ℹ [CJS] dist/index.cjs.map     0.71 kB │ gzip: 0.33 kB
+ℹ [CJS] 8 files, total: 34.86 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `tsdown:report`. See https://rolldown.rs/options/checks#plugintimings for more details.
+
+ℹ [CJS] dist/server.d.cts   4.05 kB │ gzip: 1.65 kB
+ℹ [CJS] dist/client.d.cts   3.80 kB │ gzip: 1.40 kB
+ℹ [CJS] dist/index.d.cts    0.73 kB │ gzip: 0.27 kB
+ℹ [CJS] dist/types.d.cts    7.25 kB │ gzip: 2.64 kB
+ℹ [CJS] dist/runtime.d.cts  1.13 kB │ gzip: 0.48 kB
+ℹ [CJS] 5 files, total: 16.96 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (63%)
+  - tsdown:deps (28%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 4736ms
+ℹ [ESM] dist/server.mjs                       7.30 kB │ gzip: 2.64 kB
+ℹ [ESM] dist/client.mjs                       4.04 kB │ gzip: 1.50 kB
+ℹ [ESM] dist/index.mjs                        0.47 kB │ gzip: 0.23 kB
+ℹ [ESM] dist/server.mjs.map                  12.53 kB │ gzip: 4.05 kB
+ℹ [ESM] dist/client.mjs.map                   5.86 kB │ gzip: 2.05 kB
+ℹ [ESM] dist/runtime.mjs.map                  2.06 kB │ gzip: 0.78 kB
+ℹ [ESM] dist/runtime.mjs                      1.27 kB │ gzip: 0.53 kB
+ℹ [ESM] dist/index.mjs.map                    0.68 kB │ gzip: 0.32 kB
+ℹ [ESM] dist/_virtual/_rolldown/runtime.mjs   0.18 kB │ gzip: 0.15 kB
+ℹ [ESM] dist/server.d.mts                     4.05 kB │ gzip: 1.65 kB
+ℹ [ESM] dist/client.d.mts                     3.80 kB │ gzip: 1.40 kB
+ℹ [ESM] dist/index.d.mts                      0.73 kB │ gzip: 0.27 kB
+ℹ [ESM] dist/types.d.mts                      7.25 kB │ gzip: 2.64 kB
+ℹ [ESM] dist/runtime.d.mts                    1.13 kB │ gzip: 0.48 kB
+ℹ [ESM] 14 files, total: 51.34 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - tsdown:deps (51%)
+  - rolldown-plugin-dts:generate (39%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 4846ms

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Hedystia
+
+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/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+export { __require };

package/dist/client.cjs

@@ -0,0 +1,148 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/client.ts
+/**
+* Resolve the best `WebSocket` constructor for the current runtime.
+*
+* @remarks
+* - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.
+* - Older Node falls back to the [`ws`](https://github.com/websockets/ws)
+*   package, which mirrors the WHATWG `WebSocket` API.
+*
+* @returns A `WebSocket` constructor compatible with the WHATWG interface.
+*
+* @example
+* ```ts
+* import { resolveWebSocket } from "@hedystia/ws/client";
+*
+* const WS = resolveWebSocket();
+* const socket = new WS("ws://localhost:3000");
+* ```
+*/
+function resolveWebSocket() {
+	if (typeof globalThis !== "undefined" && globalThis.WebSocket) return globalThis.WebSocket;
+	const mod = require("ws");
+	return mod.WebSocket ?? mod;
+}
+/**
+* Create a `WebSocket` instance using the best available implementation
+* for the current runtime.
+*
+* @remarks
+* Custom request headers are honoured on Node via the `ws` package; on
+* runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,
+* browsers, Node ≥ 22) headers are ignored — matching standard semantics.
+*
+* @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+* @param options - Optional protocols / headers
+* @returns A connected (or connecting) `WebSocket` instance.
+*
+* @example
+* ```ts
+* import { createWebSocket } from "@hedystia/ws/client";
+*
+* const ws = createWebSocket("ws://localhost:3000", {
+*   protocols: "v1",
+*   headers: { authorization: "Bearer ..." },
+* });
+*
+* ws.onopen = () => ws.send("hi");
+* ws.onmessage = (event) => console.log(event.data);
+* ```
+*/
+function createWebSocket(url, options) {
+	const Ctor = resolveWebSocket();
+	if (typeof globalThis !== "undefined" && globalThis.WebSocket === Ctor) return options?.protocols ? new Ctor(url, options.protocols) : new Ctor(url);
+	const init = {};
+	if (options?.headers) init.headers = options.headers;
+	return new Ctor(url, options?.protocols, init);
+}
+/**
+* Lightweight runtime-agnostic wrapper that mirrors a small, predictable
+* subset of the WHATWG WebSocket interface.
+*
+* @remarks
+* Useful for higher-level code that wants to assign event handlers by
+* property (`socket.onmessage = ...`) without caring whether the underlying
+* implementation comes from `globalThis.WebSocket` or the `ws` package.
+*
+* @example
+* ```ts
+* import { WebSocketClient } from "@hedystia/ws/client";
+*
+* const client = new WebSocketClient("ws://localhost:3000");
+* client.onopen = () => client.send("hello");
+* client.onmessage = (event) => console.log(event.data);
+* ```
+*/
+var WebSocketClient = class {
+	/**
+	* Underlying WebSocket instance produced by {@link createWebSocket}.
+	*
+	* @readonly
+	*/
+	socket;
+	/**
+	* Create a new client and immediately initiate the connection.
+	*
+	* @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+	* @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}
+	*/
+	constructor(url, options) {
+		this.socket = createWebSocket(url, options);
+	}
+	/**
+	* Current connection state, mirroring {@link WebSocket.readyState}.
+	*
+	* @returns `0` connecting, `1` open, `2` closing, `3` closed.
+	*/
+	get readyState() {
+		return this.socket.readyState;
+	}
+	/**
+	* Send a payload to the server.
+	*
+	* @param data - WHATWG-compatible payload
+	*/
+	send(data) {
+		this.socket.send(data);
+	}
+	/**
+	* Close the underlying socket.
+	*
+	* @param code - Close code (defaults to 1000)
+	* @param reason - Optional human-readable reason
+	*/
+	close(code, reason) {
+		this.socket.close(code, reason);
+	}
+	/**
+	* Assign the open-event listener.
+	*/
+	set onopen(cb) {
+		this.socket.onopen = cb;
+	}
+	/**
+	* Assign the message-event listener.
+	*/
+	set onmessage(cb) {
+		this.socket.onmessage = cb;
+	}
+	/**
+	* Assign the close-event listener.
+	*/
+	set onclose(cb) {
+		this.socket.onclose = cb;
+	}
+	/**
+	* Assign the error-event listener.
+	*/
+	set onerror(cb) {
+		this.socket.onerror = cb;
+	}
+};
+//#endregion
+exports.WebSocketClient = WebSocketClient;
+exports.createWebSocket = createWebSocket;
+exports.resolveWebSocket = resolveWebSocket;
+
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { ClientWebSocketOptions } from \"./types\";\n\nexport type { ClientWebSocketOptions } from \"./types\";\n\n/**\n * Resolve the best `WebSocket` constructor for the current runtime.\n *\n * @remarks\n * - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.\n * - Older Node falls back to the [`ws`](https://github.com/websockets/ws)\n *   package, which mirrors the WHATWG `WebSocket` API.\n *\n * @returns A `WebSocket` constructor compatible with the WHATWG interface.\n *\n * @example\n * ```ts\n * import { resolveWebSocket } from \"@hedystia/ws/client\";\n *\n * const WS = resolveWebSocket();\n * const socket = new WS(\"ws://localhost:3000\");\n * ```\n */\nexport function resolveWebSocket(): typeof WebSocket {\n  if (typeof globalThis !== \"undefined\" && (globalThis as any).WebSocket) {\n    return (globalThis as any).WebSocket as typeof WebSocket;\n  }\n  const mod = require(\"ws\");\n  return (mod.WebSocket ?? mod) as typeof WebSocket;\n}\n\n/**\n * Create a `WebSocket` instance using the best available implementation\n * for the current runtime.\n *\n * @remarks\n * Custom request headers are honoured on Node via the `ws` package; on\n * runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,\n * browsers, Node ≥ 22) headers are ignored — matching standard semantics.\n *\n * @param url - Absolute WebSocket URL (`ws://` or `wss://`)\n * @param options - Optional protocols / headers\n * @returns A connected (or connecting) `WebSocket` instance.\n *\n * @example\n * ```ts\n * import { createWebSocket } from \"@hedystia/ws/client\";\n *\n * const ws = createWebSocket(\"ws://localhost:3000\", {\n *   protocols: \"v1\",\n *   headers: { authorization: \"Bearer ...\" },\n * });\n *\n * ws.onopen = () => ws.send(\"hi\");\n * ws.onmessage = (event) => console.log(event.data);\n * ```\n */\nexport function createWebSocket(url: string, options?: ClientWebSocketOptions): WebSocket {\n  const Ctor = resolveWebSocket();\n  const isWhatwg =\n    typeof globalThis !== \"undefined\" && (globalThis as any).WebSocket === (Ctor as any);\n\n  if (isWhatwg) {\n    return options?.protocols ? new Ctor(url, options.protocols as any) : new Ctor(url);\n  }\n\n  const init: any = {};\n  if (options?.headers) {\n    init.headers = options.headers;\n  }\n  return new (Ctor as any)(url, options?.protocols, init);\n}\n\n/**\n * Lightweight runtime-agnostic wrapper that mirrors a small, predictable\n * subset of the WHATWG WebSocket interface.\n *\n * @remarks\n * Useful for higher-level code that wants to assign event handlers by\n * property (`socket.onmessage = ...`) without caring whether the underlying\n * implementation comes from `globalThis.WebSocket` or the `ws` package.\n *\n * @example\n * ```ts\n * import { WebSocketClient } from \"@hedystia/ws/client\";\n *\n * const client = new WebSocketClient(\"ws://localhost:3000\");\n * client.onopen = () => client.send(\"hello\");\n * client.onmessage = (event) => console.log(event.data);\n * ```\n */\nexport class WebSocketClient {\n  /**\n   * Underlying WebSocket instance produced by {@link createWebSocket}.\n   *\n   * @readonly\n   */\n  readonly socket: WebSocket;\n\n  /**\n   * Create a new client and immediately initiate the connection.\n   *\n   * @param url - Absolute WebSocket URL (`ws://` or `wss://`)\n   * @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}\n   */\n  constructor(url: string, options?: ClientWebSocketOptions) {\n    this.socket = createWebSocket(url, options);\n  }\n\n  /**\n   * Current connection state, mirroring {@link WebSocket.readyState}.\n   *\n   * @returns `0` connecting, `1` open, `2` closing, `3` closed.\n   */\n  get readyState(): number {\n    return this.socket.readyState;\n  }\n\n  /**\n   * Send a payload to the server.\n   *\n   * @param data - WHATWG-compatible payload\n   */\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void {\n    this.socket.send(data as any);\n  }\n\n  /**\n   * Close the underlying socket.\n   *\n   * @param code - Close code (defaults to 1000)\n   * @param reason - Optional human-readable reason\n   */\n  close(code?: number, reason?: string): void {\n    this.socket.close(code, reason);\n  }\n\n  /**\n   * Assign the open-event listener.\n   */\n  set onopen(cb: ((ev: Event) => void) | null) {\n    (this.socket as any).onopen = cb;\n  }\n  /**\n   * Assign the message-event listener.\n   */\n  set onmessage(cb: ((ev: MessageEvent) => void) | null) {\n    (this.socket as any).onmessage = cb;\n  }\n  /**\n   * Assign the close-event listener.\n   */\n  set onclose(cb: ((ev: CloseEvent) => void) | null) {\n    (this.socket as any).onclose = cb;\n  }\n  /**\n   * Assign the error-event listener.\n   */\n  set onerror(cb: ((ev: Event) => void) | null) {\n    (this.socket as any).onerror = cb;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,mBAAqC;CACnD,IAAI,OAAO,eAAe,eAAgB,WAAmB,WAC3D,OAAQ,WAAmB;CAE7B,MAAM,MAAM,QAAQ,KAAK;CACzB,OAAQ,IAAI,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B3B,SAAgB,gBAAgB,KAAa,SAA6C;CACxF,MAAM,OAAO,kBAAkB;CAI/B,IAFE,OAAO,eAAe,eAAgB,WAAmB,cAAe,MAGxE,OAAO,SAAS,YAAY,IAAI,KAAK,KAAK,QAAQ,UAAiB,GAAG,IAAI,KAAK,IAAI;CAGrF,MAAM,OAAY,EAAE;CACpB,IAAI,SAAS,SACX,KAAK,UAAU,QAAQ;CAEzB,OAAO,IAAK,KAAa,KAAK,SAAS,WAAW,KAAK;;;;;;;;;;;;;;;;;;;;AAqBzD,IAAa,kBAAb,MAA6B;;;;;;CAM3B;;;;;;;CAQA,YAAY,KAAa,SAAkC;EACzD,KAAK,SAAS,gBAAgB,KAAK,QAAQ;;;;;;;CAQ7C,IAAI,aAAqB;EACvB,OAAO,KAAK,OAAO;;;;;;;CAQrB,KAAK,MAA+D;EAClE,KAAK,OAAO,KAAK,KAAY;;;;;;;;CAS/B,MAAM,MAAe,QAAuB;EAC1C,KAAK,OAAO,MAAM,MAAM,OAAO;;;;;CAMjC,IAAI,OAAO,IAAkC;EAC3C,KAAM,OAAe,SAAS;;;;;CAKhC,IAAI,UAAU,IAAyC;EACrD,KAAM,OAAe,YAAY;;;;;CAKnC,IAAI,QAAQ,IAAuC;EACjD,KAAM,OAAe,UAAU;;;;;CAKjC,IAAI,QAAQ,IAAkC;EAC5C,KAAM,OAAe,UAAU"}

package/dist/client.d.cts

@@ -0,0 +1,120 @@
+import { ClientWebSocketOptions } from "./types.cjs";
+
+//#region src/client.d.ts
+/**
+ * Resolve the best `WebSocket` constructor for the current runtime.
+ *
+ * @remarks
+ * - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.
+ * - Older Node falls back to the [`ws`](https://github.com/websockets/ws)
+ *   package, which mirrors the WHATWG `WebSocket` API.
+ *
+ * @returns A `WebSocket` constructor compatible with the WHATWG interface.
+ *
+ * @example
+ * ```ts
+ * import { resolveWebSocket } from "@hedystia/ws/client";
+ *
+ * const WS = resolveWebSocket();
+ * const socket = new WS("ws://localhost:3000");
+ * ```
+ */
+declare function resolveWebSocket(): typeof WebSocket;
+/**
+ * Create a `WebSocket` instance using the best available implementation
+ * for the current runtime.
+ *
+ * @remarks
+ * Custom request headers are honoured on Node via the `ws` package; on
+ * runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,
+ * browsers, Node ≥ 22) headers are ignored — matching standard semantics.
+ *
+ * @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+ * @param options - Optional protocols / headers
+ * @returns A connected (or connecting) `WebSocket` instance.
+ *
+ * @example
+ * ```ts
+ * import { createWebSocket } from "@hedystia/ws/client";
+ *
+ * const ws = createWebSocket("ws://localhost:3000", {
+ *   protocols: "v1",
+ *   headers: { authorization: "Bearer ..." },
+ * });
+ *
+ * ws.onopen = () => ws.send("hi");
+ * ws.onmessage = (event) => console.log(event.data);
+ * ```
+ */
+declare function createWebSocket(url: string, options?: ClientWebSocketOptions): WebSocket;
+/**
+ * Lightweight runtime-agnostic wrapper that mirrors a small, predictable
+ * subset of the WHATWG WebSocket interface.
+ *
+ * @remarks
+ * Useful for higher-level code that wants to assign event handlers by
+ * property (`socket.onmessage = ...`) without caring whether the underlying
+ * implementation comes from `globalThis.WebSocket` or the `ws` package.
+ *
+ * @example
+ * ```ts
+ * import { WebSocketClient } from "@hedystia/ws/client";
+ *
+ * const client = new WebSocketClient("ws://localhost:3000");
+ * client.onopen = () => client.send("hello");
+ * client.onmessage = (event) => console.log(event.data);
+ * ```
+ */
+declare class WebSocketClient {
+  /**
+   * Underlying WebSocket instance produced by {@link createWebSocket}.
+   *
+   * @readonly
+   */
+  readonly socket: WebSocket;
+  /**
+   * Create a new client and immediately initiate the connection.
+   *
+   * @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+   * @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}
+   */
+  constructor(url: string, options?: ClientWebSocketOptions);
+  /**
+   * Current connection state, mirroring {@link WebSocket.readyState}.
+   *
+   * @returns `0` connecting, `1` open, `2` closing, `3` closed.
+   */
+  get readyState(): number;
+  /**
+   * Send a payload to the server.
+   *
+   * @param data - WHATWG-compatible payload
+   */
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+  /**
+   * Close the underlying socket.
+   *
+   * @param code - Close code (defaults to 1000)
+   * @param reason - Optional human-readable reason
+   */
+  close(code?: number, reason?: string): void;
+  /**
+   * Assign the open-event listener.
+   */
+  set onopen(cb: ((ev: Event) => void) | null);
+  /**
+   * Assign the message-event listener.
+   */
+  set onmessage(cb: ((ev: MessageEvent) => void) | null);
+  /**
+   * Assign the close-event listener.
+   */
+  set onclose(cb: ((ev: CloseEvent) => void) | null);
+  /**
+   * Assign the error-event listener.
+   */
+  set onerror(cb: ((ev: Event) => void) | null);
+}
+//#endregion
+export { type ClientWebSocketOptions, WebSocketClient, createWebSocket, resolveWebSocket };
+//# sourceMappingURL=client.d.cts.map

package/dist/client.d.mts

@@ -0,0 +1,120 @@
+import { ClientWebSocketOptions } from "./types.mjs";
+
+//#region src/client.d.ts
+/**
+ * Resolve the best `WebSocket` constructor for the current runtime.
+ *
+ * @remarks
+ * - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.
+ * - Older Node falls back to the [`ws`](https://github.com/websockets/ws)
+ *   package, which mirrors the WHATWG `WebSocket` API.
+ *
+ * @returns A `WebSocket` constructor compatible with the WHATWG interface.
+ *
+ * @example
+ * ```ts
+ * import { resolveWebSocket } from "@hedystia/ws/client";
+ *
+ * const WS = resolveWebSocket();
+ * const socket = new WS("ws://localhost:3000");
+ * ```
+ */
+declare function resolveWebSocket(): typeof WebSocket;
+/**
+ * Create a `WebSocket` instance using the best available implementation
+ * for the current runtime.
+ *
+ * @remarks
+ * Custom request headers are honoured on Node via the `ws` package; on
+ * runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,
+ * browsers, Node ≥ 22) headers are ignored — matching standard semantics.
+ *
+ * @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+ * @param options - Optional protocols / headers
+ * @returns A connected (or connecting) `WebSocket` instance.
+ *
+ * @example
+ * ```ts
+ * import { createWebSocket } from "@hedystia/ws/client";
+ *
+ * const ws = createWebSocket("ws://localhost:3000", {
+ *   protocols: "v1",
+ *   headers: { authorization: "Bearer ..." },
+ * });
+ *
+ * ws.onopen = () => ws.send("hi");
+ * ws.onmessage = (event) => console.log(event.data);
+ * ```
+ */
+declare function createWebSocket(url: string, options?: ClientWebSocketOptions): WebSocket;
+/**
+ * Lightweight runtime-agnostic wrapper that mirrors a small, predictable
+ * subset of the WHATWG WebSocket interface.
+ *
+ * @remarks
+ * Useful for higher-level code that wants to assign event handlers by
+ * property (`socket.onmessage = ...`) without caring whether the underlying
+ * implementation comes from `globalThis.WebSocket` or the `ws` package.
+ *
+ * @example
+ * ```ts
+ * import { WebSocketClient } from "@hedystia/ws/client";
+ *
+ * const client = new WebSocketClient("ws://localhost:3000");
+ * client.onopen = () => client.send("hello");
+ * client.onmessage = (event) => console.log(event.data);
+ * ```
+ */
+declare class WebSocketClient {
+  /**
+   * Underlying WebSocket instance produced by {@link createWebSocket}.
+   *
+   * @readonly
+   */
+  readonly socket: WebSocket;
+  /**
+   * Create a new client and immediately initiate the connection.
+   *
+   * @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+   * @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}
+   */
+  constructor(url: string, options?: ClientWebSocketOptions);
+  /**
+   * Current connection state, mirroring {@link WebSocket.readyState}.
+   *
+   * @returns `0` connecting, `1` open, `2` closing, `3` closed.
+   */
+  get readyState(): number;
+  /**
+   * Send a payload to the server.
+   *
+   * @param data - WHATWG-compatible payload
+   */
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+  /**
+   * Close the underlying socket.
+   *
+   * @param code - Close code (defaults to 1000)
+   * @param reason - Optional human-readable reason
+   */
+  close(code?: number, reason?: string): void;
+  /**
+   * Assign the open-event listener.
+   */
+  set onopen(cb: ((ev: Event) => void) | null);
+  /**
+   * Assign the message-event listener.
+   */
+  set onmessage(cb: ((ev: MessageEvent) => void) | null);
+  /**
+   * Assign the close-event listener.
+   */
+  set onclose(cb: ((ev: CloseEvent) => void) | null);
+  /**
+   * Assign the error-event listener.
+   */
+  set onerror(cb: ((ev: Event) => void) | null);
+}
+//#endregion
+export { type ClientWebSocketOptions, WebSocketClient, createWebSocket, resolveWebSocket };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.mjs

@@ -0,0 +1,146 @@
+import { __require } from "./_virtual/_rolldown/runtime.mjs";
+//#region src/client.ts
+/**
+* Resolve the best `WebSocket` constructor for the current runtime.
+*
+* @remarks
+* - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.
+* - Older Node falls back to the [`ws`](https://github.com/websockets/ws)
+*   package, which mirrors the WHATWG `WebSocket` API.
+*
+* @returns A `WebSocket` constructor compatible with the WHATWG interface.
+*
+* @example
+* ```ts
+* import { resolveWebSocket } from "@hedystia/ws/client";
+*
+* const WS = resolveWebSocket();
+* const socket = new WS("ws://localhost:3000");
+* ```
+*/
+function resolveWebSocket() {
+	if (typeof globalThis !== "undefined" && globalThis.WebSocket) return globalThis.WebSocket;
+	const mod = __require("ws");
+	return mod.WebSocket ?? mod;
+}
+/**
+* Create a `WebSocket` instance using the best available implementation
+* for the current runtime.
+*
+* @remarks
+* Custom request headers are honoured on Node via the `ws` package; on
+* runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,
+* browsers, Node ≥ 22) headers are ignored — matching standard semantics.
+*
+* @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+* @param options - Optional protocols / headers
+* @returns A connected (or connecting) `WebSocket` instance.
+*
+* @example
+* ```ts
+* import { createWebSocket } from "@hedystia/ws/client";
+*
+* const ws = createWebSocket("ws://localhost:3000", {
+*   protocols: "v1",
+*   headers: { authorization: "Bearer ..." },
+* });
+*
+* ws.onopen = () => ws.send("hi");
+* ws.onmessage = (event) => console.log(event.data);
+* ```
+*/
+function createWebSocket(url, options) {
+	const Ctor = resolveWebSocket();
+	if (typeof globalThis !== "undefined" && globalThis.WebSocket === Ctor) return options?.protocols ? new Ctor(url, options.protocols) : new Ctor(url);
+	const init = {};
+	if (options?.headers) init.headers = options.headers;
+	return new Ctor(url, options?.protocols, init);
+}
+/**
+* Lightweight runtime-agnostic wrapper that mirrors a small, predictable
+* subset of the WHATWG WebSocket interface.
+*
+* @remarks
+* Useful for higher-level code that wants to assign event handlers by
+* property (`socket.onmessage = ...`) without caring whether the underlying
+* implementation comes from `globalThis.WebSocket` or the `ws` package.
+*
+* @example
+* ```ts
+* import { WebSocketClient } from "@hedystia/ws/client";
+*
+* const client = new WebSocketClient("ws://localhost:3000");
+* client.onopen = () => client.send("hello");
+* client.onmessage = (event) => console.log(event.data);
+* ```
+*/
+var WebSocketClient = class {
+	/**
+	* Underlying WebSocket instance produced by {@link createWebSocket}.
+	*
+	* @readonly
+	*/
+	socket;
+	/**
+	* Create a new client and immediately initiate the connection.
+	*
+	* @param url - Absolute WebSocket URL (`ws://` or `wss://`)
+	* @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}
+	*/
+	constructor(url, options) {
+		this.socket = createWebSocket(url, options);
+	}
+	/**
+	* Current connection state, mirroring {@link WebSocket.readyState}.
+	*
+	* @returns `0` connecting, `1` open, `2` closing, `3` closed.
+	*/
+	get readyState() {
+		return this.socket.readyState;
+	}
+	/**
+	* Send a payload to the server.
+	*
+	* @param data - WHATWG-compatible payload
+	*/
+	send(data) {
+		this.socket.send(data);
+	}
+	/**
+	* Close the underlying socket.
+	*
+	* @param code - Close code (defaults to 1000)
+	* @param reason - Optional human-readable reason
+	*/
+	close(code, reason) {
+		this.socket.close(code, reason);
+	}
+	/**
+	* Assign the open-event listener.
+	*/
+	set onopen(cb) {
+		this.socket.onopen = cb;
+	}
+	/**
+	* Assign the message-event listener.
+	*/
+	set onmessage(cb) {
+		this.socket.onmessage = cb;
+	}
+	/**
+	* Assign the close-event listener.
+	*/
+	set onclose(cb) {
+		this.socket.onclose = cb;
+	}
+	/**
+	* Assign the error-event listener.
+	*/
+	set onerror(cb) {
+		this.socket.onerror = cb;
+	}
+};
+//#endregion
+export { WebSocketClient, createWebSocket, resolveWebSocket };
+
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { ClientWebSocketOptions } from \"./types\";\n\nexport type { ClientWebSocketOptions } from \"./types\";\n\n/**\n * Resolve the best `WebSocket` constructor for the current runtime.\n *\n * @remarks\n * - Bun, Deno, browsers and Node ≥ 22 expose `globalThis.WebSocket`.\n * - Older Node falls back to the [`ws`](https://github.com/websockets/ws)\n *   package, which mirrors the WHATWG `WebSocket` API.\n *\n * @returns A `WebSocket` constructor compatible with the WHATWG interface.\n *\n * @example\n * ```ts\n * import { resolveWebSocket } from \"@hedystia/ws/client\";\n *\n * const WS = resolveWebSocket();\n * const socket = new WS(\"ws://localhost:3000\");\n * ```\n */\nexport function resolveWebSocket(): typeof WebSocket {\n  if (typeof globalThis !== \"undefined\" && (globalThis as any).WebSocket) {\n    return (globalThis as any).WebSocket as typeof WebSocket;\n  }\n  const mod = require(\"ws\");\n  return (mod.WebSocket ?? mod) as typeof WebSocket;\n}\n\n/**\n * Create a `WebSocket` instance using the best available implementation\n * for the current runtime.\n *\n * @remarks\n * Custom request headers are honoured on Node via the `ws` package; on\n * runtimes that ship a WHATWG-compliant global `WebSocket` (Bun, Deno,\n * browsers, Node ≥ 22) headers are ignored — matching standard semantics.\n *\n * @param url - Absolute WebSocket URL (`ws://` or `wss://`)\n * @param options - Optional protocols / headers\n * @returns A connected (or connecting) `WebSocket` instance.\n *\n * @example\n * ```ts\n * import { createWebSocket } from \"@hedystia/ws/client\";\n *\n * const ws = createWebSocket(\"ws://localhost:3000\", {\n *   protocols: \"v1\",\n *   headers: { authorization: \"Bearer ...\" },\n * });\n *\n * ws.onopen = () => ws.send(\"hi\");\n * ws.onmessage = (event) => console.log(event.data);\n * ```\n */\nexport function createWebSocket(url: string, options?: ClientWebSocketOptions): WebSocket {\n  const Ctor = resolveWebSocket();\n  const isWhatwg =\n    typeof globalThis !== \"undefined\" && (globalThis as any).WebSocket === (Ctor as any);\n\n  if (isWhatwg) {\n    return options?.protocols ? new Ctor(url, options.protocols as any) : new Ctor(url);\n  }\n\n  const init: any = {};\n  if (options?.headers) {\n    init.headers = options.headers;\n  }\n  return new (Ctor as any)(url, options?.protocols, init);\n}\n\n/**\n * Lightweight runtime-agnostic wrapper that mirrors a small, predictable\n * subset of the WHATWG WebSocket interface.\n *\n * @remarks\n * Useful for higher-level code that wants to assign event handlers by\n * property (`socket.onmessage = ...`) without caring whether the underlying\n * implementation comes from `globalThis.WebSocket` or the `ws` package.\n *\n * @example\n * ```ts\n * import { WebSocketClient } from \"@hedystia/ws/client\";\n *\n * const client = new WebSocketClient(\"ws://localhost:3000\");\n * client.onopen = () => client.send(\"hello\");\n * client.onmessage = (event) => console.log(event.data);\n * ```\n */\nexport class WebSocketClient {\n  /**\n   * Underlying WebSocket instance produced by {@link createWebSocket}.\n   *\n   * @readonly\n   */\n  readonly socket: WebSocket;\n\n  /**\n   * Create a new client and immediately initiate the connection.\n   *\n   * @param url - Absolute WebSocket URL (`ws://` or `wss://`)\n   * @param options - Optional protocols / headers, see {@link ClientWebSocketOptions}\n   */\n  constructor(url: string, options?: ClientWebSocketOptions) {\n    this.socket = createWebSocket(url, options);\n  }\n\n  /**\n   * Current connection state, mirroring {@link WebSocket.readyState}.\n   *\n   * @returns `0` connecting, `1` open, `2` closing, `3` closed.\n   */\n  get readyState(): number {\n    return this.socket.readyState;\n  }\n\n  /**\n   * Send a payload to the server.\n   *\n   * @param data - WHATWG-compatible payload\n   */\n  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void {\n    this.socket.send(data as any);\n  }\n\n  /**\n   * Close the underlying socket.\n   *\n   * @param code - Close code (defaults to 1000)\n   * @param reason - Optional human-readable reason\n   */\n  close(code?: number, reason?: string): void {\n    this.socket.close(code, reason);\n  }\n\n  /**\n   * Assign the open-event listener.\n   */\n  set onopen(cb: ((ev: Event) => void) | null) {\n    (this.socket as any).onopen = cb;\n  }\n  /**\n   * Assign the message-event listener.\n   */\n  set onmessage(cb: ((ev: MessageEvent) => void) | null) {\n    (this.socket as any).onmessage = cb;\n  }\n  /**\n   * Assign the close-event listener.\n   */\n  set onclose(cb: ((ev: CloseEvent) => void) | null) {\n    (this.socket as any).onclose = cb;\n  }\n  /**\n   * Assign the error-event listener.\n   */\n  set onerror(cb: ((ev: Event) => void) | null) {\n    (this.socket as any).onerror = cb;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,mBAAqC;CACnD,IAAI,OAAO,eAAe,eAAgB,WAAmB,WAC3D,OAAQ,WAAmB;CAE7B,MAAM,MAAA,UAAc,KAAK;CACzB,OAAQ,IAAI,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B3B,SAAgB,gBAAgB,KAAa,SAA6C;CACxF,MAAM,OAAO,kBAAkB;CAI/B,IAFE,OAAO,eAAe,eAAgB,WAAmB,cAAe,MAGxE,OAAO,SAAS,YAAY,IAAI,KAAK,KAAK,QAAQ,UAAiB,GAAG,IAAI,KAAK,IAAI;CAGrF,MAAM,OAAY,EAAE;CACpB,IAAI,SAAS,SACX,KAAK,UAAU,QAAQ;CAEzB,OAAO,IAAK,KAAa,KAAK,SAAS,WAAW,KAAK;;;;;;;;;;;;;;;;;;;;AAqBzD,IAAa,kBAAb,MAA6B;;;;;;CAM3B;;;;;;;CAQA,YAAY,KAAa,SAAkC;EACzD,KAAK,SAAS,gBAAgB,KAAK,QAAQ;;;;;;;CAQ7C,IAAI,aAAqB;EACvB,OAAO,KAAK,OAAO;;;;;;;CAQrB,KAAK,MAA+D;EAClE,KAAK,OAAO,KAAK,KAAY;;;;;;;;CAS/B,MAAM,MAAe,QAAuB;EAC1C,KAAK,OAAO,MAAM,MAAM,OAAO;;;;;CAMjC,IAAI,OAAO,IAAkC;EAC3C,KAAM,OAAe,SAAS;;;;;CAKhC,IAAI,UAAU,IAAyC;EACrD,KAAM,OAAe,YAAY;;;;;CAKnC,IAAI,QAAQ,IAAuC;EACjD,KAAM,OAAe,UAAU;;;;;CAKjC,IAAI,QAAQ,IAAkC;EAC5C,KAAM,OAAe,UAAU"}

package/dist/index.cjs

@@ -0,0 +1,22 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_client = require("./client.cjs");
+const require_runtime = require("./runtime.cjs");
+const require_server = require("./server.cjs");
+//#region src/index.ts
+var src_default = require_server.WebSocketServer;
+//#endregion
+exports.WebSocketClient = require_client.WebSocketClient;
+exports.WebSocketServer = require_server.WebSocketServer;
+exports.createWebSocket = require_client.createWebSocket;
+exports.default = src_default;
+exports.detectRuntime = require_runtime.detectRuntime;
+exports.isBrowser = require_runtime.isBrowser;
+exports.isBun = require_runtime.isBun;
+exports.isDeno = require_runtime.isDeno;
+exports.isNode = require_runtime.isNode;
+exports.resolveWebSocket = require_client.resolveWebSocket;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["WebSocketServer"],"sources":["../src/index.ts"],"sourcesContent":["export type { ClientWebSocketOptions } from \"./client\";\nexport { createWebSocket, resolveWebSocket, WebSocketClient } from \"./client\";\nexport type { Runtime } from \"./runtime\";\nexport { detectRuntime, isBrowser, isBun, isDeno, isNode } from \"./runtime\";\nexport type {\n  ServerWebSocket,\n  UpgradeOptions,\n  UpgradeRequest,\n  WebSocketHandlers,\n  WebSocketServerOptions,\n  WSData,\n  WSMessage,\n} from \"./server\";\n\nimport { WebSocketServer } from \"./server\";\n\nexport { WebSocketServer };\n\nexport default WebSocketServer;\n"],"mappings":";;;;;;;;AAkBA,IAAA,cAAeA,eAAAA"}

package/dist/index.d.cts

@@ -0,0 +1,5 @@
+import { ClientWebSocketOptions, ServerWebSocket, UpgradeOptions, UpgradeRequest, WSData, WSMessage, WebSocketHandlers, WebSocketServerOptions } from "./types.cjs";
+import { WebSocketClient, createWebSocket, resolveWebSocket } from "./client.cjs";
+import { Runtime, detectRuntime, isBrowser, isBun, isDeno, isNode } from "./runtime.cjs";
+import { WebSocketServer } from "./server.cjs";
+export { type ClientWebSocketOptions, type Runtime, type ServerWebSocket, type UpgradeOptions, type UpgradeRequest, type WSData, type WSMessage, WebSocketClient, type WebSocketHandlers, WebSocketServer, WebSocketServer as default, type WebSocketServerOptions, createWebSocket, detectRuntime, isBrowser, isBun, isDeno, isNode, resolveWebSocket };