@ingissa/navcore-simulator 1.0.3 → 1.0.4

package/dist/replay/SessionRecorder.js

@@ -1,120 +0,0 @@
-/**
- * SessionRecorder — Record and export simulation sessions.
- *
- * Supports JSON, GPX 1.1, and CSV export formats.
- *
- * The GPX export is the critical format: a session recorded in the simulator
- * can be exported as GPX, then replayed via GpxParser on a future run.
- * This creates a full regression test loop:
- *   real GPS trace → gpx → GpxParser → SimulatorEngine → CI test
- */
-/** Generate a UUID v4 without external dependencies */
-function uuidV4() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-        const r = (Math.random() * 16) | 0;
-        const v = c === 'x' ? r : (r & 0x3) | 0x8;
-        return v.toString(16);
-    });
-}
-export class SessionRecorder {
-    constructor() {
-        this._sessionId = null;
-        this._startedAt = null;
-        this._session = null;
-    }
-    /**
-     * Start a new recording.
-     * If the engine already has a session via startRecording(), you can pass
-     * the existing sessionId to keep IDs consistent.
-     */
-    start(sessionId) {
-        this._sessionId = sessionId ?? uuidV4();
-        this._startedAt = Date.now();
-        this._session = null;
-    }
-    /**
-     * Stop recording and return the captured session.
-     * If called with an existing SimSession (from SimulatorEngine.stopRecording()),
-     * it stores that session for subsequent export() calls.
-     */
-    stop(existing) {
-        if (existing) {
-            this._session = existing;
-            return existing;
-        }
-        // Minimal empty session if stop() is called without an engine session
-        const session = {
-            id: this._sessionId ?? uuidV4(),
-            startedAt: new Date(this._startedAt ?? Date.now()).toISOString(),
-            endedAt: new Date().toISOString(),
-            route: [],
-            positions: [],
-            scenarios: [],
-            stats: {
-                durationMs: Date.now() - (this._startedAt ?? Date.now()),
-                distanceTravelledM: 0,
-                avgSpeedKmh: 0,
-                noiseSamplesAdded: 0,
-                scenariosFired: 0,
-            },
-        };
-        this._session = session;
-        return session;
-    }
-    /**
-     * Export the most recent session in the specified format.
-     * Must call stop() first.
-     */
-    export(format) {
-        const session = this._session;
-        if (!session)
-            throw new Error('SessionRecorder: call stop() before export()');
-        switch (format) {
-            case 'json':
-                return JSON.stringify(session, null, 2);
-            case 'gpx':
-                return SessionRecorder._toGpx(session);
-            case 'csv':
-                return SessionRecorder._toCsv(session);
-            default:
-                throw new Error(`SessionRecorder: unknown format "${format}"`);
-        }
-    }
-    // ── Static export helpers ───────────────────────────────────────────────────
-    static _toGpx(session) {
-        const trkpts = session.positions
-            .map((p) => {
-            const time = new Date(p.timestamp).toISOString();
-            return (`    <trkpt lat="${p.coord[1]}" lon="${p.coord[0]}">\n` +
-                `      <time>${time}</time>\n` +
-                `      <extensions>\n` +
-                `        <speed>${p.speed.toFixed(4)}</speed>\n` +
-                `        <bearing>${p.bearing.toFixed(4)}</bearing>\n` +
-                `        <accuracy>${p.accuracy.toFixed(2)}</accuracy>\n` +
-                `      </extensions>\n` +
-                `    </trkpt>`);
-        })
-            .join('\n');
-        return (`<?xml version="1.0" encoding="UTF-8"?>\n` +
-            `<gpx version="1.1" creator="@ingissa/navcore-simulator"\n` +
-            `     xmlns="http://www.topografix.com/GPX/1/1"\n` +
-            `     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\n` +
-            `     xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">\n` +
-            `  <metadata>\n` +
-            `    <name>${session.id}</name>\n` +
-            `    <time>${session.startedAt}</time>\n` +
-            `  </metadata>\n` +
-            `  <trk>\n` +
-            `    <name>${session.id}</name>\n` +
-            `    <trkseg>\n` +
-            trkpts + '\n' +
-            `    </trkseg>\n` +
-            `  </trk>\n` +
-            `</gpx>`);
-    }
-    static _toCsv(session) {
-        const header = 'timestamp,lng,lat,bearing,speed,accuracy';
-        const rows = session.positions.map((p) => `${p.timestamp},${p.coord[0]},${p.coord[1]},${p.bearing.toFixed(4)},${p.speed.toFixed(4)},${p.accuracy.toFixed(2)}`);
-        return [header, ...rows].join('\n');
-    }
-}

