electric-cherry/tests/unit/ui-server-clock.test.ts

import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { get } from 'svelte/store';
import { freshServer, matchesFleet, type FleetServer } from '../../src/lib/fleet-overview.js';
import type { ServerStatus } from '../../src/lib/ui/stores/servers.js';

vi.mock('$app/environment', () => ({ browser: true }));

const epoch = Date.parse('2026-09-19T12:00:00Z');
let source: EventTarget;
let stop: (() => void) | undefined;
let snapshot: { serverNow: number; servers: FleetServer[]; integrations: object };

function server(timestamp = epoch, changes: Partial<FleetServer> = {}): FleetServer {
    return {
        name: 't5_zombie_theater_1', game: 't5', map: 'zombie_theater',
        last_players: 0, last_map: 'zombie_theater', last_gametype: 'zom',
        last_seen_at: new Date(timestamp).toISOString(), last_error: null,
        roster: [], health: 'online', held: [], active_since: null,
        inactive_since: new Date(epoch).toISOString(), game_started_at: null,
        game_ended_at: null, ...changes
    };
}

function status(timestamp: number, changes: Partial<ServerStatus> = {}): ServerStatus {
    return {
        server: 't5_zombie_theater_1', players: 0, map: 'zombie_theater', gametype: 'zom',
        roster: [], health: 'online', lastSeenAt: new Date(timestamp).toISOString(),
        lastError: null, endpoint: null, reason: null, replySnippet: null,
        activeSince: null, inactiveSince: new Date(epoch).toISOString(),
        gameStartedAt: null, gameEndedAt: null, ...changes
    };
}

function emit(serverNow: number, entries: ServerStatus[]) {
    source.dispatchEvent(new MessageEvent('server-status', { data: JSON.stringify({ serverNow, entries }) }));
}

beforeEach(() => {
    vi.resetModules();
    vi.useFakeTimers({ toFake: ['Date', 'performance', 'setTimeout', 'clearTimeout', 'setInterval', 'clearInterval'] });
    vi.setSystemTime(epoch);
    snapshot = { serverNow: epoch, servers: [server()], integrations: {} };
    vi.stubGlobal('fetch', vi.fn(async (url: string) => new Response(JSON.stringify(
        url === '/api/servers' ? snapshot : { operations: [] }
    ))));
    vi.stubGlobal('EventSource', class extends EventTarget {
        constructor() { super(); source = this; }
        close() {}
    });
});

afterEach(() => {
    stop?.(); stop = undefined;
    vi.useRealTimers();
    vi.unstubAllGlobals();
    vi.restoreAllMocks();
});

async function setup() {
    const clock = await import('../../src/lib/ui/stores/servers.js');
    const fleet = await import('../../src/lib/ui/stores/fleet.js');
    stop = clock.startServerStream();
    await fleet.refreshFleet();
    return { ...clock, ...fleet };
}

describe('Fleet report clock', () => {
    it.each([-2500, 60_000])('keeps fresh HTTP and streamed reports healthy with a browser clock offset of %i ms', async (offset) => {
        vi.setSystemTime(epoch + offset);
        const { fleetServers, uiNow, refreshFleet } = await setup();
        const expectHealthy = () => {
            const current = get(fleetServers)[0];
            expect(freshServer(current, get(uiNow))).toBe(true);
            expect(matchesFleet(current, '', 'empty', '', [], [], get(uiNow))).toBe(true);
            expect(matchesFleet(current, '', 'attention', '', [], [], get(uiNow))).toBe(false);
        };
        expect(get(uiNow)).toBe(epoch);
        expectHealthy();
        for (let cycle = 1; cycle <= 3; cycle++) {
            for (let second = 0; second < 30; second++) {
                await vi.advanceTimersByTimeAsync(1000);
                expectHealthy();
            }
            const now = epoch + cycle * 30_000;
            emit(now, [status(now)]);
            expectHealthy();
            snapshot = { ...snapshot, serverNow: now, servers: [server(now)] };
            await refreshFleet();
            expectHealthy();
        }
    });

    it('updates the clock before exposing a new status after a suspended UI ticker', async () => {
        const { fleetServers, uiNow } = await setup();
        vi.spyOn(performance, 'now').mockReturnValue(30_000);
        vi.setSystemTime(epoch + 30_000);
        expect(get(uiNow)).toBe(epoch);
        emit(epoch + 30_000, [status(epoch + 30_000)]);
        expect(get(uiNow)).toBe(epoch + 30_000);
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(true);
    });

    it('does not rewind the clock when an older HTTP snapshot follows a newer stream update', async () => {
        const { fleetServers, uiNow, refreshFleet } = await setup();
        let resolveSnapshot!: (response: Response) => void;
        vi.mocked(fetch).mockImplementationOnce(() => new Promise(resolve => { resolveSnapshot = resolve; }));
        const refreshing = refreshFleet();
        await vi.advanceTimersByTimeAsync(4000);
        emit(epoch + 4000, [status(epoch + 4000)]);
        resolveSnapshot(new Response(JSON.stringify(snapshot)));
        await refreshing;
        expect(get(uiNow)).toBe(epoch + 4000);
        expect(get(fleetServers)[0].last_seen_at).toBe(new Date(epoch + 4000).toISOString());
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(true);
    });

    it('keeps advancing through wall-clock changes and expires a report if updates stop', async () => {
        const { fleetServers, uiNow } = await setup();
        vi.setSystemTime(epoch - 120_000);
        await vi.advanceTimersByTimeAsync(45_000);
        expect(get(uiNow)).toBe(epoch + 45_000);
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(true);
        await vi.advanceTimersByTimeAsync(1000);
        expect(get(uiNow)).toBe(epoch + 46_000);
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(false);
        expect(matchesFleet(get(fleetServers)[0], '', 'attention', '', [], [], get(uiNow))).toBe(true);
    });

    it('preserves actual RCON failures and stopped-container health', async () => {
        const { fleetServers, uiNow } = await setup();
        await vi.advanceTimersByTimeAsync(1000);
        emit(epoch + 1000, [status(epoch, { health: 'stale', lastError: 'timeout:no reply', reason: 'timeout' })]);
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(false);
        expect(matchesFleet(get(fleetServers)[0], '', 'attention', '', [], [], get(uiNow))).toBe(true);
        emit(epoch + 1000, [status(epoch, { health: 'offline' })]);
        expect(get(fleetServers)[0].health).toBe('offline');
        expect(freshServer(get(fleetServers)[0], get(uiNow))).toBe(false);
    });

    it('anchors the initial telemetry snapshot even before Fleet finishes loading', async () => {
        vi.setSystemTime(epoch - 60_000);
        const { startServerStream, uiNow } = await import('../../src/lib/ui/stores/servers.js');
        stop = startServerStream();
        source.dispatchEvent(new MessageEvent('server-telemetry', {
            data: JSON.stringify({ serverNow: epoch, entries: [], snapshot: true })
        }));
        expect(get(uiNow)).toBe(epoch);
        await vi.advanceTimersByTimeAsync(1000);
        expect(get(uiNow)).toBe(epoch + 1000);
    });
});