mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-18 01:02:23 +00:00
AIS Vessels are keyed by the id their live source gives, with the MMSI as an attribute: an MMSI can be shared, spoofed or reused, so two vessels with one MMSI are now two vessels. Looking a vessel up or selecting it by MMSI still finds it. A share link made while a vessel is selected opens that vessel. A UUID vessel id travels as 16 bytes in a new thing field (13). A shared thing that is not reporting now says so in a sentence per kind, with its id (ICAO, NORAD, MMSI or vessel UUID) on a second line.
184 lines
6.6 KiB
JavaScript
184 lines
6.6 KiB
JavaScript
import test from 'node:test';
|
|
import assert from 'node:assert/strict';
|
|
import { VesselRecords, normalizeVessel } from './records.js';
|
|
const row = (mmsi, fields = {}) => ({
|
|
mmsi,
|
|
lat: 51.93,
|
|
lon: 4.05,
|
|
name: mmsi,
|
|
speed: 8,
|
|
...fields,
|
|
});
|
|
function setup() {
|
|
let now = 1000;
|
|
const store = new VesselRecords({ now: () => now });
|
|
const events = [];
|
|
const effects = {
|
|
add: (record) => events.push(['add', record]),
|
|
beforeUpdate: (record) => record.type,
|
|
updated: (record, before) => events.push(['update', record, before]),
|
|
remove: (record, evicted) =>
|
|
events.push(['remove', record, evicted, store.byId.has(record.id)]),
|
|
removed: (id) => events.push(['removed', id, store.byId.has(id)]),
|
|
staleSelected: (record) => events.push(['stale', record]),
|
|
};
|
|
return {
|
|
store,
|
|
events,
|
|
advance: (ms) => {
|
|
now += ms;
|
|
},
|
|
reconcile: (rows, options = {}) => store.reconcile(rows, options, effects),
|
|
};
|
|
}
|
|
|
|
test('vessel reconciliation preserves record identity and first duplicate while emitting plain metadata', () => {
|
|
const probe = setup();
|
|
probe.reconcile([
|
|
row('111', { type: 'Cargo' }),
|
|
row('222'),
|
|
row('222', { name: 'duplicate' }),
|
|
row('bad', { lat: NaN }),
|
|
]);
|
|
assert.equal(probe.store.byId.size, 2);
|
|
assert.equal(probe.store.byId.get('222').name, '222');
|
|
const record = probe.store.byId.get('111');
|
|
probe.reconcile([row('111', { lat: 51.94, type: 'Tanker' })]);
|
|
assert.equal(probe.store.byId.get('111'), record);
|
|
assert.equal(record.lat, 51.94);
|
|
assert.equal(probe.events.find((event) => event[0] === 'update')[2], 'Cargo');
|
|
assert.equal(probe.store.byId.has('222'), false);
|
|
for (const field of ['position', 'surfacePosition', 'normal', 'billboard'])
|
|
assert.equal(Object.hasOwn(record, field), false);
|
|
assert.deepEqual(structuredClone(record), record);
|
|
});
|
|
|
|
test('selected vessel remains pinned for three complete misses and teardown precedes removal', () => {
|
|
const probe = setup();
|
|
probe.reconcile([row('111'), row('222')]);
|
|
const selectedRecord = probe.store.byId.get('111');
|
|
for (let i = 1; i <= 3; i++) {
|
|
probe.reconcile([row('222')], { selectedRecord });
|
|
assert.equal(probe.store.byId.get('111'), selectedRecord);
|
|
assert.equal(selectedRecord.missedRefreshes, i);
|
|
}
|
|
probe.reconcile([row('222')], { selectedRecord });
|
|
assert.equal(probe.store.byId.has('111'), false);
|
|
const removal = probe.events.find(
|
|
(event) => event[0] === 'remove' && event[1] === selectedRecord,
|
|
);
|
|
assert.deepEqual(removal.slice(2), [true, true]);
|
|
assert.deepEqual(
|
|
probe.events.find((event) => event[0] === 'removed' && event[1] === '111'),
|
|
['removed', '111', false],
|
|
);
|
|
});
|
|
|
|
test('partial retention respects age and row cap while preserving the selected contact', () => {
|
|
const probe = setup();
|
|
probe.reconcile([row('111'), row('222')], { cap: 2 });
|
|
const selectedRecord = probe.store.byId.get('111');
|
|
probe.reconcile([row('333')], { complete: false, selectedRecord, cap: 2 });
|
|
assert.deepEqual([...probe.store.byId.keys()], ['111', '333']);
|
|
assert.equal(selectedRecord.missedRefreshes, 1);
|
|
probe.advance(5 * 60 * 1000);
|
|
probe.reconcile([row('333')], { complete: false, selectedRecord, cap: 2 });
|
|
assert.equal(probe.store.byId.has('111'), false);
|
|
assert.equal(
|
|
probe.events.find(
|
|
(event) => event[0] === 'remove' && event[1] === selectedRecord,
|
|
)[2],
|
|
true,
|
|
);
|
|
});
|
|
|
|
test('unkeyed records rebuild on each refresh and numeric coercion keeps unknown values null', () => {
|
|
const probe = setup();
|
|
probe.reconcile([row('', { speed: '', course: '12.5', heading: 'bad' })]);
|
|
const original = probe.store.unkeyed[0];
|
|
assert.equal(original.speed, null);
|
|
assert.equal(original.course, 12.5);
|
|
assert.equal(original.heading, null);
|
|
probe.reconcile([row('')]);
|
|
assert.notEqual(probe.store.unkeyed[0], original);
|
|
assert.equal(
|
|
probe.events.some(
|
|
(event) => event[0] === 'remove' && event[1] === original,
|
|
),
|
|
true,
|
|
);
|
|
assert.equal(probe.store.byId.size, 0);
|
|
assert.equal(probe.store.all.length, 1);
|
|
assert.equal(normalizeVessel(row('bad', { lon: Infinity })), null);
|
|
});
|
|
|
|
test("each fix keeps when it was first received and its refresh's newest fix", () => {
|
|
const probe = setup();
|
|
probe.reconcile([
|
|
row('111', { last_position_epoch: 1_800_000_000 }),
|
|
row('222', { last_position_epoch: 1_800_000_030 }),
|
|
row('333'),
|
|
]);
|
|
for (const mmsi of ['111', '222', '333']) {
|
|
const record = probe.store.byId.get(mmsi);
|
|
assert.equal(record.fixFeedEpoch, 1_800_000_030, mmsi);
|
|
assert.equal(record.fixReceivedAtMs, 1000, mmsi);
|
|
}
|
|
// A new fix is stamped afresh.
|
|
probe.advance(60_000);
|
|
probe.reconcile([row('111', { last_position_epoch: 1_800_000_050 })]);
|
|
const record = probe.store.byId.get('111');
|
|
assert.equal(record.fixFeedEpoch, 1_800_000_050);
|
|
assert.equal(record.fixReceivedAtMs, 61_000);
|
|
// The same fix re-served by later polls keeps its first receipt, while
|
|
// the row itself counts as seen for retention.
|
|
probe.advance(30_000);
|
|
probe.reconcile([
|
|
row('111', { last_position_epoch: 1_800_000_050 }),
|
|
row('222', { last_position_epoch: 1_800_000_090 }),
|
|
]);
|
|
assert.equal(record.fixReceivedAtMs, 61_000);
|
|
assert.equal(record.fixFeedEpoch, 1_800_000_050);
|
|
assert.equal(record.receivedAtMs, 91_000);
|
|
});
|
|
|
|
test('vessels are keyed by their source id; a shared MMSI is only an attribute', () => {
|
|
const probe = setup();
|
|
probe.reconcile([
|
|
row('123456789', { id: 'hull-a', name: 'A' }),
|
|
row('123456789', { id: 'hull-b', name: 'B' }),
|
|
row('', { id: 'hull-c', name: 'C' }),
|
|
]);
|
|
assert.deepEqual(
|
|
[...probe.store.byId.keys()],
|
|
['hull-a', 'hull-b', 'hull-c'],
|
|
);
|
|
assert.equal(probe.store.unkeyed.length, 0);
|
|
const [a, b, c] = probe.store.all;
|
|
assert.deepEqual([a.mmsi, b.mmsi, c.mmsi], ['123456789', '123456789', '']);
|
|
assert.equal(a.reference, 'hull-a');
|
|
// The number moves to another hull: the vessel keeps its id.
|
|
probe.reconcile([
|
|
row('', { id: 'hull-a', name: 'A' }),
|
|
row('123456789', { id: 'hull-b', name: 'B' }),
|
|
row('123456789', { id: 'hull-c', name: 'C' }),
|
|
]);
|
|
assert.equal(probe.store.byId.get('hull-a'), a);
|
|
assert.equal(a.mmsi, '');
|
|
assert.equal(probe.store.byId.get('hull-c').mmsi, '123456789');
|
|
});
|
|
|
|
test('an AIS row with no id is keyed by its MMSI; one with neither is unkeyed', () => {
|
|
assert.deepEqual(
|
|
[
|
|
normalizeVessel(row('366999712')).id,
|
|
normalizeVessel(row('366999712')).mmsi,
|
|
],
|
|
['366999712', '366999712'],
|
|
);
|
|
const probe = setup();
|
|
probe.reconcile([row(''), row('', { id: '' })]);
|
|
assert.equal(probe.store.byId.size, 0);
|
|
assert.equal(probe.store.unkeyed.length, 2);
|
|
});
|