package/dist/scenarios/ScenarioInjector.d.ts

@@ -1,55 +0,0 @@
-/**
- * ScenarioInjector — Registers and fires Scenario objects at geometry indices.
- *
- * Called internally by SimulatorEngine on each tick.
- * Also provides static factory methods for the built-in scenario types.
- */
-import type { Scenario } from '../core/types';
-export type ScenarioFireCallback = (scenario: Scenario) => void;
-export type ScenarioEndCallback = (scenario: Scenario) => void;
-export declare class ScenarioInjector {
-    /** Map from triggerIndex → Scenario */
-    private readonly scenarios;
-    /** Tracks which scenarios have already fired (by name) to avoid double-fire */
-    private readonly fired;
-    /** Currently active scenario, if any */
-    private _activeScenario;
-    private _activeEndTimer;
-    private onStart;
-    private onEnd;
-    constructor(onStart?: ScenarioFireCallback, onEnd?: ScenarioEndCallback);
-    register(scenario: Scenario): void;
-    remove(name: string): void;
-    clear(): void;
-    /**
-     * Check and fire any scenario whose triggerIndex matches (or was passed) by
-     * currentIndex. Called by SimulatorEngine on every tick.
-     *
-     * Returns the name of the active scenario (if any), for metadata injection.
-     */
-    tick(currentIndex: number): string | undefined;
-    get activeScenario(): Scenario | null;
-    /** Clean up any pending timers */
-    destroy(): void;
-    /**
-     * GPS blackout: no position updates for `durationMs`.
-     * Engine handles signal loss; this scenario signals the blackout period.
-     */
-    static gpsBlackout(atIndex: number, durationMs: number): Scenario;
-    /**
-     * Wrong-side road: offset the simulated position by `offsetM` metres
-     * perpendicular to the route to stress-test the parallel road resolver.
-     */
-    static wrongSideRoad(atIndex: number, offsetM: number): Scenario;
-    /** U-turn at the given index — stress-tests U-turn protection. */
-    static uTurn(atIndex: number): Scenario;
-    /** Speed spike: briefly report spikeKmh instead of the configured speed. */
-    static speedSpike(atIndex: number, spikeKmh: number, durationMs?: number): Scenario;
-    /**
-     * Accuracy drop: GPS accuracy degrades to newAccuracyM for durationMs.
-     */
-    static accuracyDrop(atIndex: number, newAccuracyM: number, durationMs: number): Scenario;
-    private _fire;
-    private _clearActiveTimer;
-}
-//# sourceMappingURL=ScenarioInjector.d.ts.map

package/dist/scenarios/ScenarioInjector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ScenarioInjector.d.ts","sourceRoot":"","sources":["../../src/scenarios/ScenarioInjector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAE/D,qBAAa,gBAAgB;IAC3B,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,wCAAwC;IACxC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,eAAe,CAA8C;IAErE,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAAsB;gBAEvB,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE,mBAAmB;IAOvE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS1B,KAAK,IAAI,IAAI;IASb;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAa9C,IAAI,cAAc,IAAI,QAAQ,GAAG,IAAI,CAEpC;IAED,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAMf;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ;IAUjE;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;IAShE,kEAAkE;IAClE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IASvC,4EAA4E;IAC5E,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAO,GAAG,QAAQ;IAUjF;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ;IAYxF,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/scenarios/ScenarioInjector.js

