server

type GRPCServer interface {
	Start() error
	Stop()
}

type GracefulGRPCServer interface {
	GRPCServer
	GracefulStop(context.Context) error
}

type HTTPRuntime struct {
	// contains filtered or unexported fields
}

type HTTPRuntimeConfig struct {
	ServiceName                 string
	RootMux                     *http.ServeMux
	APIMux                      *http.ServeMux
	APIBasePath                 string
	RootMiddleware              []func(http.Handler) http.Handler
	APIMiddleware               []func(http.Handler) http.Handler
	Health                      *HealthRegistry
	Metrics                     *telemetry.HTTPMetrics
	MetricsPath                 string
	DisableHealthRoutes         bool
	DisableMetricsRoute         bool
	DisableRegisteredExtensions bool
	StartupHooks                []StartupHook
	ShutdownHooks               []ShutdownHook
}

type HealthCheck func(context.Context) error

type HealthCheckResult struct {
	Name   string `json:"name"`
	Status string `json:"status"`
	Error  string `json:"error,omitempty"`
}

type HealthDependency interface {
	HealthCheck(context.Context) error
}

type HealthPhase string

type HealthRegistry struct {
	// contains filtered or unexported fields
}

type HealthReport struct {
	Status string              `json:"status"`
	Phase  string              `json:"phase"`
	Checks []HealthCheckResult `json:"checks,omitempty"`
}

type Options struct {
	HTTPServer      *http.Server
	GRPCServer      GRPCServer
	EnableGRPC      bool
	ShutdownTimeout time.Duration
	StartupHooks    []StartupHook
	ShutdownHooks   []ShutdownHook
}

type Runner struct {
	// contains filtered or unexported fields
}

type RuntimeExtension interface {
	// Name returns a stable extension identifier.
	Name() string

	// APIMiddleware returns middleware to apply to /v1 API routes.
	APIMiddleware() []func(http.Handler) http.Handler

	// RegisterRoutes lets the extension mount HTTP handlers.
	//
	// rootMux is the top-level server mux, apiMux is the /v1 sub-mux.
	RegisterRoutes(rootMux, apiMux *http.ServeMux)

	// Startup runs before serving traffic.
	Startup(ctx context.Context) error

	// Shutdown runs during graceful termination.
	Shutdown(ctx context.Context) error
}

type ShutdownHook func(context.Context) error

type StartupHook func(context.Context) error