@bbc/sofie-live-status-gateway-api 1.53.0-nightly-bbc-release53-a9ae5e2-20251112-104105.0 → 1.53.0-nightly-release53-20251125-115432-0144543.0

package/api/asyncapi.yaml

@@ -1,20 +1,20 @@
-asyncapi: 2.6.0
-id: 'urn:nrk:no:sofie:live-status-gateway:server'
+asyncapi: '2.6.0'
+id: 'sofie:live-status-gateway:server'
 info:
   title: Sofie Live Status Service
+  version: '2.0.1'
   description: This service provides subscriptions for status updates from Sofie
-  version: 2.0.0
   license:
     name: MIT License
     url: http://opensource.org/licenses/MIT
   contact:
-    name: Sofie TV Automation - NRK Team
+    name: Sofie TV Automation
     url: https://github.com/Sofie-Automation/sofie-core/issues
 
 servers:
   development:
     url: localhost
-    description: Server available without authorisation
+    description: Server available without authorization
     protocol: ws
     protocolVersion: '13'
 
@@ -26,114 +26,24 @@ tags:
   - name: broadcast
 
 channels:
-  /:
-    publish:
-      description: Send messages to the root API
-      operationId: processRootMessage
-      message:
-        oneOf:
-          - $ref: '#/components/messages/ping'
-          - $ref: '#/components/messages/subscribe'
-          - $ref: '#/components/messages/unsubscribe'
-    subscribe:
-      description: Messages that are received from the API
-      operationId: sendRootMessage
-      message:
-        oneOf:
-          - $ref: '#/components/messages/pong'
-          - $ref: '#/components/messages/heartbeat'
-          - $ref: '#/components/messages/subscriptionStatus'
-          - $ref: '#/components/messages/studio'
-          - $ref: '#/components/messages/activePlaylist'
-          - $ref: '#/components/messages/activePieces'
-          - $ref: '#/components/messages/segments'
-          - $ref: '#/components/messages/adLibs'
-          - $ref: '#/components/messages/packages'
-          - $ref: '#/components/messages/buckets'
-components:
-  messages:
-    ping:
-      name: ping
-      messageId: ping
-      summary: Ping server to determine whether connection is alive
-      description: Client can ping server to determine whether connection is alive, server responds with pong. This is an application level ping as opposed to default ping in websockets standard which is server initiated
-      payload:
-        $ref: './schemas/root.yaml#/$defs/ping'
-      x-response:
-        $ref: '#/components/messages/pong'
-    pong:
-      name: pong
-      messageId: pong
-      summary: Pong is a response to ping message
-      description: Server pong response to a ping to determine whether connection is alive. This is an application level pong as opposed to default pong in websockets standard which is sent by client in response to a ping
-      payload:
-        $ref: './schemas/root.yaml#/$defs/pong'
-    heartbeat:
-      name: heartbeat
-      messageId: heartbeat
-      description: Server heartbeat sent if no subscription traffic within 1 second (approximately)
-      payload:
-        $ref: './schemas/root.yaml#/$defs/heartbeat'
-    subscribe:
-      name: subscribe
-      messageId: subscribe
-      description: Subscribe to a topic
-      payload:
-        $ref: './schemas/root.yaml#/$defs/subscribe'
-      x-response:
-        $ref: './schemas/root.yaml#/$defs/subscriptionStatus'
-    unsubscribe:
-      name: unsubscribe
-      messageId: unsubscribe
-      description: Unsubscribe from a topic
-      payload:
-        $ref: './schemas/root.yaml#/$defs/unsubscribe'
-      x-response:
-        $ref: './schemas/root.yaml#/$defs/subscriptionStatus'
-    subscriptionStatus:
-      messageId: subscriptionStatus
-      description: Subscription status response to subscribe or unsubscribe
-      payload:
-        $ref: './schemas/root.yaml#/$defs/subscriptionStatus'
-    studio:
-      name: studio
-      messageId: studioUpdate
-      description: Studio status
-      payload:
-        $ref: './schemas/studio.yaml#/$defs/studio'
-    activePlaylist:
-      name: activePlaylist
-      messageId: activePlaylistUpdate
-      description: Active Playlist status
-      payload:
-        $ref: './schemas/activePlaylist.yaml#/$defs/activePlaylist'
-    activePieces:
-      name: activePieces
-      messageId: activePiecesUpdate
-      summary: Active Pieces status
-      description: Pieces from the active Playlist that are currently active (on air)
-      payload:
-        $ref: './schemas/activePieces.yaml#/$defs/activePieces'
-    segments:
-      name: segments
-      messageId: segmentsUpdate
-      description: Segments in active Playlist
-      payload:
-        $ref: './schemas/segments.yaml#/$defs/segments'
-    adLibs:
-      name: adLibs
-      messageId: adLibsUpdate
-      description: AdLibs in active Playlist
-      payload:
-        $ref: './schemas/adLibs.yaml#/$defs/adLibs'
-    packages:
-      name: packages
-      messageId: packages
-      description: Status of Packages expected by Pieces
-      payload:
-        $ref: './schemas/packages.yaml#/$defs/packages'
-    buckets:
-      name: buckets
-      description: Buckets in Studio
-      payload:
-        $ref: './schemas/buckets.yaml#/$defs/buckets'
+  # As the LSG is websocket only, channels are only used for logical grouping for the generated docs and folder structure.
+  ping:
+    $ref: './topics/ping/pingTopic.yaml'
+  heartbeat:
+    $ref: './topics/heartbeat/heartbeatTopic.yaml'
+  subscriptions:
+    $ref: './topics/subscriptions/subscriptionsTopic.yaml'
+  studio:
+    $ref: './topics/studio/studioTopic.yaml'
+  activePlaylist:
+    $ref: './topics/activePlaylist/activePlaylistTopic.yaml'
+  activePieces:
+    $ref: './topics/activePieces/activePiecesTopic.yaml'
+  segments:
+    $ref: './topics/segments/segmentsTopic.yaml'
+  adLibs:
+    $ref: './topics/adLibs/adLibsTopic.yaml'
+  packages:
+    $ref: './topics/packages/packagesTopic.yaml'
+  buckets:
+    $ref: './topics/buckets/bucketsTopic.yaml'

