graphql-spec
graphql-spec copied to clipboard
graphql
GraphQL is a query language and execution engine tied to any backend service.
See http://spec.graphql.org/October2021/#TypeDefinition. Every type definition _may_ not declare its "important" parts: _FieldsDefinition_, _UnionMemberTypes_, _EnumValuesDefinition_, _InputFieldsDefinition_. The idea is that those parts may be declared later as extensions: ```graphql extend type...
# GraphQL Tuples At this stage, GraphQL does not provide tuples. This issue proposes to extend the GraphQL specification with an additional primitive type `Tuple` (of kind `WRAPPER`). a GraphQL...
This is to better anticipate the nature of defer/stream directives as client side recommendations rather than mandates.
[Coercing Field Arguments](http://spec.graphql.org/draft/#sec-Coercing-Field-Arguments) states: > 5.c. Let defaultValue be the default value for argumentDefinition. > [...] > 5.h. If hasValue is not true and defaultValue exists (including null): > 5.h.i....
In the current GraphQL specification the schema type have three different types on it: `query`, `mutation` and `subscription`. The **mutation** type is a special `ObjectType` that **enforces the fields on...
👋 I've pulled out the proposed spec edits for Schema Coordinates (issue: https://github.com/graphql/graphql-spec/issues/735) into this PR. (The RFC now lives in the original PR: https://github.com/graphql/graphql-spec/pull/746/files) @leebyron you mentioned it might...
In RDF it's quite common to use subclasses, and somewhat common to use union types (eg `schema:rangeIncludes` states a field can take values from several different classes; `owl:unionOf` does a...
This broad change uses definition phrases to define each type, as well as expands the set of sub-sections at the top of the "Types" section which define *kinds* of types....
### Motivation Our application defines some mutations that are purely used to trigger side effects and don't return a value. GraphQL enforces the definition of a return type for those...
Was already discussed during WG: https://github.com/graphql/graphql-wg/blob/main/notes/2021-04-01.md#adding-descriptions-to-queries-and-fragments-ivan I prepare a format proposal, here is a couple of key points: 1. You can add descriptions on operations, fragments, and query variables 2....
