feat: gamemaster

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

@@ -0,0 +1,81 @@
+package handlers
+
+import (
+	"net/http"
+
+	"galaxy/gamemaster/internal/domain/operation"
+	"galaxy/gamemaster/internal/service/registerruntime"
+)
+
+// registerRuntimeRequestBody mirrors the OpenAPI
+// RegisterRuntimeRequest schema. Strict decoding rejects unknown
+// fields.
+type registerRuntimeRequestBody struct {
+	EngineEndpoint      string                       `json:"engine_endpoint"`
+	Members             []registerRuntimeMemberBody  `json:"members"`
+	TargetEngineVersion string                       `json:"target_engine_version"`
+	TurnSchedule        string                       `json:"turn_schedule"`
+}
+
+// registerRuntimeMemberBody mirrors the OpenAPI
+// RegisterRuntimeMember schema.
+type registerRuntimeMemberBody struct {
+	UserID   string `json:"user_id"`
+	RaceName string `json:"race_name"`
+}
+
+// newRegisterRuntimeHandler returns the handler for
+// `POST /api/v1/internal/games/{game_id}/register-runtime`.
+func newRegisterRuntimeHandler(deps Dependencies) http.HandlerFunc {
+	logger := loggerFor(deps.Logger, "internal_rest.register_runtime")
+	return func(writer http.ResponseWriter, request *http.Request) {
+		if deps.RegisterRuntime == nil {
+			writeError(writer, http.StatusInternalServerError, errorCodeInternal, "register runtime service is not wired")
+			return
+		}
+
+		gameID, ok := extractGameID(writer, request)
+		if !ok {
+			return
+		}
+
+		var body registerRuntimeRequestBody
+		if err := decodeStrictJSON(request.Body, &body); err != nil {
+			writeError(writer, http.StatusBadRequest, errorCodeInvalidRequest, err.Error())
+			return
+		}
+
+		members := make([]registerruntime.Member, 0, len(body.Members))
+		for _, member := range body.Members {
+			members = append(members, registerruntime.Member{
+				UserID:   member.UserID,
+				RaceName: member.RaceName,
+			})
+		}
+
+		result, err := deps.RegisterRuntime.Handle(request.Context(), registerruntime.Input{
+			GameID:              gameID,
+			EngineEndpoint:      body.EngineEndpoint,
+			Members:             members,
+			TargetEngineVersion: body.TargetEngineVersion,
+			TurnSchedule:        body.TurnSchedule,
+			OpSource:            resolveOpSource(request),
+			SourceRef:           requestSourceRef(request),
+		})
+		if err != nil {
+			logger.ErrorContext(request.Context(), "register runtime service errored",
+				"game_id", gameID,
+				"err", err.Error(),
+			)
+			writeError(writer, http.StatusInternalServerError, errorCodeInternal, "register runtime service failed")
+			return
+		}
+
+		if result.Outcome == operation.OutcomeFailure {
+			writeFailure(writer, result.ErrorCode, result.ErrorMessage)
+			return
+		}
+
+		writeJSON(writer, http.StatusOK, encodeRuntimeRecord(result.Record))
+	}
+}