Context
El objeto que reciben todo handler, provider y función de middleware
import { Arcton } from '@arcton/core'
const app = Arcton()
app.get('/users/:id', ctx => {
return { id: ctx.params.id, page: ctx.query.page ?? '1' }
})
app.listen()Todo handler, provider y función de middleware recibe un Context como primer argumento (el middleware también recibe un next). Esta página es la referencia de tipos; ver Context para la guía orientada al concepto.
Context
Propósito: la forma completa de ctx en un punto dado del pipeline.
Firma
import type { BaseContext, QueryParams, RouteParams } from '@arcton/contracts'
type Context<P = RouteParams, Q = QueryParams, TBody = {}, TProvided = {}> =
BaseContext<P, Q> & TBody & TProvidedParámetros
Propiedad
Tipo
Comportamiento: los valores provistos quedan planos sobre ctx — no hay namespace. params se infiere del literal de ruta pasado a get/post/etc.: '/users/:id' da { id: string }, una ruta sin params da Record<string, never>, y un path pasado como variable string no literal da Record<string, string>. query es Record<string, string> por defecto, construido de forma perezosa en el primer acceso — las keys repetidas conservan el último valor, y una key sin valor se lee como ''.
BaseContext
Propósito: los campos presentes en todo Context, sin importar qué se haya provisto o validado.
Firma
import type { ResponseContext } from '@arcton/contracts'
interface BaseContext<P, Q> {
request: Request
params: P
query: Q
response: ResponseContext
}Comportamiento: request es el Request crudo, sin modificar. response se describe más abajo.
ResponseContext
Propósito: el estado mutable de la response disponible antes de que el body finalice.
Firma
interface ResponseContext {
status?: number
headers: Headers
}Comportamiento: ctx.response comienza como este objeto plano y se materializa en un Response real en el momento en que el body finaliza, en cualquier capa (el handler retorna, un step corta la cadena, o una capa reemplaza el body después de next()). Antes de la materialización, se puede asignar ctx.response.status directamente. Después de la materialización, mutar los headers sigue funcionando y llega al cliente, pero status ya no acepta asignación. Ver Response.
Configura ctx.response.status desde el handler, o desde middleware antes de llamar a await next(). Configurarlo después lanza una excepción, porque para ese momento el body ya se materializó en un Response real.
RouteParams
Propósito: la forma por defecto de ctx.params para una ruta sin schema de params.
Firma
type RouteParams = Record<string, string>QueryParams
Propósito: la forma por defecto de ctx.query para una ruta sin schema de query.
Firma
type QueryParams = Record<string, string>Body
Propósito: la unión de valores que un handler o middleware puede retornar.
Firma
type Body =
| object
| string
| ArrayBufferView
| ArrayBuffer
| Blob
| FormData
| URLSearchParams
| ReadableStream
| ResponseComportamiento: cada variante se mapea a una response HTTP distinta — ver Response para la tabla completa de mapeo, incluyendo cómo se derivan el status y los headers en cada caso.