@venizia/ignis-helpers 0.2.0-4 → 0.2.0-5

package/dist/cjs/modules/socket/websocket/server/delivery.d.ts

@@ -0,0 +1,48 @@
+import { BaseHelper } from '../../../../modules/base';
+import { IBunServer, IWebSocketClient, TWebSocketOutboundTransformer } from '../common';
+export interface IWebSocketDeliveryHelperOptions<MetadataType extends Record<string, unknown> = Record<string, unknown>> {
+    server: IBunServer;
+    /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */
+    clients: Map<string, IWebSocketClient<MetadataType>>;
+    users: Map<string, Set<string>>;
+    rooms: Map<string, Set<string>>;
+    outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;
+    encryptedBatchLimit: number;
+}
+/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */
+export declare class WebSocketDeliveryHelper<MetadataType extends Record<string, unknown> = Record<string, unknown>> extends BaseHelper {
+    private server;
+    private clients;
+    private users;
+    private rooms;
+    private outboundTransformer?;
+    private encryptedBatchLimit;
+    constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>);
+    sendToClient(opts: {
+        clientId: string;
+        event: string;
+        data: unknown;
+        doLog?: boolean;
+    }): void;
+    private sendToClientAsync;
+    private deliverToSocket;
+    sendToUser(opts: {
+        userId: string;
+        event: string;
+        data: unknown;
+    }): void;
+    private sendToRoomExcluding;
+    sendToRoom(opts: {
+        room: string;
+        event: string;
+        data: unknown;
+        exclude?: string[];
+    }): void;
+    private broadcastExcluding;
+    broadcast(opts: {
+        event: string;
+        data: unknown;
+        exclude?: string[];
+    }): void;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/cjs/modules/socket/websocket/server/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EACL,UAAU,EACV,gBAAgB,EAEhB,6BAA6B,EAG9B,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,+BAA+B,CAC9C,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,MAAM,EAAE,UAAU,CAAC;IACnB,2GAA2G;IAC3G,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,mBAAmB,CAAC,EAAE,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3E,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,6GAA6G;AAC7G,qBAAa,uBAAuB,CAClC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACtE,SAAQ,UAAU;IAClB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAuD;IACnF,OAAO,CAAC,mBAAmB,CAAS;gBAExB,IAAI,EAAE,+BAA+B,CAAC,YAAY,CAAC;IAW/D,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;YAiCxE,iBAAiB;IAuB/B,OAAO,CAAC,eAAe;IA8BvB,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAYjE,OAAO,CAAC,mBAAmB;IA2C3B,UAAU,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAoCnF,OAAO,CAAC,kBAAkB;IAiB1B,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAiCrE"}

