- Release v1.0.0

Author: NinjaRocks

docs/SourceFlow.Net-README.md

@@ -293,7 +293,7 @@ public class TransactionHistoryViewModel : IViewModel
 
 ### 6. Implement Views for Event Projections
 
-**Enhanced Feature: Store operations now return the persisted entity**, which can be useful when the store modifies the entity (e.g., sets database-generated IDs or updates timestamps). Views serve as **Event Subscribers** that project events into view models for efficient querying.
+**Views** serve as **Event Subscribers** that project events into view models for efficient querying.
 
 ```csharp
 using SourceFlow.Projections;
@@ -561,7 +561,7 @@ public class BankingService
 
 ## 🏗️ Architecture Flow
 
-<img width="1959" height="649" alt="Architecture" src="https://github.com/user-attachments/assets/3ceb5df2-f01c-4316-829a-0350b399cba2" />
+> Please see [Readme](https://github.com/CodeShayk/SourceFlow.Net/blob/master/README.md) to get a detailed view on Architecture and its components.
 
 ---
 
@@ -624,7 +624,6 @@ The Entity Framework provider offers:
 - Resilience policies with automatic retry and circuit breaker
 - OpenTelemetry integration for database operations
 - Configurable connection strings per store type
-- **Enhanced Return Types**: Store operations return the persisted entity for additional processing
 
 Install with:
 ```bash
