Generando tipos sin trepar un árbol

Rate this content
Bookmark

¿Cómo generas tipos dinámicamente? ¿Cómo escribes un script que crea código TypeScript? El enfoque que la mayoría de las personas recomendaría es utilizar manipulaciones del Árbol de Sintaxis Abstracta. Estaba trabajando con una fecha límite para implementar tipos para nuestro cliente OpenAPI, y habría perdido nuestra ventana de lanzamiento. Necesitaba algo diferente y más fácil de construir. Afortunadamente, un amigo me recomendó una biblioteca que no conocía: code-block-writer. Me enamoré de ella a primera vista.

This talk has been presented at TypeScript Congress 2023, check out the latest edition of this Tech Conference.

FAQ

Matteo Collina es miembro del Comité de Dirección Técnica de Node.js y miembro de la Junta Directiva de la Fundación Open Source Open JS. Ha creado y mantenido numerosas bibliotecas de Node.js, con un uso significativo en la comunidad.

Fastify es un framework que Matteo Collina ayudó a desarrollar para construir APIs en Node.js. Ofrece la capacidad de generar documentación y definiciones de especificaciones OpenAPI de manera rápida y eficiente para las rutas definidas.

Antes de 2022, Matteo Collina casi nunca había usado TypeScript, pero comenzó a usarlo ese año cuando inició una nueva empresa, lo que le llevó a profundizar en el uso de TypeScript para el desarrollo empresarial.

tRPC es una biblioteca que facilita la creación de llamadas RPC desde el cliente al servidor de manera segura en cuanto a tipos. Su desventaja principal es el acoplamiento de tipos que introduce entre el código del frontend y el backend.

El objetivo de Matteo Collina es ayudar a los desarrolladores a eliminar el trabajo pesado indiferenciado en la construcción de aplicaciones JS, permitiendo un desarrollo más rápido y eficiente sin un acoplamiento estrecho entre el servidor y el cliente.

Matteo Collina propuso utilizar el estándar OpenAPI para definir las rutas y generar automáticamente un cliente que pueda consumir estas APIs de manera eficiente y completamente tipada, sin validaciones de datos en tiempo de ejecución.

Matteo Collina recomendó la biblioteca Cold Block Writer para la generación de código dinámico, destacando su facilidad de uso y la capacidad de generar código homomórfico que facilita la identificación y corrección de errores.

Matteo Collina
Matteo Collina
30 min
21 Sep, 2023

Comments

Sign in or register to post your comment.

Video Summary and Transcription

Esta charla explora los desafíos y beneficios de generar tipos para APIs. El orador discute la necesidad de una mejor experiencia para el cliente y la popularidad de generar clientes. También explica el uso de OpenAPI para generar clientes de API REST y el uso de Cold Block Writer para la generación de código. La charla cubre el proceso de definir tipos para parámetros y respuestas, generar el cliente y la solicitud, y utilizar el cliente generado. El orador también menciona la validación en producción y los desafíos iniciales con TypeScript.

1. Introducción a la Generación de Tipos

Short description:

Hola a todos. Soy Matteo Collina, cofundador y CTO de Platformatic, y hoy voy a hablar de algo que me pone un poco nervioso, la generación de tipos. Entradas. ¿Por qué? Vamos a profundizar en ello. Así que, la primera pregunta para todos ustedes es, ¿cuántas cuerdas necesitan para subir a un árbol? Esta es una pregunta fundamental y vamos a intentar responderla en esta charla.

