packeteer 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# packeteer
+
+Minimal HTTP server for Node.js with trie-based routing and built-in JSON body parsing.
+
+## Install
+
+```sh
+npm install packeteer
+```
+
+## Usage
+
+```ts
+import { Packeteer } from 'packeteer'
+
+const app = await new Packeteer()
+    .get('/health', (_req, res, _ctx) => {
+        res.writeHead(200, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ status: 'ok' }))
+    })
+    .post('/echo', (_req, res, ctx) => {
+        res.writeHead(200, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify(ctx.get('body')))
+    })
+    .listen(3000)
+
+console.log(app.address())
+```
+
+## API
+
+### `new Packeteer()`
+
+Creates a new server instance. CORS headers (`Access-Control-Allow-*: *`) are set on every response automatically.
+
+### `.get(path, handler)` / `.post` / `.put` / `.delete` / `.patch`
+
+Registers a route. Returns `this` for chaining.
+
+The handler signature is:
+
+```ts
+(request: IncomingMessage, response: ServerResponse, context: Map<string, unknown>) => Promise<void> | void
+```
+
+`context` contains `body` (parsed JSON) when the request has a body.
+
+#### Path parameters
+
+Prefix a segment with `:` to capture it by name:
+
+```ts
+app.get('/users/:id', (_req, res, ctx) => {
+    res.end(ctx.get('id') as string) // e.g. "42" for /users/42
+})
+```
+
+#### Wildcards
+
+End a path with `*` to capture all remaining segments as a single slash-joined string under the key `'wildcard'`:
+
+```ts
+app.get('/files/*', (_req, res, ctx) => {
+    res.end(ctx.get('wildcard') as string) // e.g. "images/avatar.png" for /files/images/avatar.png
+})
+```
+
+### `.maxBodySize(bytes)`
+
+Overrides the default 8 MB body size limit. Returns `this` for chaining.
+
+```ts
+new Packeteer().maxBodySize(1024 * 1024) // 1 MB
+```
+
+### `.listen(port): Promise<this>`
+
+Starts the server and resolves when it is ready.
+
+### `.address()`
+
+Returns the bound address (delegates to `server.address()`).
+
+### `.close(): Promise<void>`
+
+Stops the server.
+
+## Behaviour
+
+-   JSON bodies are parsed automatically and available as `ctx.get('body')`.
+-   Bodies over the size limit (default 8 MB) are rejected with `413`.
+-   Malformed JSON is rejected with `400`.
+-   `TypeError` / `RangeError` thrown from a handler return `400` with the error message.
+-   Any other thrown error returns `500` and is logged to stderr.
+-   Unmatched routes return `404`.
+
+## Requirements
+
+Node.js 18 or later.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+type Handler = (request: IncomingMessage, response: ServerResponse, context: Map<string, unknown>) => Promise<void> | void;
+export declare class Packeteer {
+    private router;
+    private server;
+    private _maxBodySize;
+    maxBodySize(bytes: number): this;
+    constructor();
+    get(path: string, handler: Handler): this;
+    post(path: string, handler: Handler): this;
+    put(path: string, handler: Handler): this;
+    delete(path: string, handler: Handler): this;
+    patch(path: string, handler: Handler): this;
+    listen(port: number): Promise<this>;
+    address(): string | import("node:net").AddressInfo | null;
+    close(): Promise<void>;
+}
+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":"AACA,OAAO,EAAgB,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEzE,KAAK,OAAO,GAAG,CACX,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAkB;IAEtC,WAAW,CAAC,KAAK,EAAE,MAAM;;IAoEzB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKlC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKlC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKpC,MAAM,CAAC,IAAI,EAAE,MAAM;IAMnB,OAAO;IAIP,KAAK;CAKR"}

package/dist/index.js