package/api/components/adLibs/actionType/actionType-example.yaml

@@ -0,0 +1,2 @@
+name: pvw
+label: Preview

package/api/components/adLibs/actionType/actionType.yaml

@@ -0,0 +1,15 @@
+$defs:
+  adLibActionType:
+    title: AdLibActionType
+    type: object
+    properties:
+      name:
+        type: string
+        description: The string to be passed to the ExecuteAdlib function
+      label:
+        type: string
+        description: The label for the AdLib type
+    required: [name, label]
+    additionalProperties: false
+    examples:
+      - $ref: './actionType-example.yaml'

package/api/components/adLibs/adLibBase/adLibBase-example.yaml

@@ -0,0 +1,9 @@
+id: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'
+name: Music video clip
+sourceLayer: Video Clip
+actionType:
+  - $ref: '../actionType/actionType-example.yaml'
+tags: ['music_video']
+publicData:
+  fileName: MV000123.mxf
+optionsSchema: '{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Play Video Clip","type":"object","properties":{"type":"adlib_action_video_clip","label":{"type":"string"},"clipId":{"type":"string"},"vo":{"type":"boolean"},"target":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Object Id","description":"Id of an object sent to Sofie","type":"string"},"duration":{"type":"number","exclusiveMinimum":0},"takeType":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AdLib Action Take Type","type":"string","enum":["take_immediate","queue"]},"transition":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AdLib Action Transition Type","oneOf":[{"type":"object","properties":{"type":"cut"},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":"mix","duration":{"type":"number","exclusiveMinimum":0,"description":"Duration in ms"}},"required":["type","duration"],"additionalProperties":false},{"type":"object","properties":{"type":"wipe","duration":{"type":"number","exclusiveMinimum":0,"description":"Duration in ms"},"patternId":{"type":"string","description":"Type of wipe to use"}},"required":["type","duration","patternId"],"additionalProperties":false},{"type":"object","properties":{"type":"macro","macroId":{"type":"string","description":"Macro template to recall"}},"required":["type","macroId"],"additionalProperties":false}]}},"required":["type","clipId","vo","target"],"additionalProperties":false}"'

package/api/components/adLibs/adLibBase/adLibBase.yaml