package/dist/cjs/modules/socket/websocket/server/delivery.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketDeliveryHelper = void 0;
+const base_1 = require("../../../../modules/base");
+const utilities_1 = require("../../../../utilities");
+const promise_utility_1 = require("../../../../utilities/promise.utility");
+const common_1 = require("../common");
+/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */
+class WebSocketDeliveryHelper extends base_1.BaseHelper {
+    constructor(opts) {
+        super({ scope: WebSocketDeliveryHelper.name });
+        this.server = opts.server;
+        this.clients = opts.clients;
+        this.users = opts.users;
+        this.rooms = opts.rooms;
+        this.outboundTransformer = opts.outboundTransformer;
+        this.encryptedBatchLimit = opts.encryptedBatchLimit;
+    }
+    sendToClient(opts) {
+        const logger = this.logger.for(this.sendToClient.name);
+        const { clientId, event, data, doLog } = opts;
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return;
+        }
+        // Async path - transformer intercepts before socket.send()
+        const outboundTransformer = this.outboundTransformer;
+        if (outboundTransformer && client.encrypted) {
+            Promise.resolve()
+                .then(() => outboundTransformer({ client, event, data }))
+                .then(transformed => {
+                const outboundMessage = transformed ?? { event, data };
+                this.deliverToSocket({
+                    client,
+                    payload: JSON.stringify(outboundMessage),
+                    doLog,
+                    event,
+                    data,
+                });
+            })
+                .catch(error => {
+                logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);
+            });
+            return;
+        }
+        // Sync path (unchanged, zero overhead when no transformer)
+        this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });
+    }
+    async sendToClientAsync(opts) {
+        const { clientId, event, data } = opts;
+        const client = this.clients.get(clientId);
+        if (!client) {
+            return Promise.resolve();
+        }
+        if (!this.outboundTransformer || !client.encrypted) {
+            this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });
+            return Promise.resolve();
+        }
+        try {
+            const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));
+            const outboundMessage = transformed ?? { event, data };
+            this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });
+        }
+        catch (error) {
+            this.logger
+                .for(this.sendToClientAsync.name)
+                .error('Outbound transformer error | id: %s | error: %s', clientId, error);
+        }
+    }
+    deliverToSocket(opts) {
+        const logger = this.logger.for(this.deliverToSocket.name);
+        const { client, payload, doLog, event, data } = opts;
+        try {
+            const result = client.socket.send(payload);
+            if (result === 0) {
+                logger.warn('Message dropped (socket closed) | id: %s', client.id);
+            }
+            if (result === -1) {
+                client.backpressured = true;
+                logger.warn('Backpressure detected | id: %s', client.id);
+            }
+        }
+        catch (error) {
+            logger.error('Failed to send | id: %s | error: %s', client.id, error);
+        }
+        if (doLog) {
+            logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);
+        }
+    }
+    sendToUser(opts) {
+        const { userId, event, data } = opts;
+        const clientIds = this.users.get(userId);
+        if (!clientIds) {
+            return;
+        }
+        for (const clientId of clientIds) {
+            this.sendToClient({ clientId, event, data });
+        }
+    }
+    sendToRoomExcluding(opts) {
+        const { room, event, data, exclude } = opts;
+        const excludeSet = new Set(exclude);
+        const roomClientIds = this.rooms.get(room);
+        if (!roomClientIds) {
+            return;
+        }
+        // Serialised ONCE when there is no transformer, because the payload is then identical for every
+        // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that
+        // never differs. With a transformer each client's payload really is different, so that path
+        // still goes through `sendToClient`. The non-excluding fan-out already works this way.
+        if (!this.outboundTransformer) {
+            const payload = JSON.stringify({ event, data });
+            for (const clientId of roomClientIds) {
+                if (excludeSet.has(clientId)) {
+                    continue;
+                }
+                const client = this.clients.get(clientId);
+                if (client) {
+                    this.deliverToSocket({ client, payload, event, data });
+                }
+            }
+            return;
+        }
+        for (const clientId of roomClientIds) {
+            if (excludeSet.has(clientId)) {
+                continue;
+            }
+            this.sendToClient({ clientId, event, data });
+        }
+    }
+    sendToRoom(opts) {
+        const { room, event, data, exclude } = opts;
+        // When exclude is present, must iterate - can't exclude from Bun native pub/sub
+        if (exclude?.length) {
+            this.sendToRoomExcluding({ room, event, data, exclude });
+            return;
+        }
+        // No encryption - Bun native pub/sub O(1) C++ fan-out
+        if (!this.outboundTransformer) {
+            const payload = JSON.stringify({ event, data });
+            this.server.publish(room, payload);
+            return;
+        }
+        // Encryption enabled - iterate all clients individually with concurrency limit
+        const roomClientIds = this.rooms.get(room);
+        if (!roomClientIds) {
+            return;
+        }
+        const tasks = [];
+        for (const clientId of roomClientIds) {
+            tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
+        }
+        if (tasks.length) {
+            (0, promise_utility_1.voidExecution)({
+                logger: this.logger,
+                scope: this.sendToRoom.name,
+                execution: (0, utilities_1.executePromiseWithLimit)({ tasks, limit: this.encryptedBatchLimit }),
+            });
+        }
+    }
+    broadcastExcluding(opts) {
+        const { event, data, exclude } = opts;
+        const excludeSet = new Set(exclude);
+        for (const [clientId, client] of this.clients) {
+            if (excludeSet.has(clientId)) {
+                continue;
+            }
+            // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)
+            if (client.state !== common_1.WebSocketClientStates.AUTHENTICATED) {
+                continue;
+            }
+            this.sendToClient({ clientId, event, data });
+        }
+    }
+    broadcast(opts) {
+        const { event, data, exclude } = opts;
+        // When exclude is present, must iterate - can't exclude from Bun native pub/sub
+        if (exclude?.length) {
+            this.broadcastExcluding({ event, data, exclude });
+            return;
+        }
+        // No encryption - Bun native pub/sub O(1) C++ fan-out
+        if (!this.outboundTransformer) {
+            const payload = JSON.stringify({ event, data });
+            this.server.publish(common_1.WebSocketDefaults.BROADCAST_TOPIC, payload);
+            return;
+        }
+        // Encryption enabled - iterate all clients individually with concurrency limit
+        const tasks = [];
+        for (const [clientId, client] of this.clients) {
+            if (client.state !== common_1.WebSocketClientStates.AUTHENTICATED) {
+                continue;
+            }
+            tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
+        }
+        if (tasks.length) {
+            (0, promise_utility_1.voidExecution)({
+                logger: this.logger,
+                scope: this.broadcast.name,
+                execution: (0, utilities_1.executePromiseWithLimit)({ tasks, limit: this.encryptedBatchLimit }),
+            });
+        }
+    }
+}
+exports.WebSocketDeliveryHelper = WebSocketDeliveryHelper;
+//# sourceMappingURL=delivery.js.map

