Cuando cambia el modelo de contenido de Drupal, también cambia el contrato del frontend
Un campo añadido en Drupal no se convierte automáticamente en un campo útil en una aplicación Next.js. El esquema, la consulta, el modelo de TypeScript y el renderizador deben coincidir. Una importación de configuración del CMS exitosa demuestra solo una parte de ese contrato.
GraphQL Compose Codegen ayuda a hacer explícito ese trabajo. Inspecciona los bundles de nodos y párrafos de Drupal y genera adiciones de TypeScript, fragmentos de GraphQL, casos de renderizador y esbozos de componentes. El resultado le da a un ingeniero un punto de partida concreto para integrar un cambio en el modelo de contenido.
Haga que la diferencia sea revisable
Considere un nuevo tipo de párrafo con un encabezado y una colección de enlaces. El frontend necesita un tipo correspondiente, una consulta que seleccione los campos, una rama del renderizador y un componente que presente el resultado. Si falta cualquiera de ellos, el nuevo contenido puede quedar invisible o inutilizable.
Los comandos de inspección y de diferencia de esquema del módulo exponen los cambios antes de que se conviertan en un ejercicio de depuración. La generación produce andamiaje para revisión e integración manual. Su comando de validación verifica si los archivos generados siguen alineados con el esquema. Son verificaciones útiles en el punto donde se encuentran la configuración del CMS y el código del frontend.
El andamiaje generado todavía necesita una prueba de aplicación
Un esbozo de componente no puede decidir cómo debe verse una colección de enlaces vacía. Un tipo generado no puede demostrar que una API desplegada acepte la consulta completa de la aplicación. Esas decisiones siguen perteneciendo a la aplicación y a sus pruebas.
Esa distinción importa en nuestro artículo sobre un campo de GraphQL faltante que tumba la consulta de una página: verificar la consulta real contra el esquema objetivo detecta una falla distinta de la que detecta verificar los archivos generados en busca de desviaciones. Use ambas verificaciones cuando el frontend dependa de un modelo de Drupal en cambio.
El resultado es una tarea de integración más pequeña y más visible. Los ingenieros pueden revisar juntos el cambio de esquema y sus consecuencias en el frontend, y luego probar el comportamiento de renderizado y de consulta antes del lanzamiento. Consulte la documentación del proyecto para los comandos y la configuración.