@forklaunch/core 0.3.6 → 0.4.0

package/lib/http/index.d.mts

@@ -2,6 +2,9 @@ import { AnySchemaValidator, UnboxedObjectSchema, IdiomaticSchema, Schema, Schem
 import { Prettify, RemoveTrailingSlash, MakePropertyOptionalIfChildrenOptional } from '@forklaunch/common';
 import { ParsedQs } from 'qs';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
+import { Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { AnyValueMap } from '@opentelemetry/api-logs';
+import { LevelWithSilentOrString, LevelWithSilent } from 'pino';
 
 interface PathBasedHandler<RouterHandler> {
     (path: string, ...handlers: RouterHandler[]): unknown;
@@ -270,8 +273,12 @@ interface ForklaunchRequest<SV extends AnySchemaValidator, P extends ParamsDicti
     schemaValidator: SchemaValidator;
     /** Method */
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD' | 'CONNECT' | 'TRACE';
+    /** Request path */
+    path: string;
     /** Request schema, compiled */
     requestSchema: unknown;
+    /** Original path */
+    originalPath: string;
 }
 /**
  * Represents the types of data that can be sent in a response.
@@ -805,6 +812,39 @@ declare function typedHandler<SV extends AnySchemaValidator, ContractMethod exte
  */
 declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaValidator: SV, port: string | number, routers: ForklaunchRouter<SV>[]): OpenAPIObject;
 
+type Request = {
+    method: string;
+    originalPath: string;
+    path: string;
+    contractDetails: {
+        name: string;
+    };
+};
+type Response = {
+    statusCode: number;
+};
+
+declare const emitLoggerError: (req: Request, res: Response, errorString: string) => void;
+
+type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
+type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
+
+declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
+    private readonly serviceName;
+    private readonly logger;
+    private readonly metrics;
+    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
+    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
+    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
+}
+declare const httpRequestsTotalCounter: Counter<{
+    'service.name': string;
+    'api.name': string;
+    "http.method": string;
+    "http.route": string;
+    "http.status_code": number;
+}>;
+
 /**
  * Enhances the Express-like `send` method with additional logic for response handling and validation.
  *
@@ -831,7 +871,7 @@ declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaVa
  *
  * @returns {unknown} The return value of the original `send` method, typically the response itself.
  */
-declare function enrichExpressLikeSend<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(instance: unknown, req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>, originalSend: ForklaunchStatusResponse<ForklaunchSendableData>['send'], data: ForklaunchSendableData, shouldEnrich: boolean): void;
+declare function enrichExpressLikeSend<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(instance: unknown, req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>, originalSend: ForklaunchStatusResponse<ForklaunchSendableData>['send'] | ForklaunchStatusResponse<ForklaunchSendableData>['json'], data: ForklaunchSendableData, shouldEnrich: boolean): void;
 
 /**
  * Object-map of the HTTP Status Codes. Maps from the status code, to the
@@ -907,4 +947,6 @@ declare const isServerError: (code: StatusCode) => boolean;
  */
 declare const getCodeForStatus: (status: string) => null | StatusCode;
 
-export { type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, isClientError, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, middleware, options, patch, post, put, trace, typedHandler };
+declare function recordMetric(req: Request, res: Response): void;
+
+export { type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MetricType, type MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, emitLoggerError, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, httpRequestsTotalCounter, isClientError, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, middleware, options, patch, post, put, recordMetric, trace, typedHandler };

package/lib/http/index.d.ts

