@emmett-community/emmett-expressjs-with-openapi 0.2.0 → 0.4.0

package/dist/index.cjs

@@ -3,12 +3,16 @@
 var _chunkMRSGTROWcjs = require('./chunk-MRSGTROW.cjs');
 
 
+var _chunkBY65ZALYcjs = require('./chunk-BY65ZALY.cjs');
+
+
 var _chunkGS7T56RPcjs = require('./chunk-GS7T56RP.cjs');
 
 // src/index.ts
 require('express-async-errors');
 
 // src/application.ts
+var _api = require('@opentelemetry/api');
 
 
 var _express = require('express'); var _express2 = _interopRequireDefault(_express);
@@ -18,7 +22,8 @@ var _module = require('module');
 
 // src/middlewares/problemDetailsMiddleware.ts
 var _httpproblemdetails = require('http-problem-details');
-var problemDetailsMiddleware = (mapError) => (error, request, response, _next) => {
+var problemDetailsMiddleware = (mapError, logger) => (error, request, response, _next) => {
+  _chunkBY65ZALYcjs.safeLog.error(logger, "Request error", error);
   let problemDetails;
   if (mapError) problemDetails = mapError(error, request);
   problemDetails = _nullishCoalesce(problemDetails, () => ( defaultErrorToProblemDetailsMapping(error)));
@@ -42,6 +47,7 @@ var defaultErrorToProblemDetailsMapping = (error) => {
 };
 
 // src/application.ts
+var tracer = _api.trace.getTracer("@emmett-community/emmett-expressjs-with-openapi");
 var getApplication = async (options) => {
   const app = _express2.default.call(void 0, );
   const {
@@ -51,10 +57,39 @@ var getApplication = async (options) => {
     disableJsonMiddleware,
     disableUrlEncodingMiddleware,
     disableProblemDetailsMiddleware,
-    openApiValidator
+    pinoHttp,
+    openApiValidator,
+    observability
   } = options;
+  const logger = _optionalChain([observability, 'optionalAccess', _ => _.logger]);
+  _chunkBY65ZALYcjs.safeLog.debug(logger, "Initializing Express application", {
+    hasApis: !!_optionalChain([apis, 'optionalAccess', _2 => _2.length]),
+    hasOpenApiValidator: !!openApiValidator,
+    hasPinoHttp: !!pinoHttp
+  });
   const router = _express.Router.call(void 0, );
   app.set("etag", _nullishCoalesce(enableDefaultExpressEtag, () => ( false)));
+  if (pinoHttp !== void 0 && pinoHttp !== false) {
+    try {
+      const require2 = _module.createRequire.call(void 0, _chunkGS7T56RPcjs.importMetaUrl);
+      const mod = require2("pino-http");
+      const provider = _nullishCoalesce(mod.default, () => ( mod));
+      if (typeof provider !== "function") {
+        throw new Error("Invalid pino-http module: missing default export");
+      }
+      const options2 = pinoHttp === true ? void 0 : pinoHttp;
+      const middleware = provider(options2);
+      app.use(middleware);
+    } catch (error) {
+      _chunkBY65ZALYcjs.safeLog.warn(
+        logger,
+        "Pino HTTP configuration provided but pino-http package is not installed. Install it with: npm install pino-http"
+      );
+      throw new Error(
+        "pino-http package is required when pinoHttp option is used"
+      );
+    }
+  }
   if (!disableJsonMiddleware) app.use(_express2.default.json());
   if (!disableUrlEncodingMiddleware)
     app.use(
@@ -68,20 +103,52 @@ var getApplication = async (options) => {
       activateESMResolver();
       const handlersBasePath = typeof openApiValidator.operationHandlers === "string" ? openApiValidator.operationHandlers : openApiValidator.operationHandlers.basePath;
       if (handlersBasePath) {
-        const { extractHandlerModules } = await Promise.resolve().then(() => _interopRequireWildcard(require("./openapi-parser-NFUD7ZGZ.cjs")));
-        const { importAndRegisterHandlers } = await Promise.resolve().then(() => _interopRequireWildcard(require("./handler-importer-4BVBIZX3.cjs")));
-        try {
-          const modules = await extractHandlerModules(
-            openApiValidator.apiSpec,
-            handlersBasePath
-          );
-          const importedHandlers = await importAndRegisterHandlers(modules);
-          if (openApiValidator.initializeHandlers) {
-            await openApiValidator.initializeHandlers(importedHandlers);
+        const { extractHandlerModules } = await Promise.resolve().then(() => _interopRequireWildcard(require("./openapi-parser-PW5USNZ4.cjs")));
+        const { importAndRegisterHandlers } = await Promise.resolve().then(() => _interopRequireWildcard(require("./handler-importer-UFV7TKBN.cjs")));
+        const modules = await tracer.startActiveSpan(
+          "emmett.openapi.parse_spec",
+          async (span) => {
+            try {
+              const result = await extractHandlerModules(
+                openApiValidator.apiSpec,
+                handlersBasePath,
+                logger
+              );
+              span.setAttribute("emmett.handlers.count", result.length);
+              span.setStatus({ code: _api.SpanStatusCode.OK });
+              return result;
+            } catch (error) {
+              span.recordException(error);
+              span.setStatus({ code: _api.SpanStatusCode.ERROR });
+              throw error;
+            } finally {
+              span.end();
+            }
+          }
+        );
+        const importedHandlers = await tracer.startActiveSpan(
+          "emmett.http.import_handlers",
+          async (span) => {
+            try {
+              const result = await importAndRegisterHandlers(modules, logger);
+              span.setAttribute(
+                "emmett.handlers.count",
+                Object.keys(result).length
+              );
+              span.setStatus({ code: _api.SpanStatusCode.OK });
+              return result;
+            } catch (error) {
+              _chunkBY65ZALYcjs.safeLog.error(logger, "Failed to auto-import handler modules", error);
+              span.recordException(error);
+              span.setStatus({ code: _api.SpanStatusCode.ERROR });
+              throw error;
+            } finally {
+              span.end();
+            }
           }
-        } catch (error) {
-          console.error("Failed to auto-import handler modules:", error);
-          throw error;
+        );
+        if (openApiValidator.initializeHandlers) {
+          await openApiValidator.initializeHandlers(importedHandlers);
         }
       }
     } else {
@@ -117,8 +184,9 @@ var getApplication = async (options) => {
       } else {
         app.use(middleware);
       }
-    } catch (e) {
-      console.warn(
+    } catch (error) {
+      _chunkBY65ZALYcjs.safeLog.warn(
+        logger,
         "OpenAPI validator configuration provided but express-openapi-validator package is not installed. Install it with: npm install express-openapi-validator"
       );
       throw new Error(
@@ -133,14 +201,15 @@ var getApplication = async (options) => {
     app.use(router);
   }
   if (!disableProblemDetailsMiddleware)
-    app.use(problemDetailsMiddleware(mapError));
+    app.use(problemDetailsMiddleware(mapError, logger));
+  _chunkBY65ZALYcjs.safeLog.info(logger, "Express application initialized");
   return app;
 };
 var startAPI = (app, options = { port: 3e3 }) => {
-  const { port } = options;
+  const { port, logger } = options;
   const server = _http2.default.createServer(app);
   server.on("listening", () => {
-    console.info("server up listening");
+    _chunkBY65ZALYcjs.safeLog.info(logger, "Server up listening", { port });
   });
   return server.listen(port);
 };
@@ -194,10 +263,34 @@ var getETagValueFromIfMatch = (request) => {
 };
 
 // src/handler.ts
+
+var tracer2 = _api.trace.getTracer("@emmett-community/emmett-expressjs-with-openapi");
 var on = (handle) => async (request, response, _next) => {
   const setResponse = await Promise.resolve(handle(request));
   return setResponse(response);
 };
+var tracedOn = (handle, options) => async (request, response, _next) => {
+  const spanName = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _3 => _3.spanName]), () => ( "emmett.http.handle_request"));
+  return tracer2.startActiveSpan(spanName, async (span) => {
+    try {
+      span.setAttribute("http.method", request.method);
+      const route = (_nullishCoalesce(request.baseUrl, () => ( ""))) + (_nullishCoalesce(_optionalChain([request, 'access', _4 => _4.route, 'optionalAccess', _5 => _5.path]), () => ( request.path)));
+      span.setAttribute("http.route", route);
+      const setResponse = await Promise.resolve(handle(request));
+      setResponse(response);
+      span.setAttribute("http.status_code", response.statusCode);
+      span.setStatus({
+        code: response.statusCode >= 400 ? _api.SpanStatusCode.ERROR : _api.SpanStatusCode.OK
+      });
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({ code: _api.SpanStatusCode.ERROR });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+};
 var OK = (options) => (response) => {
   send(response, 200, options);
 };
@@ -271,7 +364,7 @@ var createFirebaseAuthSecurityHandlers = (options = {}) => {
       const isAuthenticated = await runMiddleware(middleware, req);
       if (!isAuthenticated) return false;
       if (!scopes.length) return true;
-      const roles = _optionalChain([req, 'optionalAccess', _ => _.auth, 'optionalAccess', _2 => _2.token, 'optionalAccess', _3 => _3[roleClaim]]);
+      const roles = _optionalChain([req, 'optionalAccess', _6 => _6.auth, 'optionalAccess', _7 => _7.token, 'optionalAccess', _8 => _8[roleClaim]]);
       if (!Array.isArray(roles)) return false;
       return scopes.every((scope) => roles.includes(scope));
     }
@@ -282,24 +375,24 @@ var createFirebaseAuthSecurityHandlers = (options = {}) => {
 var createOpenApiValidatorOptions = (apiSpec, options) => {
   return {
     apiSpec,
-    validateRequests: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _4 => _4.validateRequests]), () => ( true)),
-    validateResponses: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _5 => _5.validateResponses]), () => ( false)),
-    validateSecurity: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _6 => _6.validateSecurity]), () => ( true)),
-    validateFormats: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _7 => _7.validateFormats]), () => ( true)),
-    operationHandlers: _optionalChain([options, 'optionalAccess', _8 => _8.operationHandlers]),
-    ignorePaths: _optionalChain([options, 'optionalAccess', _9 => _9.ignorePaths]),
-    validateApiSpec: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _10 => _10.validateApiSpec]), () => ( true)),
-    $refParser: _optionalChain([options, 'optionalAccess', _11 => _11.$refParser]),
-    serveSpec: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _12 => _12.serveSpec]), () => ( false)),
-    fileUploader: _optionalChain([options, 'optionalAccess', _13 => _13.fileUploader]),
-    initializeHandlers: _optionalChain([options, 'optionalAccess', _14 => _14.initializeHandlers])
+    validateRequests: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _9 => _9.validateRequests]), () => ( true)),
+    validateResponses: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _10 => _10.validateResponses]), () => ( false)),
+    validateSecurity: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _11 => _11.validateSecurity]), () => ( true)),
+    validateFormats: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _12 => _12.validateFormats]), () => ( true)),
+    operationHandlers: _optionalChain([options, 'optionalAccess', _13 => _13.operationHandlers]),
+    ignorePaths: _optionalChain([options, 'optionalAccess', _14 => _14.ignorePaths]),
+    validateApiSpec: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _15 => _15.validateApiSpec]), () => ( true)),
+    $refParser: _optionalChain([options, 'optionalAccess', _16 => _16.$refParser]),
+    serveSpec: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _17 => _17.serveSpec]), () => ( false)),
+    fileUploader: _optionalChain([options, 'optionalAccess', _18 => _18.fileUploader]),
+    initializeHandlers: _optionalChain([options, 'optionalAccess', _19 => _19.initializeHandlers])
   };
 };
 var isOpenApiValidatorAvailable = async () => {
   try {
     await Promise.resolve().then(() => _interopRequireWildcard(require("express-openapi-validator")));
     return true;
-  } catch (e2) {
+  } catch (e) {
     return false;
   }
 };
