adorn-api 1.0.4 → 1.0.6

package/dist/scripts/adorn-example.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../scripts/adorn-example.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Adorn-API Example Runner\n * \n * Usage:\n *   npx adorn-example <example-name>\n *   npx adorn-example blog-platform\n *   npx adorn-example task-manager\n * \n * Or from the adorn-api project root:\n *   npm run example <example-name>\n */\n\nimport { execSync, spawn, ChildProcess } from \"child_process\";\nimport { dirname, join } from \"path\";\nimport { existsSync, readdirSync, statSync } from \"fs\";\nimport process from \"node:process\";\n\nconst __filename = process.cwd() + \"/index.js\";\nconst __dirname = dirname(__filename);\n\nfunction isWindows(): boolean {\n  return process.platform === \"win32\";\n}\n\nfunction runCommand(command: string, cwd: string): void {\n  const shell = isWindows() ? \"cmd.exe\" : \"/bin/bash\";\n  execSync(command, { cwd, stdio: \"inherit\", shell });\n}\n\nfunction spawnCommand(args: string[], cwd: string): Promise<ChildProcess> {\n  return new Promise((resolve, reject) => {\n    const cmd = isWindows() ? \"npm.cmd\" : \"npm\";\n    const child = spawn(cmd, args, {\n      cwd,\n      stdio: \"inherit\",\n      shell: isWindows(),\n    });\n\n    child.on(\"error\", reject);\n    resolve(child);\n  });\n}\n\nfunction getExamples(): string[] {\n  const examplesDir = join(__dirname, \"..\", \"examples\");\n  if (!existsSync(examplesDir)) return [];\n  return readdirSync(examplesDir).filter(name => {\n    const path = join(examplesDir, name);\n    return statSync(path).isDirectory();\n  });\n}\n\nfunction printHelp(): void {\n  console.log(`\nUsage: npx adorn-example <example-name>\n\nRun an adorn-api example with automatic dependency installation.\n\nExamples:\n  npx adorn-example blog-platform\n  npx adorn-example task-manager\n  npx adorn-example basic\n\nAvailable examples:\n${getExamples().map(e => `  - ${e}`).join(\"\\n\")}\n\nOptions:\n  -h, --help     Show this help message\n  -l, --list     List all available examples\n\nFrom the adorn-api project root, you can also use:\n  npm run example <example-name>\n`);\n}\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n  \n  if (args.includes(\"-h\") || args.includes(\"--help\")) {\n    printHelp();\n    process.exit(0);\n  }\n\n  if (args.includes(\"-l\") || args.includes(\"--list\")) {\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(0);\n  }\n\n  const example = args[0] || \"basic\";\n  const examplePath = join(__dirname, \"..\", \"examples\", example);\n\n  if (!existsSync(examplePath)) {\n    console.error(`\\n❌ Example \"${example}\" not found.\\n`);\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(1);\n  }\n\n  console.log(`\\n🚀 Running \"${example}\" example...\\n`);\n\n  let child: ChildProcess | null = null;\n\n  try {\n    const nodeModulesPath = join(examplePath, \"node_modules\");\n    const nodeModulesExists = existsSync(nodeModulesPath);\n\n    if (!nodeModulesExists) {\n      console.log(\"📦 Installing dependencies...\");\n      runCommand(\"npm install\", examplePath);\n    }\n\n    console.log(\"📦 Building artifacts...\");\n    runCommand(\"npm run build\", examplePath);\n\n    console.log(\"🌐 Starting server...\\n\");\n    console.log(\"Press Ctrl+C to stop\\n\");\n\n    child = await spawnCommand([\"run\", \"dev\"], examplePath);\n\n    process.on(\"SIGINT\", () => {\n      if (child) child.kill(\"SIGINT\");\n    });\n\n    process.on(\"SIGTERM\", () => {\n      if (child) child.kill(\"SIGTERM\");\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      if (!child) {\n        reject(new Error(\"Child process not started\"));\n        return;\n      }\n      child.on(\"exit\", (code) => {\n        if (code === 0 || code === null) {\n          resolve();\n        } else {\n          reject(new Error(`Process exited with code ${code}`));\n        }\n      });\n      child.on(\"error\", reject);\n    });\n  } catch (err: any) {\n    if (err.code !== \"SIGINT\" && err.code !== \"SIGTERM\") {\n      console.error(`\\n❌ Error: ${err.message}`);\n      process.exit(1);\n    }\n  }\n}\n\nmain();\n"],"mappings":"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","names":["process"]}

