Skip to content

Error Reference

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.

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.
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

Edit this page on GitHub