From cc38042f630dd399d96d183a6bb4c36cb90d0ba0 Mon Sep 17 00:00:00 2001
From: Luke Hagar <lukeslakemail@gmail.com>
Date: Mon, 3 Jul 2023 15:34:40 -0500
Subject: [PATCH] Added Timeline endpoint

---
 pms/paths/timeline.yaml | 95 +++++++++++++++++++++++++++++++++++++++++
 pms/pms-spec.yaml       |  6 +++
 2 files changed, 101 insertions(+)
 create mode 100644 pms/paths/timeline.yaml

diff --git a/pms/paths/timeline.yaml b/pms/paths/timeline.yaml
new file mode 100644
index 00000000..c44c2ee8
--- /dev/null
+++ b/pms/paths/timeline.yaml
@@ -0,0 +1,95 @@
+get:
+  tags:
+    - Video
+  summary: Get the timeline for a media item
+  description: Get the timeline for a media item
+  operationId: getTimeline
+  parameters: 
+
+    - name: ratingKey
+      description: The rating key of the media item
+      required: true
+      in: query
+      schema: number
+      example: 23409
+      
+    - name: key
+      description: The key of the media item to get the timeline for
+      required: true
+      in: query
+      schema: string
+      example: "/library/metadata/23409"
+
+    - name: state
+      description: The state of the media item
+      required: true
+      in: query
+      schema: 
+        type: string
+        enum: ["playing", "paused", "stopped"]
+      example: "playing"
+
+    - name: hasMDE
+      description: Whether the media item has MDE
+      required: true
+      in: query
+      schema: number
+      example: 1
+
+    - name: time
+      description: The time of the media item
+      required: true
+      in: query
+      schema: number
+      example: 2000
+
+    - name: duration
+      description: The duration of the media item
+      required: true
+      in: query
+      schema: number
+      example: 10000
+
+    - name: context
+      description: The context of the media item
+      required: true
+      in: query
+      schema: string
+      example: "home:hub.continueWatching"
+
+    - name: playQueueItemID
+      description: The play queue item ID of the media item
+      required: true
+      in: query
+      schema: number
+      example: 1
+
+    - name: playBackTime
+      description: The playback time of the media item
+      required: true
+      in: query
+      schema: number
+      example: 2000
+
+    - name: row
+      description: The row of the media item
+      required: true
+      in: query
+      schema: number
+      example: 1
+
+    - name: ratingKey
+      description: The rating key of the media item
+      required: true
+      in: query
+      schema: number
+      example: 23409
+
+  responses:
+    "200":
+      description: The timeline for the media item
+
+    "400":
+      $ref: "../../responses/400.yaml"
+    "401":
+      $ref: "../../responses/401.yaml"
diff --git a/pms/pms-spec.yaml b/pms/pms-spec.yaml
index 79728eda..aa0a25fa 100644
--- a/pms/pms-spec.yaml
+++ b/pms/pms-spec.yaml
@@ -199,6 +199,12 @@ paths:
   /updater/apply:
     $ref: "./paths/updater-apply.yaml"
 
+  /video/:/transcode/universal/start.mpd:
+    $ref: "./paths/video-transcode-universal-start.yaml"
+
+  /:/timeline:
+    $ref: "./paths/timeline.yaml"
+
 tags:
   - name: Activities
     description: |