svrooij / node-sonos-ts / 28817038006

74%

master: 81%

push

github

feat: add MetadataHelper.IsRadioStream() to detect live/non-skippable streams (#227)

* feat: add MetadataHelper.IsRadioStream() to detect live/non-skippable streams

Consumers building playback UIs need to know whether the currently
playing track is a live stream (radio, Deezer-powered Sonos Radio,
Pandora, etc.) so they can disable next/previous/shuffle controls -
none of that is skippable even though it arrives on TrackURI just like
a regular track. GetSimpleUri() reverses a URI back to a portable
service reference, but doesn't answer that question, so this adds a
dedicated boolean check next to it covering the known
non-skippable-stream URI schemes.

* docs: clarify IsRadioStream vs GetCurrentTransportActions tradeoff

IsRadioStream is a synchronous URI-pattern guess for callers that
already have a TrackUri and need an answer on every playback event
without an extra device round-trip. GetCurrentTransportActions is the
more authoritative live source when a round-trip is acceptable.

876 of 1217 branches covered (71.98%)

Branch coverage included in aggregate %.

2 of 2 new or added lines in 1 file covered. (100.0%)

1621 of 2173 relevant lines covered (74.6%)

67.81 hits per line