EmailBuilder improvements

CHANGELOG.md

@@ -19,11 +19,13 @@ Previous classification is not required if changes are simple or all belong to t
 ## [8.1.8]
 
 ### Breaking Changes 
+
 - `DocumentConnectorProviderBase` no longer automatically registers document connectors. Instead, it will register available connectors in the dependency container. 
   This means that document connectors must be registered manually in the dependency container. For this purpose, new extension methods have been added to `IServiceCollection` that allow to register document connectors in the dependency container.
   Also the `AddDefaultDocumentConnectors` method has been added in `IServiceCollectionExtensions` to register document connectors that were registered by default before.
 
 ### Major Changes
+
 - Added the `IEnmarchaDocumentConnector` interface that extends the existing `IDocumentConnector`. This interface, by now, adds a `CompatibleFileFormats` property that returns the file formats supported by the connector. Existing document connectors have been updated to implement this interface.
 - Added `CsvTsvDocumentConnector` document connector that allows to read CSV and TSV files keeping the headers in different chunks.
 - Added `SkVisionImageDocumentConnector` which allows to read images and extract text from them. Using Semantic Kernel vision capabilities.
@@ -42,6 +44,10 @@ Previous classification is not required if changes are simple or all belong to t
   - Moved `TableStorageResponseProvider` class to `Encamina.Enmarcha.Conversation`.
   - Updated `LocalizedResponseGreetingsProvider.cs` to use new abstractions.
 
+### Minor Changes
+
+- Added `SetRecipients` method to `IEmailBuilder` interface.
+
 ## [8.1.7]
 
 ### Major Changes

Directory.Build.props

@@ -17,7 +17,7 @@
 
   <PropertyGroup>
     <VersionPrefix>8.1.8</VersionPrefix>
-    <VersionSuffix>preview-02</VersionSuffix>
+    <VersionSuffix>preview-03</VersionSuffix>
   </PropertyGroup>
 
   <!--

src/Encamina.Enmarcha.Email.Abstractions/IEmailBuilder.cs

@@ -98,6 +98,18 @@ public interface IEmailBuilder
     /// <returns>The <see cref="IEmailBuilder"/> so that additional calls can be chained.</returns>
     IEmailBuilder SetBody(StringBuilder body, bool isHtml = false);
 
+    /// <summary>
+    /// Sets the e-mail addresses for the recipients of an e-mail, typically for the 'TO', 'CC', or 'BCC' fields, replacing any previously set recipients.
+    /// </summary>
+    /// <param name="recipients">
+    /// A collection of tuples where each tuple contains:
+    /// - <c>EmailAddress</c>: The recipient's e-mail address.
+    /// - <c>RecipientName</c>: The recipient's name./>.
+    /// - <c>RecipientType</c>: The type of recipient (like 'to', 'cc', or 'bcc')./>.
+    /// </param>
+    /// <returns>The <see cref="IEmailBuilder"/> so that additional calls can be chained.</returns>
+    IEmailBuilder SetRecipients(IEnumerable<(string EmailAddress, string? RecipientName, EmailRecipientType RecipientType)> recipients);
+
     /// <summary>
     /// Sends the e-mail, thus effectively ending its building.
     /// </summary>

src/Encamina.Enmarcha.Email.MailKit/EmailService.cs

@@ -145,6 +145,19 @@ public IEmailBuilder SetSender(string emailAddress, string? senderName)
     /// <inheritdoc/>
     public IEmailBuilder SetDefaultSender(string? senderName = null) => SetSender(SmtpClientOptions.User, senderName);
 
+    /// <inheritdoc/>
+    public IEmailBuilder SetRecipients(IEnumerable<(string EmailAddress, string? RecipientName, EmailRecipientType RecipientType)> recipients)
+    {
+        Specification.To.Clear();
+
+        foreach (var (emailAddress, recipientName, recipientType) in recipients)
+        {
+            AddRecipient(emailAddress, recipientName, recipientType);
+        }
+
+        return this;
+    }
+
     /// <inheritdoc/>
     /// <remarks>This implementation does not allows the subject to be <see langword="null"/>.</remarks>
     public IEmailBuilder SetSubject(string subject)