Sobre el proyecto
Hecho para quienes se toman la arquitectura en serio.
Spraxium empezó como un proyecto interno en Spacelaxy, creado para resolver los problemas que seguíamos encontrando con discord.js conforme nuestros bots crecían en escala y complejidad.
Funcionó en producción durante más de un año antes de que lo abriéramos. Lo que ves aquí es esa misma base: limpia, documentada y lista para equipos fuera del nuestro.
Origen
Todo empezó con frustración.
En Spacelaxy, cada bot empezaba igual: un proyecto discord.js ordenado que con el tiempo se convertía en un problema de mantenimiento. Los comandos crecían, el archivo de listeners se alargaba, la lógica de permisos terminaba en tres sitios distintos. Nadie quería tocar el onInteractionCreate.
Spraxium fue nuestra respuesta interna a eso. No un framework desde el principio, solo estructura: módulos explícitos, un contenedor DI real y pipelines de guards que funcionaban igual en todos los tipos de interacción.
Funcionó en producción en todos los bots de Spacelaxy durante más de un año antes de que nadie fuera del equipo lo viera. En 2025 limpiamos la API, documentamos la arquitectura como correspondía y publicamos los paquetes del ecosistema que llevábamos tiempo usando de forma privada.
La mayoría de las decisiones de diseño vinieron de chocar con problemas reales. Variables de entorno faltantes que tumbaban el bot silenciosamente al arrancar. Checks de permisos duplicados en distintos handlers que acababan desfasados. Un listener global que toda nueva funcionalidad tenía que tocar. Cada uno de esos problemas tiene su contrapartida directa en cómo funciona Spraxium hoy.
@spraxium/env bloquea el arranque antes de que el bot llegue a un estado indefinido. Los guard pipelines centralizan las reglas de acceso en un solo sitio. @spraxium/http corre en el mismo proceso y grafo DI que los handlers de Discord. @spraxium/signal conecta servicios externos sin estado compartido ni polling.
El proyecto lo mantiene el mismo equipo que depende de él en producción cada día. Cuando algo se rompe en nuestro entorno, lo arreglamos, y ese arreglo acaba en la release pública.
Empezó como framework interno después de que nuestros proyectos discord.js se fueran haciendo cada vez más difíciles de mantener a escala.
Lanzamiento público con documentación completa, CLI en funcionamiento y paquetes del ecosistema que cubrían los huecos que siempre encontrábamos.
Mejoras de arquitectura de la v3 probadas primero en producción en todos los bots de Spacelaxy y luego publicadas.
Misión
Hacer que los bots de Discord se construyan como software real.
Los bots de Discord son aplicaciones backend. Funcionan las 24 horas, procesan eventos concurrentes, aplican reglas de negocio y necesitan seguir siendo mantenibles conforme crecen las funcionalidades. Spraxium lo toma en serio: módulos, DI, guards y un ciclo de vida que aguanta desde el primer comando hasta el doscientos.
Estructura por defecto
Módulos, providers y handlers siempre explícitos. Nada se registra en silencio. Siempre sabes qué hay en el grafo DI y de dónde viene.
TypeScript nativo
Cada decorator, contrato de guard y token de inyección está construido alrededor de TypeScript. El framework nunca te devuelve un any con el que lidiar.
Core ligero
El runtime principal es pequeño a propósito. Cada paquete del ecosistema es opt-in. Solo añades lo que tu proyecto realmente necesita.
Abierto por diseño
El framework, la CLI, el tooling y la documentación son todos open source. Tienes visibilidad total sobre lo que corre en tu bot y eres dueño de lo que construyes.
Futuro
Hacia dónde lo llevamos.
El framework es lo suficientemente estable para construir hoy. Los próximos ciclos están enfocados en rellenar huecos: mejor soporte para testing, scaffolding de CLI más completo y mejor visibilidad sobre lo que corre en producción.
Estabilización de la superficie de API en todos los paquetes. Cerrar las brechas pendientes de ergonomía de la CLI y publicar scaffolding de módulos que valga la pena usar de verdad.
Utilidades de testing diseñadas para los patrones del framework: aislamiento de guards, cableado DI y testing de handlers sin necesitar una conexión real con el bot.
Paquetes de observabilidad y operaciones con visibilidad real de lo que hace el bot, sin atar tu arquitectura a ninguna plataforma específica.
Mantener el proyecto honesto: las decisiones importantes en público, el roadmap guiado por uso real y mantenido por las personas que dependen de él en producción.
Open source
Gratis para usar. Hecho para durar.
Spraxium está licenciado bajo Apache 2.0. Úsalo como quieras: bots personales, herramientas internas, plataformas comerciales. Sin letra pequeña. Si le ahorra tiempo real a tu equipo, considera apoyar el proyecto para que podamos seguir con el mantenimiento, la documentación y las releases a un ritmo sólido.
Las donaciones financian tiempo de mantenimiento, trabajo en la documentación y mantienen el ritmo de releases del ecosistema en todos los paquetes públicos.