Merhaba; Geliştirdiğim bir kütüphaneyi sizlerle paylaşmak istedim.

.NET ekosisteminde CQRS ve mediator pattern denildiğinde akla gelen ilk kütüphanelerden biri uzun süredir MediatR idi. Ancak son dönemde yaşanan iki önemli gelişme, birçok geliştirici ve ekip için alternatif arayışını zorunlu hale getirdi:

MediatR artık commercial lisans ile sunuluyor.
Runtime reflection kullanımı, yüksek performans gerektiren senaryolarda ve AOT (Ahead-of-Time) derleme hedeflerinde sorun yaratabiliyor.

Bu motivasyonlarla yola çıkarak geliştirdiğimiz Ergosfare, hem açık kaynak dünyasına dost, hem de performans odaklı bir mediation kütüphanesi olarak doğdu.

Neden Ergosfare?

Ergosfare, komut (command) ve mesaj (message) akışını yöneten, güçlü tip güvenliğine sahip ve modern .NET uygulamalarına uygun bir yapı sunuyor. Hedefimiz, gereksiz karmaşıklıkları ortadan kaldırırken aynı zamanda esnek, hızlı ve geliştirici dostu bir çözüm sunmak.

Öne çıkan özellikler:

Tamamen açık kaynak — hiçbir lisans kısıtlaması yok.
Reflection-free tasarım — compile-time registration ile AOT dostu.
Covariance & Contravariance desteği — daha esnek handler atamaları.
Modüler mimari — Command, Query, Event modülleri bağımsız eklenebilir.
Microsoft.Extensions.DependencyInjection ile tam uyum — mevcut DI altyapınıza kolayca entegre olur.
Hiçbir dış bağımlılık gerektirmez — ihtiyaç duyduğunuz DI altyapısını kendiniz seçebilirsiniz.

MediatR’a Göre Farklılıklarımız

| Özellik-------------------------------- | MediatR ------------------- | Ergosfare -------------- ------------------ |
| ---------------------------------------| ------------------------------| ------------------------------------------ --|
| Lisans --------------------------------| Commercia (ucretlı)-------- | MIT (acık kaynak ve bedava)------------ |
| Reflection kullanımı -----------------| Var (runtime)--------------- | Yok (compile-time registration) --------- |
| Covariance/Contravariance desteği-| Sınırlı------------------------| Tam destek ------------------------------- |
| Performans---------------------- ----| Orta (reflection overhead)- | Yüksek (doğrudan delegate çağrıları)--- |
| AOT uyumu--------------------------| Kısıtlı-------------------------| Tam uyumlu ----------------------------- |

Proje Modülerliği ve Katmanlar

Ergosfare, tamamen modüler bir yapıda tasarlanmıştır. Projenin farklı parçaları, bağımsız modüller halinde organize edilmiştir ve her modülün kendi abstractions (soyutlama) katmanı bulunmaktadır. Örnek modül yapısı şu şekildedir:

Ergosfare
Ergosfare.Messaging
Ergosfare.Messaging.Abstractions
Ergosfare.Messaging.Extensions.DependencyInjection
Ergosfare.Commands
Ergosfare.Commands.Abstractions
(Ve benzer şekilde diğer modüller…)

Bazı geliştiriciler, soyutlamaları ayrı projelerde tutmayı tercih eder. Bu sayede:

Contractlar (arayüzler, mesaj tipleri) bağımsız kalır, farklı projelerde referans alınabilir.
Gerçek implementasyonlar ve bağımlılıklar ayrı tutulur, böylece bağımlılık yönetimi daha temiz olur.
Büyük ve karmaşık projelerde katmanlar arası bağımlılıkların sınırlandırılması kolaylaşır.

Ergosfare, bu yaklaşıma doğal destek sağlar. İster tüm modülleri tek projede kullanın, ister abstractions katmanlarını farklı projelerde tanımlayın, yapı esnekliğini korur.

Kullanım Örneği

public record CreateProductCommand(string Name) : ICommand<Guid>;

