@venizia/ignis-helpers 0.2.0-2 → 0.2.0-20

package/dist/esm/modules/socket/socket-io/server/helper.d.ts

@@ -1,5 +1,5 @@
-import { ValueOrPromise } from '../../../../common/types.js';
-import { BaseHelper } from '../../../../modules/base.js';
+import { ValueOrPromise } from '../../../../common/types/index.js';
+import { BaseHelper } from '../../../base.js';
 import { Server as IOServer, Socket as IOSocket } from 'socket.io';
 import { ISocketIOClient, TSocketIOServerOptions } from '../common/index.js';
 export declare class SocketIOServerHelper extends BaseHelper {

package/dist/esm/modules/socket/socket-io/server/helper.js

@@ -1,8 +1,8 @@
 import { HTTP } from '../../../../common/index.js';
 import { RuntimeModules } from '../../../../common/constants/index.js';
-import { BaseHelper } from '../../../../modules/base.js';
-import { getError } from '../../../../modules/error/index.js';
-import { ensureRedisClientsConnecting, waitForRedisReady } from '../../../../modules/redis/index.js';
+import { BaseHelper } from '../../../base.js';
+import { getError } from '../../../error/index.js';
+import { ensureRedisClientsConnecting, waitForRedisReady } from '../../../redis/index.js';
 import { voidExecution } from '../../../../utilities/promise.utility.js';
 import { createAdapter } from '@socket.io/redis-adapter';
 import { Emitter } from '@socket.io/redis-emitter';

package/dist/esm/modules/socket/websocket/common/constants.d.ts

@@ -1,4 +1,4 @@
-import { TConstValue } from '../../../../common/types.js';
+import { TConstValue } from '../../../../common/types/index.js';
 export declare class WebSocketEvents {
     static readonly AUTHENTICATE = "authenticate";
     static readonly CONNECTED = "connected";

package/dist/esm/modules/socket/websocket/common/index.d.ts

@@ -1,3 +1,3 @@
 export * from './constants.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/socket/websocket/common/index.js

@@ -1,3 +1,3 @@
 export * from './constants.js';
-export * from './types.js';
+export * from './types/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/modules/socket/websocket/common/types/client.d.ts

@@ -0,0 +1,35 @@
+import { TConstValue } from '../../../../../common/types/index.js';
+import { WebSocketClientStates } from '../constants.js';
+export interface IWebSocket<T = unknown> {
+    readonly data: T;
+    readonly remoteAddress: string;
+    readonly readyState: number;
+    send(data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView, compress?: boolean): number;
+    subscribe(topic: string): void;
+    unsubscribe(topic: string): void;
+    isSubscribed(topic: string): boolean;
+    close(code?: number, reason?: string): void;
+    cork(callback: (ws: IWebSocket<T>) => void): void;
+}
+export type TWebSocketClientState = TConstValue<typeof WebSocketClientStates>;
+export interface IWebSocketClient<MetadataType extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    userId?: string;
+    socket: IWebSocket;
+    state: TWebSocketClientState;
+    rooms: Set<string>;
+    backpressured: boolean;
+    encrypted: boolean;
+    connectedAt: number;
+    lastActivity: number;
+    metadata?: MetadataType;
+    serverPublicKey?: string;
+    salt?: string;
+    authTimer?: ReturnType<typeof setTimeout>;
+}
+export interface IWebSocketData<MetadataType extends Record<string, unknown> = Record<string, unknown>> {
+    clientId: string;
+    userId?: string;
+    metadata?: MetadataType;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAG5B,IAAI,CACF,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,UAAU,GAAG,QAAQ,EACtE,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CAAC;IACV,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE9E,MAAM,WAAW,gBAAgB,CAC/B,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc,CAC7B,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB"}

package/dist/esm/modules/socket/websocket/common/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/esm/modules/socket/websocket/common/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/client.ts"],"names":[],"mappings":""}

package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts

@@ -0,0 +1,44 @@
+import { ValueOrPromise } from '../../../../../common/types/index.js';
+import { TNullable } from '@venizia/ignis-inversion';
+import { IWebSocketClient } from './client.js';
+import { IWebSocketMessage } from './message.js';
+export type TWebSocketAuthenticateFn<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: AuthDataType) => ValueOrPromise<{
+    userId?: string;
+    metadata?: MetadataType;
+} | null | false>;
+export type TWebSocketHandshakeFn<AuthDataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
+    clientId: string;
+    userId?: string;
+    data: AuthDataType;
+}) => ValueOrPromise<{
+    serverPublicKey: string;
+    salt: string;
+} | null | false>;
+export type TWebSocketValidateRoomFn = (opts: {
+    clientId: string;
+    userId?: string;
+    rooms: string[];
+}) => ValueOrPromise<string[]>;
+export type TWebSocketClientConnectedFn<MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
+    clientId: string;
+    userId?: string;
+    metadata?: MetadataType;
+}) => ValueOrPromise<void>;
+export type TWebSocketClientDisconnectedFn = (opts: {
+    clientId: string;
+    userId?: string;
+}) => ValueOrPromise<void>;
+export type TWebSocketMessageHandler = (opts: {
+    clientId: string;
+    userId?: string;
+    message: IWebSocketMessage;
+}) => ValueOrPromise<void>;
+export type TWebSocketOutboundTransformer<DataType = unknown, MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
+    client: IWebSocketClient<MetadataType>;
+    event: string;
+    data: DataType;
+}) => ValueOrPromise<TNullable<{
+    event: string;
+    data: DataType;
+}>>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,MAAM,wBAAwB,CAClC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpE,CACF,IAAI,EAAE,YAAY,KACf,cAAc,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;AAEjF,MAAM,MAAM,qBAAqB,CAC/B,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpE,CAAC,IAAI,EAAE;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;CACpB,KAAK,cAAc,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;AAE/B,MAAM,MAAM,2BAA2B,CACrC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpE,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;AAEnG,MAAM,MAAM,8BAA8B,GAAG,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;AAE3B,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;AAE3B,MAAM,MAAM,6BAA6B,CACvC,QAAQ,GAAG,OAAO,EAClB,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACpE,CAAC,IAAI,EAAE;IACT,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,KAAK,cAAc,CAAC,SAAS,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,CAAC"}

