@forklaunch/express 0.1.0 → 0.1.1

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/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,22 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { Application } from './src/expressApplication';
+import { Router } from './src/expressRouter';
+/**
+ * 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/express.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,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C;;;;;;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,2BAA2B,CAAC"}

package/lib/index.js

@@ -0,0 +1,25 @@
+import { Application } from './src/expressApplication';
+import { Router } from './src/expressRouter';
+/**
+ * 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/express.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/expressApplication.d.ts

@@ -0,0 +1,37 @@
+import { ForklaunchExpressLikeApplication, ForklaunchRouter } from '@forklaunch/core/http';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { Express, RequestHandler } from 'express';
+import { Server } from 'http';
+/**
+ * Application class that sets up an Express server with Forklaunch routers and middleware.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpressLikeApplication<SV, Express> {
+    /**
+     * Creates an instance of Application.
+     *
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(schemaValidator: SV);
+    /**
+     * Registers middleware or routers to the application.
+     *
+     * @param {...(ForklaunchRouter<SV> | RequestHandler)[]} args - The middleware or routers to register.
+     * @returns {this} - The application instance.
+     */
+    use(router: ForklaunchRouter<SV> | RequestHandler, ...args: (ForklaunchRouter<SV> | RequestHandler)[]): this;
+    /**
+     * Starts the server and sets up Swagger documentation.
+     *
+     * @param {...unknown[]} args - The arguments to pass to the listen method.
+     * @returns {Server} - The HTTP server.
+     */
+    listen(port: number, hostname: string, backlog: number, callback?: () => void): Server;
+    listen(port: number, hostname: string, callback?: () => void): Server;
+    listen(port: number, callback?: () => void): Server;
+    listen(callback?: () => void): Server;
+    listen(path: string, callback?: () => void): Server;
+    listen(handle: unknown, listeningListener?: () => void): Server;
+}
+//# sourceMappingURL=expressApplication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expressApplication.d.ts","sourceRoot":"","sources":["../../src/expressApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAgB,EAAuB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAI9B;;;;GAIG;AACH,qBAAa,WAAW,CACtB,EAAE,SAAS,kBAAkB,CAC7B,SAAQ,gCAAgC,CAAC,EAAE,EAAE,OAAO,CAAC;IACrD;;;;OAIG;gBACS,eAAe,EAAE,EAAE;IAK/B;;;;;OAKG;IACH,GAAG,CACD,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,cAAc,EAC7C,GAAG,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,EAAE,GACjD,IAAI;IA0BP;;;;;OAKG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,MAAM;IACT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM;IACnD,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM;IACnD,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM;CAuBhE"}

package/lib/src/expressApplication.js

