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 { apiFetchJSON } from '@/utils/apiClient';
import type {
ActionAuditPlan,
ActionDetailResponse,
ActionDecisionResponse,
ActionExecutionResponse,
ActionInboxResponse,
ActionInboxView,
PendingActionsResponse,
ResourceActionRequest,
} from '@/types/actionAudit';
export type ActionDecisionOutcome = 'approved' | 'rejected';
function reviewedPlanHash(planHash: string): string {
const normalized = planHash.trim();
if (!normalized) {
throw new Error(
'A reviewed action plan identity is required. Create a new plan before continuing.',
);
}
return normalized;
}
export class ResourceActionsAPI {
static async listActions(view: ActionInboxView, limit = 100): Promise<ActionInboxResponse> {
const params = new URLSearchParams({ view, limit: String(limit) });
return apiFetchJSON<ActionInboxResponse>(`/api/actions?${params.toString()}`);
}
static async getAction(actionId: string): Promise<ActionDetailResponse> {
return apiFetchJSON<ActionDetailResponse>(`/api/actions/${encodeURIComponent(actionId)}`);
}
static async refreshAction(actionId: string, planHash: string): Promise<ActionDetailResponse> {
return apiFetchJSON<ActionDetailResponse>(
`/api/actions/${encodeURIComponent(actionId)}/refresh`,
{
method: 'POST',
body: JSON.stringify({ planHash: reviewedPlanHash(planHash) }),
},
);
}
static async listPendingActions(): Promise<PendingActionsResponse> {
return apiFetchJSON<PendingActionsResponse>('/api/actions/pending');
}
static async planAction(request: ResourceActionRequest): Promise<ActionAuditPlan> {
return apiFetchJSON<ActionAuditPlan>('/api/actions/plan', {
method: 'POST',
body: JSON.stringify(request),
});
}
static async decideAction(
actionId: string,
outcome: ActionDecisionOutcome,
planHash: string,
reason?: string,
): Promise<ActionDecisionResponse> {
return apiFetchJSON<ActionDecisionResponse>(
`/api/actions/${encodeURIComponent(actionId)}/decision`,
{
method: 'POST',
body: JSON.stringify({
outcome,
planHash: reviewedPlanHash(planHash),
...(reason ? { reason } : {}),
}),
},
);
}
static async executeAction(
actionId: string,
planHash: string,
reason?: string,
): Promise<ActionExecutionResponse> {
return apiFetchJSON<ActionExecutionResponse>(
`/api/actions/${encodeURIComponent(actionId)}/execute`,
{
method: 'POST',
body: JSON.stringify({
planHash: reviewedPlanHash(planHash),
...(reason ? { reason } : {}),
}),
},
);
}
static async forceFailAction(actionId: string, reason: string): Promise<ActionExecutionResponse> {
const justification = reason.trim();
if (!justification) {
throw new Error('Record what you verified directly before closing the action audit.');
}
return apiFetchJSON<ActionExecutionResponse>(
`/api/actions/${encodeURIComponent(actionId)}/force-fail`,
{
method: 'POST',
body: JSON.stringify({ reason: justification }),
},
);
}
}