@@ -682,8 +681,8 @@ services.AddLogging(configure => configure.AddConsole().SetMinimumLevel(LogLevel
 
 - **Full Documentation**: [GitHub Wiki](https://github.com/CodeShayk/SourceFlow.Net/wiki)
 - **API Reference**: [NuGet Package Documentation](https://www.nuget.org/packages/SourceFlow.Net)
-- **Release Notes**: [CHANGELOG](../CHANGELOG.md)
-- **Architecture Patterns**: [Design Patterns Guide](https://github.com/CodeShayk/SourceFlow.Net/wiki/Architecture-Patterns)
+- **Release Notes**: [CHANGELOG](https://github.com/CodeShayk/SourceFlow.Net/blob/v1.0.0/CHANGELOG.md)
+- **Architecture Patterns**: [Design Patterns Guide](https://github.com/CodeShayk/SourceFlow.Net/wiki#architecture-overview)
 
 ## 🤝 Contributing
 

docs/SourceFlow.Stores.EntityFramework-README.md

@@ -124,7 +124,7 @@ The provider includes built-in Polly resilience policies for:
 - [Full Documentation](https://github.com/CodeShayk/SourceFlow.Net/wiki)
 - [GitHub Repository](https://github.com/CodeShayk/SourceFlow.Net)
 - [Report Issues](https://github.com/CodeShayk/SourceFlow.Net/issues)
-- [Release Notes](https://github.com/CodeShayk/SourceFlow.Net/blob/master/CHANGELOG.md)
+- [Release Notes](https://github.com/CodeShayk/SourceFlow.Net/blob/v1.0.0/CHANGELOG.md)
 
 ## Support
 

src/SourceFlow.Net.EntityFramework/SourceFlow.Stores.EntityFramework.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <TargetFrameworks>net8.0;net9.0;net10.0</TargetFrameworks>
@@ -14,6 +14,7 @@
     <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
     <Description>Entity Framework Core persistence provider for SourceFlow.Net. Provides production-ready implementations of ICommandStore, IEntityStore, and IViewModelStore using Entity Framework Core 9.0. Features include flexible configuration with separate or shared connection strings per store type, SQL Server support, Polly-based resilience and retry policies, OpenTelemetry instrumentation for database operations, and full support for .NET 8.0, .NET 9.0, and .NET 10.0. Seamlessly integrates with SourceFlow.Net core framework for complete event sourcing persistence.</Description>
     <Copyright>Copyright (c) 2025 CodeShayk</Copyright>
+    <PackageIcon>ninja-icon-16.png</PackageIcon>
     <PackageReadmeFile>docs\SourceFlow.Stores.EntityFramework-README.md</PackageReadmeFile>
     <AssemblyVersion>1.0.0</AssemblyVersion>
     <FileVersion>1.0.0</FileVersion>
@@ -24,6 +25,7 @@
     <LangVersion>latest</LangVersion>
     <AssemblyName>SourceFlow.Stores.EntityFramework</AssemblyName>
     <AssemblyTitle>SourceFlow.Stores.EntityFramework</AssemblyTitle>
+    <PackageLicenseFile>LICENSE</PackageLicenseFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -50,6 +52,14 @@
       <Pack>True</Pack>
       <PackagePath>\docs</PackagePath>
     </None>
+    <None Include="..\..\Images\ninja-icon-16.png">
+      <Pack>True</Pack>
+      <PackagePath>\</PackagePath>
+    </None>
+    <None Include="..\..\LICENSE">
+      <Pack>True</Pack>
+      <PackagePath>\</PackagePath>
+    </None>
   </ItemGroup>
 
 </Project>

src/SourceFlow/Projections/View.cs

@@ -59,22 +59,22 @@ async Task IView.Apply<TEvent>(TEvent @event)
         /// <summary>
         /// Finds the view model by identifier.
         /// </summary>
-        /// <typeparam name="TViewModel"></typeparam>
+        /// <typeparam name="TModel"></typeparam>
         /// <param name="id"></param>
         /// <returns></returns>
-        protected Task<TViewModel> Find<TViewModel>(int id) where TViewModel : class, IViewModel
+        protected Task<TModel> Find<TModel>(int id) where TModel : class, IViewModel
         {
-            return viewModelStore.Find<TViewModel>(id);
+            return viewModelStore.Find<TModel>(id);
         }
         /// <summary>
         /// Projects the specified view model.
         /// </summary>
-        /// <typeparam name="TViewModel"></typeparam>
+        /// <typeparam name="TModel"></typeparam>
         /// <param name="viewModel"></param>
         /// <returns>The persisted view model</returns>
-        protected Task<TViewModel> Persist<TViewModel>(TViewModel viewModel) where TViewModel : class, IViewModel
+        protected Task<TModel> Persist<TModel>(TModel viewModel) where TModel : class, IViewModel
         {
-            return viewModelStore.Persist<TViewModel>(viewModel);
+            return viewModelStore.Persist<TModel>(viewModel);
         }
     }
 }

tests/SourceFlow.Core.Tests/E2E/E2E.Tests.cs

@@ -74,9 +74,9 @@ public async Task EndToEnd_AccountLifecycle_WorksAsExpected()
             // Get current state and assertions
             var account = await _viewRepository.Find<AccountViewModel>(_accountId);
             Assert.That(account, Is.Not.Null);
-            Assert.That(_accountId, Is.EqualTo(account.Id));
-            Assert.That("John Doe", Is.EqualTo(account.AccountName));
-            Assert.That(1000m + 500m - 200m + 100m, Is.EqualTo(account.CurrentBalance));
+            Assert.That(account.Id, Is.EqualTo(_accountId));
+            Assert.That(account.AccountName, Is.EqualTo("John Doe"));
+            Assert.That(account.CurrentBalance, Is.EqualTo(1000m + 500m - 200m + 100m));
             Assert.That(account.TransactionCount, Is.GreaterThanOrEqualTo(3));
             Assert.That(account.IsClosed, Is.False);
 

tests/SourceFlow.Core.Tests/Impl/AggregateFactoryTests.cs

@@ -24,7 +24,7 @@ public async Task Create_ReturnsAggregateInstance()
             var factory = new AggregateFactory(spMock.Object);
             var result = await factory.Create<IAggregate>();
             Assert.IsNotNull(result);
-            Assert.AreSame(aggregateMock.Object, result);
+            Assert.That(result, Is.SameAs(aggregateMock.Object));
         }
     }
 }

tests/SourceFlow.Core.Tests/Interfaces/IViewModelRepositoryTests.cs

@@ -15,7 +15,7 @@ public async Task GetByIdAsync_ReturnsModel()
             mock.Setup(r => r.Find<DummyViewModel>(1)).ReturnsAsync(new DummyViewModel { Id = 1 });
             var result = await mock.Object.Find<DummyViewModel>(1);
             Assert.That(result, Is.Not.Null);
-            Assert.That(1, Is.EqualTo(result.Id));
+            Assert.That(result.Id, Is.EqualTo(1));
         }
 
         [Test]

tests/SourceFlow.Core.Tests/Messaging/CommandTests.cs

@@ -24,8 +24,8 @@ public void Constructor_InitializesProperties()
             var payload = new DummyPayload { EntityId = 42 };
             var command = new DummyCommand(42, payload);
             Assert.IsNotNull(command.Metadata);
-            Assert.AreEqual("DummyCommand", command.Name);
-            Assert.AreSame(payload, command.Payload);
+            Assert.That(command.Name, Is.EqualTo("DummyCommand"));
+            Assert.That(command.Payload, Is.SameAs(payload));
         }
 
         [Test]
@@ -34,8 +34,8 @@ public void ICommandPayload_GetSet_WorksCorrectly()
             var payload = new DummyPayload { EntityId = 7 };
             var command = new DummyCommand(7, new DummyPayload());
             ((ICommand)command).Payload = payload;
-            Assert.AreSame(payload, command.Payload);
-            Assert.AreSame(payload, ((ICommand)command).Payload);
+            Assert.That(command.Payload, Is.SameAs(payload));
+            Assert.That(((ICommand)command).Payload, Is.SameAs(payload));
         }
     }
 }

tests/SourceFlow.Core.Tests/Messaging/EventTests.cs

@@ -23,8 +23,8 @@ public void Constructor_InitializesProperties()
             var payload = new DummyEntity { Id = 99 };
             var ev = new DummyEvent(payload);
             Assert.IsNotNull(ev.Metadata);
-            Assert.AreEqual("DummyEvent", ev.Name);
-            Assert.AreSame(payload, ev.Payload);
+            Assert.That(ev.Name, Is.EqualTo("DummyEvent"));
+            Assert.That(ev.Payload, Is.SameAs(payload));
         }
 
         [Test]
@@ -33,8 +33,8 @@ public void IEventPayload_GetSet_WorksCorrectly()
             var payload = new DummyEntity { Id = 123 };
             var ev = new DummyEvent(new DummyEntity());
             ((IEvent)ev).Payload = payload;
-            Assert.AreSame(payload, ev.Payload);
-            Assert.AreSame(payload, ((IEvent)ev).Payload);
+            Assert.That(ev.Payload, Is.SameAs(payload));
+            Assert.That(((IEvent)ev).Payload, Is.SameAs(payload));
         }
     }
 }

