actor-ts 0.9.0 → 0.10.0

package/dist/io/broker/ServerWebSocketActor.js

@@ -1,128 +0,0 @@
-import { Actor } from '../../Actor.js';
-export class ServerWebSocketActor extends Actor {
-    socket;
-    opts;
-    closed = false;
-    // Pinned listener refs so `removeEventListener` (where supported)
-    // can detach them on stop.
-    onMessage = (ev) => this.handleMessage(ev.data);
-    onClose = () => this.handleClose();
-    onErrorEvent = (ev) => this.handleError(ev);
-    constructor(socket, opts = {}) {
-        super();
-        this.socket = socket;
-        this.opts = opts;
-    }
-    preStart() {
-        this.log.debug('ServerWebSocketActor: attached to socket');
-        this.socket.addEventListener('message', this.onMessage);
-        this.socket.addEventListener('close', this.onClose);
-        this.socket.addEventListener('error', this.onErrorEvent);
-    }
-    postStop() {
-        if (this.socket.removeEventListener) {
-            try {
-                this.socket.removeEventListener('message', this.onMessage);
-                this.socket.removeEventListener('close', this.onClose);
-                this.socket.removeEventListener('error', this.onErrorEvent);
-            }
-            catch { /* ignore — best-effort detach */ }
-        }
-        if (!this.closed) {
-            this.closed = true;
-            try {
-                this.socket.close();
-            }
-            catch { /* already closed */ }
-        }
-    }
-    onReceive(cmd) {
-        if (this.closed) {
-            this.log.debug('ServerWebSocketActor: send after close — ignored');
-            return;
-        }
-        try {
-            if (cmd.kind === 'send') {
-                this.log.debug(`ServerWebSocketActor: send ${cmd.frame.kind} frame (${cmd.frame.kind === 'text' ? `${cmd.frame.data.length} chars` : `${cmd.frame.data.byteLength} bytes`})`);
-                this.send(cmd.frame);
-            }
-            else if (cmd.kind === 'sendText') {
-                this.log.debug(`ServerWebSocketActor: send text (${cmd.data.length} chars)`);
-                this.socket.send(cmd.data);
-            }
-            else {
-                this.log.debug(`ServerWebSocketActor: send binary (${cmd.data.byteLength} bytes)`);
-                this.socket.send(cmd.data);
-            }
-        }
-        catch (err) {
-            this.log.warn(`ServerWebSocketActor: send failed: ${err.message}`);
-        }
-    }
-    /* ------------------------------ inbound ------------------------------- */
-    send(frame) {
-        if (frame.kind === 'text')
-            this.socket.send(frame.data);
-        else
-            this.socket.send(frame.data);
-    }
-    handleMessage(data) {
-        const target = this.opts.target;
-        if (!target)
-            return;
-        if (typeof data === 'string') {
-            this.log.debug(`ServerWebSocketActor: recv text (${data.length} chars)`);
-            target.tell({ kind: 'text', data });
-            return;
-        }
-        if (data instanceof ArrayBuffer) {
-            this.log.debug(`ServerWebSocketActor: recv binary (${data.byteLength} bytes)`);
-            target.tell({ kind: 'binary', data: new Uint8Array(data) });
-            return;
-        }
-        if (data instanceof Uint8Array) {
-            this.log.debug(`ServerWebSocketActor: recv binary (${data.byteLength} bytes)`);
-            target.tell({ kind: 'binary', data });
-            return;
-        }
-        // ws-lib delivers a Buffer (which is a Uint8Array subtype) or
-        // arrays of Buffer chunks for fragmented messages — coerce.
-        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;
-            }
-            target.tell({ kind: 'binary', data: merged });
-            return;
-        }
-        if (data && typeof data.byteLength === 'number') {
-            target.tell({ kind: 'binary', data: new Uint8Array(data) });
-            return;
-        }
-        this.log.warn(`ServerWebSocketActor: unrecognised inbound frame type (${typeof data})`);
-    }
-    handleClose() {
-        if (this.closed)
-            return;
-        this.log.debug('ServerWebSocketActor: socket closed');
-        this.closed = true;
-        if (this.opts.stopOnSocketClose ?? true) {
-            this.context.stopSelf();
-        }
-    }
-    handleError(ev) {
-        const err = ev instanceof Error
-            ? ev
-            : new Error(typeof ev === 'string' ? ev : 'WebSocket error');
-        this.log.warn(`ServerWebSocketActor: ${err.message}`);
-        try {
-            this.opts.onError?.(err);
-        }
-        catch { /* user code throwing in onError shouldn't kill us */ }
-    }
-}
-//# sourceMappingURL=ServerWebSocketActor.js.map

