@darthcav/ts-http-server 0.0.1

package/dist/defaults/defaultPlugins.js

@@ -0,0 +1,84 @@
+import { join } from "node:path";
+import FastifyAccepts from "@fastify/accepts";
+import FastifyCompress from "@fastify/compress";
+import FastifyCors from "@fastify/cors";
+import FastifyEtag from "@fastify/etag";
+import FastifyHelmet from "@fastify/helmet";
+import FastifyStatic from "@fastify/static";
+import FastifyView from "@fastify/view";
+import Ejs from "ejs";
+/**
+ * Builds the default plugin map for use with `launcher`.
+ *
+ * Registers: `@fastify/accepts`, `@fastify/compress`,
+ * `@fastify/cors`, `@fastify/etag`, `@fastify/helmet`,
+ * `@fastify/view` (EJS), and `@fastify/static`.
+ *
+ * @param opts.locals - Application locals; `locals.pkg` is exposed as the
+ *   default context for every EJS view.
+ * @param opts.baseDir - Optional base directory for resolving the `src/` folder; defaults to the parent of `import.meta.dirname`.
+ * @returns A `Map` of plugin names to plugin entries, suitable for passing as
+ *   the `plugins` field of `LauncherOptions`.
+ */
+export default function defaultPlugins(opts) {
+    const { locals, baseDir = null } = opts;
+    const plugins = new Map();
+    const srcDir = baseDir
+        ? join(baseDir, "src")
+        : join(import.meta.dirname, "..");
+    plugins.set("@fastify/accepts", {
+        plugin: FastifyAccepts,
+    });
+    plugins.set("@fastify/compress", {
+        plugin: FastifyCompress,
+    });
+    plugins.set("@fastify/cors", {
+        plugin: FastifyCors,
+        opts: { origin: true },
+    });
+    plugins.set("@fastify/etag", {
+        plugin: FastifyEtag,
+        opts: { algorithm: "sha1" },
+    });
+    plugins.set("@fastify/helmet", {
+        plugin: FastifyHelmet,
+        opts: {
+            global: true,
+            contentSecurityPolicy: {
+                directives: {
+                    fontSrc: [
+                        "'self'",
+                        "https://fonts.googleapis.com/",
+                        "https://fonts.gstatic.com/",
+                    ],
+                    scriptSrc: [
+                        "'self'",
+                        "'unsafe-inline'",
+                        "https://cdn.jsdelivr.net/",
+                    ],
+                },
+            },
+            hsts: {
+                maxAge: 31536000,
+                includeSubDomains: true,
+            },
+        },
+    });
+    plugins.set("@fastify/view", {
+        plugin: FastifyView,
+        opts: {
+            engine: { ejs: Ejs },
+            root: join(srcDir, "views"),
+            defaultContext: { pkg: locals.pkg },
+        },
+    });
+    plugins.set("@fastify/static", {
+        plugin: FastifyStatic,
+        opts: {
+            root: join(srcDir, "public"),
+            prefix: "/",
+        },
+    });
+    return plugins;
+}
+//# sourceMappingURL=defaultPlugins.js.map

package/dist/defaults/defaultPlugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultPlugins.js","sourceRoot":"","sources":["../../src/defaults/defaultPlugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,GAAG,MAAM,KAAK,CAAA;AAGrB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,IAGtC;IACG,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAA;IAC5C,MAAM,MAAM,GAAG,OAAO;QAClB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAErC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE;QAC5B,MAAM,EAAE,cAAc;KACzB,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE;QAC7B,MAAM,EAAE,eAAe;KAC1B,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE;QACzB,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;KACzB,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE;QACzB,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;KAC9B,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE;QAC3B,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE;YACF,MAAM,EAAE,IAAI;YACZ,qBAAqB,EAAE;gBACnB,UAAU,EAAE;oBACR,OAAO,EAAE;wBACL,QAAQ;wBACR,+BAA+B;wBAC/B,4BAA4B;qBAC/B;oBACD,SAAS,EAAE;wBACP,QAAQ;wBACR,iBAAiB;wBACjB,2BAA2B;qBAC9B;iBACJ;aACJ;YACD,IAAI,EAAE;gBACF,MAAM,EAAE,QAAQ;gBAChB,iBAAiB,EAAE,IAAI;aAC1B;SACJ;KACJ,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE;QACzB,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE;YACF,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;YACpB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;YAC3B,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;SACtC;KACJ,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE;QAC3B,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC5B,MAAM,EAAE,GAAG;SACd;KACJ,CAAC,CAAA;IAEF,OAAO,OAAO,CAAA;AAClB,CAAC"}

