mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-17 00:32:21 +00:00
createApplicationCatalog takes an optional placement provider. Its layer(kind) hands Flights, Military Flights, AIS Vessels, Transit and Rail a place(id, wallMs), and optionally observe(id, fix) and forget(id). While live, each layer tells it every fix it accepts and draws a contact where it places it: position, height (the layer's own when none is given), course and speed. A null answer, a provider that throws, a kind it leaves out, or no provider at all keeps the layer's own motion unchanged, and following the world clock the layers never ask it. A transit vehicle or train it holds still lets the render loop idle and is asked again each second; vessels ask for frames only while it places one, and stop when the layer turns off. Tests show the layers draw and reconcile exactly as before without a provider and with one that places nothing, draw where a provider places them, and idle while it holds them still.
214 lines
7.3 KiB
JavaScript
214 lines
7.3 KiB
JavaScript
import { DEFAULT_AIS_RUNTIME } from './policy.js';
|
|
|
|
export function createTesting({
|
|
vesselState,
|
|
services,
|
|
parts: components,
|
|
layer,
|
|
options,
|
|
}) {
|
|
const { state } = vesselState;
|
|
const aisLiveVesselsLayer = layer;
|
|
|
|
/**
|
|
* Bind the production interaction callbacks to mockable viewer/handler
|
|
* surfaces. Test-only seam; behavior is shared with installInteraction().
|
|
* @param {Object} viewer - Viewer-like object with scene.pick().
|
|
* @param {Object} handler - Handler-like object with setInputAction().
|
|
* @param {Object} keyTarget - EventTarget-like object with add/removeEventListener().
|
|
* @returns {void}
|
|
*/
|
|
|
|
function _bindVesselInteractionForTest(viewer, handler, keyTarget) {
|
|
components.selection.bindVesselInteraction(viewer, handler, keyTarget);
|
|
}
|
|
|
|
/**
|
|
* Prime the minimum live state needed by interaction/lifecycle wire tests.
|
|
* @param {Object} [options={}] - Test state values.
|
|
* @returns {void}
|
|
*/
|
|
|
|
function _setVesselStateForTest(options = {}) {
|
|
components.lifecycle.resetState();
|
|
const records = Array.isArray(options.records) ? options.records : [];
|
|
// A test record that names no id is keyed by its MMSI, as an AIS feed's
|
|
// own rows are (see normalizeVessel).
|
|
for (const record of [...records, options.selectedRecord])
|
|
if (record && typeof record === 'object' && record.id === undefined)
|
|
record.id = String(record.mmsi || '').trim();
|
|
state.viewer = options.viewer || null;
|
|
state.feed.enabled = options.enabled !== false;
|
|
state.feed.loaded = options.loaded === true;
|
|
state.feed.loading = options.loading === true;
|
|
state.feed.stale = options.stale === true;
|
|
state.feed.partial = options.partial === true;
|
|
state.feed.error = options.error || null;
|
|
state.feed.lastUpdate = options.lastUpdate ?? null;
|
|
state.records.all = records;
|
|
state.feed.count = records.length;
|
|
state.records.byId = new Map(
|
|
records
|
|
.filter((record) => record?.id)
|
|
.map((record) => [record.id, record]),
|
|
);
|
|
state.selectedRecord = options.selectedRecord || null;
|
|
state.billboardCollection = options.billboardCollection || { remove() {} };
|
|
state.trail = options.trail || null;
|
|
state.trailId = options.trailId || null;
|
|
state.trailPositions = Array.isArray(options.trailPositions)
|
|
? [...options.trailPositions]
|
|
: [];
|
|
state.feed.transportStatus = options.transportStatus || null;
|
|
state.feed.lastMessageAt = options.lastMessageAt ?? null;
|
|
state.feed.rawRowCount = Number.isFinite(options.rawRowCount)
|
|
? options.rawRowCount
|
|
: 0;
|
|
state.feed.acceptedRowCount = Number.isFinite(options.acceptedRowCount)
|
|
? options.acceptedRowCount
|
|
: records.length;
|
|
state.feed.firstConnectPhase = options.firstConnectPhase || 'idle';
|
|
state.feed.firstConnectStartedAt = options.firstConnectStartedAt ?? null;
|
|
state.feed.firstConnectDeadline = options.firstConnectDeadline ?? null;
|
|
state.interactionHandlerFactory = options.interactionHandlerFactory || null;
|
|
state.interactionKeyTarget = options.interactionKeyTarget || null;
|
|
}
|
|
|
|
/** Inject a host recorder for lifecycle/contract tests; null restores production. */
|
|
|
|
function _setVesselOverlayHostForTest(host = null) {
|
|
vesselState._vesselOverlayHost =
|
|
host || vesselState.DEFAULT_VESSEL_OVERLAY_HOST;
|
|
}
|
|
|
|
/** Exercise the production selector/publisher through a test-owned state. */
|
|
|
|
function _updateVesselCardsForTest(records = []) {
|
|
components.rendering.updateClusteredLabels(records);
|
|
}
|
|
|
|
/**
|
|
* Reconcile AIS rows through the production lifecycle. Test-only seam.
|
|
* @param {Object} viewer - Viewer-like object.
|
|
* @param {Array<Object>} rows - Raw AIS rows.
|
|
* @returns {void}
|
|
*/
|
|
|
|
function _reconcileVesselsForTest(viewer, rows) {
|
|
components.snapshots.reconcileVessels(viewer, rows);
|
|
}
|
|
|
|
/** Apply one server snapshot through the production pre-reconcile health gate. */
|
|
|
|
function _applyAisFeedSnapshotForTest(viewer, payload) {
|
|
return components.ingestion.applyAisFeedSnapshot(viewer, payload);
|
|
}
|
|
|
|
/** Exercise the request-owned live loader with a test-controlled fetch. */
|
|
|
|
function _loadLivePositionsForTest(viewer) {
|
|
return components.ingestion.loadLivePositions(viewer);
|
|
}
|
|
|
|
/** Start the production first-connect grace state without installing UI. */
|
|
|
|
function _beginAisSessionForTest() {
|
|
components.lifecycle.beginAisSession();
|
|
}
|
|
|
|
/** Inject a deterministic clock/scheduler; null restores production runtime. */
|
|
|
|
function _setAisRuntimeForTest(runtime = null) {
|
|
components.lifecycle.clearFirstConnectTimer();
|
|
vesselState._aisRuntime = runtime
|
|
? {
|
|
now: runtime.now,
|
|
setTimeout: runtime.setTimeout,
|
|
clearTimeout: runtime.clearTimeout,
|
|
}
|
|
: DEFAULT_AIS_RUNTIME;
|
|
}
|
|
|
|
/** Read feed-health fields without exposing mutable production state. */
|
|
|
|
function _getVesselFeedStateForTest() {
|
|
const stats = aisLiveVesselsLayer.getStats();
|
|
return {
|
|
count: state.feed.count,
|
|
loaded: state.feed.loaded,
|
|
loading: stats.loading,
|
|
loadingLabel: stats.loadingLabel,
|
|
stale: state.feed.stale,
|
|
error: state.feed.error,
|
|
status: stats.status,
|
|
lastUpdate: state.feed.lastUpdate,
|
|
transportStatus: state.feed.transportStatus,
|
|
lastMessageAt: state.feed.lastMessageAt,
|
|
rawRowCount: state.feed.rawRowCount,
|
|
acceptedRowCount: state.feed.acceptedRowCount,
|
|
selectedId: state.selectedRecord?.id || null,
|
|
trailId: state.trailId,
|
|
trailPositionCount: state.trailPositions.length,
|
|
sessionId: state.feed.sessionId,
|
|
firstConnectPhase: state.feed.firstConnectPhase,
|
|
firstConnectStartedAt: state.feed.firstConnectStartedAt,
|
|
firstConnectDeadline: state.feed.firstConnectDeadline,
|
|
};
|
|
}
|
|
|
|
/** Run one preRender visibility/focus pass. Test-only seam. */
|
|
|
|
function _runVisibilityPassForTest(force = false) {
|
|
components.rendering.updateVisibility(force);
|
|
}
|
|
|
|
/** Draw a record's visual where it stands now. Test-only seam. */
|
|
|
|
function _prepareVesselVisualForTest(record) {
|
|
return components.rendering.prepareRecordVisual(record);
|
|
}
|
|
|
|
/** Run one live placement pass (a host-supplied placement). Test-only seam. */
|
|
|
|
function _runPlacementPassForTest() {
|
|
components.rendering.followPlacements();
|
|
}
|
|
|
|
/** True while a trailing visibility frame is scheduled. Test-only seam. */
|
|
|
|
function _hasTrailingVisibilityPassForTest() {
|
|
return state.trailingVisibilityTimer !== null;
|
|
}
|
|
|
|
/**
|
|
* Read lifecycle ownership state without exposing the mutable state object.
|
|
* Test-only seam.
|
|
* @returns {{trailId: string|null, trailPositionCount: number, vesselCount: number}}
|
|
*/
|
|
|
|
function _getVesselStateForTest() {
|
|
return {
|
|
trailId: state.trailId,
|
|
trailPositionCount: state.trailPositions.length,
|
|
vesselCount: state.records.byId.size,
|
|
};
|
|
}
|
|
return {
|
|
_bindVesselInteractionForTest,
|
|
_setVesselStateForTest,
|
|
_setVesselOverlayHostForTest,
|
|
_updateVesselCardsForTest,
|
|
_reconcileVesselsForTest,
|
|
_applyAisFeedSnapshotForTest,
|
|
_loadLivePositionsForTest,
|
|
_beginAisSessionForTest,
|
|
_setAisRuntimeForTest,
|
|
_getVesselFeedStateForTest,
|
|
_getVesselStateForTest,
|
|
_runVisibilityPassForTest,
|
|
_prepareVesselVisualForTest,
|
|
_runPlacementPassForTest,
|
|
_hasTrailingVisibilityPassForTest,
|
|
};
|
|
}
|