import React, { useEffect, useContext, useState, useMemo } from "react"; import { useNavigate, useParams } from "react-router-dom"; import { Button, Checkbox, Col, Grid, Input, Popconfirm, Row, Space, Spin, Tooltip } from "antd"; import { ExclamationCircleOutlined, StarOutlined, DeleteOutlined} from "@ant-design/icons"; import * as lib from "@clusterio/lib"; import { useRole } from "../model/roles"; import { useAccount } from "../model/account"; import ControlContext from "./ControlContext"; import PageHeader from "./PageHeader"; import PageLayout from "./PageLayout"; import PluginExtra from "./PluginExtra"; import ResourceNotes from "./ResourceNotes"; import { notifyErrorHandler } from "../util/notify"; /** Splits a permission name into parts, removing the last part */ function getGroupName(name: string) { const parts = name.split("."); return parts.length <= 2 ? parts.slice(0, 2).join(".") : parts.slice(0, parts.length - 1).join("."); } /** Converts a group name into Title Case with _ and . removed */ function formatGroupTitle(name: string) { return name .replace(/\./g, " / ") .replace(/_/g, " ") .split(" ") .filter(Boolean) .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()) .join(" "); } /** Check if a permission is dangerous, in the future we might have metadata for this */ function isDangerous(permission: lib.Permission) { return ["delete", "kill", "stop", "revoke", "update", "core.admin"] .some(word => permission.name.includes(word)); } /** A single permission item inside a group; includes a checkbox, name, and description */ function PermissionItem({ permission, baseline, checked, disabled, onChange, }: { permission: lib.Permission; checked: boolean; baseline: boolean; disabled: boolean; onChange: (value: boolean) => void; }) { const modified = checked !== baseline; return (
onChange(e.target.checked)}> {permission.title} {permission.grantByDefault && ( )} {isDangerous(permission) && ( )}
{permission.description}
); } /** A group of permissions; includes a title, clear and select all buttons, and the permission items */ function PermissionGroup({ groupName, permissions, canUpdate, baselineState, permissionState, setPermissionState, }: { groupName: string; permissions: lib.Permission[]; canUpdate: boolean; baselineState: Record; permissionState: Record; setPermissionState: React.Dispatch>>; setEdited?: (value: boolean) => void; }) { function setGroup(value: boolean) { setPermissionState((prev: any) => { const next = { ...prev }; for (let p of permissions) { next[p.name] = value; } return next; }); } return (
{formatGroupTitle(groupName)}
{permissions.map((p: any) => ( setPermissionState((prev: any) => ({ ...prev, [p.name]: v }))} /> ))}
); } /** An entry in the group list; the dot is blue when any permission in the group is granted */ function PermissionGroupNav({ groupName, granted }: { groupName: string; granted: boolean }) { function scrollToGroup() { document.getElementById(`permission-group-${groupName}`)?.scrollIntoView({ behavior: "smooth" }); } return (
{formatGroupTitle(groupName)}
); } /** The role page view */ export default function RoleViewPage() { const params = useParams(); const roleId = Number(params.id); const navigate = useNavigate(); const account = useAccount(); const control = useContext(ControlContext); const [role, synced] = useRole(roleId); const [name, setName] = useState(""); const [description, setDescription] = useState(""); const [permissionState, setPermissionState] = useState>({}); const [baselineState, setBaselineState] = useState>({}); const [search, setSearch] = useState(""); // Hidden below lg, where the site sider leaves too little room; undefined until measured const screens = Grid.useBreakpoint(); const showGroupList = screens.lg !== false; const allPermissions = useMemo(() => [...lib.permissions.values()], []); const canUpdate = Boolean(account.hasPermission("core.role.update")); useEffect(() => { if (!role) { return; } const base = Object.fromEntries( allPermissions.map(p => [p.name, role.permissions.has(p.name)]) ); setName(role.name); setDescription(role.description); setPermissionState(base); setBaselineState(base); }, [role, allPermissions]); // If no role then display either the loading screen or the not found screen if (!role) { const nav = [{ name: "Roles", path: "/roles" }, { name: String(roleId) }]; if (!synced) { return ; } return

Role with id {roleId} was not found on the controller.

; } // Apply the filter by searching all permission fields const filtered = allPermissions.filter(p => { const q = search.toLowerCase(); return p.name.toLowerCase().includes(q) || p.title.toLowerCase().includes(q) || p.description.toLowerCase().includes(q); }); // Organise the permissions into groups const groups = new Map(); for (let p of filtered) { const g = getGroupName(p.name); if (!groups.has(g)) { groups.set(g, []); } groups.get(g)!.push(p); } // Sort permissions alphabetically within their groups const sortedGroups = [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)); for (let [, permissions] of sortedGroups) { permissions.sort((a, b) => a.title.localeCompare(b.title)); } // Groups with at least one granted permission, including those hidden by the search const grantedGroups = new Set(allPermissions.filter(p => permissionState[p.name]).map(p => getGroupName(p.name))); // Check if any changes have been made to the permissions or role metadata const permissionChanged = Object.keys(permissionState).some(k => permissionState[k] !== baselineState[k]); const metaChanged = name !== role.name || description !== role.description; const edited = permissionChanged || metaChanged; /** Applies all pending changes */ function applyChanges() { const newPermissions = Object.entries(permissionState).filter(([, v]) => v).map(([k]) => k); control.send(new lib.RoleUpdateRequest(roleId, name || "", description || "", newPermissions)) .then(() => { setBaselineState(permissionState); }) .catch(notifyErrorHandler("Error applying changes")); } /** Revert any pending changes */ function revertChanges() { setPermissionState(baselineState); if (role) { setName(role.name); setDescription(role.description); } } return ( {account.hasPermission("core.role.delete") && { control.send(new lib.RoleDeleteRequest(roleId)) .then(() => navigate("/roles")) .catch(notifyErrorHandler("Error deleting role")); }} > } } /> {edited && (
You have unsaved changes
)}
setName(e.target.value)} />
setDescription(e.target.value)} />

Permissions

setSearch(e.target.value)} style={{ marginBottom: 16 }} /> {showGroupList && {/* Clear of the fixed page header */}
{sortedGroups.map(([groupName]) => ( ))}
} {sortedGroups.map(([groupName, permissions]) => ( ))}
); }