hablar de algo que me pone un poco nervioso, la generación de tipos. Entradas. ¿Por qué? Vamos a profundizar en ello. Así que, la primera pregunta para todos ustedes es, ¿cuántas cuerdas necesitan para subir a un árbol? Esta es una pregunta fundamental y vamos a intentar responderla en esta charla. Así que, vamos. Lo primero, un par de cosas sobre mí. Soy Matteo Collina, parte del Comité de Dirección Técnica de Node.js, también miembro de la Junta Directiva de la Fundación Open Source Open JS. He creado un montón de bibliotecas, ayudado a mantener nodos, probablemente usando algunas de mis software dado que se descargaron 17 mil millones de veces el año pasado, así que sí, tal vez. Así que, algunas de mis decisiones afectan a algunas personas, así que espero no romper a demasiados de ustedes durante esta charla o después. De todos modos, vamos y saltemos. He escrito muchos módulos, mantengo muchos módulos en NPM, muchas descargas, lo que sea que importe. Por cierto, si alguna vez usas uno de ellos, si quieres patrocinarme en GitHub, todo es apreciado. Tengo una pequeña confesión que hacer. ¿Qué? ¿Qué? Bueno, antes de 2022, casi nunca usé TypeScript. Y aquí estoy hablando en el Congreso de TypeScript. ¿Qué es eso? Es realmente fascinante. Evité y pasé por alto esta tecnología tanto tiempo como pude. ¿Qué pasó en 2022? Bueno, empecé una nueva empresa, y era una experiencia de desarrollo para empresas. Así que sí, tuve que adentrarme en TypeScript. De hecho, todo se basa en algo que había hecho anteriormente, que es Fastify, que es un proyecto dentro de la Fundación Open Source también. Y se trata de construir APIs. Soy un ingeniero de back-end de profesión y lo que quiero es ayudar a las personas y cómo ayudar a las personas con mi herramienta, ya sabes, para construir y usar APIs de manera mejor y hacerlo más rápido y más fácil de desarrollar, mantener, escalar, como quieras llamarlo. Así que sí, típicamente el flujo típico cuando uno de tus miembros del equipo o alguien más está comenzando a escribir tus APIs, tienes una API en un extremo y típicamente eres un ingeniero de back-end escribiendo algunas consultas SQL complejas o algunas consultas complejas de MongoDB, lo que quieras, luego generan, escriben algo de documentación a partir de esa API y luego tu cliente, tu ingeniero, codifica su cliente. Entonces, ¿cómo se relaciona esto con la generación de tipos? Sí, permítanme presentar el problema primero. Esto es más o menos lo que Plasformatic quiere simplificar y mejorar cómo creamos software de back-end. Típicamente lo que queremos hacer es mover, permitirte moverte muy rápidamente de A a B utilizando tantos rieles como sea posible, rieles de protección para todos ustedes para moverse muy rápido. Y luego, ya sabes, puedes llevar tu viejo SUV exactamente donde quieras ir. Así que, queremos ayudar a los desarrolladores a deshacerse de todo el trabajo pesado indiferenciado de construir tus aplicaciones JS. Como parte de eso, en algún momento, nos enfocamos en trabajar

2. The Need for a Better Client Experience

Short description:

Lo que descubrimos al hablar con mucha gente fue que tener un cliente para las APIs era fundamental para una buena experiencia de desarrollo. La generación de clientes se ha vuelto popular recientemente con bibliotecas como tRPC y TS Rest. Sin embargo, estas bibliotecas introducen un acoplamiento estrecho entre el cliente y el código del servidor, lo que dificulta la escalabilidad y la evolución. Necesitamos una mejor experiencia de cliente que permita flexibilidad y el uso de diferentes versiones de TypeScript.

