Damba

Um framework Express amigável à IA e orientado a esquemas. Você declara suas entidades TypeORM e um mapa de serviços; Damba conecta as rotas REST, a validação, a autenticação, a documentação, as filas BullMQ e o Socket.io ao redor delas. Suas convenções planas e greppáveis — sem magia de DSL — tornam cada serviço fácil de ler, gerar e revisar tanto para humanos quanto para agentes de código com IA.

Esquemas / Entidades  →  Serviços  →  Rotas  →  Docs

O que você ganha

• Amigável à IA — um formato previsível esquema → serviço → rota → docs e convenções planas e greppáveis (sem magia de DSL) que LLMs e agentes de código conseguem gerar e revisar de forma confiável.
• CRUD auto-gerado a partir de qualquer entidade TypeORM, com hooks before / after opcionais.
• Comportamentos tipados — funções factory com contexto de requisição de primeira classe.
• Políticas — passos de autorização compostos com erros JSON estáveis.
• Tempo real — Socket.io envolvido no mesmo contexto tenant + correlação das suas rotas HTTP.
• Filas — produtores + listeners BullMQ compartilhando o contexto ALS da requisição.
• Erros — hierarquia central DambaError produzindo respostas JSON padronizadas.
• Docs — páginas de API + Extras geradas automaticamente.

Início rápido

npm install damba-v2

Veja o início rápido (em inglês) para um exemplo completo, ou use o template starter.

Status da tradução em português

Esta seção está em tradução. Por enquanto, a documentação completa só está disponível em inglês.

• 📖 Documentação completa (inglês)
• 🚀 Início rápido (inglês)
• 💡 Serviços (inglês)

Quer contribuir uma tradução? Abra um PR no GitHub.

Links

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