package/dist/utils/operationId.d.ts

@@ -0,0 +1,2 @@
+export declare function defaultOperationId(controllerName: string, methodName: string): string;
+//# sourceMappingURL=operationId.d.ts.map

package/dist/utils/operationId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationId.d.ts","sourceRoot":"","sources":["../../src/utils/operationId.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF"}

package/dist/utils/path.d.ts

@@ -0,0 +1,2 @@
+export declare function joinPaths(base: string, sub: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/package.json

@@ -1,57 +1,92 @@
-{
-  "name": "adorn-api",
-  "version": "1.0.4",
-  "description": "Stage-3 decorator router + OpenAPI, with optional MetalORM integration",
-  "license": "MIT",
-  "type": "module",
-  "sideEffects": false,
-  "files": [
-    "dist"
-  ],
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./express": {
-      "types": "./dist/express.d.ts",
-      "default": "./dist/express.js"
-    },
-    "./metal-orm": {
-      "types": "./dist/metal-orm.d.ts",
-      "default": "./dist/metal-orm.js"
-    }
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "express": "^5.2.1",
-    "metal-orm": "^1.0.64"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.6",
-    "@types/node": "^25.0.3",
-    "@types/supertest": "^6.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "sqlite3": "^5.1.7",
-    "supertest": "^7.1.4",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
-  },
-  "scripts": {
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json",
-    "check": "npm run lint && npm run typecheck && npm run check:decorated-returns && npm run test",
-    "lint": "eslint src test --ext .ts",
-    "check:decorated-returns": "node scripts/check-decorated-returns.js",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:e2e": "vitest run test/e2e"
-  }
-}
+{
+  "name": "adorn-api",
+  "version": "1.0.6",
+  "description": "Stage-3 decorator-first OpenAPI + routing toolkit",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "import": "./dist/express.js",
+      "require": "./dist/express.cjs"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js",
+      "require": "./dist/cli.cjs"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js",
+      "require": "./dist/schema/index.cjs"
+    },
+    "./metal": {
+      "types": "./dist/metal/index.d.ts",
+      "import": "./dist/metal/index.js",
+      "require": "./dist/metal/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "adorn-api": "./dist/cli.cjs",
+    "adorn-example": "./dist/scripts/adorn-example.cjs"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src --ext .ts",
+    "check": "npm run typecheck && npm run test",
+    "build:js": "tsup src/index.ts src/express.ts src/cli.ts src/schema/index.ts src/metal/index.ts --format esm,cjs --out-dir dist --sourcemap --no-splitting && tsup scripts/adorn-example.ts --format cjs --out-dir dist/scripts --sourcemap --no-splitting",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build": "npm run clean && npm run build:js && npm run build:types",
+    "test": "npm run build && vitest run",
+    "test:staleness": "npm run build && vitest run test/cache/staleness.test.ts",
+    "dev": "tsx src/cli.ts dev",
+    "example": "tsx scripts/run-example.ts",
+    "example:list": "tsx scripts/adorn-example.ts --list",
+    "example:blog-platform": "npm run example -- blog-platform",
+    "example:task-manager": "npm run example -- task-manager",
+    "example:basic": "npm run example -- basic",
+    "examples:install": "cd examples/basic && npm install"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "metal-orm": "^1.0.71",
+    "swagger-ui-express": "^5.0.0",
+    "typescript": "^5.9.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^6.0.0",
+    "@types/swagger-ui-express": "^4.1.6",
+    "eslint": "^9.39.2",
+    "express": "^5.2.1",
+    "rimraf": "^6.0.0",
+    "supertest": "^7.1.4",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "vitest": "^2.0.0"
+  }
+}

