Add races results GET endpoints (by ID and last finished) and regenerate swagger specs

server/cmd/poc-server/main.go

@@ -300,6 +300,8 @@ func main() {
 	mux.HandleFunc("/api/cars", carsRouter(cat))
 	mux.HandleFunc("/api/cars/", carByIDHandler(cat))
 	mux.HandleFunc("/api/races", racesListHandler(racesSvc))
+	mux.HandleFunc("/api/races/last", racesGetLastHandler(racesSvc))
+	mux.HandleFunc("/api/races/", racesGetHandler(racesSvc))
 	mux.HandleFunc("/api/races/upcoming", racesUpcomingHandler(racesSvc))
 	mux.HandleFunc("/api/races/queue", racesQueueRouter(racesSvc))
 	mux.HandleFunc("/api/races/queue/join", racesQueueJoinHandler(racesSvc))

server/cmd/poc-server/races_handlers.go

@@ -90,6 +90,100 @@ func racesListHandler(svc *races.Service) http.HandlerFunc {
 	}
 }
 
+// racesGetLastHandler godoc
+// @Summary      Get the results of the last finished race
+// @Description  Returns the details and podium/results of the most recently finished race.
+// @Tags         races
+// @Produce      json
+// @Success      200 {object} transport.LobbyRace "Last race results"
+// @Failure      404 {object} map[string]interface{}     "No finished races found"
+// @Failure      500 {object} map[string]interface{}     "Internal server error"
+// @Router       /api/races/last [get]
+func racesGetLastHandler(svc *races.Service) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		res, err := svc.GetLastFinished(r.Context())
+		if err != nil {
+			if errors.Is(err, races.ErrNotFound) {
+				writeError(w, http.StatusNotFound, "not_found", "no finished races found")
+				return
+			}
+			writeError(w, http.StatusInternalServerError, "internal", err.Error())
+			return
+		}
+
+		var out transport.LobbyRace
+		meta := lobby.RaceMeta{
+			ID:         res.ID,
+			Name:       res.Name,
+			TrackID:    res.TrackID,
+			MaxCars:    res.MaxCars,
+			Laps:       res.Laps,
+			TimeLimitS: res.TimeLimitS,
+			DriverIDs:  res.DriverIDs,
+			Status:     lobby.RaceStatus(res.Status),
+			CreatedMs:  res.CreatedMs,
+			StartedMs:  res.StartedMs,
+		}
+		if len(res.Podium) > 0 {
+			out = lobbyToWireFinished(meta, res.Podium)
+		} else {
+			out = lobbyToWire(meta)
+		}
+		writeJSON(w, http.StatusOK, out)
+	}
+}
+
+// racesGetHandler godoc
+// @Summary      Get results of a specific race by ID
+// @Description  Returns details of a single race by its ID. Works for both live and finished races.
+// @Tags         races
+// @Produce      json
+// @Param        id path string true "Race ID"
+// @Success      200 {object} transport.LobbyRace "Race details"
+// @Failure      400 {object} map[string]interface{}     "Missing race id"
+// @Failure      404 {object} map[string]interface{}     "Race not found"
+// @Failure      500 {object} map[string]interface{}     "Internal server error"
+// @Router       /api/races/{id} [get]
+func racesGetHandler(svc *races.Service) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		id := strings.TrimPrefix(r.URL.Path, "/api/races/")
+		if id == "" || strings.Contains(id, "/") {
+			writeError(w, http.StatusBadRequest, "bad_request", "missing race id")
+			return
+		}
+		res, err := svc.GetRace(r.Context(), id)
+		if err != nil {
+			if errors.Is(err, races.ErrNotFound) {
+				writeError(w, http.StatusNotFound, "not_found", "race not found")
+				return
+			}
+			writeError(w, http.StatusInternalServerError, "internal", err.Error())
+			return
+		}
+
+		var out transport.LobbyRace
+		meta := lobby.RaceMeta{
+			ID:         res.ID,
+			Name:       res.Name,
+			TrackID:    res.TrackID,
+			MaxCars:    res.MaxCars,
+			Laps:       res.Laps,
+			TimeLimitS: res.TimeLimitS,
+			DriverIDs:  res.DriverIDs,
+			Status:     lobby.RaceStatus(res.Status),
+			CreatedMs:  res.CreatedMs,
+			StartedMs:  res.StartedMs,
+		}
+		if len(res.Podium) > 0 {
+			out = lobbyToWireFinished(meta, res.Podium)
+		} else {
+			out = lobbyToWire(meta)
+		}
+		writeJSON(w, http.StatusOK, out)
+	}
+}
+
+
 func parseRaceListFilter(r *http.Request) (races.ListFilter, error) {
 	q := r.URL.Query()
 	cur, err := races.DecodeCursor(q.Get("cursor"))