veloce-ts 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.3] - 2026-03-27
+
+### Added
+- **RFC 9457 (Problem Details):** respuestas de error por defecto con `Content-Type: application/problem+json`, campos `type`, `title`, `status`, `detail`, `instance` y extensiones (`violations`/`details` en validación; `debug` en 500 solo en desarrollo).
+- **`VeloceTSConfig.errorResponseFormat`:** `'rfc9457'` (defecto) o `'legacy'` para el JSON `{ error, statusCode, details? }` anterior.
+- Helpers exportados: `problemTypeUri`, `resolveProblemType`, `resolveProblemTitle`, `buildProblemInstance`, `toLegacyErrorBody`, `sendErrorResponse`, constantes `PROBLEM_JSON_MEDIA_TYPE`, `DEFAULT_PROBLEM_TYPE_BASE`.
+- **`HTTPExceptionOptions`:** `problemType` y `title` opcionales en el constructor de `HTTPException`.
+
+### Changed
+- Excepciones de auth (`AuthenticationException`, `AuthorizationException`) dejan de definir `toJSON` propio; heredan el formato unificado con URIs `authentication-error` / `authorization-error`.
+
+### Documentation
+- Cabeceras `@module` en el núcleo (application, metadata, router-compiler, plugin, compiled-metadata), errores, validación, DI, respuestas, logging, middleware, adapters, testing, barrels y más.
+- **Benchmarks:** `benchmarks/run.ts` etiquetado como v0.4.3; `BENCHMARKS.md` y `benchmarks/results/latest.json` regenerados (6 000 req, 50 concurrentes, Bun 1.3.5, 2026-03-28).
+
+### Notes
+- El cuerpo JSON de error sigue incluyendo `error` y `statusCode` junto a los campos RFC 9457. Si tu cliente exige `Content-Type: application/json` en errores, usa `errorResponseFormat: 'legacy'` o acepta `application/problem+json`.
+
+## [0.4.2] - 2026-03-27
+
+### Fixed
+- **HealthCheckPlugin:** checker display names are set with `Object.defineProperty` (with a fallback) so runtimes such as Bun do not throw when assigning `.name` on async checker functions.
+- **Public API:** `@Req` is now exported from the main `veloce-ts` entry (it was implemented in `decorators/params` but missing from the package exports).
+
 ## [0.4.1] - 2026-03-27
 
 ### Fixed

