mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
Add aircraft_in_area, find_aircraft, get_aircraft_track and get_aircraft_info over the live aircraft sources, with an optional military feed, and next_satellite_pass and satellites_overhead over the satellite catalog and the existing pass predictor. Source failures from the live contract now become tool errors with the matching code, so a rate limit reaches clients as retry_later with a wait time. Tool schemas may use pattern.
155 lines
4.9 KiB
JavaScript
155 lines
4.9 KiB
JavaScript
import assert from 'node:assert/strict';
|
|
import test from 'node:test';
|
|
import { composeCatalog, coreTools } from '../index.js';
|
|
import { parseTleText, tleCatalogNumber } from '../../sources/tle.js';
|
|
|
|
// Element sets published for 1 January 2024.
|
|
const TLE = `ISS (ZARYA)
|
|
1 25544U 98067A 24001.50000000 .00016717 00000-0 30270-3 0 9994
|
|
2 25544 51.6416 247.4627 0006703 130.5360 325.0288 15.50377579432414
|
|
CSS (TIANHE)
|
|
1 48274U 21035A 24001.50000000 .00020137 00000-0 24481-3 0 9993
|
|
2 48274 41.4697 175.8913 0005643 312.8370 141.6893 15.61287398150000
|
|
`;
|
|
const CLOCK = { now: () => Date.UTC(2024, 0, 1, 12) };
|
|
const satellites = (text = TLE, ok = true) => ({
|
|
calls: [],
|
|
async readGroup(group) {
|
|
this.calls.push(group);
|
|
return { ok, status: ok ? 200 : 503, text };
|
|
},
|
|
});
|
|
|
|
test('TLE text parses into named entries with catalog numbers', () => {
|
|
const entries = parseTleText(`${TLE}\nBROKEN\nnot a line\nnor this\n`);
|
|
assert.deepEqual(
|
|
entries.map((entry) => entry.name),
|
|
['ISS (ZARYA)', 'CSS (TIANHE)'],
|
|
);
|
|
assert.equal(tleCatalogNumber(entries[0].line1), 25544);
|
|
assert.equal(tleCatalogNumber('1 xx'), null);
|
|
});
|
|
|
|
test('the next pass defaults to the ISS and reports times, peak and direction', async () => {
|
|
const catalog = composeCatalog({
|
|
tools: coreTools,
|
|
services: { satellites: satellites(), clock: CLOCK },
|
|
});
|
|
const result = await catalog.call('next_satellite_pass', {
|
|
lat: 40.7,
|
|
lon: -74,
|
|
});
|
|
const { pass } = result.data;
|
|
assert.equal(result.data.satellite, 'ISS (ZARYA)');
|
|
assert.equal(result.data.norad, 25544);
|
|
assert.ok(Date.parse(pass.rise) >= CLOCK.now());
|
|
assert.ok(Date.parse(pass.rise) < Date.parse(pass.peak));
|
|
assert.ok(Date.parse(pass.peak) < Date.parse(pass.set));
|
|
assert.ok(pass.max_elevation_deg >= 10 && pass.max_elevation_deg <= 90);
|
|
assert.match(pass.rise_direction, /^[NESW]{1,3}$/);
|
|
assert.match(
|
|
result.summary,
|
|
new RegExp(
|
|
`^ISS \\(ZARYA\\) next rises ${pass.rise} in the ${pass.rise_direction}, peaking at \\d+°`,
|
|
),
|
|
);
|
|
});
|
|
|
|
test('satellites are matched by name or catalog number within the group', async () => {
|
|
const source = satellites();
|
|
const catalog = composeCatalog({
|
|
tools: coreTools,
|
|
services: { satellites: source, clock: CLOCK },
|
|
});
|
|
const byName = await catalog.call('next_satellite_pass', {
|
|
lat: 0,
|
|
lon: 0,
|
|
satellite: 'tianhe',
|
|
});
|
|
assert.equal(byName.data.norad, 48274);
|
|
const byNumber = await catalog.call('next_satellite_pass', {
|
|
lat: 0,
|
|
lon: 0,
|
|
satellite: '48274',
|
|
group: 'visual',
|
|
});
|
|
assert.equal(byNumber.data.satellite, 'CSS (TIANHE)');
|
|
assert.deepEqual(source.calls, ['stations', 'visual']);
|
|
await assert.rejects(
|
|
catalog.call('next_satellite_pass', {
|
|
lat: 0,
|
|
lon: 0,
|
|
satellite: 'Hubble',
|
|
}),
|
|
/No satellite matching "Hubble" is in the stations group/,
|
|
);
|
|
await assert.rejects(
|
|
catalog.call('next_satellite_pass', { lat: 0, lon: 0, group: 'weather' }),
|
|
/must be one of/,
|
|
);
|
|
});
|
|
|
|
test('a pass that never comes is a normal answer, and catalog failures are unavailable', async () => {
|
|
const catalog = composeCatalog({
|
|
tools: coreTools,
|
|
services: { satellites: satellites(), clock: CLOCK },
|
|
});
|
|
// The ISS orbit is inclined 51.6°, so it never rises 10° above the pole.
|
|
const none = await catalog.call('next_satellite_pass', {
|
|
lat: 89.9,
|
|
lon: 0,
|
|
hours: 6,
|
|
});
|
|
assert.equal(none.data.pass, null);
|
|
assert.equal(
|
|
none.summary,
|
|
'ISS (ZARYA) has no pass over this location in the next 6 hours.',
|
|
);
|
|
const down = composeCatalog({
|
|
tools: coreTools,
|
|
services: { satellites: satellites('', false), clock: CLOCK },
|
|
});
|
|
await assert.rejects(
|
|
down.call('next_satellite_pass', { lat: 0, lon: 0 }),
|
|
(error) => error.code === 'unavailable' && /HTTP 503/.test(error.message),
|
|
);
|
|
});
|
|
|
|
test('satellites overhead are those above the elevation, highest first', async () => {
|
|
const source = satellites();
|
|
const services = { satellites: source, clock: CLOCK };
|
|
const catalog = composeCatalog({ tools: coreTools, services });
|
|
const pass = (
|
|
await catalog.call('next_satellite_pass', { lat: 40.7, lon: -74 })
|
|
).data.pass;
|
|
const atPeak = {
|
|
satellites: source,
|
|
clock: { now: () => Date.parse(pass.peak) },
|
|
};
|
|
const overhead = await composeCatalog({
|
|
tools: coreTools,
|
|
services: atPeak,
|
|
}).call('satellites_overhead', {
|
|
lat: 40.7,
|
|
lon: -74,
|
|
});
|
|
assert.equal(overhead.data.rows[0].name, 'ISS (ZARYA)');
|
|
assert.ok(
|
|
Math.abs(overhead.data.rows[0].elevation_deg - pass.max_elevation_deg) < 1,
|
|
);
|
|
assert.equal(overhead.data.at, pass.peak);
|
|
const strict = await composeCatalog({
|
|
tools: coreTools,
|
|
services: atPeak,
|
|
}).call('satellites_overhead', {
|
|
lat: 40.7,
|
|
lon: -74,
|
|
min_elevation_deg: 90,
|
|
});
|
|
assert.equal(strict.data.total, 0);
|
|
assert.match(
|
|
strict.summary,
|
|
/^0 satellites from the stations group are at least 90° above/,
|
|
);
|
|
});
|