@arikajs/http 0.0.4 → 0.0.6

package/README.md

@@ -1,5 +1,11 @@
 # Arika HTTP
 
+<div align="center">
+
+<img src="../cli/templates/app/public/assets/img/logo.png" alt="ArikaJS Logo" width="400">
+
+</div>
+
 `@arikajs/http` is the **web engine** for the ArikaJS ecosystem.
 
 Arika HTTP provides a native, framework-controlled HTTP layer that sits directly on top of Node.js HTTP primitives. It handles the request lifecycle, routing, and middleware without relying on external frameworks like Express or Fastify.
@@ -199,17 +205,33 @@ return response
 
 ---
 
-## Project Structure (recommended)
-
-- `src/`
-  - `HttpKernel.ts` – The main HTTP entry point
-  - `Router.ts` – The route collection and dispatcher
-  - `Request.ts` – HTTP Request abstraction
-  - `Response.ts` – HTTP Response builder
-  - `Pipeline.ts` – Middleware execution engine
-  - `Middleware/` – Built-in middleware (e.g., BodyParser)
-  - `index.ts` – Public exports
-- `tests/` – Unit tests for the HTTP layer
+## 🏗 Architecture
+
+```text
+http/
+├── src/
+│   ├── Contracts
+│   │   └── Application.ts
+│   ├── Exceptions
+│   │   └── HttpException.ts
+│   ├── Middleware
+│   │   ├── BodyParserMiddleware.ts
+│   │   ├── ConvertEmptyStringsToNull.ts
+│   │   ├── CorsMiddleware.ts
+│   │   └── TrimStrings.ts
+│   ├── HttpKernel.ts
+│   ├── HttpServiceProvider.ts
+│   ├── index.ts
+│   ├── Middleware.ts
+│   ├── Pipeline.ts
+│   ├── Request.ts
+│   ├── Response.ts
+│   └── Router.ts
+├── tests/
+├── package.json
+├── tsconfig.json
+└── README.md
+```
 
 ---
 

package/dist/HttpKernel.d.ts

@@ -0,0 +1,40 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { Application } from './Contracts/Application';
+import { Request } from './Request';
+import { Response } from './Response';
+import { Router } from './Router';
+export declare class HttpKernel {
+    protected app: Application;
+    protected middleware: any[];
+    protected router: Router;
+    constructor(app: Application);
+    /**
+     * Get the router instance.
+     */
+    getRouter(): Router;
+    /**
+     * Set the router instance.
+     */
+    setRouter(router: Router): void;
+    /**
+     * Add global middleware.
+     */
+    use(middleware: any): this;
+    /**
+     * Handle an incoming HTTP request.
+     */
+    handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    /**
+     * Send the given request through the middleware / router.
+     */
+    protected sendRequestThroughRouter(request: Request, response: Response): Promise<Response>;
+    /**
+     * Dispatch the request to the router.
+     */
+    protected dispatchToRouter(request: Request, response: Response): Promise<Response>;
+    /**
+     * Handle an exception during request execution.
+     */
+    protected handleException(error: any, res: ServerResponse): void;
+}
+//# sourceMappingURL=HttpKernel.d.ts.map

package/dist/HttpKernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpKernel.d.ts","sourceRoot":"","sources":["../src/HttpKernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,UAAU;IAIP,SAAS,CAAC,GAAG,EAAE,WAAW;IAHtC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,CAAM;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEH,GAAG,EAAE,WAAW;IAItC;;OAEG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,GAAG,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAKjC;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7E;;OAEG;cACa,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMjG;;OAEG;cACa,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIzF;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;CAYnE"}