tests/SourceFlow.Core.Tests/Messaging/MetadataTests.cs

@@ -9,7 +9,7 @@ public class MetadataTests
         public void Constructor_InitializesProperties()
         {
             var metadata = new Metadata();
-            Assert.AreNotEqual(Guid.Empty, metadata.EventId);
+            Assert.That(metadata.EventId, Is.Not.EqualTo(Guid.Empty));
             Assert.That(metadata.OccurredOn, Is.Not.EqualTo(default(DateTime)));
             Assert.IsFalse(metadata.IsReplay);
             Assert.IsNotNull(metadata.Properties);
@@ -27,11 +27,11 @@ public void Properties_CanBeSetAndGet()
             metadata.OccurredOn = now;
             metadata.SequenceNo = 42;
             metadata.Properties["foo"] = 123;
-            Assert.AreEqual(guid, metadata.EventId);
+            Assert.That(metadata.EventId, Is.EqualTo(guid));
             Assert.IsTrue(metadata.IsReplay);
-            Assert.AreEqual(now, metadata.OccurredOn);
-            Assert.AreEqual(42, metadata.SequenceNo);
-            Assert.AreEqual(123, metadata.Properties["foo"]);
+            Assert.That(metadata.OccurredOn, Is.EqualTo(now));
+            Assert.That(metadata.SequenceNo, Is.EqualTo(42));
+            Assert.That(metadata.Properties["foo"], Is.EqualTo(123));
         }
     }
 }