@emmett-community/emmett-expressjs-with-openapi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andre X Costa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @emmett-community/emmett-expressjs-with-openapi
+
+Express.js utilities for Emmett applications that want OpenAPI 3.x validation without pulling the whole Emmett core. This package wires [`express-openapi-validator`](https://github.com/cdimascio/express-openapi-validator) into the Emmett application builder so you can validate requests, responses, security handlers, file uploads, and formats from a single OpenAPI document.
+
+## Why this package?
+
+- Built as a standalone module extracted from the original `@event-driven-io/emmett` repo so it can evolve independently.
+- Keeps the OpenAPI document as the single source of truth across manual routers, validation, and `operationHandlers`.
+- Ships with batteries included: problem-details error handling, helpers for tests, and examples for real-world setups.
+
+## Installation
+
+```bash
+npm install @emmett-community/emmett-expressjs-with-openapi
+npm install express-openapi-validator   # optional peer dependency
+```
+
+Other peer requirements (`express`, `@event-driven-io/emmett`, etc.) follow the versions listed in `package.json`.
+
+## Quick start
+
+```typescript
+import {
+  getApplication,
+  createOpenApiValidatorOptions,
+} from '@emmett-community/emmett-expressjs-with-openapi';
+
+const app = getApplication({
+  apis: [myApi],
+  openApiValidator: createOpenApiValidatorOptions('./openapi.yaml', {
+    validateRequests: true,
+    validateResponses: process.env.NODE_ENV === 'development',
+  }),
+});
+```
+
+Prefer to parse the spec once and share it? Load the `.yml` document manually and reuse it for routing, validation, and automatic `operationHandlers`.
+
+```typescript
+import path from 'node:path';
+import { readFileSync } from 'node:fs';
+import { parse } from 'yaml';
+
+const spec = parse(readFileSync(new URL('./openapi.yml', import.meta.url), 'utf-8'));
+
+const app = getApplication({
+  apis: [usersApi],
+  openApiValidator: createOpenApiValidatorOptions(spec, {
+    operationHandlers: path.join(path.dirname(import.meta.url), './handlers'),
+  }),
+});
+```
+
+## Configuration highlights
+
+`createOpenApiValidatorOptions` forwards every option from `express-openapi-validator`, so you can:
+
+- 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.
+- Reuse `$ref` parsing, custom formats, and file upload middleware exactly as in the upstream validator.
+
+Head to [`docs/openapi-validation.md`](docs/openapi-validation.md) for the full matrix of options, extended explanations, and complete examples. Keeping that document allows us to document advanced scenarios without bloating the README.
+
+## Examples
+
+Working examples live under `examples/`:
+
+- `examples/shopping-cart` – feature-complete Emmett sample (business logic, memory store/publisher, security handlers, OpenAPI file, unit/int/e2e tests, `.http` scripts).
+- Legacy quick starts:
+  - `examples/basic` – manual routes + validation (minimal scaffolding).
+  - `examples/with-security` – standalone security handler demo.
+  - `examples/operation-handlers` – barebones `operationHandlers` showcase.
+
+## Tests
+
+The package includes comprehensive test coverage:
+
+- **Unit tests** (`test/unit/`) - Utilities for ETag handling, error mapping
+- **Integration tests** (`test/integration/`) - Basic routing, OpenAPI validation, operation handlers, optimistic concurrency
+- **E2E tests** (`test/e2e/`) - End-to-end workflows for all features
+
+Run `npm test` to execute the whole suite (unit + integration + e2e) or use:
+
+- `npm run test:unit` - Unit tests only
+- `npm run test:int` - Integration tests only
+- `npm run test:e2e` - E2E tests only
+
+## Documentation
+
+- **Guide:** [`docs/openapi-validation.md`](docs/openapi-validation.md) – authoritative reference for configuration, advanced usage, and troubleshooting.
+- **Emmett docs:** <https://event-driven-io.github.io/emmett/>
+
+## Contributing
+
+Issues and PRs are welcome! Please open a discussion or ticket if you are unsure about the direction of a change before coding.
+
+## License
+
+MIT

package/dist/chunk-5TC7YUZR.js

@@ -0,0 +1,38 @@
+// src/internal/esm-resolver.ts
+import { createRequire } from "module";
+import path from "path";
+var isPatched = false;
+var moduleCache = /* @__PURE__ */ new Map();
+var registerHandlerModule = (modulePath, moduleExports) => {
+  moduleCache.set(modulePath, moduleExports);
+};
+var activateESMResolver = () => {
+  if (isPatched) {
+    return;
+  }
+  const require2 = createRequire(import.meta.url);
+  const Module = require2("module");
+  const originalLoad = Module._load;
+  Module._load = function(request, parent, isMain) {
+    const caller = parent?.filename;
+    const isValidatorLoading = caller?.includes("express-openapi-validator");
+    const isHandlerModule = request.includes("handlers");
+    if (isValidatorLoading && isHandlerModule) {
+      const absolutePath = path.isAbsolute(request) ? request : path.resolve(path.dirname(caller), request);
+      if (moduleCache.has(absolutePath)) {
+        return moduleCache.get(absolutePath);
+      }
+      throw new Error(
+        `Handler module not registered: ${absolutePath}. Make sure initializeHandlers imports and registers the module.`
+      );
+    }
+    return originalLoad.call(this, request, parent, isMain);
+  };
+  isPatched = true;
+};
+
+export {
+  registerHandlerModule,
+  activateESMResolver
+};
+//# sourceMappingURL=chunk-5TC7YUZR.js.map

package/dist/chunk-5TC7YUZR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/esm-resolver.ts"],"sourcesContent":["/**\n * ESM Resolver for express-openapi-validator operation handlers.\n *\n * INTERNAL MODULE - Not part of public API.\n *\n * PROBLEM:\n * When using TypeScript runtime (tsx) with express-openapi-validator's operationHandlers:\n * - Our code uses `import()` to load handlers (ESM)\n * - express-openapi-validator uses `require()` to load handlers (CJS)\n * - Node.js maintains separate module caches for ESM and CJS\n * - This creates TWO separate instances of the same handler module\n * - Dependencies injected via module-level variables in one instance don't reach the other\n *\n * SOLUTION:\n * This module monkey-patches Module.prototype.require to intercept when\n * express-openapi-validator loads operation handlers and forces it to use\n * dynamic import() instead of require(). This ensures both sides share the\n * same ESM module instance, allowing module-level variables to work correctly.\n *\n * USAGE:\n * This module is automatically activated by getApplication() when operationHandlers\n * are configured. Applications don't need to import or configure anything.\n *\n * LIMITATIONS:\n * - Relies on heuristic detection (caller path includes 'express-openapi-validator')\n * - May break if express-openapi-validator changes its internal loading mechanism\n * - Adds \"magic\" behavior that may not be immediately obvious to developers\n *\n * FUTURE:\n * If express-openapi-validator migrates to native ESM, this resolver becomes\n * unnecessary and will safely become a no-op.\n */\n\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nlet isPatched = false;\nconst moduleCache = new Map<string, any>();\n\n/**\n * Registers a pre-loaded ESM module so it can be returned synchronously\n * when express-openapi-validator tries to require() it.\n */\nexport const registerHandlerModule = (modulePath: string, moduleExports: any): void => {\n  moduleCache.set(modulePath, moduleExports);\n};\n\n/**\n * Activates the ESM resolver for express-openapi-validator handler loading.\n */\nexport const activateESMResolver = (): void => {\n  if (isPatched) {\n    return;\n  }\n\n  const require = createRequire(import.meta.url);\n  const Module = require('module');\n  const originalLoad = Module._load;\n\n  Module._load = function (request: string, parent: any, isMain: boolean) {\n    const caller = parent?.filename;\n    const isValidatorLoading = caller?.includes('express-openapi-validator');\n    const isHandlerModule = request.includes('handlers');\n\n    if (isValidatorLoading && isHandlerModule) {\n      const absolutePath = path.isAbsolute(request)\n        ? request\n        : path.resolve(path.dirname(caller), request);\n\n      // Check if we have this module pre-registered\n      if (moduleCache.has(absolutePath)) {\n        return moduleCache.get(absolutePath);\n      }\n\n      throw new Error(\n        `Handler module not registered: ${absolutePath}. ` +\n        `Make sure initializeHandlers imports and registers the module.`\n      );\n    }\n\n    return originalLoad.call(this, request, parent, isMain);\n  };\n\n  isPatched = true;\n};\n"],"mappings":";AAiCA,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAEjB,IAAI,YAAY;AAChB,IAAM,cAAc,oBAAI,IAAiB;AAMlC,IAAM,wBAAwB,CAAC,YAAoB,kBAA6B;AACrF,cAAY,IAAI,YAAY,aAAa;AAC3C;AAKO,IAAM,sBAAsB,MAAY;AAC7C,MAAI,WAAW;AACb;AAAA,EACF;AAEA,QAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,QAAM,SAASA,SAAQ,QAAQ;AAC/B,QAAM,eAAe,OAAO;AAE5B,SAAO,QAAQ,SAAU,SAAiB,QAAa,QAAiB;AACtE,UAAM,SAAS,QAAQ;AACvB,UAAM,qBAAqB,QAAQ,SAAS,2BAA2B;AACvE,UAAM,kBAAkB,QAAQ,SAAS,UAAU;AAEnD,QAAI,sBAAsB,iBAAiB;AACzC,YAAM,eAAe,KAAK,WAAW,OAAO,IACxC,UACA,KAAK,QAAQ,KAAK,QAAQ,MAAM,GAAG,OAAO;AAG9C,UAAI,YAAY,IAAI,YAAY,GAAG;AACjC,eAAO,YAAY,IAAI,YAAY;AAAA,MACrC;AAEA,YAAM,IAAI;AAAA,QACR,kCAAkC,YAAY;AAAA,MAEhD;AAAA,IACF;AAEA,WAAO,aAAa,KAAK,MAAM,SAAS,QAAQ,MAAM;AAAA,EACxD;AAEA,cAAY;AACd;","names":["require"]}

package/dist/chunk-GS7T56RP.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+
+
+exports.importMetaUrl = importMetaUrl;
+//# sourceMappingURL=chunk-GS7T56RP.cjs.map

package/dist/chunk-GS7T56RP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/chunk-GS7T56RP.cjs","../node_modules/tsup/assets/cjs_shims.js"],"names":[],"mappings":"AAAA;ACKA,IAAM,iBAAA,EAAmB,CAAA,EAAA,GACvB,OAAO,SAAA,IAAa,YAAA,EAChB,IAAI,GAAA,CAAI,CAAA,KAAA,EAAQ,UAAU,CAAA,CAAA;AAK8B;ADT4B;AACA;AACA;AACA","file":"/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/chunk-GS7T56RP.cjs","sourcesContent":[null,"// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"]}

package/dist/chunk-MRSGTROW.cjs

@@ -0,0 +1,42 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } 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; }
+
+var _chunkGS7T56RPcjs = require('./chunk-GS7T56RP.cjs');
+
+// src/internal/esm-resolver.ts
+var _module = require('module');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var isPatched = false;
+var moduleCache = /* @__PURE__ */ new Map();
+var registerHandlerModule = (modulePath, moduleExports) => {
+  moduleCache.set(modulePath, moduleExports);
+};
+var activateESMResolver = () => {
+  if (isPatched) {
+    return;
+  }
+  const require2 = _module.createRequire.call(void 0, _chunkGS7T56RPcjs.importMetaUrl);
+  const Module = require2("module");
+  const originalLoad = Module._load;
+  Module._load = function(request, parent, isMain) {
+    const caller = _optionalChain([parent, 'optionalAccess', _ => _.filename]);
+    const isValidatorLoading = _optionalChain([caller, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3("express-openapi-validator")]);
+    const isHandlerModule = request.includes("handlers");
+    if (isValidatorLoading && isHandlerModule) {
+      const absolutePath = _path2.default.isAbsolute(request) ? request : _path2.default.resolve(_path2.default.dirname(caller), request);
+      if (moduleCache.has(absolutePath)) {
+        return moduleCache.get(absolutePath);
+      }
+      throw new Error(
+        `Handler module not registered: ${absolutePath}. Make sure initializeHandlers imports and registers the module.`
+      );
+    }
+    return originalLoad.call(this, request, parent, isMain);
+  };
+  isPatched = true;
+};
+
+
+
+
+exports.registerHandlerModule = registerHandlerModule; exports.activateESMResolver = activateESMResolver;
+//# sourceMappingURL=chunk-MRSGTROW.cjs.map

package/dist/chunk-MRSGTROW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/chunk-MRSGTROW.cjs","../src/internal/esm-resolver.ts"],"names":["require"],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;AC6BA,gCAA8B;AAC9B,wEAAiB;AAEjB,IAAI,UAAA,EAAY,KAAA;AAChB,IAAM,YAAA,kBAAc,IAAI,GAAA,CAAiB,CAAA;AAMlC,IAAM,sBAAA,EAAwB,CAAC,UAAA,EAAoB,aAAA,EAAA,GAA6B;AACrF,EAAA,WAAA,CAAY,GAAA,CAAI,UAAA,EAAY,aAAa,CAAA;AAC3C,CAAA;AAKO,IAAM,oBAAA,EAAsB,CAAA,EAAA,GAAY;AAC7C,EAAA,GAAA,CAAI,SAAA,EAAW;AACb,IAAA,MAAA;AAAA,EACF;AAEA,EAAA,MAAMA,SAAAA,EAAU,mCAAA,+BAA6B,CAAA;AAC7C,EAAA,MAAM,OAAA,EAASA,QAAAA,CAAQ,QAAQ,CAAA;AAC/B,EAAA,MAAM,aAAA,EAAe,MAAA,CAAO,KAAA;AAE5B,EAAA,MAAA,CAAO,MAAA,EAAQ,QAAA,CAAU,OAAA,EAAiB,MAAA,EAAa,MAAA,EAAiB;AACtE,IAAA,MAAM,OAAA,kBAAS,MAAA,2BAAQ,UAAA;AACvB,IAAA,MAAM,mBAAA,kBAAqB,MAAA,6BAAQ,QAAA,mBAAS,2BAA2B,GAAA;AACvE,IAAA,MAAM,gBAAA,EAAkB,OAAA,CAAQ,QAAA,CAAS,UAAU,CAAA;AAEnD,IAAA,GAAA,CAAI,mBAAA,GAAsB,eAAA,EAAiB;AACzC,MAAA,MAAM,aAAA,EAAe,cAAA,CAAK,UAAA,CAAW,OAAO,EAAA,EACxC,QAAA,EACA,cAAA,CAAK,OAAA,CAAQ,cAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,CAAA;AAG9C,MAAA,GAAA,CAAI,WAAA,CAAY,GAAA,CAAI,YAAY,CAAA,EAAG;AACjC,QAAA,OAAO,WAAA,CAAY,GAAA,CAAI,YAAY,CAAA;AAAA,MACrC;AAEA,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,+BAAA,EAAkC,YAAY,CAAA,gEAAA;AAAA,MAEhD,CAAA;AAAA,IACF;AAEA,IAAA,OAAO,YAAA,CAAa,IAAA,CAAK,IAAA,EAAM,OAAA,EAAS,MAAA,EAAQ,MAAM,CAAA;AAAA,EACxD,CAAA;AAEA,EAAA,UAAA,EAAY,IAAA;AACd,CAAA;ADhDA;AACA;AACE;AACA;AACF,yGAAC","file":"/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/chunk-MRSGTROW.cjs","sourcesContent":[null,"/**\n * ESM Resolver for express-openapi-validator operation handlers.\n *\n * INTERNAL MODULE - Not part of public API.\n *\n * PROBLEM:\n * When using TypeScript runtime (tsx) with express-openapi-validator's operationHandlers:\n * - Our code uses `import()` to load handlers (ESM)\n * - express-openapi-validator uses `require()` to load handlers (CJS)\n * - Node.js maintains separate module caches for ESM and CJS\n * - This creates TWO separate instances of the same handler module\n * - Dependencies injected via module-level variables in one instance don't reach the other\n *\n * SOLUTION:\n * This module monkey-patches Module.prototype.require to intercept when\n * express-openapi-validator loads operation handlers and forces it to use\n * dynamic import() instead of require(). This ensures both sides share the\n * same ESM module instance, allowing module-level variables to work correctly.\n *\n * USAGE:\n * This module is automatically activated by getApplication() when operationHandlers\n * are configured. Applications don't need to import or configure anything.\n *\n * LIMITATIONS:\n * - Relies on heuristic detection (caller path includes 'express-openapi-validator')\n * - May break if express-openapi-validator changes its internal loading mechanism\n * - Adds \"magic\" behavior that may not be immediately obvious to developers\n *\n * FUTURE:\n * If express-openapi-validator migrates to native ESM, this resolver becomes\n * unnecessary and will safely become a no-op.\n */\n\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\nlet isPatched = false;\nconst moduleCache = new Map<string, any>();\n\n/**\n * Registers a pre-loaded ESM module so it can be returned synchronously\n * when express-openapi-validator tries to require() it.\n */\nexport const registerHandlerModule = (modulePath: string, moduleExports: any): void => {\n  moduleCache.set(modulePath, moduleExports);\n};\n\n/**\n * Activates the ESM resolver for express-openapi-validator handler loading.\n */\nexport const activateESMResolver = (): void => {\n  if (isPatched) {\n    return;\n  }\n\n  const require = createRequire(import.meta.url);\n  const Module = require('module');\n  const originalLoad = Module._load;\n\n  Module._load = function (request: string, parent: any, isMain: boolean) {\n    const caller = parent?.filename;\n    const isValidatorLoading = caller?.includes('express-openapi-validator');\n    const isHandlerModule = request.includes('handlers');\n\n    if (isValidatorLoading && isHandlerModule) {\n      const absolutePath = path.isAbsolute(request)\n        ? request\n        : path.resolve(path.dirname(caller), request);\n\n      // Check if we have this module pre-registered\n      if (moduleCache.has(absolutePath)) {\n        return moduleCache.get(absolutePath);\n      }\n\n      throw new Error(\n        `Handler module not registered: ${absolutePath}. ` +\n        `Make sure initializeHandlers imports and registers the module.`\n      );\n    }\n\n    return originalLoad.call(this, request, parent, isMain);\n  };\n\n  isPatched = true;\n};\n"]}

package/dist/esm-resolver-I5MW2PIQ.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkMRSGTROWcjs = require('./chunk-MRSGTROW.cjs');
+require('./chunk-GS7T56RP.cjs');
+
+
+
+exports.activateESMResolver = _chunkMRSGTROWcjs.activateESMResolver; exports.registerHandlerModule = _chunkMRSGTROWcjs.registerHandlerModule;
+//# sourceMappingURL=esm-resolver-I5MW2PIQ.cjs.map

package/dist/esm-resolver-I5MW2PIQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/esm-resolver-I5MW2PIQ.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACF,6IAAC","file":"/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/esm-resolver-I5MW2PIQ.cjs"}

package/dist/esm-resolver-ZL5JTVDP.js

@@ -0,0 +1,9 @@
+import {
+  activateESMResolver,
+  registerHandlerModule
+} from "./chunk-5TC7YUZR.js";
+export {
+  activateESMResolver,
+  registerHandlerModule
+};
+//# sourceMappingURL=esm-resolver-ZL5JTVDP.js.map

package/dist/esm-resolver-ZL5JTVDP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/handler-importer-4BVBIZX3.cjs

@@ -0,0 +1,27 @@
+"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');
+require('./chunk-GS7T56RP.cjs');
+
+// src/internal/handler-importer.ts
+var _url = require('url');
+async function importAndRegisterHandlers(modules) {
+  const importedHandlers = {};
+  for (const module of modules) {
+    try {
+      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;
+    } catch (error) {
+      throw new Error(
+        `Failed to import handler module "${module.moduleName}" from ${module.absolutePath}: ${error.message}`
+      );
+    }
+  }
+  return importedHandlers;
+}
+
+
+exports.importAndRegisterHandlers = importAndRegisterHandlers;
+//# sourceMappingURL=handler-importer-4BVBIZX3.cjs.map

package/dist/handler-importer-4BVBIZX3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/handler-importer-4BVBIZX3.cjs","../src/internal/handler-importer.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACIA,0BAA8B;AAY9B,MAAA,SAAsB,yBAAA,CACpB,OAAA,EACiC;AACjC,EAAA,MAAM,iBAAA,EAA2C,CAAC,CAAA;AAElD,EAAA,IAAA,CAAA,MAAW,OAAA,GAAU,OAAA,EAAS;AAC5B,IAAA,IAAI;AAEF,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;AAAA,IACxC,EAAA,MAAA,CAAS,KAAA,EAAO;AACd,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;AD1BA;AACA;AACA","file":"/Users/axcosta/Git/pessoal/oss/emmett-community/emmett-expressjs-with-openapi/dist/handler-importer-4BVBIZX3.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 { 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 * @returns Object containing all imported modules, keyed by module name\n */\nexport async function importAndRegisterHandlers(\n  modules: HandlerModuleInfo[],\n): Promise<ImportedHandlerModules> {\n  const importedHandlers: ImportedHandlerModules = {};\n\n  for (const module of modules) {\n    try {\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    } catch (error) {\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/handler-importer-OJGFQON5.js

@@ -0,0 +1,26 @@
+import {
+  registerHandlerModule
+} from "./chunk-5TC7YUZR.js";
+
+// src/internal/handler-importer.ts
+import { pathToFileURL } from "url";
+async function importAndRegisterHandlers(modules) {
+  const importedHandlers = {};
+  for (const module of modules) {
+    try {
+      const fileUrl = pathToFileURL(module.absolutePath).href;
+      const importedModule = await import(fileUrl);
+      registerHandlerModule(module.absolutePath, importedModule);
+      importedHandlers[module.moduleName] = importedModule;
+    } catch (error) {
+      throw new Error(
+        `Failed to import handler module "${module.moduleName}" from ${module.absolutePath}: ${error.message}`
+      );
+    }
+  }
+  return importedHandlers;
+}
+export {
+  importAndRegisterHandlers
+};
+//# sourceMappingURL=handler-importer-OJGFQON5.js.map

package/dist/handler-importer-OJGFQON5.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 { 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 * @returns Object containing all imported modules, keyed by module name\n */\nexport async function importAndRegisterHandlers(\n  modules: HandlerModuleInfo[],\n): Promise<ImportedHandlerModules> {\n  const importedHandlers: ImportedHandlerModules = {};\n\n  for (const module of modules) {\n    try {\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    } catch (error) {\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;AAY9B,eAAsB,0BACpB,SACiC;AACjC,QAAM,mBAA2C,CAAC;AAElD,aAAW,UAAU,SAAS;AAC5B,QAAI;AAEF,YAAM,UAAU,cAAc,OAAO,YAAY,EAAE;AAGnD,YAAM,iBAAiB,MAAM,OAAO;AAGpC,4BAAsB,OAAO,cAAc,cAAc;AAGzD,uBAAiB,OAAO,UAAU,IAAI;AAAA,IACxC,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,oCAAoC,OAAO,UAAU,UAAU,OAAO,YAAY,KAC/E,MAAgB,OACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}