@hedystia/ws 2.3.1

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { ClientWebSocketOptions, ServerWebSocket, UpgradeOptions, UpgradeRequest, WSData, WSMessage, WebSocketHandlers, WebSocketServerOptions } from "./types.mjs";
+import { WebSocketClient, createWebSocket, resolveWebSocket } from "./client.mjs";
+import { Runtime, detectRuntime, isBrowser, isBun, isDeno, isNode } from "./runtime.mjs";
+import { WebSocketServer } from "./server.mjs";
+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 };

package/dist/index.mjs

@@ -0,0 +1,9 @@
+import { WebSocketClient, createWebSocket, resolveWebSocket } from "./client.mjs";
+import { detectRuntime, isBrowser, isBun, isDeno, isNode } from "./runtime.mjs";
+import { WebSocketServer } from "./server.mjs";
+//#region src/index.ts
+var src_default = WebSocketServer;
+//#endregion
+export { WebSocketClient, WebSocketServer, createWebSocket, src_default as default, detectRuntime, isBrowser, isBun, isDeno, isNode, resolveWebSocket };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"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,cAAe"}

package/dist/runtime.cjs

@@ -0,0 +1,56 @@
+//#region src/runtime.ts
+/**
+* Detect the host runtime by probing well-known globals.
+*
+* @returns A {@link Runtime} discriminator for the active environment.
+*
+* @example
+* ```ts
+* import { detectRuntime } from "@hedystia/ws";
+*
+* if (detectRuntime() === "bun") {
+*   // ...use Bun-specific APIs
+* }
+* ```
+*/
+function detectRuntime() {
+	if (typeof globalThis === "undefined") return "unknown";
+	const g = globalThis;
+	if (g.Bun?.serve) return "bun";
+	if (g.Deno) return "deno";
+	if (g.process?.versions?.node) return "node";
+	if (typeof g.window !== "undefined" && typeof g.document !== "undefined") return "browser";
+	return "unknown";
+}
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Bun.
+*/
+const isBun = () => detectRuntime() === "bun";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Node.js.
+*/
+const isNode = () => detectRuntime() === "node";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Deno.
+*/
+const isDeno = () => detectRuntime() === "deno";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running inside a browser-like environment.
+*/
+const isBrowser = () => detectRuntime() === "browser";
+//#endregion
+exports.detectRuntime = detectRuntime;
+exports.isBrowser = isBrowser;
+exports.isBun = isBun;
+exports.isDeno = isDeno;
+exports.isNode = isNode;
+
+//# sourceMappingURL=runtime.cjs.map

package/dist/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.cjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["/**\n * String identifier of the JavaScript runtime hosting the current process.\n */\nexport type Runtime = \"bun\" | \"node\" | \"deno\" | \"browser\" | \"unknown\";\n\n/**\n * Detect the host runtime by probing well-known globals.\n *\n * @returns A {@link Runtime} discriminator for the active environment.\n *\n * @example\n * ```ts\n * import { detectRuntime } from \"@hedystia/ws\";\n *\n * if (detectRuntime() === \"bun\") {\n *   // ...use Bun-specific APIs\n * }\n * ```\n */\nexport function detectRuntime(): Runtime {\n  if (typeof globalThis === \"undefined\") {\n    return \"unknown\";\n  }\n  const g = globalThis as any;\n  if (g.Bun?.serve) {\n    return \"bun\";\n  }\n  if (g.Deno) {\n    return \"deno\";\n  }\n  if (g.process?.versions?.node) {\n    return \"node\";\n  }\n  if (typeof g.window !== \"undefined\" && typeof g.document !== \"undefined\") {\n    return \"browser\";\n  }\n  return \"unknown\";\n}\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Bun.\n */\nexport const isBun = (): boolean => detectRuntime() === \"bun\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Node.js.\n */\nexport const isNode = (): boolean => detectRuntime() === \"node\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Deno.\n */\nexport const isDeno = (): boolean => detectRuntime() === \"deno\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running inside a browser-like environment.\n */\nexport const isBrowser = (): boolean => detectRuntime() === \"browser\";\n"],"mappings":";;;;;;;;;;;;;;;AAmBA,SAAgB,gBAAyB;CACvC,IAAI,OAAO,eAAe,aACxB,OAAO;CAET,MAAM,IAAI;CACV,IAAI,EAAE,KAAK,OACT,OAAO;CAET,IAAI,EAAE,MACJ,OAAO;CAET,IAAI,EAAE,SAAS,UAAU,MACvB,OAAO;CAET,IAAI,OAAO,EAAE,WAAW,eAAe,OAAO,EAAE,aAAa,aAC3D,OAAO;CAET,OAAO;;;;;;;AAQT,MAAa,cAAuB,eAAe,KAAK;;;;;;AAOxD,MAAa,eAAwB,eAAe,KAAK;;;;;;AAOzD,MAAa,eAAwB,eAAe,KAAK;;;;;;AAOzD,MAAa,kBAA2B,eAAe,KAAK"}

