smtp

type CapturedMessage struct {
	// ID is a unique identifier assigned at capture time.
	ID string `json:"id"`

	// Kind is the transport type: "email" or "sms".
	Kind MessageKind `json:"kind"`

	// Source is the name of the service that sent the message
	// (e.g. "sns", "ses", "cognito"). Empty when unknown.
	Source string `json:"source,omitempty"`

	// From is the envelope sender address (MAIL FROM for email, or the
	// originator phone number / sender ID for SMS).
	From string `json:"from"`

	// To is the list of recipient addresses (email) or phone numbers (SMS).
	To []string `json:"to"`

	// Subject is the value of the Subject header. Always empty for SMS.
	Subject string `json:"subject,omitempty"`

	// TextBody is the plain-text body.
	TextBody string `json:"textBody"`

	// HTMLBody is the HTML body (text/html part), if present. Always empty for SMS.
	HTMLBody string `json:"htmlBody,omitempty"`

	// ReceivedAt is the UTC timestamp when the message was captured.
	ReceivedAt time.Time `json:"receivedAt"`

	// Raw is the complete RFC 5321 DATA payload, verbatim. Empty for SMS.
	Raw string `json:"raw,omitempty"`

	// GroupID ties all deliveries for a single SNS Publish call together so
	// the inbox UI can show them as a thread. It is the SNS MessageId when
	// set by the SNS fan-out; empty for standalone messages (SES, Cognito).
	GroupID string `json:"groupId,omitempty"`

	// GroupTopic is the short topic name associated with GroupID, shown as
	// the thread title in the inbox list.
	GroupTopic string `json:"groupTopic,omitempty"`
}

type Config struct {
	// Host is the SMTP server hostname or IP address.
	Host string

	// Port is the SMTP server port (e.g. 25, 465, 587, 1025).
	Port int

	// Username and Password are used for SMTP AUTH PLAIN. Leave empty to skip AUTH.
	Username string
	Password string

	// TLS controls whether to use implicit TLS (port 465 convention).
	// For STARTTLS on submission ports (587), set TLS=false — the client
	// upgrades automatically when the server advertises STARTTLS.
	TLS bool
}

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

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

type Mailer interface {
	// Send delivers an email. from is the envelope sender; to is the list of
	// recipient addresses; subject and body are the message content;
	// html is an optional HTML alternative (empty string = plain text only).
	Send(ctx context.Context, from string, to []string, subject, body, html string) error

	// SendRaw delivers an already-assembled RFC 2822 MIME message. The msg
	// bytes are passed verbatim to the SMTP DATA command. Use this for
	// SES SendRawEmail where the caller supplies the full message.
	SendRaw(ctx context.Context, from string, to []string, msg []byte) error
}

type MessageKind string

type MockOutboundCapture struct {
	OnMessage func(*CapturedMessage) // optional callback invoked after each capture
	// contains filtered or unexported fields
}

type MockSMSSender struct {
	OnMessage func(*CapturedMessage) // optional callback invoked after each capture
	// contains filtered or unexported fields
}

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

type OutboundCapture interface {
	// CaptureWebhook records an SNS http/https subscription delivery.
	// endpoint is the destination URL; body is the full JSON notification payload.
	// groupID and groupTopic link this delivery to an SNS fan-out batch.
	CaptureWebhook(source, endpoint, body, groupID, groupTopic string) error

	// CapturePush records an SNS application (mobile push) subscription delivery.
	// endpoint is the device ARN; body is the notification payload JSON.
	// groupID and groupTopic link this delivery to an SNS fan-out batch.
	CapturePush(source, endpoint, body, groupID, groupTopic string) error
}

type SMSSender interface {
	// SendSMS delivers an SMS message. source identifies the service name
	// (e.g. "sns", "cognito") for display; sender is the originator phone
	// number or sender ID (may be empty); to is the destination phone number;
	// body is the message text. groupID and groupTopic link this message to
	// an SNS fan-out batch; pass "" for standalone messages.
	SendSMS(source, sender, to, body, groupID, groupTopic string) error
}

type Server struct {

	// OnMessage is an optional callback invoked after every successfully
	// captured message has been stored. It runs in the connection goroutine
	// and must not block. Set before calling Serve.
	OnMessage func(*CapturedMessage)
	// contains filtered or unexported fields
}