actor-ts 0.9.0 → 0.10.0

package/dist/http/ws/WebSocketServerActor.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Base class for a WebSocket server hub — the actor you bind a route to
+ * with `websocket(path, ref)`.  ONE hub handles every connection on the
+ * route; the framework spawns an internal session actor per connection
+ * behind the scenes (you never manage those).
+ *
+ *     type In  = { kind: 'ping'; n: number };
+ *     type Out = { kind: 'pong'; n: number };
+ *
+ *     class PingServer extends WebSocketServerActor<Out, In> {
+ *       onMessage(msg: In): void {
+ *         this.reply({ kind: 'pong', n: msg.n });   // → the sending connection
+ *       }
+ *     }
+ *
+ * `TOut` (what you send) comes first, then `TIn` (what you receive), to
+ * match the `websocket()` / client generic order.  `TSelf` (default
+ * `never`) is for app-level messages other actors `tell` this hub.
+ *
+ * You override `onMessage` (required) and optionally the lifecycle
+ * hooks.  Do NOT override `onReceive` — it is the sealed dispatcher that
+ * turns mailbox envelopes into these calls.  Per connection you observe
+ * exactly: `onClientConnected` → zero+ `onMessage` (in frame order) →
+ * `onClientDisconnected`, all serialised through this one actor.
+ */
+import { Actor } from '../../Actor.js';
+import { type SupervisorStrategy } from '../../Supervision.js';
+import type { WsDecodeError } from './WsCodec.js';
+import type { WsConnection } from './WsConnection.js';
+import { type WsServerMessage } from './WsMessages.js';
+import type { WsCloseInfo } from './types.js';
+export declare abstract class WebSocketServerActor<TOut, TIn, TSelf = never> extends Actor<WsServerMessage<TOut, TIn, TSelf>> {
+    private readonly _clients;
+    private _current;
+    /** Handle one decoded client message.  `this.connection` / `this.sender` = the sender. */
+    abstract onMessage(msg: TIn): void | Promise<void>;
+    /** A client completed the upgrade.  Ordered before its first `onMessage`. */
+    protected onClientConnected(_client: WsConnection<TOut>): void | Promise<void>;
+    /** A client went away.  Ordered after its last `onMessage`; then it leaves `clients`. */
+    protected onClientDisconnected(_client: WsConnection<TOut>, _info: WsCloseInfo): void | Promise<void>;
+    /** A frame failed to decode.  Only called when the route policy is `'hook'`. */
+    protected onInvalidMessage(_client: WsConnection<TOut>, _error: WsDecodeError): void | Promise<void>;
+    /** App-level message told to this hub's ref (reachable only when `TSelf` ≠ `never`). */
+    protected onSelfMessage(msg: TSelf): void | Promise<void>;
+    /** The connection whose event is being processed.  Throws outside a hook / onMessage. */
+    protected get connection(): WsConnection<TOut>;
+    /** Reply to the current connection.  Sugar for `this.connection.tell(msg)`. */
+    protected reply(msg: TOut): void;
+    /** Send to every open connection (optionally filtered). */
+    protected broadcast(msg: TOut, filter?: (c: WsConnection<TOut>) => boolean): void;
+    /** Live connections, keyed by connection id. */
+    protected get clients(): ReadonlyMap<string, WsConnection<TOut>>;
+    /** Close every connection. */
+    protected closeAll(code?: number, reason?: string): void;
+    /**
+     * Supervision for the per-connection child actors: stop a crashed
+     * connection (its `postStop` still reports the disconnect) rather than
+     * restart it into a dead socket.  Override on your subclass only if you
+     * really mean to change how connection failures are handled.
+     */
+    supervisorStrategy(): SupervisorStrategy;
+    /** @internal Sealed — do not override; override `onMessage` + hooks instead. */
+    onReceive(msg: WsServerMessage<TOut, TIn, TSelf>): Promise<void>;
+}
+//# sourceMappingURL=WebSocketServerActor.d.ts.map

