mailbox

type Address struct {
	Name    string `json:"name,omitempty"`
	Address string `json:"address"`
}

type Attachment struct {
	Filename    string `json:"filename"`
	ContentType string `json:"contentType"`
	Size        int    `json:"size"`
}

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

type Draft struct {
	To        []Address `json:"to"`
	CC        []Address `json:"cc,omitempty"`
	BCC       []Address `json:"bcc,omitempty"`
	Subject   string    `json:"subject"`
	Text      string    `json:"text"`
	InReplyTo string    `json:"inReplyTo,omitempty"`
}

type FlagChange struct {
	Seen    *bool
	Flagged *bool
}

type IMAPConfig struct {
	IMAPAddr string // host:port, e.g. mail.profullstack.com:993 (implicit TLS)
	SMTPAddr string // host:port, e.g. smtp.profullstack.com:587 (STARTTLS)
	Username string
	Password string
	// SMTPUser/SMTPPass default to Username/Password when empty.
	SMTPUser string
	SMTPPass string
	// SMTPServerName is the TLS server name verified during STARTTLS. Set it when
	// the dial host differs from the certificate name — e.g. dialing the trusted
	// local relay at 127.0.0.1:25 whose cert is mail.<host>. Empty = use the dial
	// host (the net/smtp default).
	SMTPServerName string
	// Plaintext dials IMAP without TLS. Used only for a co-located backend over
	// loopback (the Mailu gateway hitting Dovecot directly on 127.0.0.1, bypassing
	// the front's auth proxy so master-user login works) — the password never
	// leaves the host. Never enable it for a remote server.
	Plaintext bool
}

type Identity struct {
	Name string // local-part / handle, e.g. "alice"
	Paid bool   // Founding Lifetime Member (informational; does not gate mail)
}

type ListOptions struct {
	Mailbox string
	Limit   int
}

type Mailbox struct {
	Name   string `json:"name"`
	Path   string `json:"path"`
	Unseen int    `json:"unseen"`
	Total  int    `json:"total"`
}

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

type Message struct {
	MessageSummary
	CC          []Address    `json:"cc,omitempty"`
	ReplyTo     *Address     `json:"replyTo,omitempty"`
	MessageID   string       `json:"messageId"`
	References  []string     `json:"references,omitempty"`
	Text        string       `json:"text"`
	HTML        string       `json:"html,omitempty"`
	Attachments []Attachment `json:"attachments,omitempty"`
}

type MessageSummary struct {
	UID            uint32    `json:"uid"`
	Mailbox        string    `json:"mailbox"`
	From           Address   `json:"from"`
	To             []Address `json:"to"`
	Subject        string    `json:"subject"`
	Date           time.Time `json:"date"`
	Seen           bool      `json:"seen"`
	Flagged        bool      `json:"flagged"`
	HasAttachments bool      `json:"hasAttachments"`
	Snippet        string    `json:"snippet"`
}

type SearchOptions struct {
	Mailbox string // empty = all mailboxes
	Query   string
	Limit   int
}

type SendResult struct {
	MessageID string `json:"messageId"`
}

type Transport interface {
	ListMailboxes(ctx context.Context) ([]Mailbox, error)
	ListMessages(ctx context.Context, opts ListOptions) ([]MessageSummary, error)
	// ReadMessage returns (Message, false, nil) when the uid is unknown.
	ReadMessage(ctx context.Context, mailbox string, uid uint32) (Message, bool, error)
	Search(ctx context.Context, opts SearchOptions) ([]MessageSummary, error)
	// Send delivers an already-validated draft, stamped from `from`.
	Send(ctx context.Context, from string, d Draft) (SendResult, error)
	SetFlags(ctx context.Context, mailbox string, uid uint32, fc FlagChange) error
	DeleteMessage(ctx context.Context, mailbox string, uid uint32) error
	Close() error
}