mucho en las APIs y mejorar dos APIs que se habían escrito. Lo que descubrimos al hablar con mucha gente fue que, ya sabes, oh, pero tener un cliente para esas APIs era realmente fundamental para proporcionar una buena experiencia y agilizar el desarrollo. Entonces, lo que sucedió fue que, ya sabes, a la mayoría de las personas realmente les gusta mucho más este flujo. Así que, en lugar de tener que llamar al cliente y preparar documentation para la API, solo quiero presionar un botón y generar un cliente. De hecho, esto ha sido tan popular desde hace mucho tiempo, y de alguna manera lo perdimos un poco en el camino, porque, ya sabes, recuerdo generar clientes para mis APIs cuando hacía WSDL y SOAP hace mucho tiempo. Así que, ya sabes, probablemente no sea una gran comparación, pero lo es. De todos modos, esto ha sido extremadamente popular recientemente. De hecho, esto ha sido popularizado en gran medida por algunas bibliotecas nuevas. Una es tRPC, que es fantástica, proporciona una experiencia de developer experience fantástica. Te permite exponer tu... crea una llamada RPC desde el servidor al... desde el cliente al servidor de una manera completamente segura en cuanto a tipos. Es genial, ¿vale? Solo tiene una desventaja significativa, que es el acoplamiento de tipos introducido en el... el código de tu frontend con el código de tu backend, también utiliza un protocolo propietario para comunicarse. Así que sí, es muy estrecho. Es un acoplamiento muy estrecho entre el cliente y el servidor. Hay otra biblioteca llamada TS Rest, que también es genial, una biblioteca fantástica, pero tiene otro pequeño... todavía otro pequeño problema, que es que necesitas especificar el contrato entre tu cliente y tu servidor en su propia definición de espacio de tipos. Nuevamente, para consumir la biblioteca, necesitas tener una dependencia de código fuente en el servidor. Así que nuevamente, para mí, esto introduce un acoplamiento estrecho entre los dos. De hecho, el problema aquí es el concepto de ya sabes, lo que sucede en la mayoría de los equipos con los que he trabajado y desarrollado y demás, es que básicamente tienes alguna API que es desarrollada más o menos por un equipo y hay otro grupo de personas que, ya sabes, crea y consume o que consume esas APIs. Y esos grupos típicamente están más o menos separados en la mayoría de las empresas y en la mayoría de las organizaciones. Entonces, integrar todo junto, crear un acoplamiento estrecho entre todo eso hace que sea muy difícil descomponer y escalar y seguir evolucionando las cosas. Y por cierto, no hay nada que criticar a esas bibliotecas, que son fantásticas. Solo estoy hablando de por qué creo que necesitamos una mejor experiencia de cliente para las APIs. Entonces, ¿dónde nos quedamos? Bueno, algo que queremos proporcionar es una experiencia de desarrollador fantástica pero sin ningún acoplamiento estrecho. Entonces, sin ningún código compartido, esencialmente, entre el servidor y el cliente, para que puedas usar y consumir otras APIs. Y así, uno puede usar TypeScript 4.9 y el otro puede usar TypeScript 6 en el futuro. Y pueden evolucionar y tener diferentes versiones, diferentes cosas. Todo es divertido y perfecto. Entonces, ¿cómo podemos generar esta developer experience? Comencé este viaje,

QnA

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

