- release planning

Author: NinjaRocks

License.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2025 Code Shayk
+Copyright (c) 2026 Code Shayk
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

RELEASE.md

@@ -1,82 +1,56 @@
 # Release Notes - v5.0.0
 
 ## New Architecture
-
 ```
-Aggregate -> Interceptor -> Middleware -> Dispatcher -> Queue <- Listener -> Middleware -> Resolver -> Handler
+Aggregate → Interceptor → Middleware → Dispatcher → Queue ← Listener → Resolver → Handler
 ```
 
-### Components:
-
-1. **IEventMiddleware** - Custom plugins that run before/after dispatch and handling
-2. **IEventQueue** - In-flight non-persistent queue for events
-3. **IEventListener** - Listens to queue and triggers handling
-
 ## New Features
 
-### 1. Event Middleware
-
-Custom plugins that run at various points in the event pipeline:
-
+### 1. ISubscribes<TEvent>
+Aggregates can handle their own events:
 ```csharp
-public class MyMiddleware : IEventMiddleware
+public class OrderAggregate : Aggregate, ISubscribes<OrderPlaced>
 {
-    public Task<bool> OnDispatchingAsync(EventContext context) { ... }
-    public Task OnDispatchedAsync(EventContext context) { ... }
-    public Task<bool> OnHandlingAsync(EventContext context) { ... }
-    public Task OnHandledAsync(EventContext context) { ... }
+    public Task HandleAsync(OrderPlaced @event) => ...;
+    public void PlaceOrder(decimal amount) => Raise(new OrderPlaced());
 }
 ```
 
-**Registration:**
+### 2. AggregateFactory
+Multiple methods to create proxied aggregates:
 ```csharp
-services.AddDomainEvents(assembly);
-services.AddSingleton<IEventMiddleware, MyMiddleware>();
-```
+// Default constructor
+var order = await factory.CreateAsync<OrderAggregate>();
 
-### 2. Event Queue
+// With constructor arguments
+var order = await factory.CreateAsync<OrderAggregate>(logger);
 
-In-flight non-persistent queue for events:
-
-```csharp
-// Use default in-memory queue
-services.AddDomainEvents(assembly);
+// From service provider (auto-resolves deps)
+var order = await factory.CreateFromServiceProviderAsync<OrderAggregate>();
 
-// Or use custom queue
-services.AddSingleton<IEventQueue, MyCustomQueue>();
-
-// Process queue
-var dispatcher = serviceProvider.GetRequiredService<IEventDispatcher>();
-await dispatcher.ProcessQueueAsync();
+// Wrap existing instance
+var order = await factory.CreateFromInstanceAsync(existingOrder);
 ```
 
-### 3. Custom Dispatcher
-
-```csharp
-services.AddDomainEventsWithDispatcher<MyCustomDispatcher>(assembly);
-```
+### 3. Event Middleware (IEventMiddleware)
+Pipeline hooks: `OnDispatchingAsync`, `OnDispatchedAsync`, `OnHandlingAsync`, `OnHandledAsync`
 
-### 4. Standard EventInterceptor with Telemetry
-The `EventInterceptor` remains standard with OpenTelemetry and logging.
+### 4. Event Queue (IEventQueue)
+In-flight non-persistent queue with subscription support
 
-### 5. Async Handler Interface (IHandler<T>)
-Changed from `IHandle<T>` to `IHandler<T>` with async `HandleAsync()`.
+### 5. Event Listener (IEventListener)
+Processes queued events asynchronously
 
 ## Breaking Changes
+- `IHandle<T>` → `IHandler<T>`
+- `Handle()` → `HandleAsync()` returning `Task`
 
