FEAT: Update Status Of Video Row On Media Convert Update

cms/docs/docs.go

@@ -157,6 +157,47 @@ const docTemplate = `{
                 }
             }
         },
+        "/api/videos/{id}": {
+            "get": {
+                "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.",
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "videos"
+                ],
+                "summary": "Read a video",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "The video's id, as returned by POST /api/videos",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/api.VideoResponse"
+                        }
+                    },
+                    "404": {
+                        "description": "No video has that id",
+                        "schema": {
+                            "$ref": "#/definitions/api.ProblemDetails"
+                        }
+                    },
+                    "500": {
+                        "description": "The video could not be read from the database",
+                        "schema": {
+                            "$ref": "#/definitions/api.ProblemDetails"
+                        }
+                    }
+                }
+            }
+        },
         "/health": {
             "get": {
                 "description": "Reports that the service is up and serving. Used as the ALB target group health check; it does not verify the database or S3 connections.",
@@ -359,6 +400,68 @@ const docTemplate = `{
                     "example": "about:blank"
                 }
             }
+        },
+        "api.VideoResponse": {
+            "type": "object",
+            "properties": {
+                "categoryIds": {
+                    "type": "array",
+                    "items": {
+                        "type": "integer"
+                    },
+                    "example": [
+                        1,
+                        2
+                    ]
+                },
+                "createdAt": {
+                    "type": "string"
+                },
+                "description": {
+                    "type": "string",
+                    "example": "A behind-the-scenes look at the evening bulletin."
+                },
+                "fileName": {
+                    "type": "string",
+                    "example": "interview-cut.mov"
+                },
+                "id": {
+                    "type": "string",
+                    "example": "0199f3a1-7c2e-7b21-9f0d-1a2b3c4d5e6f"
+                },
+                "mediaConvertJobId": {
+                    "type": "string",
+                    "example": "1755300000000-abcdef"
+                },
+                "sizeBytes": {
+                    "type": "integer",
+                    "example": 60
+                },
+                "status": {
+                    "type": "string",
+                    "enum": [
+                        "processing",
+                        "ready",
+                        "failed"
+                    ],
+                    "example": "processing"
+                },
+                "storageKey": {
+                    "type": "string",
+                    "example": "videos/a1b2c3d4e5f6.mov"
+                },
+                "tags": {
+                    "type": "string",
+                    "example": "media, press, riyadh"
+                },
+                "title": {
+                    "type": "string",
+                    "example": "Inside the Newsroom"
+                },
+                "updatedAt": {
+                    "type": "string"
+                }
+            }
         }
     }
 }`