newtUn framework de backend para Bun

Contextos, casos de uso, entidades y eventos de dominio con un outbox transaccional, en stores que puedes cambiar.

Reglas que comprueba la máquina

Un caso de uso escribe en su propio módulo, un módulo por transacción, un guardado que lee filas lleva su guard. newt rechaza lo demás al ejecutarse, y su lint antes de ejecutar.

La anatomía y el lint

Guardados de los que fiarte

Cada fila tiene una versión; dos personas que cambian lo mismo no pierden ningún cambio. Un conflicto vuelve a ejecutar el caso de uso solo, y una regla sobre varias filas se cumple en cualquier store.

Dos personas, una tarjeta

Eventos que nunca se pierden

Un evento se escribe en la misma transacción que el cambio que lo cuenta. Un worker ejecuta cada reacción hasta que sale bien, con reintentos, espera creciente y jobs muertos que puedes reintentar.

El outbox

Stores que puedes cambiar

SQLite, ficheros, Postgres y MySQL detrás de un mismo puerto. Los módulos no saben cuál es; una suite de contrato demuestra que un store tuyo cumple cada promesa.

De ficheros a SQLite

Un tiempo que puedes mover

Un reloj por contexto marca las fechas, los jobs y los crons. Un cron salta una sola vez aunque haya varios procesos, y un test mueve el reloj en vez de esperar.

Invitaciones y tiempo

HTTP cerrado por defecto

Toda ruta pide sesión salvo que diga lo contrario. CORS, POST idempotentes, errores con forma OAuth y un health que responde 503 mientras el servidor termina.

Preguntar dos veces

Listo para agentes de código

newt trae un AGENTS.md que se versiona con el código. newt init lleva a los agentes de una aplicación hasta él; newt add module escribe un módulo que el lint ya acepta.

La línea de comandos

Tu sistema, dibujado

newt-graph lee una aplicación y dibuja sus contextos, módulos, casos de uso y eventos. Elige un caso de uso y mira cómo viajan sus efectos, worker tras worker.

newt-graph

Apréndelo construyendo

Treinta capítulos construyen cooper, un Trello pequeño con un servidor OAuth, un servidor MCP y un backoffice. Cada capítulo acaba en una etiqueta de git que funciona y pasa sus tests.

Empezar