feat: spellcheck engine migration to LanguageTool with batch support

Author: Kinnouts

apps/api/services/text/spellcheck/service.go

@@ -72,19 +72,16 @@ func (s *Service) Check(text string) (Result, error) {
 // CheckBatch processes multiple texts and returns spell-check results for each.
 // It returns an error only if LanguageTool is unreachable; individual texts do
 // not produce per-item errors.
-func (s *Service) CheckBatch(texts []string) (BatchCheckResponse, error) {
+func (s *Service) CheckBatch(texts []string) ([]Result, error) {
 	results := make([]Result, 0, len(texts))
 	for _, text := range texts {
 		result, err := s.Check(text)
 		if err != nil {
-			return BatchCheckResponse{}, err
+			return nil, err
 		}
 		results = append(results, result)
 	}
-	return BatchCheckResponse{
-		Results: results,
-		Total:   len(results),
-	}, nil
+	return results, nil
 }
 
 // buildResult converts LanguageTool matches into our Result type.

apps/api/services/text/spellcheck/transport_http.go

@@ -17,9 +17,12 @@ func RegisterRoutes(r chi.Router, svc *Service) {
 	))
 
 	r.Post("/spellcheck/batch", httpx.HandleBatch(
-		func(_ context.Context, req BatchCheckRequest) (BatchCheckResponse, int, error) {
-			res, err := svc.CheckBatch(req.Texts)
-			return res, len(req.Texts), err
+		func(_ context.Context, req BatchCheckRequest) (BatchCheckResponse, error) {
+			results, err := svc.CheckBatch(req.Texts)
+			if err != nil {
+				return BatchCheckResponse{}, err
+			}
+			return BatchCheckResponse{Results: results}, nil
 		},
 	))
 }

apps/api/services/text/spellcheck/type.go

@@ -1,5 +1,7 @@
 package spellcheck
 
+import "requiems-api/platform/httpx"
+
 // Request is the input for the spell check endpoint.
 type Request struct {
 	Text string `json:"text" validate:"required"`
@@ -29,10 +31,5 @@ type BatchCheckRequest struct {
 	Texts []string `json:"texts" validate:"required,min=1,max=50,dive,required"`
 }
 
-// BatchCheckResponse is the response for a batch spell check request.
-type BatchCheckResponse struct {
-	Results []Result `json:"results"`
-	Total   int      `json:"total"`
-}
-
-func (BatchCheckResponse) IsData() {}
+// BatchCheckResponse is the standard batch envelope for spell-check results.
+type BatchCheckResponse = httpx.BatchResponse[Result]