@@ -0,0 +1,35 @@
+$defs:
+  adLibBase:
+    title: AdLibBase
+    type: object
+    properties:
+      id:
+        type: string
+        description: Unique id of the AdLib
+      name:
+        type: string
+        description: The user defined AdLib name
+      sourceLayer:
+        type: string
+        description: The source layer name for this AdLib
+      outputLayer:
+        type: string
+        description: The output layer name for this AdLib
+      actionType:
+        type: array
+        description: The available action type names that can be used to modify the execution of the AdLib
+        items:
+          $ref: '../actionType/actionType.yaml#/$defs/adLibActionType'
+      tags:
+        type: array
+        description: Tags attached to this AdLib
+        items:
+          type: string
+      publicData:
+        description: Optional arbitrary data
+      optionsSchema:
+        type: string
+        description: JSON schema definition of the adLib properties that can be modified using the adLibOptions property in executeAdLib
+    required: [id, name, sourceLayer, actionType]
+    examples:
+      - $ref: './adLibBase-example.yaml'

package/api/components/adLibs/adLibStatus/adLibStatus-example.yaml

@@ -0,0 +1,3 @@
+$ref: '../adLibBase/adLibBase-example.yaml'
+segmentId: HsD8_QwE1ZmR5vN3XcK_Ab7y
+partId: JkL3_OpR6WxT1bF8Vq2_Zy9u

package/api/components/adLibs/adLibStatus/adLibStatus.yaml

@@ -0,0 +1,17 @@
+$defs:
+  adLibStatus:
+    title: AdLibStatus
+    allOf:
+      - $ref: '../adLibBase/adLibBase.yaml#/$defs/adLibBase'
+      - type: object
+        title: AdLibStatus
+        properties:
+          segmentId:
+            description: Unique id of the segment this adLib belongs to
+            type: string
+          partId:
+            description: Unique id of the part this adLib belongs to
+            type: string
+        required: [segmentId, partId]
+    examples:
+      - $ref: './adLibStatus-example.yaml'

package/api/components/adLibs/adLibsEvent/adLibsEvent-example.yaml

@@ -0,0 +1,6 @@
+event: 'adLibs'
+rundownPlaylistId: 'OKAgZmZ0Buc99lE_2uPPSKVbMrQ_'
+adLibs:
+  - $ref: '../adLibStatus/adLibStatus-example.yaml'
+globalAdLibs:
+  - $ref: '../globalAdLibStatus/globalAdLibStatus-example.yaml'

package/api/components/adLibs/adLibsEvent/adLibsEvent.yaml

@@ -0,0 +1,29 @@
+$defs:
+  adLibsEvent:
+    type: object
+    title: AdLibsEvent
+    properties:
+      event:
+        type: string
+        const: adLibs
+      rundownPlaylistId:
+        description: Unique id of the rundown playlist, or null if no playlist is active
+        oneOf:
+          - type: string
+            title: Unique id of the rundown playlist
+          - type: 'null'
+            title: Null if no playlist is active
+      adLibs:
+        type: array
+        description: The available AdLibs for this playlist
+        items:
+          $ref: '../adLibStatus/adLibStatus.yaml#/$defs/adLibStatus'
+      globalAdLibs:
+        type: array
+        description: The available Global AdLibs for this playlist
+        items:
+          $ref: '../globalAdLibStatus/globalAdLibStatus.yaml#/$defs/globalAdLibStatus'
+    required: [event, rundownPlaylistId, adLibs, globalAdLibs]
+    additionalProperties: false
+    examples:
+      - $ref: './adLibsEvent-example.yaml'

package/api/components/adLibs/bucketAdLibStatus/bucketAdLibStatus-example.yaml

@@ -0,0 +1,2 @@
+$ref: '../adLibBase/adLibBase-example.yaml'
+externalId: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'

package/api/components/adLibs/bucketAdLibStatus/bucketAdLibStatus.yaml

@@ -0,0 +1,14 @@
+$defs:
+  bucketAdLibStatus:
+    title: BucketAdLibStatus
+    allOf:
+      - $ref: '../adLibBase/adLibBase.yaml#/$defs/adLibBase'
+      - type: object
+        title: BucketAdLibStatus
+        properties:
+          externalId:
+            type: string
+            description: Id of the adLib recognizable by the external source. Unique within a bucket.
+        required: [externalId]
+    examples:
+      - $ref: './bucketAdLibStatus-example.yaml'

package/api/components/adLibs/globalAdLibStatus/globalAdLibStatus-example.yaml

@@ -0,0 +1 @@
+$ref: '../adLibBase/adLibBase-example.yaml'

