actor-ts 0.9.1 → 0.11.0

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":"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"}

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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"}

package/dist/io/broker/WebSocketServerAdapters.js

@@ -1,155 +0,0 @@
-import { Props } from '../../Props.js';
-import { ServerWebSocketActor, } 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.
- */
-/* ------------------- generic / ws-package adapter --------------------- */
-/**
- * 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 function serverWebSocketActorOf(system, socket, opts = {}) {
-    const { name, ...actorOpts } = opts;
-    const props = Props.create(() => new ServerWebSocketActor(socket, actorOpts));
-    return name !== undefined ? system.spawn(props, name) : system.spawnAnonymous(props);
-}
-/** Wrapper that captures listeners registered by the actor and
- *  exposes setter-callbacks the Bun handlers drive. */
-class BunWebSocketBridge {
-    ws;
-    messageCb = null;
-    closeCb = null;
-    errorCb = null;
-    constructor(ws) {
-        this.ws = ws;
-    }
-    send(data) { this.ws.send(data); }
-    close(code, reason) { this.ws.close(code, reason); }
-    get readyState() { return this.ws.readyState; }
-    addEventListener(event, cb) {
-        if (event === 'message')
-            this.messageCb = cb;
-        else if (event === 'close')
-            this.closeCb = cb;
-        else
-            this.errorCb = cb;
-    }
-    removeEventListener(event) {
-        if (event === 'message')
-            this.messageCb = null;
-        else if (event === 'close')
-            this.closeCb = null;
-        else if (event === 'error')
-            this.errorCb = null;
-    }
-    /* Driven by Bun.serve handlers. */
-    deliverMessage(data) { this.messageCb?.({ data }); }
-    deliverClose() { this.closeCb?.(); }
-    deliverError(ev) { this.errorCb?.(ev); }
-}
-/**
- * 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 function bunWebSocketHandlers(system, opts = {}) {
-    let counter = 0;
-    return {
-        open(ws) {
-            const bridge = new BunWebSocketBridge(ws);
-            const slotName = opts.actorName?.(ws)
-                ?? `ws-${++counter}`;
-            const ref = system.spawn(Props.create(() => new ServerWebSocketActor(bridge, {
-                target: opts.target,
-                stopOnSocketClose: opts.stopOnSocketClose,
-            })), slotName);
-            // Stash the bridge + ref on the bun socket so subsequent
-            // callbacks can find it.  The original user data is preserved
-            // under `.user` for downstream code.
-            const userData = ws.data;
-            ws.data = { bridge, ref, user: userData };
-            try {
-                opts.onOpen?.(ws, ref);
-            }
-            catch (err) {
-                system.log.warn('bunWebSocketHandlers.onOpen threw', err);
-            }
-        },
-        message(ws, message) {
-            const slot = ws.data;
-            if (!slot)
-                return;
-            // Bun delivers strings as-is and binary as Buffer (Uint8Array
-            // subclass) — both pass through to the actor's frame
-            // dispatcher unchanged.
-            slot.bridge.deliverMessage(message);
-        },
-        close(ws, code, reason) {
-            const slot = ws.data;
-            if (!slot)
-                return;
-            slot.bridge.deliverClose();
-            try {
-                opts.onClose?.(ws, slot.ref, code, reason);
-            }
-            catch (err) {
-                system.log.warn('bunWebSocketHandlers.onClose threw', err);
-            }
-        },
-        drain(_ws) {
-            // Backpressure hook — Bun calls this when the socket's send
-            // buffer drains.  We don't queue at the actor layer, so this
-            // is a no-op for v1.  Document so users know it's available.
-        },
-    };
-}
-//# sourceMappingURL=WebSocketServerAdapters.js.map

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

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