V2.0/release #144

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

eneshoxha merged 16 commits into v2/main from v2.0/release

Oct 10, 2025

Cortex.sln

-Original file line number
+Diff line change
@@ -1,4 +1,3 @@
     Microsoft Visual Studio Solution File, Format Version 12.00
     # Visual Studio Version 17
     VisualStudioVersion = 17.10.34607.79
@@ Expand Down Expand Up @@
     EndProject
     Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Cortex.Types", "src\Cortex.Types\Cortex.Types.csproj", "{64E12D4C-FBB2-4004-8316-C886CBFC614B}"
     EndProject
+    Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Cortex.Vectors", "src\Cortex.Vectors\Cortex.Vectors.csproj", "{268BA5C7-C6FB-4A6B-875A-492659ED4573}"
+    EndProject
+    Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Cortex.Mediator.Behaviors.FluentValidation", "src\Cortex.Mediator.Behaviors.FluentValidation\Cortex.Mediator.Behaviors.FluentValidation.csproj", "{44A166BD-01E9-4A4B-9BC5-7DE01B472E73}"
+    EndProject
     Global
     	GlobalSection(SolutionConfigurationPlatforms) = preSolution
     		Debug|Any CPU = Debug|Any CPU
@@ Expand Down Expand Up / @@ -170,6 +173,14 @@ Global @@
     		{64E12D4C-FBB2-4004-8316-C886CBFC614B}.Debug|Any CPU.Build.0 = Debug|Any CPU
     		{64E12D4C-FBB2-4004-8316-C886CBFC614B}.Release|Any CPU.ActiveCfg = Release|Any CPU
     		{64E12D4C-FBB2-4004-8316-C886CBFC614B}.Release|Any CPU.Build.0 = Release|Any CPU
+    		{268BA5C7-C6FB-4A6B-875A-492659ED4573}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+    		{268BA5C7-C6FB-4A6B-875A-492659ED4573}.Debug|Any CPU.Build.0 = Debug|Any CPU
+    		{268BA5C7-C6FB-4A6B-875A-492659ED4573}.Release|Any CPU.ActiveCfg = Release|Any CPU
+    		{268BA5C7-C6FB-4A6B-875A-492659ED4573}.Release|Any CPU.Build.0 = Release|Any CPU
+    		{44A166BD-01E9-4A4B-9BC5-7DE01B472E73}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+    		{44A166BD-01E9-4A4B-9BC5-7DE01B472E73}.Debug|Any CPU.Build.0 = Debug|Any CPU
+    		{44A166BD-01E9-4A4B-9BC5-7DE01B472E73}.Release|Any CPU.ActiveCfg = Release|Any CPU
+    		{44A166BD-01E9-4A4B-9BC5-7DE01B472E73}.Release|Any CPU.Build.0 = Release|Any CPU
     	EndGlobalSection
     	GlobalSection(SolutionProperties) = preSolution
     		HideSolutionNode = FALSE
@@ Expand Down @@

README.md

-Original file line number
+Diff line change
@@ Expand Up / @@ -26,6 +26,7 @@ @@
     ## Use Cases
     - Real-time analytics and monitoring
     - Event-driven architectures
     - Stateful stream processing (e.g., aggregations, joins)
