actor-ts 0.9.1 → 0.10.0

package/dist/http/ws/ConnectionWiring.js

@@ -0,0 +1,112 @@
+import { Props } from '../../Props.js';
+import { WsAcceptSignal } from './WsMessages.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
+ * server's `close()` pending forever (the process refuses to exit).
+ */
+export class ConnectionTracker {
+    sockets = new Set();
+    add(socket) {
+        this.sockets.add(socket);
+    }
+    remove(socket) {
+        this.sockets.delete(socket);
+    }
+    get size() {
+        return this.sockets.size;
+    }
+    /** Send a polite close frame to every tracked socket (best-effort). */
+    closeAll(code = 1000, reason = '') {
+        for (const socket of this.sockets) {
+            try {
+                socket.close(code, reason);
+            }
+            catch {
+                /* already closing / closed */
+            }
+        }
+    }
+    /** Hard-terminate every tracked socket and forget them all (shutdown). */
+    terminateAll() {
+        for (const socket of this.sockets) {
+            try {
+                if (socket.terminate)
+                    socket.terminate();
+                else
+                    socket.close(1001, 'going away');
+            }
+            catch {
+                /* already gone */
+            }
+        }
+        this.sockets.clear();
+    }
+}
+/**
+ * Register `socket` with `tracker` and return a thin wrapper whose
+ * `setListeners` chains tracker removal into `onClose`.  The tracker
+ * always holds the *original* socket, so `closeAll` / `terminateAll`
+ * act on the real thing; the wrapper only ensures we stop tracking a
+ * socket once it closes on its own.
+ */
+export function trackSocket(tracker, socket) {
+    tracker.add(socket);
+    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) => {
+                    tracker.remove(socket);
+                    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;
+        },
+    };
+}
+let connectionCounter = 0;
+/**
+ * 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
+ * the hub spawns that actor as its OWN child (`server → conn-N`).  The
+ * child then creates the {@link WsConnection}, reports `connected`, and
+ * attaches the socket listeners in its `preStart`.
+ *
+ * First-frame race: the socket adapter attaches its native listeners
+ * synchronously at upgrade and BUFFERS inbound frames until the child's
+ * `setListeners` runs — so nothing is lost between upgrade and the child
+ * becoming ready.
+ */
+export function wireConnection(_system, hub, req, socket, codec, policy) {
+    const id = `ws-${++connectionCounter}`;
+    const upgrade = {
+        path: req.path,
+        params: req.params,
+        query: req.query,
+        headers: req.headers,
+        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);
+}
+//# sourceMappingURL=ConnectionWiring.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * 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
+ * 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.
+ */
+/**
+ * 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
+ * in the same synchronous tick, or buffer until then) — this is what
+ * closes the "first frame lost" race by construction.
+ */
+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: {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+};
+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;
+    readonly readyState: 0 | 1 | 2 | 3;
+    /** Bytes queued in the peer send buffer, when the backend can report it. */
+    bufferedAmount?(): number;
+    readonly remoteAddress?: string;
+    /** Negotiated `Sec-WebSocket-Protocol`, when known. */
+    readonly protocol?: string;
+}
+/**
+ * The `ws` package socket surface (used by `@fastify/websocket`,
+ * plain `ws.WebSocketServer`, and `@hono/node-ws`).  Only the members
+ * we touch are declared — the peer dep is optional.
+ */
+export interface WsPackageSocket {
+    send(data: string | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    terminate?(): void;
+    on(event: 'message', cb: (data: unknown, isBinary: boolean) => void): void;
+    on(event: 'close', cb: (code: number, reason: unknown) => void): void;
+    on(event: 'error', cb: (err: unknown) => void): void;
+    readonly bufferedAmount?: number;
+    readonly readyState?: number;
+    readonly protocol?: string;
+}
+/**
+ * Adapt a `ws`-package socket (already upgraded) to a
+ * {@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?: {
+    readonly remoteAddress?: string;
+    readonly protocol?: string;
+}): WebSocketSocketAdapter;
+//# sourceMappingURL=SocketAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SocketAdapter.d.ts","sourceRoot":"","sources":["../../../src/http/ws/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,YAAY;;;;;CAKf,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,eAAe;IAC9B,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,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,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/SocketAdapter.js

@@ -0,0 +1,97 @@
+/**
+ * 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
+ * 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 = {
+    CONNECTING: 0,
+    OPEN: 1,
+    CLOSING: 2,
+    CLOSED: 3,
+};
+function coerceBinary(data) {
+    if (data instanceof Uint8Array)
+        return data; // Node Buffer is a Uint8Array
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    if (Array.isArray(data)) {
+        const total = data.reduce((n, b) => n + b.byteLength, 0);
+        const merged = new Uint8Array(total);
+        let off = 0;
+        for (const part of data) {
+            const u8 = new Uint8Array(part);
+            merged.set(u8, off);
+            off += u8.byteLength;
+        }
+        return merged;
+    }
+    return new Uint8Array(0);
+}
+function coerceText(data) {
+    if (typeof data === 'string')
+        return data;
+    const bytes = coerceBinary(data);
+    return new TextDecoder('utf-8', { fatal: false }).decode(bytes);
+}
+/**
+ * Adapt a `ws`-package socket (already upgraded) to a
+ * {@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 = {}) {
+    let listeners = null;
+    const pending = [];
+    socket.on('message', (data, isBinary) => {
+        const norm = isBinary ? coerceBinary(data) : coerceText(data);
+        if (listeners)
+            listeners.onMessage(norm);
+        else
+            pending.push({ t: 'message', data: norm });
+    });
+    socket.on('close', (code, reason) => {
+        const c = typeof code === 'number' ? code : 1005;
+        const r = reason == null ? '' : String(reason);
+        if (listeners)
+            listeners.onClose(c, r);
+        else
+            pending.push({ t: 'close', code: c, reason: r });
+    });
+    socket.on('error', (err) => {
+        const e = err instanceof Error ? err : new Error(String(err));
+        if (listeners)
+            listeners.onError(e);
+        else
+            pending.push({ t: 'error', err: e });
+    });
+    return {
+        send: (data) => socket.send(data),
+        close: (code, reason) => socket.close(code, reason),
+        terminate: socket.terminate ? () => socket.terminate() : undefined,
+        setListeners: (l) => {
+            listeners = l;
+            for (const ev of pending.splice(0)) {
+                if (ev.t === 'message')
+                    l.onMessage(ev.data);
+                else if (ev.t === 'close')
+                    l.onClose(ev.code, ev.reason);
+                else
+                    l.onError(ev.err);
+            }
+        },
+        get readyState() {
+            return (socket.readyState ?? WsReadyState.OPEN);
+        },
+        bufferedAmount: () => socket.bufferedAmount ?? 0,
+        remoteAddress: opts.remoteAddress,
+        protocol: opts.protocol ?? socket.protocol,
+    };
+}
+//# sourceMappingURL=SocketAdapter.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * Typed WebSocket **client** actor.  The counterpart to
+ * {@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.
+ *
+ *     class FeedClient extends WebSocketClientActor<ClientMsg, ServerMsg> {
+ *       constructor() {
+ *         super(WebSocketClientOptions.create<ClientMsg, ServerMsg>()
+ *           .withUrl('ws://localhost:8080/ws'));
+ *       }
+ *       override onConnected(): void { this.send({ kind: 'ping', n: 1 }); }
+ *       onMessage(msg: ServerMsg): 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))`.
+ */
+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> {
+    private socket;
+    private pingTimer;
+    private _codec;
+    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). */
+    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>;
+    /** App-level message told to this actor's ref (reachable only when TSelf ≠ never). */
+    protected onSelfMessage(msg: TSelf): void | Promise<void>;
+    /**
+     * Encode + enqueue an outbound message.  Buffered while disconnected and
+     * resent after reconnect (BrokerActor machinery).  Returns false if the
+     * message was dropped (encode failure or buffer overflow).
+     */
+    protected send(msg: TOut): boolean;
+    /** Send a raw frame, bypassing the codec. */
+    protected sendRaw(frame: WsFrame): boolean;
+    private codec;
+    /** @internal Sealed — override onMessage + hooks instead. */
+    onReceive(cmd: WsClientMessage<TOut, TIn, TSelf>): void | Promise<void>;
+    protected configKey(): string;
+    protected builtInDefaults(): Partial<WebSocketClientOptionsType<TOut, TIn>>;
+    protected requiredSettings(): ReadonlyArray<keyof WebSocketClientOptionsType<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>;
+    private onSocketDown;
+    private handleInbound;
+}
+//# sourceMappingURL=WebSocketClientActor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketClientActor.d.ts","sourceRoot":"","sources":["../../../src/http/ws/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,aAAa,EAAgB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAIL,KAAK,OAAO,EACb,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,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEtG,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,MAAM,CAAmC;gBAErC,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,2EAA2E;IAC3E,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9D,uFAAuF;IACvF,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACvE,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,OAAO,GAAG,OAAO;IAI1C,OAAO,CAAC,KAAK;IAMb,6DAA6D;IACpD,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhF,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxF,SAAS,CAAC,aAAa,IAAI,MAAM;IAEjC,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;cAe3E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cA+B5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAO/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/E,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;CA6BtB"}

