wpd-message-gateway

WPD Message Gateway

A unified Go package for sending messages through multiple providers. One API, any provider.

Installation

go get github.com/weprodev/wpd-message-gateway

Quick Start

1. Configure environment:

export MESSAGE_DEFAULT_EMAIL_PROVIDER=mailgun
export MESSAGE_MAILGUN_API_KEY=your-api-key
export MESSAGE_MAILGUN_DOMAIN=mg.yourdomain.com
export MESSAGE_MAILGUN_FROM_EMAIL=noreply@yourdomain.com

2. Send an email:

package main

import (
    "context"
    "github.com/weprodev/wpd-message-gateway/config"
    "github.com/weprodev/wpd-message-gateway/contracts"
    "github.com/weprodev/wpd-message-gateway/manager"
)

func main() {
    cfg, _ := config.LoadFromEnv()
    mgr, _ := manager.New(cfg)

    mgr.SendEmail(context.Background(), &contracts.Email{
        To:      []string{"user@example.com"},
        Subject: "Welcome!",
        HTML:    "<h1>Hello from Go!</h1>",
    })
}

Providers

Documentation

• Usage Guide — Installation, configuration, examples
• Architecture — Design patterns and principles
• Contributing — How to add new providers
• Code Conventions — Style guide

Development

make test       # Run tests
make lint       # Run linter
make sandbox    # Interactive testing CLI

License

MIT