Files
MikrotikManager/backend/src/services/server-poll-journal-validation.ts
T

27 lines
3.2 KiB
TypeScript

import { publicationLayout } from "./server-poll-maintenance-groups.js"
import type { ServerPollPlan, ServerPollReceipt } from "./server-poll-execution.js"
import { SERVER_POLL_NATIVE_READS } from "./server-poll-execution-model.js"
export interface ServerPollJournalStage extends Record<string, unknown> {
stage: string; before_proof: string; effect_proof: string; intent_proof: string
result_proof: string | null; outcome: string | null; ack_proof: string | null
}
export const serverPollPublications = (rows: ServerPollJournalStage[]) => rows.filter(row => row.stage.startsWith("publish.")).sort((a, b) => Number(a.stage.slice(8)) - Number(b.stage.slice(8)))
/** Shared completion rules only. No authority, expiry, SQL or execution path.
* Callers separately authenticate context, stage MACs and maintenance effects. */
export function validateServerPollJournalReceipt(plan: ServerPollPlan, receipt: ServerPollReceipt, rows: ServerPollJournalStage[], executionStartProof?: string): void {
const must = (value: unknown) => { if (!value) throw Error("Invalid complete server poll receipt") }
must(receipt.receiptId === plan.request.receiptId && /^[a-f0-9]{64}$/.test(receipt.afterProof))
const native = new Set(SERVER_POLL_NATIVE_READS.map(value => "native." + value))
const pubs = serverPollPublications(rows), natives = rows.filter(row => native.has(row.stage))
const epochPlan = plan.version === 3 || plan.version === 4, count = publicationLayout(plan).maintenancePublications
const start = executionStartProof ?? (epochPlan ? undefined : plan.beforeProof)
must(typeof start === "string" && /^[a-f0-9]{64}$/.test(start) && (epochPlan || start === plan.beforeProof))
must(new Set(natives.map(row => row.stage)).size === 4 && natives.every(row => row.before_proof === start))
must(pubs.every((row, index) => row.before_proof === (index === 0 ? start : pubs[index - 1].result_proof)))
must(receipt.configurationVerified === true && receipt.complete === true && receipt.maintenanceComplete === true && receipt.nativeReads === 4 && natives.length === 4 && rows.every(row => row.ack_proof !== null) && pubs.length === receipt.confirmedPublications && pubs.length === receipt.completedPublications && [count + 2, count + 4].includes(pubs.length) && pubs.every((row, index) => row.stage === "publish." + index && row.outcome === "confirmed") && pubs.at(-1)?.result_proof === receipt.afterProof && ["online", "offline"].includes(receipt.observation))
must((receipt.observation !== "online" || natives.every(row => row.outcome === "confirmed")) && receipt.snapshot.serverId === plan.request.serverId && receipt.snapshot.status === receipt.observation && Object.keys(receipt.snapshot).every(key => ["id", "serverId", "polledAt", "status", "latencyMs", "rosVersion", "boardName", "uptime", "cpuLoad", "freeMemory", "totalMemory", "identityName"].includes(key)) && Buffer.byteLength(JSON.stringify(receipt)) <= 131072)
must(Object.keys(receipt).every(key => ["receiptId", "configurationVerified", "complete", "maintenanceComplete", "nativeReads", "confirmedPublications", "completedPublications", "afterProof", "observation", "snapshot"].includes(key)) && Object.values(receipt.snapshot).every(value => value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value)))
}