ArctonArcton
Introducción

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-node

Luego 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 port y la url reales.
  • Convierten el request nativo del runtime en un Request estándar, y escriben de vuelta un Response estándar.
  • Hacen el upgrade de las rutas WebSocket registradas con app.ws().
  • Loguean con console.error un error tirado fuera del handler del request y responden 500.

Diferencias que vale la pena conocer

BunNode.js
Paquete@arcton/adapter-bun@arcton/adapter-node
adapter.versionBun.versionla versión de Node.js sin la v inicial
server.stop()retorna de inmediatoretorna 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.

En esta página