email

type Attempt struct {
	Recipient string
	Type      string
	Status    DeliveryStatus
	// Code is the SMTP reply code, 0 when there was no conversation.
	Code int
	// Detail is the server's reply text or our own reason, for an operator to
	// read. It is never shown to the recipient.
	Detail string
}

type CredentialExpiryParams struct {
	UserName       string
	CredentialType string
	ExpiryDate     string
	DaysRemaining  int
}

type CustomCurrencyParams struct {
	UserName string
	RuleName string
	// Expiring is true for a "will lapse soon" warning (ExpiresOn set), false
	// for a "no longer current" notice.
	Expiring  bool
	ExpiresOn string
}

type DeliveryRecorder interface {
	RecordAttempt(ctx context.Context, a Attempt)
	// IsSuppressed reports whether the address has hard-bounced before. It is
	// consulted before dialling, so implementations should fail open (return
	// false) if they cannot answer — refusing to send because a lookup failed
	// would be worse than one wasted delivery attempt.
	IsSuppressed(ctx context.Context, recipient string) bool
}

type DeliveryStatus string

type FlightReviewExpiryParams struct {
	UserName      string
	ExpiryDate    string
	DaysRemaining int
}

type FlightReviewRequiredParams struct {
	UserName string
	Message  string
}

type Message struct {
	To       string
	Subject  string
	HTMLBody string
	Type     string
}

type PassengerCurrencyParams struct {
	UserName  string
	ClassType string
	Landings  int
	Required  int
	Remaining int
	Period    string // "day" or "night"
}

type PasswordChangedParams struct {
	UserName string
	// TwoFactorEnabled reports whether 2FA is still active on the account, so
	// the notice can state plainly that the second factor was not removed.
	TwoFactorEnabled bool
}

type PasswordResetParams struct {
	UserName string
	Link     string
	// TwoFactorEnabled warns the user up front that finishing the reset also
	// requires their authenticator code or a recovery code.
	TwoFactorEnabled bool
}

type RatingExpiryParams struct {
	UserName      string
	LicenseType   string
	ClassType     string
	ExpiryDate    string
	DaysRemaining int
}

type RevalidationParams struct {
	UserName    string
	LicenseType string
	ClassType   string
	Message     string
}

type SMTPConfig struct {
	Host     string
	Port     string
	Username string
	Password string
	From     string
}

type SendError struct {
	Status DeliveryStatus
	// Code is the SMTP reply code when the server gave one, 0 otherwise.
	Code int
	Err  error
}

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

type SignatureCompletedParams struct {
	OwnerName     string
	FlightSummary string
	SignerName    string
}

type SignatureRequestParams struct {
	OwnerName string
	// OwnerEmail is the requester's VERIFIED account address. OwnerName is a
	// free-form display name the sender chooses, so on its own it lets anyone
	// address a stranger as e.g. "Lufthansa Flight Operations" from the
	// platform's own domain. Showing the account address alongside it gives the
	// recipient something the sender could not invent.
	OwnerEmail    string
	FlightSummary string // e.g. "12 Jul 2026 — D-EFGH (C172), 1h24m"
	Link          string
	ExpiresAt     string
}

type TwoFactorResetParams struct {
	UserName string
}

type VerificationReminderParams struct {
	UserName string
	Link     string
	// DeletionDays is how long the account survives from this reminder.
	DeletionDays int
	// LinkValidDays is how long the enclosed link works, which is shorter.
	LinkValidDays int
}

type VerifyEmailParams struct {
	UserName string
	Link     string
}