baseplate

type Baseplate interface {
	io.Closer

	Configer

	EdgeContextImpl() ecinterface.Interface
	Secrets() *secrets.Store
}

type Config struct {
	// Addr is the local address to run your server on.
	//
	// It should be in the format "${IP}:${Port}", "localhost:${Port}",
	// or simply ":${Port}".
	Addr string `yaml:"addr"`

	// Deprecated: No-op for now, will be removed in a future release.
	Timeout time.Duration `yaml:"timeout"`

	// StopTimeout is the timeout for the Stop command for the service.
	//
	// If this is not set, then a default value of 30 seconds will be used.
	// If this is less than 0, then no timeout will be set on the Stop command.
	StopTimeout time.Duration `yaml:"stopTimeout"`

	// Delay after receiving termination signal (SIGTERM, etc.) before kicking off
	// the graceful shutdown process. This happens before the PreShutdown closers.
	//
	// By default this is 1s (DefaultStopDelay).
	// To disable it, set it to a negative value.
	StopDelay time.Duration `yaml:"stopDelay"`

	Log     log.Config       `yaml:"log"`
	Runtime runtimebp.Config `yaml:"runtime"`
	Secrets secrets.Config   `yaml:"secrets"`
	Sentry  log.SentryConfig `yaml:"sentry"`
	Tracing tracing.Config   `yaml:"tracing"`

	// Deprecated: statsd metrics are deprecated.
	Metrics metricsbp.Config `yaml:"metrics"`
}

type Configer interface {
	GetConfig() Config
}

type HealthCheckCloser interface {
	HealthChecker
	io.Closer
}

type HealthChecker interface {
	IsHealthy(ctx context.Context) bool
}

type NewArgs struct {
	// Required. New will panic if this is nil.
	Config Configer

	// Required. New will panic if this is nil.
	//
	// The factory to be used to create edge context implementation.
	EdgeContextFactory ecinterface.Factory
}

type NewTestBaseplateArgs struct {
	Config          Config
	Store           *secrets.Store
	EdgeContextImpl ecinterface.Interface
}

type ServeArgs struct {
	// Server is the Server that should be run until receiving a shutdown signal.
	// This is a required argument and baseplate.Serve will panic if this is nil.
	Server Server

	// PreShutdown is an optional slice of io.Closers that should be gracefully
	// shut down before the server upon receipt of a shutdown signal.
	PreShutdown []io.Closer

	// PostShutdown is an optional slice of io.Closers that should be gracefully
	// shut down after the server upon receipt of a shutdown signal.
	PostShutdown []io.Closer
}

type Server interface {
	// Close should stop the server gracefully and only return after the server has
	// finished shutting down.
	//
	// It is recommended that you use baseplate.Serve() rather than calling Close
	// directly as baseplate.Serve will manage starting your service as well as
	// shutting it down gracefully in response to a shutdown signal.
	io.Closer

	// Baseplate returns the Baseplate object the server is built on.
	Baseplate() Baseplate

	// Serve should start the Server on the Addr given by the Config and only
	// return once the Server has stopped.
	//
	// It is recommended that you use baseplate.Serve() rather than calling Serve
	// directly as baseplate.Serve will manage starting your service as well as
	// shutting it down gracefully.
	Serve() error
}