Repolode
Enviar
graphql-hive

graphql-hive/graphql-inspector

Um kit de ferramentas para comparar schemas GraphQL, sinalizar mudanças incompatíveis, validar operações e encontrar tipos semelhantes.

Ver no GitHubSite
Estrelas
1,767
Forks
218
Issues abertas
132
Último commit
anteontem

O que é?

GraphQL Inspector lista as diferenças entre dois schemas GraphQL e classifica cada mudança como incompatível, compatível ou perigosa, explicando seu impacto. Também valida queries, mutations e fragments em relação a um schema, ajudando a detectar operações inválidas antes que cheguem ao servidor.

Além de comparar schemas, o projeto encontra tipos semelhantes ou duplicados em um schema e informa a cobertura com base nas operações e fragments que o utilizam. Também pode disponibilizar um servidor GraphQL mock com dados falsos e GraphiQL.

A ferramenta está disponível como GitHub App, GitHub Action, CLI, imagem Docker e API programática para projetos TypeScript e JavaScript.

Recursos principais

  • 01Compara dois schemas e explica cada mudança como incompatível, compatível ou perigosa.
  • 02Valida operações e fragments em relação a um schema.
  • 03Envia notificações sobre mudanças no schema.
  • 04Encontra tipos semelhantes ou duplicados.
  • 05Informa a cobertura do schema com base em operações e fragments.
  • 06Disponibiliza um servidor GraphQL mock com dados falsos e GraphiQL.

Casos de uso

  • Impedir mudanças incompatíveis no schema em pull requests usando a GitHub Action.
  • Verificar queries de clientes em relação a um schema no CI antes do deploy.
  • Auditar quais partes do schema são realmente usadas pelas operações dos clientes.
  • Remover tipos duplicados de uma API GraphQL de grande porte.

Tópicos

#graphql#schema#api#breaking-changes#linting#typescript#github-action#javascript#monitoring#probot-app

Perguntas frequentes

O que é graphql-inspector?
Um kit de ferramentas para comparar schemas GraphQL, sinalizar mudanças incompatíveis, validar operações e encontrar tipos semelhantes. GraphQL Inspector lista as diferenças entre dois schemas GraphQL e classifica cada mudança como incompatível, compatível ou perigosa, explicando seu impacto. Também valida queries, mutations e fragments em relação a um schema, ajudando a detectar operações inválidas antes que cheguem ao servidor.
graphql-inspector é gratuito? Qual é a licença?
graphql-inspector é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
graphql-inspector ainda é mantido?
Manutenção ativa. O último commit de graphql-inspector foi em 20 de out. de 2026.
Para que posso usar graphql-inspector?
Impedir mudanças incompatíveis no schema em pull requests usando a GitHub Action. Verificar queries de clientes em relação a um schema no CI antes do deploy. Auditar quais partes do schema são realmente usadas pelas operações dos clientes. Remover tipos duplicados de uma API GraphQL de grande porte.
Onde consigo graphql-inspector?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/graphql-hive/graphql-inspector

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados