feat: mos status flow rework

[Julusian]

About the Contributor

This pull request is posted on behalf of the BBC

Type of Contribution

This is a: Feature

Current Behavior

Reporting statuses to a MOS NRCS is quite basic, limited to just sending PLAY events for stories as they are taken.

New Behavior

The status reporting is overhauled to support a full range of statuses, driven from both playback and ingest.
Additionally, status can now be reported for items as well as the stories.

To do this, a new custom publication has been added to be consumed by the MOS gateway. This publication is slightly mos based (the status levels it contains is based upon MOS), but it intended to be usable for other types of ingest gateways and NRCS systems.
This publication contains documents which follows a similar structure to an IngestRundown. Each 'Part' in this structure corresponds with a story/part as reported by the gateway. This 'Part' contains a few values which describe the status of the story and of any items. At this level it still reflects the raw values as provided by the playout and ingest logic, they have not been resolved into a single string/value at this point.
It is expected that the gateway will get an update to this document for each take performed, as the playback status of parts will change, as well as following any ingest operation.

Inside the gateway, we consume this publication and upon receiving a new version of it perform a diff. Through this, we compile a sequence of MOS messages we should send to report the correct status.

To ensure correct operation, at startup of the gateway, the gateway will write all the values to the NRCS, to ensure they are in sync.

As part of this, the MOS gateway has gained a few new options, to configure how this status writing is performed.
One of these options is to limit the diff to only produce PLAY statuses, so that it can be configured to match existing behaviour.

Testing

• I have added one or more unit tests for this PR
• I have updated the relevant unit tests
• No unit test changes are needed for this PR

This has been tested against a non-production like openmedia installation. Testing against a production like openmedia has not been done yet, and no testing has been performed against other MOS systems.

This will want testing by NRK to ensure it produces PLAY messages in a way that is compatible with your existing workflow.

Affected areas

This PR affects the status reporting to MOS NRCS

Time Frame

Not urgent, but we would like to get this merged into the in-development release.

Other Information

Status

• PR is ready to be reviewed.
• The functionality has been tested by the author.
• Relevant unit tests has been added / updated.
• Relevant documentation (code comments, system documentation) has been added / updated.

[codecov]

Codecov Report

Attention: Patch coverage is 20.53571% with 1157 lines in your changes missing coverage. Please review.

Project coverage is 56.26%. Comparing base (b17ec63) to head (77d06da).
Report is 78 commits behind head on release52.

Files with missing lines	Patch %	Lines
packages/mos-gateway/src/mosHandler.ts	13.38%	220 Missing ⚠️
...or/server/publications/ingestStatus/publication.ts	0.00%	194 Missing and 1 partial ⚠️
...ublications/ingestStatus/rundownContentObserver.ts	0.00%	149 Missing and 1 partial ⚠️
...ications/ingestStatus/createIngestRundownStatus.ts	0.00%	133 Missing and 1 partial ⚠️
packages/mos-gateway/src/mosStatus/handler.ts	28.22%	117 Missing ⚠️
.../publications/ingestStatus/reactiveContentCache.ts	0.00%	77 Missing and 1 partial ⚠️
...ations/pieceContentStatusUI/rundown/publication.ts	0.00%	77 Missing ⚠️
...server/publications/partInstancesUI/publication.ts	0.00%	55 Missing ⚠️
meteor/server/publications/partsUI/publication.ts	0.00%	51 Missing ⚠️
...ver/publications/segmentPartNotesUI/publication.ts	0.00%	46 Missing ⚠️
... and 7 more

Additional details and impacted files

@@              Coverage Diff              @@
##           release52    #1356      +/-   ##
=============================================
- Coverage      56.46%   56.26%   -0.21%     
=============================================
  Files            401      447      +46     
  Lines          72105    80573    +8468     
  Branches        4546     5132     +586     
=============================================
+ Hits           40714    45333    +4619     
- Misses         31257    34993    +3736     
- Partials         134      247     +113     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.