mdsend

Jul 25, 2026

Changes in this version

+ func NewFileReadError(p string, cause error) error

+ type FileReadError struct

+ Cause error

+ Path string

+ func (err FileReadError) Error() string

+ func (err FileReadError) Unwrap() error

type ValidationResult

+ LetterPath string

+ func (r ValidationResult) IsMeaningful() bool

Jul 23, 2026

Changes in this version

+ type ValidationResult struct

+ Errors []*i18n.LocalizeConfig

+ Subject *i18n.LocalizeConfig

+ Warnings []i18n.LocalizeConfig

Jul 18, 2026

Changes in this version

+ type Defaults struct

+ LetterIdentifierGenerator IdentifierGenerator

+ MediaContraints media.Constraints

+ Schedule Schedule

+ type IdentifierGenerator interface

+ GenerateID func() (string, error)

+ type IdentifierGeneratorFunc func() (string, error)

+ func (f IdentifierGeneratorFunc) GenerateID() (string, error)

+ type Loader interface

+ LoadLetter func(context.Context, string) (Letter, iter.Seq2[Attachment, error], error)

+ func New(fs fs.FS, options Defaults) (_ Loader, err error)

type Schedule

+ func (s Schedule) Validate() error

Jul 17, 2026

Changes in this version

type Letter

+ func (l Letter) GetExpiration() (t time.Duration, err error)

type LetterError

+ const ErrFieldNotFound

+ const ErrNotFound

Jul 14, 2026

Changes in this version

+ const FieldNameAttachmentLocation

+ const FieldNameAttachmentName

+ const FieldNameAttachments

+ const FieldNameDatabase

+ const FieldNameExtends

+ const FieldNameFrom

+ const FieldNameHeaders

+ const FieldNameID

+ const FieldNameLanguage

+ const FieldNameMediaConstrainsHeight

+ const FieldNameMediaConstrainsResolution

+ const FieldNameMediaConstraintsQuality

+ const FieldNameMediaConstraintsWidth

+ const FieldNameMediaContraints

+ const FieldNameReplyTo

+ const FieldNameSchedule

+ const FieldNameScheduleAfter

+ const FieldNameScheduleDelay

+ const FieldNameScheduleExpire

+ const FieldNameScheduleFluctuate

+ const FieldNameScheduleStep

+ const FieldNameSeed

+ const FieldNameSubject

+ const FieldNameTemplates

+ func EachAttachmentSourceRelativeWithPathPrefix(prefix string, each iter.Seq2[AttachmentSource, error]) iter.Seq2[AttachmentSource, error]

type Attachment

+ Content []byte

+ ContentID string

+ ContentType string

+ LetterID string

+ func NewAttachmentFromFile(fs fs.FS, p string, constraints media.Constraints) (a Attachment, err error)

+ func (a Attachment) AssertEqualityTo(b Attachment) error

+ func (a Attachment) IsEqualTo(b Attachment) bool

+ func (a Attachment) LogValue() slog.Value

+ func (a Attachment) Validate() (err error)

+ func (a Attachment) WithUpdatedHash() Attachment

+ type AttachmentError uint8

+ const ErrDuplicateAttachment

+ const ErrInvalidAttachment

+ func (err AttachmentError) Error() string

+ type AttachmentReference struct

+ ContentID string

+ ContentType string

+ ID string

+ Name string

+ type AttachmentSource struct

+ Location string

+ Name string

+ type FieldComparisonMismatchError struct

+ ActualValue any

+ ExpectedValue any

+ FieldName string

+ func (e FieldComparisonMismatchError) Error() string

+ type Letter struct

+ Content string

+ CreatedAt time.Time

+ Frontmatter map[string]any

+ ID string

+ SentAt time.Time

+ Templates []Attachment

+ func NewLetter(b []byte) (letter Letter, err error)

+ func NewLetterFromFile(ctx context.Context, fs fs.FS, p string) (letter Letter, err error)

+ func (l Letter) AssertEqualityTo(b Letter) error

+ func (l Letter) EachAttachmentSource() iter.Seq2[AttachmentSource, error]

+ func (l Letter) EachWarning(fs fs.FS) iter.Seq2[*i18n.LocalizeConfig, error]

+ func (l Letter) GetDatabase() string

+ func (l Letter) GetFrom() (mail.Address, error)

+ func (l Letter) GetHeaders() (headers []header.Header, err error)

+ func (l Letter) GetLanguage() (lang language.Tag, err error)

+ func (l Letter) GetMediaConstraints() (m media.Constraints, err error)

+ func (l Letter) GetSchedule() (s Schedule, err error)

+ func (l Letter) GetSeed() (string, error)

+ func (l Letter) GetSubject() (string, error)

+ func (l Letter) IsEqualTo(b Letter) bool

+ func (l Letter) IsValid(cxt context.Context, logger *slog.Logger) (ok bool)

+ func (l Letter) LogValue() slog.Value

+ func (l Letter) Validate() (err error)

+ type LetterError uint

+ const ErrDuplicateLetter

+ const ErrLetterNotFound

+ const ErrNoContent

+ const ErrNoFromAddress

+ const ErrNoSubject

+ func (l LetterError) Error() string

type Mailer

+ SendMail func(context.Context, Message) (string, error)

type Message

+ From mail.Address

+ HTML string

+ Headers []header.Header

+ ID string

+ LetterID string

+ ScheduleAfter time.Time

+ ScheduledAt time.Time

+ SeedKey string

+ SentAt time.Time

+ Text string

+ func (m Message) AssertEqualityTo(b Message) error

+ func (m Message) IsEqualTo(b Message) bool

+ func (m Message) LogValue() slog.Value

+ func (m Message) Validate() (err error)

+ type MessageError uint8

+ const ErrDuplicateMessage

+ const ErrInvalidMessage

+ const ErrMessageNotFound

+ func (err MessageError) Error() string

+ type Schedule struct

+ After time.Time

+ Expire time.Duration

+ Fluctuate time.Duration

+ Step time.Duration

+ func (s Schedule) Next() Schedule

Mar 7, 2024

Changes in this version

+ const Version

+ func MIMEBase64To(w io.Writer, r io.Reader) (err error)

+ func MIMEHeaderTo(w io.Writer, header textproto.MIMEHeader) (err error)

+ func PreviewMessage(m *loaders.Message)

+ func RegisterCompressor(contentType string, resizer Compressor)

+ func Send(message *loaders.Message, o *Options) error

+ type Attachment struct

+ Hash uint64

+ Name string

+ Source string

+ func NewAttachment(p string) (*Attachment, error)

+ func (a *Attachment) WriteTo(w io.Writer) (int64, error)

+ type Compressor func(io.Reader) (*bytes.Buffer, error)

+ func NewImageJPEGResizer(maxWidth, maxHeight, quality uint) Compressor

+ type MIMELineWrapper struct

+ func (w *MIMELineWrapper) Write(p []byte) (int, error)

+ type Mailer struct

+ type Message interface

+ BCC func() []string

+ CC func() []string

+ MIMEBody func() io.ReadCloser

+ Subject func() string

+ To func() []string

+ type Option func(m *Mailer) error

+ func WithOptions(options ...Option) Option

+ type Options struct

+ Distributor distributors.Distributor

+ Dryrun bool

+ Loader loaders.Loader

+ Logger loggers.Logger

+ Provider providers.Provider

+ Renderer renderers.Renderer

+ URI string

+ Verbose bool

+ YesOnPrompt bool