@darthcav/ts-http-server 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @darthcav/ts-http-server
 
-![Node][node-version] ![Version][version-image] ![CI][ci-badge] ![Coverage][coverage-badge]
+[![Node][node-version]][node-url] ![Version][version-image] ![CI][ci-badge] [![Coverage][coverage-badge]][coverage-url]
 
 A TypeScript wrapper HTTP server for Node.js >= 25 based upon [Fastify](https://fastify.dev/).
 
@@ -112,7 +112,9 @@ public/             # Documentation output (generated)
 [Apache-2.0](LICENSE)
 
 [node-version]: https://img.shields.io/badge/node-%3E%3D25-orange.svg?style=flat-square
-[version-image]: https://img.shields.io/badge/version-0.1.0-blue.svg?style=flat-square
+[node-url]: https://nodejs.org
+[version-image]: https://img.shields.io/badge/version-0.3.0-blue.svg?style=flat-square
 [ci-badge]: https://github.com/darthcav/ts-http-server/actions/workflows/tests.yml/badge.svg
-[coverage-badge]: https://img.shields.io/badge/coverage-check%20CI-yellow.svg?style=flat-square
+[coverage-badge]: https://codecov.io/github/darthcav/ts-http-server/branch/dev/graph/badge.svgK8Q4T4N9SG
+[coverage-url]: https://codecov.io/github/darthcav/ts-http-server
 [pages-url]: https://darthcav.github.io/ts-http-server/

package/dist/__tests__/defaultPlugins.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defaultPlugins.test.d.ts.map

package/dist/__tests__/defaultPlugins.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultPlugins.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/defaultPlugins.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/defaultPlugins.test.js

@@ -0,0 +1,23 @@
+import { equal, ok } from "node:assert/strict";
+import { cwd } from "node:process";
+import { suite, test } from "node:test";
+import defaultPlugins from "../defaults/defaultPlugins.js";
+suite("defaultPlugins", () => {
+    const locals = {
+        pkg: { name: "ts-http-server", version: "0.0.0", description: "Test" },
+    };
+    test("returns all plugins using default baseDir", () => {
+        const plugins = defaultPlugins({ locals });
+        equal(plugins.size, 7);
+        ok(plugins.has("@fastify/accepts"));
+        ok(plugins.has("@fastify/view"));
+        ok(plugins.has("@fastify/static"));
+    });
+    test("returns all plugins using explicit baseDir", () => {
+        const plugins = defaultPlugins({ locals, baseDir: cwd() });
+        equal(plugins.size, 7);
+        ok(plugins.has("@fastify/view"));
+        ok(plugins.has("@fastify/static"));
+    });
+});
+//# sourceMappingURL=defaultPlugins.test.js.map

package/dist/__tests__/defaultPlugins.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultPlugins.test.js","sourceRoot":"","sources":["../../src/__tests__/defaultPlugins.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,cAAc,MAAM,+BAA+B,CAAA;AAE1D,KAAK,CAAC,gBAAgB,EAAE,GAAG,EAAE;IACzB,MAAM,MAAM,GAAG;QACX,GAAG,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE;KACzE,CAAA;IAED,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1C,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACnC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAA;QAChC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;QAC1D,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACtB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAA;QAChC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/__tests__/defaultRoutes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defaultRoutes.test.d.ts.map

package/dist/__tests__/defaultRoutes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRoutes.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/defaultRoutes.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/defaultRoutes.test.js

@@ -0,0 +1,181 @@
+import { equal, match, ok } from "node:assert/strict";
+import { request as httpRequest } from "node:http";
+import { after, before, suite, test } from "node:test";
+import { setTimeout } from "node:timers/promises";
+import defaultPlugins from "../defaults/defaultPlugins.js";
+import defaultRoutes from "../defaults/defaultRoutes.js";
+import launcher from "../launcher.js";
+// ---------------------------------------------------------------------------
+// HTTP server suite
+// ---------------------------------------------------------------------------
+suite("defaultRoutes [HTTP]", () => {
+    // ---------------------------------------------------------------------------
+    // Minimal test logger (no real I/O)
+    // ---------------------------------------------------------------------------
+    const noop = () => { };
+    const testLogger = {
+        category: ["test"],
+        info: noop,
+        error: noop,
+        warn: noop,
+        debug: noop,
+        getChild: () => testLogger,
+    };
+    // ---------------------------------------------------------------------------
+    // Error route for 500 testing
+    // ---------------------------------------------------------------------------
+    function errorRoute() {
+        const routes = new Map();
+        routes.set("ERROR_ROUTE", {
+            method: "GET",
+            url: "/error",
+            handler: async () => {
+                throw new Error("test server error");
+            },
+        });
+        return routes;
+    }
+    // ---------------------------------------------------------------------------
+    // Full plugin + route setup (EJS views, static files, accepts negotiation)
+    // ---------------------------------------------------------------------------
+    const locals = {
+        pkg: { name: "ts-http-server", version: "0.0.0", description: "Test" },
+    };
+    const plugins = defaultPlugins({ locals });
+    const routes = new Map([...defaultRoutes(), ...errorRoute()]);
+    const port = 19002;
+    const base = `http://localhost:${port}`;
+    let server;
+    before(async () => {
+        server = launcher({
+            logger: testLogger,
+            locals: { ...locals, port },
+            plugins,
+            routes,
+            opts: { disableRequestLogging: true },
+        });
+        await setTimeout(1000);
+    });
+    after(async () => {
+        await setTimeout(500);
+        await server.close();
+    });
+    test("GET / → 200 text/html", async () => {
+        const res = await fetch(`${base}/`);
+        const body = await res.text();
+        equal(res.status, 200);
+        equal(res.statusText, "OK");
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+        ok(body.includes("<!doctype html>"));
+    });
+    test("HEAD / → 200 text/html", async () => {
+        const res = await fetch(`${base}/`, { method: "HEAD" });
+        equal(res.status, 200);
+        equal(res.statusText, "OK");
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+    });
+    test("GET / with application/json → 406 Not Acceptable (json)", async () => {
+        const res = await fetch(`${base}/`, {
+            headers: { accept: "application/json" },
+        });
+        const body = (await res.json());
+        equal(res.status, 406);
+        equal(res.statusText, "Not Acceptable");
+        match(res.headers.get("content-type") ?? "", /application\/json/);
+        equal(body.statusCode, 406);
+        equal(body.error, "Not Acceptable");
+    });
+    test("POST / → 405 Method Not Allowed (html)", async () => {
+        const res = await fetch(`${base}/`, { method: "POST" });
+        const body = await res.text();
+        equal(res.status, 405);
+        equal(res.statusText, "Method Not Allowed");
+        equal(res.headers.get("allow"), "GET, HEAD");
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+        ok(body.includes("405"));
+    });
+    test("POST / with application/json → 405 Method Not Allowed (json)", async () => {
+        const res = await fetch(`${base}/`, {
+            method: "POST",
+            headers: { accept: "application/json" },
+        });
+        const body = (await res.json());
+        equal(res.status, 405);
+        equal(res.statusText, "Method Not Allowed");
+        equal(res.headers.get("allow"), "GET, HEAD");
+        match(res.headers.get("content-type") ?? "", /application\/json/);
+        equal(body.statusCode, 405);
+        equal(body.error, "Method Not Allowed");
+    });
+    test("GET /missing → 404 Not Found (html)", async () => {
+        const res = await fetch(`${base}/missing`);
+        const body = await res.text();
+        equal(res.status, 404);
+        equal(res.statusText, "Not Found");
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+        ok(body.includes("404"));
+    });
+    test("GET /missing with application/json → 404 Not Found (json)", async () => {
+        const res = await fetch(`${base}/missing`, {
+            headers: { accept: "application/json" },
+        });
+        const body = (await res.json());
+        equal(res.status, 404);
+        equal(res.statusText, "Not Found");
+        match(res.headers.get("content-type") ?? "", /application\/json/);
+        equal(body.statusCode, 404);
+        equal(body.error, "Not Found");
+    });
+    test("GET /error → 500 Internal Server Error (html)", async () => {
+        const res = await fetch(`${base}/error`);
+        const body = await res.text();
+        equal(res.status, 500);
+        equal(res.statusText, "Internal Server Error");
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+        ok(body.includes("500"));
+    });
+    test("GET /error with application/json → 500 Internal Server Error (json)", async () => {
+        const res = await fetch(`${base}/error`, {
+            headers: { accept: "application/json" },
+        });
+        const body = await res.json();
+        equal(res.status, 500);
+        equal(res.statusText, "Internal Server Error");
+        match(res.headers.get("content-type") ?? "", /application\/json/);
+        ok(body);
+    });
+    test("GET / with Referer header → 200 text/html", async () => {
+        const res = await fetch(`${base}/`, {
+            headers: { accept: "text/html", referer: `${base}/` },
+        });
+        equal(res.status, 200);
+        match(res.headers.get("content-type") ?? "", /text\/html/);
+    });
+    test("GET / without User-Agent → 200 (covers onResponse user-agent fallback)", async () => {
+        const status = await new Promise((resolve, reject) => {
+            const req = httpRequest({
+                hostname: "localhost",
+                port,
+                path: "/",
+                method: "GET",
+                headers: { accept: "text/html" },
+            }, (res) => {
+                res.resume();
+                resolve(res.statusCode ?? 0);
+            });
+            req.on("error", reject);
+            req.end();
+        });
+        equal(status, 200);
+    });
+    test("GET /missing with text/plain → 404 plain text (Boom)", async () => {
+        const res = await fetch(`${base}/missing`, {
+            headers: { accept: "text/plain" },
+        });
+        const body = await res.text();
+        equal(res.status, 404);
+        match(res.headers.get("content-type") ?? "", /text\/plain/);
+        ok(body.includes("Not Found"));
+    });
+});
+//# sourceMappingURL=defaultRoutes.test.js.map

package/dist/__tests__/defaultRoutes.test.js.map

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

package/dist/__tests__/launcher.decorators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=launcher.decorators.test.d.ts.map

package/dist/__tests__/launcher.decorators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.decorators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/launcher.decorators.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/launcher.decorators.test.js

@@ -0,0 +1,70 @@
+import { equal, ok } from "node:assert/strict";
+import { after, before, suite, test } from "node:test";
+import { setTimeout } from "node:timers/promises";
+import FastifyAccepts from "@fastify/accepts";
+import launcher from "../launcher.js";
+// ---------------------------------------------------------------------------
+// Suite covering decorators map and done callback
+// ---------------------------------------------------------------------------
+suite("launcher [HTTP] with decorators and done callback", () => {
+    // ---------------------------------------------------------------------------
+    // Minimal test logger (no real I/O)
+    // ---------------------------------------------------------------------------
+    const noop = () => { };
+    const testLogger = {
+        category: ["test"],
+        info: noop,
+        error: noop,
+        warn: noop,
+        debug: noop,
+        getChild: () => testLogger,
+    };
+    // ---------------------------------------------------------------------------
+    // Minimal plugins and routes (no EJS/static required)
+    // ---------------------------------------------------------------------------
+    const plugins = new Map([
+        ["@fastify/accepts", { plugin: FastifyAccepts }],
+    ]);
+    const routes = new Map([
+        [
+            "JSON_OK",
+            {
+                method: "GET",
+                url: "/",
+                handler: async (_request, reply) => reply.send({ ok: true }),
+            },
+        ],
+    ]);
+    const port = 19003;
+    const base = `http://localhost:${port}`;
+    let server;
+    let doneWasCalled = false;
+    before(async () => {
+        server = launcher({
+            logger: testLogger,
+            locals: { port },
+            plugins,
+            routes,
+            decorators: new Map([["myDecorator", true]]),
+            opts: { disableRequestLogging: true },
+            done: () => {
+                doneWasCalled = true;
+            },
+        });
+        await setTimeout(500);
+    });
+    after(async () => {
+        await setTimeout(200);
+        await server.close();
+    });
+    test("done callback is invoked on successful listen", () => {
+        ok(doneWasCalled);
+    });
+    test("GET / → 200 JSON with decorators registered", async () => {
+        const res = await fetch(`${base}/`);
+        const body = (await res.json());
+        equal(res.status, 200);
+        equal(body.ok, true);
+    });
+});
+//# sourceMappingURL=launcher.decorators.test.js.map

package/dist/__tests__/launcher.decorators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.decorators.test.js","sourceRoot":"","sources":["../../src/__tests__/launcher.decorators.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAG7C,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAGrC,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,KAAK,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC5D,8EAA8E;IAC9E,oCAAoC;IACpC,8EAA8E;IAC9E,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAA;IAC3B,MAAM,UAAU,GAAG;QACf,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU;KACR,CAAA;IAEtB,8EAA8E;IAC9E,sDAAsD;IACtD,8EAA8E;IAC9E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAoB;QACvC,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;KACnD,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAuB;QACzC;YACI,SAAS;YACT;gBACI,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,GAAG;gBACR,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;aAC/D;SACJ;KACJ,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,KAAK,CAAA;IAClB,MAAM,IAAI,GAAG,oBAAoB,IAAI,EAAE,CAAA;IACvC,IAAI,MAAuB,CAAA;IAC3B,IAAI,aAAa,GAAG,KAAK,CAAA;IAEzB,MAAM,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,GAAG,QAAQ,CAAC;YACd,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,EAAE,IAAI,EAAE;YAChB,OAAO;YACP,MAAM;YACN,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5C,IAAI,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE;YACrC,IAAI,EAAE,GAAG,EAAE;gBACP,aAAa,GAAG,IAAI,CAAA;YACxB,CAAC;SACJ,CAAC,CAAA;QACF,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;QACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,EAAE,CAAC,aAAa,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;QACnC,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAA;QAClD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/__tests__/launcher.test.js

@@ -1,5 +1,5 @@
 import { equal, ok } from "node:assert/strict";
-import { after, before, describe, it } from "node:test";
+import { after, before, suite, test } from "node:test";
 import { setTimeout } from "node:timers/promises";
 import FastifyAccepts from "@fastify/accepts";
 import launcher from "../launcher.js";
@@ -55,7 +55,7 @@ const routes = new Map([
 // ---------------------------------------------------------------------------
 // HTTP server suite
 // ---------------------------------------------------------------------------
-describe("launcher [HTTP]", () => {
+suite("launcher [HTTP]", () => {
     const port = 19001;
     const base = `http://localhost:${port}`;
     let server;
@@ -73,18 +73,18 @@ describe("launcher [HTTP]", () => {
         await setTimeout(200);
         await server.close();
     });
-    it("GET / → 200 JSON", async () => {
+    test("GET / → 200 JSON", async () => {
         const res = await fetch(`${base}/`);
         equal(res.status, 200);
         const body = (await res.json());
         equal(body.ok, true);
     });
-    it("POST / → 405", async () => {
+    test("POST / → 405", async () => {
         const res = await fetch(`${base}/`, { method: "POST" });
         equal(res.status, 405);
         equal(res.headers.get("allow"), "GET, HEAD");
     });
-    it("GET /missing → 404 JSON", async () => {
+    test("GET /missing → 404 JSON", async () => {
         const res = await fetch(`${base}/missing`, {
             headers: { accept: "application/json" },
         });
@@ -94,19 +94,19 @@ describe("launcher [HTTP]", () => {
         ok(body.statusCode);
         equal(body.statusCode, 404);
     });
-    it("GET /missing → 404 plain text", async () => {
+    test("GET /missing → 404 plain text", async () => {
         const res = await fetch(`${base}/missing`, {
             headers: { accept: "text/plain" },
         });
         equal(res.status, 404);
     });
-    it("GET /error → 500 JSON", async () => {
+    test("GET /error → 500 JSON", async () => {
         const res = await fetch(`${base}/error`, {
             headers: { accept: "application/json" },
         });
         equal(res.status, 500);
     });
-    it("GET /error → 500 plain text", async () => {
+    test("GET /error → 500 plain text", async () => {
         const res = await fetch(`${base}/error`, {
             headers: { accept: "text/plain" },
         });

package/dist/__tests__/launcher.test.js.map

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

package/dist/hooks/onResponse.d.ts

@@ -11,8 +11,8 @@ import type { FastifyReply, FastifyRequest } from "fastify";
  * fastify.addHook("onResponse", onResponse)
  * ```
  *
- * Uses `reply.log.info` so each log record is automatically correlated with
- * the request ID assigned by Fastify.
+ * Uses `reply.log.info` for 2xx/3xx and `reply.log.error` for 4xx/5xx,
+ * so each log record is automatically correlated with the request ID assigned by Fastify.
  */
 export default function onResponse(request: FastifyRequest, reply: FastifyReply): Promise<void>;
 //# sourceMappingURL=onResponse.d.ts.map

package/dist/hooks/onResponse.js

@@ -10,8 +10,8 @@
  * fastify.addHook("onResponse", onResponse)
  * ```
  *
- * Uses `reply.log.info` so each log record is automatically correlated with
- * the request ID assigned by Fastify.
+ * Uses `reply.log.info` for 2xx/3xx and `reply.log.error` for 4xx/5xx,
+ * so each log record is automatically correlated with the request ID assigned by Fastify.
  */
 export default async function onResponse(request, reply) {
     const contentLength = reply.getHeader("content-length");

package/dist/hooks/preHandler.d.ts

@@ -3,7 +3,7 @@ import type { FastifyReply, FastifyRequest } from "fastify";
  * Fastify `preHandler` hook that logs incoming request details:
  *
  * ```
- * Incoming request: {method} {url} HTTP/{httpVersion} from {ip}
+ * Incoming request [{id}]: {method} {url} HTTP/{httpVersion} from {ip}
  * ```
  *
  * Intended to be registered via:

package/dist/hooks/preHandler.js

@@ -2,7 +2,7 @@
  * Fastify `preHandler` hook that logs incoming request details:
  *
  * ```
- * Incoming request: {method} {url} HTTP/{httpVersion} from {ip}
+ * Incoming request [{id}]: {method} {url} HTTP/{httpVersion} from {ip}
  * ```
  *
  * Intended to be registered via:

package/dist/index.d.ts

@@ -11,5 +11,5 @@ import onResponse from "./hooks/onResponse.ts";
 import preHandler from "./hooks/preHandler.ts";
 import launcher from "./launcher.ts";
 export type { FSTPlugin, LauncherLocals, LauncherOptions, } from "./types.ts";
-export { defaultErrorHandler, defaultFastifyOptions, defaultPlugins, defaultRoutes, launcher, preHandler, onResponse, };
+export { defaultErrorHandler, defaultFastifyOptions, defaultPlugins, defaultRoutes, launcher, onResponse, preHandler, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -10,5 +10,5 @@ import defaultRoutes from "./defaults/defaultRoutes.js";
 import onResponse from "./hooks/onResponse.js";
 import preHandler from "./hooks/preHandler.js";
 import launcher from "./launcher.js";
-export { defaultErrorHandler, defaultFastifyOptions, defaultPlugins, defaultRoutes, launcher, preHandler, onResponse, };
+export { defaultErrorHandler, defaultFastifyOptions, defaultPlugins, defaultRoutes, launcher, onResponse, preHandler, };
 //# sourceMappingURL=index.js.map

package/dist/start.js

@@ -3,7 +3,7 @@ import { getConsoleLogger, main } from "@darthcav/ts-utils";
 import pkg from "../package.json" with { type: "json" };
 import { defaultPlugins, defaultRoutes, launcher } from "./index.js";
 const logger = await getConsoleLogger(pkg.name, "info");
-main(pkg.name, logger, false, () => {
+main(pkg.name, logger, () => {
     const locals = { pkg };
     const plugins = defaultPlugins({ locals });
     const routes = defaultRoutes();

package/dist/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEpE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAEvD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;IAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAA;IACtB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7D,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QAClD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAChC,OAAO;aACF,KAAK,EAAE;aACP,IAAI,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,KAAK,CACR,2DAA2D,MAAM,EAAE,CACtE,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC,CAAC,CACT,CAAA;IACL,CAAC;AACL,CAAC,CAAC,CAAA"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEpE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAEvD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IACxB,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAA;IACtB,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7D,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QAClD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAChC,OAAO;aACF,KAAK,EAAE;aACP,IAAI,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,KAAK,CACR,2DAA2D,MAAM,EAAE,CACtE,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC,CAAC,CACT,CAAA;IACL,CAAC;AACL,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,9 +1,10 @@
 {
     "name": "@darthcav/ts-http-server",
     "description": "A TypeScript HTTP server for Node.js >= 25",
-    "version": "0.1.0",
+    "version": "0.3.0",
     "author": {
-        "name": "darthcav"
+        "name": "darthcav",
+        "url": "https://github.com/darthcav"
     },
     "license": "Apache-2.0",
     "type": "module",
@@ -17,18 +18,13 @@
         }
     },
     "files": [
-        "package.json",
-        "README.md",
-        "LICENSE",
-        "src/**/*.ts",
-        "src/**/*.tsx",
-        "dist/**/*.js",
-        "dist/**/*.js.map",
-        "dist/**/*.d.ts",
-        "dist/**/*.d.ts.map"
+        "src",
+        "!src/**/*.test.ts",
+        "!src/__tests__",
+        "dist"
     ],
     "dependencies": {
-        "@darthcav/ts-utils": "0.8.0",
+        "@darthcav/ts-utils": "0.8.2",
         "@fastify/accepts": "5.0.4",
         "@fastify/compress": "8.3.1",
         "@fastify/cors": "11.2.0",
@@ -43,9 +39,9 @@
         "fastify": "5.8.2"
     },
     "devDependencies": {
-        "@biomejs/biome": "2.4.6",
+        "@biomejs/biome": "2.4.8",
         "@types/ejs": "3.1.5",
-        "@types/node": "25.4.0",
+        "@types/node": "25.5.0",
         "asserttt": "1.0.1",
         "shx": "0.4.0",
         "typedoc": "0.28.17"
@@ -64,15 +60,16 @@
         "prepare": "npm run build",
         "\n===== Typecheck =====": "",
         "typecheck": "tsc --noEmit",
+        "\n===== Start =====": "",
+        "start": "node --env-file=.env.local src/start.ts",
         "\n===== Test =====": "",
         "test": "node --env-file=.env.local --test --test-reporter=spec 'src/**/*.test.ts'",
         "test:coverage": "node --env-file=.env.local --experimental-test-coverage --test 'src/**/*.test.ts'",
+        "test:coverage:lcov": "shx mkdir -p coverage && node --env-file=.env.local --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=coverage/lcov.info --test-reporter=spec --test-reporter-destination=stdout --test 'src/**/*.test.ts'",
         "\n===== Linter =====": "",
         "lint": "biome check .",
         "lint:fix": "biome check --write .",
         "\n===== TypeDoc =====": "",
-        "doc": "shx rm -rf public/* && typedoc --tsconfig tsconfig.json",
-        "\n===== Start =====": "",
-        "start": "node --env-file=.env.local src/start.ts"
+        "doc": "shx rm -rf public/* && typedoc --tsconfig tsconfig.json"
     }
 }

package/src/hooks/onResponse.ts

@@ -12,8 +12,8 @@ import type { FastifyReply, FastifyRequest } from "fastify"
  * fastify.addHook("onResponse", onResponse)
  * ```
  *
- * Uses `reply.log.info` so each log record is automatically correlated with
- * the request ID assigned by Fastify.
+ * Uses `reply.log.info` for 2xx/3xx and `reply.log.error` for 4xx/5xx,
+ * so each log record is automatically correlated with the request ID assigned by Fastify.
  */
 export default async function onResponse(
     request: FastifyRequest,

package/src/hooks/preHandler.ts

@@ -4,7 +4,7 @@ import type { FastifyReply, FastifyRequest } from "fastify"
  * Fastify `preHandler` hook that logs incoming request details:
  *
  * ```
- * Incoming request: {method} {url} HTTP/{httpVersion} from {ip}
+ * Incoming request [{id}]: {method} {url} HTTP/{httpVersion} from {ip}
  * ```
  *
  * Intended to be registered via:

package/src/index.ts

@@ -23,6 +23,6 @@ export {
     defaultPlugins,
     defaultRoutes,
     launcher,
-    preHandler,
     onResponse,
+    preHandler,
 }

package/src/public/css/main.css

@@ -0,0 +1,11 @@
+/* ===== import extra fonts ===== */
+@import url("https://fonts.googleapis.com/css?family=Roboto:100,100i,300,300i,400,400i,500,500i,700,700i,900,900i");
+
+/* ===== custom styles ===== */
+body {
+    padding-top: 6rem;
+    font-style: normal;
+    --bs-body-font-family: Roboto, sans-serif;
+    --bs-body-font-weight: 300;
+    --bs-body-font-size: 1.25rem;
+}

package/src/start.ts

@@ -5,7 +5,7 @@ import { defaultPlugins, defaultRoutes, launcher } from "./index.ts"
 
 const logger = await getConsoleLogger(pkg.name, "info")
 
-main(pkg.name, logger, false, () => {
+main(pkg.name, logger, () => {
     const locals = { pkg }
     const plugins = defaultPlugins({ locals })
     const routes = defaultRoutes()

package/src/views/_error.ejs

@@ -0,0 +1,30 @@
+<%- include ("./include/header.ejs") -%>
+
+<table class="table table-striped">
+    <tr>
+        <th>
+            HTTP status
+        </th>
+        <td>
+            <%= status %>
+        </td>
+    </tr>
+    <tr>
+        <th>
+            Request path
+        </th>
+        <td>
+            <%= uri %>
+        </td>
+    </tr>
+    <tr>
+        <th>
+            Message
+        </th>
+        <td>
+            <%= message %>
+        </td>
+    </tr>
+</table>
+
+<%- include ("./include/footer.ejs") -%>

package/src/views/include/footer.ejs

@@ -0,0 +1,12 @@
+        </main>
+        <footer class="container-fluid p-3 m-0 text-center text-light bg-secondary" role="contentinfo">
+            <address class="font-weight-bold">
+                Copyright &copy; <%= new Date().getFullYear() %> Darth CAV. All rights reserved.
+            </address>
+        </footer>
+    </div>
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.bundle.min.js"
+            integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI"
+            crossorigin="anonymous"></script>
+</body>
+</html>

package/src/views/include/header.ejs

@@ -0,0 +1,40 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title><%= pkg.name %> :: <%= header %></title>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="/images/favicon.ico" type="image/x-icon" rel="shortcut icon">
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css"
+          type="text/css" rel="stylesheet" crossorigin="anonymous"
+          integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB">
+	<link href="/css/main.css" type="text/css" rel="stylesheet">
+</head>
+<body class="d-flex h-100">
+    <% const menu = [ { name : "index", title : "Home" } ]; %>
+    <div class="container-fluid d-flex w-100 h-100 p-0 m-0 flex-column">
+        <nav class="navbar navbar-expand-lg navbar-dark bg-primary m-0 p-3 fixed-top">
+            <span class="navbar-brand px-4 d-block"><%= pkg.name %></span>
+            <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarCollapse"
+                    aria-controls="navbarCollapse" aria-expanded="false" aria-label="Toggle navigation">
+                <span class="text-primary navbar-toggler-icon"></span>
+            </button>
+            <div class="collapse navbar-collapse justify-content-end" id="navbarCollapse">
+                <ul class="navbar-nav">
+                    <% for (let i = 0; i < menu.length; i++) { %>
+                        <% if (menu[i].name === menu_name) { %>
+                        <li class="nav-item active">
+                            <a class="nav-link" href="#"><%= menu[i].title %><span class="visually-hidden-focusable">(current)</span></a>
+                        </li>
+                        <% } else { %>
+                        <li class="nav-item">
+                            <a class="nav-link" href="/<%= menu[i].name %>.html"><%= menu[i].title %></a>
+                        </li>
+                    <% } } %>
+                </ul>
+            </div>
+        </nav>
+        <main id="main" class="container mb-5" role="main">
+            <header role="banner" class="border border-info border-3 rounded p-3 mb-3">
+                <h1 class="display-3 text-info"><%= header %><br><%= pkg.name %></h1>
+            </header>

package/src/views/index.ejs

@@ -0,0 +1,30 @@
+<%- include ("./include/header.ejs") -%>
+
+<p><%= pkg.description %></p>
+
+<table class="table table-striped">
+    <tr>
+        <th>Software version</th>
+        <td><%= pkg.version %></td>
+    </tr>
+    <tr>
+        <th>Node binary</th>
+        <td><code><%= process.execPath %></code></td>
+    </tr>
+    <tr>
+        <th>Node version</th>
+        <td><code><%= process.version %></code></td>
+    </tr>
+    <tr>
+        <th>Working directory</th>
+        <td><code><%= process.cwd() %></code></td>
+    </tr>
+    <tr>
+        <th>Service process ID</th>
+        <td>
+            <code><%= process.pid %></code>
+        </td>
+    </tr>
+</table>
+
+<%- include ("./include/footer.ejs") -%>

package/src/__tests__/launcher.test.ts

@@ -1,136 +0,0 @@
-import { equal, ok } from "node:assert/strict"
-import { after, before, describe, it } from "node:test"
-import { setTimeout } from "node:timers/promises"
-import FastifyAccepts from "@fastify/accepts"
-import type { Logger } from "@logtape/logtape"
-import type { RouteOptions } from "fastify"
-import launcher from "../launcher.ts"
-import type { FSTPlugin } from "../types.ts"
-
-// ---------------------------------------------------------------------------
-// Minimal test logger (no real I/O)
-// ---------------------------------------------------------------------------
-
-const noop = (): void => {}
-const testLogger = {
-    category: ["test"],
-    info: noop,
-    error: noop,
-    warn: noop,
-    debug: noop,
-    getChild: () => testLogger,
-} as unknown as Logger
-
-// ---------------------------------------------------------------------------
-// Minimal plugins and routes (no EJS/static required)
-// ---------------------------------------------------------------------------
-
-const plugins = new Map<string, FSTPlugin>([
-    ["@fastify/accepts", { plugin: FastifyAccepts }],
-])
-
-const routes = new Map<string, RouteOptions>([
-    [
-        "JSON_OK",
-        {
-            method: "GET",
-            url: "/",
-            handler: async (_request, reply) => reply.send({ ok: true }),
-        },
-    ],
-    [
-        "JSON_405",
-        {
-            method: ["POST", "PUT", "DELETE", "PATCH"],
-            url: "/",
-            handler: async (_request, reply) => {
-                reply.header("allow", "GET, HEAD")
-                return reply.status(405).send({ statusCode: 405 })
-            },
-        },
-    ],
-    [
-        "ERROR_ROUTE",
-        {
-            method: "GET",
-            url: "/error",
-            handler: async () => {
-                throw new Error("test server error")
-            },
-        },
-    ],
-])
-
-// ---------------------------------------------------------------------------
-// HTTP server suite
-// ---------------------------------------------------------------------------
-
-describe("launcher [HTTP]", () => {
-    const port = 19001
-    const base = `http://localhost:${port}`
-    let server: import("fastify").FastifyInstance
-
-    before(async () => {
-        server = launcher({
-            logger: testLogger,
-            locals: { port },
-            plugins,
-            routes,
-            opts: { disableRequestLogging: true },
-        })
-        await setTimeout(500)
-    })
-
-    after(async () => {
-        await setTimeout(200)
-        await server.close()
-    })
-
-    it("GET / → 200 JSON", async () => {
-        const res = await fetch(`${base}/`)
-        equal(res.status, 200)
-        const body = (await res.json()) as { ok: boolean }
-        equal(body.ok, true)
-    })
-
-    it("POST / → 405", async () => {
-        const res = await fetch(`${base}/`, { method: "POST" })
-        equal(res.status, 405)
-        equal(res.headers.get("allow"), "GET, HEAD")
-    })
-
-    it("GET /missing → 404 JSON", async () => {
-        const res = await fetch(`${base}/missing`, {
-            headers: { accept: "application/json" },
-        })
-        equal(res.status, 404)
-        equal(
-            res.headers.get("content-type"),
-            "application/json; charset=utf-8",
-        )
-        const body = (await res.json()) as { statusCode: number }
-        ok(body.statusCode)
-        equal(body.statusCode, 404)
-    })
-
-    it("GET /missing → 404 plain text", async () => {
-        const res = await fetch(`${base}/missing`, {
-            headers: { accept: "text/plain" },
-        })
-        equal(res.status, 404)
-    })
-
-    it("GET /error → 500 JSON", async () => {
-        const res = await fetch(`${base}/error`, {
-            headers: { accept: "application/json" },
-        })
-        equal(res.status, 500)
-    })
-
-    it("GET /error → 500 plain text", async () => {
-        const res = await fetch(`${base}/error`, {
-            headers: { accept: "text/plain" },
-        })
-        equal(res.status, 500)
-    })
-})