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 { beforeEach, describe, expect, it, vi } from 'vitest';
import { LicenseAPI } from '../license';
import { apiFetchJSON } from '@/utils/apiClient';
vi.mock('@/utils/apiClient', () => ({
apiFetchJSON: vi.fn(),
}));
describe('LicenseAPI', () => {
beforeEach(() => {
vi.clearAllMocks();
});
it('binds a billing status read to the selected session and cancellation signal', async () => {
const controller = new AbortController();
const options = {
expectedOrgID: 'org-a',
signal: controller.signal,
retry: false as const,
preferSessionAuth: true as const,
};
await LicenseAPI.getStatus(options);
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/status', options);
});
it('keeps unbound status reads unchanged for existing callers', async () => {
await LicenseAPI.getStatus();
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/status');
});
it('reads runtime capabilities from the canonical runtime endpoint', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
capabilities: ['relay'],
limits: [],
hosted_mode: false,
max_history_days: 14,
runtime: { build: 'community', label: 'Pulse Community runtime' },
blocked_capabilities: [
{ key: 'audit_logging', reason: 'paid_runtime_required', action_url: '/download' },
],
});
const result = await LicenseAPI.getRuntimeCapabilities();
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/runtime-capabilities');
expect(result).toMatchObject({
capabilities: ['relay'],
max_history_days: 14,
runtime: { build: 'community', label: 'Pulse Community runtime' },
blocked_capabilities: [
{ key: 'audit_logging', reason: 'paid_runtime_required', action_url: '/download' },
],
});
});
it('normalizes null runtime capability collections to arrays', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
capabilities: null,
limits: null,
hosted_mode: false,
max_history_days: 7,
blocked_capabilities: null,
});
const result = await LicenseAPI.getRuntimeCapabilities();
expect(result.capabilities).toEqual([]);
expect(result.limits).toEqual([]);
expect(result.blocked_capabilities).toEqual([]);
});
it('reads commercial entitlements from the commercial endpoint', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
tier: 'pro',
subscription_state: 'active',
capabilities: ['relay'],
limits: [],
upgrade_reasons: [],
});
const result = await LicenseAPI.getCommercialEntitlements();
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/entitlements');
expect(result).toMatchObject({
tier: 'pro',
subscription_state: 'active',
});
});
it('preserves commercial migration timing fields from entitlements', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
tier: 'free',
subscription_state: 'expired',
capabilities: [],
limits: [],
upgrade_reasons: [],
commercial_migration: {
state: 'pending',
reason: 'exchange_connectivity_required',
recommended_action: 'allow_license_egress',
first_failed_at: 1_700_000_000,
},
});
const result = await LicenseAPI.getCommercialEntitlements();
expect(result.commercial_migration).toMatchObject({
state: 'pending',
reason: 'exchange_connectivity_required',
recommended_action: 'allow_license_egress',
first_failed_at: 1_700_000_000,
});
});
it('reads commercial posture from the public-safe commercial endpoint', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
tier: 'pro',
subscription_state: 'active',
upgrade_reasons: [],
trial_eligible: false,
});
const result = await LicenseAPI.getCommercialPosture();
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/commercial-posture');
expect(result).toMatchObject({
tier: 'pro',
subscription_state: 'active',
});
});
it('keeps getEntitlements as a compatibility alias for the commercial endpoint', async () => {
vi.mocked(apiFetchJSON).mockResolvedValueOnce({
tier: 'free',
subscription_state: 'expired',
capabilities: [],
limits: [],
upgrade_reasons: [],
});
await LicenseAPI.getEntitlements();
expect(apiFetchJSON).toHaveBeenCalledWith('/api/license/entitlements');
});
it('does not expose a normal self-hosted trial-start client', () => {
expect('startTrial' in LicenseAPI).toBe(false);
});
});