@wooksjs/event-ws 0.7.25 → 0.7.27

package/dist/index.cjs

@@ -147,6 +147,83 @@ const useWsRooms = (0, _wooksjs_event_core.defineWook)((ctx) => {
 	};
 });
 
+//#endregion
+//#region packages/event-ws/src/ws-connection.ts
+function pushMessage(event, path, data, params) {
+	const msg = {
+		event,
+		path
+	};
+	if (params) msg.params = params;
+	if (data !== void 0) msg.data = data;
+	return msg;
+}
+/** Internal class representing a connected WebSocket client. */
+var WsConnection = class {
+	constructor(id, ws, ctx, serializer) {
+		this.id = id;
+		this.ws = ws;
+		this.ctx = ctx;
+		this.serializer = serializer;
+		this.rooms = /* @__PURE__ */ new Set();
+		this.alive = true;
+	}
+	/** Send a push message to this connection. */
+	send(event, path, data, params) {
+		if (this.ws.readyState !== 1) return;
+		this.ws.send(this.serializer(pushMessage(event, path, data, params)));
+	}
+	/**
+	* Send an already serialized frame (e.g. one push message serialized once for many recipients).
+	* Skipped when the socket is not open, like `send()`.
+	*/
+	sendSerialized(payload) {
+		if (this.ws.readyState !== 1) return;
+		this.ws.send(payload);
+	}
+	/** Send a reply to a client request. */
+	reply(id, data) {
+		if (this.ws.readyState !== 1) return;
+		const msg = { id };
+		if (data !== void 0) msg.data = data;
+		this.ws.send(this.serializer(msg));
+	}
+	/** Send an error reply to a client request. */
+	replyError(id, code, message) {
+		if (this.ws.readyState !== 1) return;
+		const msg = {
+			id,
+			error: {
+				code,
+				message
+			}
+		};
+		this.ws.send(this.serializer(msg));
+	}
+	/**
+	* Sends one push message to many connections, serializing it once per distinct serializer
+	* (connections of one adapter share one) and only when an open recipient exists.
+	* @internal
+	*/
+	static sendPushToMany(connections, skip, event, path, data, params) {
+		let msg;
+		let serializer;
+		let payload = "";
+		for (const conn of connections) {
+			if (conn.ws.readyState !== 1 || skip && skip(conn)) continue;
+			if (conn.serializer !== serializer) {
+				serializer = conn.serializer;
+				payload = serializer(msg ??= pushMessage(event, path, data, params));
+			}
+			conn.sendSerialized(payload);
+		}
+	}
+	/** Close the connection. */
+	close(code, reason) {
+		this.ws.close(code, reason);
+	}
+};
+
 //#endregion
 //#region packages/event-ws/src/composables/server.ts
 /**
@@ -160,7 +237,7 @@ function useWsServer() {
 			return state.connections;
 		},
 		broadcast(event, path, data, params) {
-			for (const conn of state.connections.values()) conn.send(event, path, data, params);
+			WsConnection.sendPushToMany(state.connections.values(), void 0, event, path, data, params);
 		},
 		getConnection(id) {
 			return state.connections.get(id);
@@ -201,54 +278,6 @@ function createDefaultWsServerAdapter() {
 	} };
 }
 
-//#endregion
-//#region packages/event-ws/src/ws-connection.ts
-/** Internal class representing a connected WebSocket client. */
-var WsConnection = class {
-	constructor(id, ws, ctx, serializer) {
-		this.id = id;
-		this.ws = ws;
-		this.ctx = ctx;
-		this.serializer = serializer;
-		this.rooms = /* @__PURE__ */ new Set();
-		this.alive = true;
-	}
-	/** Send a push message to this connection. */
-	send(event, path, data, params) {
-		if (this.ws.readyState !== 1) return;
-		const msg = {
-			event,
-			path
-		};
-		if (params) msg.params = params;
-		if (data !== void 0) msg.data = data;
-		this.ws.send(this.serializer(msg));
-	}
-	/** Send a reply to a client request. */
-	reply(id, data) {
-		if (this.ws.readyState !== 1) return;
-		const msg = { id };
-		if (data !== void 0) msg.data = data;
-		this.ws.send(this.serializer(msg));
-	}
-	/** Send an error reply to a client request. */
-	replyError(id, code, message) {
-		if (this.ws.readyState !== 1) return;
-		const msg = {
-			id,
-			error: {
-				code,
-				message
-			}
-		};
-		this.ws.send(this.serializer(msg));
-	}
-	/** Close the connection. */
-	close(code, reason) {
-		this.ws.close(code, reason);
-	}
-};
-
 //#endregion
 //#region packages/event-ws/src/ws-error.ts
 /** WebSocket error with a numeric code following HTTP conventions (401, 403, 404, 500, etc.). */