package/dist/esm/modules/socket/websocket/common/types/hooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/esm/modules/socket/websocket/common/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/hooks.ts"],"names":[],"mappings":""}

package/dist/esm/modules/socket/websocket/common/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './client.js';
+export * from './hooks.js';
+export * from './message.js';
+export * from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/esm/modules/socket/websocket/common/types/index.js

@@ -0,0 +1,5 @@
+export * from './client.js';
+export * from './hooks.js';
+export * from './message.js';
+export * from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/socket/websocket/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/esm/modules/socket/websocket/common/types/message.d.ts

@@ -0,0 +1,17 @@
+import { TWebSocketMessageType } from '../constants.js';
+/** Client <-> Server message envelope */
+export interface IWebSocketMessage<DataType = unknown> {
+    event: string;
+    data?: DataType;
+    id?: string;
+}
+/** Internal Redis pub/sub message envelope */
+export interface IRedisSocketMessage<DataType = unknown> {
+    serverId: string;
+    type: TWebSocketMessageType;
+    target?: string;
+    event: string;
+    data: DataType;
+    exclude?: string[];
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,yCAAyC;AACzC,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,OAAO;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/esm/modules/socket/websocket/common/types/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/esm/modules/socket/websocket/common/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/message.ts"],"names":[],"mappings":""}

package/dist/esm/modules/socket/websocket/common/types/server.d.ts

@@ -0,0 +1,49 @@
+import { IRedisHelper } from '../../../../redis/index.js';
+import { IWebSocket } from './client.js';
+import { TWebSocketAuthenticateFn, TWebSocketClientConnectedFn, TWebSocketClientDisconnectedFn, TWebSocketHandshakeFn, TWebSocketMessageHandler, TWebSocketOutboundTransformer, TWebSocketValidateRoomFn } from './hooks.js';
+export interface IBunServer {
+    readonly pendingWebSockets: number;
+    publish(topic: string, data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView, compress?: boolean): number;
+}
+/** Bun WebSocket native configuration options */
+export interface IBunWebSocketConfig {
+    perMessageDeflate?: boolean;
+    maxPayloadLength?: number;
+    idleTimeout?: number;
+    backpressureLimit?: number;
+    closeOnBackpressureLimit?: boolean;
+    sendPings?: boolean;
+    publishToSelf?: boolean;
+}
+/** Return type for getBunWebSocketHandler - handlers + config spread for server.reload() */
+export interface IBunWebSocketHandler extends IBunWebSocketConfig {
+    open: (socket: IWebSocket) => void;
+    message: (socket: IWebSocket, message: string | Buffer) => void;
+    close: (socket: IWebSocket, code: number, reason: string) => void;
+    drain: (socket: IWebSocket) => void;
+}
+export interface IWebSocketServerOptions<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> {
+    identifier: string;
+    path?: string;
+    redisConnection: IRedisHelper;
+    server: IBunServer;
+    defaultRooms?: string[];
+    serverOptions?: IBunWebSocketConfig;
+    authTimeout?: number;
+    heartbeatInterval?: number;
+    heartbeatTimeout?: number;
+    encryptedBatchLimit?: number;
+    requireEncryption?: boolean;
+    authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;
+    validateRoomFn?: TWebSocketValidateRoomFn;
+    clientConnectedFn?: TWebSocketClientConnectedFn<MetadataType>;
+    clientDisconnectedFn?: TWebSocketClientDisconnectedFn;
+    messageHandler?: TWebSocketMessageHandler;
+    outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;
+    handshakeFn?: TWebSocketHandshakeFn<AuthDataType>;
+}
+export interface IWebSocketEmitterOptions {
+    identifier?: string;
+    redisConnection: IRedisHelper;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,OAAO,CACL,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,GAAG,UAAU,GAAG,QAAQ,EACtE,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CAAC;CACX;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,4FAA4F;AAC5F,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB,CACtC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,YAAY,CAAC;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,cAAc,EAAE,wBAAwB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACrE,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC9D,oBAAoB,CAAC,EAAE,8BAA8B,CAAC;IACtD,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,mBAAmB,CAAC,EAAE,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3E,WAAW,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,YAAY,CAAC;CAC/B"}

package/dist/esm/modules/socket/websocket/common/types/server.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.js.map

package/dist/esm/modules/socket/websocket/common/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/server.ts"],"names":[],"mappings":""}

package/dist/esm/modules/socket/websocket/emitter/helper.d.ts

@@ -1,4 +1,4 @@
-import { BaseHelper } from '../../../../modules/base.js';
+import { BaseHelper } from '../../../base.js';
 import { IWebSocketEmitterOptions } from '../common/index.js';
 export declare class WebSocketEmitter extends BaseHelper {
     private redisPub;

package/dist/esm/modules/socket/websocket/emitter/helper.js

@@ -1,7 +1,7 @@
 import { HTTP } from '../../../../common/index.js';
-import { BaseHelper } from '../../../../modules/base.js';
-import { getError } from '../../../../modules/error/index.js';
-import { ensureRedisClientsConnecting, waitForRedisReady } from '../../../../modules/redis/index.js';
+import { BaseHelper } from '../../../base.js';
+import { getError } from '../../../error/index.js';
+import { ensureRedisClientsConnecting, waitForRedisReady } from '../../../redis/index.js';
 import { WebSocketChannels, WebSocketMessageTypes, } from '../common/index.js';
 const EMITTER_SERVER_ID = 'emitter';
 export class WebSocketEmitter extends BaseHelper {

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

@@ -0,0 +1,48 @@
+import { BaseHelper } from '../../../base.js';
+import { IBunServer, IWebSocketClient, TWebSocketOutboundTransformer } from '../common/index.js';
+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/esm/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/esm/modules/socket/websocket/server/delivery.js

@@ -0,0 +1,202 @@
+import { BaseHelper } from '../../../base.js';
+import { executePromiseWithLimit } from '../../../../utilities/index.js';
+import { voidExecution } from '../../../../utilities/promise.utility.js';
+import { WebSocketClientStates, WebSocketDefaults, } from '../common/index.js';
+/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */
+export class WebSocketDeliveryHelper extends 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) {
+            voidExecution({
+                logger: this.logger,
+                scope: this.sendToRoom.name,
+                execution: 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 !== 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(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 !== WebSocketClientStates.AUTHENTICATED) {
+                continue;
+            }
+            tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
+        }
+        if (tasks.length) {
+            voidExecution({
+                logger: this.logger,
+                scope: this.broadcast.name,
+                execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),
+            });
+        }
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/esm/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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAKL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAcnB,6GAA6G;AAC7G,MAAM,OAAO,uBAEX,SAAQ,UAAU;IAQlB,YAAY,IAAmD;QAC7D,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;QAE/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACpD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;IACtD,CAAC;IAED,YAAY,CAAC,IAAyE;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,2DAA2D;QAC3D,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACrD,IAAI,mBAAmB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5C,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxD,IAAI,CAAC,WAAW,CAAC,EAAE;gBAClB,MAAM,eAAe,GAAG,WAAW,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBACvD,IAAI,CAAC,eAAe,CAAC;oBACnB,MAAM;oBACN,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;oBACxC,KAAK;oBACL,KAAK;oBACL,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,KAAK,CAAC,EAAE;gBACb,MAAM,CAAC,KAAK,CAAC,iDAAiD,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnF,CAAC,CAAC,CAAC;YACL,OAAO;QACT,CAAC;QAED,2DAA2D;QAC3D,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,IAAwD;QACtF,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACnD,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7F,MAAM,eAAe,GAAG,WAAW,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACvD,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;iBAChC,KAAK,CAAC,iDAAiD,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAMvB;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE3C,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAsD;QAC/D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,IAK3B;QACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAE5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,gGAAgG;QAChG,+FAA+F;QAC/F,4FAA4F;QAC5F,uFAAuF;QACvF,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAEhD,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;gBACrC,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,SAAS;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC1C,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAED,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAwE;QACjF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAE5C,gFAAgF;QAChF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAA8B,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,+EAA+E;QAC/E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,aAAa,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAC3B,SAAS,EAAE,uBAAuB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAAyD;QAClF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YACD,wGAAwG;YACxG,IAAI,MAAM,CAAC,KAAK,KAAK,qBAAqB,CAAC,aAAa,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAA0D;QAClE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEtC,gFAAgF;QAChF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAA8B,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,+EAA+E;QAC/E,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,MAAM,CAAC,KAAK,KAAK,qBAAqB,CAAC,aAAa,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,aAAa,CAAC;gBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;gBAC1B,SAAS,EAAE,uBAAuB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

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

@@ -1,5 +1,5 @@
-import { ValueOrPromise } from '../../../../common/types.js';
-import { BaseHelper } from '../../../../modules/base.js';
+import { ValueOrPromise } from '../../../../common/types/index.js';
+import { BaseHelper } from '../../../base.js';
 import { IBunWebSocketHandler, IWebSocket, IWebSocketClient, IWebSocketServerOptions } from '../common/index.js';
 export declare class WebSocketServerHelper<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> extends BaseHelper {
     /**
@@ -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;