Python
import { useEffect, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import {
checkForUpdate,
clearPendingUpdate,
downloadUpdate,
installUpdate,
isTauri,
type UpdateInfo,
} from "../tauri";
// Auto-update prompt (desktop shell only — the browser build never renders this).
// Deliberately a PROMPT, not a silent background install: swapping the app under a
// user mid-session would kill their running coworker turn, and quiet self-mutation
// sits badly with the local-first trust posture. "Later" dismisses that VERSION for
// this app run; long-lived instances still hear about the next release because the
// check repeats every 30 minutes (FB-001 — the app can sit open for weeks).
//
// The first check runs shortly after boot settles (the splash and session restore own
// the first seconds). Once a release is offered, the bytes are pre-fetched in the
// background (FB-003) so "Restart to update" is instant instead of a multi-minute
// download; if the pre-fetch fails the button falls back to download-on-click.
// Update integrity is enforced below this layer: the shell verifies the manifest's
// minisign signature against the pubkey compiled into tauri.conf.json.
const FIRST_CHECK_MS = 15_000;
const RECHECK_MS = 30 * 60_000;
// downloading: background pre-fetch in flight (button locked).
// ready: bytes cached in the shell — install is instant.
// fallback: pre-fetch failed — the button does the full download-on-click as before.
type Phase = "downloading" | "ready" | "fallback" | "installing" | "error";
export function UpdateBanner() {
const { t } = useTranslation();
const [update, setUpdate] = useState<UpdateInfo | null>(null);
const [phase, setPhase] = useState<Phase>("downloading");
// Per-run, per-version dismissal — no localStorage, so a restart re-offers, and a
// NEWER release found by a later check overrides an earlier "Later".
const dismissed = useRef<string | null>(null);
// Version the background pre-fetch was kicked off for: keeps periodic re-checks of
// the same release from re-firing the download or resetting the button state.
const fetched = useRef<string | null>(null);
const offer = (u: UpdateInfo) => {
if (u.version === dismissed.current) return;
setUpdate((prev) => (prev?.version === u.version ? prev : u));
if (fetched.current === u.version) return;
fetched.current = u.version;
setPhase("downloading");
const v = u.version; // guard: a newer release may supersede this fetch mid-flight
downloadUpdate()
.then(() => fetched.current === v && setPhase("ready"))
.catch(() => fetched.current === v && setPhase("fallback"));
};
useEffect(() => {
if (!isTauri()) return;
const check = () => checkForUpdate().then((u) => u && offer(u)).catch(() => {});
const t = setTimeout(check, FIRST_CHECK_MS);
const i = setInterval(check, RECHECK_MS);
return () => {
clearTimeout(t);
clearInterval(i);
};
// eslint-disable-next-line react-hooks/exhaustive-deps
}, []);
if (!update) return null;
const install = async () => {
setPhase("installing");
try {
await installUpdate(); // success restarts the app — nothing to do after
} catch {
setPhase("error");
}
};
const busy = phase === "downloading" || phase === "installing";
return (
// Docked over the sidebar column (FB-002, owner call): 300px grid column minus the
// 12px side margins, bottom offset clearing the ~57px account row so the card sits
// just above it. z-[35]: above the account menu's click-away backdrop (z-30) so the
// card stays clickable, but BELOW the menu itself (z-40) — an open menu must never
// be occluded by a passive status card.
<div
className="fixed bottom-[64px] left-3 z-[35] w-[276px] rounded-xl border border-line bg-panel shadow-2xl px-4 py-3.5"
role="status"
data-testid="update-banner"
>
<div className="text-ui font-semibold">{t("update.banner_title")}</div>
<div className="text-meta text-muted mt-0.5">
{t("update.ready", { version: update.version })}
</div>
{phase === "error" && (
<div className="text-meta text-warnInk mt-1.5">
{t("update.install_failed")}
</div>
)}
<div className="flex items-center gap-2 mt-2.5">
<button
className="px-3 py-1.5 rounded-full bg-accent text-white text-ui disabled:opacity-50"
onClick={install}
disabled={busy}
data-testid="update-install"
>
{busy ? t("update.downloading") : t("update.restart_to_update")}
</button>
<button
className="px-2 py-1.5 text-ui text-faint hover:text-muted"
onClick={() => {
dismissed.current = update.version;
setUpdate(null);
// Free the pre-fetched bundle (tens of MB) — a dismissed release may sit
// unused for weeks; it re-downloads if the user changes their mind.
fetched.current = null;
clearPendingUpdate().catch(() => {});
}}
disabled={phase === "installing"}
data-testid="update-later"
>
{t("update.later")}
</button>
</div>
</div>
);
}