ArctonArcton
Fundamentos

Context

El objeto `ctx` que recibe todo middleware, provider y handler, y cómo crece su tipo según lo que registres.

Todo middleware, provider y handler recibe el mismo tipo de objeto, ctx. Su forma base siempre está:

import { Arcton } from '@arcton/core'

const app = Arcton()

app.get('/users/:id', ctx => {
  // ctx.request  → the raw Request
  // ctx.params   → { id: string }, inferred from the route literal
  // ctx.query    → Record<string, string>, built from the URL's search params
  // ctx.response → { status?: number; headers: Headers } until it materializes
  return { id: ctx.params.id, referer: ctx.request.headers.get('referer') }
})

app.listen()
  • request es el Request estándar — ver Request.
  • params se tipa a partir del literal de ruta que le pasaste a .get() (o de un esquema de params, si la ruta declaró uno) — ver Parámetros de ruta.
  • query es Record<string, string> por defecto (o el output de un esquema), construido de forma perezosa la primera vez que lo lees — ver Parámetros de query.
  • response empieza como { status?: number; headers: Headers } y es lo que usas para darle forma a una response antes de que se materialice — ver Response.

El context crece con lo que registras

ctx.body solo aparece en rutas que declaran un esquema de body, y cualquier valor que devuelva una llamada a provide() se mezcla plano sobre ctx — sin namespace — para todo lo que se registre después:

import { Arcton } from '@arcton/core'
import * as v from 'valibot'

const app = Arcton()

app
  .provide(() => ({ requestId: crypto.randomUUID() }))
  .post('/users', {
    body: v.object({ name: v.pipe(v.string(), v.minLength(1)) }),
    handler: ctx => ({
      requestId: ctx.requestId,
      body: ctx.body
    })
  })

app.listen()

ctx.requestId está disponible aquí porque la llamada a provide() de arriba corrió primero; ctx.body está disponible porque esta ruta declaró un esquema de body. Ninguno de los dos estaría en ctx — ni pasaría el type-check — sin eso. Ver Providers para cómo compone provide(), y Body para ctx.body.

En esta página