mobux 0.48.0

A touch-friendly tmux web UI for unhinged people who run terminal sessions from their phone while walking the dog
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

import { signal } from "@preact/signals";
import { localGet } from "./api.js";

// Server update detection (issue #189). Watches the server's `build_hash`
// (`/api/build-info`) — a self-update (#130) or a plain service restart — so
// a tab never keeps running stale bundles unnoticed.
//
// An open terminal is never reloaded under the user: a changed hash raises
// `updateAvailable`, and the update bar offers the reload. Dismissing the bar
// hides it until the tab is next shown. Without a terminal open nothing is lost, so
// the tab reloads at once.
//
// An in-memory module variable remembers the last hash this tab observed —
// no client-side storage, so it resets on every load, which is exactly right:
//   - nothing remembered yet → record the current hash (a first load is
//     never "stale", it just has no baseline).
//   - remembered === current → no-op.
//   - remembered !== current → record the new hash, then reload or offer it.
//     Recording first can't loop: the reloaded tab starts fresh with no
//     baseline, re-records the now-current hash, and settles.
const POLL_MS = 60000;

export const updateAvailable = signal(false);

let seen = null;
let stale = false;
let poll = null;

const onTerminal = () => /^#\/s\//.test(location.hash);

function reloadOrOffer() {
  stale = true;
  if (onTerminal()) updateAvailable.value = true;
  else location.reload();
}

export function dismissUpdate() {
  updateAvailable.value = false;
}

async function checkBuildHash({ shown = false } = {}) {
  let hash;
  try {
    hash = (await localGet("/api/build-info"))?.build_hash;
  } catch (_) {
    return; // offline / mid-restart — the next poll or visibility check retries
  }
  // "unknown" means the server has no embedded hash to compare against —
  // not evidence of staleness (mirrors BuildInfoCard's `stale` computation).
  if (!hash || hash === "unknown") return;

  if (seen === hash) {
    if (stale && shown) reloadOrOffer();
    return;
  }

  const hadBaseline = seen !== null;
  seen = hash;

  if (hadBaseline) reloadOrOffer();
}

function startPoll() {
  if (poll === null) poll = setInterval(() => checkBuildHash(), POLL_MS);
}

function stopPoll() {
  clearInterval(poll);
  poll = null;
}

function onVisible() {
  if (document.visibilityState !== "visible") return;
  startPoll();
  checkBuildHash({ shown: true });
}

export function watchBuildHash() {
  checkBuildHash();
  if (document.visibilityState === "visible") startPoll();
  document.addEventListener("visibilitychange", () => {
    if (document.visibilityState === "visible") onVisible();
    else stopPoll();
  });
  document.addEventListener("freeze", stopPoll);
  document.addEventListener("resume", onVisible);
  // Leaving the terminal with an update pending: nothing is lost any more.
  window.addEventListener("hashchange", () => {
    if (stale && !onTerminal()) location.reload();
  });
  // Exposed for the SPA e2e suite (test/spa.spec.cjs) to force a check
  // without waiting out the poll interval — mirrors terminal.js's
  // window.__mobux* test hooks (e.g. forceDrop for auto-reconnect).
  window.__mobuxCheckBuildHash = () => checkBuildHash();
  window.__mobuxBuildPollActive = () => poll !== null;
}