package/dist/runtime.d.cts

@@ -0,0 +1,47 @@
+//#region src/runtime.d.ts
+/**
+ * String identifier of the JavaScript runtime hosting the current process.
+ */
+type Runtime = "bun" | "node" | "deno" | "browser" | "unknown";
+/**
+ * Detect the host runtime by probing well-known globals.
+ *
+ * @returns A {@link Runtime} discriminator for the active environment.
+ *
+ * @example
+ * ```ts
+ * import { detectRuntime } from "@hedystia/ws";
+ *
+ * if (detectRuntime() === "bun") {
+ *   // ...use Bun-specific APIs
+ * }
+ * ```
+ */
+declare function detectRuntime(): Runtime;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Bun.
+ */
+declare const isBun: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Node.js.
+ */
+declare const isNode: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Deno.
+ */
+declare const isDeno: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running inside a browser-like environment.
+ */
+declare const isBrowser: () => boolean;
+//#endregion
+export { Runtime, detectRuntime, isBrowser, isBun, isDeno, isNode };
+//# sourceMappingURL=runtime.d.cts.map

package/dist/runtime.d.mts

@@ -0,0 +1,47 @@
+//#region src/runtime.d.ts
+/**
+ * String identifier of the JavaScript runtime hosting the current process.
+ */
+type Runtime = "bun" | "node" | "deno" | "browser" | "unknown";
+/**
+ * Detect the host runtime by probing well-known globals.
+ *
+ * @returns A {@link Runtime} discriminator for the active environment.
+ *
+ * @example
+ * ```ts
+ * import { detectRuntime } from "@hedystia/ws";
+ *
+ * if (detectRuntime() === "bun") {
+ *   // ...use Bun-specific APIs
+ * }
+ * ```
+ */
+declare function detectRuntime(): Runtime;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Bun.
+ */
+declare const isBun: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Node.js.
+ */
+declare const isNode: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running on Deno.
+ */
+declare const isDeno: () => boolean;
+/**
+ * Convenience predicate.
+ *
+ * @returns `true` when running inside a browser-like environment.
+ */
+declare const isBrowser: () => boolean;
+//#endregion
+export { Runtime, detectRuntime, isBrowser, isBun, isDeno, isNode };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.mjs

