mail

type Attachment ¶

type Attachment struct {
	Filename string
	Data     []byte
	MIMEType string // e.g. "application/pdf". Auto-detected if empty.
}

Attachment represents a file attachment on an email.

type Driver ¶

type Driver interface {
	Send(m *Message) error
}

Driver sends emails.

var Default Driver

type MailgunAPIDriver ¶

type MailgunAPIDriver struct {
	Domain   string
	APIKey   string
	FromAddr string
	Endpoint string // defaults to "https://api.mailgun.net/v3"
	Client   *http.Client
}

MailgunAPIDriver sends email via the Mailgun HTTP API. This is a native API driver — no SMTP connection required.

driver := mail.NewMailgunAPIDriver("your-domain.com", "key-xxx", "sender@your-domain.com")
mail.Default = driver

func NewMailgunAPIDriver(domain, apiKey, fromAddr string) *MailgunAPIDriver

func (d *MailgunAPIDriver) Send(m *Message) error

type MailgunSMTPDriver ¶

type MailgunSMTPDriver struct {
	// contains filtered or unexported fields
}

MailgunSMTPDriver wraps SMTPDriver for Mailgun SMTP transport. For the native API driver, use MailgunAPIDriver instead. Example addr: "smtp.mailgun.org:587".

func NewMailgunSMTPDriver(addr string, auth smtp.Auth, fromAddr string) *MailgunSMTPDriver

func (d *MailgunSMTPDriver) Send(m *Message) error

type Message ¶

type Message struct {
	From        string
	To          []string
	Cc          []string
	Bcc         []string
	ReplyTo     string
	Subject     string
	Body        string
	HTML        bool
	Attachments []Attachment
}

Message represents an email (plan: mail drivers SMTP, etc.).

func NewMessage(subject string) *Message

func (m *Message) AddBcc(bcc ...string) *Message

func (m *Message) AddCc(cc ...string) *Message

func (m *Message) AllRecipients() []string

func (m *Message) Attach(filename string, data []byte, mimeType ...string) *Message

func (m *Message) SetBody(body string, html bool) *Message

func (m *Message) SetFrom(from string) *Message

func (m *Message) SetReplyTo(replyTo string) *Message

func (m *Message) SetTo(to ...string) *Message

type PostmarkDriver ¶

type PostmarkDriver struct {
	// contains filtered or unexported fields
}

PostmarkDriver wraps SMTPDriver for Postmark. Example addr: "smtp.postmarkapp.com:587".

func NewPostmarkDriver(addr string, auth smtp.Auth, fromAddr string) *PostmarkDriver

func (d *PostmarkDriver) Send(m *Message) error

type ResendDriver ¶

type ResendDriver struct {
	APIKey   string
	FromAddr string
	Endpoint string
	Client   *http.Client
}

ResendDriver sends email via the Resend HTTP API.

driver := mail.NewResendDriver("re_xxxx", "sender@example.com")
mail.Default = driver

func NewResendDriver(apiKey, fromAddr string) *ResendDriver

func (d *ResendDriver) Send(m *Message) error

type SESAPIDriver ¶

type SESAPIDriver struct {
	Region    string
	AccessKey string
	SecretKey string
	FromAddr  string
	Client    *http.Client
}

SESAPIDriver sends email via the Amazon SES v2 HTTP API using AWS Signature Version 4. For simplicity, this driver uses the SES SendEmail Action via query parameters (no external AWS SDK required).

driver := mail.NewSESAPIDriver("us-east-1", "AKID...", "secret...", "sender@example.com")
mail.Default = driver

func NewSESAPIDriver(region, accessKey, secretKey, fromAddr string) *SESAPIDriver

func (d *SESAPIDriver) Send(m *Message) error

type SESDriver ¶

type SESDriver struct {
	// contains filtered or unexported fields
}

SESDriver is a thin wrapper around SMTPDriver configured for Amazon SES SMTP. Use the SMTP credentials from your SES console.

func NewSESDriver(addr string, auth smtp.Auth, fromAddr string) *SESDriver

func (d *SESDriver) Send(m *Message) error

type SMTPDriver ¶

type SMTPDriver struct {
	Addr     string
	Auth     smtp.Auth
	FromAddr string
}

SMTPDriver sends via SMTP.

func NewSMTPDriver(addr string, auth smtp.Auth, fromAddr string) *SMTPDriver

func (d *SMTPDriver) Send(m *Message) error

type SendGridDriver ¶

type SendGridDriver struct {
	APIKey   string
	FromAddr string
	FromName string
	Endpoint string // defaults to "https://api.sendgrid.com/v3/mail/send"
	Client   *http.Client
}

SendGridDriver sends email via the SendGrid v3 HTTP API. This is a native API driver — no SMTP connection required.

driver := mail.NewSendGridDriver("SG.your-api-key", "sender@example.com")
mail.Default = driver

func NewSendGridDriver(apiKey, fromAddr string) *SendGridDriver

func (d *SendGridDriver) Send(m *Message) error

type SendGridSMTPDriver ¶

type SendGridSMTPDriver struct {
	// contains filtered or unexported fields
}

SendGridSMTPDriver wraps SMTPDriver for SendGrid SMTP transport. For the native API driver, use SendGridDriver instead. Example addr: "smtp.sendgrid.net:587".

func NewSendGridSMTPDriver(addr string, auth smtp.Auth, fromAddr string) *SendGridSMTPDriver

func (d *SendGridSMTPDriver) Send(m *Message) error