BlueGit

timfa questward

Files

questward / server / src / deploy / manifest.js

manifest.js

manifest.js 1.9 KiB Download Raw
1import { mkdirSync, renameSync, writeFileSync, unlinkSync, existsSync, readFileSync } from "node:fs";
2import { dirname, join } from "node:path";
3
4export const RESTART_MANIFEST_NAME = "restart-request.json";
5
6export function restartManifestPath (dataDir)
7{
8 return join(dataDir, RESTART_MANIFEST_NAME);
9}
10
11/**
12 * Atomically write a restart request for systemd ExecStartPre.
13 * @param {string} filePath
14 * @param {{
15 * reasons?: string[],
16 * deployCode?: boolean,
17 * targetCommit?: string | null,
18 * pendingWorldRevision?: number | null,
19 * writtenAt?: number
20 * }} payload
21 */
22export function writeRestartManifest (filePath, payload)
23{
24 const body = {
25 reasons: Array.isArray(payload.reasons) ? payload.reasons : [],
26 deployCode: !!payload.deployCode,
27 targetCommit: payload.targetCommit ?? null,
28 pendingWorldRevision: payload.pendingWorldRevision ?? null,
29 writtenAt: payload.writtenAt ?? Date.now()
30 };
31 mkdirSync(dirname(filePath), { recursive: true });
32 const tmp = `${filePath}.${process.pid}.tmp`;
33 writeFileSync(tmp, `${JSON.stringify(body, null, 2)}\n`, "utf8");
34 renameSync(tmp, filePath);
35 return body;
36}
37
38export function readRestartManifest (filePath)
39{
40 if (!existsSync(filePath))
41 { return null; }
42 try
43 {
44 const raw = JSON.parse(readFileSync(filePath, "utf8"));
45 if (!raw || typeof raw !== "object")
46 { return null; }
47 return {
48 reasons: Array.isArray(raw.reasons) ? raw.reasons.map(String) : [],
49 deployCode: !!raw.deployCode,
50 targetCommit: raw.targetCommit ? String(raw.targetCommit) : null,
51 pendingWorldRevision: raw.pendingWorldRevision != null
52 ? Number(raw.pendingWorldRevision)
53 : null,
54 writtenAt: Number(raw.writtenAt) || 0
55 };
56 }
57 catch
58 {
59 return null;
60 }
61}
62
63export function consumeRestartManifest (filePath)
64{
65 const manifest = readRestartManifest(filePath);
66 try
67 { unlinkSync(filePath); }
68 catch
69 { /* missing is fine */ }
70 return manifest;
71}