feat(rail): add a Rail layer with keyless live trains

Live trains from 30 keyless operator feeds: GPS positions from 29 and
Irish Rail's station reports, shown as the operators publish them. 28
work out of the box; Renfe long and medium distance and KTMB appear once
their pack is built, because their vehicles name no route.

Packs are opt-in (scripts/build-rail-paths.mjs): the operator's own
route lines, stop names, next stops and trip-update delays for live
trains. Nothing downloads when the app starts, no train is placed from a
timetable, and no request carries a deployer's key.
This commit is contained in:
Denis Groshev committed 2026-11-11 16:06:22 +01:00
1 parent 14db73f201
commit 830c080803
114 files changed
+26639 -26

No files matched your search

+97
View File
@@ -0,0 +1,97 @@
// The rail counts the documents state, against the registry: how many feeds
// there are, how many publish GPS or station reports, how many work out of
// the box, register trip updates or have a static GTFS, and one
// DATA_SOURCES.md row per feed, none for a feed the registry does not hold.
import test from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import {
RAIL_ENABLED_FEEDS,
RAIL_FEED_REGISTRY,
railFeedNeedsSchedulePack,
railFeedPositions,
} from './railFeeds.js';
const read = (file) =>
readFileSync(new URL(`../../${file}`, import.meta.url), 'utf8');
const counts = {
registry: RAIL_FEED_REGISTRY.length,
gps: RAIL_FEED_REGISTRY.filter((feed) => railFeedPositions(feed) === 'gps')
.length,
stationReports: RAIL_FEED_REGISTRY.filter(
(feed) => railFeedPositions(feed) === 'event',
).length,
outOfTheBox: RAIL_ENABLED_FEEDS.filter(
(feed) => !railFeedNeedsSchedulePack(feed),
).length,
tripUpdates: RAIL_FEED_REGISTRY.filter(
(feed) => typeof feed.tripUpdatesUrl === 'string',
).length,
staticGtfs: RAIL_FEED_REGISTRY.filter(
(feed) => typeof feed.staticGtfsUrl === 'string',
).length,
};
test('the registry holds the feeds the documents count', () => {
assert.deepEqual(counts, {
registry: 30,
gps: 29,
stationReports: 1,
outOfTheBox: 28,
tripUpdates: 22,
staticGtfs: 29,
});
assert.equal(RAIL_ENABLED_FEEDS.length, counts.registry, 'all switched on');
assert.deepEqual(
RAIL_FEED_REGISTRY.filter(
(feed) => railFeedPositions(feed) === 'event',
).map((feed) => feed.id),
['irish-rail'],
'the station reports are Irish Rail’s',
);
});
test('DATA_SOURCES.md states the rail counts and has one row per feed', () => {
const sources = read('DATA_SOURCES.md');
const { registry, gps, outOfTheBox, tripUpdates, staticGtfs } = counts;
for (const phrase of [
`The registry lists ${registry} feeds, all switched on`,
`${gps} feeds publish live GPS positions (SJ Nord's through SIRI VM), and Irish Rail reports the station or timing point a train last passed`,
`${tripUpdates} feeds register trip updates`,
`${outOfTheBox} feeds work out of the box`,
`(${staticGtfs} of the ${registry} have one)`,
])
assert.ok(sources.includes(phrase), phrase);
const rows = sources
.split('\n')
.filter((line) => /^\| \*\*.+\| Rail layer trains, /.test(line));
assert.equal(rows.length, registry, 'one row per feed');
for (const feed of RAIL_FEED_REGISTRY)
assert.ok(
rows.some((row) => row.includes(`| Rail layer trains, ${feed.region}:`)),
`${feed.id} has a row`,
);
});
test('CURRENT-STATE.md states the rail counts', () => {
const state = read('docs/CURRENT-STATE.md');
const { registry, gps, outOfTheBox, tripUpdates, staticGtfs } = counts;
for (const phrase of [
`(${registry} keyless feeds, all on, ${outOfTheBox} out of the box;`,
`The registry lists ${registry} feeds, all`,
`a host that has built nothing shows ${outOfTheBox} feeds`,
`By position source, ${gps} feeds publish live GPS.`,
'Irish Rail publishes the\nstation or timing point the signalling last reported.',
`${tripUpdates} feeds register trip updates;`,
`that has a static GTFS (${staticGtfs} of the ${registry})`,
])
assert.ok(state.includes(phrase), phrase);
});
test('README.md states the rail counts', () => {
const readme = read('README.md');
const { registry, gps, outOfTheBox } = counts;
const phrase = `from ${registry} keyless operator feeds: live GPS positions from ${gps} of them and Irish Rail’s station reports, ${outOfTheBox} live out of the box`;
assert.ok(readme.includes(phrase), phrase);
});