FEAT: Update Status Of Video Row On Media Convert Update

cms/internal/handlers/videos.go

@@ -17,6 +17,8 @@ import (
 	"thamanyah/cms/v2/internal/models"
 	"thamanyah/cms/v2/internal/services"
 	"time"
+
+	"github.com/google/uuid"
 )
 
 const (
@@ -253,3 +255,62 @@ func randomFilename(original string) (string, error) {
 	}
 	return hex.EncodeToString(buf) + ext, nil
 }
+
+// GetVideo returns one video by its id.
+//
+//	@Summary		Read a video
+//	@Description	Returns the catalogue record for one video, including the status its transcoding job has reached. This is how a client follows an upload after POST /api/videos: the record starts "processing" and moves to "ready" or "failed" once MediaConvert reports the job finished.
+//	@Tags			videos
+//	@Produce		json
+//	@Param			id	path		string	true	"The video's id, as returned by POST /api/videos"
+//	@Success		200	{object}	api.VideoResponse
+//	@Failure		404	{object}	api.ProblemDetails	"No video has that id"
+//	@Failure		500	{object}	api.ProblemDetails	"The video could not be read from the database"
+//	@Router			/api/videos/{id} [get]
+func GetVideo(w http.ResponseWriter, r *http.Request) {
+	id := r.PathValue("id")
+
+	// Parsed before the query, because Postgres rejects anything that is not a
+	// uuid the moment it is compared against the column rather than simply
+	// matching no row — which would surface as a 500. An id that cannot name a
+	// video is a video that does not exist.
+	//
+	// The parsed value, not the raw one, is what goes to the database: uuid
+	// accepts spellings Postgres will not take verbatim — notably the
+	// "urn:uuid:" form — and String() puts them all back into the canonical
+	// form the column holds.
+	videoID, err := uuid.Parse(id)
+	if err != nil {
+		writeProblem(w, http.StatusNotFound, "Video Not Found",
+			fmt.Sprintf("No video has the id %q. Use the 'id' returned by POST /api/videos.", id))
+		return
+	}
+
+	video, err := repositories.VideoRepo.GetVideoByID(r.Context(), videoID.String())
+	if errors.Is(err, repositories.ErrVideoNotFound) {
+		writeProblem(w, http.StatusNotFound, "Video Not Found",
+			fmt.Sprintf("No video has the id %q. Use the 'id' returned by POST /api/videos.", id))
+		return
+	}
+	if err != nil {
+		log.Printf("Something Went Wrong Loading The Video: %s", err)
+		writeProblem(w, http.StatusInternalServerError, "Something Went Wrong Loading The Video",
+			"The video could not be read from the database. This is a server-side fault and the request was not processed; retrying in a few moments may succeed.")
+		return
+	}
+
+	writeJSON(w, http.StatusOK, api.VideoResponse{
+		ID:                video.ID,
+		Title:             video.Title,
+		Description:       video.Description,
+		CategoryIDs:       video.CategoryIDs,
+		Tags:              video.Tags,
+		FileName:          video.FileName,
+		StorageKey:        video.StorageKey,
+		MediaConvertJobID: video.MediaConvertJobID,
+		Status:            video.Status.String(),
+		SizeBytes:         video.SizeBytes,
+		CreatedAt:         video.CreatedAt,
+		UpdatedAt:         video.UpdatedAt,
+	})
+}