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 type { SecurityStatusSettingsCapabilities } from '@/types/config';
import { isTabLocked } from './settingsFeatureGates';
import { getSettingsNavItem } from './settingsNavCatalog';
import type { SettingsTab } from './settingsNavigationModel';
export interface SettingsNavVisibilityContext {
hasFeature: (feature: string) => boolean;
runtimeCapabilitiesLoaded: () => boolean;
presentationPolicyHidesCommercial?: boolean;
presentationPolicyHidesUpgrade?: boolean;
presentationPolicyIsDemoMode?: boolean;
presentationPolicyIsReadOnly?: boolean;
presentationPolicyHidesOrganizations?: boolean;
presentationPolicyResolved?: boolean;
hostedModeEnabled?: boolean;
settingsCapabilities?: Partial<SecurityStatusSettingsCapabilities> | null;
settingsCapabilitiesResolved?: boolean;
isRuntimeCapabilityBlocked?: (feature: string, reason?: string) => boolean;
}
export function canMountSettingsPanel(
tab: SettingsTab,
settingsCapabilities: Partial<SecurityStatusSettingsCapabilities> | null | undefined,
): boolean {
const requiredCapability = getSettingsNavItem(tab)?.requiredCapability;
return !requiredCapability || settingsCapabilities?.[requiredCapability] === true;
}
function hasRequiredFeatures(tab: SettingsTab, hasFeature: (feature: string) => boolean): boolean {
const requiredFeatures = getSettingsNavItem(tab)?.features ?? [];
return requiredFeatures.every((feature) => hasFeature(feature));
}
function missingFeaturesArePaidRuntimeBlocked(
tab: SettingsTab,
context: SettingsNavVisibilityContext,
): boolean {
const requiredFeatures = getSettingsNavItem(tab)?.features ?? [];
const missingFeatures = requiredFeatures.filter((feature) => !context.hasFeature(feature));
if (missingFeatures.length === 0) return false;
return missingFeatures.every((feature) =>
context.isRuntimeCapabilityBlocked?.(feature, 'paid_runtime_required'),
);
}
const PANEL_OWNED_FEATURE_GATE_TABS = new Set<SettingsTab>([
'system-relay',
'support-reporting',
'security-roles',
'security-users',
'security-audit',
'security-webhooks',
]);
export function shouldHideSettingsNavItem(
tab: SettingsTab,
context: SettingsNavVisibilityContext,
): boolean {
const item = getSettingsNavItem(tab);
if (!item) return false;
if (item.hostedOnly && !context.hostedModeEnabled) {
return true;
}
if (item.hideWhenOrganizationHidden) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyHidesOrganizations) {
return true;
}
}
if (item.hideWhenCommercialHidden) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyHidesCommercial) {
return true;
}
}
if (item.hideWhenUpgradeHidden) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyHidesUpgrade) {
return true;
}
}
if (item.hideWhenDemoMode) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyIsDemoMode) {
return true;
}
}
if (item.hideWhenReadOnly) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyIsReadOnly) {
return true;
}
}
if (
item.requiredCapability &&
context.settingsCapabilitiesResolved &&
context.settingsCapabilities?.[item.requiredCapability] !== true
) {
return true;
}
if (item.hideWhenUnavailable && !hasRequiredFeatures(tab, context.hasFeature)) {
if (missingFeaturesArePaidRuntimeBlocked(tab, context)) {
return false;
}
return true;
}
return false;
}
export function shouldBlockSettingsRouteItem(
tab: SettingsTab,
context: SettingsNavVisibilityContext,
): boolean {
const item = getSettingsNavItem(tab);
if (!item) return false;
if (item.hostedOnly && !context.hostedModeEnabled) {
return true;
}
if (item.hideWhenOrganizationHidden) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyHidesOrganizations) {
return true;
}
}
if (item.hideWhenCommercialHidden) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyHidesCommercial) {
return true;
}
}
if (item.hideWhenDemoMode) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyIsDemoMode) {
return true;
}
}
if (item.hideWhenReadOnly) {
if (context.presentationPolicyResolved === false) {
return true;
}
if (context.presentationPolicyIsReadOnly) {
return true;
}
}
if (
item.requiredCapability &&
context.settingsCapabilitiesResolved &&
context.settingsCapabilities?.[item.requiredCapability] !== true
) {
return true;
}
if (
item.hideWhenUnavailable &&
!PANEL_OWNED_FEATURE_GATE_TABS.has(tab) &&
!hasRequiredFeatures(tab, context.hasFeature)
) {
if (missingFeaturesArePaidRuntimeBlocked(tab, context)) {
return false;
}
return true;
}
return false;
}
export function isSettingsNavItemLocked(
tab: SettingsTab,
context: SettingsNavVisibilityContext,
): boolean {
const item = getSettingsNavItem(tab);
if (!item || item.hideWhenUnavailable) {
return false;
}
return isTabLocked(tab, context.hasFeature, context.runtimeCapabilitiesLoaded);
}