package/dist/adapters/express/createApp.d.ts

@@ -1,158 +0,0 @@
-import { type Express, type Router } from 'express';
-import type { ControllerCtor, Registry } from '../../core/registry/types.js';
-import type { Validator } from '../../contracts/validator.js';
-import { type ApplyRoutesOptions } from './router.js';
-import { type AdornErrorHandlerOptions } from './middleware/errorHandler.js';
-import type { OpenApiBuildOptions } from '../../core/openapi/buildOpenApi.js';
-/**
- * Options for OpenAPI documentation generation and serving.
- * Extends OpenApiBuildOptions with serving configuration.
- */
-export type AdornOpenApiOptions = OpenApiBuildOptions & {
-    /** Whether to enable OpenAPI documentation (default: true) */
-    enabled?: boolean;
-    /** Path to serve the OpenAPI JSON specification (default: '/openapi.json') */
-    jsonPath?: string;
-    /** Path to serve the OpenAPI documentation UI (default: '/docs') */
-    docsPath?: string;
-    /** Whether to serve Swagger UI (default: true) */
-    swaggerUi?: boolean;
-    /** Configuration options for Swagger UI */
-    swaggerUiConfig?: Record<string, unknown>;
-};
-/**
- * Options for creating an Adorn Express router with controllers.
- *
- * @see ApplyRoutesOptions for additional routing options
- */
-export type CreateAdornExpressRouterOptions = ApplyRoutesOptions & {
-    /** Array of controller constructors to register */
-    controllers: ControllerCtor[];
-    /** Whether to automatically add JSON body parser middleware (default: true) */
-    jsonBodyParser?: boolean;
-    /** Validator instance for request validation */
-    validator?: Validator;
-    /** Error handler configuration or false to disable (default: built-in handler) */
-    errorHandler?: AdornErrorHandlerOptions | false;
-    /** OpenAPI documentation configuration */
-    openapi?: AdornOpenApiOptions;
-};
-/**
- * Result of creating an Adorn Express router.
- */
-export type CreateAdornExpressRouterResult = {
-    /** Configured Express router with all routes */
-    router: Router;
-    /** Route registry containing metadata about all registered routes */
-    registry: Registry;
-};
-/**
- * Options for creating an Adorn Express application.
- * Extends router options with mount path configuration.
- *
- * @see CreateAdornExpressRouterOptions for base options
- */
-export type CreateAdornExpressAppOptions = CreateAdornExpressRouterOptions & {
-    /** Path to mount the router (default: '/') */
-    mountPath?: string;
-};
-/**
- * Creates a complete Express application with Adorn API functionality.
- *
- * This function sets up an Express app with all Adorn features including:
- * - Controller-based routing
- * - Automatic OpenAPI documentation
- * - Built-in error handling
- * - Request validation
- *
- * @param options - Configuration options for the application
- * @returns Configured Express application instance
- *
- * @example
- * ```typescript
- * import { createAdornExpressApp } from '@adorn/api';
- * import { UserController } from './controllers/user.controller';
- *
- * const app = createAdornExpressApp({
- *   controllers: [UserController],
- *   openapi: {
- *     title: 'My API',
- *     version: '1.0.0'
- *   }
- * });
- *
- * app.listen(3000, () => {
- *   console.log('Server running on port 3000');
- * });
- * ```
- *
- * @example
- * ```typescript
- * // With custom mount path
- * const app = createAdornExpressApp({
- *   controllers: [UserController, ProductController],
- *   mountPath: '/api/v1',
- *   jsonBodyParser: true,
- *   errorHandler: {
- *     logErrors: true,
- *     exposeStack: process.env.NODE_ENV === 'development'
- *   }
- * });
- * ```
- *
- * @see createAdornExpressRouter for router-specific functionality
- * @see AdornOpenApiOptions for OpenAPI configuration
- */
-export declare function createAdornExpressApp(options: CreateAdornExpressAppOptions): Express;
-/**
- * Creates an Express router with Adorn API functionality.
- *
- * This function sets up an Express router with all Adorn features including:
- * - Controller-based routing
- * - Automatic OpenAPI documentation
- * - Built-in error handling
- * - Request validation
- *
- * @param options - Configuration options for the router
- * @returns Object containing the configured router and route registry
- *
- * @example
- * ```typescript
- * import { createAdornExpressRouter } from '@adorn/api';
- * import { UserController } from './controllers/user.controller';
- * import express from 'express';
- *
- * const app = express();
- * const { router, registry } = createAdornExpressRouter({
- *   controllers: [UserController],
- *   openapi: {
- *     title: 'My API',
- *     version: '1.0.0',
- *     docsPath: '/api-docs'
- *   }
- * });
- *
- * app.use('/api', router);
- *
- * // Access the registry for runtime inspection
- * console.log('Registered routes:', registry.routes.length);
- * ```
- *
- * @example
- * ```typescript
- * // With custom validator and error handling
- * const { router } = createAdornExpressRouter({
- *   controllers: [UserController],
- *   validator: new CustomValidator(),
- *   errorHandler: {
- *     logErrors: true,
- *     customErrorFormatter: (err) => ({ ...err, timestamp: new Date() })
- *   }
- * });
- * ```
- *
- * @see createAdornExpressApp for full application setup
- * @see AdornOpenApiOptions for OpenAPI configuration
- */
-export declare function createAdornExpressRouter(options: CreateAdornExpressRouterOptions): CreateAdornExpressRouterResult;
-//# sourceMappingURL=createApp.d.ts.map