package/dist/defaults/defaultRoutes.d.ts

@@ -0,0 +1,10 @@
+import type { RouteOptions } from "fastify";
+/**
+ * Returns the default route map used in {@link launcher}.
+ *
+ * Registers:
+ * - `GET /` — renders `index.ejs` for `text/html`, throws 406 otherwise.
+ * - `DELETE|PATCH|POST|PUT|OPTIONS /` — responds with 405 Method Not Allowed.
+ */
+export default function defaultRoutes(): Map<string, RouteOptions>;
+//# sourceMappingURL=defaultRoutes.d.ts.map

package/dist/defaults/defaultRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRoutes.d.ts","sourceRoot":"","sources":["../../src/defaults/defaultRoutes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CA+BjE"}

package/dist/defaults/defaultRoutes.js

@@ -0,0 +1,38 @@
+import { methodNotAllowed, notAcceptable } from "@hapi/boom";
+/**
+ * Returns the default route map used in {@link launcher}.
+ *
+ * Registers:
+ * - `GET /` — renders `index.ejs` for `text/html`, throws 406 otherwise.
+ * - `DELETE|PATCH|POST|PUT|OPTIONS /` — responds with 405 Method Not Allowed.
+ */
+export default function defaultRoutes() {
+    const routes = new Map();
+    routes.set("INDEX", {
+        method: "GET",
+        url: "/",
+        exposeHeadRoute: true,
+        handler: async (request, reply) => {
+            const accept = request.accepts();
+            switch (accept.type(["html"])) {
+                case "html":
+                    return reply.type("text/html").view("index.ejs", {
+                        menu_name: "index",
+                        header: "Welcome page",
+                    });
+                default:
+                    throw notAcceptable();
+            }
+        },
+    });
+    routes.set("INDEX_405", {
+        method: ["DELETE", "PATCH", "POST", "PUT", "OPTIONS"],
+        url: "/",
+        handler: async (_request, reply) => {
+            reply.header("allow", "GET, HEAD");
+            throw methodNotAllowed();
+        },
+    });
+    return routes;
+}
+//# sourceMappingURL=defaultRoutes.js.map

package/dist/defaults/defaultRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRoutes.js","sourceRoot":"","sources":["../../src/defaults/defaultRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG5D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE9C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE;QAChB,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,GAAG;QACR,eAAe,EAAE,IAAI;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;YAChC,QAAQ,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC5B,KAAK,MAAM;oBACP,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;wBAC7C,SAAS,EAAE,OAAO;wBAClB,MAAM,EAAE,cAAc;qBACzB,CAAC,CAAA;gBACN;oBACI,MAAM,aAAa,EAAE,CAAA;YAC7B,CAAC;QACL,CAAC;KACJ,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE;QACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC;QACrD,GAAG,EAAE,GAAG;QACR,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YAC/B,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YAClC,MAAM,gBAAgB,EAAE,CAAA;QAC5B,CAAC;KACJ,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/defaults/getConsoleFastifyLogger.d.ts

@@ -0,0 +1,15 @@
+import { type PinoLevel, type PinoLikeLogger } from "@logtape/fastify";
+/**
+ * Returns a `PinoLikeLogger` for Fastify scoped to the given category.
+ *
+ * Assumes LogTape has already been configured by the caller (e.g. via
+ * `getConsoleLogger`). All records at or above `level` are forwarded
+ * by Fastify to the active LogTape sinks.
+ *
+ * @param name - Logger category array passed to `getLogTapeFastifyLogger`
+ *   (e.g. `["my-app", "fastify"]`).
+ * @param level - Minimum Pino log level to pass through. Defaults to `"info"`.
+ * @returns A Pino-compatible logger backed by LogTape.
+ */
+export default function getConsoleFastifyLogger(name: string[], level?: PinoLevel): PinoLikeLogger;
+//# sourceMappingURL=getConsoleFastifyLogger.d.ts.map

