@tobiasgjerstrup/microhttp-server 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Tobias Gjerstrup
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# MicroHTTP Server
+
+A small, lightweight, zero-dependency wrapper around Node.js' built-in `http` module for quickly defining route handlers.
+
+## Installation
+
+```sh
+npm install @tobiasgjerstrup/microhttp-server
+```
+
+## Usage
+
+```ts
+import createApp from "@tobiasgjerstrup/microhttp-server";
+
+const app = createApp();
+
+app.get("/", (req, res) => {
+  res.writeHead(200, { "Content-Type": "text/plain" });
+  res.end("Hello, world!");
+});
+
+app.listen(3000, "127.0.0.1", () => {
+  console.log("Listening on http://127.0.0.1:3000");
+});
+```
+
+## API
+
+### `createApp()`
+
+Returns an app instance with the following methods:
+
+#### `app.get(path, handler)`
+#### `app.post(path, handler)`
+#### `app.put(path, handler)`
+#### `app.delete(path, handler)`
+
+Register a route handler for the given HTTP method and path.
+
+- `path` — exact URL path to match (e.g. `"/users"`)
+- `handler(req, res)` — standard Node.js `http.IncomingMessage` / `http.ServerResponse` handler
+
+#### `app.listen(port, callback)`
+#### `app.listen(port, hostname, callback)`
+
+Start the HTTP server on the given port and optional hostname.
+
+Unmatched routes respond with `404 Not Found`.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,2 @@
+console.log("Hello world!");
+export {};

package/dist/main.d.ts

@@ -0,0 +1,10 @@
+import http from 'node:http';
+declare function createApp(): {
+    get: (path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse) => void) => void;
+    post: (path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse) => void) => void;
+    put: (path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse) => void) => void;
+    delete: (path: string, handler: (req: http.IncomingMessage, res: http.ServerResponse) => void) => void;
+    listen: (port: number, hostnameOrCallback: string | (() => void), callback?: () => void) => void;
+};
+export default createApp;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iBAAS,SAAS;gBA+BF,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;iBAG7E,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;gBAG/E,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;mBAG3E,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;mBA7BzE,MAAM,sBAAsB,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,MAAM,IAAI;EAkC/F;AAED,eAAe,SAAS,CAAC"}

package/dist/main.js

@@ -0,0 +1,44 @@
+import http from 'node:http';
+function createApp() {
+    const routes = [];
+    function addRoute(method, path, handler) {
+        routes.push({ method, path, handler });
+    }
+    function matchRoute(method, url) {
+        return routes.find(r => r.method === method && r.path === url);
+    }
+    function listen(port, hostnameOrCallback, callback) {
+        const server = http.createServer((req, res) => {
+            const route = matchRoute(req.method, req.url ?? '');
+            if (route) {
+                route.handler(req, res);
+            }
+            else {
+                res.writeHead(404, { 'Content-Type': 'text/plain' });
+                res.end('Not found');
+            }
+        });
+        if (typeof hostnameOrCallback === 'function') {
+            server.listen(port, hostnameOrCallback);
+        }
+        else {
+            server.listen(port, hostnameOrCallback, callback);
+        }
+    }
+    return {
+        get: (path, handler) => {
+            addRoute('GET', path, handler);
+        },
+        post: (path, handler) => {
+            addRoute('POST', path, handler);
+        },
+        put: (path, handler) => {
+            addRoute('PUT', path, handler);
+        },
+        delete: (path, handler) => {
+            addRoute('DELETE', path, handler);
+        },
+        listen
+    };
+}
+export default createApp;

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tobiasgjerstrup/microhttp-server",
+  "version": "1.0.0",
+  "description": "A small wrapper for nodejs' http server",
+  "homepage": "https://github.com/tobiasgjerstrup/npm-MicroHTTP-Server#readme",
+  "bugs": {
+    "url": "https://github.com/tobiasgjerstrup/npm-MicroHTTP-Server/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tobiasgjerstrup/npm-MicroHTTP-Server.git"
+  },
+  "license": "ISC",
+  "author": "Tobias Gjerstrup",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "cd playground && npm start",
+    "lint": "eslint . --max-warnings=0",
+    "test": "vitest",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "prepublishOnly": "npm run build && npm run lint && npm run test"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "jiti": "^2.6.1",
+    "typescript": "~6.0.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^4.1.1"
+  }
+}