package/api/components/adLibs/globalAdLibStatus/globalAdLibStatus.yaml

@@ -0,0 +1,7 @@
+$defs:
+  globalAdLibStatus:
+    title: GlobalAdLibStatus
+    allOf:
+      - $ref: '../adLibBase/adLibBase.yaml#/$defs/adLibBase'
+    examples:
+      - $ref: './globalAdLibStatus-example.yaml'

package/api/components/adLibs/messages/adLibsMessage.yaml

@@ -0,0 +1,10 @@
+components:
+  messages:
+    adLibsMessage:
+      messageId: adLibs
+      title: AdLibs Event Message
+      payload:
+        $ref: '../adLibsEvent/adLibsEvent.yaml#/$defs/adLibsEvent'
+      examples:
+        - payload:
+            $ref: '../adLibsEvent/adLibsEvent-example.yaml'

package/api/components/buckets/bucketStatus/bucketStatus-example.yaml

@@ -0,0 +1,4 @@
+id: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'
+name: My Bucket
+adLibs:
+  - $ref: '../../adLibs/bucketAdLibStatus/bucketAdLibStatus-example.yaml'

package/api/components/buckets/bucketStatus/bucketStatus.yaml

@@ -0,0 +1,20 @@
+$defs:
+  bucketStatus:
+    title: BucketStatus
+    type: object
+    properties:
+      id:
+        description: Unique id of the bucket
+        type: string
+      name:
+        description: The user defined bucket name
+        type: string
+      adLibs:
+        description: The AdLibs in this bucket
+        type: array
+        items:
+          $ref: '../../adLibs/bucketAdLibStatus/bucketAdLibStatus.yaml#/$defs/bucketAdLibStatus'
+    required: [id, name, adLibs]
+    additionalProperties: false
+    examples:
+      - $ref: './bucketStatus-example.yaml'

package/api/components/buckets/bucketsEvent/bucketsEvent-example.yaml

@@ -0,0 +1,3 @@
+event: buckets
+buckets:
+  - $ref: '../bucketStatus/bucketStatus-example.yaml'

package/api/components/buckets/bucketsEvent/bucketsEvent.yaml

@@ -0,0 +1,17 @@
+$defs:
+  bucketsEvent:
+    title: BucketsEvent
+    type: object
+    properties:
+      event:
+        type: string
+        const: buckets
+      buckets:
+        description: Buckets available in the Studio
+        type: array
+        items:
+          $ref: '../bucketStatus/bucketStatus.yaml#/$defs/bucketStatus'
+    required: [event, buckets]
+    additionalProperties: false
+    examples:
+      - $ref: './bucketsEvent-example.yaml'

package/api/components/buckets/messages/bucketsMessage.yaml

@@ -0,0 +1,10 @@
+components:
+  messages:
+    bucketsMessage:
+      messageId: buckets
+      title: Buckets in Studio
+      payload:
+        $ref: '../bucketsEvent/bucketsEvent.yaml#/$defs/bucketsEvent'
+      examples:
+        - payload:
+            $ref: '../bucketsEvent/bucketsEvent-example.yaml'

package/api/components/connection/heartbeatEvent/heartbeatEvent-example.yaml

@@ -0,0 +1 @@
+event: heartbeat

package/api/components/connection/heartbeatEvent/heartbeatEvent.yaml

@@ -0,0 +1,12 @@
+$defs:
+  heartbeatEvent:
+    title: HeartbeatEvent
+    type: object
+    properties:
+      event:
+        type: string
+        const: heartbeat
+    required: [event]
+    additionalProperties: false
+    examples:
+      - $ref: './heartbeatEvent-example.yaml'

package/api/components/connection/messages/heartbeatMessage.yaml

@@ -0,0 +1,11 @@
+components:
+  messages:
+    heartbeatMessage:
+      name: heartbeat
+      messageId: heartbeat
+      description: Server heartbeat sent if no subscription traffic within 1 second (approximately)
+      payload:
+        $ref: '../heartbeatEvent/heartbeatEvent.yaml#/$defs/heartbeatEvent'
+      examples:
+        - payload:
+            $ref: '../heartbeatEvent/heartbeatEvent-example.yaml'

package/api/components/connection/messages/pingMessage.yaml

