@guidelytech/electron 0.15.0 → 0.17.0

package/dist/main.js

@@ -1,26 +1,180 @@
 import {
-  APP_INFO_CHANNEL
-} from "./chunk-AGZOVF3N.js";
+  APP_INFO_CHANNEL,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL
+} from "./chunk-JP3V2XK5.js";
+
+// src/main-crashes.ts
+import * as nodeFs from "fs";
+import { basename, join } from "path";
+var MAX_EVENTS = 30;
+var OS_NAMES = { darwin: "macOS", win32: "Windows", linux: "Linux" };
+var FATAL_REASONS = /* @__PURE__ */ new Set(["crashed", "oom", "killed"]);
+var safe = (fn) => {
+  try {
+    return fn();
+  } catch {
+    return void 0;
+  }
+};
+var newId = () => Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join("");
+function serialize(error, depth = 0) {
+  const e = error;
+  const isErr = !!e && typeof e === "object" && typeof e.message === "string";
+  const out = {
+    type: isErr && typeof e.name === "string" && e.name || (isErr ? "Error" : "UnhandledRejection"),
+    message: (isErr ? String(e.message) : safe(() => typeof error === "string" ? error : JSON.stringify(error)) ?? String(error)).slice(0, 1e3),
+    ...isErr && typeof e.stack === "string" ? { stack: e.stack.slice(0, 16e3) } : {}
+  };
+  if (isErr && e.cause !== void 0 && e.cause !== null && depth < 5) out.cause = serialize(e.cause, depth + 1);
+  return out;
+}
+function installGuidelyCrashHandlers(opts) {
+  const proc = opts.process ?? process;
+  const fs = opts.fs ?? nodeFs;
+  const { app } = opts;
+  const userData = safe(() => app.getPath?.("userData"));
+  const storePath = opts.storePath === void 0 ? userData ? join(userData, "guidely-main-errors.json") : null : opts.storePath;
+  const cleanups = [];
+  let events = [];
+  if (storePath) {
+    const saved = safe(() => JSON.parse(fs.readFileSync(storePath, "utf8")));
+    if (Array.isArray(saved)) events = saved.filter((e) => !!e && typeof e === "object" && typeof e.id === "string").slice(-MAX_EVENTS);
+  }
+  const persist = () => {
+    if (storePath) safe(() => fs.writeFileSync(storePath, JSON.stringify(events)));
+  };
+  const notify = () => {
+    safe(() => {
+      for (const wc of opts.webContents?.getAllWebContents() ?? []) if (!safe(() => wc.isDestroyed?.())) safe(() => wc.send(MAIN_ERRORS_READY_CHANNEL));
+    });
+  };
+  const baseContexts = () => {
+    const osVersion = safe(() => proc.getSystemVersion?.());
+    return {
+      electron: { version: proc.versions.electron, chrome: proc.versions.chrome, node: proc.versions.node, processType: "main" },
+      os: { name: OS_NAMES[proc.platform] ?? proc.platform, ...osVersion ? { version: osVersion } : {} },
+      app: { app_name: safe(() => app.getName?.()), app_version: safe(() => app.getVersion?.()) }
+    };
+  };
+  const record = (data, extra) => {
+    try {
+      const contexts = baseContexts();
+      for (const [k, v] of Object.entries(extra.contexts ?? {})) contexts[k] = { ...contexts[k] ?? {}, ...v };
+      const event = { id: newId(), timestamp: Date.now(), ...data, level: extra.level, mechanism: extra.mechanism, handled: extra.handled ?? false, contexts, ...extra.tags ? { tags: extra.tags } : {}, ...extra.fingerprint ? { fingerprint: extra.fingerprint } : {} };
+      events.push(event);
+      if (events.length > MAX_EVENTS) events.splice(0, events.length - MAX_EVENTS);
+      persist();
+      notify();
+      return event.id;
+    } catch {
+      return "";
+    }
+  };
+  const on = (target, event, listener) => {
+    if (typeof target.on !== "function") return;
+    safe(() => target.on(event, listener));
+    cleanups.push(() => target.removeListener?.(event, listener));
+  };
+  if (opts.processHandlers !== false) {
+    on(proc, "uncaughtExceptionMonitor", (error, origin) => {
+      record(serialize(error), { level: "fatal", mechanism: origin === "unhandledRejection" ? "unhandledRejection" : "uncaughtException" });
+      if (opts.exitOnUncaught) {
+        safe(() => console.error(error));
+        if (typeof app.exit === "function") app.exit(1);
+        else proc.exit(1);
+      }
+    });
+    const onRejection = (reason) => {
+      record(serialize(reason), { level: "error", mechanism: "unhandledRejection" });
+      if (proc.listenerCount("unhandledRejection") <= 1) safe(() => console.error("Unhandled promise rejection in the main process:", reason));
+    };
+    on(proc, "unhandledRejection", onRejection);
+  }
+  if (opts.processGone !== false) {
+    on(app, "render-process-gone", (_event, _webContents, details = {}) => {
+      if (!details.reason || details.reason === "clean-exit") return;
+      record({ type: "RenderProcessGone", message: `Renderer process gone: ${details.reason}` }, { level: FATAL_REASONS.has(details.reason) ? "fatal" : "error", mechanism: "render-process-gone", contexts: { electron: { reason: details.reason, exitCode: details.exitCode, processType: "renderer" } } });
+    });
+    on(app, "child-process-gone", (_event, details = {}) => {
+      if (!details.reason || details.reason === "clean-exit") return;
+      const kind = details.type ?? "Child";
+      record({ type: "ChildProcessGone", message: `${kind} process gone: ${details.reason}` }, { level: FATAL_REASONS.has(details.reason) ? "fatal" : "error", mechanism: "child-process-gone", contexts: { electron: { reason: details.reason, exitCode: details.exitCode, processType: kind, ...details.serviceName ? { serviceName: details.serviceName } : {}, ...details.name ? { name: details.name } : {} } } });
+    });
+  }
+  if (opts.nativeCrashes) {
+    const reporter = typeof opts.nativeCrashes === "object" ? opts.nativeCrashes.crashReporter : void 0;
+    safe(() => reporter?.start({ uploadToServer: false }));
+    reportNewMinidumps(
+      app,
+      fs,
+      userData,
+      (file, stat) => record({ type: "NativeCrash", message: `Native crash (minidump ${basename(file)})` }, { level: "fatal", mechanism: "minidump", contexts: { electron: { minidump: basename(file), minidumpSize: stat.size, crashedAt: new Date(stat.mtimeMs).toISOString() } } })
+    );
+  }
+  safe(() => {
+    opts.ipcMain.removeHandler?.(MAIN_ERRORS_CHANNEL);
+    opts.ipcMain.handle(MAIN_ERRORS_CHANNEL, () => handle.take());
+    cleanups.push(() => opts.ipcMain.removeHandler?.(MAIN_ERRORS_CHANNEL));
+  });
+  const handle = {
+    captureException: (error, context = {}) => record(serialize(error), { level: context.level ?? "error", mechanism: "generic", handled: true, contexts: context.contexts, tags: context.tags, fingerprint: context.fingerprint }),
+    take: () => {
+      const out = events;
+      events = [];
+      if (out.length) persist();
+      return out;
+    },
+    dispose: () => {
+      for (const off of cleanups.splice(0)) safe(off);
+    }
+  };
+  return handle;
+}
+function reportNewMinidumps(app, fs, userData, report) {
+  const dir = safe(() => app.getPath?.("crashDumps"));
+  if (!dir || !userData) return;
+  const seenPath = join(userData, "guidely-minidumps.json");
+  const saved = safe(() => JSON.parse(fs.readFileSync(seenPath, "utf8")));
+  const firstRun = !Array.isArray(saved);
+  const seen = new Set(Array.isArray(saved) ? saved.filter((s) => typeof s === "string") : []);
+  const found = [];
+  const walk = (d, depth) => {
+    for (const entry of safe(() => fs.readdirSync(d, { withFileTypes: true })) ?? []) {
+      const path = join(d, entry.name);
+      if (entry.isDirectory() && depth < 2) walk(path, depth + 1);
+      else if (entry.isFile() && entry.name.endsWith(".dmp")) found.push(path);
+    }
+  };
+  walk(dir, 0);
+  for (const file of found) {
+    if (seen.has(file) || firstRun) continue;
+    const stat = safe(() => fs.statSync(file));
+    if (stat) report(file, stat);
+  }
+  safe(() => fs.writeFileSync(seenPath, JSON.stringify(found.slice(-500))));
+}
 
 // src/main.ts
 function appInfo(app, proc = process, osRelease) {
-  const safe = (fn) => {
+  const safe2 = (fn) => {
     try {
       return fn();
     } catch {
       return void 0;
     }
   };
-  const osVersion = safe(() => proc.getSystemVersion?.()) || safe(() => osRelease?.());
+  const osVersion = safe2(() => proc.getSystemVersion?.()) || safe2(() => osRelease?.());
   return {
-    appName: safe(() => app.getName()) ?? "app",
-    appVersion: safe(() => app.getVersion()) ?? "0.0.0",
+    appName: safe2(() => app.getName()) ?? "app",
+    appVersion: safe2(() => app.getVersion()) ?? "0.0.0",
     platform: proc.platform,
     arch: proc.arch,
     ...osVersion ? { osVersion } : {},
     ...proc.versions.electron ? { electronVersion: proc.versions.electron } : {},
     ...proc.versions.chrome ? { chromeVersion: proc.versions.chrome } : {},
-    ...app.getLocale ? { locale: safe(() => app.getLocale()) } : {},
+    ...proc.versions.node ? { nodeVersion: proc.versions.node } : {},
+    ...app.getLocale ? { locale: safe2(() => app.getLocale()) } : {},
     ...typeof app.isPackaged === "boolean" ? { packaged: app.isPackaged } : {}
   };
 }
@@ -28,11 +182,18 @@ function setupGuidelyMain(opts) {
   const info = appInfo(opts.app, opts.process, opts.osRelease);
   opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);
   opts.ipcMain.handle(APP_INFO_CHANNEL, () => info);
-  return () => opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);
+  const crashes = opts.errors ? installGuidelyCrashHandlers({ app: opts.app, ipcMain: opts.ipcMain, ...typeof opts.errors === "object" ? opts.errors : {} }) : null;
+  return () => {
+    opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);
+    crashes?.dispose();
+  };
 }
 export {
   APP_INFO_CHANNEL,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL,
   appInfo,
+  installGuidelyCrashHandlers,
   setupGuidelyMain
 };
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/main.ts"],"sourcesContent":["import { APP_INFO_CHANNEL, type ElectronAppInfo } from \"./types\";\n\nexport { APP_INFO_CHANNEL } from \"./types\";\nexport type { ElectronAppInfo } from \"./types\";\n\n/** The parts of Electron's `app` the helper reads (pass `import { app } from \"electron\"`). */\nexport interface ElectronAppLike {\n  getName(): string;\n  getVersion(): string;\n  getLocale?(): string;\n  isPackaged?: boolean;\n}\n\n/** The parts of Electron's `ipcMain` the helper uses. */\nexport interface IpcMainLike {\n  handle(channel: string, listener: (event: unknown, ...args: unknown[]) => unknown): void;\n  removeHandler?(channel: string): void;\n}\n\n/** Node's `process` fields read for the app info (overridable for tests). */\nexport interface ProcessLike {\n  platform: string;\n  arch: string;\n  versions: Record<string, string | undefined>;\n  getSystemVersion?: () => string;\n}\n\n/** Collects the app info Guidely reports: app name and version, OS, architecture and Electron/Chrome versions. */\nexport function appInfo(app: ElectronAppLike, proc: ProcessLike = process as unknown as ProcessLike, osRelease?: () => string): ElectronAppInfo {\n  const safe = <T>(fn: () => T): T | undefined => {\n    try {\n      return fn();\n    } catch {\n      return undefined;\n    }\n  };\n  const osVersion = safe(() => proc.getSystemVersion?.()) || safe(() => osRelease?.());\n  return {\n    appName: safe(() => app.getName()) ?? \"app\",\n    appVersion: safe(() => app.getVersion()) ?? \"0.0.0\",\n    platform: proc.platform,\n    arch: proc.arch,\n    ...(osVersion ? { osVersion } : {}),\n    ...(proc.versions.electron ? { electronVersion: proc.versions.electron } : {}),\n    ...(proc.versions.chrome ? { chromeVersion: proc.versions.chrome } : {}),\n    ...(app.getLocale ? { locale: safe(() => app.getLocale!()) } : {}),\n    ...(typeof app.isPackaged === \"boolean\" ? { packaged: app.isPackaged } : {}),\n  };\n}\n\n/**\n * Main process: answers the preload bridge's app-info request. Call once after `app` is ready:\n *\n * ```ts\n * import { app, ipcMain } from \"electron\";\n * import { setupGuidelyMain } from \"@guidelytech/electron/main\";\n * app.whenReady().then(() => { setupGuidelyMain({ app, ipcMain }); createWindow(); });\n * ```\n *\n * Returns a function that removes the handler.\n */\nexport function setupGuidelyMain(opts: { app: ElectronAppLike; ipcMain: IpcMainLike; process?: ProcessLike; osRelease?: () => string }): () => void {\n  const info = appInfo(opts.app, opts.process, opts.osRelease);\n  opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);\n  opts.ipcMain.handle(APP_INFO_CHANNEL, () => info);\n  return () => opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);\n}\n"],"mappings":";;;;;AA4BO,SAAS,QAAQ,KAAsB,OAAoB,SAAmC,WAA2C;AAC9I,QAAM,OAAO,CAAI,OAA+B;AAC9C,QAAI;AACF,aAAO,GAAG;AAAA,IACZ,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,QAAM,YAAY,KAAK,MAAM,KAAK,mBAAmB,CAAC,KAAK,KAAK,MAAM,YAAY,CAAC;AACnF,SAAO;AAAA,IACL,SAAS,KAAK,MAAM,IAAI,QAAQ,CAAC,KAAK;AAAA,IACtC,YAAY,KAAK,MAAM,IAAI,WAAW,CAAC,KAAK;AAAA,IAC5C,UAAU,KAAK;AAAA,IACf,MAAM,KAAK;AAAA,IACX,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IACjC,GAAI,KAAK,SAAS,WAAW,EAAE,iBAAiB,KAAK,SAAS,SAAS,IAAI,CAAC;AAAA,IAC5E,GAAI,KAAK,SAAS,SAAS,EAAE,eAAe,KAAK,SAAS,OAAO,IAAI,CAAC;AAAA,IACtE,GAAI,IAAI,YAAY,EAAE,QAAQ,KAAK,MAAM,IAAI,UAAW,CAAC,EAAE,IAAI,CAAC;AAAA,IAChE,GAAI,OAAO,IAAI,eAAe,YAAY,EAAE,UAAU,IAAI,WAAW,IAAI,CAAC;AAAA,EAC5E;AACF;AAaO,SAAS,iBAAiB,MAAmH;AAClJ,QAAM,OAAO,QAAQ,KAAK,KAAK,KAAK,SAAS,KAAK,SAAS;AAC3D,OAAK,QAAQ,gBAAgB,gBAAgB;AAC7C,OAAK,QAAQ,OAAO,kBAAkB,MAAM,IAAI;AAChD,SAAO,MAAM,KAAK,QAAQ,gBAAgB,gBAAgB;AAC5D;","names":[]}
+{"version":3,"sources":["../src/main-crashes.ts","../src/main.ts"],"sourcesContent":["import * as nodeFs from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL, type MainErrorEvent } from \"./types\";\n\n/**\n * Main-process error and crash capture (Sentry Electron's main-process integrations): uncaught\n * exceptions, unhandled rejections, renderer and child processes that die, and, opt-in, Crashpad\n * minidumps. The main process has no Guidely client, so events wait in a small file under\n * `userData` (they survive the crash or restart that usually follows) until a window's client takes\n * them over IPC and sends them; each event goes to exactly one window.\n */\n\n/** The parts of Electron's `app` crash capture uses. */\nexport interface CrashAppLike {\n  getName?(): string;\n  getVersion?(): string;\n  getPath?(name: \"userData\" | \"crashDumps\"): string;\n  on?(event: string, listener: (...args: any[]) => void): unknown;\n  removeListener?(event: string, listener: (...args: any[]) => void): unknown;\n  exit?(code?: number): void;\n}\n\n/** The parts of Node's `process` crash capture uses. */\nexport interface CrashProcessLike {\n  on(event: string, listener: (...args: any[]) => void): unknown;\n  removeListener(event: string, listener: (...args: any[]) => void): unknown;\n  listenerCount(event: string): number;\n  exit(code?: number): void;\n  platform: string;\n  versions: Record<string, string | undefined>;\n  getSystemVersion?: () => string;\n}\n\n/** The parts of `node:fs` crash capture uses (tests pass a fake). */\nexport interface CrashFsLike {\n  readFileSync(path: string, encoding: \"utf8\"): string;\n  writeFileSync(path: string, data: string): void;\n  readdirSync(path: string, options: { withFileTypes: true }): Array<{ name: string; isDirectory(): boolean; isFile(): boolean }>;\n  statSync(path: string): { mtimeMs: number; size: number };\n}\n\n/** The parts of Electron's `crashReporter` used for native crashes. */\nexport interface CrashReporterLike {\n  start(options: { uploadToServer: boolean; submitURL?: string; compress?: boolean }): void;\n}\n\n/** Electron's `webContents` module: windows are told when there are errors to take. */\nexport interface WebContentsModuleLike {\n  getAllWebContents(): Array<{ send(channel: string, ...args: unknown[]): void; isDestroyed?(): boolean }>;\n}\n\nexport interface MainCrashOptions {\n  /** Report uncaught exceptions and unhandled rejections (default true). */\n  processHandlers?: boolean;\n  /**\n   * After an uncaught exception: log it, then `app.exit(1)`, as a Node process would (default\n   * false: Electron shows its \"A JavaScript error occurred in the main process\" dialog and keeps\n   * running, and so does it with Guidely). Unhandled rejections are reported and logged, never fatal.\n   */\n  exitOnUncaught?: boolean;\n  /** Report renderers, GPU and utility processes that crash, are killed or run out of memory (default true). */\n  processGone?: boolean;\n  /**\n   * Native crashes: Guidely starts Electron's `crashReporter` (`uploadToServer: false`) and, at the\n   * next start, reports each new minidump by file name (the dump itself is not uploaded yet). Pass\n   * `true` when your app starts the crash reporter itself. Default off.\n   */\n  nativeCrashes?: boolean | { crashReporter: CrashReporterLike };\n  /** Where waiting events are kept (default `<userData>/guidely-main-errors.json`; `null`: in memory only). */\n  storePath?: string | null;\n  /** Electron's `webContents` module, to tell open windows to take new events right away (else the next window load takes them). */\n  webContents?: WebContentsModuleLike;\n}\n\nexport interface MainCrashHandle {\n  /** Reports an error from main-process code (`level` default `error`). */\n  captureException(error: unknown, context?: { level?: \"fatal\" | \"error\"; tags?: Record<string, string>; contexts?: Record<string, Record<string, unknown>>; fingerprint?: string[] }): string;\n  /** The waiting events, removed from the store (what the IPC handler answers). */\n  take(): MainErrorEvent[];\n  /** Removes the listeners and the IPC handler. */\n  dispose(): void;\n}\n\nconst MAX_EVENTS = 30;\nconst OS_NAMES: Record<string, string> = { darwin: \"macOS\", win32: \"Windows\", linux: \"Linux\" };\n/** Reasons a process ends that are crashes; the rest (`abnormal-exit`, `launch-failed`, …) are errors. */\nconst FATAL_REASONS = new Set([\"crashed\", \"oom\", \"killed\"]);\n\nconst safe = <T>(fn: () => T): T | undefined => {\n  try {\n    return fn();\n  } catch {\n    return undefined;\n  }\n};\n\nconst newId = () => Array.from({ length: 32 }, () => Math.floor(Math.random() * 16).toString(16)).join(\"\");\n\n/** An error (or any thrown value) as plain data for IPC, with up to 5 causes. */\nfunction serialize(error: unknown, depth = 0): Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\"> {\n  const e = error as { name?: unknown; message?: unknown; stack?: unknown; cause?: unknown } | null;\n  const isErr = !!e && typeof e === \"object\" && typeof e.message === \"string\";\n  const out: Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\"> = {\n    type: (isErr && typeof e!.name === \"string\" && e!.name) || (isErr ? \"Error\" : \"UnhandledRejection\"),\n    message: (isErr ? String(e!.message) : safe(() => (typeof error === \"string\" ? error : JSON.stringify(error))) ?? String(error)).slice(0, 1000),\n    ...(isErr && typeof e!.stack === \"string\" ? { stack: e!.stack.slice(0, 16000) } : {}),\n  };\n  if (isErr && e!.cause !== undefined && e!.cause !== null && depth < 5) out.cause = serialize(e!.cause, depth + 1);\n  return out;\n}\n\n/**\n * Installs main-process crash capture and the IPC handler windows take events from. Call it as\n * early as you can in the main process (before `app.whenReady()` works too), or pass\n * `errors: true | { … }` to `setupGuidelyMain`. Never throws.\n */\nexport function installGuidelyCrashHandlers(opts: { app: CrashAppLike; ipcMain: { handle(channel: string, listener: (event: unknown, ...args: unknown[]) => unknown): void; removeHandler?(channel: string): void }; process?: CrashProcessLike; fs?: CrashFsLike } & MainCrashOptions): MainCrashHandle {\n  const proc = opts.process ?? (process as unknown as CrashProcessLike);\n  const fs = opts.fs ?? (nodeFs as unknown as CrashFsLike);\n  const { app } = opts;\n  const userData = safe(() => app.getPath?.(\"userData\"));\n  const storePath = opts.storePath === undefined ? (userData ? join(userData, \"guidely-main-errors.json\") : null) : opts.storePath;\n  const cleanups: Array<() => void> = [];\n\n  let events: MainErrorEvent[] = [];\n  if (storePath) {\n    const saved = safe(() => JSON.parse(fs.readFileSync(storePath, \"utf8\")) as unknown);\n    if (Array.isArray(saved)) events = saved.filter((e): e is MainErrorEvent => !!e && typeof e === \"object\" && typeof (e as MainErrorEvent).id === \"string\").slice(-MAX_EVENTS);\n  }\n  // Synchronous: the process may be about to exit.\n  const persist = () => {\n    if (storePath) safe(() => fs.writeFileSync(storePath, JSON.stringify(events)));\n  };\n  const notify = () => {\n    safe(() => {\n      for (const wc of opts.webContents?.getAllWebContents() ?? []) if (!safe(() => wc.isDestroyed?.())) safe(() => wc.send(MAIN_ERRORS_READY_CHANNEL));\n    });\n  };\n\n  const baseContexts = (): Record<string, Record<string, unknown>> => {\n    const osVersion = safe(() => proc.getSystemVersion?.());\n    return {\n      electron: { version: proc.versions.electron, chrome: proc.versions.chrome, node: proc.versions.node, processType: \"main\" },\n      os: { name: OS_NAMES[proc.platform] ?? proc.platform, ...(osVersion ? { version: osVersion } : {}) },\n      app: { app_name: safe(() => app.getName?.()), app_version: safe(() => app.getVersion?.()) },\n    };\n  };\n\n  const record = (data: Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\">, extra: { level: \"fatal\" | \"error\"; mechanism: string; handled?: boolean; contexts?: Record<string, Record<string, unknown>>; tags?: Record<string, string>; fingerprint?: string[] }): string => {\n    try {\n      const contexts = baseContexts();\n      for (const [k, v] of Object.entries(extra.contexts ?? {})) contexts[k] = { ...(contexts[k] ?? {}), ...v };\n      const event: MainErrorEvent = { id: newId(), timestamp: Date.now(), ...data, level: extra.level, mechanism: extra.mechanism, handled: extra.handled ?? false, contexts, ...(extra.tags ? { tags: extra.tags } : {}), ...(extra.fingerprint ? { fingerprint: extra.fingerprint } : {}) };\n      events.push(event);\n      if (events.length > MAX_EVENTS) events.splice(0, events.length - MAX_EVENTS);\n      persist();\n      notify();\n      return event.id;\n    } catch {\n      return \"\";\n    }\n  };\n\n  const on = (target: { on?(e: string, l: (...a: any[]) => void): unknown; removeListener?(e: string, l: (...a: any[]) => void): unknown }, event: string, listener: (...args: any[]) => void) => {\n    if (typeof target.on !== \"function\") return;\n    safe(() => target.on!(event, listener));\n    cleanups.push(() => target.removeListener?.(event, listener));\n  };\n\n  if (opts.processHandlers !== false) {\n    // The monitor sees uncaught exceptions without changing what happens next (Electron's dialog, or Node's exit).\n    on(proc, \"uncaughtExceptionMonitor\", (error: unknown, origin?: string) => {\n      record(serialize(error), { level: \"fatal\", mechanism: origin === \"unhandledRejection\" ? \"unhandledRejection\" : \"uncaughtException\" });\n      if (opts.exitOnUncaught) {\n        safe(() => console.error(error));\n        if (typeof app.exit === \"function\") app.exit(1);\n        else proc.exit(1);\n      }\n    });\n    const onRejection = (reason: unknown) => {\n      record(serialize(reason), { level: \"error\", mechanism: \"unhandledRejection\" });\n      // Listening stops Node from raising it: keep it visible, as Node's `warn` mode does.\n      if (proc.listenerCount(\"unhandledRejection\") <= 1) safe(() => console.error(\"Unhandled promise rejection in the main process:\", reason));\n    };\n    on(proc, \"unhandledRejection\", onRejection);\n  }\n\n  if (opts.processGone !== false) {\n    on(app, \"render-process-gone\", (_event: unknown, _webContents: unknown, details: { reason?: string; exitCode?: number } = {}) => {\n      if (!details.reason || details.reason === \"clean-exit\") return;\n      record({ type: \"RenderProcessGone\", message: `Renderer process gone: ${details.reason}` }, { level: FATAL_REASONS.has(details.reason) ? \"fatal\" : \"error\", mechanism: \"render-process-gone\", contexts: { electron: { reason: details.reason, exitCode: details.exitCode, processType: \"renderer\" } } });\n    });\n    on(app, \"child-process-gone\", (_event: unknown, details: { type?: string; reason?: string; exitCode?: number; serviceName?: string; name?: string } = {}) => {\n      if (!details.reason || details.reason === \"clean-exit\") return;\n      const kind = details.type ?? \"Child\";\n      record({ type: \"ChildProcessGone\", message: `${kind} process gone: ${details.reason}` }, { level: FATAL_REASONS.has(details.reason) ? \"fatal\" : \"error\", mechanism: \"child-process-gone\", contexts: { electron: { reason: details.reason, exitCode: details.exitCode, processType: kind, ...(details.serviceName ? { serviceName: details.serviceName } : {}), ...(details.name ? { name: details.name } : {}) } } });\n    });\n  }\n\n  if (opts.nativeCrashes) {\n    const reporter = typeof opts.nativeCrashes === \"object\" ? opts.nativeCrashes.crashReporter : undefined;\n    safe(() => reporter?.start({ uploadToServer: false }));\n    reportNewMinidumps(app, fs, userData, (file, stat) =>\n      record({ type: \"NativeCrash\", message: `Native crash (minidump ${basename(file)})` }, { level: \"fatal\", mechanism: \"minidump\", contexts: { electron: { minidump: basename(file), minidumpSize: stat.size, crashedAt: new Date(stat.mtimeMs).toISOString() } } }),\n    );\n  }\n\n  safe(() => {\n    opts.ipcMain.removeHandler?.(MAIN_ERRORS_CHANNEL);\n    opts.ipcMain.handle(MAIN_ERRORS_CHANNEL, () => handle.take());\n    cleanups.push(() => opts.ipcMain.removeHandler?.(MAIN_ERRORS_CHANNEL));\n  });\n\n  const handle: MainCrashHandle = {\n    captureException: (error, context = {}) => record(serialize(error), { level: context.level ?? \"error\", mechanism: \"generic\", handled: true, contexts: context.contexts, tags: context.tags, fingerprint: context.fingerprint }),\n    take: () => {\n      const out = events;\n      events = [];\n      if (out.length) persist();\n      return out;\n    },\n    dispose: () => {\n      for (const off of cleanups.splice(0)) safe(off);\n    },\n  };\n  return handle;\n}\n\n/**\n * Reports the minidumps Crashpad wrote since the last start (`<crashDumps>/**.dmp`, two levels\n * deep). The first run only records the dumps already there.\n */\nfunction reportNewMinidumps(app: CrashAppLike, fs: CrashFsLike, userData: string | undefined, report: (file: string, stat: { mtimeMs: number; size: number }) => void): void {\n  const dir = safe(() => app.getPath?.(\"crashDumps\"));\n  if (!dir || !userData) return;\n  const seenPath = join(userData, \"guidely-minidumps.json\");\n  const saved = safe(() => JSON.parse(fs.readFileSync(seenPath, \"utf8\")) as unknown);\n  const firstRun = !Array.isArray(saved);\n  const seen = new Set(Array.isArray(saved) ? saved.filter((s): s is string => typeof s === \"string\") : []);\n  const found: string[] = [];\n  const walk = (d: string, depth: number) => {\n    for (const entry of safe(() => fs.readdirSync(d, { withFileTypes: true })) ?? []) {\n      const path = join(d, entry.name);\n      if (entry.isDirectory() && depth < 2) walk(path, depth + 1);\n      else if (entry.isFile() && entry.name.endsWith(\".dmp\")) found.push(path);\n    }\n  };\n  walk(dir, 0);\n  for (const file of found) {\n    if (seen.has(file) || firstRun) continue;\n    const stat = safe(() => fs.statSync(file));\n    if (stat) report(file, stat);\n  }\n  // Only the dumps still on disk: Crashpad prunes old ones.\n  safe(() => fs.writeFileSync(seenPath, JSON.stringify(found.slice(-500))));\n}\n","import { installGuidelyCrashHandlers, type CrashAppLike, type MainCrashOptions } from \"./main-crashes\";\nimport { APP_INFO_CHANNEL, type ElectronAppInfo } from \"./types\";\n\nexport { APP_INFO_CHANNEL, MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL } from \"./types\";\nexport type { ElectronAppInfo, MainErrorEvent } from \"./types\";\nexport { installGuidelyCrashHandlers } from \"./main-crashes\";\nexport type { CrashAppLike, CrashFsLike, CrashProcessLike, CrashReporterLike, MainCrashHandle, MainCrashOptions, WebContentsModuleLike } from \"./main-crashes\";\n\n/** The parts of Electron's `app` the helper reads (pass `import { app } from \"electron\"`). */\nexport interface ElectronAppLike {\n  getName(): string;\n  getVersion(): string;\n  getLocale?(): string;\n  isPackaged?: boolean;\n}\n\n/** The parts of Electron's `ipcMain` the helper uses. */\nexport interface IpcMainLike {\n  handle(channel: string, listener: (event: unknown, ...args: unknown[]) => unknown): void;\n  removeHandler?(channel: string): void;\n}\n\n/** Node's `process` fields read for the app info (overridable for tests). */\nexport interface ProcessLike {\n  platform: string;\n  arch: string;\n  versions: Record<string, string | undefined>;\n  getSystemVersion?: () => string;\n}\n\n/** Collects the app info Guidely reports: app name and version, OS, architecture and Electron/Chrome versions. */\nexport function appInfo(app: ElectronAppLike, proc: ProcessLike = process as unknown as ProcessLike, osRelease?: () => string): ElectronAppInfo {\n  const safe = <T>(fn: () => T): T | undefined => {\n    try {\n      return fn();\n    } catch {\n      return undefined;\n    }\n  };\n  const osVersion = safe(() => proc.getSystemVersion?.()) || safe(() => osRelease?.());\n  return {\n    appName: safe(() => app.getName()) ?? \"app\",\n    appVersion: safe(() => app.getVersion()) ?? \"0.0.0\",\n    platform: proc.platform,\n    arch: proc.arch,\n    ...(osVersion ? { osVersion } : {}),\n    ...(proc.versions.electron ? { electronVersion: proc.versions.electron } : {}),\n    ...(proc.versions.chrome ? { chromeVersion: proc.versions.chrome } : {}),\n    ...(proc.versions.node ? { nodeVersion: proc.versions.node } : {}),\n    ...(app.getLocale ? { locale: safe(() => app.getLocale!()) } : {}),\n    ...(typeof app.isPackaged === \"boolean\" ? { packaged: app.isPackaged } : {}),\n  };\n}\n\n/**\n * Main process: answers the preload bridge's app-info request. Call once after `app` is ready:\n *\n * ```ts\n * import { app, ipcMain } from \"electron\";\n * import { setupGuidelyMain } from \"@guidelytech/electron/main\";\n * app.whenReady().then(() => { setupGuidelyMain({ app, ipcMain }); createWindow(); });\n * ```\n *\n * Returns a function that removes the handler.\n */\nexport function setupGuidelyMain(opts: { app: ElectronAppLike & CrashAppLike; ipcMain: IpcMainLike; process?: ProcessLike; osRelease?: () => string; errors?: boolean | MainCrashOptions }): () => void {\n  const info = appInfo(opts.app, opts.process, opts.osRelease);\n  opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);\n  opts.ipcMain.handle(APP_INFO_CHANNEL, () => info);\n  // `errors`: main-process crash capture (see installGuidelyCrashHandlers), sent through the windows' clients.\n  const crashes = opts.errors ? installGuidelyCrashHandlers({ app: opts.app, ipcMain: opts.ipcMain, ...(typeof opts.errors === \"object\" ? opts.errors : {}) }) : null;\n  return () => {\n    opts.ipcMain.removeHandler?.(APP_INFO_CHANNEL);\n    crashes?.dispose();\n  };\n}\n"],"mappings":"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","names":["safe"]}

