CQRSSharp (.NET 9+)

A lightweight CQRS (Command Query Responsibility Segregation) implementation built on top of a mediator-like dispatcher pattern for clean and scalable architecture in .NET 9+ projects.

📦 Installation

Install via NuGet:

dotnet add package CQRSSharp --version 1.0.0

---

🛠️ Project Structure

YourProject/ ├── Application/ │ ├── Commands/ │ │ └── CreateContactCommand.cs │ ├── Queries/ │ │ └── GetContactsQuery.cs │ ├── Handlers/ │ │ ├── CreateContactHandler.cs │ │ └── GetContactsHandler.cs │ └── Behaviors/ │ ├── RequestLoggingPipelineBehavior.cs │ └── EnrichResponseBehavior.cs ├── API/ │ └── Controllers/ │ └── ContactController.cs ├── Domain/ │ └── Interfaces/ │ └── IContactService.cs

---

🚀 Usage in Controller

[Route("api/contact")] [ApiController] public class ContactController(IDispatcher dispatcher) : ControllerBase { [Route("get-contacts")] [HttpGet] public async Task<IActionResult> GetContacts() { return Ok(await dispatcher.SendAsync(new GetContactsQuery { })); } }

---

🧠 Command Example

public class CreateContactCommand : IRequest<Result> { public string FirstName { get; set; } public string LastName { get; set; } public string Mobile { get; set; } public string? Email { get; set; } public string CountryCode { get; set; } }

---

🔍 Query Example

public class GetContactsQuery : IRequest<Result> { }

---

🎯 Handler Example

public class CreateContactHandler(IContactService contactService) : IRequestHandler<CreateContactCommand, Result> { public async Task<Result> HandleAsync(CreateContactCommand command, CancellationToken cancellationToken) { var result = await contactService.CreateContactsAsync(command); return Result.Success(result); } }

---

⚙️ Dependency Injection Configuration

public static void AddApplication(this IServiceCollection services) { services.AddCQRS(cfg => { cfg.RegisterServicesFromAssembly(Assembly.GetExecutingAssembly()); cfg.AddOpenBehavior(typeof(RequestLoggingPipelineBehavior<,>)); cfg.AddOpenBehavior(typeof(EnrichReponseBehavior<,>)); }); }

---

✅ Features

• Built-in dispatcher abstraction
• Clean command/query separation
• Simple configuration
• Supports pipeline behaviors (e.g., logging, response enrichment)
• Modular and extensible

🧾 License

This project is licensed under the MIT License.

---

👤 Author

Kishan Suthar