GPALMailSettings.cs

// =============================================================================
// GPAL - Generally Positive Automation Library
// Copyright © 2026 Software Decisions, Inc. All rights reserved.
//
// This file is part of GPAL.
// Licensed under the Business Source License 1.1
//
// Primary development, architecture, and vision by Michael B. Vederman,
// CEO of Software Decisions, Inc., Texas.
//
// Internal development maintained privately.
// Public releases appear on GitHub: https://github.com/SoftwareDecisionsInc/GPAL.
//
// See LICENSE for full terms, including Additional Use Grant.
// =============================================================================
 
using MimeKit;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
 
namespace GenerallyPositive
{
    internal class GPALMailSettings
    {
        public string IMAPServerName { get; set; }
        public string POPServerName { get; set; }
        public string SMTPServerName { get; set; }
        public int IMAPPortNum { get; set; }
        public int POPPortNum { get; set; }
        public int SMTPPortNum { get; set; }
 
        // whether a send may fall back to accepting any certificate, including one that fails validation. Off,
        // so a cert problem is a failure the workflow is told about rather than a silent downgrade to no
        // verification. See GPALMail.WithAcceptAnyCertificate
        public bool AcceptAnyCertificate { get; set; } = false;
        // internal, because as a public MailboxAddress it went into the settings file as a whole MimeKit object
        // - route, local part, domain and an entire Encoding with its fallbacks and code pages - and nothing
        // could read that back
        internal MailboxAddress FromEmailAddress { get; set; }

        public string FromAddress
        {
            get
            {
                return FromEmailAddress?.ToString();
            }
            set
            {
                FromEmailAddress = true == string.IsNullOrWhiteSpace(value) ? null : MailboxAddress.Parse(value);
            }
        }
        internal List<MailboxAddress> ToEmailAddresses { get; set; } = new List<MailboxAddress>();
        internal List<MailboxAddress> CcEmailAddresses { get; set; } = new List<MailboxAddress>();
        internal List<MailboxAddress> BccEmailAddresses { get; set; } = new List<MailboxAddress>();
        internal List<string> Attachments { get; set; } = new List<string>();
        internal string BodyText { get; set; }
        internal string BodyHTML { get; set; }
        internal string Subject { get; set; }
        internal List<ReceivedEmail> ReceivedEmails { get; set; } = new List<ReceivedEmail>();
 
        // what Receive is allowed to fetch. the whole mailbox by default, which is what it has always done
        internal bool UnreadOnly { get; set; }
        internal int MaxMessages { get; set; } = int.MaxValue;
        // internal, so a settings file holds servers and ports and never who you are or your password. a
        // credential is where those belong
        internal string UserName { get; set; }
        internal string Password { get; set; }
        internal ICredentials Credentials { get; set; }
    }
}