mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-17 00:32:21 +00:00
152 lines
5.5 KiB
JavaScript
152 lines
5.5 KiB
JavaScript
import { localReceiverFeedName } from './feedNames.js';
|
|
import { LAYER_SOURCE } from './policy.js';
|
|
|
|
// Marks English that the Layers panel translates when it shows the status.
|
|
// Texts with a number or a feed name stay English data too; the panel shows
|
|
// them through STATUS_PIECE_PATTERNS (ui/statusText.js), piece by piece.
|
|
const msg = (text) => text;
|
|
|
|
/**
|
|
* Layers-panel status for Local ADS-B, from its two inputs: the browser
|
|
* WebUSB receiver and the server's decoder feeds. Pure; no DOM or Cesium.
|
|
*/
|
|
|
|
export const FEED_SOURCE = msg('Decoder feeds');
|
|
export const COMBINED_SOURCE = msg('WebUSB + decoder feeds');
|
|
|
|
function plural(count, one, many) {
|
|
return count === 1 ? one : many;
|
|
}
|
|
|
|
/**
|
|
* Describe the feeds that are not live, grouped by status, e.g.
|
|
* "feed 978 unreachable" or "feeds 1090, 978 stale".
|
|
* @param {object[]} feeds Feed statuses from the route.
|
|
* @returns {string}
|
|
*/
|
|
function describeFeedProblems(feeds) {
|
|
const byStatus = new Map();
|
|
for (const feed of feeds) {
|
|
if (feed?.status === 'live') continue;
|
|
const status = feed?.status || 'unreachable';
|
|
if (!byStatus.has(status)) byStatus.set(status, new Set());
|
|
byStatus.get(status).add(localReceiverFeedName(feed, feeds));
|
|
}
|
|
return [...byStatus]
|
|
.map(([status, names]) => {
|
|
const list = [...names];
|
|
return `${plural(list.length, 'feed', 'feeds')} ${list.join(', ')} ${status}`;
|
|
})
|
|
.join(' · ');
|
|
}
|
|
|
|
/** Whether the server reported at least one configured feed. */
|
|
function feedsConfigured(feedState) {
|
|
return Boolean(
|
|
feedState?.configured === true &&
|
|
Array.isArray(feedState.feeds) &&
|
|
feedState.feeds.length,
|
|
);
|
|
}
|
|
|
|
function webUsbStatus(receiver, heard, feedState) {
|
|
if (receiver.status === 'error')
|
|
return { status: 'error', error: receiver.errorText ?? receiver.message };
|
|
if (receiver.status === 'connecting' || receiver.status === 'tuning')
|
|
return { loading: true, loadingLabel: msg('opening receiver') };
|
|
if (
|
|
feedState?.polling &&
|
|
feedState.configured === null &&
|
|
!receiver.connected
|
|
)
|
|
return { loading: true, loadingLabel: msg('checking decoder feeds') };
|
|
if (!receiver.webUsbSupported)
|
|
return {
|
|
status: 'idle',
|
|
statusMessage: msg('WebUSB needs desktop Chrome or Edge'),
|
|
};
|
|
if (!receiver.connected)
|
|
return {
|
|
status: 'idle',
|
|
statusMessage: msg('connect a receiver in Radio'),
|
|
};
|
|
if (receiver.mode !== 'adsb')
|
|
return { status: 'idle', statusMessage: msg('receiver is in FM mode') };
|
|
const rate = Number.isFinite(receiver.messagesPerSecond)
|
|
? `${receiver.messagesPerSecond} msg/s`
|
|
: msg('listening');
|
|
// i18n-ignore: English data, shown through STATUS_PIECE_PATTERNS
|
|
return { status: 'streaming', loadingLabel: `${heard} heard · ${rate}` };
|
|
}
|
|
|
|
/**
|
|
* Status fields of `getStats()` for the Local ADS-B row.
|
|
*
|
|
* Without configured feeds this is exactly the WebUSB status. With feeds:
|
|
* "2 feeds live · 14 heard" when every feed is live. While any input is
|
|
* producing (the browser receiver streaming, or a feed live) the row stays
|
|
* nominal and names the other feeds as a trailing note, e.g. "3 heard · USB
|
|
* 5.8 msg/s · feed 1090 stale": a decoder stopped so the browser can take the
|
|
* dongle is not a fault. With nothing producing, every readable feed stale is
|
|
* STALE and anything else is an error.
|
|
* @param {object} options
|
|
* @param {object} options.receiver WebUSB receiver snapshot.
|
|
* @param {object|null} options.feedState Feed poller snapshot.
|
|
* @param {number} options.heard Merged aircraft heard in the last 60 s.
|
|
* @returns {object} status / statusMessage / loading / loadingLabel / error /
|
|
* stale / source.
|
|
*/
|
|
export function localAdsbStatus({ receiver, feedState, heard }) {
|
|
if (!feedsConfigured(feedState))
|
|
return {
|
|
source: LAYER_SOURCE,
|
|
...webUsbStatus(receiver, heard, feedState),
|
|
};
|
|
const usbActive = Boolean(receiver.connected && receiver.mode === 'adsb');
|
|
const source = usbActive ? COMBINED_SOURCE : FEED_SOURCE;
|
|
const live = feedState.feeds.filter((feed) => feed.status === 'live');
|
|
const problems = [describeFeedProblems(feedState.feeds)].filter(Boolean);
|
|
if (usbActive && receiver.status === 'error') problems.push(msg('USB error'));
|
|
const rate =
|
|
usbActive &&
|
|
receiver.status !== 'error' &&
|
|
Number.isFinite(receiver.messagesPerSecond)
|
|
? ` · USB ${receiver.messagesPerSecond} msg/s`
|
|
: '';
|
|
const heardText = `${heard} heard`;
|
|
if (!problems.length) {
|
|
return {
|
|
source,
|
|
status: 'streaming',
|
|
// i18n-ignore: English data, shown through STATUS_PIECE_PATTERNS
|
|
loadingLabel: `${live.length} ${plural(live.length, 'feed', 'feeds')} live · ${heardText}${rate}`,
|
|
};
|
|
}
|
|
const problemText = problems.join(' · ');
|
|
const usbProducing = usbActive && receiver.status !== 'error';
|
|
if (!live.length && !usbProducing) {
|
|
// Decoders that stopped but still serve their last aircraft.json are
|
|
// stale, not down: only an unreachable or unusable feed is an error.
|
|
const readable = feedState.feeds.filter(
|
|
(feed) => feed.status !== 'invalid',
|
|
);
|
|
if (readable.length && readable.every((feed) => feed.status === 'stale'))
|
|
return {
|
|
source,
|
|
status: 'stale',
|
|
stale: true,
|
|
statusMessage: `${problemText} · ${heardText}`,
|
|
};
|
|
return {
|
|
source,
|
|
status: 'error',
|
|
error: heard > 0 ? `${problemText} · ${heardText}` : problemText,
|
|
};
|
|
}
|
|
return {
|
|
source,
|
|
status: 'streaming',
|
|
loadingLabel: `${heardText}${rate} · ${problemText}`,
|
|
};
|
|
}
|