package/dist/adapters/express/createApp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/createApp.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAgC,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACtD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,GAAG;IACjE,mDAAmD;IACnD,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kFAAkF;IAClF,YAAY,CAAC,EAAE,wBAAwB,GAAG,KAAK,CAAC;IAChD,0CAA0C;IAC1C,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,+BAA+B,GAAG;IAC3E,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAKpF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAqChC"}

package/dist/adapters/express/createApp.js

@@ -1,141 +0,0 @@
-import express, {} from 'express';
-import { buildRegistry } from '../../core/registry/buildRegistry.js';
-import { applyRegistryToExpressRouter } from './router.js';
-import { adornErrorHandler, createAdornExpressErrorHandler, } from './middleware/errorHandler.js';
-import { serveOpenApi } from './swagger/serve.js';
-/**
- * Creates a complete Express application with Adorn API functionality.
- *
- * This function sets up an Express app with all Adorn features including:
- * - Controller-based routing
- * - Automatic OpenAPI documentation
- * - Built-in error handling
- * - Request validation
- *
- * @param options - Configuration options for the application
- * @returns Configured Express application instance
- *
- * @example
- * ```typescript
- * import { createAdornExpressApp } from '@adorn/api';
- * import { UserController } from './controllers/user.controller';
- *
- * const app = createAdornExpressApp({
- *   controllers: [UserController],
- *   openapi: {
- *     title: 'My API',
- *     version: '1.0.0'
- *   }
- * });
- *
- * app.listen(3000, () => {
- *   console.log('Server running on port 3000');
- * });
- * ```
- *
- * @example
- * ```typescript
- * // With custom mount path
- * const app = createAdornExpressApp({
- *   controllers: [UserController, ProductController],
- *   mountPath: '/api/v1',
- *   jsonBodyParser: true,
- *   errorHandler: {
- *     logErrors: true,
- *     exposeStack: process.env.NODE_ENV === 'development'
- *   }
- * });
- * ```
- *
- * @see createAdornExpressRouter for router-specific functionality
- * @see AdornOpenApiOptions for OpenAPI configuration
- */
-export function createAdornExpressApp(options) {
-    const app = express();
-    const { router } = createAdornExpressRouter(options);
-    app.use(options.mountPath ?? '/', router);
-    return app;
-}
-/**
- * Creates an Express router with Adorn API functionality.
- *
- * This function sets up an Express router with all Adorn features including:
- * - Controller-based routing
- * - Automatic OpenAPI documentation
- * - Built-in error handling
- * - Request validation
- *
- * @param options - Configuration options for the router
- * @returns Object containing the configured router and route registry
- *
- * @example
- * ```typescript
- * import { createAdornExpressRouter } from '@adorn/api';
- * import { UserController } from './controllers/user.controller';
- * import express from 'express';
- *
- * const app = express();
- * const { router, registry } = createAdornExpressRouter({
- *   controllers: [UserController],
- *   openapi: {
- *     title: 'My API',
- *     version: '1.0.0',
- *     docsPath: '/api-docs'
- *   }
- * });
- *
- * app.use('/api', router);
- *
- * // Access the registry for runtime inspection
- * console.log('Registered routes:', registry.routes.length);
- * ```
- *
- * @example
- * ```typescript
- * // With custom validator and error handling
- * const { router } = createAdornExpressRouter({
- *   controllers: [UserController],
- *   validator: new CustomValidator(),
- *   errorHandler: {
- *     logErrors: true,
- *     customErrorFormatter: (err) => ({ ...err, timestamp: new Date() })
- *   }
- * });
- * ```
- *
- * @see createAdornExpressApp for full application setup
- * @see AdornOpenApiOptions for OpenAPI configuration
- */
-export function createAdornExpressRouter(options) {
-    const router = express.Router();
-    if (options.jsonBodyParser ?? true) {
-        router.use(express.json());
-    }
-    const registry = buildRegistry(options.controllers);
-    applyRegistryToExpressRouter(router, registry, options);
-    const oa = options.openapi;
-    if (oa?.enabled ?? true) {
-        if (oa?.title && oa?.version) {
-            const openApiOptions = {
-                title: oa.title,
-                version: oa.version,
-                ...(oa.servers !== undefined ? { servers: oa.servers } : {}),
-            };
-            const serveOptions = {
-                ...(oa.jsonPath !== undefined ? { jsonPath: oa.jsonPath } : {}),
-                ...(oa.docsPath !== undefined ? { docsPath: oa.docsPath } : {}),
-                ...(oa.swaggerUi !== undefined ? { swaggerUi: oa.swaggerUi } : {}),
-                ...(oa.swaggerUiConfig !== undefined ? { swaggerUiConfig: oa.swaggerUiConfig } : {}),
-            };
-            router.use(serveOpenApi(registry, openApiOptions, serveOptions));
-        }
-    }
-    if (options.errorHandler !== false) {
-        const handler = options.errorHandler
-            ? createAdornExpressErrorHandler(options.errorHandler)
-            : adornErrorHandler;
-        router.use(handler);
-    }
-    return { router, registry };
-}
-//# sourceMappingURL=createApp.js.map

package/dist/adapters/express/createApp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createApp.js","sourceRoot":"","sources":["../../../src/adapters/express/createApp.ts"],"names":[],"mappings":"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"}

package/dist/adapters/express/index.d.ts

@@ -1,7 +0,0 @@
-export * from './createApp.js';
-export * from './router.js';
-export * from './transport/request.js';
-export * from './transport/response.js';
-export * from './middleware/errorHandler.js';
-export * from './swagger/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/adapters/express/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/adapters/express/index.js

@@ -1,7 +0,0 @@
-export * from './createApp.js';
-export * from './router.js';
-export * from './transport/request.js';
-export * from './transport/response.js';
-export * from './middleware/errorHandler.js';
-export * from './swagger/index.js';
-//# sourceMappingURL=index.js.map

package/dist/adapters/express/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}