@@ -2,6 +2,9 @@ import { AnySchemaValidator, UnboxedObjectSchema, IdiomaticSchema, Schema, Schem
 import { Prettify, RemoveTrailingSlash, MakePropertyOptionalIfChildrenOptional } from '@forklaunch/common';
 import { ParsedQs } from 'qs';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
+import { Counter, Gauge, Histogram, UpDownCounter, ObservableCounter, ObservableGauge, ObservableUpDownCounter } from '@opentelemetry/api';
+import { AnyValueMap } from '@opentelemetry/api-logs';
+import { LevelWithSilentOrString, LevelWithSilent } from 'pino';
 
 interface PathBasedHandler<RouterHandler> {
     (path: string, ...handlers: RouterHandler[]): unknown;
@@ -270,8 +273,12 @@ interface ForklaunchRequest<SV extends AnySchemaValidator, P extends ParamsDicti
     schemaValidator: SchemaValidator;
     /** Method */
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD' | 'CONNECT' | 'TRACE';
+    /** Request path */
+    path: string;
     /** Request schema, compiled */
     requestSchema: unknown;
+    /** Original path */
+    originalPath: string;
 }
 /**
  * Represents the types of data that can be sent in a response.
@@ -805,6 +812,39 @@ declare function typedHandler<SV extends AnySchemaValidator, ContractMethod exte
  */
 declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaValidator: SV, port: string | number, routers: ForklaunchRouter<SV>[]): OpenAPIObject;
 
+type Request = {
+    method: string;
+    originalPath: string;
+    path: string;
+    contractDetails: {
+        name: string;
+    };
+};
+type Response = {
+    statusCode: number;
+};
+
+declare const emitLoggerError: (req: Request, res: Response, errorString: string) => void;
+
+type MetricType<T extends string> = T extends 'counter' ? Counter : T extends 'gauge' ? Gauge : T extends 'histogram' ? Histogram : T extends 'upDownCounter' ? UpDownCounter : T extends 'observableCounter' ? ObservableCounter : T extends 'observableGauge' ? ObservableGauge : T extends 'observableUpDownCounter' ? ObservableUpDownCounter : undefined;
+type MetricsDefinition = Record<string, 'counter' | 'gauge' | 'histogram' | 'upDownCounter' | 'observableCounter' | 'observableGauge' | 'observableUpDownCounter'>;
+
+declare class OpenTelemetryCollector<AppliedMetricsDefinition extends MetricsDefinition> {
+    private readonly serviceName;
+    private readonly logger;
+    private readonly metrics;
+    constructor(serviceName: string, level?: LevelWithSilentOrString, metricDefinitions?: AppliedMetricsDefinition);
+    log(level: LevelWithSilent, msg: string, meta?: AnyValueMap): void;
+    getMetric<T extends keyof AppliedMetricsDefinition>(metricId: T): MetricType<AppliedMetricsDefinition[T]>;
+}
+declare const httpRequestsTotalCounter: Counter<{
+    'service.name': string;
+    'api.name': string;
+    "http.method": string;
+    "http.route": string;
+    "http.status_code": number;
+}>;
+
 /**
  * Enhances the Express-like `send` method with additional logic for response handling and validation.
  *
@@ -831,7 +871,7 @@ declare function generateSwaggerDocument<SV extends AnySchemaValidator>(schemaVa
  *
  * @returns {unknown} The return value of the original `send` method, typically the response itself.
  */
-declare function enrichExpressLikeSend<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(instance: unknown, req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>, originalSend: ForklaunchStatusResponse<ForklaunchSendableData>['send'], data: ForklaunchSendableData, shouldEnrich: boolean): void;
+declare function enrichExpressLikeSend<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, string>, LocalsObj extends Record<string, unknown>>(instance: unknown, req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>, originalSend: ForklaunchStatusResponse<ForklaunchSendableData>['send'] | ForklaunchStatusResponse<ForklaunchSendableData>['json'], data: ForklaunchSendableData, shouldEnrich: boolean): void;
 
 /**
  * Object-map of the HTTP Status Codes. Maps from the status code, to the
@@ -907,4 +947,6 @@ declare const isServerError: (code: StatusCode) => boolean;
  */
 declare const getCodeForStatus: (status: string) => null | StatusCode;
 
