srvx 0.11.7 → 0.11.9

package/dist/_chunks/_plugins.mjs

@@ -1,4 +1,5 @@
 import { a as green, i as gray, n as bold, s as red } from "./_utils.mjs";
+//#region src/_middleware.ts
 function wrapFetch(server) {
 	const fetchHandler = server.options.fetch;
 	const middleware = server.options.middleware || [];
@@ -8,6 +9,8 @@ function callMiddleware(request, fetchHandler, middleware, index) {
 	if (index === middleware.length) return fetchHandler(request);
 	return middleware[index](request, () => callMiddleware(request, fetchHandler, middleware, index + 1));
 }
+//#endregion
+//#region src/_plugins.ts
 const errorPlugin = (server) => {
 	const errorHandler = server.options.error;
 	if (!errorHandler) return;
@@ -53,4 +56,5 @@ const gracefulShutdownPlugin = (server) => {
 	};
 	for (const sig of ["SIGINT", "SIGTERM"]) globalThis.process.on(sig, shutdown);
 };
+//#endregion
 export { gracefulShutdownPlugin as n, wrapFetch as r, errorPlugin as t };

package/dist/_chunks/_url.mjs

@@ -1,3 +1,4 @@
+//#region src/_inherit.ts
 function lazyInherit(target, source, sourceKey) {
 	for (const key of [...Object.getOwnPropertyNames(source), ...Object.getOwnPropertySymbols(source)]) {
 		if (key === "constructor") continue;
@@ -25,6 +26,23 @@ function lazyInherit(target, source, sourceKey) {
 		if (modified) Object.defineProperty(target, key, desc);
 	}
 }
+//#endregion
+//#region src/_url.ts
+const _needsNormRE = /(?:(?:^|\/)(?:\.|\.\.|%2e|%2e\.|\.%2e|%2e%2e)(?:\/|$))|[\\^\x80-\uffff]/i;
+/**
+* URL wrapper with fast paths to access to the following props:
+*
+*  - `url.pathname`
+*  - `url.search`
+*  - `url.searchParams`
+*  - `url.protocol`
+*
+* **NOTES:**
+*
+* - It is assumed that the input URL is **already encoded** and formatted from an HTTP request and contains no hash.
+* - Triggering the setters or getters on other props will deoptimize to full URL parsing.
+* - Changes to `searchParams` will be discarded as we don't track them.
+*/
 const FastURL = /* @__PURE__ */ (() => {
 	const NativeURL = globalThis.URL;
 	const FastURL = class URL {
@@ -38,6 +56,7 @@ const FastURL = /* @__PURE__ */ (() => {
 		#pos;
 		constructor(url) {
 			if (typeof url === "string") this.#href = url;
+			else if (_needsNormRE.test(url.pathname)) this.#url = new NativeURL(`${url.protocol || "http:"}//${url.host || "localhost"}${url.pathname}${url.search || ""}`);
 			else {
 				this.#protocol = url.protocol;
 				this.#host = url.host;
@@ -123,4 +142,5 @@ const FastURL = /* @__PURE__ */ (() => {
 	Object.setPrototypeOf(FastURL, NativeURL);
 	return FastURL;
 })();
+//#endregion
 export { lazyInherit as n, FastURL as t };

package/dist/_chunks/_utils.mjs

@@ -1,3 +1,4 @@
+//#region src/cli/_utils.ts
 const noColor = /* @__PURE__ */ (() => {
 	const env = globalThis.process?.env ?? {};
 	return env.NO_COLOR === "1" || env.TERM === "dumb";
@@ -12,4 +13,5 @@ const magenta = /* @__PURE__ */ _c(35);
 const cyan = /* @__PURE__ */ _c(36);
 const gray = /* @__PURE__ */ _c(90);
 const url = (title, url) => noColor ? `[${title}](${url})` : `\u001B]8;;${url}\u001B\\${title}\u001B]8;;\u001B\\`;
+//#endregion
 export { green as a, url as c, gray as i, yellow as l, bold as n, magenta as o, cyan as r, red as s, blue as t };

package/dist/_chunks/_utils2.mjs

@@ -1,3 +1,4 @@
+//#region src/_utils.ts
 function resolvePortAndHost(opts) {
 	const _port = opts.port ?? globalThis.process?.env.PORT ?? 3e3;
 	const port = typeof _port === "number" ? _port : Number.parseInt(_port, 10);
@@ -67,4 +68,5 @@ function createWaitUntil() {
 		}
 	};
 }
+//#endregion
 export { resolveTLSOptions as a, resolvePortAndHost as i, fmtURL as n, printListening as r, createWaitUntil as t };

package/dist/_chunks/loader.d.mts

@@ -0,0 +1,87 @@
+import { Server, ServerHandler } from "srvx";
+
+//#region src/loader.d.ts
+declare const defaultExts: string[];
+declare const defaultEntries: string[];
+/**
+* Options for loading a server entry module.
+*/
+type LoadOptions = {
+  /**
+  * Path or URL to the server entry file.
+  *
+  * If not provided, common entry points will be searched automatically.
+  */
+  entry?: string;
+  /**
+  * Base directory for resolving relative paths.
+  *
+  * @default "."
+  */
+  dir?: string;
+  /**
+  * Set to `false` to disable interception of `http.Server.listen` to detect legacy handlers.
+  *
+  * @default true
+  */
+  interceptHttpListen?: boolean;
+  /**
+  * Set to `false` to disable Node.js handler (req, res) compatibility.
+  */
+  nodeCompat?: boolean;
+  /**
+  * Node.js server instance to return when intercepting `http.Server.listen`.
+  */
+  nodeServer?: NodeServer;
+  /**
+  * srvx server instance to return when intercepting `http.Server.listen`.
+  */
+  srvxServer?: Server;
+  /**
+  * Hook called after the module is loaded to allow for custom processing.
+  *
+  * You can return a modified version of the module if needed.
+  */
+  onLoad?: (module: unknown) => any;
+};
+/**
+* Result of loading a server entry module.
+*/
+type LoadedServerEntry = {
+  /**
+  * The web fetch handler extracted from the loaded module.
+  *
+  * This is resolved from `module.fetch`, `module.default.fetch`,
+  * or upgraded from a legacy Node.js handler.
+  */
+  fetch?: ServerHandler;
+  /**
+  * The raw loaded module.
+  */
+  module?: any;
+  /**
+  * Whether the handler was upgraded from a legacy Node.js HTTP handler.
+  *
+  * When `true`, the original module exported a Node.js-style `(req, res)` handler
+  * that has been wrapped for web fetch compatibility.
+  */
+  nodeCompat?: boolean;
+  /**
+  * The resolved `file://` URL of the loaded entry module.
+  */
+  url?: string;
+  /**
+  * Whether the specified entry file was not found.
+  *
+  * When `true`, no valid entry point could be located.
+  */
+  notFound?: boolean;
+  /**
+  * The original srvx server instance if the module used the loader API to export a server directly.
+  */
+  srvxServer?: Server;
+};
+declare function loadServerEntry(opts: LoadOptions): Promise<LoadedServerEntry>;
+type NodeServer = NonNullable<Server["node"]>["server"];
+//#endregion
+export { loadServerEntry as a, defaultExts as i, LoadedServerEntry as n, defaultEntries as r, LoadOptions as t };

package/dist/adapters/aws-lambda.mjs

@@ -1,4 +1,6 @@
+import "../_chunks/_utils.mjs";
 import { r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
+//#region src/adapters/_aws/utils.ts
 function awsRequest(event, context) {
 	const req = new Request(awsEventURL(event), {
 		method: awsEventMethod(event),
@@ -249,6 +251,8 @@ function createMockContext() {
 		succeed: () => {}
 	};
 }
+//#endregion
+//#region src/adapters/aws-lambda.ts
 function toLambdaHandler(options) {
 	const server = new AWSLambdaServer(options);
 	return (event, context) => server.fetch(event, context);
@@ -289,4 +293,5 @@ var AWSLambdaServer = class {
 		return Promise.resolve();
 	}
 };
+//#endregion
 export { handleLambdaEvent, handleLambdaEventWithStream, invokeLambdaHandler, toLambdaHandler };

package/dist/adapters/bun.mjs

@@ -1,6 +1,8 @@
+import "../_chunks/_utils.mjs";
 import { t as FastURL } from "../_chunks/_url.mjs";
 import { a as resolveTLSOptions, i as resolvePortAndHost, n as fmtURL, r as printListening, t as createWaitUntil } from "../_chunks/_utils2.mjs";
 import { n as gracefulShutdownPlugin, r as wrapFetch } from "../_chunks/_plugins.mjs";
+//#region src/adapters/bun.ts
 const FastResponse = Response;
 function serve(options) {
 	return new BunServer(options);
@@ -83,4 +85,5 @@ var BunServer = class {
 		await Promise.all([this.#wait?.wait(), Promise.resolve(this.bun?.server?.stop(closeAll))]);
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/adapters/bunny.mjs

@@ -1,4 +1,6 @@
+import "../_chunks/_utils.mjs";
 import { r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
+//#region src/adapters/bunny.ts
 const FastURL = URL;
 const FastResponse = Response;
 function serve(options) {
@@ -51,4 +53,5 @@ var BunnyServer = class {
 		return Promise.resolve();
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/adapters/cloudflare.mjs

@@ -1,4 +1,6 @@
+import "../_chunks/_utils.mjs";
 import { r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
+//#region src/adapters/cloudflare.ts
 const FastURL = URL;
 const FastResponse = Response;
 function serve(options) {
@@ -54,4 +56,5 @@ var CloudflareServer = class {
 		return Promise.resolve();
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/adapters/deno.mjs

@@ -1,6 +1,8 @@
+import "../_chunks/_utils.mjs";
 import { t as FastURL } from "../_chunks/_url.mjs";
 import { a as resolveTLSOptions, i as resolvePortAndHost, n as fmtURL, r as printListening, t as createWaitUntil } from "../_chunks/_utils2.mjs";
 import { n as gracefulShutdownPlugin, r as wrapFetch } from "../_chunks/_plugins.mjs";
+//#region src/adapters/deno.ts
 const FastResponse = Response;
 function serve(options) {
 	return new DenoServer(options);
@@ -92,4 +94,5 @@ var DenoServer = class {
 		await Promise.all([this.#wait?.wait(), Promise.resolve(this.deno?.server?.shutdown())]);
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/adapters/generic.mjs

@@ -1,5 +1,7 @@
+import "../_chunks/_utils.mjs";
 import { t as createWaitUntil } from "../_chunks/_utils2.mjs";
 import { r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
+//#region src/adapters/generic.ts
 const FastURL = URL;
 const FastResponse = Response;
 function serve(options) {
@@ -34,4 +36,5 @@ var GenericServer = class {
 		await this.#wait.wait();
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/adapters/node.mjs

@@ -1,3 +1,4 @@
+import "../_chunks/_utils.mjs";
 import { n as lazyInherit, t as FastURL } from "../_chunks/_url.mjs";
 import { a as resolveTLSOptions, i as resolvePortAndHost, n as fmtURL, r as printListening, t as createWaitUntil } from "../_chunks/_utils2.mjs";
 import { n as gracefulShutdownPlugin, r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
@@ -5,6 +6,7 @@ import nodeHTTP, { IncomingMessage, ServerResponse } from "node:http";
 import { Duplex, PassThrough, Readable } from "node:stream";
 import nodeHTTPS from "node:https";
 import nodeHTTP2 from "node:http2";
+//#region src/adapters/_node/send.ts
 async function sendNodeResponse(nodeRes, webRes) {
 	if (!webRes) {
 		nodeRes.statusCode = 500;
@@ -62,6 +64,13 @@ function streamBody(stream, nodeRes) {
 		nodeRes.off("error", streamCancel);
 	});
 }
+//#endregion
+//#region src/adapters/_node/url.ts
+/**
+* Validates an HTTP Host header value (domain, IPv4, or bracketed IPv6) with optional port.
+* Intended for preliminary filtering invalid values like "localhost:3000/foobar?"
+*/
+const HOST_RE = /^(\[(?:[A-Fa-f0-9:.]+)\]|(?:[A-Za-z0-9_-]+\.)*[A-Za-z0-9_-]+|(?:\d{1,3}\.){3}\d{1,3})(:\d{1,5})?$/;
 var NodeRequestURL = class extends FastURL {
 	#req;
 	constructor({ req }) {
@@ -70,7 +79,11 @@ var NodeRequestURL = class extends FastURL {
 			const qIndex = path.indexOf("?");
 			const pathname = qIndex === -1 ? path : path?.slice(0, qIndex) || "/";
 			const search = qIndex === -1 ? "" : path?.slice(qIndex) || "";
-			const host = req.headers.host || req.headers[":authority"] || `${req.socket.localFamily === "IPv6" ? "[" + req.socket.localAddress + "]" : req.socket.localAddress}:${req.socket?.localPort || "80"}`;
+			let host = req.headers.host || req.headers[":authority"];
+			if (host) {
+				if (!HOST_RE.test(host)) throw new TypeError(`Invalid host header: ${host}`);
+			} else if (req.socket) host = `${req.socket.localFamily === "IPv6" ? "[" + req.socket.localAddress + "]" : req.socket.localAddress}:${req.socket?.localPort || "80"}`;
+			else host = "localhost";
 			const protocol = req.socket?.encrypted || req.headers["x-forwarded-proto"] === "https" || req.headers[":scheme"] === "https" ? "https:" : "http:";
 			super({
 				protocol,
@@ -89,6 +102,8 @@ var NodeRequestURL = class extends FastURL {
 		this.#req.url = this._url.pathname + this._url.search;
 	}
 };
+//#endregion
+//#region src/adapters/_node/headers.ts
 const NodeRequestHeaders = /* @__PURE__ */ (() => {
 	const NativeHeaders = globalThis.Headers;
 	class Headers {
@@ -150,6 +165,8 @@ const NodeRequestHeaders = /* @__PURE__ */ (() => {
 	Object.setPrototypeOf(Headers.prototype, NativeHeaders.prototype);
 	return Headers;
 })();
+//#endregion
+//#region src/adapters/_node/request.ts
 const NodeRequest = /* @__PURE__ */ (() => {
 	const NativeRequest = globalThis.Request;
 	class Request {
@@ -248,6 +265,13 @@ const NodeRequest = /* @__PURE__ */ (() => {
 	Object.setPrototypeOf(Request.prototype, NativeRequest.prototype);
 	return Request;
 })();
+/**
+* Undici uses an incompatible Request constructor depending on private property accessors.
+*
+* This utility, patches global Request to support `new Request(req)` in Node.js.
+*
+* Alternatively you can use `new Request(req._request || req)` instead of patching global Request.
+*/
 function patchGlobalRequest() {
 	const NativeRequest = globalThis[Symbol.for("srvx.nativeRequest")] ??= globalThis.Request;
 	const PatchedRequest = class Request extends NativeRequest {
@@ -282,6 +306,13 @@ function readBody(req) {
 		req.on("data", onData).once("end", onEnd).once("error", onError);
 	});
 }
+//#endregion
+//#region src/adapters/_node/response.ts
+/**
+* Fast Response for Node.js runtime
+*
+* It is faster because in most cases it doesn't create a full Response instance.
+*/
 const NodeResponse = /* @__PURE__ */ (() => {
 	const NativeResponse = globalThis.Response;
 	const STATUS_CODES = globalThis.process?.getBuiltinModule?.("node:http")?.STATUS_CODES || {};
@@ -390,6 +421,13 @@ const NodeResponse = /* @__PURE__ */ (() => {
 	Object.setPrototypeOf(NodeResponse.prototype, NativeResponse.prototype);
 	return NodeResponse;
 })();
+//#endregion
+//#region src/adapters/_node/web/socket.ts
+/**
+* Events:
+* - Readable (req from client): readable => data => end (push(null)) => error => close
+* - Writable (res to client): pipe => unpipe => drain => finish (end called) => error => close
+*/
 var WebRequestSocket = class extends Duplex {
 	_httpMessage;
 	autoSelectFamilyAttemptedAddresses = [];
@@ -505,6 +543,8 @@ var WebRequestSocket = class extends Duplex {
 		cb(err ?? void 0);
 	}
 };
+//#endregion
+//#region src/adapters/_node/web/incoming.ts
 var WebIncomingMessage = class extends IncomingMessage {
 	constructor(req, socket) {
 		super(socket);
@@ -523,6 +563,8 @@ var WebIncomingMessage = class extends IncomingMessage {
 		});
 	}
 };
+//#endregion
+//#region src/adapters/_node/call.ts
 function callNodeHandler(handler, req) {
 	const isMiddleware = handler.length > 2;
 	const nodeCtx = req.runtime?.node;
@@ -566,6 +608,8 @@ function callNodeHandler(handler, req) {
 		}
 	});
 }
+//#endregion
+//#region src/adapters/_node/web/response.ts
 var WebServerResponse = class extends ServerResponse {
 	#socket;
 	constructor(req, socket) {
@@ -604,6 +648,19 @@ var WebServerResponse = class extends ServerResponse {
 		});
 	}
 };
+//#endregion
+//#region src/adapters/_node/web/fetch.ts
+/**
+* Calls a Node.js HTTP Request handler with a Fetch API Request object and returns a Response object.
+*
+* If the web Request contains an existing Node.js req/res pair (indicating it originated from a Node.js server from srvx/node), it will be called directly.
+*
+* Otherwise, new Node.js IncomingMessage and ServerResponse objects are created and linked to a custom Duplex stream that bridges the Fetch API streams with Node.js streams.
+*
+* The handler is invoked with these objects, and the response is constructed from the ServerResponse once it is finished.
+*
+* @experimental Behavior might be unstable.
+*/
 async function fetchNodeHandler(handler, req) {
 	const nodeRuntime = req.runtime?.node;
 	if (nodeRuntime && nodeRuntime.req && nodeRuntime.res) return await callNodeHandler(handler, req);
@@ -624,6 +681,11 @@ async function fetchNodeHandler(handler, req) {
 		});
 	}
 }
+//#endregion
+//#region src/adapters/_node/adapter.ts
+/**
+* Converts a Fetch API handler to a Node.js HTTP handler.
+*/
 function toNodeHandler(handler) {
 	if (handler.__nodeHandler) return handler.__nodeHandler;
 	function convertedNodeHandler(nodeReq, nodeRes) {
@@ -637,6 +699,11 @@ function toNodeHandler(handler) {
 	assignFnName(convertedNodeHandler, handler, " (converted to Node handler)");
 	return convertedNodeHandler;
 }
+/**
+* Converts a Node.js HTTP handler into a Fetch API handler.
+*
+* @experimental Behavior might be unstable and won't work in Bun and Deno currently (tracker: https://github.com/h3js/srvx/issues/132)
+*/
 function toFetchHandler(handler) {
 	if (handler.__fetchHandler) return handler.__fetchHandler;
 	function convertedNodeHandler(req) {
@@ -651,6 +718,8 @@ function assignFnName(target, source, suffix) {
 		Object.defineProperty(target, "name", { value: `${source.name}${suffix}` });
 	} catch {}
 }
+//#endregion
+//#region src/adapters/node.ts
 function serve(options) {
 	return new NodeServer(options);
 }
@@ -744,4 +813,5 @@ var NodeServer = class {
 		})]);
 	}
 };
+//#endregion
 export { NodeResponse as FastResponse, NodeResponse, FastURL, NodeRequest, fetchNodeHandler, patchGlobalRequest, sendNodeResponse, serve, toFetchHandler, toNodeHandler };

package/dist/adapters/service-worker.mjs

@@ -1,4 +1,6 @@
+import "../_chunks/_utils.mjs";
 import { r as wrapFetch, t as errorPlugin } from "../_chunks/_plugins.mjs";
+//#region src/adapters/service-worker.ts
 const FastURL = URL;
 const FastResponse = Response;
 const isBrowserWindow = typeof window !== "undefined" && typeof navigator !== "undefined";
@@ -73,4 +75,5 @@ var ServiceWorkerServer = class {
 		} else if (isServiceWorker) await self.registration.unregister();
 	}
 };
+//#endregion
 export { FastResponse, FastURL, serve };

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { LoadOptions } from "./loader.mjs";
+import { t as LoadOptions } from "./_chunks/loader.mjs";
 
 //#region src/cli/types.d.ts
 type MainOptions = CLIOptions & {

package/dist/cli.mjs

@@ -6,6 +6,7 @@ import { fork } from "node:child_process";
 import { createReadStream, existsSync, statSync } from "node:fs";
 import { dirname, relative, resolve } from "node:path";
 import { Readable } from "node:stream";
+//#region src/cli/serve.ts
 const NO_ENTRY_ERROR = "No server entry or public directory found";
 async function cliServe(cliOpts) {
 	try {
@@ -88,6 +89,8 @@ function printInfo(cliOpts, loaded) {
 	console.log(gray(`${bold(gray("◇"))} Static files:   ${staticInfo}`));
 	console.log("");
 }
+//#endregion
+//#region src/cli/fetch.ts
 async function cliFetch(cliOpts) {
 	const stdin = cliOpts.stdin || process.stdin;
 	const stdout = cliOpts.stdout || process.stdout;
@@ -177,11 +180,15 @@ function getResponseFormat(res) {
 		encoding: contentType.includes("charset=") ? contentType.split("charset=")[1].split(";")[0].trim() : "utf8"
 	};
 }
+//#endregion
+//#region src/cli/_meta.ts
 const srvxMeta = {
 	name: "srvx",
-	version: "0.11.7",
+	version: "0.11.9",
 	description: "Universal Server."
 };
+//#endregion
+//#region src/cli/usage.ts
 function usage(mainOpts) {
 	const command = mainOpts.usage?.command || "srvx";
 	const name = mainOpts.meta?.name || srvxMeta.name;
@@ -247,6 +254,8 @@ ${mainOpts.usage?.docs ? `➤ ${url("Documentation", mainOpts.usage.docs)}` : ""
 ${mainOpts.usage?.issues ? `➤ ${url("Report issues", mainOpts.usage.issues)}` : ""}
 `.trim();
 }
+//#endregion
+//#region src/cli/main.ts
 async function main(mainOpts) {
 	const args = process.argv.slice(2);
 	const cliOpts = parseArgs$1(args);
@@ -423,4 +432,5 @@ function runtime() {
 	else if (process.versions.deno) return `deno ${process.versions.deno}`;
 	else return `node ${process.versions.node}`;
 }
+//#endregion
 export { cliFetch, main };

package/dist/loader.d.mts

@@ -1,87 +1,2 @@
-import { Server, ServerHandler } from "srvx";
-
-//#region src/loader.d.ts
-declare const defaultExts: string[];
-declare const defaultEntries: string[];
-/**
-* Options for loading a server entry module.
-*/
-type LoadOptions = {
-  /**
-  * Path or URL to the server entry file.
-  *
-  * If not provided, common entry points will be searched automatically.
-  */
-  entry?: string;
-  /**
-  * Base directory for resolving relative paths.
-  *
-  * @default "."
-  */
-  dir?: string;
-  /**
-  * Set to `false` to disable interception of `http.Server.listen` to detect legacy handlers.
-  *
-  * @default true
-  */
-  interceptHttpListen?: boolean;
-  /**
-  * Set to `false` to disable Node.js handler (req, res) compatibility.
-  */
-  nodeCompat?: boolean;
-  /**
-  * Node.js server instance to return when intercepting `http.Server.listen`.
-  */
-  nodeServer?: NodeServer;
-  /**
-  * srvx server instance to return when intercepting `http.Server.listen`.
-  */
-  srvxServer?: Server;
-  /**
-  * Hook called after the module is loaded to allow for custom processing.
-  *
-  * You can return a modified version of the module if needed.
-  */
-  onLoad?: (module: unknown) => any;
-};
-/**
-* Result of loading a server entry module.
-*/
-type LoadedServerEntry = {
-  /**
-  * The web fetch handler extracted from the loaded module.
-  *
-  * This is resolved from `module.fetch`, `module.default.fetch`,
-  * or upgraded from a legacy Node.js handler.
-  */
-  fetch?: ServerHandler;
-  /**
-  * The raw loaded module.
-  */
-  module?: any;
-  /**
-  * Whether the handler was upgraded from a legacy Node.js HTTP handler.
-  *
-  * When `true`, the original module exported a Node.js-style `(req, res)` handler
-  * that has been wrapped for web fetch compatibility.
-  */
-  nodeCompat?: boolean;
-  /**
-  * The resolved `file://` URL of the loaded entry module.
-  */
-  url?: string;
-  /**
-  * Whether the specified entry file was not found.
-  *
-  * When `true`, no valid entry point could be located.
-  */
-  notFound?: boolean;
-  /**
-  * The original srvx server instance if the module used the loader API to export a server directly.
-  */
-  srvxServer?: Server;
-};
-declare function loadServerEntry(opts: LoadOptions): Promise<LoadedServerEntry>;
-type NodeServer = NonNullable<Server["node"]>["server"];
-//#endregion
+import { a as loadServerEntry, i as defaultExts, n as LoadedServerEntry, r as defaultEntries, t as LoadOptions } from "./_chunks/loader.mjs";
 export { LoadOptions, LoadedServerEntry, defaultEntries, defaultExts, loadServerEntry };

package/dist/loader.mjs

@@ -3,6 +3,7 @@ import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import * as nodeHTTP$1 from "node:http";
 import { EventEmitter } from "node:events";
+//#region src/loader.ts
 const defaultExts = [
 	".mjs",
 	".js",
@@ -135,4 +136,5 @@ var StubNodeServer = class extends EventEmitter {
 		return this;
 	}
 };
+//#endregion
 export { defaultEntries, defaultExts, loadServerEntry };

package/dist/log.mjs

@@ -1,4 +1,5 @@
 import { a as green, i as gray, l as yellow, n as bold, s as red, t as blue } from "./_chunks/_utils.mjs";
+//#region src/log.ts
 const statusColors = {
 	1: blue,
 	2: green,
@@ -14,4 +15,5 @@ const log = (_options = {}) => {
 		return res;
 	};
 };
+//#endregion
 export { log };

package/dist/static.mjs

@@ -1,9 +1,10 @@
 import { t as FastURL } from "./_chunks/_url.mjs";
 import { createReadStream } from "node:fs";
-import { extname, join, resolve } from "node:path";
+import { extname, join, resolve, sep } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 import { FastResponse } from "srvx";
 import { createBrotliCompress, createGzip } from "node:zlib";
+//#region src/static.ts
 const COMMON_MIME_TYPES = {
 	".html": "text/html",
 	".htm": "text/html",
@@ -28,7 +29,7 @@ const COMMON_MIME_TYPES = {
 	".pdf": "application/pdf"
 };
 const serveStatic = (options) => {
-	const dir = resolve(options.dir) + "/";
+	const dir = resolve(options.dir) + sep;
 	const methods = new Set((options.methods || ["GET", "HEAD"]).map((m) => m.toUpperCase()));
 	return async (req, next) => {
 		if (!methods.has(req.method)) return next();
@@ -71,4 +72,5 @@ const serveStatic = (options) => {
 		return next();
 	};
 };
+//#endregion
 export { serveStatic };

package/dist/tracing.mjs

@@ -1,3 +1,25 @@
+//#region src/tracing.ts
+/**
+*
+* @experimental Channel names, event types and config options may change in future releases.
+*
+* Tracing plugin that adds diagnostics channel tracing to middleware and fetch handlers.
+*
+* This plugin wraps all middleware and the fetch handler with tracing instrumentation,
+* allowing you to subscribe to `srvx.request` and `srvx.middleware` tracing channels.
+*
+* @example
+* ```ts
+* import { serve } from "srvx";
+* import { tracingPlugin } from "srvx/tracing";
+*
+* const server = serve({
+*   fetch: (req) => new Response("OK"),
+*   middleware: [myMiddleware],
+*   plugins: [tracingPlugin()],
+* });
+* ```
+*/
 function tracingPlugin(opts = {}) {
 	return (server) => {
 		const { tracingChannel } = globalThis.process?.getBuiltinModule?.("node:diagnostics_channel") || {};
@@ -31,4 +53,5 @@ function tracingPlugin(opts = {}) {
 		}
 	};
 }
+//#endregion
 export { tracingPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "srvx",
-  "version": "0.11.7",
+  "version": "0.11.9",
   "description": "Universal Server.",
   "homepage": "https://srvx.h3.dev",
   "license": "MIT",
@@ -59,18 +59,18 @@
     "vitest": "vitest"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260217.0",
-    "@hono/node-server": "^1.19.9",
+    "@cloudflare/workers-types": "^4.20260307.1",
+    "@hono/node-server": "^1.19.11",
     "@mitata/counters": "^0.0.8",
     "@mjackson/node-fetch-server": "^0.7.0",
-    "@types/aws-lambda": "^8.10.160",
-    "@types/bun": "^1.3.9",
+    "@types/aws-lambda": "^8.10.161",
+    "@types/bun": "^1.3.10",
     "@types/deno": "^2.5.0",
     "@types/express": "^5.0.6",
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.3.5",
     "@types/node-forge": "^1.3.14",
-    "@types/serviceworker": "^0.0.191",
-    "@typescript/native-preview": "^7.0.0-dev.20260217.1",
+    "@types/serviceworker": "^0.0.193",
+    "@typescript/native-preview": "7.0.0-dev.20260309.1",
     "@vitest/coverage-v8": "^4.0.18",
     "@whatwg-node/server": "^0.10.18",
     "automd": "^0.4.3",
@@ -78,15 +78,15 @@
     "eslint-config-unjs": "^0.6.2",
     "execa": "^9.6.1",
     "express": "^5.2.1",
-    "fastify": "^5.7.4",
+    "fastify": "^5.8.2",
     "get-port-please": "^3.2.0",
     "mdbox": "^0.1.1",
     "mitata": "^1.0.34",
     "node-forge": "^1.3.3",
-    "obuild": "^0.4.27",
-    "oxfmt": "^0.33.0",
-    "oxlint": "^1.48.0",
-    "srvx-release": "npm:srvx@^0.11.4",
+    "obuild": "^0.4.32",
+    "oxfmt": "^0.36.0",
+    "oxlint": "^1.51.0",
+    "srvx-release": "npm:srvx@^0.11.8",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "undici": "^7.22.0",
@@ -98,5 +98,5 @@
   "engines": {
     "node": ">=20.16.0"
   },
-  "packageManager": "pnpm@10.29.3"
+  "packageManager": "pnpm@10.30.2"
 }