@@ -0,0 +1,12 @@
+components:
+  messages:
+    pingMessage:
+      name: ping
+      messageId: ping
+      summary: Ping server to determine whether connection is alive
+      description: Client can ping server to determine whether connection is alive, server responds with pong. This is an application level ping as opposed to default ping in websockets standard which is server initiated
+      payload:
+        $ref: '../pingEvent/pingEvent.yaml#/$defs/pingEvent'
+      examples:
+        - payload:
+            $ref: '../pingEvent/pingEvent-example.yaml'

package/api/components/connection/messages/pongMessage.yaml

@@ -0,0 +1,12 @@
+components:
+  messages:
+    pongMessage:
+      name: pong
+      messageId: pong
+      summary: Pong is a response to ping message
+      description: Server pong response to a ping to determine whether connection is alive. This is an application level pong as opposed to default pong in websockets standard which is sent by client in response to a ping
+      payload:
+        $ref: '../pongEvent/pongEvent.yaml#/$defs/pongEvent'
+      examples:
+        - payload:
+            $ref: '../pongEvent/pongEvent-example.yaml'

package/api/components/connection/pingEvent/pingEvent-example.yaml

@@ -0,0 +1,2 @@
+event: ping
+reqid: 27

package/api/components/connection/pingEvent/pingEvent.yaml

@@ -0,0 +1,14 @@
+$defs:
+  pingEvent:
+    title: PingEvent
+    type: object
+    properties:
+      event:
+        type: string
+        const: ping
+      reqid:
+        $ref: '../reqid/reqid.yaml#/$defs/reqid'
+    required: [event, reqid]
+    additionalProperties: false
+    examples:
+      - $ref: './pingEvent-example.yaml'

package/api/components/connection/pongEvent/pongEvent-example.yaml

@@ -0,0 +1,2 @@
+event: pong
+reqid: 27

package/api/components/connection/pongEvent/pongEvent.yaml

@@ -0,0 +1,14 @@
+$defs:
+  pongEvent:
+    title: PongEvent
+    type: object
+    properties:
+      event:
+        type: string
+        const: pong
+      reqid:
+        $ref: '../reqid/reqid.yaml#/$defs/reqid'
+    required: [event, reqid]
+    additionalProperties: false
+    examples:
+      - $ref: './pongEvent-example.yaml'

package/api/components/connection/reqid/reqid.yaml

@@ -0,0 +1,4 @@
+$defs:
+  reqid:
+    type: integer
+    description: Client originated ID reflected in response message.

package/api/components/packages/messages/packagesMessage.yaml

@@ -0,0 +1,8 @@
+components:
+  messages:
+    packagesMessage:
+      name: packages
+      messageId: packages
+      description: Status of Packages expected by Pieces
+      payload:
+        $ref: '../packagesEvent/packagesEvent.yaml'

package/api/components/packages/packageInfoStatus/packageInfoStatus-example.yaml

@@ -0,0 +1,8 @@
+packageName: 'MV000123.mxf'
+status: ok
+rundownId: 'y9HauyWkcxQS3XaAOsW40BRLLsI_'
+partId: 'H5CBGYjThrMSmaYvRaa5FVKJIzk_'
+segmentId: 'H5CBGYjThrMSmaYvRaa5FVKJIzk_'
+pieceOrAdLibId: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'
+thumbnailUrl: 'https://package-manager.local/package/MV000123.mov_thumbnail.jpg'
+previewUrl: 'https://package-manager.local/package/MV000123.mov_preview'

package/api/components/packages/packageInfoStatus/packageInfoStatus.yaml

@@ -0,0 +1,32 @@
+$defs:
+  packageInfoStatus:
+    title: PackageInfoStatus
+    type: object
+    properties:
+      packageName:
+        description: Name of the package
+        type: string
+      status:
+        $ref: '../packageStatus/packageStatus.yaml#/$defs/packageStatus'
+      rundownId:
+        description: Id of the Rundown that a Piece (or AdLib) expecting this package belongs to
+        type: string
+      partId:
+        description: Id of the Part that a Piece (or AdLib) expecting this package belongs to. It could be an Id of a Part from the Active Playlist topic, or a Part not exposed otherwise by the LSG.
+        type: string
+      segmentId:
+        description: Id of the Segment that a Piece (or AdLib) expecting this package belongs to
+        type: string
+      pieceOrAdLibId:
+        description: Id of the Piece or AdLib that expects this package. It could be an Id of a Piece from the Active Pieces and Active Playlist topics, or an Id of an AdLib from the AdLibs topic. It could also be an Id of a Piece not exposed otherwise by the LSG, but still relevant, e.g. to summarize the status of packages within a specific Part/Segment.
+        type: string
+      thumbnailUrl:
+        description: URL where the thumbnail can be accessed
+        type: string
+      previewUrl:
+        description: URL where the preview can be accessed
+        type: string
+    required: [status, rundownId, pieceOrAdLibId]
+    additionalProperties: false
+    examples:
+      - $ref: './packageInfoStatus-example.yaml'

