email

type Address struct {
	Name  string
	Email string
}

type Attachment struct {
	Filename    string
	ContentType string // application/pdf, image/png, …
	Data        io.Reader
}

type Config struct {
	Backend string `env:"BACKEND"` // smtp|ses|postmark|stub

	SMTP     SMTPConfig
	SES      SESConfig
	Postmark PostmarkConfig
}

type Message struct {
	From        Address
	To          []Address
	CC          []Address
	BCC         []Address
	ReplyTo     []Address
	Subject     string
	HTMLBody    string
	TextBody    string
	Headers     map[string]string
	Attachments []Attachment

	// Tag is an opt-in tracking label propagated to backends that
	// support it (Postmark X-PM-Message-Stream / SES Tags). Maps
	// to nothing on plain SMTP.
	Tag string
}

type Option func(*options)

type PostmarkConfig struct {
	// ServerToken is the per-server token. Found under Postmark
	// → Server → API Tokens.
	ServerToken string `env:"SERVER_TOKEN"`

	// MessageStream picks the stream (default "outbound"). Postmark
	// requires a matching stream for broadcasts vs transactional.
	MessageStream string `env:"MESSAGE_STREAM" envDefault:"outbound"`

	// Endpoint overrides the default https://api.postmarkapp.com.
	// Used by tests + region-pinned EU deployments
	// (https://api.eu.postmarkapp.com).
	Endpoint string `env:"ENDPOINT"`

	// Timeout caps the round-trip per Send. Default 15s.
	Timeout time.Duration `env:"TIMEOUT" envDefault:"15s"`

	// HTTPClient is an optional override. Set to wire kit's
	// clients/httpc retries / metrics. nil falls back to a
	// fresh net/http.DefaultClient with Timeout.
	HTTPClient *http.Client
}

type SESConfig struct {
	Region          string `env:"REGION" envDefault:"us-east-1"`
	AccessKeyID     string `env:"ACCESS_KEY_ID"`
	SecretAccessKey string `env:"SECRET_ACCESS_KEY"`
	SessionToken    string `env:"SESSION_TOKEN"`

	// ConfigurationSet activates per-set SES features (event
	// publishing to SNS, IP-pool routing). Empty leaves the default.
	ConfigurationSet string `env:"CONFIGURATION_SET"`

	// Endpoint overrides the default service endpoint (LocalStack /
	// kit tests). Empty uses AWS resolved endpoint.
	Endpoint string `env:"ENDPOINT"`

	// Timeout caps the round-trip per Send. Default 15s.
	Timeout time.Duration `env:"TIMEOUT" envDefault:"15s"`
}

type SMTPConfig struct {
	Host     string `env:"HOST"`
	Port     int    `env:"PORT" envDefault:"587"`
	Username string `env:"USERNAME"`
	Password string `env:"PASSWORD"`

	// AuthMethod is the credential mechanism used. "plain" (default)
	// runs PLAIN over STARTTLS; "cram-md5" uses CRAM-MD5. Empty
	// Username disables auth entirely (no-auth relay).
	AuthMethod string `env:"AUTH_METHOD"`

	// LocalName is the HELO/EHLO domain. Empty defaults to
	// "localhost"; set to your sending host for IP-based reputation
	// systems that match HELO against rDNS.
	LocalName string `env:"LOCAL_NAME"`

	// StartTLS toggles STARTTLS upgrade. true (default) is correct
	// for port 587; set false ONLY for port 25 to local mail-relay
	// inside trusted networks.
	StartTLS bool `env:"START_TLS" envDefault:"true"`

	// Timeout caps the total round-trip per Send. Default 30s.
	Timeout time.Duration `env:"TIMEOUT" envDefault:"30s"`
}

type Sender interface {
	Send(ctx context.Context, msg Message) error
}

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

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