srvx 0.8.2 → 0.8.3

package/README.md

@@ -1,47 +1,74 @@
-# 💥 srvx
+# λ srvx
 
-<!-- automd:badges color=yellow -->
+<!-- automd:badges color=yellow packagephobia -->
 
 [![npm version](https://img.shields.io/npm/v/srvx?color=yellow)](https://npmjs.com/package/srvx)
 [![npm downloads](https://img.shields.io/npm/dm/srvx?color=yellow)](https://npm.chart.dev/srvx)
+[![install size](https://badgen.net/packagephobia/install/srvx?color=yellow)](https://packagephobia.com/result?p=srvx)
 
 <!-- /automd -->
 
-Universal Server API based on web platform standards. Works with [Deno](https://deno.com/), [Bun](https://bun.sh/) and [Node.js](https://nodejs.org/en).
+Universal Server based on web standards. Works with [Deno](https://deno.com/), [Bun](https://bun.sh/) and [Node.js](https://nodejs.org/en).
 
-- ✅ Seamless runtime integration with identical usage ([handler](https://srvx.h3.dev/guide/handler) and [instance](https://srvx.h3.dev/guide/server))
-- ✅ Zero overhead [Deno](https://deno.com/) and [Bun](https://bun.sh/) support
-- ✅ [Node.js compatibility](https://srvx.h3.dev/guide/node) with ~native perf and [fast response](https://srvx.h3.dev/guide/node#fast-response) support
+- ✅ Zero dependency
+- ✅ Full featured CLI with watcher, error handler, serve static and logger
+- ✅ Seamless runtime integration with same API ([handler](https://srvx.h3.dev/guide/handler) and [instance](https://srvx.h3.dev/guide/server)).
+- ✅ [Node.js compatibility](https://srvx.h3.dev/guide/node) with up to [~96.98%](https://github.com/h3js/srvx/tree/main/test/bench-node) native performance.
+- ✅ Zero overhead [Deno](https://deno.com/) and [Bun](https://bun.sh/) support.
 
 ## Quick start
 
 ```js
-import { serve } from "srvx";
-
-const server = serve({
-  port: 3000,
-  fetch(request) {
-    return new Response("👋 Hello there!");
+export default {
+  fetch(req: Request) {
+    return Response.json({ hello: "world!" });
   },
-});
+};
+```
+
+Then, run the server using your favorite runtime:
+
+```bash
+# Node.js
+$ npx srvx       # npm
+$ pnpx srvx      # pnpm
+$ yarn dlx srvx  # yarn
+
+# Deno
+$ deno -A npm:srvx
+
+# Bun
+$ bunx --bun srvx
 ```
 
 👉 **Visit the 📖 [Documentation](https://srvx.h3.dev/) to learn more.**
 
-## Development
+## Starter Examples
 
-<details>
+[➤ Online Playground](https://stackblitz.com/fork/github/h3js/srvx/tree/main/examples/stackblitz?startScript=dev&file=server.mjs)
 
-<summary>local development</summary>
+<!-- automd:examples -->
+
+| Example          | Source                                                                                     | Try                                                                  |
+| ---------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
+| `elysia`         | [examples/elysia](https://github.com/h3js/srvx/tree/main/examples/elysia/)                 | `npx giget gh:h3js/srvx/examples/elysia srvx-elysia`                 |
+| `h3`             | [examples/h3](https://github.com/h3js/srvx/tree/main/examples/h3/)                         | `npx giget gh:h3js/srvx/examples/h3 srvx-h3`                         |
+| `hello-world`    | [examples/hello-world](https://github.com/h3js/srvx/tree/main/examples/hello-world/)       | `npx giget gh:h3js/srvx/examples/hello-world srvx-hello-world`       |
+| `hono`           | [examples/hono](https://github.com/h3js/srvx/tree/main/examples/hono/)                     | `npx giget gh:h3js/srvx/examples/hono srvx-hono`                     |
+| `service-worker` | [examples/service-worker](https://github.com/h3js/srvx/tree/main/examples/service-worker/) | `npx giget gh:h3js/srvx/examples/service-worker srvx-service-worker` |
+| `websocket`      | [examples/websocket](https://github.com/h3js/srvx/tree/main/examples/websocket/)           | `npx giget gh:h3js/srvx/examples/websocket srvx-websocket`           |
+
+<!-- /automd -->
+
+## Contribution
 
 - Clone this repository
 - Install the latest LTS version of [Node.js](https://nodejs.org/en/)
 - Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable`
 - Install dependencies using `pnpm install`
+- **Prepare stub mode using `pnpm build --stub`**
 - Run interactive tests using `pnpm dev`
 
-</details>
-
 ## License
 
 <!-- automd:contributors author=pi0 license=MIT -->

package/bin/srvx.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from "../dist/cli.mjs";
+
+await main({
+  command: "srvx",
+  docs: "https://srvx.h3.dev",
+  issues: "https://github.com/h3js/srvx/issues",
+});

package/dist/_chunks/{_utils-ek-l5xdY.mjs → _utils-DRF_4b_y.mjs}

@@ -28,7 +28,7 @@ function printListening(opts, url) {
 		url = `\u001B[36m${url}\u001B[0m`;
 		additionalInfo = `\u001B[2m${additionalInfo}\u001B[0m`;
 	}
-	console.log(`  ${listeningOn} ${url}${additionalInfo}`);
+	console.log(`${listeningOn} ${url}${additionalInfo}`);
 }
 function resolveTLSOptions(opts) {
 	if (!opts.tls || opts.protocol === "http") return;

package/dist/_chunks/_utils.cli-4eOGyiAa.mjs

@@ -0,0 +1,17 @@
+//#region src/_utils.cli.ts
+const noColor = globalThis.process?.env?.NO_COLOR === "1" || globalThis.process?.env?.TERM === "dumb";
+const _c = (c) => (t) => noColor ? t : `\u001B[${c}m${t}\u001B[0m`;
+const Colors = {
+	bold: _c(1),
+	red: _c(31),
+	green: _c(32),
+	yellow: _c(33),
+	blue: _c(34),
+	magenta: _c(35),
+	cyan: _c(36),
+	gray: _c(90),
+	url: (title, url) => noColor ? `${title} (${url})` : `\u001B]8;;${url}\u001B\\${title}\u001B]8;;\u001B\\`
+};
+
+//#endregion
+export { Colors };

package/dist/_chunks/package-BxkQNJ8Z.mjs

@@ -0,0 +1,104 @@
+//#region package.json
+var name = "srvx";
+var version = "0.8.3";
+var description = "Universal Server API based on web platform standards. Works seamlessly with Deno, Bun and Node.js.";
+var homepage = "https://srvx.h3.dev";
+var repository = "h3js/srvx";
+var license = "MIT";
+var sideEffects = false;
+var type = "module";
+var exports = {
+	"./deno": "./dist/adapters/deno.mjs",
+	"./bun": "./dist/adapters/bun.mjs",
+	"./node": "./dist/adapters/node.mjs",
+	"./cloudflare": "./dist/adapters/cloudflare.mjs",
+	"./generic": "./dist/adapters/generic.mjs",
+	"./service-worker": "./dist/adapters/service-worker.mjs",
+	"./cli": "./dist/cli.mjs",
+	"./static": "./dist/static.mjs",
+	"./log": "./dist/log.mjs",
+	".": {
+		"types": "./dist/types.d.mts",
+		"deno": "./dist/adapters/deno.mjs",
+		"bun": "./dist/adapters/bun.mjs",
+		"workerd": "./dist/adapters/cloudflare.mjs",
+		"browser": "./dist/adapters/service-worker.mjs",
+		"node": "./dist/adapters/node.mjs",
+		"default": "./dist/adapters/generic.mjs"
+	}
+};
+var types = "./dist/types.d.mts";
+var bin = { "srvx": "./bin/srvx.mjs" };
+var files = ["bin", "dist"];
+var scripts = {
+	"bench:node": "node test/bench-node/_run.mjs",
+	"bench:url:bun": "bun run ./test/url.bench.ts",
+	"bench:url:deno": "deno run -A ./test/url.bench.ts",
+	"bench:url:node": "pnpm node-ts --expose-gc --allow-natives-syntax ./test/url.bench.ts",
+	"build": "obuild",
+	"dev": "vitest dev",
+	"lint": "eslint . && prettier -c .",
+	"lint:fix": "automd && eslint . --fix && prettier -w .",
+	"node-ts": "node --disable-warning=ExperimentalWarning --experimental-strip-types",
+	"prepack": "pnpm build",
+	"play:mkcert": "openssl req -x509 -newkey rsa:2048 -nodes -keyout server.key -out server.crt -days 365 -subj /CN=srvx.local",
+	"release": "pnpm test && changelogen --release && npm publish && git push --follow-tags",
+	"srvx": "./bin/srvx.mjs",
+	"test": "pnpm lint && pnpm test:types && vitest run --coverage",
+	"test:types": "tsc --noEmit --skipLibCheck"
+};
+var resolutions = { "srvx": "link:." };
+var dependencies = { "cookie-es": "^2.0.0" };
+var devDependencies = {
+	"@cloudflare/workers-types": "^4.20250627.0",
+	"@hono/node-server": "^1.14.4",
+	"@mitata/counters": "^0.0.8",
+	"@mjackson/node-fetch-server": "^0.7.0",
+	"@types/bun": "^1.2.17",
+	"@types/deno": "^2.3.0",
+	"@types/node": "^24.0.4",
+	"@types/node-forge": "^1.3.11",
+	"@types/serviceworker": "^0.0.139",
+	"@vitest/coverage-v8": "^3.2.4",
+	"@whatwg-node/server": "^0.10.10",
+	"automd": "^0.4.0",
+	"changelogen": "^0.6.1",
+	"eslint": "^9.29.0",
+	"eslint-config-unjs": "^0.5.0",
+	"execa": "^9.6.0",
+	"get-port-please": "^3.1.2",
+	"mdbox": "^0.1.1",
+	"mitata": "^1.0.34",
+	"node-forge": "^1.3.1",
+	"obuild": "^0.2.1",
+	"prettier": "^3.6.2",
+	"tslib": "^2.8.1",
+	"typescript": "^5.8.3",
+	"undici": "^7.11.0",
+	"vitest": "^3.2.4"
+};
+var packageManager = "pnpm@10.12.4";
+var engines = { "node": ">=20.16.0" };
+var package_default = {
+	name,
+	version,
+	description,
+	homepage,
+	repository,
+	license,
+	sideEffects,
+	type,
+	exports,
+	types,
+	bin,
+	files,
+	scripts,
+	resolutions,
+	dependencies,
+	devDependencies,
+	packageManager,
+	engines
+};
+
+//#endregion
+export { package_default as default };

package/dist/adapters/bun.d.mts

@@ -1,5 +1,5 @@
-import { BunFetchHandler, Server, ServerOptions } from "../_chunks/types-IGvUeyh_.mjs";
-import { FastURL$2 as FastURL } from "../_chunks/_url-CE8HuNzA.mjs";
+import { BunFetchHandler, Server, ServerOptions } from "../_chunks/types-GwbH0R0m.mjs";
+import { FastURL$2 as FastURL } from "../_chunks/_url-Bu46KnwC.mjs";
 import * as bun from "bun";
 
 //#region src/adapters/bun.d.ts

package/dist/adapters/bun.mjs

@@ -1,6 +1,6 @@
-import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-ek-l5xdY.mjs";
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { FastURL$1 as FastURL } from "../_chunks/_url-0eSmxIIk.mjs";
+import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-DRF_4b_y.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { FastURL$1 as FastURL } from "../_chunks/_url-CdE4ce6F.mjs";
 
 //#region src/adapters/bun.ts
 const FastResponse = Response;

package/dist/adapters/cloudflare.d.mts

@@ -1,4 +1,4 @@
-import { Server, ServerOptions } from "../_chunks/types-IGvUeyh_.mjs";
+import { Server, ServerOptions } from "../_chunks/types-GwbH0R0m.mjs";
 import * as CF from "@cloudflare/workers-types";
 
 //#region src/adapters/cloudflare.d.ts

package/dist/adapters/cloudflare.mjs

@@ -1,5 +1,5 @@
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { errorPlugin } from "../_chunks/_plugins-ta8pkwXd.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { errorPlugin } from "../_chunks/_plugins-CbGQstxC.mjs";
 
 //#region src/adapters/cloudflare.ts
 const FastURL = URL;

package/dist/adapters/deno.d.mts

@@ -1,5 +1,5 @@
-import { DenoFetchHandler, Server, ServerOptions } from "../_chunks/types-IGvUeyh_.mjs";
-import { FastURL$2 as FastURL } from "../_chunks/_url-CE8HuNzA.mjs";
+import { DenoFetchHandler, Server, ServerOptions } from "../_chunks/types-GwbH0R0m.mjs";
+import { FastURL$2 as FastURL } from "../_chunks/_url-Bu46KnwC.mjs";
 
 //#region src/adapters/deno.d.ts
 declare const FastResponse: typeof globalThis.Response;

package/dist/adapters/deno.mjs

@@ -1,6 +1,6 @@
-import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-ek-l5xdY.mjs";
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { FastURL$1 as FastURL } from "../_chunks/_url-0eSmxIIk.mjs";
+import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-DRF_4b_y.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { FastURL$1 as FastURL } from "../_chunks/_url-CdE4ce6F.mjs";
 
 //#region src/adapters/deno.ts
 const FastResponse = Response;

package/dist/adapters/generic.d.mts

@@ -1,4 +1,4 @@
-import { Server, ServerOptions } from "../_chunks/types-IGvUeyh_.mjs";
+import { Server, ServerOptions } from "../_chunks/types-GwbH0R0m.mjs";
 
 //#region src/adapters/generic.d.ts
 declare const FastURL: typeof globalThis.URL;

package/dist/adapters/generic.mjs

@@ -1,6 +1,6 @@
-import { createWaitUntil } from "../_chunks/_utils-ek-l5xdY.mjs";
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { errorPlugin } from "../_chunks/_plugins-ta8pkwXd.mjs";
+import { createWaitUntil } from "../_chunks/_utils-DRF_4b_y.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { errorPlugin } from "../_chunks/_plugins-CbGQstxC.mjs";
 
 //#region src/adapters/generic.ts
 const FastURL = URL;

package/dist/adapters/node.d.mts

@@ -1,5 +1,5 @@
-import { FetchHandler, NodeHttpHandler, NodeServerRequest, NodeServerResponse, Server, ServerOptions, ServerRequest } from "../_chunks/types-IGvUeyh_.mjs";
-import { FastURL$2 as FastURL } from "../_chunks/_url-CE8HuNzA.mjs";
+import { FetchHandler, NodeHttpHandler, NodeServerRequest, NodeServerResponse, Server, ServerOptions, ServerRequest } from "../_chunks/types-GwbH0R0m.mjs";
+import { FastURL$2 as FastURL } from "../_chunks/_url-Bu46KnwC.mjs";
 import NodeHttp from "node:http";
 import { Readable } from "node:stream";
 

package/dist/adapters/node.mjs

@@ -1,7 +1,7 @@
-import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-ek-l5xdY.mjs";
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { FastURL$1 as FastURL } from "../_chunks/_url-0eSmxIIk.mjs";
-import { errorPlugin } from "../_chunks/_plugins-ta8pkwXd.mjs";
+import { createWaitUntil, fmtURL, printListening, resolvePortAndHost, resolveTLSOptions } from "../_chunks/_utils-DRF_4b_y.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { FastURL$1 as FastURL } from "../_chunks/_url-CdE4ce6F.mjs";
+import { errorPlugin } from "../_chunks/_plugins-CbGQstxC.mjs";
 import { splitSetCookieString } from "cookie-es";
 
 //#region src/adapters/_node/send.ts

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

@@ -1,4 +1,4 @@
-import { Server, ServerOptions, ServerRequest } from "../_chunks/types-IGvUeyh_.mjs";
+import { Server, ServerOptions, ServerRequest } from "../_chunks/types-GwbH0R0m.mjs";
 
 //#region src/adapters/service-worker.d.ts
 declare const FastURL: typeof globalThis.URL;

package/dist/adapters/service-worker.mjs

@@ -1,5 +1,5 @@
-import { wrapFetch } from "../_chunks/_middleware-Bz7WmB2e.mjs";
-import { errorPlugin } from "../_chunks/_plugins-ta8pkwXd.mjs";
+import { wrapFetch } from "../_chunks/_middleware-BvRR7B4M.mjs";
+import { errorPlugin } from "../_chunks/_plugins-CbGQstxC.mjs";
 
 //#region src/adapters/service-worker.ts
 const FastURL = URL;

package/dist/cli.d.mts

@@ -0,0 +1,10 @@
+//#region src/cli.d.ts
+declare function main(mainOpts: MainOpts): Promise<void>;
+type MainOpts = {
+  command: string;
+  docs: string;
+  issues: string;
+};
+declare function usage(mainOpts: MainOpts): string;
+//#endregion
+export { main, usage };

package/dist/cli.mjs

@@ -0,0 +1,270 @@
+import { Colors } from "./_chunks/_utils.cli-4eOGyiAa.mjs";
+import { parseArgs } from "node:util";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, extname, relative, resolve } from "node:path";
+import { fork } from "node:child_process";
+import { existsSync } from "node:fs";
+
+//#region src/cli.ts
+const defaultEntries = [
+	"server",
+	"src/server",
+	"index",
+	"src/index"
+];
+const defaultExts = [
+	".mts",
+	".ts",
+	".cts",
+	".js",
+	".mjs",
+	".cjs"
+];
+const args = process.argv.slice(2);
+const options = parseArgs$1(args);
+if (process.send) {
+	setupProcessErrorHandlers();
+	await serve();
+}
+async function main(mainOpts) {
+	setupProcessErrorHandlers();
+	if (options._version) {
+		console.log(await version());
+		process.exit(0);
+	}
+	if (options._help) {
+		console.log(usage(mainOpts));
+		process.exit(options._help ? 0 : 1);
+	}
+	if (options._prod) await serve();
+	else {
+		const isBun = !!process.versions.bun;
+		const isDeno = !!process.versions.deno;
+		const isNode = !isBun && !isDeno;
+		const runtimeArgs = ["--watch"];
+		if (isNode || isDeno) runtimeArgs.push(...[".env", ".env.local"].filter((f) => existsSync(f)).map((f) => `--env-file=${f}`));
+		const child = fork(fileURLToPath(import.meta.url), args, { execArgv: [...process.execArgv, ...runtimeArgs].filter(Boolean) });
+		child.on("error", (error) => {
+			console.error("Error in child process:", error);
+			process.exit(1);
+		});
+		child.on("exit", (code) => {
+			if (code !== 0) {
+				console.error(`Child process exited with code ${code}`);
+				process.exit(code);
+			}
+		});
+	}
+}
+async function serve() {
+	try {
+		const { serve: srvxServe } = await import("srvx");
+		const { serveStatic } = await import("srvx/static");
+		const { log } = await import("srvx/log");
+		const entry = await loadEntry(options);
+		const staticDir = resolve(options._dir, options._static);
+		options._static = existsSync(staticDir) ? staticDir : "";
+		const server = await srvxServe({
+			error: (error) => {
+				console.error(error);
+				return renderError(error);
+			},
+			middleware: [
+				log(),
+				options._static ? serveStatic({ dir: options._static }) : void 0,
+				...entry.middleware || []
+			].filter(Boolean),
+			...entry
+		}).ready();
+		printInfo();
+		const cleanup = () => {
+			server.close(true).catch(() => {});
+			process.exit(0);
+		};
+		process.on("SIGINT", () => {
+			console.log(Colors.gray("\rStopping server..."));
+			cleanup();
+		});
+		process.on("SIGTERM", cleanup);
+	} catch (error) {
+		console.error(error);
+		process.exit(1);
+	}
+}
+async function loadEntry(opts) {
+	try {
+		if (!opts._entry) for (const entry of defaultEntries) {
+			for (const ext of defaultExts) {
+				const entryPath = resolve(opts._dir, `${entry}${ext}`);
+				if (existsSync(entryPath)) {
+					opts._entry = entryPath;
+					break;
+				}
+			}
+			if (opts._entry) break;
+		}
+		if (!opts._entry) return {
+			fetch: () => renderError(`No server entry file found.\nPlease specify an entry file or ensure one of the default entries exists (${defaultEntries.join(", ")}).`, 404, "No Server Entry"),
+			...opts
+		};
+		const entryURL = opts._entry.startsWith("file://") ? opts._entry : pathToFileURL(resolve(opts._entry)).href;
+		const entryModule = await import(entryURL);
+		return {
+			fetch: () => renderError(`The entry file "${relative(".", opts._entry)}" does not export a valid fetch handler.`, 500, "Invalid Entry"),
+			...entryModule.default,
+			...opts
+		};
+	} catch (error) {
+		console.error(Colors.red(`${Colors.bold(opts._entry)}`));
+		if (error instanceof Error) Error.captureStackTrace?.(error, serve);
+		throw error;
+	}
+}
+function renderError(error, status = 500, title = "Server Error") {
+	let html = `<!DOCTYPE html><html><head><title>${title}</title></head><body>`;
+	if (options._prod) html += `<h1>${title}</h1><p>Something went wrong while processing your request.</p>`;
+	else html += `
+    <style>
+      body { font-family: Arial, sans-serif; margin: 0; padding: 20px; background: #f8f9fa; color: #333; }
+      h1 { color: #dc3545; }
+      pre { background: #fff; padding: 10px; border-radius: 5px; overflow: auto; }
+      code { font-family: monospace; }
+      #error { display: flex; flex-direction: column; justify-content: center; align-items: center; height: 100vh; }
+    </style>
+    <div id="error"><h1>${title}</h1><pre>${error instanceof Error ? error.stack || error.message : String(error)}</pre></div>
+    `;
+	return new Response(html, {
+		status,
+		headers: { "Content-Type": "text/html; charset=utf-8" }
+	});
+}
+function printInfo() {
+	if (options._entry) console.log(Colors.gray(`${Colors.bold(Colors.gray("λ"))} Server entry: ${Colors.cyan("./" + relative(".", options._entry))} ${options._prod ? "" : Colors.gray("(watching for changes)")}`));
+	if (options._static) console.log(Colors.gray(`${Colors.bold(Colors.gray("⊟"))} Static files: ${Colors.cyan("./" + relative(".", options._static) + "/")}`));
+}
+async function version() {
+	const { default: pkg } = await import("../package.json", { with: { type: "json" } });
+	return `srvx v${pkg.version}\n${runtime()}`;
+}
+function runtime() {
+	if (process.versions.bun) return `bun v${process.versions.bun}`;
+	else if (process.versions.deno) return `deno v${process.versions.deno}`;
+	else return `node v${process.versions.node}`;
+}
+function parseArgs$1(args$1) {
+	const { values, positionals } = parseArgs({
+		args: args$1,
+		allowPositionals: true,
+		options: {
+			help: {
+				type: "boolean",
+				short: "h"
+			},
+			version: {
+				type: "boolean",
+				short: "v"
+			},
+			prod: { type: "boolean" },
+			port: {
+				type: "string",
+				short: "p"
+			},
+			host: {
+				type: "string",
+				short: "H"
+			},
+			static: {
+				type: "string",
+				short: "s"
+			},
+			tls: { type: "boolean" },
+			cert: { type: "string" },
+			key: { type: "string" }
+		}
+	});
+	const input = positionals[0] || ".";
+	let dir;
+	let entry = "";
+	if (extname(input) === "") dir = resolve(input);
+	else {
+		entry = resolve(input);
+		dir = dirname(entry);
+	}
+	return {
+		_dir: dir,
+		_entry: entry,
+		_prod: values.prod ?? process.env.NODE_ENV === "production",
+		_help: values.help,
+		_static: values.static || "public",
+		_version: values.version,
+		port: values.port ? Number.parseInt(values.port, 10) : void 0,
+		hostname: values.host,
+		tls: values.tls ? {
+			cert: values.cert,
+			key: values.key
+		} : void 0
+	};
+}
+function example() {
+	const useTs = !options._entry || options._entry.endsWith(".ts");
+	return `${Colors.bold(Colors.gray("// server.ts"))}
+${Colors.magenta("export default")} {
+  ${Colors.cyan("fetch")}(req${useTs ? ": Request" : ""}) {
+    ${Colors.magenta("return")} new Response(${Colors.green("\"Hello, World!\"")});
+  }
+}`;
+}
+function usage(mainOpts) {
+	const command = mainOpts.command;
+	return `
+${Colors.cyan(command)} - Start an HTTP server with the specified entry path.
+
+${Colors.bold("USAGE")}
+${existsSync(options._entry) ? "" : `\n${example()}\n`}
+${Colors.gray("# srvx [options] [entry]")}
+${Colors.gray("$")} ${Colors.cyan(command)} ${Colors.gray("./server.ts")}         ${Colors.gray("# Start development server")}
+${Colors.gray("$")} ${Colors.cyan(command)} --prod              ${Colors.gray("# Start production  server")}
+${Colors.gray("$")} ${Colors.cyan(command)} --port=8080         ${Colors.gray("# Listen on port 8080")}
+${Colors.gray("$")} ${Colors.cyan(command)} --host=localhost    ${Colors.gray("# Bind to localhost only")}
+${Colors.gray("$")} ${Colors.cyan(command)} --tls --cert=cert.pem --key=key.pem  ${Colors.gray("# Enable TLS (HTTPS/HTTP2)")}
+
+${Colors.bold("ARGUMENTS")}
+
+  ${Colors.yellow("<entry>")}                  Server entry path to serve.
+                           Default: ${defaultEntries.map((e) => Colors.cyan(e)).join(", ")} ${Colors.gray(`(${defaultExts.join(",")})`)}
+
+${Colors.bold("OPTIONS")}
+
+  ${Colors.green("-p, --port")} ${Colors.yellow("<port>")}        Port to listen on (default: ${Colors.yellow("3000")})
+  ${Colors.green("--host")} ${Colors.yellow("<host>")}            Host to bind to (default: all interfaces)
+  ${Colors.green("-s, --static")} ${Colors.yellow("<dir>")}       Serve static files from the specified directory (default: ${Colors.yellow("public")})
+  ${Colors.green("--prod")}                   Run in production mode (no watch, no debug)
+  ${Colors.green("--tls")}                    Enable TLS (HTTPS/HTTP2)
+  ${Colors.green("--cert")} ${Colors.yellow("<file>")}            TLS certificate file
+  ${Colors.green("--key")}  ${Colors.yellow("<file>")}            TLS private key file
+  ${Colors.green("-h, --help")}               Show this help message
+  ${Colors.green("-v, --version")}            Show server and runtime versions
+
+${Colors.bold("ENVIRONMENT")}
+
+  ${Colors.green("PORT")}                     Override port
+  ${Colors.green("HOST")}                     Override host
+  ${Colors.green("NODE_ENV")}                 Set to ${Colors.yellow("production")} for production mode.
+
+➤ ${Colors.url("Documentation", mainOpts.docs || "https://srvx.h3.dev")}
+➤ ${Colors.url("Report issues", mainOpts.issues || "https://github.com/h3js/srvx/issues")}
+`.trim();
+}
+function setupProcessErrorHandlers() {
+	process.on("uncaughtException", (error) => {
+		console.error("Uncaught exception:", error);
+		process.exit(1);
+	});
+	process.on("unhandledRejection", (reason) => {
+		console.error("Unhandled rejection:", reason);
+		process.exit(1);
+	});
+}
+
+//#endregion
+export { main, usage };

package/dist/log.d.mts

@@ -0,0 +1,8 @@
+import { ServerMiddleware } from "./_chunks/types-GwbH0R0m.mjs";
+
+//#region src/log.d.ts
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+interface LogOptions {}
+declare const log: (_options?: LogOptions) => ServerMiddleware;
+//#endregion
+export { LogOptions, log };

package/dist/log.mjs

@@ -0,0 +1,15 @@
+import { Colors } from "./_chunks/_utils.cli-4eOGyiAa.mjs";
+
+//#region src/log.ts
+const log = (_options = {}) => {
+	return async (req, next) => {
+		const start = performance.now();
+		const res = await next();
+		const duration = performance.now() - start;
+		console.log(`${Colors.gray(`[${new Date().toLocaleTimeString()}]`)} ${Colors.bold(req.method)} ${Colors.blue(req.url)} [${Colors[res.ok ? "green" : "red"](res.status + "")}] ${Colors.gray(`(${duration.toFixed(2)}ms)`)}`);
+		return res;
+	};
+};
+
+//#endregion
+export { log };

package/dist/static.d.mts

@@ -0,0 +1,9 @@
+import { ServerMiddleware } from "./_chunks/types-GwbH0R0m.mjs";
+
+//#region src/static.d.ts
+interface ServeStaticOptions {
+  dir: string;
+}
+declare const serveStatic: (options: ServeStaticOptions) => ServerMiddleware;
+//#endregion
+export { ServeStaticOptions, serveStatic };

package/dist/static.mjs

@@ -0,0 +1,70 @@
+import { extname, join, resolve } from "node:path";
+import { createReadStream } from "node:fs";
+import { 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",
+	".css": "text/css",
+	".js": "text/javascript",
+	".mjs": "text/javascript",
+	".json": "application/json",
+	".txt": "text/plain",
+	".xml": "application/xml",
+	".gif": "image/gif",
+	".ico": "image/vnd.microsoft.icon",
+	".jpeg": "image/jpeg",
+	".jpg": "image/jpeg",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".webp": "image/webp",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".mp4": "video/mp4",
+	".webm": "video/webm",
+	".zip": "application/zip",
+	".pdf": "application/pdf"
+};
+const serveStatic = (options) => {
+	const dir = resolve(options.dir) + "/";
+	return async (req, next) => {
+		if (req.method !== "GET" && req.method !== "HEAD") return next();
+		const path = new URL(req.url).pathname.slice(1).replace(/\/$/, "");
+		let paths;
+		if (path === "") paths = ["index.html"];
+		else if (extname(path) === "") paths = [`${path}.html`, `${path}/index.html`];
+		else paths = [path];
+		for (const path$1 of paths) {
+			const filePath = join(dir, path$1);
+			if (!filePath.startsWith(dir)) continue;
+			const fileStat = await stat(filePath).catch(() => null);
+			if (fileStat?.isFile()) {
+				const headers = {
+					"Content-Length": fileStat.size.toString(),
+					"Content-Type": COMMON_MIME_TYPES[extname(filePath)] || "application/octet-stream"
+				};
+				let stream = createReadStream(filePath);
+				const acceptEncoding = req.headers.get("accept-encoding") || "";
+				if (acceptEncoding.includes("br")) {
+					headers["Content-Encoding"] = "br";
+					delete headers["Content-Length"];
+					headers["Vary"] = "Accept-Encoding";
+					stream = stream.pipe(createBrotliCompress());
+				} else if (acceptEncoding.includes("gzip")) {
+					headers["Content-Encoding"] = "gzip";
+					delete headers["Content-Length"];
+					headers["Vary"] = "Accept-Encoding";
+					stream = stream.pipe(createGzip());
+				}
+				return new FastResponse(stream, { headers });
+			}
+		}
+		return next();
+	};
+};
+
+//#endregion
+export { serveStatic };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { BunFetchHandler, CloudflareFetchHandler, DenoFetchHandler, ErrorHandler, FastResponse, FastURL, FetchHandler, NodeHttpHandler, NodeServerRequest, NodeServerResponse, Server, ServerHandler, ServerMiddleware, ServerOptions, ServerPlugin, ServerRequest, ServerRuntimeContext, serve } from "./_chunks/types-IGvUeyh_.mjs";
+import { BunFetchHandler, CloudflareFetchHandler, DenoFetchHandler, ErrorHandler, FastResponse, FastURL, FetchHandler, NodeHttpHandler, NodeServerRequest, NodeServerResponse, Server, ServerHandler, ServerMiddleware, ServerOptions, ServerPlugin, ServerRequest, ServerRuntimeContext, serve } from "./_chunks/types-GwbH0R0m.mjs";
 export { BunFetchHandler, CloudflareFetchHandler, DenoFetchHandler, ErrorHandler, FastResponse, FastURL, FetchHandler, NodeHttpHandler, NodeServerRequest, NodeServerResponse, Server, ServerHandler, ServerMiddleware, ServerOptions, ServerPlugin, ServerRequest, ServerRuntimeContext, serve };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "srvx",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Universal Server API based on web platform standards. Works seamlessly with Deno, Bun and Node.js.",
   "homepage": "https://srvx.h3.dev",
   "repository": "h3js/srvx",
@@ -14,6 +14,9 @@
     "./cloudflare": "./dist/adapters/cloudflare.mjs",
     "./generic": "./dist/adapters/generic.mjs",
     "./service-worker": "./dist/adapters/service-worker.mjs",
+    "./cli": "./dist/cli.mjs",
+    "./static": "./dist/static.mjs",
+    "./log": "./dist/log.mjs",
     ".": {
       "types": "./dist/types.d.mts",
       "deno": "./dist/adapters/deno.mjs",
@@ -25,7 +28,11 @@
     }
   },
   "types": "./dist/types.d.mts",
+  "bin": {
+    "srvx": "./bin/srvx.mjs"
+  },
   "files": [
+    "bin",
     "dist"
   ],
   "scripts": {
@@ -39,13 +46,9 @@
     "lint:fix": "automd && eslint . --fix && prettier -w .",
     "node-ts": "node --disable-warning=ExperimentalWarning --experimental-strip-types",
     "prepack": "pnpm build",
-    "play:bun": "bun --watch playground/app.mjs",
-    "play:cf": "pnpx wrangler dev playground/app.mjs",
-    "play:deno": "deno run -A --watch playground/app.mjs",
     "play:mkcert": "openssl req -x509 -newkey rsa:2048 -nodes -keyout server.key -out server.crt -days 365 -subj /CN=srvx.local",
-    "play:node": "pnpm node-ts --watch playground/app.mjs",
-    "play:sw": "pnpm build && pnpx serve playground",
     "release": "pnpm test && changelogen --release && npm publish && git push --follow-tags",
+    "srvx": "./bin/srvx.mjs",
     "test": "pnpm lint && pnpm test:types && vitest run --coverage",
     "test:types": "tsc --noEmit --skipLibCheck"
   },
@@ -73,6 +76,7 @@
     "eslint-config-unjs": "^0.5.0",
     "execa": "^9.6.0",
     "get-port-please": "^3.1.2",
+    "mdbox": "^0.1.1",
     "mitata": "^1.0.34",
     "node-forge": "^1.3.1",
     "obuild": "^0.2.1",