feat: Implement application bootstrap and window management

- Added bootstrap functionality to initialize the Electron application.
- Created a new paths module to manage application paths and URLs.
- Introduced a shutdown service to handle graceful application shutdowns.
- Refactored error logging to use a dedicated logger module.
- Implemented process killing logic for NodeCG processes across platforms.
- Established navigation policies for internal and external URL handling in windows.
- Developed window service for creating and managing application windows.
- Added tests for application paths, application controller, navigation policies, process killer, and shutdown service.

src/main/nodecg/platform-process-killer.ts

@@ -0,0 +1,54 @@
+import { ChildProcess, SpawnOptions } from "node:child_process";
+
+export type PlatformProcessKillerDeps = {
+  platform: NodeJS.Platform;
+  spawnProcess: (command: string, args: string[], options: SpawnOptions) => ChildProcess;
+  killProcess: (pid: number, signal: NodeJS.Signals) => void;
+  log: (...args: unknown[]) => void;
+};
+
+export function killProcessTree(pid: number, signal: NodeJS.Signals, deps: PlatformProcessKillerDeps): boolean {
+  if (!Number.isSafeInteger(pid) || pid <= 0) {
+    deps.log(`Invalid pid for process tree termination: ${pid}`);
+    return false;
+  }
+
+  if (deps.platform === "win32") {
+    return killWindowsProcessTree(pid, signal, deps);
+  }
+
+  return killPosixProcessTree(pid, signal, deps.killProcess);
+}
+
+function killWindowsProcessTree(
+  pid: number,
+  signal: NodeJS.Signals,
+  deps: Pick<PlatformProcessKillerDeps, "spawnProcess" | "log">,
+): boolean {
+  const args = ["/pid", String(pid), "/T", ...(signal === "SIGKILL" ? ["/F"] : [])];
+  const killer = deps.spawnProcess("taskkill", args, {
+    stdio: "ignore",
+    shell: false,
+    windowsHide: true,
+  });
+
+  killer.on("error", (error) => {
+    deps.log(`taskkill error for pid=${pid}`, error);
+  });
+
+  return true;
+}
+
+function killPosixProcessTree(pid: number, signal: NodeJS.Signals, killProcess: PlatformProcessKillerDeps["killProcess"]): boolean {
+  try {
+    killProcess(-pid, signal);
+    return true;
+  } catch {
+    try {
+      killProcess(pid, signal);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}

src/main/nodecg/process-manager.ts

@@ -5,6 +5,7 @@ import path from "node:path";
 
 import { AppRuntimeConfig } from "../config/runtime-config";
 import { NODE_RUNTIME_NAME } from "../constants";
+import { killProcessTree } from "./platform-process-killer";
 
 type NodecgProcessManagerConfig = {
   isDev: boolean;
@@ -161,7 +162,12 @@ export function createNodecgProcessManager({
     }
 
     log(`Stopping NodeCG pid=${pid}`);
-    killNodecgProcessTree(pid, "SIGTERM", log, resolvedDeps);
+    killProcessTree(pid, "SIGTERM", {
+      platform: resolvedDeps.platform,
+      spawnProcess: resolvedDeps.spawnProcess,
+      killProcess: resolvedDeps.killProcess,
+      log,
+    });
 
     stopNodecgPromise = new Promise((resolve) => {
       let completed = false;
@@ -189,7 +195,12 @@ export function createNodecgProcessManager({
         () => {
           if (processToStop.exitCode === null && processToStop.signalCode === null) {
             log(`NodeCG did not exit after SIGTERM, forcing SIGKILL pid=${pid}`);
-            killNodecgProcessTree(pid, "SIGKILL", log, resolvedDeps);
+            killProcessTree(pid, "SIGKILL", {
+              platform: resolvedDeps.platform,
+              spawnProcess: resolvedDeps.spawnProcess,
+              killProcess: resolvedDeps.killProcess,
+              log,
+            });
             complete();
           }
         },
@@ -315,39 +326,6 @@ function probePortAvailable(port: number): Promise<boolean> {
   });
 }
 
-function killNodecgProcessTree(
-  pid: number,
-  signal: NodeJS.Signals,
-  log: (...args: unknown[]) => void,
-  deps: Pick<NodecgProcessManagerDeps, "platform" | "spawnProcess" | "killProcess">,
-): boolean {
-  if (deps.platform === "win32") {
-    const force = signal === "SIGKILL" ? "/F" : "";
-    const killer = deps.spawnProcess("taskkill", ["/pid", String(pid), "/T", ...(force ? [force] : [])], {
-      stdio: "ignore",
-      shell: true,
-    });
-
-    killer.on("error", (error) => {
-      log(`taskkill error for pid=${pid}`, error);
-    });
-
-    return true;
-  }
-
-  try {
-    deps.killProcess(-pid, signal);
-    return true;
-  } catch {
-    try {
-      deps.killProcess(pid, signal);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}
-
 function sleep(ms: number, setTimer: (handler: () => void, timeoutMs: number) => unknown): Promise<void> {
   return new Promise((resolve) => {
     setTimer(resolve, ms);