chore(LSG): update packages topic docs

Author: ianshade

packages/live-status-gateway/api/asyncapi.yaml

@@ -127,6 +127,7 @@ components:
         $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'

packages/live-status-gateway/api/schemas/activePlaylist.yaml

@@ -14,7 +14,7 @@ $defs:
         description: User-presentable name for the active playlist
         type: string
       rundownIds:
-        description: The set of rundownIds in the active playlist
+        description: The set of rundownIds in the active playlist, in order
         type: array
         items:
           type: string

packages/live-status-gateway/api/schemas/packages.yaml

@@ -34,28 +34,28 @@ $defs:
         description: Status code
         type: number
       rundownId:
-        description: Id of the Rundown that expects this package
+        description: Id of the Rundown that a Piece (or AdLib) expecting this package belongs to
         type: string
       partId:
-        description: Id of the Part that expects this package
+        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 expects this package
+        description: Id of the Segment that a Piece (or AdLib) expecting this package belongs to
         type: string
-      pieceId:
-        description: Id of the Piece that expects this package
+      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: [statusCode, rundownId, pieceId]
+    required: [statusCode, rundownId, pieceOrAdLibId]
     additionalProperties: false
     examples:
       - packageName: 'MV000123.mxf'
         statusCode: 0
         rundownId: 'y9HauyWkcxQS3XaAOsW40BRLLsI_'
-        pieceId: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'
+        pieceOrAdLibId: 'C6K_yIMuGFUk8X_L9A9_jRT6aq4_'
         thumbnailUrl: 'https://package-manager.local/package/MV000123.mov_thumbnail.jpg'