package/dist/io/broker/ServerWebSocketActor.js.map

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

package/dist/io/broker/WebSocketActor.d.ts

@@ -1,77 +0,0 @@
-import type { Config } from '../../config/Config.js';
-import type { ActorRef } from '../../ActorRef.js';
-import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
-import type { BrokerCommonSettings } from './BrokerSettings.js';
-/** WebSocket message — frames are either text or binary. */
-export type WebSocketFrame = {
-    readonly kind: 'text';
-    readonly data: string;
-} | {
-    readonly kind: 'binary';
-    readonly data: Uint8Array;
-};
-export interface WebSocketActorSettings extends BrokerCommonSettings {
-    /** WebSocket URL (`ws://...` or `wss://...`). */
-    readonly url?: string;
-    /** Subprotocols negotiated with the server. */
-    readonly protocols?: string | ReadonlyArray<string>;
-    /** Custom request headers (Node only — browsers ignore these). */
-    readonly headers?: Readonly<Record<string, string>>;
-    /** Subscriber that receives every inbound frame.  Required. */
-    readonly target?: ActorRef<WebSocketFrame>;
-    /** Send a ping every `pingIntervalMs` to keep the connection alive.  Default: disabled. */
-    readonly pingIntervalMs?: number;
-    /**
-     * Maximum allowed size of a single inbound frame, in bytes.
-     * Frames larger than this are dropped (logged at warn level)
-     * without being forwarded to `target`.  Default: 1 MiB.
-     *
-     * **Why this exists (security):** a malicious (or compromised) WS
-     * peer can send arbitrarily-large frames.  Without a cap, the
-     * actor's mailbox grows unbounded if `target` consumes slowly —
-     * one 100-MiB frame plus a stalled consumer exhausts the process.
-     * Set to `Infinity` to disable (not recommended for public-facing
-     * endpoints); raise the cap if you legitimately need bigger
-     * frames (audio/video streams).
-     */
-    readonly maxInboundFrameBytes?: number;
-}
-export type WebSocketCmd = {
-    readonly kind: 'send';
-    readonly frame: WebSocketFrame;
-} | {
-    readonly kind: 'sendText';
-    readonly data: string;
-} | {
-    readonly kind: 'sendBinary';
-    readonly data: Uint8Array;
-};
-/**
- * WebSocket-client actor.  Picks up the native `WebSocket` API on
- * Bun + Deno; on Node, lazy-imports the `ws` peer-dep.  Either way
- * inbound text/binary frames are routed to `target`; outbound is the
- * standard `enqueueOutbound` path so messages buffered while
- * disconnected are resent after reconnect.
- *
- * Server-side WebSocket upgrades (Hono/Fastify integration) are out of
- * scope for v1 — those need access to the underlying HTTP request,
- * which is backend-specific.
- */
-export declare class WebSocketActor extends BrokerActor<WebSocketActorSettings, WebSocketCmd, WebSocketFrame> {
-    private socket;
-    private pingTimer;
-    constructor(settings?: Partial<WebSocketActorSettings>);
-    protected configKey(): string;
-    protected builtInDefaults(): Partial<WebSocketActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<WebSocketActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof WebSocketActorSettings>;
-    protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
-    protected dispatchOutgoing(env: OutboundEnvelope<WebSocketFrame>): Promise<void>;
-    onReceive(cmd: WebSocketCmd): void;
-    private handleMessage;
-}
-/** Default cap on a single inbound WebSocket frame — 1 MiB. */
-export declare const DEFAULT_WS_MAX_INBOUND_FRAME_BYTES: number;
-//# sourceMappingURL=WebSocketActor.d.ts.map

package/dist/io/broker/WebSocketActor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebSocketActor.d.ts","sourceRoot":"","sources":["../../../src/io/broker/WebSocketActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,WAAW,CAAC,sBAAsB,EAAE,YAAY,EAAE,cAAc,CAAC;IACnG,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;gBAEpD,QAAQ,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAE1D,SAAS,CAAC,SAAS,IAAI,MAAM;IAC7B,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAC5D,SAAS,CAAC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAe5E,SAAS,CAAC,gBAAgB,IAAI,aAAa,CAAC,MAAM,sBAAsB,CAAC;IAGzE,SAAS,CAAC,aAAa,IAAI,MAAM;cAEjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;cAiC5B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;cAQ/B,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7E,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAQ3C,OAAO,CAAC,aAAa;CAyDtB;AAED,+DAA+D;AAC/D,eAAO,MAAM,kCAAkC,QAAkB,CAAC"}