Escalando con Remix y Micro Frontends
Remix Conf Europe 2022Remix Conf Europe 2022
23 min
Escalando con Remix y Micro Frontends
Top Content
This talk discusses the usage of Microfrontends in Remix and introduces the Tiny Frontend library. Kazoo, a used car buying platform, follows a domain-driven design approach and encountered issues with granular slicing. Tiny Frontend aims to solve the slicing problem and promotes type safety and compatibility of shared dependencies. The speaker demonstrates how Tiny Frontend works with server-side rendering and how Remix can consume and update components without redeploying the app. The talk also explores the usage of micro frontends and the future support for Webpack Module Federation in Remix.
Los tipos más útiles de React
React Day Berlin 2023React Day Berlin 2023
21 min
Los tipos más útiles de React
Top Content
Today's Talk focuses on React's best types and JSX. It covers the types of JSX and React components, including React.fc and React.reactnode. The discussion also explores JSX intrinsic elements and react.component props, highlighting their differences and use cases. The Talk concludes with insights on using React.componentType and passing components, as well as utilizing the react.element ref type for external libraries like React-Select.
Componentes de Full Stack
Remix Conf Europe 2022Remix Conf Europe 2022
37 min
Componentes de Full Stack
Top Content
RemixConf EU discussed full stack components and their benefits, such as marrying the backend and UI in the same file. The talk demonstrated the implementation of a combo box with search functionality using Remix and the Downshift library. It also highlighted the ease of creating resource routes in Remix and the importance of code organization and maintainability in full stack components. The speaker expressed gratitude towards the audience and discussed the future of Remix, including its acquisition by Shopify and the potential for collaboration with Hydrogen.
TypeScript y React: Secretos de un matrimonio feliz
React Advanced Conference 2022React Advanced Conference 2022
21 min
TypeScript y React: Secretos de un matrimonio feliz
Top Content
React and TypeScript have a strong relationship, with TypeScript offering benefits like better type checking and contract enforcement. Failing early and failing hard is important in software development to catch errors and debug effectively. TypeScript provides early detection of errors and ensures data accuracy in components and hooks. It offers superior type safety but can become complex as the codebase grows. Using union types in props can resolve errors and address dependencies. Dynamic communication and type contracts can be achieved through generics. Understanding React's built-in types and hooks like useState and useRef is crucial for leveraging their functionality.
Depuración de JS
React Summit 2023React Summit 2023
24 min
Depuración de JS
Top Content
Debugging JavaScript is a crucial skill that is often overlooked in the industry. It is important to understand the problem, reproduce the issue, and identify the root cause. Having a variety of debugging tools and techniques, such as console methods and graphical debuggers, is beneficial. Replay is a time-traveling debugger for JavaScript that allows users to record and inspect bugs. It works with Redux, plain React, and even minified code with the help of source maps.
Haciendo JavaScript en WebAssembly Rápido
JSNation Live 2021JSNation Live 2021
29 min
Haciendo JavaScript en WebAssembly Rápido
Top Content
WebAssembly enables optimizing JavaScript performance for different environments by deploying the JavaScript engine as a portable WebAssembly module. By making JavaScript on WebAssembly fast, instances can be created for each request, reducing latency and security risks. Initialization and runtime phases can be improved with tools like Wiser and snapshotting, resulting in faster startup times. Optimizing JavaScript performance in WebAssembly can be achieved through techniques like ahead-of-time compilation and inline caching. WebAssembly usage is growing outside the web, offering benefits like isolation and portability. Build sizes and snapshotting in WebAssembly depend on the application, and more information can be found on the Mozilla Hacks website and Bike Reliance site.

Workshops on related topic

React, TypeScript y TDD
React Advanced Conference 2021React Advanced Conference 2021
174 min
React, TypeScript y TDD
Top Content
Featured WorkshopFree
Paul Everitt
Paul Everitt
ReactJS es extremadamente popular y, por lo tanto, ampliamente soportado. TypeScript está ganando popularidad y, por lo tanto, cada vez más soportado.

¿Los dos juntos? No tanto. Dado que ambos cambian rápidamente, es difícil encontrar materiales de aprendizaje precisos.

