server

type ACMEConfig struct {
	// Enabled indicates whether ACME/Let's Encrypt is enabled.
	// Optional. Default value false.
	Enabled bool

	// Email specifies the ACME email address.
	// Optional. Default value "".
	Email string

	// HostWhitelist specifies the ACME host whitelist.
	// Optional. Default value empty slice.
	HostWhitelist []string

	// CachePath specifies the ACME cache path.
	// Optional. Default value "./certs".
	CachePath string

	// DirectoryURL specifies the ACME directory URL.
	// Optional. Default value "".
	DirectoryURL string
}

type CompressConfig struct {
	// Enabled indicates whether compression is enabled.
	// Optional. Default value false.
	Enabled bool

	// Level specifies the compression level.
	// Optional. Default value 6.
	Level int

	// MinLength specifies the minimum length for compression.
	// Optional. Default value 1024.
	MinLength int
}

type Config struct {
	// Name specifies the application name.
	// Optional. Default value "app".
	Name string

	// Version specifies the application version.
	// Optional. Default value "1.0.0".
	Version string

	// GracefulTimeout specifies the duration for graceful shutdown.
	// Optional. Default value 30 seconds.
	GracefulTimeout time.Duration

	// HTTP holds HTTP server configuration.
	// Optional. Default value with localhost:8080 bind address.
	HTTP HTTPConfig

	// TLS holds TLS/HTTPS server configuration.
	// Optional. Default value with TLS disabled.
	TLS TLSConfig

	// Compress holds compression configuration.
	// Optional. Default value with compression disabled.
	Compress CompressConfig

	// Redirect holds redirect configuration.
	// Optional. Default value with HTTPS redirect disabled.
	Redirect RedirectConfig

	// Healthcheck holds healthcheck configuration.
	// Optional. Default value with standard endpoints enabled.
	Healthcheck HealthcheckConfig

	// Prometheus holds Prometheus metrics configuration.
	// Optional. Default value with metrics disabled.
	Prometheus PrometheusConfig
}

type HTTPConfig struct {
	// BindAddr specifies the HTTP bind address.
	// Optional. Default value "localhost:8080".
	BindAddr string

	// IdleTimeout specifies the HTTP idle timeout.
	// Optional. Default value 60 seconds.
	IdleTimeout time.Duration

	// ReadTimeout specifies the HTTP read timeout.
	// Optional. Default value 10 seconds.
	ReadTimeout time.Duration

	// ReadHeaderTimeout specifies the HTTP read header timeout.
	// Optional. Default value 5 seconds.
	ReadHeaderTimeout time.Duration

	// WriteTimeout specifies the HTTP write timeout.
	// Optional. Default value 10 seconds.
	WriteTimeout time.Duration

	// MaxHeaderBytes specifies the maximum header bytes.
	// Optional. Default value 1MB.
	MaxHeaderBytes int
}

type HealthcheckConfig struct {
	// LivenessEndpoint specifies the liveness check endpoint.
	// Optional. Default value "/livez".
	LivenessEndpoint string

	// LivenessHandler specifies the liveness check handler.
	// Optional. Default value returns 200 OK.
	LivenessHandler echo.HandlerFunc

	// ReadinessEndpoint specifies the readiness check endpoint.
	// Optional. Default value "/readyz".
	ReadinessEndpoint string

	// ReadinessHandler specifies the readiness check handler.
	// Optional. Default value returns 200 OK.
	ReadinessHandler echo.HandlerFunc

	// StartupEndpoint specifies the startup check endpoint.
	// Optional. Default value "/startupz".
	StartupEndpoint string

	// StartupHandler specifies the startup check handler.
	// Optional. Default value returns 200 OK.
	StartupHandler echo.HandlerFunc
}

type Option func(*Server)

type PrometheusConfig struct {
	// Enabled indicates whether Prometheus metrics are enabled.
	// Optional. Default value false.
	Enabled bool

	// Path specifies the HTTP path for Prometheus metrics.
	// Optional. Default value "/metrics".
	Path string
}

type RedirectConfig struct {
	// HTTPS indicates whether to redirect HTTP to HTTPS.
	// Optional. Default value false.
	HTTPS bool

	// Code specifies the redirect status code.
	// Optional. Default value 301 (Moved Permanently).
	Code int
}

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

type TLSConfig struct {
	// Enabled indicates whether TLS/HTTPS is enabled.
	// Optional. Default value false.
	Enabled bool

	// BindAddr specifies the TLS bind address.
	// Optional. Default value "localhost:8443".
	BindAddr string

	// CertFile specifies the TLS certificate file path.
	// Optional. Default value "".
	CertFile string

	// KeyFile specifies the TLS key file path.
	// Optional. Default value "".
	KeyFile string

	// ACME holds ACME/Let's Encrypt configuration.
	// Optional. Default value with ACME disabled.
	ACME ACMEConfig
}