@forklaunch/express 0.4.11 → 0.5.0

package/lib/index.d.mts

@@ -1,6 +1,8 @@
 import * as _forklaunch_core_http from '@forklaunch/core/http';
 import { ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
 import { AnySchemaValidator, LiteralSchema, IdiomaticSchema, SchemaResolve } from '@forklaunch/validator';
+import { OptionsText, OptionsJson, OptionsUrlencoded } from 'body-parser';
+import { BusboyConfig } from 'busboy';
 import { Express, RequestHandler, Request, Response, NextFunction, Router as Router$1 } from 'express';
 export { NextFunction, Request, Response } from 'express';
 import { Server } from 'http';
@@ -28,7 +30,12 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
      * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
      * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
      */
-    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration | undefined);
+    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration | undefined, options?: {
+        busboy?: BusboyConfig;
+        text?: OptionsText;
+        json?: OptionsJson;
+        urlencoded?: OptionsUrlencoded;
+    });
     /**
      * Starts the Express server and sets up API documentation (Swagger/Scalar).
      * This method is overloaded to support various ways of starting the server.
@@ -73,7 +80,12 @@ declare class Router<SV extends AnySchemaValidator, BasePath extends `/${string}
      * @param {string} basePath - The base path for the router.
      * @param {SV} schemaValidator - The schema validator.
      */