-export { type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, isClientError, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, middleware, options, patch, post, put, trace, typedHandler };
+declare function recordMetric(req: Request, res: Response): void;
+
+export { type ApiClient, type AuthMethods, type AuthMethodsBase, type Body, type BodyObject, type ConstrainedForklaunchRouter, type ContractDetails, type ContractDetailsExpressLikeSchemaHandler, type ContractDetailsOrMiddlewareOrTypedHandler, type ErrorContainer, type ExpressLikeAuthMapper, type ExpressLikeHandler, type ExpressLikeRouter, type ExpressLikeSchemaAuthMapper, type ExpressLikeSchemaHandler, type ExtractedParamsObject, type ForklaunchBaseRequest, ForklaunchExpressLikeApplication, ForklaunchExpressLikeRouter, type ForklaunchNextFunction, type ForklaunchRequest, type ForklaunchResErrors, type ForklaunchResHeaders, type ForklaunchResponse, type ForklaunchRoute, type ForklaunchRouter, type ForklaunchSendableData, type ForklaunchStatusResponse, HTTPStatuses, type HeadersObject, type HttpContractDetails, type HttpMethod, type LiveTypeFunction, type LiveTypeRouteDefinition, type MapParamsSchema, type MapReqBodySchema, type MapReqHeadersSchema, type MapReqQuerySchema, type MapResBodyMapSchema, type MapResHeadersSchema, type MapSchema, type Method, type MetricType, type MetricsDefinition, type MiddlewareContractDetails, type MiddlewareOrMiddlewareWithTypedHandler, type NestableRouterBasedHandler, type NumberOnlyObject, OpenTelemetryCollector, type ParamsDictionary, type ParamsObject, type PathBasedHandler, type PathMatch, type PathOrMiddlewareBasedHandler, type PathParamHttpContractDetails, type PathParamMethod, type QueryObject, type RequestContext, type ResponseCompiledSchema, type ResponseShape, type ResponsesObject, type SchemaAuthMethods, type StatusCode, type StringOnlyObject, type TypedHandler, type TypedMiddlewareDefinition, type TypedNestableMiddlewareDefinition, delete_, emitLoggerError, enrichExpressLikeSend, generateSwaggerDocument, get, getCodeForStatus, head, httpRequestsTotalCounter, isClientError, isForklaunchRouter, isInformational, isRedirection, isServerError, isSuccessful, isValidStatusCode, middleware, options, patch, post, put, recordMetric, trace, typedHandler };

package/lib/http/index.js

@@ -33,12 +33,15 @@ __export(http_exports, {
   ForklaunchExpressLikeApplication: () => ForklaunchExpressLikeApplication,
   ForklaunchExpressLikeRouter: () => ForklaunchExpressLikeRouter,
   HTTPStatuses: () => HTTPStatuses,
+  OpenTelemetryCollector: () => OpenTelemetryCollector,
   delete_: () => delete_,
+  emitLoggerError: () => emitLoggerError,
   enrichExpressLikeSend: () => enrichExpressLikeSend,
   generateSwaggerDocument: () => generateSwaggerDocument,
   get: () => get,
   getCodeForStatus: () => getCodeForStatus,
   head: () => head,
+  httpRequestsTotalCounter: () => httpRequestsTotalCounter,
   isClientError: () => isClientError,
   isForklaunchRouter: () => isForklaunchRouter,
   isInformational: () => isInformational,
@@ -51,11 +54,39 @@ __export(http_exports, {
   patch: () => patch,
   post: () => post,
   put: () => put,
+  recordMetric: () => recordMetric,
   trace: () => trace,
   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_uuid = require("uuid");
+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
+    };
+    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,55 +246,25 @@ 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;
@@ -281,7 +282,6 @@ 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,
@@ -319,8 +319,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 +330,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 +362,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) {
+          next(error);
+        } else {
+          throw error;
         }
       }
     };
