ArctonArcton
Providers

Descripción general de Providers

Compone valores tipados sobre ctx con provide(), disponibles para todo lo que se registre después.

provide() compone context tipado: corre una función por request y mezcla lo que sea que devuelva, plano y tipado, sobre ctx, para todo lo que se registre después:

import { Arcton } from '@arcton/core'

const app = Arcton()

app
  .provide(ctx => ({
    requestId: ctx.request.headers.get('x-request-id') ?? crypto.randomUUID()
  }))
  .get('/whoami', ctx => ({ requestId: ctx.requestId }))

app.listen()

ctx.requestId pasa el type-check en el handler de arriba porque .get() está encadenado directamente sobre el valor que devuelve .provide() — ese es el objeto cuyo tipo realmente trae requestId. Ver Context tipado para saber exactamente por qué importa el encadenamiento.

Los providers pueden construir uno sobre otro

Los providers corren en orden de registro, y uno posterior puede leer lo que agregó uno anterior:

import { Arcton } from '@arcton/core'

const app = Arcton()

app
  .provide(() => ({ db: { query: async (_sql: string) => [] } }))
  .provide(async ctx => {
    const users = await ctx.db.query('select * from users')
    return { users }
  })
  .get('/users', ctx => ctx.users)

app.listen()

Lo que no puedes proveer

Volver a proveer una key que ya está en ctx — una que ya proveíste antes, o uno de los campos base request, params, query, response, body — es un error de compilación, no algo que se chequea en runtime.

Los providers corren antes de la validación y del route middleware, y no corren para responses 404/405. Para ver con más profundidad cómo provide() compone context tipado, ver Context tipado; para saber cuándo usar provide() en vez de use(), ver Providers vs Middleware.

En esta página