-    constructor(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
+    constructor(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
+        busboy?: BusboyConfig;
+        text?: OptionsText;
+        json?: OptionsJson;
+        urlencoded?: OptionsUrlencoded;
+    });
     route(path: string): this;
     param<ParamName extends string, Types extends {
         req?: LiteralSchema | SV['_SchemaCatchall'];
@@ -1964,7 +1976,12 @@ declare const unsubscribe: <SV extends AnySchemaValidator, Path extends `/${stri
  * @param {SV} schemaValidator - The schema validator.
  * @returns {Application<SV>} - The new application instance.
  */
-declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration): Application<SV>;
+declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration, options?: {
+    busboy?: BusboyConfig;
+    text?: OptionsText;
+    json?: OptionsJson;
+    urlencoded?: OptionsUrlencoded;
+}): Application<SV>;
 /**
  * Creates a new instance of Router with the given base path and schema validator.
  *
@@ -1973,7 +1990,12 @@ declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidato
  * @param {SV} schemaValidator - The schema validator.
  * @returns {Router<SV>} - The new router instance.
  */
-declare function forklaunchRouter<SV extends AnySchemaValidator, BasePath extends `/${string}`>(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>): Router<SV, BasePath>;
+declare function forklaunchRouter<SV extends AnySchemaValidator, BasePath extends `/${string}`>(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
+    busboy?: BusboyConfig;
+    text?: OptionsText;
+    json?: OptionsJson;
+    urlencoded?: OptionsUrlencoded;
+}): Router<SV, BasePath>;
 
 declare const handlers: {
     checkout: typeof checkout;

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 import * as _forklaunch_core_http from '@forklaunch/core/http';
 import { ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
 import { AnySchemaValidator, LiteralSchema, IdiomaticSchema, SchemaResolve } from '@forklaunch/validator';
+import { OptionsText, OptionsJson, OptionsUrlencoded } from 'body-parser';
+import { BusboyConfig } from 'busboy';
 import { Express, RequestHandler, Request, Response, NextFunction, Router as Router$1 } from 'express';
 export { NextFunction, Request, Response } from 'express';
 import { Server } from 'http';
@@ -28,7 +30,12 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
      * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
      * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
      */
-    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration | undefined);
+    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration | undefined, options?: {
+        busboy?: BusboyConfig;
+        text?: OptionsText;
+        json?: OptionsJson;
+        urlencoded?: OptionsUrlencoded;
+    });
     /**
      * Starts the Express server and sets up API documentation (Swagger/Scalar).
      * This method is overloaded to support various ways of starting the server.
@@ -73,7 +80,12 @@ declare class Router<SV extends AnySchemaValidator, BasePath extends `/${string}
      * @param {string} basePath - The base path for the router.
      * @param {SV} schemaValidator - The schema validator.
      */
-    constructor(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>);
+    constructor(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
+        busboy?: BusboyConfig;
+        text?: OptionsText;
+        json?: OptionsJson;
+        urlencoded?: OptionsUrlencoded;
+    });
     route(path: string): this;
     param<ParamName extends string, Types extends {
         req?: LiteralSchema | SV['_SchemaCatchall'];
@@ -1964,7 +1976,12 @@ declare const unsubscribe: <SV extends AnySchemaValidator, Path extends `/${stri
  * @param {SV} schemaValidator - The schema validator.
  * @returns {Application<SV>} - The new application instance.
  */
-declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration): Application<SV>;
+declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, docsConfiguration?: DocsConfiguration, options?: {
+    busboy?: BusboyConfig;
+    text?: OptionsText;
+    json?: OptionsJson;
+    urlencoded?: OptionsUrlencoded;
+}): Application<SV>;
 /**
  * Creates a new instance of Router with the given base path and schema validator.
  *
@@ -1973,7 +1990,12 @@ declare function forklaunchExpress<SV extends AnySchemaValidator>(schemaValidato
  * @param {SV} schemaValidator - The schema validator.
  * @returns {Router<SV>} - The new router instance.
  */
-declare function forklaunchRouter<SV extends AnySchemaValidator, BasePath extends `/${string}`>(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>): Router<SV, BasePath>;
+declare function forklaunchRouter<SV extends AnySchemaValidator, BasePath extends `/${string}`>(basePath: BasePath, schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
+    busboy?: BusboyConfig;
+    text?: OptionsText;
+    json?: OptionsJson;
+    urlencoded?: OptionsUrlencoded;
+}): Router<SV, BasePath>;
 
 declare const handlers: {
     checkout: typeof checkout;

package/lib/index.js

@@ -37,11 +37,121 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/expressApplication.ts
-var import_http = require("@forklaunch/core/http");
+var import_common3 = require("@forklaunch/common");
+var import_http3 = require("@forklaunch/core/http");
 var import_express_api_reference = require("@scalar/express-api-reference");
-var import_express = __toESM(require("express"));
+var import_crypto = __toESM(require("crypto"));
+var import_express2 = __toESM(require("express"));
 var import_swagger_ui_express = __toESM(require("swagger-ui-express"));
-var Application = class extends import_http.ForklaunchExpressLikeApplication {
+
+// src/middleware/content.parse.middleware.ts
+var import_common = require("@forklaunch/common");
+var import_http = require("@forklaunch/core/http");
+var import_busboy = __toESM(require("busboy"));
+var import_express = __toESM(require("express"));
+function contentParse(options2) {
+  const jsonParser = import_express.default.json(options2?.json);
+  const urlencodedParser = import_express.default.urlencoded({
+    extended: true,
+    ...options2?.urlencoded
+  });
+  const textParser = import_express.default.text(options2?.text);
+  const rawParser = import_express.default.raw(options2?.raw);
+  return async (req, res, next) => {
+    try {
+      const coercedRequest = req;
+      const discriminatedBody = (0, import_http.discriminateBody)(
+        coercedRequest.schemaValidator,
+        coercedRequest.contractDetails.body
+      );
+      if (!discriminatedBody) {
+        return next();
+      }
+      switch (discriminatedBody.parserType) {
+        case "json":
+          return jsonParser(req, res, next);
+        case "urlEncoded":
+          return urlencodedParser(req, res, next);
+        case "text":
+          return textParser(req, res, next);
+        case "file":
+          return rawParser(req, res, next);
+        case "multipart": {
+          const bb = (0, import_busboy.default)({
+            headers: req.headers,
+            ...options2?.busboy
+          });
+          const body = {};
+          bb.on("file", (fieldname, file) => {
+            const chunks = [];
+            file.on("data", (chunk) => {
+              chunks.push(chunk);
+            });
+            file.on("end", () => {
+              const fileBuffer = Buffer.concat(chunks);
+              body[fieldname] = fileBuffer.toString();
+            });
+          });
+          bb.on("field", (fieldname, value) => {
+            body[fieldname] = value;
+          });
+          bb.on("finish", () => {
+            req.body = body;
+            next();
+          });
+          bb.on("error", (err) => {
+            next(err);
+          });
+          req.pipe(bb);
+          break;
+        }
+        default:
+          (0, import_common.isNever)(discriminatedBody.parserType);
+      }
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+
+// src/middleware/enrichResponseTransmission.middleware.ts
+var import_common2 = require("@forklaunch/common");
+var import_http2 = require("@forklaunch/core/http");
+function enrichResponseTransmission(req, res, next) {
+  const originalSend = res.send;
+  const originalJson = res.json;
+  const originalSetHeader = res.setHeader;
+  res.json = function(data) {
+    (0, import_http2.enrichExpressLikeSend)(this, req, res, originalJson, originalSend, data, !res.cors);
+    return data;
+  };
+  res.send = function(data) {
+    if (res.sent) {
+      originalSend.call(this, data);
+      return true;
+    }
+    (0, import_http2.enrichExpressLikeSend)(this, req, res, originalSend, originalSend, data, !res.cors);
+    res.sent = true;
+    return true;
+  };
+  res.setHeader = function(name, value) {
+    let stringifiedValue;
+    if (Array.isArray(value)) {
+      stringifiedValue = value.map((v) => (0, import_common2.safeStringify)(v)).join("\n");
+    } else {
+      stringifiedValue = (0, import_common2.safeStringify)(value);
+    }
+    return originalSetHeader.call(this, name, stringifiedValue);
+  };
+  res.sseEmitter = async function(emitter) {
+    const generator = emitter();
+    (0, import_http2.enrichExpressLikeSend)(this, req, res, originalSend, originalSend, generator, !res.cors);
+  };
+  next?.();
+}
+
+// src/expressApplication.ts
+var Application = class extends import_http3.ForklaunchExpressLikeApplication {
   /**
    * Creates an instance of Application.
    *
@@ -49,21 +159,30 @@ var Application = class extends import_http.ForklaunchExpressLikeApplication {
    * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
    * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
    */
-  constructor(schemaValidator, openTelemetryCollector, docsConfiguration) {
-    super(schemaValidator, (0, import_express.default)(), openTelemetryCollector);
+  constructor(schemaValidator, openTelemetryCollector, docsConfiguration, options2) {
+    super(
+      schemaValidator,
+      (0, import_express2.default)(),
+      [
+        contentParse(options2),
+        enrichResponseTransmission
+      ],
+      openTelemetryCollector
+    );
     this.docsConfiguration = docsConfiguration;
   }
   listen(...args) {
     const port = typeof args[0] === "number" ? args[0] : Number(process.env.PORT);
+    const openApi = (0, import_http3.generateSwaggerDocument)(
+      this.schemaValidator,
+      port,
+      this.routers
+    );
     if (this.docsConfiguration == null || this.docsConfiguration.type === "scalar") {
       this.internal.use(
         `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
         (0, import_express_api_reference.apiReference)({
-          content: (0, import_http.generateSwaggerDocument)(
-            this.schemaValidator,
-            port,
-            this.routers
-          ),
+          content: openApi,
           ...this.docsConfiguration
         })
       );
