ArctonArcton
Providers

Context tipado

Cómo provide() hace crecer el tipo de ctx para todo lo que se registre después, sin namespace.

Cada llamada a provide() devuelve un nuevo valor de app cuyo tipo trae el campo agregado, para lo que sea que se registre sobre ese valor devuelto después:

import { Arcton } from '@arcton/core'

const app = Arcton()

app
  .get('/before', () => {
    // ctx has no `user` here — the provide() below hasn't run yet
    // in registration order
    return { ok: true }
  })
  .provide(ctx => ({
    user: ctx.request.headers.get('authorization') ? { id: 1 } : null
  }))
  .get('/after', ctx => ({ user: ctx.user }))

app.listen()

ctx.user pasa el type-check en /after y no en /before, porque /after se registra sobre el valor que devolvió .provide(), y /before se registra sobre el valor de antes.

provide() no ensancha retroactivamente el tipo de una app que ya tienes — devuelve una nueva, con un tipo más amplio. Registrar cualquier cosa que necesite un valor provisto tiene que pasar sobre ese valor devuelto, ya sea encadenando como en el ejemplo de arriba o reasignando, por ejemplo app = app.provide(...) con app declarada let. Llamar a .provide() y después seguir registrando rutas como statements separados sobre el const app original no va a pasar el type-check, aunque el valor esté presente en ctx en runtime de todas formas.

Plano, sin namespace

Un valor provisto queda directo sobre ctx — no hay ningún objeto envoltorio que atravesar:

import { Arcton } from '@arcton/core'

const app = Arcton()

app
  .provide(() => ({ user: { id: 1, name: 'Alice' } }))
  .get('/me', ctx => ctx.user)

app.listen()

Keys reservadas

Una llamada a provide() no puede reusar una key que ya está ahí. Eso incluye los campos base de Context — request, params, query, response, body — y cualquier key que un provide() anterior en la cadena ya haya agregado. Ambos casos se refuerzan a nivel de tipos: reusar una es un error de compilación.

Ver Descripción general de Providers para la mecánica request por request, y Context para los campos base junto a los que queda un valor provisto.

En esta página