@@ -0,0 +1,52 @@
+//#region src/runtime.ts
+/**
+* Detect the host runtime by probing well-known globals.
+*
+* @returns A {@link Runtime} discriminator for the active environment.
+*
+* @example
+* ```ts
+* import { detectRuntime } from "@hedystia/ws";
+*
+* if (detectRuntime() === "bun") {
+*   // ...use Bun-specific APIs
+* }
+* ```
+*/
+function detectRuntime() {
+	if (typeof globalThis === "undefined") return "unknown";
+	const g = globalThis;
+	if (g.Bun?.serve) return "bun";
+	if (g.Deno) return "deno";
+	if (g.process?.versions?.node) return "node";
+	if (typeof g.window !== "undefined" && typeof g.document !== "undefined") return "browser";
+	return "unknown";
+}
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Bun.
+*/
+const isBun = () => detectRuntime() === "bun";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Node.js.
+*/
+const isNode = () => detectRuntime() === "node";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running on Deno.
+*/
+const isDeno = () => detectRuntime() === "deno";
+/**
+* Convenience predicate.
+*
+* @returns `true` when running inside a browser-like environment.
+*/
+const isBrowser = () => detectRuntime() === "browser";
+//#endregion
+export { detectRuntime, isBrowser, isBun, isDeno, isNode };
+
+//# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["/**\n * String identifier of the JavaScript runtime hosting the current process.\n */\nexport type Runtime = \"bun\" | \"node\" | \"deno\" | \"browser\" | \"unknown\";\n\n/**\n * Detect the host runtime by probing well-known globals.\n *\n * @returns A {@link Runtime} discriminator for the active environment.\n *\n * @example\n * ```ts\n * import { detectRuntime } from \"@hedystia/ws\";\n *\n * if (detectRuntime() === \"bun\") {\n *   // ...use Bun-specific APIs\n * }\n * ```\n */\nexport function detectRuntime(): Runtime {\n  if (typeof globalThis === \"undefined\") {\n    return \"unknown\";\n  }\n  const g = globalThis as any;\n  if (g.Bun?.serve) {\n    return \"bun\";\n  }\n  if (g.Deno) {\n    return \"deno\";\n  }\n  if (g.process?.versions?.node) {\n    return \"node\";\n  }\n  if (typeof g.window !== \"undefined\" && typeof g.document !== \"undefined\") {\n    return \"browser\";\n  }\n  return \"unknown\";\n}\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Bun.\n */\nexport const isBun = (): boolean => detectRuntime() === \"bun\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Node.js.\n */\nexport const isNode = (): boolean => detectRuntime() === \"node\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running on Deno.\n */\nexport const isDeno = (): boolean => detectRuntime() === \"deno\";\n\n/**\n * Convenience predicate.\n *\n * @returns `true` when running inside a browser-like environment.\n */\nexport const isBrowser = (): boolean => detectRuntime() === \"browser\";\n"],"mappings":";;;;;;;;;;;;;;;AAmBA,SAAgB,gBAAyB;CACvC,IAAI,OAAO,eAAe,aACxB,OAAO;CAET,MAAM,IAAI;CACV,IAAI,EAAE,KAAK,OACT,OAAO;CAET,IAAI,EAAE,MACJ,OAAO;CAET,IAAI,EAAE,SAAS,UAAU,MACvB,OAAO;CAET,IAAI,OAAO,EAAE,WAAW,eAAe,OAAO,EAAE,aAAa,aAC3D,OAAO;CAET,OAAO;;;;;;;AAQT,MAAa,cAAuB,eAAe,KAAK;;;;;;AAOxD,MAAa,eAAwB,eAAe,KAAK;;;;;;AAOzD,MAAa,eAAwB,eAAe,KAAK;;;;;;AAOzD,MAAa,kBAA2B,eAAe,KAAK"}

package/dist/server.cjs

