feat: SEO backend output (2/4)

api/handlers/article/articleHandler.go

@@ -16,6 +16,7 @@ import (
 	"log"
 	"net/http"
 	"net/url"
+	"slices"
 	"strconv"
 	"strings"
 	"time"
@@ -79,8 +80,10 @@ type articleResponse struct {
 
 type listItemResponse struct {
 	baseArticleResponse
-	Excerpt string `json:"excerpt"`
-	Slug    string `json:"slug"`
+	Excerpt        string `json:"excerpt"`
+	Slug           string `json:"slug"`
+	SEOStatus      string `json:"seo_status"`
+	SEOSuggestions int    `json:"seo_suggestions"`
 }
 
 func toBaseResponse(article domain.Article, format domain.BodyFormat) (baseArticleResponse, error) {
@@ -135,12 +138,12 @@ func toArticleResponse(article domain.Article, format domain.BodyFormat) (articl
 	}, nil
 }
 
-func toListItemResponse(article domain.Article, format domain.BodyFormat) (listItemResponse, error) {
+func toListItemResponse(article domain.Article, summary domain.SEOSummary, format domain.BodyFormat) (listItemResponse, error) {
 	base, err := toBaseResponse(article, format)
 	if err != nil {
 		return listItemResponse{}, err
 	}
-	return listItemResponse{baseArticleResponse: base, Excerpt: article.Excerpt, Slug: article.Slug}, nil
+	return listItemResponse{baseArticleResponse: base, Excerpt: article.Excerpt, Slug: article.Slug, SEOStatus: summary.Status, SEOSuggestions: summary.Suggestions}, nil
 }
 
 func encodeArticle(article domain.Article, format domain.BodyFormat) ([]byte, error) {
@@ -392,6 +395,22 @@ func hasDuplicates(ids []uint32) bool {
 	return false
 }
 
+func countKnownFields(fields map[string]json.RawMessage, nonNullable []string) (int, bool) {
+	known := 0
+	for name, value := range fields {
+		switch {
+		case slices.Contains(nonNullable, name):
+			if string(value) == "null" {
+				return 0, false
+			}
+			known++
+		case slices.Contains(nullableArticleFields, name):
+			known++
+		}
+	}
+	return known, true
+}
+
 func readUpdateArticleBody(r *http.Request) (UpdateArticleBody, bool) {
 	raw, err := io.ReadAll(r.Body)
 	if err != nil {
@@ -401,23 +420,8 @@ func readUpdateArticleBody(r *http.Request) (UpdateArticleBody, bool) {
 	if err := json.Unmarshal(raw, &fields); err != nil {
 		return UpdateArticleBody{}, false
 	}
-	known := 0
-	for _, name := range nonNullableArticleFields {
-		value, present := fields[name]
-		if !present {
-			continue
-		}
-		if string(value) == "null" {
-			return UpdateArticleBody{}, false
-		}
-		known++
-	}
-	for _, name := range nullableArticleFields {
-		if _, present := fields[name]; present {
-			known++
-		}
-	}
-	if known == 0 {
+	known, ok := countKnownFields(fields, nonNullableArticleFields)
+	if !ok || known == 0 {
 		return UpdateArticleBody{}, false
 	}
 	var request UpdateArticleBody
@@ -488,12 +492,16 @@ func (h *Handler) UnpublishArticle(w http.ResponseWriter, r *http.Request) {
 }
 
 func (h *Handler) callerIsVerified(r *http.Request) bool {
+	return isVerifiedCaller(r, h.GetUserUseCase)
+}
+
+func isVerifiedCaller(r *http.Request, getUser *useCases.GetUserUseCase) bool {
 	userId, ok := claims.UserId(r)
 	if !ok {
 		return false
 	}
 
-	currentUser, err := h.GetUserUseCase.GetUser(userId)
+	currentUser, err := getUser.GetUser(userId)
 	if err != nil {
 		return false
 	}
@@ -512,6 +520,7 @@ type listQuery struct {
 	Q      string  `validate:"max=200"`
 	Status string  `validate:"omitempty,oneof=online draft"`
 	Site   *string `validate:"omitempty,min=1"`
+	SEO    string  `validate:"omitempty,oneof=ready suggestions hidden"`
 	Sort   string  `validate:"oneof=title:asc title:desc status:asc status:desc created_at:asc created_at:desc updated_at:asc updated_at:desc"`
 }
 
@@ -562,7 +571,11 @@ func readListQuery(values url.Values) (listQuery, error) {
 		}
 		siteKey = &key
 	}
-	return listQuery{Page: page, Size: size, Q: values.Get("q"), Status: status, Sort: sortValue, Site: siteKey}, nil
+	seoStatus := values.Get("seo")
+	if values.Has("seo") && seoStatus == "" {
+		return listQuery{}, errors.New("empty seo")
+	}
+	return listQuery{Page: page, Size: size, Q: values.Get("q"), Status: status, Sort: sortValue, Site: siteKey, SEO: seoStatus}, nil
 }
 
 func (h *Handler) ListArticles(w http.ResponseWriter, r *http.Request) {
@@ -586,6 +599,7 @@ func (h *Handler) ListArticles(w http.ResponseWriter, r *http.Request) {
 		Status:   query.Status,
 		Sort:     parseSort(query.Sort),
 		SiteKey:  query.Site,
+		SEO:      query.SEO,
 	})
 	if err != nil {
 		http.Error(w, "Failed to retrieve articles", http.StatusInternalServerError)
@@ -594,7 +608,7 @@ func (h *Handler) ListArticles(w http.ResponseWriter, r *http.Request) {
 
 	responses := make([]listItemResponse, 0, len(page.Items))
 	for _, article := range page.Items {
-		response, err := toListItemResponse(article, format)
+		response, err := toListItemResponse(article, page.SEO[article.ID], format)
 		if err != nil {
 			http.Error(w, "Failed to encode response", http.StatusInternalServerError)
 			return