Avem în lucru un refactoring serios pe un API cu vreo 50 de endpoint-uri și ne gândim serios dacă să dăm afară Zod în favoarea lui Valibot. Înainte să mă apuc să rescriu validările la mână pe tot codebase-ul, aș vrea să aflu dacă a mai făcut cineva pasul ăsta recent într-un proiect mediu sau mare.
Contextul e simplu: rulăm o parte bună din logică pe Cloudflare Workers și câteva lambdas pe AWS. Cu Zod am ajuns la un bundle pe funcție care ne mărește cold start-ul cu vreo 80-120ms doar din parsing-ul librăriei și al schemelor uriașe pe care le importăm. Poate pe un container clasic de Docker nu-ți pasă de 60KB gzipped, dar la 15.000 de cereri pe oră împărțite pe zeci de instante mici, diferența se simte direct în latency metrics.
Ce am văzut în primele teste
Am făcut un spike tehnic pe vreo 5 endpoint-uri mai stufoase, care foloseau z.discriminatedUnion, câteva refine-uri custom și transformări de date.
Pe partea de bundle size, Valibot e o gură de aer curat. Faptul că e modularizat complet și folosește funcții de tip pipe (pipe(string(), email(), ...)) face ca tree-shaking-ul să elimine tot ce nu folosești. Am redus slice-ul de validare din bundle de la ~52KB la sub 6KB pe endpoint-ul respectiv. Asta e partea frumoasă și promisiunea funcționează perfect.
Trade-off-ul direct e la Developer Experience. Sintaxa fluentă din Zod (z.string().min(3).max(20)) se scrie mult mai rapid din reflex. La Valibot, cel puțin la început, simt că scriu mult mai mult boilerplate cu wrapping-ul de funcții. Nu e un capăt de țară, te obișnuiești după două zile, dar colegii de echipă mai juniori s-au plâns deja că arată mai greoi și mai greu de parcurs dintr-o privire.
Dilema OpenAPI și integrarea cu ecosistemul
Adevăratul semn de întrebare pentru mine nu e viteza de execuție, ci ecosistemul din jur. În Zod avem totul legat strâns: generăm scheme OpenAPI automat cu @asteasolutions/zod-to-openapi, avem inferență de tipuri pe frontend fără bătaie de cap și validare de formulare pe client cu React Hook Form resolvers.
Dacă trecem pe Valibot:
- Cât de stabilă e generarea de JSON Schema / OpenAPI specs? Am văzut
@valibot/to-json-schema, dar nu știu dacă crapă la uniuni complexe sau transformări custom pe care le folosim frecvent. - Cum stați cu stabilitatea API-ului lor intern? Valibot a trecut prin schimbări destul de mari de sintaxă între versiunile 0.x și cele recente, iar noi avem nevoie de stabilitate pe următorii 2 ani fără să rescriem importuri la fiecare minor release.
- A folosit cineva un hibrid (Zod unde ai nevoie de tooling complex, Valibot doar la edge), sau e o rețetă sigură pentru haos mental în echipă?
Dacă a trecut cineva deja printr-o migrare similară pe un proiect viu, sunt curios: a meritat bătaia de cap pentru economisirea de bytes sau e doar un micro-management de optimizare prematură?