@@ -534,7 +537,7 @@ var ForklaunchExpressLikeRouter = class {
         const controllerHandler = this.#extractControllerHandler(handlers);
         registrationMethod.bind(this.internal)(
           path,
-          ...this.#resolveMiddlewares(contractDetails, requestSchema, responseSchemas).concat(
+          ...this.#resolveMiddlewares(path, contractDetails, requestSchema, responseSchemas).concat(
             handlers
           ),
           this.#parseAndRunControllerHandler(controllerHandler)
@@ -895,6 +898,8 @@ var ForklaunchExpressLikeApplication = class extends ForklaunchExpressLikeRouter
     super("/", schemaValidator, internal);
     this.schemaValidator = schemaValidator;
     this.internal = internal;
+    this.internal.use(createContext(this.schemaValidator));
+    this.internal.use(cors);
   }
 };
 
@@ -1962,7 +1967,7 @@ function transformBasePath(basePath) {
   }
   return `/${basePath}`;
 }
-function swaggerDocument(port, tags, paths) {
+function generateOpenApiDocument(port, tags, paths) {
   return {
     openapi: "3.1.0",
     info: {
@@ -2034,7 +2039,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 +2057,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 +2068,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,13 +2097,164 @@ function generateSwaggerDocument(schemaValidator, port, routers) {
       }
     });
   });
-  return swaggerDocument(port, tags, paths);
+  return generateOpenApiDocument(port, tags, paths);
 }
 
