/** Shared helpers for midnight deploy / restart scheduling (server-local calendar). */ export const RESTART_WARN_BEFORE_MS = 3 * 60 * 60 * 1000; export const DEFAULT_DEPLOY_CHECK_MS = 5 * 60 * 1000; /** Next local calendar midnight strictly after `now`. */ export function nextLocalMidnightMs (now = Date.now()) { const d = new Date(now); const next = new Date(d.getFullYear(), d.getMonth(), d.getDate() + 1, 0, 0, 0, 0); return next.getTime(); } export function restartWarningStartsAt (scheduledAt, warnBeforeMs = RESTART_WARN_BEFORE_MS) { const at = Number(scheduledAt); const warn = Number(warnBeforeMs); if (!Number.isFinite(at)) { return 0; } return Math.max(0, at - (Number.isFinite(warn) ? warn : RESTART_WARN_BEFORE_MS)); } export function isInRestartWarningWindow (now, scheduledAt, warnBeforeMs = RESTART_WARN_BEFORE_MS) { if (scheduledAt == null) { return false; } const at = Number(scheduledAt); if (!Number.isFinite(at)) { return false; } const t = Number(now); return t >= restartWarningStartsAt(at, warnBeforeMs) && t < at; } /** Human countdown like `2h 05m 03s` or `45s`. */ export function formatRestartCountdown (remainingMs) { const ms = Math.max(0, Math.ceil(Number(remainingMs) || 0)); const totalSec = Math.floor(ms / 1000); const h = Math.floor(totalSec / 3600); const m = Math.floor((totalSec % 3600) / 60); const s = totalSec % 60; if (h > 0) { return `${h}h ${String(m).padStart(2, "0")}m ${String(s).padStart(2, "0")}s`; } if (m > 0) { return `${m}m ${String(s).padStart(2, "0")}s`; } return `${s}s`; } export function restartCountdownMessage (remainingMs) { return `Server restart for a game update in ${formatRestartCountdown(remainingMs)}.`; }