@@ -71,23 +190,37 @@ var Application = class extends import_http.ForklaunchExpressLikeApplication {
       this.internal.use(
         `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
         import_swagger_ui_express.default.serve,
-        import_swagger_ui_express.default.setup(
-          (0, import_http.generateSwaggerDocument)(this.schemaValidator, port, this.routers)
-        )
+        import_swagger_ui_express.default.setup(openApi)
       );
     }
+    this.internal.get(
+      `/api/${process.env.VERSION ?? "v1"}/openapi`,
+      (_, res) => {
+        res.type("application/json");
+        res.json(openApi);
+      }
+    );
+    this.internal.get(
+      `/api/${process.env.VERSION ?? "v1"}/openapi-hash`,
+      async (_, res) => {
+        const hash = await import_crypto.default.createHash("sha256").update((0, import_common3.safeStringify)(openApi)).digest("hex");
+        res.send(hash);
+      }
+    );
     const errorHandler = (err, req, res, _next) => {
+      const statusCode = Number(res.statusCode);
       res.locals.errorMessage = err.message;
+      console.log(err);
       res.type("text/plain");
-      res.status(res.statusCode && res.statusCode >= 400 ? res.statusCode : 500).send(
+      res.status(statusCode >= 400 ? statusCode : 500).send(
         `Internal server error:
 
-Correlation id: ${(0, import_http.isForklaunchRequest)(req) ? req.context.correlationId : "No correlation ID"}`
+Correlation id: ${(0, import_http3.isForklaunchRequest)(req) ? req.context.correlationId : "No correlation ID"}`
       );
-      (0, import_http.logger)("error").error(
+      (0, import_http3.logger)("error").error(
         err.stack ?? err.message,
-        (0, import_http.meta)({
-          [import_http.ATTR_HTTP_RESPONSE_STATUS_CODE]: res.statusCode ?? 500
+        (0, import_http3.meta)({
+          [import_http3.ATTR_HTTP_RESPONSE_STATUS_CODE]: statusCode
         })
       );
     };
@@ -97,42 +230,9 @@ Correlation id: ${(0, import_http.isForklaunchRequest)(req) ? req.context.correl
 };
 
 // src/expressRouter.ts
-var import_http3 = require("@forklaunch/core/http");
-var import_express2 = __toESM(require("express"));
-
-// src/middleware/response.middleware.ts
-var import_http2 = require("@forklaunch/core/http");
-function enrichResponseTransmission(req, res, next) {
-  const originalSend = res.send;
-  const originalJson = res.json;
-  const originalSetHeader = res.setHeader;
-  res.json = function(data) {
-    res.bodyData = data;
-    (0, import_http2.enrichExpressLikeSend)(this, req, res, originalJson, data, !res.cors);
-    return data;
-  };
-  res.send = function(data) {
-    if (!res.bodyData) {
-      res.bodyData = data;
-    }
-    return (0, import_http2.enrichExpressLikeSend)(this, req, res, originalSend, data, !res.cors);
-  };
-  res.setHeader = function(name, value) {
-    let stringifiedValue;
-    if (Array.isArray(value)) {
-      stringifiedValue = value.map(
-        (v) => typeof v !== "string" ? JSON.stringify(v) : v
-      );
-    } else {
-      stringifiedValue = typeof value !== "string" ? JSON.stringify(value) : value;
-    }
-    return originalSetHeader.call(this, name, stringifiedValue);
-  };
-  next?.();
-}
-
-// src/expressRouter.ts
-var Router = class extends import_http3.ForklaunchExpressLikeRouter {
+var import_http4 = require("@forklaunch/core/http");
+var import_express3 = __toESM(require("express"));
+var Router = class extends import_http4.ForklaunchExpressLikeRouter {
   // implements ForklaunchRouter<SV>
   /**
    * Creates an instance of Router.
@@ -140,11 +240,18 @@ var Router = class extends import_http3.ForklaunchExpressLikeRouter {
    * @param {string} basePath - The base path for the router.
    * @param {SV} schemaValidator - The schema validator.
    */
-  constructor(basePath, schemaValidator, openTelemetryCollector) {
-    super(basePath, schemaValidator, import_express2.default.Router(), openTelemetryCollector);
+  constructor(basePath, schemaValidator, openTelemetryCollector, options2) {
+    super(
+      basePath,
+      schemaValidator,
+      import_express3.default.Router(),
+      [
+        contentParse(options2),
+        enrichResponseTransmission
+      ],
+      openTelemetryCollector
+    );
     this.basePath = basePath;
-    this.internal.use(import_express2.default.json());
-    this.internal.use(enrichResponseTransmission);
   }
   route(path) {
     this.internal.route(path);
@@ -317,183 +424,189 @@ var Router = class extends import_http3.ForklaunchExpressLikeRouter {
 };
 
 // src/handlers/checkout.ts
-var import_http4 = require("@forklaunch/core/http");
+var import_http5 = require("@forklaunch/core/http");
 var checkout = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http4.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http5.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/copy.ts
-var import_http5 = require("@forklaunch/core/http");
+var import_http6 = require("@forklaunch/core/http");
 var copy = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http5.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http6.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/delete.ts
-var import_http6 = require("@forklaunch/core/http");
+var import_http7 = require("@forklaunch/core/http");
 var delete_ = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http6.delete_)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http7.delete_)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/get.ts
-var import_http7 = require("@forklaunch/core/http");
+var import_http8 = require("@forklaunch/core/http");
 var get = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http7.get)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http8.get)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/head.ts
-var import_http8 = require("@forklaunch/core/http");
+var import_http9 = require("@forklaunch/core/http");
 var head = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http8.head)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http9.head)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/link.ts
-var import_http9 = require("@forklaunch/core/http");
+var import_http10 = require("@forklaunch/core/http");
 var link = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http9.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http10.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/lock.ts
-var import_http10 = require("@forklaunch/core/http");
+var import_http11 = require("@forklaunch/core/http");
 var lock = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http10.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http11.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/m-search.ts
-var import_http11 = require("@forklaunch/core/http");
+var import_http12 = require("@forklaunch/core/http");
 var mSearch = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http11.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http12.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/merge.ts
-var import_http12 = require("@forklaunch/core/http");
+var import_http13 = require("@forklaunch/core/http");
 var merge = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http12.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http13.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/middleware.ts
-var import_http13 = require("@forklaunch/core/http");
+var import_http14 = require("@forklaunch/core/http");
 var middleware7 = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http13.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http14.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/mkcactivity.ts
-var import_http14 = require("@forklaunch/core/http");
+var import_http15 = require("@forklaunch/core/http");
 var mkcActivity = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http14.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http15.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/mkcol.ts
-var import_http15 = require("@forklaunch/core/http");
+var import_http16 = require("@forklaunch/core/http");
 var mkcol = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http15.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http16.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/move.ts
-var import_http16 = require("@forklaunch/core/http");
+var import_http17 = require("@forklaunch/core/http");
 var move = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http16.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http17.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/notify.ts
-var import_http17 = require("@forklaunch/core/http");
+var import_http18 = require("@forklaunch/core/http");
 var notify = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http17.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http18.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/options.ts
-var import_http18 = require("@forklaunch/core/http");
+var import_http19 = require("@forklaunch/core/http");
 var options = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http18.options)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http19.options)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/patch.ts
