@guidelytech/electron 0.16.0 → 0.17.0

package/README.md

@@ -42,7 +42,12 @@ Sandboxed preloads (the default since Electron 20) can't `require` npm packages:
 (esbuild, Vite, webpack) or inline the equivalent:
 
 ```ts
-contextBridge.exposeInMainWorld("guidelyElectron", { getAppInfo: () => ipcRenderer.invoke("guidely:app-info") });
+contextBridge.exposeInMainWorld("guidelyElectron", {
+  getAppInfo: () => ipcRenderer.invoke("guidely:app-info"),
+  // Only with main-process crash capture (see "Crashes and errors"):
+  takeMainErrors: () => ipcRenderer.invoke("guidely:main-errors").catch(() => []),
+  onMainErrors: (cb) => { const l = () => cb(); ipcRenderer.on("guidely:main-errors-ready", l); return () => ipcRenderer.removeListener("guidely:main-errors-ready", l); },
+});
 ```
 
 ## 3. Renderer
@@ -72,9 +77,46 @@ const info = await getElectronAppInfo();
 | `getElectronAppInfo(timeoutMs = 1000)` | renderer | `{ appName, appVersion, platform, arch, osVersion, electronVersion, chromeVersion, locale, packaged }` or `null` |
 | `electronOptions(info)` | renderer | `{ pageUrl: normalizeAppUrl, appVersion, release }` |
 | `desktopTraits(info)` | renderer | `{ appVersion, desktopOs, desktopOsVersion, desktopArch, electronVersion }` |
-| `createGuidelyElectron(options)` | renderer | `createGuidely` with all of the above |
+| `createGuidelyElectron(options)` | renderer | `createGuidely` with all of the above, Electron error contexts and main-process errors forwarded |
+| `installGuidelyCrashHandlers({ app, ipcMain, … })` / `setupGuidelyMain({ errors })` | main | Main-process crash capture (below) |
+| `forwardMainErrors(client)`, `setElectronErrorContexts(client, info)` | renderer | What `createGuidelyElectron` does, for clients made another way |
 | `normalizeAppUrl(href)` | anywhere | The URL mapping (also exported by `@guidelytech/sdk-core`) |
 
