@rhythmjs/router 0.0.8 → 0.0.9

package/README.md

@@ -77,15 +77,17 @@ Everything above (`RhythmRouter`, `ctx.response`, etc.) is runtime-agnostic. Two
 
 ## Deploying per runtime
 
-One app definition; each runtime has its own adapter under `@rhythmjs/router/adapters/*`, hono-style: import `handle` from your target's adapter and export what the platform expects.
+One app definition; each runtime has its own adapter under `@rhythmjs/router/adapters/*`, hono-style: import from your target's adapter and export what the platform expects. Runtimes that speak web-standard `Request`/`Response` natively (Bun, Deno, Vercel) can equally use `toFetchHandler(app)` from `@rhythmjs/router/fetch` — their adapters are aliases for it.
 
-**Node**
+Every adapter maps errors thrown in the middleware chain to a response (`500`, or the error's own `status`) instead of crashing, and accepts `{ onError }` to replace that mapping: `handle(app, { onError: (error) => new Response("down", { status: 503 }) })`. Platform metadata (Cloudflare `env`/`ctx`, the Netlify context) is readable in middleware via `getRuntime(ctx.request)` from `@rhythmjs/router/context`.
+
+**Node** — `getRequestListener` returns a listener for your own `node:http` server:
 
 ```ts
 import { createServer } from "node:http";
-import { handle } from "@rhythmjs/router/adapters/node";
+import { getRequestListener } from "@rhythmjs/router/adapters/node";
 
-createServer(handle(app, { maxRequestBodySize: 1024 * 1024 })).listen(3000);
+createServer(getRequestListener(app, { maxRequestBodySize: 1024 * 1024 })).listen(3000);
 ```
 
 (Or skip the adapter entirely and use `serve(app, { port: 3000 })`.)

package/dist/adapters/aws-lambda.d.ts

@@ -1,7 +1,8 @@
-import { RhythmHttpContext } from "../context.js";
+import { t as RhythmHttpContext } from "../context-ChHlG-q0.js";
+import { t as AdapterOptions } from "../base--TyruAfY.js";
 import { AWSLambdaHandler } from "srvx/aws-lambda";
 import { Rhythm } from "@rhythmjs/rhythm";
 //#region src/adapters/aws-lambda.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): AWSLambdaHandler;
+export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>, options?: AdapterOptions): AWSLambdaHandler;
 //#endregion
-export type { AWSLambdaHandler };
+export type { AWSLambdaHandler, AdapterOptions };

package/dist/adapters/aws-lambda.js

@@ -1,8 +1,9 @@
-import { toFetchHandler } from "../fetch.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 import { toLambdaHandler } from "srvx/aws-lambda";
 //#region src/adapters/aws-lambda.ts