@@ -0,0 +1,237 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let ws = require("ws");
+//#region src/server.ts
+/**
+* Runtime-agnostic WebSocket server.
+*
+* @remarks
+* Internally backed by the [`ws`](https://github.com/websockets/ws) package
+* which runs on Bun, Node.js and Deno (via `npm:` specifiers). The class
+* does **not** create or own an HTTP server — callers feed it raw upgrade
+* tuples coming from any HTTP runtime they prefer.
+*
+* It implements topic-based pub/sub on top of the per-connection
+* `subscribe` / `unsubscribe` / `publish` API expected by Hedystia,
+* matching the shape of `Bun.ServerWebSocket`.
+*
+* @typeParam Data - Shape of the user-attached `data` field
+*
+* @example
+* ```ts
+* import { createServer } from "node:http";
+* import { WebSocketServer } from "@hedystia/ws/server";
+*
+* const wss = new WebSocketServer({
+*   open: (ws) => ws.send("welcome"),
+*   message: (ws, msg) => ws.publish("room", msg),
+* });
+*
+* const http = createServer((_req, res) => res.end("ok"));
+* http.on("upgrade", (req, socket, head) => {
+*   wss.upgrade({ rawRequest: req, socket, head }, { data: { user: "anon" } });
+* });
+* http.listen(3000);
+* ```
+*/
+var WebSocketServer = class {
+	handlers;
+	wss;
+	topics = /* @__PURE__ */ new Map();
+	socketTopics = /* @__PURE__ */ new WeakMap();
+	allSockets = /* @__PURE__ */ new Set();
+	/**
+	* Build a new WebSocket server.
+	*
+	* @param handlers - Lifecycle handlers ({@link WebSocketHandlers})
+	* @param options - Optional behavioural overrides ({@link WebSocketServerOptions})
+	*
+	* @example
+	* ```ts
+	* const wss = new WebSocketServer(
+	*   { message: (ws, msg) => ws.send(msg) },
+	*   { maxPayload: 1024 * 1024 },
+	* );
+	* ```
+	*/
+	constructor(handlers, options = {}) {
+		this.handlers = handlers;
+		this.wss = new ws.WebSocketServer({
+			noServer: true,
+			maxPayload: options.maxPayload,
+			perMessageDeflate: options.perMessageDeflate ?? false
+		});
+	}
+	/**
+	* Upgrade a raw HTTP upgrade tuple to a WebSocket connection.
+	*
+	* @remarks
+	* The returned promise resolves to the connected {@link ServerWebSocket}
+	* once the handshake completes; rejection means the handshake failed.
+	*
+	* @param req - Upgrade tuple emitted by `node:http`'s `'upgrade'` event
+	* @param options - Optional initial `data` for the new connection
+	* @returns Promise that resolves with the established socket wrapper
+	*
+	* @throws {Error} When the underlying handshake throws synchronously
+	*
+	* @example
+	* ```ts
+	* http.on("upgrade", async (req, socket, head) => {
+	*   try {
+	*     await wss.upgrade({ rawRequest: req, socket, head });
+	*   } catch (err) {
+	*     console.error("Upgrade failed", err);
+	*     socket.destroy();
+	*   }
+	* });
+	* ```
+	*/
+	upgrade(req, options) {
+		return new Promise((resolve, reject) => {
+			try {
+				this.wss.handleUpgrade(req.rawRequest, req.socket, req.head, (socket) => {
+					const data = options?.data ?? {};
+					const wrapped = this.wrap(socket, data, req.rawRequest);
+					this.bind(socket, wrapped);
+					resolve(wrapped);
+				});
+			} catch (err) {
+				reject(err);
+			}
+		});
+	}
+	/**
+	* Publish a message to all sockets currently subscribed to `topic`.
+	*
+	* @param topic - Topic name
+	* @param message - Payload to broadcast
+	* @param _compress - Reserved for future use; ignored under the `ws` adapter
+	* @returns Number of sockets that received the message.
+	*
+	* @example
+	* ```ts
+	* wss.publish("room", JSON.stringify({ kind: "ping" }));
+	* ```
+	*/
+	publish(topic, message, _compress) {
+		const set = this.topics.get(topic);
+		if (!set || set.size === 0) return 0;
+		const payload = toSendable(message);
+		let count = 0;
+		for (const socket of set) if (socket.readyState === 1) {
+			socket.send(payload);
+			count++;
+		}
+		return count;
+	}
+	/**
+	* Close the server and optionally terminate all live sockets.
+	*
+	* @param closeActiveConnections - When `true`, calls `socket.terminate()`
+	*  on every live connection before shutting down.
+	*/
+	close(closeActiveConnections = false) {
+		if (closeActiveConnections) {
+			for (const socket of this.allSockets) try {
+				socket.terminate();
+			} catch {}
+			this.allSockets.clear();
+		}
+		this.wss.close();
+	}
+	/**
+	* Attach the per-socket lifecycle listeners (`message`, `close`, `error`).
+	*
+	* @internal
+	*/
+	bind(socket, wrapped) {
+		this.allSockets.add(socket);
+		if (this.handlers.open) Promise.resolve(this.handlers.open(wrapped)).catch((err) => console.error("[ws] open handler error:", err));
+		socket.on("message", (raw, isBinary) => {
+			const message = isBinary ? raw instanceof ArrayBuffer ? new Uint8Array(raw) : Array.isArray(raw) ? Buffer.concat(raw) : raw : raw.toString();
+			Promise.resolve(this.handlers.message(wrapped, message)).catch((err) => console.error("[ws] message handler error:", err));
+		});
+		socket.on("close", (code, reason) => {
+			const owned = this.socketTopics.get(socket);
+			if (owned) {
+				for (const topic of owned) this.topics.get(topic)?.delete(socket);
+				this.socketTopics.delete(socket);
+			}
+			this.allSockets.delete(socket);
+			if (this.handlers.close) Promise.resolve(this.handlers.close(wrapped, code, reason?.toString() ?? "")).catch((err) => console.error("[ws] close handler error:", err));
+		});
+		socket.on("error", (err) => {
+			if (this.handlers.error) Promise.resolve(this.handlers.error(wrapped, err)).catch((e) => console.error("[ws] error handler error:", e));
+		});
+	}
+	/**
+	* Build the {@link ServerWebSocket} wrapper exposed to user handlers.
+	*
+	* @internal
+	*/
+	wrap(socket, data, rawReq) {
+		const remoteAddress = rawReq?.socket?.remoteAddress || rawReq?.headers?.["x-forwarded-for"] || "";
+		const subscribe = (topic) => {
+			let set = this.topics.get(topic);
+			if (!set) {
+				set = /* @__PURE__ */ new Set();
+				this.topics.set(topic, set);
+			}
+			set.add(socket);
+			let owned = this.socketTopics.get(socket);
+			if (!owned) {
+				owned = /* @__PURE__ */ new Set();
+				this.socketTopics.set(socket, owned);
+			}
+			owned.add(topic);
+		};
+		const unsubscribe = (topic) => {
+			this.topics.get(topic)?.delete(socket);
+			this.socketTopics.get(socket)?.delete(topic);
+		};
+		const publishToPeers = (topic, message) => {
+			const set = this.topics.get(topic);
+			if (!set) return;
+			const payload = toSendable(message);
+			for (const peer of set) if (peer !== socket && peer.readyState === 1) peer.send(payload);
+		};
+		const wrapper = {
+			data,
+			get readyState() {
+				return socket.readyState;
+			},
+			remoteAddress,
+			send: (message, _compress) => {
+				const payload = toSendable(message);
+				socket.send(payload);
+				return typeof payload === "string" ? Buffer.byteLength(payload) : payload.byteLength;
+			},
+			close: (code, reason) => {
+				socket.close(code, reason);
+			},
+			subscribe,
+			unsubscribe,
+			publish: publishToPeers,
+			isSubscribed: (topic) => !!this.socketTopics.get(socket)?.has(topic),
+			cork: (cb) => cb(wrapper)
+		};
+		return wrapper;
+	}
+};
+/**
+* Coerce a {@link WSMessage} into something the `ws` package can transmit.
+*
+* @param message - User-supplied payload
+* @returns A `string`, `Buffer` or `Uint8Array` ready to be sent
+*
+* @internal
+*/
+function toSendable(message) {
+	if (typeof message === "string") return message;
+	if (message instanceof ArrayBuffer) return Buffer.from(message);
+	return message;
+}
+//#endregion
+exports.WebSocketServer = WebSocketServer;
+
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["WSServer"],"sources":["../src/server.ts"],"sourcesContent":["import { type WebSocket as NodeWebSocket, WebSocketServer as WSServer } from \"ws\";\n\nimport type {\n  ServerWebSocket,\n  UpgradeOptions,\n  UpgradeRequest,\n  WebSocketHandlers,\n  WebSocketServerOptions,\n  WSData,\n  WSMessage,\n} from \"./types\";\n\nexport type {\n  ServerWebSocket,\n  UpgradeOptions,\n  UpgradeRequest,\n  WebSocketHandlers,\n  WebSocketServerOptions,\n  WSData,\n  WSMessage,\n} from \"./types\";\n\n/**\n * Runtime-agnostic WebSocket server.\n *\n * @remarks\n * Internally backed by the [`ws`](https://github.com/websockets/ws) package\n * which runs on Bun, Node.js and Deno (via `npm:` specifiers). The class\n * does **not** create or own an HTTP server — callers feed it raw upgrade\n * tuples coming from any HTTP runtime they prefer.\n *\n * It implements topic-based pub/sub on top of the per-connection\n * `subscribe` / `unsubscribe` / `publish` API expected by Hedystia,\n * matching the shape of `Bun.ServerWebSocket`.\n *\n * @typeParam Data - Shape of the user-attached `data` field\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { WebSocketServer } from \"@hedystia/ws/server\";\n *\n * const wss = new WebSocketServer({\n *   open: (ws) => ws.send(\"welcome\"),\n *   message: (ws, msg) => ws.publish(\"room\", msg),\n * });\n *\n * const http = createServer((_req, res) => res.end(\"ok\"));\n * http.on(\"upgrade\", (req, socket, head) => {\n *   wss.upgrade({ rawRequest: req, socket, head }, { data: { user: \"anon\" } });\n * });\n * http.listen(3000);\n * ```\n */\nexport class WebSocketServer<Data extends WSData = WSData> {\n  private readonly handlers: WebSocketHandlers<Data>;\n  private readonly wss: WSServer;\n  private readonly topics = new Map<string, Set<NodeWebSocket>>();\n  private readonly socketTopics = new WeakMap<NodeWebSocket, Set<string>>();\n  private readonly allSockets = new Set<NodeWebSocket>();\n\n  /**\n   * Build a new WebSocket server.\n   *\n   * @param handlers - Lifecycle handlers ({@link WebSocketHandlers})\n   * @param options - Optional behavioural overrides ({@link WebSocketServerOptions})\n   *\n   * @example\n   * ```ts\n   * const wss = new WebSocketServer(\n   *   { message: (ws, msg) => ws.send(msg) },\n   *   { maxPayload: 1024 * 1024 },\n   * );\n   * ```\n   */\n  constructor(handlers: WebSocketHandlers<Data>, options: WebSocketServerOptions = {}) {\n    this.handlers = handlers;\n    this.wss = new WSServer({\n      noServer: true,\n      maxPayload: options.maxPayload,\n      perMessageDeflate: (options.perMessageDeflate ?? false) as any,\n    });\n  }\n\n  /**\n   * Upgrade a raw HTTP upgrade tuple to a WebSocket connection.\n   *\n   * @remarks\n   * The returned promise resolves to the connected {@link ServerWebSocket}\n   * once the handshake completes; rejection means the handshake failed.\n   *\n   * @param req - Upgrade tuple emitted by `node:http`'s `'upgrade'` event\n   * @param options - Optional initial `data` for the new connection\n   * @returns Promise that resolves with the established socket wrapper\n   *\n   * @throws {Error} When the underlying handshake throws synchronously\n   *\n   * @example\n   * ```ts\n   * http.on(\"upgrade\", async (req, socket, head) => {\n   *   try {\n   *     await wss.upgrade({ rawRequest: req, socket, head });\n   *   } catch (err) {\n   *     console.error(\"Upgrade failed\", err);\n   *     socket.destroy();\n   *   }\n   * });\n   * ```\n   */\n  upgrade(req: UpgradeRequest, options?: UpgradeOptions<Data>): Promise<ServerWebSocket<Data>> {\n    return new Promise((resolve, reject) => {\n      try {\n        this.wss.handleUpgrade(req.rawRequest, req.socket, req.head as Buffer, (socket) => {\n          const data = (options?.data ?? ({} as Data)) as Data;\n          const wrapped = this.wrap(socket, data, req.rawRequest);\n          this.bind(socket, wrapped);\n          resolve(wrapped);\n        });\n      } catch (err) {\n        reject(err);\n      }\n    });\n  }\n\n  /**\n   * Publish a message to all sockets currently subscribed to `topic`.\n   *\n   * @param topic - Topic name\n   * @param message - Payload to broadcast\n   * @param _compress - Reserved for future use; ignored under the `ws` adapter\n   * @returns Number of sockets that received the message.\n   *\n   * @example\n   * ```ts\n   * wss.publish(\"room\", JSON.stringify({ kind: \"ping\" }));\n   * ```\n   */\n  publish(topic: string, message: WSMessage, _compress?: boolean): number {\n    const set = this.topics.get(topic);\n    if (!set || set.size === 0) {\n      return 0;\n    }\n    const payload = toSendable(message);\n    let count = 0;\n    for (const socket of set) {\n      if (socket.readyState === 1) {\n        socket.send(payload);\n        count++;\n      }\n    }\n    return count;\n  }\n\n  /**\n   * Close the server and optionally terminate all live sockets.\n   *\n   * @param closeActiveConnections - When `true`, calls `socket.terminate()`\n   *  on every live connection before shutting down.\n   */\n  close(closeActiveConnections = false): void {\n    if (closeActiveConnections) {\n      for (const socket of this.allSockets) {\n        try {\n          socket.terminate();\n        } catch {\n          /* ignore */\n        }\n      }\n      this.allSockets.clear();\n    }\n    this.wss.close();\n  }\n\n  /**\n   * Attach the per-socket lifecycle listeners (`message`, `close`, `error`).\n   *\n   * @internal\n   */\n  private bind(socket: NodeWebSocket, wrapped: ServerWebSocket<Data>): void {\n    this.allSockets.add(socket);\n\n    if (this.handlers.open) {\n      Promise.resolve(this.handlers.open(wrapped)).catch((err) =>\n        console.error(\"[ws] open handler error:\", err),\n      );\n    }\n\n    socket.on(\"message\", (raw, isBinary) => {\n      const message: WSMessage = isBinary\n        ? raw instanceof ArrayBuffer\n          ? new Uint8Array(raw)\n          : Array.isArray(raw)\n            ? Buffer.concat(raw)\n            : (raw as Buffer)\n        : raw.toString();\n      Promise.resolve(this.handlers.message(wrapped, message)).catch((err) =>\n        console.error(\"[ws] message handler error:\", err),\n      );\n    });\n\n    socket.on(\"close\", (code, reason) => {\n      const owned = this.socketTopics.get(socket);\n      if (owned) {\n        for (const topic of owned) {\n          this.topics.get(topic)?.delete(socket);\n        }\n        this.socketTopics.delete(socket);\n      }\n      this.allSockets.delete(socket);\n      if (this.handlers.close) {\n        Promise.resolve(this.handlers.close(wrapped, code, reason?.toString() ?? \"\")).catch((err) =>\n          console.error(\"[ws] close handler error:\", err),\n        );\n      }\n    });\n\n    socket.on(\"error\", (err) => {\n      if (this.handlers.error) {\n        Promise.resolve(this.handlers.error(wrapped, err)).catch((e) =>\n          console.error(\"[ws] error handler error:\", e),\n        );\n      }\n    });\n  }\n\n  /**\n   * Build the {@link ServerWebSocket} wrapper exposed to user handlers.\n   *\n   * @internal\n   */\n  private wrap(socket: NodeWebSocket, data: Data, rawReq: any): ServerWebSocket<Data> {\n    const remoteAddress: string =\n      (rawReq?.socket?.remoteAddress as string) ||\n      (rawReq?.headers?.[\"x-forwarded-for\"] as string) ||\n      \"\";\n\n    const subscribe = (topic: string) => {\n      let set = this.topics.get(topic);\n      if (!set) {\n        set = new Set();\n        this.topics.set(topic, set);\n      }\n      set.add(socket);\n      let owned = this.socketTopics.get(socket);\n      if (!owned) {\n        owned = new Set();\n        this.socketTopics.set(socket, owned);\n      }\n      owned.add(topic);\n    };\n\n    const unsubscribe = (topic: string) => {\n      this.topics.get(topic)?.delete(socket);\n      this.socketTopics.get(socket)?.delete(topic);\n    };\n\n    const publishToPeers = (topic: string, message: WSMessage) => {\n      const set = this.topics.get(topic);\n      if (!set) {\n        return;\n      }\n      const payload = toSendable(message);\n      for (const peer of set) {\n        if (peer !== socket && peer.readyState === 1) {\n          peer.send(payload);\n        }\n      }\n    };\n\n    const wrapper: ServerWebSocket<Data> = {\n      data,\n      get readyState() {\n        return socket.readyState;\n      },\n      remoteAddress,\n      send: (message, _compress) => {\n        const payload = toSendable(message);\n        socket.send(payload);\n        return typeof payload === \"string\"\n          ? Buffer.byteLength(payload)\n          : (payload as Buffer | Uint8Array).byteLength;\n      },\n      close: (code, reason) => {\n        socket.close(code, reason);\n      },\n      subscribe,\n      unsubscribe,\n      publish: publishToPeers,\n      isSubscribed: (topic) => !!this.socketTopics.get(socket)?.has(topic),\n      cork: (cb) => cb(wrapper),\n    };\n\n    return wrapper;\n  }\n}\n\n/**\n * Coerce a {@link WSMessage} into something the `ws` package can transmit.\n *\n * @param message - User-supplied payload\n * @returns A `string`, `Buffer` or `Uint8Array` ready to be sent\n *\n * @internal\n */\nfunction toSendable(message: WSMessage): string | Buffer | Uint8Array {\n  if (typeof message === \"string\") {\n    return message;\n  }\n  if (message instanceof ArrayBuffer) {\n    return Buffer.from(message);\n  }\n  return message;\n}\n"],"mappings":"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"}

