Errores de validación
La response exacta que envía Arcton cuando falla la validación de params, query o body.
Cuando falla un esquema de params, query o body, Arcton responde 400 con un
body application/json que trae los issues que reportó el esquema:
{
"issues": [
{ "message": "Invalid length: Expected >=1 but received 0", "path": ["..."] }
]
}El array issues es exactamente lo que tu librería de esquemas devolvió en su propia
llamada de validación — Arcton no lo reestructura ni lo filtra. Todo issue tiene un
message, y cada librería agrega sus propios campos al lado.
Valibot, por ejemplo, devuelve issues que traen kind, type, input, expected,
received y requirement, con un path de objetos de segmento en lugar de keys
planas:
{
"issues": [
{
"kind": "validation",
"type": "min_length",
"input": "",
"expected": ">=1",
"received": "0",
"message": "Invalid length: Expected >=1 but received 0",
"requirement": 1,
"path": [{ "type": "object", "origin": "value", "key": "item" }]
}
]
}Zod y ArkType reportan sus propias formas. Lee message cuando necesites algo
estable entre librerías, y trata el resto como específico de la que elegiste — si un
cliente depende de los campos exactos, fija la librería de esquemas que los produce.
import { Arcton } from '@arcton/core'
import * as v from 'valibot'
const app = Arcton()
app.post('/users', {
body: v.object({
email: v.pipe(v.string(), v.email())
}),
handler: ctx => ({ created: ctx.body })
})
app.listen()Un POST /users con un body cuyo campo email falla v.email() recibe el 400 de
arriba; una request cuyo email pasa llega al handler con ctx.body.email ya
validado.
Manejar tú mismo los fallos de validación
Ese 400 es el comportamiento por defecto. Un fallo de validación es un error
como cualquier otro, así que llega a
app.onError()
como un ValidationError con los mismos issues: devuelve un valor o una
Response ahí para reemplazar la respuesta, o no devuelvas nada para conservar
esta.
Qué corta la cadena y qué no
La validación corre params → query → body, y el primer esquema que falla detiene la request justo ahí — nada más en ese orden corre después, y tampoco corre ningún route middleware ni el handler. Ver Descripción general de validación.
Dos fallas relacionadas pasan por fuera de la validación del esquema en sí, antes de que tu esquema llegue a ver un valor:
- Un
Content-Typede request no soportado para una ruta con un esquema debodyresponde415, antes de intentar cualquier parseo o validación. - Un parser integrado que no puede interpretar el body en absoluto (JSON malformado,
por ejemplo) responde
400con un{"issues":[{"message":"Invalid request body"}]}fijo — este mensaje no viene de tu esquema, porque el esquema nunca llegó a recibir un valor para validar.
Ambas están cubiertas en detalle en Parsers de Body.