@forklaunch/hyper-express 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 forklaunch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/config.d.ts

@@ -0,0 +1,2 @@
+export declare const basePath = "/testpath";
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,cAAc,CAAC"}

package/lib/config.js

@@ -0,0 +1 @@
+export const basePath = '/testpath';

package/lib/eslint.config.d.mts

@@ -0,0 +1,3 @@
+declare const _default: any[];
+export default _default;
+//# sourceMappingURL=eslint.config.d.mts.map

package/lib/eslint.config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.config.d.mts","sourceRoot":"","sources":["../eslint.config.mjs"],"names":[],"mappings":""}

package/lib/eslint.config.mjs

@@ -0,0 +1,10 @@
+import pluginJs from '@eslint/js';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+export default [
+    { files: ['**/*.{ts}'] },
+    { ignores: ['tests/**/*', 'dist/**/*', 'node_modules/**/*'] },
+    { languageOptions: { globals: globals.browser } },
+    pluginJs.configs.recommended,
+    ...tseslint.configs.recommended
+];

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { Application } from './src/hyperExpressApplication';
+import { Router } from './src/hyperExpressRouter';
+export type App<SV extends AnySchemaValidator> = Application<SV>;
+/**
+ * Creates a new instance of Application with the given schema validator.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {SV} schemaValidator - The schema validator.
+ * @returns {Application<SV>} - The new application instance.
+ */
+export declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidator: SV): Application<SV>;
+/**
+ * Creates a new instance of Router with the given base path and schema validator.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {string} basePath - The base path for the router.
+ * @param {SV} schemaValidator - The schema validator.
+ * @returns {Router<SV>} - The new router instance.
+ */
+export declare function forklaunchRouter<SV extends AnySchemaValidator, BasePath extends `/${string}`>(basePath: BasePath, schemaValidator: SV): Router<SV, BasePath>;
+export * from './src/types/hyperExpress.types';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,MAAM,MAAM,GAAG,CAAC,EAAE,SAAS,kBAAkB,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,kBAAkB,EAC7D,eAAe,EAAE,EAAE,mBAGpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,kBAAkB,EAC7B,QAAQ,SAAS,IAAI,MAAM,EAAE,EAC7B,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAG/D;AAED,cAAc,gCAAgC,CAAC"}

package/lib/index.js

@@ -0,0 +1,25 @@
+import { Application } from './src/hyperExpressApplication';
+import { Router } from './src/hyperExpressRouter';
+/**
+ * Creates a new instance of Application with the given schema validator.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {SV} schemaValidator - The schema validator.
+ * @returns {Application<SV>} - The new application instance.
+ */
+export function forklaunchExpress(schemaValidator) {
+    return new Application(schemaValidator);
+}
+/**
+ * Creates a new instance of Router with the given base path and schema validator.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {string} basePath - The base path for the router.
+ * @param {SV} schemaValidator - The schema validator.
+ * @returns {Router<SV>} - The new router instance.
+ */
+export function forklaunchRouter(basePath, schemaValidator) {
+    const router = new Router(basePath, schemaValidator);
+    return router;
+}
+export * from './src/types/hyperExpress.types';

package/lib/jest.config.d.ts

@@ -0,0 +1,4 @@
+import type { JestConfigWithTsJest } from 'ts-jest';
+declare const jestConfig: JestConfigWithTsJest;
+export default jestConfig;
+//# sourceMappingURL=jest.config.d.ts.map

package/lib/jest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.d.ts","sourceRoot":"","sources":["../jest.config.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,QAAA,MAAM,UAAU,EAAE,oBAkBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/lib/jest.config.js

@@ -0,0 +1,21 @@
+// import type { Config } from 'jest';
+const jestConfig = {
+    // [...]
+    preset: 'ts-jest/presets/default-esm', // or other ESM presets
+    moduleNameMapper: {
+        '^(\\.{1,2}/.*)\\.js$': '$1'
+    },
+    transform: {
+        // '^.+\\.[tj]sx?$' to process ts,js,tsx,jsx with `ts-jest`
+        // '^.+\\.m?[tj]sx?$' to process ts,js,tsx,jsx,mts,mjs,mtsx,mjsx with `ts-jest`
+        '^.+\\.[tj]sx?$': [
+            'ts-jest',
+            {
+                useESM: true
+            }
+        ],
+        '^.+\\.js$': 'babel-jest'
+    },
+    testPathIgnorePatterns: ['.*dist/', '.*node_modules/']
+};
+export default jestConfig;

