Hace unas semanas publiqué una librería TypeScript llamada @traversable/zod. En este artículo explico qué hace, por qué es diferente y destaco varias funciones únicas que pueden acelerar tu desarrollo de software a medida.
Nota: actualmente @traversable/zod solo funciona con la última versión de Zod v4.
Qué hace diferente a @traversable/zod. La puedes usar de dos maneras. Primero, elegir entre más de 25 transformadores listos para usar. Segundo, crear tus propios transformadores personalizados cuando necesites total control.
Transformadores listos para usar
zx.check convierte un esquema de Zod en un type guard de alto rendimiento. Consulta el perfil de rendimiento en esta comparativa.
zx.deepClone convierte un esquema de Zod en una función de copia profunda. Descubre cómo se construyó uno de los deep clone más rápidos de JavaScript en este artículo.
zx.deepEqual convierte un esquema de Zod en una función de igualdad profunda. Más detalles sobre rendimiento y técnicas en esta guía.
zx.deepPartial vuelve opcionales todas las propiedades de un esquema Zod. Contexto sobre el cambio en Zod v4 en este apunte del changelog.
zx.toString convierte un esquema de Zod en una cadena legible. Útil para pruebas, generación de código y comprobaciones de coherencia.
zx.toType convierte un esquema de Zod en un tipo de TypeScript, preservando metadatos del esquema como anotaciones JSDoc.
zx.makeLens permite trabajar con lentes para enfocar valores anidados con getters y setters, reificar el control de flujo con prismas para realizar pattern matching, recorrer contenedores con traversals y componer todo con funciones.
Crea tus propios transformadores
El núcleo es zx.fold, la abstracción que impulsa todos los transformadores incluidos en @traversable/zod. Bajo el capó utiliza recursion schemes que hacen que implementar recursión sea simple y entretenido. Puedes leer más sobre el enfoque en este artículo.
Como demostración, implementé toJsonSchema con zx.fold en apenas 28 líneas. Explora el ejemplo completo en StackBlitz.
Nota: elegí toJsonSchema porque existen varias librerías que ya lo hacen, incluida la propia Zod. El objetivo es mostrar cómo aprovechar zx.fold para construir tu propio conjunto de utilidades.
Cómo encaja en proyectos reales
Si construyes aplicaciones a medida, @traversable/zod reduce la fricción entre la definición de modelos y las operaciones comunes de tu código como validación, clonación, comparación y serialización. Esto incrementa la robustez y acelera los ciclos de entrega en software a medida y en plataformas de datos con fuerte tipado.
En Q2BSTUDIO integramos estas prácticas en soluciones de ingeniería para empresas. Somos una empresa de desarrollo de software especializada en aplicaciones a medida, inteligencia artificial, ciberseguridad, servicios cloud AWS y Azure, servicios de inteligencia de negocio y automatización. Si estás pensando en modernizar tu stack o lanzar un producto, descubre cómo abordamos el desarrollo de aplicaciones y software multiplataforma con foco en calidad, rendimiento y escalabilidad.
También impulsamos proyectos de ia para empresas con agentes IA y analítica avanzada, integrando modelos y pipelines en producción. Conoce nuestras capacidades en inteligencia artificial para acelerar casos de uso de clasificación, extracción de conocimiento y copilotos internos.
Si te preocupa la protección de datos y amenazas emergentes, reforzamos tus iniciativas con prácticas de ciberseguridad y pentesting, y desplegamos infraestructuras en la nube siguiendo buenas prácticas de servicios cloud aws y azure y gobierno del dato. Complementamos con servicios inteligencia de negocio y cuadros de mando con power bi para llevar la toma de decisiones al siguiente nivel.
Cierre
Gracias por leer. Si tienes comentarios, ideas o preguntas, puedes abrir un issue o iniciar una discusión en el repositorio de @traversable/zod.
Enlaces
@traversable/zod en GitHub: repositorio
Demo completa de toJsonSchema: StackBlitz