actor-ts 0.9.1 → 0.11.0

package/dist/http/backend/FastifyBackend.js

@@ -1,5 +1,22 @@
 import Fastify from 'fastify';
 import { HttpError } from '../types.js';
+import { Lazy } from '../../util/Lazy.js';
+import { websocketPackageAdapter } from '../websocket/SocketAdapter.js';
+import { DEFAULT_WEBSOCKET_MAX_FRAME_BYTES } from '../websocket/types.js';
+// `@fastify/websocket` is an optional peer dep — lazy-import it (cached),
+// so projects that never use websocket() routes don't pull it in.
+const fastifyWebsocketLazy = Lazy.of(async () => {
+    try {
+        const name = '@fastify/websocket';
+        const mod = (await import(name));
+        return mod.default ?? mod;
+    }
+    catch (e) {
+        throw new Error('websocket() routes on the Fastify backend require "@fastify/websocket".  '
+            + 'Install it with: bun add @fastify/websocket\nOriginal error: '
+            + (e instanceof Error ? e.message : String(e)));
+    }
+});
 /**
  * Fastify-based default HTTP backend.  Leans on Fastify for fast routing,
  * body parsing (including raw-body support), and its plugin ecosystem.
@@ -11,6 +28,8 @@ export class FastifyBackend {
     name = 'fastify';
     app;
     registered = [];
+    wsRegistered = [];
+    userErrorHandler = null;
     constructor(opts = { logger: false }) {
         this.app = Fastify(opts);
         // Route EVERY content-type through a raw-buffer parser — we want the
@@ -39,11 +58,17 @@ export class FastifyBackend {
                     this.writeResponse(reply, out);
                 }
                 catch (err) {
-                    this.writeError(reply, err);
+                    await this.emitError(reply, adapted, err);
                 }
             },
         });
     }
+    registerWebSocket(reg) {
+        if (this.wsRegistered.some((r) => r.pattern === reg.pattern)) {
+            throw new Error(`FastifyBackend: duplicate websocket route for pattern "${reg.pattern}".`);
+        }
+        this.wsRegistered.push(reg);
+    }
     setNotFound(handler) {
         this.app.setNotFoundHandler(async (req, reply) => {
             const adapted = this.adaptRequest(req);
@@ -52,13 +77,30 @@ export class FastifyBackend {
         });
     }
     setErrorHandler(handler) {
+        // Record the handler so errors thrown by our route handlers — caught
+        // in registerRoute's try/catch, which never reaches Fastify core —
+        // route through it too.  The app-level hook still covers
+        // framework-internal errors (body-parse failures, etc.).
+        this.userErrorHandler = handler;
         this.app.setErrorHandler(async (err, req, reply) => {
-            const adapted = this.adaptRequest(req);
-            const res = await handler(err, adapted);
-            this.writeResponse(reply, res);
+            await this.emitError(reply, this.adaptRequest(req), err);
         });
     }
     async listen(host, port) {
+        if (this.wsRegistered.length > 0) {
+            const plugin = await fastifyWebsocketLazy.get();
+            // Await the register so the plugin's onRoute hook is installed
+            // before we add the ws routes below.  (Awaiting does NOT lock the
+            // route tree — routes can still be added after.)
+            // `options` is forwarded to the underlying `ws` server; `maxPayload`
+            // caps the transport frame size (aligned with the default WS policy) so
+            // an oversized frame is rejected at the protocol level rather than
+            // buffered up to the `ws` 100 MiB default first (security audit WS-3).
+            await this.app
+                .register(plugin, { options: { maxPayload: DEFAULT_WEBSOCKET_MAX_FRAME_BYTES } });
+            for (const reg of this.wsRegistered)
+                this.attachWebsocketRoute(reg);
+        }
         const address = await this.app.listen({ host, port });
         // Fastify returns "http://<host>:<port>".
         const match = /:(\d+)$/.exec(address);
@@ -79,7 +121,7 @@ export class FastifyBackend {
                 //      sockets (Node 18.2+ / Bun).  It does NOT touch
                 //      sockets already upgraded to WebSocket — Node
                 //      releases ownership of those at upgrade time.
-                //   2. For WebSockets we walk `fastify.websocketServer.clients`
+                //   2. For Websockets we walk `fastify.websocketServer.clients`
                 //      (populated by `@fastify/websocket`) and `terminate()`
                 //      each one.  `terminate()` destroys the underlying TCP
                 //      socket without sending a close frame — appropriate
@@ -117,22 +159,59 @@ export class FastifyBackend {
                         catch { /* best-effort */ }
                     }
                 }