package/dist/http/ws/WebSocketClientActor.js

@@ -0,0 +1,194 @@
+import { ConfigKeys } from '../../config/ConfigKeys.js';
+import { BrokerActor } from '../../io/broker/BrokerActor.js';
+import { jsonCodec, WsDecodeError } from './WsCodec.js';
+import { WsClientConnected, WsClientDisconnected, WsClientInbound, WsClientInvalid, WsClientSend, } from './WsMessages.js';
+import { wsClientCtor } from './wsCtor.js';
+import { DEFAULT_WS_MAX_FRAME_BYTES, frameByteLength, normalizeInbound, } from './types.js';
+export class WebSocketClientActor extends BrokerActor {
+    socket = null;
+    pingTimer = null;
+    _codec = null;
+    constructor(options = {}) {
+        super(options);
+    }
+    /** The connection (re)opened.  A good place to send an initial handshake. */
+    onConnected() { }
+    /** The connection dropped; a reconnect cycle may follow (per settings). */
+    onDisconnected(_cause) { }
+    /** An inbound frame failed to decode.  Only called when onInvalidMessage is 'hook'. */
+    onInvalidMessage(_error) { }
+    /** App-level message told to this actor's ref (reachable only when TSelf ≠ never). */
+    onSelfMessage(msg) {
+        this.log.warn(`WebSocketClientActor: unhandled self message: ${String(msg)}`);
+    }
+    /* ----------------------- helpers ------------------------------- */
+    /**
+     * Encode + enqueue an outbound message.  Buffered while disconnected and
+     * resent after reconnect (BrokerActor machinery).  Returns false if the
+     * message was dropped (encode failure or buffer overflow).
+     */
+    send(msg) {
+        let frame;
+        try {
+            frame = this.codec().encode(msg);
+        }
+        catch (err) {
+            this.log.error(`WebSocketClientActor: encode failed, dropping message: ${err.message}`);
+            return false;
+        }
+        return this.enqueueOutbound(frame);
+    }
+    /** Send a raw frame, bypassing the codec. */
+    sendRaw(frame) {
+        return this.enqueueOutbound(frame);
+    }
+    codec() {
+        return (this._codec ??= this.settings.codec ?? jsonCodec());
+    }
+    /* ----------------------- sealed dispatch ----------------------- */
+    /** @internal Sealed — override onMessage + hooks instead. */
+    onReceive(cmd) {
+        if (cmd instanceof WsClientSend)
+            return void this.send(cmd.msg);
+        if (cmd instanceof WsClientInbound)
+            return this.onMessage(cmd.msg);
+        if (cmd instanceof WsClientInvalid)
+            return this.onInvalidMessage(cmd.error);
+        if (cmd instanceof WsClientConnected)
+            return this.onConnected();
+        if (cmd instanceof WsClientDisconnected)
+            return this.onDisconnected(cmd.cause);
+        return this.onSelfMessage(cmd);
+    }
+    /* ----------------------- BrokerActor plumbing ------------------ */
+    configKey() { return ConfigKeys.io.broker.websocket; }
+    builtInDefaults() { return {}; }
+    requiredSettings() { return ['url']; }
+    endpointLabel() { return this.settings.url ?? '<unknown>'; }
+    readSettingsFromConfig(c) {
+        const out = {};
+        if (c.hasPath('url'))
+            out.url = c.getString('url');
+        if (c.hasPath('protocols'))
+            out.protocols = c.getStringList('protocols');
+        if (c.hasPath('pingIntervalMs'))
+            out.pingIntervalMs = c.getDuration('pingIntervalMs');
+        if (c.hasPath('maxFrameBytes'))
+            out.maxFrameBytes = c.getBytes('maxFrameBytes');
+        if (c.hasPath('headers')) {
+            const obj = c.getObject('headers');
+            const headers = {};
+            for (const [k, v] of Object.entries(obj))
+                if (typeof v === 'string')
+                    headers[k] = v;
+            out.headers = headers;
+        }
+        return out;
+    }
+    async connectImpl() {
+        const ctor = await wsClientCtor.get();
+        const ws = ctor.create(this.settings.url, {
+            protocols: this.settings.protocols,
+            headers: this.settings.headers,
+        });
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            ws.addEventListener('open', () => {
+                if (settled)
+                    return;
+                settled = true;
+                this.socket = ws;
+                ws.addEventListener('message', (ev) => this.handleInbound(ev.data));
+                ws.addEventListener('close', () => this.onSocketDown(new Error('websocket closed')));
+                ws.addEventListener('error', () => this.onSocketDown(new Error('websocket error')));
+                const ping = this.settings.pingIntervalMs;
+                if (ping && ping > 0) {
+                    this.pingTimer = setInterval(() => { try {
+                        ws.ping?.();
+                    }
+                    catch { /* ignore */ } }, ping);
+                }
+                this.self.tell(new WsClientConnected());
+                resolve();
+            });
+            ws.addEventListener('error', () => {
+                if (settled)
+                    return;
+                settled = true;
+                try {
+                    ws.close();
+                }
+                catch { /* ignore */ }
+                reject(new Error('websocket connect error'));
+            });
+        });
+    }
+    async disconnectImpl() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        const sock = this.socket;
+        this.socket = null;
+        if (sock) {
+            try {
+                sock.close();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    async dispatchOutgoing(env) {
+        if (!this.socket)
+            throw new Error('WebSocketClientActor: not open');
+        this.socket.send(env.payload.data);
+    }
+    /* ----------------------- inbound ------------------------------- */
+    onSocketDown(cause) {
+        if (!this.socket)
+            return; // already handled this connection's drop
+        this.socket = null;
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        this.self.tell(new WsClientDisconnected(cause));
+        // Trigger BrokerActor's reconnect cycle.
+        this.handleConnectionLost(cause);
+    }
+    handleInbound(data) {
+        const frame = normalizeInbound(data);
+        if (!frame) {
+            this.log.warn('WebSocketClientActor: unrecognised inbound frame type — dropped');
+            return;
+        }
+        const cap = this.settings.maxFrameBytes ?? DEFAULT_WS_MAX_FRAME_BYTES;
+        if (frameByteLength(frame) > cap) {
+            this.log.warn(`WebSocketClientActor: dropped oversize inbound frame (> ${cap} bytes) from ${this.settings.url}`);
+            return;
+        }
+        let decoded;
+        try {
+            decoded = this.codec().decode(frame);
+        }
+        catch (err) {
+            const e = err instanceof WsDecodeError ? err : new WsDecodeError(String(err), frame);
+            const policy = this.settings.onInvalidMessage ?? 'drop';
+            if (policy === 'hook') {
+                this.self.tell(new WsClientInvalid(e));
+            }
+            else if (policy === 'disconnect') {
+                this.log.warn(`WebSocketClientActor: invalid inbound message — disconnecting: ${e.message}`);
+                try {
+                    this.socket?.close(1003, 'unsupported data');
+                }
+                catch { /* ignore */ }
+            }
+            else {
+                this.log.warn(`WebSocketClientActor: invalid inbound message — dropped: ${e.message}`);
+            }
+            return;
+        }
+        this.self.tell(new WsClientInbound(decoded));
+    }
+}
+//# sourceMappingURL=WebSocketClientActor.js.map

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

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