Runtime Support
Correr la misma aplicación de Arcton en Bun o en Node.js, y las diferencias entre los dos adapters.
La misma aplicación corre en Bun y en Node.js. Qué runtime la sirve lo
decide el adapter que le pasas a listen().
Bun
Bun es el default. No pasar ningún adapter usa bunAdapter:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => ({ runtime: 'bun' }))
app.listen({ port: 3000 })Córrelo con bun src/index.ts. Para ser explícito, importa el adapter tú
mismo:
import { bunAdapter } from '@arcton/adapter-bun'
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => ({ runtime: 'bun' }))
app.listen({ adapter: bunAdapter })Node.js
Instala @arcton/adapter-node:
bun add @arcton/adapter-nodeLuego pásaselo a listen():
import { nodeAdapter } from '@arcton/adapter-node'
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => ({ runtime: 'node' }))
app.listen({ adapter: nodeAdapter })Todo lo demás — rutas, middleware, providers, validation, mapeo de respuestas — se comporta idéntico. Solo cambia el adapter.
Qué hacen ambos adapters
- Sirven la aplicación sobre HTTP y exponen el
porty laurlreales. - Convierten el request nativo del runtime en un
Requestestándar, y escriben de vuelta unResponseestándar. - Hacen el upgrade de las rutas WebSocket
registradas con
app.ws(). - Loguean con
console.errorun error tirado fuera del handler del request y responden500.
Diferencias que vale la pena conocer
| Bun | Node.js | |
|---|---|---|
| Paquete | @arcton/adapter-bun | @arcton/adapter-node |
adapter.version | Bun.version | la versión de Node.js sin la v inicial |
server.stop() | retorna de inmediato | retorna una promesa para awaitear |
stop() es el que aparece en el código. En Node.js, úsalo con await:
import { nodeAdapter } from '@arcton/adapter-node'
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => 'ok')
const server = app.listen({ adapter: nodeAdapter })
process.on('SIGTERM', async () => {
await server.stop()
})Eligiendo un puerto
port por default es 3000. Pasar 0 hace bind a un puerto libre, que es
como los tests evitan colisiones — lee el valor real de vuelta desde el
server:
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/', () => 'ok')
const server = app.listen({ port: 0 })
console.log(`listening on ${server.url}`)Ver Testing para el patrón completo.
Otros runtimes
RuntimeAdapter es una interfaz pública en @arcton/contracts: un
name, una version, un objeto capabilities y una función serve().
Cualquier runtime que pueda aceptar un Request y retornar un Response
puede respaldar uno. Ver Runtime types y
Adapters.