+## Crashes and errors
+
+In the renderer the web SDK reports uncaught errors and rejections as in a browser (options under
+`errors`, `captureException`, breadcrumbs, React/Svelte error boundaries). `createGuidelyElectron`
+adds the `electron` (`version`, `chrome`, `node`), `os` (the real OS version, not the user agent's
+frozen one) and `app` (`app_name`, `app_version`) contexts to every error.
+
+The main process has no Guidely client. With `errors`, it records its own crashes in
+`<userData>/guidely-main-errors.json` and a window's client sends them (each one once, the next
+time a window loads, or right away when you pass `webContents`):
+
+```ts
+import { app, crashReporter, ipcMain, webContents } from "electron";
+import { installGuidelyCrashHandlers } from "@guidelytech/electron/main";
+
+// First thing in main.ts, so startup errors are kept (or setupGuidelyMain({ app, ipcMain, errors: { … } })).
+const guidelyMain = installGuidelyCrashHandlers({ app, ipcMain, webContents, nativeCrashes: { crashReporter } });
+guidelyMain.captureException(err, { tags: { area: "updater" } }); // main-process code's own errors
+```
+
+| What | `mechanism` | `level` |
+|---|---|---|
+| Uncaught exception (seen through `uncaughtExceptionMonitor`, so Electron's error dialog still shows) | `uncaughtException` | `fatal` |
+| Unhandled rejection (logged, as Node's `warn` mode does) | `unhandledRejection` | `error` |
+| `render-process-gone` (`contexts.electron`: `reason`, `exitCode`, `processType: "renderer"`) | `render-process-gone` | `fatal` for `crashed`, `oom`, `killed`; else `error` |
+| `child-process-gone` (GPU, utility, … `processType` is the process type) | `child-process-gone` | as above |
+| A new Crashpad minidump at the next start (`nativeCrashes`) | `minidump` | `fatal` |
+
+`exitOnUncaught: true` logs an uncaught exception and exits with code 1, as plain Node does
+(Electron's default is to show a dialog and keep running). `processHandlers: false` and
+`processGone: false` turn those parts off. `nativeCrashes: { crashReporter }` starts Electron's
+crash reporter with `uploadToServer: false` (pass `true` if you start it yourself); the minidump's
+file name is reported, the dump itself is not uploaded or symbolicated yet. Events are sent through
+the renderer's client, so the renderer's consent and error-tracking settings apply.
+
 ## Page URLs
 
 The SDK maps every non-http(s) URL (`file:`, custom protocols) with `normalizeAppUrl`, even without

package/dist/{chunk-AGZOVF3N.js → chunk-JP3V2XK5.js}

@@ -1,4 +1,6 @@
 // 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";
 function osName(platform) {
@@ -9,8 +11,10 @@ function osName(platform) {
 }
 
 export {
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL,
   APP_INFO_CHANNEL,
   BRIDGE_KEY,
   osName
 };
-//# sourceMappingURL=chunk-AGZOVF3N.js.map
+//# sourceMappingURL=chunk-JP3V2XK5.js.map

package/dist/chunk-JP3V2XK5.js.map

@@ -0,0 +1 @@
+{"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  /** 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":";AAmDO,IAAM,sBAAsB;AAE5B,IAAM,4BAA4B;AAGlC,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/index.cjs

@@ -22,17 +22,24 @@ var index_exports = {};
 __export(index_exports, {
   APP_INFO_CHANNEL: () => APP_INFO_CHANNEL,
   BRIDGE_KEY: () => BRIDGE_KEY,
+  MAIN_ERRORS_CHANNEL: () => MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL: () => MAIN_ERRORS_READY_CHANNEL,
   createGuidelyElectron: () => createGuidelyElectron,
   desktopTraits: () => desktopTraits,
+  electronErrorContexts: () => electronErrorContexts,
   electronOptions: () => electronOptions,
+  forwardMainErrors: () => forwardMainErrors,
   getElectronAppInfo: () => getElectronAppInfo,
   normalizeAppUrl: () => import_sdk_core2.normalizeAppUrl,
-  osName: () => osName
+  osName: () => osName,
+  setElectronErrorContexts: () => setElectronErrorContexts
 });
 module.exports = __toCommonJS(index_exports);
 var import_sdk_core = require("@guidelytech/sdk-core");
 
 // 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";
 function osName(platform) {
@@ -42,15 +49,87 @@ function osName(platform) {
   return platform;
 }
 
+// src/renderer-errors.ts
+var OS_NAMES = { darwin: "macOS", win32: "Windows", linux: "Linux" };
+function electronErrorContexts(info) {
+  if (!info) return {};
+  return {
+    electron: { ...info.electronVersion ? { version: info.electronVersion } : {}, ...info.chromeVersion ? { chrome: info.chromeVersion } : {}, ...info.nodeVersion ? { node: info.nodeVersion } : {}, processType: "renderer" },
+    os: { name: OS_NAMES[info.platform] ?? info.platform, ...info.osVersion ? { version: info.osVersion } : {} },
+    app: { app_name: info.appName, app_version: info.appVersion }
+  };
+}
+function setElectronErrorContexts(client, info) {
+  try {
+    for (const [name, context] of Object.entries(electronErrorContexts(info))) client.setContext(name, context);
+  } catch {
+  }
+}
+function toError(data) {
+  const error = new Error(data.message);
+  error.name = data.type;
+  error.stack = data.stack ?? `${data.type}: ${data.message}`;
+  if (data.cause) error.cause = toError(data.cause);
+  return error;
+}
+var bridge = () => {
+  const b = globalThis[BRIDGE_KEY];
+  return b && typeof b.takeMainErrors === "function" ? b : null;
+};
+function forwardMainErrors(client, from = bridge()) {
+  if (!from?.takeMainErrors) return () => {
+  };
+  let busy = false;
+  let again = false;
+  const take = async () => {
+    if (busy) {
+      again = true;
+      return;
+    }
+    busy = true;
+    try {
+      if (client.getState().destroyed) return;
+      for (const e of await from.takeMainErrors() ?? []) {
+        try {
+          client.captureException(toError(e), {
+            level: e.level,
+            mechanism: { type: e.mechanism, handled: e.handled },
+            contexts: e.contexts,
+            tags: { process: "main", ...e.tags ?? {} },
+            ...e.fingerprint?.length ? { fingerprint: e.fingerprint } : {},
+            extra: { occurredAt: new Date(e.timestamp).toISOString() }
+          });
+        } catch {
+        }
+      }
+    } catch {
+    } finally {
+      busy = false;
+      if (again) {
+        again = false;
+        void take();
+      }
+    }
+  };
+  void take();
+  let off = () => {
+  };
+  try {
+    off = from.onMainErrors?.(() => void take()) ?? off;
+  } catch {
+  }
+  return off;
+}
+
 // src/index.ts
 var import_sdk_core2 = require("@guidelytech/sdk-core");
-var bridge = () => {
+var bridge2 = () => {
   const g = globalThis;
   const b = g[BRIDGE_KEY];
   return b && typeof b.getAppInfo === "function" ? b : null;
 };
 async function getElectronAppInfo(timeoutMs = 1e3) {
-  const b = bridge();
+  const b = bridge2();
   if (!b) return null;
   let timer;
   try {
@@ -81,17 +160,25 @@ async function createGuidelyElectron(options) {
   const { bridgeTimeoutMs, ...rest } = options;
   const info = await getElectronAppInfo(bridgeTimeoutMs);
   const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...rest.user.traits ?? {} } } : void 0;
-  return (0, import_sdk_core.createGuidely)({ ...electronOptions(info), ...rest, ...user ? { user } : {} });
+  const client = (0, import_sdk_core.createGuidely)({ ...electronOptions(info), ...rest, ...user ? { user } : {} });
+  setElectronErrorContexts(client, info);
+  forwardMainErrors(client);
+  return client;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APP_INFO_CHANNEL,
   BRIDGE_KEY,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL,
   createGuidelyElectron,
   desktopTraits,
+  electronErrorContexts,
   electronOptions,
+  forwardMainErrors,
   getElectronAppInfo,
   normalizeAppUrl,
-  osName
+  osName,
+  setElectronErrorContexts
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types.ts"],"sourcesContent":["import { createGuidely, normalizeAppUrl, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { BRIDGE_KEY, osName, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport { APP_INFO_CHANNEL, BRIDGE_KEY, osName } from \"./types\";\nexport type { ElectronAppInfo, GuidelyElectronBridge } from \"./types\";\nexport { normalizeAppUrl } from \"@guidelytech/sdk-core\";\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const g = globalThis as unknown as Record<string, unknown>;\n  const b = g[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.getAppInfo === \"function\" ? b : null;\n};\n\n/**\n * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,\n * preload not installed) or does not answer within `timeoutMs`.\n */\nexport async function getElectronAppInfo(timeoutMs = 1000): Promise<ElectronAppInfo | null> {\n  const b = bridge();\n  if (!b) return null;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      b.getAppInfo().then((info) => (info && typeof info === \"object\" && typeof info.appVersion === \"string\" ? info : null)),\n      new Promise<null>((resolve) => (timer = setTimeout(() => resolve(null), timeoutMs))),\n    ]);\n  } catch {\n    return null;\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * SDK options for a desktop app: app-relative page URLs for `file:` and custom protocols, the app\n * version for **App version** targeting rules and flag attributes, and the release for source-mapped\n * errors. Spread your own options after it to override.\n */\nexport function electronOptions(info: ElectronAppInfo | null): Pick<GuidelyOptions, \"pageUrl\" | \"appVersion\" | \"release\"> {\n  return {\n    pageUrl: normalizeAppUrl,\n    ...(info?.appVersion ? { appVersion: info.appVersion, release: info.appVersion } : {}),\n  };\n}\n\n/**\n * Desktop details as user traits (`desktopOs`, `desktopOsVersion`, `desktopArch`, `electronVersion`,\n * `appVersion`), for `identify(userId, { ...traits, ...desktopTraits(info) })` so targeting rules,\n * audiences and the Users list can use them.\n */\nexport function desktopTraits(info: ElectronAppInfo | null): Record<string, string> {\n  if (!info) return {};\n  const out: Record<string, string> = { appVersion: info.appVersion, desktopOs: osName(info.platform), desktopArch: info.arch };\n  if (info.osVersion) out.desktopOsVersion = info.osVersion;\n  if (info.electronVersion) out.electronVersion = info.electronVersion;\n  return out;\n}\n\n/**\n * Renderer: creates the Guidely client for an Electron window, after reading the app info from the\n * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with\n * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.\n *\n * ```ts\n * import { createGuidelyElectron } from \"@guidelytech/electron\";\n * const guidely = await createGuidelyElectron({ projectId: \"pk_prod_…\", user: { id: me.id, traits: { plan: me.plan } } });\n * ```\n */\nexport async function createGuidelyElectron(options: GuidelyOptions & { bridgeTimeoutMs?: number }): Promise<GuidelyClient> {\n  const { bridgeTimeoutMs, ...rest } = options;\n  const info = await getElectronAppInfo(bridgeTimeoutMs);\n  const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...(rest.user.traits ?? {}) } } : undefined;\n  return createGuidely({ ...electronOptions(info), ...rest, ...(user ? { user } : {}) });\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAwF;;;AC0BjF,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;;;AD/BA,IAAAA,mBAAgC;AAEhC,IAAM,SAAS,MAAoC;AACjD,QAAM,IAAI;AACV,QAAM,IAAI,EAAE,UAAU;AACtB,SAAO,KAAK,OAAO,EAAE,eAAe,aAAa,IAAI;AACvD;AAMA,eAAsB,mBAAmB,YAAY,KAAuC;AAC1F,QAAM,IAAI,OAAO;AACjB,MAAI,CAAC,EAAG,QAAO;AACf,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,QAAQ,KAAK;AAAA,MACxB,EAAE,WAAW,EAAE,KAAK,CAAC,SAAU,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,eAAe,WAAW,OAAO,IAAK;AAAA,MACrH,IAAI,QAAc,CAAC,YAAa,QAAQ,WAAW,MAAM,QAAQ,IAAI,GAAG,SAAS,CAAE;AAAA,IACrF,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT,UAAE;AACA,QAAI,MAAO,cAAa,KAAK;AAAA,EAC/B;AACF;AAOO,SAAS,gBAAgB,MAA0F;AACxH,SAAO;AAAA,IACL,SAAS;AAAA,IACT,GAAI,MAAM,aAAa,EAAE,YAAY,KAAK,YAAY,SAAS,KAAK,WAAW,IAAI,CAAC;AAAA,EACtF;AACF;AAOO,SAAS,cAAc,MAAsD;AAClF,MAAI,CAAC,KAAM,QAAO,CAAC;AACnB,QAAM,MAA8B,EAAE,YAAY,KAAK,YAAY,WAAW,OAAO,KAAK,QAAQ,GAAG,aAAa,KAAK,KAAK;AAC5H,MAAI,KAAK,UAAW,KAAI,mBAAmB,KAAK;AAChD,MAAI,KAAK,gBAAiB,KAAI,kBAAkB,KAAK;AACrD,SAAO;AACT;AAYA,eAAsB,sBAAsB,SAAgF;AAC1H,QAAM,EAAE,iBAAiB,GAAG,KAAK,IAAI;AACrC,QAAM,OAAO,MAAM,mBAAmB,eAAe;AACrD,QAAM,OAAO,KAAK,OAAO,EAAE,GAAG,KAAK,MAAM,QAAQ,EAAE,GAAG,cAAc,IAAI,GAAG,GAAI,KAAK,KAAK,UAAU,CAAC,EAAG,EAAE,IAAI;AAC7G,aAAO,+BAAc,EAAE,GAAG,gBAAgB,IAAI,GAAG,GAAG,MAAM,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,EAAG,CAAC;AACvF;","names":["import_sdk_core"]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/renderer-errors.ts"],"sourcesContent":["import { createGuidely, normalizeAppUrl, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { forwardMainErrors, setElectronErrorContexts } from \"./renderer-errors\";\nimport { BRIDGE_KEY, osName, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport { APP_INFO_CHANNEL, BRIDGE_KEY, MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL, osName } from \"./types\";\nexport type { ElectronAppInfo, GuidelyElectronBridge, MainErrorEvent } from \"./types\";\nexport { electronErrorContexts, forwardMainErrors, setElectronErrorContexts } from \"./renderer-errors\";\nexport { normalizeAppUrl } from \"@guidelytech/sdk-core\";\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const g = globalThis as unknown as Record<string, unknown>;\n  const b = g[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.getAppInfo === \"function\" ? b : null;\n};\n\n/**\n * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,\n * preload not installed) or does not answer within `timeoutMs`.\n */\nexport async function getElectronAppInfo(timeoutMs = 1000): Promise<ElectronAppInfo | null> {\n  const b = bridge();\n  if (!b) return null;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      b.getAppInfo().then((info) => (info && typeof info === \"object\" && typeof info.appVersion === \"string\" ? info : null)),\n      new Promise<null>((resolve) => (timer = setTimeout(() => resolve(null), timeoutMs))),\n    ]);\n  } catch {\n    return null;\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * SDK options for a desktop app: app-relative page URLs for `file:` and custom protocols, the app\n * version for **App version** targeting rules and flag attributes, and the release for source-mapped\n * errors. Spread your own options after it to override.\n */\nexport function electronOptions(info: ElectronAppInfo | null): Pick<GuidelyOptions, \"pageUrl\" | \"appVersion\" | \"release\"> {\n  return {\n    pageUrl: normalizeAppUrl,\n    ...(info?.appVersion ? { appVersion: info.appVersion, release: info.appVersion } : {}),\n  };\n}\n\n/**\n * Desktop details as user traits (`desktopOs`, `desktopOsVersion`, `desktopArch`, `electronVersion`,\n * `appVersion`), for `identify(userId, { ...traits, ...desktopTraits(info) })` so targeting rules,\n * audiences and the Users list can use them.\n */\nexport function desktopTraits(info: ElectronAppInfo | null): Record<string, string> {\n  if (!info) return {};\n  const out: Record<string, string> = { appVersion: info.appVersion, desktopOs: osName(info.platform), desktopArch: info.arch };\n  if (info.osVersion) out.desktopOsVersion = info.osVersion;\n  if (info.electronVersion) out.electronVersion = info.electronVersion;\n  return out;\n}\n\n/**\n * Renderer: creates the Guidely client for an Electron window, after reading the app info from the\n * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with\n * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.\n * Errors carry the `electron`, `os` and `app` contexts, and the main process's errors and crashes\n * (`setupGuidelyMain({ errors })`) are sent through this client. `errors` options pass through.\n *\n * ```ts\n * import { createGuidelyElectron } from \"@guidelytech/electron\";\n * const guidely = await createGuidelyElectron({ projectId: \"pk_prod_…\", user: { id: me.id, traits: { plan: me.plan } } });\n * ```\n */\nexport async function createGuidelyElectron(options: GuidelyOptions & { bridgeTimeoutMs?: number }): Promise<GuidelyClient> {\n  const { bridgeTimeoutMs, ...rest } = options;\n  const info = await getElectronAppInfo(bridgeTimeoutMs);\n  const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...(rest.user.traits ?? {}) } } : undefined;\n  const client = createGuidely({ ...electronOptions(info), ...rest, ...(user ? { user } : {}) });\n  setElectronErrorContexts(client, info);\n  forwardMainErrors(client);\n  return client;\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","import type { GuidelyClient } from \"@guidelytech/sdk-core\";\nimport { BRIDGE_KEY, type ElectronAppInfo, type GuidelyElectronBridge, type MainErrorEvent } from \"./types\";\n\n/**\n * Renderer side of Electron error monitoring: Electron contexts on every error the window's client\n * reports, and the main process's errors and crashes, sent by this window's client. Kept out of\n * index.ts so the renderer entry only wires it in.\n */\n\nconst OS_NAMES: Record<string, string> = { darwin: \"macOS\", win32: \"Windows\", linux: \"Linux\" };\n\n/** `electron`, `os` and `app` contexts (Sentry's names) from the app info. */\nexport function electronErrorContexts(info: ElectronAppInfo | null): Record<string, Record<string, unknown>> {\n  if (!info) return {};\n  return {\n    electron: { ...(info.electronVersion ? { version: info.electronVersion } : {}), ...(info.chromeVersion ? { chrome: info.chromeVersion } : {}), ...(info.nodeVersion ? { node: info.nodeVersion } : {}), processType: \"renderer\" },\n    os: { name: OS_NAMES[info.platform] ?? info.platform, ...(info.osVersion ? { version: info.osVersion } : {}) },\n    app: { app_name: info.appName, app_version: info.appVersion },\n  };\n}\n\n/** Puts the Electron contexts on every later error of `client` (the user agent's frozen OS version is replaced by the real one). */\nexport function setElectronErrorContexts(client: GuidelyClient, info: ElectronAppInfo | null): void {\n  try {\n    for (const [name, context] of Object.entries(electronErrorContexts(info))) client.setContext(name, context);\n  } catch {\n    // an older client without setContext\n  }\n}\n\n/** A main-process error back as an `Error`, its main-process stack (or none) kept as is. */\nfunction toError(data: Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\">): Error {\n  const error = new Error(data.message);\n  error.name = data.type;\n  // Never the renderer's own stack: crashes without frames stay without frames.\n  error.stack = data.stack ?? `${data.type}: ${data.message}`;\n  if (data.cause) (error as Error & { cause?: unknown }).cause = toError(data.cause);\n  return error;\n}\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const b = (globalThis as unknown as Record<string, unknown>)[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.takeMainErrors === \"function\" ? b : null;\n};\n\n/**\n * Sends the main process's waiting errors (`setupGuidelyMain({ errors })`) through `client` now and\n * whenever the main process has new ones. `createGuidelyElectron` calls it; call it yourself when\n * you create the client another way. Returns a function that stops listening.\n */\nexport function forwardMainErrors(client: GuidelyClient, from: GuidelyElectronBridge | null = bridge()): () => void {\n  if (!from?.takeMainErrors) return () => {};\n  let busy = false;\n  let again = false;\n  const take = async (): Promise<void> => {\n    if (busy) {\n      again = true;\n      return;\n    }\n    busy = true;\n    try {\n      // A destroyed client would take the events and drop them: leave them for another window.\n      if (client.getState().destroyed) return;\n      for (const e of (await from.takeMainErrors!()) ?? []) {\n        try {\n          client.captureException(toError(e), {\n            level: e.level,\n            mechanism: { type: e.mechanism, handled: e.handled },\n            contexts: e.contexts,\n            tags: { process: \"main\", ...(e.tags ?? {}) },\n            ...(e.fingerprint?.length ? { fingerprint: e.fingerprint } : {}),\n            extra: { occurredAt: new Date(e.timestamp).toISOString() },\n          });\n        } catch {\n          // keep sending the rest\n        }\n      }\n    } catch {\n      // no main-process handler: nothing to send\n    } finally {\n      busy = false;\n      if (again) {\n        again = false;\n        void take();\n      }\n    }\n  };\n  void take();\n  let off: () => void = () => {};\n  try {\n    off = from.onMainErrors?.(() => void take()) ?? off;\n  } catch {\n    // a bridge without push: events are taken when windows load\n  }\n  return off;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAwF;;;ACmDjF,IAAM,sBAAsB;AAE5B,IAAM,4BAA4B;AAGlC,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;;;ACzDA,IAAM,WAAmC,EAAE,QAAQ,SAAS,OAAO,WAAW,OAAO,QAAQ;AAGtF,SAAS,sBAAsB,MAAuE;AAC3G,MAAI,CAAC,KAAM,QAAO,CAAC;AACnB,SAAO;AAAA,IACL,UAAU,EAAE,GAAI,KAAK,kBAAkB,EAAE,SAAS,KAAK,gBAAgB,IAAI,CAAC,GAAI,GAAI,KAAK,gBAAgB,EAAE,QAAQ,KAAK,cAAc,IAAI,CAAC,GAAI,GAAI,KAAK,cAAc,EAAE,MAAM,KAAK,YAAY,IAAI,CAAC,GAAI,aAAa,WAAW;AAAA,IAChO,IAAI,EAAE,MAAM,SAAS,KAAK,QAAQ,KAAK,KAAK,UAAU,GAAI,KAAK,YAAY,EAAE,SAAS,KAAK,UAAU,IAAI,CAAC,EAAG;AAAA,IAC7G,KAAK,EAAE,UAAU,KAAK,SAAS,aAAa,KAAK,WAAW;AAAA,EAC9D;AACF;AAGO,SAAS,yBAAyB,QAAuB,MAAoC;AAClG,MAAI;AACF,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,sBAAsB,IAAI,CAAC,EAAG,QAAO,WAAW,MAAM,OAAO;AAAA,EAC5G,QAAQ;AAAA,EAER;AACF;AAGA,SAAS,QAAQ,MAA2E;AAC1F,QAAM,QAAQ,IAAI,MAAM,KAAK,OAAO;AACpC,QAAM,OAAO,KAAK;AAElB,QAAM,QAAQ,KAAK,SAAS,GAAG,KAAK,IAAI,KAAK,KAAK,OAAO;AACzD,MAAI,KAAK,MAAO,CAAC,MAAsC,QAAQ,QAAQ,KAAK,KAAK;AACjF,SAAO;AACT;AAEA,IAAM,SAAS,MAAoC;AACjD,QAAM,IAAK,WAAkD,UAAU;AACvE,SAAO,KAAK,OAAO,EAAE,mBAAmB,aAAa,IAAI;AAC3D;AAOO,SAAS,kBAAkB,QAAuB,OAAqC,OAAO,GAAe;AAClH,MAAI,CAAC,MAAM,eAAgB,QAAO,MAAM;AAAA,EAAC;AACzC,MAAI,OAAO;AACX,MAAI,QAAQ;AACZ,QAAM,OAAO,YAA2B;AACtC,QAAI,MAAM;AACR,cAAQ;AACR;AAAA,IACF;AACA,WAAO;AACP,QAAI;AAEF,UAAI,OAAO,SAAS,EAAE,UAAW;AACjC,iBAAW,KAAM,MAAM,KAAK,eAAgB,KAAM,CAAC,GAAG;AACpD,YAAI;AACF,iBAAO,iBAAiB,QAAQ,CAAC,GAAG;AAAA,YAClC,OAAO,EAAE;AAAA,YACT,WAAW,EAAE,MAAM,EAAE,WAAW,SAAS,EAAE,QAAQ;AAAA,YACnD,UAAU,EAAE;AAAA,YACZ,MAAM,EAAE,SAAS,QAAQ,GAAI,EAAE,QAAQ,CAAC,EAAG;AAAA,YAC3C,GAAI,EAAE,aAAa,SAAS,EAAE,aAAa,EAAE,YAAY,IAAI,CAAC;AAAA,YAC9D,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE;AAAA,UAC3D,CAAC;AAAA,QACH,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF,QAAQ;AAAA,IAER,UAAE;AACA,aAAO;AACP,UAAI,OAAO;AACT,gBAAQ;AACR,aAAK,KAAK;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AACA,OAAK,KAAK;AACV,MAAI,MAAkB,MAAM;AAAA,EAAC;AAC7B,MAAI;AACF,UAAM,KAAK,eAAe,MAAM,KAAK,KAAK,CAAC,KAAK;AAAA,EAClD,QAAQ;AAAA,EAER;AACA,SAAO;AACT;;;AFxFA,IAAAA,mBAAgC;AAEhC,IAAMC,UAAS,MAAoC;AACjD,QAAM,IAAI;AACV,QAAM,IAAI,EAAE,UAAU;AACtB,SAAO,KAAK,OAAO,EAAE,eAAe,aAAa,IAAI;AACvD;AAMA,eAAsB,mBAAmB,YAAY,KAAuC;AAC1F,QAAM,IAAIA,QAAO;AACjB,MAAI,CAAC,EAAG,QAAO;AACf,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,QAAQ,KAAK;AAAA,MACxB,EAAE,WAAW,EAAE,KAAK,CAAC,SAAU,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,eAAe,WAAW,OAAO,IAAK;AAAA,MACrH,IAAI,QAAc,CAAC,YAAa,QAAQ,WAAW,MAAM,QAAQ,IAAI,GAAG,SAAS,CAAE;AAAA,IACrF,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT,UAAE;AACA,QAAI,MAAO,cAAa,KAAK;AAAA,EAC/B;AACF;AAOO,SAAS,gBAAgB,MAA0F;AACxH,SAAO;AAAA,IACL,SAAS;AAAA,IACT,GAAI,MAAM,aAAa,EAAE,YAAY,KAAK,YAAY,SAAS,KAAK,WAAW,IAAI,CAAC;AAAA,EACtF;AACF;AAOO,SAAS,cAAc,MAAsD;AAClF,MAAI,CAAC,KAAM,QAAO,CAAC;AACnB,QAAM,MAA8B,EAAE,YAAY,KAAK,YAAY,WAAW,OAAO,KAAK,QAAQ,GAAG,aAAa,KAAK,KAAK;AAC5H,MAAI,KAAK,UAAW,KAAI,mBAAmB,KAAK;AAChD,MAAI,KAAK,gBAAiB,KAAI,kBAAkB,KAAK;AACrD,SAAO;AACT;AAcA,eAAsB,sBAAsB,SAAgF;AAC1H,QAAM,EAAE,iBAAiB,GAAG,KAAK,IAAI;AACrC,QAAM,OAAO,MAAM,mBAAmB,eAAe;AACrD,QAAM,OAAO,KAAK,OAAO,EAAE,GAAG,KAAK,MAAM,QAAQ,EAAE,GAAG,cAAc,IAAI,GAAG,GAAI,KAAK,KAAK,UAAU,CAAC,EAAG,EAAE,IAAI;AAC7G,QAAM,aAAS,+BAAc,EAAE,GAAG,gBAAgB,IAAI,GAAG,GAAG,MAAM,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,EAAG,CAAC;AAC7F,2BAAyB,QAAQ,IAAI;AACrC,oBAAkB,MAAM;AACxB,SAAO;AACT;","names":["import_sdk_core","bridge"]}

package/dist/index.d.cts

@@ -1,7 +1,18 @@
-import { GuidelyOptions, GuidelyClient } from '@guidelytech/sdk-core';
+import { GuidelyClient, GuidelyOptions } from '@guidelytech/sdk-core';
 export { normalizeAppUrl } from '@guidelytech/sdk-core';
-import { E as ElectronAppInfo } from './types-BEnWCecg.cjs';
-export { A as APP_INFO_CHANNEL, B as BRIDGE_KEY, G as GuidelyElectronBridge, o as osName } from './types-BEnWCecg.cjs';
+import { E as ElectronAppInfo, G as GuidelyElectronBridge } from './types-jhX9pTdK.cjs';
+export { A as APP_INFO_CHANNEL, B as BRIDGE_KEY, M as MAIN_ERRORS_CHANNEL, a as MAIN_ERRORS_READY_CHANNEL, b as MainErrorEvent, o as osName } from './types-jhX9pTdK.cjs';
+
+/** `electron`, `os` and `app` contexts (Sentry's names) from the app info. */
+declare function electronErrorContexts(info: ElectronAppInfo | null): Record<string, Record<string, unknown>>;
+/** Puts the Electron contexts on every later error of `client` (the user agent's frozen OS version is replaced by the real one). */
+declare function setElectronErrorContexts(client: GuidelyClient, info: ElectronAppInfo | null): void;
+/**
+ * Sends the main process's waiting errors (`setupGuidelyMain({ errors })`) through `client` now and
+ * whenever the main process has new ones. `createGuidelyElectron` calls it; call it yourself when
+ * you create the client another way. Returns a function that stops listening.
+ */
+declare function forwardMainErrors(client: GuidelyClient, from?: GuidelyElectronBridge | null): () => void;
 
 /**
  * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,
@@ -24,6 +35,8 @@ declare function desktopTraits(info: ElectronAppInfo | null): Record<string, str
  * Renderer: creates the Guidely client for an Electron window, after reading the app info from the
  * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with
  * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.
+ * Errors carry the `electron`, `os` and `app` contexts, and the main process's errors and crashes
+ * (`setupGuidelyMain({ errors })`) are sent through this client. `errors` options pass through.
  *
  * ```ts
  * import { createGuidelyElectron } from "@guidelytech/electron";
@@ -34,4 +47,4 @@ declare function createGuidelyElectron(options: GuidelyOptions & {
     bridgeTimeoutMs?: number;
 }): Promise<GuidelyClient>;
 
-export { ElectronAppInfo, createGuidelyElectron, desktopTraits, electronOptions, getElectronAppInfo };
+export { ElectronAppInfo, GuidelyElectronBridge, createGuidelyElectron, desktopTraits, electronErrorContexts, electronOptions, forwardMainErrors, getElectronAppInfo, setElectronErrorContexts };

package/dist/index.d.ts

@@ -1,7 +1,18 @@
-import { GuidelyOptions, GuidelyClient } from '@guidelytech/sdk-core';
+import { GuidelyClient, GuidelyOptions } from '@guidelytech/sdk-core';
 export { normalizeAppUrl } from '@guidelytech/sdk-core';
-import { E as ElectronAppInfo } from './types-BEnWCecg.js';
-export { A as APP_INFO_CHANNEL, B as BRIDGE_KEY, G as GuidelyElectronBridge, o as osName } from './types-BEnWCecg.js';
+import { E as ElectronAppInfo, G as GuidelyElectronBridge } from './types-jhX9pTdK.js';
+export { A as APP_INFO_CHANNEL, B as BRIDGE_KEY, M as MAIN_ERRORS_CHANNEL, a as MAIN_ERRORS_READY_CHANNEL, b as MainErrorEvent, o as osName } from './types-jhX9pTdK.js';
+
+/** `electron`, `os` and `app` contexts (Sentry's names) from the app info. */
+declare function electronErrorContexts(info: ElectronAppInfo | null): Record<string, Record<string, unknown>>;
+/** Puts the Electron contexts on every later error of `client` (the user agent's frozen OS version is replaced by the real one). */
+declare function setElectronErrorContexts(client: GuidelyClient, info: ElectronAppInfo | null): void;
+/**
+ * Sends the main process's waiting errors (`setupGuidelyMain({ errors })`) through `client` now and
+ * whenever the main process has new ones. `createGuidelyElectron` calls it; call it yourself when
+ * you create the client another way. Returns a function that stops listening.
+ */
+declare function forwardMainErrors(client: GuidelyClient, from?: GuidelyElectronBridge | null): () => void;
 
 /**
  * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,
@@ -24,6 +35,8 @@ declare function desktopTraits(info: ElectronAppInfo | null): Record<string, str
  * Renderer: creates the Guidely client for an Electron window, after reading the app info from the
  * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with
  * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.
+ * Errors carry the `electron`, `os` and `app` contexts, and the main process's errors and crashes
+ * (`setupGuidelyMain({ errors })`) are sent through this client. `errors` options pass through.
  *
  * ```ts
  * import { createGuidelyElectron } from "@guidelytech/electron";
@@ -34,4 +47,4 @@ declare function createGuidelyElectron(options: GuidelyOptions & {
     bridgeTimeoutMs?: number;
 }): Promise<GuidelyClient>;
 
-export { ElectronAppInfo, createGuidelyElectron, desktopTraits, electronOptions, getElectronAppInfo };
+export { ElectronAppInfo, GuidelyElectronBridge, createGuidelyElectron, desktopTraits, electronErrorContexts, electronOptions, forwardMainErrors, getElectronAppInfo, setElectronErrorContexts };

package/dist/index.js

@@ -1,19 +1,95 @@
 import {
   APP_INFO_CHANNEL,
   BRIDGE_KEY,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL,
   osName
-} from "./chunk-AGZOVF3N.js";
+} from "./chunk-JP3V2XK5.js";
 
 // src/index.ts
 import { createGuidely, normalizeAppUrl } from "@guidelytech/sdk-core";
-import { normalizeAppUrl as normalizeAppUrl2 } from "@guidelytech/sdk-core";
+
+// src/renderer-errors.ts
+var OS_NAMES = { darwin: "macOS", win32: "Windows", linux: "Linux" };
+function electronErrorContexts(info) {
+  if (!info) return {};
+  return {
+    electron: { ...info.electronVersion ? { version: info.electronVersion } : {}, ...info.chromeVersion ? { chrome: info.chromeVersion } : {}, ...info.nodeVersion ? { node: info.nodeVersion } : {}, processType: "renderer" },
+    os: { name: OS_NAMES[info.platform] ?? info.platform, ...info.osVersion ? { version: info.osVersion } : {} },
+    app: { app_name: info.appName, app_version: info.appVersion }
+  };
+}
+function setElectronErrorContexts(client, info) {
+  try {
+    for (const [name, context] of Object.entries(electronErrorContexts(info))) client.setContext(name, context);
+  } catch {
+  }
+}
+function toError(data) {
+  const error = new Error(data.message);
+  error.name = data.type;
+  error.stack = data.stack ?? `${data.type}: ${data.message}`;
+  if (data.cause) error.cause = toError(data.cause);
+  return error;
+}
 var bridge = () => {
+  const b = globalThis[BRIDGE_KEY];
+  return b && typeof b.takeMainErrors === "function" ? b : null;
+};
+function forwardMainErrors(client, from = bridge()) {
+  if (!from?.takeMainErrors) return () => {
+  };
+  let busy = false;
+  let again = false;
+  const take = async () => {
+    if (busy) {
+      again = true;
+      return;
+    }
+    busy = true;
+    try {
+      if (client.getState().destroyed) return;
+      for (const e of await from.takeMainErrors() ?? []) {
+        try {
+          client.captureException(toError(e), {
+            level: e.level,
+            mechanism: { type: e.mechanism, handled: e.handled },
+            contexts: e.contexts,
+            tags: { process: "main", ...e.tags ?? {} },
+            ...e.fingerprint?.length ? { fingerprint: e.fingerprint } : {},
+            extra: { occurredAt: new Date(e.timestamp).toISOString() }
+          });
+        } catch {
+        }
+      }
+    } catch {
+    } finally {
+      busy = false;
+      if (again) {
+        again = false;
+        void take();
+      }
+    }
+  };
+  void take();
+  let off = () => {
+  };
+  try {
+    off = from.onMainErrors?.(() => void take()) ?? off;
+  } catch {
+  }
+  return off;
+}
+
+// src/index.ts
+import { normalizeAppUrl as normalizeAppUrl2 } from "@guidelytech/sdk-core";
+var bridge2 = () => {
   const g = globalThis;
   const b = g[BRIDGE_KEY];
   return b && typeof b.getAppInfo === "function" ? b : null;
 };
 async function getElectronAppInfo(timeoutMs = 1e3) {
-  const b = bridge();
+  const b = bridge2();
   if (!b) return null;
   let timer;
   try {
@@ -44,16 +120,24 @@ async function createGuidelyElectron(options) {
   const { bridgeTimeoutMs, ...rest } = options;
   const info = await getElectronAppInfo(bridgeTimeoutMs);
   const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...rest.user.traits ?? {} } } : void 0;
-  return createGuidely({ ...electronOptions(info), ...rest, ...user ? { user } : {} });
+  const client = createGuidely({ ...electronOptions(info), ...rest, ...user ? { user } : {} });
+  setElectronErrorContexts(client, info);
+  forwardMainErrors(client);
+  return client;
 }
 export {
   APP_INFO_CHANNEL,
   BRIDGE_KEY,
+  MAIN_ERRORS_CHANNEL,
+  MAIN_ERRORS_READY_CHANNEL,
   createGuidelyElectron,
   desktopTraits,
+  electronErrorContexts,
   electronOptions,
+  forwardMainErrors,
   getElectronAppInfo,
   normalizeAppUrl2 as normalizeAppUrl,
-  osName
+  osName,
+  setElectronErrorContexts
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { createGuidely, normalizeAppUrl, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { BRIDGE_KEY, osName, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport { APP_INFO_CHANNEL, BRIDGE_KEY, osName } from \"./types\";\nexport type { ElectronAppInfo, GuidelyElectronBridge } from \"./types\";\nexport { normalizeAppUrl } from \"@guidelytech/sdk-core\";\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const g = globalThis as unknown as Record<string, unknown>;\n  const b = g[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.getAppInfo === \"function\" ? b : null;\n};\n\n/**\n * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,\n * preload not installed) or does not answer within `timeoutMs`.\n */\nexport async function getElectronAppInfo(timeoutMs = 1000): Promise<ElectronAppInfo | null> {\n  const b = bridge();\n  if (!b) return null;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      b.getAppInfo().then((info) => (info && typeof info === \"object\" && typeof info.appVersion === \"string\" ? info : null)),\n      new Promise<null>((resolve) => (timer = setTimeout(() => resolve(null), timeoutMs))),\n    ]);\n  } catch {\n    return null;\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * SDK options for a desktop app: app-relative page URLs for `file:` and custom protocols, the app\n * version for **App version** targeting rules and flag attributes, and the release for source-mapped\n * errors. Spread your own options after it to override.\n */\nexport function electronOptions(info: ElectronAppInfo | null): Pick<GuidelyOptions, \"pageUrl\" | \"appVersion\" | \"release\"> {\n  return {\n    pageUrl: normalizeAppUrl,\n    ...(info?.appVersion ? { appVersion: info.appVersion, release: info.appVersion } : {}),\n  };\n}\n\n/**\n * Desktop details as user traits (`desktopOs`, `desktopOsVersion`, `desktopArch`, `electronVersion`,\n * `appVersion`), for `identify(userId, { ...traits, ...desktopTraits(info) })` so targeting rules,\n * audiences and the Users list can use them.\n */\nexport function desktopTraits(info: ElectronAppInfo | null): Record<string, string> {\n  if (!info) return {};\n  const out: Record<string, string> = { appVersion: info.appVersion, desktopOs: osName(info.platform), desktopArch: info.arch };\n  if (info.osVersion) out.desktopOsVersion = info.osVersion;\n  if (info.electronVersion) out.electronVersion = info.electronVersion;\n  return out;\n}\n\n/**\n * Renderer: creates the Guidely client for an Electron window, after reading the app info from the\n * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with\n * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.\n *\n * ```ts\n * import { createGuidelyElectron } from \"@guidelytech/electron\";\n * const guidely = await createGuidelyElectron({ projectId: \"pk_prod_…\", user: { id: me.id, traits: { plan: me.plan } } });\n * ```\n */\nexport async function createGuidelyElectron(options: GuidelyOptions & { bridgeTimeoutMs?: number }): Promise<GuidelyClient> {\n  const { bridgeTimeoutMs, ...rest } = options;\n  const info = await getElectronAppInfo(bridgeTimeoutMs);\n  const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...(rest.user.traits ?? {}) } } : undefined;\n  return createGuidely({ ...electronOptions(info), ...rest, ...(user ? { user } : {}) });\n}\n"],"mappings":";;;;;;;AAAA,SAAS,eAAe,uBAAgE;AAKxF,SAAS,mBAAAA,wBAAuB;AAEhC,IAAM,SAAS,MAAoC;AACjD,QAAM,IAAI;AACV,QAAM,IAAI,EAAE,UAAU;AACtB,SAAO,KAAK,OAAO,EAAE,eAAe,aAAa,IAAI;AACvD;AAMA,eAAsB,mBAAmB,YAAY,KAAuC;AAC1F,QAAM,IAAI,OAAO;AACjB,MAAI,CAAC,EAAG,QAAO;AACf,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,QAAQ,KAAK;AAAA,MACxB,EAAE,WAAW,EAAE,KAAK,CAAC,SAAU,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,eAAe,WAAW,OAAO,IAAK;AAAA,MACrH,IAAI,QAAc,CAAC,YAAa,QAAQ,WAAW,MAAM,QAAQ,IAAI,GAAG,SAAS,CAAE;AAAA,IACrF,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT,UAAE;AACA,QAAI,MAAO,cAAa,KAAK;AAAA,EAC/B;AACF;AAOO,SAAS,gBAAgB,MAA0F;AACxH,SAAO;AAAA,IACL,SAAS;AAAA,IACT,GAAI,MAAM,aAAa,EAAE,YAAY,KAAK,YAAY,SAAS,KAAK,WAAW,IAAI,CAAC;AAAA,EACtF;AACF;AAOO,SAAS,cAAc,MAAsD;AAClF,MAAI,CAAC,KAAM,QAAO,CAAC;AACnB,QAAM,MAA8B,EAAE,YAAY,KAAK,YAAY,WAAW,OAAO,KAAK,QAAQ,GAAG,aAAa,KAAK,KAAK;AAC5H,MAAI,KAAK,UAAW,KAAI,mBAAmB,KAAK;AAChD,MAAI,KAAK,gBAAiB,KAAI,kBAAkB,KAAK;AACrD,SAAO;AACT;AAYA,eAAsB,sBAAsB,SAAgF;AAC1H,QAAM,EAAE,iBAAiB,GAAG,KAAK,IAAI;AACrC,QAAM,OAAO,MAAM,mBAAmB,eAAe;AACrD,QAAM,OAAO,KAAK,OAAO,EAAE,GAAG,KAAK,MAAM,QAAQ,EAAE,GAAG,cAAc,IAAI,GAAG,GAAI,KAAK,KAAK,UAAU,CAAC,EAAG,EAAE,IAAI;AAC7G,SAAO,cAAc,EAAE,GAAG,gBAAgB,IAAI,GAAG,GAAG,MAAM,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,EAAG,CAAC;AACvF;","names":["normalizeAppUrl"]}
+{"version":3,"sources":["../src/index.ts","../src/renderer-errors.ts"],"sourcesContent":["import { createGuidely, normalizeAppUrl, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/sdk-core\";\nimport { forwardMainErrors, setElectronErrorContexts } from \"./renderer-errors\";\nimport { BRIDGE_KEY, osName, type ElectronAppInfo, type GuidelyElectronBridge } from \"./types\";\n\nexport { APP_INFO_CHANNEL, BRIDGE_KEY, MAIN_ERRORS_CHANNEL, MAIN_ERRORS_READY_CHANNEL, osName } from \"./types\";\nexport type { ElectronAppInfo, GuidelyElectronBridge, MainErrorEvent } from \"./types\";\nexport { electronErrorContexts, forwardMainErrors, setElectronErrorContexts } from \"./renderer-errors\";\nexport { normalizeAppUrl } from \"@guidelytech/sdk-core\";\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const g = globalThis as unknown as Record<string, unknown>;\n  const b = g[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.getAppInfo === \"function\" ? b : null;\n};\n\n/**\n * Renderer: the app info exposed by the preload bridge, or null when it is missing (plain browser,\n * preload not installed) or does not answer within `timeoutMs`.\n */\nexport async function getElectronAppInfo(timeoutMs = 1000): Promise<ElectronAppInfo | null> {\n  const b = bridge();\n  if (!b) return null;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  try {\n    return await Promise.race([\n      b.getAppInfo().then((info) => (info && typeof info === \"object\" && typeof info.appVersion === \"string\" ? info : null)),\n      new Promise<null>((resolve) => (timer = setTimeout(() => resolve(null), timeoutMs))),\n    ]);\n  } catch {\n    return null;\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * SDK options for a desktop app: app-relative page URLs for `file:` and custom protocols, the app\n * version for **App version** targeting rules and flag attributes, and the release for source-mapped\n * errors. Spread your own options after it to override.\n */\nexport function electronOptions(info: ElectronAppInfo | null): Pick<GuidelyOptions, \"pageUrl\" | \"appVersion\" | \"release\"> {\n  return {\n    pageUrl: normalizeAppUrl,\n    ...(info?.appVersion ? { appVersion: info.appVersion, release: info.appVersion } : {}),\n  };\n}\n\n/**\n * Desktop details as user traits (`desktopOs`, `desktopOsVersion`, `desktopArch`, `electronVersion`,\n * `appVersion`), for `identify(userId, { ...traits, ...desktopTraits(info) })` so targeting rules,\n * audiences and the Users list can use them.\n */\nexport function desktopTraits(info: ElectronAppInfo | null): Record<string, string> {\n  if (!info) return {};\n  const out: Record<string, string> = { appVersion: info.appVersion, desktopOs: osName(info.platform), desktopArch: info.arch };\n  if (info.osVersion) out.desktopOsVersion = info.osVersion;\n  if (info.electronVersion) out.electronVersion = info.electronVersion;\n  return out;\n}\n\n/**\n * Renderer: creates the Guidely client for an Electron window, after reading the app info from the\n * preload bridge (at most `bridgeTimeoutMs`, default 1 s; without the bridge it still works, with\n * app-relative page URLs but no app version). `options.user.traits` get the desktop traits added.\n * Errors carry the `electron`, `os` and `app` contexts, and the main process's errors and crashes\n * (`setupGuidelyMain({ errors })`) are sent through this client. `errors` options pass through.\n *\n * ```ts\n * import { createGuidelyElectron } from \"@guidelytech/electron\";\n * const guidely = await createGuidelyElectron({ projectId: \"pk_prod_…\", user: { id: me.id, traits: { plan: me.plan } } });\n * ```\n */\nexport async function createGuidelyElectron(options: GuidelyOptions & { bridgeTimeoutMs?: number }): Promise<GuidelyClient> {\n  const { bridgeTimeoutMs, ...rest } = options;\n  const info = await getElectronAppInfo(bridgeTimeoutMs);\n  const user = rest.user ? { ...rest.user, traits: { ...desktopTraits(info), ...(rest.user.traits ?? {}) } } : undefined;\n  const client = createGuidely({ ...electronOptions(info), ...rest, ...(user ? { user } : {}) });\n  setElectronErrorContexts(client, info);\n  forwardMainErrors(client);\n  return client;\n}\n","import type { GuidelyClient } from \"@guidelytech/sdk-core\";\nimport { BRIDGE_KEY, type ElectronAppInfo, type GuidelyElectronBridge, type MainErrorEvent } from \"./types\";\n\n/**\n * Renderer side of Electron error monitoring: Electron contexts on every error the window's client\n * reports, and the main process's errors and crashes, sent by this window's client. Kept out of\n * index.ts so the renderer entry only wires it in.\n */\n\nconst OS_NAMES: Record<string, string> = { darwin: \"macOS\", win32: \"Windows\", linux: \"Linux\" };\n\n/** `electron`, `os` and `app` contexts (Sentry's names) from the app info. */\nexport function electronErrorContexts(info: ElectronAppInfo | null): Record<string, Record<string, unknown>> {\n  if (!info) return {};\n  return {\n    electron: { ...(info.electronVersion ? { version: info.electronVersion } : {}), ...(info.chromeVersion ? { chrome: info.chromeVersion } : {}), ...(info.nodeVersion ? { node: info.nodeVersion } : {}), processType: \"renderer\" },\n    os: { name: OS_NAMES[info.platform] ?? info.platform, ...(info.osVersion ? { version: info.osVersion } : {}) },\n    app: { app_name: info.appName, app_version: info.appVersion },\n  };\n}\n\n/** Puts the Electron contexts on every later error of `client` (the user agent's frozen OS version is replaced by the real one). */\nexport function setElectronErrorContexts(client: GuidelyClient, info: ElectronAppInfo | null): void {\n  try {\n    for (const [name, context] of Object.entries(electronErrorContexts(info))) client.setContext(name, context);\n  } catch {\n    // an older client without setContext\n  }\n}\n\n/** A main-process error back as an `Error`, its main-process stack (or none) kept as is. */\nfunction toError(data: Pick<MainErrorEvent, \"type\" | \"message\" | \"stack\" | \"cause\">): Error {\n  const error = new Error(data.message);\n  error.name = data.type;\n  // Never the renderer's own stack: crashes without frames stay without frames.\n  error.stack = data.stack ?? `${data.type}: ${data.message}`;\n  if (data.cause) (error as Error & { cause?: unknown }).cause = toError(data.cause);\n  return error;\n}\n\nconst bridge = (): GuidelyElectronBridge | null => {\n  const b = (globalThis as unknown as Record<string, unknown>)[BRIDGE_KEY] as GuidelyElectronBridge | undefined;\n  return b && typeof b.takeMainErrors === \"function\" ? b : null;\n};\n\n/**\n * Sends the main process's waiting errors (`setupGuidelyMain({ errors })`) through `client` now and\n * whenever the main process has new ones. `createGuidelyElectron` calls it; call it yourself when\n * you create the client another way. Returns a function that stops listening.\n */\nexport function forwardMainErrors(client: GuidelyClient, from: GuidelyElectronBridge | null = bridge()): () => void {\n  if (!from?.takeMainErrors) return () => {};\n  let busy = false;\n  let again = false;\n  const take = async (): Promise<void> => {\n    if (busy) {\n      again = true;\n      return;\n    }\n    busy = true;\n    try {\n      // A destroyed client would take the events and drop them: leave them for another window.\n      if (client.getState().destroyed) return;\n      for (const e of (await from.takeMainErrors!()) ?? []) {\n        try {\n          client.captureException(toError(e), {\n            level: e.level,\n            mechanism: { type: e.mechanism, handled: e.handled },\n            contexts: e.contexts,\n            tags: { process: \"main\", ...(e.tags ?? {}) },\n            ...(e.fingerprint?.length ? { fingerprint: e.fingerprint } : {}),\n            extra: { occurredAt: new Date(e.timestamp).toISOString() },\n          });\n        } catch {\n          // keep sending the rest\n        }\n      }\n    } catch {\n      // no main-process handler: nothing to send\n    } finally {\n      busy = false;\n      if (again) {\n        again = false;\n        void take();\n      }\n    }\n  };\n  void take();\n  let off: () => void = () => {};\n  try {\n    off = from.onMainErrors?.(() => void take()) ?? off;\n  } catch {\n    // a bridge without push: events are taken when windows load\n  }\n  return off;\n}\n"],"mappings":"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","names":["normalizeAppUrl","bridge"]}