The PepperX Ecosystem

A suite of high-performance, enterprise-grade engines and tools for the .NET ecosystem.
Designed for easy, bulletproof security, and seamless integration.

🧩 The Tool Suite

PepperX is a modular ecosystem. Each tool is engineered to solve specific, complex enterprise challenges without relying on heavy, black-box third-party dependencies.

Package	Description	Status	NuGet
PepperX.QueryForge	Abstract, provider-agnostic foundation of the QueryForge ecosystem. It provides the core models, fluent builders, and bulletproof validation engines required to construct dynamic, paginated, and hierarchically grouped queries.	✅ Released
PepperX.QueryForge.Dapper	High-performance execution provider for the PepperX.QueryForge core library. It translates abstract query models into optimized SQL and executes them against Microsoft SQL Server using Dapper, 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

---

🏛️ Architecture & Philosophy

All libraries under the PepperX umbrella share a core set of engineering principles:

• 🛡️ Security by Default: Built-in validation engines (like SilentStrip) to prevent schema enumeration, data dumps, and malicious payloads.
• 🧩 Provider-Agnostic Cores: Define your intent once, execute it anywhere.
• 🔄 Automated CI/CD: All packages are built, tested, and published via GitHub Actions using OIDC Trusted Publishing.

---

📂 Repository Structure

This repository is an Umbrella Monorepo.

• /src: Contains the source code for all PepperX libraries. Each library folder contains its own dedicated README.md with deep-dive technical documentation, C# examples, and API references.
• /tests: Comprehensive xUnit test suites ensuring bulletproof reliability across all engines.
• /samples: Runnable ASP.NET Core Minimal API projects demonstrating real-world integration.

---

🤝 Contributing & License

Contributions, issues, and feature requests are welcome!

Unless otherwise specified, all packages in the PepperX ecosystem are licensed under the MIT License — see the LICENSE file for details.

_{Engineered with ❤️ and C# by Amir Hossein}