@wildwinter/app-shell 0.1.0 → 0.14.0

package/dist/updater.js

@@ -0,0 +1,306 @@
+import { app, BrowserWindow, ipcMain } from 'electron';
+import { appendFileSync } from 'fs';
+import { join } from 'path';
+import electronUpdater from 'electron-updater';
+
+// src/updater.ts
+var UPDATER_CHANNELS = {
+  /** main -> renderer: "are there unsaved edits?"; reply on `dirtyReply`. */
+  checkDirty: "updater:check-dirty",
+  dirtyReply: "updater:dirty-reply",
+  /** main -> renderer: "save now"; reply `{ ok }` on `saveDone`. */
+  saveBeforeInstall: "updater:save-before-install",
+  saveDone: "updater:save-done",
+  /** main -> renderer: show this prompt; reply with the button index. */
+  prompt: "updater:prompt",
+  promptReply: "updater:prompt-reply",
+  /** main -> renderer: live download progress. */
+  progress: "updater:download-progress"
+};
+var appName = "This app";
+var activeWindowFn = () => BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0] ?? null;
+var activeWindow = () => activeWindowFn();
+var { autoUpdater, CancellationToken } = electronUpdater;
+var updateDownloaded = null;
+var lastBackgroundError = null;
+var logPath = join(app.getPath("userData"), "updater.log");
+var writeLog = (level, args) => {
+  try {
+    appendFileSync(logPath, `${(/* @__PURE__ */ new Date()).toISOString()} [${level}] ${args.map((a) => a instanceof Error ? a.stack || a.message : String(a)).join(" ")}
+`);
+  } catch {
+  }
+};
+autoUpdater.logger = {
+  info: (...a) => writeLog("info", a),
+  warn: (...a) => writeLog("warn", a),
+  error: (...a) => writeLog("error", a),
+  debug: (...a) => writeLog("debug", a)
+};
+autoUpdater.autoDownload = false;
+autoUpdater.autoInstallOnAppQuit = true;
+autoUpdater.disableDifferentialDownload = true;
+autoUpdater.on("error", (err) => {
+  console.error("AutoUpdater error:", err?.message || err);
+  lastBackgroundError = err?.message || String(err);
+});
+var STALL_MS = 3 * 60 * 1e3;
+var WATCH_EVERY_MS = 30 * 1e3;
+var RETRY_DELAY_MS = 15 * 1e3;
+var MAX_ATTEMPTS = 3;
+var download = null;
+function broadcastProgress(p) {
+  for (const w of BrowserWindow.getAllWindows()) {
+    if (!w.isDestroyed() && !w.webContents.isDestroyed()) w.webContents.send(UPDATER_CHANNELS.progress, p);
+  }
+}
+function clearDownload() {
+  if (download) clearInterval(download.watchdog);
+  download = null;
+}
+function beginDownload(info, attempts) {
+  clearDownload();
+  const token = new CancellationToken();
+  const state = {
+    info,
+    token,
+    attempts: attempts + 1,
+    lastProgressAt: Date.now(),
+    cancelledByWatchdog: false,
+    watchdog: setInterval(() => {
+      if (download !== state) return;
+      const quiet = Date.now() - state.lastProgressAt;
+      if (quiet < STALL_MS) return;
+      writeLog("warn", [`watchdog: no download progress for ${Math.round(quiet / 1e3)}s - cancelling (attempt ${state.attempts}/${MAX_ATTEMPTS})`]);
+      state.cancelledByWatchdog = true;
+      state.token.cancel();
+    }, WATCH_EVERY_MS)
+  };
+  download = state;
+  writeLog("info", [`download: starting ${info.version} (attempt ${state.attempts}/${MAX_ATTEMPTS})`]);
+  autoUpdater.downloadUpdate(token).then(() => {
+  }).catch((err) => {
+    if (download !== state) return;
+    const why = state.cancelledByWatchdog ? "stalled (killed by the watchdog)" : err instanceof Error ? err.message : String(err);
+    clearDownload();
+    if (state.attempts < MAX_ATTEMPTS) {
+      writeLog("warn", [`download: attempt ${state.attempts} failed - ${why}; retrying in ${RETRY_DELAY_MS / 1e3}s`]);
+      setTimeout(() => {
+        if (!download && !updateDownloaded) beginDownload(info, state.attempts);
+      }, RETRY_DELAY_MS);
+    } else {
+      lastBackgroundError = `Downloading ${info.version} failed ${MAX_ATTEMPTS} times (last: ${why}). Will retry on the next check.`;
+      writeLog("error", [`download: giving up on ${info.version} this cycle - ${why}`]);
+    }
+  });
+}
+autoUpdater.on("update-available", (info) => {
+  if (download || updateDownloaded) return;
+  beginDownload(info, 0);
+});
+autoUpdater.on("download-progress", (p) => {
+  if (download) download.lastProgressAt = Date.now();
+  broadcastProgress({
+    percent: p.percent,
+    transferred: p.transferred,
+    total: p.total,
+    bytesPerSecond: p.bytesPerSecond,
+    version: download?.info.version ?? ""
+  });
+});
+function askRendererIsDirty(win) {
+  return new Promise((resolve) => {
+    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) {
+      resolve(false);
+      return;
+    }
+    const onReply = (_e, isDirty) => {
+      clearTimeout(timeout);
+      resolve(!!isDirty);
+    };
+    ipcMain.once(UPDATER_CHANNELS.dirtyReply, onReply);
+    const timeout = setTimeout(() => {
+      ipcMain.removeListener(UPDATER_CHANNELS.dirtyReply, onReply);
+      console.warn("Updater dirty-check timed out; assuming clean.");
+      resolve(false);
+    }, 2e3);
+    win.webContents.send(UPDATER_CHANNELS.checkDirty);
+  });
+}
+function triggerRendererSave(win) {
+  return new Promise((resolve) => {
+    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) {
+      resolve({ ok: false });
+      return;
+    }
+    const onReply = (_e, result) => {
+      clearTimeout(timeout);
+      resolve(result || { ok: false });
+    };
+    ipcMain.once(UPDATER_CHANNELS.saveDone, onReply);
+    const timeout = setTimeout(() => {
+      ipcMain.removeListener(UPDATER_CHANNELS.saveDone, onReply);
+      console.warn("Updater save timed out.");
+      resolve({ ok: false });
+    }, 3e4);
+    win.webContents.send(UPDATER_CHANNELS.saveBeforeInstall);
+  });
+}
+function themedPrompt(win, opts) {
+  return new Promise((resolve) => {
+    const fallback = opts.cancelId ?? opts.defaultId ?? 0;
+    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) {
+      resolve(fallback);
+      return;
+    }
+    const onReply = (_e, idx) => {
+      clearTimeout(timeout);
+      resolve(typeof idx === "number" ? idx : fallback);
+    };
+    ipcMain.once(UPDATER_CHANNELS.promptReply, onReply);
+    const timeout = setTimeout(() => {
+      ipcMain.removeListener(UPDATER_CHANNELS.promptReply, onReply);
+      resolve(fallback);
+    }, 3e5);
+    win.webContents.send(UPDATER_CHANNELS.prompt, opts);
+  });
+}
+async function quitAndInstallSafely() {
+  const win = activeWindow();
+  if (!await askRendererIsDirty(win)) {
+    autoUpdater.quitAndInstall();
+    return;
+  }
+  const response = await themedPrompt(win, {
+    buttons: ["Save and Restart", "Discard and Restart", "Cancel"],
+    defaultId: 0,
+    cancelId: 2,
+    message: "You have unsaved changes.",
+    detail: `Save them before restarting to install ${appName} ${updateDownloaded?.version || ""}?`
+  });
+  if (response === 2) return;
+  if (response === 0) {
+    const result = await triggerRendererSave(win);
+    if (!result.ok) {
+      await themedPrompt(win, {
+        message: "Save failed",
+        detail: "Your changes could not be saved, so the update was not installed. Save manually, then try again.",
+        buttons: ["OK"]
+      });
+      return;
+    }
+  }
+  autoUpdater.quitAndInstall();
+}
+autoUpdater.on("update-downloaded", (info) => {
+  clearDownload();
+  updateDownloaded = info;
+  lastBackgroundError = null;
+  writeLog("info", [`download: ${info.version} downloaded and ready to install`]);
+  const win = activeWindow();
+  if (!win) return;
+  void themedPrompt(win, {
+    buttons: ["Restart Now", "Later"],
+    defaultId: 0,
+    cancelId: 1,
+    message: "Update ready to install",
+    detail: `${appName} ${info.version} has been downloaded. Restart now to apply, or it will install automatically next time you quit.`
+  }).then((response) => {
+    if (response === 0) void quitAndInstallSafely();
+  });
+});
+function configureUpdater(opts) {
+  appName = opts.appName;
+  activeWindowFn = opts.activeWindow;
+  if (opts.logFile !== void 0) logPath = join(app.getPath("userData"), opts.logFile);
+}
+function startBackgroundUpdateCheck() {
+  if (!app.isPackaged) return;
+  autoUpdater.checkForUpdates().catch((err) => {
+    console.error("AutoUpdater background check failed:", err?.message || err);
+  });
+}
+async function manualCheckForUpdates(win) {
+  const parent = win || activeWindow();
+  if (!app.isPackaged) {
+    await themedPrompt(parent, {
+      message: "Updates unavailable in development build",
+      detail: `Auto-update only runs in packaged builds.
+
+Current version: ${app.getVersion()}`,
+      buttons: ["OK"]
+    });
+    return;
+  }
+  if (updateDownloaded) {
+    const response = await themedPrompt(parent, {
+      buttons: ["Restart Now", "Later"],
+      defaultId: 0,
+      cancelId: 1,
+      message: "Update ready to install",
+      detail: `${appName} ${updateDownloaded.version} has been downloaded. Restart now to apply.`
+    });
+    if (response === 0) await quitAndInstallSafely();
+    return;
+  }
+  if (download) {
+    await themedPrompt(parent, {
+      message: "Update available",
+      detail: `${appName} ${download.info.version} is downloading. You'll be prompted to restart when it's ready.`,
+      buttons: ["OK"],
+      progress: true
+    });
+    return;
+  }
+  try {
+    await autoUpdater.checkForUpdates();
+    const started = download;
+    const ready = updateDownloaded;
+    if (started) {
+      await themedPrompt(parent, {
+        message: "Update available",
+        detail: `${appName} ${started.info.version} is downloading. You'll be prompted to restart when it's ready.`,
+        buttons: ["OK"],
+        progress: true
+      });
+      lastBackgroundError = null;
+    } else if (ready) {
+      const response = await themedPrompt(parent, {
+        buttons: ["Restart Now", "Later"],
+        defaultId: 0,
+        cancelId: 1,
+        message: "Update ready to install",
+        detail: `${appName} ${ready.version} has been downloaded. Restart now to apply.`
+      });
+      if (response === 0) await quitAndInstallSafely();
+    } else if (lastBackgroundError) {
+      await themedPrompt(parent, {
+        message: "You're on the latest version, but updates have had errors.",
+        detail: `Current version: ${appName} ${app.getVersion()}
+
+Last update error:
+${lastBackgroundError}`,
+        buttons: ["OK"]
+      });
+      lastBackgroundError = null;
+    } else {
+      await themedPrompt(parent, {
+        message: "You're on the latest version.",
+        detail: `${appName} ${app.getVersion()} is up to date.`,
+        buttons: ["OK"]
+      });
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const detail = lastBackgroundError && lastBackgroundError !== message ? `${message}
+
+A previous background check also failed with:
+${lastBackgroundError}` : message;
+    await themedPrompt(parent, { message: "Update check failed", detail, buttons: ["OK"] });
+    lastBackgroundError = null;
+  }
+}
+
+export { UPDATER_CHANNELS, configureUpdater, manualCheckForUpdates, startBackgroundUpdateCheck };
+//# sourceMappingURL=updater.js.map
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/updater.ts"],"names":[],"mappings":"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","file":"updater.js","sourcesContent":["// ---------------------------------------------------------------------------\n// In-app auto-update over electron-updater: the family's, lifted from Patterpad\n// where it was hardened in the field.\n//\n// This is not a wrapper anybody should write twice. Every rule in it is a bug\n// that reached a user:\n//\n//   - Downloads are driven HERE rather than by electron-updater's autoDownload,\n//     because holding the CancellationToken is what lets a stall watchdog kill\n//     and retry a download that hangs. A hung stream emits neither progress nor\n//     `error`, so anything built on events alone sits \"downloading\" for ever\n//     (Patterpad #33: a Windows user's download did exactly that, all day).\n//   - Differential download is off. On Windows it stalled silently across an\n//     Electron major bump, where almost no blocks match anyway.\n//   - There is a PERSISTENT LOG in userData, because electron-updater is silent\n//     by default and a stalled download otherwise leaves nothing to diagnose.\n//   - Installing asks the renderer whether there is unsaved work, and offers\n//     Save / Discard / Cancel. \"Restart Now\" must never silently drop an\n//     author's afternoon.\n//   - Every prompt is THEMED, in the renderer, never a stock OS dialog.\n//\n// Only runs in a packaged build; in development the manual check says so rather\n// than failing obscurely.\n//\n// THE SEAMS: the app supplies its NAME (it appears in every message), a way to\n// find the ACTIVE WINDOW, and a renderer that answers four channels - the\n// contract below. Everything else is the same in every app.\n// ---------------------------------------------------------------------------\n\nimport { app, BrowserWindow, ipcMain } from \"electron\";\nimport { appendFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ProgressInfo, UpdateDownloadedEvent, UpdateInfo } from \"electron-updater\";\nimport electronUpdater from \"electron-updater\";\n\n/** Download progress, broadcast to every window so a live dialog can show it. */\nexport interface UpdaterDownloadProgress {\n  percent: number;\n  transferred: number;\n  total: number;\n  bytesPerSecond: number;\n  /** Which version is coming, so a dialog can name it. */\n  version: string;\n}\n\n/** A themed prompt, answered by the renderer with the chosen button index -\n *  the same contract as `dialog.showMessageBox`'s `response`. */\nexport interface UpdaterPromptOptions {\n  message: string;\n  detail?: string;\n  buttons: string[];\n  defaultId?: number;\n  cancelId?: number;\n  /** Show live download progress in the dialog. */\n  progress?: boolean;\n}\n\n/** The channels the app's renderer must answer. Named here so both sides agree. */\nexport const UPDATER_CHANNELS = {\n  /** main -> renderer: \"are there unsaved edits?\"; reply on `dirtyReply`. */\n  checkDirty: \"updater:check-dirty\",\n  dirtyReply: \"updater:dirty-reply\",\n  /** main -> renderer: \"save now\"; reply `{ ok }` on `saveDone`. */\n  saveBeforeInstall: \"updater:save-before-install\",\n  saveDone: \"updater:save-done\",\n  /** main -> renderer: show this prompt; reply with the button index. */\n  prompt: \"updater:prompt\",\n  promptReply: \"updater:prompt-reply\",\n  /** main -> renderer: live download progress. */\n  progress: \"updater:download-progress\",\n} as const;\n\nexport interface UpdaterOptions {\n  /** The product name, as it should read in every message (\"Patterpad\"). */\n  appName: string;\n  /** Which window the prompts belong to. */\n  activeWindow: () => BrowserWindow | null;\n  /** The log file inside userData. */\n  logFile?: string;\n}\n\nlet appName = \"This app\";\nlet activeWindowFn: () => BrowserWindow | null = () =>\n  BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0] ?? null;\nconst activeWindow = (): BrowserWindow | null => activeWindowFn();\n\nconst { autoUpdater, CancellationToken } = electronUpdater;\n\nlet updateDownloaded: UpdateDownloadedEvent | null = null;\n// Remember the last background error so the manual \"Check for Updates\" dialog can\n// surface it - otherwise a broken feed (network policy, expired cert, GitHub outage)\n// stays invisible and the user has no idea why updates never arrive.\nlet lastBackgroundError: string | null = null;\n\n// Persistent updater log (userData/updater.log). electron-updater is silent by default; without a log a\n// Windows download that stalls without emitting `error` (found in 0.1.5) leaves nothing to diagnose.\nlet logPath = join(app.getPath(\"userData\"), \"updater.log\");\nconst writeLog = (level: string, args: unknown[]): void => {\n  try { appendFileSync(logPath, `${new Date().toISOString()} [${level}] ${args.map((a) => (a instanceof Error ? a.stack || a.message : String(a))).join(\" \")}\\n`); } catch { /* logging must never throw */ }\n};\nautoUpdater.logger = {\n  info: (...a: unknown[]) => writeLog(\"info\", a),\n  warn: (...a: unknown[]) => writeLog(\"warn\", a),\n  error: (...a: unknown[]) => writeLog(\"error\", a),\n  debug: (...a: unknown[]) => writeLog(\"debug\", a),\n};\n\n// Downloads are driven by the download manager below, NOT electron-updater's autoDownload: holding\n// the CancellationToken ourselves is what lets the stall watchdog kill and retry a download that\n// hangs without ever erroring (#33 - a Windows user's download sat \"in the background\" all day; a\n// hung stream emits neither progress nor `error`, so nothing built on events alone can recover it).\nautoUpdater.autoDownload = false;\nautoUpdater.autoInstallOnAppQuit = true;\n// Force a plain full download instead of the block-by-block differential. On Windows the differential\n// path stalled silently (0.1.5): across an Electron-major bump almost no blocks match, so it downloads\n// nearly everything anyway, and it's fragile for unsigned installers. Full download is one reliable\n// stream. No-op on macOS (Squirrel.Mac always fetches the whole zip).\nautoUpdater.disableDifferentialDownload = true;\n\nautoUpdater.on(\"error\", (err) => {\n  console.error(\"AutoUpdater error:\", err?.message || err);\n  lastBackgroundError = err?.message || String(err);\n});\n\n// ---------------------------------------------------------------------------\n// Download manager: start, watch, retry. Platform-agnostic - it rides\n// electron-updater's shared events, identical for NSIS (win), zip (mac), and\n// AppImage (linux) feeds.\n// ---------------------------------------------------------------------------\n\nconst STALL_MS = 3 * 60 * 1000;   // no progress event for this long = the download is hung\nconst WATCH_EVERY_MS = 30 * 1000; // how often the watchdog looks at the clock\nconst RETRY_DELAY_MS = 15 * 1000; // pause before re-attempting a killed/failed download\nconst MAX_ATTEMPTS = 3;           // per check cycle; the 6-hourly background check starts a fresh cycle\n\ntype DownloadState = {\n  info: UpdateInfo;\n  token: InstanceType<typeof CancellationToken>;\n  attempts: number;        // attempts consumed this cycle, including the running one\n  lastProgressAt: number;\n  cancelledByWatchdog: boolean;\n  watchdog: NodeJS.Timeout;\n};\nlet download: DownloadState | null = null;\n\nfunction broadcastProgress(p: UpdaterDownloadProgress): void {\n  for (const w of BrowserWindow.getAllWindows()) {\n    if (!w.isDestroyed() && !w.webContents.isDestroyed()) w.webContents.send(UPDATER_CHANNELS.progress, p);\n  }\n}\n\nfunction clearDownload(): void {\n  if (download) clearInterval(download.watchdog);\n  download = null;\n}\n\n/** Begin (or re-attempt) downloading `info`. One state machine for every platform. */\nfunction beginDownload(info: UpdateInfo, attempts: number): void {\n  clearDownload();\n  const token = new CancellationToken();\n  const state: DownloadState = {\n    info, token, attempts: attempts + 1, lastProgressAt: Date.now(), cancelledByWatchdog: false,\n    watchdog: setInterval(() => {\n      if (download !== state) return;\n      const quiet = Date.now() - state.lastProgressAt;\n      if (quiet < STALL_MS) return;\n      // Hung: no progress and no error for STALL_MS. Kill it; the download promise's catch retries.\n      writeLog(\"warn\", [`watchdog: no download progress for ${Math.round(quiet / 1000)}s - cancelling (attempt ${state.attempts}/${MAX_ATTEMPTS})`]);\n      state.cancelledByWatchdog = true;\n      state.token.cancel();\n    }, WATCH_EVERY_MS),\n  };\n  download = state;\n  writeLog(\"info\", [`download: starting ${info.version} (attempt ${state.attempts}/${MAX_ATTEMPTS})`]);\n\n  autoUpdater.downloadUpdate(token).then(() => {\n    // Success is reported via the update-downloaded event; it clears the state.\n  }).catch((err: unknown) => {\n    if (download !== state) return; // superseded by a newer attempt/cycle\n    const why = state.cancelledByWatchdog ? \"stalled (killed by the watchdog)\"\n      : (err instanceof Error ? err.message : String(err));\n    clearDownload();\n    if (state.attempts < MAX_ATTEMPTS) {\n      writeLog(\"warn\", [`download: attempt ${state.attempts} failed - ${why}; retrying in ${RETRY_DELAY_MS / 1000}s`]);\n      setTimeout(() => { if (!download && !updateDownloaded) beginDownload(info, state.attempts); }, RETRY_DELAY_MS);\n    } else {\n      // Out of attempts for this cycle. Record it where the manual check surfaces it; the next\n      // background check (6-hourly, or Help > Check for Updates) starts a fresh cycle.\n      lastBackgroundError = `Downloading ${info.version} failed ${MAX_ATTEMPTS} times (last: ${why}). Will retry on the next check.`;\n      writeLog(\"error\", [`download: giving up on ${info.version} this cycle - ${why}`]);\n    }\n  });\n}\n\nautoUpdater.on(\"update-available\", (info: UpdateInfo) => {\n  if (download || updateDownloaded) return; // already downloading it, or already have it\n  beginDownload(info, 0);\n});\n\nautoUpdater.on(\"download-progress\", (p: ProgressInfo) => {\n  if (download) download.lastProgressAt = Date.now();\n  broadcastProgress({\n    percent: p.percent, transferred: p.transferred, total: p.total,\n    bytesPerSecond: p.bytesPerSecond, version: download?.info.version ?? \"\",\n  });\n});\n\n/** Ask the renderer (one-shot, timeout-guarded) whether the open scene has unsaved edits.\n *  Resolves false on any error/timeout - the renderer's dirty flag is the only truth here. */\nfunction askRendererIsDirty(win: BrowserWindow | null): Promise<boolean> {\n  return new Promise((resolve) => {\n    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) { resolve(false); return; }\n    const onReply = (_e: unknown, isDirty: boolean) => { clearTimeout(timeout); resolve(!!isDirty); };\n    ipcMain.once(UPDATER_CHANNELS.dirtyReply, onReply);\n    const timeout = setTimeout(() => {\n      ipcMain.removeListener(UPDATER_CHANNELS.dirtyReply, onReply);\n      console.warn(\"Updater dirty-check timed out; assuming clean.\");\n      resolve(false);\n    }, 2000);\n    win.webContents.send(UPDATER_CHANNELS.checkDirty);\n  });\n}\n\n/** Trigger a save in the renderer and wait for completion. Saves run the lock-aware VC write path,\n *  so the timeout is generous; if it elapses we abort rather than install over a half-saved project. */\nfunction triggerRendererSave(win: BrowserWindow | null): Promise<{ ok: boolean }> {\n  return new Promise((resolve) => {\n    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) { resolve({ ok: false }); return; }\n    const onReply = (_e: unknown, result: { ok: boolean }) => { clearTimeout(timeout); resolve(result || { ok: false }); };\n    ipcMain.once(UPDATER_CHANNELS.saveDone, onReply);\n    const timeout = setTimeout(() => {\n      ipcMain.removeListener(UPDATER_CHANNELS.saveDone, onReply);\n      console.warn(\"Updater save timed out.\");\n      resolve({ ok: false });\n    }, 30000);\n    win.webContents.send(UPDATER_CHANNELS.saveBeforeInstall);\n  });\n}\n\n/** Show a THEMED prompt in the renderer (never a stock OS dialog; design-language \"coherent to the edges\")\n *  and resolve the chosen button index - the same contract as dialog.showMessageBox's `response`. Falls\n *  back to cancelId/defaultId if there's no live renderer to answer (so an install is never blocked on it). */\nfunction themedPrompt(win: BrowserWindow | null, opts: UpdaterPromptOptions): Promise<number> {\n  return new Promise((resolve) => {\n    const fallback = opts.cancelId ?? opts.defaultId ?? 0;\n    if (!win || win.isDestroyed() || win.webContents.isDestroyed()) { resolve(fallback); return; }\n    const onReply = (_e: unknown, idx: number) => { clearTimeout(timeout); resolve(typeof idx === \"number\" ? idx : fallback); };\n    ipcMain.once(UPDATER_CHANNELS.promptReply, onReply);\n    // Generous: these are user-facing prompts. If the renderer never answers (gone / hung), fall back safely.\n    const timeout = setTimeout(() => { ipcMain.removeListener(UPDATER_CHANNELS.promptReply, onReply); resolve(fallback); }, 300000);\n    win.webContents.send(UPDATER_CHANNELS.prompt, opts);\n  });\n}\n\n/** quitAndInstall, guarded by the unsaved-edits check. autoInstallOnAppQuit routes through the normal\n *  window-close save path already, so only this explicit \"Restart Now\" needs the guard. */\nasync function quitAndInstallSafely(): Promise<void> {\n  const win = activeWindow();\n  if (!(await askRendererIsDirty(win))) { autoUpdater.quitAndInstall(); return; }\n\n  const response = await themedPrompt(win, {\n    buttons: [\"Save and Restart\", \"Discard and Restart\", \"Cancel\"],\n    defaultId: 0,\n    cancelId: 2,\n    message: \"You have unsaved changes.\",\n    detail: `Save them before restarting to install ${appName} ${updateDownloaded?.version || \"\"}?`,\n  });\n\n  if (response === 2) return; // Cancel - abort the install\n  if (response === 0) {\n    const result = await triggerRendererSave(win);\n    if (!result.ok) {\n      await themedPrompt(win, {\n        message: \"Save failed\",\n        detail: \"Your changes could not be saved, so the update was not installed. Save manually, then try again.\",\n        buttons: [\"OK\"],\n      });\n      return;\n    }\n  }\n  // response === 1 (Discard) falls through.\n  autoUpdater.quitAndInstall();\n}\n\nautoUpdater.on(\"update-downloaded\", (info: UpdateDownloadedEvent) => {\n  clearDownload();\n  updateDownloaded = info;\n  lastBackgroundError = null; // it got here in the end; stale retry noise would only mislead\n  writeLog(\"info\", [`download: ${info.version} downloaded and ready to install`]);\n  const win = activeWindow();\n  if (!win) return;\n  void themedPrompt(win, {\n    buttons: [\"Restart Now\", \"Later\"],\n    defaultId: 0,\n    cancelId: 1,\n    message: \"Update ready to install\",\n    detail: `${appName} ${info.version} has been downloaded. Restart now to apply, or it will install automatically next time you quit.`,\n  }).then((response) => { if (response === 0) void quitAndInstallSafely(); });\n});\n\n/** Name the app and say how to find its window. Call once, at startup. */\nexport function configureUpdater(opts: UpdaterOptions): void {\n  appName = opts.appName;\n  activeWindowFn = opts.activeWindow;\n  if (opts.logFile !== undefined) logPath = join(app.getPath(\"userData\"), opts.logFile);\n}\n\n/** Fire-and-forget background check; periodic + on launch. No-op in dev. */\nexport function startBackgroundUpdateCheck(): void {\n  if (!app.isPackaged) return;\n  autoUpdater.checkForUpdates().catch((err) => {\n    console.error(\"AutoUpdater background check failed:\", err?.message || err);\n  });\n}\n\n/** The Help ▸ Check for Updates… handler: always gives the user feedback (downloading / up to date /\n *  error), unlike the silent background check. */\nexport async function manualCheckForUpdates(win?: BrowserWindow | null): Promise<void> {\n  const parent = win || activeWindow();\n\n  if (!app.isPackaged) {\n    await themedPrompt(parent, {\n      message: \"Updates unavailable in development build\",\n      detail: `Auto-update only runs in packaged builds.\\n\\nCurrent version: ${app.getVersion()}`,\n      buttons: [\"OK\"],\n    });\n    return;\n  }\n\n  if (updateDownloaded) {\n    const response = await themedPrompt(parent, {\n      buttons: [\"Restart Now\", \"Later\"],\n      defaultId: 0,\n      cancelId: 1,\n      message: \"Update ready to install\",\n      detail: `${appName} ${updateDownloaded.version} has been downloaded. Restart now to apply.`,\n    });\n    if (response === 0) await quitAndInstallSafely();\n    return;\n  }\n\n  if (download) {\n    // A download is already in flight: show it, live (the dialog subscribes to progress events).\n    await themedPrompt(parent, {\n      message: \"Update available\",\n      detail: `${appName} ${download.info.version} is downloading. You'll be prompted to restart when it's ready.`,\n      buttons: [\"OK\"],\n      progress: true,\n    });\n    return;\n  }\n\n  try {\n    // A manual check starts a fresh retry cycle: if the last one gave up, this is the user asking again.\n    await autoUpdater.checkForUpdates();\n    // With autoDownload off, `update-available` (fired during the await) starts the managed download,\n    // so by here `download` is set iff the feed had something newer. (Read through locals: TS narrows the\n    // module-level `download` to null after the guard above and cannot see the event handler mutate it.)\n    const started = download as DownloadState | null;\n    const ready = updateDownloaded as UpdateDownloadedEvent | null;\n    if (started) {\n      await themedPrompt(parent, {\n        message: \"Update available\",\n        detail: `${appName} ${started.info.version} is downloading. You'll be prompted to restart when it's ready.`,\n        buttons: [\"OK\"],\n        progress: true,\n      });\n      lastBackgroundError = null;\n    } else if (ready) {\n      // The check completed a download between our earlier guard and now (tiny window, but free to handle).\n      const response = await themedPrompt(parent, {\n        buttons: [\"Restart Now\", \"Later\"], defaultId: 0, cancelId: 1,\n        message: \"Update ready to install\",\n        detail: `${appName} ${ready.version} has been downloaded. Restart now to apply.`,\n      });\n      if (response === 0) await quitAndInstallSafely();\n    } else if (lastBackgroundError) {\n      await themedPrompt(parent, {\n        message: \"You're on the latest version, but updates have had errors.\",\n        detail: `Current version: ${appName} ${app.getVersion()}\\n\\nLast update error:\\n${lastBackgroundError}`,\n        buttons: [\"OK\"],\n      });\n      lastBackgroundError = null;\n    } else {\n      await themedPrompt(parent, {\n        message: \"You're on the latest version.\",\n        detail: `${appName} ${app.getVersion()} is up to date.`,\n        buttons: [\"OK\"],\n      });\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    const detail = lastBackgroundError && lastBackgroundError !== message\n      ? `${message}\\n\\nA previous background check also failed with:\\n${lastBackgroundError}`\n      : message;\n    await themedPrompt(parent, { message: \"Update check failed\", detail, buttons: [\"OK\"] });\n    lastBackgroundError = null;\n  }\n}\n"]}

package/dist/vc-status.cjs

@@ -0,0 +1,77 @@
+'use strict';
+
+var simpleVcLib = require('@wildwinter/simple-vc-lib');
+
+// src/vc-status.ts
+var REMOTE_STATUS_THROTTLE_MS = 15e3;
+var read = simpleVcLib.fileStatusAsync;
+var logPrefix = "app-shell";
+function setVcLogPrefix(name) {
+  logPrefix = name;
+}
+var lastRemoteAt = 0;
+var cachedRemoteBits = /* @__PURE__ */ new Map();
+var inFlight;
+function setStatusReader(reader) {
+  read = reader ?? simpleVcLib.fileStatusAsync;
+}
+function resetShardStatus() {
+  lastRemoteAt = 0;
+  cachedRemoteBits = /* @__PURE__ */ new Map();
+}
+async function query(shards) {
+  const states = /* @__PURE__ */ new Map();
+  for (const s of shards) states.set(s.key, { writable: true });
+  const keyOf = new Map(shards.map((s) => [s.path, s.key]));
+  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;
+  let system = "filesystem";
+  try {
+    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {
+      const key = keyOf.get(st.filePath);
+      if (key === void 0) continue;
+      system = st.system;
+      const acc = states.get(key);
+      if (!st.writable) acc.writable = false;
+      if (doRemote) {
+        if (st.lockedBy?.length) acc.lockedBy = [.../* @__PURE__ */ new Set([...acc.lockedBy ?? [], ...st.lockedBy])];
+        if (st.outOfDate) acc.outOfDate = true;
+      }
+    }
+    if (doRemote) {
+      lastRemoteAt = Date.now();
+      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {
+        ...s.lockedBy !== void 0 ? { lockedBy: s.lockedBy } : {},
+        ...s.outOfDate !== void 0 ? { outOfDate: s.outOfDate } : {}
+      }]));
+    } else {
+      for (const [key, acc] of states) {
+        const cached = cachedRemoteBits.get(key);
+        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;
+        if (cached?.outOfDate) acc.outOfDate = true;
+      }
+    }
+  } catch (e) {
+    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);
+  }
+  return { system, states };
+}
+function shardStatus(shards) {
+  if (!inFlight) {
+    inFlight = (async () => {
+      try {
+        return await query(shards);
+      } finally {
+        inFlight = void 0;
+      }
+    })();
+  }
+  return inFlight;
+}
+
+exports.REMOTE_STATUS_THROTTLE_MS = REMOTE_STATUS_THROTTLE_MS;
+exports.resetShardStatus = resetShardStatus;
+exports.setStatusReader = setStatusReader;
+exports.setVcLogPrefix = setVcLogPrefix;
+exports.shardStatus = shardStatus;
+//# sourceMappingURL=vc-status.cjs.map
+//# sourceMappingURL=vc-status.cjs.map

