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/logging/accesslog/config.go

@@ -13,7 +13,7 @@ type (
 		Path           string        `json:"path"`
 		Stdout         bool          `json:"stdout"`
 		Retention      *Retention    `json:"retention" aliases:"keep"`
-		RotateInterval time.Duration `json:"rotate_interval,omitempty"`
+		RotateInterval time.Duration `json:"rotate_interval,omitempty" swaggertype:"primitive,integer"`
 	}
 	ACLLoggerConfig struct {
 		ConfigBase
@@ -24,7 +24,7 @@ type (
 		Format  Format  `json:"format" validate:"oneof=common combined json"`
 		Filters Filters `json:"filters"`
 		Fields  Fields  `json:"fields"`
-	}
+	} // @name RequestLoggerConfig
 	Config struct {
 		*ConfigBase
 		acl *ACLLoggerConfig

internal/logging/accesslog/filter.go

@@ -14,19 +14,19 @@ type (
 	LogFilter[T Filterable] struct {
 		Negative bool
 		Values   []T
-	}
+	} // @name LogFilter
 	Filterable interface {
 		comparable
 		Fulfill(req *http.Request, res *http.Response) bool
 	}
-	HTTPMethod string
+	HTTPMethod string // @name HTTPMethod
 	HTTPHeader struct {
 		Key, Value string
-	}
-	Host string
+	} // @name HTTPHeader
+	Host string // @name Host
 	CIDR struct {
 		nettypes.CIDR
-	}
+	} // @name CIDR
 )
 
 var ErrInvalidHTTPHeaderFilter = gperr.New("invalid http header filter")

internal/logging/accesslog/retention.go

@@ -12,7 +12,7 @@ type Retention struct {
 	Days     uint64 `json:"days"`
 	Last     uint64 `json:"last"`
 	KeepSize uint64 `json:"keep_size"`
-}
+} // @name LogRetention
 
 var (
 	ErrInvalidSyntax = gperr.New("invalid syntax")

internal/logging/accesslog/status_code_range.go

@@ -10,7 +10,7 @@ import (
 type StatusCodeRange struct {
 	Start int
 	End   int
-}
+} // @name StatusCodeRange
 
 var ErrInvalidStatusCodeRange = gperr.New("invalid status code range")
 

internal/logging/memlogger/mem_logger.go

@@ -4,13 +4,13 @@ import (
 	"bytes"
 	"context"
 	"io"
-	"net/http"
 	"sync"
 	"time"
 
-	"github.com/gorilla/websocket"
+	"github.com/gin-gonic/gin"
 	"github.com/puzpuzpuz/xsync/v4"
-	"github.com/yusing/go-proxy/internal/net/gphttp/gpwebsocket"
+	apitypes "github.com/yusing/go-proxy/internal/api/types"
+	"github.com/yusing/go-proxy/internal/net/gphttp/websocket"
 )
 
 type logEntryRange struct {
@@ -20,6 +20,7 @@ type logEntryRange struct {
 type memLogger struct {
 	*bytes.Buffer
 	sync.RWMutex
+
 	notifyLock sync.RWMutex
 	connChans  *xsync.Map[chan *logEntryRange, struct{}]
 	listeners  *xsync.Map[chan []byte, struct{}]
@@ -31,6 +32,7 @@ const (
 	maxMemLogSize         = 16 * 1024
 	truncateSize          = maxMemLogSize / 2
 	initialWriteChunkSize = 4 * 1024
+	writeTimeout          = 10 * time.Second
 )
 
 var memLoggerInstance = &memLogger{
@@ -43,11 +45,7 @@ func GetMemLogger() MemLogger {
 	return memLoggerInstance
 }
 
-func Handler() http.Handler {
-	return memLoggerInstance
-}
-
-func HandlerFunc() http.HandlerFunc {
+func HandlerFunc() gin.HandlerFunc {
 	return memLoggerInstance.ServeHTTP
 }
 
@@ -70,9 +68,10 @@ func (m *memLogger) Write(p []byte) (n int, err error) {
 	return
 }
 
-func (m *memLogger) ServeHTTP(w http.ResponseWriter, r *http.Request) {
-	conn, err := gpwebsocket.Initiate(w, r)
+func (m *memLogger) ServeHTTP(c *gin.Context) {
+	manager, err := websocket.NewManagerWithUpgrade(c)
 	if err != nil {
+		c.Error(apitypes.InternalServerError(err, "failed to create websocket manager"))
 		return
 	}
 
@@ -80,20 +79,19 @@ func (m *memLogger) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	m.connChans.Store(logCh, struct{}{})
 
 	defer func() {
-		_ = conn.Close()
-
+		manager.Close()
 		m.notifyLock.Lock()
 		m.connChans.Delete(logCh)
 		close(logCh)
 		m.notifyLock.Unlock()
 	}()
 
-	if err := m.wsInitial(conn); err != nil {
-		http.Error(w, err.Error(), http.StatusInternalServerError)
+	if err := m.wsInitial(manager); err != nil {
+		c.Error(apitypes.InternalServerError(err, "failed to send initial log"))
 		return
 	}
 
-	m.wsStreamLog(r.Context(), conn, logCh)
+	m.wsStreamLog(c.Request.Context(), manager, logCh)
 }
 
 func (m *memLogger) truncateIfNeeded(n int) {
@@ -168,19 +166,14 @@ func (m *memLogger) events() (logs <-chan []byte, cancel func()) {
 	}
 }
 
-func (m *memLogger) writeBytes(conn *websocket.Conn, b []byte) error {
-	_ = conn.SetWriteDeadline(time.Now().Add(10 * time.Second))
-	return conn.WriteMessage(websocket.TextMessage, b)
-}
-
-func (m *memLogger) wsInitial(conn *websocket.Conn) error {
+func (m *memLogger) wsInitial(manager *websocket.Manager) error {
 	m.Lock()
 	defer m.Unlock()
 
-	return m.writeBytes(conn, m.Bytes())
+	return manager.WriteData(websocket.TextMessage, m.Bytes(), writeTimeout)
 }
 
-func (m *memLogger) wsStreamLog(ctx context.Context, conn *websocket.Conn, ch <-chan *logEntryRange) {
+func (m *memLogger) wsStreamLog(ctx context.Context, manager *websocket.Manager, ch <-chan *logEntryRange) {
 	for {
 		select {
 		case <-ctx.Done():
@@ -188,7 +181,7 @@ func (m *memLogger) wsStreamLog(ctx context.Context, conn *websocket.Conn, ch <-
 		case logRange := <-ch:
 			m.RLock()
 			msg := m.Bytes()[logRange.Start:logRange.End]
-			err := m.writeBytes(conn, msg)
+			err := manager.WriteData(websocket.TextMessage, msg, writeTimeout)
 			m.RUnlock()
 			if err != nil {
 				return