Damba

Un framework Express orientado a la IA y dirigido por esquemas. Declaras tus entidades de TypeORM y un mapa de servicios; Damba conecta las rutas REST, la validación, la autenticación, la documentación, las colas BullMQ y Socket.io a su alrededor. Sus convenciones planas y greppables — sin magia DSL — hacen que cada servicio sea fácil de leer, generar y revisar tanto para humanos como para agentes de código con IA.

Esquemas / Entidades  →  Servicios  →  Rutas  →  Docs

Lo que obtienes

• Orientado a la IA — una forma predecible esquema → servicio → ruta → docs y convenciones planas y greppables (sin magia DSL) que los LLM y agentes de código pueden generar y revisar de forma fiable.
• CRUD auto-generado desde cualquier entidad de TypeORM, con hooks opcionales before / after.
• Comportamientos tipados — funciones factory con contexto de petición de primera clase.
• Políticas — pasos de autorización componibles con errores JSON estables.
• Tiempo real — Socket.io envuelto en el mismo contexto tenant + correlación que tus rutas HTTP.
• Colas — productores + listeners BullMQ que comparten el contexto ALS de la petición.
• Errores — jerarquía central DambaError produciendo respuestas JSON estandarizadas.
• Documentación — páginas de API + Extras generadas automáticamente.

Inicio rápido

npm install damba-v2

Consulta el inicio rápido (en inglés) para un ejemplo completo, o usa la plantilla starter.

Estado de la traducción al español

Esta sección está en proceso de traducción. Por ahora, la documentación completa solo está disponible en inglés.

• 📖 Documentación completa (inglés)
• 🚀 Inicio rápido (inglés)
• 💡 Servicios (inglés)

¿Quieres contribuir una traducción? Abre un PR en GitHub.

Enlaces

• npm: damba-v2
• Fuente: github.com/bmarcella/Damba
• Starter: github.com/bmarcella/damba-starter