public class CreateProductHandler : ICommandHandler<CreateProductCommand, Guid>
{
    public Task<Guid> HandleAsync(CreateProductCommand command, CancellationToken cancellationToken)
    {
        var id = Guid.NewGuid();
        Console.WriteLine($"Ürün oluşturuldu: {command.Name} (ID: {id})");
        return Task.FromResult(id);
    }
}

Kayıt ve çalıştırma:

var services = new ServiceCollection()
    .AddErgosfare(cfg => cfg.AddCommandModule(b => 
        b.RegisterFromAssembly(Assembly.GetExecutingAssembly())))
    .BuildServiceProvider();

var mediator = services.GetRequiredService<ICommandMediator>();
var id = await mediator.SendAsync(new CreateProductCommand("Laptop"));

Covariance & Contravariance Desteği

Ergosfare, covariant ve contravariant handler tiplerini doğal olarak destekler.
Bu sayede farklı ancak uyumlu tip hiyerarşilerinde tek handler ile birden fazla mesaj tipini işleyebilirsiniz.

Örneğin:

public interface IMessage<out TResponse> { }
public interface ICommand<out TResponse> : IMessage<TResponse> { }

Bu yapı, handler'ların tek bir generik parametreyle geniş bir mesaj ailesini işleyebilmesini sağlar.

Performans ve AOT Uyumu

Ergosfare, reflection-free tasarımı sayesinde Native AOT derlemelerde problemsiz çalışır. Handler kayıtları derleme zamanında yapılır, böylece runtime’da ekstra metadata taraması gerekmez.

Bu hem soğuk başlatma sürelerini iyileştirir, hem de CPU tüketimini azaltır.

Roadmap: Gelecek Planlarımız

Ergosfare sürekli gelişen, topluluk odaklı bir proje olarak, önümüzdeki dönemlerde aşağıdaki önemli özellikleri eklemeyi planlıyoruz:

1. Pre-Processing & Post-Processing Pipeline Adımları

Komut veya mesaj işlenmeden önce veya sonra çalışan interceptor’lar
Örneğin, logging, validation, caching, ya da audit işlemlerinin merkezi yönetimi
Hata yakalama ve özel hata yönetimi için esnek yapı

2. Error Processing (Hata İşleyiciler)

Handler çalışırken oluşan hataların merkezi yakalanması
Özelleştirilebilir retry ve fallback mekanizmaları
Hata türüne göre farklı stratejiler uygulama

3. Query Modülü

Okuma tarafı için optimize edilmiş, sorgu odaklı mesajlaşma
CQRS pattern’inin tam kapsamlı uygulanması
Performans ve ölçeklenebilirlik için özel sorgu handler’ları

4. Stream Modülü

Event sourcing ve reactive programming senaryoları için akış tabanlı mesajlaşma
IAsyncEnumerable ve Reactive Extensions (Rx) destekleri
Gerçek zamanlı veri akışı ve bildirimler

TL;DR — Neden isim olarak "Ergosfare"?

Ergosfare ismi, ergosphere (kara deliklerin etrafındaki enerji bölgesi) kelimesinden esinlenildi.
“Fare” kısmı ise hem Ingilizceki’deki yol geçit anlamı hem de “mesajları kara deliğin etrafından geçirerek” işleyen bir aracı metaforu olarak eklendi.
Yani Ergosfare, mesajların olay ufkuna girmeden güvenle iletilmesini sağlayan aracı gibi düşünebilirsiniz.

Özetle

Ergosfare, MediatR’a aşina olan herkesin kolayca adapte olabileceği, ancak lisans ve performans konusunda çağdaş gereksinimlere cevap veren bir kütüphane.
Özellikle lisans maliyeti istemeyen, AOT dostu, yüksek performanslı bir mediation çözümü arayan ekipler için güçlü ve ücretsiz (sonsuza kadar ücretsiz kalacak) bir alternatif.

Kaynak kodu & dokümantasyon:
Dökümantasyon henüz yapım aşamasında, ama kaynak kodları inceleyebilirsiniz.

Yorumlarınızı, katkılarınızı ve geri bildirimlerinizi bekliyoruz.