graphql.cr

Oxide is a GraphQL library for Crystal that implements the core GraphQL specification as a low-level foundation. It provides the essential building blocks for creating GraphQL schemas programmatically, enabling dynamic API generation and runtime schema construction.

Key Features

• Low-Level Schema Definition — Schemas are built using core type instances like Schema, Field, and Type, providing full control over the AST.
• GraphQL-JS Compatibility — Error messages, formatting, and suggestions match the reference implementation for consistency.
• LateBoundType Support — Enables recursive and cyclic type definitions by referencing types by name during schema construction.
• Lazy Execution with Loader — Includes a synchronous future implementation and Loader abstract class for batching operations to prevent N+1 queries.
• Comprehensive Validation — Implements the GraphQL spec's validation rules for operations, fields, fragments, arguments, values, directives, and variables.

Philosophy

Oxide aims to follow the GraphQL specification as closely as possible, with a focus on enabling dynamic, runtime-generated schemas and providing a foundation for flexible GraphQL APIs in Crystal.