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/homepage/homepage.go

@@ -8,8 +8,8 @@ import (
 )
 
 type (
-	Homepage map[string]Category
-	Category []*Item
+	Homepage map[string]Category // @name HomepageItems
+	Category []*Item             // @name HomepageCategory
 
 	ItemConfig struct {
 		Show        bool     `json:"show"`
@@ -23,6 +23,7 @@ type (
 
 	Item struct {
 		*ItemConfig
+
 		WidgetConfig *widgets.Config `json:"widget_config,omitempty" aliases:"widget"`
 
 		Alias     string `json:"alias"`

internal/homepage/list_icons.go

@@ -150,9 +150,9 @@ func ListAvailableIcons() (*Cache, error) {
 	return iconsCache, nil
 }
 
-func SearchIcons(keyword string, limit int) ([]IconMetaSearch, error) {
+func SearchIcons(keyword string, limit int) []IconMetaSearch {
 	if keyword == "" {
-		return make([]IconMetaSearch, 0), nil
+		return make([]IconMetaSearch, 0)
 	}
 	iconsCache.RLock()
 	defer iconsCache.RUnlock()
@@ -174,7 +174,7 @@ func SearchIcons(keyword string, limit int) ([]IconMetaSearch, error) {
 			break
 		}
 	}
-	return result, nil
+	return result
 }
 
 func HasIcon(icon *IconURL) bool {