package/api/components/packages/packageStatus/packageStatus.yaml

@@ -0,0 +1,23 @@
+$defs:
+  packageStatus:
+    title: PackageStatus
+    type: string
+    description: |
+      Status:
+      * `unknown` - status not determined (yet)
+      * `ok` - no faults, can be played
+      * `source_broken` - the source is present, but should not be played due to a technical malfunction (file is broken, camera robotics failed, REMOTE input is just bars, etc.)
+      * `source_has_issues` - technically it can be played, but some issues with it were detected
+      * `source_missing` - the source (file, live input) is missing and cannot be played
+      * `source_not_ready` - can't be played for a non-technical reason (e.g. a placeholder clip with no content)
+      * `source_not_set` - missing a file path
+      * `source_unknown_state` - reported, but unrecognized state
+    enum:
+      - unknown
+      - ok
+      - source_broken
+      - source_has_issues
+      - source_missing
+      - source_not_ready
+      - source_not_set
+      - source_unknown_state

package/api/components/packages/packagesEvent/packagesEvent-example.yaml

@@ -0,0 +1,4 @@
+event: packages
+rundownPlaylistId: 'y9HauyWkcxQS3XaAOsW40BRLLsI_'
+packages:
+  - $ref: '../packageInfoStatus/packageInfoStatus-example.yaml'

package/api/components/packages/packagesEvent/packagesEvent.yaml

@@ -0,0 +1,20 @@
+title: PackagesEvent
+type: object
+properties:
+  event:
+    type: string
+    const: packages
+  rundownPlaylistId:
+    description: Unique id of the rundown playlist, or null if no playlist is active
+    oneOf:
+      - type: string
+      - type: 'null'
+  packages:
+    description: The Package statuses for this playlist
+    type: array
+    items:
+      $ref: '../packageInfoStatus/packageInfoStatus.yaml#/$defs/packageInfoStatus'
+required: [event, rundownPlaylistId, packages]
+additionalProperties: false
+examples:
+  - $ref: './packagesEvent-example.yaml'

package/api/components/part/currentPart/currentPartStatus-example.yaml

@@ -0,0 +1,3 @@
+$ref: '../partStatus/partStatus-example.yaml'
+timing:
+  $ref: '../../timing/currentPartTiming/currentPartTiming-example.yaml'

package/api/components/part/currentPart/currentPartStatus.yaml

@@ -0,0 +1,13 @@
+$defs:
+  currentPartStatus:
+    title: CurrentPartStatus
+    allOf:
+      - $ref: '../partStatus/partStatus.yaml#/$defs/partStatus'
+      - type: object
+        title: CurrentPartStatus
+        properties:
+          timing:
+            $ref: '../../timing/currentPartTiming/currentPartTiming.yaml#/$defs/currentPartTiming'
+        required: [timing]
+    examples:
+      - $ref: './currentPartStatus-example.yaml'

package/api/components/part/currentSegmentPart/currentSegmentPart-example.yaml

@@ -0,0 +1,3 @@
+$ref: '../partBase/partBase-example.yaml'
+timing:
+  expectedDurationMs: 15000

package/api/components/part/currentSegmentPart/currentSegmentPart.yaml

@@ -0,0 +1,14 @@
+$defs:
+  currentSegmentPart:
+    title: CurrentSegmentPart
+    type: object
+    allOf:
+      - $ref: '../partBase/partBase.yaml#/$defs/partBase'
+      - type: object
+        title: CurrentSegmentPart
+        properties:
+          timing:
+            $ref: '../../timing/currentSegmentPartTiming/currentSegmentPartTiming.yaml#/$defs/currentSegmentPartTiming'
+    required: [id, name, timing]
+    examples:
+      - $ref: './currentSegmentPart-example.yaml'