mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-22 11:12:18 +00:00
OpenSky's state-vector spec allows null longitude/latitude, and every live /states/all response carries such rows (about 50 of 7,800). The normaliser rejects them, so admitRecords reported complete: false on effectively every poll. While a snapshot is incomplete, FlightRecords.absence() retains any aircraft received in the last five minutes, which meant the stale fade, MISSING_POLL_LIMIT and the landed fast-cull never ran: vanished and landed aircraft stayed on the globe at full opacity for up to five minutes. admitRecords now takes an optional unpositionedId(row). A rejected row it names is a contact without a position: its id is returned in retainIds and the row does not count against completeness. OpenSky opts in for rows with an ICAO24 address and strictly null longitude and latitude; the id comes from the same helper the normaliser uses. Rows with no usable id, out-of-range or half-null coordinates, truncated rows and positioned duplicates still make the snapshot incomplete, and a nonempty feed with no positioned rows is still malformed. absence() retains exactly the retainIds aircraft under the existing five-minute bound, except likely-landed ones, which keep the landed limit. Everything else ages out normally. Military readsb admission does not opt in and is unchanged.
140 lines
3.9 KiB
JavaScript
140 lines
3.9 KiB
JavaScript
/**
|
|
* Browser live-source contract. Coordinates are WGS84 degrees; lengths and
|
|
* velocities are metres and metres/second; times are Unix milliseconds.
|
|
* Barometric altitude and ellipsoid altitude are separate, nullable observations.
|
|
* A missing timestamp is unknown, never the time the response was received.
|
|
*
|
|
* Sources expose getSnapshot(query, { signal }) and optionally
|
|
* getTrack(reference, { signal }). References are opaque to consumers.
|
|
* Snapshots describe coverage and completeness independently of freshness.
|
|
* Records contain observation data only, with no scene objects or transport data.
|
|
*/
|
|
export class LiveSourceError extends Error {
|
|
constructor(
|
|
code,
|
|
message,
|
|
{ status = null, retryAfterMs = 20000, source = null } = {},
|
|
) {
|
|
super(message);
|
|
this.name = 'LiveSourceError';
|
|
this.code = code;
|
|
this.status = status;
|
|
this.retryAfterMs = retryAfterMs;
|
|
this.source = source;
|
|
}
|
|
}
|
|
|
|
export function finite(value) {
|
|
if (value == null || value === '' || typeof value === 'boolean') return null;
|
|
const number = Number(value);
|
|
return Number.isFinite(number) ? number : null;
|
|
}
|
|
|
|
export function epoch(value, scale = 1) {
|
|
const number = finite(value);
|
|
const milliseconds = number == null ? null : number * scale;
|
|
return milliseconds != null &&
|
|
milliseconds > 0 &&
|
|
milliseconds <= 8640000000000000
|
|
? milliseconds
|
|
: null;
|
|
}
|
|
|
|
export function cleanText(value) {
|
|
return typeof value === 'string' ? value.trim() : '';
|
|
}
|
|
|
|
export function coordinates(latitude, longitude) {
|
|
return (
|
|
Number.isFinite(latitude) &&
|
|
Math.abs(latitude) <= 90 &&
|
|
Number.isFinite(longitude) &&
|
|
Math.abs(longitude) <= 180
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Admit a snapshot atomically; an all-invalid nonempty feed is unavailable.
|
|
* `unpositionedId(row)` names a rejected row that is a valid contact without
|
|
* a position: it is returned in `retainIds` and does not make the snapshot
|
|
* incomplete.
|
|
*/
|
|
export function admitRecords(rows, normalize, label, unpositionedId) {
|
|
if (!Array.isArray(rows))
|
|
throw new LiveSourceError('malformed', `Malformed ${label} response`);
|
|
const records = [];
|
|
const ids = new Set();
|
|
const retainIds = new Set();
|
|
let unpositioned = 0;
|
|
for (const row of rows) {
|
|
const record = normalize(row);
|
|
if (record && !ids.has(record.id)) {
|
|
records.push(record);
|
|
ids.add(record.id);
|
|
} else if (!record) {
|
|
const id = unpositionedId?.(row);
|
|
if (id) {
|
|
retainIds.add(id);
|
|
unpositioned += 1;
|
|
}
|
|
}
|
|
}
|
|
if (rows.length && !records.length) {
|
|
throw new LiveSourceError('malformed', `Malformed ${label} aircraft rows`);
|
|
}
|
|
return {
|
|
records,
|
|
retainIds,
|
|
complete: records.length + unpositioned === rows.length,
|
|
rejectedCount: rows.length - records.length,
|
|
};
|
|
}
|
|
|
|
/** Cancellation is checked after body parsing even when a transport ignores it. */
|
|
export async function readResponse(
|
|
fetchImpl,
|
|
url,
|
|
{ signal, ...init } = {},
|
|
source = 'Live source',
|
|
) {
|
|
signal?.throwIfAborted();
|
|
let response;
|
|
try {
|
|
response = await fetchImpl(url, { ...init, signal });
|
|
signal?.throwIfAborted();
|
|
} catch (error) {
|
|
signal?.throwIfAborted();
|
|
if (error?.name === 'AbortError') throw error;
|
|
throw new LiveSourceError('unavailable', `${source} network error`, {
|
|
source,
|
|
});
|
|
}
|
|
let payload = null;
|
|
try {
|
|
payload = await response.json();
|
|
} catch {
|
|
/* classified below */
|
|
}
|
|
signal?.throwIfAborted();
|
|
return { response, payload };
|
|
}
|
|
|
|
export function httpError(response, source) {
|
|
const status = response.status;
|
|
const code =
|
|
status === 429
|
|
? 'limited'
|
|
: status === 401 || status === 403
|
|
? 'denied'
|
|
: 'unavailable';
|
|
return new LiveSourceError(
|
|
code,
|
|
status === 429 ? `${source} rate limited` : `${source} HTTP ${status}`,
|
|
{
|
|
status,
|
|
source,
|
|
retryAfterMs: code === 'limited' || code === 'denied' ? 45000 : 20000,
|
|
},
|
|
);
|
|
}
|