actor-ts 0.10.0 → 0.11.0

package/dist/http/types.js

@@ -30,10 +30,20 @@ export const Status = {
 export class HttpError extends Error {
     status;
     extra;
-    constructor(status, message, extra) {
+    headers;
+    constructor(status, message, extra, 
+    /**
+     * Response headers to emit alongside the error — e.g.
+     * `WWW-Authenticate` on a 401 or `Retry-After` on a 429.  Without
+     * this the value could only reach the body (`extra`), never the
+     * wire as a real header.  Names SHOULD be lower-case; backends emit
+     * them verbatim after the status and before the body.
+     */
+    headers) {
         super(message);
         this.status = status;
         this.extra = extra;
+        this.headers = headers;
         this.name = 'HttpError';
     }
 }

package/dist/http/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH,yEAAyE;AACzE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,GAAG;IACP,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;IACrB,KAAK,EAAE,GAAG;IACV,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,GAAG;IACf,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,gBAAgB,EAAE,GAAG;IACrB,QAAQ,EAAE,GAAG;IACb,oBAAoB,EAAE,GAAG;IACzB,gGAAgG;IAChG,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,UAAU,EAAE,GAAG;IACf,kBAAkB,EAAE,GAAG;CACf,CAAC;AAEX,4EAA4E;AAC5E,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEhB;IAEA;IAHlB,YACkB,MAAc,EAC9B,OAAe,EACC,KAAyC;QAEzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QAEd,UAAK,GAAL,KAAK,CAAoC;QAGzD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH,yEAAyE;AACzE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,GAAG;IACP,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;IACrB,KAAK,EAAE,GAAG;IACV,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,GAAG;IACf,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,gBAAgB,EAAE,GAAG;IACrB,QAAQ,EAAE,GAAG;IACb,oBAAoB,EAAE,GAAG;IACzB,gGAAgG;IAChG,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,UAAU,EAAE,GAAG;IACf,kBAAkB,EAAE,GAAG;CACf,CAAC;AAEX,4EAA4E;AAC5E,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEhB;IAEA;IAQA;IAXlB,YACkB,MAAc,EAC9B,OAAe,EACC,KAAyC;IACzD;;;;;;OAMG;IACa,OAA0C;QAE1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAZC,WAAM,GAAN,MAAM,CAAQ;QAEd,UAAK,GAAL,KAAK,CAAoC;QAQzC,YAAO,GAAP,OAAO,CAAmC;QAG1D,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

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

@@ -2,7 +2,7 @@
  * Shared connection-wiring layer.  Everything that turns an accepted
  * upgrade into a live actor-backed connection lives here, so the three
  * HTTP backends stay thin (they only produce a
- * {@link WebSocketSocketAdapter}).
+ * {@link WebsocketSocketAdapter}).
  *
  * This file grows across the WebSocket work:
  *   - {@link ConnectionTracker} / {@link trackSocket} — shutdown bookkeeping
@@ -12,10 +12,10 @@
  */
 import type { ActorSystem } from '../../ActorSystem.js';
 import type { HttpRequest } from '../types.js';
-import type { WebSocketSocketAdapter } from './SocketAdapter.js';
-import { type WsServerRef } from './WsMessages.js';
-import type { WsCodec } from './WsCodec.js';
-import type { ResolvedWsPolicy } from './WsPolicy.js';
+import type { WebsocketSocketAdapter } from './SocketAdapter.js';
+import { type WebsocketServerRef } from './WebsocketMessages.js';
+import type { WebsocketCodec } from './WebsocketCodec.js';
+import type { ResolvedWebsocketPolicy } from './WebsocketPolicy.js';
 /**
  * Tracks the live server-side sockets of one binding so `unbind()` can
  * close them.  Without this a long-lived WebSocket keeps the HTTP
@@ -23,8 +23,8 @@ import type { ResolvedWsPolicy } from './WsPolicy.js';
  */
 export declare class ConnectionTracker {
     private readonly sockets;
-    add(socket: WebSocketSocketAdapter): void;
-    remove(socket: WebSocketSocketAdapter): void;
+    add(socket: WebsocketSocketAdapter): void;
+    remove(socket: WebsocketSocketAdapter): void;
     get size(): number;
     /** Send a polite close frame to every tracked socket (best-effort). */
     closeAll(code?: number, reason?: string): void;
@@ -38,16 +38,16 @@ export declare class ConnectionTracker {
  * act on the real thing; the wrapper only ensures we stop tracking a
  * socket once it closes on its own.
  */
-export declare function trackSocket(tracker: ConnectionTracker, socket: WebSocketSocketAdapter): WebSocketSocketAdapter;
+export declare function trackSocket(tracker: ConnectionTracker, socket: WebsocketSocketAdapter): WebsocketSocketAdapter;
 /**
  * Turn one accepted upgrade into a live actor-backed connection.  Called
  * synchronously from the backend's upgrade callback (via the route's
  * `connect` handler).
  *
  * It does NOT spawn or attach anything itself — instead it tells the hub
- * a {@link WsAcceptSignal} carrying the per-connection actor's `Props`, so
+ * a {@link WebsocketAcceptCommand} carrying the per-connection actor's `Props`, so
  * the hub spawns that actor as its OWN child (`server → conn-N`).  The
- * child then creates the {@link WsConnection}, reports `connected`, and
+ * child then creates the {@link WebsocketConnection}, reports `connected`, and
  * attaches the socket listeners in its `preStart`.
  *
  * First-frame race: the socket adapter attaches its native listeners
@@ -55,5 +55,5 @@ export declare function trackSocket(tracker: ConnectionTracker, socket: WebSocke
  * `setListeners` runs — so nothing is lost between upgrade and the child
  * becoming ready.
  */
-export declare function wireConnection<TOut, TIn, TSelf = never>(_system: ActorSystem, hub: WsServerRef<TOut, TIn, TSelf>, req: HttpRequest, socket: WebSocketSocketAdapter, codec: WsCodec<TOut, TIn>, policy: ResolvedWsPolicy): void;
+export declare function wireConnection<TOut, TIn, TSelf = never>(_system: ActorSystem, hub: WebsocketServerRef<TOut, TIn, TSelf>, req: HttpRequest, socket: WebsocketSocketAdapter, codec: WebsocketCodec<TOut, TIn>, policy: ResolvedWebsocketPolicy): void;
 //# sourceMappingURL=ConnectionWiring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionWiring.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/ConnectionWiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGpE;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,GAAG,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAIzC,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAI5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uEAAuE;IACvE,QAAQ,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAUxC,0EAA0E;IAC1E,YAAY,IAAI,IAAI;CAWrB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CA2BxB;AAuCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,EACrD,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACzC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,EAChC,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAgCN"}

package/dist/http/{ws → websocket}/ConnectionWiring.js

@@ -1,6 +1,6 @@
 import { Props } from '../../Props.js';
-import { WsAcceptSignal } from './WsMessages.js';
-import { WebSocketConnectionActor } from './WebSocketConnectionActor.js';
+import { websocketAcceptCommand } from './WebsocketMessages.js';
+import { WebsocketConnectionActor } from './WebsocketConnectionActor.js';
 /**
  * Tracks the live server-side sockets of one binding so `unbind()` can
  * close them.  Without this a long-lived WebSocket keeps the HTTP
@@ -80,15 +80,48 @@ export function trackSocket(tracker, socket) {
     };
 }
 let connectionCounter = 0;
+/**
+ * Live connection count per hub, for the per-route `maxConnections` cap
+ * (security audit WS-5).  Keyed by the hub ref (one per route); increments
+ * when a connection is admitted and decrements when its socket closes.  A
+ * `WeakMap` so a discarded hub doesn't leak its counter.
+ */
+const liveConnectionsByHub = new WeakMap();
+/**
+ * Wrap `socket` so `onClosed` runs exactly once when it closes — used to
+ * decrement the live-connection count.  Mirrors {@link trackSocket}'s onClose
+ * chaining.
+ */
+function decrementOnClose(socket, onClosed) {
+    let fired = false;
+    const fire = () => { if (!fired) {
+        fired = true;
+        onClosed();
+    } };
+    return {
+        send: (data) => socket.send(data),
+        close: (code, reason) => socket.close(code, reason),
+        terminate: socket.terminate ? () => socket.terminate() : undefined,
+        setListeners: (l) => socket.setListeners({
+            onMessage: (data) => l.onMessage(data),
+            onClose: (code, reason) => { fire(); l.onClose(code, reason); },
+            onError: (err) => l.onError(err),
+        }),
+        get readyState() { return socket.readyState; },
+        bufferedAmount: socket.bufferedAmount ? () => socket.bufferedAmount() : undefined,
+        get remoteAddress() { return socket.remoteAddress; },
+        get protocol() { return socket.protocol; },
+    };
+}
 /**
  * Turn one accepted upgrade into a live actor-backed connection.  Called
  * synchronously from the backend's upgrade callback (via the route's
  * `connect` handler).
  *
  * It does NOT spawn or attach anything itself — instead it tells the hub
- * a {@link WsAcceptSignal} carrying the per-connection actor's `Props`, so
+ * a {@link WebsocketAcceptCommand} carrying the per-connection actor's `Props`, so
  * the hub spawns that actor as its OWN child (`server → conn-N`).  The
- * child then creates the {@link WsConnection}, reports `connected`, and
+ * child then creates the {@link WebsocketConnection}, reports `connected`, and
  * attaches the socket listeners in its `preStart`.
  *
  * First-frame race: the socket adapter attaches its native listeners
@@ -97,6 +130,26 @@ let connectionCounter = 0;
  * becoming ready.
  */
 export function wireConnection(_system, hub, req, socket, codec, policy) {
+    // Admission cap (security audit WS-5): when the route is at its
+    // connection limit, close the freshly-upgraded socket with 1013 ("try
+    // again later") instead of wiring an actor for it.  Unlimited by default
+    // (`policy.maxConnections === Infinity`).
+    const cap = policy.maxConnections;
+    if (Number.isFinite(cap)) {
+        const hubKey = hub;
+        const live = liveConnectionsByHub.get(hubKey) ?? 0;
+        if (live >= cap) {
+            try {
+                socket.close(1013, 'server at capacity');
+            }
+            catch { /* already closing */ }
+            return;
+        }
+        liveConnectionsByHub.set(hubKey, live + 1);
+        socket = decrementOnClose(socket, () => {
+            liveConnectionsByHub.set(hubKey, Math.max(0, (liveConnectionsByHub.get(hubKey) ?? 1) - 1));
+        });
+    }
     const id = `ws-${++connectionCounter}`;
     const upgrade = {
         path: req.path,
@@ -106,7 +159,7 @@ export function wireConnection(_system, hub, req, socket, codec, policy) {
         remoteAddress: req.remoteAddress ?? socket.remoteAddress,
         subprotocol: socket.protocol,
     };
-    const props = Props.create(() => new WebSocketConnectionActor({ socket, codec, policy, hub, id, upgrade }));
-    hub.tell(new WsAcceptSignal(props, id), null);
+    const props = Props.create(() => new WebsocketConnectionActor({ socket, codec, policy, hub, id, upgrade }));
+    hub.tell(websocketAcceptCommand(props, id), null);
 }
 //# sourceMappingURL=ConnectionWiring.js.map

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

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

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

@@ -1,7 +1,7 @@
 /**
  * Backend-agnostic socket surface.  Each HTTP backend maps its native
  * WebSocket (the `ws` package's socket for Fastify/Express, Hono's
- * `WSContext`) onto a {@link WebSocketSocketAdapter}, and the shared
+ * `WSContext`) onto a {@link WebsocketSocketAdapter}, and the shared
  * connection-wiring layer drives everything through this one shape — so
  * frame decoding, size caps, codec handling and lifecycle live in ONE
  * place regardless of backend.
@@ -9,30 +9,30 @@
 /**
  * Listeners the framework attaches to a socket.  The backend adapter
  * must guarantee that no inbound frame is delivered before
- * {@link WebSocketSocketAdapter.setListeners} returns (attach natively
+ * {@link WebsocketSocketAdapter.setListeners} returns (attach natively
  * in the same synchronous tick, or buffer until then) — this is what
  * closes the "first frame lost" race by construction.
  */
-export interface WebSocketListeners {
+export interface WebsocketListeners {
     /** One inbound frame, already normalised to text (`string`) or binary (`Uint8Array`). */
     onMessage(data: string | Uint8Array): void;
     onClose(code: number, reason: string): void;
     onError(err: Error): void;
 }
 /** W3C-style readyState values. */
-export declare const WsReadyState: {
+export declare const WebsocketReadyState: {
     readonly CONNECTING: 0;
     readonly OPEN: 1;
     readonly CLOSING: 2;
     readonly CLOSED: 3;
 };
-export interface WebSocketSocketAdapter {
+export interface WebsocketSocketAdapter {
     send(data: string | Uint8Array): void;
     close(code?: number, reason?: string): void;
     /** Hard-kill without a close handshake (shutdown).  Falls back to `close()` if absent. */
     terminate?(): void;
-    /** Single-shot listener attach — see {@link WebSocketListeners}. */
-    setListeners(l: WebSocketListeners): void;
+    /** Single-shot listener attach — see {@link WebsocketListeners}. */
+    setListeners(l: WebsocketListeners): void;
     readonly readyState: 0 | 1 | 2 | 3;
     /** Bytes queued in the peer send buffer, when the backend can report it. */
     bufferedAmount?(): number;
@@ -45,7 +45,7 @@ export interface WebSocketSocketAdapter {
  * plain `ws.WebSocketServer`, and `@hono/node-ws`).  Only the members
  * we touch are declared — the peer dep is optional.
  */
-export interface WsPackageSocket {
+export interface WebsocketPackageSocket {
     send(data: string | Uint8Array): void;
     close(code?: number, reason?: string): void;
     terminate?(): void;
@@ -58,15 +58,15 @@ export interface WsPackageSocket {
 }
 /**
  * Adapt a `ws`-package socket (already upgraded) to a
- * {@link WebSocketSocketAdapter}.  Native `socket.on(...)` listeners are
+ * {@link WebsocketSocketAdapter}.  Native `socket.on(...)` listeners are
  * attached **immediately** (synchronously at upgrade) and inbound events
  * are BUFFERED until `setListeners` runs — because the per-connection
  * actor attaches its listeners a mailbox-tick later, and `ws` would drop
  * events that arrive with no `'message'` listener.  `isBinary` from `ws`
  * decides text-vs-binary delivery.
  */
-export declare function wsPackageAdapter(socket: WsPackageSocket, opts?: {
+export declare function websocketPackageAdapter(socket: WebsocketPackageSocket, opts?: {
     readonly remoteAddress?: string;
     readonly protocol?: string;
-}): WebSocketSocketAdapter;
+}): WebsocketSocketAdapter;
 //# sourceMappingURL=SocketAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SocketAdapter.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/SocketAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B;AAED,mCAAmC;AACnC,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,0FAA0F;IAC1F,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,4EAA4E;IAC5E,cAAc,CAAC,IAAI,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACtE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,sBAAsB,CAwCxB"}

package/dist/http/{ws → websocket}/SocketAdapter.js

@@ -1,13 +1,13 @@
 /**
  * Backend-agnostic socket surface.  Each HTTP backend maps its native
  * WebSocket (the `ws` package's socket for Fastify/Express, Hono's
- * `WSContext`) onto a {@link WebSocketSocketAdapter}, and the shared
+ * `WSContext`) onto a {@link WebsocketSocketAdapter}, and the shared
  * connection-wiring layer drives everything through this one shape — so
  * frame decoding, size caps, codec handling and lifecycle live in ONE
  * place regardless of backend.
  */
 /** W3C-style readyState values. */
-export const WsReadyState = {
+export const WebsocketReadyState = {
     CONNECTING: 0,
     OPEN: 1,
     CLOSING: 2,
@@ -39,14 +39,14 @@ function coerceText(data) {
 }
 /**
  * Adapt a `ws`-package socket (already upgraded) to a
- * {@link WebSocketSocketAdapter}.  Native `socket.on(...)` listeners are
+ * {@link WebsocketSocketAdapter}.  Native `socket.on(...)` listeners are
  * attached **immediately** (synchronously at upgrade) and inbound events
  * are BUFFERED until `setListeners` runs — because the per-connection
  * actor attaches its listeners a mailbox-tick later, and `ws` would drop
  * events that arrive with no `'message'` listener.  `isBinary` from `ws`
  * decides text-vs-binary delivery.
  */
-export function wsPackageAdapter(socket, opts = {}) {
+export function websocketPackageAdapter(socket, opts = {}) {
     let listeners = null;
     const pending = [];
     socket.on('message', (data, isBinary) => {
@@ -57,19 +57,19 @@ export function wsPackageAdapter(socket, opts = {}) {
             pending.push({ t: 'message', data: norm });
     });
     socket.on('close', (code, reason) => {
-        const c = typeof code === 'number' ? code : 1005;
-        const r = reason == null ? '' : String(reason);
+        const closeCode = typeof code === 'number' ? code : 1005;
+        const reasonText = reason == null ? '' : String(reason);
         if (listeners)
-            listeners.onClose(c, r);
+            listeners.onClose(closeCode, reasonText);
         else
-            pending.push({ t: 'close', code: c, reason: r });
+            pending.push({ t: 'close', code: closeCode, reason: reasonText });
     });
     socket.on('error', (err) => {
-        const e = err instanceof Error ? err : new Error(String(err));
+        const error = err instanceof Error ? err : new Error(String(err));
         if (listeners)
-            listeners.onError(e);
+            listeners.onError(error);
         else
-            pending.push({ t: 'error', err: e });
+            pending.push({ t: 'error', err: error });
     });
     return {
         send: (data) => socket.send(data),
@@ -87,7 +87,7 @@ export function wsPackageAdapter(socket, opts = {}) {
             }
         },
         get readyState() {
-            return (socket.readyState ?? WsReadyState.OPEN);
+            return (socket.readyState ?? WebsocketReadyState.OPEN);
         },
         bufferedAmount: () => socket.bufferedAmount ?? 0,
         remoteAddress: opts.remoteAddress,

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

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

package/dist/http/{ws/WebSocketClientActor.d.ts → websocket/WebsocketClientActor.d.ts}

@@ -1,44 +1,45 @@
 /**
  * Typed WebSocket **client** actor.  The counterpart to
- * {@link WebSocketServerActor}: it dials a URL and speaks the same typed,
+ * {@link WebsocketServerActor}: it dials a URL and speaks the same typed,
  * codec-encoded protocol.  Built on {@link BrokerActor}, so it inherits
  * reconnect-with-backoff, an outbound buffer that survives reconnects, a
- * circuit breaker, and HOCON settings resolution for free.
+ * circuit breaker, and HOCON options resolution for free.
  *
- *     class FeedClient extends WebSocketClientActor<ClientMsg, ServerMsg> {
+ *     class FeedClient extends WebsocketClientActor<ClientMessage, ServerMessage> {
  *       constructor() {
- *         super(WebSocketClientOptions.create<ClientMsg, ServerMsg>()
+ *         super(WebsocketClientOptions.create<ClientMessage, ServerMessage>()
  *           .withUrl('ws://localhost:8080/ws'));
  *       }
  *       override onConnected(): void { this.send({ kind: 'ping', n: 1 }); }
- *       onMessage(msg: ServerMsg): void { this.log.info(`pong ${msg.n}`); }
+ *       onMessage(msg: ServerMessage): void { this.log.info(`pong ${msg.n}`); }
  *     }
  *
  * `TOut` (what the client sends) comes first, then `TIn` (decoded server
  * messages).  Lifecycle events (connected / disconnected / inbound) are
  * delivered through the mailbox, so `onMessage` and the hooks always run
  * on the actor thread.  Other actors can push a typed send with
- * `ref.tell(wsSend(msg))`.
+ * `ref.tell(websocketSend(msg))`.
  */
 import type { Config } from '../../config/Config.js';
 import { BrokerActor, type OutboundEnvelope } from '../../io/broker/BrokerActor.js';
-import { WsDecodeError } from './WsCodec.js';
-import type { WebSocketClientOptions, WebSocketClientOptionsType } from './WebSocketClientOptions.js';
-import { type WsClientMessage } from './WsMessages.js';
-import { type WsFrame } from './types.js';
-export declare abstract class WebSocketClientActor<TOut, TIn, TSelf = never> extends BrokerActor<WebSocketClientOptionsType<TOut, TIn>, WsClientMessage<TOut, TIn, TSelf>, WsFrame> {
+import { WebsocketDecodeError } from './WebsocketCodec.js';
+import { WebsocketClientOptionsValidator } from './WebsocketClientOptions.js';
+import type { WebsocketClientOptions, WebsocketClientOptionsType } from './WebsocketClientOptions.js';
+import { type WebsocketClientMessage } from './WebsocketMessages.js';
+import { type WebsocketFrame } from './types.js';
+export declare abstract class WebsocketClientActor<TOut, TIn, TSelf = never> extends BrokerActor<WebsocketClientOptionsType<TOut, TIn>, WebsocketClientMessage<TOut, TIn, TSelf>, WebsocketFrame> {
     private socket;
     private pingTimer;
     private _codec;
-    constructor(options?: WebSocketClientOptions<TOut, TIn>);
+    constructor(options?: WebsocketClientOptions<TOut, TIn>);
     /** Handle one decoded server message. */
     abstract onMessage(msg: TIn): void | Promise<void>;
     /** The connection (re)opened.  A good place to send an initial handshake. */
     protected onConnected(): void | Promise<void>;
-    /** The connection dropped; a reconnect cycle may follow (per settings). */
+    /** The connection dropped; a reconnect cycle may follow (per options). */
     protected onDisconnected(_cause?: Error): void | Promise<void>;
     /** An inbound frame failed to decode.  Only called when onInvalidMessage is 'hook'. */
-    protected onInvalidMessage(_error: WsDecodeError): void | Promise<void>;
+    protected onInvalidMessage(_error: WebsocketDecodeError): void | Promise<void>;
     /** App-level message told to this actor's ref (reachable only when TSelf ≠ never). */
     protected onSelfMessage(msg: TSelf): void | Promise<void>;
     /**
@@ -48,19 +49,20 @@ export declare abstract class WebSocketClientActor<TOut, TIn, TSelf = never> ext
      */
     protected send(msg: TOut): boolean;
     /** Send a raw frame, bypassing the codec. */
-    protected sendRaw(frame: WsFrame): boolean;
+    protected sendRaw(frame: WebsocketFrame): boolean;
     private codec;
     /** @internal Sealed — override onMessage + hooks instead. */
-    onReceive(cmd: WsClientMessage<TOut, TIn, TSelf>): void | Promise<void>;
+    onReceive(cmd: WebsocketClientMessage<TOut, TIn, TSelf>): void | Promise<void>;
     protected configKey(): string;
-    protected builtInDefaults(): Partial<WebSocketClientOptionsType<TOut, TIn>>;
-    protected requiredSettings(): ReadonlyArray<keyof WebSocketClientOptionsType<TOut, TIn>>;
+    protected builtInDefaultOptions(): Partial<WebsocketClientOptionsType<TOut, TIn>>;
+    protected requiredOptions(): ReadonlyArray<keyof WebsocketClientOptionsType<TOut, TIn>>;
+    protected optionsValidator(): WebsocketClientOptionsValidator<TOut, TIn>;
     protected endpointLabel(): string;
-    protected readSettingsFromConfig(c: Config): Partial<WebSocketClientOptionsType<TOut, TIn>>;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
-    protected dispatchOutgoing(env: OutboundEnvelope<WsFrame>): Promise<void>;
+    protected readOptionsFromConfig(config: Config): Partial<WebsocketClientOptionsType<TOut, TIn>>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
+    protected dispatchOutgoing(env: OutboundEnvelope<WebsocketFrame>): Promise<void>;
     private onSocketDown;
     private handleInbound;
 }
-//# sourceMappingURL=WebSocketClientActor.d.ts.map
+//# sourceMappingURL=WebsocketClientActor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketClientActor.d.ts","sourceRoot":"","sources":["../../../src/http/websocket/WebsocketClientActor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAa,oBAAoB,EAAuB,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EASL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,8BAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CACjE,SAAQ,WAAW,CAAC,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC;IAEpH,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,MAAM,CAA0C;gBAE5C,OAAO,GAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAM;IAM3D,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD,6EAA6E;IAC7E,SAAS,CAAC,WAAW,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,0EAA0E;IAC1E,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9D,uFAAuF;IACvF,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9E,sFAAsF;IACtF,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO;IAWlC,6CAA6C;IAC7C,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAIjD,OAAO,CAAC,KAAK;IAMb,6DAA6D;IACpD,SAAS,CAAC,GAAG,EAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAavF,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,qBAAqB,IAAI,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjF,SAAS,CAAC,eAAe,IAAI,aAAa,CAAC,MAAM,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;cACpE,gBAAgB,IAAI,+BAA+B,CAAC,IAAI,EAAE,GAAG,CAAC;IAGjF,SAAS,CAAC,aAAa,IAAI,MAAM;IAEjC,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;cAe/E,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;cA+BtC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;cAOzC,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;CA6BtB"}