package/dist/http/ws/WebSocketServerActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketServerActor.d.ts","sourceRoot":"","sources":["../../../src/http/ws/WebSocketServerActor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8BAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CACjE,SAAQ,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAEhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAmC;IAInD,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD,6EAA6E;IAC7E,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9E,yFAAyF;IACzF,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAErG,gFAAgF;IAChF,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpG,wFAAwF;IACxF,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,yFAAyF;IACzF,SAAS,KAAK,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC,CAK7C;IAED,+EAA+E;IAC/E,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAIhC,2DAA2D;IAC3D,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,OAAO,GAAG,IAAI;IAMjF,gDAAgD;IAChD,SAAS,KAAK,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAE/D;IAED,8BAA8B;IAC9B,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAMlD;;;;;OAKG;IACM,kBAAkB,IAAI,kBAAkB;IAIjD,gFAAgF;IACjE,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CA+ChF"}

package/dist/http/ws/WebSocketServerActor.js

@@ -0,0 +1,133 @@
+/**
+ * Base class for a WebSocket server hub — the actor you bind a route to
+ * with `websocket(path, ref)`.  ONE hub handles every connection on the
+ * route; the framework spawns an internal session actor per connection
+ * behind the scenes (you never manage those).
+ *
+ *     type In  = { kind: 'ping'; n: number };
+ *     type Out = { kind: 'pong'; n: number };
+ *
+ *     class PingServer extends WebSocketServerActor<Out, In> {
+ *       onMessage(msg: In): void {
+ *         this.reply({ kind: 'pong', n: msg.n });   // → the sending connection
+ *       }
+ *     }
+ *
+ * `TOut` (what you send) comes first, then `TIn` (what you receive), to
+ * match the `websocket()` / client generic order.  `TSelf` (default
+ * `never`) is for app-level messages other actors `tell` this hub.
+ *
+ * You override `onMessage` (required) and optionally the lifecycle
+ * hooks.  Do NOT override `onReceive` — it is the sealed dispatcher that
+ * turns mailbox envelopes into these calls.  Per connection you observe
+ * exactly: `onClientConnected` → zero+ `onMessage` (in frame order) →
+ * `onClientDisconnected`, all serialised through this one actor.
+ */
+import { Actor } from '../../Actor.js';
+import { stoppingStrategy } from '../../Supervision.js';
+import { WsAcceptSignal, WsConnectedSignal, WsDataSignal, WsDisconnectedSignal, WsInvalidSignal, } from './WsMessages.js';
+export class WebSocketServerActor extends Actor {
+    _clients = new Map();
+    _current = null;
+    /** A client completed the upgrade.  Ordered before its first `onMessage`. */
+    onClientConnected(_client) { }
+    /** A client went away.  Ordered after its last `onMessage`; then it leaves `clients`. */
+    onClientDisconnected(_client, _info) { }
+    /** A frame failed to decode.  Only called when the route policy is `'hook'`. */
+    onInvalidMessage(_client, _error) { }
+    /** App-level message told to this hub's ref (reachable only when `TSelf` ≠ `never`). */
+    onSelfMessage(msg) {
+        this.log.warn(`WebSocketServerActor: unhandled self message: ${String(msg)}`);
+    }
+    /* ----------------------- helpers ------------------------------- */
+    /** The connection whose event is being processed.  Throws outside a hook / onMessage. */
+    get connection() {
+        if (this._current === null) {
+            throw new Error('this.connection is only valid inside onMessage / onClient* hooks');
+        }
+        return this._current;
+    }
+    /** Reply to the current connection.  Sugar for `this.connection.tell(msg)`. */
+    reply(msg) {
+        this.connection.tell(msg);
+    }
+    /** Send to every open connection (optionally filtered). */
+    broadcast(msg, filter) {
+        for (const c of this._clients.values()) {
+            if (c.isOpen && (!filter || filter(c)))
+                c.tell(msg);
+        }
+    }
+    /** Live connections, keyed by connection id. */
+    get clients() {
+        return this._clients;
+    }
+    /** Close every connection. */
+    closeAll(code = 1000, reason = '') {
+        for (const c of this._clients.values())
+            c.close(code, reason);
+    }
+    /* ----------------------- sealed dispatch ----------------------- */
+    /**
+     * Supervision for the per-connection child actors: stop a crashed
+     * connection (its `postStop` still reports the disconnect) rather than
+     * restart it into a dead socket.  Override on your subclass only if you
+     * really mean to change how connection failures are handled.
+     */
+    supervisorStrategy() {
+        return stoppingStrategy;
+    }
+    /** @internal Sealed — do not override; override `onMessage` + hooks instead. */
+    async onReceive(msg) {
+        if (msg instanceof WsAcceptSignal) {
+            // Spawn the per-connection actor as THIS actor's child, so the
+            // tree is server → conn-N and supervision/teardown are automatic.
+            this.context.spawn(msg.props, msg.name);
+            return;
+        }
+        if (msg instanceof WsConnectedSignal) {
+            this._clients.set(msg.connection.id, msg.connection);
+            this._current = msg.connection;
+            try {
+                await this.onClientConnected(msg.connection);
+            }
+            finally {
+                this._current = null;
+            }
+            return;
+        }
+        if (msg instanceof WsDataSignal) {
+            this._current = msg.connection;
+            try {
+                await this.onMessage(msg.message);
+            }
+            finally {
+                this._current = null;
+            }
+            return;
+        }
+        if (msg instanceof WsDisconnectedSignal) {
+            this._current = msg.connection;
+            try {
+                await this.onClientDisconnected(msg.connection, msg.info);
+            }
+            finally {
+                this._current = null;
+                this._clients.delete(msg.connection.id);
+            }
+            return;
+        }
+        if (msg instanceof WsInvalidSignal) {
+            this._current = msg.connection;
+            try {
+                await this.onInvalidMessage(msg.connection, msg.error);
+            }
+            finally {
+                this._current = null;
+            }
+            return;
+        }
+        await this.onSelfMessage(msg);
+    }
+}
+//# sourceMappingURL=WebSocketServerActor.js.map