package/dist/server.d.cts

@@ -0,0 +1,119 @@
+import { ServerWebSocket, UpgradeOptions, UpgradeRequest, WSData, WSMessage, WebSocketHandlers, WebSocketServerOptions } from "./types.cjs";
+
+//#region src/server.d.ts
+/**
+ * Runtime-agnostic WebSocket server.
+ *
+ * @remarks
+ * Internally backed by the [`ws`](https://github.com/websockets/ws) package
+ * which runs on Bun, Node.js and Deno (via `npm:` specifiers). The class
+ * does **not** create or own an HTTP server — callers feed it raw upgrade
+ * tuples coming from any HTTP runtime they prefer.
+ *
+ * It implements topic-based pub/sub on top of the per-connection
+ * `subscribe` / `unsubscribe` / `publish` API expected by Hedystia,
+ * matching the shape of `Bun.ServerWebSocket`.
+ *
+ * @typeParam Data - Shape of the user-attached `data` field
+ *
+ * @example
+ * ```ts
+ * import { createServer } from "node:http";
+ * import { WebSocketServer } from "@hedystia/ws/server";
+ *
+ * const wss = new WebSocketServer({
+ *   open: (ws) => ws.send("welcome"),
+ *   message: (ws, msg) => ws.publish("room", msg),
+ * });
+ *
+ * const http = createServer((_req, res) => res.end("ok"));
+ * http.on("upgrade", (req, socket, head) => {
+ *   wss.upgrade({ rawRequest: req, socket, head }, { data: { user: "anon" } });
+ * });
+ * http.listen(3000);
+ * ```
+ */
+declare class WebSocketServer<Data extends WSData = WSData> {
+  private readonly handlers;
+  private readonly wss;
+  private readonly topics;
+  private readonly socketTopics;
+  private readonly allSockets;
+  /**
+   * Build a new WebSocket server.
+   *
+   * @param handlers - Lifecycle handlers ({@link WebSocketHandlers})
+   * @param options - Optional behavioural overrides ({@link WebSocketServerOptions})
+   *
+   * @example
+   * ```ts
+   * const wss = new WebSocketServer(
+   *   { message: (ws, msg) => ws.send(msg) },
+   *   { maxPayload: 1024 * 1024 },
+   * );
+   * ```
+   */
+  constructor(handlers: WebSocketHandlers<Data>, options?: WebSocketServerOptions);
+  /**
+   * Upgrade a raw HTTP upgrade tuple to a WebSocket connection.
+   *
+   * @remarks
+   * The returned promise resolves to the connected {@link ServerWebSocket}
+   * once the handshake completes; rejection means the handshake failed.
+   *
+   * @param req - Upgrade tuple emitted by `node:http`'s `'upgrade'` event
+   * @param options - Optional initial `data` for the new connection
+   * @returns Promise that resolves with the established socket wrapper
+   *
+   * @throws {Error} When the underlying handshake throws synchronously
+   *
+   * @example
+   * ```ts
+   * http.on("upgrade", async (req, socket, head) => {
+   *   try {
+   *     await wss.upgrade({ rawRequest: req, socket, head });
+   *   } catch (err) {
+   *     console.error("Upgrade failed", err);
+   *     socket.destroy();
+   *   }
+   * });
+   * ```
+   */
+  upgrade(req: UpgradeRequest, options?: UpgradeOptions<Data>): Promise<ServerWebSocket<Data>>;
+  /**
+   * Publish a message to all sockets currently subscribed to `topic`.
+   *
+   * @param topic - Topic name
+   * @param message - Payload to broadcast
+   * @param _compress - Reserved for future use; ignored under the `ws` adapter
+   * @returns Number of sockets that received the message.
+   *
+   * @example
+   * ```ts
+   * wss.publish("room", JSON.stringify({ kind: "ping" }));
+   * ```
+   */
+  publish(topic: string, message: WSMessage, _compress?: boolean): number;
+  /**
+   * Close the server and optionally terminate all live sockets.
+   *
+   * @param closeActiveConnections - When `true`, calls `socket.terminate()`
+   *  on every live connection before shutting down.
+   */
+  close(closeActiveConnections?: boolean): void;
+  /**
+   * Attach the per-socket lifecycle listeners (`message`, `close`, `error`).
+   *
+   * @internal
+   */
+  private bind;
+  /**
+   * Build the {@link ServerWebSocket} wrapper exposed to user handlers.
+   *
+   * @internal
+   */
+  private wrap;
+}
+//#endregion
+export { type ServerWebSocket, type UpgradeOptions, type UpgradeRequest, type WSData, type WSMessage, type WebSocketHandlers, WebSocketServer, type WebSocketServerOptions };
+//# sourceMappingURL=server.d.cts.map