Errors
Error Reference¶
All error types thrown by the library across all languages.
AppError¶
Error type for application builder operations.
| Variant | Message | Description |
|---|---|---|
Route | Failed to register route: | Route registration failed. |
Server | Failed to build server: | Server/router construction failed. |
Decode | Failed to decode payload: | Failed to extract DTO from the request context. |
GraphQL | Failed to register GraphQL route: | GraphQL route registration failed (e.g. an unrecognized schema_type). |
GraphQLError¶
Errors that can occur during GraphQL operations
These errors are compatible with async-graphql error handling and can be converted to structured HTTP responses matching the project's error fixtures.
| Variant | Message | Description |
|---|---|---|
ExecutionError | execution error: | Error during schema execution Occurs when the GraphQL executor encounters a runtime error during query execution. |
SchemaBuildError | schema build error: | Error during schema building Occurs when schema construction fails due to invalid definitions or conflicts. |
RequestHandlingError | request handling error: | Error during request handling Occurs when the HTTP request cannot be properly handled or parsed. |
SerializationError | serialization error: | Serialization error Occurs during JSON serialization/deserialization of GraphQL values. |
JsonError | JSON error: | JSON parsing error Occurs when JSON input cannot be parsed. |
ValidationError | GraphQL validation error: | GraphQL validation error Occurs when a GraphQL query fails schema validation. |
ParseError | GraphQL parse error: | GraphQL parse error Occurs when the GraphQL query string cannot be parsed. |
AuthenticationError | Authentication error: | Authentication error Occurs when request authentication fails. |
AuthorizationError | Authorization error: | Authorization error Occurs when user lacks required permissions. |
NotFound | Not found: | Not found error Occurs when a requested resource is not found. |
RateLimitExceeded | Rate limit exceeded: | Rate limit error Occurs when rate limit is exceeded. |
InvalidInput | Invalid input: | Invalid input error with validation details Occurs during input validation with detailed error information. |
ComplexityLimitExceeded | Query complexity limit exceeded | Query complexity limit exceeded Occurs when a GraphQL query exceeds the configured complexity limit. |
DepthLimitExceeded | Query depth limit exceeded | Query depth limit exceeded Occurs when a GraphQL query exceeds the configured depth limit. |
IntrospectionDisabled | GraphQL introspection is disabled | Introspection query rejected because introspection is disabled Occurs when a query selects __schema or __type while the schema was configured with introspection disabled. |
InternalError | Internal server error: | Internal server error Occurs when an unexpected internal error happens. |
SchemaError¶
Error type for schema building operations
| Variant | Message | Description |
|---|---|---|
BuildingFailed | Schema building failed: | Generic schema building error |
ValidationError | Configuration validation failed: | Configuration validation error |
ComplexityLimitExceeded | Query complexity limit exceeded: limit={limit}, actual={actual} | Complexity limit exceeded |
DepthLimitExceeded | Query depth limit exceeded: limit={limit}, actual={actual} | Depth limit exceeded |