¿React+TypeScript, con los IDEs de JetBrains? Esa combinación de tres partes es el tema de esta serie. Mostraremos un poco sobre mucho. Es decir, los pasos clave para ser productivo, en el IDE, para proyectos de React utilizando TypeScript. En el camino, mostraremos el desarrollo guiado por pruebas y enfatizaremos consejos y trucos en el IDE.
Dominando conceptos avanzados en TypeScript
React Summit US 2023React Summit US 2023
132 min
Dominando conceptos avanzados en TypeScript
Top Content
Featured WorkshopFree
Jiri Lojda
Jiri Lojda
TypeScript no es solo tipos e interfaces. Únete a esta masterclass para dominar características más avanzadas de TypeScript que harán tu código a prueba de balas. Cubriremos tipos condicionales y notación de inferencia, cadenas de plantillas y cómo mapear sobre tipos de unión y propiedades de objetos/arrays. Cada tema se demostrará en una aplicación de muestra que se escribió con tipos básicos o sin tipos en absoluto y juntos mejoraremos el código para que te familiarices más con cada característica y puedas llevar este nuevo conocimiento directamente a tus proyectos.
Aprenderás:- - ¿Qué son los tipos condicionales y la notación de inferencia?- ¿Qué son las cadenas de plantillas?- Cómo mapear sobre tipos de unión y propiedades de objetos/arrays.
Consejos y Trucos Profundos de TypeScript
Node Congress 2024Node Congress 2024
83 min
Consejos y Trucos Profundos de TypeScript
Top Content
Featured Workshop
Josh Goldberg
Josh Goldberg
TypeScript tiene un sistema de tipos poderoso con todo tipo de características sofisticadas para representar estados de JavaScript salvajes y extravagantes. Pero la sintaxis para hacerlo no siempre es sencilla, y los mensajes de error no siempre son precisos al decirte qué está mal. Vamos a profundizar en cómo funcionan muchas de las características más poderosas de TypeScript, qué tipos de problemas del mundo real resuelven, y cómo dominar el sistema de tipos para que puedas escribir código TypeScript verdaderamente excelente.
Mejores Prácticas y Consejos Avanzados de TypeScript para Desarrolladores de React
React Advanced Conference 2022React Advanced Conference 2022
148 min
Mejores Prácticas y Consejos Avanzados de TypeScript para Desarrolladores de React
Top Content
Featured Workshop
Maurice de Beijer
Maurice de Beijer
¿Eres un desarrollador de React tratando de obtener los máximos beneficios de TypeScript? Entonces esta es la masterclass para ti.En esta masterclass interactiva, comenzaremos desde lo básico y examinaremos los pros y contras de las diferentes formas en que puedes declarar componentes de React usando TypeScript. Después de eso, pasaremos a conceptos más avanzados donde iremos más allá de la configuración estricta de TypeScript. Aprenderás cuándo usar tipos como any, unknown y never. Exploraremos el uso de predicados de tipo, guardias y comprobación exhaustiva. Aprenderás sobre los tipos mapeados incorporados, así como cómo crear tus propias utilidades de mapa de tipo nuevo. Y comenzaremos a programar en el sistema de tipos de TypeScript usando tipos condicionales e inferencia de tipos.
Master Patrones de JavaScript
JSNation 2024JSNation 2024
145 min
Master Patrones de JavaScript
Featured Workshop
Adrian Hajdin
Adrian Hajdin
Durante este masterclass, los participantes revisarán los patrones esenciales de JavaScript que todo desarrollador debe conocer. A través de ejercicios prácticos, ejemplos del mundo real y discusiones interactivas, los asistentes profundizarán su comprensión de las mejores prácticas para organizar el código, resolver desafíos comunes y diseñar arquitecturas escalables. Al final del masterclass, los participantes ganarán confianza en su capacidad para escribir código JavaScript de alta calidad que perdure en el tiempo.
Puntos Cubiertos:
1. Introducción a los Patrones de JavaScript2. Patrones Fundamentales3. Patrones de Creación de Objetos4. Patrones de Comportamiento5. Patrones Arquitectónicos6. Ejercicios Prácticos y Estudios de Caso
Cómo Ayudará a los Desarrolladores:
- Obtener una comprensión profunda de los patrones de JavaScript y sus aplicaciones en escenarios del mundo real- Aprender las mejores prácticas para organizar el código, resolver desafíos comunes y diseñar arquitecturas escalables- Mejorar las habilidades de resolución de problemas y la legibilidad del código- Mejorar la colaboración y comunicación dentro de los equipos de desarrollo- Acelerar el crecimiento profesional y las oportunidades de avance en la industria del software
Building Your Own Custom Type System
React Summit 2024React Summit 2024
38 min
Building Your Own Custom Type System
Featured Workshop
Kunal Dubey
Kunal Dubey
I'll introduce the audience to a concept where they can have end-to-end type systems that helps ensure typesafety across the teams Such a system not only improves communication between teams but also helps teams collaborate effectively and ship way faster than they used to before. By having a custom type system, teams can also identify the errors and modify the API contracts on their IDE, which contributes to a better Developer Experience. The workshop would primarily leverage TS to showcase the concept and use tools like OpenAPI to generate the typesystem on the client side.