Sobre o projeto
Feito para quem leva estrutura a sério.
O Spraxium começou como um projeto interno na Spacelaxy, criado para resolver os problemas que continuávamos enfrentando com o discord.js conforme nossos bots cresciam em escala e complexidade.
Ele rodou em produção por mais de um ano antes de decidirmos abrir. O que você vê aqui é essa mesma base - limpa, documentada e pronta para equipes além da nossa.
Origem
Tudo começou com frustração.
Na Spacelaxy, todo bot começava da mesma forma: um projeto discord.js organizado que virava um problema de manutenção com o tempo. Comandos cresciam, o arquivo de listeners ficava maior, a lógica de permissão acabava em três lugares diferentes. Ninguém queria mexer no onInteractionCreate.
O Spraxium foi nossa resposta interna para isso. Não um framework desde o início, só estrutura: módulos explícitos, um container de DI de verdade e guard pipelines que funcionavam igual em todos os tipos de interação.
Ele rodou todos os bots da Spacelaxy em produção por mais de um ano antes de qualquer pessoa fora da equipe ver. Em 2025 limpamos a API, documentamos a arquitetura direito e publicamos os pacotes do ecossistema que estávamos rodando em privado.
A maioria das decisões de design veio de problemas reais. Variáveis de ambiente faltando derrubando o bot silenciosamente no boot. Checagens de permissão duplicadas em handlers que ficavam fora de sincronia. Um listener global que todo novo recurso tinha que tocar. Cada um desses problemas tem uma contrapartida direta em como o Spraxium funciona hoje.
O @spraxium/env bloqueia o startup antes que o bot chegue a um estado indefinido. Guard pipelines centralizam as regras de acesso em um único lugar. O @spraxium/http roda no mesmo processo e grafo de DI dos handlers Discord. O @spraxium/signal conecta serviços externos sem estado compartilhado nem polling.
O projeto é mantido pelas mesmas pessoas que dependem dele em produção todo dia. Quando algo quebra no nosso ambiente, consertamos - e essa correção vai para o release público.
Começou como framework interno depois que nossos projetos discord.js ficaram cada vez mais difíceis de manter em escala.
Lançamento público com documentação, CLI funcionando e pacotes do ecossistema cobrindo as lacunas que sempre encontrávamos.
Melhorias de arquitetura da v3 testadas em produção em todos os bots da Spacelaxy antes de serem lançadas publicamente.
Missão
Tornar bots Discord construíveis como software de verdade.
Bots Discord são aplicações backend. Rodam 24/7, processam eventos concorrentes, aplicam regras de negócio e precisam continuar manuteníveis conforme os recursos crescem. O Spraxium leva isso a sério - com módulos, DI, guards e um ciclo de vida que se mantém do primeiro ao ducentésimo comando.
Estrutura por padrão
Módulos, providers e handlers sempre explícitos. Nada se registra silenciosamente. Você sempre sabe o que está no grafo de DI e de onde veio.
TypeScript nativo
Cada decorator, contrato de guard e token de injeção foi construído em torno do TypeScript. O framework nunca devolve um any para você lidar.
Core enxuto
O runtime principal é pequeno de propósito. Cada pacote do ecossistema é opt-in. Você adiciona apenas o que o projeto realmente precisa.
Aberto por design
O framework, a CLI, o tooling e a documentação são todos open source. Você tem visibilidade total sobre o que roda no seu bot e é dono do que constrói.
Futuro
Para onde estamos indo.
O framework é estável o suficiente para construir hoje. Os próximos ciclos são focados em preencher lacunas - melhor suporte a testes, scaffolding de CLI mais completo e melhor visibilidade sobre o que roda em produção.
Estabilização da superfície de API em todos os pacotes. Fechar as lacunas restantes de ergonomia da CLI e lançar scaffolding de módulos que valha realmente a pena usar.
Utilitários de testes pensados para os padrões do framework: isolamento de guards, fiação de DI e testes de handlers sem precisar de uma conexão real com o bot.
Pacotes de observabilidade e operação com visibilidade real do que o bot está fazendo, sem acoplar sua arquitetura a uma plataforma específica.
Manter o projeto honesto: decisões importantes em público, roadmap guiado por uso real e mantido pelas pessoas que dependem dele em produção.
Open source
Gratuito para usar. Feito para durar.
O Spraxium é licenciado sob Apache 2.0. Use como quiser - bots pessoais, ferramentas internas, plataformas comerciais. Sem pegadinhas. Se ele realmente economiza tempo do seu time, considere apoiar para continuarmos com manutenção, documentação e releases num ritmo razoável.
Doações financiam tempo de manutenção, trabalho na documentação e mantêm o ritmo de releases do ecossistema em todos os pacotes públicos.