package/dist/vc-status.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vc-status.ts"],"names":["fileStatusAsync"],"mappings":";;;;;AAsDO,IAAM,yBAAA,GAA4B;AAIzC,IAAI,IAAA,GAAqBA,2BAAA;AAEzB,IAAI,SAAA,GAAY,WAAA;AAET,SAAS,eAAe,IAAA,EAAoB;AAAE,EAAA,SAAA,GAAY,IAAA;AAAM;AACvE,IAAI,YAAA,GAAe,CAAA;AACnB,IAAI,gBAAA,uBAAuB,GAAA,EAA0D;AACrF,IAAI,QAAA;AAIG,SAAS,gBAAgB,MAAA,EAAmC;AACjE,EAAA,IAAA,GAAO,MAAA,IAAUA,2BAAA;AACnB;AAIO,SAAS,gBAAA,GAAyB;AACvC,EAAA,YAAA,GAAe,CAAA;AACf,EAAA,gBAAA,uBAAuB,GAAA,EAAI;AAC7B;AAEA,eAAe,MAAM,MAAA,EAA0C;AAC7D,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAwB;AAC3C,EAAA,KAAA,MAAW,CAAA,IAAK,QAAQ,MAAA,CAAO,GAAA,CAAI,EAAE,GAAA,EAAK,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA;AAC5D,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,IAAA,EAAM,CAAA,CAAE,GAAG,CAAC,CAAC,CAAA;AAExD,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,YAAA,IAAgB,yBAAA;AAC9C,EAAA,IAAI,MAAA,GAAS,YAAA;AACb,EAAA,IAAI;AACF,IAAA,KAAA,MAAW,EAAA,IAAM,MAAM,IAAA,CAAK,MAAA,CAAO,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAA,EAAG,EAAE,MAAA,EAAQ,QAAA,EAAU,CAAA,EAAG;AAC5E,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,EAAA,CAAG,QAAQ,CAAA;AACjC,MAAA,IAAI,QAAQ,KAAA,CAAA,EAAW;AACvB,MAAA,MAAA,GAAS,EAAA,CAAG,MAAA;AACZ,MAAA,MAAM,GAAA,GAAM,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAC1B,MAAA,IAAI,CAAC,EAAA,CAAG,QAAA,EAAU,GAAA,CAAI,QAAA,GAAW,KAAA;AACjC,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,IAAI,GAAG,QAAA,EAAU,MAAA,MAAY,QAAA,GAAW,CAAC,mBAAG,IAAI,GAAA,CAAI,CAAC,GAAI,GAAA,CAAI,YAAY,EAAC,EAAI,GAAG,EAAA,CAAG,QAAQ,CAAC,CAAC,CAAA;AAC9F,QAAA,IAAI,EAAA,CAAG,SAAA,EAAW,GAAA,CAAI,SAAA,GAAY,IAAA;AAAA,MACpC;AAAA,IACF;AACA,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,YAAA,GAAe,KAAK,GAAA,EAAI;AACxB,MAAA,gBAAA,GAAmB,IAAI,GAAA,CAAI,CAAC,GAAG,MAAM,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,CAAC,CAAA,KAAM,CAAC,GAAA,EAAK;AAAA,QAC7D,GAAI,EAAE,QAAA,KAAa,KAAA,CAAA,GAAY,EAAE,QAAA,EAAU,CAAA,CAAE,QAAA,EAAS,GAAI,EAAC;AAAA,QAC3D,GAAI,EAAE,SAAA,KAAc,KAAA,CAAA,GAAY,EAAE,SAAA,EAAW,CAAA,CAAE,SAAA,EAAU,GAAI;AAAC,OAC/D,CAAC,CAAC,CAAA;AAAA,IACL,CAAA,MAAO;AACL,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,GAAG,CAAA,IAAK,MAAA,EAAQ;AAC/B,QAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,GAAA,CAAI,GAAG,CAAA;AACvC,QAAA,IAAI,MAAA,EAAQ,QAAA,EAAU,MAAA,EAAQ,GAAA,CAAI,WAAW,MAAA,CAAO,QAAA;AACpD,QAAA,IAAI,MAAA,EAAQ,SAAA,EAAW,GAAA,CAAI,SAAA,GAAY,IAAA;AAAA,MACzC;AAAA,IACF;AAAA,EACF,SAAS,CAAA,EAAG;AAEV,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,EAAG,SAAS,CAAA,6EAAA,CAAA,EAAiF,CAAC,CAAA;AAAA,EAC7G;AACA,EAAA,OAAO,EAAE,QAAQ,MAAA,EAAO;AAC1B;AAIO,SAAS,YAAY,MAAA,EAA0C;AACpE,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,QAAA,GAAA,CAAY,YAAY;AACtB,MAAA,IAAI;AAAE,QAAA,OAAO,MAAM,MAAM,MAAM,CAAA;AAAA,MAAG,CAAA,SAAE;AAAU,QAAA,QAAA,GAAW,MAAA;AAAA,MAAW;AAAA,IACtE,CAAA,GAAG;AAAA,EACL;AACA,EAAA,OAAO,QAAA;AACT","file":"vc-status.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}

