httpserver

type Config struct {
	Host            string
	Port            int
	ReadTimeout     time.Duration
	WriteTimeout    time.Duration
	IdleTimeout     time.Duration
	MaxHeaderBytes  int
	ShutdownTimeout time.Duration

	// 健康检查配置
	EnableHealthCheck bool   // 是否启用健康检查
	HealthCheckPath   string // 健康检查路径，默认为 /health
	HealthCheckPort   int    // 健康检查端口，默认为0（使用主端口）
}

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

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

type ErrorMapper func(err error) (status int, body any)

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

type HandlerFunc[Req any, Resp any] func(ctx context.Context, req Req) (Resp, error)

type HandlerOption func(*handlerConfig)

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

type HealthChecker interface {
	CheckHealth(ctx context.Context) error
	GetName() string
}

type HealthStatus struct {
	Status    string                 `json:"status"`            // healthy, unhealthy
	Timestamp int64                  `json:"timestamp"`         // Unix时间戳
	Version   string                 `json:"version,omitempty"` // 应用版本
	Uptime    int64                  `json:"uptime,omitempty"`  // 运行时间（秒）
	Checks    map[string]interface{} `json:"checks,omitempty"`  // 详细检查结果
	Error     string                 `json:"error,omitempty"`   // 错误信息
}

type Hooks struct {
	OnStarting         func(context.Context, LifecycleEvent)
	OnStarted          func(context.Context, LifecycleEvent)
	OnServeError       func(context.Context, LifecycleEvent)
	OnShuttingDown     func(context.Context, LifecycleEvent)
	OnShutdownComplete func(context.Context, LifecycleEvent)
}

type LifecycleEvent struct {
	Addr       string
	HealthAddr string
	Err        error
}

type Option func(*Server)

type RouteModule interface {
	RegisterRoutes(r gin.IRoutes)
}

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