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

package/README.md

@@ -31,16 +31,19 @@ npm install @my-f-startup/firebase-auth-express  # optional: Firebase Auth handl
 ### Peer Dependencies
 
 Required:
+
 - `@event-driven-io/emmett` ^0.39.1
 - `express` ^4.19.2
 - `express-async-errors` ^3.1.1
 - `http-problem-details` ^0.1.5
 
 TypeScript types:
+
 - `@types/express` ^4.17.21
 - `@types/supertest` ^6.0.2 (if using testing helpers)
 
 Optional (feature-gated):
+
 - `express-openapi-validator` ^5.3.7 (OpenAPI validation)
 - `pino-http` ^9.0.0 (HTTP logging)
 - `@my-f-startup/firebase-auth-express` 0.1.0 (Firebase Auth handlers)
@@ -103,6 +106,7 @@ const app = await getApplication({
 ```
 
 Highlights:
+
 - Enable/disable request or response validation, including per-field tweaks (coercion, unknown query params, removing additional fields, etc.).
 - Register custom security handlers with `validateSecurity.handlers`.
 - Serve the parsed spec via `serveSpec`, configure file upload limits, ignore health-check routes, or validate the spec itself.
@@ -156,25 +160,67 @@ const app = await getApplication({
 
 `@my-f-startup/firebase-auth-express` relies on `firebase-admin`. Make sure the Admin SDK is installed, initialized, and configured for your environment (credentials or emulator).
 
+## Observability
+
+This package supports optional logging and tracing.
+
+### Logging
+
+Inject a Pino-compatible logger:
+
+```typescript
+import pino from 'pino';
+
+const logger = pino();
+
+const app = await getApplication({
+  observability: { logger },
+});
+
+startAPI(app, { port: 3000, logger });
+```
+
+No logs are emitted when logger is not provided.
+
+### Tracing
+
+If your application initializes OpenTelemetry, this package will emit spans automatically. Tracing is passive - spans are no-ops when OpenTelemetry is not configured.
+
+```typescript
+import { tracedOn, OK } from '@emmett-community/emmett-expressjs-with-openapi';
+
+router.post('/carts', tracedOn(async (req) => {
+  // Your handler logic
+  return OK({ body: { success: true } });
+}));
+```
+
+This package never initializes OpenTelemetry - configure your tracer provider in your application.
+
 ## API Reference
 
 ### Application
+
 - `getApplication(options)` - Creates and configures the Express app.
 - `startAPI(app, options)` - Starts the HTTP server.
 
 ### OpenAPI
+
 - `createOpenApiValidatorOptions(apiSpec, options)` - Helper to assemble OpenAPI validator config.
 - `isOpenApiValidatorAvailable()` - Type guard for optional validator dependency.
 - `createFirebaseAuthSecurityHandlers(options)` - Firebase Auth security handlers.
 - `registerHandlerModule(handlersPath, module)` - Manual registration for operation handlers.
 
 ### HTTP helpers
+
 - `send`, `sendCreated`, `sendAccepted`, `sendProblem` - Standard HTTP responses.
 
 ### ETag helpers
+
 - `toWeakETag`, `getETagFromIfMatch`, `getETagFromIfNotMatch`, `getETagValueFromIfMatch`, `setETag`.
 
 ### Testing helpers
+
 - `ApiSpecification`, `ApiE2ESpecification`
 - `expect`, `expectNewEvents`, `expectResponse`, `expectError`
 

package/dist/chunk-BY65ZALY.cjs

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/observability.ts
+var safeLog = {
+  debug: (logger, msg, data) => _optionalChain([logger, 'optionalAccess', _ => _.debug, 'optionalCall', _2 => _2(msg, data)]),
+  info: (logger, msg, data) => _optionalChain([logger, 'optionalAccess', _3 => _3.info, 'optionalCall', _4 => _4(msg, data)]),
+  warn: (logger, msg, data) => _optionalChain([logger, 'optionalAccess', _5 => _5.warn, 'optionalCall', _6 => _6(msg, data)]),
+  error: (logger, msg, error) => _optionalChain([logger, 'optionalAccess', _7 => _7.error, 'optionalCall', _8 => _8(msg, error)])
+};
+
+
+
+exports.safeLog = safeLog;
+//# sourceMappingURL=chunk-BY65ZALY.cjs.map

package/dist/chunk-BY65ZALY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/chunk-BY65ZALY.cjs","../src/observability.ts"],"names":[],"mappings":"AAAA;AC4CO,IAAM,QAAA,EAAU;AAAA,EACrB,KAAA,EAAO,CAAC,MAAA,EAA4B,GAAA,EAAa,IAAA,EAAA,mBAC/C,MAAA,2BAAQ,KAAA,0BAAA,CAAQ,GAAA,EAAK,IAAI,GAAA;AAAA,EAC3B,IAAA,EAAM,CAAC,MAAA,EAA4B,GAAA,EAAa,IAAA,EAAA,mBAC9C,MAAA,6BAAQ,IAAA,0BAAA,CAAO,GAAA,EAAK,IAAI,GAAA;AAAA,EAC1B,IAAA,EAAM,CAAC,MAAA,EAA4B,GAAA,EAAa,IAAA,EAAA,mBAC9C,MAAA,6BAAQ,IAAA,0BAAA,CAAO,GAAA,EAAK,IAAI,GAAA;AAAA,EAC1B,KAAA,EAAO,CAAC,MAAA,EAA4B,GAAA,EAAa,KAAA,EAAA,mBAC/C,MAAA,6BAAQ,KAAA,0BAAA,CAAQ,GAAA,EAAK,KAAK;AAC9B,CAAA;AD9CA;AACA;AACE;AACF,0BAAC","file":"/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/chunk-BY65ZALY.cjs","sourcesContent":[null,"/**\n * Observability types for emmett-expressjs-with-openapi.\n *\n * This module provides optional logging integration\n * following a \"silent by default\" philosophy.\n */\n\n/**\n * Minimal logger interface compatible with Pino, Winston, console, and similar loggers.\n * All methods are optional to support partial implementations.\n */\nexport interface Logger {\n  debug?(msg: string, data?: unknown): void;\n  info?(msg: string, data?: unknown): void;\n  warn?(msg: string, data?: unknown): void;\n  error?(msg: string, err?: unknown): void;\n}\n\n/**\n * Observability configuration options.\n */\nexport type ObservabilityOptions = {\n  /**\n   * Optional logger instance for diagnostic output.\n   * When not provided, the library operates silently.\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  logger?: Logger;\n};\n\n/**\n * Internal helper to safely call logger methods, handling partial implementations.\n * Always use: safeLog.error(logger, msg, error) - never { error }\n */\nexport const safeLog = {\n  debug: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.debug?.(msg, data),\n  info: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.info?.(msg, data),\n  warn: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.warn?.(msg, data),\n  error: (logger: Logger | undefined, msg: string, error?: unknown) =>\n    logger?.error?.(msg, error),\n};\n"]}

package/dist/chunk-I46UH36B.js

@@ -0,0 +1,12 @@
+// src/observability.ts
+var safeLog = {
+  debug: (logger, msg, data) => logger?.debug?.(msg, data),
+  info: (logger, msg, data) => logger?.info?.(msg, data),
+  warn: (logger, msg, data) => logger?.warn?.(msg, data),
+  error: (logger, msg, error) => logger?.error?.(msg, error)
+};
+
+export {
+  safeLog
+};
+//# sourceMappingURL=chunk-I46UH36B.js.map

package/dist/chunk-I46UH36B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability.ts"],"sourcesContent":["/**\n * Observability types for emmett-expressjs-with-openapi.\n *\n * This module provides optional logging integration\n * following a \"silent by default\" philosophy.\n */\n\n/**\n * Minimal logger interface compatible with Pino, Winston, console, and similar loggers.\n * All methods are optional to support partial implementations.\n */\nexport interface Logger {\n  debug?(msg: string, data?: unknown): void;\n  info?(msg: string, data?: unknown): void;\n  warn?(msg: string, data?: unknown): void;\n  error?(msg: string, err?: unknown): void;\n}\n\n/**\n * Observability configuration options.\n */\nexport type ObservabilityOptions = {\n  /**\n   * Optional logger instance for diagnostic output.\n   * When not provided, the library operates silently.\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  logger?: Logger;\n};\n\n/**\n * Internal helper to safely call logger methods, handling partial implementations.\n * Always use: safeLog.error(logger, msg, error) - never { error }\n */\nexport const safeLog = {\n  debug: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.debug?.(msg, data),\n  info: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.info?.(msg, data),\n  warn: (logger: Logger | undefined, msg: string, data?: unknown) =>\n    logger?.warn?.(msg, data),\n  error: (logger: Logger | undefined, msg: string, error?: unknown) =>\n    logger?.error?.(msg, error),\n};\n"],"mappings":";AA4CO,IAAM,UAAU;AAAA,EACrB,OAAO,CAAC,QAA4B,KAAa,SAC/C,QAAQ,QAAQ,KAAK,IAAI;AAAA,EAC3B,MAAM,CAAC,QAA4B,KAAa,SAC9C,QAAQ,OAAO,KAAK,IAAI;AAAA,EAC1B,MAAM,CAAC,QAA4B,KAAa,SAC9C,QAAQ,OAAO,KAAK,IAAI;AAAA,EAC1B,OAAO,CAAC,QAA4B,KAAa,UAC/C,QAAQ,QAAQ,KAAK,KAAK;AAC9B;","names":[]}

package/dist/{handler-importer-OJGFQON5.js → handler-importer-6A237UML.js}

@@ -1,18 +1,37 @@
 import {
   registerHandlerModule
 } from "./chunk-5TC7YUZR.js";
+import {
+  safeLog
+} from "./chunk-I46UH36B.js";
 
 // src/internal/handler-importer.ts
 import { pathToFileURL } from "url";
-async function importAndRegisterHandlers(modules) {
+async function importAndRegisterHandlers(modules, logger) {
+  safeLog.debug(logger, "Importing handler modules", {
+    count: modules.length,
+    modules: modules.map((m) => m.moduleName)
+  });
   const importedHandlers = {};
   for (const module of modules) {
     try {
+      safeLog.debug(logger, "Importing handler module", {
+        moduleName: module.moduleName,
+        absolutePath: module.absolutePath
+      });
       const fileUrl = pathToFileURL(module.absolutePath).href;
       const importedModule = await import(fileUrl);
       registerHandlerModule(module.absolutePath, importedModule);
       importedHandlers[module.moduleName] = importedModule;
+      safeLog.debug(logger, "Handler module imported successfully", {
+        moduleName: module.moduleName
+      });
     } catch (error) {
+      safeLog.error(
+        logger,
+        `Failed to import handler module "${module.moduleName}"`,
+        error
+      );
       throw new Error(
         `Failed to import handler module "${module.moduleName}" from ${module.absolutePath}: ${error.message}`
       );
@@ -23,4 +42,4 @@ async function importAndRegisterHandlers(modules) {
 export {
   importAndRegisterHandlers
 };
-//# sourceMappingURL=handler-importer-OJGFQON5.js.map
+//# sourceMappingURL=handler-importer-6A237UML.js.map

package/dist/handler-importer-6A237UML.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/handler-importer.ts"],"sourcesContent":["/**\n * Handler module importer.\n *\n * INTERNAL MODULE - Not part of public API.\n *\n * Dynamically imports handler modules and registers them in the ESM resolver cache,\n * enabling automatic handler discovery without manual registration.\n */\n\nimport { pathToFileURL } from 'node:url';\nimport { type Logger, safeLog } from '../observability';\nimport { registerHandlerModule } from './esm-resolver.js';\nimport type { HandlerModuleInfo } from './openapi-parser.js';\n\nexport type ImportedHandlerModules = Record<string, any>;\n\n/**\n * Dynamically import and register all handler modules.\n *\n * @param modules - Handler module information from OpenAPI parser\n * @param logger - Optional logger for debug output\n * @returns Object containing all imported modules, keyed by module name\n */\nexport async function importAndRegisterHandlers(\n  modules: HandlerModuleInfo[],\n  logger?: Logger,\n): Promise<ImportedHandlerModules> {\n  safeLog.debug(logger, 'Importing handler modules', {\n    count: modules.length,\n    modules: modules.map((m) => m.moduleName),\n  });\n\n  const importedHandlers: ImportedHandlerModules = {};\n\n  for (const module of modules) {\n    try {\n      safeLog.debug(logger, 'Importing handler module', {\n        moduleName: module.moduleName,\n        absolutePath: module.absolutePath,\n      });\n\n      // Convert to file:// URL for dynamic import\n      const fileUrl = pathToFileURL(module.absolutePath).href;\n\n      // Dynamically import the handler module\n      const importedModule = await import(fileUrl);\n\n      // Register in ESM resolver cache\n      registerHandlerModule(module.absolutePath, importedModule);\n\n      // Store in result object keyed by module name\n      importedHandlers[module.moduleName] = importedModule;\n\n      safeLog.debug(logger, 'Handler module imported successfully', {\n        moduleName: module.moduleName,\n      });\n    } catch (error) {\n      safeLog.error(\n        logger,\n        `Failed to import handler module \"${module.moduleName}\"`,\n        error,\n      );\n      throw new Error(\n        `Failed to import handler module \"${module.moduleName}\" from ${module.absolutePath}: ${\n          (error as Error).message\n        }`,\n      );\n    }\n  }\n\n  return importedHandlers;\n}\n"],"mappings":";;;;;;;;AASA,SAAS,qBAAqB;AAc9B,eAAsB,0BACpB,SACA,QACiC;AACjC,UAAQ,MAAM,QAAQ,6BAA6B;AAAA,IACjD,OAAO,QAAQ;AAAA,IACf,SAAS,QAAQ,IAAI,CAAC,MAAM,EAAE,UAAU;AAAA,EAC1C,CAAC;AAED,QAAM,mBAA2C,CAAC;AAElD,aAAW,UAAU,SAAS;AAC5B,QAAI;AACF,cAAQ,MAAM,QAAQ,4BAA4B;AAAA,QAChD,YAAY,OAAO;AAAA,QACnB,cAAc,OAAO;AAAA,MACvB,CAAC;AAGD,YAAM,UAAU,cAAc,OAAO,YAAY,EAAE;AAGnD,YAAM,iBAAiB,MAAM,OAAO;AAGpC,4BAAsB,OAAO,cAAc,cAAc;AAGzD,uBAAiB,OAAO,UAAU,IAAI;AAEtC,cAAQ,MAAM,QAAQ,wCAAwC;AAAA,QAC5D,YAAY,OAAO;AAAA,MACrB,CAAC;AAAA,IACH,SAAS,OAAO;AACd,cAAQ;AAAA,QACN;AAAA,QACA,oCAAoC,OAAO,UAAU;AAAA,QACrD;AAAA,MACF;AACA,YAAM,IAAI;AAAA,QACR,oCAAoC,OAAO,UAAU,UAAU,OAAO,YAAY,KAC/E,MAAgB,OACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/{handler-importer-4BVBIZX3.cjs → handler-importer-UFV7TKBN.cjs}

@@ -1,19 +1,38 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
 var _chunkMRSGTROWcjs = require('./chunk-MRSGTROW.cjs');
+
+
+var _chunkBY65ZALYcjs = require('./chunk-BY65ZALY.cjs');
 require('./chunk-GS7T56RP.cjs');
 
 // src/internal/handler-importer.ts
 var _url = require('url');
-async function importAndRegisterHandlers(modules) {
+async function importAndRegisterHandlers(modules, logger) {
+  _chunkBY65ZALYcjs.safeLog.debug(logger, "Importing handler modules", {
+    count: modules.length,
+    modules: modules.map((m) => m.moduleName)
+  });
   const importedHandlers = {};
   for (const module of modules) {
     try {
+      _chunkBY65ZALYcjs.safeLog.debug(logger, "Importing handler module", {
+        moduleName: module.moduleName,
+        absolutePath: module.absolutePath
+      });
       const fileUrl = _url.pathToFileURL.call(void 0, module.absolutePath).href;
       const importedModule = await Promise.resolve().then(() => _interopRequireWildcard(require(fileUrl)));
       _chunkMRSGTROWcjs.registerHandlerModule.call(void 0, module.absolutePath, importedModule);
       importedHandlers[module.moduleName] = importedModule;
+      _chunkBY65ZALYcjs.safeLog.debug(logger, "Handler module imported successfully", {
+        moduleName: module.moduleName
+      });
     } catch (error) {
+      _chunkBY65ZALYcjs.safeLog.error(
+        logger,
+        `Failed to import handler module "${module.moduleName}"`,
+        error
+      );
       throw new Error(
         `Failed to import handler module "${module.moduleName}" from ${module.absolutePath}: ${error.message}`
       );
@@ -24,4 +43,4 @@ async function importAndRegisterHandlers(modules) {
 
 
 exports.importAndRegisterHandlers = importAndRegisterHandlers;
-//# sourceMappingURL=handler-importer-4BVBIZX3.cjs.map
+//# sourceMappingURL=handler-importer-UFV7TKBN.cjs.map

package/dist/handler-importer-UFV7TKBN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/handler-importer-UFV7TKBN.cjs","../src/internal/handler-importer.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACCA,0BAA8B;AAc9B,MAAA,SAAsB,yBAAA,CACpB,OAAA,EACA,MAAA,EACiC;AACjC,EAAA,yBAAA,CAAQ,KAAA,CAAM,MAAA,EAAQ,2BAAA,EAA6B;AAAA,IACjD,KAAA,EAAO,OAAA,CAAQ,MAAA;AAAA,IACf,OAAA,EAAS,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,UAAU;AAAA,EAC1C,CAAC,CAAA;AAED,EAAA,MAAM,iBAAA,EAA2C,CAAC,CAAA;AAElD,EAAA,IAAA,CAAA,MAAW,OAAA,GAAU,OAAA,EAAS;AAC5B,IAAA,IAAI;AACF,MAAA,yBAAA,CAAQ,KAAA,CAAM,MAAA,EAAQ,0BAAA,EAA4B;AAAA,QAChD,UAAA,EAAY,MAAA,CAAO,UAAA;AAAA,QACnB,YAAA,EAAc,MAAA,CAAO;AAAA,MACvB,CAAC,CAAA;AAGD,MAAA,MAAM,QAAA,EAAU,gCAAA,MAAc,CAAO,YAAY,CAAA,CAAE,IAAA;AAGnD,MAAA,MAAM,eAAA,EAAiB,MAAM,4DAAA,CAAO,OAAA,GAAA;AAGpC,MAAA,qDAAA,MAAsB,CAAO,YAAA,EAAc,cAAc,CAAA;AAGzD,MAAA,gBAAA,CAAiB,MAAA,CAAO,UAAU,EAAA,EAAI,cAAA;AAEtC,MAAA,yBAAA,CAAQ,KAAA,CAAM,MAAA,EAAQ,sCAAA,EAAwC;AAAA,QAC5D,UAAA,EAAY,MAAA,CAAO;AAAA,MACrB,CAAC,CAAA;AAAA,IACH,EAAA,MAAA,CAAS,KAAA,EAAO;AACd,MAAA,yBAAA,CAAQ,KAAA;AAAA,QACN,MAAA;AAAA,QACA,CAAA,iCAAA,EAAoC,MAAA,CAAO,UAAU,CAAA,CAAA,CAAA;AAAA,QACrD;AAAA,MACF,CAAA;AACA,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,MAAA,CAAO,UAAU,CAAA,OAAA,EAAU,MAAA,CAAO,YAAY,CAAA,EAAA,EAC/E,KAAA,CAAgB,OACnB,CAAA;AAAA,MAAA;AACF,IAAA;AACF,EAAA;AAGF,EAAA;AACF;AD7BA;AACA;AACA","file":"/home/runner/work/emmett-expressjs-with-openapi/emmett-expressjs-with-openapi/dist/handler-importer-UFV7TKBN.cjs","sourcesContent":[null,"/**\n * Handler module importer.\n *\n * INTERNAL MODULE - Not part of public API.\n *\n * Dynamically imports handler modules and registers them in the ESM resolver cache,\n * enabling automatic handler discovery without manual registration.\n */\n\nimport { pathToFileURL } from 'node:url';\nimport { type Logger, safeLog } from '../observability';\nimport { registerHandlerModule } from './esm-resolver.js';\nimport type { HandlerModuleInfo } from './openapi-parser.js';\n\nexport type ImportedHandlerModules = Record<string, any>;\n\n/**\n * Dynamically import and register all handler modules.\n *\n * @param modules - Handler module information from OpenAPI parser\n * @param logger - Optional logger for debug output\n * @returns Object containing all imported modules, keyed by module name\n */\nexport async function importAndRegisterHandlers(\n  modules: HandlerModuleInfo[],\n  logger?: Logger,\n): Promise<ImportedHandlerModules> {\n  safeLog.debug(logger, 'Importing handler modules', {\n    count: modules.length,\n    modules: modules.map((m) => m.moduleName),\n  });\n\n  const importedHandlers: ImportedHandlerModules = {};\n\n  for (const module of modules) {\n    try {\n      safeLog.debug(logger, 'Importing handler module', {\n        moduleName: module.moduleName,\n        absolutePath: module.absolutePath,\n      });\n\n      // Convert to file:// URL for dynamic import\n      const fileUrl = pathToFileURL(module.absolutePath).href;\n\n      // Dynamically import the handler module\n      const importedModule = await import(fileUrl);\n\n      // Register in ESM resolver cache\n      registerHandlerModule(module.absolutePath, importedModule);\n\n      // Store in result object keyed by module name\n      importedHandlers[module.moduleName] = importedModule;\n\n      safeLog.debug(logger, 'Handler module imported successfully', {\n        moduleName: module.moduleName,\n      });\n    } catch (error) {\n      safeLog.error(\n        logger,\n        `Failed to import handler module \"${module.moduleName}\"`,\n        error,\n      );\n      throw new Error(\n        `Failed to import handler module \"${module.moduleName}\" from ${module.absolutePath}: ${\n          (error as Error).message\n        }`,\n      );\n    }\n  }\n\n  return importedHandlers;\n}\n"]}

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 {
@@ -52,8 +58,15 @@ var getApplication = async (options) => {
     disableUrlEncodingMiddleware,
     disableProblemDetailsMiddleware,
     pinoHttp,
-    openApiValidator
+    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) {
@@ -67,8 +80,9 @@ var getApplication = async (options) => {
       const options2 = pinoHttp === true ? void 0 : pinoHttp;
       const middleware = provider(options2);
       app.use(middleware);
-    } catch (e) {
-      console.warn(
+    } 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(
@@ -89,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();
+            }
           }
-        } catch (error) {
-          console.error("Failed to auto-import handler modules:", error);
-          throw error;
+        );
+        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();
+            }
+          }
+        );
+        if (openApiValidator.initializeHandlers) {
+          await openApiValidator.initializeHandlers(importedHandlers);
         }
       }
     } else {
@@ -138,8 +184,9 @@ var getApplication = async (options) => {
       } else {
         app.use(middleware);
       }
-    } catch (e2) {
-      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(
@@ -154,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);
 };
@@ -215,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);
 };
@@ -292,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));
     }
@@ -303,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 (e3) {
+  } catch (e) {
     return false;
   }
 };
@@ -504,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