@@ -0,0 +1,60 @@
+import { ForklaunchExpressLikeApplication, generateSwaggerDocument } from '@forklaunch/core/http';
+import express from 'express';
+import swaggerUi from 'swagger-ui-express';
+import { Router } from './expressRouter';
+/**
+ * Application class that sets up an Express server with Forklaunch routers and middleware.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export class Application extends ForklaunchExpressLikeApplication {
+    /**
+     * Creates an instance of Application.
+     *
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(schemaValidator) {
+        super(schemaValidator, express());
+    }
+    //TODO: change this to different signatures and handle different cases
+    /**
+     * Registers middleware or routers to the application.
+     *
+     * @param {...(ForklaunchRouter<SV> | RequestHandler)[]} args - The middleware or routers to register.
+     * @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(...args) {
+        const port = typeof args[0] === 'number' ? args[0] : Number(process.env.PORT);
+        this.internal.use(`/api${process.env.VERSION ?? '/v1'}${process.env.SWAGGER_PATH ?? '/swagger'}`, swaggerUi.serve, swaggerUi.setup(generateSwaggerDocument(this.schemaValidator, port, this.routers)));
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const errorHandler = (err, _req, res, _next) => {
+            console.error(err);
+            res.locals.errorMessage = err.message;
+            res
+                .status(res.statusCode && res.statusCode >= 400 ? res.statusCode : 500)
+                .send(`Internal server error:\n\n${err.message}`);
+        };
+        this.internal.use(errorHandler);
+        return this.internal.listen(...args);
+    }
+}

package/lib/src/expressRouter.d.ts

@@ -0,0 +1,46 @@
+import { ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
+import { AnySchemaValidator, IdiomaticSchema, LiteralSchema, SchemaResolve } from '@forklaunch/validator';
+import { Router as ExpressRouter, NextFunction, RequestHandler } from 'express';
+/**
+ * Router class that sets up routes and middleware for an Express router.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @implements {ForklaunchRouter<SV>}
+ */
+export declare class Router<SV extends AnySchemaValidator, BasePath extends `/${string}`> extends ForklaunchExpressLikeRouter<SV, BasePath, RequestHandler, ExpressRouter> implements ForklaunchRouter<SV> {
+    basePath: BasePath;
+    /**
+     * Creates an instance of Router.
+     *
+     * @param {string} basePath - The base path for the router.
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(basePath: BasePath, schemaValidator: SV);
+    route(path: string): this;
+    param<ParamName extends string, Types extends {
+        req?: LiteralSchema | SV['_SchemaCatchall'];
+        res?: IdiomaticSchema<SV>;
+    } & {
+        [K in ParamName]: IdiomaticSchema<SV>;
+    }>(name: ParamName, types: Types, handler: (req: SchemaResolve<Types['req']>, res: SchemaResolve<Types['res']>, next: NextFunction, value: SchemaResolve<Types[ParamName]>, name: ParamName) => void): this;
+    checkout: TypedMiddlewareDefinition<this, SV>;
+    copy: TypedMiddlewareDefinition<this, SV>;
+    lock: TypedMiddlewareDefinition<this, SV>;
+    merge: TypedMiddlewareDefinition<this, SV>;
+    mkcactivity: TypedMiddlewareDefinition<this, SV>;
+    mkcol: TypedMiddlewareDefinition<this, SV>;
+    move: TypedMiddlewareDefinition<this, SV>;
+    'm-search': TypedMiddlewareDefinition<this, SV>;
+    notify: TypedMiddlewareDefinition<this, SV>;
+    propfind: TypedMiddlewareDefinition<this, SV>;
+    proppatch: TypedMiddlewareDefinition<this, SV>;
+    purge: TypedMiddlewareDefinition<this, SV>;
+    report: TypedMiddlewareDefinition<this, SV>;
+    search: TypedMiddlewareDefinition<this, SV>;
+    subscribe: TypedMiddlewareDefinition<this, SV>;
+    unlock: TypedMiddlewareDefinition<this, SV>;
+    unsubscribe: TypedMiddlewareDefinition<this, SV>;
+    link: TypedMiddlewareDefinition<this, SV>;
+    unlink: TypedMiddlewareDefinition<this, SV>;
+}
+//# sourceMappingURL=expressRouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expressRouter.d.ts","sourceRoot":"","sources":["../../src/expressRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,2BAA2B,EAC3B,gBAAgB,EAMhB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAgB,EACd,MAAM,IAAI,aAAa,EACvB,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,qBAAa,MAAM,CACf,EAAE,SAAS,kBAAkB,EAC7B,QAAQ,SAAS,IAAI,MAAM,EAAE,CAE/B,SAAQ,2BAA2B,CACjC,EAAE,EACF,QAAQ,EACR,cAAc,EACd,aAAa,CAEf,YAAW,gBAAgB,CAAC,EAAE,CAAC;IAStB,QAAQ,EAAE,QAAQ;IAP3B;;;;;OAKG;gBAEM,QAAQ,EAAE,QAAQ,EACzB,eAAe,EAAE,EAAE;IAQrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,KAAK,CACH,SAAS,SAAS,MAAM,EACxB,KAAK,SAAS;QACZ,GAAG,CAAC,EAAE,aAAa,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAC5C,GAAG,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;KAC3B,GAAG;SACD,CAAC,IAAI,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;KACtC,EAED,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,CACP,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAChC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EACtC,IAAI,EAAE,SAAS,KACZ,IAAI,GACR,IAAI;IAcP,QAAQ,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE3C;IAEF,IAAI,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEvC;IAEF,IAAI,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEvC;IAEF,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgExC;IAEF,WAAW,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE9C;IAEF,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgExC;IAEF,IAAI,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEvC;IAEF,UAAU,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE7C;IAEF,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEzC;IAEF,QAAQ,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE3C;IAEF,SAAS,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE5C;IAEF,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgExC;IAEF,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEzC;IAEF,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEzC;IAEF,SAAS,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE5C;IAEF,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEzC;IAEF,WAAW,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgE9C;IAEF,IAAI,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEvC;IAEF,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,EAAE,CAAC,CAgEzC;CACH"}

package/lib/src/expressRouter.js

@@ -0,0 +1,91 @@
+import { ForklaunchExpressLikeRouter } from '@forklaunch/core/http';
+import express from 'express';
+import { enrichResponseTransmission } from './middleware/response.middleware';
+/**
+ * Router class that sets up routes and middleware for an Express router.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @implements {ForklaunchRouter<SV>}
+ */
+export class Router extends ForklaunchExpressLikeRouter {
+    basePath;
+    /**
+     * Creates an instance of Router.
+     *
+     * @param {string} basePath - The base path for the router.
+     * @param {SV} schemaValidator - The schema validator.
+     */
+    constructor(basePath, schemaValidator) {
+        super(basePath, schemaValidator, express.Router());
+        this.basePath = basePath;
+        this.internal.use(express.json());
+        this.internal.use(enrichResponseTransmission);
+    }
+    route(path) {
+        this.internal.route(path);
+        return this;
+    }
+    param(name, types, handler) {
+        this.internal.param(name, (req, res, next, value, name) => {
+            handler(req, res, next, value, name);
+        });
+        return this;
+    }
+    checkout = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.checkout, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    copy = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.copy, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    lock = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.lock, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    merge = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.merge, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    mkcactivity = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.mkactivity, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    mkcol = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.mkcol, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    move = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.move, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    'm-search' = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal['m-search'], pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    notify = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.notify, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    propfind = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.propfind, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    proppatch = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.proppatch, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    purge = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.purge, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    report = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.report, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    search = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.search, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    subscribe = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.subscribe, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    unlock = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.unlock, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    unsubscribe = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.unsubscribe, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    link = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.link, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+    unlink = (pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler) => {
+        return this.registerMiddlewareHandler(this.internal.unlink, pathOrContractDetailsOrMiddlewareOrTypedHandler, contractDetailsOrMiddlewareOrTypedHandler, ...middlewareOrMiddlewareWithTypedHandler);
+    };
+}

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

@@ -0,0 +1,16 @@
+import { RequestHandler } from 'express';
+/**
+ * Wraps an asynchronous middleware function to handle errors and pass them to the next middleware.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template P - A type for request parameters, defaulting to ParamsDictionary.
+ * @template ResBodyMap - 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.
+ * @template StatusCode - A type for the status code, defaulting to number.
+ * @param {RequestHandler} fn - The asynchronous middleware function to wrap.
+ * @returns {RequestHandler} - The wrapped middleware function.
+ */
+export declare function asyncMiddleware(fn: RequestHandler): RequestHandler;
+//# sourceMappingURL=async.middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"async.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/async.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,cAAc,CAKlE"}

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

@@ -1,25 +1,19 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.asyncMiddleware = asyncMiddleware;
 /**
  * Wraps an asynchronous middleware function to handle errors and pass them to the next middleware.
  *
  * @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 ResBodyMap - 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.
  * @template StatusCode - A type for the status code, defaulting to number.
- * @param {RequestHandler<SV, P, ResBody, ReqBody, ReqQuery, LocalsObj, StatusCode>} fn - The asynchronous middleware function to wrap.
- * @returns {RequestHandler<SV, P, ResBody, ReqBody, ReqQuery, LocalsObj, StatusCode>} - The wrapped middleware function.
+ * @param {RequestHandler} fn - The asynchronous middleware function to wrap.
+ * @returns {RequestHandler} - The wrapped middleware function.
  */
-function asyncMiddleware(fn) {
+export function asyncMiddleware(fn) {
     return async (req, res, next) => {
         await Promise.resolve(fn(req, res, next)).catch(next);
-        if (next) {
-            next();
-        }
+        next?.();
     };
 }
-//# sourceMappingURL=async.middleware.js.map

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

@@ -1,6 +1,8 @@
+import { ParamsDictionary } from '@forklaunch/core/http';
 import { AnySchemaValidator } from '@forklaunch/validator';
 import { NextFunction } from 'express';
-import { Request, Response } from '../types/forklaunch.express.types';
+import { ParsedQs } from 'qs';
+import { Request, Response } from '../types/express.types';
 /**
  * Middleware to enrich the response transmission by intercepting and parsing responses before they are sent.
  *
@@ -9,4 +11,5 @@ import { Request, Response } from '../types/forklaunch.express.types';
  * @param {Response} res - The response object.
  * @param {NextFunction} [next] - The next middleware function.
  */
-export declare function enrichResponseTransmission<SV extends AnySchemaValidator>(req: Request<SV>, res: Response, next?: NextFunction): void;
+export declare function enrichResponseTransmission<SV extends AnySchemaValidator>(req: Request<SV, ParamsDictionary, Record<number, unknown>, Record<string, unknown>, ParsedQs, Record<string, string>, Record<string, unknown>>, res: Response<Record<number, unknown>, Record<string, string>, Record<string, unknown>>, next?: NextFunction): void;
+//# sourceMappingURL=response.middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/response.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,SAAS,kBAAkB,EACtE,GAAG,EAAE,OAAO,CACV,EAAE,EACF,gBAAgB,EAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,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,CAAC,EAAE,YAAY,QAsDpB"}

package/{dist → lib/src}/middleware/response.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,10 @@ const core_1 = require("@forklaunch/core");
  * @param {Response} res - The response object.
  * @param {NextFunction} [next] - The next middleware function.
  */
-function enrichResponseTransmission(req, res, next) {
+export function enrichResponseTransmission(req, res, next) {
     const originalSend = res.send;
     const originalJson = res.json;
+    const originalSetHeader = res.setHeader;
     /**
      * Intercepts the JSON response to include additional processing.
      *
@@ -22,8 +20,7 @@ function enrichResponseTransmission(req, res, next) {
      */
     res.json = function (data) {
         res.bodyData = data;
-        const result = originalJson.call(this, data);
-        return result;
+        return originalJson.call(this, data);
     };
     /**
      * Intercepts the send response to include additional processing and error handling.
@@ -35,22 +32,23 @@ function enrichResponseTransmission(req, res, next) {
         if (!res.bodyData) {
             res.bodyData = data;
         }
-        try {
-            (0, core_1.parseResponse)(req, res);
-            const result = originalSend.call(this, data);
-            return result;
+        return enrichExpressLikeSend(this, req, res, originalSend, data, !res.cors);
+    };
+    /**
+     * 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);
-            if (next) {
-                next(error);
-            }
+        else {
+            stringifiedValue =
+                typeof value !== 'string' ? JSON.stringify(value) : value;
         }
+        return originalSetHeader.call(this, name, stringifiedValue);
     };
-    if (next) {
-        next();
-    }
+    next?.();
 }
-//# sourceMappingURL=response.middleware.js.map

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

@@ -0,0 +1,28 @@
+import { ForklaunchRequest, ForklaunchResponse, ForklaunchSendableData, ForklaunchStatusResponse, ParamsDictionary } from '@forklaunch/core/http';
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { Request as ExpressRequest, Response as ExpressResponse } from 'express';
+import { ParsedQs } from 'qs';
+/**
+ * Extends the Forklaunch request interface with properties from Express's request interface.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template P - A type for request parameters, defaulting to ParamsDictionary.
+ * @template ResBodyMap - 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, ResBodyMap extends Record<number, unknown>, 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<P, ResBodyMap, ReqBody, ReqQuery, LocalsObj>, 'method' | 'body' | 'params' | 'query' | 'headers'> {
+}
+/**
+ * Extends the Forklaunch response interface with properties from Express's response interface.
+ *
+ * @template ResBodyMap - 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> = Record<string, unknown>> extends ForklaunchResponse<ResBodyMap, ResHeaders, LocalsObj>, Omit<ExpressResponse<ResBodyMap, LocalsObj>, 'status' | 'statusCode' | 'sendStatus' | 'getHeaders' | 'setHeader' | 'send' | 'json' | 'jsonp' | 'end' | 'locals'>, ForklaunchStatusResponse<ForklaunchSendableData> {
+    /** If cors are applied to the response */
+    cors: boolean;
+}
+//# sourceMappingURL=express.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.types.d.ts","sourceRoot":"","sources":["../../../src/types/express.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,QAAQ,IAAI,eAAe,EAC5B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO,CACtB,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,gBAAgB,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,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,CACF,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,EAC3D,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CACnD;CAAG;AAER;;;;;;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,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACnE,SAAQ,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,EAC3D,IAAI,CACF,eAAe,CAAC,UAAU,EAAE,SAAS,CAAC,EACpC,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,QAAQ,CACX,EACD,wBAAwB,CAAC,sBAAsB,CAAC;IAClD,0CAA0C;IAC1C,IAAI,EAAE,OAAO,CAAC;CACf"}

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

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

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

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