diff --git a/docs/source/schema-design/federated-schemas/reference/errors.mdx b/docs/source/schema-design/federated-schemas/reference/errors.mdx index 95617c335..40bd0d1de 100644 --- a/docs/source/schema-design/federated-schemas/reference/errors.mdx +++ b/docs/source/schema-design/federated-schemas/reference/errors.mdx @@ -62,6 +62,50 @@ A [circular reference](/graphos/schema-design/connectors/troubleshooting#circula +##### `CONNECT_BATCH_AND_THIS` + +Since v2.11.0\*\* + + + + +Using both [`$batch`](/graphos/connectors/mapping/variables#batch) and [`$this`](/graphos/connectors/mapping/variables#this) in a mapping is not allowed. + + + + + + +###### `CONNECTORS_BATCH_KEY_NOT_IN_SELECTION` + +Since v2.11.0\*\* + + + + +Every field used on `$batch` must also appear in the `selection` of the same connector. +See [Rules for `batch` Connectors](/graphos/connectors/requests/batching#rules-for-batch-connectors) for more information. + + + + + + +###### `CONNECTORS_CANNOT_RESOLVE_KEY` + +Since v2.11.0\*\* + + + + +A `@key` could not be resolved for the given combination of variables. In order to create a valid `@key` +selection's are expected contain at least one of the following variables: `$args`, `$this`, or `$batch`. + + + + + + ###### `CONNECTORS_FIELD_WITH_ARGUMENTS` Since v2.10.0\*\* @@ -69,7 +113,38 @@ Since v2.10.0\*\* -A field resolved by a connector has arguments defined. +A field resolved by a [connector](/graphos/connectors) has arguments defined. + + + + + + +###### `CONNECTORS_NON_ROOT_BATCH_KEY` + +Since v2.11.0\*\* + + + + + +Variables (such as `$this` or `$context`) to define Connector `$batch` selections. +Batch selections should be mapped from the `$batch` variable. + + + + + + + +###### `CONNECT_ON_ROOT` + +Since v2.11.0\*\* + + + + +`@connect` cannot be applied to a query, mutation, or subscription root type @@ -83,7 +158,7 @@ Since v2.10.0\*\* -The schema includes fields that aren't resolved by a connector. +The schema includes fields that aren't resolved by a [connector](/graphos/connectors). @@ -97,7 +172,7 @@ Since v2.10.0\*\* -[Abstract types](/graphos/schema-design/connectors/limitations#abstract-schema-types-are-unsupported) are not allowed when using connectors. +[Abstract types](/graphos/connectors/reference/limitations#abstract-schema-types-are-unsupported) are not allowed when using connectors. @@ -111,7 +186,7 @@ Since v2.10.0\*\* -[Certain directives](/graphos/schema-design/connectors/limitations) are not allowed when using connectors. +[Certain directives](/graphos/connectors/reference/limitations) are not allowed when using connectors. @@ -199,7 +274,7 @@ Since v2.10.0\*\* -Indicates two connector sources with the same name were created. +Indicates two connector [sources](/graphos/connectors/requests#sharing-configuration-with-source) with the same name were created. @@ -242,7 +317,7 @@ Since v2.10.0\*\* -No `name` was provided when creating a connector source with `@source`. +No `name` was provided when creating a connector source with [`@source`](/graphos/connectors/requests#sharing-configuration-with-source). @@ -477,7 +552,7 @@ Replaces [`VALUE_TYPE_FIELD_TYPE_MISMATCH`](#value-type-field-type-mismatch). -###### `GRAPHQL_ERROR` +###### `GRAPH_QL_ERROR` Since v2.10.0\*\* @@ -512,7 +587,7 @@ Since v2.10.0\*\* -Fields that return an object type must use a group selection mapping `{}`. +Fields that return an object type must use a group selection mapping (i.e. `a { b }`). @@ -568,7 +643,7 @@ Since v2.10.0\*\* -The `http.body` provided in `@connect` was not valid. +The mapping for `http.body` provided in `@connect` was not valid. See [Mapping Language Reference](/graphos/connectors/mapping) for more information on writing mappings. @@ -582,7 +657,7 @@ Since v2.10.0\*\* -A provided header in `@source` or `@connect` was not valid. +A provided header in `@source` or `@connect` was not valid. See [Headers](/graphos/connectors/requests#headers) for more on connector request headers. @@ -596,7 +671,7 @@ Since v2.10.0\*\* -The provided selection mapping in a `@connect`s `selection` was not valid. +The provided selection mapping in a `@connect`s `selection` was not valid. See [Mapping Language Reference](/graphos/connectors/mapping) for more information on writing selection mappings. @@ -610,7 +685,7 @@ Since v2.10.0\*\* -The `name` provided for a `@source` was invalid. Source names must start with a letter, include only letters, numbers, underscores (`_`) and hyphens (`-`), and be less than 64 characters. +The `name` provided for a [`@source`](/graphos/connectors/requests#sharing-configuration-with-source) was invalid. Source names must start with a letter, include only letters, numbers, underscores (`_`) and hyphens (`-`), and be less than 64 characters. @@ -918,7 +993,7 @@ Since v2.10.0\*\* -A `@key` was defined without a corresponding entity connector. +A `@key` was defined without a corresponding entity connector. See: [Working with Entities](/graphos/connectors/responses/entities) for more information. @@ -932,7 +1007,7 @@ Since v2.10.0\*\* -The `@connect` directive is missing an HTTP method. +The `@connect` directive is missing an [HTTP method](/graphos/connectors/requests#http-methods). @@ -946,7 +1021,7 @@ Since v2.10.0\*\* -The `@connect` directive has multiple HTTP methods when only one is allowed. +The `@connect` directive has multiple [HTTP methods](/graphos/connectors/requests#http-methods) when only one is allowed. @@ -1009,20 +1084,6 @@ This is a specialization of [`SOURCE_NAME_MISMATCH`](#source_name_mismatch) erro -###### `NULLABILITY_MISMATCH` - -Since v2.10.0\*\* - - - - -A variable is nullable in a location which requires non-null at runtime. - - - - - - ###### `ONLY_INACCESSIBLE_CHILDREN` Since v2.0.0 @@ -1464,7 +1525,7 @@ Since v2.10.0\*\* -The `source` argument used in a `@connect` directive doesn't match any named connecter sources created with `@source`. +The `source` argument used in a `@connect` directive doesn't match any named connector sources created with [`@source`](/graphos/connectors/requests#sharing-configuration-with-source). @@ -1478,7 +1539,7 @@ Since v2.10.0\*\* -Connectors currently [don't support subscription operations](/graphos/schema-design/connectors/limitations#subscriptions-are-unsupported). +Connectors currently [don't support subscription operations](/graphos/connectors/reference/limitations#subscriptions-are-unsupported). @@ -1536,7 +1597,7 @@ Since v2.10.0\*\* -Part of the `@connect` refers to an `$args` which is not defined. +Part of the `@connect` directive refers to an [`$args`](/graphos/connectors/mapping/variables#args) which is not defined. @@ -1550,7 +1611,7 @@ Since v2.10.0\*\* -Part of the `@connect` refers to an `$this` which is not defined. +Part of the `@connect` directive refers to an [`$this`](/graphos/connectors/mapping/variables#this) which is not defined. @@ -1634,7 +1695,7 @@ Since v2.10.0\*\* -A type used in a connector's variable is [not yet supported](/graphos/schema-design/connectors/limitations) (i.e., unions). +A type used in a connector's variable is [not yet supported](/graphos/connectors/reference/limitations) (i.e., unions).