feat(desktop): split daemon and release settings to main process

Move daemon management and release channel settings out of the renderer's AsyncStorage and into a desktop-owned settings store persisted by the main process. Adds a "Keep daemon running after quit" option, a daemon lifecycle section in settings, and a one-time migration of legacy renderer-owned desktop settings.
2026-04-25 13:59:07 +07:00
parent 2b37276577
commit ae3e88e7e1
20 changed files with 1792 additions and 187 deletions
@@ -0,0 +1,261 @@
+import { access, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+import type { AppReleaseChannel } from "../features/auto-updater.js";
+
+export interface DesktopSettings {
+  releaseChannel: AppReleaseChannel;
+  daemon: {
+    manageBuiltInDaemon: boolean;
+    keepRunningAfterQuit: boolean;
+  };
+}
+
+interface DesktopSettingsPatch {
+  releaseChannel?: AppReleaseChannel;
+  daemon?: Partial<DesktopSettings["daemon"]>;
+}
+
+interface PersistedDesktopSettingsDocument {
+  version: 1;
+  settings: DesktopSettings;
+  migrations: {
+    legacyRendererSettingsImported: boolean;
+  };
+}
+
+export interface DesktopSettingsStore {
+  get(): Promise<DesktopSettings>;
+  patch(patch: unknown): Promise<DesktopSettings>;
+  migrateLegacyRendererSettings(legacySettings: unknown): Promise<DesktopSettings>;
+}
+
+export const DEFAULT_DESKTOP_SETTINGS: DesktopSettings = {
+  releaseChannel: "stable",
+  daemon: {
+    manageBuiltInDaemon: true,
+    keepRunningAfterQuit: true,
+  },
+};
+
+const DESKTOP_SETTINGS_FILENAME = "desktop-settings.json";
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function coerceReleaseChannel(value: unknown): AppReleaseChannel | null {
+  if (value === "beta") {
+    return "beta";
+  }
+  if (value === "stable") {
+    return "stable";
+  }
+  return null;
+}
+
+function coerceBoolean(value: unknown): boolean | null {
+  return typeof value === "boolean" ? value : null;
+}
+
+function buildDefaultDocument(): PersistedDesktopSettingsDocument {
+  return {
+    version: 1,
+    settings: DEFAULT_DESKTOP_SETTINGS,
+    migrations: {
+      legacyRendererSettingsImported: false,
+    },
+  };
+}
+
+function coerceDesktopSettings(input: unknown): DesktopSettings {
+  const result: DesktopSettings = {
+    releaseChannel: DEFAULT_DESKTOP_SETTINGS.releaseChannel,
+    daemon: { ...DEFAULT_DESKTOP_SETTINGS.daemon },
+  };
+
+  if (!isRecord(input)) {
+    return result;
+  }
+
+  const releaseChannel = coerceReleaseChannel(input.releaseChannel);
+  if (releaseChannel) {
+    result.releaseChannel = releaseChannel;
+  }
+
+  if (isRecord(input.daemon)) {
+    const manageBuiltInDaemon = coerceBoolean(input.daemon.manageBuiltInDaemon);
+    if (manageBuiltInDaemon !== null) {
+      result.daemon.manageBuiltInDaemon = manageBuiltInDaemon;
+    }
+
+    const keepRunningAfterQuit = coerceBoolean(input.daemon.keepRunningAfterQuit);
+    if (keepRunningAfterQuit !== null) {
+      result.daemon.keepRunningAfterQuit = keepRunningAfterQuit;
+    }
+  }
+
+  return result;
+}
+
+function coerceDesktopSettingsPatch(input: unknown): DesktopSettingsPatch {
+  if (!isRecord(input)) {
+    return {};
+  }
+
+  const patch: DesktopSettingsPatch = {};
+
+  const releaseChannel = coerceReleaseChannel(input.releaseChannel);
+  if (releaseChannel) {
+    patch.releaseChannel = releaseChannel;
+  }
+
+  if (isRecord(input.daemon)) {
+    const daemonPatch: Partial<DesktopSettings["daemon"]> = {};
+    const manageBuiltInDaemon = coerceBoolean(input.daemon.manageBuiltInDaemon);
+    if (manageBuiltInDaemon !== null) {
+      daemonPatch.manageBuiltInDaemon = manageBuiltInDaemon;
+    }
+    const keepRunningAfterQuit = coerceBoolean(input.daemon.keepRunningAfterQuit);
+    if (keepRunningAfterQuit !== null) {
+      daemonPatch.keepRunningAfterQuit = keepRunningAfterQuit;
+    }
+    if (Object.keys(daemonPatch).length > 0) {
+      patch.daemon = daemonPatch;
+    }
+  }
+
+  return patch;
+}
+
+function pickDesktopSettingsFromLegacyRendererSettings(
+  legacySettings: unknown,
+): DesktopSettingsPatch {
+  if (!isRecord(legacySettings)) {
+    return {};
+  }
+
+  const patch: DesktopSettingsPatch = {};
+  const releaseChannel = coerceReleaseChannel(legacySettings.releaseChannel);
+  if (releaseChannel) {
+    patch.releaseChannel = releaseChannel;
+  }
+
+  const manageBuiltInDaemon = coerceBoolean(legacySettings.manageBuiltInDaemon);
+  if (manageBuiltInDaemon !== null) {
+    patch.daemon = { manageBuiltInDaemon };
+  }
+
+  return patch;
+}
+
+function mergeDesktopSettings(
+  current: DesktopSettings,
+  patch: DesktopSettingsPatch,
+): DesktopSettings {
+  return {
+    releaseChannel: patch.releaseChannel ?? current.releaseChannel,
+    daemon: { ...current.daemon, ...patch.daemon },
+  };
+}
+
+function coerceDocument(input: unknown): PersistedDesktopSettingsDocument {
+  if (!isRecord(input)) {
+    return buildDefaultDocument();
+  }
+
+  const settings = coerceDesktopSettings(input.settings);
+  const migrations = isRecord(input.migrations)
+    ? {
+        legacyRendererSettingsImported: input.migrations.legacyRendererSettingsImported === true,
+      }
+    : {
+        legacyRendererSettingsImported: false,
+      };
+
+  return {
+    version: 1,
+    settings,
+    migrations,
+  };
+}
+
+export function createDesktopSettingsStore({
+  userDataPath,
+}: {
+  userDataPath: string;
+}): DesktopSettingsStore {
+  const filePath = path.join(userDataPath, DESKTOP_SETTINGS_FILENAME);
+  let cachedDocument: PersistedDesktopSettingsDocument | null = null;
+
+  async function persistDocument(document: PersistedDesktopSettingsDocument): Promise<void> {
+    await mkdir(userDataPath, { recursive: true });
+    const tempFilePath = `${filePath}.tmp`;
+    await writeFile(tempFilePath, `${JSON.stringify(document, null, 2)}\n`, "utf8");
+    await rename(tempFilePath, filePath);
+    cachedDocument = document;
+  }
+
+  async function loadDocument(): Promise<PersistedDesktopSettingsDocument> {
+    if (cachedDocument) {
+      return cachedDocument;
+    }
+
+    try {
+      await access(filePath);
+    } catch {
+      const document = buildDefaultDocument();
+      await persistDocument(document);
+      return document;
+    }
+
+    try {
+      const raw = await readFile(filePath, "utf8");
+      const document = coerceDocument(JSON.parse(raw));
+      await persistDocument(document);
+      return document;
+    } catch {
+      const document = buildDefaultDocument();
+      await persistDocument(document);
+      return document;
+    }
+  }
+
+  return {
+    async get(): Promise<DesktopSettings> {
+      const document = await loadDocument();
+      return document.settings;
+    },
+
+    async patch(patch: unknown): Promise<DesktopSettings> {
+      const current = await loadDocument();
+      const next = mergeDesktopSettings(current.settings, coerceDesktopSettingsPatch(patch));
+      await persistDocument({
+        ...current,
+        settings: next,
+      });
+      return next;
+    },
+
+    async migrateLegacyRendererSettings(legacySettings: unknown): Promise<DesktopSettings> {
+      const current = await loadDocument();
+      if (current.migrations.legacyRendererSettingsImported) {
+        return current.settings;
+      }
+
+      const next = mergeDesktopSettings(
+        current.settings,
+        pickDesktopSettingsFromLegacyRendererSettings(legacySettings),
+      );
+      await persistDocument({
+        ...current,
+        settings: next,
+        migrations: {
+          ...current.migrations,
+          legacyRendererSettingsImported: true,
+        },
+      });
+      return next;
+    },
+  };
+}