package handlers import ( "net/http" "galaxy/rtmanager/internal/domain/operation" "galaxy/rtmanager/internal/service/startruntime" ) // startRequestBody mirrors the OpenAPI StartRequest schema. Only // `image_ref` is accepted; unknown fields are rejected by // decodeStrictJSON. type startRequestBody struct { ImageRef string `json:"image_ref"` } // newStartHandler returns the handler for // `POST /api/v1/internal/runtimes/{game_id}/start`. The handler // delegates the entire lifecycle to `startruntime.Service`; failure // codes are mapped to HTTP statuses via mapErrorCodeToStatus. func newStartHandler(deps Dependencies) http.HandlerFunc { logger := loggerFor(deps.Logger, "internal_rest.start") return func(writer http.ResponseWriter, request *http.Request) { if deps.StartRuntime == nil { writeError(writer, http.StatusInternalServerError, startruntime.ErrorCodeInternal, "start runtime service is not wired", ) return } gameID, ok := extractGameID(writer, request) if !ok { return } var body startRequestBody if err := decodeStrictJSON(request.Body, &body); err != nil { writeError(writer, http.StatusBadRequest, startruntime.ErrorCodeInvalidRequest, err.Error(), ) return } result, err := deps.StartRuntime.Handle(request.Context(), startruntime.Input{ GameID: gameID, ImageRef: body.ImageRef, OpSource: resolveOpSource(request), SourceRef: requestSourceRef(request), }) if err != nil { logger.ErrorContext(request.Context(), "start runtime service errored", "game_id", gameID, "err", err.Error(), ) writeError(writer, http.StatusInternalServerError, startruntime.ErrorCodeInternal, "start runtime service failed", ) return } if result.Outcome == operation.OutcomeFailure { writeFailure(writer, result.ErrorCode, result.ErrorMessage) return } writeJSON(writer, http.StatusOK, encodeRuntimeRecord(result.Record)) } }