package/lib/src/hyperExpressApplication.d.ts

@@ -0,0 +1,36 @@
+import { ForklaunchExpressLikeApplication, ForklaunchRouter } from '@forklaunch/core/http';
+import { MiddlewareHandler, Server } from '@forklaunch/hyper-express-fork';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import * as uWebsockets from 'uWebSockets.js';
+/**
+ * Represents an application built on top of Hyper-Express and Forklaunch.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpressLikeApplication<SV, Server> {
+    /**
+     * Creates an instance of the Application class.
+     *
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(schemaValidator: SV);
+    /**
+     * Registers middleware or routers to the application.
+     *
+     * @param {ForklaunchRouter<SV> | MiddlewareHandler<SV> | MiddlewareHandler<SV>[]} router - The router or middleware to register.
+     * @param {...(ForklaunchRouter<SV> | MiddlewareHandler<SV> | MiddlewareHandler<SV>[])} args - Additional arguments.
+     * @returns {this} - The application instance.
+     */
+    use(router: ForklaunchRouter<SV> | MiddlewareHandler | MiddlewareHandler[], ...args: (ForklaunchRouter<SV> | MiddlewareHandler | MiddlewareHandler[])[]): this;
+    /**
+     * Starts the server and sets up Swagger documentation.
+     *
+     * @param {string | number} arg0 - The port number or UNIX path to listen on.
+     * @param {...unknown[]} args - Additional arguments.
+     * @returns {Promise<uWebsockets.us_listen_socket>} - A promise that resolves with the listening socket.
+     */
+    listen(port: number, callback?: (listen_socket: uWebsockets.us_listen_socket) => void): Promise<uWebsockets.us_listen_socket>;
+    listen(port: number, host?: string, callback?: (listen_socket: uWebsockets.us_listen_socket) => void): Promise<uWebsockets.us_listen_socket>;
+    listen(unix_path: string, callback?: (listen_socket: uWebsockets.us_listen_socket) => void): Promise<uWebsockets.us_listen_socket>;
+}
+//# sourceMappingURL=hyperExpressApplication.d.ts.map

package/lib/src/hyperExpressApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperExpressApplication.d.ts","sourceRoot":"","sources":["../../src/hyperExpressApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAI9C;;;;GAIG;AACH,qBAAa,WAAW,CACtB,EAAE,SAAS,kBAAkB,CAC7B,SAAQ,gCAAgC,CAAC,EAAE,EAAE,MAAM,CAAC;IACpD;;;;OAIG;gBACS,eAAe,EAAE,EAAE;IAI/B;;;;;;OAMG;IACH,GAAG,CACD,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,EACtE,GAAG,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAAC,EAAE,GAC1E,IAAI;IA0BP;;;;;;OAMG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,gBAAgB,KAAK,IAAI,GAC/D,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;IACxC,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,gBAAgB,KAAK,IAAI,GAC/D,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;IACxC,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,gBAAgB,KAAK,IAAI,GAC/D,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC;CA0CzC"}

package/lib/src/hyperExpressApplication.js