package/dist/preload.cjs

@@ -25,6 +25,8 @@ __export(preload_exports, {
 module.exports = __toCommonJS(preload_exports);
 
 // src/types.ts
+var MAIN_ERRORS_CHANNEL = "guidely:main-errors";
+var MAIN_ERRORS_READY_CHANNEL = "guidely:main-errors-ready";
 var APP_INFO_CHANNEL = "guidely:app-info";
 var BRIDGE_KEY = "guidelyElectron";
 
@@ -32,7 +34,14 @@ var BRIDGE_KEY = "guidelyElectron";
 function exposeGuidely(opts) {
   let cached = null;
   const bridge = {
-    getAppInfo: () => cached ?? (cached = opts.ipcRenderer.invoke(APP_INFO_CHANNEL))
+    getAppInfo: () => cached ?? (cached = opts.ipcRenderer.invoke(APP_INFO_CHANNEL)),
+    // Main-process errors (`setupGuidelyMain({ errors })`); an empty list when the main process does not collect them.
+    takeMainErrors: () => opts.ipcRenderer.invoke(MAIN_ERRORS_CHANNEL).then((v) => Array.isArray(v) ? v : [], () => []),
+    onMainErrors: (listener) => {
+      const l = () => listener();
+      opts.ipcRenderer.on?.(MAIN_ERRORS_READY_CHANNEL, l);
+      return () => void opts.ipcRenderer.removeListener?.(MAIN_ERRORS_READY_CHANNEL, l);
+    }
   };
   opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);
 }

package/dist/preload.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/preload.ts","../src/types.ts"],"sourcesContent":["import { APP_INFO_CHANNEL, BRIDGE_KEY, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport type { ElectronAppInfo, GuidelyElectronBridge } from \"./types\";\n\n/** The parts of Electron's `contextBridge` the helper uses. */\nexport interface ContextBridgeLike {\n  exposeInMainWorld(key: string, api: unknown): void;\n}\n\n/** The parts of Electron's `ipcRenderer` the helper uses. */\nexport interface IpcRendererLike {\n  invoke(channel: string, ...args: unknown[]): Promise<unknown>;\n}\n\n/**\n * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with\n * `contextIsolation: true`; the page gets a function, never `ipcRenderer` itself).\n *\n * ```ts\n * // preload.ts\n * import { contextBridge, ipcRenderer } from \"electron\";\n * import { exposeGuidely } from \"@guidelytech/electron/preload\";\n * exposeGuidely({ contextBridge, ipcRenderer });\n * ```\n *\n * Sandboxed preloads (Electron's default since 20) can't `require` npm packages: bundle the preload\n * (esbuild, Vite, webpack), or copy these few lines into it.\n */\nexport function exposeGuidely(opts: { contextBridge: ContextBridgeLike; ipcRenderer: IpcRendererLike }): void {\n  let cached: Promise<ElectronAppInfo> | null = null;\n  const bridge: GuidelyElectronBridge = {\n    getAppInfo: () => (cached ??= opts.ipcRenderer.invoke(APP_INFO_CHANNEL) as Promise<ElectronAppInfo>),\n  };\n  opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);\n}\n","/** What the main process knows about the desktop app, sent to the renderer over IPC. */\nexport interface ElectronAppInfo {\n  /** `app.getName()`. */\n  appName: string;\n  /** `app.getVersion()` (from package.json). */\n  appVersion: string;\n  /** `process.platform`: `darwin`, `win32`, `linux`. */\n  platform: string;\n  /** `process.arch`: `x64`, `arm64`, … */\n  arch: string;\n  /** `os.release()` / `process.getSystemVersion()`, when available. */\n  osVersion?: string;\n  electronVersion?: string;\n  chromeVersion?: string;\n  /** `app.getLocale()`. */\n  locale?: string;\n  /** `app.isPackaged`: false while running from source (`electron .`). */\n  packaged?: boolean;\n}\n\n/** The API the preload script exposes on `window.guidelyElectron`. */\nexport interface GuidelyElectronBridge {\n  getAppInfo(): Promise<ElectronAppInfo>;\n}\n\n/** IPC channel used between the main-process handler and the preload bridge. */\nexport const APP_INFO_CHANNEL = \"guidely:app-info\";\n/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */\nexport const BRIDGE_KEY = \"guidelyElectron\";\n\n/** Desktop operating system names used in Guidely device properties. */\nexport function osName(platform: string): string {\n  if (platform === \"darwin\") return \"macos\";\n  if (platform === \"win32\") return \"windows\";\n  if (platform === \"linux\") return \"linux\";\n  return platform;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC0BO,IAAM,mBAAmB;AAEzB,IAAM,aAAa;;;ADAnB,SAAS,cAAc,MAAgF;AAC5G,MAAI,SAA0C;AAC9C,QAAM,SAAgC;AAAA,IACpC,YAAY,MAAO,oBAAW,KAAK,YAAY,OAAO,gBAAgB;AAAA,EACxE;AACA,OAAK,cAAc,kBAAkB,YAAY,MAAM;AACzD;","names":[]}
+{"version":3,"sources":["../src/preload.ts","../src/types.ts"],"sourcesContent":["import { APP_INFO_CHANNEL, BRIDGE_KEY, MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL, type ElectronAppInfo, type GuidelyElectronBridge, type MainErrorEvent } from \"./types\";\n\nexport type { ElectronAppInfo, GuidelyElectronBridge, MainErrorEvent } from \"./types\";\n\n/** The parts of Electron's `contextBridge` the helper uses. */\nexport interface ContextBridgeLike {\n  exposeInMainWorld(key: string, api: unknown): void;\n}\n\n/** The parts of Electron's `ipcRenderer` the helper uses. */\nexport interface IpcRendererLike {\n  invoke(channel: string, ...args: unknown[]): Promise<unknown>;\n  /** Used to hear about new main-process errors (optional: without it windows take them when they load). */\n  on?(channel: string, listener: (...args: any[]) => void): unknown;\n  removeListener?(channel: string, listener: (...args: any[]) => void): unknown;\n}\n\n/**\n * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with\n * `contextIsolation: true`; the page gets a function, never `ipcRenderer` itself).\n *\n * ```ts\n * // preload.ts\n * import { contextBridge, ipcRenderer } from \"electron\";\n * import { exposeGuidely } from \"@guidelytech/electron/preload\";\n * exposeGuidely({ contextBridge, ipcRenderer });\n * ```\n *\n * Sandboxed preloads (Electron's default since 20) can't `require` npm packages: bundle the preload\n * (esbuild, Vite, webpack), or copy these few lines into it.\n */\nexport function exposeGuidely(opts: { contextBridge: ContextBridgeLike; ipcRenderer: IpcRendererLike }): void {\n  let cached: Promise<ElectronAppInfo> | null = null;\n  const bridge: GuidelyElectronBridge = {\n    getAppInfo: () => (cached ??= opts.ipcRenderer.invoke(APP_INFO_CHANNEL) as Promise<ElectronAppInfo>),\n    // Main-process errors (`setupGuidelyMain({ errors })`); an empty list when the main process does not collect them.\n    takeMainErrors: () => opts.ipcRenderer.invoke(MAIN_ERRORS_CHANNEL).then((v) => (Array.isArray(v) ? (v as MainErrorEvent[]) : []), () => []),\n    onMainErrors: (listener) => {\n      const l = () => listener();\n      opts.ipcRenderer.on?.(MAIN_ERRORS_READY_CHANNEL, l);\n      return () => void opts.ipcRenderer.removeListener?.(MAIN_ERRORS_READY_CHANNEL, l);\n    },\n  };\n  opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);\n}\n","/** What the main process knows about the desktop app, sent to the renderer over IPC. */\nexport interface ElectronAppInfo {\n  /** `app.getName()`. */\n  appName: string;\n  /** `app.getVersion()` (from package.json). */\n  appVersion: string;\n  /** `process.platform`: `darwin`, `win32`, `linux`. */\n  platform: string;\n  /** `process.arch`: `x64`, `arm64`, … */\n  arch: string;\n  /** `os.release()` / `process.getSystemVersion()`, when available. */\n  osVersion?: string;\n  electronVersion?: string;\n  chromeVersion?: string;\n  /** The main process's Node.js version. */\n  nodeVersion?: string;\n  /** `app.getLocale()`. */\n  locale?: string;\n  /** `app.isPackaged`: false while running from source (`electron .`). */\n  packaged?: boolean;\n}\n\n/** The API the preload script exposes on `window.guidelyElectron`. */\nexport interface GuidelyElectronBridge {\n  getAppInfo(): Promise<ElectronAppInfo>;\n  /** Main-process errors and crashes waiting to be sent (each is handed to one window only). */\n  takeMainErrors?(): Promise<MainErrorEvent[]>;\n  /** Called when the main process has new errors to take; returns an unsubscribe function. */\n  onMainErrors?(listener: () => void): () => void;\n}\n\n/** An error the main process caught (thrown, rejected, a process gone, a minidump), sent by a renderer's client. */\nexport interface MainErrorEvent {\n  id: string;\n  /** When it happened (ms since epoch); it may be sent much later, after a restart. */\n  timestamp: number;\n  type: string;\n  message: string;\n  stack?: string;\n  /** The error's `cause`, serialized the same way. */\n  cause?: Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\">;\n  level: \"fatal\" | \"error\";\n  /** `uncaughtException`, `unhandledRejection`, `render-process-gone`, `child-process-gone`, `minidump`, `generic`. */\n  mechanism: string;\n  handled: boolean;\n  contexts: Record<string, Record<string, unknown>>;\n  tags?: Record<string, string>;\n  fingerprint?: string[];\n}\n\n/** IPC channel the preload bridge takes main-process errors from. */\nexport const MAIN_ERRORS_CHANNEL = \"guidely:main-errors\";\n/** IPC message the main process sends windows when it has errors to take. */\nexport const MAIN_ERRORS_READY_CHANNEL = \"guidely:main-errors-ready\";\n\n/** IPC channel used between the main-process handler and the preload bridge. */\nexport const APP_INFO_CHANNEL = \"guidely:app-info\";\n/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */\nexport const BRIDGE_KEY = \"guidelyElectron\";\n\n/** Desktop operating system names used in Guidely device properties. */\nexport function osName(platform: string): string {\n  if (platform === \"darwin\") return \"macos\";\n  if (platform === \"win32\") return \"windows\";\n  if (platform === \"linux\") return \"linux\";\n  return platform;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmDO,IAAM,sBAAsB;AAE5B,IAAM,4BAA4B;AAGlC,IAAM,mBAAmB;AAEzB,IAAM,aAAa;;;AD3BnB,SAAS,cAAc,MAAgF;AAC5G,MAAI,SAA0C;AAC9C,QAAM,SAAgC;AAAA,IACpC,YAAY,MAAO,oBAAW,KAAK,YAAY,OAAO,gBAAgB;AAAA;AAAA,IAEtE,gBAAgB,MAAM,KAAK,YAAY,OAAO,mBAAmB,EAAE,KAAK,CAAC,MAAO,MAAM,QAAQ,CAAC,IAAK,IAAyB,CAAC,GAAI,MAAM,CAAC,CAAC;AAAA,IAC1I,cAAc,CAAC,aAAa;AAC1B,YAAM,IAAI,MAAM,SAAS;AACzB,WAAK,YAAY,KAAK,2BAA2B,CAAC;AAClD,aAAO,MAAM,KAAK,KAAK,YAAY,iBAAiB,2BAA2B,CAAC;AAAA,IAClF;AAAA,EACF;AACA,OAAK,cAAc,kBAAkB,YAAY,MAAM;AACzD;","names":[]}

package/dist/preload.d.cts

@@ -1,4 +1,4 @@
-export { E as ElectronAppInfo, G as GuidelyElectronBridge } from './types-BEnWCecg.cjs';
+export { E as ElectronAppInfo, G as GuidelyElectronBridge, b as MainErrorEvent } from './types-jhX9pTdK.cjs';
 
 /** The parts of Electron's `contextBridge` the helper uses. */
 interface ContextBridgeLike {
@@ -7,6 +7,9 @@ interface ContextBridgeLike {
 /** The parts of Electron's `ipcRenderer` the helper uses. */
 interface IpcRendererLike {
     invoke(channel: string, ...args: unknown[]): Promise<unknown>;
+    /** Used to hear about new main-process errors (optional: without it windows take them when they load). */
+    on?(channel: string, listener: (...args: any[]) => void): unknown;
+    removeListener?(channel: string, listener: (...args: any[]) => void): unknown;
 }
 /**
  * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with

package/dist/preload.d.ts

@@ -1,4 +1,4 @@
-export { E as ElectronAppInfo, G as GuidelyElectronBridge } from './types-BEnWCecg.js';
+export { E as ElectronAppInfo, G as GuidelyElectronBridge, b as MainErrorEvent } from './types-jhX9pTdK.js';
 
 /** The parts of Electron's `contextBridge` the helper uses. */
 interface ContextBridgeLike {
@@ -7,6 +7,9 @@ interface ContextBridgeLike {
 /** The parts of Electron's `ipcRenderer` the helper uses. */
 interface IpcRendererLike {
     invoke(channel: string, ...args: unknown[]): Promise<unknown>;
+    /** Used to hear about new main-process errors (optional: without it windows take them when they load). */
+    on?(channel: string, listener: (...args: any[]) => void): unknown;
+    removeListener?(channel: string, listener: (...args: any[]) => void): unknown;
 }
 /**
  * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with

package/dist/preload.js

@@ -1,13 +1,22 @@
 import {
   APP_INFO_CHANNEL,
-  BRIDGE_KEY
-} from "./chunk-AGZOVF3N.js";
+  BRIDGE_KEY,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL
+} from "./chunk-JP3V2XK5.js";
 
 // src/preload.ts
 function exposeGuidely(opts) {
   let cached = null;
   const bridge = {
-    getAppInfo: () => cached ?? (cached = opts.ipcRenderer.invoke(APP_INFO_CHANNEL))
+    getAppInfo: () => cached ?? (cached = opts.ipcRenderer.invoke(APP_INFO_CHANNEL)),
+    // Main-process errors (`setupGuidelyMain({ errors })`); an empty list when the main process does not collect them.
+    takeMainErrors: () => opts.ipcRenderer.invoke(MAIN_ERRORS_CHANNEL).then((v) => Array.isArray(v) ? v : [], () => []),
+    onMainErrors: (listener) => {
+      const l = () => listener();
+      opts.ipcRenderer.on?.(MAIN_ERRORS_READY_CHANNEL, l);
+      return () => void opts.ipcRenderer.removeListener?.(MAIN_ERRORS_READY_CHANNEL, l);
+    }
   };
   opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);
 }

package/dist/preload.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/preload.ts"],"sourcesContent":["import { APP_INFO_CHANNEL, BRIDGE_KEY, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport type { ElectronAppInfo, GuidelyElectronBridge } from \"./types\";\n\n/** The parts of Electron's `contextBridge` the helper uses. */\nexport interface ContextBridgeLike {\n  exposeInMainWorld(key: string, api: unknown): void;\n}\n\n/** The parts of Electron's `ipcRenderer` the helper uses. */\nexport interface IpcRendererLike {\n  invoke(channel: string, ...args: unknown[]): Promise<unknown>;\n}\n\n/**\n * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with\n * `contextIsolation: true`; the page gets a function, never `ipcRenderer` itself).\n *\n * ```ts\n * // preload.ts\n * import { contextBridge, ipcRenderer } from \"electron\";\n * import { exposeGuidely } from \"@guidelytech/electron/preload\";\n * exposeGuidely({ contextBridge, ipcRenderer });\n * ```\n *\n * Sandboxed preloads (Electron's default since 20) can't `require` npm packages: bundle the preload\n * (esbuild, Vite, webpack), or copy these few lines into it.\n */\nexport function exposeGuidely(opts: { contextBridge: ContextBridgeLike; ipcRenderer: IpcRendererLike }): void {\n  let cached: Promise<ElectronAppInfo> | null = null;\n  const bridge: GuidelyElectronBridge = {\n    getAppInfo: () => (cached ??= opts.ipcRenderer.invoke(APP_INFO_CHANNEL) as Promise<ElectronAppInfo>),\n  };\n  opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);\n}\n"],"mappings":";;;;;;AA4BO,SAAS,cAAc,MAAgF;AAC5G,MAAI,SAA0C;AAC9C,QAAM,SAAgC;AAAA,IACpC,YAAY,MAAO,oBAAW,KAAK,YAAY,OAAO,gBAAgB;AAAA,EACxE;AACA,OAAK,cAAc,kBAAkB,YAAY,MAAM;AACzD;","names":[]}
+{"version":3,"sources":["../src/preload.ts"],"sourcesContent":["import { APP_INFO_CHANNEL, BRIDGE_KEY, MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL, type ElectronAppInfo, type GuidelyElectronBridge, type MainErrorEvent } from \"./types\";\n\nexport type { ElectronAppInfo, GuidelyElectronBridge, MainErrorEvent } from \"./types\";\n\n/** The parts of Electron's `contextBridge` the helper uses. */\nexport interface ContextBridgeLike {\n  exposeInMainWorld(key: string, api: unknown): void;\n}\n\n/** The parts of Electron's `ipcRenderer` the helper uses. */\nexport interface IpcRendererLike {\n  invoke(channel: string, ...args: unknown[]): Promise<unknown>;\n  /** Used to hear about new main-process errors (optional: without it windows take them when they load). */\n  on?(channel: string, listener: (...args: any[]) => void): unknown;\n  removeListener?(channel: string, listener: (...args: any[]) => void): unknown;\n}\n\n/**\n * Preload script: exposes `window.guidelyElectron.getAppInfo()` to the page (works with\n * `contextIsolation: true`; the page gets a function, never `ipcRenderer` itself).\n *\n * ```ts\n * // preload.ts\n * import { contextBridge, ipcRenderer } from \"electron\";\n * import { exposeGuidely } from \"@guidelytech/electron/preload\";\n * exposeGuidely({ contextBridge, ipcRenderer });\n * ```\n *\n * Sandboxed preloads (Electron's default since 20) can't `require` npm packages: bundle the preload\n * (esbuild, Vite, webpack), or copy these few lines into it.\n */\nexport function exposeGuidely(opts: { contextBridge: ContextBridgeLike; ipcRenderer: IpcRendererLike }): void {\n  let cached: Promise<ElectronAppInfo> | null = null;\n  const bridge: GuidelyElectronBridge = {\n    getAppInfo: () => (cached ??= opts.ipcRenderer.invoke(APP_INFO_CHANNEL) as Promise<ElectronAppInfo>),\n    // Main-process errors (`setupGuidelyMain({ errors })`); an empty list when the main process does not collect them.\n    takeMainErrors: () => opts.ipcRenderer.invoke(MAIN_ERRORS_CHANNEL).then((v) => (Array.isArray(v) ? (v as MainErrorEvent[]) : []), () => []),\n    onMainErrors: (listener) => {\n      const l = () => listener();\n      opts.ipcRenderer.on?.(MAIN_ERRORS_READY_CHANNEL, l);\n      return () => void opts.ipcRenderer.removeListener?.(MAIN_ERRORS_READY_CHANNEL, l);\n    },\n  };\n  opts.contextBridge.exposeInMainWorld(BRIDGE_KEY, bridge);\n}\n"],"mappings":";;;;;;;;AA+BO,SAAS,cAAc,MAAgF;AAC5G,MAAI,SAA0C;AAC9C,QAAM,SAAgC;AAAA,IACpC,YAAY,MAAO,oBAAW,KAAK,YAAY,OAAO,gBAAgB;AAAA;AAAA,IAEtE,gBAAgB,MAAM,KAAK,YAAY,OAAO,mBAAmB,EAAE,KAAK,CAAC,MAAO,MAAM,QAAQ,CAAC,IAAK,IAAyB,CAAC,GAAI,MAAM,CAAC,CAAC;AAAA,IAC1I,cAAc,CAAC,aAAa;AAC1B,YAAM,IAAI,MAAM,SAAS;AACzB,WAAK,YAAY,KAAK,2BAA2B,CAAC;AAClD,aAAO,MAAM,KAAK,KAAK,YAAY,iBAAiB,2BAA2B,CAAC;AAAA,IAClF;AAAA,EACF;AACA,OAAK,cAAc,kBAAkB,YAAY,MAAM;AACzD;","names":[]}

package/dist/types-jhX9pTdK.d.cts

@@ -0,0 +1,59 @@
+/** What the main process knows about the desktop app, sent to the renderer over IPC. */
+interface ElectronAppInfo {
+    /** `app.getName()`. */
+    appName: string;
+    /** `app.getVersion()` (from package.json). */
+    appVersion: string;
+    /** `process.platform`: `darwin`, `win32`, `linux`. */
+    platform: string;
+    /** `process.arch`: `x64`, `arm64`, … */
+    arch: string;
+    /** `os.release()` / `process.getSystemVersion()`, when available. */
+    osVersion?: string;
+    electronVersion?: string;
+    chromeVersion?: string;
+    /** The main process's Node.js version. */
+    nodeVersion?: string;
+    /** `app.getLocale()`. */
+    locale?: string;
+    /** `app.isPackaged`: false while running from source (`electron .`). */
+    packaged?: boolean;
+}
+/** The API the preload script exposes on `window.guidelyElectron`. */
+interface GuidelyElectronBridge {
+    getAppInfo(): Promise<ElectronAppInfo>;
+    /** Main-process errors and crashes waiting to be sent (each is handed to one window only). */
+    takeMainErrors?(): Promise<MainErrorEvent[]>;
+    /** Called when the main process has new errors to take; returns an unsubscribe function. */
+    onMainErrors?(listener: () => void): () => void;
+}
+/** An error the main process caught (thrown, rejected, a process gone, a minidump), sent by a renderer's client. */
+interface MainErrorEvent {
+    id: string;
+    /** When it happened (ms since epoch); it may be sent much later, after a restart. */
+    timestamp: number;
+    type: string;
+    message: string;
+    stack?: string;
+    /** The error's `cause`, serialized the same way. */
+    cause?: Pick<MainErrorEvent, "type" | "message" | "stack" | "cause">;
+    level: "fatal" | "error";
+    /** `uncaughtException`, `unhandledRejection`, `render-process-gone`, `child-process-gone`, `minidump`, `generic`. */
+    mechanism: string;
+    handled: boolean;
+    contexts: Record<string, Record<string, unknown>>;
+    tags?: Record<string, string>;
+    fingerprint?: string[];
+}
+/** IPC channel the preload bridge takes main-process errors from. */
+declare const MAIN_ERRORS_CHANNEL = "guidely:main-errors";
+/** IPC message the main process sends windows when it has errors to take. */
+declare const MAIN_ERRORS_READY_CHANNEL = "guidely:main-errors-ready";
+/** IPC channel used between the main-process handler and the preload bridge. */
+declare const APP_INFO_CHANNEL = "guidely:app-info";
+/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */
+declare const BRIDGE_KEY = "guidelyElectron";
+/** Desktop operating system names used in Guidely device properties. */
+declare function osName(platform: string): string;
+
+export { APP_INFO_CHANNEL as A, BRIDGE_KEY as B, type ElectronAppInfo as E, type GuidelyElectronBridge as G, MAIN_ERRORS_CHANNEL as M, MAIN_ERRORS_READY_CHANNEL as a, type MainErrorEvent as b, osName as o };

package/dist/types-jhX9pTdK.d.ts

@@ -0,0 +1,59 @@
+/** What the main process knows about the desktop app, sent to the renderer over IPC. */
+interface ElectronAppInfo {
+    /** `app.getName()`. */
+    appName: string;
+    /** `app.getVersion()` (from package.json). */
+    appVersion: string;
+    /** `process.platform`: `darwin`, `win32`, `linux`. */
+    platform: string;
+    /** `process.arch`: `x64`, `arm64`, … */
+    arch: string;
+    /** `os.release()` / `process.getSystemVersion()`, when available. */
+    osVersion?: string;
+    electronVersion?: string;
+    chromeVersion?: string;
+    /** The main process's Node.js version. */
+    nodeVersion?: string;
+    /** `app.getLocale()`. */
+    locale?: string;
+    /** `app.isPackaged`: false while running from source (`electron .`). */
+    packaged?: boolean;
+}
+/** The API the preload script exposes on `window.guidelyElectron`. */
+interface GuidelyElectronBridge {
+    getAppInfo(): Promise<ElectronAppInfo>;
+    /** Main-process errors and crashes waiting to be sent (each is handed to one window only). */
+    takeMainErrors?(): Promise<MainErrorEvent[]>;
+    /** Called when the main process has new errors to take; returns an unsubscribe function. */
+    onMainErrors?(listener: () => void): () => void;
+}
+/** An error the main process caught (thrown, rejected, a process gone, a minidump), sent by a renderer's client. */
+interface MainErrorEvent {
+    id: string;
+    /** When it happened (ms since epoch); it may be sent much later, after a restart. */
+    timestamp: number;
+    type: string;
+    message: string;
+    stack?: string;
+    /** The error's `cause`, serialized the same way. */
+    cause?: Pick<MainErrorEvent, "type" | "message" | "stack" | "cause">;
+    level: "fatal" | "error";
+    /** `uncaughtException`, `unhandledRejection`, `render-process-gone`, `child-process-gone`, `minidump`, `generic`. */
+    mechanism: string;
+    handled: boolean;
+    contexts: Record<string, Record<string, unknown>>;
+    tags?: Record<string, string>;
+    fingerprint?: string[];
+}
+/** IPC channel the preload bridge takes main-process errors from. */
+declare const MAIN_ERRORS_CHANNEL = "guidely:main-errors";
+/** IPC message the main process sends windows when it has errors to take. */
+declare const MAIN_ERRORS_READY_CHANNEL = "guidely:main-errors-ready";
+/** IPC channel used between the main-process handler and the preload bridge. */
+declare const APP_INFO_CHANNEL = "guidely:app-info";
+/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */
+declare const BRIDGE_KEY = "guidelyElectron";
+/** Desktop operating system names used in Guidely device properties. */
+declare function osName(platform: string): string;
+
+export { APP_INFO_CHANNEL as A, BRIDGE_KEY as B, type ElectronAppInfo as E, type GuidelyElectronBridge as G, MAIN_ERRORS_CHANNEL as M, MAIN_ERRORS_READY_CHANNEL as a, type MainErrorEvent as b, osName as o };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guidelytech/electron",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Guidely for Electron apps: page paths for file:// and custom protocols, app version and OS metadata, preload bridge",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@guidelytech/sdk-core": "0.15.0"
+    "@guidelytech/sdk-core": "0.17.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
@@ -39,8 +39,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.46.0",
-    "vitest": "^3.2.7",
-    "happy-dom": "^17.6.3"
+    "vitest": "^4.1.12",
+    "happy-dom": "^21.0.4"
   },
   "publishConfig": {
     "access": "public"

package/dist/chunk-AGZOVF3N.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/** What the main process knows about the desktop app, sent to the renderer over IPC. */\nexport interface ElectronAppInfo {\n  /** `app.getName()`. */\n  appName: string;\n  /** `app.getVersion()` (from package.json). */\n  appVersion: string;\n  /** `process.platform`: `darwin`, `win32`, `linux`. */\n  platform: string;\n  /** `process.arch`: `x64`, `arm64`, … */\n  arch: string;\n  /** `os.release()` / `process.getSystemVersion()`, when available. */\n  osVersion?: string;\n  electronVersion?: string;\n  chromeVersion?: string;\n  /** `app.getLocale()`. */\n  locale?: string;\n  /** `app.isPackaged`: false while running from source (`electron .`). */\n  packaged?: boolean;\n}\n\n/** The API the preload script exposes on `window.guidelyElectron`. */\nexport interface GuidelyElectronBridge {\n  getAppInfo(): Promise<ElectronAppInfo>;\n}\n\n/** IPC channel used between the main-process handler and the preload bridge. */\nexport const APP_INFO_CHANNEL = \"guidely:app-info\";\n/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */\nexport const BRIDGE_KEY = \"guidelyElectron\";\n\n/** Desktop operating system names used in Guidely device properties. */\nexport function osName(platform: string): string {\n  if (platform === \"darwin\") return \"macos\";\n  if (platform === \"win32\") return \"windows\";\n  if (platform === \"linux\") return \"linux\";\n  return platform;\n}\n"],"mappings":";AA0BO,IAAM,mBAAmB;AAEzB,IAAM,aAAa;AAGnB,SAAS,OAAO,UAA0B;AAC/C,MAAI,aAAa,SAAU,QAAO;AAClC,MAAI,aAAa,QAAS,QAAO;AACjC,MAAI,aAAa,QAAS,QAAO;AACjC,SAAO;AACT;","names":[]}

package/dist/types-BEnWCecg.d.cts

@@ -1,31 +0,0 @@
-/** What the main process knows about the desktop app, sent to the renderer over IPC. */
-interface ElectronAppInfo {
-    /** `app.getName()`. */
-    appName: string;
-    /** `app.getVersion()` (from package.json). */
-    appVersion: string;
-    /** `process.platform`: `darwin`, `win32`, `linux`. */
-    platform: string;
-    /** `process.arch`: `x64`, `arm64`, … */
-    arch: string;
-    /** `os.release()` / `process.getSystemVersion()`, when available. */
-    osVersion?: string;
-    electronVersion?: string;
-    chromeVersion?: string;
-    /** `app.getLocale()`. */
-    locale?: string;
-    /** `app.isPackaged`: false while running from source (`electron .`). */
-    packaged?: boolean;
-}
-/** The API the preload script exposes on `window.guidelyElectron`. */
-interface GuidelyElectronBridge {
-    getAppInfo(): Promise<ElectronAppInfo>;
-}
-/** IPC channel used between the main-process handler and the preload bridge. */
-declare const APP_INFO_CHANNEL = "guidely:app-info";
-/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */
-declare const BRIDGE_KEY = "guidelyElectron";
-/** Desktop operating system names used in Guidely device properties. */
-declare function osName(platform: string): string;
-
-export { APP_INFO_CHANNEL as A, BRIDGE_KEY as B, type ElectronAppInfo as E, type GuidelyElectronBridge as G, osName as o };

package/dist/types-BEnWCecg.d.ts

@@ -1,31 +0,0 @@
-/** What the main process knows about the desktop app, sent to the renderer over IPC. */
-interface ElectronAppInfo {
-    /** `app.getName()`. */
-    appName: string;
-    /** `app.getVersion()` (from package.json). */
-    appVersion: string;
-    /** `process.platform`: `darwin`, `win32`, `linux`. */
-    platform: string;
-    /** `process.arch`: `x64`, `arm64`, … */
-    arch: string;
-    /** `os.release()` / `process.getSystemVersion()`, when available. */
-    osVersion?: string;
-    electronVersion?: string;
-    chromeVersion?: string;
-    /** `app.getLocale()`. */
-    locale?: string;
-    /** `app.isPackaged`: false while running from source (`electron .`). */
-    packaged?: boolean;
-}
-/** The API the preload script exposes on `window.guidelyElectron`. */
-interface GuidelyElectronBridge {
-    getAppInfo(): Promise<ElectronAppInfo>;
-}
-/** IPC channel used between the main-process handler and the preload bridge. */
-declare const APP_INFO_CHANNEL = "guidely:app-info";
-/** Global the preload bridge is exposed as (`contextBridge.exposeInMainWorld`). */
-declare const BRIDGE_KEY = "guidelyElectron";
-/** Desktop operating system names used in Guidely device properties. */
-declare function osName(platform: string): string;
-
-export { APP_INFO_CHANNEL as A, BRIDGE_KEY as B, type ElectronAppInfo as E, type GuidelyElectronBridge as G, osName as o };