Providers vs Middleware
Cuándo agregar valores tipados con provide() y cuándo usar use() para controlar el flujo alrededor de una request.
provide() y use() corren ambos por request, en orden de registro, y se pueden
mezclar libremente — pero existen para trabajos distintos.
Un provider no tiene next y no puede cortar la cadena; lo que devuelve se mezcla
sobre ctx y la cadena siempre continúa. El middleware recibe next, corre código
antes y después de llamarlo, y puede cortar la cadena devolviendo un valor sin llamar
a next() — deteniendo todo lo que sigue, incluyendo cualquier provider o handler
que de otra forma correría.
import { Arcton } from '@arcton/core'
const app = Arcton()
app
.use(async (ctx, next) => {
console.log(ctx.request.method, new URL(ctx.request.url).pathname)
await next()
})
.provide(ctx => {
const authHeader = ctx.request.headers.get('authorization')
return {
user: authHeader === 'secret' ? { id: 1, name: 'Alice' } : null
}
})
.get(
'/profile',
async (ctx, next) => {
if (!ctx.user) return new Response('Unauthorized', { status: 401 })
await next()
},
ctx => ({ user: ctx.user })
)
app.listen()El use() de logging de arriba solo observa la request; no agrega nada al tipo de
ctx. La llamada a provide() adjunta user, tipado, a todo lo que se registre
después. El route middleware en /profile es la pieza que realmente puede rechazar
la request — devolviendo 401 y sin llamar nunca a next() — algo que un provider no
tiene ningún mecanismo para hacer.
Recurre a provide() cuando estás adjuntando un valor tipado que todo lo que sigue
debería poder leer. Recurre a use() cuando necesitas correr código alrededor del
resto de la cadena, inspeccionar o reemplazar la response, o detener la request
temprano. Ver Descripción general de Providers y
Descripción general de Middleware para cada uno por
separado.