actor-ts 0.9.0 → 0.10.0

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