package/dist/http/ws/WebSocketServerActor.js.map

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

package/dist/http/ws/WsCodec.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Codec seam for the typed WebSocket stack.  A codec turns application
+ * messages into wire frames and back:
+ *
+ *   - `encode(msg: TOut): WsFrame`  — outbound (server→client / client→server)
+ *   - `decode(frame: WsFrame): TIn` — inbound
+ *
+ * `TOut` comes first to match the actor-class generic order
+ * (`WebSocketServerActor<TOut, TIn>`).  The default is {@link jsonCodec};
+ * {@link rawCodec} is the escape hatch for apps that want the raw frames
+ * (e.g. binary audio).  Custom codecs (CBOR, protobuf, a zod-validated
+ * JSON codec) implement the same two methods.
+ *
+ * Error contract: `decode` throws {@link WsDecodeError} on malformed
+ * input — the connection layer then applies the route's
+ * `onInvalidMessage` policy (close / drop / hook).  `encode` throws
+ * {@link WsEncodeError}; since sends are fire-and-forget the message is
+ * logged and dropped rather than surfaced to the caller.
+ */
+import type { WsFrame } from './types.js';
+/** Thrown by `decode` when an inbound frame can't be parsed or validated. */
+export declare class WsDecodeError extends Error {
+    /** The offending raw frame — useful for logging / an onInvalidMessage hook. */
+    readonly frame: WsFrame;
+    constructor(message: string, 
+    /** The offending raw frame — useful for logging / an onInvalidMessage hook. */
+    frame: WsFrame, options?: {
+        cause?: unknown;
+    });
+}
+/** Thrown by `encode` when an outbound message can't be serialised. */
+export declare class WsEncodeError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Bidirectional wire codec.  `TOut` = what we send, `TIn` = what we receive. */
+export interface WsCodec<TOut, TIn> {
+    /** Stable identifier — 'json' | 'raw' | custom.  Informational (logs). */
+    readonly name: string;
+    encode(msg: TOut): WsFrame;
+    decode(frame: WsFrame): TIn;
+}
+/**
+ * Default codec: application messages ↔ JSON.  Text frames are
+ * `JSON.parse`d directly; binary frames are UTF-8 decoded first (so a
+ * client that sends JSON as a binary frame still works).  Outbound
+ * messages become text frames via `JSON.stringify`.
+ *
+ * Pass `validate` to run a schema check (e.g. a zod parser) on the
+ * parsed value — it receives the `unknown` parse result and must return
+ * (or throw for) a `TIn`.  A thrown validator is wrapped as a
+ * {@link WsDecodeError}.
+ */
+export declare function jsonCodec<TOut, TIn>(opts?: {
+    validate?: (value: unknown) => TIn;
+}): WsCodec<TOut, TIn>;
+/**
+ * Escape-hatch codec: no encoding at all — `TOut` and `TIn` are both
+ * {@link WsFrame}, so the actor sees and sends raw text/binary frames.
+ * Use for binary protocols (audio/video) or when you want to own the
+ * wire format entirely.
+ */
+export declare function rawCodec(): WsCodec<WsFrame, WsFrame>;
+//# sourceMappingURL=WsCodec.d.ts.map

