actor-ts 0.10.0 → 0.11.0

package/dist/http/{ws/WsConnection.d.ts → websocket/WebsocketConnection.d.ts}

@@ -11,49 +11,49 @@
  */
 import { ActorPath } from '../../ActorPath.js';
 import { ActorRef } from '../../ActorRef.js';
-import { type WebSocketSocketAdapter } from './SocketAdapter.js';
-import type { WsFrame, WsUpgradeInfo } from './types.js';
+import { type WebsocketSocketAdapter } from './SocketAdapter.js';
+import type { WebsocketFrame, WebsocketUpgradeInfo } from './types.js';
 /**
- * Outbound command a {@link WsConnection} enqueues to its per-connection
+ * Outbound command a {@link WebsocketConnection} enqueues to its per-connection
  * actor.  Defined here (the producer) so the connection actor imports it
  * from the connection module, not the other way round.
  */
-export type WsOutboundCommand<TOut> = {
+export type WebsocketOutboundCommand<TOut> = {
     readonly _cmd: 'out';
     readonly msg: TOut;
 } | {
     readonly _cmd: 'out-raw';
-    readonly frame: WsFrame;
+    readonly frame: WebsocketFrame;
 } | {
     readonly _cmd: 'close';
     readonly code: number;
     readonly reason: string;
 };
-export interface WsConnection<TOut> extends ActorRef<TOut> {
+export interface WebsocketConnection<TOut> extends ActorRef<TOut> {
     /** Stable id, unique within the process (e.g. `ws-7`). */
     readonly id: string;
     /** Remote peer address, if the backend reported one. */
     readonly remoteAddress?: string;
     /** Snapshot of the HTTP upgrade request (path, params, query, headers). */
-    readonly upgrade: WsUpgradeInfo;
+    readonly upgrade: WebsocketUpgradeInfo;
     /** Send a raw frame, bypassing the codec. */
-    sendRaw(frame: WsFrame): void;
+    sendRaw(frame: WebsocketFrame): void;
     /** Close this connection (1000 by default). */
     close(code?: number, reason?: string): void;
     /** `true` while the underlying socket is open. */
     readonly isOpen: boolean;
 }
-export declare class WsConnectionImpl<TOut> extends ActorRef<TOut> implements WsConnection<TOut> {
+export declare class WebsocketConnectionImplementation<TOut> extends ActorRef<TOut> implements WebsocketConnection<TOut> {
     readonly id: string;
-    readonly upgrade: WsUpgradeInfo;
+    readonly upgrade: WebsocketUpgradeInfo;
     private readonly socket;
     private readonly connRef;
     readonly path: ActorPath;
-    constructor(id: string, upgrade: WsUpgradeInfo, socket: WebSocketSocketAdapter, connRef: ActorRef<WsOutboundCommand<TOut>>, systemName: string);
+    constructor(id: string, upgrade: WebsocketUpgradeInfo, socket: WebsocketSocketAdapter, connRef: ActorRef<WebsocketOutboundCommand<TOut>>, systemName: string);
     get remoteAddress(): string | undefined;
     get isOpen(): boolean;
     tell(msg: TOut): void;
-    sendRaw(frame: WsFrame): void;
+    sendRaw(frame: WebsocketFrame): void;
     close(code?: number, reason?: string): void;
 }
-//# sourceMappingURL=WsConnection.d.ts.map
+//# sourceMappingURL=WebsocketConnection.d.ts.map

package/dist/http/websocket/WebsocketConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketConnection.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,CAAC,IAAI,IACrC;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,mBAAmB,CAAC,IAAI,CAAE,SAAQ,QAAQ,CAAC,IAAI,CAAC;IAC/D,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,6CAA6C;IAC7C,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,+CAA+C;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iCAAiC,CAAC,IAAI,CAAE,SAAQ,QAAQ,CAAC,IAAI,CAAE,YAAW,mBAAmB,CAAC,IAAI,CAAC;IAI5G,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,OAAO,EAAE,oBAAoB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAGd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,oBAAoB,EACrB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAClE,UAAU,EAAE,MAAM;IAMpB,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEQ,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAI9B,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIpC,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;CAGtC"}

package/dist/http/{ws/WsConnection.js → websocket/WebsocketConnection.js}

@@ -11,8 +11,8 @@
  */
 import { ActorPath } from '../../ActorPath.js';
 import { ActorRef } from '../../ActorRef.js';
-import { WsReadyState } from './SocketAdapter.js';
-export class WsConnectionImpl extends ActorRef {
+import { WebsocketReadyState } from './SocketAdapter.js';
+export class WebsocketConnectionImplementation extends ActorRef {
     id;
     upgrade;
     socket;
@@ -30,7 +30,7 @@ export class WsConnectionImpl extends ActorRef {
         return this.upgrade.remoteAddress;
     }
     get isOpen() {
-        return this.socket.readyState === WsReadyState.OPEN;
+        return this.socket.readyState === WebsocketReadyState.OPEN;
     }
     tell(msg) {
         this.connRef.tell({ _cmd: 'out', msg });
@@ -42,4 +42,4 @@ export class WsConnectionImpl extends ActorRef {
         this.connRef.tell({ _cmd: 'close', code, reason });
     }
 }
-//# sourceMappingURL=WsConnection.js.map
+//# sourceMappingURL=WebsocketConnection.js.map

package/dist/http/websocket/WebsocketConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketConnection.js","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAA+B,MAAM,oBAAoB,CAAC;AA4BtF,MAAM,OAAO,iCAAwC,SAAQ,QAAc;IAI9D;IACA;IACQ;IACA;IANV,IAAI,CAAY;IAEzB,YACW,EAAU,EACV,OAA6B,EACrB,MAA8B,EAC9B,OAAiD,EAClE,UAAkB;QAElB,KAAK,EAAE,CAAC;QANC,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAsB;QACrB,WAAM,GAAN,MAAM,CAAwB;QAC9B,YAAO,GAAP,OAAO,CAA0C;QAIlE,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;IACpC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,mBAAmB,CAAC,IAAI,CAAC;IAC7D,CAAC;IAEQ,IAAI,CAAC,GAAS;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,KAAqB;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE;QAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/http/{ws/WebSocketConnectionActor.d.ts → websocket/WebsocketConnectionActor.d.ts}

@@ -1,6 +1,6 @@
 /**
  * Internal per-connection actor — a genuine child of the
- * {@link WebSocketServerActor} hub (spawned via the hub's context, so
+ * {@link WebsocketServerActor} hub (spawned via the hub's context, so
  * the actor tree is `server → conn-1, conn-2, …`).  Users never see or
  * manage it.
  *
@@ -9,7 +9,7 @@
  *     decodes each frame, and forwards the decoded message to the hub
  *     with this connection as the sender;
  *   - outbound: its mailbox is the connection's write queue — a
- *     {@link WsConnection}'s `tell` / `sendRaw` / `close` enqueue here,
+ *     {@link WebsocketConnection}'s `tell` / `sendRaw` / `close` enqueue here,
  *     and it encodes + writes to the socket (with a backpressure check);
  *   - lifecycle: on socket close it stops itself; `postStop` reports the
  *     disconnect to the hub exactly once and closes the socket.
@@ -19,33 +19,33 @@
  * than restarting into a dead socket.
  */
 import { Actor } from '../../Actor.js';
-import { type WebSocketSocketAdapter } from './SocketAdapter.js';
-import { type WsCodec } from './WsCodec.js';
-import { type WsOutboundCommand } from './WsConnection.js';
-import { type WsServerRef } from './WsMessages.js';
-import type { ResolvedWsPolicy } from './WsPolicy.js';
-import { type WsUpgradeInfo } from './types.js';
-export interface WebSocketConnectionDeps<TOut, TIn, TSelf> {
-    readonly socket: WebSocketSocketAdapter;
-    readonly codec: WsCodec<TOut, TIn>;
-    readonly policy: ResolvedWsPolicy;
-    readonly hub: WsServerRef<TOut, TIn, TSelf>;
+import { type WebsocketSocketAdapter } from './SocketAdapter.js';
+import { type WebsocketCodec } from './WebsocketCodec.js';
+import { type WebsocketOutboundCommand } from './WebsocketConnection.js';
+import { type WebsocketServerRef } from './WebsocketMessages.js';
+import type { ResolvedWebsocketPolicy } from './WebsocketPolicy.js';
+import { type WebsocketUpgradeInfo } from './types.js';
+export interface WebsocketConnectionDeps<TOut, TIn, TSelf> {
+    readonly socket: WebsocketSocketAdapter;
+    readonly codec: WebsocketCodec<TOut, TIn>;
+    readonly policy: ResolvedWebsocketPolicy;
+    readonly hub: WebsocketServerRef<TOut, TIn, TSelf>;
     readonly id: string;
-    readonly upgrade: WsUpgradeInfo;
+    readonly upgrade: WebsocketUpgradeInfo;
 }
-export declare class WebSocketConnectionActor<TOut, TIn, TSelf = never> extends Actor<WsOutboundCommand<TOut>> {
+export declare class WebsocketConnectionActor<TOut, TIn, TSelf = never> extends Actor<WebsocketOutboundCommand<TOut>> {
     private readonly d;
     private connection;
     private closed;
     private disconnectReported;
     private closeInfo;
-    constructor(deps: WebSocketConnectionDeps<TOut, TIn, TSelf>);
+    constructor(deps: WebsocketConnectionDeps<TOut, TIn, TSelf>);
     preStart(): void;
-    onReceive(cmd: WsOutboundCommand<TOut>): void;
+    onReceive(cmd: WebsocketOutboundCommand<TOut>): void;
     postStop(): void;
     private handleInbound;
     private handleClose;
     private write;
     private closeSocket;
 }
-//# sourceMappingURL=WebSocketConnectionActor.d.ts.map
+//# sourceMappingURL=WebsocketConnectionActor.d.ts.map

package/dist/http/websocket/WebsocketConnectionActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketConnectionActor.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketConnectionActor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAA+D,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACtI,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK;IACvD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,qBAAa,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CAC5D,SAAQ,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAA4C;IAC9D,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAAmC;gBAExC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;IAKlD,QAAQ,IAAI,IAAI;IAahB,SAAS,CAAC,GAAG,EAAE,wBAAwB,CAAC,IAAI,CAAC,GAAG,IAAI;IA0BpD,QAAQ,IAAI,IAAI;IAiBzB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,WAAW;CAOpB"}

package/dist/http/{ws/WebSocketConnectionActor.js → websocket/WebsocketConnectionActor.js}

@@ -1,6 +1,6 @@
 /**
  * Internal per-connection actor — a genuine child of the
- * {@link WebSocketServerActor} hub (spawned via the hub's context, so
+ * {@link WebsocketServerActor} hub (spawned via the hub's context, so
  * the actor tree is `server → conn-1, conn-2, …`).  Users never see or
  * manage it.
  *
@@ -9,7 +9,7 @@
  *     decodes each frame, and forwards the decoded message to the hub
  *     with this connection as the sender;
  *   - outbound: its mailbox is the connection's write queue — a
- *     {@link WsConnection}'s `tell` / `sendRaw` / `close` enqueue here,
+ *     {@link WebsocketConnection}'s `tell` / `sendRaw` / `close` enqueue here,
  *     and it encodes + writes to the socket (with a backpressure check);
  *   - lifecycle: on socket close it stops itself; `postStop` reports the
  *     disconnect to the hub exactly once and closes the socket.
@@ -19,12 +19,12 @@
  * than restarting into a dead socket.
  */
 import { Actor } from '../../Actor.js';
-import { WsReadyState } from './SocketAdapter.js';
-import { WsDecodeError } from './WsCodec.js';
-import { WsConnectionImpl } from './WsConnection.js';
-import { WsConnectedSignal, WsDataSignal, WsDisconnectedSignal, WsInvalidSignal, } from './WsMessages.js';
+import { WebsocketReadyState } from './SocketAdapter.js';
+import { WebsocketDecodeError } from './WebsocketCodec.js';
+import { WebsocketConnectionImplementation } from './WebsocketConnection.js';
+import { websocketConnectedSignal, websocketDataSignal, websocketDisconnectedSignal, websocketInvalidSignal, } from './WebsocketMessages.js';
 import { frameByteLength, normalizeInbound, } from './types.js';
-export class WebSocketConnectionActor extends Actor {
+export class WebsocketConnectionActor extends Actor {
     d;
     connection = null;
     closed = false;
@@ -35,20 +35,20 @@ export class WebSocketConnectionActor extends Actor {
         this.d = deps;
     }
     preStart() {
-        const conn = new WsConnectionImpl(this.d.id, this.d.upgrade, this.d.socket, this.self, this.system.name);
+        const conn = new WebsocketConnectionImplementation(this.d.id, this.d.upgrade, this.d.socket, this.self, this.system.name);
         this.connection = conn;
         // Tell the hub 'connected' BEFORE attaching listeners, so it is
         // mailbox-ordered before any inbound data flushed by setListeners.
-        this.d.hub.tell(new WsConnectedSignal(conn), conn);
+        this.d.hub.tell(websocketConnectedSignal(conn), conn);
         this.d.socket.setListeners({
             onMessage: (data) => this.handleInbound(data),
             onClose: (code, reason) => this.handleClose(code, reason),
-            onError: (err) => this.log.warn(`WebSocketConnectionActor ${this.d.id}: socket error: ${err.message}`),
+            onError: (err) => this.log.warn(`WebsocketConnectionActor ${this.d.id}: socket error: ${err.message}`),
         });
     }
     onReceive(cmd) {
         if (this.closed) {
-            this.log.debug(`WebSocketConnectionActor ${this.d.id}: command after close — ignored`);
+            this.log.debug(`WebsocketConnectionActor ${this.d.id}: command after close — ignored`);
             return;
         }
         switch (cmd._cmd) {
@@ -58,7 +58,7 @@ export class WebSocketConnectionActor extends Actor {
                     frame = this.d.codec.encode(cmd.msg);
                 }
                 catch (err) {
-                    this.log.error(`WebSocketConnectionActor ${this.d.id}: encode failed, dropping message: ${err.message}`);
+                    this.log.error(`WebsocketConnectionActor ${this.d.id}: encode failed, dropping message: ${err.message}`);
                     return;
                 }
                 this.write(frame);
@@ -79,7 +79,7 @@ export class WebSocketConnectionActor extends Actor {
         if (this.connection && !this.disconnectReported) {
             this.disconnectReported = true;
             const info = this.closeInfo ?? { code: 1011, reason: '', initiatedBy: 'error' };
-            this.d.hub.tell(new WsDisconnectedSignal(this.connection, info), this.connection);
+            this.d.hub.tell(websocketDisconnectedSignal(this.connection, info), this.connection);
         }
         if (!this.closed) {
             this.closed = true;
@@ -93,7 +93,7 @@ export class WebSocketConnectionActor extends Actor {
     handleInbound(data) {
         const frame = normalizeInbound(data);
         if (!frame) {
-            this.log.warn(`WebSocketConnectionActor ${this.d.id}: unrecognised inbound frame type — dropped`);
+            this.log.warn(`WebsocketConnectionActor ${this.d.id}: unrecognised inbound frame type — dropped`);
             return;
         }
         if (frameByteLength(frame) > this.d.policy.maxFrameBytes) {
@@ -101,7 +101,7 @@ export class WebSocketConnectionActor extends Actor {
                 this.closeSocket(1009, 'message too big');
             }
             else {
-                this.log.warn(`WebSocketConnectionActor ${this.d.id}: dropped oversize inbound frame (> ${this.d.policy.maxFrameBytes} bytes)`);
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: dropped oversize inbound frame (> ${this.d.policy.maxFrameBytes} bytes)`);
             }
             return;
         }
@@ -110,19 +110,19 @@ export class WebSocketConnectionActor extends Actor {
             decoded = this.d.codec.decode(frame);
         }
         catch (err) {
-            const decodeErr = err instanceof WsDecodeError ? err : new WsDecodeError(String(err), frame);
+            const decodeErr = err instanceof WebsocketDecodeError ? err : new WebsocketDecodeError(String(err), frame);
             if (this.d.policy.onInvalidMessage === 'close') {
                 this.closeSocket(1003, 'unsupported data');
             }
             else if (this.d.policy.onInvalidMessage === 'hook') {
-                this.d.hub.tell(new WsInvalidSignal(this.connection, decodeErr), this.connection);
+                this.d.hub.tell(websocketInvalidSignal(this.connection, decodeErr), this.connection);
             }
             else {
-                this.log.warn(`WebSocketConnectionActor ${this.d.id}: invalid inbound message — dropped: ${decodeErr.message}`);
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: invalid inbound message — dropped: ${decodeErr.message}`);
             }
             return;
         }
-        this.d.hub.tell(new WsDataSignal(this.connection, decoded), this.connection);
+        this.d.hub.tell(websocketDataSignal(this.connection, decoded), this.connection);
     }
     handleClose(code, reason) {
         if (this.closed)
@@ -132,18 +132,18 @@ export class WebSocketConnectionActor extends Actor {
     }
     /* ------------------------------ outbound ------------------------------ */
     write(frame) {
-        if (this.d.socket.readyState !== WsReadyState.OPEN) {
-            this.log.debug(`WebSocketConnectionActor ${this.d.id}: write on non-open socket — dropped`);
+        if (this.d.socket.readyState !== WebsocketReadyState.OPEN) {
+            this.log.debug(`WebsocketConnectionActor ${this.d.id}: write on non-open socket — dropped`);
             return;
         }
         const buffered = this.d.socket.bufferedAmount?.();
         if (buffered !== undefined && buffered > this.d.policy.maxBufferedBytes) {
             if (this.d.policy.onBackpressure === 'close') {
-                this.log.warn(`WebSocketConnectionActor ${this.d.id}: send buffer ${buffered} > ${this.d.policy.maxBufferedBytes} — closing`);
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: send buffer ${buffered} > ${this.d.policy.maxBufferedBytes} — closing`);
                 this.closeSocket(1013, 'try again later');
             }
             else {
-                this.log.warn(`WebSocketConnectionActor ${this.d.id}: send buffer ${buffered} > ${this.d.policy.maxBufferedBytes} — dropping frame`);
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: send buffer ${buffered} > ${this.d.policy.maxBufferedBytes} — dropping frame`);
             }
             return;
         }
@@ -151,7 +151,7 @@ export class WebSocketConnectionActor extends Actor {
             this.d.socket.send(frame.data);
         }
         catch (err) {
-            this.log.warn(`WebSocketConnectionActor ${this.d.id}: send failed: ${err.message}`);
+            this.log.warn(`WebsocketConnectionActor ${this.d.id}: send failed: ${err.message}`);
         }
     }
     closeSocket(code, reason) {
@@ -167,4 +167,4 @@ export class WebSocketConnectionActor extends Actor {
         this.context.stopSelf();
     }
 }
-//# sourceMappingURL=WebSocketConnectionActor.js.map
+//# sourceMappingURL=WebsocketConnectionActor.js.map

package/dist/http/websocket/WebsocketConnectionActor.js.map

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

package/dist/http/websocket/WebsocketMessages.d.ts

@@ -0,0 +1,115 @@
+/**
+ * The internal envelopes that flow into a {@link WebsocketServerActor}'s or
+ * {@link WebsocketClientActor}'s mailbox.  Like the typed-actor `Signal`
+ * and the broker commands, these are `kind`-tagged plain objects —
+ * dispatch is a single uniform `kind` switch, never `instanceof`.  Users
+ * never construct or match these; the base class fans them out to
+ * `onMessage` / `onClient*` / `onConnected` hooks.
+ *
+ * Delivering lifecycle events *through the mailbox* (rather than via
+ * out-of-band callbacks) preserves the actor's single-threaded guarantee
+ * and gives a strict per-connection order: connected → messages (in
+ * order) → disconnected.
+ */
+import type { ActorRef } from '../../ActorRef.js';
+import type { Props } from '../../Props.js';
+import type { WebsocketDecodeError } from './WebsocketCodec.js';
+import type { WebsocketConnection } from './WebsocketConnection.js';
+import type { WebsocketCloseInfo } from './types.js';
+/**
+ * Command — ask the hub to spawn a per-connection actor as its own child.
+ * Sent by the wiring layer at upgrade time; the hub does `context.spawn(
+ * props, name)` so the connection actor is a genuine sub-actor of the
+ * server.  A command ("do X"), not a lifecycle signal.
+ */
+export interface WebsocketAcceptCommand {
+    readonly kind: 'websocket-accept';
+    readonly props: Props<unknown>;
+    readonly name: string;
+}
+/** @internal */
+export declare function websocketAcceptCommand(props: Props<unknown>, name: string): WebsocketAcceptCommand;
+/** Signal — a connection opened. */
+export interface WebsocketConnectedSignal<TOut> {
+    readonly kind: 'websocket-connected';
+    readonly connection: WebsocketConnection<TOut>;
+}
+/** @internal */
+export declare function websocketConnectedSignal<TOut>(connection: WebsocketConnection<TOut>): WebsocketConnectedSignal<TOut>;
+/** Signal — a decoded message arrived on a connection. */
+export interface WebsocketDataSignal<TOut, TIn> {
+    readonly kind: 'websocket-data';
+    readonly connection: WebsocketConnection<TOut>;
+    readonly message: TIn;
+}
+/** @internal */
+export declare function websocketDataSignal<TOut, TIn>(connection: WebsocketConnection<TOut>, message: TIn): WebsocketDataSignal<TOut, TIn>;
+/** Signal — a connection closed. */
+export interface WebsocketDisconnectedSignal<TOut> {
+    readonly kind: 'websocket-disconnected';
+    readonly connection: WebsocketConnection<TOut>;
+    readonly info: WebsocketCloseInfo;
+}
+/** @internal */
+export declare function websocketDisconnectedSignal<TOut>(connection: WebsocketConnection<TOut>, info: WebsocketCloseInfo): WebsocketDisconnectedSignal<TOut>;
+/** Signal — an inbound frame that failed to decode. */
+export interface WebsocketInvalidSignal<TOut> {
+    readonly kind: 'websocket-invalid';
+    readonly connection: WebsocketConnection<TOut>;
+    readonly error: WebsocketDecodeError;
+}
+/** @internal */
+export declare function websocketInvalidSignal<TOut>(connection: WebsocketConnection<TOut>, error: WebsocketDecodeError): WebsocketInvalidSignal<TOut>;
+/** Lifecycle/data signals delivered to a hub actor's mailbox. */
+export type WebsocketServerSignal<TOut, TIn> = WebsocketConnectedSignal<TOut> | WebsocketDataSignal<TOut, TIn> | WebsocketDisconnectedSignal<TOut> | WebsocketInvalidSignal<TOut>;
+/**
+ * Full mailbox type of a hub actor: the accept command, the internal
+ * signals, plus any application messages (`TSelf`) other actors may
+ * `tell` it — e.g. a ticker that triggers a broadcast.  `TSelf` defaults
+ * to `never`.
+ */
+export type WebsocketServerMessage<TOut, TIn, TSelf = never> = TSelf | WebsocketAcceptCommand | WebsocketServerSignal<TOut, TIn>;
+/** Convenience alias for a reference to a hub actor. */
+export type WebsocketServerRef<TOut, TIn, TSelf = never> = ActorRef<WebsocketServerMessage<TOut, TIn, TSelf>>;
+/** Command — push a typed outbound message through a client actor's ref. */
+export interface WebsocketClientSend<TOut> {
+    readonly kind: 'websocket-client-send';
+    readonly message: TOut;
+}
+/** Signal — a decoded inbound message from the server. */
+export interface WebsocketClientInbound<TIn> {
+    readonly kind: 'websocket-client-inbound';
+    readonly message: TIn;
+}
+/** Signal — an inbound frame that failed to decode. */
+export interface WebsocketClientInvalid {
+    readonly kind: 'websocket-client-invalid';
+    readonly error: WebsocketDecodeError;
+}
+/** Signal — the connection (re)opened. */
+export interface WebsocketClientConnected {
+    readonly kind: 'websocket-client-connected';
+}
+/** Signal — the connection dropped (a reconnect cycle may follow). */
+export interface WebsocketClientDisconnected {
+    readonly kind: 'websocket-client-disconnected';
+    readonly cause?: Error;
+}
+/** Lifecycle/data signals delivered to a client actor's mailbox. */
+export type WebsocketClientSignal<TIn> = WebsocketClientInbound<TIn> | WebsocketClientInvalid | WebsocketClientConnected | WebsocketClientDisconnected;
+/**
+ * Full mailbox type of a client actor: the outbound-send command, the
+ * internal signals, plus any application messages (`TSelf`).
+ */
+export type WebsocketClientMessage<TOut, TIn, TSelf = never> = TSelf | WebsocketClientSend<TOut> | WebsocketClientSignal<TIn>;
+/** @internal */
+export declare function websocketClientInbound<TIn>(message: TIn): WebsocketClientInbound<TIn>;
+/** @internal */
+export declare function websocketClientInvalid(error: WebsocketDecodeError): WebsocketClientInvalid;
+/** @internal */
+export declare function websocketClientConnected(): WebsocketClientConnected;
+/** @internal */
+export declare function websocketClientDisconnected(cause?: Error): WebsocketClientDisconnected;
+/** Push a typed outbound message through a client actor's ref: `ref.tell(websocketSend(m))`. */
+export declare function websocketSend<TOut>(message: TOut): WebsocketClientSend<TOut>;
+//# sourceMappingURL=WebsocketMessages.d.ts.map

package/dist/http/websocket/WebsocketMessages.d.ts.map

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

package/dist/http/websocket/WebsocketMessages.js

@@ -0,0 +1,41 @@
+/** @internal */
+export function websocketAcceptCommand(props, name) {
+    return { kind: 'websocket-accept', props, name };
+}
+/** @internal */
+export function websocketConnectedSignal(connection) {
+    return { kind: 'websocket-connected', connection };
+}
+/** @internal */
+export function websocketDataSignal(connection, message) {
+    return { kind: 'websocket-data', connection, message };
+}
+/** @internal */
+export function websocketDisconnectedSignal(connection, info) {
+    return { kind: 'websocket-disconnected', connection, info };
+}
+/** @internal */
+export function websocketInvalidSignal(connection, error) {
+    return { kind: 'websocket-invalid', connection, error };
+}
+/** @internal */
+export function websocketClientInbound(message) {
+    return { kind: 'websocket-client-inbound', message };
+}
+/** @internal */
+export function websocketClientInvalid(error) {
+    return { kind: 'websocket-client-invalid', error };
+}
+/** @internal */
+export function websocketClientConnected() {
+    return { kind: 'websocket-client-connected' };
+}
+/** @internal */
+export function websocketClientDisconnected(cause) {
+    return { kind: 'websocket-client-disconnected', cause };
+}
+/** Push a typed outbound message through a client actor's ref: `ref.tell(websocketSend(m))`. */
+export function websocketSend(message) {
+    return { kind: 'websocket-client-send', message };
+}
+//# sourceMappingURL=WebsocketMessages.js.map

package/dist/http/websocket/WebsocketMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketMessages.js","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketMessages.ts"],"names":[],"mappings":"AAgCA,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAAC,KAAqB,EAAE,IAAY;IACxE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAOD,gBAAgB;AAChB,MAAM,UAAU,wBAAwB,CACtC,UAAqC;IAErC,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC;AAQD,gBAAgB;AAChB,MAAM,UAAU,mBAAmB,CACjC,UAAqC,EACrC,OAAY;IAEZ,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC;AAQD,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CACzC,UAAqC,EACrC,IAAwB;IAExB,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC;AAQD,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CACpC,UAAqC,EACrC,KAA2B;IAE3B,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAkED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAAM,OAAY;IACtD,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,CAAC;AACvD,CAAC;AACD,gBAAgB;AAChB,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AACD,gBAAgB;AAChB,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;AAChD,CAAC;AACD,gBAAgB;AAChB,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,OAAO,EAAE,IAAI,EAAE,+BAA+B,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAO,OAAa;IAC/C,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/http/{ws/WsPolicy.d.ts → websocket/WebsocketPolicy.d.ts}

@@ -5,28 +5,47 @@
  * > built-in defaults.  The codec and target ref are code, never config.
  */
 import type { ActorSystem } from '../../ActorSystem.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
 /** What to do with an inbound frame that exceeds `maxFrameBytes`. */
 export type OversizeFramePolicy = 'close' | 'drop';
 /** What to do with an inbound frame the codec can't decode. */
 export type InvalidMessagePolicy = 'close' | 'drop' | 'hook';
 /** What to do when a slow consumer's send buffer exceeds `maxBufferedBytes`. */
 export type BackpressurePolicy = 'drop' | 'close';
-export interface ResolvedWsPolicy {
+export interface ResolvedWebsocketPolicy {
     readonly maxFrameBytes: number;
     readonly onOversizeFrame: OversizeFramePolicy;
     readonly onInvalidMessage: InvalidMessagePolicy;
     readonly maxBufferedBytes: number;
     readonly onBackpressure: BackpressurePolicy;
+    /**
+     * Max concurrent connections admitted per route.  A new upgrade beyond
+     * this is closed with 1013 ("try again later") instead of being wired
+     * (security audit WS-5).  `Infinity` (the default) = unlimited.
+     */
+    readonly maxConnections: number;
 }
 /** Fields a `websocket()` route may override; everything else falls back. */
-export interface WebSocketPolicyOptions {
+export interface WebsocketPolicyOptions {
     readonly maxFrameBytes?: number;
     readonly onOversizeFrame?: OversizeFramePolicy;
     readonly onInvalidMessage?: InvalidMessagePolicy;
     readonly maxBufferedBytes?: number;
     readonly onBackpressure?: BackpressurePolicy;
+    readonly maxConnections?: number;
+}
+export declare const DEFAULT_WEBSOCKET_POLICY: ResolvedWebsocketPolicy;
+/**
+ * Validates the per-connection policy knobs — from any path (route options,
+ * HOCON, defaults) since it runs on the fully-resolved policy.  Rejections
+ * throw `OptionsError`, replacing the earlier HOCON-only bare-`Error` enum
+ * guard.  `maxConnections` admits `Infinity` (the unlimited default), which
+ * the generic `positiveInt` helper rejects, so its rule is bespoke.
+ */
+export declare class WebsocketPolicyOptionsValidator extends OptionsValidator<WebsocketPolicyOptions> {
+    constructor();
+    protected rules(s: Partial<WebsocketPolicyOptions>): void;
 }
-export declare const DEFAULT_WS_POLICY: ResolvedWsPolicy;
 /** Merge built-in defaults, HOCON server defaults, and per-route options. */
-export declare function resolveWsPolicy(system: ActorSystem, options: WebSocketPolicyOptions): ResolvedWsPolicy;
-//# sourceMappingURL=WsPolicy.d.ts.map
+export declare function resolveWebsocketPolicy(system: ActorSystem, options: WebsocketPolicyOptions): ResolvedWebsocketPolicy;
+//# sourceMappingURL=WebsocketPolicy.d.ts.map

package/dist/http/websocket/WebsocketPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketPolicy.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,CAAC;AACnD,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,wBAAwB,EAAE,uBAOtC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB,CAAC,sBAAsB,CAAC;;IAI3F,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;CAc1D;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CAgCpH"}