package/dist/vc-status.d.cts

@@ -0,0 +1,40 @@
+import { VCStatusOptions, VCFileStatus } from '@wildwinter/simple-vc-lib';
+
+/** One shard to ask about: the key the renderer looks state up by, and its
+ *  absolute path on disk. */
+interface ShardRef {
+    key: string;
+    path: string;
+}
+/** One shard's version-control state. All-clean is `{ writable: true }`. */
+interface ShardState {
+    /** Writable on disk right now. `false` = the read-only bit is set (a lock
+     *  VCS has not checked it out yet, or someone else holds it). */
+    writable: boolean;
+    /** Who else holds it open / locked (e.g. "bo@bo-ws") - we can read it, not
+     *  write it. */
+    lockedBy?: string[];
+    /** A newer revision exists on the server (get latest before editing). */
+    outOfDate?: boolean;
+}
+interface ShardStatus {
+    /** The backend simple-vc-lib actually detected ("git" / "perforce" / ...). */
+    system: string;
+    states: Map<string, ShardState>;
+}
+/** How long a remote (server round-trip) answer stays good for. */
+declare const REMOTE_STATUS_THROTTLE_MS = 15000;
+type StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;
+/** Name the app, for that warning. */
+declare function setVcLogPrefix(name: string): void;
+/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status
+ *  reader for canned answers. Pass null to restore the real one. */
+declare function setStatusReader(reader: StatusReader | null): void;
+/** Drop the throttle window and the cached remote bits - called when a project
+ *  opens, so a new project never inherits the last one's answers. */
+declare function resetShardStatus(): void;
+/** The current state of every shard, throttled + coalesced as above. Never
+ *  throws: a failed query yields a clean, writable snapshot. */
+declare function shardStatus(shards: ShardRef[]): Promise<ShardStatus>;
+
+export { REMOTE_STATUS_THROTTLE_MS, type ShardRef, type ShardState, type ShardStatus, resetShardStatus, setStatusReader, setVcLogPrefix, shardStatus };