package/dist/http/ws/WsCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsCodec.d.ts","sourceRoot":"","sources":["../../../src/http/ws/WsCodec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,6EAA6E;AAC7E,qBAAa,aAAc,SAAQ,KAAK;IAGpC,+EAA+E;aAC/D,KAAK,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM;IACf,+EAA+E;IAC/D,KAAK,EAAE,OAAO,EAC9B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKhC;AAED,uEAAuE;AACvE,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,iFAAiF;AACjF,MAAM,WAAW,OAAO,CAAC,IAAI,EAAE,GAAG;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;CAC7B;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,GAAG,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAiC1G;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAMpD"}

package/dist/http/ws/WsCodec.js

@@ -0,0 +1,82 @@
+/** Thrown by `decode` when an inbound frame can't be parsed or validated. */
+export class WsDecodeError extends Error {
+    frame;
+    constructor(message, 
+    /** The offending raw frame — useful for logging / an onInvalidMessage hook. */
+    frame, options) {
+        super(message, options);
+        this.frame = frame;
+        this.name = 'WsDecodeError';
+    }
+}
+/** Thrown by `encode` when an outbound message can't be serialised. */
+export class WsEncodeError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'WsEncodeError';
+    }
+}
+const textDecoder = /* @__PURE__ */ new TextDecoder('utf-8', { fatal: false });
+/**
+ * Default codec: application messages ↔ JSON.  Text frames are
+ * `JSON.parse`d directly; binary frames are UTF-8 decoded first (so a
+ * client that sends JSON as a binary frame still works).  Outbound
+ * messages become text frames via `JSON.stringify`.
+ *
+ * Pass `validate` to run a schema check (e.g. a zod parser) on the
+ * parsed value — it receives the `unknown` parse result and must return
+ * (or throw for) a `TIn`.  A thrown validator is wrapped as a
+ * {@link WsDecodeError}.
+ */
+export function jsonCodec(opts = {}) {
+    const validate = opts.validate;
+    return {
+        name: 'json',
+        encode(msg) {
+            let data;
+            try {
+                data = JSON.stringify(msg);
+            }
+            catch (cause) {
+                throw new WsEncodeError('jsonCodec: failed to stringify outbound message', { cause });
+            }
+            if (data === undefined) {
+                // JSON.stringify(undefined) / a function returns undefined.
+                throw new WsEncodeError('jsonCodec: outbound message is not JSON-serialisable');
+            }
+            return { kind: 'text', data };
+        },
+        decode(frame) {
+            const text = frame.kind === 'text' ? frame.data : textDecoder.decode(frame.data);
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch (cause) {
+                throw new WsDecodeError('jsonCodec: inbound frame is not valid JSON', frame, { cause });
+            }
+            if (!validate)
+                return parsed;
+            try {
+                return validate(parsed);
+            }
+            catch (cause) {
+                throw new WsDecodeError('jsonCodec: inbound message failed validation', frame, { cause });
+            }
+        },
+    };
+}
+/**
+ * Escape-hatch codec: no encoding at all — `TOut` and `TIn` are both
+ * {@link WsFrame}, so the actor sees and sends raw text/binary frames.
+ * Use for binary protocols (audio/video) or when you want to own the
+ * wire format entirely.
+ */
+export function rawCodec() {
+    return {
+        name: 'raw',
+        encode: (frame) => frame,
+        decode: (frame) => frame,
+    };
+}
+//# sourceMappingURL=WsCodec.js.map