@@ -483,5 +576,7 @@ var ApiSpecification = {
 
 
 
-exports.Accepted = Accepted; exports.ApiE2ESpecification = ApiE2ESpecification; exports.ApiSpecification = ApiSpecification; exports.BadRequest = BadRequest; exports.Conflict = Conflict; exports.Created = Created; exports.DefaultHttpProblemResponseOptions = DefaultHttpProblemResponseOptions; exports.DefaultHttpResponseOptions = DefaultHttpResponseOptions; exports.ETagErrors = ETagErrors; exports.Forbidden = Forbidden; exports.HeaderNames = HeaderNames; exports.HttpProblem = HttpProblem; exports.HttpResponse = HttpResponse; exports.NoContent = NoContent; exports.NotFound = NotFound; exports.OK = OK; exports.PreconditionFailed = PreconditionFailed; exports.WeakETagRegex = WeakETagRegex; exports.createFirebaseAuthSecurityHandlers = createFirebaseAuthSecurityHandlers; exports.createOpenApiValidatorOptions = createOpenApiValidatorOptions; exports.existingStream = existingStream; exports.expect = expect; exports.expectError = expectError; exports.expectNewEvents = expectNewEvents; exports.expectResponse = expectResponse; exports.getApplication = getApplication; exports.getETagFromIfMatch = getETagFromIfMatch; exports.getETagFromIfNotMatch = getETagFromIfNotMatch; exports.getETagValueFromIfMatch = getETagValueFromIfMatch; exports.getWeakETagValue = getWeakETagValue; exports.isOpenApiValidatorAvailable = isOpenApiValidatorAvailable; exports.isWeakETag = isWeakETag; exports.on = on; exports.registerHandlerModule = _chunkMRSGTROWcjs.registerHandlerModule; exports.send = send; exports.sendAccepted = sendAccepted; exports.sendCreated = sendCreated; exports.sendProblem = sendProblem; exports.setETag = setETag; exports.startAPI = startAPI; exports.toWeakETag = toWeakETag;
+
+
+exports.Accepted = Accepted; exports.ApiE2ESpecification = ApiE2ESpecification; exports.ApiSpecification = ApiSpecification; exports.BadRequest = BadRequest; exports.Conflict = Conflict; exports.Created = Created; exports.DefaultHttpProblemResponseOptions = DefaultHttpProblemResponseOptions; exports.DefaultHttpResponseOptions = DefaultHttpResponseOptions; exports.ETagErrors = ETagErrors; exports.Forbidden = Forbidden; exports.HeaderNames = HeaderNames; exports.HttpProblem = HttpProblem; exports.HttpResponse = HttpResponse; exports.NoContent = NoContent; exports.NotFound = NotFound; exports.OK = OK; exports.PreconditionFailed = PreconditionFailed; exports.WeakETagRegex = WeakETagRegex; exports.createFirebaseAuthSecurityHandlers = createFirebaseAuthSecurityHandlers; exports.createOpenApiValidatorOptions = createOpenApiValidatorOptions; exports.existingStream = existingStream; exports.expect = expect; exports.expectError = expectError; exports.expectNewEvents = expectNewEvents; exports.expectResponse = expectResponse; exports.getApplication = getApplication; exports.getETagFromIfMatch = getETagFromIfMatch; exports.getETagFromIfNotMatch = getETagFromIfNotMatch; exports.getETagValueFromIfMatch = getETagValueFromIfMatch; exports.getWeakETagValue = getWeakETagValue; exports.isOpenApiValidatorAvailable = isOpenApiValidatorAvailable; exports.isWeakETag = isWeakETag; exports.on = on; exports.registerHandlerModule = _chunkMRSGTROWcjs.registerHandlerModule; exports.safeLog = _chunkBY65ZALYcjs.safeLog; exports.send = send; exports.sendAccepted = sendAccepted; exports.sendCreated = sendCreated; exports.sendProblem = sendProblem; exports.setETag = setETag; exports.startAPI = startAPI; exports.toWeakETag = toWeakETag; exports.tracedOn = tracedOn;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/index.cjs","../src/index.ts","../src/application.ts","../src/middlewares/problemDetailsMiddleware.ts","../src/etag.ts","../src/handler.ts","../src/openapi/firebase-auth.ts","../src/openapi/index.ts","../src/responses.ts","../src/testing/apiE2ESpecification.ts","../src/testing/apiSpecification.ts"],"names":["require","ETagErrors"],"mappings":"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","file":"/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/index.cjs","sourcesContent":[null,"import 'express-async-errors';\n\nexport * from './application';\nexport * from './etag';\nexport * from './handler';\nexport * from './openapi';\nexport * from './responses';\nexport * from './testing';\nexport { registerHandlerModule } from './internal/esm-resolver';\n","import express, {\n  Router,\n  type Application,\n  type RequestHandler,\n} from 'express';\nimport 'express-async-errors';\nimport http from 'http';\nimport { createRequire } from 'node:module';\nimport { problemDetailsMiddleware } from './middlewares/problemDetailsMiddleware';\nimport type { OpenApiValidatorOptions } from './openapi';\nimport type { ErrorToProblemDetailsMapping } from './responses';\n\n// #region web-api-setup\nexport type WebApiSetup = (router: Router) => void;\n// #endregion web-api-setup\n\nexport type ApplicationOptions = {\n  apis?: WebApiSetup[];\n  mapError?: ErrorToProblemDetailsMapping;\n  enableDefaultExpressEtag?: boolean;\n  disableJsonMiddleware?: boolean;\n  disableUrlEncodingMiddleware?: boolean;\n  disableProblemDetailsMiddleware?: boolean;\n  /**\n   * Optional OpenAPI validator configuration.\n   * When provided, enables request/response validation against an OpenAPI specification.\n   * Requires the 'express-openapi-validator' package to be installed.\n   *\n   * @see https://github.com/cdimascio/express-openapi-validator\n   * @example\n   * ```typescript\n   * import { getApplication, createOpenApiValidatorOptions } from '@event-driven-io/emmett-expressjs';\n   *\n   * type AppDeps = {\n   *   eventStore: EventStore;\n   *   messageBus: EventsPublisher;\n   * };\n   *\n   * const app = await getApplication({\n   *   openApiValidator: createOpenApiValidatorOptions<AppDeps>('./openapi.yaml', {\n   *     validateResponses: true,\n   *     operationHandlers: './handlers',\n   *     initializeHandlers: (deps) => {\n   *       initializeHandlers(deps.eventStore, deps.messageBus);\n   *     }\n   *   })\n   * });\n   * ```\n   */\n  openApiValidator?: OpenApiValidatorOptions;\n};\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const app: Application = express();\n\n  const {\n    apis,\n    mapError,\n    enableDefaultExpressEtag,\n    disableJsonMiddleware,\n    disableUrlEncodingMiddleware,\n    disableProblemDetailsMiddleware,\n    openApiValidator,\n  } = options;\n\n  const router = Router();\n\n  // disabling default etag behaviour\n  // to use etags in if-match and if-not-match headers\n  app.set('etag', enableDefaultExpressEtag ?? false);\n\n  // add json middleware\n  if (!disableJsonMiddleware) app.use(express.json());\n\n  // enable url encoded urls and bodies\n  if (!disableUrlEncodingMiddleware)\n    app.use(\n      express.urlencoded({\n        extended: true,\n      }),\n    );\n\n  // add OpenAPI validator middleware if configured\n  if (openApiValidator) {\n    // Activate ESM resolver if operationHandlers are configured\n    // This ensures handler modules are loaded via ESM import() instead of CJS require(),\n    // preventing dual module loading issues when using TypeScript runtimes (tsx, ts-node)\n    if (openApiValidator.operationHandlers) {\n      const { activateESMResolver } = await import(\n        './internal/esm-resolver.js'\n      );\n      activateESMResolver();\n\n      // NEW: Auto-discover and import handler modules from OpenAPI spec\n      const handlersBasePath =\n        typeof openApiValidator.operationHandlers === 'string'\n          ? openApiValidator.operationHandlers\n          : openApiValidator.operationHandlers.basePath;\n\n      if (handlersBasePath) {\n        const { extractHandlerModules } = await import(\n          './internal/openapi-parser.js'\n        );\n        const { importAndRegisterHandlers } = await import(\n          './internal/handler-importer.js'\n        );\n\n        try {\n          // Parse OpenAPI spec to find handler modules\n          const modules = await extractHandlerModules(\n            openApiValidator.apiSpec,\n            handlersBasePath,\n          );\n\n          // Dynamically import and register all handler modules\n          const importedHandlers = await importAndRegisterHandlers(modules);\n\n          // Call user's initializeHandlers callback with imported modules\n          if (openApiValidator.initializeHandlers) {\n            await openApiValidator.initializeHandlers(importedHandlers);\n          }\n        } catch (error) {\n          console.error('Failed to auto-import handler modules:', error);\n          throw error;\n        }\n      }\n    } else {\n      // No operationHandlers, just call initializeHandlers if provided\n      if (openApiValidator.initializeHandlers) {\n        await openApiValidator.initializeHandlers();\n      }\n    }\n\n    try {\n      const require = createRequire(import.meta.url);\n      // express-openapi-validator exports a default with .middleware (ESM/CJS compatibility)\n      const mod = require('express-openapi-validator') as Record<\n        string,\n        unknown\n      >;\n      const provider = (mod.default ?? mod) as Record<string, unknown>;\n\n      if (typeof provider.middleware !== 'function') {\n        throw new Error(\n          'Invalid express-openapi-validator module: missing middleware export',\n        );\n      }\n\n      // Serve OpenAPI spec if configured\n      if (openApiValidator.serveSpec) {\n        if (typeof openApiValidator.apiSpec === 'string') {\n          // If apiSpec is a file path, serve it as a static file\n          app.use(\n            openApiValidator.serveSpec,\n            express.static(openApiValidator.apiSpec),\n          );\n        } else {\n          // If apiSpec is an object, serve it as JSON\n          app.get(openApiValidator.serveSpec, (_req, res) => {\n            res.json(openApiValidator.apiSpec);\n          });\n        }\n      }\n\n      const factory = provider.middleware as (\n        opts: OpenApiValidatorOptions,\n      ) => RequestHandler | RequestHandler[];\n      const middleware = factory(openApiValidator);\n      if (Array.isArray(middleware)) {\n        for (const m of middleware) app.use(m);\n      } else {\n        app.use(middleware);\n      }\n    } catch {\n      console.warn(\n        'OpenAPI validator configuration provided but express-openapi-validator package is not installed. ' +\n          'Install it with: npm install express-openapi-validator',\n      );\n      throw new Error(\n        'express-openapi-validator package is required when openApiValidator option is used',\n      );\n    }\n  }\n\n  // Register API routes if provided\n  if (apis) {\n    for (const api of apis) {\n      api(router);\n    }\n    app.use(router);\n  }\n\n  // add problem details middleware\n  if (!disableProblemDetailsMiddleware)\n    app.use(problemDetailsMiddleware(mapError));\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n};\n\nexport const startAPI = (\n  app: Application,\n  options: StartApiOptions = { port: 3000 },\n) => {\n  const { port } = options;\n  const server = http.createServer(app);\n\n  server.on('listening', () => {\n    console.info('server up listening');\n  });\n\n  return server.listen(port);\n};\n","import type { NextFunction, Request, Response } from 'express';\nimport { ProblemDocument } from 'http-problem-details';\nimport { sendProblem, type ErrorToProblemDetailsMapping } from '..';\n\nexport const problemDetailsMiddleware =\n  (mapError?: ErrorToProblemDetailsMapping) =>\n  (\n    error: Error,\n    request: Request,\n    response: Response,\n    _next: NextFunction,\n  ): void => {\n    let problemDetails: ProblemDocument | undefined;\n\n    if (mapError) problemDetails = mapError(error, request);\n\n    problemDetails =\n      problemDetails ?? defaultErrorToProblemDetailsMapping(error);\n\n    sendProblem(response, problemDetails.status, { problem: problemDetails });\n  };\n\nexport const defaultErrorToProblemDetailsMapping = (\n  error: Error,\n): ProblemDocument => {\n  let statusCode = 500;\n\n  // Prefer standard `status` code if present (e.g., express-openapi-validator)\n  const errObj = error as unknown as Record<string, unknown>;\n  const maybeStatus = errObj['status'];\n  if (\n    typeof maybeStatus === 'number' &&\n    maybeStatus >= 100 &&\n    maybeStatus < 600\n  ) {\n    statusCode = maybeStatus;\n  }\n\n  const maybeErrorCode = errObj['errorCode'];\n  if (\n    typeof maybeErrorCode === 'number' &&\n    maybeErrorCode >= 100 &&\n    maybeErrorCode < 600\n  ) {\n    statusCode = maybeErrorCode;\n  }\n\n  return new ProblemDocument({\n    detail: error.message,\n    status: statusCode,\n  });\n};\n","import { type Brand } from '@event-driven-io/emmett';\nimport type { Request, Response } from 'express';\n\n//////////////////////////////////////\n/// ETAG\n//////////////////////////////////////\n\nexport const HeaderNames = {\n  IF_MATCH: 'if-match',\n  IF_NOT_MATCH: 'if-not-match',\n  ETag: 'etag',\n};\n\nexport type WeakETag = Brand<`W/${string}`, 'ETag'>;\nexport type ETag = Brand<string, 'ETag'>;\n\nexport const WeakETagRegex = /W\\/\"(-?\\d+.*)\"/;\n\nexport const enum ETagErrors {\n  WRONG_WEAK_ETAG_FORMAT = 'WRONG_WEAK_ETAG_FORMAT',\n  MISSING_IF_MATCH_HEADER = 'MISSING_IF_MATCH_HEADER',\n  MISSING_IF_NOT_MATCH_HEADER = 'MISSING_IF_NOT_MATCH_HEADER',\n}\n\nexport const isWeakETag = (etag: ETag): etag is WeakETag => {\n  return WeakETagRegex.test(etag as string);\n};\n\nexport const getWeakETagValue = (etag: ETag): string => {\n  const result = WeakETagRegex.exec(etag as string);\n  if (result === null || result.length === 0) {\n    throw new Error(ETagErrors.WRONG_WEAK_ETAG_FORMAT);\n  }\n  return result[1]!;\n};\n\nexport const toWeakETag = (value: number | bigint | string): WeakETag => {\n  return `W/\"${value}\"` as WeakETag;\n};\n\nexport const getETagFromIfMatch = (request: Request): ETag => {\n  const etag = request.headers[HeaderNames.IF_MATCH];\n\n  if (etag === undefined) {\n    throw new Error(ETagErrors.MISSING_IF_MATCH_HEADER);\n  }\n\n  return etag as ETag;\n};\n\nexport const getETagFromIfNotMatch = (request: Request): ETag => {\n  const etag = request.headers[HeaderNames.IF_NOT_MATCH];\n\n  if (etag === undefined) {\n    throw new Error(ETagErrors.MISSING_IF_MATCH_HEADER);\n  }\n\n  return (Array.isArray(etag) ? etag[0] : etag) as ETag;\n};\n\nexport const setETag = (response: Response, etag: ETag): void => {\n  response.setHeader(HeaderNames.ETag, etag as string);\n};\n\nexport const getETagValueFromIfMatch = (request: Request): string => {\n  const eTagValue: ETag = getETagFromIfMatch(request);\n\n  return isWeakETag(eTagValue)\n    ? getWeakETagValue(eTagValue)\n    : (eTagValue as string);\n};\n","import { type NextFunction, type Request, type Response } from 'express';\nimport {\n  send,\n  sendAccepted,\n  sendCreated,\n  sendProblem,\n  type AcceptedHttpResponseOptions,\n  type CreatedHttpResponseOptions,\n  type HttpProblemResponseOptions,\n  type HttpResponseOptions,\n  type NoContentHttpResponseOptions,\n} from '.';\n\n// #region httpresponse-on\nexport type HttpResponse = (response: Response) => void;\n\nexport type HttpHandler<RequestType extends Request> = (\n  request: RequestType,\n) => Promise<HttpResponse> | HttpResponse;\n\nexport const on =\n  <RequestType extends Request>(handle: HttpHandler<RequestType>) =>\n  async (\n    request: RequestType,\n    response: Response,\n    _next: NextFunction,\n  ): Promise<void> => {\n    const setResponse = await Promise.resolve(handle(request));\n\n    return setResponse(response);\n  };\n// #endregion httpresponse-on\n\nexport const OK =\n  (options?: HttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    send(response, 200, options);\n  };\n\nexport const Created =\n  (options: CreatedHttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendCreated(response, options);\n  };\n\nexport const Accepted =\n  (options: AcceptedHttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendAccepted(response, options);\n  };\n\nexport const NoContent = (\n  options?: NoContentHttpResponseOptions,\n): HttpResponse => HttpResponse(204, options);\n\nexport const HttpResponse =\n  (statusCode: number, options?: HttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    send(response, statusCode, options);\n  };\n\n/////////////////////\n// ERRORS\n/////////////////////\n\nexport const BadRequest = (\n  options?: HttpProblemResponseOptions,\n): HttpResponse => HttpProblem(400, options);\n\nexport const Forbidden = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(403, options);\n\nexport const NotFound = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(404, options);\n\nexport const Conflict = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(409, options);\n\nexport const PreconditionFailed = (\n  options: HttpProblemResponseOptions,\n): HttpResponse => HttpProblem(412, options);\n\nexport const HttpProblem =\n  (statusCode: number, options?: HttpProblemResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendProblem(response, statusCode, options);\n  };\n","import type { SecurityHandlers } from './index';\n\ntype AuthClient = {\n  verifyIdToken: (token: string) => Promise<unknown>;\n};\n\nexport type FirebaseAuthSecurityOptions = {\n  /**\n   * Name of the OpenAPI security scheme to attach the handler to.\n   * Defaults to \"bearerAuth\".\n   */\n  securitySchemeName?: string;\n  /**\n   * Custom auth client for tests or alternate Firebase auth instances.\n   */\n  authClient?: AuthClient;\n  /**\n   * Token claim used for role-based checks when scopes are defined.\n   * Defaults to \"roles\".\n   */\n  roleClaim?: string;\n};\n\ntype FirebaseAuthModule = {\n  firebaseAuthMiddleware: (options?: { authClient?: AuthClient }) => (\n    req: unknown,\n    res: unknown,\n    next: () => void,\n  ) => Promise<void> | void;\n};\n\nconst loadFirebaseAuth = async (): Promise<FirebaseAuthModule> => {\n  try {\n    const mod = await import('@my-f-startup/firebase-auth-express');\n    const provider = (mod as unknown as Record<string, unknown>).default ?? mod;\n    const firebaseAuthMiddleware =\n      (provider as Record<string, unknown>).firebaseAuthMiddleware;\n\n    if (typeof firebaseAuthMiddleware !== 'function') {\n      throw new Error(\n        'Invalid @my-f-startup/firebase-auth-express module: missing firebaseAuthMiddleware export',\n      );\n    }\n\n    return provider as FirebaseAuthModule;\n  } catch (error) {\n    const message =\n      '@my-f-startup/firebase-auth-express is required for createFirebaseAuthSecurityHandlers. ' +\n      'Install it with: npm install @my-f-startup/firebase-auth-express';\n    throw new Error(message, { cause: error as Error });\n  }\n};\n\nconst createNullResponse = () => {\n  const res: Record<string, unknown> = {};\n  res.status = () => res;\n  res.json = () => res;\n  res.send = () => res;\n  res.end = () => res;\n  res.set = () => res;\n  return res;\n};\n\nconst runMiddleware = async (\n  middleware: (req: unknown, res: unknown, next: () => void) => Promise<void> | void,\n  req: unknown,\n): Promise<boolean> => {\n  return new Promise((resolve) => {\n    let nextCalled = false;\n    const res = createNullResponse();\n    const next = () => {\n      nextCalled = true;\n      resolve(true);\n    };\n\n    Promise.resolve(middleware(req, res, next))\n      .then(() => {\n        if (!nextCalled) resolve(false);\n      })\n      .catch(() => resolve(false));\n  });\n};\n\nexport const createFirebaseAuthSecurityHandlers = (\n  options: FirebaseAuthSecurityOptions = {},\n): SecurityHandlers => {\n  const securitySchemeName = options.securitySchemeName ?? 'bearerAuth';\n  const roleClaim = options.roleClaim ?? 'roles';\n\n  return {\n    [securitySchemeName]: async (req, scopes, _schema) => {\n      const { firebaseAuthMiddleware } = await loadFirebaseAuth();\n      const middleware = firebaseAuthMiddleware({\n        authClient: options.authClient,\n      });\n\n      const isAuthenticated = await runMiddleware(middleware, req);\n      if (!isAuthenticated) return false;\n\n      if (!scopes.length) return true;\n\n      const roles = (req as Record<string, any>)?.auth?.token?.[roleClaim];\n      if (!Array.isArray(roles)) return false;\n\n      return scopes.every((scope: string) => roles.includes(scope));\n    },\n  };\n};\n","/**\n * OpenAPI v3 Document type (to avoid requiring express-openapi-validator types directly)\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OpenAPIV3Document = any;\n\n/**\n * Imported handler modules, keyed by module name.\n * Automatically populated by the framework when operationHandlers is configured.\n */\nexport type ImportedHandlerModules = Record<string, any>;\n\n/**\n * Security handlers for custom authentication/authorization logic.\n * Maps security scheme names to handler functions.\n *\n * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-security/\n */\n\nexport type SecurityHandlers = Record<\n  string,\n  (req: any, scopes: string[], schema: any) => boolean | Promise<boolean>\n>;\n\nexport * from './firebase-auth';\n\n/**\n * Configuration options for express-openapi-validator middleware.\n * This allows optional validation of API requests and responses against an OpenAPI specification.\n *\n * @see https://cdimascio.github.io/express-openapi-validator-documentation/\n */\nexport type OpenApiValidatorOptions = {\n  /**\n   * Path to the OpenAPI specification file (JSON or YAML)\n   * or an OpenAPI specification object.\n   */\n  apiSpec: string | OpenAPIV3Document;\n\n  /**\n   * Determines whether the validator should validate requests.\n   * Can be a boolean or an object with detailed request validation options.\n   * @default true\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-requests/\n   */\n  validateRequests?:\n    | boolean\n    | {\n        /**\n         * Allow unknown query parameters (not defined in the spec).\n         * @default false\n         */\n        allowUnknownQueryParameters?: boolean;\n        /**\n         * Coerce types in request parameters.\n         * @default true\n         */\n        coerceTypes?: boolean | 'array';\n        /**\n         * Remove additional properties not defined in the spec.\n         * @default false\n         */\n        removeAdditional?: boolean | 'all' | 'failing';\n      };\n\n  /**\n   * Determines whether the validator should validate responses.\n   * Can be a boolean or an object with detailed response validation options.\n   * @default false\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-responses/\n   */\n  validateResponses?:\n    | boolean\n    | {\n        /**\n         * Remove additional properties from responses not defined in the spec.\n         * @default false\n         */\n        removeAdditional?: boolean | 'all' | 'failing';\n        /**\n         * Coerce types in responses.\n         * @default true\n         */\n        coerceTypes?: boolean;\n        /**\n         * Callback to handle response validation errors.\n         */\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        onError?: (error: any, body: any, req: any) => void;\n      };\n\n  /**\n   * Determines whether the validator should validate security.\n   * Can be a boolean or an object with security handlers.\n   * @default true\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-security/\n   */\n  validateSecurity?:\n    | boolean\n    | {\n        /**\n         * Custom security handlers for authentication/authorization.\n         */\n        handlers?: SecurityHandlers;\n      };\n\n  /**\n   * Defines how the validator should validate formats.\n   * When true, uses ajv-formats for format validation.\n   * When false, format validation is disabled.\n   * Can also be 'fast' or 'full' for different validation modes.\n   * @default true\n   */\n  validateFormats?: boolean | 'fast' | 'full';\n\n  /**\n   * The base path to the operation handlers directory.\n   * When set to a path, automatically wires OpenAPI operations to handler functions\n   * based on operationId or x-eov-operation-id.\n   * When false, operation handlers are disabled (manual routing required).\n   * @default false\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/guide-operation-handlers/\n   */\n  operationHandlers?:\n    | string\n    | false\n    | {\n        /**\n         * Base path to operation handlers directory.\n         */\n        basePath?: string;\n        /**\n         * Resolver function to map operationId to handler module path.\n         */\n        resolver?: (\n          handlersPath: string,\n          route: string,\n          apiDoc: OpenAPIV3Document,\n        ) => string;\n      };\n\n  /**\n   * Paths or pattern to ignore during validation.\n   * @default undefined\n   */\n  ignorePaths?: RegExp | ((path: string) => boolean);\n\n  /**\n   * Validate the OpenAPI specification itself.\n   * @default true\n   */\n  validateApiSpec?: boolean;\n\n  /**\n   * $ref parser configuration for handling OpenAPI references.\n   * @default undefined\n   */\n  $refParser?: {\n    mode: 'bundle' | 'dereference';\n  };\n\n  /**\n   * Serve the OpenAPI specification at a specific path.\n   * When set to a string, the spec will be served at that path.\n   * When false, the spec will not be served.\n   * @default false\n   * @example '/api-docs/openapi.json'\n   */\n  serveSpec?: string | false;\n\n  /**\n   * File upload configuration options.\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-file-uploads/\n   */\n  fileUploader?:\n    | boolean\n    | {\n        /**\n         * Destination directory for uploaded files.\n         */\n        dest?: string;\n        /**\n         * File size limit in bytes.\n         */\n        limits?: {\n          fileSize?: number;\n          files?: number;\n        };\n      };\n\n  /**\n   * Optional callback to initialize operation handlers with dependencies.\n   * Called before the OpenAPI validator middleware is configured.\n   *\n   * The framework automatically imports handler modules referenced in your\n   * OpenAPI spec (via x-eov-operation-handler) and passes them as the first parameter.\n   *\n   * @param handlers - Auto-imported handler modules, keyed by module name\n   * @returns void or a Promise that resolves when initialization is complete\n   *\n   * @example\n   * ```typescript\n   * // With automatic import (recommended)\n   * initializeHandlers: async (handlers) => {\n   *   handlers.shoppingCarts.initializeHandlers(eventStore, messageBus, getUnitPrice, getCurrentTime);\n   * }\n   *\n   * // Manual import (still supported for backward compatibility)\n   * import * as handlersModule from './handlers/shoppingCarts';\n   * import { registerHandlerModule } from '@emmett-community/emmett-expressjs-with-openapi';\n   * initializeHandlers: () => {\n   *   const handlersPath = path.join(__dirname, './handlers/shoppingCarts');\n   *   registerHandlerModule(handlersPath, handlersModule);\n   *   handlersModule.initializeHandlers(eventStore, messageBus, getUnitPrice, getCurrentTime);\n   * }\n   * ```\n   */\n  initializeHandlers?: (\n    handlers?: ImportedHandlerModules,\n  ) => void | Promise<void>;\n};\n\n/**\n * Helper function to create OpenAPI validator configuration with sensible defaults.\n *\n * @param apiSpec - Path to OpenAPI spec file or OpenAPI document object\n * @param options - Additional validator options\n * @returns Complete OpenApiValidatorOptions configuration\n *\n * @example\n * ```typescript\n * // Basic usage with default options\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml');\n *\n * // With response validation enabled\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   validateResponses: true\n * });\n *\n * // With custom security handlers\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   validateSecurity: {\n *     handlers: {\n *       bearerAuth: async (req, scopes) => {\n *         // Custom authentication logic\n *         return true;\n *       }\n *     }\n *   }\n * });\n *\n * // Serving the spec at /api-docs\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   serveSpec: '/api-docs/openapi.json'\n * });\n *\n * // With dependency injection for operation handlers\n * type ShoppingCartDeps = {\n *   eventStore: EventStore;\n *   messageBus: EventsPublisher;\n *   getUnitPrice: (productId: string) => Promise<number>;\n *   getCurrentTime: () => Date;\n * };\n *\n * const validatorOptions = createOpenApiValidatorOptions<ShoppingCartDeps>(\n *   './openapi.yaml',\n *   {\n *     operationHandlers: './handlers',\n *     initializeHandlers: (deps) => {\n *       initializeHandlers(\n *         deps.eventStore,\n *         deps.messageBus,\n *         deps.getUnitPrice,\n *         deps.getCurrentTime\n *       );\n *     }\n *   }\n * );\n *\n * const app = getApplication({\n *   apis: [myApi],\n *   openApiValidator: validatorOptions\n * });\n * ```\n */\nexport const createOpenApiValidatorOptions = (\n  apiSpec: string | OpenAPIV3Document,\n  options?: Partial<Omit<OpenApiValidatorOptions, 'apiSpec'>>,\n): OpenApiValidatorOptions => {\n  return {\n    apiSpec,\n    validateRequests: options?.validateRequests ?? true,\n    validateResponses: options?.validateResponses ?? false,\n    validateSecurity: options?.validateSecurity ?? true,\n    validateFormats: options?.validateFormats ?? true,\n    operationHandlers: options?.operationHandlers,\n    ignorePaths: options?.ignorePaths,\n    validateApiSpec: options?.validateApiSpec ?? true,\n    $refParser: options?.$refParser,\n    serveSpec: options?.serveSpec ?? false,\n    fileUploader: options?.fileUploader,\n    initializeHandlers: options?.initializeHandlers,\n  };\n};\n\n/**\n * Type guard to check if express-openapi-validator is available\n */\nexport const isOpenApiValidatorAvailable = async (): Promise<boolean> => {\n  try {\n    await import('express-openapi-validator');\n    return true;\n  } catch {\n    return false;\n  }\n};\n","import { type Request, type Response } from 'express';\nimport { ProblemDocument } from 'http-problem-details';\nimport { setETag, type ETag } from './etag';\n\nexport type ErrorToProblemDetailsMapping = (\n  error: Error,\n  request: Request,\n) => ProblemDocument | undefined;\n\nexport type HttpResponseOptions = {\n  body?: unknown;\n  location?: string;\n  eTag?: ETag;\n};\nexport const DefaultHttpResponseOptions: HttpResponseOptions = {};\n\nexport type HttpProblemResponseOptions = {\n  location?: string;\n  eTag?: ETag;\n} & Omit<HttpResponseOptions, 'body'> &\n  (\n    | {\n        problem: ProblemDocument;\n      }\n    | { problemDetails: string }\n  );\nexport const DefaultHttpProblemResponseOptions: HttpProblemResponseOptions = {\n  problemDetails: 'Error occured!',\n};\n\nexport type CreatedHttpResponseOptions = (\n  | {\n      createdId: string;\n    }\n  | {\n      createdId?: string;\n      url: string;\n    }\n) &\n  HttpResponseOptions;\n\nexport const sendCreated = (\n  response: Response,\n  { eTag, ...options }: CreatedHttpResponseOptions,\n): void =>\n  send(response, 201, {\n    location:\n      'url' in options\n        ? options.url\n        : `${response.req.url}/${options.createdId}`,\n    body: 'createdId' in options ? { id: options.createdId } : undefined,\n    eTag,\n  });\n\nexport type AcceptedHttpResponseOptions = {\n  location: string;\n} & HttpResponseOptions;\n\nexport const sendAccepted = (\n  response: Response,\n  options: AcceptedHttpResponseOptions,\n): void => send(response, 202, options);\n\nexport type NoContentHttpResponseOptions = Omit<HttpResponseOptions, 'body'>;\n\nexport const send = (\n  response: Response,\n  statusCode: number,\n  options?: HttpResponseOptions,\n): void => {\n  const { location, body, eTag } = options ?? DefaultHttpResponseOptions;\n  // HEADERS\n  if (eTag) setETag(response, eTag);\n  if (location) response.setHeader('Location', location);\n\n  if (body) {\n    response.statusCode = statusCode;\n    response.send(body);\n  } else {\n    response.sendStatus(statusCode);\n  }\n};\n\nexport const sendProblem = (\n  response: Response,\n  statusCode: number,\n  options?: HttpProblemResponseOptions,\n): void => {\n  options = options ?? DefaultHttpProblemResponseOptions;\n\n  const { location, eTag } = options;\n\n  const problemDetails =\n    'problem' in options\n      ? options.problem\n      : new ProblemDocument({\n          detail: options.problemDetails,\n          status: statusCode,\n        });\n\n  // HEADERS\n  if (eTag) setETag(response, eTag);\n  if (location) response.setHeader('Location', location);\n\n  response.setHeader('Content-Type', 'application/problem+json');\n\n  response.statusCode = statusCode;\n  response.json(problemDetails);\n};\n","import supertest, { type Response } from 'supertest';\n\nimport type { EventStore } from '@event-driven-io/emmett';\nimport assert from 'assert';\nimport type { Application } from 'express';\nimport type { TestRequest } from './apiSpecification';\n\nexport type E2EResponseAssert = (response: Response) => boolean | void;\n\nexport type ApiE2ESpecificationAssert = [E2EResponseAssert];\n\nexport type ApiE2ESpecification = (...givenRequests: TestRequest[]) => {\n  when: (setupRequest: TestRequest) => {\n    then: (verify: ApiE2ESpecificationAssert) => Promise<void>;\n  };\n};\n\nexport const ApiE2ESpecification = {\n  for: <Store extends EventStore = EventStore>(\n    getEventStore: () => Store,\n    getApplication: (eventStore: Store) => Application | Promise<Application>,\n  ): ApiE2ESpecification => {\n    {\n      return (...givenRequests: TestRequest[]) => {\n        const eventStore = getEventStore();\n\n        return {\n          when: (setupRequest: TestRequest) => {\n            const handle = async () => {\n              const application = await Promise.resolve(getApplication(eventStore));\n\n              for (const requestFn of givenRequests) {\n                await requestFn(supertest(application));\n              }\n\n              return setupRequest(supertest(application));\n            };\n\n            return {\n              then: async (\n                verify: ApiE2ESpecificationAssert,\n              ): Promise<void> => {\n                const response = await handle();\n\n                verify.forEach((assertion) => {\n                  const succeeded = assertion(response);\n\n                  if (succeeded === false) assert.fail();\n                });\n              },\n            };\n          },\n        };\n      };\n    }\n  },\n};\n","import {\n  WrapEventStore,\n  assertEqual,\n  assertFails,\n  assertMatches,\n  type Event,\n  type EventStore,\n  type TestEventStream,\n} from '@event-driven-io/emmett';\nimport { type Application } from 'express';\nimport type { ProblemDocument } from 'http-problem-details';\nimport type { Response, Test } from 'supertest';\nimport supertest from 'supertest';\nimport type TestAgent from 'supertest/lib/agent';\n\n////////////////////////////////\n/////////// Setup\n////////////////////////////////\n\nexport type TestRequest = (request: TestAgent<supertest.Test>) => Test;\n\nexport const existingStream = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\n////////////////////////////////\n/////////// Asserts\n////////////////////////////////\n\nexport type ResponseAssert = (response: Response) => boolean | void;\n\nexport type ApiSpecificationAssert<EventType extends Event = Event> =\n  | TestEventStream<EventType>[]\n  | ResponseAssert\n  | [ResponseAssert, ...TestEventStream<EventType>[]];\n\nexport const expect = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\nexport const expectNewEvents = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\nexport const expectResponse =\n  <Body = unknown>(\n    statusCode: number,\n    options?: { body?: Body; headers?: { [index: string]: string } },\n  ) =>\n  (response: Response): void => {\n    const { body, headers } = options ?? {};\n    assertEqual(statusCode, response.statusCode, \"Response code doesn't match\");\n    if (body) assertMatches(response.body, body);\n    if (headers) assertMatches(response.headers, headers);\n  };\n\nexport const expectError = (\n  errorCode: number,\n  problemDetails?: Partial<ProblemDocument>,\n) =>\n  expectResponse(\n    errorCode,\n    problemDetails ? { body: problemDetails } : undefined,\n  );\n\n////////////////////////////////\n/////////// Api Specification\n////////////////////////////////\n\nexport type ApiSpecification<EventType extends Event = Event> = (\n  ...givenStreams: TestEventStream<EventType>[]\n) => {\n  when: (setupRequest: TestRequest) => {\n    then: (verify: ApiSpecificationAssert<EventType>) => Promise<void>;\n  };\n};\n\nexport const ApiSpecification = {\n  for: <\n    EventType extends Event = Event,\n    Store extends EventStore<import('@event-driven-io/emmett').ReadEventMetadataWithGlobalPosition> = EventStore<import('@event-driven-io/emmett').ReadEventMetadataWithGlobalPosition>\n  >(\n    getEventStore: () => Store,\n    getApplication: (eventStore: Store) => Application | Promise<Application>,\n  ): ApiSpecification<EventType> => {\n    {\n      return (...givenStreams: TestEventStream<EventType>[]) => {\n        const eventStore = WrapEventStore(getEventStore());\n\n        return {\n          when: (setupRequest: TestRequest) => {\n            const handle = async () => {\n              const application = await Promise.resolve(getApplication(eventStore));\n\n              for (const [streamName, events] of givenStreams) {\n                await eventStore.setup(streamName, events);\n              }\n\n              return setupRequest(supertest(application));\n            };\n\n            return {\n              then: async (\n                verify: ApiSpecificationAssert<EventType>,\n              ): Promise<void> => {\n                const response = await handle();\n\n                if (typeof verify === 'function') {\n                  const succeeded = verify(response);\n\n                  if (succeeded === false) assertFails();\n                } else if (Array.isArray(verify)) {\n                  const [first, ...rest] = verify;\n\n                  if (typeof first === 'function') {\n                    const succeeded = first(response);\n\n                    if (succeeded === false) assertFails();\n                  }\n\n                  const events = typeof first === 'function' ? rest : verify;\n\n                  assertMatches(\n                    Array.from(eventStore.appendedEvents.values()),\n                    events,\n                  );\n                }\n              },\n            };\n          },\n        };\n      };\n    }\n  },\n};\n"]}
+{"version":3,"sources":["/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/index.cjs","../src/index.ts","../src/application.ts","../src/middlewares/problemDetailsMiddleware.ts","../src/etag.ts","../src/handler.ts","../src/openapi/firebase-auth.ts","../src/openapi/index.ts","../src/responses.ts","../src/testing/apiE2ESpecification.ts","../src/testing/apiSpecification.ts"],"names":["require","options","ETagErrors","tracer","trace","SpanStatusCode"],"mappings":"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","file":"/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/index.cjs","sourcesContent":[null,"import 'express-async-errors';\n\nexport * from './application';\nexport * from './etag';\nexport * from './handler';\nexport * from './observability';\nexport * from './openapi';\nexport * from './responses';\nexport * from './testing';\nexport { registerHandlerModule } from './internal/esm-resolver';\n","import { trace, SpanStatusCode } from '@opentelemetry/api';\nimport express, {\n  Router,\n  type Application,\n  type RequestHandler,\n} from 'express';\nimport 'express-async-errors';\nimport http from 'http';\nimport { createRequire } from 'node:module';\nimport { problemDetailsMiddleware } from './middlewares/problemDetailsMiddleware';\nimport { type Logger, type ObservabilityOptions, safeLog } from './observability';\nimport type { OpenApiValidatorOptions } from './openapi';\nimport type { ErrorToProblemDetailsMapping } from './responses';\n\nconst tracer = trace.getTracer('@emmett-community/emmett-expressjs-with-openapi');\n\n// #region web-api-setup\nexport type WebApiSetup = (router: Router) => void;\n// #endregion web-api-setup\n\n/**\n * Options forwarded to pino-http. Typed loosely to avoid hard dependency.\n *\n * @see https://github.com/pinojs/pino-http\n */\nexport type PinoHttpOptions = Record<string, unknown>;\n\nexport type ApplicationOptions = {\n  apis?: WebApiSetup[];\n  mapError?: ErrorToProblemDetailsMapping;\n  enableDefaultExpressEtag?: boolean;\n  disableJsonMiddleware?: boolean;\n  disableUrlEncodingMiddleware?: boolean;\n  disableProblemDetailsMiddleware?: boolean;\n  /**\n   * Optional Pino HTTP logger configuration.\n   * When true, enables pino-http with defaults.\n   * When an object, forwards the options to pino-http.\n   * Requires the 'pino-http' package to be installed.\n   *\n   * @see https://github.com/pinojs/pino-http\n   * @example\n   * ```typescript\n   * const app = await getApplication({\n   *   pinoHttp: true,\n   * });\n   *\n   * const app = await getApplication({\n   *   pinoHttp: { autoLogging: false },\n   * });\n   * ```\n   */\n  pinoHttp?: boolean | PinoHttpOptions;\n  /**\n   * Optional OpenAPI validator configuration.\n   * When provided, enables request/response validation against an OpenAPI specification.\n   * Requires the 'express-openapi-validator' package to be installed.\n   *\n   * @see https://github.com/cdimascio/express-openapi-validator\n   * @example\n   * ```typescript\n   * import { getApplication, createOpenApiValidatorOptions } from '@event-driven-io/emmett-expressjs';\n   *\n   * type AppDeps = {\n   *   eventStore: EventStore;\n   *   messageBus: EventsPublisher;\n   * };\n   *\n   * const app = await getApplication({\n   *   openApiValidator: createOpenApiValidatorOptions<AppDeps>('./openapi.yaml', {\n   *     validateResponses: true,\n   *     operationHandlers: './handlers',\n   *     initializeHandlers: (deps) => {\n   *       initializeHandlers(deps.eventStore, deps.messageBus);\n   *     }\n   *   })\n   * });\n   * ```\n   */\n  openApiValidator?: OpenApiValidatorOptions;\n  /**\n   * Optional observability configuration for logging.\n   * When not provided, the library operates silently (no logs).\n   *\n   * @example\n   * ```typescript\n   * import pino from 'pino';\n   *\n   * const logger = pino();\n   *\n   * const app = await getApplication({\n   *   observability: { logger },\n   * });\n   * ```\n   */\n  observability?: ObservabilityOptions;\n};\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const app: Application = express();\n\n  const {\n    apis,\n    mapError,\n    enableDefaultExpressEtag,\n    disableJsonMiddleware,\n    disableUrlEncodingMiddleware,\n    disableProblemDetailsMiddleware,\n    pinoHttp,\n    openApiValidator,\n    observability,\n  } = options;\n\n  const logger = observability?.logger;\n\n  safeLog.debug(logger, 'Initializing Express application', {\n    hasApis: !!apis?.length,\n    hasOpenApiValidator: !!openApiValidator,\n    hasPinoHttp: !!pinoHttp,\n  });\n\n  const router = Router();\n\n  // disabling default etag behaviour\n  // to use etags in if-match and if-not-match headers\n  app.set('etag', enableDefaultExpressEtag ?? false);\n\n  // add Pino HTTP logger middleware if configured\n  if (pinoHttp !== undefined && pinoHttp !== false) {\n    try {\n      const require = createRequire(import.meta.url);\n      const mod = require('pino-http') as Record<string, unknown>;\n      const provider = (mod.default ?? mod) as unknown;\n\n      if (typeof provider !== 'function') {\n        throw new Error('Invalid pino-http module: missing default export');\n      }\n\n      const options = pinoHttp === true ? undefined : pinoHttp;\n      const middleware = (\n        provider as (opts?: PinoHttpOptions) => RequestHandler\n      )(options);\n      app.use(middleware);\n    } catch (error) {\n      safeLog.warn(\n        logger,\n        'Pino HTTP configuration provided but pino-http package is not installed. Install it with: npm install pino-http',\n      );\n      throw new Error(\n        'pino-http package is required when pinoHttp option is used',\n      );\n    }\n  }\n\n  // add json middleware\n  if (!disableJsonMiddleware) app.use(express.json());\n\n  // enable url encoded urls and bodies\n  if (!disableUrlEncodingMiddleware)\n    app.use(\n      express.urlencoded({\n        extended: true,\n      }),\n    );\n\n  // add OpenAPI validator middleware if configured\n  if (openApiValidator) {\n    // Activate ESM resolver if operationHandlers are configured\n    // This ensures handler modules are loaded via ESM import() instead of CJS require(),\n    // preventing dual module loading issues when using TypeScript runtimes (tsx, ts-node)\n    if (openApiValidator.operationHandlers) {\n      const { activateESMResolver } = await import(\n        './internal/esm-resolver.js'\n      );\n      activateESMResolver();\n\n      // NEW: Auto-discover and import handler modules from OpenAPI spec\n      const handlersBasePath =\n        typeof openApiValidator.operationHandlers === 'string'\n          ? openApiValidator.operationHandlers\n          : openApiValidator.operationHandlers.basePath;\n\n      if (handlersBasePath) {\n        const { extractHandlerModules } = await import(\n          './internal/openapi-parser.js'\n        );\n        const { importAndRegisterHandlers } = await import(\n          './internal/handler-importer.js'\n        );\n\n        // Parse OpenAPI spec to find handler modules\n        const modules = await tracer.startActiveSpan(\n          'emmett.openapi.parse_spec',\n          async (span) => {\n            try {\n              const result = await extractHandlerModules(\n                openApiValidator.apiSpec,\n                handlersBasePath,\n                logger,\n              );\n              span.setAttribute('emmett.handlers.count', result.length);\n              span.setStatus({ code: SpanStatusCode.OK });\n              return result;\n            } catch (error) {\n              span.recordException(error as Error);\n              span.setStatus({ code: SpanStatusCode.ERROR });\n              throw error;\n            } finally {\n              span.end();\n            }\n          },\n        );\n\n        // Dynamically import and register all handler modules\n        const importedHandlers = await tracer.startActiveSpan(\n          'emmett.http.import_handlers',\n          async (span) => {\n            try {\n              const result = await importAndRegisterHandlers(modules, logger);\n              span.setAttribute(\n                'emmett.handlers.count',\n                Object.keys(result).length,\n              );\n              span.setStatus({ code: SpanStatusCode.OK });\n              return result;\n            } catch (error) {\n              safeLog.error(logger, 'Failed to auto-import handler modules', error);\n              span.recordException(error as Error);\n              span.setStatus({ code: SpanStatusCode.ERROR });\n              throw error;\n            } finally {\n              span.end();\n            }\n          },\n        );\n\n        // Call user's initializeHandlers callback with imported modules\n        if (openApiValidator.initializeHandlers) {\n          await openApiValidator.initializeHandlers(importedHandlers);\n        }\n      }\n    } else {\n      // No operationHandlers, just call initializeHandlers if provided\n      if (openApiValidator.initializeHandlers) {\n        await openApiValidator.initializeHandlers();\n      }\n    }\n\n    try {\n      const require = createRequire(import.meta.url);\n      // express-openapi-validator exports a default with .middleware (ESM/CJS compatibility)\n      const mod = require('express-openapi-validator') as Record<\n        string,\n        unknown\n      >;\n      const provider = (mod.default ?? mod) as Record<string, unknown>;\n\n      if (typeof provider.middleware !== 'function') {\n        throw new Error(\n          'Invalid express-openapi-validator module: missing middleware export',\n        );\n      }\n\n      // Serve OpenAPI spec if configured\n      if (openApiValidator.serveSpec) {\n        if (typeof openApiValidator.apiSpec === 'string') {\n          // If apiSpec is a file path, serve it as a static file\n          app.use(\n            openApiValidator.serveSpec,\n            express.static(openApiValidator.apiSpec),\n          );\n        } else {\n          // If apiSpec is an object, serve it as JSON\n          app.get(openApiValidator.serveSpec, (_req, res) => {\n            res.json(openApiValidator.apiSpec);\n          });\n        }\n      }\n\n      const factory = provider.middleware as (\n        opts: OpenApiValidatorOptions,\n      ) => RequestHandler | RequestHandler[];\n      const middleware = factory(openApiValidator);\n      if (Array.isArray(middleware)) {\n        for (const m of middleware) app.use(m);\n      } else {\n        app.use(middleware);\n      }\n    } catch (error) {\n      safeLog.warn(\n        logger,\n        'OpenAPI validator configuration provided but express-openapi-validator package is not installed. Install it with: npm install express-openapi-validator',\n      );\n      throw new Error(\n        'express-openapi-validator package is required when openApiValidator option is used',\n      );\n    }\n  }\n\n  // Register API routes if provided\n  if (apis) {\n    for (const api of apis) {\n      api(router);\n    }\n    app.use(router);\n  }\n\n  // add problem details middleware\n  if (!disableProblemDetailsMiddleware)\n    app.use(problemDetailsMiddleware(mapError, logger));\n\n  safeLog.info(logger, 'Express application initialized');\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n  /**\n   * Optional logger for lifecycle events.\n   */\n  logger?: Logger;\n};\n\nexport const startAPI = (\n  app: Application,\n  options: StartApiOptions = { port: 3000 },\n) => {\n  const { port, logger } = options;\n  const server = http.createServer(app);\n\n  server.on('listening', () => {\n    safeLog.info(logger, 'Server up listening', { port });\n  });\n\n  return server.listen(port);\n};\n","import type { NextFunction, Request, Response } from 'express';\nimport { ProblemDocument } from 'http-problem-details';\nimport { sendProblem, type ErrorToProblemDetailsMapping } from '..';\nimport { type Logger, safeLog } from '../observability';\n\nexport const problemDetailsMiddleware =\n  (mapError?: ErrorToProblemDetailsMapping, logger?: Logger) =>\n  (\n    error: Error,\n    request: Request,\n    response: Response,\n    _next: NextFunction,\n  ): void => {\n    safeLog.error(logger, 'Request error', error);\n\n    let problemDetails: ProblemDocument | undefined;\n\n    if (mapError) problemDetails = mapError(error, request);\n\n    problemDetails =\n      problemDetails ?? defaultErrorToProblemDetailsMapping(error);\n\n    sendProblem(response, problemDetails.status, { problem: problemDetails });\n  };\n\nexport const defaultErrorToProblemDetailsMapping = (\n  error: Error,\n): ProblemDocument => {\n  let statusCode = 500;\n\n  // Prefer standard `status` code if present (e.g., express-openapi-validator)\n  const errObj = error as unknown as Record<string, unknown>;\n  const maybeStatus = errObj['status'];\n  if (\n    typeof maybeStatus === 'number' &&\n    maybeStatus >= 100 &&\n    maybeStatus < 600\n  ) {\n    statusCode = maybeStatus;\n  }\n\n  const maybeErrorCode = errObj['errorCode'];\n  if (\n    typeof maybeErrorCode === 'number' &&\n    maybeErrorCode >= 100 &&\n    maybeErrorCode < 600\n  ) {\n    statusCode = maybeErrorCode;\n  }\n\n  return new ProblemDocument({\n    detail: error.message,\n    status: statusCode,\n  });\n};\n","import { type Brand } from '@event-driven-io/emmett';\nimport type { Request, Response } from 'express';\n\n//////////////////////////////////////\n/// ETAG\n//////////////////////////////////////\n\nexport const HeaderNames = {\n  IF_MATCH: 'if-match',\n  IF_NOT_MATCH: 'if-not-match',\n  ETag: 'etag',\n};\n\nexport type WeakETag = Brand<`W/${string}`, 'ETag'>;\nexport type ETag = Brand<string, 'ETag'>;\n\nexport const WeakETagRegex = /W\\/\"(-?\\d+.*)\"/;\n\nexport const enum ETagErrors {\n  WRONG_WEAK_ETAG_FORMAT = 'WRONG_WEAK_ETAG_FORMAT',\n  MISSING_IF_MATCH_HEADER = 'MISSING_IF_MATCH_HEADER',\n  MISSING_IF_NOT_MATCH_HEADER = 'MISSING_IF_NOT_MATCH_HEADER',\n}\n\nexport const isWeakETag = (etag: ETag): etag is WeakETag => {\n  return WeakETagRegex.test(etag as string);\n};\n\nexport const getWeakETagValue = (etag: ETag): string => {\n  const result = WeakETagRegex.exec(etag as string);\n  if (result === null || result.length === 0) {\n    throw new Error(ETagErrors.WRONG_WEAK_ETAG_FORMAT);\n  }\n  return result[1]!;\n};\n\nexport const toWeakETag = (value: number | bigint | string): WeakETag => {\n  return `W/\"${value}\"` as WeakETag;\n};\n\nexport const getETagFromIfMatch = (request: Request): ETag => {\n  const etag = request.headers[HeaderNames.IF_MATCH];\n\n  if (etag === undefined) {\n    throw new Error(ETagErrors.MISSING_IF_MATCH_HEADER);\n  }\n\n  return etag as ETag;\n};\n\nexport const getETagFromIfNotMatch = (request: Request): ETag => {\n  const etag = request.headers[HeaderNames.IF_NOT_MATCH];\n\n  if (etag === undefined) {\n    throw new Error(ETagErrors.MISSING_IF_MATCH_HEADER);\n  }\n\n  return (Array.isArray(etag) ? etag[0] : etag) as ETag;\n};\n\nexport const setETag = (response: Response, etag: ETag): void => {\n  response.setHeader(HeaderNames.ETag, etag as string);\n};\n\nexport const getETagValueFromIfMatch = (request: Request): string => {\n  const eTagValue: ETag = getETagFromIfMatch(request);\n\n  return isWeakETag(eTagValue)\n    ? getWeakETagValue(eTagValue)\n    : (eTagValue as string);\n};\n","import { trace, SpanStatusCode } from '@opentelemetry/api';\nimport { type NextFunction, type Request, type Response } from 'express';\nimport {\n  send,\n  sendAccepted,\n  sendCreated,\n  sendProblem,\n  type AcceptedHttpResponseOptions,\n  type CreatedHttpResponseOptions,\n  type HttpProblemResponseOptions,\n  type HttpResponseOptions,\n  type NoContentHttpResponseOptions,\n} from '.';\n\nconst tracer = trace.getTracer('@emmett-community/emmett-expressjs-with-openapi');\n\n// #region httpresponse-on\nexport type HttpResponse = (response: Response) => void;\n\nexport type HttpHandler<RequestType extends Request> = (\n  request: RequestType,\n) => Promise<HttpResponse> | HttpResponse;\n\nexport const on =\n  <RequestType extends Request>(handle: HttpHandler<RequestType>) =>\n  async (\n    request: RequestType,\n    response: Response,\n    _next: NextFunction,\n  ): Promise<void> => {\n    const setResponse = await Promise.resolve(handle(request));\n\n    return setResponse(response);\n  };\n// #endregion httpresponse-on\n\n/**\n * Options for the traced handler wrapper.\n */\nexport type TracedHandlerOptions = {\n  /**\n   * Custom span name. Defaults to 'emmett.http.handle_request'.\n   */\n  spanName?: string;\n};\n\n/**\n * Wraps an HTTP handler with OpenTelemetry tracing.\n * Creates a span that captures request method, route, and response status.\n *\n * If OpenTelemetry is not initialized by the application, spans are no-ops\n * with zero overhead.\n *\n * @example\n * ```typescript\n * router.post('/carts', tracedOn(async (req) => {\n *   // Your handler logic\n *   return Created({ createdId: cartId });\n * }));\n * ```\n */\nexport const tracedOn =\n  <RequestType extends Request>(\n    handle: HttpHandler<RequestType>,\n    options?: TracedHandlerOptions,\n  ) =>\n  async (\n    request: RequestType,\n    response: Response,\n    _next: NextFunction,\n  ): Promise<void> => {\n    const spanName = options?.spanName ?? 'emmett.http.handle_request';\n\n    return tracer.startActiveSpan(spanName, async (span) => {\n      try {\n        span.setAttribute('http.method', request.method);\n\n        const route =\n          (request.baseUrl ?? '') +\n          ((request.route as { path?: string })?.path ?? request.path);\n        span.setAttribute('http.route', route);\n\n        const setResponse = await Promise.resolve(handle(request));\n        setResponse(response);\n\n        span.setAttribute('http.status_code', response.statusCode);\n        span.setStatus({\n          code:\n            response.statusCode >= 400 ? SpanStatusCode.ERROR : SpanStatusCode.OK,\n        });\n      } catch (error) {\n        span.recordException(error as Error);\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        throw error;\n      } finally {\n        span.end();\n      }\n    });\n  };\n\nexport const OK =\n  (options?: HttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    send(response, 200, options);\n  };\n\nexport const Created =\n  (options: CreatedHttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendCreated(response, options);\n  };\n\nexport const Accepted =\n  (options: AcceptedHttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendAccepted(response, options);\n  };\n\nexport const NoContent = (\n  options?: NoContentHttpResponseOptions,\n): HttpResponse => HttpResponse(204, options);\n\nexport const HttpResponse =\n  (statusCode: number, options?: HttpResponseOptions): HttpResponse =>\n  (response: Response) => {\n    send(response, statusCode, options);\n  };\n\n/////////////////////\n// ERRORS\n/////////////////////\n\nexport const BadRequest = (\n  options?: HttpProblemResponseOptions,\n): HttpResponse => HttpProblem(400, options);\n\nexport const Forbidden = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(403, options);\n\nexport const NotFound = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(404, options);\n\nexport const Conflict = (options?: HttpProblemResponseOptions): HttpResponse =>\n  HttpProblem(409, options);\n\nexport const PreconditionFailed = (\n  options: HttpProblemResponseOptions,\n): HttpResponse => HttpProblem(412, options);\n\nexport const HttpProblem =\n  (statusCode: number, options?: HttpProblemResponseOptions): HttpResponse =>\n  (response: Response) => {\n    sendProblem(response, statusCode, options);\n  };\n","import type { SecurityHandlers } from './index';\n\ntype AuthClient = {\n  verifyIdToken: (token: string) => Promise<unknown>;\n};\n\nexport type FirebaseAuthSecurityOptions = {\n  /**\n   * Name of the OpenAPI security scheme to attach the handler to.\n   * Defaults to \"bearerAuth\".\n   */\n  securitySchemeName?: string;\n  /**\n   * Custom auth client for tests or alternate Firebase auth instances.\n   */\n  authClient?: AuthClient;\n  /**\n   * Token claim used for role-based checks when scopes are defined.\n   * Defaults to \"roles\".\n   */\n  roleClaim?: string;\n};\n\ntype FirebaseAuthModule = {\n  firebaseAuthMiddleware: (options?: { authClient?: AuthClient }) => (\n    req: unknown,\n    res: unknown,\n    next: () => void,\n  ) => Promise<void> | void;\n};\n\nconst loadFirebaseAuth = async (): Promise<FirebaseAuthModule> => {\n  try {\n    const mod = await import('@my-f-startup/firebase-auth-express');\n    const provider = (mod as unknown as Record<string, unknown>).default ?? mod;\n    const firebaseAuthMiddleware =\n      (provider as Record<string, unknown>).firebaseAuthMiddleware;\n\n    if (typeof firebaseAuthMiddleware !== 'function') {\n      throw new Error(\n        'Invalid @my-f-startup/firebase-auth-express module: missing firebaseAuthMiddleware export',\n      );\n    }\n\n    return provider as FirebaseAuthModule;\n  } catch (error) {\n    const message =\n      '@my-f-startup/firebase-auth-express is required for createFirebaseAuthSecurityHandlers. ' +\n      'Install it with: npm install @my-f-startup/firebase-auth-express';\n    throw new Error(message, { cause: error as Error });\n  }\n};\n\nconst createNullResponse = () => {\n  const res: Record<string, unknown> = {};\n  res.status = () => res;\n  res.json = () => res;\n  res.send = () => res;\n  res.end = () => res;\n  res.set = () => res;\n  return res;\n};\n\nconst runMiddleware = async (\n  middleware: (req: unknown, res: unknown, next: () => void) => Promise<void> | void,\n  req: unknown,\n): Promise<boolean> => {\n  return new Promise((resolve) => {\n    let nextCalled = false;\n    const res = createNullResponse();\n    const next = () => {\n      nextCalled = true;\n      resolve(true);\n    };\n\n    Promise.resolve(middleware(req, res, next))\n      .then(() => {\n        if (!nextCalled) resolve(false);\n      })\n      .catch(() => resolve(false));\n  });\n};\n\nexport const createFirebaseAuthSecurityHandlers = (\n  options: FirebaseAuthSecurityOptions = {},\n): SecurityHandlers => {\n  const securitySchemeName = options.securitySchemeName ?? 'bearerAuth';\n  const roleClaim = options.roleClaim ?? 'roles';\n\n  return {\n    [securitySchemeName]: async (req, scopes, _schema) => {\n      const { firebaseAuthMiddleware } = await loadFirebaseAuth();\n      const middleware = firebaseAuthMiddleware({\n        authClient: options.authClient,\n      });\n\n      const isAuthenticated = await runMiddleware(middleware, req);\n      if (!isAuthenticated) return false;\n\n      if (!scopes.length) return true;\n\n      const roles = (req as Record<string, any>)?.auth?.token?.[roleClaim];\n      if (!Array.isArray(roles)) return false;\n\n      return scopes.every((scope: string) => roles.includes(scope));\n    },\n  };\n};\n","/**\n * OpenAPI v3 Document type (to avoid requiring express-openapi-validator types directly)\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OpenAPIV3Document = any;\n\n/**\n * Imported handler modules, keyed by module name.\n * Automatically populated by the framework when operationHandlers is configured.\n */\nexport type ImportedHandlerModules = Record<string, any>;\n\n/**\n * Security handlers for custom authentication/authorization logic.\n * Maps security scheme names to handler functions.\n *\n * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-security/\n */\n\nexport type SecurityHandlers = Record<\n  string,\n  (req: any, scopes: string[], schema: any) => boolean | Promise<boolean>\n>;\n\nexport * from './firebase-auth';\n\n/**\n * Configuration options for express-openapi-validator middleware.\n * This allows optional validation of API requests and responses against an OpenAPI specification.\n *\n * @see https://cdimascio.github.io/express-openapi-validator-documentation/\n */\nexport type OpenApiValidatorOptions = {\n  /**\n   * Path to the OpenAPI specification file (JSON or YAML)\n   * or an OpenAPI specification object.\n   */\n  apiSpec: string | OpenAPIV3Document;\n\n  /**\n   * Determines whether the validator should validate requests.\n   * Can be a boolean or an object with detailed request validation options.\n   * @default true\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-requests/\n   */\n  validateRequests?:\n    | boolean\n    | {\n        /**\n         * Allow unknown query parameters (not defined in the spec).\n         * @default false\n         */\n        allowUnknownQueryParameters?: boolean;\n        /**\n         * Coerce types in request parameters.\n         * @default true\n         */\n        coerceTypes?: boolean | 'array';\n        /**\n         * Remove additional properties not defined in the spec.\n         * @default false\n         */\n        removeAdditional?: boolean | 'all' | 'failing';\n      };\n\n  /**\n   * Determines whether the validator should validate responses.\n   * Can be a boolean or an object with detailed response validation options.\n   * @default false\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-responses/\n   */\n  validateResponses?:\n    | boolean\n    | {\n        /**\n         * Remove additional properties from responses not defined in the spec.\n         * @default false\n         */\n        removeAdditional?: boolean | 'all' | 'failing';\n        /**\n         * Coerce types in responses.\n         * @default true\n         */\n        coerceTypes?: boolean;\n        /**\n         * Callback to handle response validation errors.\n         */\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        onError?: (error: any, body: any, req: any) => void;\n      };\n\n  /**\n   * Determines whether the validator should validate security.\n   * Can be a boolean or an object with security handlers.\n   * @default true\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-validate-security/\n   */\n  validateSecurity?:\n    | boolean\n    | {\n        /**\n         * Custom security handlers for authentication/authorization.\n         */\n        handlers?: SecurityHandlers;\n      };\n\n  /**\n   * Defines how the validator should validate formats.\n   * When true, uses ajv-formats for format validation.\n   * When false, format validation is disabled.\n   * Can also be 'fast' or 'full' for different validation modes.\n   * @default true\n   */\n  validateFormats?: boolean | 'fast' | 'full';\n\n  /**\n   * The base path to the operation handlers directory.\n   * When set to a path, automatically wires OpenAPI operations to handler functions\n   * based on operationId or x-eov-operation-id.\n   * When false, operation handlers are disabled (manual routing required).\n   * @default false\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/guide-operation-handlers/\n   */\n  operationHandlers?:\n    | string\n    | false\n    | {\n        /**\n         * Base path to operation handlers directory.\n         */\n        basePath?: string;\n        /**\n         * Resolver function to map operationId to handler module path.\n         */\n        resolver?: (\n          handlersPath: string,\n          route: string,\n          apiDoc: OpenAPIV3Document,\n        ) => string;\n      };\n\n  /**\n   * Paths or pattern to ignore during validation.\n   * @default undefined\n   */\n  ignorePaths?: RegExp | ((path: string) => boolean);\n\n  /**\n   * Validate the OpenAPI specification itself.\n   * @default true\n   */\n  validateApiSpec?: boolean;\n\n  /**\n   * $ref parser configuration for handling OpenAPI references.\n   * @default undefined\n   */\n  $refParser?: {\n    mode: 'bundle' | 'dereference';\n  };\n\n  /**\n   * Serve the OpenAPI specification at a specific path.\n   * When set to a string, the spec will be served at that path.\n   * When false, the spec will not be served.\n   * @default false\n   * @example '/api-docs/openapi.json'\n   */\n  serveSpec?: string | false;\n\n  /**\n   * File upload configuration options.\n   * @see https://cdimascio.github.io/express-openapi-validator-documentation/usage-file-uploads/\n   */\n  fileUploader?:\n    | boolean\n    | {\n        /**\n         * Destination directory for uploaded files.\n         */\n        dest?: string;\n        /**\n         * File size limit in bytes.\n         */\n        limits?: {\n          fileSize?: number;\n          files?: number;\n        };\n      };\n\n  /**\n   * Optional callback to initialize operation handlers with dependencies.\n   * Called before the OpenAPI validator middleware is configured.\n   *\n   * The framework automatically imports handler modules referenced in your\n   * OpenAPI spec (via x-eov-operation-handler) and passes them as the first parameter.\n   *\n   * @param handlers - Auto-imported handler modules, keyed by module name\n   * @returns void or a Promise that resolves when initialization is complete\n   *\n   * @example\n   * ```typescript\n   * // With automatic import (recommended)\n   * initializeHandlers: async (handlers) => {\n   *   handlers.shoppingCarts.initializeHandlers(eventStore, messageBus, getUnitPrice, getCurrentTime);\n   * }\n   *\n   * // Manual import (still supported for backward compatibility)\n   * import * as handlersModule from './handlers/shoppingCarts';\n   * import { registerHandlerModule } from '@emmett-community/emmett-expressjs-with-openapi';\n   * initializeHandlers: () => {\n   *   const handlersPath = path.join(__dirname, './handlers/shoppingCarts');\n   *   registerHandlerModule(handlersPath, handlersModule);\n   *   handlersModule.initializeHandlers(eventStore, messageBus, getUnitPrice, getCurrentTime);\n   * }\n   * ```\n   */\n  initializeHandlers?: (\n    handlers?: ImportedHandlerModules,\n  ) => void | Promise<void>;\n};\n\n/**\n * Helper function to create OpenAPI validator configuration with sensible defaults.\n *\n * @param apiSpec - Path to OpenAPI spec file or OpenAPI document object\n * @param options - Additional validator options\n * @returns Complete OpenApiValidatorOptions configuration\n *\n * @example\n * ```typescript\n * // Basic usage with default options\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml');\n *\n * // With response validation enabled\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   validateResponses: true\n * });\n *\n * // With custom security handlers\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   validateSecurity: {\n *     handlers: {\n *       bearerAuth: async (req, scopes) => {\n *         // Custom authentication logic\n *         return true;\n *       }\n *     }\n *   }\n * });\n *\n * // Serving the spec at /api-docs\n * const validatorOptions = createOpenApiValidatorOptions('./openapi.yaml', {\n *   serveSpec: '/api-docs/openapi.json'\n * });\n *\n * // With dependency injection for operation handlers\n * type ShoppingCartDeps = {\n *   eventStore: EventStore;\n *   messageBus: EventsPublisher;\n *   getUnitPrice: (productId: string) => Promise<number>;\n *   getCurrentTime: () => Date;\n * };\n *\n * const validatorOptions = createOpenApiValidatorOptions<ShoppingCartDeps>(\n *   './openapi.yaml',\n *   {\n *     operationHandlers: './handlers',\n *     initializeHandlers: (deps) => {\n *       initializeHandlers(\n *         deps.eventStore,\n *         deps.messageBus,\n *         deps.getUnitPrice,\n *         deps.getCurrentTime\n *       );\n *     }\n *   }\n * );\n *\n * const app = getApplication({\n *   apis: [myApi],\n *   openApiValidator: validatorOptions\n * });\n * ```\n */\nexport const createOpenApiValidatorOptions = (\n  apiSpec: string | OpenAPIV3Document,\n  options?: Partial<Omit<OpenApiValidatorOptions, 'apiSpec'>>,\n): OpenApiValidatorOptions => {\n  return {\n    apiSpec,\n    validateRequests: options?.validateRequests ?? true,\n    validateResponses: options?.validateResponses ?? false,\n    validateSecurity: options?.validateSecurity ?? true,\n    validateFormats: options?.validateFormats ?? true,\n    operationHandlers: options?.operationHandlers,\n    ignorePaths: options?.ignorePaths,\n    validateApiSpec: options?.validateApiSpec ?? true,\n    $refParser: options?.$refParser,\n    serveSpec: options?.serveSpec ?? false,\n    fileUploader: options?.fileUploader,\n    initializeHandlers: options?.initializeHandlers,\n  };\n};\n\n/**\n * Type guard to check if express-openapi-validator is available\n */\nexport const isOpenApiValidatorAvailable = async (): Promise<boolean> => {\n  try {\n    await import('express-openapi-validator');\n    return true;\n  } catch {\n    return false;\n  }\n};\n","import { type Request, type Response } from 'express';\nimport { ProblemDocument } from 'http-problem-details';\nimport { setETag, type ETag } from './etag';\n\nexport type ErrorToProblemDetailsMapping = (\n  error: Error,\n  request: Request,\n) => ProblemDocument | undefined;\n\nexport type HttpResponseOptions = {\n  body?: unknown;\n  location?: string;\n  eTag?: ETag;\n};\nexport const DefaultHttpResponseOptions: HttpResponseOptions = {};\n\nexport type HttpProblemResponseOptions = {\n  location?: string;\n  eTag?: ETag;\n} & Omit<HttpResponseOptions, 'body'> &\n  (\n    | {\n        problem: ProblemDocument;\n      }\n    | { problemDetails: string }\n  );\nexport const DefaultHttpProblemResponseOptions: HttpProblemResponseOptions = {\n  problemDetails: 'Error occured!',\n};\n\nexport type CreatedHttpResponseOptions = (\n  | {\n      createdId: string;\n    }\n  | {\n      createdId?: string;\n      url: string;\n    }\n) &\n  HttpResponseOptions;\n\nexport const sendCreated = (\n  response: Response,\n  { eTag, ...options }: CreatedHttpResponseOptions,\n): void =>\n  send(response, 201, {\n    location:\n      'url' in options\n        ? options.url\n        : `${response.req.url}/${options.createdId}`,\n    body: 'createdId' in options ? { id: options.createdId } : undefined,\n    eTag,\n  });\n\nexport type AcceptedHttpResponseOptions = {\n  location: string;\n} & HttpResponseOptions;\n\nexport const sendAccepted = (\n  response: Response,\n  options: AcceptedHttpResponseOptions,\n): void => send(response, 202, options);\n\nexport type NoContentHttpResponseOptions = Omit<HttpResponseOptions, 'body'>;\n\nexport const send = (\n  response: Response,\n  statusCode: number,\n  options?: HttpResponseOptions,\n): void => {\n  const { location, body, eTag } = options ?? DefaultHttpResponseOptions;\n  // HEADERS\n  if (eTag) setETag(response, eTag);\n  if (location) response.setHeader('Location', location);\n\n  if (body) {\n    response.statusCode = statusCode;\n    response.send(body);\n  } else {\n    response.sendStatus(statusCode);\n  }\n};\n\nexport const sendProblem = (\n  response: Response,\n  statusCode: number,\n  options?: HttpProblemResponseOptions,\n): void => {\n  options = options ?? DefaultHttpProblemResponseOptions;\n\n  const { location, eTag } = options;\n\n  const problemDetails =\n    'problem' in options\n      ? options.problem\n      : new ProblemDocument({\n          detail: options.problemDetails,\n          status: statusCode,\n        });\n\n  // HEADERS\n  if (eTag) setETag(response, eTag);\n  if (location) response.setHeader('Location', location);\n\n  response.setHeader('Content-Type', 'application/problem+json');\n\n  response.statusCode = statusCode;\n  response.json(problemDetails);\n};\n","import supertest, { type Response } from 'supertest';\n\nimport type { EventStore } from '@event-driven-io/emmett';\nimport assert from 'assert';\nimport type { Application } from 'express';\nimport type { TestRequest } from './apiSpecification';\n\nexport type E2EResponseAssert = (response: Response) => boolean | void;\n\nexport type ApiE2ESpecificationAssert = [E2EResponseAssert];\n\nexport type ApiE2ESpecification = (...givenRequests: TestRequest[]) => {\n  when: (setupRequest: TestRequest) => {\n    then: (verify: ApiE2ESpecificationAssert) => Promise<void>;\n  };\n};\n\nexport const ApiE2ESpecification = {\n  for: <Store extends EventStore = EventStore>(\n    getEventStore: () => Store,\n    getApplication: (eventStore: Store) => Application | Promise<Application>,\n  ): ApiE2ESpecification => {\n    {\n      return (...givenRequests: TestRequest[]) => {\n        const eventStore = getEventStore();\n\n        return {\n          when: (setupRequest: TestRequest) => {\n            const handle = async () => {\n              const application = await Promise.resolve(getApplication(eventStore));\n\n              for (const requestFn of givenRequests) {\n                await requestFn(supertest(application));\n              }\n\n              return setupRequest(supertest(application));\n            };\n\n            return {\n              then: async (\n                verify: ApiE2ESpecificationAssert,\n              ): Promise<void> => {\n                const response = await handle();\n\n                verify.forEach((assertion) => {\n                  const succeeded = assertion(response);\n\n                  if (succeeded === false) assert.fail();\n                });\n              },\n            };\n          },\n        };\n      };\n    }\n  },\n};\n","import {\n  WrapEventStore,\n  assertEqual,\n  assertFails,\n  assertMatches,\n  type Event,\n  type EventStore,\n  type TestEventStream,\n} from '@event-driven-io/emmett';\nimport { type Application } from 'express';\nimport type { ProblemDocument } from 'http-problem-details';\nimport type { Response, Test } from 'supertest';\nimport supertest from 'supertest';\nimport type TestAgent from 'supertest/lib/agent';\n\n////////////////////////////////\n/////////// Setup\n////////////////////////////////\n\nexport type TestRequest = (request: TestAgent<supertest.Test>) => Test;\n\nexport const existingStream = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\n////////////////////////////////\n/////////// Asserts\n////////////////////////////////\n\nexport type ResponseAssert = (response: Response) => boolean | void;\n\nexport type ApiSpecificationAssert<EventType extends Event = Event> =\n  | TestEventStream<EventType>[]\n  | ResponseAssert\n  | [ResponseAssert, ...TestEventStream<EventType>[]];\n\nexport const expect = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\nexport const expectNewEvents = <EventType extends Event = Event>(\n  streamId: string,\n  events: EventType[],\n): TestEventStream<EventType> => {\n  return [streamId, events];\n};\n\nexport const expectResponse =\n  <Body = unknown>(\n    statusCode: number,\n    options?: { body?: Body; headers?: { [index: string]: string } },\n  ) =>\n  (response: Response): void => {\n    const { body, headers } = options ?? {};\n    assertEqual(statusCode, response.statusCode, \"Response code doesn't match\");\n    if (body) assertMatches(response.body, body);\n    if (headers) assertMatches(response.headers, headers);\n  };\n\nexport const expectError = (\n  errorCode: number,\n  problemDetails?: Partial<ProblemDocument>,\n) =>\n  expectResponse(\n    errorCode,\n    problemDetails ? { body: problemDetails } : undefined,\n  );\n\n////////////////////////////////\n/////////// Api Specification\n////////////////////////////////\n\nexport type ApiSpecification<EventType extends Event = Event> = (\n  ...givenStreams: TestEventStream<EventType>[]\n) => {\n  when: (setupRequest: TestRequest) => {\n    then: (verify: ApiSpecificationAssert<EventType>) => Promise<void>;\n  };\n};\n\nexport const ApiSpecification = {\n  for: <\n    EventType extends Event = Event,\n    Store extends EventStore<import('@event-driven-io/emmett').ReadEventMetadataWithGlobalPosition> = EventStore<import('@event-driven-io/emmett').ReadEventMetadataWithGlobalPosition>\n  >(\n    getEventStore: () => Store,\n    getApplication: (eventStore: Store) => Application | Promise<Application>,\n  ): ApiSpecification<EventType> => {\n    {\n      return (...givenStreams: TestEventStream<EventType>[]) => {\n        const eventStore = WrapEventStore(getEventStore());\n\n        return {\n          when: (setupRequest: TestRequest) => {\n            const handle = async () => {\n              const application = await Promise.resolve(getApplication(eventStore));\n\n              for (const [streamName, events] of givenStreams) {\n                await eventStore.setup(streamName, events);\n              }\n\n              return setupRequest(supertest(application));\n            };\n\n            return {\n              then: async (\n                verify: ApiSpecificationAssert<EventType>,\n              ): Promise<void> => {\n                const response = await handle();\n\n                if (typeof verify === 'function') {\n                  const succeeded = verify(response);\n\n                  if (succeeded === false) assertFails();\n                } else if (Array.isArray(verify)) {\n                  const [first, ...rest] = verify;\n\n                  if (typeof first === 'function') {\n                    const succeeded = first(response);\n\n                    if (succeeded === false) assertFails();\n                  }\n\n                  const events = typeof first === 'function' ? rest : verify;\n\n                  assertMatches(\n                    Array.from(eventStore.appendedEvents.values()),\n                    events,\n                  );\n                }\n              },\n            };\n          },\n        };\n      };\n    }\n  },\n};\n"]}