Add t-timers info to LSG

Author: anteeek

packages/live-status-gateway-api/api/components/playlist/activePlaylistEvent/activePlaylistEvent-example.yaml

@@ -15,3 +15,18 @@ timing:
   $ref: '../../timing/activePlaylistTiming/activePlaylistTiming-example.yaml'
 quickLoop:
   $ref: '../../quickLoop/activePlaylistQuickLoop/activePlaylistQuickLoop-example.yaml'
+tTimers:
+  - index: 1
+    label: 'On Air Timer'
+    configured: true
+    mode:
+      $ref: '../../tTimers/tTimerMode/tTimerModeCountdown-example.yaml'
+  - index: 2
+    label: ''
+    configured: false
+    mode: null
+  - index: 3
+    label: 'Studio Clock'
+    configured: true
+    mode:
+      $ref: '../../tTimers/tTimerMode/tTimerModeFreeRun-example.yaml'

packages/live-status-gateway-api/api/components/playlist/activePlaylistEvent/activePlaylistEvent.yaml

@@ -44,7 +44,14 @@ $defs:
         $ref: '../../timing/activePlaylistTiming/activePlaylistTiming.yaml#/$defs/activePlaylistTiming'
       quickLoop:
         $ref: '../../quickLoop/activePlaylistQuickLoop/activePlaylistQuickLoop.yaml#/$defs/activePlaylistQuickLoop'
-    required: [event, id, externalId, name, rundownIds, currentPart, currentSegment, nextPart, timing]
+      tTimers:
+        description: T-timers for the playlist. Always contains 3 elements (one for each timer slot).
+        type: array
+        items:
+          $ref: '../../tTimers/tTimerStatus/tTimerStatus.yaml#/$defs/tTimerStatus'
+        minItems: 3
+        maxItems: 3
+    required: [event, id, externalId, name, rundownIds, currentPart, currentSegment, nextPart, timing, tTimers]
     additionalProperties: false
     examples:
       - $ref: './activePlaylistEvent-example.yaml'

packages/live-status-gateway-api/api/components/tTimers/tTimerIndex.yaml

@@ -0,0 +1,6 @@
+$defs:
+  tTimerIndex:
+    type: integer
+    title: TTimerIndex
+    description: Timer index (1-3). The playlist always has 3 T-timer slots.
+    enum: [1, 2, 3]

packages/live-status-gateway-api/api/components/tTimers/tTimerMode/tTimerMode.yaml

@@ -0,0 +1,55 @@
+$defs:
+  tTimerModeCountdown:
+    type: object
+    title: TTimerModeCountdown
+    description: Countdown timer mode - counts down from a duration
+    properties:
+      type:
+        type: string
+        const: countdown
+      startTime:
+        description: Unix timestamp when timer started (milliseconds). May be adjusted when pausing/resuming.
+        type: number
+      pauseTime:
+        description: Unix timestamp when paused (milliseconds), or null if running
+        oneOf:
+          - type: number
+          - type: 'null'
+      durationMs:
+        description: Total countdown duration in milliseconds
+        type: number
+      stopAtZero:
+        description: Whether timer stops at zero or continues into negative values
+        type: boolean
+    required: [type, startTime, pauseTime, durationMs, stopAtZero]
+    additionalProperties: false
+    examples:
+      - $ref: './tTimerModeCountdown-example.yaml'
+
+  tTimerModeFreeRun:
+    type: object
+    title: TTimerModeFreeRun
+    description: Free-running timer mode - counts up from start time
+    properties:
+      type:
+        type: string
+        const: freeRun
+      startTime:
+        description: Unix timestamp when timer started (milliseconds). May be adjusted when pausing/resuming.
+        type: number
+      pauseTime:
+        description: Unix timestamp when paused (milliseconds), or null if running
+        oneOf:
+          - type: number
+          - type: 'null'
+    required: [type, startTime, pauseTime]
+    additionalProperties: false
+    examples:
+      - $ref: './tTimerModeFreeRun-example.yaml'
+
+  tTimerMode:
+    title: TTimerMode
+    description: The mode/state of a T-timer
+    oneOf:
+      - $ref: '#/$defs/tTimerModeCountdown'
+      - $ref: '#/$defs/tTimerModeFreeRun'

packages/live-status-gateway-api/api/components/tTimers/tTimerMode/tTimerModeCountdown-example.yaml

@@ -0,0 +1,5 @@
+type: countdown
+startTime: 1706371800000
+pauseTime: null
+durationMs: 120000
+stopAtZero: true

packages/live-status-gateway-api/api/components/tTimers/tTimerMode/tTimerModeFreeRun-example.yaml

@@ -0,0 +1,3 @@
+type: freeRun
+startTime: 1706371900000
+pauseTime: 1706372000000

packages/live-status-gateway-api/api/components/tTimers/tTimerStatus/tTimerStatus-example.yaml

@@ -0,0 +1,9 @@
+index: 1
+label: 'Segment Timer'
+configured: true
+mode:
+  type: countdown
+  startTime: 1706371800000
+  pauseTime: null
+  durationMs: 120000
+  stopAtZero: true

packages/live-status-gateway-api/api/components/tTimers/tTimerStatus/tTimerStatus.yaml

@@ -0,0 +1,23 @@
+$defs:
+  tTimerStatus:
+    type: object
+    title: TTimerStatus
+    description: Status of a single T-timer in the playlist
+    properties:
+      index:
+        $ref: '../tTimerIndex.yaml#/$defs/tTimerIndex'
+      label:
+        description: User-defined label for the timer
+        type: string
+      configured:
+        description: Whether the timer has been configured (mode is not null)
+        type: boolean
+      mode:
+        description: Timer mode and timing state. Null if not configured.
+        oneOf:
+          - type: 'null'
+          - $ref: '../tTimerMode/tTimerMode.yaml#/$defs/tTimerMode'
+    required: [index, label, configured]
+    additionalProperties: false
+    examples:
+      - $ref: './tTimerStatus-example.yaml'