actor-ts 0.9.1 → 0.11.0

package/dist/http/websocket/WebsocketConnection.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 { WebsocketFrame, WebsocketUpgradeInfo } from './types.js';
+/**
+ * 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 WebsocketOutboundCommand<TOut> = {
+    readonly _cmd: 'out';
+    readonly msg: TOut;
+} | {
+    readonly _cmd: 'out-raw';
+    readonly frame: WebsocketFrame;
+} | {
+    readonly _cmd: 'close';
+    readonly code: number;
+    readonly reason: string;
+};
+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: WebsocketUpgradeInfo;
+    /** Send a raw frame, bypassing the codec. */
+    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 WebsocketConnectionImplementation<TOut> extends ActorRef<TOut> implements WebsocketConnection<TOut> {
+    readonly id: string;
+    readonly upgrade: WebsocketUpgradeInfo;
+    private readonly socket;
+    private readonly connRef;
+    readonly path: ActorPath;
+    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: WebsocketFrame): void;
+    close(code?: number, reason?: string): void;
+}
+//# 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/websocket/WebsocketConnection.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 { WebsocketReadyState } from './SocketAdapter.js';
+export class WebsocketConnectionImplementation 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 === WebsocketReadyState.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=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/websocket/WebsocketConnectionActor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Internal per-connection actor — a genuine child of the
+ * {@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.
+ *
+ * It owns the whole communication for one connection:
+ *   - inbound: attaches the socket listeners in `preStart`, size-caps +
+ *     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 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.
+ *
+ * The hub supervises these with `stoppingStrategy` — a crashed
+ * connection stops (and `postStop` still reports the disconnect) rather
+ * than restarting into a dead socket.
+ */
+import { Actor } from '../../Actor.js';
+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: WebsocketUpgradeInfo;
+}
+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>);
+    preStart(): void;
+    onReceive(cmd: WebsocketOutboundCommand<TOut>): void;
+    postStop(): void;
+    private handleInbound;
+    private handleClose;
+    private write;
+    private closeSocket;
+}
+//# 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/websocket/WebsocketConnectionActor.js

@@ -0,0 +1,170 @@
+/**
+ * Internal per-connection actor — a genuine child of the
+ * {@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.
+ *
+ * It owns the whole communication for one connection:
+ *   - inbound: attaches the socket listeners in `preStart`, size-caps +
+ *     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 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.
+ *
+ * The hub supervises these with `stoppingStrategy` — a crashed
+ * connection stops (and `postStop` still reports the disconnect) rather
+ * than restarting into a dead socket.
+ */
+import { Actor } from '../../Actor.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 {
+    d;
+    connection = null;
+    closed = false;
+    disconnectReported = false;
+    closeInfo = null;
+    constructor(deps) {
+        super();
+        this.d = deps;
+    }
+    preStart() {
+        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(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}`),
+        });
+    }
+    onReceive(cmd) {
+        if (this.closed) {
+            this.log.debug(`WebsocketConnectionActor ${this.d.id}: command after close — ignored`);
+            return;
+        }
+        switch (cmd._cmd) {
+            case 'out': {
+                let frame;
+                try {
+                    frame = this.d.codec.encode(cmd.msg);
+                }
+                catch (err) {
+                    this.log.error(`WebsocketConnectionActor ${this.d.id}: encode failed, dropping message: ${err.message}`);
+                    return;
+                }
+                this.write(frame);
+                break;
+            }
+            case 'out-raw':
+                this.write(cmd.frame);
+                break;
+            case 'close':
+                this.closeSocket(cmd.code, cmd.reason);
+                break;
+        }
+    }
+    postStop() {
+        // Report the disconnect to the hub exactly once — covers normal
+        // close (info set by handleClose), hub-initiated close, and crashes
+        // (framework stops the actor → postStop runs → synthetic info).
+        if (this.connection && !this.disconnectReported) {
+            this.disconnectReported = true;
+            const info = this.closeInfo ?? { code: 1011, reason: '', initiatedBy: 'error' };
+            this.d.hub.tell(websocketDisconnectedSignal(this.connection, info), this.connection);
+        }
+        if (!this.closed) {
+            this.closed = true;
+            try {
+                this.d.socket.close();
+            }
+            catch { /* already closed */ }
+        }
+    }
+    /* ------------------------------ inbound ------------------------------- */
+    handleInbound(data) {
+        const frame = normalizeInbound(data);
+        if (!frame) {
+            this.log.warn(`WebsocketConnectionActor ${this.d.id}: unrecognised inbound frame type — dropped`);
+            return;
+        }
+        if (frameByteLength(frame) > this.d.policy.maxFrameBytes) {
+            if (this.d.policy.onOversizeFrame === 'close') {
+                this.closeSocket(1009, 'message too big');
+            }
+            else {
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: dropped oversize inbound frame (> ${this.d.policy.maxFrameBytes} bytes)`);
+            }
+            return;
+        }
+        let decoded;
+        try {
+            decoded = this.d.codec.decode(frame);
+        }
+        catch (err) {
+            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(websocketInvalidSignal(this.connection, decodeErr), this.connection);
+            }
+            else {
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: invalid inbound message — dropped: ${decodeErr.message}`);
+            }
+            return;
+        }
+        this.d.hub.tell(websocketDataSignal(this.connection, decoded), this.connection);
+    }
+    handleClose(code, reason) {
+        if (this.closed)
+            return;
+        this.closeInfo = { code, reason, initiatedBy: 'client' };
+        this.context.stopSelf();
+    }
+    /* ------------------------------ outbound ------------------------------ */
+    write(frame) {
+        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.closeSocket(1013, 'try again later');
+            }
+            else {
+                this.log.warn(`WebsocketConnectionActor ${this.d.id}: send buffer ${buffered} > ${this.d.policy.maxBufferedBytes} — dropping frame`);
+            }
+            return;
+        }
+        try {
+            this.d.socket.send(frame.data);
+        }
+        catch (err) {
+            this.log.warn(`WebsocketConnectionActor ${this.d.id}: send failed: ${err.message}`);
+        }
+    }
+    closeSocket(code, reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.closeInfo === null)
+            this.closeInfo = { code, reason, initiatedBy: 'server' };
+        try {
+            this.d.socket.close(code, reason);
+        }
+        catch { /* already closed */ }
+        this.context.stopSelf();
+    }
+}
+//# 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/websocket/WebsocketPolicy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-connection WebSocket policy — the knobs that govern inbound frame
+ * limits and outbound backpressure.  Resolved once per route (on the
+ * first connection) as: route options > HOCON (`actor-ts.http.websocket`)
+ * > 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 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 {
+    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;
+}
+/** Merge built-in defaults, HOCON server defaults, and per-route options. */
+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"}