actor-ts 0.9.1 → 0.11.0

package/dist/http/backend/HonoBackend.js

@@ -1,6 +1,60 @@
 import { match } from 'ts-pattern';
-import { getHonoRunner } from '../../runtime/http/index.js';
+import { getHonoRunner, } from '../../runtime/http/index.js';
 import { HttpError } from '../types.js';
+import { HonoBackendOptionsValidator } from './HonoBackendOptions.js';
+/** Hono delivers text as a string and binary as ArrayBuffer/Uint8Array. */
+function coerceWebsocketData(data) {
+    if (typeof data === 'string')
+        return data;
+    if (data instanceof Uint8Array)
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    return new Uint8Array(0);
+}
+/**
+ * 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 function contentLengthExceeds(header, cap) {
+    if (header === undefined)
+        return false;
+    const declaredLength = Number(header);
+    return Number.isFinite(declaredLength) && declaredLength > cap;
+}
+/** Standard 413 response used by the body-size guards. */
+function payloadTooLarge() {
+    return new Response('Payload Too Large', {
+        status: 413,
+        headers: { 'content-type': 'text/plain; charset=utf-8' },
+    });
+}
+/** Read the `Content-Length` header off a Hono context as a string, if present. */
+function contentLengthHeader(c) {
+    const cl = c.req.header('content-length');
+    return typeof cl === 'string' ? cl : undefined;
+}
+/**
+ * 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 function readBufferedAmount(raw) {
+    if (!raw || typeof raw !== 'object')
+        return 0;
+    const sock = raw;
+    if (typeof sock.getBufferedAmount === 'function') {
+        const buffered = sock.getBufferedAmount();
+        return typeof buffered === 'number' && Number.isFinite(buffered) ? buffered : 0;
+    }
+    return typeof sock.bufferedAmount === 'number' && Number.isFinite(sock.bufferedAmount) ? sock.bufferedAmount : 0;
+}
 /**
  * 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
@@ -17,15 +71,18 @@ export class HonoBackend {
     ownsApp;
     maxBodyBytes;
     registered = [];
+    wsRegistered = [];
     notFoundHandler = null;
     errorHandler = null;
     // Runtime-neutral server handle; the per-runtime adapter supplies a
     // concrete implementation (Bun.serve / @hono/node-server / Deno.serve).
     server = null;
     constructor(options = {}) {
-        this.app = options.app ?? null;
-        this.ownsApp = options.app == null;
-        this.maxBodyBytes = options.maxBodyBytes ?? 10 * 1024 * 1024;
+        const resolvedOptions = options;
+        new HonoBackendOptionsValidator().validate(resolvedOptions);
+        this.app = resolvedOptions.app ?? null;
+        this.ownsApp = resolvedOptions.app == null;
+        this.maxBodyBytes = resolvedOptions.maxBodyBytes ?? 10 * 1024 * 1024;
     }
     /** Inject / access the underlying Hono app — useful for native middleware. */
     getApp() {
@@ -36,6 +93,12 @@ export class HonoBackend {
     registerRoute(route) {
         this.registered.push(route);
     }
+    registerWebSocket(reg) {
+        if (this.wsRegistered.some((r) => r.pattern === reg.pattern)) {
+            throw new Error(`HonoBackend: duplicate websocket route for pattern "${reg.pattern}".`);
+        }
+        this.wsRegistered.push(reg);
+    }
     setNotFound(handler) {
         this.notFoundHandler = handler;
     }
@@ -46,18 +109,22 @@ export class HonoBackend {
         if (!this.app)
             this.app = await this.createHonoApp();
         const app = this.app;
-        for (const r of this.registered)
-            this.attachRoute(r);
+        const explicitHead = new Set(this.registered.filter((r) => r.method === 'HEAD').map((r) => r.pattern));
+        for (const r of this.registered) {
+            this.attachRoute(r, r.method === 'GET' && !explicitHead.has(r.pattern));
+        }
         if (this.notFoundHandler) {
             const handler = this.notFoundHandler;
-            app.notFound(async (c) => {
-                const req = await this.adaptRequest(c);
+            app.notFound(async (context) => {
+                if (contentLengthExceeds(contentLengthHeader(context), this.maxBodyBytes))
+                    return payloadTooLarge();
+                const req = await this.adaptRequest(context);
                 const res = await handler(req);
                 return this.writeResponse(res);
             });
         }
-        app.onError(async (err, c) => {
-            const req = await this.adaptRequest(c);
+        app.onError(async (err, context) => {
+            const req = await this.adaptRequest(context);
             if (this.errorHandler) {
                 try {
                     const res = await this.errorHandler(err, req);
@@ -70,18 +137,37 @@ export class HonoBackend {
             if (err instanceof HttpError) {
                 return new Response(JSON.stringify({ error: err.message, ...err.extra }), {
                     status: err.status,
-                    headers: { 'content-type': 'application/json; charset=utf-8' },
+                    headers: { 'content-type': 'application/json; charset=utf-8', ...(err.headers ?? {}) },
                 });
             }
             return new Response(JSON.stringify({ error: 'Internal Server Error', message: err?.message ?? String(err) }), { status: 500, headers: { 'content-type': 'application/json; charset=utf-8' } });
         });
         const runner = await getHonoRunner();
+        // WebSocket routes: obtain the per-runtime bridge, register each route
+        // as a GET carrying the authorize guard + Hono's upgrade middleware,
+        // and fold the bridge's serve options in (Bun needs `{ websocket }`).
+        let bridge = null;
+        if (this.wsRegistered.length > 0) {
+            if (!runner.webSocket) {
+                throw new Error('HonoBackend: this runtime\'s Hono runner does not support websocket() routes.');
+            }
+            bridge = await runner.webSocket(app);
+            for (const reg of this.wsRegistered)
+                this.attachWebsocketRoute(app, bridge, reg);
+        }
+        // Forward ALL args to app.fetch — Bun invokes fetch(request, server)
+        // and Hono's WebSocket upgrade needs that second `server` argument to
+        // call server.upgrade().  A single-arg wrapper would silently break
+        // upgrades (HTTP still works, WS never opens).
+        const appFetch = app.fetch;
         const server = await runner.serve({
             host,
             port,
-            fetch: (request) => app.fetch(request),
+            fetch: ((...args) => appFetch(...args)),
+            serveOptions: bridge?.serveOptions,
         });
         this.server = server;
+        bridge?.attach?.(server);
         return {
             host: server.host,
             port: server.port,
@@ -96,8 +182,8 @@ export class HonoBackend {
                     await Promise.race([
                         srv.stop(true),
                         new Promise((resolve) => {
-                            const t = setTimeout(() => resolve(), gracePeriodMs);
-                            t.unref?.();
+                            const timer = setTimeout(() => resolve(), gracePeriodMs);
+                            timer.unref?.();
                         }),
                     ]);
                     await srv.stop(false); // force any still-active connections
@@ -108,22 +194,43 @@ export class HonoBackend {
         };
     }
     /* ============================ internals ============================ */
-    attachRoute(route) {
+    attachRoute(route, addHeadTwin = false) {
         const app = this.app;
+        const wildcard = route.pattern.endsWith('/*');
+        const prefix = wildcard ? route.pattern.slice(0, -2) : '';
         const handler = async (c) => {
+            // Reject an oversized Content-Length BEFORE buffering the body.  The
+            // post-buffer check below is a backstop for chunked bodies that omit
+            // Content-Length (security audit HTTP-1) — previously the whole
+            // body was materialised via arrayBuffer() before any size check,
+            // making the 10 MiB cap cosmetic against the runtime's much larger
+            // native default.
+            if (contentLengthExceeds(contentLengthHeader(c), this.maxBodyBytes))
+                return payloadTooLarge();
             const req = await this.adaptRequest(c);
-            if (req.body && req.body.byteLength > this.maxBodyBytes) {
-                return new Response('Payload Too Large', {
-                    status: 413,
-                    headers: { 'content-type': 'text/plain; charset=utf-8' },
-                });
-            }
-            const out = await route.handler(req);
+            if (req.body && req.body.byteLength > this.maxBodyBytes)
+                return payloadTooLarge();
+            // Wildcard contract: expose the matched remainder as params['*'].
+            const finalReq = wildcard
+                ? { ...req, params: { ...req.params, '*': honoWildcardRest(c.req.path ?? new URL(c.req.url).pathname, prefix) } }
+                : req;
+            const out = await route.handler(finalReq);
             return this.writeResponse(out);
         };
         const method = route.method.toLowerCase();
         match(method)
-            .with('get', () => app.get(route.pattern, handler))
+            .with('get', () => {
+            app.get(route.pattern, handler);
+            // Hono doesn't auto-dispatch HEAD to a GET route (Fastify/Express
+            // do), so mirror GET as HEAD (body stripped) unless an explicit
+            // HEAD route already covers this pattern.
+            if (addHeadTwin) {
+                app.on('HEAD', route.pattern, async (c) => {
+                    const full = await handler(c);
+                    return new Response(null, { status: full.status, headers: full.headers });
+                });
+            }
+        })
             .with('post', () => app.post(route.pattern, handler))
             .with('put', () => app.put(route.pattern, handler))
             .with('delete', () => app.delete(route.pattern, handler))
@@ -132,45 +239,129 @@ export class HonoBackend {
             .with('options', () => app.options(route.pattern, handler))
             .exhaustive();
     }
-    async adaptRequest(c) {
-        const method = c.req.method.toUpperCase();
-        const headers = c.req.header() ?? {};
+    attachWebsocketRoute(app, bridge, reg) {
+        // Guard middleware runs the authorize check against the upgrade
+        // request; returning a Response short-circuits (no upgrade).
+        const guard = async (context, next) => {
+            const res = await reg.authorize(this.adaptUpgradeContext(context));
+            if (res)
+                return this.writeResponse(res);
+            await next();
+        };
+        const createEvents = (raw) => {
+            const context = raw;
+            const adapted = this.adaptUpgradeContext(context);
+            let ws = null;
+            let listeners = null;
+            // Frames that arrive before setListeners runs (defensive — Hono
+            // dispatches onOpen before onMessage, but the buffer makes it
+            // unconditional).
+            const pending = [];
+            const adapter = {
+                send: (data) => ws?.send(data),
+                close: (code, reason) => ws?.close(code, reason),
+                setListeners: (incoming) => {
+                    listeners = incoming;
+                    const buffered = pending.splice(0);
+                    for (const data of buffered)
+                        incoming.onMessage(data);
+                },
+                get readyState() {
+                    return (ws?.readyState ?? 1);
+                },
+                // Enables the backpressure guard in WebsocketConnectionActor on Hono
+                // (was a no-op before — the adapter had no bufferedAmount).  WS-4.
+                bufferedAmount: () => readBufferedAmount(ws?.raw),
+                remoteAddress: adapted.remoteAddress,
+                get protocol() {
+                    return ws?.protocol;
+                },
+            };
+            return {
+                onOpen: (_evt, wsCtx) => {
+                    ws = wsCtx;
+                    reg.onConnection(adapted, adapter);
+                },
+                onMessage: (evt, wsCtx) => {
+                    ws = wsCtx;
+                    const data = coerceWebsocketData(evt.data);
+                    if (listeners)
+                        listeners.onMessage(data);
+                    else
+                        pending.push(data);
+                },
+                onClose: (evt) => listeners?.onClose(evt.code ?? 1005, evt.reason ?? ''),
+                onError: () => listeners?.onError(new Error('websocket error')),
+            };
+        };
+        app.get(reg.pattern, guard, bridge.upgradeWebSocket(createEvents));
+    }
+    /** Synchronous upgrade-request snapshot (no body read — always GET). */
+    adaptUpgradeContext(context) {
+        const headers = context.req.header() ?? {};
+        let params = {};
+        try {
+            params = context.req.param() ?? {};
+        }
+        catch { /* no match — leave empty */ }
+        const rawQueries = context.req.queries() ?? {};
+        const query = {};
+        for (const [key, value] of Object.entries(rawQueries)) {
+            if (value)
+                query[key] = value.length === 1 ? value[0] : value;
+        }
+        const remoteAddress = extractHonoRemoteAddress(context);
+        return {
+            method: 'GET',
+            path: context.req.path ?? new URL(context.req.url).pathname,
+            headers,
+            query,
+            params,
+            body: null,
+            ...(remoteAddress ? { remoteAddress } : {}),
+        };
+    }
+    async adaptRequest(context) {
+        const method = context.req.method.toUpperCase();
+        const headers = context.req.header() ?? {};
         // `c.req.param()` throws inside notFound / onError handlers because no
         // route matched — swallow that, an empty params object is the right
         // fallback there.
         let params = {};
         try {
-            params = c.req.param() ?? {};
+            params = context.req.param() ?? {};
         }
         catch { /* no match — leave empty */ }
         // Hono returns queries as Record<string, string[]>; flatten single values.
-        const rawQueries = c.req.queries() ?? {};
+        const rawQueries = context.req.queries() ?? {};
         const query = {};
-        for (const [k, v] of Object.entries(rawQueries)) {
-            if (!v)
+        for (const [key, value] of Object.entries(rawQueries)) {
+            if (!value)
                 continue;
-            query[k] = v.length === 1 ? v[0] : v;
+            query[key] = value.length === 1 ? value[0] : value;
         }
         let body = null;
         if (method !== 'GET' && method !== 'HEAD' && method !== 'OPTIONS') {
-            const buf = await c.req.arrayBuffer();
+            const buf = await context.req.arrayBuffer();
             if (buf.byteLength > 0)
                 body = new Uint8Array(buf);
         }
+        const remoteAddress = extractHonoRemoteAddress(context);
         return {
             method,
-            path: c.req.path ?? new URL(c.req.url).pathname,
+            path: context.req.path ?? new URL(context.req.url).pathname,
             headers,
             query,
             params,
             body,
+            ...(remoteAddress ? { remoteAddress } : {}),
         };
     }
     writeResponse(res) {
         const headers = new Headers();
         if (res.headers)
-            for (const [k, v] of Object.entries(res.headers))
-                headers.set(k, v);
+            for (const [key, value] of Object.entries(res.headers))
+                headers.set(key, value);
         if (res.contentType)
             headers.set('content-type', res.contentType);
         const body = res.body;
@@ -189,6 +380,11 @@ export class HonoBackend {
             // (yet) parameterised that way, so the direct assignment errors.
             return new Response(body, { status: res.status, headers });
         }
+        if (typeof ReadableStream !== 'undefined' && body instanceof ReadableStream) {
+            if (!headers.has('content-type'))
+                headers.set('content-type', 'application/octet-stream');
+            return new Response(body, { status: res.status, headers });
+        }
         if (!headers.has('content-type'))
             headers.set('content-type', 'application/json; charset=utf-8');
         return new Response(JSON.stringify(body), { status: res.status, headers });
@@ -209,4 +405,42 @@ export class HonoBackend {
         }
     }
 }
+/** The path remainder a `/prefix/*` route matched (still URL-encoded — the caller decodes). */
+function honoWildcardRest(path, prefix) {
+    const withSlash = `${prefix}/`;
+    if (path.startsWith(withSlash))
+        return path.slice(withSlash.length);
+    if (path === prefix)
+        return '';
+    return path.replace(/^\/+/, '');
+}
+/**
+ * Best-effort peer-IP extraction across Hono's adapter zoo.  Tries
+ * the well-known shapes (Node-server `c.req.raw.socket.remoteAddress`,
+ * Bun `c.env.requestIP({ ... }).address`, Cloudflare `c.req.raw.cf.ip`),
+ * returns `undefined` if none of them yield a string.  Consumers
+ * that need a guaranteed IP must override `getClientIp` on
+ * IpAllowlist or similar middlewares.
+ */
+function extractHonoRemoteAddress(context) {
+    // 1. @hono/node-server: c.req.raw is the Node IncomingMessage.
+    const raw = context.req.raw;
+    if (raw?.socket?.remoteAddress)
+        return raw.socket.remoteAddress;
+    // 2. Bun.serve via Hono: connection info lives on `c.env`.
+    //    Bun's adapter exposes a `requestIP` callable.
+    const env = context.env;
+    if (env?.requestIP && context.req.raw) {
+        try {
+            const info = env.requestIP(context.req.raw);
+            if (info?.address)
+                return info.address;
+        }
+        catch { /* runtime didn't accept the raw shape — fall through */ }
+    }
+    // 3. Some adapters (e.g. Vercel) put the connection info on env.incoming.
+    if (env?.incoming?.socket?.remoteAddress)
+        return env.incoming.socket.remoteAddress;
+    return undefined;
+}
 //# sourceMappingURL=HonoBackend.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * All Hono-backend option-relevant types live here:
+ *
+ *   - {@link HonoBackendOptionsType} — the plain options-object shape
+ *     (what you may also pass as a bare `{ … }` object).
+ *   - {@link HonoBackendOptionsBuilder} — the fluent builder
+ *     (`HonoBackendOptions.create()…`).
+ *   - {@link HonoBackendOptions} — the accepted-input **union**
+ *     (`HonoBackendOptionsBuilder | HonoBackendOptionsType`), plus a value
+ *     alias to the builder so `HonoBackendOptions.create()` /
+ *     `new HonoBackendOptions()` keep working.
+ *
+ *     const backendOptions = HonoBackendOptions.create()
+ *       .withMaxBodyBytes(1 << 20);
+ *     new HonoBackend(backendOptions);
+ */
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+import type { HonoAppLike } from './HonoBackend.js';
+/** Plain options-object shape accepted by a {@link HonoBackend}. */
+export interface HonoBackendOptionsType {
+    /**
+     * 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;
+}
+/** Fluent builder for {@link HonoBackendOptionsType}. */
+export declare class HonoBackendOptionsBuilder extends OptionsBuilder<HonoBackendOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new HonoBackendOptionsBuilder()`. */
+    static create(): HonoBackendOptionsBuilder;
+    /** Bring-your-own Hono app (skips the internal `hono` import). */
+    withApp(app: HonoAppLike): this;
+    /** Maximum request body size in bytes.  Default 10 MiB; exceeding it returns 413. */
+    withMaxBodyBytes(bytes: number): this;
+}
+/** Validates resolved {@link HonoBackendOptionsType} settings. */
+export declare class HonoBackendOptionsValidator extends OptionsValidator<HonoBackendOptionsType> {
+    constructor();
+    protected rules(_s: Partial<HonoBackendOptionsType>): void;
+}
+/**
+ * Accepted input for the {@link HonoBackend} constructor: the fluent
+ * {@link HonoBackendOptionsBuilder} OR a plain {@link HonoBackendOptionsType}
+ * object.
+ */
+export type HonoBackendOptions = HonoBackendOptionsBuilder | Partial<HonoBackendOptionsType>;
+/** Value alias so `HonoBackendOptions.create()` / `new HonoBackendOptions()` resolve to the builder. */
+export declare const HonoBackendOptions: typeof HonoBackendOptionsBuilder;
+//# sourceMappingURL=HonoBackendOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HonoBackendOptions.d.ts","sourceRoot":"","sources":["../../../src/http/backend/HonoBackendOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yDAAyD;AACzD,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,sBAAsB,CAAC;IACnF,+EAA+E;IAC/E,MAAM,CAAC,MAAM,IAAI,yBAAyB;IAI1C,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAI/B,qFAAqF;IACrF,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGtC;AAED,kEAAkE;AAClE,qBAAa,2BAA4B,SAAQ,gBAAgB,CAAC,sBAAsB,CAAC;;IAIvF,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;CAG3D;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAC7F,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,kCAA4B,CAAC"}

package/dist/http/backend/HonoBackendOptions.js

@@ -0,0 +1,45 @@
+/**
+ * All Hono-backend option-relevant types live here:
+ *
+ *   - {@link HonoBackendOptionsType} — the plain options-object shape
+ *     (what you may also pass as a bare `{ … }` object).
+ *   - {@link HonoBackendOptionsBuilder} — the fluent builder
+ *     (`HonoBackendOptions.create()…`).
+ *   - {@link HonoBackendOptions} — the accepted-input **union**
+ *     (`HonoBackendOptionsBuilder | HonoBackendOptionsType`), plus a value
+ *     alias to the builder so `HonoBackendOptions.create()` /
+ *     `new HonoBackendOptions()` keep working.
+ *
+ *     const backendOptions = HonoBackendOptions.create()
+ *       .withMaxBodyBytes(1 << 20);
+ *     new HonoBackend(backendOptions);
+ */
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+/** Fluent builder for {@link HonoBackendOptionsType}. */
+export class HonoBackendOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new HonoBackendOptionsBuilder()`. */
+    static create() {
+        return new HonoBackendOptionsBuilder();
+    }
+    /** Bring-your-own Hono app (skips the internal `hono` import). */
+    withApp(app) {
+        return this.set('app', app);
+    }
+    /** Maximum request body size in bytes.  Default 10 MiB; exceeding it returns 413. */
+    withMaxBodyBytes(bytes) {
+        return this.set('maxBodyBytes', bytes);
+    }
+}
+/** Validates resolved {@link HonoBackendOptionsType} settings. */
+export class HonoBackendOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('HonoBackendOptions');
+    }
+    rules(_s) {
+        this.positiveInt('maxBodyBytes');
+    }
+}
+/** Value alias so `HonoBackendOptions.create()` / `new HonoBackendOptions()` resolve to the builder. */
+export const HonoBackendOptions = HonoBackendOptionsBuilder;
+//# sourceMappingURL=HonoBackendOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HonoBackendOptions.js","sourceRoot":"","sources":["../../../src/http/backend/HonoBackendOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAelE,yDAAyD;AACzD,MAAM,OAAO,yBAA0B,SAAQ,cAAsC;IACnF,+EAA+E;IAC/E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,yBAAyB,EAAE,CAAC;IACzC,CAAC;IAED,kEAAkE;IAClE,OAAO,CAAC,GAAgB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,qFAAqF;IACrF,gBAAgB,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,2BAA4B,SAAQ,gBAAwC;IACvF;QACE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9B,CAAC;IACS,KAAK,CAAC,EAAmC;QACjD,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;CACF;AAQD,wGAAwG;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC"}

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

@@ -1,4 +1,5 @@
 import type { HttpMethod, HttpRequest, HttpResponse } from '../types.js';
+import type { WebsocketSocketAdapter } from '../websocket/SocketAdapter.js';
 /** One route registration — supplied by the DSL after compilation. */
 export interface RouteRegistration {
     readonly method: HttpMethod;
@@ -6,6 +7,23 @@ export interface RouteRegistration {
     readonly pattern: string;
     readonly handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse;
 }
+/**
+ * One WebSocket route registration.  The backend accepts the HTTP
+ * upgrade at `pattern` (a GET), MUST call `authorize` first (a non-null
+ * result means: send that plain HTTP response and DO NOT upgrade), and
+ * then call `onConnection` exactly once — **synchronously** inside its
+ * native open/upgrade callback — handing over a normalised socket.
+ * Everything actor-related lives behind `onConnection`; the backend
+ * never sees the framework's actors.
+ */
+export interface WebsocketRouteRegistration {
+    /** ':param'-style pattern, same dialect as {@link RouteRegistration.pattern}. */
+    readonly pattern: string;
+    /** Pre-upgrade guard.  `null` → proceed; `HttpResponse` → reject with it. */
+    readonly authorize: (req: HttpRequest) => Promise<HttpResponse | null>;
+    /** Called once per accepted connection, synchronously in the upgrade callback. */
+    readonly onConnection: (req: HttpRequest, socket: WebsocketSocketAdapter) => void;
+}
 export interface ServerBinding {
     readonly host: string;
     readonly port: number;
@@ -23,9 +41,25 @@ export interface HttpServerBackend {
     registerRoute(route: RouteRegistration): void;
     /** Start listening.  Returns a ServerBinding with the actual bound port. */
     listen(host: string, port: number): Promise<ServerBinding>;
-    /** Optionally register a catch-all not-found handler. */
+    /**
+     * Optional: register a method-agnostic not-found handler, invoked for
+     * any request that matched no route (including unmatched OPTIONS/HEAD).
+     * `HttpExtension` wires `fallback()` here.  If the handler throws, the
+     * backend applies its default error mapping.
+     */
     setNotFound?(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
-    /** Optionally register a global error handler. */
+    /**
+     * Optional: register a last-resort error handler.  It MUST see both
+     * errors thrown by route handlers AND backend-internal errors (body
+     * parsing, etc.); if it throws, the backend falls back to its default
+     * error mapping.  `HttpExtension` wires `withErrorHandler` here.
+     */
     setErrorHandler?(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    /**
+     * Optional capability: register a WebSocket endpoint.  Backends that
+     * implement this support `websocket()` routes; absence is detected by
+     * `HttpExtension.bind` and reported as a clear error.
+     */
+    registerWebSocket?(reg: WebsocketRouteRegistration): void;
 }
 //# sourceMappingURL=HttpServerBackend.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HttpServerBackend.d.ts","sourceRoot":"","sources":["../../../src/http/backend/HttpServerBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CAC9E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE9C,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D,yDAAyD;IACzD,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAExF,kDAAkD;IAClD,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;CAC3G"}
+{"version":3,"file":"HttpServerBackend.d.ts","sourceRoot":"","sources":["../../../src/http/backend/HttpServerBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CAC9E;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACvE,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE9C,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAExF;;;;;OAKG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAE1G;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,GAAG,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC3D"}