feat: capture uncaught IPC handler errors as PostHog exceptions

src/ipc/handlers/base.ts

@@ -1,6 +1,7 @@
 import { ipcMain, IpcMainInvokeEvent } from "electron";
 import { z } from "zod";
 import type { IpcContract } from "../contracts/core";
+import { sendTelemetryException } from "../utils/telemetry";
 
 /**
  * Creates a typed IPC handler from a contract.
@@ -37,7 +38,13 @@ export function createTypedHandler<
         throw new Error(`[${contract.channel}] Invalid input: ${errorMessage}`);
       }
 
-      const result = await handler(event, parsed.data);
+      let result: z.infer<TOutput>;
+      try {
+        result = await handler(event, parsed.data);
+      } catch (err) {
+        sendTelemetryException(err, { ipc_channel: contract.channel });
+        throw err;
+      }
 
       // Validate output in development mode only (catches handler bugs without prod overhead)
       if (process.env.NODE_ENV === "development") {
@@ -118,6 +125,7 @@ export function createLoggedTypedHandler(logger: {
           return result;
         } catch (err) {
           logger.error(`[${contract.channel}] Handler error`, err);
+          sendTelemetryException(err, { ipc_channel: contract.channel });
           throw err;
         }
       },

src/ipc/handlers/safe_handle.ts

@@ -1,5 +1,6 @@
 import { ipcMain, IpcMainInvokeEvent } from "electron";
 import log from "electron-log";
+import { sendTelemetryException } from "../utils/telemetry";
 import { IS_TEST_BUILD } from "../utils/test_utils";
 
 export function createLoggedHandler(logger: log.LogFunctions) {
@@ -22,6 +23,7 @@ export function createLoggedHandler(logger: log.LogFunctions) {
             `Error in ${fn.name}: args: ${JSON.stringify(args)}`,
             error,
           );
+          sendTelemetryException(error, { ipc_channel: channel });
           throw new Error(`[${channel}] ${error}`);
         }
       },

src/ipc/utils/telemetry.ts

@@ -24,3 +24,22 @@ export function sendTelemetryEvent(
     logger.warn("Error sending telemetry event:", error);
   }
 }
+
+/**
+ * Sends an exception from the main process to the renderer as a PostHog $exception event.
+ */
+export function sendTelemetryException(
+  error: unknown,
+  context?: Record<string, unknown>,
+): void {
+  const err =
+    error instanceof Error
+      ? error
+      : new Error(String(error ?? "Unknown error"));
+  sendTelemetryEvent("$exception", {
+    $exception_type: err.name,
+    $exception_message: err.message,
+    $exception_stack_trace_raw: err.stack,
+    ...context,
+  });
+}