package/dist/defaults/getConsoleFastifyLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsoleFastifyLogger.d.ts","sourceRoot":"","sources":["../../src/defaults/getConsoleFastifyLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,cAAc,EACtB,MAAM,kBAAkB,CAAA;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,GAAE,SAAkB,GAC1B,cAAc,CAKhB"}

package/dist/defaults/getConsoleFastifyLogger.js

@@ -0,0 +1,20 @@
+import { getLogTapeFastifyLogger, } from "@logtape/fastify";
+/**
+ * Returns a `PinoLikeLogger` for Fastify scoped to the given category.
+ *
+ * Assumes LogTape has already been configured by the caller (e.g. via
+ * `getConsoleLogger`). All records at or above `level` are forwarded
+ * by Fastify to the active LogTape sinks.
+ *
+ * @param name - Logger category array passed to `getLogTapeFastifyLogger`
+ *   (e.g. `["my-app", "fastify"]`).
+ * @param level - Minimum Pino log level to pass through. Defaults to `"info"`.
+ * @returns A Pino-compatible logger backed by LogTape.
+ */
+export default function getConsoleFastifyLogger(name, level = "info") {
+    return getLogTapeFastifyLogger({
+        category: name,
+        level,
+    });
+}
+//# sourceMappingURL=getConsoleFastifyLogger.js.map

package/dist/defaults/getConsoleFastifyLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsoleFastifyLogger.js","sourceRoot":"","sources":["../../src/defaults/getConsoleFastifyLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,uBAAuB,GAG1B,MAAM,kBAAkB,CAAA;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC3C,IAAc,EACd,QAAmB,MAAM;IAEzB,OAAO,uBAAuB,CAAC;QAC3B,QAAQ,EAAE,IAAI;QACd,KAAK;KACR,CAAC,CAAA;AACN,CAAC"}

package/dist/hooks/onResponse.d.ts

@@ -0,0 +1,18 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+/**
+ * Fastify `onResponse` hook that logs completed request details:
+ *
+ * ```
+ * {ip} -- {method} {url} HTTP/{httpVersion} {status} {size} {elapsed}ms "{referrer}" "{userAgent}"
+ * ```
+ *
+ * Intended to be registered via:
+ * ```ts
+ * fastify.addHook("onResponse", onResponse)
+ * ```
+ *
+ * Uses `reply.log.info` 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onResponse.d.ts","sourceRoot":"","sources":["../../src/hooks/onResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;;;;;;;;;GAcG;AACH,wBAA8B,UAAU,CACpC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/hooks/onResponse.js

@@ -0,0 +1,26 @@
+/**
+ * Fastify `onResponse` hook that logs completed request details:
+ *
+ * ```
+ * {ip} -- {method} {url} HTTP/{httpVersion} {status} {size} {elapsed}ms "{referrer}" "{userAgent}"
+ * ```
+ *
+ * Intended to be registered via:
+ * ```ts
+ * fastify.addHook("onResponse", onResponse)
+ * ```
+ *
+ * Uses `reply.log.info` 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");
+    const size = contentLength != null ? Number(contentLength) : "-";
+    if (reply.statusCode < 400) {
+        reply.log.info(`${request.ip} -- ${request.method} ${request.url} HTTP/${request.raw.httpVersion} ${reply.statusCode} ${size} ${Math.round(reply.elapsedTime)}ms "${request.headers["referer"] ?? "-"}" "${request.headers["user-agent"] ?? "-"}"`);
+    }
+    else {
+        reply.log.error(`${request.ip} -- ${request.method} ${request.url} HTTP/${request.raw.httpVersion} ${reply.statusCode} ${size} ${Math.round(reply.elapsedTime)}ms "${request.headers["referer"] ?? "-"}" "${request.headers["user-agent"] ?? "-"}"`);
+    }
+}
+//# sourceMappingURL=onResponse.js.map

package/dist/hooks/onResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onResponse.js","sourceRoot":"","sources":["../../src/hooks/onResponse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU,CACpC,OAAuB,EACvB,KAAmB;IAEnB,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAEhE,IAAI,KAAK,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CACV,GAAG,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,GAAG,GAAG,CACtO,CAAA;IACL,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,GAAG,CAAC,KAAK,CACX,GAAG,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,GAAG,GAAG,CACtO,CAAA;IACL,CAAC;AACL,CAAC"}

package/dist/hooks/preHandler.d.ts

@@ -0,0 +1,18 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+/**
+ * Fastify `preHandler` hook that logs incoming request details:
+ *
+ * ```
+ * Incoming request: {method} {url} HTTP/{httpVersion} from {ip}
+ * ```
+ *
+ * Intended to be registered via:
+ * ```ts
+ * fastify.addHook("preHandler", preHandler)
+ * ```
+ *
+ * Uses `request.log.info` so each log record is automatically correlated with
+ * the request ID assigned by Fastify.
+ */
+export default function preHandler(request: FastifyRequest, _reply: FastifyReply): Promise<void>;
+//# sourceMappingURL=preHandler.d.ts.map

