Files
gods-eye-view/src/tools/queries/space.test.mjs
T
Sameh Khamis 22c3fe40b0 feat: add aviation and satellite tools
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.
2026-10-01 12:05:50 -07:00

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/,
);
});