Expand description
Compatibility diffing between two generated GraphQL type graphs.
GraphQL states nullability on the reference (id: ID!) rather than on the
parent, so this is not the JSON Schema comparison the other dialects
share — but the asymmetry underneath it is the same one. On an output
type, T! becoming T withdraws a guarantee a client already relies on;
on an input type, the same edit relaxes a demand, and it is T
becoming T! that breaks the caller.
Comparing the graph rather than the SDL text is what lets the gate say “field removed” instead of “line 42 changed”: reformatting is invisible here, and a real edit is named at the field it happened to.
Functions§
- diff
- Compare two generated type graphs, oldest first.