FEAT: Added MOre Video Statuses

2026-08-17 00:13:22 +03:00
parent 4b719f712d
commit aa32bb6ed8
10 changed files with 216 additions and 146 deletions
@@ -0,0 +1,48 @@
+package api
+
+import "time"
+
+// CategoriesResponse is the body of GET /api/categories.
+type CategoriesResponse struct {
+	Categories []string `json:"categories" example:"documentary,news"`
+}
+
+// PresignRequest is the body of POST /api/videos/presign.
+type PresignRequest struct {
+	FileName    string `json:"fileName" example:"interview-cut.mov"`
+	ContentType string `json:"contentType" enums:"video/mp4,video/quicktime" example:"video/quicktime"`
+}
+
+// PresignResponse is the body returned by POST /api/videos/presign.
+type PresignResponse struct {
+	UploadURL string `json:"uploadUrl" example:"https://raw-uploads-bucket.s3.amazonaws.com/videos/a1b2....mov?X-Amz-Signature=..."`
+	Key       string `json:"key" example:"videos/a1b2c3d4e5f6.mov"`
+}
+
+// CompleteRequest is the body of POST /api/videos.
+type CompleteRequest struct {
+	Title       string   `json:"title" example:"Inside the Newsroom"`
+	Description string   `json:"description" example:"A behind-the-scenes look at the evening bulletin."`
+	Categories  []string `json:"categories" example:"documentary,news"`
+	Tags        string   `json:"tags" example:"media, press, riyadh"`
+	FileName    string   `json:"fileName" example:"interview-cut.mov"`
+	Key         string   `json:"key" example:"videos/a1b2c3d4e5f6.mov"`
+}
+
+// VideoResponse is a persisted video record as returned by POST /api/videos.
+// Status carries the values of services.VideoStatus; the enums tag has to be
+// widened by hand whenever that type gains a state.
+type VideoResponse struct {
+	ID                string    `json:"id" example:"0199f3a1-7c2e-7b21-9f0d-1a2b3c4d5e6f"`
+	Title             string    `json:"title" example:"Inside the Newsroom"`
+	Description       string    `json:"description" example:"A behind-the-scenes look at the evening bulletin."`
+	Categories        []string  `json:"categories" example:"documentary,news"`
+	Tags              string    `json:"tags" example:"media, press, riyadh"`
+	FileName          string    `json:"fileName" example:"interview-cut.mov"`
+	StorageKey        string    `json:"storageKey" example:"videos/a1b2c3d4e5f6.mov"`
+	MediaConvertJobID string    `json:"mediaConvertJobId" example:"1755300000000-abcdef"`
+	Status            string    `json:"status" enums:"processing,ready,failed" example:"processing"`
+	SizeBytes         int64     `json:"sizeBytes" example:"60"`
+	CreatedAt         time.Time `json:"createdAt"`
+	UpdatedAt         time.Time `json:"updatedAt"`
+}