-1. `IHandle<T>` -> `IHandler<T>`
-2. `Handle()` -> `HandleAsync()` returning `Task`
-3. `EventInterceptor` requires `IEventDispatcher`
-
-## Migration Guide
-
+## Migration
 ```csharp
 // Before
 public class Handler : IHandle<Event> { void Handle(Event e) { } }
 
 // After
-public class Handler : IHandler<Event> 
-{ 
-    Task HandleAsync(Event e) => Task.CompletedTask; 
-}
+public class Handler : IHandler<Event> { Task HandleAsync(Event e) => Task.CompletedTask; }
 ```

src/DomainEvents/DomainEvents.csproj

@@ -16,7 +16,7 @@
     <PackageLicenseFile>License.md</PackageLicenseFile>
     <PackageRequireLicenseAcceptance>False</PackageRequireLicenseAcceptance>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-    <Title>DomainEvents</Title>
+    <Title>Domain Events</Title>
     <Authors>CodeShayk</Authors>
     <Company>CodeShayk</Company>
     <Product>DomainEvents</Product>
@@ -26,21 +26,17 @@
     <RepositoryUrl>https://github.com/CodeShayk/DomainEvents</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     <PackageTags>domain-events; domain-model, events; event-handling; c#; transactional-events; domain-pub/sub; event-pub-sub; ddd; aggregates; castle-dynamicproxy</PackageTags>
-    <Version>4.1.0</Version>
+    <Version>5.0.0</Version>
     <PackageIcon>pub-sub-icon.png</PackageIcon>
     <GenerateDocumentationFile>True</GenerateDocumentationFile>
     <PackageProjectUrl>https://github.com/CodeShayk/DomainEvents/wiki</PackageProjectUrl>
     <PackageReleaseNotes>
-      Release v4.2.0 - Updated all dependencies to latest stable versions
-      - OpenTelemetry.Api 1.11.2 -&gt; 1.15.0 (security fix for CVE-2025-27513)
-      - Castle.Core 5.1.1 -&gt; 5.2.1
-      - Microsoft.Extensions 9.0.0 -&gt; 10.0.5
-      - Targets .Net 10.0
-      - Target .Net 9.0
-      - Target .Net 8.0
-      - Target .Net Standard 2.1
-      - Target .Net Standard 2.0
+      Release v5.0.0 - Major update with new features, improvements, and bug fixes.
+      This release includes enhanced aggregate support, improved event handling performance, and better integration with Castle DynamicProxy.
+      For more details, see the release notes on GitHub: https://github.com/CodeShayk/DomainEvents/releases/tag/v5.0.0
     </PackageReleaseNotes>
+    <FileVersion>5.0.0</FileVersion>
+    <AssemblyVersion>5.0.0</AssemblyVersion>
   </PropertyGroup>
 
   <ItemGroup>

src/DomainEvents/assemblyinfo.cs

@@ -15,11 +15,11 @@
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Release")]
 [assembly: System.Reflection.AssemblyCopyrightAttribute("2026")]
 [assembly: System.Reflection.AssemblyDescriptionAttribute(".Net Library to implement transactional events in domain model.")]
-[assembly: System.Reflection.AssemblyFileVersionAttribute("4.1.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("4.1.0")]
+[assembly: System.Reflection.AssemblyFileVersionAttribute("5.0.0")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("5.0.0")]
 [assembly: System.Reflection.AssemblyProductAttribute("Dormito")]
 [assembly: System.Reflection.AssemblyTitleAttribute("DomainEvents")]
-[assembly: System.Reflection.AssemblyVersionAttribute("4.1.0")]
+[assembly: System.Reflection.AssemblyVersionAttribute("5.0.0")]
 [assembly: System.Reflection.AssemblyMetadataAttribute("RepositoryUrl", "https://github.com/Codeshayk/DomainEvents")]
 
 // Generated by the MSBuild WriteCodeFragment class.

version.json

@@ -17,5 +17,5 @@
   },
   "inherit": false,
   "publicReleaseRefSpec": [ "^refs/heads/master$" ],
-  "version": "4.1.0"
+  "version": "5.0.0"
 }