A high-performance, provider-agnostic query engine for the .NET ecosystem.
Build dynamic, paginated, and hierarchically grouped queries with a fluent API — execute anywhere.
QueryForge is a modular query engine. It decouples the intent of a query from its execution, allowing you to define your query once and run it against multiple data sources through different providers.
| Package | Description | Status | NuGet |
|---|---|---|---|
| PepperX.QueryForge | The abstract, provider-agnostic foundation of QueryForge. It provides the core models (Query), fluent builders, and bulletproof validation engines required to construct dynamic, paginated, and hierarchically grouped queries. |
✅ Released |  |
| PepperX.QueryForge.Dapper | High-performance execution provider for Dapper. Translates abstract query models into optimized SQL, seamlessly handling hierarchical grouping, complex filtering, and Stored Procedure/TVF integration. | ✅ Released |  |
| PepperX.QueryForge.EFCore | Entity Framework Core execution provider for QueryForge. | 🔧 Dev | Coming Soon |
| PepperX.QueryForge.InMemory | In-memory execution provider designed for IEnumerable based types without database dependencies. | 📋 Planned | Coming Soon |
QueryForge is built around a core set of engineering principles:
- 🛡️ Security by Default: Built-in validation engines (
SilentStriporThrowException) prevent schema enumeration, data dumps, and malicious payloads. - 🧩 Provider-Agnostic Core: Define your query intent once using the abstract
Querymodel, and execute it anywhere. - 🔄 Automated CI/CD: All packages are built, tested, and published via GitHub Actions using OIDC Trusted Publishing.
This repository is an Umbrella Monorepo.
/src: Contains the source code for all QueryForge libraries. Each library folder contains its own dedicatedREADME.mdwith deep-dive technical documentation, C# examples, and API references./tests: ComprehensivexUnittest suites ensuring bulletproof reliability across all engines./samples: Runnable ASP.NET Core Minimal API projects demonstrating real-world integration.
Contributions, issues, and feature requests are welcome!
Unless otherwise specified, all packages in QueryForge are licensed under the MIT License — see the LICENSE file for details.
Engineered with ❤️ and C# by PepperX-Dev