mail

type Mailer ¶

type Mailer interface {
	Send(ctx context.Context, m Message) error
}

Mailer sends one email. The auth module calls Send from a background goroutine and retries on error, so an implementation should return an error for any failure worth retrying.

type Message ¶

type Message struct {
	To      string
	Subject string
	// Text is the plain-text body. It's always set.
	Text string
	// HTML is an optional HTML body.
	HTML string
	// IdempotencyKey is the same on every retry of one message, so a
	// provider that supports it can drop duplicates.
	IdempotencyKey string
}

Message is one email.

type Writer ¶

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

Writer is a Mailer for local development that prints each email to an io.Writer instead of sending it.

Emails contain working links with live tokens, so a Writer must never be used in production: anyone who can read its output can take over accounts. auth.New logs a warning when it's given one.

func NewWriter(w io.Writer) *Writer

func (w *Writer) Send(_ context.Context, m Message) error