refactor(api): restructured API for type safety, maintainability and docs generation

- These changes makes the API incombatible with previous versions
- Added new types for error handling, success responses, and health checks.
- Updated health check logic to utilize the new types for better clarity and structure.
- Refactored existing handlers to improve response consistency and error handling.
- Updated Makefile to include a new target for generating API types from Swagger.
- Updated "new agent" API to respond an encrypted cert pair

internal/types/routes.go

@@ -0,0 +1,63 @@
+package types
+
+import (
+	"net/http"
+
+	"github.com/yusing/go-proxy/agent/pkg/agent"
+	"github.com/yusing/go-proxy/internal/homepage"
+	"github.com/yusing/go-proxy/internal/net/gphttp/reverseproxy"
+	nettypes "github.com/yusing/go-proxy/internal/net/types"
+	"github.com/yusing/go-proxy/internal/task"
+	"github.com/yusing/go-proxy/internal/utils/pool"
+)
+
+type (
+	Route interface {
+		task.TaskStarter
+		task.TaskFinisher
+		pool.Object
+		ProviderName() string
+		GetProvider() RouteProvider
+		TargetURL() *nettypes.URL
+		HealthMonitor() HealthMonitor
+		SetHealthMonitor(m HealthMonitor)
+		References() []string
+
+		Started() <-chan struct{}
+
+		IdlewatcherConfig() *IdlewatcherConfig
+		HealthCheckConfig() *HealthCheckConfig
+		LoadBalanceConfig() *LoadBalancerConfig
+		HomepageConfig() *homepage.ItemConfig
+		HomepageItem() *homepage.Item
+		ContainerInfo() *Container
+
+		GetAgent() *agent.AgentConfig
+
+		IsDocker() bool
+		IsAgent() bool
+		UseLoadBalance() bool
+		UseIdleWatcher() bool
+		UseHealthCheck() bool
+		UseAccessLog() bool
+	}
+	HTTPRoute interface {
+		Route
+		http.Handler
+	}
+	ReverseProxyRoute interface {
+		HTTPRoute
+		ReverseProxy() *reverseproxy.ReverseProxy
+	}
+	StreamRoute interface {
+		Route
+		nettypes.Stream
+		Stream() nettypes.Stream
+	}
+	RouteProvider interface {
+		GetRoute(alias string) (r Route, ok bool)
+		IterRoutes(yield func(alias string, r Route) bool)
+		FindService(project, service string) (r Route, ok bool)
+		ShortName() string
+	}
+)