@@ -0,0 +1,105 @@
+import { TrieRouter } from 'cafe-utility';
+import { createServer } from 'node:http';
+export class Packeteer {
+    router = new TrieRouter();
+    server = createServer();
+    _maxBodySize = 1024 * 1024 * 8;
+    maxBodySize(bytes) {
+        this._maxBodySize = bytes;
+        return this;
+    }
+    constructor() {
+        this.server.on('request', (request, response) => {
+            response.setHeader('Access-Control-Allow-Origin', '*');
+            response.setHeader('Access-Control-Allow-Headers', '*');
+            response.setHeader('Access-Control-Allow-Methods', '*');
+            if (request.method === 'OPTIONS') {
+                response.writeHead(204);
+                response.end();
+                return;
+            }
+            let incomingBodySize = 0;
+            const chunks = [];
+            request.on('data', chunk => {
+                incomingBodySize += chunk.length;
+                if (incomingBodySize > this._maxBodySize) {
+                    response.writeHead(413);
+                    response.end('Request body too large');
+                    request.destroy();
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            request.on('end', async () => {
+                const context = new Map();
+                const raw = Buffer.concat(chunks).toString();
+                if (raw) {
+                    try {
+                        context.set('body', JSON.parse(raw));
+                    }
+                    catch {
+                        response.writeHead(400);
+                        response.end('Invalid JSON');
+                        return;
+                    }
+                }
+                try {
+                    const segments = [
+                        (request.method || 'get').toLowerCase(),
+                        ...(request.url || '/').slice(1).split('/')
+                    ];
+                    const handled = await this.router.handle(segments, request, response, context);
+                    if (!handled) {
+                        response.writeHead(404);
+                        response.end('Not found');
+                    }
+                }
+                catch (error) {
+                    if (error instanceof TypeError || error instanceof RangeError) {
+                        response.writeHead(400);
+                        response.end(error.message);
+                    }
+                    else {
+                        console.error(error);
+                        response.writeHead(500);
+                        response.end('Internal server error');
+                    }
+                }
+            });
+        });
+    }
+    get(path, handler) {
+        this.router.insert(['get', ...path.slice(1).split('/')], handler);
+        return this;
+    }
+    post(path, handler) {
+        this.router.insert(['post', ...path.slice(1).split('/')], handler);
+        return this;
+    }
+    put(path, handler) {
+        this.router.insert(['put', ...path.slice(1).split('/')], handler);
+        return this;
+    }
+    delete(path, handler) {
+        this.router.insert(['delete', ...path.slice(1).split('/')], handler);
+        return this;
+    }
+    patch(path, handler) {
+        this.router.insert(['patch', ...path.slice(1).split('/')], handler);
+        return this;
+    }
+    listen(port) {
+        return new Promise(resolve => {
+            this.server.listen(port, () => resolve(this));
+        });
+    }
+    address() {
+        return this.server.address();
+    }
+    close() {
+        return new Promise((resolve, reject) => {
+            this.server.close(err => (err ? reject(err) : resolve()));
+        });
+    }
+}
+//# 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,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAmC,MAAM,WAAW,CAAA;AAQzE,MAAM,OAAO,SAAS;IACV,MAAM,GAAG,IAAI,UAAU,EAAmC,CAAA;IAC1D,MAAM,GAAG,YAAY,EAAE,CAAA;IACvB,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,CAAA;IAEtC,WAAW,CAAC,KAAa;QACrB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,OAAO,IAAI,CAAA;IACf,CAAC;IAED;QACI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC5C,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;YACtD,QAAQ,CAAC,SAAS,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;YACvD,QAAQ,CAAC,SAAS,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;YACvD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;gBACvB,QAAQ,CAAC,GAAG,EAAE,CAAA;gBACd,OAAM;YACV,CAAC;YACD,IAAI,gBAAgB,GAAG,CAAC,CAAA;YACxB,MAAM,MAAM,GAAa,EAAE,CAAA;YAC3B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;gBACvB,gBAAgB,IAAI,KAAK,CAAC,MAAM,CAAA;gBAChC,IAAI,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;oBACvC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;oBACvB,QAAQ,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;oBACtC,OAAO,CAAC,OAAO,EAAE,CAAA;oBACjB,OAAM;gBACV,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC,CAAC,CAAA;YACF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;gBACzB,MAAM,OAAO,GAAyB,IAAI,GAAG,EAAE,CAAA;gBAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;gBAC5C,IAAI,GAAG,EAAE,CAAC;oBACN,IAAI,CAAC;wBACD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;oBACxC,CAAC;oBAAC,MAAM,CAAC;wBACL,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;wBACvB,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;wBAC5B,OAAM;oBACV,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC;oBACD,MAAM,QAAQ,GAAG;wBACb,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE;wBACvC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;qBAC9C,CAAA;oBACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CACpC,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,OAA8B,CACjC,CAAA;oBACD,IAAI,CAAC,OAAO,EAAE,CAAC;wBACX,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;wBACvB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;oBAC7B,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;wBAC5D,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;wBACvB,QAAQ,CAAC,GAAG,CAAE,KAAe,CAAC,OAAO,CAAC,CAAA;oBAC1C,CAAC;yBAAM,CAAC;wBACJ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;wBACpB,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;wBACvB,QAAQ,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;oBACzC,CAAC;gBACL,CAAC;YACL,CAAC,CAAC,CAAA;QACN,CAAC,CAAC,CAAA;IACN,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAgB;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAc,CAAC,CAAA;QACxE,OAAO,IAAI,CAAA;IACf,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAgB;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAc,CAAC,CAAA;QACzE,OAAO,IAAI,CAAA;IACf,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAgB;QAC9B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAc,CAAC,CAAA;QACxE,OAAO,IAAI,CAAA;IACf,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,OAAgB;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAc,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAA;IACf,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAgB;QAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAc,CAAC,CAAA;QAC1E,OAAO,IAAI,CAAA;IACf,CAAC;IAED,MAAM,CAAC,IAAY;QACf,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;IACN,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;IAChC,CAAC;IAED,KAAK;QACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC7D,CAAC,CAAC,CAAA;IACN,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "packeteer",
+  "version": "1.0.0",
+  "description": "",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "sideEffects": false,
+  "dependencies": {
+    "cafe-utility": "^33.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.7.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test test/*.test.ts"
+  }
+}