package/dist/HttpKernel.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpKernel = void 0;
+const Request_1 = require("./Request");
+const Response_1 = require("./Response");
+const Pipeline_1 = require("./Pipeline");
+const Router_1 = require("./Router");
+class HttpKernel {
+    constructor(app) {
+        this.app = app;
+        this.middleware = [];
+        this.router = new Router_1.Router();
+    }
+    /**
+     * Get the router instance.
+     */
+    getRouter() {
+        return this.router;
+    }
+    /**
+     * Set the router instance.
+     */
+    setRouter(router) {
+        this.router = router;
+    }
+    /**
+     * Add global middleware.
+     */
+    use(middleware) {
+        this.middleware.push(middleware);
+        return this;
+    }
+    /**
+     * Handle an incoming HTTP request.
+     */
+    async handle(req, res) {
+        try {
+            const request = new Request_1.Request(this.app, req);
+            const response = new Response_1.Response(res);
+            const result = await this.sendRequestThroughRouter(request, response);
+            result.terminate();
+        }
+        catch (error) {
+            this.handleException(error, res);
+        }
+    }
+    /**
+     * Send the given request through the middleware / router.
+     */
+    async sendRequestThroughRouter(request, response) {
+        return (new Pipeline_1.Pipeline(this.app.getContainer()))
+            .pipe(this.middleware)
+            .handle(request, (req) => this.dispatchToRouter(req, response), response);
+    }
+    /**
+     * Dispatch the request to the router.
+     */
+    async dispatchToRouter(request, response) {
+        return this.router.dispatch(request, response);
+    }
+    /**
+     * Handle an exception during request execution.
+     */
+    handleException(error, res) {
+        const response = new Response_1.Response(res);
+        const status = error.statusCode || error.status || 500;
+        response.status(status).json({
+            message: error.message || 'Internal Server Error',
+            error: process.env.NODE_ENV === 'development' ? error.stack : undefined
+        });
+        response.terminate();
+    }
+}
+exports.HttpKernel = HttpKernel;
+//# sourceMappingURL=HttpKernel.js.map

package/dist/HttpKernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpKernel.js","sourceRoot":"","sources":["../src/HttpKernel.ts"],"names":[],"mappings":";;;AAEA,uCAAoC;AACpC,yCAAsC;AACtC,yCAAsC;AACtC,qCAAkC;AAElC,MAAa,UAAU;IAInB,YAAsB,GAAgB;QAAhB,QAAG,GAAH,GAAG,CAAa;QAH5B,eAAU,GAAU,EAAE,CAAC;QAI7B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,SAAS,CAAC,MAAc;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,UAAe;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,GAAoB,EAAE,GAAmB;QACzD,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,GAAG,CAAC,CAAC;YAEnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEtE,MAAM,CAAC,SAAS,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,wBAAwB,CAAC,OAAgB,EAAE,QAAkB;QACzE,OAAO,CAAC,IAAI,mBAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;aACrB,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,gBAAgB,CAAC,OAAgB,EAAE,QAAkB;QACjE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,KAAU,EAAE,GAAmB;QACrD,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,GAAG,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;QAEvD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB;YACjD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC1E,CAAC,CAAC;QAEH,QAAQ,CAAC,SAAS,EAAE,CAAC;IACzB,CAAC;CACJ;AA7ED,gCA6EC"}

package/dist/HttpServiceProvider.d.ts

@@ -0,0 +1,13 @@
+export declare class HttpServiceProvider {
+    protected app: any;
+    constructor(app: any);
+    /**
+     * Register the service provider.
+     */
+    register(): void;
+    /**
+     * Boot the service provider.
+     */
+    boot(): void;
+}
+//# sourceMappingURL=HttpServiceProvider.d.ts.map

package/dist/HttpServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServiceProvider.d.ts","sourceRoot":"","sources":["../src/HttpServiceProvider.ts"],"names":[],"mappings":"AAEA,qBAAa,mBAAmB;IAChB,SAAS,CAAC,GAAG,EAAE,GAAG;gBAAR,GAAG,EAAE,GAAG;IAE9B;;OAEG;IACH,QAAQ;IAMR;;OAEG;IACH,IAAI;CAGP"}

package/dist/HttpServiceProvider.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpServiceProvider = void 0;
+const HttpKernel_1 = require("./HttpKernel");
+class HttpServiceProvider {
+    constructor(app) {
+        this.app = app;
+    }
+    /**
+     * Register the service provider.
+     */
+    register() {
+        this.app.singleton(HttpKernel_1.HttpKernel, (app) => {
+            return new HttpKernel_1.HttpKernel(app);
+        });
+    }
+    /**
+     * Boot the service provider.
+     */
+    boot() {
+        //
+    }
+}
+exports.HttpServiceProvider = HttpServiceProvider;
+//# sourceMappingURL=HttpServiceProvider.js.map