-function handle(app) {
-	return toLambdaHandler({ fetch: toFetchHandler(app) });
+const fetchHandle = createFetchAdapter();
+function handle(app, options = {}) {
+	return toLambdaHandler({ fetch: fetchHandle(app, options) });
 }
 //#endregion
 export { handle };

package/dist/adapters/bun.d.ts

@@ -1,5 +1,5 @@
-import { RhythmHttpContext } from "../context.js";
-import { Rhythm } from "@rhythmjs/rhythm";
+import { n as FetchAdapter, t as AdapterOptions } from "../base--TyruAfY.js";
 //#region src/adapters/bun.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request) => Promise<Response>;
-//#endregion
+export declare const handle: FetchAdapter;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/bun.js

@@ -1,7 +1,5 @@
-import { toFetchHandler } from "../fetch.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/bun.ts
-function handle(app) {
-	return toFetchHandler(app);
-}
+const handle = createFetchAdapter();
 //#endregion
 export { handle };

package/dist/adapters/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { RhythmHttpContext } from "../context.js";
-import { Rhythm } from "@rhythmjs/rhythm";
+import { n as FetchAdapter, t as AdapterOptions } from "../base--TyruAfY.js";
 //#region src/adapters/cloudflare.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request, env?: unknown, context?: unknown) => Promise<Response>;
-//#endregion
+export declare const handle: FetchAdapter<[env?: unknown, context?: unknown]>;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/cloudflare.js

@@ -1,20 +1,13 @@
-import { toFetchHandler } from "../fetch.js";
+import { n as setRuntime, t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/cloudflare.ts
-function handle(app) {
-	const handler = toFetchHandler(app);
-	return (request, env, context) => {
-		if (env !== void 0 || context !== void 0) Object.defineProperty(request, "runtime", {
-			value: {
-				name: "cloudflare",
-				cloudflare: {
-					env,
-					context
-				}
-			},
-			configurable: true
-		});
-		return handler(request);
-	};
-}
+const handle = createFetchAdapter((request, env, context) => {
+	if (env !== void 0 || context !== void 0) setRuntime(request, {
+		name: "cloudflare",
+		cloudflare: {
+			env,
+			context
+		}
+	});
+});
 //#endregion
 export { handle };

package/dist/adapters/deno.d.ts

@@ -1,5 +1,5 @@
-import { RhythmHttpContext } from "../context.js";
-import { Rhythm } from "@rhythmjs/rhythm";
+import { n as FetchAdapter, t as AdapterOptions } from "../base--TyruAfY.js";
 //#region src/adapters/deno.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request) => Promise<Response>;
-//#endregion
+export declare const handle: FetchAdapter;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/deno.js

@@ -1,7 +1,5 @@
-import { toFetchHandler } from "../fetch.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/deno.ts
-function handle(app) {
-	return toFetchHandler(app);
-}
+const handle = createFetchAdapter();
 //#endregion
 export { handle };

package/dist/adapters/netlify.d.ts

@@ -1,5 +1,5 @@
-import { RhythmHttpContext } from "../context.js";
-import { Rhythm } from "@rhythmjs/rhythm";
+import { n as FetchAdapter, t as AdapterOptions } from "../base--TyruAfY.js";
 //#region src/adapters/netlify.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request, context?: unknown) => Promise<Response>;
-//#endregion
+export declare const handle: FetchAdapter<[context?: unknown]>;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/netlify.js

@@ -1,17 +1,10 @@
-import { toFetchHandler } from "../fetch.js";
+import { n as setRuntime, t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/netlify.ts
-function handle(app) {
-	const handler = toFetchHandler(app);
-	return (request, context) => {
-		if (context !== void 0) Object.defineProperty(request, "runtime", {
-			value: {
-				name: "netlify",
-				netlify: { context }
-			},
-			configurable: true
-		});
-		return handler(request);
-	};
-}
+const handle = createFetchAdapter((request, context) => {
+	if (context !== void 0) setRuntime(request, {
+		name: "netlify",
+		netlify: { context }
+	});
+});
 //#endregion
 export { handle };

package/dist/adapters/node.d.ts

@@ -1,9 +1,11 @@
-import { RhythmHttpContext } from "../context.js";
-import { NodeHttpHandler } from "srvx";
+import { t as RhythmHttpContext } from "../context-ChHlG-q0.js";
+import { t as AdapterOptions } from "../base--TyruAfY.js";
+import { NodeHttp1Handler, NodeHttp2Handler } from "srvx";
 import { Rhythm } from "@rhythmjs/rhythm";
 //#region src/adapters/node.d.ts
-export interface NodeHandlerOptions {
+export interface NodeHandlerOptions extends AdapterOptions {
   maxRequestBodySize?: number;
 }
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>, options?: NodeHandlerOptions): NodeHttpHandler;
+export type NodeHandler = NodeHttp1Handler & NodeHttp2Handler;
+export declare function getRequestListener<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>, options?: NodeHandlerOptions): NodeHandler;
 //#endregion

package/dist/adapters/node.js

@@ -1,17 +1,9 @@
-import { toFetchHandler } from "../fetch.js";
-import { errorToResponse } from "../serve.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 import { toNodeHandler } from "srvx/node";
 //#region src/adapters/node.ts
-function handle(app, options = {}) {
-	const handler = toFetchHandler(app);
-	const safeHandler = async (request) => {
-		try {
-			return await handler(request);
-		} catch (error) {
-			return errorToResponse(error);
-		}
-	};
-	return toNodeHandler(safeHandler, options);
+const fetchHandle = createFetchAdapter();
+function getRequestListener(app, options = {}) {
+	return toNodeHandler(fetchHandle(app, options), options);
 }
 //#endregion
-export { handle };
+export { getRequestListener };

package/dist/adapters/service-worker.d.ts

@@ -1,9 +1,11 @@
-import { RhythmHttpContext } from "../context.js";
+import { t as RhythmHttpContext } from "../context-ChHlG-q0.js";
+import { t as AdapterOptions } from "../base--TyruAfY.js";
 import { Rhythm } from "@rhythmjs/rhythm";
 //#region src/adapters/service-worker.d.ts
 interface FetchEventLike {
   readonly request: Request;
   respondWith(response: Response | Promise<Response>): void;
 }
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (event: FetchEventLike) => void;
-//#endregion
+export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>, options?: AdapterOptions): (event: FetchEventLike) => void;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/service-worker.js

@@ -1,7 +1,8 @@
-import { toFetchHandler } from "../fetch.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/service-worker.ts
-function handle(app) {
-	const handler = toFetchHandler(app);
+const fetchHandle = createFetchAdapter();
+function handle(app, options = {}) {
+	const handler = fetchHandle(app, options);
 	return (event) => {
 		event.respondWith(handler(event.request));
 	};

package/dist/adapters/vercel.d.ts

@@ -1,5 +1,5 @@
-import { RhythmHttpContext } from "../context.js";
-import { Rhythm } from "@rhythmjs/rhythm";
+import { n as FetchAdapter, t as AdapterOptions } from "../base--TyruAfY.js";
 //#region src/adapters/vercel.d.ts
-export declare function handle<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request) => Promise<Response>;
-//#endregion
+export declare const handle: FetchAdapter;
+//#endregion
+export type { AdapterOptions };

package/dist/adapters/vercel.js

@@ -1,7 +1,5 @@
-import { toFetchHandler } from "../fetch.js";
+import { t as createFetchAdapter } from "../base-B8GEu3z4.js";
 //#region src/adapters/vercel.ts
-function handle(app) {
-	return toFetchHandler(app);
-}
+const handle = createFetchAdapter();
 //#endregion
 export { handle };

package/dist/base--TyruAfY.d.ts

@@ -0,0 +1,10 @@
+import { t as RhythmHttpContext } from "./context-ChHlG-q0.js";
+import { ErrorHandler, ServerRuntimeContext } from "srvx";
+import { Rhythm } from "@rhythmjs/rhythm";
+//#region src/adapters/base.d.ts
+interface AdapterOptions {
+  onError?: ErrorHandler;
+}
+type FetchAdapter<TExtra extends unknown[] = []> = <TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>, options?: AdapterOptions) => (request: Request, ...extra: TExtra) => Promise<Response>;
+//#endregion
+export { FetchAdapter as n, AdapterOptions as t };

package/dist/base-B8GEu3z4.js

@@ -0,0 +1,25 @@
+import { toFetchHandler } from "./fetch.js";
+import { errorToResponse } from "./serve.js";
+//#region src/adapters/base.ts
+function setRuntime(request, runtime) {
+	Object.defineProperty(request, "runtime", {
+		value: runtime,
+		configurable: true
+	});
+}
+function createFetchAdapter(enrich) {
+	return (app, options = {}) => {
+		const handler = toFetchHandler(app);
+		const onError = options.onError ?? errorToResponse;
+		return async (request, ...extra) => {
+			try {
+				enrich?.(request, ...extra);
+				return await handler(request);
+			} catch (error) {
+				return onError(error);
+			}
+		};
+	};
+}
+//#endregion
+export { setRuntime as n, createFetchAdapter as t };

package/dist/context-ChHlG-q0.d.ts

@@ -0,0 +1,24 @@
+import { ServerRuntimeContext } from "srvx";
+//#region src/context.d.ts
+type RhythmRuntime = ServerRuntimeContext;
+declare function getRuntime(request: Request): RhythmRuntime | undefined;
+type RhythmResponseBody = string | ArrayBuffer | Uint8Array | Blob | FormData | URLSearchParams | ReadableStream<Uint8Array> | null;
+declare class RhythmResponse {
+  status: number;
+  statusText: string | undefined;
+  headers: Headers;
+  body: RhythmResponseBody;
+}
+interface RhythmHttpContext {
+  readonly request: Request;
+  readonly response: RhythmResponse;
+  json(data: unknown, status?: number): void;
+  text(body: string, status?: number): void;
+  html(body: string, status?: number): void;
+  error(status: number, message?: string): void;
+  redirect(url: string, status?: number): void;
+}
+declare function createHttpContext(request: Request): RhythmHttpContext;
+declare function toResponse(response: RhythmResponse): Response;
+//#endregion
+export { createHttpContext as a, RhythmRuntime as i, RhythmResponse as n, getRuntime as o, RhythmResponseBody as r, toResponse as s, RhythmHttpContext as t };

package/dist/context.d.ts

@@ -1,20 +1,2 @@
-//#region src/context.d.ts
-export type RhythmResponseBody = string | ArrayBuffer | Uint8Array | Blob | FormData | URLSearchParams | ReadableStream<Uint8Array> | null;
-export declare class RhythmResponse {
-  status: number;
-  statusText: string | undefined;
-  headers: Headers;
-  body: RhythmResponseBody;
-}
-export interface RhythmHttpContext {
-  readonly request: Request;
-  readonly response: RhythmResponse;
-  json(data: unknown, status?: number): void;
-  text(body: string, status?: number): void;
-  html(body: string, status?: number): void;
-  error(status: number, message?: string): void;
-  redirect(url: string, status?: number): void;
-}
-export declare function createHttpContext(request: Request): RhythmHttpContext;
-export declare function toResponse(response: RhythmResponse): Response;
-//#endregion
+import { a as createHttpContext, i as RhythmRuntime, n as RhythmResponse, o as getRuntime, r as RhythmResponseBody, s as toResponse, t as RhythmHttpContext } from "./context-ChHlG-q0.js";
+export { RhythmHttpContext, RhythmResponse, RhythmResponseBody, RhythmRuntime, createHttpContext, getRuntime, toResponse };

package/dist/context.js

@@ -1,4 +1,7 @@
 //#region src/context.ts
+function getRuntime(request) {
+	return request.runtime;
+}
 var RhythmResponse = class {
 	status = 200;
 	statusText = void 0;
@@ -63,4 +66,4 @@ function toResponse(response) {
 	});
 }
 //#endregion
-export { RhythmResponse, createHttpContext, toResponse };
+export { RhythmResponse, createHttpContext, getRuntime, toResponse };

package/dist/fetch.d.ts

@@ -1,4 +1,4 @@
-import { RhythmHttpContext } from "./context.js";
+import { t as RhythmHttpContext } from "./context-ChHlG-q0.js";
 import { Rhythm } from "@rhythmjs/rhythm";
 //#region src/fetch.d.ts
 export declare function toFetchHandler<TContext extends RhythmHttpContext, TProviders extends object = {}>(app: Rhythm<RhythmHttpContext, TContext, TProviders>): (request: Request) => Promise<Response>;

package/dist/rhythm-router.d.ts

@@ -1,4 +1,4 @@
-import { RhythmHttpContext } from "./context.js";
+import { t as RhythmHttpContext } from "./context-ChHlG-q0.js";
 import { DeriveMiddleware, Middleware } from "@rhythmjs/rhythm/types";
 //#region src/rhythm-router.d.ts
 export interface RhythmRouterContext {

package/dist/serve.d.ts

@@ -1,4 +1,4 @@
-import { RhythmHttpContext } from "./context.js";
+import { t as RhythmHttpContext } from "./context-ChHlG-q0.js";
 import { ErrorHandler, Server, ServerMiddleware, ServerOptions, ServerPlugin } from "srvx";
 import { Rhythm } from "@rhythmjs/rhythm";
 //#region src/serve.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhythmjs/router",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Radix-tree HTTP router for the Rhythm middleware kernel, with Bun, Node, and Deno adapters.",
   "homepage": "https://rhythm.js.org/router",
   "license": "ISC",
@@ -78,7 +78,7 @@
   },
   "dependencies": {
     "srvx": "^1.0.5",
-    "@rhythmjs/rhythm": "0.0.8"
+    "@rhythmjs/rhythm": "0.0.9"
   },
   "devDependencies": {
     "@types/node": "^26.6.3",