package/dist/cjs/src/adapters/express.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["..\\..\\src\\adapters\\express.ts"],
   "sourcesContent": [
-    "/**\r\n * Express adapter for Veloce-TS\r\n *\r\n * Bridges Veloce-TS / Hono routes into an existing Express application.\r\n * The adapter works by forwarding every request received by Express to\r\n * Hono's `fetch()` handler and then writing the Web-standard `Response`\r\n * back through Express's `res` object.\r\n *\r\n * Express is a **peer dependency** — install it separately:\r\n *   npm install express\r\n *   npm install --save-dev @types/express\r\n *\r\n * @example\r\n * ```ts\r\n * import express from 'express';\r\n * import { VeloceTS } from 'veloce-ts';\r\n * import { ExpressAdapter } from 'veloce-ts/adapters/express';\r\n *\r\n * const veloce = new VeloceTS({ docs: true });\r\n * veloce.get('/hello', { handler: () => ({ message: 'Hello from Veloce!' }) });\r\n * await veloce.compile();\r\n *\r\n * const adapter = new ExpressAdapter(veloce);\r\n *\r\n * // Mount Veloce-TS under a sub-path (or mount at root with '/')\r\n * const expressApp = express();\r\n * expressApp.use('/api', adapter.getHandler());\r\n * expressApp.listen(3000);\r\n * ```\r\n */\r\nimport type { Adapter } from './base';\r\nimport type { VeloceTS } from '../core/application';\r\n\r\n/**\r\n * ExpressAdapter — bridges Veloce-TS to Express.js.\r\n *\r\n * The adapter is completely **standalone** (no `require` at module load time).\r\n * Express is loaded lazily the first time the adapter is constructed, so\r\n * apps that do not use it pay no startup cost.\r\n */\r\nexport class ExpressAdapter implements Adapter {\r\n  name = 'express';\r\n  private expressApp: any;\r\n\r\n  /**\r\n   * @param veloceApp - A compiled (or not-yet-compiled) VeloceTS instance.\r\n   * @param expressInstance - Optional pre-created Express application.\r\n   *   Pass your own `express()` if you need to add middleware before the\r\n   *   Veloce-TS bridge is attached.\r\n   */\r\n  constructor(private veloceApp: VeloceTS, expressInstance?: any) {\r\n    this.expressApp = expressInstance ?? ExpressAdapter.createExpressApp();\r\n    this.setupBridge();\r\n  }\r\n\r\n  // -------------------------------------------------------------------------\r\n  // Public API\r\n  // -------------------------------------------------------------------------\r\n\r\n  /**\r\n   * Start listening on `port`.\r\n   * @returns The underlying `http.Server` instance.\r\n   */\r\n  listen(port: number, callback?: () => void): any {\r\n    return this.expressApp.listen(port, callback);\r\n  }\r\n\r\n  /**\r\n   * Return the Express application so you can attach additional middleware\r\n   * or mount it with `app.use('/prefix', adapter.getHandler())`.\r\n   */\r\n  getHandler(): any {\r\n    return this.expressApp;\r\n  }\r\n\r\n  /** Alias for `getHandler()`. */\r\n  getExpressApp(): any {\r\n    return this.expressApp;\r\n  }\r\n\r\n  // -------------------------------------------------------------------------\r\n  // Internal helpers\r\n  // -------------------------------------------------------------------------\r\n\r\n  /**\r\n   * Lazily load Express (works in ESM and CJS, Bun and Node).\r\n   * Express is a peer dependency so we load it at runtime.\r\n   */\r\n  private static createExpressApp(): any {\r\n    // Use Function constructor to escape TypeScript's module-aware narrowing of\r\n    // `require`.  This also ensures the bundler does not try to inline express.\r\n    // eslint-disable-next-line no-new-func\r\n    const _require = (typeof require !== 'undefined'\r\n      ? require\r\n      : Function('return require')()) as (id: string) => any;\r\n\r\n    let expressFactory: (...args: any[]) => any;\r\n    try {\r\n      expressFactory = _require('express') as (...args: any[]) => any;\r\n    } catch {\r\n      throw new Error(\r\n        '[ExpressAdapter] Could not load the \"express\" package.\\n' +\r\n        'Install it as a peer dependency:  npm install express'\r\n      );\r\n    }\r\n\r\n    return expressFactory();\r\n  }\r\n\r\n  /**\r\n   * Register a catch-all Express middleware that forwards every request to\r\n   * Hono and writes the result back.\r\n   */\r\n  private setupBridge(): void {\r\n    const honoApp = this.veloceApp.getHono();\r\n\r\n    this.expressApp.use(async (req: any, res: any, next: any) => {\r\n      try {\r\n        const webRequest = this.toWebRequest(req);\r\n        const webResponse = await honoApp.fetch(webRequest);\r\n        await this.writeExpressResponse(res, webResponse);\r\n      } catch (err) {\r\n        // Let Express handle unexpected errors through its error middleware\r\n        next(err);\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Convert an Express `req` to a Web-standard `Request`.\r\n   *\r\n   * Body handling:\r\n   * - If Express's `body-parser` (or similar) already parsed the body, it is\r\n   *   re-serialised as JSON.\r\n   * - If the body was streamed directly (raw middleware), the raw buffer is\r\n   *   forwarded as-is.\r\n   */\r\n  private toWebRequest(req: any): Request {\r\n    const protocol = req.protocol ?? 'http';\r\n    const host     = req.get?.('host') ?? req.headers?.host ?? 'localhost';\r\n    const url      = `${protocol}://${host}${req.originalUrl ?? req.url}`;\r\n\r\n    const headers = new Headers();\r\n    for (const [key, value] of Object.entries<any>(req.headers ?? {})) {\r\n      if (typeof value === 'string') {\r\n        headers.set(key, value);\r\n      } else if (Array.isArray(value)) {\r\n        value.forEach((v: string) => headers.append(key, v));\r\n      }\r\n    }\r\n\r\n    const init: RequestInit = { method: req.method, headers };\r\n\r\n    if (req.method !== 'GET' && req.method !== 'HEAD') {\r\n      if (Buffer.isBuffer(req.body)) {\r\n        // Raw body from express.raw() or multer\r\n        init.body = req.body;\r\n      } else if (req.body !== undefined && req.body !== null) {\r\n        // Parsed body from express.json() / express.urlencoded()\r\n        init.body = JSON.stringify(req.body);\r\n        if (!headers.has('content-type')) {\r\n          headers.set('content-type', 'application/json');\r\n        }\r\n      }\r\n    }\r\n\r\n    return new Request(url, init);\r\n  }\r\n\r\n  /**\r\n   * Write a Web-standard `Response` back through Express `res`.\r\n   */\r\n  private async writeExpressResponse(res: any, response: Response): Promise<void> {\r\n    res.status(response.status);\r\n\r\n    // Forward all headers from Hono to Express\r\n    response.headers.forEach((value: string, key: string) => {\r\n      // Skip hop-by-hop headers that Express manages itself\r\n      if (key.toLowerCase() !== 'transfer-encoding') {\r\n        res.setHeader(key, value);\r\n      }\r\n    });\r\n\r\n    if (!response.body) {\r\n      res.end();\r\n      return;\r\n    }\r\n\r\n    const contentType = response.headers.get('content-type') ?? '';\r\n\r\n    if (contentType.includes('application/json')) {\r\n      const json = await response.json();\r\n      res.json(json);\r\n    } else if (contentType.startsWith('text/')) {\r\n      const text = await response.text();\r\n      res.send(text);\r\n    } else {\r\n      // Binary / streaming content — send as Buffer\r\n      const buffer = await response.arrayBuffer();\r\n      res.send(Buffer.from(buffer));\r\n    }\r\n  }\r\n}\r\n"
+    "/**\r\n * @module veloce-ts/adapters/express\r\n * @description {@link ExpressAdapter}: monta la app Hono interna detrás de Express reenviando cada request a `fetch` y copiando la `Response`.\r\n *\r\n * Express adapter for Veloce-TS\r\n *\r\n * Bridges Veloce-TS / Hono routes into an existing Express application.\r\n * The adapter works by forwarding every request received by Express to\r\n * Hono's `fetch()` handler and then writing the Web-standard `Response`\r\n * back through Express's `res` object.\r\n *\r\n * Express is a **peer dependency** — install it separately:\r\n *   npm install express\r\n *   npm install --save-dev @types/express\r\n *\r\n * @example\r\n * ```ts\r\n * import express from 'express';\r\n * import { VeloceTS } from 'veloce-ts';\r\n * import { ExpressAdapter } from 'veloce-ts/adapters/express';\r\n *\r\n * const veloce = new VeloceTS({ docs: true });\r\n * veloce.get('/hello', { handler: () => ({ message: 'Hello from Veloce!' }) });\r\n * await veloce.compile();\r\n *\r\n * const adapter = new ExpressAdapter(veloce);\r\n *\r\n * // Mount Veloce-TS under a sub-path (or mount at root with '/')\r\n * const expressApp = express();\r\n * expressApp.use('/api', adapter.getHandler());\r\n * expressApp.listen(3000);\r\n * ```\r\n */\r\nimport type { Adapter } from './base';\r\nimport type { VeloceTS } from '../core/application';\r\n\r\n/**\r\n * ExpressAdapter — bridges Veloce-TS to Express.js.\r\n *\r\n * The adapter is completely **standalone** (no `require` at module load time).\r\n * Express is loaded lazily the first time the adapter is constructed, so\r\n * apps that do not use it pay no startup cost.\r\n */\r\nexport class ExpressAdapter implements Adapter {\r\n  name = 'express';\r\n  private expressApp: any;\r\n\r\n  /**\r\n   * @param veloceApp - A compiled (or not-yet-compiled) VeloceTS instance.\r\n   * @param expressInstance - Optional pre-created Express application.\r\n   *   Pass your own `express()` if you need to add middleware before the\r\n   *   Veloce-TS bridge is attached.\r\n   */\r\n  constructor(private veloceApp: VeloceTS, expressInstance?: any) {\r\n    this.expressApp = expressInstance ?? ExpressAdapter.createExpressApp();\r\n    this.setupBridge();\r\n  }\r\n\r\n  // -------------------------------------------------------------------------\r\n  // Public API\r\n  // -------------------------------------------------------------------------\r\n\r\n  /**\r\n   * Start listening on `port`.\r\n   * @returns The underlying `http.Server` instance.\r\n   */\r\n  listen(port: number, callback?: () => void): any {\r\n    return this.expressApp.listen(port, callback);\r\n  }\r\n\r\n  /**\r\n   * Return the Express application so you can attach additional middleware\r\n   * or mount it with `app.use('/prefix', adapter.getHandler())`.\r\n   */\r\n  getHandler(): any {\r\n    return this.expressApp;\r\n  }\r\n\r\n  /** Alias for `getHandler()`. */\r\n  getExpressApp(): any {\r\n    return this.expressApp;\r\n  }\r\n\r\n  // -------------------------------------------------------------------------\r\n  // Internal helpers\r\n  // -------------------------------------------------------------------------\r\n\r\n  /**\r\n   * Lazily load Express (works in ESM and CJS, Bun and Node).\r\n   * Express is a peer dependency so we load it at runtime.\r\n   */\r\n  private static createExpressApp(): any {\r\n    // Use Function constructor to escape TypeScript's module-aware narrowing of\r\n    // `require`.  This also ensures the bundler does not try to inline express.\r\n    // eslint-disable-next-line no-new-func\r\n    const _require = (typeof require !== 'undefined'\r\n      ? require\r\n      : Function('return require')()) as (id: string) => any;\r\n\r\n    let expressFactory: (...args: any[]) => any;\r\n    try {\r\n      expressFactory = _require('express') as (...args: any[]) => any;\r\n    } catch {\r\n      throw new Error(\r\n        '[ExpressAdapter] Could not load the \"express\" package.\\n' +\r\n        'Install it as a peer dependency:  npm install express'\r\n      );\r\n    }\r\n\r\n    return expressFactory();\r\n  }\r\n\r\n  /**\r\n   * Register a catch-all Express middleware that forwards every request to\r\n   * Hono and writes the result back.\r\n   */\r\n  private setupBridge(): void {\r\n    const honoApp = this.veloceApp.getHono();\r\n\r\n    this.expressApp.use(async (req: any, res: any, next: any) => {\r\n      try {\r\n        const webRequest = this.toWebRequest(req);\r\n        const webResponse = await honoApp.fetch(webRequest);\r\n        await this.writeExpressResponse(res, webResponse);\r\n      } catch (err) {\r\n        // Let Express handle unexpected errors through its error middleware\r\n        next(err);\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Convert an Express `req` to a Web-standard `Request`.\r\n   *\r\n   * Body handling:\r\n   * - If Express's `body-parser` (or similar) already parsed the body, it is\r\n   *   re-serialised as JSON.\r\n   * - If the body was streamed directly (raw middleware), the raw buffer is\r\n   *   forwarded as-is.\r\n   */\r\n  private toWebRequest(req: any): Request {\r\n    const protocol = req.protocol ?? 'http';\r\n    const host     = req.get?.('host') ?? req.headers?.host ?? 'localhost';\r\n    const url      = `${protocol}://${host}${req.originalUrl ?? req.url}`;\r\n\r\n    const headers = new Headers();\r\n    for (const [key, value] of Object.entries<any>(req.headers ?? {})) {\r\n      if (typeof value === 'string') {\r\n        headers.set(key, value);\r\n      } else if (Array.isArray(value)) {\r\n        value.forEach((v: string) => headers.append(key, v));\r\n      }\r\n    }\r\n\r\n    const init: RequestInit = { method: req.method, headers };\r\n\r\n    if (req.method !== 'GET' && req.method !== 'HEAD') {\r\n      if (Buffer.isBuffer(req.body)) {\r\n        // Raw body from express.raw() or multer\r\n        init.body = req.body;\r\n      } else if (req.body !== undefined && req.body !== null) {\r\n        // Parsed body from express.json() / express.urlencoded()\r\n        init.body = JSON.stringify(req.body);\r\n        if (!headers.has('content-type')) {\r\n          headers.set('content-type', 'application/json');\r\n        }\r\n      }\r\n    }\r\n\r\n    return new Request(url, init);\r\n  }\r\n\r\n  /**\r\n   * Write a Web-standard `Response` back through Express `res`.\r\n   */\r\n  private async writeExpressResponse(res: any, response: Response): Promise<void> {\r\n    res.status(response.status);\r\n\r\n    // Forward all headers from Hono to Express\r\n    response.headers.forEach((value: string, key: string) => {\r\n      // Skip hop-by-hop headers that Express manages itself\r\n      if (key.toLowerCase() !== 'transfer-encoding') {\r\n        res.setHeader(key, value);\r\n      }\r\n    });\r\n\r\n    if (!response.body) {\r\n      res.end();\r\n      return;\r\n    }\r\n\r\n    const contentType = response.headers.get('content-type') ?? '';\r\n\r\n    if (contentType.includes('application/json')) {\r\n      const json = await response.json();\r\n      res.json(json);\r\n    } else if (contentType.startsWith('text/')) {\r\n      const text = await response.text();\r\n      res.send(text);\r\n    } else {\r\n      // Binary / streaming content — send as Buffer\r\n      const buffer = await response.arrayBuffer();\r\n      res.send(Buffer.from(buffer));\r\n    }\r\n  }\r\n}\r\n"
   ],