package/dist/vc-status.d.ts

@@ -0,0 +1,40 @@
+import { VCStatusOptions, VCFileStatus } from '@wildwinter/simple-vc-lib';
+
+/** One shard to ask about: the key the renderer looks state up by, and its
+ *  absolute path on disk. */
+interface ShardRef {
+    key: string;
+    path: string;
+}
+/** One shard's version-control state. All-clean is `{ writable: true }`. */
+interface ShardState {
+    /** Writable on disk right now. `false` = the read-only bit is set (a lock
+     *  VCS has not checked it out yet, or someone else holds it). */
+    writable: boolean;
+    /** Who else holds it open / locked (e.g. "bo@bo-ws") - we can read it, not
+     *  write it. */
+    lockedBy?: string[];
+    /** A newer revision exists on the server (get latest before editing). */
+    outOfDate?: boolean;
+}
+interface ShardStatus {
+    /** The backend simple-vc-lib actually detected ("git" / "perforce" / ...). */
+    system: string;
+    states: Map<string, ShardState>;
+}
+/** How long a remote (server round-trip) answer stays good for. */
+declare const REMOTE_STATUS_THROTTLE_MS = 15000;
+type StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;
+/** Name the app, for that warning. */
+declare function setVcLogPrefix(name: string): void;
+/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status
+ *  reader for canned answers. Pass null to restore the real one. */
+declare function setStatusReader(reader: StatusReader | null): void;
+/** Drop the throttle window and the cached remote bits - called when a project
+ *  opens, so a new project never inherits the last one's answers. */
+declare function resetShardStatus(): void;
+/** The current state of every shard, throttled + coalesced as above. Never
+ *  throws: a failed query yields a clean, writable snapshot. */
+declare function shardStatus(shards: ShardRef[]): Promise<ShardStatus>;
+
+export { REMOTE_STATUS_THROTTLE_MS, type ShardRef, type ShardState, type ShardStatus, resetShardStatus, setStatusReader, setVcLogPrefix, shardStatus };