@@ -1,150 +0,0 @@
-/**
- * ScenarioInjector — Registers and fires Scenario objects at geometry indices.
- *
- * Called internally by SimulatorEngine on each tick.
- * Also provides static factory methods for the built-in scenario types.
- */
-export class ScenarioInjector {
-    constructor(onStart, onEnd) {
-        /** Map from triggerIndex → Scenario */
-        this.scenarios = new Map();
-        /** Tracks which scenarios have already fired (by name) to avoid double-fire */
-        this.fired = new Set();
-        /** Currently active scenario, if any */
-        this._activeScenario = null;
-        this._activeEndTimer = null;
-        this.onStart = onStart ?? (() => undefined);
-        this.onEnd = onEnd ?? (() => undefined);
-    }
-    // ── Registration ────────────────────────────────────────────────────────────
-    register(scenario) {
-        this.scenarios.set(scenario.triggerIndex, scenario);
-    }
-    remove(name) {
-        for (const [idx, s] of this.scenarios) {
-            if (s.name === name) {
-                this.scenarios.delete(idx);
-                break;
-            }
-        }
-    }
-    clear() {
-        this.scenarios.clear();
-        this.fired.clear();
-        this._clearActiveTimer();
-        this._activeScenario = null;
-    }
-    // ── Tick ────────────────────────────────────────────────────────────────────
-    /**
-     * Check and fire any scenario whose triggerIndex matches (or was passed) by
-     * currentIndex. Called by SimulatorEngine on every tick.
-     *
-     * Returns the name of the active scenario (if any), for metadata injection.
-     */
-    tick(currentIndex) {
-        const floorIdx = Math.floor(currentIndex);
-        for (const [triggerIdx, scenario] of this.scenarios) {
-            if (floorIdx >= triggerIdx && !this.fired.has(scenario.name)) {
-                this.fired.add(scenario.name);
-                this._fire(scenario);
-            }
-        }
-        return this._activeScenario?.name;
-    }
-    get activeScenario() {
-        return this._activeScenario;
-    }
-    /** Clean up any pending timers */
-    destroy() {
-        this._clearActiveTimer();
-    }
-    // ── Static factories ────────────────────────────────────────────────────────
-    /**
-     * GPS blackout: no position updates for `durationMs`.
-     * Engine handles signal loss; this scenario signals the blackout period.
-     */
-    static gpsBlackout(atIndex, durationMs) {
-        return {
-            name: `gps-blackout-@${atIndex}`,
-            triggerIndex: atIndex,
-            type: 'GPS_BLACKOUT',
-            durationMs,
-            params: { durationMs },
-        };
-    }
-    /**
-     * Wrong-side road: offset the simulated position by `offsetM` metres
-     * perpendicular to the route to stress-test the parallel road resolver.
-     */
-    static wrongSideRoad(atIndex, offsetM) {
-        return {
-            name: `wrong-side-@${atIndex}`,
-            triggerIndex: atIndex,
-            type: 'WRONG_SIDE_ROAD',
-            params: { offsetM },
-        };
-    }
-    /** U-turn at the given index — stress-tests U-turn protection. */
-    static uTurn(atIndex) {
-        return {
-            name: `uturn-@${atIndex}`,
-            triggerIndex: atIndex,
-            type: 'UTURN',
-            params: {},
-        };
-    }
-    /** Speed spike: briefly report spikeKmh instead of the configured speed. */
-    static speedSpike(atIndex, spikeKmh, durationMs = 2000) {
-        return {
-            name: `speed-spike-@${atIndex}`,
-            triggerIndex: atIndex,
-            type: 'SPEED_SPIKE',
-            durationMs,
-            params: { spikeKmh },
-        };
-    }
-    /**
-     * Accuracy drop: GPS accuracy degrades to newAccuracyM for durationMs.
-     */
-    static accuracyDrop(atIndex, newAccuracyM, durationMs) {
-        return {
-            name: `accuracy-drop-@${atIndex}`,
-            triggerIndex: atIndex,
-            type: 'ACCURACY_DROP',
-            durationMs,
-            params: { newAccuracyM },
-        };
-    }
-    // ── Private ─────────────────────────────────────────────────────────────────
-    _fire(scenario) {
-        this._activeScenario = scenario;
-        try {
-            this.onStart(scenario);
-        }
-        catch (_) { /* never throw from callback */ }
-        if (scenario.durationMs != null && scenario.durationMs > 0) {
-            this._clearActiveTimer();
-            this._activeEndTimer = setTimeout(() => {
-                this._activeScenario = null;
-                try {
-                    this.onEnd(scenario);
-                }
-                catch (_) { /* never throw */ }
-            }, scenario.durationMs);
-        }
-        else {
-            // Instantaneous scenario — end immediately
-            this._activeScenario = null;
-            try {
-                this.onEnd(scenario);
-            }
-            catch (_) { /* never throw */ }
-        }
-    }
-    _clearActiveTimer() {
-        if (this._activeEndTimer !== null) {
-            clearTimeout(this._activeEndTimer);
-            this._activeEndTimer = null;
-        }
-    }
-}