package/dist/io/broker/WebSocketActor.js

@@ -1,217 +0,0 @@
-import { ConfigKeys } from '../../config/ConfigKeys.js';
-import { Lazy } from '../../util/Lazy.js';
-import { BrokerActor } from './BrokerActor.js';
-/**
- * WebSocket-client actor.  Picks up the native `WebSocket` API on
- * Bun + Deno; on Node, lazy-imports the `ws` peer-dep.  Either way
- * inbound text/binary frames are routed to `target`; outbound is the
- * standard `enqueueOutbound` path so messages buffered while
- * disconnected are resent after reconnect.
- *
- * Server-side WebSocket upgrades (Hono/Fastify integration) are out of
- * scope for v1 — those need access to the underlying HTTP request,
- * which is backend-specific.
- */
-export class WebSocketActor extends BrokerActor {
-    socket = null;
-    pingTimer = null;
-    constructor(settings = {}) { super(settings); }
-    configKey() { return ConfigKeys.io.broker.websocket; }
-    builtInDefaults() { return {}; }
-    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('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;
-    }
-    requiredSettings() {
-        return ['url', 'target'];
-    }
-    endpointLabel() { return this.settings.url ?? '<unknown>'; }
-    async connectImpl() {
-        const ctor = await wsCtorLazy.get();
-        const ws = ctor.create(this.settings.url, {
-            protocols: this.settings.protocols,
-            headers: this.settings.headers,
-        });
-        return new Promise((resolve, reject) => {
-            let done = false;
-            ws.addEventListener('open', () => {
-                if (done)
-                    return;
-                done = true;
-                this.socket = ws;
-                ws.addEventListener('message', (ev) => {
-                    this.handleMessage(ev.data);
-                });
-                ws.addEventListener('close', () => this.handleConnectionLost(new Error('websocket closed')));
-                ws.addEventListener('error', (_ev) => this.handleConnectionLost(new Error('websocket error')));
-                if (this.settings.pingIntervalMs && this.settings.pingIntervalMs > 0) {
-                    this.pingTimer = setInterval(() => {
-                        try {
-                            ws.ping?.();
-                        }
-                        catch { /* ignore */ }
-                    }, this.settings.pingIntervalMs);
-                }
-                resolve();
-            });
-            ws.addEventListener('error', (_ev) => {
-                if (done)
-                    return;
-                done = true;
-                try {
-                    ws.close();
-                }
-                catch { /* ignore */ }
-                reject(new Error('websocket connect error'));
-            });
-        });
-    }
-    async disconnectImpl() {
-        if (this.pingTimer) {
-            clearInterval(this.pingTimer);
-            this.pingTimer = null;
-        }
-        if (!this.socket)
-            return;
-        const sock = this.socket;
-        this.socket = null;
-        try {
-            sock.close();
-        }
-        catch { /* ignore */ }
-    }
-    async dispatchOutgoing(env) {
-        if (!this.socket)
-            throw new Error('WebSocketActor: not open');
-        const f = env.payload;
-        if (f.kind === 'text')
-            this.socket.send(f.data);
-        else
-            this.socket.send(f.data);
-    }
-    onReceive(cmd) {
-        if (cmd.kind === 'send')
-            this.enqueueOutbound(cmd.frame);
-        else if (cmd.kind === 'sendText')
-            this.enqueueOutbound({ kind: 'text', data: cmd.data });
-        else
-            this.enqueueOutbound({ kind: 'binary', data: cmd.data });
-    }
-    /* ------------------------------ inbound ----------------------------- */
-    handleMessage(data) {
-        const target = this.settings.target;
-        if (!target)
-            return;
-        const cap = this.settings.maxInboundFrameBytes ?? DEFAULT_WS_MAX_INBOUND_FRAME_BYTES;
-        if (typeof data === 'string') {
-            // For text, use byte length (UTF-8 worst case is 4× char count
-            // but most messages are ASCII-heavy; checking utf8 byte length
-            // is the precise measure for "memory consumed").
-            const size = utf8ByteLength(data);
-            if (size > cap) {
-                this.log.warn(`WebSocketActor: dropped oversize inbound text frame (${size} > maxInboundFrameBytes ${cap}) ` +
-                    `from ${this.settings.url}`);
-                return;
-            }
-            target.tell({ kind: 'text', data });
-            return;
-        }
-        if (data instanceof ArrayBuffer) {
-            if (data.byteLength > cap) {
-                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${data.byteLength} > maxInboundFrameBytes ${cap}) ` +
-                    `from ${this.settings.url}`);
-                return;
-            }
-            target.tell({ kind: 'binary', data: new Uint8Array(data) });
-            return;
-        }
-        if (data instanceof Uint8Array) {
-            if (data.byteLength > cap) {
-                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${data.byteLength} > maxInboundFrameBytes ${cap}) ` +
-                    `from ${this.settings.url}`);
-                return;
-            }
-            target.tell({ kind: 'binary', data });
-            return;
-        }
-        // ws-lib delivers Buffer; coerce.
-        if (data && typeof data.byteLength === 'number') {
-            const bl = data.byteLength;
-            if (bl > cap) {
-                this.log.warn(`WebSocketActor: dropped oversize inbound binary frame (${bl} > maxInboundFrameBytes ${cap}) ` +
-                    `from ${this.settings.url}`);
-                return;
-            }
-            const u8 = new Uint8Array(data);
-            target.tell({ kind: 'binary', data: u8 });
-            return;
-        }
-        this.log.warn(`WebSocketActor: unrecognised inbound frame type (${typeof data})`);
-    }
-}
-/** Default cap on a single inbound WebSocket frame — 1 MiB. */
-export const DEFAULT_WS_MAX_INBOUND_FRAME_BYTES = 1 * 1024 * 1024;
-function utf8ByteLength(s) {
-    // TextEncoder's encode allocates a Uint8Array, which we'd discard;
-    // for the size check alone, hand-roll the UTF-8 byte count.  Saves
-    // an allocation in the common case (small messages well under cap).
-    let bytes = 0;
-    for (let i = 0; i < s.length; i++) {
-        const c = s.charCodeAt(i);
-        if (c < 0x80)
-            bytes += 1;
-        else if (c < 0x800)
-            bytes += 2;
-        else if (c >= 0xD800 && c <= 0xDBFF) {
-            // Surrogate pair → 4-byte sequence; skip the low surrogate.
-            bytes += 4;
-            i += 1;
-        }
-        else
-            bytes += 3;
-    }
-    return bytes;
-}
-/**
- * Lazy ctor — picks the native `WebSocket` (Bun, Deno, modern Node 22+)
- * if available; otherwise lazy-imports the `ws` peer-dep.
- */
-const wsCtorLazy = Lazy.of(async () => {
-    if (typeof globalThis.WebSocket === 'function') {
-        const NativeWS = globalThis.WebSocket;
-        return {
-            create: (url, opts) => new NativeWS(url, opts?.protocols),
-        };
-    }
-    try {
-        const name = 'ws';
-        const mod = await import(name);
-        const Ctor = mod.WebSocket ?? mod.default;
-        if (!Ctor)
-            throw new Error('ws: no constructor exported');
-        return {
-            create: (url, opts) => new Ctor(url, opts?.protocols, { headers: opts?.headers }),
-        };
-    }
-    catch (e) {
-        throw new Error('WebSocketActor needs either a native global `WebSocket` (Bun/Deno/Node ≥22) '
-            + 'or the "ws" peer-dep installed.  npm install ws\n'
-            + 'Original error: ' + (e instanceof Error ? e.message : String(e)));
-    }
-});
-//# sourceMappingURL=WebSocketActor.js.map