-var import_http19 = require("@forklaunch/core/http");
+var import_http20 = require("@forklaunch/core/http");
 var patch = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http19.patch)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http20.patch)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/post.ts
-var import_http20 = require("@forklaunch/core/http");
+var import_http21 = require("@forklaunch/core/http");
 var post = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http20.post)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http21.post)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/propfind.ts
-var import_http21 = require("@forklaunch/core/http");
+var import_http22 = require("@forklaunch/core/http");
 var propfind = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http21.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http22.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/proppatch.ts
-var import_http22 = require("@forklaunch/core/http");
+var import_http23 = require("@forklaunch/core/http");
 var proppatch = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http22.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http23.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/purge.ts
-var import_http23 = require("@forklaunch/core/http");
+var import_http24 = require("@forklaunch/core/http");
 var purge = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http23.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http24.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/put.ts
-var import_http24 = require("@forklaunch/core/http");
+var import_http25 = require("@forklaunch/core/http");
 var put = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http24.put)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http25.put)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/report.ts
-var import_http25 = require("@forklaunch/core/http");
+var import_http26 = require("@forklaunch/core/http");
 var report = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http25.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http26.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/search.ts
-var import_http26 = require("@forklaunch/core/http");
+var import_http27 = require("@forklaunch/core/http");
 var search = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http26.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http27.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/subscribe.ts
