server-studio 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 Notable changes to Server Studio. Dates are release dates.
 
+## 1.2.2 — 2026-08-30
+
+- The version badge no longer keeps offering an update you have already installed. Once you start
+  one it reads **restart to finish**, because the running process keeps the old code until it is
+  reopened. It returns to a plain version once you restart.
+
+## 1.2.1 — 2026-08-30
+
+- **Fixed:** an installed app reported its version as `0.0.0`, because the code looks for
+  `package.json` one level up and the app bundle does not contain one. The badge showed `v0.0.0`,
+  the update prompt appeared permanently even straight after updating, and telemetry recorded every
+  install as version 0.0.0. The installer now stamps the version beside the code.
+- **Fixed:** if the local server was not responding, clicking **Update**, **Run** or **Stop** did
+  nothing at all. The failed request threw and was never caught, so there was no error either. Those
+  actions now say what went wrong.
+
 ## 1.2.0 — 2026-08-30
 
 ### Folders replace categories

package/bin/cli.js

@@ -69,6 +69,14 @@ function install() {
     // cpSync does not preserve the exec bit on the launcher.
     // src/ is the single source of truth, copied into the bundle at install time.
     fs.cpSync(SRC, path.join(APP_DEST, 'Contents', 'Resources'), { recursive: true });
+    // The bundle has no package.json, so stamp the version beside the code. Without this
+    // an installed app reports 0.0.0 and therefore thinks an update is always available.
+    try {
+      fs.writeFileSync(
+        path.join(APP_DEST, 'Contents', 'Resources', 'version.json'),
+        JSON.stringify({ version: require(path.join(ROOT, 'package.json')).version }) + '\n'
+      );
+    } catch (e) {}
     fs.chmodSync(path.join(APP_DEST, 'Contents', 'MacOS', 'ServerStudio'), 0o755);
   } else skip('app skipped (--no-app)');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "server-studio",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "A tiny dashboard for your local dev servers. One click to run, stop and open them, with one permanent port per project.",
   "author": "Md Mahdi Hasan",
   "license": "MIT",

package/src/index.html

@@ -113,6 +113,7 @@
   .ver.has-update:hover { background: rgba(62,207,142,.24); }
   .ver .dot-new { width: 6px; height: 6px; border-radius: 50%; background: var(--green); flex: none; }
   .ver.checking { opacity: .55; }