package/dist/HttpServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServiceProvider.js","sourceRoot":"","sources":["../src/HttpServiceProvider.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,MAAa,mBAAmB;IAC5B,YAAsB,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAI,CAAC;IAEnC;;OAEG;IACH,QAAQ;QACJ,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAU,EAAE,CAAC,GAAQ,EAAE,EAAE;YACxC,OAAO,IAAI,uBAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,IAAI;QACA,EAAE;IACN,CAAC;CACJ;AAlBD,kDAkBC"}

package/dist/Middleware/BodyParserMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BodyParserMiddleware.d.ts","sourceRoot":"","sources":["../../src/Middleware/BodyParserMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qBAAa,oBAAqB,YAAW,UAAU;IACnD;;OAEG;IACG,MAAM,CACR,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxD,QAAQ,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC;IAiBpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAmCpB"}
+{"version":3,"file":"BodyParserMiddleware.d.ts","sourceRoot":"","sources":["../../src/Middleware/BodyParserMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qBAAa,oBAAqB,YAAW,UAAU;IACnD;;OAEG;IACG,MAAM,CACR,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxD,QAAQ,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC;IAiBpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAoEpB"}

package/dist/Middleware/BodyParserMiddleware.js

@@ -25,13 +25,41 @@ class BodyParserMiddleware {
      */
     parseBody(request) {
         return new Promise((resolve, reject) => {
-            let body = '';
+            const contentType = request.header('content-type');
             const req = request.getRaw();
+            if (contentType?.includes('multipart/form-data')) {
+                try {
+                    const Busboy = require('busboy');
+                    const busboy = Busboy({ headers: request.headers() });
+                    const data = {};
+                    busboy.on('field', (name, value, info) => {
+                        data[name] = value;
+                    });
+                    busboy.on('file', (name, file, info) => {
+                        // For now we just consume the file stream to prevent hang
+                        file.resume();
+                    });
+                    busboy.on('close', () => {
+                        resolve(data);
+                    });
+                    busboy.on('finish', () => {
+                        resolve(data);
+                    });
+                    busboy.on('error', (err) => {
+                        reject(err);
+                    });
+                    req.pipe(busboy);
+                }
+                catch (e) {
+                    reject(e);
+                }
+                return;
+            }
+            let body = '';
             req.on('data', (chunk) => {
                 body += chunk.toString();
             });
             req.on('end', () => {
-                const contentType = request.header('content-type');
                 if (contentType?.includes('application/json')) {
                     try {
                         resolve(JSON.parse(body || '{}'));

package/dist/Middleware/BodyParserMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"BodyParserMiddleware.js","sourceRoot":"","sources":["../../src/Middleware/BodyParserMiddleware.ts"],"names":[],"mappings":";;;AAIA,MAAa,oBAAoB;IAC7B;;OAEG;IACH,KAAK,CAAC,MAAM,CACR,OAAgB,EAChB,IAAwD,EACxD,QAAmB;QAEnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB,CAAC;QAEzE,8CAA8C;QAC9C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YACrE,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC3C,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,wDAAwD;YAC5D,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,OAAgB;QAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAE7B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC7B,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACf,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAuB,CAAC;gBAEzE,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC5C,IAAI,CAAC;wBACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC;oBACtC,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACT,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;oBACtC,CAAC;gBACL,CAAC;qBAAM,IAAI,WAAW,EAAE,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC;oBACpE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM,IAAI,GAAwB,EAAE,CAAC;oBACrC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;wBAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACtB,CAAC,CAAC,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,EAAE,CAAC,CAAC;gBAChB,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC3B,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA/DD,oDA+DC"}
+{"version":3,"file":"BodyParserMiddleware.js","sourceRoot":"","sources":["../../src/Middleware/BodyParserMiddleware.ts"],"names":[],"mappings":"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"}

package/dist/Middleware/SecurityHeaders.d.ts

@@ -0,0 +1,12 @@
+import { Request, Response } from '../index';
+import { Middleware } from '../Middleware';
+/**
+ * Sets essential HTTP security headers to protect the application.
+ */
+export declare class SecurityHeaders implements Middleware {
+    /**
+     * Handle the incoming request.
+     */
+    handle(request: Request, next: (request: Request) => Promise<Response> | Response, response?: Response): Promise<Response>;
+}
+//# sourceMappingURL=SecurityHeaders.d.ts.map

package/dist/Middleware/SecurityHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityHeaders.d.ts","sourceRoot":"","sources":["../../src/Middleware/SecurityHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAC9C;;OAEG;IACU,MAAM,CACf,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxD,QAAQ,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC;CAyBvB"}

package/dist/Middleware/SecurityHeaders.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityHeaders = void 0;
+/**
+ * Sets essential HTTP security headers to protect the application.
+ */
+class SecurityHeaders {
+    /**
+     * Handle the incoming request.
+     */
+    async handle(request, next, response) {
+        const res = await next(request);
+        res.header('X-Content-Type-Options', 'nosniff');
+        res.header('X-Frame-Options', 'SAMEORIGIN');
+        res.header('X-XSS-Protection', '1; mode=block');
+        res.header('Referrer-Policy', 'strict-origin-when-cross-origin');
+        res.header('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+        if (process.env.NODE_ENV === 'production') {
+            res.header('Strict-Transport-Security', 'max-age=31536000; includeSubDomains; preload');
+        }
+        res.header('Content-Security-Policy', "default-src 'self'; " +
+            "script-src 'self' 'unsafe-inline'; " +
+            "style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; " +
+            "img-src 'self' data:; " +
+            "font-src 'self' https://fonts.gstatic.com; " +
+            "connect-src 'self'");
+        return res;
+    }
+}
+exports.SecurityHeaders = SecurityHeaders;
+//# sourceMappingURL=SecurityHeaders.js.map

package/dist/Middleware/SecurityHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityHeaders.js","sourceRoot":"","sources":["../../src/Middleware/SecurityHeaders.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,eAAe;IACxB;;OAEG;IACI,KAAK,CAAC,MAAM,CACf,OAAgB,EAChB,IAAwD,EACxD,QAAmB;QAEnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAEhC,GAAG,CAAC,MAAM,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,oBAAoB,EAAE,0CAA0C,CAAC,CAAC;QAE7E,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACxC,GAAG,CAAC,MAAM,CAAC,2BAA2B,EAAE,8CAA8C,CAAC,CAAC;QAC5F,CAAC;QAED,GAAG,CAAC,MAAM,CACN,yBAAyB,EACzB,sBAAsB;YACtB,qCAAqC;YACrC,iEAAiE;YACjE,wBAAwB;YACxB,6CAA6C;YAC7C,oBAAoB,CACvB,CAAC;QAEF,OAAO,GAAG,CAAC;IACf,CAAC;CACJ;AAjCD,0CAiCC"}

package/dist/Middleware/ServeStaticMiddleware.d.ts

@@ -0,0 +1,8 @@
+import { Request } from '../Request';
+import { Response } from '../Response';
+export declare class ServeStaticMiddleware {
+    private serve;
+    constructor(publicPath: string);
+    handle(request: Request, next: (req: Request) => Promise<Response>, response: Response): Promise<Response>;
+}
+//# sourceMappingURL=ServeStaticMiddleware.d.ts.map

package/dist/Middleware/ServeStaticMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServeStaticMiddleware.d.ts","sourceRoot":"","sources":["../../src/Middleware/ServeStaticMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,KAAK,CAAiC;gBAElC,UAAU,EAAE,MAAM;IAOjB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CAmB1H"}

package/dist/Middleware/ServeStaticMiddleware.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServeStaticMiddleware = void 0;
+const serve_static_1 = __importDefault(require("serve-static"));
+class ServeStaticMiddleware {
+    constructor(publicPath) {
+        this.serve = (0, serve_static_1.default)(publicPath, {
+            index: false,
+            fallthrough: true,
+        });
+    }
+    async handle(request, next, response) {
+        return new Promise((resolve, reject) => {
+            const req = request.getIncomingMessage();
+            const res = response.getOriginalResponse();
+            this.serve(req, res, async (err) => {
+                if (err) {
+                    return reject(err);
+                }
+                try {
+                    const result = await next(request);
+                    resolve(result);
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+    }
+}
+exports.ServeStaticMiddleware = ServeStaticMiddleware;
+//# sourceMappingURL=ServeStaticMiddleware.js.map

package/dist/Middleware/ServeStaticMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServeStaticMiddleware.js","sourceRoot":"","sources":["../../src/Middleware/ServeStaticMiddleware.ts"],"names":[],"mappings":";;;;;;AAEA,gEAAuC;AAEvC,MAAa,qBAAqB;IAG9B,YAAY,UAAkB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAA,sBAAW,EAAC,UAAU,EAAE;YACjC,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,IAAI;SACpB,CAAC,CAAC;IACP,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,OAAgB,EAAE,IAAyC,EAAE,QAAkB;QAC/F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YAE3C,IAAI,CAAC,KAAK,CAAC,GAAU,EAAE,GAAU,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;gBAClD,IAAI,GAAG,EAAE,CAAC;oBACN,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;gBAED,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;oBACnC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,MAAM,CAAC,CAAC,CAAC,CAAC;gBACd,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AA7BD,sDA6BC"}

package/dist/Middleware/Throttle.d.ts

@@ -0,0 +1,17 @@
+import { Request, Response } from '../index';
+import { Middleware } from '../Middleware';
+/**
+ * Simple in-memory rate limiter middleware.
+ */
+export declare class Throttle implements Middleware {
+    private maxAttempts;
+    private windowSeconds;
+    private store;
+    constructor(maxAttempts?: number, windowSeconds?: number);
+    /**
+     * Handle the incoming request.
+     */
+    handle(request: Request, next: (request: Request) => Promise<Response> | Response, response?: Response): Promise<Response>;
+    private cleanup;
+}
+//# sourceMappingURL=Throttle.d.ts.map

package/dist/Middleware/Throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Throttle.d.ts","sourceRoot":"","sources":["../../src/Middleware/Throttle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C;;GAEG;AACH,qBAAa,QAAS,YAAW,UAAU;IAInC,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,aAAa;IAJzB,OAAO,CAAC,KAAK,CAAyC;gBAG1C,WAAW,GAAE,MAAW,EACxB,aAAa,GAAE,MAAW;IAGtC;;OAEG;IACU,MAAM,CACf,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxD,QAAQ,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC;IA0CpB,OAAO,CAAC,OAAO;CAQlB"}

package/dist/Middleware/Throttle.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Throttle = void 0;
+const index_1 = require("../index");
+/**
+ * Simple in-memory rate limiter middleware.
+ */
+class Throttle {
+    constructor(maxAttempts = 60, windowSeconds = 60) {
+        this.maxAttempts = maxAttempts;
+        this.windowSeconds = windowSeconds;
+        this.store = new Map();
+    }
+    /**
+     * Handle the incoming request.
+     */
+    async handle(request, next, response) {
+        const ip = request.ip() || '127.0.0.1';
+        const key = `throttle:${ip}:${request.path()}`;
+        const now = Date.now();
+        const windowMs = this.windowSeconds * 1000;
+        const entry = this.store.get(key);
+        if (entry && now < entry.resetAt) {
+            if (entry.count >= this.maxAttempts) {
+                const retryAfter = Math.ceil((entry.resetAt - now) / 1000);
+                // If it's a 429, we should return early
+                const errorRes = response || new index_1.Response(request.getRaw());
+                errorRes.header('Retry-After', String(retryAfter));
+                errorRes.header('X-RateLimit-Limit', String(this.maxAttempts));
+                errorRes.header('X-RateLimit-Remaining', '0');
+                return errorRes.status(429).json({
+                    message: `Too many requests. Please try again in ${retryAfter} seconds.`,
+                    retry_after: retryAfter
+                });
+            }
+            entry.count++;
+        }
+        else {
+            this.store.set(key, { count: 1, resetAt: now + windowMs });
+        }
+        const res = await next(request);
+        const currentEntry = this.store.get(key);
+        res.header('X-RateLimit-Limit', String(this.maxAttempts));
+        res.header('X-RateLimit-Remaining', String(Math.max(0, this.maxAttempts - currentEntry.count)));
+        // Cleanup expired entries probabilistically
+        if (Math.random() < 0.01) {
+            this.cleanup();
+        }
+        return res;
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.store.entries()) {
+            if (now >= entry.resetAt) {
+                this.store.delete(key);
+            }
+        }
+    }
+}
+exports.Throttle = Throttle;
+//# sourceMappingURL=Throttle.js.map

package/dist/Middleware/Throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Throttle.js","sourceRoot":"","sources":["../../src/Middleware/Throttle.ts"],"names":[],"mappings":"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"}

package/dist/ObjectPool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A high-performance generic object pool.
+ * Prevents repeated memory allocation/GC by recycling objects across requests.
+ *
+ * Strategy: maintain a fixed-size free list (stack). On acquire(), pop a
+ * pre-warmed object and reset its state. On release(), push it back.
+ */
+export declare class ObjectPool<T> {
+    private readonly pool;
+    private readonly maxSize;
+    private readonly factory;
+    private readonly reset;
+    constructor(factory: () => T, reset: (obj: T) => void, poolSize?: number);
+    /**
+     * Acquire an object from the pool (or allocate a new one if the pool is empty).
+     */
+    acquire(): T;
+    /**
+     * Return an object to the pool after resetting its state.
+     */
+    release(obj: T): void;
+    /**
+     * Current number of available objects in the pool.
+     */
+    get available(): number;
+}
+//# sourceMappingURL=ObjectPool.d.ts.map

package/dist/ObjectPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectPool.d.ts","sourceRoot":"","sources":["../src/ObjectPool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,UAAU,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,QAAQ,SAAM;IAYrE;;OAEG;IACH,OAAO,IAAI,CAAC;IAOZ;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAQrB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;CACJ"}

package/dist/ObjectPool.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectPool = void 0;
+/**
+ * A high-performance generic object pool.
+ * Prevents repeated memory allocation/GC by recycling objects across requests.
+ *
+ * Strategy: maintain a fixed-size free list (stack). On acquire(), pop a
+ * pre-warmed object and reset its state. On release(), push it back.
+ */
+class ObjectPool {
+    constructor(factory, reset, poolSize = 512) {
+        this.pool = [];
+        this.factory = factory;
+        this.reset = reset;
+        this.maxSize = poolSize;
+        // Pre-warm the pool — allocate & shape objects at startup so V8
+        // can immediately JIT-compile them into a stable hidden class.
+        for (let i = 0; i < poolSize; i++) {
+            this.pool.push(factory());
+        }
+    }
+    /**
+     * Acquire an object from the pool (or allocate a new one if the pool is empty).
+     */
+    acquire() {
+        if (this.pool.length > 0) {
+            return this.pool.pop();
+        }
+        return this.factory();
+    }
+    /**
+     * Return an object to the pool after resetting its state.
+     */
+    release(obj) {
+        if (this.pool.length < this.maxSize) {
+            this.reset(obj);
+            this.pool.push(obj);
+        }
+        // If pool is full, let the object be GC'd — this is rare at high concurrency.
+    }
+    /**
+     * Current number of available objects in the pool.
+     */
+    get available() {
+        return this.pool.length;
+    }
+}
+exports.ObjectPool = ObjectPool;
+//# sourceMappingURL=ObjectPool.js.map

package/dist/ObjectPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectPool.js","sourceRoot":"","sources":["../src/ObjectPool.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,UAAU;IAMnB,YAAY,OAAgB,EAAE,KAAuB,EAAE,QAAQ,GAAG,GAAG;QALpD,SAAI,GAAQ,EAAE,CAAC;QAM5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QAExB,gEAAgE;QAChE,+DAA+D;QAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,OAAO;QACH,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAG,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAM;QACV,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,8EAA8E;IAClF,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;CACJ;AA7CD,gCA6CC"}

package/dist/Pipeline.d.ts

@@ -0,0 +1,23 @@
+import { Request } from './Request';
+import { Response } from './Response';
+/**
+ * Pipeline executes a stack of middleware for HTTP requests.
+ */
+export declare class Pipeline {
+    private container?;
+    private handlers;
+    constructor(container?: any | undefined);
+    /**
+     * Add middleware to the pipeline.
+     */
+    pipe(middleware: any | any[]): this;
+    /**
+     * Run the pipeline through the given destination.
+     */
+    handle(request: Request, destination: (request: Request, response?: Response) => Promise<Response> | Response, response?: Response): Promise<Response>;
+    /**
+     * Resolve the middleware handler.
+     */
+    private resolve;
+}
+//# sourceMappingURL=Pipeline.d.ts.map

package/dist/Pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../src/Pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,qBAAa,QAAQ;IAGL,OAAO,CAAC,SAAS,CAAC;IAF9B,OAAO,CAAC,QAAQ,CAAa;gBAET,SAAS,CAAC,EAAE,GAAG,YAAA;IAEnC;;OAEG;IACI,IAAI,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI;IAS1C;;OAEG;IACU,MAAM,CACf,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACpF,QAAQ,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC;IAsBpB;;OAEG;IACH,OAAO,CAAC,OAAO;CAgBlB"}