-var import_http27 = require("@forklaunch/core/http");
+var import_http28 = require("@forklaunch/core/http");
 var subscribe = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http27.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http28.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/trace.ts
-var import_http28 = require("@forklaunch/core/http");
+var import_http29 = require("@forklaunch/core/http");
 var trace = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http28.trace)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http29.trace)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/unlink.ts
-var import_http29 = require("@forklaunch/core/http");
+var import_http30 = require("@forklaunch/core/http");
 var unlink = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http29.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http30.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/unlock.ts
-var import_http30 = require("@forklaunch/core/http");
+var import_http31 = require("@forklaunch/core/http");
 var unlock = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http30.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http31.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // src/handlers/unsubscribe.ts
-var import_http31 = require("@forklaunch/core/http");
+var import_http32 = require("@forklaunch/core/http");
 var unsubscribe = (schemaValidator, path, contractDetails, ...handlers2) => {
-  return (0, import_http31.middleware)(schemaValidator, path, contractDetails, ...handlers2);
+  return (0, import_http32.middleware)(schemaValidator, path, contractDetails, ...handlers2);
 };
 
 // index.ts
-function forklaunchExpress(schemaValidator, openTelemetryCollector, docsConfiguration) {
+function forklaunchExpress(schemaValidator, openTelemetryCollector, docsConfiguration, options2) {
   return new Application(
     schemaValidator,
     openTelemetryCollector,
-    docsConfiguration
+    docsConfiguration,
+    options2
   );
 }
-function forklaunchRouter(basePath, schemaValidator, openTelemetryCollector) {
-  const router = new Router(basePath, schemaValidator, openTelemetryCollector);
+function forklaunchRouter(basePath, schemaValidator, openTelemetryCollector, options2) {
+  const router = new Router(
+    basePath,
+    schemaValidator,
+    openTelemetryCollector,
+    options2
+  );
   return router;
 }
 var handlers = {

package/lib/index.mjs

@@ -1,4 +1,5 @@
 // src/expressApplication.ts
+import { safeStringify as safeStringify2 } from "@forklaunch/common";
 import {
   ATTR_HTTP_RESPONSE_STATUS_CODE,
   ForklaunchExpressLikeApplication,
@@ -8,8 +9,119 @@ import {
   meta
 } from "@forklaunch/core/http";
 import { apiReference } from "@scalar/express-api-reference";
-import express from "express";
+import crypto from "crypto";
+import express2 from "express";
 import swaggerUi from "swagger-ui-express";
+
+// src/middleware/content.parse.middleware.ts
+import { isNever } from "@forklaunch/common";
+import { discriminateBody } from "@forklaunch/core/http";
+import Busboy from "busboy";
+import express from "express";
+function contentParse(options2) {
+  const jsonParser = express.json(options2?.json);
+  const urlencodedParser = express.urlencoded({
+    extended: true,
+    ...options2?.urlencoded
+  });
+  const textParser = express.text(options2?.text);
+  const rawParser = express.raw(options2?.raw);
+  return async (req, res, next) => {
+    try {
+      const coercedRequest = req;
+      const discriminatedBody = discriminateBody(
+        coercedRequest.schemaValidator,
+        coercedRequest.contractDetails.body
+      );
+      if (!discriminatedBody) {
+        return next();
+      }
+      switch (discriminatedBody.parserType) {
+        case "json":
+          return jsonParser(req, res, next);
+        case "urlEncoded":
+          return urlencodedParser(req, res, next);
+        case "text":
+          return textParser(req, res, next);
+        case "file":
+          return rawParser(req, res, next);
+        case "multipart": {
+          const bb = Busboy({
+            headers: req.headers,
+            ...options2?.busboy
+          });
+          const body = {};
+          bb.on("file", (fieldname, file) => {
+            const chunks = [];
+            file.on("data", (chunk) => {
+              chunks.push(chunk);
+            });
+            file.on("end", () => {
+              const fileBuffer = Buffer.concat(chunks);
+              body[fieldname] = fileBuffer.toString();
+            });
+          });
+          bb.on("field", (fieldname, value) => {
+            body[fieldname] = value;
+          });
+          bb.on("finish", () => {
+            req.body = body;
+            next();
+          });
+          bb.on("error", (err) => {
+            next(err);
+          });
+          req.pipe(bb);
+          break;
+        }
+        default:
+          isNever(discriminatedBody.parserType);
+      }
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+
+// src/middleware/enrichResponseTransmission.middleware.ts
+import { safeStringify } from "@forklaunch/common";
+import {
+  enrichExpressLikeSend
+} from "@forklaunch/core/http";
+function enrichResponseTransmission(req, res, next) {
+  const originalSend = res.send;
+  const originalJson = res.json;
+  const originalSetHeader = res.setHeader;
+  res.json = function(data) {
+    enrichExpressLikeSend(this, req, res, originalJson, originalSend, data, !res.cors);
+    return data;
+  };
+  res.send = function(data) {
+    if (res.sent) {
+      originalSend.call(this, data);
+      return true;
+    }
+    enrichExpressLikeSend(this, req, res, originalSend, originalSend, data, !res.cors);
+    res.sent = true;
+    return true;
+  };
+  res.setHeader = function(name, value) {
+    let stringifiedValue;
+    if (Array.isArray(value)) {
+      stringifiedValue = value.map((v) => safeStringify(v)).join("\n");
+    } else {
+      stringifiedValue = safeStringify(value);
+    }
+    return originalSetHeader.call(this, name, stringifiedValue);
+  };
+  res.sseEmitter = async function(emitter) {
+    const generator = emitter();
+    enrichExpressLikeSend(this, req, res, originalSend, originalSend, generator, !res.cors);
+  };
+  next?.();
+}
+
+// src/expressApplication.ts
 var Application = class extends ForklaunchExpressLikeApplication {
   /**
    * Creates an instance of Application.
@@ -18,21 +130,30 @@ var Application = class extends ForklaunchExpressLikeApplication {
    * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
    * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
    */
-  constructor(schemaValidator, openTelemetryCollector, docsConfiguration) {
-    super(schemaValidator, express(), openTelemetryCollector);
+  constructor(schemaValidator, openTelemetryCollector, docsConfiguration, options2) {
+    super(
+      schemaValidator,
+      express2(),
+      [
+        contentParse(options2),
+        enrichResponseTransmission
+      ],
+      openTelemetryCollector
+    );
     this.docsConfiguration = docsConfiguration;
   }
   listen(...args) {
     const port = typeof args[0] === "number" ? args[0] : Number(process.env.PORT);
+    const openApi = generateSwaggerDocument(
+      this.schemaValidator,
+      port,
+      this.routers
+    );
     if (this.docsConfiguration == null || this.docsConfiguration.type === "scalar") {
       this.internal.use(
         `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
         apiReference({
-          content: generateSwaggerDocument(
-            this.schemaValidator,
-            port,
-            this.routers
-          ),
+          content: openApi,
           ...this.docsConfiguration
         })
       );
@@ -40,15 +161,29 @@ var Application = class extends ForklaunchExpressLikeApplication {
       this.internal.use(
         `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
         swaggerUi.serve,
-        swaggerUi.setup(
-          generateSwaggerDocument(this.schemaValidator, port, this.routers)
-        )
+        swaggerUi.setup(openApi)
       );
     }
+    this.internal.get(
+      `/api/${process.env.VERSION ?? "v1"}/openapi`,
+      (_, res) => {
+        res.type("application/json");
+        res.json(openApi);
+      }
+    );
+    this.internal.get(
+      `/api/${process.env.VERSION ?? "v1"}/openapi-hash`,
+      async (_, res) => {
+        const hash = await crypto.createHash("sha256").update(safeStringify2(openApi)).digest("hex");
+        res.send(hash);
+      }
+    );
     const errorHandler = (err, req, res, _next) => {
+      const statusCode = Number(res.statusCode);
       res.locals.errorMessage = err.message;
+      console.log(err);
       res.type("text/plain");
-      res.status(res.statusCode && res.statusCode >= 400 ? res.statusCode : 500).send(
+      res.status(statusCode >= 400 ? statusCode : 500).send(
         `Internal server error:
 
 Correlation id: ${isForklaunchRequest(req) ? req.context.correlationId : "No correlation ID"}`
@@ -56,7 +191,7 @@ Correlation id: ${isForklaunchRequest(req) ? req.context.correlationId : "No cor
       logger("error").error(
         err.stack ?? err.message,
         meta({
-          [ATTR_HTTP_RESPONSE_STATUS_CODE]: res.statusCode ?? 500
+          [ATTR_HTTP_RESPONSE_STATUS_CODE]: statusCode
         })
       );
     };
@@ -69,40 +204,7 @@ Correlation id: ${isForklaunchRequest(req) ? req.context.correlationId : "No cor
 import {
   ForklaunchExpressLikeRouter
 } from "@forklaunch/core/http";
-import express2 from "express";
-
-// src/middleware/response.middleware.ts
-import { enrichExpressLikeSend } from "@forklaunch/core/http";
-function enrichResponseTransmission(req, res, next) {
-  const originalSend = res.send;
-  const originalJson = res.json;
-  const originalSetHeader = res.setHeader;
-  res.json = function(data) {
-    res.bodyData = data;
-    enrichExpressLikeSend(this, req, res, originalJson, data, !res.cors);
-    return data;
-  };
-  res.send = function(data) {
-    if (!res.bodyData) {
-      res.bodyData = data;
-    }
-    return enrichExpressLikeSend(this, req, res, originalSend, data, !res.cors);
-  };
-  res.setHeader = function(name, value) {
-    let stringifiedValue;
-    if (Array.isArray(value)) {
-      stringifiedValue = value.map(
-        (v) => typeof v !== "string" ? JSON.stringify(v) : v
-      );
-    } else {
-      stringifiedValue = typeof value !== "string" ? JSON.stringify(value) : value;
-    }
-    return originalSetHeader.call(this, name, stringifiedValue);
-  };
-  next?.();
-}
-
-// src/expressRouter.ts
+import express3 from "express";
 var Router = class extends ForklaunchExpressLikeRouter {
   // implements ForklaunchRouter<SV>
   /**
@@ -111,11 +213,18 @@ var Router = class extends ForklaunchExpressLikeRouter {
    * @param {string} basePath - The base path for the router.
    * @param {SV} schemaValidator - The schema validator.
    */
-  constructor(basePath, schemaValidator, openTelemetryCollector) {
-    super(basePath, schemaValidator, express2.Router(), openTelemetryCollector);
+  constructor(basePath, schemaValidator, openTelemetryCollector, options2) {
+    super(
+      basePath,
+      schemaValidator,
+      express3.Router(),
+      [
+        contentParse(options2),
+        enrichResponseTransmission
+      ],
+      openTelemetryCollector
+    );
     this.basePath = basePath;
-    this.internal.use(express2.json());
-    this.internal.use(enrichResponseTransmission);
   }
   route(path) {
     this.internal.route(path);
@@ -512,15 +621,21 @@ var unsubscribe = (schemaValidator, path, contractDetails, ...handlers2) => {
 };
 
 // index.ts
-function forklaunchExpress(schemaValidator, openTelemetryCollector, docsConfiguration) {
+function forklaunchExpress(schemaValidator, openTelemetryCollector, docsConfiguration, options2) {
   return new Application(
     schemaValidator,
     openTelemetryCollector,
-    docsConfiguration
+    docsConfiguration,
+    options2
   );
 }
-function forklaunchRouter(basePath, schemaValidator, openTelemetryCollector) {
-  const router = new Router(basePath, schemaValidator, openTelemetryCollector);
+function forklaunchRouter(basePath, schemaValidator, openTelemetryCollector, options2) {
+  const router = new Router(
+    basePath,
+    schemaValidator,
+    openTelemetryCollector,
+    options2
+  );
   return router;
 }
 var handlers = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/express",
-  "version": "0.4.11",
+  "version": "0.5.0",
   "description": "Forklaunch framework for express.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -25,32 +25,38 @@
     "lib/**"
   ],
   "dependencies": {
-    "@scalar/express-api-reference": "^0.6.8",
+    "@scalar/express-api-reference": "^0.8.1",
+    "@types/multer": "^1.4.12",
+    "body-parser": "^2.2.0",
+    "busboy": "^1.6.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
+    "multer": "2.0.0",
     "qs": "^6.14.0",
     "swagger-ui-express": "^5.0.1",
-    "@forklaunch/validator": "0.5.4",
-    "@forklaunch/core": "0.7.4",
-    "@forklaunch/common": "0.2.11"
+    "@forklaunch/common": "0.3.0",
+    "@forklaunch/core": "0.8.0",
+    "@forklaunch/validator": "0.6.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.25.0",
-    "@types/cors": "^2.8.17",
-    "@types/express": "^5.0.1",
+    "@eslint/js": "^9.27.0",
+    "@types/body-parser": "^1.19.5",
+    "@types/busboy": "^1.5.4",
+    "@types/cors": "^2.8.18",
+    "@types/express": "^5.0.2",
     "@types/express-serve-static-core": "^5.0.6",
     "@types/jest": "^29.5.14",
-    "@types/qs": "^6.9.18",
+    "@types/qs": "^6.14.0",
     "@types/swagger-ui-express": "^4.1.8",
     "jest": "^29.7.0",
     "kill-port-process": "^3.2.1",
     "prettier": "^3.5.3",
-    "ts-jest": "^29.3.2",
+    "ts-jest": "^29.3.4",
     "ts-node": "^10.9.2",
-    "tsup": "^8.4.0",
-    "typedoc": "^0.28.3",
+    "tsup": "^8.5.0",
+    "typedoc": "^0.28.4",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.30.1"
+    "typescript-eslint": "^8.32.1"
   },
   "scripts": {
     "build": "tsc --noEmit && tsup index.ts --format cjs,esm --no-splitting --tsconfig tsconfig.json --outDir lib --dts --clean",