package httpapi import ( "encoding/json" "errors" "net/http" "speech-learning-api/internal/domain" "speech-learning-api/internal/services" "strings" ) type errorResponse struct { Error string `json:"error"` Code string `json:"code"` } func writeJSON(w http.ResponseWriter, status int, value any) { w.Header().Set("Content-Type", "application/json") w.WriteHeader(status) _ = json.NewEncoder(w).Encode(value) } func writeError(w http.ResponseWriter, status int, err error) { if err == nil { err = errors.New(http.StatusText(status)) } writeJSON(w, status, errorResponse{Error: err.Error(), Code: errorCode(status, err)}) } // Codes are presentation contracts; provider diagnostics remain in the error field. func errorCode(status int, err error) string { switch { case errors.Is(err, domain.ErrNativeLanguageUnsupported): return "native_language_unsupported" case errors.Is(err, domain.ErrNativeLanguageConflict): return "native_language_conflict" case errors.Is(err, services.ErrInvalidCredentials): return "invalid_credentials" case err.Error() == "valid email is required": return "invalid_email" case err.Error() == "password must be at least 8 characters": return "password_too_short" case strings.Contains(err.Error(), "duplicate key") && strings.Contains(err.Error(), "email"): return "email_in_use" } switch status { case 400, 422: return "invalid_request" case 401: return "authentication_required" case 403: return "access_denied" case 404: return "not_found" case 409: return "operation_conflict" case 413: return "upload_too_large" case 415: return "unsupported_audio_format" case 429: return "rate_limited" case 502, 503: return "service_unavailable" case 408, 504: return "request_timeout" default: return "internal_error" } } func decodeJSON(r *http.Request, dst any) error { defer r.Body.Close() return json.NewDecoder(r.Body).Decode(dst) }