package/dist/io/broker/WebSocketActor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebSocketActor.js","sourceRoot":"","sources":["../../../src/io/broker/WebSocketActor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAwCtE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAiE;IAC3F,MAAM,GAAyB,IAAI,CAAC;IACpC,SAAS,GAA0C,IAAI,CAAC;IAEhE,YAAY,WAA4C,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtE,SAAS,KAAa,OAAO,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,eAAe,KAAsC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjE,sBAAsB,CAAC,CAAS;QACxC,MAAM,GAAG,GAAkF,EAAE,CAAC;QAC9F,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAAE,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACtF,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5C,CAAC;YACD,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;QACxB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACS,gBAAgB;QACxB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACS,aAAa,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC;IAEpE,KAAK,CAAC,WAAW;QACzB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAI,EAAE;YACzC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;YAClC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAqB,EAAE,EAAE;oBACvD,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC,CAAC,CAAC;gBACH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;gBAC7F,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;gBAC/F,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;oBACrE,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;wBAChC,IAAI,CAAC;4BAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;oBAC7C,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAC1C,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,cAAc;QAC5B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,GAAqC;QACpE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAEQ,SAAS,CAAC,GAAiB;QAClC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;aACpD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;;YACpF,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,0EAA0E;IAElE,aAAa,CAAC,IAAa;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,IAAI,kCAAkC,CAAC;QACrF,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,+DAA+D;YAC/D,+DAA+D;YAC/D,iDAAiD;YACjD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,wDAAwD,IAAI,2BAA2B,GAAG,IAAI;oBAC9F,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAC5B,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,0DAA0D,IAAI,CAAC,UAAU,2BAA2B,GAAG,IAAI;oBAC3G,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAC5B,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,0DAA0D,IAAI,CAAC,UAAU,2BAA2B,GAAG,IAAI;oBAC3G,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAC5B,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,kCAAkC;QAClC,IAAI,IAAI,IAAI,OAAQ,IAAgC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC7E,MAAM,EAAE,GAAI,IAA+B,CAAC,UAAU,CAAC;YACvD,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,0DAA0D,EAAE,2BAA2B,GAAG,IAAI;oBAC9F,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAC5B,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,IAAuB,CAAC,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oDAAoD,OAAO,IAAI,GAAG,CAAC,CAAC;IACpF,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElE,SAAS,cAAc,CAAC,CAAS;IAC/B,mEAAmE;IACnE,mEAAmE;IACnE,oEAAoE;IACpE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACpB,IAAI,CAAC,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;YACpC,4DAA4D;YAC5D,KAAK,IAAI,CAAC,CAAC;YAAC,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAiBD;;;GAGG;AACH,MAAM,UAAU,GAA0B,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;IAC3D,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,SAEV,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,CAAC,GAAW,EAAE,IAAqD,EAAiB,EAAE,CAC5F,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;SACrC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAG5B,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO;YACL,MAAM,EAAE,CACN,GAAW,EACX,IAAiG,EAClF,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC/E,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,8EAA8E;cAC5E,mDAAmD;cACnD,kBAAkB,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACpE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/io/broker/WebSocketServerAdapters.d.ts

