Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
import { describe, expect, it } from 'vitest';
import type { Resource } from '@/types/resource';
import {
collectOutdatedAgentHosts,
compareAgentVersions,
formatAgentVersionDisplay,
hostAgentConnectionID,
hostAgentVersion,
parseAgentVersion,
} from './agentVersion';
describe('parseAgentVersion', () => {
it('parses a plain semver', () => {
expect(parseAgentVersion('6.0.0')).toEqual({ major: 6, minor: 0, patch: 0, prerelease: [] });
});
it('tolerates a leading v and strips build metadata', () => {
expect(parseAgentVersion('v6.0.0-rc.6+git.151.gd8f5519ee')).toEqual({
major: 6,
minor: 0,
patch: 0,
prerelease: ['rc', '6'],
});
});
it('returns null for empty or non-semver input', () => {
expect(parseAgentVersion('')).toBeNull();
expect(parseAgentVersion(undefined)).toBeNull();
expect(parseAgentVersion('dev')).toBeNull();
expect(parseAgentVersion('6.0')).toBeNull();
});
});
describe('compareAgentVersions', () => {
it('orders rc.5 before rc.6', () => {
expect(compareAgentVersions('v6.0.0-rc.5', 'v6.0.0-rc.6')).toBe(-1);
expect(compareAgentVersions('v6.0.0-rc.6', 'v6.0.0-rc.5')).toBe(1);
});
it('treats equal versions as equal regardless of build metadata or v prefix', () => {
expect(compareAgentVersions('6.0.0-rc.6', 'v6.0.0-rc.6+git.151.gd8f5519ee')).toBe(0);
});
it('ranks a stable release above a pre-release of the same core', () => {
expect(compareAgentVersions('6.0.0-rc.6', '6.0.0')).toBe(-1);
expect(compareAgentVersions('6.0.0', '6.0.0-rc.6')).toBe(1);
});
it('orders by major, then minor, then patch', () => {
expect(compareAgentVersions('6.0.0', '7.0.0')).toBe(-1);
expect(compareAgentVersions('6.1.0', '6.0.9')).toBe(1);
expect(compareAgentVersions('6.0.1', '6.0.2')).toBe(-1);
});
it('returns null when either side is unparseable', () => {
expect(compareAgentVersions('dev', '6.0.0')).toBeNull();
expect(compareAgentVersions('6.0.0', undefined)).toBeNull();
});
});
describe('formatAgentVersionDisplay', () => {
it('normalises to a v-prefixed string without build metadata', () => {
expect(formatAgentVersionDisplay('6.0.0-rc.6+git.151.gd8f5519ee')).toBe('v6.0.0-rc.6');
expect(formatAgentVersionDisplay('v6.0.0')).toBe('v6.0.0');
});
it('returns an empty string for unparseable input', () => {
expect(formatAgentVersionDisplay('dev')).toBe('');
});
});
const host = (over: Partial<Resource>): Resource =>
({ id: 'x', name: 'host', type: 'docker-host', ...over }) as Resource;
describe('hostAgentVersion', () => {
it('reads the docker meta version for a docker host', () => {
expect(
hostAgentVersion(host({ docker: { agentVersion: 'v6.0.0-rc.5' } as Resource['docker'] })),
).toBe('v6.0.0-rc.5');
});
it('falls back to the agent meta version for a plain agent host', () => {
expect(
hostAgentVersion(host({ agent: { agentVersion: 'v6.0.0-rc.5' } as Resource['agent'] })),
).toBe('v6.0.0-rc.5');
});
it('reads the Kubernetes cluster-agent version projected onto node rows', () => {
expect(
hostAgentVersion(
host({
type: 'k8s-node',
kubernetes: { agentVersion: 'v6.0.0-rc.5' } as Resource['kubernetes'],
}),
),
).toBe('v6.0.0-rc.5');
});
it('prefers Kubernetes cluster-agent version for Kubernetes platform rows', () => {
expect(
hostAgentVersion(
host({
type: 'k8s-node',
agent: { agentVersion: 'v6.0.0-rc.6' } as Resource['agent'],
kubernetes: { agentVersion: 'v6.0.0-rc.5' } as Resource['kubernetes'],
}),
),
).toBe('v6.0.0-rc.5');
});
it('returns undefined when no version is reported', () => {
expect(hostAgentVersion(host({}))).toBeUndefined();
});
it('normalizes agent connection IDs from agent and Kubernetes metadata', () => {
expect(
hostAgentConnectionID(host({ agent: { agentId: 'agent-delly' } as Resource['agent'] })),
).toBe('agent:agent-delly');
expect(
hostAgentConnectionID(
host({
type: 'k8s-node',
kubernetes: { agentId: 'agent:agent-k8s' } as Resource['kubernetes'],
}),
),
).toBe('agent:agent-k8s');
});
it('prefers Kubernetes cluster-agent IDs for Kubernetes platform rows', () => {
expect(
hostAgentConnectionID(
host({
type: 'k8s-node',
agent: { agentId: 'agent-host' } as Resource['agent'],
kubernetes: { agentId: 'agent-k8s' } as Resource['kubernetes'],
}),
),
).toBe('agent:agent-k8s');
});
});
describe('collectOutdatedAgentHosts', () => {
const server = 'v6.0.0-rc.6+git.151.gd8f5519ee';
it('flags hosts strictly behind the server version', () => {
const hosts = [
host({ name: 'tower', docker: { agentVersion: 'v6.0.0-rc.5' } as Resource['docker'] }),
host({ name: 'current', docker: { agentVersion: 'v6.0.0-rc.6' } as Resource['docker'] }),
host({
name: 'delly',
agent: { agentId: 'agent-delly', agentVersion: 'v6.0.0-rc.5' } as Resource['agent'],
}),
];
expect(collectOutdatedAgentHosts(hosts, server)).toEqual([
{ name: 'tower', version: 'v6.0.0-rc.5' },
{ name: 'delly', version: 'v6.0.0-rc.5', agentId: 'agent:agent-delly' },
]);
});
it('does not flag hosts with no reported version', () => {
expect(collectOutdatedAgentHosts([host({ name: 'mystery' })], server)).toEqual([]);
});
it('does not present a retained version from a non-reporting agent as currently running', () => {
const providerBackedHost = host({
name: 'pi',
status: 'online',
agent: {
agentId: 'old-pi-agent',
agentVersion: 'v6.0.0-rc.5',
stale: true,
lastReportAt: '2026-08-08T23:05:41Z',
} as Resource['agent'],
});
expect(collectOutdatedAgentHosts([providerBackedHost], server)).toEqual([]);
});
it('returns nothing when the server version is unknown or unparseable', () => {
const hosts = [
host({ name: 'tower', docker: { agentVersion: 'v6.0.0-rc.5' } as Resource['docker'] }),
];
expect(collectOutdatedAgentHosts(hosts, '')).toEqual([]);
expect(collectOutdatedAgentHosts(hosts, 'dev')).toEqual([]);
});
});