@@ -314,9 +343,7 @@ var WsRoomManager = class {
 	/** Broadcast to all connections in a room. */
 	broadcast(room, event, path, data, params, exclude) {
 		const set = this.rooms.get(room);
-		if (set) {
-			for (const conn of set) if (conn !== exclude) conn.send(event, path, data, params);
-		}
+		if (set) WsConnection.sendPushToMany(set, exclude && ((conn) => conn === exclude), event, path, data, params);
 		if (this.transport) {
 			const payload = JSON.stringify({
 				event,
@@ -334,7 +361,7 @@ var WsRoomManager = class {
 		if (!set || set.size === 0) return;
 		try {
 			const { event, path, data, params, excludeId } = JSON.parse(payload);
-			for (const conn of set) if (conn.id !== excludeId) conn.send(event, path, data, params);
+			WsConnection.sendPushToMany(set, excludeId === void 0 ? void 0 : (conn) => conn.id === excludeId, event, path, data, params);
 		} catch {}
 	}
 };

package/dist/index.d.ts

@@ -152,6 +152,7 @@ interface TWooksWsOptions {
     broadcastTransport?: WsBroadcastTransport;
 }
 
+type TWsSerializer = (msg: WsReplyMessage | WsPushMessage) => string | Buffer;
 /** Internal class representing a connected WebSocket client. */
 declare class WsConnection {
     readonly id: string;
@@ -160,13 +161,24 @@ declare class WsConnection {
     private readonly serializer;
     readonly rooms: Set<string>;
     alive: boolean;
-    constructor(id: string, ws: WsSocket, ctx: EventContext, serializer: (msg: WsReplyMessage | WsPushMessage) => string | Buffer);
+    constructor(id: string, ws: WsSocket, ctx: EventContext, serializer: TWsSerializer);
     /** Send a push message to this connection. */
     send(event: string, path: string, data?: unknown, params?: Record<string, string>): void;
+    /**
+     * Send an already serialized frame (e.g. one push message serialized once for many recipients).
+     * Skipped when the socket is not open, like `send()`.
+     */
+    sendSerialized(payload: string | Buffer): void;
     /** Send a reply to a client request. */
     reply(id: string | number, data?: unknown): void;
     /** Send an error reply to a client request. */
     replyError(id: string | number, code: number, message: string): void;
+    /**
+     * Sends one push message to many connections, serializing it once per distinct serializer
+     * (connections of one adapter share one) and only when an open recipient exists.
+     * @internal
+     */
+    static sendPushToMany(connections: Iterable<WsConnection>, skip: ((conn: WsConnection) => boolean) | undefined, event: string, path: string, data?: unknown, params?: Record<string, string>): void;
     /** Close the connection. */
     close(code?: number, reason?: string): void;
 }

package/dist/index.mjs

@@ -118,6 +118,83 @@ const useWsRooms = defineWook((ctx) => {
 	};
 });
 
+//#endregion
+//#region packages/event-ws/src/ws-connection.ts
+function pushMessage(event, path, data, params) {
+	const msg = {
+		event,
+		path
+	};
+	if (params) msg.params = params;
+	if (data !== void 0) msg.data = data;
+	return msg;
+}
+/** Internal class representing a connected WebSocket client. */
+var WsConnection = class {
+	constructor(id, ws, ctx, serializer) {
+		this.id = id;
+		this.ws = ws;
+		this.ctx = ctx;
+		this.serializer = serializer;
+		this.rooms = /* @__PURE__ */ new Set();
+		this.alive = true;
+	}
+	/** Send a push message to this connection. */
+	send(event, path, data, params) {
+		if (this.ws.readyState !== 1) return;
+		this.ws.send(this.serializer(pushMessage(event, path, data, params)));
+	}
+	/**
+	* Send an already serialized frame (e.g. one push message serialized once for many recipients).
+	* Skipped when the socket is not open, like `send()`.
+	*/
+	sendSerialized(payload) {
+		if (this.ws.readyState !== 1) return;
+		this.ws.send(payload);
+	}
+	/** Send a reply to a client request. */
+	reply(id, data) {
+		if (this.ws.readyState !== 1) return;
+		const msg = { id };
+		if (data !== void 0) msg.data = data;
+		this.ws.send(this.serializer(msg));
+	}
+	/** Send an error reply to a client request. */
+	replyError(id, code, message) {
+		if (this.ws.readyState !== 1) return;
+		const msg = {
+			id,
+			error: {
+				code,
+				message
+			}
+		};
+		this.ws.send(this.serializer(msg));
+	}
+	/**
+	* Sends one push message to many connections, serializing it once per distinct serializer
+	* (connections of one adapter share one) and only when an open recipient exists.
+	* @internal
+	*/
+	static sendPushToMany(connections, skip, event, path, data, params) {
+		let msg;
+		let serializer;
+		let payload = "";
+		for (const conn of connections) {
+			if (conn.ws.readyState !== 1 || skip && skip(conn)) continue;
+			if (conn.serializer !== serializer) {
+				serializer = conn.serializer;
+				payload = serializer(msg ??= pushMessage(event, path, data, params));
+			}
+			conn.sendSerialized(payload);
+		}
+	}
+	/** Close the connection. */
+	close(code, reason) {
+		this.ws.close(code, reason);
+	}
+};
+
 //#endregion
 //#region packages/event-ws/src/composables/server.ts
 /**
@@ -131,7 +208,7 @@ function useWsServer() {
 			return state.connections;
 		},
 		broadcast(event, path, data, params) {
-			for (const conn of state.connections.values()) conn.send(event, path, data, params);
+			WsConnection.sendPushToMany(state.connections.values(), void 0, event, path, data, params);
 		},
 		getConnection(id) {
 			return state.connections.get(id);
@@ -172,54 +249,6 @@ function createDefaultWsServerAdapter() {
 	} };
 }
 
-//#endregion
-//#region packages/event-ws/src/ws-connection.ts
-/** Internal class representing a connected WebSocket client. */
-var WsConnection = class {
-	constructor(id, ws, ctx, serializer) {
-		this.id = id;
-		this.ws = ws;
-		this.ctx = ctx;
-		this.serializer = serializer;
-		this.rooms = /* @__PURE__ */ new Set();
-		this.alive = true;
-	}
-	/** Send a push message to this connection. */
-	send(event, path, data, params) {
-		if (this.ws.readyState !== 1) return;
-		const msg = {
-			event,
-			path
-		};
-		if (params) msg.params = params;
-		if (data !== void 0) msg.data = data;
-		this.ws.send(this.serializer(msg));
-	}
-	/** Send a reply to a client request. */
-	reply(id, data) {
-		if (this.ws.readyState !== 1) return;
-		const msg = { id };
-		if (data !== void 0) msg.data = data;
-		this.ws.send(this.serializer(msg));
-	}
-	/** Send an error reply to a client request. */
-	replyError(id, code, message) {
-		if (this.ws.readyState !== 1) return;
-		const msg = {
-			id,
-			error: {
-				code,
-				message
-			}
-		};
-		this.ws.send(this.serializer(msg));
-	}
-	/** Close the connection. */
-	close(code, reason) {
-		this.ws.close(code, reason);
-	}
-};
-
 //#endregion
 //#region packages/event-ws/src/ws-error.ts
 /** WebSocket error with a numeric code following HTTP conventions (401, 403, 404, 500, etc.). */
@@ -285,9 +314,7 @@ var WsRoomManager = class {
 	/** Broadcast to all connections in a room. */
 	broadcast(room, event, path, data, params, exclude) {
 		const set = this.rooms.get(room);
-		if (set) {
-			for (const conn of set) if (conn !== exclude) conn.send(event, path, data, params);
-		}
+		if (set) WsConnection.sendPushToMany(set, exclude && ((conn) => conn === exclude), event, path, data, params);
 		if (this.transport) {
 			const payload = JSON.stringify({
 				event,
@@ -305,7 +332,7 @@ var WsRoomManager = class {
 		if (!set || set.size === 0) return;
 		try {
 			const { event, path, data, params, excludeId } = JSON.parse(payload);
-			for (const conn of set) if (conn.id !== excludeId) conn.send(event, path, data, params);
+			WsConnection.sendPushToMany(set, excludeId === void 0 ? void 0 : (conn) => conn.id === excludeId, event, path, data, params);
 		} catch {}
 	}
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-ws",
-  "version": "0.7.25",
+  "version": "0.7.27",
   "description": "WebSocket adapter for Wooks with path-based message routing, rooms, and broadcasting",
   "keywords": [
     "api",
@@ -42,15 +42,15 @@
     "@types/ws": "^8.18.1",
     "typescript": "^5.9.3",
     "vitest": "^3.2.7",
-    "@wooksjs/event-core": "^0.7.25",
-    "wooks": "^0.7.25"
+    "wooks": "^0.7.27",
+    "@wooksjs/event-core": "^0.7.27"
   },
   "peerDependencies": {
     "@prostojs/logger": "^0.4.3",
-    "@prostojs/router": "^0.3.4",
+    "@prostojs/router": "^0.3.5",
     "ws": "^8.21.0",
-    "@wooksjs/event-core": "^0.7.25",
-    "wooks": "^0.7.25"
+    "wooks": "^0.7.27",
+    "@wooksjs/event-core": "^0.7.27"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs"