email

package
v0.1.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 29, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrDriverRequired = errors.New("email: driver is required")
	ErrUnknownDriver  = errors.New("email: unknown driver")
)
View Source
var (
	ErrMessageRequired          = errors.New("email: message is required")
	ErrTemplateRendererRequired = errors.New("email: template renderer is required")
	ErrTemplateFSRequired       = errors.New("email: template fs is required")
	ErrTemplateNotFound         = errors.New("email: template not found")
)

Functions

func LoadTemplates added in v0.1.4

func LoadTemplates(fsys fs.FS, templates map[string]Template) (map[string]Template, error)

func RegisterDriver

func RegisterDriver(driver string, factory DriverFactory)

Types

type AttemptResult

type AttemptResult struct {
	Provider string
	Success  bool
	Result   *ProviderResult
	Error    error
}

type DirectMessage added in v0.1.4

type DirectMessage struct {
	To      []string
	Cc      []string
	Bcc     []string
	Subject string
	Text    string
	HTML    string
	Headers map[string]string
}

func (DirectMessage) Resolve added in v0.1.4

type DriverFactory

type DriverFactory func(name string, cfg ProviderConfig) (Provider, error)

type Message

type Message interface {
	Resolve(ctx context.Context, renderer TemplateRenderer) (Payload, error)
}

type Middleware

type Middleware func(Sender) Sender

type Payload added in v0.1.4

type Payload struct {
	To      []string
	Cc      []string
	Bcc     []string
	Subject string
	Text    string
	HTML    string
	Headers map[string]string
}

type Provider

type Provider interface {
	Send(ctx context.Context, payload Payload) (*ProviderResult, error)
	Close() error
}

func NewProvider

func NewProvider(name string, cfg ProviderConfig) (Provider, error)

type ProviderConfig

type ProviderConfig struct {
	Driver      string        `mapstructure:"driver" yaml:"driver"`
	Host        string        `mapstructure:"host" yaml:"host"`
	Port        int           `mapstructure:"port" yaml:"port"`
	Username    string        `mapstructure:"username" yaml:"username"`
	Password    string        `mapstructure:"password" yaml:"password"`
	FromAddress string        `mapstructure:"from_address" yaml:"from_address"`
	FromName    string        `mapstructure:"from_name" yaml:"from_name"`
	ReplyTo     string        `mapstructure:"reply_to" yaml:"reply_to"`
	Encryption  string        `mapstructure:"encryption" yaml:"encryption"`
	Auth        string        `mapstructure:"auth" yaml:"auth"`
	Timeout     time.Duration `mapstructure:"timeout" yaml:"timeout"`
}

func (ProviderConfig) Clone

func (c ProviderConfig) Clone() ProviderConfig

type ProviderResult

type ProviderResult struct {
	MessageID string
	Raw       any
}

type Request

type Request struct {
	Message   Message
	Providers []string
}

type SendResult

type SendResult struct {
	Provider string
	Result   *ProviderResult
	Error    error
	Attempts []AttemptResult
}

type Sender

type Sender interface {
	Send(ctx context.Context, req Request) (*SendResult, error)
}

type SenderFunc

type SenderFunc func(ctx context.Context, req Request) (*SendResult, error)

func (SenderFunc) Send

func (fn SenderFunc) Send(ctx context.Context, req Request) (*SendResult, error)

type Template added in v0.1.4

type Template struct {
	Subject     string `mapstructure:"subject" yaml:"subject"`
	SubjectFile string `mapstructure:"subject_file" yaml:"subject_file"`
	Text        string `mapstructure:"text" yaml:"text"`
	TextFile    string `mapstructure:"text_file" yaml:"text_file"`
	HTML        string `mapstructure:"html" yaml:"html"`
	HTMLFile    string `mapstructure:"html_file" yaml:"html_file"`
}

type TemplateMap added in v0.1.4

type TemplateMap map[string]Template

func (TemplateMap) Render added in v0.1.4

func (m TemplateMap) Render(ctx context.Context, name string, data map[string]any) (Template, error)

type TemplateMessage added in v0.1.4

type TemplateMessage struct {
	To       []string
	Cc       []string
	Bcc      []string
	Template string
	Data     map[string]any
	Headers  map[string]string
}

func (TemplateMessage) Resolve added in v0.1.4

func (m TemplateMessage) Resolve(ctx context.Context, renderer TemplateRenderer) (Payload, error)

type TemplateRenderer added in v0.1.4

type TemplateRenderer interface {
	Render(ctx context.Context, name string, data map[string]any) (Template, error)
}

type TemplateRendererFunc added in v0.1.4

type TemplateRendererFunc func(ctx context.Context, name string, data map[string]any) (Template, error)

func (TemplateRendererFunc) Render added in v0.1.4

func (fn TemplateRendererFunc) Render(ctx context.Context, name string, data map[string]any) (Template, error)

Directories

Path Synopsis
driver

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL