Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

4.5 KB
Raw Blame
import { describe, expect, it } from 'vitest';
import { SETTINGS_NAV_GROUPS, getSettingsNavItem } from '../settingsNavCatalog';
import type { SettingsTab } from '../settingsNavigationModel';
import {
  canMountSettingsPanel,
  shouldBlockSettingsRouteItem,
  shouldHideSettingsNavItem,
  type SettingsNavVisibilityContext,
} from '../settingsNavVisibility';

const ADMIN_ONLY_TABS: ReadonlyArray<{
  tab: SettingsTab;
  capability: keyof NonNullable<SettingsNavVisibilityContext['settingsCapabilities']>;
}> = [
  { tab: 'monitoring-availability', capability: 'availabilityRead' },
  { tab: 'system-ai', capability: 'pulseIntelligenceRead' },
  { tab: 'system-ai-patrol', capability: 'pulseIntelligenceRead' },
  { tab: 'system-ai-agents', capability: 'pulseIntelligenceRead' },
  { tab: 'support-diagnostics', capability: 'diagnosticsRead' },
  { tab: 'support-reporting', capability: 'reportingRead' },
  { tab: 'support-logs', capability: 'systemLogsRead' },
];

const createContext = (
  overrides: Partial<SettingsNavVisibilityContext> = {},
): SettingsNavVisibilityContext => ({
  hasFeature: () => true,
  runtimeCapabilitiesLoaded: () => true,
  hostedModeEnabled: false,
  ...overrides,
});

const PAID_FEATURE_TABS: readonly SettingsTab[] = [
  'support-reporting',
  'security-roles',
  'security-users',
  'security-audit',
  'security-webhooks',
  'system-relay',
  'organization-overview',
  'organization-access',
  'organization-sharing',
  'organization-billing',
  'organization-billing-admin',
];

describe('paid-feature settings nav gates', () => {
  it.each(PAID_FEATURE_TABS)('%s is hidden without its paid feature and shown with it', (tab) => {
    const context = createContext({ hostedModeEnabled: true });

    expect(shouldHideSettingsNavItem(tab, { ...context, hasFeature: () => false })).toBe(true);
    expect(shouldHideSettingsNavItem(tab, { ...context, hasFeature: () => true })).toBe(false);
  });
});

describe('admin-only settings nav gates', () => {
  it.each(ADMIN_ONLY_TABS)('$tab declares $capability', ({ tab, capability }) => {
    expect(getSettingsNavItem(tab)?.requiredCapability).toBe(capability);
  });

  it.each(ADMIN_ONLY_TABS)(
    '$tab is hidden, route-blocked, and unmountable when $capability is withheld',
    ({ tab, capability }) => {
      const settingsCapabilities = { [capability]: false };
      const context = createContext({
        settingsCapabilitiesResolved: true,
        settingsCapabilities,
      });

      expect(shouldHideSettingsNavItem(tab, context)).toBe(true);
      expect(shouldBlockSettingsRouteItem(tab, context)).toBe(true);
      expect(canMountSettingsPanel(tab, settingsCapabilities)).toBe(false);
    },
  );

  it.each(ADMIN_ONLY_TABS)(
    '$tab remains reachable and mountable when $capability is granted',
    ({ tab, capability }) => {
      const settingsCapabilities = { [capability]: true };
      const context = createContext({
        settingsCapabilitiesResolved: true,
        settingsCapabilities,
      });

      expect(shouldHideSettingsNavItem(tab, context)).toBe(false);
      expect(shouldBlockSettingsRouteItem(tab, context)).toBe(false);
      expect(canMountSettingsPanel(tab, settingsCapabilities)).toBe(true);
    },
  );

  it.each(ADMIN_ONLY_TABS)(
    '$tab cannot mount before capabilities resolve even though the nav avoids flashing',
    ({ tab }) => {
      const context = createContext({
        settingsCapabilitiesResolved: false,
        settingsCapabilities: null,
      });

      expect(shouldHideSettingsNavItem(tab, context)).toBe(false);
      expect(shouldBlockSettingsRouteItem(tab, context)).toBe(false);
      expect(canMountSettingsPanel(tab, null)).toBe(false);
    },
  );

  it('keeps the user-scoped General panel mountable without a capability payload', () => {
    expect(getSettingsNavItem('system-general')?.requiredCapability).toBeUndefined();
    expect(canMountSettingsPanel('system-general', null)).toBe(true);
  });

  it('leaves General reachable after every admin-only capability is withheld', () => {
    const withheld = createContext({
      settingsCapabilitiesResolved: true,
      settingsCapabilities: {},
      hasFeature: () => false,
    });
    const reachable = SETTINGS_NAV_GROUPS.flatMap((group) => group.items)
      .filter((item) => !shouldBlockSettingsRouteItem(item.id, withheld))
      .map((item) => item.id);

    expect(reachable).toContain('system-general');
    expect(reachable).not.toContain('monitoring-availability');
    expect(reachable).not.toContain('support-diagnostics');
  });
});