+// src/http/tracing/emitLoggerError.ts
+var import_api_logs = require("@opentelemetry/api-logs");
+var import_semantic_conventions = require("@opentelemetry/semantic-conventions");
+
+// src/http/tracing/pinoLogger.ts
+var import_pino = __toESM(require("pino"));
+function pinoLogger(level) {
+  return (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 }
+    }
+  });
+}
+
+// src/http/tracing/emitLoggerError.ts
+var logger = pinoLogger("error");
+var emitLoggerError = (req, res, errorString) => {
+  import_api_logs.logs.getLogger(process.env.SERVICE_NAME ?? "unknown").emit({
+    severityText: "ERROR",
+    severityNumber: 17,
+    body: errorString,
+    attributes: {
+      "service.name": process.env.SERVICE_NAME,
+      "api.name": req.contractDetails?.name,
+      [import_semantic_conventions.SEMATTRS_HTTP_TARGET]: req.path,
+      [import_semantic_conventions.SEMATTRS_HTTP_ROUTE]: req.originalPath,
+      [import_semantic_conventions.SEMATTRS_HTTP_METHOD]: req.method,
+      [import_semantic_conventions.SEMATTRS_HTTP_STATUS_CODE]: res.statusCode
+    }
+  });
+  logger.error(errorString);
+};
+
+// src/http/tracing/openTelemetryCollector.ts
+var import_opentelemetry_instrumentation_hyper_express = require("@forklaunch/opentelemetry-instrumentation-hyper-express");
+var import_api = require("@opentelemetry/api");
+var import_api_logs2 = require("@opentelemetry/api-logs");
+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 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 = pinoLogger(level ?? "info");
+    this.metrics = {};
+    for (const [metricId, metricType] of Object.entries(
+      metricDefinitions ?? {}
+    )) {
+      switch (metricType) {
+        case "counter":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createCounter(metricId);
+          break;
+        case "gauge":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createGauge(metricId);
+          break;
+        case "histogram":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createHistogram(metricId);
+          break;
+        case "upDownCounter":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createUpDownCounter(metricId);
+          break;
+        case "observableCounter":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createObservableCounter(metricId);
+          break;
+        case "observableGauge":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createObservableGauge(metricId);
+          break;
+        case "observableUpDownCounter":
+          this.metrics[metricId] = import_api.metrics.getMeter(this.serviceName).createObservableUpDownCounter(metricId);
+          break;
+      }
+    }
+    this.log("info", "OpenTelemetry (Traces + Logs + Metrics) started");
+  }
+  logger;
+  metrics;
+  log(level, msg, meta = {}) {
+    const activeSpan = import_api.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.api_name = activeSpan?.attributes["api.name"] ?? "undefined";
+    }
+    this.logger[level](msg);
+    import_api_logs2.logs.getLogger(this.serviceName).emit({
+      severityText: level,
+      body: msg,
+      attributes: meta
+    });
+  }
+  getMetric(metricId) {
+    return this.metrics[metricId];
+  }
+};
+new import_sdk_node.NodeSDK({
+  resource: new import_resources.Resource({
+    [import_semantic_conventions2.ATTR_SERVICE_NAME]: process.env.SERVICE_NAME
+  }),
+  traceExporter: new import_exporter_trace_otlp_http.OTLPTraceExporter({
+    url: `${process.env.OTEL_EXPORTER_OTLP_ENDPOINT ?? "http://localhost:4318"}/v1/traces`
+  }),
+  metricReader: new import_sdk_metrics.PeriodicExportingMetricReader({
+    exporter: new import_exporter_metrics_otlp_http.OTLPMetricExporter({
+      url: `${process.env.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: `${process.env.OTEL_EXPORTER_OTLP_ENDPOINT ?? "http://localhost:4318"}/v1/logs`
+      })
+    )
+  ],
+  instrumentations: [
+    new import_instrumentation_http.HttpInstrumentation(),
+    new import_instrumentation_express.ExpressInstrumentation({
+      requestHook: (span, info) => {
+        span.setAttribute(
+          "service.name",
+          process.env.SERVICE_NAME ?? "unknown"
+        );
+        span.setAttribute("api.name", info.request.contractDetails?.name);
+      }
+    }),
+    new import_opentelemetry_instrumentation_hyper_express.HyperExpressInstrumentation()
+  ]
+}).start();
+var httpRequestsTotalCounter = import_api.metrics.getMeter(process.env.SERVICE_NAME || "unknown").createCounter("http_requests_total", {
+  description: "Number of HTTP requests"
+});
+
 // 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],
@@ -2141,6 +2304,7 @@ function enrichExpressLikeSend(instance, req, res, originalSend, data, shouldEnr
   if (shouldEnrich) {
     if (res.statusCode === 404) {
       res.status(404);
+      emitLoggerError(req, res, "Not Found");
       originalSend.call(instance, "Not Found");
     }
     parse2(req, res, (err) => {
@@ -2151,6 +2315,7 @@ function enrichExpressLikeSend(instance, req, res, originalSend, data, shouldEnr
 ------------------
 ${res.locals.errorMessage}`;
         }
+        emitLoggerError(req, res, errorString);
         res.status(500);
         originalSend.call(instance, errorString);
         parseErrorSent = true;
@@ -2161,17 +2326,32 @@ ${res.locals.errorMessage}`;
     originalSend.call(instance, data);
   }
 }
+
+// src/http/utils/recordMetric.ts
+var import_semantic_conventions3 = require("@opentelemetry/semantic-conventions");
+function recordMetric(req, res) {
+  httpRequestsTotalCounter.add(1, {
+    "service.name": process.env.SERVICE_NAME ?? "unknown",
+    "api.name": req.contractDetails?.name,
+    [import_semantic_conventions3.SEMATTRS_HTTP_METHOD]: req.method,
+    [import_semantic_conventions3.SEMATTRS_HTTP_ROUTE]: req.originalPath,
+    [import_semantic_conventions3.SEMATTRS_HTTP_STATUS_CODE]: res.statusCode || 0
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ForklaunchExpressLikeApplication,
   ForklaunchExpressLikeRouter,
   HTTPStatuses,
+  OpenTelemetryCollector,
   delete_,
+  emitLoggerError,
   enrichExpressLikeSend,
   generateSwaggerDocument,
   get,
   getCodeForStatus,
   head,
+  httpRequestsTotalCounter,
   isClientError,
   isForklaunchRouter,
   isInformational,
@@ -2184,6 +2364,7 @@ ${res.locals.errorMessage}`;
   patch,
   post,
   put,
+  recordMetric,
   trace,
   typedHandler
 });