@@ -0,0 +1,69 @@
+import { ForklaunchExpressLikeApplication, generateSwaggerDocument } from '@forklaunch/core/http';
+import { Server } from '@forklaunch/hyper-express-fork';
+import { Router } from './hyperExpressRouter';
+import { swagger, swaggerRedirect } from './middleware/swagger.middleware';
+/**
+ * Represents an application built on top of Hyper-Express and Forklaunch.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export class Application extends ForklaunchExpressLikeApplication {
+    /**
+     * Creates an instance of the Application class.
+     *
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(schemaValidator) {
+        super(schemaValidator, new Server());
+    }
+    /**
+     * Registers middleware or routers to the application.
+     *
+     * @param {ForklaunchRouter<SV> | MiddlewareHandler<SV> | MiddlewareHandler<SV>[]} router - The router or middleware to register.
+     * @param {...(ForklaunchRouter<SV> | MiddlewareHandler<SV> | MiddlewareHandler<SV>[])} args - Additional arguments.
+     * @returns {this} - The application instance.
+     */
+    use(router, ...args) {
+        if (router instanceof Router) {
+            this.routers.push(router);
+            this.internal.use(router.basePath, router.internal);
+            return this;
+        }
+        else {
+            const router = args.pop();
+            if (!(router instanceof Router)) {
+                throw new Error('Last argument must be a router');
+            }
+            args.forEach((arg) => {
+                if (arg instanceof Router) {
+                    throw new Error('Only one router is allowed');
+                }
+            });
+            this.internal.use(router.basePath, ...args, router.internal);
+            return this;
+        }
+    }
+    listen(arg0, arg1, arg2) {
+        if (typeof arg0 === 'number') {
+            const port = arg0 || Number(process.env.PORT);
+            this.internal.set_error_handler((_req, res, err) => {
+                res.locals.errorMessage = err.message;
+                // TODO: replace with logger
+                console.error(err);
+                res
+                    .status(res.statusCode && res.statusCode >= 400 ? res.statusCode : 500)
+                    .send(`Internal server error:\n\n${err.message}`);
+            });
+            const swaggerPath = `/api${process.env.VERSION ?? '/v1'}${process.env.SWAGGER_PATH ?? '/swagger'}`;
+            this.internal.use(swaggerPath, swaggerRedirect(swaggerPath));
+            this.internal.get(`${swaggerPath}/*`, swagger(swaggerPath, generateSwaggerDocument(this.schemaValidator, port, this.routers)));
+            if (arg1 && typeof arg1 === 'string') {
+                return this.internal.listen(port, arg1, arg2);
+            }
+            else if (arg1 && typeof arg1 === 'function') {
+                return this.internal.listen(port, arg1);
+            }
+        }
+        return this.internal.listen(arg0, arg1);
+    }
+}

package/lib/src/hyperExpressRouter.d.ts

@@ -0,0 +1,10 @@
+import { ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
+import { Router as ExpressRouter, MiddlewareHandler } from '@forklaunch/hyper-express-fork';
+import { AnySchemaValidator } from '@forklaunch/validator';
+export declare class Router<SV extends AnySchemaValidator, BasePath extends `/${string}`> extends ForklaunchExpressLikeRouter<SV, BasePath, MiddlewareHandler, ExpressRouter> implements ForklaunchRouter<SV> {
+    basePath: BasePath;
+    constructor(basePath: BasePath, schemaValidator: SV);
+    route(path: string): this;
+    any: TypedMiddlewareDefinition<this, SV>;
+}
+//# sourceMappingURL=hyperExpressRouter.d.ts.map

package/lib/src/hyperExpressRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperExpressRouter.d.ts","sourceRoot":"","sources":["../../src/hyperExpressRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,2BAA2B,EAC3B,gBAAgB,EAMhB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,MAAM,IAAI,aAAa,EACvB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM3D,qBAAa,MAAM,CACf,EAAE,SAAS,kBAAkB,EAC7B,QAAQ,SAAS,IAAI,MAAM,EAAE,CAE/B,SAAQ,2BAA2B,CACjC,EAAE,EACF,QAAQ,EACR,iBAAiB,EACjB,aAAa,CAEf,YAAW,gBAAgB,CAAC,EAAE,CAAC;IAGtB,QAAQ,EAAE,QAAQ;gBAAlB,QAAQ,EAAE,QAAQ,EACzB,eAAe,EAAE,EAAE;IAWrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,GAAG,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEtC;CAKH"}

package/lib/src/hyperExpressRouter.js

@@ -0,0 +1,22 @@
+import { ForklaunchExpressLikeRouter } from '@forklaunch/core/http';
+import { Router as ExpressRouter } from '@forklaunch/hyper-express-fork';
+import { contentParse } from './middleware/contentParse.middleware';
+import { enrichResponseTransmission } from './middleware/enrichResponseTransmission.middleware';
+import { polyfillGetHeaders } from './middleware/polyfillGetHeaders.middleware';
+export class Router extends ForklaunchExpressLikeRouter {
+    basePath;
+    constructor(basePath, schemaValidator) {
+        super(basePath, schemaValidator, new ExpressRouter());
+        this.basePath = basePath;
+        this.internal.use(polyfillGetHeaders);
+        this.internal.use(contentParse);
+        this.internal.use(enrichResponseTransmission);
+    }
+    route(path) {
+        this.internal.route(path);
+        return this;
+    }
+    any = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.any, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+}

package/lib/src/middleware/contentParse.middleware.d.ts

@@ -0,0 +1,8 @@
+import { Request } from '@forklaunch/hyper-express-fork';
+/**
+ * Middleware function to parse the request body based on the content type.
+ *
+ * @returns {Function} - The middleware function.
+ */
+export declare function contentParse(req: Request): Promise<void>;
+//# sourceMappingURL=contentParse.middleware.d.ts.map

package/lib/src/middleware/contentParse.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentParse.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/contentParse.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,iBAsB9C"}

package/lib/src/middleware/contentParse.middleware.js

@@ -0,0 +1,26 @@
+/**
+ * Middleware function to parse the request body based on the content type.
+ *
+ * @returns {Function} - The middleware function.
+ */
+export async function contentParse(req) {
+    console.debug('[MIDDLEWARE] contentParse started');
+    switch (req.headers['content-type'] &&
+        req.headers['content-type'].split(';')[0]) {
+        case 'application/json':
+            req.body = await req.json();
+            break;
+        case 'application/x-www-form-urlencoded':
+            req.body = await req.urlencoded();
+            break;
+        case 'text/plain':
+            req.body = await req.text();
+            break;
+        case 'application/octet-stream':
+            req.body = await req.buffer();
+            break;
+        default:
+            req.body = await req.json();
+            break;
+    }
+}

package/lib/src/middleware/enrichResponseTransmission.middleware.d.ts

@@ -0,0 +1,14 @@
+import { ForklaunchNextFunction, ParamsDictionary } from '@forklaunch/core/http';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ParsedQs } from 'qs';
+import { Request, Response } from '../types/hyperExpress.types';
+/**
+ * Middleware to enrich the response transmission by intercepting and parsing responses before they are sent.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {Request<SV>} req - The request object.
+ * @param {Response} res - The response object.
+ * @param {MiddlewareNext} next - The next middleware function.
+ */
+export declare function enrichResponseTransmission<SV extends AnySchemaValidator>(req: Request<SV, ParamsDictionary, Record<string, unknown>, ParsedQs, Record<string, string>, Record<string, unknown>>, res: Response<Record<number, unknown>, Record<string, string>, Record<string, unknown>>, next: ForklaunchNextFunction): void;
+//# sourceMappingURL=enrichResponseTransmission.middleware.d.ts.map