package/dist/hooks/preHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preHandler.d.ts","sourceRoot":"","sources":["../../src/hooks/preHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;;;;;;;;;;;GAcG;AACH,wBAA8B,UAAU,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/hooks/preHandler.js

@@ -0,0 +1,19 @@
+/**
+ * Fastify `preHandler` hook that logs incoming request details:
+ *
+ * ```
+ * Incoming request: {method} {url} HTTP/{httpVersion} from {ip}
+ * ```
+ *
+ * Intended to be registered via:
+ * ```ts
+ * fastify.addHook("preHandler", preHandler)
+ * ```
+ *
+ * Uses `request.log.info` so each log record is automatically correlated with
+ * the request ID assigned by Fastify.
+ */
+export default async function preHandler(request, _reply) {
+    request.log.debug(`Incoming request [${request.id}]: ${request.method} ${request.url} HTTP/${request.raw.httpVersion} from ${request.ip}`);
+}
+//# sourceMappingURL=preHandler.js.map

package/dist/hooks/preHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preHandler.js","sourceRoot":"","sources":["../../src/hooks/preHandler.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU,CACpC,OAAuB,EACvB,MAAoB;IAEpB,OAAO,CAAC,GAAG,CAAC,KAAK,CACb,qBAAqB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,GAAG,CAAC,WAAW,SAAS,OAAO,CAAC,EAAE,EAAE,CAC1H,CAAA;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A TypeScript HTTP server library built on Fastify for Node.js >= 25.
+ *
+ * @packageDocumentation
+ */
+import defaultErrorHandler from "./defaults/defaultErrorHandler.ts";
+import defaultFastifyOptions from "./defaults/defaultFastifyOptions.ts";
+import defaultPlugins from "./defaults/defaultPlugins.ts";
+import defaultRoutes from "./defaults/defaultRoutes.ts";
+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, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,mBAAmB,MAAM,mCAAmC,CAAA;AACnE,OAAO,qBAAqB,MAAM,qCAAqC,CAAA;AACvE,OAAO,cAAc,MAAM,8BAA8B,CAAA;AACzD,OAAO,aAAa,MAAM,6BAA6B,CAAA;AACvD,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAC9C,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAC9C,OAAO,QAAQ,MAAM,eAAe,CAAA;AAEpC,YAAY,EACR,SAAS,EACT,cAAc,EACd,eAAe,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,GACb,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * A TypeScript HTTP server library built on Fastify for Node.js >= 25.
+ *
+ * @packageDocumentation
+ */
+import defaultErrorHandler from "./defaults/defaultErrorHandler.js";
+import defaultFastifyOptions from "./defaults/defaultFastifyOptions.js";
+import defaultPlugins from "./defaults/defaultPlugins.js";
+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, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,mBAAmB,MAAM,mCAAmC,CAAA;AACnE,OAAO,qBAAqB,MAAM,qCAAqC,CAAA;AACvE,OAAO,cAAc,MAAM,8BAA8B,CAAA;AACzD,OAAO,aAAa,MAAM,6BAA6B,CAAA;AACvD,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAC9C,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAC9C,OAAO,QAAQ,MAAM,eAAe,CAAA;AAOpC,OAAO,EACH,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,GACb,CAAA"}

package/dist/launcher.d.ts