-  "mappings": "yzBAwCO,MAAM,CAAkC,CAUzB,UATpB,KAAO,UACC,WAQR,WAAW,CAAS,EAAqB,EAAuB,CAA5C,iBAClB,KAAK,WAAa,GAAmB,EAAe,iBAAiB,EACrE,KAAK,YAAY,EAWnB,MAAM,CAAC,EAAc,EAA4B,CAC/C,OAAO,KAAK,WAAW,OAAO,EAAM,CAAQ,EAO9C,UAAU,EAAQ,CAChB,OAAO,KAAK,WAId,aAAa,EAAQ,CACnB,OAAO,KAAK,iBAWC,iBAAgB,EAAQ,CAIrC,IAAM,EACF,QAGA,EACJ,GAAI,CACF,EAAiB,EAAS,SAAS,EACnC,KAAM,CACN,MAAU,MACR;AAAA,sDAEF,EAGF,OAAO,EAAe,EAOhB,WAAW,EAAS,CAC1B,IAAM,EAAU,KAAK,UAAU,QAAQ,EAEvC,KAAK,WAAW,IAAI,MAAO,EAAU,EAAU,IAAc,CAC3D,GAAI,CACF,IAAM,EAAa,KAAK,aAAa,CAAG,EAClC,EAAc,MAAM,EAAQ,MAAM,CAAU,EAClD,MAAM,KAAK,qBAAqB,EAAK,CAAW,EAChD,MAAO,EAAK,CAEZ,EAAK,CAAG,GAEX,EAYK,YAAY,CAAC,EAAmB,CACtC,IAAM,EAAW,EAAI,UAAY,OAC3B,EAAW,EAAI,MAAM,MAAM,GAAK,EAAI,SAAS,MAAQ,YACrD,EAAW,GAAG,OAAc,IAAO,EAAI,aAAe,EAAI,MAE1D,EAAU,IAAI,QACpB,QAAY,EAAK,KAAU,OAAO,QAAa,EAAI,SAAW,CAAC,CAAC,EAC9D,GAAI,OAAO,IAAU,SACnB,EAAQ,IAAI,EAAK,CAAK,EACjB,QAAI,MAAM,QAAQ,CAAK,EAC5B,EAAM,QAAQ,CAAC,IAAc,EAAQ,OAAO,EAAK,CAAC,CAAC,EAIvD,IAAM,EAAoB,CAAE,OAAQ,EAAI,OAAQ,SAAQ,EAExD,GAAI,EAAI,SAAW,OAAS,EAAI,SAAW,QACzC,GAAI,OAAO,SAAS,EAAI,IAAI,EAE1B,EAAK,KAAO,EAAI,KACX,QAAI,EAAI,OAAS,QAAa,EAAI,OAAS,MAGhD,GADA,EAAK,KAAO,KAAK,UAAU,EAAI,IAAI,EAC/B,CAAC,EAAQ,IAAI,cAAc,EAC7B,EAAQ,IAAI,eAAgB,kBAAkB,GAKpD,OAAO,IAAI,QAAQ,EAAK,CAAI,OAMhB,qBAAoB,CAAC,EAAU,EAAmC,CAW9E,GAVA,EAAI,OAAO,EAAS,MAAM,EAG1B,EAAS,QAAQ,QAAQ,CAAC,EAAe,IAAgB,CAEvD,GAAI,EAAI,YAAY,IAAM,oBACxB,EAAI,UAAU,EAAK,CAAK,EAE3B,EAEG,CAAC,EAAS,KAAM,CAClB,EAAI,IAAI,EACR,OAGF,IAAM,EAAc,EAAS,QAAQ,IAAI,cAAc,GAAK,GAE5D,GAAI,EAAY,SAAS,kBAAkB,EAAG,CAC5C,IAAM,EAAO,MAAM,EAAS,KAAK,EACjC,EAAI,KAAK,CAAI,EACR,QAAI,EAAY,WAAW,OAAO,EAAG,CAC1C,IAAM,EAAO,MAAM,EAAS,KAAK,EACjC,EAAI,KAAK,CAAI,EACR,KAEL,IAAM,EAAS,MAAM,EAAS,YAAY,EAC1C,EAAI,KAAK,OAAO,KAAK,CAAM,CAAC,GAGlC",
+  "mappings": "yzBA2CO,MAAM,CAAkC,CAUzB,UATpB,KAAO,UACC,WAQR,WAAW,CAAS,EAAqB,EAAuB,CAA5C,iBAClB,KAAK,WAAa,GAAmB,EAAe,iBAAiB,EACrE,KAAK,YAAY,EAWnB,MAAM,CAAC,EAAc,EAA4B,CAC/C,OAAO,KAAK,WAAW,OAAO,EAAM,CAAQ,EAO9C,UAAU,EAAQ,CAChB,OAAO,KAAK,WAId,aAAa,EAAQ,CACnB,OAAO,KAAK,iBAWC,iBAAgB,EAAQ,CAIrC,IAAM,EACF,QAGA,EACJ,GAAI,CACF,EAAiB,EAAS,SAAS,EACnC,KAAM,CACN,MAAU,MACR;AAAA,sDAEF,EAGF,OAAO,EAAe,EAOhB,WAAW,EAAS,CAC1B,IAAM,EAAU,KAAK,UAAU,QAAQ,EAEvC,KAAK,WAAW,IAAI,MAAO,EAAU,EAAU,IAAc,CAC3D,GAAI,CACF,IAAM,EAAa,KAAK,aAAa,CAAG,EAClC,EAAc,MAAM,EAAQ,MAAM,CAAU,EAClD,MAAM,KAAK,qBAAqB,EAAK,CAAW,EAChD,MAAO,EAAK,CAEZ,EAAK,CAAG,GAEX,EAYK,YAAY,CAAC,EAAmB,CACtC,IAAM,EAAW,EAAI,UAAY,OAC3B,EAAW,EAAI,MAAM,MAAM,GAAK,EAAI,SAAS,MAAQ,YACrD,EAAW,GAAG,OAAc,IAAO,EAAI,aAAe,EAAI,MAE1D,EAAU,IAAI,QACpB,QAAY,EAAK,KAAU,OAAO,QAAa,EAAI,SAAW,CAAC,CAAC,EAC9D,GAAI,OAAO,IAAU,SACnB,EAAQ,IAAI,EAAK,CAAK,EACjB,QAAI,MAAM,QAAQ,CAAK,EAC5B,EAAM,QAAQ,CAAC,IAAc,EAAQ,OAAO,EAAK,CAAC,CAAC,EAIvD,IAAM,EAAoB,CAAE,OAAQ,EAAI,OAAQ,SAAQ,EAExD,GAAI,EAAI,SAAW,OAAS,EAAI,SAAW,QACzC,GAAI,OAAO,SAAS,EAAI,IAAI,EAE1B,EAAK,KAAO,EAAI,KACX,QAAI,EAAI,OAAS,QAAa,EAAI,OAAS,MAGhD,GADA,EAAK,KAAO,KAAK,UAAU,EAAI,IAAI,EAC/B,CAAC,EAAQ,IAAI,cAAc,EAC7B,EAAQ,IAAI,eAAgB,kBAAkB,GAKpD,OAAO,IAAI,QAAQ,EAAK,CAAI,OAMhB,qBAAoB,CAAC,EAAU,EAAmC,CAW9E,GAVA,EAAI,OAAO,EAAS,MAAM,EAG1B,EAAS,QAAQ,QAAQ,CAAC,EAAe,IAAgB,CAEvD,GAAI,EAAI,YAAY,IAAM,oBACxB,EAAI,UAAU,EAAK,CAAK,EAE3B,EAEG,CAAC,EAAS,KAAM,CAClB,EAAI,IAAI,EACR,OAGF,IAAM,EAAc,EAAS,QAAQ,IAAI,cAAc,GAAK,GAE5D,GAAI,EAAY,SAAS,kBAAkB,EAAG,CAC5C,IAAM,EAAO,MAAM,EAAS,KAAK,EACjC,EAAI,KAAK,CAAI,EACR,QAAI,EAAY,WAAW,OAAO,EAAG,CAC1C,IAAM,EAAO,MAAM,EAAS,KAAK,EACjC,EAAI,KAAK,CAAI,EACR,KAEL,IAAM,EAAS,MAAM,EAAS,YAAY,EAC1C,EAAI,KAAK,OAAO,KAAK,CAAM,CAAC,GAGlC",
   "debugId": "8B5C1D588B2B820364756E2164756E21",
   "names": []
 }

package/dist/cjs/src/adapters/hono.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["..\\..\\src\\adapters\\hono.ts"],
   "sourcesContent": [
-    "/**\r\n * Hono adapter for runtime-agnostic server deployment\r\n * Supports Bun, Node.js, Deno, and Cloudflare Workers\r\n */\r\nimport type { Hono } from 'hono';\r\nimport type { Adapter, ServerInstance } from './base';\r\n\r\n// Type declarations for runtime globals\r\ndeclare const Deno: any;\r\ndeclare const Bun: any;\r\n\r\n/**\r\n * Runtime detection utilities\r\n */\r\nconst detectRuntime = (): 'bun' | 'deno' | 'node' | 'workerd' | 'unknown' => {\r\n  // Check for Bun\r\n  if (typeof Bun !== 'undefined') {\r\n    return 'bun';\r\n  }\r\n\r\n  // Check for Deno\r\n  if (typeof Deno !== 'undefined') {\r\n    return 'deno';\r\n  }\r\n\r\n  // Check for Cloudflare Workers\r\n  if (typeof navigator !== 'undefined' && navigator.userAgent === 'Cloudflare-Workers') {\r\n    return 'workerd';\r\n  }\r\n\r\n  // Check for Node.js\r\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\r\n    return 'node';\r\n  }\r\n\r\n  return 'unknown';\r\n};\r\n\r\n/**\r\n * HonoAdapter - Adapts Hono.js to work across multiple runtimes\r\n * Automatically detects the runtime and uses the appropriate server implementation\r\n */\r\nexport class HonoAdapter implements Adapter {\r\n  name = 'hono';\r\n  private runtime: ReturnType<typeof detectRuntime>;\r\n\r\n  constructor(private hono: Hono) {\r\n    this.runtime = detectRuntime();\r\n  }\r\n\r\n  /**\r\n   * Start the server on the specified port\r\n   * Automatically uses the appropriate server for the detected runtime\r\n   */\r\n  listen(port: number, callback?: () => void): ServerInstance {\r\n    switch (this.runtime) {\r\n      case 'bun':\r\n        return this.listenBun(port, callback);\r\n      \r\n      case 'deno':\r\n        return this.listenDeno(port, callback);\r\n      \r\n      case 'node':\r\n        return this.listenNode(port, callback);\r\n      \r\n      case 'workerd':\r\n        throw new Error(\r\n          'Cloudflare Workers do not support listen(). Deploy using wrangler or export the handler with getHandler().'\r\n        );\r\n      \r\n      default:\r\n        throw new Error(\r\n          `Unsupported runtime: ${this.runtime}. FastAPI-TS supports Bun, Node.js, Deno, and Cloudflare Workers.`\r\n        );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the Hono fetch handler\r\n   * This can be used directly in serverless environments or for custom server setups\r\n   */\r\n  getHandler() {\r\n    return this.hono.fetch;\r\n  }\r\n\r\n  /**\r\n   * Get the detected runtime\r\n   */\r\n  getRuntime(): string {\r\n    return this.runtime;\r\n  }\r\n\r\n  /**\r\n   * Start server using Bun's native server\r\n   */\r\n  private listenBun(port: number, callback?: () => void): ServerInstance {\r\n    const server = Bun.serve({\r\n      port,\r\n      fetch: this.hono.fetch,\r\n    });\r\n\r\n    if (callback) {\r\n      callback();\r\n    }\r\n\r\n    return {\r\n      port,\r\n      close: async () => {\r\n        server.stop();\r\n      },\r\n      ...server\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Start server using Deno's native server\r\n   */\r\n  private listenDeno(port: number, callback?: () => void): ServerInstance {\r\n    // Deno.serve returns a promise, so we handle it appropriately\r\n    const ac = new AbortController();\r\n    \r\n    Deno.serve(\r\n      {\r\n        port,\r\n        signal: ac.signal,\r\n        onListen: callback\r\n      },\r\n      this.hono.fetch\r\n    );\r\n\r\n    // Return an object with a close method for consistency\r\n    return {\r\n      port,\r\n      close: async () => {\r\n        ac.abort();\r\n      },\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Start server using Node.js adapter\r\n   * Requires @hono/node-server package\r\n   */\r\n  private listenNode(port: number, callback?: () => void): ServerInstance {\r\n    try {\r\n      // Dynamically import @hono/node-server\r\n      // This is a peer dependency that users need to install for Node.js support\r\n      const { serve } = require('@hono/node-server');\r\n      \r\n      const server = serve(\r\n        {\r\n          fetch: this.hono.fetch,\r\n          port,\r\n        },\r\n        callback\r\n      );\r\n\r\n      return {\r\n        port,\r\n        close: async () => {\r\n          return new Promise<void>((resolve) => {\r\n            server.close(() => resolve());\r\n          });\r\n        },\r\n        ...server\r\n      };\r\n    } catch (error) {\r\n      throw new Error(\r\n        'Node.js adapter requires @hono/node-server package. Install it with: npm install @hono/node-server'\r\n      );\r\n    }\r\n  }\r\n}\r\n"
+    "/**\r\n * @module veloce-ts/adapters/hono\r\n * @description {@link HonoAdapter}: detecta runtime (Bun/Node/Deno/Workers) y expone `listen` sobre la instancia Hono.\r\n */\r\nimport type { Hono } from 'hono';\r\nimport type { Adapter, ServerInstance } from './base';\r\n\r\n// Type declarations for runtime globals\r\ndeclare const Deno: any;\r\ndeclare const Bun: any;\r\n\r\n/**\r\n * Runtime detection utilities\r\n */\r\nconst detectRuntime = (): 'bun' | 'deno' | 'node' | 'workerd' | 'unknown' => {\r\n  // Check for Bun\r\n  if (typeof Bun !== 'undefined') {\r\n    return 'bun';\r\n  }\r\n\r\n  // Check for Deno\r\n  if (typeof Deno !== 'undefined') {\r\n    return 'deno';\r\n  }\r\n\r\n  // Check for Cloudflare Workers\r\n  if (typeof navigator !== 'undefined' && navigator.userAgent === 'Cloudflare-Workers') {\r\n    return 'workerd';\r\n  }\r\n\r\n  // Check for Node.js\r\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\r\n    return 'node';\r\n  }\r\n\r\n  return 'unknown';\r\n};\r\n\r\n/**\r\n * HonoAdapter - Adapts Hono.js to work across multiple runtimes\r\n * Automatically detects the runtime and uses the appropriate server implementation\r\n */\r\nexport class HonoAdapter implements Adapter {\r\n  name = 'hono';\r\n  private runtime: ReturnType<typeof detectRuntime>;\r\n\r\n  constructor(private hono: Hono) {\r\n    this.runtime = detectRuntime();\r\n  }\r\n\r\n  /**\r\n   * Start the server on the specified port\r\n   * Automatically uses the appropriate server for the detected runtime\r\n   */\r\n  listen(port: number, callback?: () => void): ServerInstance {\r\n    switch (this.runtime) {\r\n      case 'bun':\r\n        return this.listenBun(port, callback);\r\n      \r\n      case 'deno':\r\n        return this.listenDeno(port, callback);\r\n      \r\n      case 'node':\r\n        return this.listenNode(port, callback);\r\n      \r\n      case 'workerd':\r\n        throw new Error(\r\n          'Cloudflare Workers do not support listen(). Deploy using wrangler or export the handler with getHandler().'\r\n        );\r\n      \r\n      default:\r\n        throw new Error(\r\n          `Unsupported runtime: ${this.runtime}. FastAPI-TS supports Bun, Node.js, Deno, and Cloudflare Workers.`\r\n        );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the Hono fetch handler\r\n   * This can be used directly in serverless environments or for custom server setups\r\n   */\r\n  getHandler() {\r\n    return this.hono.fetch;\r\n  }\r\n\r\n  /**\r\n   * Get the detected runtime\r\n   */\r\n  getRuntime(): string {\r\n    return this.runtime;\r\n  }\r\n\r\n  /**\r\n   * Start server using Bun's native server\r\n   */\r\n  private listenBun(port: number, callback?: () => void): ServerInstance {\r\n    const server = Bun.serve({\r\n      port,\r\n      fetch: this.hono.fetch,\r\n    });\r\n\r\n    if (callback) {\r\n      callback();\r\n    }\r\n\r\n    return {\r\n      port,\r\n      close: async () => {\r\n        server.stop();\r\n      },\r\n      ...server\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Start server using Deno's native server\r\n   */\r\n  private listenDeno(port: number, callback?: () => void): ServerInstance {\r\n    // Deno.serve returns a promise, so we handle it appropriately\r\n    const ac = new AbortController();\r\n    \r\n    Deno.serve(\r\n      {\r\n        port,\r\n        signal: ac.signal,\r\n        onListen: callback\r\n      },\r\n      this.hono.fetch\r\n    );\r\n\r\n    // Return an object with a close method for consistency\r\n    return {\r\n      port,\r\n      close: async () => {\r\n        ac.abort();\r\n      },\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Start server using Node.js adapter\r\n   * Requires @hono/node-server package\r\n   */\r\n  private listenNode(port: number, callback?: () => void): ServerInstance {\r\n    try {\r\n      // Dynamically import @hono/node-server\r\n      // This is a peer dependency that users need to install for Node.js support\r\n      const { serve } = require('@hono/node-server');\r\n      \r\n      const server = serve(\r\n        {\r\n          fetch: this.hono.fetch,\r\n          port,\r\n        },\r\n        callback\r\n      );\r\n\r\n      return {\r\n        port,\r\n        close: async () => {\r\n          return new Promise<void>((resolve) => {\r\n            server.close(() => resolve());\r\n          });\r\n        },\r\n        ...server\r\n      };\r\n    } catch (error) {\r\n      throw new Error(\r\n        'Node.js adapter requires @hono/node-server package. Install it with: npm install @hono/node-server'\r\n      );\r\n    }\r\n  }\r\n}\r\n"
   ],
   "mappings": "szBA0CO,MAAM,CAA+B,CAItB,KAHpB,KAAO,OACC,QAER,WAAW,CAAS,EAAY,CAAZ,YAClB,KAAK,QAAU,EAAc,EAO/B,MAAM,CAAC,EAAc,EAAuC,CAC1D,OAAQ,KAAK,aACN,MACH,OAAO,KAAK,UAAU,EAAM,CAAQ,MAEjC,OACH,OAAO,KAAK,WAAW,EAAM,CAAQ,MAElC,OACH,OAAO,KAAK,WAAW,EAAM,CAAQ,MAElC,UACH,MAAU,MACR,4GACF,UAGA,MAAU,MACR,wBAAwB,KAAK,0EAC/B,GAQN,UAAU,EAAG,CACX,OAAO,KAAK,KAAK,MAMnB,UAAU,EAAW,CACnB,OAAO,KAAK,QAMN,SAAS,CAAC,EAAc,EAAuC,CACrE,IAAM,EAAS,IAAI,MAAM,CACvB,OACA,MAAO,KAAK,KAAK,KACnB,CAAC,EAED,GAAI,EACF,EAAS,EAGX,MAAO,CACL,OACA,MAAO,SAAY,CACjB,EAAO,KAAK,MAEX,CACL,EAMM,UAAU,CAAC,EAAc,EAAuC,CAEtE,IAAM,EAAK,IAAI,gBAYf,OAVA,KAAK,MACH,CACE,OACA,OAAQ,EAAG,OACX,SAAU,CACZ,EACA,KAAK,KAAK,KACZ,EAGO,CACL,OACA,MAAO,SAAY,CACjB,EAAG,MAAM,EAEb,EAOM,UAAU,CAAC,EAAc,EAAuC,CACtE,GAAI,CAGF,IAAQ,kFAEF,EAAS,EACb,CACE,MAAO,KAAK,KAAK,MACjB,MACF,EACA,CACF,EAEA,MAAO,CACL,OACA,MAAO,SAAY,CACjB,OAAO,IAAI,QAAc,CAAC,IAAY,CACpC,EAAO,MAAM,IAAM,EAAQ,CAAC,EAC7B,MAEA,CACL,EACA,MAAO,EAAO,CACd,MAAU,MACR,oGACF,GAGN,KA9JM,EAAgB,IAAuD,CAE3E,GAAI,OAAO,IAAQ,IACjB,MAAO,MAIT,GAAI,OAAO,KAAS,IAClB,MAAO,OAIT,GAAI,OAAO,UAAc,KAAe,UAAU,YAAc,qBAC9D,MAAO,UAIT,GAAI,OAAO,QAAY,KAAe,QAAQ,UAAY,QAAQ,SAAS,KACzE,MAAO,OAGT,MAAO",
   "debugId": "23E2A2213E257E3964756E2164756E21",