package/dist/vc-status.js

@@ -0,0 +1,71 @@
+import { fileStatusAsync } from '@wildwinter/simple-vc-lib';
+
+// src/vc-status.ts
+var REMOTE_STATUS_THROTTLE_MS = 15e3;
+var read = fileStatusAsync;
+var logPrefix = "app-shell";
+function setVcLogPrefix(name) {
+  logPrefix = name;
+}
+var lastRemoteAt = 0;
+var cachedRemoteBits = /* @__PURE__ */ new Map();
+var inFlight;
+function setStatusReader(reader) {
+  read = reader ?? fileStatusAsync;
+}
+function resetShardStatus() {
+  lastRemoteAt = 0;
+  cachedRemoteBits = /* @__PURE__ */ new Map();
+}
+async function query(shards) {
+  const states = /* @__PURE__ */ new Map();
+  for (const s of shards) states.set(s.key, { writable: true });
+  const keyOf = new Map(shards.map((s) => [s.path, s.key]));
+  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;
+  let system = "filesystem";
+  try {
+    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {
+      const key = keyOf.get(st.filePath);
+      if (key === void 0) continue;
+      system = st.system;
+      const acc = states.get(key);
+      if (!st.writable) acc.writable = false;
+      if (doRemote) {
+        if (st.lockedBy?.length) acc.lockedBy = [.../* @__PURE__ */ new Set([...acc.lockedBy ?? [], ...st.lockedBy])];
+        if (st.outOfDate) acc.outOfDate = true;
+      }
+    }
+    if (doRemote) {
+      lastRemoteAt = Date.now();
+      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {
+        ...s.lockedBy !== void 0 ? { lockedBy: s.lockedBy } : {},
+        ...s.outOfDate !== void 0 ? { outOfDate: s.outOfDate } : {}
+      }]));
+    } else {
+      for (const [key, acc] of states) {
+        const cached = cachedRemoteBits.get(key);
+        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;
+        if (cached?.outOfDate) acc.outOfDate = true;
+      }
+    }
+  } catch (e) {
+    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);
+  }
+  return { system, states };
+}
+function shardStatus(shards) {
+  if (!inFlight) {
+    inFlight = (async () => {
+      try {
+        return await query(shards);
+      } finally {
+        inFlight = void 0;
+      }
+    })();
+  }
+  return inFlight;
+}
+
+export { REMOTE_STATUS_THROTTLE_MS, resetShardStatus, setStatusReader, setVcLogPrefix, shardStatus };
+//# sourceMappingURL=vc-status.js.map
+//# sourceMappingURL=vc-status.js.map

package/dist/vc-status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vc-status.ts"],"names":[],"mappings":"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","file":"vc-status.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}