mikroserve 0.0.5 → 0.0.7

package/README.md

@@ -2,8 +2,13 @@
 
 **Minimalistic, ready-to-use API, built on Node.js primitives**.
 
+[![npm version](https://img.shields.io/npm/v/mikroserve.svg)](https://www.npmjs.com/package/mikroserve)
+
+[![bundle size](https://img.shields.io/bundlephobia/minzip/mikroserve)](https://bundlephobia.com/package/mikroserve)
+
 ![Build Status](https://github.com/mikaelvesavuori/mikroserve/workflows/main/badge.svg)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
@@ -13,7 +18,7 @@
 - Supports custom middlewares
 - Out-of-the-box CORS support
 - Built-in customizable rate limiter
-- Tiny (~4.9kb gzipped)
+- Tiny (~4.8kb gzipped)
 - Only a single dependency: [MikroConf](https://github.com/mikaelvesavuori/mikroconf)
 
 ## Installation

package/lib/MikroServe.d.mts

@@ -1,6 +1,7 @@
-import http from 'node:http';
-import https from 'node:https';
-import { MikroServeOptions, Middleware, RouteHandler } from './interfaces/index.mjs';
+import { MikroServeOptions, Middleware, RouteHandler, ServerType } from './interfaces/index.mjs';
+import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 /**
  * @description MikroServe manages HTTP server operations with routing.
@@ -44,11 +45,11 @@ declare class MikroServe {
     /**
      * @description Creates an HTTP/HTTPS server, sets up graceful shutdown, and starts listening.
      */
-    start(): http.Server | https.Server;
+    start(): ServerType;
     /**
      * @description Creates and configures a server instance without starting it.
      */
-    createServer(): http.Server | https.Server;
+    createServer(): ServerType;
     /**
      * @description Rate limiting middleware.
      */
@@ -80,7 +81,7 @@ declare class MikroServe {
     /**
      * @description Sets up graceful shutdown handlers for a server.
      */
-    setupGracefulShutdown(server: http.Server | https.Server): void;
+    setupGracefulShutdown(server: ServerType): void;
 }
 
 export { MikroServe };

package/lib/MikroServe.d.ts

@@ -1,6 +1,7 @@
-import http from 'node:http';
-import https from 'node:https';
-import { MikroServeOptions, Middleware, RouteHandler } from './interfaces/index.js';
+import { MikroServeOptions, Middleware, RouteHandler, ServerType } from './interfaces/index.js';
+import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 /**
  * @description MikroServe manages HTTP server operations with routing.
@@ -44,11 +45,11 @@ declare class MikroServe {
     /**
      * @description Creates an HTTP/HTTPS server, sets up graceful shutdown, and starts listening.
      */
-    start(): http.Server | https.Server;
+    start(): ServerType;
     /**
      * @description Creates and configures a server instance without starting it.
      */
-    createServer(): http.Server | https.Server;
+    createServer(): ServerType;
     /**
      * @description Rate limiting middleware.
      */
@@ -80,7 +81,7 @@ declare class MikroServe {
     /**
      * @description Sets up graceful shutdown handlers for a server.
      */
-    setupGracefulShutdown(server: http.Server | https.Server): void;
+    setupGracefulShutdown(server: ServerType): void;
 }
 
 export { MikroServe };

package/lib/MikroServe.js

@@ -35,6 +35,7 @@ __export(MikroServe_exports, {
 module.exports = __toCommonJS(MikroServe_exports);
 var import_node_fs = require("fs");
 var import_node_http = __toESM(require("http"));
+var import_node_http2 = __toESM(require("http2"));
 var import_node_https = __toESM(require("https"));
 var import_mikroconf = require("mikroconf");
 
@@ -281,18 +282,13 @@ var Router = class {
   }
 };
 
-// src/utils/getTruthyValue.ts
-function getTruthyValue(value) {
-  if (value === "true" || value === true) return true;
-  return false;
-}
-
 // src/utils/configDefaults.ts
 var configDefaults = () => {
   return {
     port: Number(process.env.PORT) || 3e3,
     host: process.env.HOST || "0.0.0.0",
     useHttps: false,
+    useHttp2: false,
     sslCert: "",
     sslKey: "",
     sslCa: "",
@@ -304,6 +300,10 @@ var configDefaults = () => {
     allowedDomains: ["*"]
   };
 };
+function getTruthyValue(value) {
+  if (value === "true" || value === true) return true;
+  return false;
+}
 
 // src/MikroServe.ts
 var MikroServe = class {
@@ -322,6 +322,7 @@ var MikroServe = class {
         { flag: "--port", path: "port", defaultValue: defaults.port },
         { flag: "--host", path: "host", defaultValue: defaults.host },
         { flag: "--https", path: "useHttps", defaultValue: defaults.useHttps, isFlag: true },
+        { flag: "--http2", path: "useHttp2", defaultValue: defaults.useHttp2, isFlag: true },
         { flag: "--cert", path: "sslCert", defaultValue: defaults.sslCert },
         { flag: "--key", path: "sslKey", defaultValue: defaults.sslKey },
         { flag: "--ca", path: "sslCa", defaultValue: defaults.sslCa },
@@ -423,7 +424,22 @@ var MikroServe = class {
    */
   createServer() {
     const boundRequestHandler = this.requestHandler.bind(this);
-    if (this.config.useHttps) {
+    if (this.config.useHttp2) {
+      if (!this.config.sslCert || !this.config.sslKey)
+        throw new Error("SSL certificate and key paths are required when useHttp2 is true");
+      try {
+        const httpsOptions = {
+          key: (0, import_node_fs.readFileSync)(this.config.sslKey),
+          cert: (0, import_node_fs.readFileSync)(this.config.sslCert),
+          ...this.config.sslCa ? { ca: (0, import_node_fs.readFileSync)(this.config.sslCa) } : {}
+        };
+        return import_node_http2.default.createSecureServer(httpsOptions, boundRequestHandler);
+      } catch (error) {
+        if (error.message.includes("key values mismatch"))
+          throw new Error(`SSL certificate and key do not match: ${error.message}`);
+        throw error;
+      }
+    } else if (this.config.useHttps) {
       if (!this.config.sslCert || !this.config.sslKey)
         throw new Error("SSL certificate and key paths are required when useHttps is true");
       try {
@@ -477,8 +493,14 @@ var MikroServe = class {
       this.setSecurityHeaders(res, this.config.useHttps);
       if (isDebug) console.log(`${method} ${url}`);
       if (req.method === "OPTIONS") {
-        res.statusCode = 204;
-        res.end();
+        if (res instanceof import_node_http.default.ServerResponse) {
+          res.statusCode = 204;
+          res.end();
+        } else {
+          const h2Res = res;
+          h2Res.writeHead(204);
+          h2Res.end();
+        }
         return;
       }
       try {
@@ -494,7 +516,10 @@ var MikroServe = class {
         });
       }
       const result = await this.router.handle(req, res);
-      if (result) return this.respond(res, result);
+      if (result) {
+        if (result._handled) return;
+        return this.respond(res, result);
+      }
       return this.respond(res, {
         statusCode: 404,
         body: {
@@ -600,14 +625,25 @@ var MikroServe = class {
    * @description Set security headers.
    */
   setSecurityHeaders(res, isHttps = false) {
-    res.setHeader("X-Content-Type-Options", "nosniff");
-    res.setHeader("X-Frame-Options", "DENY");
-    res.setHeader(
-      "Content-Security-Policy",
-      "default-src 'self'; script-src 'self'; object-src 'none'"
-    );
-    if (isHttps) res.setHeader("Strict-Transport-Security", "max-age=31536000; includeSubDomains");
-    res.setHeader("X-XSS-Protection", "1; mode=block");
+    const securityHeaders = {
+      "X-Content-Type-Options": "nosniff",
+      "X-Frame-Options": "DENY",
+      "Content-Security-Policy": "default-src 'self'; script-src 'self'; object-src 'none'",
+      "X-XSS-Protection": "1; mode=block"
+    };
+    if (isHttps || this.config.useHttp2) {
+      securityHeaders["Strict-Transport-Security"] = "max-age=31536000; includeSubDomains";
+    }
+    if (res instanceof import_node_http.default.ServerResponse) {
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        res.setHeader(name, value);
+      });
+    } else {
+      const h2Res = res;
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        h2Res.setHeader(name, value);
+      });
+    }
   }
   /**
    * @description Sends a response with appropriate headers.
@@ -616,10 +652,21 @@ var MikroServe = class {
     const headers = {
       ...response.headers || {}
     };
-    res.writeHead(response.statusCode, headers);
-    if (response.body === null || response.body === void 0) res.end();
-    else if (typeof response.body === "string") res.end(response.body);
-    else res.end(JSON.stringify(response.body));
+    const hasWriteHead = (res2) => {
+      return typeof res2.writeHead === "function" && typeof res2.end === "function";
+    };
+    if (hasWriteHead(res)) {
+      res.writeHead(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end();
+      else if (typeof response.body === "string") res.end(response.body);
+      else res.end(JSON.stringify(response.body));
+    } else {
+      console.warn("Unexpected response object type without writeHead/end methods");
+      res.writeHead?.(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end?.();
+      else if (typeof response.body === "string") res.end?.(response.body);
+      else res.end?.(JSON.stringify(response.body));
+    }
   }
   /**
    * @description Sets up graceful shutdown handlers for a server.

package/lib/MikroServe.mjs

@@ -1,10 +1,9 @@
 import {
   MikroServe
-} from "./chunk-BUKLE4JV.mjs";
+} from "./chunk-J2WPHNMW.mjs";
 import "./chunk-ZFBBESGU.mjs";
 import "./chunk-KJT4SET2.mjs";
-import "./chunk-NSHBEU32.mjs";
-import "./chunk-6HESV5Q6.mjs";
+import "./chunk-JJX5XRNB.mjs";
 export {
   MikroServe
 };

package/lib/Router.d.mts

@@ -1,5 +1,7 @@
-import http from 'node:http';
-import { Middleware, RouteHandler, Route, HandlerResponse } from './interfaces/index.mjs';
+import { Middleware, RouteHandler, Route, RequestType, ResponseType, HandlerResponse } from './interfaces/index.mjs';
+import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 /**
  * Router class to manage routes and middleware
@@ -54,7 +56,7 @@ declare class Router {
     /**
      * Handle a request and find the matching route
      */
-    handle(req: http.IncomingMessage, res: http.ServerResponse): Promise<HandlerResponse | null>;
+    handle(req: RequestType, res: ResponseType): Promise<HandlerResponse | null>;
     /**
      * Execute middleware chain and final handler
      */

package/lib/Router.d.ts

@@ -1,5 +1,7 @@
-import http from 'node:http';
-import { Middleware, RouteHandler, Route, HandlerResponse } from './interfaces/index.js';
+import { Middleware, RouteHandler, Route, RequestType, ResponseType, HandlerResponse } from './interfaces/index.js';
+import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 /**
  * Router class to manage routes and middleware
@@ -54,7 +56,7 @@ declare class Router {
     /**
      * Handle a request and find the matching route
      */
-    handle(req: http.IncomingMessage, res: http.ServerResponse): Promise<HandlerResponse | null>;
+    handle(req: RequestType, res: ResponseType): Promise<HandlerResponse | null>;
     /**
      * Execute middleware chain and final handler
      */

package/lib/{chunk-BUKLE4JV.mjs → chunk-J2WPHNMW.mjs}

@@ -6,11 +6,12 @@ import {
 } from "./chunk-KJT4SET2.mjs";
 import {
   configDefaults
-} from "./chunk-NSHBEU32.mjs";
+} from "./chunk-JJX5XRNB.mjs";
 
 // src/MikroServe.ts
 import { readFileSync } from "node:fs";
 import http from "node:http";
+import http2 from "node:http2";
 import https from "node:https";
 import { MikroConf, parsers } from "mikroconf";
 var MikroServe = class {
@@ -29,6 +30,7 @@ var MikroServe = class {
         { flag: "--port", path: "port", defaultValue: defaults.port },
         { flag: "--host", path: "host", defaultValue: defaults.host },
         { flag: "--https", path: "useHttps", defaultValue: defaults.useHttps, isFlag: true },
+        { flag: "--http2", path: "useHttp2", defaultValue: defaults.useHttp2, isFlag: true },
         { flag: "--cert", path: "sslCert", defaultValue: defaults.sslCert },
         { flag: "--key", path: "sslKey", defaultValue: defaults.sslKey },
         { flag: "--ca", path: "sslCa", defaultValue: defaults.sslCa },
@@ -130,7 +132,22 @@ var MikroServe = class {
    */
   createServer() {
     const boundRequestHandler = this.requestHandler.bind(this);
-    if (this.config.useHttps) {
+    if (this.config.useHttp2) {
+      if (!this.config.sslCert || !this.config.sslKey)
+        throw new Error("SSL certificate and key paths are required when useHttp2 is true");
+      try {
+        const httpsOptions = {
+          key: readFileSync(this.config.sslKey),
+          cert: readFileSync(this.config.sslCert),
+          ...this.config.sslCa ? { ca: readFileSync(this.config.sslCa) } : {}
+        };
+        return http2.createSecureServer(httpsOptions, boundRequestHandler);
+      } catch (error) {
+        if (error.message.includes("key values mismatch"))
+          throw new Error(`SSL certificate and key do not match: ${error.message}`);
+        throw error;
+      }
+    } else if (this.config.useHttps) {
       if (!this.config.sslCert || !this.config.sslKey)
         throw new Error("SSL certificate and key paths are required when useHttps is true");
       try {
@@ -184,8 +201,14 @@ var MikroServe = class {
       this.setSecurityHeaders(res, this.config.useHttps);
       if (isDebug) console.log(`${method} ${url}`);
       if (req.method === "OPTIONS") {
-        res.statusCode = 204;
-        res.end();
+        if (res instanceof http.ServerResponse) {
+          res.statusCode = 204;
+          res.end();
+        } else {
+          const h2Res = res;
+          h2Res.writeHead(204);
+          h2Res.end();
+        }
         return;
       }
       try {
@@ -201,7 +224,10 @@ var MikroServe = class {
         });
       }
       const result = await this.router.handle(req, res);
-      if (result) return this.respond(res, result);
+      if (result) {
+        if (result._handled) return;
+        return this.respond(res, result);
+      }
       return this.respond(res, {
         statusCode: 404,
         body: {
@@ -307,14 +333,25 @@ var MikroServe = class {
    * @description Set security headers.
    */
   setSecurityHeaders(res, isHttps = false) {
-    res.setHeader("X-Content-Type-Options", "nosniff");
-    res.setHeader("X-Frame-Options", "DENY");
-    res.setHeader(
-      "Content-Security-Policy",
-      "default-src 'self'; script-src 'self'; object-src 'none'"
-    );
-    if (isHttps) res.setHeader("Strict-Transport-Security", "max-age=31536000; includeSubDomains");
-    res.setHeader("X-XSS-Protection", "1; mode=block");
+    const securityHeaders = {
+      "X-Content-Type-Options": "nosniff",
+      "X-Frame-Options": "DENY",
+      "Content-Security-Policy": "default-src 'self'; script-src 'self'; object-src 'none'",
+      "X-XSS-Protection": "1; mode=block"
+    };
+    if (isHttps || this.config.useHttp2) {
+      securityHeaders["Strict-Transport-Security"] = "max-age=31536000; includeSubDomains";
+    }
+    if (res instanceof http.ServerResponse) {
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        res.setHeader(name, value);
+      });
+    } else {
+      const h2Res = res;
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        h2Res.setHeader(name, value);
+      });
+    }
   }
   /**
    * @description Sends a response with appropriate headers.
@@ -323,10 +360,21 @@ var MikroServe = class {
     const headers = {
       ...response.headers || {}
     };
-    res.writeHead(response.statusCode, headers);
-    if (response.body === null || response.body === void 0) res.end();
-    else if (typeof response.body === "string") res.end(response.body);
-    else res.end(JSON.stringify(response.body));
+    const hasWriteHead = (res2) => {
+      return typeof res2.writeHead === "function" && typeof res2.end === "function";
+    };
+    if (hasWriteHead(res)) {
+      res.writeHead(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end();
+      else if (typeof response.body === "string") res.end(response.body);
+      else res.end(JSON.stringify(response.body));
+    } else {
+      console.warn("Unexpected response object type without writeHead/end methods");
+      res.writeHead?.(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end?.();
+      else if (typeof response.body === "string") res.end?.(response.body);
+      else res.end?.(JSON.stringify(response.body));
+    }
   }
   /**
    * @description Sets up graceful shutdown handlers for a server.

package/lib/{chunk-NSHBEU32.mjs → chunk-JJX5XRNB.mjs}

@@ -1,13 +1,10 @@
-import {
-  getTruthyValue
-} from "./chunk-6HESV5Q6.mjs";
-
 // src/utils/configDefaults.ts
 var configDefaults = () => {
   return {
     port: Number(process.env.PORT) || 3e3,
     host: process.env.HOST || "0.0.0.0",
     useHttps: false,
+    useHttp2: false,
     sslCert: "",
     sslKey: "",
     sslCa: "",
@@ -25,6 +22,7 @@ var getDefaultConfig = () => {
     port: defaults.port,
     host: defaults.host,
     useHttps: defaults.useHttps,
+    useHttp2: defaults.useHttp2,
     sslCert: defaults.sslCert,
     sslKey: defaults.sslKey,
     sslCa: defaults.sslCa,
@@ -36,6 +34,10 @@ var getDefaultConfig = () => {
     allowedDomains: defaults.allowedDomains
   };
 };
+function getTruthyValue(value) {
+  if (value === "true" || value === true) return true;
+  return false;
+}
 
 export {
   configDefaults,

package/lib/index.d.mts

@@ -1,4 +1,5 @@
 export { MikroServe } from './MikroServe.mjs';
 export { Context } from './interfaces/index.mjs';
 import 'node:http';
+import 'node:http2';
 import 'node:https';

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export { MikroServe } from './MikroServe.js';
 export { Context } from './interfaces/index.js';
 import 'node:http';
+import 'node:http2';
 import 'node:https';

package/lib/index.js

@@ -37,6 +37,7 @@ module.exports = __toCommonJS(index_exports);
 // src/MikroServe.ts
 var import_node_fs = require("fs");
 var import_node_http = __toESM(require("http"));
+var import_node_http2 = __toESM(require("http2"));
 var import_node_https = __toESM(require("https"));
 var import_mikroconf = require("mikroconf");
 
@@ -283,18 +284,13 @@ var Router = class {
   }
 };
 
-// src/utils/getTruthyValue.ts
-function getTruthyValue(value) {
-  if (value === "true" || value === true) return true;
-  return false;
-}
-
 // src/utils/configDefaults.ts
 var configDefaults = () => {
   return {
     port: Number(process.env.PORT) || 3e3,
     host: process.env.HOST || "0.0.0.0",
     useHttps: false,
+    useHttp2: false,
     sslCert: "",
     sslKey: "",
     sslCa: "",
@@ -306,6 +302,10 @@ var configDefaults = () => {
     allowedDomains: ["*"]
   };
 };
+function getTruthyValue(value) {
+  if (value === "true" || value === true) return true;
+  return false;
+}
 
 // src/MikroServe.ts
 var MikroServe = class {
@@ -324,6 +324,7 @@ var MikroServe = class {
         { flag: "--port", path: "port", defaultValue: defaults.port },
         { flag: "--host", path: "host", defaultValue: defaults.host },
         { flag: "--https", path: "useHttps", defaultValue: defaults.useHttps, isFlag: true },
+        { flag: "--http2", path: "useHttp2", defaultValue: defaults.useHttp2, isFlag: true },
         { flag: "--cert", path: "sslCert", defaultValue: defaults.sslCert },
         { flag: "--key", path: "sslKey", defaultValue: defaults.sslKey },
         { flag: "--ca", path: "sslCa", defaultValue: defaults.sslCa },
@@ -425,7 +426,22 @@ var MikroServe = class {
    */
   createServer() {
     const boundRequestHandler = this.requestHandler.bind(this);
-    if (this.config.useHttps) {
+    if (this.config.useHttp2) {
+      if (!this.config.sslCert || !this.config.sslKey)
+        throw new Error("SSL certificate and key paths are required when useHttp2 is true");
+      try {
+        const httpsOptions = {
+          key: (0, import_node_fs.readFileSync)(this.config.sslKey),
+          cert: (0, import_node_fs.readFileSync)(this.config.sslCert),
+          ...this.config.sslCa ? { ca: (0, import_node_fs.readFileSync)(this.config.sslCa) } : {}
+        };
+        return import_node_http2.default.createSecureServer(httpsOptions, boundRequestHandler);
+      } catch (error) {
+        if (error.message.includes("key values mismatch"))
+          throw new Error(`SSL certificate and key do not match: ${error.message}`);
+        throw error;
+      }
+    } else if (this.config.useHttps) {
       if (!this.config.sslCert || !this.config.sslKey)
         throw new Error("SSL certificate and key paths are required when useHttps is true");
       try {
@@ -479,8 +495,14 @@ var MikroServe = class {
       this.setSecurityHeaders(res, this.config.useHttps);
       if (isDebug) console.log(`${method} ${url}`);
       if (req.method === "OPTIONS") {
-        res.statusCode = 204;
-        res.end();
+        if (res instanceof import_node_http.default.ServerResponse) {
+          res.statusCode = 204;
+          res.end();
+        } else {
+          const h2Res = res;
+          h2Res.writeHead(204);
+          h2Res.end();
+        }
         return;
       }
       try {
@@ -496,7 +518,10 @@ var MikroServe = class {
         });
       }
       const result = await this.router.handle(req, res);
-      if (result) return this.respond(res, result);
+      if (result) {
+        if (result._handled) return;
+        return this.respond(res, result);
+      }
       return this.respond(res, {
         statusCode: 404,
         body: {
@@ -602,14 +627,25 @@ var MikroServe = class {
    * @description Set security headers.
    */
   setSecurityHeaders(res, isHttps = false) {
-    res.setHeader("X-Content-Type-Options", "nosniff");
-    res.setHeader("X-Frame-Options", "DENY");
-    res.setHeader(
-      "Content-Security-Policy",
-      "default-src 'self'; script-src 'self'; object-src 'none'"
-    );
-    if (isHttps) res.setHeader("Strict-Transport-Security", "max-age=31536000; includeSubDomains");
-    res.setHeader("X-XSS-Protection", "1; mode=block");
+    const securityHeaders = {
+      "X-Content-Type-Options": "nosniff",
+      "X-Frame-Options": "DENY",
+      "Content-Security-Policy": "default-src 'self'; script-src 'self'; object-src 'none'",
+      "X-XSS-Protection": "1; mode=block"
+    };
+    if (isHttps || this.config.useHttp2) {
+      securityHeaders["Strict-Transport-Security"] = "max-age=31536000; includeSubDomains";
+    }
+    if (res instanceof import_node_http.default.ServerResponse) {
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        res.setHeader(name, value);
+      });
+    } else {
+      const h2Res = res;
+      Object.entries(securityHeaders).forEach(([name, value]) => {
+        h2Res.setHeader(name, value);
+      });
+    }
   }
   /**
    * @description Sends a response with appropriate headers.
@@ -618,10 +654,21 @@ var MikroServe = class {
     const headers = {
       ...response.headers || {}
     };
-    res.writeHead(response.statusCode, headers);
-    if (response.body === null || response.body === void 0) res.end();
-    else if (typeof response.body === "string") res.end(response.body);
-    else res.end(JSON.stringify(response.body));
+    const hasWriteHead = (res2) => {
+      return typeof res2.writeHead === "function" && typeof res2.end === "function";
+    };
+    if (hasWriteHead(res)) {
+      res.writeHead(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end();
+      else if (typeof response.body === "string") res.end(response.body);
+      else res.end(JSON.stringify(response.body));
+    } else {
+      console.warn("Unexpected response object type without writeHead/end methods");
+      res.writeHead?.(response.statusCode, headers);
+      if (response.body === null || response.body === void 0) res.end?.();
+      else if (typeof response.body === "string") res.end?.(response.body);
+      else res.end?.(JSON.stringify(response.body));
+    }
   }
   /**
    * @description Sets up graceful shutdown handlers for a server.

package/lib/index.mjs

@@ -1,10 +1,9 @@
 import {
   MikroServe
-} from "./chunk-BUKLE4JV.mjs";
+} from "./chunk-J2WPHNMW.mjs";
 import "./chunk-ZFBBESGU.mjs";
 import "./chunk-KJT4SET2.mjs";
-import "./chunk-NSHBEU32.mjs";
-import "./chunk-6HESV5Q6.mjs";
+import "./chunk-JJX5XRNB.mjs";
 export {
   MikroServe
 };

package/lib/interfaces/index.d.mts

@@ -1,4 +1,6 @@
 import http from 'node:http';
+import http2 from 'node:http2';
+import https from 'node:https';
 
 /**
  * @description Server configuration options.
@@ -21,6 +23,11 @@ type MikroServeConfiguration = {
      * @default false
      */
     useHttps: boolean;
+    /**
+     * Should the server use HTTP2?
+     * @default false
+     */
+    useHttp2: boolean;
     /**
      * The path to the SSL certificate.
      * @default '''
@@ -82,12 +89,12 @@ interface ResponseHelpers {
  * @description Context object passed to route handlers.
  */
 interface Context extends ResponseHelpers {
-    req: http.IncomingMessage;
-    res: http.ServerResponse;
+    req: http.IncomingMessage | http2.Http2ServerRequest;
+    res: http.ServerResponse | http2.Http2ServerResponse;
     params: Record<string, string>;
     query: Record<string, string>;
     body: any;
-    headers: http.IncomingHttpHeaders;
+    headers: http.IncomingHttpHeaders | http2.IncomingHttpHeaders;
     path: string;
     state: Record<string, any>;
 }
@@ -98,6 +105,7 @@ interface HandlerResponse {
     statusCode: number;
     body: any;
     headers?: Record<string, string>;
+    _handled?: boolean;
 }
 /**
  * @description Route handler function signature.
@@ -123,5 +131,13 @@ interface PathPattern {
     pattern: RegExp;
     paramNames: string[];
 }
+type ServerType = http.Server | https.Server | http2.Http2Server | http2.Http2SecureServer;
+type RequestType = http.IncomingMessage | http2.Http2ServerRequest;
+type ResponseType = http.ServerResponse | http2.Http2ServerResponse | {
+    setHeader: (name: string, value: string) => void;
+    getHeaders?: () => Record<string, string | string[] | number>;
+    writeHead: (statusCode: number, headers: Record<string, string | string[] | number>) => void;
+    statusCode?: number;
+};
 
-export type { Context, HandlerResponse, Middleware, MikroServeConfiguration, MikroServeOptions, PathPattern, ResponseHelpers, Route, RouteHandler };
+export type { Context, HandlerResponse, Middleware, MikroServeConfiguration, MikroServeOptions, PathPattern, RequestType, ResponseHelpers, ResponseType, Route, RouteHandler, ServerType };

package/lib/interfaces/index.d.ts

@@ -1,4 +1,6 @@
 import http from 'node:http';
+import http2 from 'node:http2';
+import https from 'node:https';
 
 /**
  * @description Server configuration options.
@@ -21,6 +23,11 @@ type MikroServeConfiguration = {
      * @default false
      */
     useHttps: boolean;
+    /**
+     * Should the server use HTTP2?
+     * @default false
+     */
+    useHttp2: boolean;
     /**
      * The path to the SSL certificate.
      * @default '''
@@ -82,12 +89,12 @@ interface ResponseHelpers {
  * @description Context object passed to route handlers.
  */
 interface Context extends ResponseHelpers {
-    req: http.IncomingMessage;
-    res: http.ServerResponse;
+    req: http.IncomingMessage | http2.Http2ServerRequest;
+    res: http.ServerResponse | http2.Http2ServerResponse;
     params: Record<string, string>;
     query: Record<string, string>;
     body: any;
-    headers: http.IncomingHttpHeaders;
+    headers: http.IncomingHttpHeaders | http2.IncomingHttpHeaders;
     path: string;
     state: Record<string, any>;
 }
@@ -98,6 +105,7 @@ interface HandlerResponse {
     statusCode: number;
     body: any;
     headers?: Record<string, string>;
+    _handled?: boolean;
 }
 /**
  * @description Route handler function signature.
@@ -123,5 +131,13 @@ interface PathPattern {
     pattern: RegExp;
     paramNames: string[];
 }
+type ServerType = http.Server | https.Server | http2.Http2Server | http2.Http2SecureServer;
+type RequestType = http.IncomingMessage | http2.Http2ServerRequest;
+type ResponseType = http.ServerResponse | http2.Http2ServerResponse | {
+    setHeader: (name: string, value: string) => void;
+    getHeaders?: () => Record<string, string | string[] | number>;
+    writeHead: (statusCode: number, headers: Record<string, string | string[] | number>) => void;
+    statusCode?: number;
+};
 
-export type { Context, HandlerResponse, Middleware, MikroServeConfiguration, MikroServeOptions, PathPattern, ResponseHelpers, Route, RouteHandler };
+export type { Context, HandlerResponse, Middleware, MikroServeConfiguration, MikroServeOptions, PathPattern, RequestType, ResponseHelpers, ResponseType, Route, RouteHandler, ServerType };

package/lib/utils/configDefaults.d.mts

@@ -1,11 +1,14 @@
 import { MikroServeConfiguration } from '../interfaces/index.mjs';
 import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 declare const configDefaults: () => MikroServeConfiguration;
 declare const getDefaultConfig: () => {
     port: number;
     host: string;
     useHttps: boolean;
+    useHttp2: boolean;
     sslCert: string;
     sslKey: string;
     sslCa: string;

package/lib/utils/configDefaults.d.ts

@@ -1,11 +1,14 @@
 import { MikroServeConfiguration } from '../interfaces/index.js';
 import 'node:http';
+import 'node:http2';
+import 'node:https';
 
 declare const configDefaults: () => MikroServeConfiguration;
 declare const getDefaultConfig: () => {
     port: number;
     host: string;
     useHttps: boolean;
+    useHttp2: boolean;
     sslCert: string;
     sslKey: string;
     sslCa: string;

package/lib/utils/configDefaults.js

@@ -24,19 +24,12 @@ __export(configDefaults_exports, {
   getDefaultConfig: () => getDefaultConfig
 });
 module.exports = __toCommonJS(configDefaults_exports);
-
-// src/utils/getTruthyValue.ts
-function getTruthyValue(value) {
-  if (value === "true" || value === true) return true;
-  return false;
-}
-
-// src/utils/configDefaults.ts
 var configDefaults = () => {
   return {
     port: Number(process.env.PORT) || 3e3,
     host: process.env.HOST || "0.0.0.0",
     useHttps: false,
+    useHttp2: false,
     sslCert: "",
     sslKey: "",
     sslCa: "",
@@ -54,6 +47,7 @@ var getDefaultConfig = () => {
     port: defaults.port,
     host: defaults.host,
     useHttps: defaults.useHttps,
+    useHttp2: defaults.useHttp2,
     sslCert: defaults.sslCert,
     sslKey: defaults.sslKey,
     sslCa: defaults.sslCa,
@@ -65,6 +59,10 @@ var getDefaultConfig = () => {
     allowedDomains: defaults.allowedDomains
   };
 };
+function getTruthyValue(value) {
+  if (value === "true" || value === true) return true;
+  return false;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   configDefaults,

package/lib/utils/configDefaults.mjs

@@ -1,8 +1,7 @@
 import {
   configDefaults,
   getDefaultConfig
-} from "../chunk-NSHBEU32.mjs";
-import "../chunk-6HESV5Q6.mjs";
+} from "../chunk-JJX5XRNB.mjs";
 export {
   configDefaults,
   getDefaultConfig

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "mikroserve",
   "description": "Minimalistic, ready-to-use API, built on Node.js primitives.",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "author": "Mikael Vesavuori",
   "license": "MIT",
-  "keywords": [],
+  "keywords": [
+    "node",
+    "node-server",
+    "api",
+    "api-server",
+    "https"
+  ],
   "main": "lib/index.js",
   "repository": {
     "type": "git",
@@ -29,7 +35,7 @@
     "mikroserve": "lib/index.js"
   },
   "scripts": {
-    "start": "npx tsx src/index.ts --force",
+    "start": "npx tsx src/index.ts",
     "test": "npm run test:licenses && npm run test:types && npm run lint && npm run test:unit",
     "test:types": "npx type-coverage --at-least 85 --strict --ignore-files \"tests/**/*.ts\" --ignore-files \"*.ts\" --ignore-files \"src/application/errors/*.ts\" --ignore-files \"testdata/*.ts\"",
     "test:licenses": "npx license-compliance --direct --allow 'MIT;ISC;0BSD;BSD-2-Clause;BSD-3-Clause;Apache-2.0;Unlicense;CC0-1.0'",
@@ -55,6 +61,6 @@
     "vitest": "2"
   },
   "dependencies": {
-    "mikroconf": "^0.0.2"
+    "mikroconf": "latest"
   }
 }

package/lib/chunk-6HESV5Q6.mjs

@@ -1,9 +0,0 @@
-// src/utils/getTruthyValue.ts
-function getTruthyValue(value) {
-  if (value === "true" || value === true) return true;
-  return false;
-}
-
-export {
-  getTruthyValue
-};

package/lib/utils/getTruthyValue.d.mts

@@ -1,6 +0,0 @@
-/**
- * @description Check if a value is a boolean or stringly "true".
- */
-declare function getTruthyValue(value: string | boolean | undefined): boolean;
-
-export { getTruthyValue };

package/lib/utils/getTruthyValue.d.ts

@@ -1,6 +0,0 @@
-/**
- * @description Check if a value is a boolean or stringly "true".
- */
-declare function getTruthyValue(value: string | boolean | undefined): boolean;
-
-export { getTruthyValue };

package/lib/utils/getTruthyValue.js

@@ -1,33 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/utils/getTruthyValue.ts
-var getTruthyValue_exports = {};
-__export(getTruthyValue_exports, {
-  getTruthyValue: () => getTruthyValue
-});
-module.exports = __toCommonJS(getTruthyValue_exports);
-function getTruthyValue(value) {
-  if (value === "true" || value === true) return true;
-  return false;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getTruthyValue
-});

package/lib/utils/getTruthyValue.mjs

@@ -1,6 +0,0 @@
-import {
-  getTruthyValue
-} from "../chunk-6HESV5Q6.mjs";
-export {
-  getTruthyValue
-};