package/dist/http/ws/WsCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsCodec.js","sourceRoot":"","sources":["../../../src/http/ws/WsCodec.ts"],"names":[],"mappings":"AAqBA,6EAA6E;AAC7E,MAAM,OAAO,aAAc,SAAQ,KAAK;IAIpB;IAHlB,YACE,OAAe;IACf,+EAA+E;IAC/D,KAAc,EAC9B,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAHR,UAAK,GAAL,KAAK,CAAS;QAI9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAUD,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAY,OAA+C,EAAE;IACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM,CAAC,GAAS;YACd,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,aAAa,CAAC,iDAAiD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,4DAA4D;gBAC5D,MAAM,IAAI,aAAa,CAAC,sDAAsD,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,CAAC,KAAc;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjF,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,aAAa,CAAC,4CAA4C,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1F,CAAC;YACD,IAAI,CAAC,QAAQ;gBAAE,OAAO,MAAa,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,aAAa,CAAC,8CAA8C,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO;QACL,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK;QAC1C,MAAM,EAAE,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK;KAC3C,CAAC;AACJ,CAAC"}

package/dist/http/ws/WsConnection.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A live WebSocket connection, presented to the hub actor as an
+ * `ActorRef<TOut>` (so `this.sender` / `this.reply` / `broadcast` all
+ * work through the normal actor machinery).  `tell(msg)` encodes `msg`
+ * via the route codec and writes it to the socket — routed through the
+ * connection's internal session actor so writes stay ordered.
+ *
+ * Precedent for a synthetic ref: `AskResponseRef` / `NobodyRef` in
+ * ActorRef.ts.  Deathwatch is NOT supported — use the hub's
+ * `onClientDisconnected` hook instead.
+ */
+import { ActorPath } from '../../ActorPath.js';
+import { ActorRef } from '../../ActorRef.js';
+import { type WebSocketSocketAdapter } from './SocketAdapter.js';
+import type { WsFrame, WsUpgradeInfo } from './types.js';
+/**
+ * Outbound command a {@link WsConnection} 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> = {
+    readonly _cmd: 'out';
+    readonly msg: TOut;
+} | {
+    readonly _cmd: 'out-raw';
+    readonly frame: WsFrame;
+} | {
+    readonly _cmd: 'close';
+    readonly code: number;
+    readonly reason: string;
+};
+export interface WsConnection<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;
+    /** Send a raw frame, bypassing the codec. */
+    sendRaw(frame: WsFrame): 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> {
+    readonly id: string;
+    readonly upgrade: WsUpgradeInfo;
+    private readonly socket;
+    private readonly connRef;
+    readonly path: ActorPath;
+    constructor(id: string, upgrade: WsUpgradeInfo, socket: WebSocketSocketAdapter, connRef: ActorRef<WsOutboundCommand<TOut>>, systemName: string);
+    get remoteAddress(): string | undefined;
+    get isOpen(): boolean;
+    tell(msg: TOut): void;
+    sendRaw(frame: WsFrame): void;
+    close(code?: number, reason?: string): void;
+}
+//# sourceMappingURL=WsConnection.d.ts.map

