/// <summary>
/// Initializes a new instance of the <see cref="EmailParticipants"/> class.
/// </summary>
/// <param name="from">The mailbox of the sender of the email.</param>
/// <param name="to">The email mailboxes of the recipients of the email.</param>
/// <param name="cc">OPTIONAL email mailboxes of the carbon copy recipients of the email. DEFAULT is null; the email will have no carbon copy recipients.</param>
/// <param name="bcc">OPTIONAL email mailboxes of the blind carbon copy recipients of the email. DEFAULT is null; the email will have no blind carbon copy recipients.</param>
/// <param name="replyTo">OPTIONAL email mailboxes that the recipients (regular, cc, bcc) of the email should reply to. DEFAULT is null; recipients should reply to <paramref name="to"/>.</param>
public EmailParticipants(
EmailMailbox from,
IReadOnlyCollection <EmailMailbox> to,
IReadOnlyCollection <EmailMailbox> cc = null,
IReadOnlyCollection <EmailMailbox> bcc = null,
IReadOnlyCollection <EmailMailbox> replyTo = null)
{
new { from }.AsArg().Must().NotBeNull();
new { to }.AsArg().Must().NotBeNullNorEmptyEnumerableNorContainAnyNulls();
if (cc != null)
{
new { cc }.AsArg().Must().NotContainAnyNullElements();
}
if (bcc != null)
{
new { bcc }.AsArg().Must().NotContainAnyNullElements();
}
if (replyTo != null)
{
new { replyTo }.AsArg().Must().NotContainAnyNullElements();
}
this.From = from;
this.To = to;
this.Cc = cc;
this.Bcc = bcc;
this.ReplyTo = replyTo;
}
public EmailParticipants DeepCloneWithFrom(EmailMailbox from)
{
var result = new EmailParticipants(
from,
this.To?.DeepClone(),
this.Cc?.DeepClone(),
this.Bcc?.DeepClone(),
this.ReplyTo?.DeepClone());
return(result);
}
/// <summary>
/// Converts a <see cref="EmailMailbox"/> to an <see cref="MailAddress"/>.
/// </summary>
/// <param name="emailMailbox">The email mailbox to convert.</param>
/// <returns>
/// The <see cref="MailAddress"/> that corresponds to the specified <see cref="EmailMailbox"/>.
/// </returns>
public static MailAddress ToMailAddress(
this EmailMailbox emailMailbox)
{
new { emailMailbox }.AsArg().Must().NotBeNull();
new { emailMailbox.Address }.AsArg(Invariant($"{nameof(emailMailbox)}.{nameof(EmailMailbox.Address)}")).Must().BeValidEmailAddress();
var displayName = string.IsNullOrWhiteSpace(emailMailbox.Name) ? null : emailMailbox.Name;
var result = new MailAddress(emailMailbox.Address, displayName);
return(result);
}