feat: gamemaster

gamemaster/internal/api/internalhttp/handlers/gameliveness.go

@@ -0,0 +1,50 @@
+package handlers
+
+import (
+	"net/http"
+	"strings"
+
+	"galaxy/gamemaster/internal/service/livenessreply"
+)
+
+// newGameLivenessHandler returns the handler for
+// `GET /api/v1/internal/games/{game_id}/liveness`. The endpoint
+// always responds with 200 + LivenessResponse; Go-level errors
+// returned by the service map to 500 / 503 according to their
+// embedded error code prefix.
+func newGameLivenessHandler(deps Dependencies) http.HandlerFunc {
+	logger := loggerFor(deps.Logger, "internal_rest.game_liveness")
+	return func(writer http.ResponseWriter, request *http.Request) {
+		if deps.GameLiveness == nil {
+			writeError(writer, http.StatusInternalServerError, errorCodeInternal, "game liveness service is not wired")
+			return
+		}
+
+		gameID, ok := extractGameID(writer, request)
+		if !ok {
+			return
+		}
+
+		result, err := deps.GameLiveness.Handle(request.Context(), livenessreply.Input{GameID: gameID})
+		if err != nil {
+			logger.ErrorContext(request.Context(), "game liveness service errored",
+				"game_id", gameID,
+				"err", err.Error(),
+			)
+			switch {
+			case strings.HasPrefix(err.Error(), livenessreply.ErrorCodeInvalidRequest+":"):
+				writeError(writer, http.StatusBadRequest, errorCodeInvalidRequest, err.Error())
+			case strings.HasPrefix(err.Error(), livenessreply.ErrorCodeServiceUnavailable+":"):
+				writeError(writer, http.StatusServiceUnavailable, errorCodeServiceUnavailable, "service unavailable")
+			default:
+				writeError(writer, http.StatusInternalServerError, errorCodeInternal, "game liveness service failed")
+			}
+			return
+		}
+
+		writeJSON(writer, http.StatusOK, livenessResponse{
+			Ready:  result.Ready,
+			Status: string(result.Status),
+		})
+	}
+}