From 4a39e3f92b2472f786297c0869c2d5bc0035a5ce Mon Sep 17 00:00:00 2001
From: TekH <h.tek@digitaldata.works>
Date: Thu, 5 Nov 2026 09:44:59 +0100
Subject: [PATCH] feat(application): add ToSender helper for email accounts

Adds GetEmailAccountQueryExtensions.ToSender to build a sender query from an email address, and documents its use on PublishEmailViaSmtpCommand.Sender.
---
 .../Commands/GetEmailAccountQueryExtensions.cs   | 16 ++++++++++++++++
 .../Commands/PublishEmailViaSmtpCommand.cs       |  4 ++++
 2 files changed, 20 insertions(+)
 create mode 100644 src/core/DigitalData.MessagingService.Application/EmailSending/Commands/GetEmailAccountQueryExtensions.cs

diff --git a/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/GetEmailAccountQueryExtensions.cs b/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/GetEmailAccountQueryExtensions.cs
new file mode 100644
index 0000000..bb9c832
--- /dev/null
+++ b/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/GetEmailAccountQueryExtensions.cs
@@ -0,0 +1,16 @@
+#if NET
+using DigitalData.MessagingService.Application.EmailAccounts.Queries;
+
+namespace DigitalData.MessagingService.Application.EmailSending.Commands;
+
+public static class GetEmailAccountQueryExtensions
+{
+    public static GetEmailAccountQuery ToSender(string emailAddress)
+    {
+        return new GetEmailAccountQuery
+        {
+            Username = emailAddress
+        };
+    }
+}
+#endif
\ No newline at end of file
diff --git a/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/PublishEmailViaSmtpCommand.cs b/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/PublishEmailViaSmtpCommand.cs
index 9567939..091391f 100644
--- a/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/PublishEmailViaSmtpCommand.cs
+++ b/src/core/DigitalData.MessagingService.Application/EmailSending/Commands/PublishEmailViaSmtpCommand.cs
@@ -17,6 +17,10 @@ namespace DigitalData.MessagingService.Application.EmailSending.Commands;
 /// </summary>
 public record PublishEmailViaSmtpCommand : IRequest<Guid>
 {
+    /// <summary>
+    /// Specifies the sender's email account to resolve, identified by either its Id or Username.
+    /// Use <see cref="GetEmailAccountQueryExtensions.ToSender(string)"/> to create a query from an email address.
+    /// </summary>
     public required GetEmailAccountQuery Sender { get; init; }
 
     /// <summary>