Refactor Email to EmailContext across codebase

Replaced the `Email` record with the new `EmailContext` record to introduce additional context and functionality in email handling. Updated property definitions to distinguish between .NET Framework (`set`) and other frameworks (`init`).

Modified `SendingEmailEvent` to use `EmailContext` for the `Mail` property. Updated mappings in `EmailMappingProfile` to map `SendEmailCommand` to `EmailContext`. Adjusted `SendEmailCommandHandler` to use `EmailContext` when mapping requests.

Refactored `EmailSender` to use `EmailContext` in its `Send` method, including updates to method signatures and documentation. Updated all related test classes (`EmailSenderTests`, `EmailSenderUrlOverloadTests`, `SendingEmailPublisherTests`) to validate the behavior of `EmailContext`, ensuring consistency and thorough testing of the transition.

These changes ensure compatibility across frameworks and improve the maintainability of the email handling process.

src/core/DigitalData.MessagingService.Abstraction/EmailContext.cs

@@ -1,6 +1,6 @@
 namespace DigitalData.MessagingService.Abstraction;
 
-public record Email
+public record EmailContext
 {
 #if NETFRAMEWORK
     public EmailAccountDto Sender { get; set; } = null!;

src/core/DigitalData.MessagingService.Abstraction/SendingEmailEvent.cs

@@ -9,9 +9,9 @@ public record SendingEmailEvent
 #endif
 
 #if NETFRAMEWORK
-    public Email Mail { get; set; } = null!;
+    public EmailContext Mail { get; set; } = null!;
 #else
-    public required Email Mail { get; init; }
+    public required EmailContext Mail { get; init; }
 #endif
 
 #if NETFRAMEWORK

src/core/DigitalData.MessagingService.Application/Common/Mappings/EmailMappingProfile.cs

@@ -13,6 +13,6 @@ public class EmailMappingProfile : Profile
     {
         // SendEmailCommand -> Email
         // Sender is resolved via MediatR in the handler and set separately after mapping.
-        CreateMap<SendEmailCommand, Email>();
+        CreateMap<SendEmailCommand, EmailContext>();
     }
 }

src/core/DigitalData.MessagingService.Application/EmailSending/Commands/SendEmailCommand.cs

@@ -46,7 +46,7 @@ public class SendEmailCommandHandler(ISender Sender, ISendingEmailPublisher Publ
             ?? throw new NotFoundException(
                 $"No email account found for the given sender criteria (Id: {request.Sender.Id}, Username: {request.Sender.Username}).");
 
-        var email = Mapper.Map<Email>(request) with { Sender = senderAccount };
+        var email = Mapper.Map<EmailContext>(request) with { Sender = senderAccount };
 
         // Enqueue to RabbitMQ
         var sendingEmailEvent = new SendingEmailEvent()

src/presentation/DigitalData.MessagingService.Client/EmailSender.cs

@@ -113,13 +113,13 @@ public static class EmailSender
     /// Thrown when <see cref="ConnectRabbitMq(Action{RabbitMqConfiguration}, OnReconnect)"/> has not been called prior to sending.
     /// </exception>
     /// <remarks>
-    /// This method maps <see cref="Email"/> to <see cref="SendingEmailEvent"/>,
+    /// This method maps <see cref="EmailContext"/> to <see cref="SendingEmailEvent"/>,
     /// then resolves <see cref="ISendingEmailPublisher"/> from the internal
     /// service provider and calls <c>EnqueueAsync</c> in a fire-and-forget manner.
     /// Ensure that any unhandled exceptions from the async operation are handled
     /// at the publisher level.
     /// </remarks>
-    public static void Send(Email email)
+    public static void Send(EmailContext email)
     {
         if(!IsConnected)
             throw new InvalidOperationException("Messaging service is not connected. Call ConnectRabbitMq first.");

tests/DigitalData.MessagingService.Tests/Integration/EmailSenderTests.cs

@@ -75,7 +75,7 @@ public sealed class EmailSenderTests
     [Fact]
     public void Send_WithValidEmail_DoesNotThrow()
     {
-        var email = new Email
+        var email = new EmailContext
         {
             Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
             Recipients = ["hakanttek@gmail.com"],
@@ -92,7 +92,7 @@ public sealed class EmailSenderTests
     [Fact]
     public void Send_WithPlainTextBody_DoesNotThrow()
     {
-        var email = new Email
+        var email = new EmailContext
         {
             Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
             Recipients = ["hakanttek@gmail.com"],

tests/DigitalData.MessagingService.Tests/Integration/EmailSenderUrlOverloadTests.cs

@@ -55,7 +55,7 @@ public sealed class EmailSenderUrlOverloadTests
     [Fact]
     public void Send_AfterUrlOverloadConnection_DoesNotThrow()
     {
-        var email = new Email
+        var email = new EmailContext
         {
             Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
             Recipients = ["url-overload-test@example.com"],

tests/DigitalData.MessagingService.Tests/Integration/SendingEmailPublisherTests.cs

@@ -37,7 +37,7 @@ public sealed class SendingEmailPublisherTests : IAsyncDisposable
         var email = new SendingEmailEvent
         {
             Id = Guid.NewGuid(),
-            Mail = new Email
+            Mail = new EmailContext
             {
                 Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
                 Recipients = ["test@example.com"],
@@ -66,7 +66,7 @@ public sealed class SendingEmailPublisherTests : IAsyncDisposable
         var emails = Enumerable.Range(1, 3).Select(i => new SendingEmailEvent
         {
             Id = Guid.NewGuid(),
-            Mail = new Email
+            Mail = new EmailContext
             {
                 Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
                 Recipients = new List<string> { $"recipient{i}@example.com" },
@@ -93,7 +93,7 @@ public sealed class SendingEmailPublisherTests : IAsyncDisposable
         var email = new SendingEmailEvent
         {
             Id = Guid.NewGuid(),
-            Mail = new Email
+            Mail = new EmailContext
             {
                 Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
                 Recipients = ["depth-test@example.com"],
@@ -120,7 +120,7 @@ public sealed class SendingEmailPublisherTests : IAsyncDisposable
         var email = new SendingEmailEvent
         {
             Id = id,
-            Mail = new Email
+            Mail = new EmailContext
             {
                 Sender = new EmailAccountDto { Username = "test@example.com", Password = "password", SmtpServer = "smtp.example.com" },
                 Recipients = new List<string> { "serialize@example.com" },