Repolode
graphql-hive

graphql-hive/graphql-inspector

Kit de herramientas para comparar esquemas GraphQL, detectar cambios incompatibles, validar operaciones y encontrar tipos similares.

Estrellas
1,767
Forks
218
Issues abiertos
132
Último commit
anteayer

¿Qué es?

GraphQL Inspector muestra las diferencias entre dos esquemas GraphQL y clasifica cada cambio como incompatible, no incompatible o peligroso, con una explicación de su impacto. También puede comprobar consultas, mutaciones y fragmentos frente a un esquema, lo que ayuda a detectar operaciones no válidas antes de que lleguen a un servidor.

Además de comparar esquemas, el proyecto encuentra tipos similares o duplicados dentro de un esquema e informa sobre su cobertura según las operaciones y los fragmentos que lo utilizan. También puede poner en marcha un servidor GraphQL simulado con datos ficticios y GraphiQL.

La herramienta está disponible como GitHub App, GitHub Action, CLI, imagen de Docker y API programática para proyectos de TypeScript y JavaScript.

Funciones clave

  • 01Compara dos esquemas y explica cada cambio como incompatible, no incompatible o peligroso.
  • 02Valida operaciones y fragmentos frente a un esquema.
  • 03Envía notificaciones sobre cambios en el esquema.
  • 04Encuentra tipos similares o duplicados.
  • 05Informa sobre la cobertura del esquema a partir de operaciones y fragmentos.
  • 06Pone en marcha un servidor GraphQL simulado con datos ficticios y GraphiQL.

Casos de uso

  • Bloquear cambios incompatibles en el esquema en las pull requests con GitHub Action.
  • Comprobar las consultas del cliente frente a un esquema en CI antes del despliegue.
  • Auditar qué partes de un esquema utilizan realmente las operaciones del cliente.
  • Eliminar tipos duplicados en una API GraphQL grande.

Temas

Preguntas frecuentes

¿Qué es graphql-inspector?
Kit de herramientas para comparar esquemas GraphQL, detectar cambios incompatibles, validar operaciones y encontrar tipos similares. GraphQL Inspector muestra las diferencias entre dos esquemas GraphQL y clasifica cada cambio como incompatible, no incompatible o peligroso, con una explicación de su impacto. También puede comprobar consultas, mutaciones y fragmentos frente a un esquema, lo que ayuda a detectar operaciones no válidas antes de que lleguen a un servidor.
¿graphql-inspector es gratuito? ¿Qué licencia tiene?
graphql-inspector es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿graphql-inspector sigue mantenido?
Mantenimiento activo. El último commit de graphql-inspector fue el 20 oct 2026.
¿Para qué puedo usar graphql-inspector?
Bloquear cambios incompatibles en el esquema en las pull requests con GitHub Action. Comprobar las consultas del cliente frente a un esquema en CI antes del despliegue. Auditar qué partes de un esquema utilizan realmente las operaciones del cliente. Eliminar tipos duplicados en una API GraphQL grande.
¿Dónde consigo graphql-inspector?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/graphql-hive/graphql-inspector

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados