mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
Preserve the camera, map source and layer selection across engine sessions. Restore the previous engine if startup fails and retain local history navigation.
122 lines
4.3 KiB
JavaScript
122 lines
4.3 KiB
JavaScript
const contract = (layers, methods) =>
|
|
Object.freeze({
|
|
layers: Object.freeze(layers),
|
|
methods: Object.freeze(methods),
|
|
});
|
|
|
|
/** Acquisition contracts and their consumers; records remain family-specific. */
|
|
export const CATALOG_SOURCE_CONTRACTS = Object.freeze({
|
|
directions: contract(['directions'], ['getRoute']),
|
|
'recent-imagery': contract(
|
|
['recent-imagery'],
|
|
['searchHls', 'getThumbnail', 'getTileTemplate'],
|
|
),
|
|
flights: contract(['flights'], ['getSnapshot']),
|
|
military: contract(['military'], ['getSnapshot']),
|
|
vessels: contract(['ais-live-vessels'], ['getSnapshot']),
|
|
cctv: contract(
|
|
['cctv'],
|
|
['getCatalog', 'getHealth', 'getFrameUrl', 'getMediaUrl'],
|
|
),
|
|
radio: contract(['radio'], ['getDirectory', 'recordClick']),
|
|
traffic: contract(
|
|
['traffic'],
|
|
[
|
|
'requestRoads',
|
|
'getStatus',
|
|
'fetchFlowForBounds',
|
|
'getFlowSessionStats',
|
|
'resetFlowTileCache',
|
|
],
|
|
),
|
|
bikeshare: contract(['bikeshare'], ['getStations']),
|
|
installations: contract(
|
|
['military-installations'],
|
|
['getMappedSites', 'searchNearby'],
|
|
),
|
|
satellites: contract(['satellites'], ['readGroup']),
|
|
launches: contract(['rocket-launches'], ['getLaunches', 'getActiveTle']),
|
|
alpr: contract(['alpr-cameras'], ['fetch']),
|
|
firms: contract(['local-firms'], ['getSnapshot']),
|
|
wind: contract(['wind'], ['getSnapshot']),
|
|
weather: contract(
|
|
['weather-radar', 'weather-satellite', 'weather-lightning'],
|
|
['getSnapshot'],
|
|
),
|
|
cyclones: contract(['weather-cyclones'], ['getSnapshot']),
|
|
earthquakes: contract(['earthquakes'], ['getSnapshot']),
|
|
'fire-perimeters': contract(['fire-perimeters'], ['getSnapshot']),
|
|
'air-quality': contract(['air-quality'], ['getSnapshot']),
|
|
'gnss-integrity': contract(['gnss-integrity'], ['getSnapshot']),
|
|
's2-ghostmaps': contract(['s2-ghostmaps'], ['getCatalog', 'getFile']),
|
|
cables: contract(['telegeography-submarine-cables'], ['fetch']),
|
|
transit: contract(['transit'], ['requestSnapshot', 'getHistory']),
|
|
});
|
|
|
|
/** An omitted provider is unavailable, never an authoritative empty dataset. */
|
|
class SourceUnavailableError extends Error {
|
|
constructor(name) {
|
|
super(`Data source not configured: ${name}`);
|
|
this.name = 'SourceUnavailableError';
|
|
this.code = 'unavailable';
|
|
this.unavailable = true;
|
|
this.retryable = false;
|
|
}
|
|
}
|
|
|
|
/** Validate supplied contracts and keep omitted sources inert during construction. */
|
|
export function resolveCatalogSources(supplied = {}) {
|
|
if (!supplied || typeof supplied !== 'object' || Array.isArray(supplied))
|
|
throw new TypeError('Catalog sources must be an object');
|
|
const sources = { ...supplied };
|
|
const missing = new Set();
|
|
for (const [name, { methods }] of Object.entries(CATALOG_SOURCE_CONTRACTS)) {
|
|
const source = sources[name];
|
|
if (source == null) {
|
|
missing.add(name);
|
|
const unavailable = () => {
|
|
throw new SourceUnavailableError(name);
|
|
};
|
|
sources[name] = Object.freeze({
|
|
label: name,
|
|
...Object.fromEntries(methods.map((method) => [method, unavailable])),
|
|
});
|
|
} else if (methods.some((method) => typeof source[method] !== 'function')) {
|
|
throw new TypeError(`Invalid catalog source: ${name}`);
|
|
}
|
|
}
|
|
return {
|
|
sources,
|
|
isConfigured: (name) => !missing.has(name),
|
|
/** `omitted`: layer ids the catalog leaves out on purpose (another
|
|
* engine's layers); any other missing consumer is a wiring error. */
|
|
createAvailabilityLookup(layers, { omitted = new Set() } = {}) {
|
|
const byId = new Map(layers.map((layer) => [layer.id, layer]));
|
|
const availability = new Map();
|
|
for (const [name, { layers: ids }] of Object.entries(
|
|
CATALOG_SOURCE_CONTRACTS,
|
|
)) {
|
|
for (const id of ids) {
|
|
const layer = byId.get(id);
|
|
if (!layer) {
|
|
if (omitted.has(id)) continue;
|
|
throw new Error(`Missing source consumer: ${id}`);
|
|
}
|
|
availability.set(
|
|
id,
|
|
Object.freeze({
|
|
available: !missing.has(name),
|
|
source: name,
|
|
reason: missing.has(name)
|
|
? `${layer.name || id}: data source not configured`
|
|
: null,
|
|
}),
|
|
);
|
|
}
|
|
}
|
|
return (id) =>
|
|
availability.get(id) ?? byId.get(id)?.getSourceAvailability?.();
|
|
},
|
|
};
|
|
}
|