@darthcav/ts-http-server 0.1.0 → 0.2.0

package/README.md

@@ -112,7 +112,7 @@ 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
+[version-image]: https://img.shields.io/badge/version-0.2.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
 [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":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGjD,OAAO,cAAc,MAAM,+BAA+B,CAAA;AAC1D,OAAO,aAAa,MAAM,8BAA8B,CAAA;AACxD,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,KAAK,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAC/B,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,8BAA8B;IAC9B,8EAA8E;IAC9E,SAAS,UAAU;QACf,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;QAC9C,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE;YACtB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,KAAK,IAAI,EAAE;gBAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;YACxC,CAAC;SACJ,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,8EAA8E;IAC9E,2EAA2E;IAC3E,8EAA8E;IAC9E,MAAM,MAAM,GAAG;QACX,GAAG,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE;KACzE,CAAA;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAA;IAE7D,MAAM,IAAI,GAAG,KAAK,CAAA;IAClB,MAAM,IAAI,GAAG,oBAAoB,IAAI,EAAE,CAAA;IACvC,IAAI,MAAuB,CAAA;IAE3B,MAAM,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,GAAG,QAAQ,CAAC;YACd,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE;YAC3B,OAAO;YACP,MAAM;YACN,IAAI,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE;SACxC,CAAC,CAAA;QACF,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;IAC1B,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,uBAAuB,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;QACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;QAC1D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACvD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE;YAChC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAA;QACxE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QACvC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAA;QACjE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAA;QAC3C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAA;QAC5C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;QAC1D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAA;QACxE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAA;QAC3C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAA;QAC5C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAA;QACjE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;QAClC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;QAC1D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAA;QACxE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;QAClC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAA;QACjE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAA;QAC9C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;QAC1D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,QAAQ,EAAE;YACrC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAA;QAC9C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAA;QACjE,EAAE,CAAC,IAAI,CAAC,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE;YAChC,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,EAAE;SACxD,CAAC,CAAA;QACF,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,GAAG,GAAG,WAAW,CACnB;gBACI,QAAQ,EAAE,WAAW;gBACrB,IAAI;gBACJ,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;aACnC,EACD,CAAC,GAAG,EAAE,EAAE;gBACJ,GAAG,CAAC,MAAM,EAAE,CAAA;gBACZ,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,CAAA;YAChC,CAAC,CACJ,CAAA;YACD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACvB,GAAG,CAAC,GAAG,EAAE,CAAA;QACb,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;SACpC,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACtB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,CAAA;QAC3D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

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/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@darthcav/ts-http-server",
     "description": "A TypeScript HTTP server for Node.js >= 25",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "author": {
         "name": "darthcav"
     },

package/src/__tests__/defaultPlugins.test.ts

@@ -0,0 +1,25 @@
+import { equal, ok } from "node:assert/strict"
+import { cwd } from "node:process"
+import { suite, test } from "node:test"
+import defaultPlugins from "../defaults/defaultPlugins.ts"
+
+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"))
+    })
+})

package/src/__tests__/defaultRoutes.test.ts

@@ -0,0 +1,204 @@
+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 type { Logger } from "@logtape/logtape"
+import type { FastifyInstance, RouteOptions } from "fastify"
+import defaultPlugins from "../defaults/defaultPlugins.ts"
+import defaultRoutes from "../defaults/defaultRoutes.ts"
+import launcher from "../launcher.ts"
+
+// ---------------------------------------------------------------------------
+// HTTP server suite
+// ---------------------------------------------------------------------------
+
+suite("defaultRoutes [HTTP]", () => {
+    // ---------------------------------------------------------------------------
+    // 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
+
+    // ---------------------------------------------------------------------------
+    // Error route for 500 testing
+    // ---------------------------------------------------------------------------
+    function errorRoute(): Map<string, RouteOptions> {
+        const routes = new Map<string, RouteOptions>()
+        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: FastifyInstance
+
+    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()) as { statusCode: number; error: string }
+        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()) as { statusCode: number; error: string }
+        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()) as { statusCode: number; error: string }
+        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<number>((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"))
+    })
+})

package/src/__tests__/launcher.decorators.test.ts

@@ -0,0 +1,80 @@
+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 type { Logger } from "@logtape/logtape"
+import type { FastifyInstance, RouteOptions } from "fastify"
+import launcher from "../launcher.ts"
+import type { FSTPlugin } from "../types.ts"
+
+// ---------------------------------------------------------------------------
+// Suite covering decorators map and done callback
+// ---------------------------------------------------------------------------
+
+suite("launcher [HTTP] with decorators and done callback", () => {
+    // ---------------------------------------------------------------------------
+    // 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 }),
+            },
+        ],
+    ])
+
+    const port = 19003
+    const base = `http://localhost:${port}`
+    let server: FastifyInstance
+    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()) as { ok: boolean }
+        equal(res.status, 200)
+        equal(body.ok, true)
+    })
+})

package/src/__tests__/launcher.test.ts

@@ -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 type { Logger } from "@logtape/logtape"
@@ -65,7 +65,7 @@ const routes = new Map<string, RouteOptions>([
 // HTTP server suite
 // ---------------------------------------------------------------------------
 
-describe("launcher [HTTP]", () => {
+suite("launcher [HTTP]", () => {
     const port = 19001
     const base = `http://localhost:${port}`
     let server: import("fastify").FastifyInstance
@@ -86,20 +86,20 @@ describe("launcher [HTTP]", () => {
         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()) as { ok: boolean }
         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" },
         })
@@ -113,21 +113,21 @@ describe("launcher [HTTP]", () => {
         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/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: