@forklaunch/core 0.3.6 → 0.5.0

package/lib/http/index.js

@@ -30,32 +30,84 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/http/index.ts
 var http_exports = {};
 __export(http_exports, {
+  ATTR_API_NAME: () => ATTR_API_NAME,
+  ATTR_CORRELATION_ID: () => ATTR_CORRELATION_ID,
+  ATTR_HTTP_REQUEST_METHOD: () => import_semantic_conventions.ATTR_HTTP_REQUEST_METHOD,
+  ATTR_HTTP_RESPONSE_STATUS_CODE: () => import_semantic_conventions.ATTR_HTTP_RESPONSE_STATUS_CODE,
+  ATTR_HTTP_ROUTE: () => import_semantic_conventions.ATTR_HTTP_ROUTE,
+  ATTR_SERVICE_NAME: () => import_semantic_conventions.ATTR_SERVICE_NAME,
   ForklaunchExpressLikeApplication: () => ForklaunchExpressLikeApplication,
   ForklaunchExpressLikeRouter: () => ForklaunchExpressLikeRouter,
   HTTPStatuses: () => HTTPStatuses,
+  OpenTelemetryCollector: () => OpenTelemetryCollector,
   delete_: () => delete_,
   enrichExpressLikeSend: () => enrichExpressLikeSend,
   generateSwaggerDocument: () => generateSwaggerDocument,
   get: () => get,
   getCodeForStatus: () => getCodeForStatus,
   head: () => head,
+  httpRequestsTotalCounter: () => httpRequestsTotalCounter,
   isClientError: () => isClientError,
+  isForklaunchRequest: () => isForklaunchRequest,
   isForklaunchRouter: () => isForklaunchRouter,
   isInformational: () => isInformational,
   isRedirection: () => isRedirection,
   isServerError: () => isServerError,
   isSuccessful: () => isSuccessful,
   isValidStatusCode: () => isValidStatusCode,
+  logger: () => logger,
+  metricsDefinitions: () => metricsDefinitions,
   middleware: () => middleware,
   options: () => options,
   patch: () => patch,
   post: () => post,
   put: () => put,
-  trace: () => trace,
+  recordMetric: () => recordMetric,
+  trace: () => trace2,
   typedHandler: () => typedHandler
 });
 module.exports = __toCommonJS(http_exports);
 
+// src/http/middleware/request/cors.middleware.ts
+var import_cors = __toESM(require("cors"));
+function cors(req, res, next) {
+  if (req.method === "OPTIONS") {
+    res.cors = true;
+  }
+  (0, import_cors.default)()(req, res, next ?? (() => {
+  }));
+}
+
+// src/http/middleware/request/createContext.middleware.ts
+var import_api = require("@opentelemetry/api");
+var import_uuid = require("uuid");
+
+// src/http/telemetry/constants.ts
+var import_semantic_conventions = require("@opentelemetry/semantic-conventions");
+var ATTR_API_NAME = "api.name";
+var ATTR_CORRELATION_ID = "correlation.id";
+
+// src/http/middleware/request/createContext.middleware.ts
+function createContext(schemaValidator) {
+  return function setContext(req, res, next) {
+    req.schemaValidator = schemaValidator;
+    let correlationId = (0, import_uuid.v4)();
+    if (req.headers["x-correlation-id"]) {
+      correlationId = req.headers["x-correlation-id"];
+    }
+    res.setHeader("x-correlation-id", correlationId);
+    req.context = {
+      correlationId
+    };
+    const span = import_api.trace.getActiveSpan();
+    if (span != null) {
+      req.context.span = span;
+      req.context.span?.setAttribute(ATTR_CORRELATION_ID, correlationId);
+    }
+    next?.();
+  };
+}
+
 // src/http/guards/isForklaunchRouter.ts
 function isForklaunchRouter(maybeForklaunchRouter) {
   return maybeForklaunchRouter != null && typeof maybeForklaunchRouter === "object" && "basePath" in maybeForklaunchRouter && "routes" in maybeForklaunchRouter && Array.isArray(maybeForklaunchRouter.routes);
@@ -215,58 +267,29 @@ async function checkAuthorizationToken(authorizationMethod, authorizationToken,
   return [401, "Invalid Authorization method."];
 }
 async function parseRequestAuth(req, res, next) {
-  console.debug("[MIDDLEWARE] parseRequest started");
   const auth = req.contractDetails.auth;
   if (auth) {
-    const errorAndMessage = await checkAuthorizationToken(
+    const [error, message] = await checkAuthorizationToken(
       auth,
       req.headers[(auth.method === "other" ? auth.headerName : void 0) ?? "Authorization"],
       req
-    );
-    if (Array.isArray(errorAndMessage)) {
-      res.status(errorAndMessage[0]).send(errorAndMessage[1]);
-      next?.(new Error(errorAndMessage[1]));
+    ) ?? [];
+    if (error != null) {
+      res.status(error).send(message);
+      next?.(new Error(message));
     }
   }
   next?.();
 }
 
-// src/http/middleware/request/cors.middleware.ts
-var import_cors = __toESM(require("cors"));
-function cors(req, res, next) {
-  console.debug("[MIDDLEWARE] cors started");
-  if (req.method === "OPTIONS") {
-    res.cors = true;
-  }
-  (0, import_cors.default)()(req, res, next ?? (() => {
-  }));
-}
-
-// src/http/middleware/request/createContext.middleware.ts
-var import_uuid = require("uuid");
-function createContext(schemaValidator) {
-  return (req, res, next) => {
-    console.debug("[MIDDLEWARE] createRequestContext started");
-    req.schemaValidator = schemaValidator;
-    let correlationId = (0, import_uuid.v4)();
-    if (req.headers["x-correlation-id"]) {
-      correlationId = req.headers["x-correlation-id"];
-    }
-    res.setHeader("x-correlation-id", correlationId);
-    req.context = {
-      correlationId
-    };
-    next?.();
-  };
-}
-
 // src/http/middleware/request/enrichDetails.middleware.ts
-function enrichDetails(contractDetails, requestSchema, responseSchemas) {
+function enrichDetails(path, contractDetails, requestSchema, responseSchemas) {
   return (req, res, next) => {
-    console.debug("[MIDDLEWARE] enrichRequestDetails started");
+    req.originalPath = path;
     req.contractDetails = contractDetails;
     req.requestSchema = requestSchema;
     res.responseSchemas = responseSchemas;
+    req.context.span?.setAttribute(ATTR_API_NAME, req.contractDetails?.name);
     next?.();
   };
 }
@@ -281,14 +304,16 @@ function isResponseShape(maybeResponseShape) {
 
 // src/http/middleware/request/parse.middleware.ts
 function parse(req, _res, next) {
-  console.debug("[MIDDLEWARE] parseRequest started");
   const request = {
     params: req.params,
     query: req.query,
     headers: req.headers,
     body: req.body
   };
-  const parsedRequest = req.schemaValidator.parse(req.requestSchema, request);
+  const parsedRequest = req.schemaValidator.parse(
+    req.requestSchema,
+    request
+  );
   if (parsedRequest.ok && isResponseShape(parsedRequest.value)) {
     req.body = parsedRequest.value.body;
     req.params = parsedRequest.value.params;
@@ -319,8 +344,6 @@ var ForklaunchExpressLikeRouter = class {
     this.schemaValidator = schemaValidator;
     this.internal = internal;
     this.basePath = basePath;
-    this.internal.use(createContext(this.schemaValidator));
-    this.internal.use(cors);
   }
   requestHandler;
   routers = [];
@@ -332,9 +355,14 @@ var ForklaunchExpressLikeRouter = class {
    * @param {PathParamHttpContractDetails<SV> | HttpContractDetails<SV>} contractDetails - The contract details.
    * @returns {MiddlewareHandler<SV>[]} - The resolved middlewares.
    */
-  #resolveMiddlewares(contractDetails, requestSchema, responseSchemas) {
+  #resolveMiddlewares(path, contractDetails, requestSchema, responseSchemas) {
     return [
-      enrichDetails(contractDetails, requestSchema, responseSchemas),
+      enrichDetails(
+        `${this.basePath}${path}`,
+        contractDetails,
+        requestSchema,
+        responseSchemas
+      ),
       parse,
       parseRequestAuth
     ];
@@ -359,10 +387,10 @@ var ForklaunchExpressLikeRouter = class {
       try {
         await requestHandler(req, res, next);
       } catch (error) {
-        next?.(error);
-        console.error(error);
-        if (!res.headersSent) {
-          res.status(500).send("Internal Server Error");
+        if (next && typeof next === "function") {
+          next(error);
+        } else {
+          throw error;
         }
       }
     };
@@ -395,7 +423,7 @@ var ForklaunchExpressLikeRouter = class {
         ...contractDetails.params ? { params: contractDetails.params } : {},
         ...contractDetails.requestHeaders ? { headers: contractDetails.requestHeaders } : {},
         ...contractDetails.query ? { query: contractDetails.query } : {},
-        ...isHttpContractDetails(contractDetails) && contractDetails.body ? { body: contractDetails.body } : {}
+        ...isHttpContractDetails(contractDetails) && contractDetails.body != null ? { body: contractDetails.body } : {}
       })
     );
     const responseEntries = {
@@ -404,7 +432,9 @@ var ForklaunchExpressLikeRouter = class {
       403: schemaValidator.string,
       404: schemaValidator.string,
       500: schemaValidator.string,
-      ...isPathParamHttpContractDetails(contractDetails) || isHttpContractDetails(contractDetails) ? { ...contractDetails.responses } : {}
+      ...isPathParamHttpContractDetails(contractDetails) || isHttpContractDetails(contractDetails) ? {
+        ...contractDetails.responses
+      } : {}
     };
     const responseSchemas = {
       responses: {},
@@ -534,9 +564,12 @@ var ForklaunchExpressLikeRouter = class {
         const controllerHandler = this.#extractControllerHandler(handlers);
         registrationMethod.bind(this.internal)(
           path,
-          ...this.#resolveMiddlewares(contractDetails, requestSchema, responseSchemas).concat(
-            handlers
-          ),
+          ...this.#resolveMiddlewares(
+            path,
+            contractDetails,
+            requestSchema,
+            responseSchemas
+          ).concat(handlers),
           this.#parseAndRunControllerHandler(controllerHandler)
         );
         return this.#localParamRequest(
@@ -592,9 +625,7 @@ var ForklaunchExpressLikeRouter = class {
       contractDetailsOrMiddlewareOrTypedHandler,
       middleware2
     );
-    if (isForklaunchExpressLikeRouter(
-      contractDetailsOrMiddlewareOrTypedHandler
-    )) {
+    if (isForklaunchExpressLikeRouter(contractDetailsOrMiddlewareOrTypedHandler)) {
       middleware2.push(contractDetailsOrMiddlewareOrTypedHandler.internal);
     }
     middleware2.push(
@@ -895,11 +926,23 @@ var ForklaunchExpressLikeApplication = class extends ForklaunchExpressLikeRouter
     super("/", schemaValidator, internal);
     this.schemaValidator = schemaValidator;
     this.internal = internal;
+    this.internal.use(createContext(this.schemaValidator));
+    this.internal.use(cors);
   }
 };
 
+// src/http/guards/isForklaunchRequest.ts
+function isForklaunchRequest(request) {
+  return request != null && typeof request === "object" && "contractDetails" in request;
+}
+
+// src/http/guards/isPath.ts
+function isPath(path) {
+  return path.startsWith("/");
+}
+
 // src/http/handlers/typedHandler.ts
-function typedHandler(_schemaValidator, _pathOrContractDetails, contractMethodOrContractDetails, contractDetailsOrHandler, ...handlerArray) {
+function typedHandler(_schemaValidator, pathOrContractMethod, contractMethodOrContractDetails, contractDetailsOrHandler, ...handlerArray) {
   let contractDetails;
   let handlers;
   if (typeof contractMethodOrContractDetails === "string") {
@@ -919,6 +962,7 @@ function typedHandler(_schemaValidator, _pathOrContractDetails, contractMethodOr
   }
   return {
     _typedHandler: true,
+    _path: isPath(pathOrContractMethod) ? pathOrContractMethod : void 0,
     contractDetails,
     handlers
   };
@@ -965,11 +1009,11 @@ var put = (_schemaValidator, path, contractDetails, ...handlers) => {
 };
 
 // src/http/handlers/trace.ts
-var trace = (_schemaValidator, path, contractDetails, ...handlers) => {
+var trace2 = (_schemaValidator, path, contractDetails, ...handlers) => {
   return typedHandler(_schemaValidator, path, "trace", contractDetails, ...handlers);
 };
 
-// src/http/utils/httpStatusCodes.ts
+// src/http/httpStatusCodes.ts
 var HTTPStatuses = {
   /**
    * The initial part of a request has been received and has not yet been
@@ -1952,6 +1996,311 @@ var getCodeForStatus = (status) => {
 };
 var httpStatusCodes_default = HTTPStatuses;
 
+// src/http/middleware/response/parse.middleware.ts
+var import_validator2 = require("@forklaunch/validator");
+function parse2(req, res, next) {
+  const { headers, responses } = res.responseSchemas;
+  const parsedResponse = req.schemaValidator.parse(
+    responses?.[res.statusCode],
+    res.bodyData
+  );
+  const parsedHeaders = req.schemaValidator.parse(
+    headers ?? req.schemaValidator.unknown,
+    res.getHeaders()
+  );
+  const parseErrors = [];
+  if (!parsedHeaders.ok) {
+    const headerErrors = (0, import_validator2.prettyPrintParseErrors)(parsedHeaders.errors, "Header");
+    if (headerErrors) {
+      parseErrors.push(headerErrors);
+    }
+  }
+  if (!parsedResponse.ok) {
+    const responseErrors = (0, import_validator2.prettyPrintParseErrors)(
+      parsedResponse.errors,
+      "Response"
+    );
+    if (responseErrors) {
+      parseErrors.push(responseErrors);
+    }
+  }
+  if (parseErrors.length > 0) {
+    switch (req.contractDetails.options?.responseValidation) {
+      default:
+      case "error":
+        next?.(new Error(`Invalid response:
+${parseErrors.join("\n\n")}`));
+        break;
+      case "warning":
+        console.warn(`Invalid response:
+${parseErrors.join("\n\n")}`);
+        break;
+      case "none":
+        break;
+    }
+  }
+  next?.();
+}
+
+// src/http/telemetry/pinoLogger.ts
+var import_common2 = require("@forklaunch/common");
+var import_api2 = require("@opentelemetry/api");
+var import_api_logs = require("@opentelemetry/api-logs");
+var import_pino = __toESM(require("pino"));
+function mapSeverity(level) {
+  switch (level) {
+    case "silent":
+      return 0;
+    case "trace":
+      return 1;
+    case "debug":
+      return 5;
+    case "info":
+      return 9;
+    case "warn":
+      return 13;
+    case "error":
+      return 17;
+    case "fatal":
+      return 21;
+    default:
+      (0, import_common2.isNever)(level);
+      return 0;
+  }
+}
+var PinoLogger = class _PinoLogger {
+  pinoLogger;
+  meta;
+  constructor(level, meta = {}) {
+    this.pinoLogger = (0, import_pino.default)({
+      level: level || "info",
+      formatters: {
+        level(label) {
+          return { level: label };
+        }
+      },
+      timestamp: import_pino.default.stdTimeFunctions.isoTime,
+      transport: {
+        target: "pino-pretty",
+        options: { colorize: true }
+      }
+    });
+    this.meta = meta;
+  }
+  log(level, msg, meta = {}) {
+    const activeSpan = import_api2.trace.getActiveSpan();
+    if (activeSpan) {
+      const activeSpanContext = activeSpan.spanContext();
+      meta.trace_id = activeSpanContext.traceId;
+      meta.span_id = activeSpanContext.spanId;
+      meta.trace_flags = activeSpanContext.traceFlags;
+      if (!meta.api_name) {
+        meta = { ...meta, ...activeSpan?.attributes };
+      }
+    }
+    this.pinoLogger[level](msg);
+    import_api_logs.logs.getLogger(process.env.OTEL_SERVICE_NAME ?? "unknown").emit({
+      severityText: level,
+      severityNumber: mapSeverity(level),
+      body: msg,
+      attributes: { ...this.meta, ...meta }
+    });
+  }
+  error(msg, meta = {}) {
+    this.log("error", msg, meta);
+  }
+  info(msg, meta = {}) {
+    this.log("info", msg, meta);
+  }
+  debug(msg, meta = {}) {
+    this.log("debug", msg, meta);
+  }
+  warn(msg, meta = {}) {
+    this.log("warn", msg, meta);
+  }
+  trace(msg, meta = {}) {
+    this.log("trace", msg, meta);
+  }
+  child(meta = {}) {
+    return new _PinoLogger(this.pinoLogger.level, { ...this.meta, ...meta });
+  }
+  getBaseLogger() {
+    return this.pinoLogger;
+  }
+};
+function logger(level, meta = {}) {
+  return new PinoLogger(level, meta);
+}
+
+// src/http/telemetry/recordMetric.ts
+var import_semantic_conventions3 = require("@opentelemetry/semantic-conventions");
+
+// src/services/configInjector.ts
+var import_common3 = require("@forklaunch/common");
+var import_validator3 = require("@forklaunch/validator");
+
+// src/services/getEnvVar.ts
+function getEnvVar(name) {
+  const value = process.env[name];
+  return value;
+}
+
+// src/http/telemetry/openTelemetryCollector.ts
+var import_opentelemetry_instrumentation_hyper_express = require("@forklaunch/opentelemetry-instrumentation-hyper-express");
+var import_api3 = require("@opentelemetry/api");
+var import_exporter_logs_otlp_http = require("@opentelemetry/exporter-logs-otlp-http");
+var import_exporter_metrics_otlp_http = require("@opentelemetry/exporter-metrics-otlp-http");
+var import_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
+var import_instrumentation_express = require("@opentelemetry/instrumentation-express");
+var import_instrumentation_http = require("@opentelemetry/instrumentation-http");
+var import_resources = require("@opentelemetry/resources");
+var import_sdk_logs = require("@opentelemetry/sdk-logs");
+var import_sdk_metrics = require("@opentelemetry/sdk-metrics");
+var import_sdk_node = require("@opentelemetry/sdk-node");
+var import_semantic_conventions2 = require("@opentelemetry/semantic-conventions");
+var import_dotenv = __toESM(require("dotenv"));
+var OpenTelemetryCollector = class {
+  // scoped creation and create this in middleware when api execute. Also add correlation id
+  constructor(serviceName, level, metricDefinitions) {
+    this.serviceName = serviceName;
+    this.logger = logger(level ?? "info");
+    this.metrics = {};
+    for (const [metricId, metricType] of Object.entries(
+      metricDefinitions ?? {}
+    )) {
+      switch (metricType) {
+        case "counter":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createCounter(metricId);
+          break;
+        case "gauge":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createGauge(metricId);
+          break;
+        case "histogram":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createHistogram(metricId);
+          break;
+        case "upDownCounter":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createUpDownCounter(metricId);
+          break;
+        case "observableCounter":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createObservableCounter(metricId);
+          break;
+        case "observableGauge":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createObservableGauge(metricId);
+          break;
+        case "observableUpDownCounter":
+          this.metrics[metricId] = import_api3.metrics.getMeter(this.serviceName).createObservableUpDownCounter(metricId);
+          break;
+      }
+    }
+    this.log("info", "OpenTelemetry (Traces + Logs + Metrics) started");
+  }
+  logger;
+  metrics;
+  log(level, msg, meta = {}) {
+    this.logger.log(level, msg, meta);
+  }
+  info(msg, meta = {}) {
+    this.logger.info(msg, meta);
+  }
+  error(msg, meta = {}) {
+    this.logger.error(msg, meta);
+  }
+  warn(msg, meta = {}) {
+    this.logger.warn(msg, meta);
+  }
+  debug(msg, meta = {}) {
+    this.logger.debug(msg, meta);
+  }
+  trace(msg, meta = {}) {
+    this.logger.trace(msg, meta);
+  }
+  getMetric(metricId) {
+    return this.metrics[metricId];
+  }
+};
+import_dotenv.default.config({ path: getEnvVar("ENV_FILE_PATH") });
+new import_sdk_node.NodeSDK({
+  resource: new import_resources.Resource({
+    [import_semantic_conventions2.ATTR_SERVICE_NAME]: getEnvVar("OTEL_SERVICE_NAME")
+  }),
+  traceExporter: new import_exporter_trace_otlp_http.OTLPTraceExporter({
+    url: `${getEnvVar("OTEL_EXPORTER_OTLP_ENDPOINT") ?? "http://localhost:4318"}/v1/traces`
+  }),
+  metricReader: new import_sdk_metrics.PeriodicExportingMetricReader({
+    exporter: new import_exporter_metrics_otlp_http.OTLPMetricExporter({
+      url: `${getEnvVar("OTEL_EXPORTER_OTLP_ENDPOINT") ?? "http://localhost:4318"}/v1/metrics`
+    }),
+    exportIntervalMillis: 5e3
+  }),
+  logRecordProcessors: [
+    new import_sdk_logs.BatchLogRecordProcessor(
+      new import_exporter_logs_otlp_http.OTLPLogExporter({
+        url: `${getEnvVar("OTEL_EXPORTER_OTLP_ENDPOINT") ?? "http://localhost:4318"}/v1/logs`
+      })
+    )
+  ],
+  instrumentations: [
+    new import_instrumentation_http.HttpInstrumentation({
+      applyCustomAttributesOnSpan: (span, request) => {
+        span.setAttribute(
+          "service.name",
+          getEnvVar("OTEL_SERVICE_NAME") ?? "unknown"
+        );
+        if (isForklaunchRequest(request)) {
+          span.setAttribute("api.name", request.contractDetails?.name);
+        }
+      }
+    }),
+    new import_instrumentation_express.ExpressInstrumentation(),
+    new import_opentelemetry_instrumentation_hyper_express.HyperExpressInstrumentation()
+  ]
+}).start();
+var httpRequestsTotalCounter = import_api3.metrics.getMeter(getEnvVar("OTEL_SERVICE_NAME") || "unknown").createCounter("http_requests_total", {
+  description: "Number of HTTP requests"
+});
+
+// src/http/telemetry/recordMetric.ts
+function recordMetric(req, res) {
+  httpRequestsTotalCounter.add(1, {
+    [import_semantic_conventions3.ATTR_SERVICE_NAME]: getEnvVar("OTEL_SERVICE_NAME"),
+    [ATTR_API_NAME]: req.contractDetails?.name,
+    [ATTR_CORRELATION_ID]: req.context.correlationId,
+    [import_semantic_conventions3.ATTR_HTTP_REQUEST_METHOD]: req.method,
+    [import_semantic_conventions3.ATTR_HTTP_ROUTE]: req.originalPath,
+    [import_semantic_conventions3.ATTR_HTTP_RESPONSE_STATUS_CODE]: res.statusCode || 0
+  });
+}
+
+// src/http/middleware/response/enrichExpressLikeSend.middleware.ts
+function enrichExpressLikeSend(instance, req, res, originalSend, data, shouldEnrich) {
+  let parseErrorSent;
+  if (shouldEnrich) {
+    recordMetric(req, res);
+    if (res.statusCode === 404) {
+      res.status(404);
+      logger("error").error("Not Found");
+      originalSend.call(instance, "Not Found");
+    }
+    parse2(req, res, (err) => {
+      if (err) {
+        let errorString = err.message;
+        if (res.locals.errorMessage) {
+          errorString += `
+------------------
+${res.locals.errorMessage}`;
+        }
+        logger("error").error(errorString);
+        res.status(500);
+        originalSend.call(instance, errorString);
+        parseErrorSent = true;
+      }
+    });
+  }
+  if (!parseErrorSent) {
+    originalSend.call(instance, data);
+  }
+}
+
 // src/http/openApiV3Generator/openApiV3Generator.ts
 function toUpperCase(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
@@ -1962,7 +2311,7 @@ function transformBasePath(basePath) {
   }
   return `/${basePath}`;
 }
-function swaggerDocument(port, tags, paths) {
+function generateOpenApiDocument(port, tags, paths) {
   return {
     openapi: "3.1.0",
     info: {
@@ -2034,7 +2383,10 @@ function generateSwaggerDocument(schemaValidator, port, routers) {
         for (const key in route.contractDetails.params) {
           pathItemObject.parameters?.push({
             name: key,
-            in: "path"
+            in: "path",
+            schema: schemaValidator.openapi(
+              route.contractDetails.params[key]
+            )
           });
         }
       }
@@ -2049,7 +2401,10 @@ function generateSwaggerDocument(schemaValidator, port, routers) {
         for (const key in requestHeaders) {
           pathItemObject.parameters?.push({
             name: key,
-            in: "header"
+            in: "header",
+            schema: schemaValidator.openapi(
+              requestHeaders[key]
+            )
           });
         }
       }
@@ -2057,7 +2412,8 @@ function generateSwaggerDocument(schemaValidator, port, routers) {
         for (const key in query) {
           pathItemObject.parameters?.push({
             name: key,
-            in: "query"
+            in: "query",
+            schema: schemaValidator.openapi(query[key])
           });
         }
       }
@@ -2085,105 +2441,48 @@ function generateSwaggerDocument(schemaValidator, port, routers) {
       }
     });
   });
-  return swaggerDocument(port, tags, paths);
+  return generateOpenApiDocument(port, tags, paths);
 }
 
-// src/http/middleware/response/parse.middleware.ts
-var import_validator2 = require("@forklaunch/validator");
-function parse2(req, res, next) {
-  console.debug("[MIDDLEWARE] parseResponse started");
-  const { headers, responses } = res.responseSchemas;
-  const parsedResponse = req.schemaValidator.parse(
-    responses?.[res.statusCode],
-    res.bodyData
-  );
-  const parsedHeaders = req.schemaValidator.parse(
-    headers ?? req.schemaValidator.unknown,
-    res.getHeaders()
-  );
-  const parseErrors = [];
-  if (!parsedHeaders.ok) {
-    const headerErrors = (0, import_validator2.prettyPrintParseErrors)(parsedHeaders.errors, "Header");
-    if (headerErrors) {
-      parseErrors.push(headerErrors);
-    }
-  }
-  if (!parsedResponse.ok) {
-    const responseErrors = (0, import_validator2.prettyPrintParseErrors)(
-      parsedResponse.errors,
-      "Response"
-    );
-    if (responseErrors) {
-      parseErrors.push(responseErrors);
-    }
-  }
-  if (parseErrors.length > 0) {
-    switch (req.contractDetails.options?.responseValidation) {
-      default:
-      case "error":
-        next?.(new Error(`Invalid response:
-${parseErrors.join("\n\n")}`));
-        break;
-      case "warning":
-        console.warn(`Invalid response:
-${parseErrors.join("\n\n")}`);
-        break;
-      case "none":
-        break;
-    }
-  }
-  next?.();
-}
-
-// src/http/utils/enrichExpressLikeSend.ts
-function enrichExpressLikeSend(instance, req, res, originalSend, data, shouldEnrich) {
-  let parseErrorSent;
-  if (shouldEnrich) {
-    if (res.statusCode === 404) {
-      res.status(404);
-      originalSend.call(instance, "Not Found");
-    }
-    parse2(req, res, (err) => {
-      if (err) {
-        let errorString = err.message;
-        if (res.locals.errorMessage) {
-          errorString += `
-------------------
-${res.locals.errorMessage}`;
-        }
-        res.status(500);
-        originalSend.call(instance, errorString);
-        parseErrorSent = true;
-      }
-    });
-  }
-  if (!parseErrorSent) {
-    originalSend.call(instance, data);
-  }
+// src/http/telemetry/metricsDefinition.ts
+function metricsDefinitions(metrics2) {
+  return metrics2;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ATTR_API_NAME,
+  ATTR_CORRELATION_ID,
+  ATTR_HTTP_REQUEST_METHOD,
+  ATTR_HTTP_RESPONSE_STATUS_CODE,
+  ATTR_HTTP_ROUTE,
+  ATTR_SERVICE_NAME,
   ForklaunchExpressLikeApplication,
   ForklaunchExpressLikeRouter,
   HTTPStatuses,
+  OpenTelemetryCollector,
   delete_,
   enrichExpressLikeSend,
   generateSwaggerDocument,
   get,
   getCodeForStatus,
   head,
+  httpRequestsTotalCounter,
   isClientError,
+  isForklaunchRequest,
   isForklaunchRouter,
   isInformational,
   isRedirection,
   isServerError,
   isSuccessful,
   isValidStatusCode,
+  logger,
+  metricsDefinitions,
   middleware,
   options,
   patch,
   post,
   put,
+  recordMetric,
   trace,
   typedHandler
 });