ChilliCream/hotchocolate
Hotchocolate
HotChocolate is a GraphQL server implementation for .NET that handles queries, mutations, and subscriptions over HTTP. It provides code-first schema generation directly from C# classes and attributes, keeping the schema and business logic in sync without manual type definitions. The project also includes a GraphQL gateway that composes multiple GraphQL and REST endpoints into a single unified schema, along with a GraphQL IDE for exploring, testing, and debugging GraphQL APIs interactively.
The project distinguishes itself through its comprehensive tooling ecosystem, which includes a GraphQL client generator for .NET that produces typed C# clients from GraphQL queries with reactive state management and data caching. It offers schema stitching via type merging to combine multiple GraphQL schemas into one, and supports real-time data streaming through WebSocket subscriptions and Server-Sent Events. The platform also provides a GraphQL schema registry for storing, versioning, and tracking schema changes with client impact analysis.
Additional capabilities include DataLoader-based batching to eliminate N+1 query problems, in-memory entity caching, middleware pipeline execution for authentication and validation, and multipart request support for file uploads. The project enables schema definition through a fluent API, query cost analysis before execution, and authentication via multiple flows including OAuth 2. It also supports restricting operations to trusted documents for safe schema evolution.
Features
- GraphQL APIs - Constructs a GraphQL server using schema-first or code-first approaches, including subscriptions and middleware.
- DataLoader Batching Engines - Implements DataLoader-based batching to eliminate N+1 query problems in GraphQL resolvers.
- Local-Remote State Binding - Provides a unified GraphQL interface to read and write both local client state and remote server data.
- Unified GraphQL Interfaces - Provides a unified GraphQL interface to read and write both local client state and remote server data.
- GraphQL Subscriptions - Delivers real-time GraphQL subscription data over WebSocket using the Apollo subscription protocol.
- WebSocket Subscriptions - Streams GraphQL subscription data over WebSocket using the Apollo subscription protocol.
- Data Batching and Caching Utilities - Groups multiple data fetching requests into a single batch call, reducing redundant queries and improving performance.
- GraphQL Subscriptions over WebSocket - Streams GraphQL subscription data over WebSocket using the Apollo subscription protocol.
- Real-Time Message Push - Implements real-time GraphQL subscriptions over WebSocket for live data updates.
- GraphQL State Change Subscriptions - Provides reactive APIs that push GraphQL data changes to keep the UI in sync.
- GraphQL Schema Stitching - Merges multiple independent GraphQL services into a unified schema exposed through a single endpoint.
- C# GraphQL Client Generators - Generates typed C# .NET client code from GraphQL queries at compile time using Roslyn source generators.
- Code-First Schema Generators - Generates GraphQL schemas directly from C# classes and attributes, keeping schema and logic in sync.
- Schema Stitching Gateways - Merges multiple GraphQL or REST endpoints into a single unified schema for client consumption.
- GraphQL Servers - Builds a complete GraphQL server in .NET handling queries, mutations, subscriptions, and file uploads.
- GraphQL Schema Registries - Stores, versions, and tracks GraphQL schema changes in a centralized registry with client impact analysis.
- In-Memory Caches - Stores fetched entities in memory so subsequent requests for the same key return instantly.
- Entity Second-Level Caching - Caches fetched entities in memory so subsequent requests for the same key return instantly.
- GraphQL Query Cost Analyzers - Assigns weights to fields and rejects operations exceeding a configured performance budget.
- SSE Subscriptions - Streams GraphQL subscription data to clients using Server-Sent Events for live updates.
- GraphQL API Clients - Registers and documents client applications consuming GraphQL APIs for schema change impact analysis.
- GraphQL IDEs - Provides a desktop or web-based IDE to query, inspect, and share any GraphQL endpoint interactively.
- API Clients - Registers and tracks client applications consuming the GraphQL API for schema change impact analysis.
- GraphQL Subscriptions over SSE - Streams GraphQL subscription data to clients using Server-Sent Events for live updates.
- GraphQL Subscriptions over SSE - Streams GraphQL subscription data to clients using Server-Sent Events for live updates.
- Authentication Flows - Supports basic, bearer, and OAuth 2 authentication flows to secure API access.
- Persisted Operation Registries - Accepts only pre-registered GraphQL operations from first-party clients for safe schema evolution.
- Interactive Explorers - Ships an interactive IDE for exploring, testing, and debugging GraphQL APIs with syntax highlighting.
- GraphQL Schema Fluent APIs - Constructs GraphQL types and fields programmatically using a C# descriptor API, decoupling schema from domain models.
- GraphQL Query Editors - Builds and runs GraphQL queries and mutations with syntax highlighting and auto-completion in an intuitive editor.
- Typed .NET Clients - Generates typed C# .NET clients from GraphQL queries with reactive state management and data caching.
- Schema Explorers - Visualizes and navigates GraphQL schema structures through an intuitive interface.
- Version Registries - Stores, versions, and tracks GraphQL schema changes with client impact analysis in a centralized registry.
- Reactive State Management - Provides reactive APIs that automatically update the UI when underlying GraphQL data changes.
- Real-Time Data Streaming - Pushes live data updates to clients via WebSocket or Server-Sent Events for subscription-based workflows.
- Request Deduplication - Merges concurrent requests for the same key so the data source is queried only once per batch.
- Ordered Middleware Pipelines - Processes GraphQL requests through a configurable chain of middleware for authentication and validation.
- API Development - Feature-rich GraphQL server for .NET.
- NET GraphQL Tools - GraphQL server for .NET Core and Framework.
