email

type APIConfig struct {
	APIKey  string
	From    string
	ReplyTo string
	// Domain and Region are Mailgun-only.
	Domain string
	Region string
}

type Backend string

type Builder func(cfg Config) (Sender, error)

type Config struct {
	Backend Backend
	SMTP    *SMTPConfig
	SES     *SESConfig
	Resend  *ResendConfig
	API     *APIConfig
	Limits  Limits
}

type ConfigLoader func(ctx context.Context) (Config, error)

type DNSLookup interface {
	LookupTXT(ctx context.Context, name string) ([]string, error)
	LookupCNAME(ctx context.Context, name string) (string, error)
}

type Delivery struct {
	At        time.Time
	Provider  string
	To        string
	Kind      string
	Status    string // DeliverySent or DeliveryFailed
	MessageID string
	Error     string
	ErrorKind FailureKind
	Attempts  int
	// ProviderID is the provider row that handled the attempt; FailoverFrom is the one it replaced, if any.
	ProviderID   string
	FailoverFrom string
}

type DomainCheck struct {
	Domain   string        `json:"domain"`
	Provider string        `json:"provider"`
	Records  []RecordCheck `json:"records"`
	// SPFInclude is the provider's expected SPF include, shown as a hint.
	SPFInclude string `json:"spf_include,omitempty"`
}

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

type FailureKind string

type HTTPError struct {
	Provider string
	Status   int
	Body     string
}

type HostLookup interface {
	LookupHost(ctx context.Context, host string) ([]string, error)
}

type Limits struct {
	PerMinute int
	PerDay    int
}

type Message struct {
	To      string
	Subject string
	Text    string
	HTML    string
	Headers map[string]string
}

type ProviderConfig struct {
	ID     string
	Config Config
}

type ProviderHealth interface {
	RecordProviderResult(ctx context.Context, providerID string, ok bool, kind FailureKind, at time.Time) error
}

type ProvidersLoader func(ctx context.Context) ([]ProviderConfig, error)

type RecordCheck struct {
	Type    string `json:"type"`
	Name    string `json:"name"`
	Status  string `json:"status"`
	Code    string `json:"code"`
	Value   string `json:"value,omitempty"`
	Message string `json:"message"`
}

type Recorder interface {
	RecordDelivery(ctx context.Context, d Delivery) error
	CountSent(ctx context.Context, since time.Time) (int, error)
}

type ResendConfig struct {
	APIKey  string
	From    string
	ReplyTo string
}

type Result struct {
	Provider  string
	MessageID string
	Attempts  int
}

type RichSender interface {
	SendMessage(ctx context.Context, m Message) error
}

type SESConfig struct {
	Region          string
	AccessKeyID     string
	SecretAccessKey string
	From            string
	ReplyTo         string
}

type SMTPConfig struct {
	// Addr is host:port, e.g. "smtp.example.com:587".
	Addr     string
	Host     string // just the host part of Addr, for PlainAuth's identity check
	Username string
	Password string
	From     string
	// EnvelopeFrom is the bare MAIL FROM address; empty uses From.
	EnvelopeFrom string
	ReplyTo      string
	TLSMode      string
	SkipVerify   bool
	// PinSHA256 trusts exactly one leaf certificate (hex SHA-256 of its DER) instead of the CA chain.
	PinSHA256 string
}

type SPFLimits struct {
	Lookups int
	Depth   int
}

type SendError struct {
	Kind     FailureKind
	Attempts int
	Err      error
}

type Sender interface {
	Send(ctx context.Context, to, subject, body string) error
}

type SystemDNS struct{}