@@ -0,0 +1,17 @@
+import { type FastifyInstance } from "fastify";
+import type { LauncherOptions } from "./types.ts";
+/**
+ * Creates and starts a Fastify HTTP server with the given configuration.
+ *
+ * Steps performed:
+ * 1. Creates a `FastifyInstance` merging {@link defaultFastifyOptions} with `opts`.
+ * 2. Decorates the instance with `locals` and any extra `decorators`.
+ * 3. Registers all `plugins` and `routes`.
+ * 4. Sets a `notFound` handler (throws Boom 404) and {@link defaultErrorHandler}.
+ * 5. Registers {@link preHandler} and {@link onResponse} hooks.
+ * 6. Calls `fastify.listen()` and invokes the optional `done` callback.
+ *
+ * @returns The `FastifyInstance` (e.g. for use with `fastify.close()`).
+ */
+export default function launcher({ logger, locals, plugins, routes, decorators, opts, done, }: LauncherOptions): FastifyInstance;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAIvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,IAAI,EACJ,IAAI,GACP,EAAE,eAAe,GAAG,eAAe,CA4CnC"}

package/dist/launcher.js

@@ -0,0 +1,55 @@
+import process, { env } from "node:process";
+import { notFound } from "@hapi/boom";
+import Fastify, {} from "fastify";
+import defaultErrorHandler from "./defaults/defaultErrorHandler.js";
+import defaultFastifyOptions from "./defaults/defaultFastifyOptions.js";
+import { onResponse, preHandler } from "./index.js";
+/**
+ * Creates and starts a Fastify HTTP server with the given configuration.
+ *
+ * Steps performed:
+ * 1. Creates a `FastifyInstance` merging {@link defaultFastifyOptions} with `opts`.
+ * 2. Decorates the instance with `locals` and any extra `decorators`.
+ * 3. Registers all `plugins` and `routes`.
+ * 4. Sets a `notFound` handler (throws Boom 404) and {@link defaultErrorHandler}.
+ * 5. Registers {@link preHandler} and {@link onResponse} hooks.
+ * 6. Calls `fastify.listen()` and invokes the optional `done` callback.
+ *
+ * @returns The `FastifyInstance` (e.g. for use with `fastify.close()`).
+ */
+export default function launcher({ logger, locals, plugins, routes, decorators, opts, done, }) {
+    const host = locals?.host ?? "localhost";
+    const port = locals?.port ?? Number(env["CONTAINER_EXPOSE_PORT"] ?? 8888);
+    const fastify = Fastify({
+        ...defaultFastifyOptions(logger),
+        ...opts,
+    });
+    fastify.decorate("locals", locals);
+    if (decorators instanceof Map) {
+        for (const [key, value] of decorators) {
+            fastify.decorate(key, value);
+        }
+    }
+    for (const value of plugins.values()) {
+        void fastify.register(value.plugin, value.opts ?? {});
+    }
+    for (const value of routes.values()) {
+        fastify.route(value);
+    }
+    fastify.setNotFoundHandler(async (_request, _reply) => {
+        throw notFound();
+    });
+    fastify.setErrorHandler(defaultErrorHandler);
+    // TODO: Add hook for `onRequestAbort`
+    fastify.addHook("preHandler", preHandler);
+    fastify.addHook("onResponse", onResponse);
+    fastify.listen({ host, port }, (error) => {
+        if (error) {
+            logger.error(`${error.message}`);
+            process.exit(1);
+        }
+        done?.();
+    });
+    return fastify;
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,OAAO,EAAE,EAAwB,MAAM,SAAS,CAAA;AACvD,OAAO,mBAAmB,MAAM,mCAAmC,CAAA;AACnE,OAAO,qBAAqB,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGnD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,IAAI,EACJ,IAAI,GACU;IACd,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,WAAW,CAAA;IACxC,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,IAAI,CAAC,CAAA;IAEzE,MAAM,OAAO,GAAG,OAAO,CAAC;QACpB,GAAG,qBAAqB,CAAC,MAAM,CAAC;QAChC,GAAG,IAAI;KACV,CAAC,CAAA;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAElC,IAAI,UAAU,YAAY,GAAG,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAChC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACnC,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QAClD,MAAM,QAAQ,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAA;IAE5C,sCAAsC;IACtC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IACzC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IAEzC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;QACrC,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC;QACD,IAAI,EAAE,EAAE,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAA;AAClB,CAAC"}

package/dist/start.d.ts

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

package/dist/start.d.ts.map

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

package/dist/start.js

@@ -0,0 +1,24 @@
+import process from "node:process";
+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, () => {
+    const locals = { pkg };
+    const plugins = defaultPlugins({ locals });
+    const routes = defaultRoutes();
+    const fastify = launcher({ logger, locals, plugins, routes });
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+        process.on(signal, async (signal) => fastify
+            .close()
+            .then(() => {
+            logger.error(`Process interrupted and server closed. Received signal: ${signal}`);
+            process.exit(0);
+        })
+            .catch((error) => {
+            logger.error(`Server shutdown error: ${error}`);
+            process.exit(1);
+        }));
+    }
+});
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+import type { Logger } from "@logtape/logtape";
+import type { FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions, FastifyServerOptions, RouteOptions } from "fastify";
+/**
+ * A plugin entry combining a Fastify plugin function with its options,
+ * stored in the plugins `Map` passed to {@link launcher}.
+ */
+export type FSTPlugin = {
+    /** The Fastify plugin function to register. */
+    plugin: FastifyPluginCallback<any> | FastifyPluginAsync<any>;
+    /** Optional options forwarded to the plugin on registration. */
+    opts?: FastifyPluginOptions;
+};
+/**
+ * Application locals decorated onto the Fastify instance and available
+ * throughout the request lifecycle.
+ */
+export type LauncherLocals = {
+    /** Package metadata (e.g. contents of `package.json`). */
+    pkg?: object;
+    /** Hostname the server will bind to. */
+    host?: string;
+    /** Port the server will listen on. */
+    port?: number;
+    /** Any additional application-specific locals. */
+    [key: string]: unknown;
+};
+/**
+ * Options passed to the {@link launcher} function.
+ */
+export type LauncherOptions = {
+    /** Logger instance used for error and info output. */
+    logger: Logger;
+    /** Application locals decorated onto the Fastify instance. */
+    locals: LauncherLocals;
+    /** Map of named plugins to register. */
+    plugins: Map<string, FSTPlugin>;
+    /** Map of named routes to register. */
+    routes: Map<string, RouteOptions>;
+    /** Map of named decorators to add to the Fastify instance. */
+    decorators?: Map<string, unknown>;
+    /** Optional Fastify server options (merged over {@link defaultFastifyOptions}). */
+    opts?: FastifyServerOptions;
+    /** Optional callback invoked once the server is listening. */
+    done?: () => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACf,MAAM,SAAS,CAAA;AAEhB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,+CAA+C;IAE/C,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;IAC5D,gEAAgE;IAChE,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,MAAM,EAAE,cAAc,CAAA;IACtB,wCAAwC;IACxC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC/B,uCAAuC;IACvC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACjC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,mFAAmF;IACnF,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,78 @@
+{
+    "name": "@darthcav/ts-http-server",
+    "description": "A TypeScript HTTP server for Node.js >= 25",
+    "version": "0.0.1",
+    "author": {
+        "name": "darthcav"
+    },
+    "license": "Apache-2.0",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "package.json",
+        "README.md",
+        "LICENSE",
+        "src/**/*.ts",
+        "src/**/*.tsx",
+        "dist/**/*.js",
+        "dist/**/*.js.map",
+        "dist/**/*.d.ts",
+        "dist/**/*.d.ts.map"
+    ],
+    "dependencies": {
+        "@darthcav/ts-utils": "0.8.0",
+        "@fastify/accepts": "5.0.4",
+        "@fastify/compress": "8.3.1",
+        "@fastify/cors": "11.2.0",
+        "@fastify/etag": "6.1.0",
+        "@fastify/helmet": "13.0.2",
+        "@fastify/static": "9.0.0",
+        "@fastify/view": "11.1.1",
+        "@hapi/boom": "10.0.1",
+        "@logtape/fastify": "2.0.4",
+        "@logtape/logtape": "2.0.4",
+        "ejs": "5.0.1",
+        "fastify": "5.8.2"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.4.6",
+        "@types/ejs": "3.1.5",
+        "@types/node": "25.4.0",
+        "asserttt": "1.0.1",
+        "shx": "0.4.0",
+        "typedoc": "0.28.17"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git@github.com:darthcav/ts-http-server.git"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "scripts": {
+        "\n===== Build =====": "",
+        "clean": "shx rm -rf dist/*",
+        "build": "npm run clean && tsc",
+        "prepare": "npm run build",
+        "\n===== Typecheck =====": "",
+        "typecheck": "tsc --noEmit",
+        "\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'",
+        "\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"
+    }
+}