package/dist/http/ws/WsConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsConnection.d.ts","sourceRoot":"","sources":["../../../src/http/ws/WsConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAgB,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,IAAI,IAC9B;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,OAAO,CAAA;CAAE,GACrD;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,YAAY,CAAC,IAAI,CAAE,SAAQ,QAAQ,CAAC,IAAI,CAAC;IACxD,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,aAAa,CAAC;IAChC,6CAA6C;IAC7C,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,+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,gBAAgB,CAAC,IAAI,CAAE,SAAQ,QAAQ,CAAC,IAAI,CAAE,YAAW,YAAY,CAAC,IAAI,CAAC;IAIpF,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,OAAO,EAAE,aAAa;IAC/B,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,aAAa,EACd,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAC3D,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,OAAO,GAAG,IAAI;IAI7B,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;CAGtC"}

package/dist/http/ws/WsConnection.js

@@ -0,0 +1,45 @@
+/**
+ * A live WebSocket connection, presented to the hub actor as an
+ * `ActorRef<TOut>` (so `this.sender` / `this.reply` / `broadcast` all
+ * work through the normal actor machinery).  `tell(msg)` encodes `msg`
+ * via the route codec and writes it to the socket — routed through the
+ * connection's internal session actor so writes stay ordered.
+ *
+ * Precedent for a synthetic ref: `AskResponseRef` / `NobodyRef` in
+ * ActorRef.ts.  Deathwatch is NOT supported — use the hub's
+ * `onClientDisconnected` hook instead.
+ */
+import { ActorPath } from '../../ActorPath.js';
+import { ActorRef } from '../../ActorRef.js';
+import { WsReadyState } from './SocketAdapter.js';
+export class WsConnectionImpl extends ActorRef {
+    id;
+    upgrade;
+    socket;
+    connRef;
+    path;
+    constructor(id, upgrade, socket, connRef, systemName) {
+        super();
+        this.id = id;
+        this.upgrade = upgrade;
+        this.socket = socket;
+        this.connRef = connRef;
+        this.path = new ActorPath(`ws-conn-${id}`, null, systemName);
+    }
+    get remoteAddress() {
+        return this.upgrade.remoteAddress;
+    }
+    get isOpen() {
+        return this.socket.readyState === WsReadyState.OPEN;
+    }
+    tell(msg) {
+        this.connRef.tell({ _cmd: 'out', msg });
+    }
+    sendRaw(frame) {
+        this.connRef.tell({ _cmd: 'out-raw', frame });
+    }
+    close(code = 1000, reason = '') {
+        this.connRef.tell({ _cmd: 'close', code, reason });
+    }
+}
+//# sourceMappingURL=WsConnection.js.map