+  .ver.pending { color: var(--amber); border-color: rgba(245,179,67,.4); background: rgba(245,179,67,.12); padding: 3px 9px; margin-left: -10px; }
   @keyframes verPulse {
     0%, 100% { box-shadow: 0 0 0 0 rgba(62,207,142,0); }
     50%      { box-shadow: 0 0 0 4px rgba(62,207,142,.18); }
@@ -831,6 +832,15 @@ function ssPrompt(title, opts) {
 /* ---------- version + update ---------- */
 let updateInfo = null;
 
+function isNewerVersion(a, b) {
+  const pa = String(a).split('.').map(Number), pb = String(b).split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] || 0, y = pb[i] || 0;
+    if (x !== y) return x > y;
+  }
+  return false;
+}
+
 async function checkUpdate() {
   const pill = document.getElementById('verPill');
   if (!pill) return;
@@ -840,6 +850,22 @@ async function checkUpdate() {
   updateInfo = r;
   pill.classList.remove('checking');
 
+  // An update was kicked off from here and this process is still the old one.
+  let pending = null;
+  try { pending = localStorage.getItem('ss_updating_to'); } catch (e) {}
+  if (pending && !isNewerVersion(pending, r.current)) {
+    // Already running it, so the restart happened. Clear the flag.
+    try { localStorage.removeItem('ss_updating_to'); } catch (e) {}
+    pending = null;
+  }
+  if (pending) {
+    pill.className = 'ver pending';
+    pill.textContent = 'restart to finish ' + pending;
+    pill.title = 'Version ' + pending + ' has been installed. Quit and reopen Server Studio to run it.';
+    pill.onclick = null;
+    return;
+  }
+
   if (r.newer) {
     pill.className = 'ver has-update';
     pill.innerHTML = '<span class="dot-new"></span>v' + esc(r.current) + ' &rarr; ' + esc(r.latest);
@@ -859,10 +885,19 @@ async function runUpdate() {
     'You are on ' + updateInfo.current + '. This runs npm install -g server-studio in a terminal window.\n\nYour saved servers and folders are not touched. Restart Server Studio when it finishes.',
     { okText: 'Update' });
   if (!ok) return;
-  const r = await api('/api/run', { method: 'POST', headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ cwd: '', command: 'npm install -g server-studio' }) });
-  if (r && r.ok) toast('Updating in ' + TERM_NAME + '. Restart Server Studio when it finishes.');
-  else toast('Could not start the update. Run: npm install -g server-studio', true);
+  let r = null;
+  try {
+    r = await api('/api/run', { method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ cwd: '', command: 'npm install -g server-studio' }) });
+  } catch (e) { /* server gone: fall through to the error toast rather than doing nothing */ }
+  if (r && r.ok) {
+    // The running process keeps the old code until it restarts, so stop offering the
+    // update. Continuing to show it after a successful update reads as a failure.
+    try { localStorage.setItem('ss_updating_to', updateInfo.latest); } catch (e) {}
+    checkUpdate();
+    toast('Updating in ' + TERM_NAME + '. Restart Server Studio when it finishes.');
+  }
+  else toast('Could not start the update. Run this yourself: npm install -g server-studio', true);
 }
 
 function moveToFolder(serverId, folderId) {
@@ -988,8 +1023,11 @@ async function runServer(id) {
     setTimeout(() => { const el = document.getElementById('f_cwd'); if (el) el.focus(); }, 120);
     return;
   }
-  const r = await api('/api/run', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ cwd: s.cwd || '', command: s.command }) });
-  if (r.ok) {
+  let r = null;
+  try {
+    r = await api('/api/run', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ cwd: s.cwd || '', command: s.command }) });
+  } catch (e) {}
+  if (r && r.ok) {
     toast('Running "' + (s.name || 'server') + '" in ' + TERM_NAME);
     if (portOf(s)) { s._status = 'checking'; render(); }
     setTimeout(() => refreshStatus(), 3500);
@@ -1000,8 +1038,10 @@ async function stopServer(id) {
   const port = portOf(s);
   if (!port) return;
   s._status = 'checking'; render();
-  await api('/api/stop', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ port }) });
-  toast('Stopped whatever was on port ' + port);
+  try {
+    await api('/api/stop', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ port }) });
+    toast('Stopped whatever was on port ' + port);
+  } catch (e) { toast('Could not stop it, the app is not responding.', true); }
   setTimeout(() => refreshStatus(), 700);
 }
 function copyUrl(url, btn) {

package/src/server.js

@@ -88,7 +88,12 @@ function portFromUrl(url) {
 
 /* ---------- version check ---------- */
 function appVersion() {
-  try { return require('../package.json').version || '0.0.0'; } catch (e) { return '0.0.0'; }
+  // Running from a checkout, package.json is one level up. Inside the installed app
+  // bundle there is no package.json, so the installer stamps version.json beside the
+  // code. Try both before giving up.
+  try { return require('./version.json').version || '0.0.0'; } catch (e) {}
+  try { return require('../package.json').version || '0.0.0'; } catch (e) {}
+  return '0.0.0';
 }
 function isNewer(a, b) {
   const pa = String(a).split('.').map(Number), pb = String(b).split('.').map(Number);

package/src/telemetry.js

@@ -28,7 +28,12 @@ function optedOut() {
 }
 
 function appVersion() {
-  try { return require('../package.json').version; } catch (e) { return '0.0.0'; }
+  // Running from a checkout, package.json is one level up. Inside the installed app
+  // bundle there is no package.json, so the installer stamps version.json beside the
+  // code. Try both before giving up.
+  try { return require('./version.json').version || '0.0.0'; } catch (e) {}
+  try { return require('../package.json').version || '0.0.0'; } catch (e) {}
+  return '0.0.0';
 }
 
 function dataDir() {