@@ Expand Down Expand Up / @@ -122,6 +123,12 @@ @@
     - **Cortex.Mediator:** implementation of the Mediator pattern for .NET applications, designed to power clean, modular architectures like **Vertical Slice Architecture** and **CQRS**.
     [![NuGet Version](https://img.shields.io/nuget/v/Cortex.Mediator?label=Cortex.Mediator)](https://www.nuget.org/packages/Cortex.Mediator)
+    - **Cortex.Mediator.Behaviors.FluentValidation:** implementation of the FluentValidation validation for Commands and Queries
+    [![NuGet Version](https://img.shields.io/nuget/v/Cortex.Mediator.Behaviors.FluentValidation?label=Cortex.Mediator.Behaviors.FluentValidation)](https://www.nuget.org/packages/Cortex.Mediator.Behaviors.FluentValidation)
+    - **Cortex.Vectors:** is a High‑performance vector types—Dense, Sparse, and Bit—for AI.
+    [![NuGet Version](https://img.shields.io/nuget/v/Cortex.Vectors?label=Cortex.Vectors)](https://www.nuget.org/packages/Cortex.Vectors)
     ## Getting Started
@@ Expand Down @@

src/Cortex.Mediator.Behaviors.FluentValidation/Assets/andyX.png

Sorry, something went wrong. Reload?

Sorry, we cannot display this file.

Sorry, this file is invalid so it cannot be displayed.

src/Cortex.Mediator.Behaviors.FluentValidation/Assets/license.md

-Original file line number
+Diff line change
@@ -0,0 +1,20 @@
+    The MIT License (MIT)
+    Copyright (c) 2025 Buildersoft
+    Permission is hereby granted, free of charge, to any person obtaining a copy of
+    this software and associated documentation files (the "Software"), to deal in
+    the Software without restriction, including without limitation the rights to
+    use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+    the Software, and to permit persons to whom the Software is furnished to do so,
+    subject to the following conditions:
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+    FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+    COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+    IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+    CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

...tex.Mediator.Behaviors.FluentValidation/Cortex.Mediator.Behaviors.FluentValidation.csproj

-Original file line number
+Diff line change
@@ -0,0 +1,72 @@
+    <Project Sdk="Microsoft.NET.Sdk">
+    	<PropertyGroup>
+    		<TargetFrameworks>net9;net8;net7;netstandard2.1</TargetFrameworks>
+    		<AssemblyVersion>1.0.0</AssemblyVersion>
+    		<FileVersion>1.0.0</FileVersion>
+    		<Product>Buildersoft Cortex Framework</Product>
+    		<Company>Buildersoft</Company>
+    		<LangVersion>12</LangVersion>
+    		<Authors>Buildersoft,EnesHoxha</Authors>
+    		<Copyright>Copyright © Buildersoft 2025</Copyright>
+    		<Description>
+    			Buildersoft Cortex Mediator is a library for .NET applications that implements the mediator pattern. It helps to reduce dependencies between objects by allowing in-process messaging without direct communication. Instead, objects communicate through Cortex Mediator, making them less coupled and more maintainable..
+    		</Description>
+    		<RepositoryUrl>https://github.com/buildersoftio/cortex</RepositoryUrl>
+    		<PackageTags>cortex vortex mediator eda cqrs streaming</PackageTags>
+    		<Version>1.0.0</Version>
+    		<PackageLicenseFile>license.md</PackageLicenseFile>
+    		<PackageIcon>andyX.png</PackageIcon>
+    		<PackageId>Cortex.Mediator.Behaviors.FluentValidation</PackageId>
+    		<GeneratePackageOnBuild>True</GeneratePackageOnBuild>
+    		<IsPublishable>True</IsPublishable>
+    		<PackageRequireLicenseAcceptance>True</PackageRequireLicenseAcceptance>
+    		<RepositoryType></RepositoryType>
+    		<PackageReleaseNotes>Just as the Cortex in our brains handles complex processing efficiently, Cortex Data Framework brings brainpower to your data management!	</PackageReleaseNotes>
+    		<PackageProjectUrl>https://buildersoft.io/</PackageProjectUrl>
+    		<Title>Cortex Mediator Behaviors FluentValidation</Title>
+    		<PackageReadmeFile>README.md</PackageReadmeFile>
+    	</PropertyGroup>
+    	<ItemGroup>
+    		<None Remove="README.md" />
+    	</ItemGroup>
+    	<ItemGroup>
+    		<Content Include="README.md">
+    			<Pack>True</Pack>
+    			<PackagePath>\</PackagePath>
+    			<CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    		</Content>
+    	</ItemGroup>
+    	<ItemGroup>
+    		<None Include="Assets\andyX.png">
+    			<Pack>True</Pack>
+    			<PackagePath></PackagePath>
+    		</None>
+    		<None Include="Assets\license.md">
+    			<Pack>True</Pack>
+    			<PackagePath></PackagePath>
+    		</None>
+    	</ItemGroup>
+    	<ItemGroup>
+    		<Folder Include="Assets\" />
+    	</ItemGroup>
+    	<ItemGroup>
+    		<ProjectReference Include="..\Cortex.Mediator\Cortex.Mediator.csproj" />
+    	</ItemGroup>
+    	<ItemGroup>
+    		<PackageReference Include="FluentValidation" Version="11.11.0" />
+    		<PackageReference Include="FluentValidation.DependencyInjectionExtensions" Version="11.11.0" />
+    	</ItemGroup>
+    </Project>

src/Cortex.Mediator.Behaviors.FluentValidation/README.md

-Original file line number
+Diff line change
@@ -0,0 +1,181 @@
+    # Cortex.Mediator 🧠
+    **Cortex.Mediator** is a lightweight and extensible implementation of the Mediator pattern for .NET applications, designed to power clean, modular architectures like **Vertical Slice Architecture** and **CQRS**.
+    Built as part of the [Cortex Data Framework](https://github.com/buildersoftio/cortex), this library simplifies command and query handling with built-in support for:
+    - ✅ Commands & Queries
+    - ✅ Notifications (Events)
+    - ✅ Pipeline Behaviors
+    - ✅ FluentValidation
+    - ✅ Logging
+    ---
+    [![GitHub License](https://img.shields.io/github/license/buildersoftio/cortex)](https://github.com/buildersoftio/cortex/blob/master/LICENSE)
+    [![NuGet Version](https://img.shields.io/nuget/v/Cortex.Mediator?label=Cortex.Mediator)](https://www.nuget.org/packages/Cortex.Mediator)
+    [![GitHub contributors](https://img.shields.io/github/contributors/buildersoftio/cortex)](https://github.com/buildersoftio/cortex)
+    [![Discord Shield](https://discord.com/api/guilds/1310034212371566612/widget.png?style=shield)](https://discord.gg/JnMJV33QHu)
+    ## 🚀 Getting Started
+    ### Install via NuGet
+    ```bash
+    dotnet add package Cortex.Mediator
+    ```
+    ## 🛠️ Setup
+    In `Program.cs` or `Startup.cs`:
+    ```csharp
+    builder.Services.AddCortexMediator(
+        builder.Configuration,
+        new[] { typeof(Program) }, // Assemblies to scan for handlers
+        options => options.AddDefaultBehaviors() // Logging
+    );
+    ```
+    ## 📦 Folder Structure Example (Vertical Slice)
+    ```bash
+    Features/
+      CreateUser/
+        CreateUserCommand.cs
+        CreateUserCommandHandler.cs
+        CreateUserValidator.cs
+        CreateUserEndpoint.cs
+    ```
+    ## ✏️ Defining a Command
+    ```csharp
+    public class CreateUserCommand : ICommand<Guid>
+    {
+        public string UserName { get; set; }
+        public string Email { get; set; }
+    }
+    ```
+    ### Handler
+    ```csharp
+    public class CreateUserCommandHandler : ICommandHandler<CreateUserCommand,Guid>
+    {
+        public async Task<Guid> Handle(CreateUserCommand command, CancellationToken cancellationToken)
+        {
+            // Logic here
+        }
+    }
+    ```
+    ### Validator (Optional, via FluentValidation) - Coming in the next release v1.8
+    ```csharp
+    public class CreateUserValidator : AbstractValidator<CreateUserCommand>
+    {
+        public CreateUserValidator()
+        {
+            RuleFor(x => x.UserName).NotEmpty();
+            RuleFor(x => x.Email).NotEmpty().EmailAddress();
+        }
+    }
+    ```
+    ---
+    ## 🔍 Defining a Query
+    ```csharp
+    public class GetUserQuery : IQuery<GetUserResponse>
+    {
+        public int UserId { get; set; }
+    }
+    ```
+    ```csharp
+    public class GetUserQueryHandler : IQueryHandler<GetUserQuery, GetUserResponse>
+    {
+        public async Task<GetUserResponse> Handle(GetUserQuery query, CancellationToken cancellationToken)
+        {
+            return new GetUserResponse { UserId = query.UserId, UserName = "Andy" };
+        }
+    }
+    ```
+    ## 📢 Notifications (Events)
+    ```csharp
+    public class UserCreatedNotification : INotification
+    {
+        public string UserName { get; set; }
+    }
+    public class SendWelcomeEmailHandler : INotificationHandler<UserCreatedNotification>
+    {
+        public async Task Handle(UserCreatedNotification notification, CancellationToken cancellationToken)
+        {
+            // Send email...
+        }
+    }
+    ```
+    ```csharp
+    await mediator.PublishAsync(new UserCreatedNotification { UserName = "Andy" });
+    ```
+    ## 🔧 Pipeline Behaviors (Built-in)
+    Out of the box, Cortex.Mediator supports:
+    - `ValidationCommandBehavior`  - Coming in the next release v1.8
+    - `LoggingCommandBehavior`
+    You can also register custom behaviors:
+    ```csharp
+    options.AddOpenCommandPipelineBehavior(typeof(MyCustomBehavior<>));
+    ```
+    ## 💬 Contributing
+    We welcome contributions from the community! Whether it's reporting bugs, suggesting features, or submitting pull requests, your involvement helps improve Cortex for everyone.
+    ### 💬 How to Contribute
+. **Fork the Repository**
+. **Create a Feature Branch**
+    ```bash
+    git checkout -b feature/YourFeature
+    ```
+. **Commit Your Changes**
+    ```bash
+    git commit -m "Add your feature"
+    ```
+. **Push to Your Fork**
+    ```bash
+    git push origin feature/YourFeature
+    ```
+. **Open a Pull Request**
+    Describe your changes and submit the pull request for review.
+    ## 📄 License
+    This project is licensed under the MIT License.
+    ## 📚 Sponsorship
+    Cortex is an open-source project maintained by BuilderSoft. Your support helps us continue developing and improving Cortex. Consider sponsoring us to contribute to the future of resilient streaming platforms.
+    ### How to Sponsor
+    * **Financial Contributions**: Support us through [GitHub Sponsors](https://github.com/sponsors/buildersoftio) or other preferred platforms.
+    * **Corporate Sponsorship**: If your organization is interested in sponsoring Cortex, please contact us directly.
+    Contact Us: cortex@buildersoft.io
+    ## Contact
+    We'd love to hear from you! Whether you have questions, feedback, or need support, feel free to reach out.
+    - Email: support@buildersoft.io
+    - Website: https://buildersoft.io
+    - GitHub Issues: [Cortex Data Framework Issues](https://github.com/buildersoftio/cortex/issues)
+    - Join our Discord Community: [![Discord Shield](https://discord.com/api/guilds/1310034212371566612/widget.png?style=shield)](https://discord.gg/JnMJV33QHu)
+    Thank you for using Cortex Data Framework! We hope it empowers you to build scalable and efficient data processing pipelines effortlessly.
+    Built with ❤️ by the Buildersoft team.

src/Cortex.Mediator.Behaviors.FluentValidation/ValidationCommandBehavior.cs

-Original file line number
+Diff line change
@@ -0,0 +1,43 @@
+    using Cortex.Mediator.Commands;
+    using FluentValidation;
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Threading;
+    using System.Threading.Tasks;
+    namespace Cortex.Mediator.Behaviors
+    {
+        /// <summary>
+        /// Pipeline behavior for validation command execution.
+        /// </summary>
+        public sealed class ValidationCommandBehavior<TCommand, TResult> : ICommandPipelineBehavior<TCommand, TResult>
+            where TCommand : ICommand<TResult>
+        {
+            private readonly IEnumerable<IValidator<TCommand>> _validators;
+            public async Task<TResult> Handle(TCommand command, CommandHandlerDelegate<TResult> next, CancellationToken cancellationToken)
+            {
+                var context = new ValidationContext<TCommand>(command);
+                var failures = _validators
+                    .Select(v => v.Validate(context))
+                    .SelectMany(r => r.Errors)
+                    .Where(f => f != null)
+                    .ToList();
+                if (failures.Count() > 0)
+                {
+                    var errors = failures
+                        .GroupBy(f => f.PropertyName)
+                        .ToDictionary(
+                            g => g.Key,
+                            g => g.Select(f => f.ErrorMessage).ToArray());
+                    throw new Exceptions.ValidationException(errors);
+                }
+                return await next();
+            }
+        }
+    }

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

V2.0/release #144

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!