package/dist/http/ws/WsConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsConnection.js","sourceRoot":"","sources":["../../../src/http/ws/WsConnection.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,YAAY,EAA+B,MAAM,oBAAoB,CAAC;AA4B/E,MAAM,OAAO,gBAAuB,SAAQ,QAAc;IAI7C;IACA;IACQ;IACA;IANV,IAAI,CAAY;IAEzB,YACW,EAAU,EACV,OAAsB,EACd,MAA8B,EAC9B,OAA0C,EAC3D,UAAkB;QAElB,KAAK,EAAE,CAAC;QANC,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAe;QACd,WAAM,GAAN,MAAM,CAAwB;QAC9B,YAAO,GAAP,OAAO,CAAmC;QAI3D,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,YAAY,CAAC,IAAI,CAAC;IACtD,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,KAAc;QACpB,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/WsMessages.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The internal envelope that flows into a {@link WebSocketServerActor}'s
+ * mailbox.  Users never construct or match these — the base class
+ * dispatches them to `onMessage` / `onClient*` 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 { WsDecodeError } from './WsCodec.js';
+import type { WsConnection } from './WsConnection.js';
+import type { WsCloseInfo } from './types.js';
+/**
+ * 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.
+ */
+export declare class WsAcceptSignal {
+    readonly props: Props<unknown>;
+    readonly name: string;
+    readonly _wsSignal: "accept";
+    constructor(props: Props<unknown>, name: string);
+}
+export declare class WsConnectedSignal<TOut> {
+    readonly connection: WsConnection<TOut>;
+    readonly _wsSignal: "connected";
+    constructor(connection: WsConnection<TOut>);
+}
+export declare class WsDataSignal<TOut, TIn> {
+    readonly connection: WsConnection<TOut>;
+    readonly message: TIn;
+    readonly _wsSignal: "data";
+    constructor(connection: WsConnection<TOut>, message: TIn);
+}
+export declare class WsDisconnectedSignal<TOut> {
+    readonly connection: WsConnection<TOut>;
+    readonly info: WsCloseInfo;
+    readonly _wsSignal: "disconnected";
+    constructor(connection: WsConnection<TOut>, info: WsCloseInfo);
+}
+export declare class WsInvalidSignal<TOut> {
+    readonly connection: WsConnection<TOut>;
+    readonly error: WsDecodeError;
+    readonly _wsSignal: "invalid";
+    constructor(connection: WsConnection<TOut>, error: WsDecodeError);
+}
+export type WsServerSignal<TOut, TIn> = WsAcceptSignal | WsConnectedSignal<TOut> | WsDataSignal<TOut, TIn> | WsDisconnectedSignal<TOut> | WsInvalidSignal<TOut>;
+/**
+ * Full mailbox type of a hub actor: 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 WsServerMessage<TOut, TIn, TSelf = never> = TSelf | WsServerSignal<TOut, TIn>;
+/** Convenience alias for a reference to a hub actor. */
+export type WsServerRef<TOut, TIn, TSelf = never> = ActorRef<WsServerMessage<TOut, TIn, TSelf>>;
+/** Outbound send pushed into a client actor's mailbox by another actor. */
+export declare class WsClientSend<TOut> {
+    readonly msg: TOut;
+    readonly _wsClient: "send";
+    constructor(msg: TOut);
+}
+/** A decoded inbound message from the server (delivered to the actor's mailbox). */
+export declare class WsClientInbound<TIn> {
+    readonly msg: TIn;
+    readonly _wsClient: "inbound";
+    constructor(msg: TIn);
+}
+/** An inbound frame that failed to decode. */
+export declare class WsClientInvalid {
+    readonly error: WsDecodeError;
+    readonly _wsClient: "invalid";
+    constructor(error: WsDecodeError);
+}
+/** The connection (re)opened. */
+export declare class WsClientConnected {
+    readonly _wsClient: "connected";
+}
+/** The connection dropped (a reconnect cycle may follow). */
+export declare class WsClientDisconnected {
+    readonly cause?: Error | undefined;
+    readonly _wsClient: "disconnected";
+    constructor(cause?: Error | undefined);
+}
+export type WsClientSignal<TOut, TIn> = WsClientSend<TOut> | WsClientInbound<TIn> | WsClientInvalid | WsClientConnected | WsClientDisconnected;
+/** Full mailbox type of a client actor: internal signals + app messages. */
+export type WsClientMessage<TOut, TIn, TSelf = never> = TSelf | WsClientSignal<TOut, TIn>;
+/** Push a typed outbound message through a client actor's ref: `ref.tell(wsSend(m))`. */
+export declare function wsSend<TOut>(msg: TOut): WsClientSend<TOut>;
+//# sourceMappingURL=WsMessages.d.ts.map

package/dist/http/ws/WsMessages.d.ts.map

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