mail

type IMailClient interface {
	// MailUsr returns the username of the mail client.
	MailUsr() string

	// CreateTextMessage creates a new plain text mail message.
	CreateTextMessage() IMailMessage

	// CreateHtmlMessage creates a new HTML mail message.
	CreateHtmlMessage() IMailMessage

	// CreateJsonMessage creates a new JSON mail message.
	CreateJsonMessage() IMailMessage

	// CreateTemplateMessage creates a new mail message from a template.
	CreateTemplateMessage(template TemplateName, variables map[string]string) IMailMessage
}

type IMailMessage interface {
	From(from string) IMailMessage
	To(to []string) IMailMessage
	Cc(cc []string) IMailMessage
	Bcc(bcc []string) IMailMessage
	Subject(subject string) IMailMessage
	Body(body string) IMailMessage
	HtmlBody(html string) IMailMessage
	Attachments(attachments []MailMessageAttachment) IMailMessage

	AddTo(to ...string) IMailMessage
	AddCc(cc ...string) IMailMessage
	AddBcc(bcc ...string) IMailMessage
	AddAttachments(attachments ...MailMessageAttachment) IMailMessage
	Attach(paths ...string) IMailMessage

	Send() error
}

type MailConfig struct {
	// MailRelayUri is the URI of the mail relay, e.g., "smtp://smtp.example.com:587" or "https://api.mailgun.net/v3".
	MailRelayUri string

	// MailRelayUser is the username for authentication with the mail relay.
	MailRelayUser string

	// MailRelayPassword is the password for authentication with the mail relay.
	MailRelayPassword string

	// UseTLS specifies whether to use TLS for the connection. This is primarily for SMTP.
	UseTLS bool

	// Headers is a map of HTTP headers to be sent with the request, applicable for HTTP-based mail clients.
	Headers map[string]string
}

type MailMessageAttachment struct {
	// FileName is the name of the file to be attached.
	FileName string `json:"fileName"`

	// Content is the base64-encoded content of the file.
	Content string `json:"content"`

	// ContentType is the MIME type of the attachment. For base64 content, it should include ";base64".
	ContentType string `json:"contentType"`
}

type TemplateName string