@@ -1,140 +0,0 @@
-import type { ActorRef } from '../../ActorRef.js';
-import type { ActorSystem } from '../../ActorSystem.js';
-import { type ServerWebSocketActorOptions, type ServerWebSocketLike, type WebSocketCmd, type WebSocketFrame } from './ServerWebSocketActor.js';
-/**
- * Backend adapters for {@link ServerWebSocketActor} (#1) — the bits
- * that make a server-side WebSocket from `Bun.serve`, the `ws`
- * package, or `@fastify/websocket` look like the
- * `ServerWebSocketLike` shape the actor expects.
- *
- * The `ws`-package family (used by `@fastify/websocket`,
- * `@hono/node-ws`, plain `new WebSocketServer({ ... })`) already
- * exposes a W3C-compatible `addEventListener` interface, so those
- * sockets can be handed straight to `ServerWebSocketActor` —
- * `serverWebSocketActorOf(system, socket, opts)` is the convenience
- * spawn for that case.
- *
- * Bun's native `ServerWebSocket` uses callback-style handlers
- * configured at server-construction time (`Bun.serve({ websocket:
- * { open, message, close } })`).  `bunWebSocketHandlers` adapts that
- * style to our event-listener shape and returns the four
- * callbacks pre-wired so each new connection spins up its own
- * actor.
- */
-/**
- * Spawn a {@link ServerWebSocketActor} bound to an already-upgraded
- * socket.  Use this from a Fastify-websocket handler:
- *
- *   fastify.register(import('@fastify/websocket'));
- *   fastify.get('/ws', { websocket: true }, (conn, _req) => {
- *     const ref = serverWebSocketActorOf(system, conn.socket, {
- *       target: chatRoom,
- *       name: () => `ws-${nextId()}`,
- *     });
- *     chatRoom.tell({ kind: 'join', client: ref });
- *   });
- *
- * `socket` must satisfy {@link ServerWebSocketLike} — Fastify's
- * `conn.socket`, the `ws` package's `WebSocket`, and Hono's
- * Node-WS-bound socket all do.
- */
-export declare function serverWebSocketActorOf(system: ActorSystem, socket: ServerWebSocketLike, opts?: ServerWebSocketActorOptions & {
-    readonly name?: string;
-}): ActorRef<WebSocketCmd>;
-/**
- * The minimum surface of a Bun `ServerWebSocket<T>` we depend on.
- * Bun's native type is generic over the per-connection `data` slot;
- * we typedef it loosely so the adapter compiles without a Bun-types
- * dependency.
- */
-export interface BunServerWebSocketLike<T = unknown> {
-    send(data: string | Uint8Array | ArrayBuffer): number;
-    close(code?: number, reason?: string): void;
-    data: T;
-    readyState?: number;
-}
-/**
- * Internal shape stored in `ws.data` so each Bun.serve websocket
- * callback can look up the actor + adapter that drives the actor's
- * event listeners.
- */
-export interface BunWebSocketSlot<UserData = unknown> {
-    /** The bridge that translates Bun callbacks into addEventListener calls. */
-    readonly bridge: BunWebSocketBridge;
-    /** Per-connection actor reference returned to user code via `onOpen`. */
-    readonly ref: ActorRef<WebSocketCmd>;
-    /** Whatever per-connection state user code attached during upgrade. */
-    readonly user: UserData;
-}
-/** Wrapper that captures listeners registered by the actor and
- *  exposes setter-callbacks the Bun handlers drive. */
-declare class BunWebSocketBridge implements ServerWebSocketLike {
-    private readonly ws;
-    private messageCb;
-    private closeCb;
-    private errorCb;
-    constructor(ws: BunServerWebSocketLike);
-    send(data: string | Uint8Array | ArrayBuffer): void;
-    close(code?: number, reason?: string): void;
-    get readyState(): number | undefined;
-    addEventListener(event: 'message' | 'close' | 'error', cb: never): void;
-    removeEventListener(event: string): void;
-    deliverMessage(data: unknown): void;
-    deliverClose(): void;
-    deliverError(ev: unknown): void;
-}
-export interface BunWebSocketHandlerOptions<UserData = unknown> {
-    /**
-     * Per-connection setup.  Receives the freshly-spawned actor ref so
-     * caller code can register it with chatrooms, persistence layers,
-     * routers, etc.  The optional return value is forwarded as
-     * `target` for the actor — handy if you build the target lazily
-     * from the upgrade context (e.g. one room actor per URL path).
-     */
-    readonly onOpen?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, ref: ActorRef<WebSocketCmd>) => void;
-    /** Per-connection cleanup.  Called after the actor has stopped. */
-    readonly onClose?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, ref: ActorRef<WebSocketCmd>, code: number, reason: string) => void;
-    /**
-     * Static target for every actor spawned by this handler set.  If
-     * omitted, callers register the per-connection target inside
-     * `onOpen` via `ref.tell(...)` to a router that knows where to
-     * forward.
-     */
-    readonly target?: ActorRef<WebSocketFrame>;
-    /** Stop the actor when the bun socket closes.  Default true. */
-    readonly stopOnSocketClose?: boolean;
-    /** Custom actor name per connection.  Defaults to a counter. */
-    readonly actorName?: (ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>) => string;
-}
-/**
- * Build the four `Bun.serve({ websocket: ... })` callbacks pre-wired
- * to spawn a `ServerWebSocketActor` per connection.  Pair with
- * `bunUpgrade(req, server, { initialUserData })` from your `fetch`
- * handler:
- *
- *   const wsHandlers = bunWebSocketHandlers(system, {
- *     target: chatRoom,
- *     onOpen:  (_ws, ref) => chatRoom.tell({ kind: 'join', client: ref }),
- *     onClose: (_ws, ref) => chatRoom.tell({ kind: 'leave', client: ref }),
- *   });
- *
- *   Bun.serve({
- *     port: 3000,
- *     fetch(req, server) {
- *       if (new URL(req.url).pathname === '/ws') {
- *         if (server.upgrade(req, { data: { user: 'alice' } })) return undefined;
- *         return new Response('upgrade failed', { status: 400 });
- *       }
- *       return new Response('not found', { status: 404 });
- *     },
- *     websocket: wsHandlers,
- *   });
- */
-export declare function bunWebSocketHandlers<UserData = unknown>(system: ActorSystem, opts?: BunWebSocketHandlerOptions<UserData>): {
-    open(ws: BunServerWebSocketLike<UserData>): void;
-    message(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, message: string | Buffer): void;
-    close(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>, code: number, reason: string): void;
-    drain(ws: BunServerWebSocketLike<BunWebSocketSlot<UserData>>): void;
-};
-export {};
-//# sourceMappingURL=WebSocketServerAdapters.d.ts.map

package/dist/io/broker/WebSocketServerAdapters.d.ts.map

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