servers

type BaseServerConfig struct {
	ServiceName      string
	TLS              auth.TLSConfigOptions
	Tracing          tracing.OTELConfig
	SwaggerFile      string
	Version          string
	ShutdownEndpoint string
}

type CustomErrorHandlerFunc func(ctx context.Context, mux *runtime.ServeMux, marshaler runtime.Marshaler,
	w http.ResponseWriter, r *http.Request, err error)

type GRPCConfig struct {
	*BaseServerConfig
	GRPCAddr  string
	HTTPAddr  string
	AdminAddr string
	// protobuf generated server registration function
	RegisterServer RegisterServerFunc `json:"-"`
	// REST gateway generated handler registration function
	RegisterHandler RegisterHandlerFunc `json:"-"`
	// use the provided mux for http instead of the default grpc-gateway mux
	HTTPEndpointOverride HTTPEndpointOverrideFunc `json:"-"`
	// pre-serve callback function to customize server setting before it is served
	PreServeCallback PreServeCallbackFunc `json:"-"`
	// additional GRPC server options
	ExtraServerOpts []grpc.ServerOption `json:"-"`
	// additional HTTP connection dial options
	ExtraHTTPDialOpts []grpc.DialOption `json:"-"`
	// additional admin http handlers
	AdditionalHttpHandlers map[string]http.Handler `json:"-"`
	// allow additional headers from requests
	AdditionalHeaders []string `json:"-"`
	// custom error handler function
	CustomErrorHandler  CustomErrorHandlerFunc `json:"-"`
	TerminationCallback func()                 `json:"-"`
	// set explicit http endpoints to serve health information
	HttpHealthEndpointOverride []string `json:"-"`
	// add additional servers
	AdditionalServers []ServerFuncPair
}

type HTTPEndpointOverrideFunc func(mux *runtime.ServeMux) *runtime.ServeMux

type Option func(server *grpcServer)

type PreServeCallbackFunc func(s *grpc.Server) error

type RegisterHandlerFunc func(ctx context.Context, mux *runtime.ServeMux, conn *grpc.ClientConn) error

type RegisterServerFunc func(s *grpc.Server)

type Server interface {
	Setup() error
	Run() error
}

type ServerFuncPair struct {
	Execute   func() error
	Interrupt func(error)
}