package/lib/src/middleware/enrichResponseTransmission.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichResponseTransmission.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/enrichResponseTransmission.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,SAAS,kBAAkB,EACtE,GAAG,EAAE,OAAO,CACV,EAAE,EACF,gBAAgB,EAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,QAAQ,EACR,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB,EACD,GAAG,EAAE,QAAQ,CACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB,EACD,IAAI,EAAE,sBAAsB,QA6D7B"}

package/{dist/middleware/response.middleware.js → lib/src/middleware/enrichResponseTransmission.middleware.js}

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.enrichResponseTransmission = enrichResponseTransmission;
-const core_1 = require("@forklaunch/core");
+import { enrichExpressLikeSend } from '@forklaunch/core/http';
 /**
  * Middleware to enrich the response transmission by intercepting and parsing responses before they are sent.
  *
@@ -10,9 +7,11 @@ const core_1 = require("@forklaunch/core");
  * @param {Response} res - The response object.
  * @param {MiddlewareNext} next - The next middleware function.
  */
-function enrichResponseTransmission(req, res, next) {
+export function enrichResponseTransmission(req, res, next) {
+    console.debug('[MIDDLEWARE] enrichResponseTransmission');
     const originalSend = res.send;
     const originalJson = res.json;
+    const originalSetHeader = res.setHeader;
     /**
      * Intercepts the JSON response to include additional processing.
      *
@@ -34,21 +33,24 @@ function enrichResponseTransmission(req, res, next) {
         if (!res.bodyData) {
             res.bodyData = data;
             res.statusCode = res._status_code;
-            res.corked = res._corked;
         }
-        try {
-            if ((res._cork && !res.corked) || !res._cork) {
-                (0, core_1.parseResponse)(req, res);
-            }
-            return originalSend.call(this, data);
+        return enrichExpressLikeSend(this, req, res, originalSend, data, !res.cors && ((res._cork && !res._corked) || !res._cork));
+    };
+    /**
+     * Intercepts the setHeader method to stringify the value before setting the header.
+     *
+     * @param {string}
+     */
+    res.setHeader = function (name, value) {
+        let stringifiedValue;
+        if (Array.isArray(value)) {
+            stringifiedValue = value.map((v) => typeof v !== 'string' ? JSON.stringify(v) : v);
         }
-        catch (error) {
-            console.error(error);
-            res.status(500);
-            originalSend.call(this, 'Internal Server Error: ' + error.message);
-            throw error;
+        else {
+            stringifiedValue =
+                typeof value !== 'string' ? JSON.stringify(value) : value;
         }
+        return originalSetHeader.call(this, name, stringifiedValue);
     };
     next();
 }
-//# sourceMappingURL=response.middleware.js.map

package/lib/src/middleware/polyfillGetHeaders.middleware.d.ts

@@ -0,0 +1,3 @@
+import { MiddlewareNext, Request, Response } from '@forklaunch/hyper-express-fork';
+export declare function polyfillGetHeaders(_req: Request, res: Response, next?: MiddlewareNext): void;
+//# sourceMappingURL=polyfillGetHeaders.middleware.d.ts.map

package/lib/src/middleware/polyfillGetHeaders.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfillGetHeaders.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/polyfillGetHeaders.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,OAAO,EACP,QAAQ,EACT,MAAM,gCAAgC,CAAC;AAGxC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,cAAc,QAOtB"}

package/lib/src/middleware/polyfillGetHeaders.middleware.js

@@ -0,0 +1,8 @@
+// TODO: Move into fork, and create gh issue
+export function polyfillGetHeaders(_req, res, next) {
+    console.debug('[MIDDLEWARE] polyfillGetHeaders started');
+    res.getHeaders = () => {
+        return res._headers;
+    };
+    next?.();
+}

package/{dist → lib/src}/middleware/swagger.middleware.d.ts

@@ -1,4 +1,4 @@
-import { MiddlewareHandler } from 'hyper-express';
+import { MiddlewareHandler } from '@forklaunch/hyper-express-fork';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
 import swaggerUi from 'swagger-ui-express';
 /**
@@ -22,3 +22,4 @@ export declare function swaggerRedirect(path: string): MiddlewareHandler;
  * @returns {MiddlewareHandler[]} - An array of middleware handlers for serving the Swagger UI.
  */
 export declare function swagger(path: string, document: OpenAPIObject, opts?: swaggerUi.SwaggerUiOptions, options?: swaggerUi.SwaggerOptions, customCss?: string, customfavIcon?: string, swaggerUrl?: string, customSiteTitle?: string): MiddlewareHandler[];
+//# sourceMappingURL=swagger.middleware.d.ts.map

package/lib/src/middleware/swagger.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/swagger.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAIlB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EACvB,IAAI,CAAC,EAAE,SAAS,CAAC,gBAAgB,EACjC,OAAO,CAAC,EAAE,SAAS,CAAC,cAAc,EAClC,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,iBAAiB,EAAE,CA+DrB"}

package/{dist → lib/src}/middleware/swagger.middleware.js

@@ -1,27 +1,18 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.swaggerRedirect = swaggerRedirect;
-exports.swagger = swagger;
-const live_directory_1 = __importDefault(require("live-directory"));
-const absolute_path_1 = __importDefault(require("swagger-ui-dist/absolute-path"));
-const swagger_ui_express_1 = __importDefault(require("swagger-ui-express"));
+import LiveDirectory from 'live-directory';
+import getAbsoluteSwaggerFsPath from 'swagger-ui-dist/absolute-path';
+import swaggerUi from 'swagger-ui-express';
 /**
  * Middleware to redirect requests to the Swagger UI base path.
  *
  * @param {string} path - The base path for the Swagger UI.
  * @returns {MiddlewareHandler} - The middleware handler for redirecting requests.
  */
-function swaggerRedirect(path) {
+export function swaggerRedirect(path) {
     return (req, res, next) => {
         if (req.path === path) {
             res.redirect(`${path}/`);
         }
-        if (next) {
-            return next();
-        }
+        return next?.();
     };
 }
 /**
@@ -37,8 +28,8 @@ function swaggerRedirect(path) {
  * @param {string} [customSiteTitle] - Custom site title for the Swagger UI.
  * @returns {MiddlewareHandler[]} - An array of middleware handlers for serving the Swagger UI.
  */
-function swagger(path, document, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle) {
-    const LiveAssets = new live_directory_1.default((0, absolute_path_1.default)(), {
+export function swagger(path, document, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle) {
+    const LiveAssets = new LiveDirectory(getAbsoluteSwaggerFsPath(), {
         filter: {
             keep: {
                 names: [
@@ -56,7 +47,7 @@ function swagger(path, document, opts, options, customCss, customfavIcon, swagge
             max_file_size: 1024 * 1024 * 1.5
         }
     });
-    const serve = swagger_ui_express_1.default.serve[0];
+    const serve = swaggerUi.serve[0];
     /**
      * Middleware to serve static assets for the Swagger UI.
      *
@@ -84,7 +75,6 @@ function swagger(path, document, opts, options, customCss, customfavIcon, swagge
             return res.type(extension).stream(content);
         }
     };
-    const ui = swagger_ui_express_1.default.setup(document, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle);
+    const ui = swaggerUi.setup(document, opts, options, customCss, customfavIcon, swaggerUrl, customSiteTitle);
     return [serve, staticAssets, ui];
 }
-//# sourceMappingURL=swagger.middleware.js.map

package/lib/src/types/hyperExpress.types.d.ts

@@ -0,0 +1,42 @@
+import { ForklaunchRequest, ForklaunchResponse, ForklaunchSendableData, ForklaunchStatusResponse, ParamsDictionary } from '@forklaunch/core/http';
+import { Request as ExpressRequest, Response as ExpressResponse } from '@forklaunch/hyper-express-fork';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ParsedQs } from 'qs';
+/**
+ * Extends the Forklaunch request interface with properties from Hyper-Express's request interface.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template P - A type for request parameters, defaulting to ParamsDictionary.
+ * @template _ResBody - A type for the response body, defaulting to unknown.
+ * @template ReqBody - A type for the request body, defaulting to unknown.
+ * @template ReqQuery - A type for the request query, defaulting to ParsedQs.
+ * @template LocalsObj - A type for local variables, defaulting to an empty object.
+ */
+export interface Request<SV extends AnySchemaValidator, P extends ParamsDictionary, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>> extends ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, Omit<ExpressRequest<LocalsObj>, 'method' | 'params' | 'query' | 'headers'> {
+    /** The request body */
+    body: ReqBody;
+    /** The request query parameters */
+    query: ReqQuery;
+    /** The request parameters */
+    params: P;
+}
+/**
+ * Extends the Forklaunch response interface with properties from Hyper-Express's response interface.
+ *
+ * @template ResBody - A type for the response body, defaulting to unknown.
+ * @template LocalsObj - A type for local variables, defaulting to an empty object.
+ * @template StatusCode - A type for the status code, defaulting to number.
+ */
+export interface Response<ResBodyMap extends Record<number, unknown>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>> extends ForklaunchResponse<ResBodyMap, ResHeaders, LocalsObj>, Omit<ExpressResponse<LocalsObj>, 'getHeaders' | 'setHeader' | 'headersSent' | 'send' | 'status' | 'statusCode' | 'json' | 'jsonp' | 'end'>, ForklaunchStatusResponse<ForklaunchSendableData> {
+    /** The body data of the response */
+    bodyData: unknown;
+    /** If cors are applied to the response */
+    cors: boolean;
+    /** The status code of the response */
+    _status_code: number;
+    /** Whether the response is corked */
+    _cork: boolean;
+    /** Whether the response is currently corked */
+    _corked: boolean;
+}
+//# sourceMappingURL=hyperExpress.types.d.ts.map

package/lib/src/types/hyperExpress.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperExpress.types.d.ts","sourceRoot":"","sources":["../../../src/types/hyperExpress.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,QAAQ,IAAI,eAAe,EAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO,CACtB,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,gBAAgB,EAC1B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,SAAS,QAAQ,EACzB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACzC,SAAQ,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC7D,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5E,uBAAuB;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,QAAQ,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ,CACvB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACzC,SAAQ,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,EAC3D,IAAI,CACF,eAAe,CAAC,SAAS,CAAC,EACxB,YAAY,GACZ,WAAW,GACX,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,OAAO,GACP,KAAK,CACR,EACD,wBAAwB,CAAC,sBAAsB,CAAC;IAClD,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/lib/tests/typebox.forklaunch.hyperExpress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typebox.forklaunch.hyperExpress.test.d.ts.map

package/lib/tests/typebox.forklaunch.hyperExpress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.forklaunch.hyperExpress.test.d.ts","sourceRoot":"","sources":["../../tests/typebox.forklaunch.hyperExpress.test.ts"],"names":[],"mappings":""}