api

type API interface {
	// Initialise options
	Init(...Option) error
	// Get the options
	Options() Options
	// Register a http handler
	Register(*Endpoint) error
	// Register a route
	Deregister(*Endpoint) error
	// Implementation of api
	String() string
}

type Endpoint struct {
	// RPC Method e.g. Greeter.Hello
	Name string
	// Domain
	Domain string
	// Description e.g what's this endpoint for
	Description string
	// API Handler e.g rpc, proxy
	Handler string
	// HTTP Host e.g example.com
	Host []string
	// HTTP Methods e.g GET, POST
	Method []string
	// HTTP Path e.g /greeter. Expect POSIX regex
	Path string
	// Body destination
	// "*" or "" - top level message value
	// "string" - inner message value
	Body string
	// Stream flag
	Stream bool
}

type Option func(*Options)

type Options struct {
	EnableACME bool
	EnableCORS bool
	EnableTLS  bool
	ACMEHosts  []string
	TLSConfig  *tls.Config
	Wrappers   []Wrapper
}

type Server interface {
	Address() string
	Init(opts ...Option) error
	Handle(path string, handler http.Handler)
	Start() error
	Stop() error
}

type Service struct {
	// Name of service
	Name string
	// Domain of the service
	Domain string
	// The endpoint for this service
	Endpoint *Endpoint
	// Versions of this service
	Services []*registry.Service
}

type Wrapper func(h http.Handler) http.Handler