Limitaciones y hoja de ruta

Limitaciones y hoja de ruta

Esta página es deliberadamente clara: qué aún no está redondo y hacia dónde apuntamos. No es un plan con fechas: el orden y los tiempos pueden cambiar. Para lo ya publicado, revisa el Registro de cambios.

Limitaciones actuales

Área	Qué esperar
WebSockets en Node.js	El plugin WebSocket responde HTTP 501 en Node.js. El upgrade funciona en Bun y Deno. Si necesitas tiempo real en Node hoy, usa otro enfoque o expón WebSockets en Bun/Deno.
GraphQL	El pipeline completo de decoradores (@Resolver, @GQLQuery, @GQLMutation, @Arg) funciona desde v1.0.1. Instala la peer dep graphql (bun add graphql) y registra resolvers con resolvers: [...] en el plugin o app.include(). Suscripciones y schema stitching aún no están endurecidos para producción.
Integraciones ORM	Drizzle tiene ayudas de primer nivel en el DI (registerDrizzle, @InjectDB). Prisma y TypeORM aún no están al mismo nivel de integración documentada en el core; puedes usarlos directamente en tus servicios.
Listeners de eventos con decorador	El decorador @On('event') aún no está implementado. Usa en su lugar la API funcional globalEvents.on(...).

Qué se publicó en v1.2.0

Todos los elementos P0 y P1 de la hoja de ruta están ahora disponibles:

• ✅ CLI scaffolding — veloce generate module/controller/service/resolver/dto/middleware/plugin
• ✅ Apagado gradual — app.onShutdown(), SIGTERM/SIGINT, timeout configurable
• ✅ Filtros de excepción — @Catch(), app.useFilter(), FilterManager
• ✅ Interceptores — @UseInterceptor(), app.useInterceptor(), ExecutionContext
• ✅ Respuestas en streaming — @SSE(), @Stream(contentType) en handlers AsyncGenerator
• ✅ Bus de eventos — EventBus, singleton globalEvents
• ✅ Decoradores extra — @Throttle, @ApiVersion, @ResponseHeader, @Redirect, @Deprecated
• ✅ Aislamiento de tests — isolate(), compileTestApp()
• ✅ OpenAPI 3.1 — jsonSchemaDialect, normalización de nullable

Próximas actualizaciones (dirección)

Prioridades del equipo; no es promesa de orden ni de fecha.

1. Elegir ORM — Que Drizzle, Prisma y TypeORM sean opciones prácticas y documentadas para que cada proyecto elija su ORM sin fricción con el framework.
2. WebSockets en Node.js — Sustituir el 501 en Node por una integración real de upgrade (p. ej. ws o equivalente) y unificar la API basada en decoradores con Bun/Deno.
3. Decorador @On('event') — Listeners de eventos declarativos como alternativa a la API funcional globalEvents.on(...).
4. GraphQL — Endurecer suscripciones y schema stitching para producción.
5. Suite de benchmarks pública — Números publicados comparando Veloce-TS con Hono, Elysia, Fastify y NestJS.

Cómo aportar o debatir

• Cambios ya publicados: Registro de cambios y el repositorio en GitHub.
• Ideas y propuestas: GitHub Discussions.