server

type API struct {
	*Server

	// Prefix defines the router prefix to register the API routes against.
	Prefix string
	// contains filtered or unexported fields
}

type MiddlewareFunc func(http.Handler) http.Handler

type Router interface {
	// RegisterUI will register the router's UI routes with the given
	// mux.Router. It will also pass through the CSRF middleware function, and
	// a variadic list of gates to apply to the routes being registered.
	RegisterUI(*mux.Router, func(http.Handler) http.Handler, ...web.Gate)

	// RegisterAPI will register the router's API routes with the given
	// mux.Router. Unlike RegisterUI, this does not take a CSRF middleware
	// function, and only the variadic list of gates.
	RegisterAPI(string, *mux.Router, ...web.Gate)
}

type Server struct {
	*http.Server

	Log     *log.Logger       // Log is the logger to use for application logging.
	Router  *mux.Router       // Router is the mux.Router to use for registering routes.
	Routers map[string]Router // Routers defines the routers for the server, along with their name.

	// Cert and Key define the paths to the certificate and key to use for
	// serving over TLS.
	Cert string
	Key  string
}

type UI struct {
	*Server

	// CSRF defines the middleware function to use for protecting form submissions
	// from CSRF attacks.
	CSRF func(http.Handler) http.Handler
}