package/dist/cjs/modules/socket/websocket/server/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/socket/websocket/server/helper.d.ts

@@ -12,11 +12,11 @@ export declare class WebSocketServerHelper<AuthDataType extends Record<string, u
      */
     private static toRoomList;
     private path;
-    private server;
     private serverId;
     private clients;
     private users;
     private rooms;
+    private delivery;
     private redisPub;
     private redisSub;
     private authenticateFn;
@@ -24,7 +24,6 @@ export declare class WebSocketServerHelper<AuthDataType extends Record<string, u
     private onClientConnected?;
     private onClientDisconnected?;
     private messageHandler?;
-    private outboundTransformer?;
     private handshakeFn?;
     private defaultRooms;
     private serverOptions;
@@ -32,7 +31,6 @@ export declare class WebSocketServerHelper<AuthDataType extends Record<string, u
     private heartbeatInterval;
     private heartbeatTimeout;
     private heartbeatTimer;
-    private encryptedBatchLimit;
     private requireEncryption;
     constructor(opts: IWebSocketServerOptions<AuthDataType, MetadataType>);
     private initRedisClients;
@@ -82,27 +80,24 @@ export declare class WebSocketServerHelper<AuthDataType extends Record<string, u
     private handleAuthenticate;
     private handleJoin;
     private handleLeave;
+    /** Local delivery and fan-out live in WebSocketDeliveryHelper - kept public here by delegation. */
     sendToClient(opts: {
         clientId: string;
         event: string;
         data: unknown;
         doLog?: boolean;
     }): void;
-    private sendToClientAsync;
-    private deliverToSocket;
     sendToUser(opts: {
         userId: string;
         event: string;
         data: unknown;
     }): void;
-    private sendToRoomExcluding;
     sendToRoom(opts: {
         room: string;
         event: string;
         data: unknown;
         exclude?: string[];
     }): void;
-    private broadcastExcluding;
     broadcast(opts: {
         event: string;
         data: unknown;

package/dist/cjs/modules/socket/websocket/server/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/helper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/helper.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/socket/websocket/server/helper.js

@@ -5,9 +5,9 @@ const common_1 = require("../../../../common");
 const base_1 = require("../../../../modules/base");
 const error_1 = require("../../../../modules/error");
 const redis_1 = require("../../../../modules/redis");
-const utilities_1 = require("../../../../utilities");
 const promise_utility_1 = require("../../../../utilities/promise.utility");
 const common_2 = require("../common");
+const delivery_1 = require("./delivery");
 class WebSocketServerHelper extends base_1.BaseHelper {
     /**
      * Narrows an untrusted room payload to the strings it actually contains.
@@ -31,14 +31,12 @@ class WebSocketServerHelper extends base_1.BaseHelper {
         this.heartbeatTimer = null;
         this.identifier = opts.identifier;
         this.path = opts.path ?? common_2.WebSocketDefaults.PATH;
-        this.server = opts.server;
         this.serverId = crypto.randomUUID();
         this.authenticateFn = opts.authenticateFn;
         this.validateRoomFn = opts.validateRoomFn;
         this.onClientConnected = opts.clientConnectedFn;
         this.onClientDisconnected = opts.clientDisconnectedFn;
         this.messageHandler = opts.messageHandler;
-        this.outboundTransformer = opts.outboundTransformer;
         this.handshakeFn = opts.handshakeFn;
         this.defaultRooms = opts.defaultRooms ?? [
             common_2.WebSocketDefaults.ROOM,
@@ -53,8 +51,15 @@ class WebSocketServerHelper extends base_1.BaseHelper {
         this.authTimeout = opts.authTimeout ?? common_2.WebSocketDefaults.AUTH_TIMEOUT;
         this.heartbeatInterval = opts.heartbeatInterval ?? common_2.WebSocketDefaults.HEARTBEAT_INTERVAL;
         this.heartbeatTimeout = opts.heartbeatTimeout ?? common_2.WebSocketDefaults.HEARTBEAT_TIMEOUT;
-        this.encryptedBatchLimit = opts.encryptedBatchLimit ?? common_2.WebSocketDefaults.ENCRYPTED_BATCH_LIMIT;
         this.requireEncryption = opts.requireEncryption ?? false;
+        this.delivery = new delivery_1.WebSocketDeliveryHelper({
+            server: opts.server,
+            clients: this.clients,
+            users: this.users,
+            rooms: this.rooms,
+            outboundTransformer: opts.outboundTransformer,
+            encryptedBatchLimit: opts.encryptedBatchLimit ?? common_2.WebSocketDefaults.ENCRYPTED_BATCH_LIMIT,
+        });
         this.initRedisClients(opts.redisConnection);
     }
     initRedisClients(redisConnection) {
@@ -644,190 +649,18 @@ class WebSocketServerHelper extends base_1.BaseHelper {
         }
         logger.info('Left rooms | id: %s | rooms: %j', clientId, validRooms);
     }
+    /** Local delivery and fan-out live in WebSocketDeliveryHelper - kept public here by delegation. */
     sendToClient(opts) {
-        const logger = this.logger.for(this.sendToClient.name);
-        const { clientId, event, data, doLog } = opts;
-        const client = this.clients.get(clientId);
-        if (!client) {
-            return;
-        }
-        // Async path - transformer intercepts before socket.send()
-        const outboundTransformer = this.outboundTransformer;
-        if (outboundTransformer && client.encrypted) {
-            Promise.resolve()
-                .then(() => outboundTransformer({ client, event, data }))
-                .then(transformed => {
-                const outboundMessage = transformed ?? { event, data };
-                this.deliverToSocket({
-                    client,
-                    payload: JSON.stringify(outboundMessage),
-                    doLog,
-                    event,
-                    data,
-                });
-            })
-                .catch(error => {
-                logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);
-            });
-            return;
-        }
-        // Sync path (unchanged, zero overhead when no transformer)
-        this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });
-    }
-    async sendToClientAsync(opts) {
-        const { clientId, event, data } = opts;
-        const client = this.clients.get(clientId);
-        if (!client) {
-            return Promise.resolve();
-        }
-        if (!this.outboundTransformer || !client.encrypted) {
-            this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });
-            return Promise.resolve();
-        }
-        try {
-            const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));
-            const outboundMessage = transformed ?? { event, data };
-            this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });
-        }
-        catch (error) {
-            this.logger
-                .for(this.sendToClientAsync.name)
-                .error('Outbound transformer error | id: %s | error: %s', clientId, error);
-        }
-    }
-    deliverToSocket(opts) {
-        const logger = this.logger.for(this.deliverToSocket.name);
-        const { client, payload, doLog, event, data } = opts;
-        try {
-            const result = client.socket.send(payload);
-            if (result === 0) {
-                logger.warn('Message dropped (socket closed) | id: %s', client.id);
-            }
-            if (result === -1) {
-                client.backpressured = true;
-                logger.warn('Backpressure detected | id: %s', client.id);
-            }
-        }
-        catch (error) {
-            logger.error('Failed to send | id: %s | error: %s', client.id, error);
-        }
-        if (doLog) {
-            logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);
-        }
+        this.delivery.sendToClient(opts);
     }
     sendToUser(opts) {
-        const { userId, event, data } = opts;
-        const clientIds = this.users.get(userId);
-        if (!clientIds) {
-            return;
-        }
-        for (const clientId of clientIds) {
-            this.sendToClient({ clientId, event, data });
-        }
-    }
-    sendToRoomExcluding(opts) {
-        const { room, event, data, exclude } = opts;
-        const excludeSet = new Set(exclude);
-        const roomClientIds = this.rooms.get(room);
-        if (!roomClientIds) {
-            return;
-        }
-        // Serialised ONCE when there is no transformer, because the payload is then identical for every
-        // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that
-        // never differs. With a transformer each client's payload really is different, so that path
-        // still goes through `sendToClient`. The non-excluding fan-out already works this way.
-        if (!this.outboundTransformer) {
-            const payload = JSON.stringify({ event, data });
-            for (const clientId of roomClientIds) {
-                if (excludeSet.has(clientId)) {
-                    continue;
-                }
-                const client = this.clients.get(clientId);
-                if (client) {
-                    this.deliverToSocket({ client, payload, event, data });
-                }
-            }
-            return;
-        }
-        for (const clientId of roomClientIds) {
-            if (excludeSet.has(clientId)) {
-                continue;
-            }
-            this.sendToClient({ clientId, event, data });
-        }
+        this.delivery.sendToUser(opts);
     }
     sendToRoom(opts) {
-        const { room, event, data, exclude } = opts;
-        // When exclude is present, must iterate - can't exclude from Bun native pub/sub
-        if (exclude?.length) {
-            this.sendToRoomExcluding({ room, event, data, exclude });
-            return;
-        }
-        // No encryption - Bun native pub/sub O(1) C++ fan-out
-        if (!this.outboundTransformer) {
-            const payload = JSON.stringify({ event, data });
-            this.server.publish(room, payload);
-            return;
-        }
-        // Encryption enabled - iterate all clients individually with concurrency limit
-        const roomClientIds = this.rooms.get(room);
-        if (!roomClientIds) {
-            return;
-        }
-        const tasks = [];
-        for (const clientId of roomClientIds) {
-            tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
-        }
-        if (tasks.length) {
-            (0, promise_utility_1.voidExecution)({
-                logger: this.logger,
-                scope: this.sendToRoom.name,
-                execution: (0, utilities_1.executePromiseWithLimit)({ tasks, limit: this.encryptedBatchLimit }),
-            });
-        }
-    }
-    broadcastExcluding(opts) {
-        const { event, data, exclude } = opts;
-        const excludeSet = new Set(exclude);
-        for (const [clientId, client] of this.clients) {
-            if (excludeSet.has(clientId)) {
-                continue;
-            }
-            // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)
-            if (client.state !== common_2.WebSocketClientStates.AUTHENTICATED) {
-                continue;
-            }
-            this.sendToClient({ clientId, event, data });
-        }
+        this.delivery.sendToRoom(opts);
     }
     broadcast(opts) {
-        const { event, data, exclude } = opts;
-        // When exclude is present, must iterate - can't exclude from Bun native pub/sub
-        if (exclude?.length) {
-            this.broadcastExcluding({ event, data, exclude });
-            return;
-        }
-        // No encryption - Bun native pub/sub O(1) C++ fan-out
-        if (!this.outboundTransformer) {
-            const payload = JSON.stringify({ event, data });
-            this.server.publish(common_2.WebSocketDefaults.BROADCAST_TOPIC, payload);
-            return;
-        }
-        // Encryption enabled - iterate all clients individually with concurrency limit
-        const tasks = [];
-        for (const [clientId, client] of this.clients) {
-            if (client.state !== common_2.WebSocketClientStates.AUTHENTICATED) {
-                continue;
-            }
-            tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
-        }
-        if (tasks.length) {
-            (0, promise_utility_1.voidExecution)({
-                logger: this.logger,
-                scope: this.broadcast.name,
-                execution: (0, utilities_1.executePromiseWithLimit)({ tasks, limit: this.encryptedBatchLimit }),
-            });
-        }
+        this.delivery.broadcast(opts);
     }
     send(opts) {
         const logger = this.logger.for(this.send.name);