-                await closing;
+                // The listening socket is already closed (close() stops accepting
+                // immediately); we've force-terminated remaining connections.  Wait
+                // for `close()` to settle, but bound it — on Bun `close()` can hang
+                // after WebSocket upgrades even once every socket is gone, which
+                // would otherwise make `unbind()` (and shutdown) never resolve.
+                await Promise.race([
+                    closing,
+                    new Promise((resolve) => {
+                        const timer = setTimeout(resolve, 1000);
+                        timer.unref?.();
+                    }),
+                ]);
             },
         };
     }
     /** @internal — used by tests that inspect Fastify state. */
     get fastify() { return this.app; }
+    attachWebsocketRoute(reg) {
+        // Use the `.get(url, { websocket: true }, handler)` shorthand: it is
+        // the form @fastify/websocket wires reliably across runtimes (the
+        // route-object `wsHandler` variant is not picked up on Bun).  The
+        // handler receives the ws socket + request; preValidation replying
+        // cancels the upgrade (auth-at-upgrade).
+        this.app.get(reg.pattern, {
+            websocket: true,
+            preValidation: async (req, reply) => {
+                const res = await reg.authorize(this.adaptRequest(req));
+                if (res)
+                    this.writeResponse(reply, res);
+            },
+        }, (socket, req) => {
+            const adapted = this.adaptRequest(req);
+            reg.onConnection(adapted, websocketPackageAdapter(socket, { remoteAddress: adapted.remoteAddress }));
+        });
+    }
     /* -------------------------------- Helpers ------------------------------- */
     adaptRequest(req) {
         const headers = {};
-        for (const [k, v] of Object.entries(req.headers)) {
-            if (typeof v === 'string')
-                headers[k] = v;
-            else if (Array.isArray(v))
-                headers[k] = v.join(',');
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (typeof value === 'string')
+                headers[key] = value;
+            else if (Array.isArray(value))
+                headers[key] = value.join(',');
         }
         const body = this.asBytes(req.body);
+        // Fastify exposes the connecting peer as `req.ip` — that's the
+        // canonical accessor that also respects the `trustProxy` config
+        // when operators have wired it up.  Fall back to the raw socket
+        // peer if `req.ip` isn't populated (e.g. inside a unit-test mock).
+        // The cast is necessary because `FastifyRequest.ip` is typed as
+        // `string` but can be missing in non-standard test doubles.
+        const remoteAddress = req.ip
+            ?? req.socket?.remoteAddress;
         return {
             method: req.method,
             path: req.url,
@@ -140,6 +219,7 @@ export class FastifyBackend {
             query: req.query ?? {},
             params: req.params ?? {},
             body,
+            ...(remoteAddress ? { remoteAddress } : {}),
         };
     }
     asBytes(raw) {
@@ -157,8 +237,8 @@ export class FastifyBackend {
     writeResponse(reply, res) {
         reply.status(res.status);
         if (res.headers)
-            for (const [k, v] of Object.entries(res.headers))
-                reply.header(k, v);
+            for (const [key, value] of Object.entries(res.headers))
+                reply.header(key, value);
         if (res.contentType)
             reply.header('content-type', res.contentType);
         if (res.body === undefined || res.body === null) {
@@ -177,14 +257,44 @@ export class FastifyBackend {
             reply.send(Buffer.from(res.body));
             return;
         }
+        if (typeof ReadableStream !== 'undefined' && res.body instanceof ReadableStream) {
+            if (!res.contentType && !res.headers?.['content-type'])
+                reply.header('content-type', 'application/octet-stream');
+            reply.send(res.body);
+            return;
+        }
         // Plain object → JSON.
         if (!res.contentType)
             reply.header('content-type', 'application/json; charset=utf-8');
         reply.send(JSON.stringify(res.body));
     }
+    /**
+     * Route a thrown error through the user's error handler when one is set
+     * (falling back to the default mapping if that handler itself throws),
+     * otherwise the default mapping.  Unifies the per-route catch with
+     * Fastify's framework-level hook so both honour `withErrorHandler` —
+     * matching how the Express and Hono backends already behave.
+     */
+    async emitError(reply, req, err) {
+        if (this.userErrorHandler) {
+            try {
+                this.writeResponse(reply, await this.userErrorHandler(err, req));
+                return;
+            }
+            catch (inner) {
+                this.writeError(reply, inner);
+                return;
+            }
+        }
+        this.writeError(reply, err);
+    }
     writeError(reply, err) {
         if (err instanceof HttpError) {
-            reply.status(err.status).send({ error: err.message, ...err.extra });
+            reply.status(err.status);
+            if (err.headers)
+                for (const [k, v] of Object.entries(err.headers))
+                    reply.header(k, v);
+            reply.send({ error: err.message, ...err.extra });
             return;
         }
         reply.status(500).send({ error: 'Internal Server Error', message: err?.message });

package/dist/http/backend/FastifyBackend.js.map

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

package/dist/http/backend/HonoBackend.d.ts

@@ -1,5 +1,23 @@
 import { type HttpRequest, type HttpResponse } from '../types.js';
-import type { HttpServerBackend, RouteRegistration, ServerBinding } from './HttpServerBackend.js';
+import type { HttpServerBackend, RouteRegistration, ServerBinding, WebsocketRouteRegistration } from './HttpServerBackend.js';
+import type { HonoBackendOptions } from './HonoBackendOptions.js';
+/**
+ * True when a declared `Content-Length` exceeds `cap`.  Extracted as a pure
+ * function so the fast-path body-size guard (security audit HTTP-1) can be
+ * unit-tested directly.  A missing/non-numeric header returns `false` — those
+ * fall through to the post-buffer backstop.
+ * @internal
+ */
+export declare function contentLengthExceeds(header: string | undefined, cap: number): boolean;
+/**
+ * Read the outbound send-buffer depth (bytes) from a Hono `WSContext`'s
+ * native socket, so the connection actor's backpressure guard actually fires
+ * on Hono (security audit WS-4).  Bun's `ServerWebSocket` exposes
+ * `getBufferedAmount()`; the Node (`@hono/node-ws`) and Deno sockets expose a
+ * numeric `.bufferedAmount`.  Unknown shape → 0 (guard stays off, as before).
+ * @internal — exported for testing.
+ */
+export declare function readBufferedAmount(raw: unknown): number;
 interface HonoContextLike {
     readonly req: {
         method: string;
@@ -9,14 +27,24 @@ interface HonoContextLike {
         queries(name?: string): Record<string, string[]> | string[] | undefined;
         header(name?: string): Record<string, string> | string | undefined;
         arrayBuffer(): Promise<ArrayBuffer>;
+        /**
+         * Underlying runtime request — typed as `unknown` here because
+         * the concrete shape varies: a Node `IncomingMessage` under
+         * `@hono/node-server`, a Web-Fetch `Request` under Bun.serve.
+         * We probe optional properties for peer-IP extraction in
+         * `adaptRequest`.
+         */
+        readonly raw?: unknown;
     };
+    /** Runtime-specific environment bag — varies per Hono adapter. */
+    readonly env?: unknown;
 }
-type HonoHandler = (c: HonoContextLike) => Promise<Response> | Response;
-type HonoErrorHandler = (err: unknown, c: HonoContextLike) => Promise<Response> | Response;
-type HonoNotFoundHandler = (c: HonoContextLike) => Promise<Response> | Response;
+type HonoHandler = (context: HonoContextLike) => Promise<Response> | Response;
+type HonoErrorHandler = (err: unknown, context: HonoContextLike) => Promise<Response> | Response;
+type HonoNotFoundHandler = (context: HonoContextLike) => Promise<Response> | Response;
 /** Structural subset of the Hono app we consume. */
-interface HonoAppLike {
-    get(path: string, handler: HonoHandler): unknown;
+export interface HonoAppLike {
+    get(path: string, ...handlers: unknown[]): unknown;
     post(path: string, handler: HonoHandler): unknown;
     put(path: string, handler: HonoHandler): unknown;
     delete(path: string, handler: HonoHandler): unknown;
@@ -27,16 +55,6 @@ interface HonoAppLike {
     notFound(handler: HonoNotFoundHandler): unknown;
     fetch(request: Request): Promise<Response> | Response;
 }
-export interface HonoBackendOptions {
-    /**
-     * Bring-your-own Hono app — useful if you already registered middleware
-     * (CORS, JWT, logger) before handing it off.  When omitted, we import
-     * `hono` dynamically and build a fresh app on `listen()`.
-     */
-    readonly app?: HonoAppLike;
-    /** Maximum allowed body size in bytes (default: 10 MiB).  Exceeding it returns 413. */
-    readonly maxBodyBytes?: number;
-}
 /**
  * Hono-backed HTTP backend — a thin adapter that compiles the actor-ts
  * routing DSL onto a Hono app and serves it with `Bun.serve`.  Hono is a
@@ -53,6 +71,7 @@ export declare class HonoBackend implements HttpServerBackend {
     private readonly ownsApp;
     private readonly maxBodyBytes;
     private readonly registered;
+    private readonly wsRegistered;
     private notFoundHandler;
     private errorHandler;
     private server;
@@ -60,10 +79,14 @@ export declare class HonoBackend implements HttpServerBackend {
     /** Inject / access the underlying Hono app — useful for native middleware. */
     getApp(): HonoAppLike;
     registerRoute(route: RouteRegistration): void;
+    registerWebSocket(reg: WebsocketRouteRegistration): void;
     setNotFound(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
     setErrorHandler(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
     listen(host: string, port: number): Promise<ServerBinding>;
     private attachRoute;
+    private attachWebsocketRoute;
+    /** Synchronous upgrade-request snapshot (no body read — always GET). */
+    private adaptUpgradeContext;
     private adaptRequest;
     private writeResponse;
     private createHonoApp;

package/dist/http/backend/HonoBackend.d.ts.map

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