electron-buff 1.0.3

package/README.md

@@ -0,0 +1,37 @@
+# electron-buff
+
+Electron enhancement utilities for electron-vite projects.
+
+## Modules
+
+| Module | Description | Documentation |
+|--------|-------------|---------------|
+| **XPC** | Cross-process communication | [English](./doc/xpc.doc.md) \| [中文](./doc/xpc_cn.doc.md) |
+
+## Install
+
+```bash
+yarn add electron-buff
+```
+
+## TODO
+
+1. 通过 Proxy 实现 XPC 调用：发送通过调用 class 的 function 实现，监听通过 class 的函数名在实例化过程中自动注册，无需手动调用 `handle`/`send` 并传入字符串句柄，可实现代码自动补全。
+
+
+## Module Overview
+
+### XPC — Cross-Process Communication
+
+XPC is a bidirectional async/await RPC module for **Electron** applications. Unlike Electron's built-in `ipcRenderer.invoke` / `ipcMain.handle`, which only supports renderer-to-main request–response, XPC enables **any process** (renderer or main) to call handlers registered in **any other process** with full `async/await` semantics — including renderer-to-renderer, main-to-renderer, and main-to-main invocations.
+
+**Advantages:**
+
+1. **Offload work to renderer processes** — Heavy or blocking tasks can be delegated to a preload script running in a hidden renderer window, keeping the main process responsive and reducing its performance overhead.
+2. **Unified async/await across all processes** — Since every inter-process call supports `async/await`, complex multi-step workflows that span multiple processes can be orchestrated with straightforward sequential logic, eliminating deeply nested callbacks or manual event coordination.
+
+> Full documentation: [English](./doc/xpc.doc.md) | [中文](./doc/xpc_cn.doc.md)
+
+## License
+
+MIT

package/dist/pathHelper/main/index.d.mts

@@ -0,0 +1,20 @@
+type PathName = 'home' | 'appData' | 'userData' | 'sessionData' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'recent' | 'logs' | 'crashDumps';
+type PathHelperApi = {
+    getAppPath: () => Promise<string>;
+    getPath: (name: PathName) => Promise<string>;
+    getUserDataPath: () => Promise<string>;
+};
+
+declare class PathMainHelper {
+    init(): void;
+    private setupListeners;
+    /** Get the app installation path */
+    getAppPath(): string;
+    /** Get a special directory or file path by name */
+    getPath(name: PathName): string;
+    /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+    getUserDataPath(): string;
+}
+declare const pathMainHelper: PathMainHelper;
+
+export { type PathHelperApi, type PathName, pathMainHelper };

package/dist/pathHelper/main/index.d.ts

@@ -0,0 +1,20 @@
+type PathName = 'home' | 'appData' | 'userData' | 'sessionData' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'recent' | 'logs' | 'crashDumps';
+type PathHelperApi = {
+    getAppPath: () => Promise<string>;
+    getPath: (name: PathName) => Promise<string>;
+    getUserDataPath: () => Promise<string>;
+};
+
+declare class PathMainHelper {
+    init(): void;
+    private setupListeners;
+    /** Get the app installation path */
+    getAppPath(): string;
+    /** Get a special directory or file path by name */
+    getPath(name: PathName): string;
+    /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+    getUserDataPath(): string;
+}
+declare const pathMainHelper: PathMainHelper;
+
+export { type PathHelperApi, type PathName, pathMainHelper };

package/dist/pathHelper/main/index.js

@@ -0,0 +1,41 @@
+'use strict';
+
+var electron = require('electron');
+
+// src/pathHelper/main/pathMain.helper.ts
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathMainHelper = class {
+  init() {
+    this.setupListeners();
+  }
+  setupListeners() {
+    electron.ipcMain.handle(IPC_GET_APP_PATH, () => {
+      return electron.app.getAppPath();
+    });
+    electron.ipcMain.handle(IPC_GET_PATH, (_event, name) => {
+      return electron.app.getPath(name);
+    });
+    electron.ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {
+      return this.getUserDataPath();
+    });
+  }
+  /** Get the app installation path */
+  getAppPath() {
+    return electron.app.getAppPath();
+  }
+  /** Get a special directory or file path by name */
+  getPath(name) {
+    return electron.app.getPath(name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  getUserDataPath() {
+    return electron.app.getPath("userData");
+  }
+};
+var pathMainHelper = new PathMainHelper();
+
+exports.pathMainHelper = pathMainHelper;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/pathHelper/main/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/pathHelper/main/pathMain.helper.ts"],"names":["ipcMain","app"],"mappings":";;;;;AAGA,IAAM,gBAAA,GAAmB,0BAAA;AACzB,IAAM,YAAA,GAAe,uBAAA;AACrB,IAAM,sBAAA,GAAyB,+BAAA;AAE/B,IAAM,iBAAN,MAAqB;AAAA,EACnB,IAAA,GAAa;AACX,IAAA,IAAA,CAAK,cAAA,EAAe;AAAA,EACtB;AAAA,EAEQ,cAAA,GAAuB;AAC7B,IAAAA,gBAAA,CAAQ,MAAA,CAAO,kBAAkB,MAAM;AACrC,MAAA,OAAOC,aAAI,UAAA,EAAW;AAAA,IACxB,CAAC,CAAA;AAED,IAAAD,gBAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,CAAC,MAAA,EAAQ,IAAA,KAAmB;AACvD,MAAA,OAAOC,YAAA,CAAI,QAAQ,IAAI,CAAA;AAAA,IACzB,CAAC,CAAA;AAED,IAAAD,gBAAA,CAAQ,MAAA,CAAO,wBAAwB,MAAM;AAC3C,MAAA,OAAO,KAAK,eAAA,EAAgB;AAAA,IAC9B,CAAC,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,UAAA,GAAqB;AACnB,IAAA,OAAOC,aAAI,UAAA,EAAW;AAAA,EACxB;AAAA;AAAA,EAGA,QAAQ,IAAA,EAAwB;AAC9B,IAAA,OAAOA,YAAA,CAAI,QAAQ,IAAI,CAAA;AAAA,EACzB;AAAA;AAAA,EAGA,eAAA,GAA0B;AACxB,IAAA,OAAOA,YAAA,CAAI,QAAQ,UAAU,CAAA;AAAA,EAC/B;AAEF,CAAA;AAEO,IAAM,cAAA,GAAiB,IAAI,cAAA","file":"index.js","sourcesContent":["import { app, ipcMain } from 'electron';\nimport type { PathName } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathMainHelper {\n  init(): void {\n    this.setupListeners();\n  }\n\n  private setupListeners(): void {\n    ipcMain.handle(IPC_GET_APP_PATH, () => {\n      return app.getAppPath();\n    });\n\n    ipcMain.handle(IPC_GET_PATH, (_event, name: PathName) => {\n      return app.getPath(name);\n    });\n\n    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {\n      return this.getUserDataPath();\n    });\n  }\n\n  /** Get the app installation path */\n  getAppPath(): string {\n    return app.getAppPath();\n  }\n\n  /** Get a special directory or file path by name */\n  getPath(name: PathName): string {\n    return app.getPath(name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  getUserDataPath(): string {\n    return app.getPath('userData');\n  }\n\n}\n\nexport const pathMainHelper = new PathMainHelper();\n"]}

package/dist/pathHelper/main/index.mjs

@@ -0,0 +1,39 @@
+import { ipcMain, app } from 'electron';
+
+// src/pathHelper/main/pathMain.helper.ts
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathMainHelper = class {
+  init() {
+    this.setupListeners();
+  }
+  setupListeners() {
+    ipcMain.handle(IPC_GET_APP_PATH, () => {
+      return app.getAppPath();
+    });
+    ipcMain.handle(IPC_GET_PATH, (_event, name) => {
+      return app.getPath(name);
+    });
+    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {
+      return this.getUserDataPath();
+    });
+  }
+  /** Get the app installation path */
+  getAppPath() {
+    return app.getAppPath();
+  }
+  /** Get a special directory or file path by name */
+  getPath(name) {
+    return app.getPath(name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  getUserDataPath() {
+    return app.getPath("userData");
+  }
+};
+var pathMainHelper = new PathMainHelper();
+
+export { pathMainHelper };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/pathHelper/main/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/pathHelper/main/pathMain.helper.ts"],"names":[],"mappings":";;;AAGA,IAAM,gBAAA,GAAmB,0BAAA;AACzB,IAAM,YAAA,GAAe,uBAAA;AACrB,IAAM,sBAAA,GAAyB,+BAAA;AAE/B,IAAM,iBAAN,MAAqB;AAAA,EACnB,IAAA,GAAa;AACX,IAAA,IAAA,CAAK,cAAA,EAAe;AAAA,EACtB;AAAA,EAEQ,cAAA,GAAuB;AAC7B,IAAA,OAAA,CAAQ,MAAA,CAAO,kBAAkB,MAAM;AACrC,MAAA,OAAO,IAAI,UAAA,EAAW;AAAA,IACxB,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,CAAC,MAAA,EAAQ,IAAA,KAAmB;AACvD,MAAA,OAAO,GAAA,CAAI,QAAQ,IAAI,CAAA;AAAA,IACzB,CAAC,CAAA;AAED,IAAA,OAAA,CAAQ,MAAA,CAAO,wBAAwB,MAAM;AAC3C,MAAA,OAAO,KAAK,eAAA,EAAgB;AAAA,IAC9B,CAAC,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,UAAA,GAAqB;AACnB,IAAA,OAAO,IAAI,UAAA,EAAW;AAAA,EACxB;AAAA;AAAA,EAGA,QAAQ,IAAA,EAAwB;AAC9B,IAAA,OAAO,GAAA,CAAI,QAAQ,IAAI,CAAA;AAAA,EACzB;AAAA;AAAA,EAGA,eAAA,GAA0B;AACxB,IAAA,OAAO,GAAA,CAAI,QAAQ,UAAU,CAAA;AAAA,EAC/B;AAEF,CAAA;AAEO,IAAM,cAAA,GAAiB,IAAI,cAAA","file":"index.mjs","sourcesContent":["import { app, ipcMain } from 'electron';\nimport type { PathName } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathMainHelper {\n  init(): void {\n    this.setupListeners();\n  }\n\n  private setupListeners(): void {\n    ipcMain.handle(IPC_GET_APP_PATH, () => {\n      return app.getAppPath();\n    });\n\n    ipcMain.handle(IPC_GET_PATH, (_event, name: PathName) => {\n      return app.getPath(name);\n    });\n\n    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {\n      return this.getUserDataPath();\n    });\n  }\n\n  /** Get the app installation path */\n  getAppPath(): string {\n    return app.getAppPath();\n  }\n\n  /** Get a special directory or file path by name */\n  getPath(name: PathName): string {\n    return app.getPath(name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  getUserDataPath(): string {\n    return app.getPath('userData');\n  }\n\n}\n\nexport const pathMainHelper = new PathMainHelper();\n"]}

package/dist/pathHelper/renderer/index.d.mts

@@ -0,0 +1,23 @@
+type PathName = 'home' | 'appData' | 'userData' | 'sessionData' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'recent' | 'logs' | 'crashDumps';
+type PathHelperApi = {
+    getAppPath: () => Promise<string>;
+    getPath: (name: PathName) => Promise<string>;
+    getUserDataPath: () => Promise<string>;
+};
+
+declare class PathRendererHelper {
+    /** Get the app installation path */
+    getAppPath(): Promise<string>;
+    /** Get a special directory or file path by name */
+    getPath(name: PathName): Promise<string>;
+    /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+    getUserDataPath(): Promise<string>;
+}
+declare const pathRendererHelper: PathRendererHelper;
+/**
+ * Returns a contextBridge-safe object for exposeInMainWorld.
+ * Usage: contextBridge.exposeInMainWorld('pathHelper', exposePathHelper())
+ */
+declare const exposePathHelper: () => PathHelperApi;
+
+export { type PathHelperApi, type PathName, exposePathHelper, pathRendererHelper };

package/dist/pathHelper/renderer/index.d.ts

@@ -0,0 +1,23 @@
+type PathName = 'home' | 'appData' | 'userData' | 'sessionData' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'recent' | 'logs' | 'crashDumps';
+type PathHelperApi = {
+    getAppPath: () => Promise<string>;
+    getPath: (name: PathName) => Promise<string>;
+    getUserDataPath: () => Promise<string>;
+};
+
+declare class PathRendererHelper {
+    /** Get the app installation path */
+    getAppPath(): Promise<string>;
+    /** Get a special directory or file path by name */
+    getPath(name: PathName): Promise<string>;
+    /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+    getUserDataPath(): Promise<string>;
+}
+declare const pathRendererHelper: PathRendererHelper;
+/**
+ * Returns a contextBridge-safe object for exposeInMainWorld.
+ * Usage: contextBridge.exposeInMainWorld('pathHelper', exposePathHelper())
+ */
+declare const exposePathHelper: () => PathHelperApi;
+
+export { type PathHelperApi, type PathName, exposePathHelper, pathRendererHelper };

package/dist/pathHelper/renderer/index.js

@@ -0,0 +1,41 @@
+'use strict';
+
+var electron = require('electron');
+
+// src/pathHelper/renderer/pathRenderer.helper.ts
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathRendererHelper = class {
+  /** Get the app installation path */
+  async getAppPath() {
+    return await electron.ipcRenderer.invoke(IPC_GET_APP_PATH);
+  }
+  /** Get a special directory or file path by name */
+  async getPath(name) {
+    return await electron.ipcRenderer.invoke(IPC_GET_PATH, name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  async getUserDataPath() {
+    return await electron.ipcRenderer.invoke(IPC_GET_USER_DATA_PATH);
+  }
+};
+var pathRendererHelper = new PathRendererHelper();
+var exposePathHelper = () => {
+  return {
+    getAppPath: () => {
+      return pathRendererHelper.getAppPath();
+    },
+    getPath: (name) => {
+      return pathRendererHelper.getPath(name);
+    },
+    getUserDataPath: () => {
+      return pathRendererHelper.getUserDataPath();
+    }
+  };
+};
+
+exports.exposePathHelper = exposePathHelper;
+exports.pathRendererHelper = pathRendererHelper;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/pathHelper/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/pathHelper/renderer/pathRenderer.helper.ts"],"names":["ipcRenderer"],"mappings":";;;;;AAGA,IAAM,gBAAA,GAAmB,0BAAA;AACzB,IAAM,YAAA,GAAe,uBAAA;AACrB,IAAM,sBAAA,GAAyB,+BAAA;AAE/B,IAAM,qBAAN,MAAyB;AAAA;AAAA,EAEvB,MAAM,UAAA,GAA8B;AAClC,IAAA,OAAO,MAAMA,oBAAA,CAAY,MAAA,CAAO,gBAAgB,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,MAAM,QAAQ,IAAA,EAAiC;AAC7C,IAAA,OAAO,MAAMA,oBAAA,CAAY,MAAA,CAAO,YAAA,EAAc,IAAI,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,MAAM,eAAA,GAAmC;AACvC,IAAA,OAAO,MAAMA,oBAAA,CAAY,MAAA,CAAO,sBAAsB,CAAA;AAAA,EACxD;AACF,CAAA;AAEO,IAAM,kBAAA,GAAqB,IAAI,kBAAA;AAM/B,IAAM,mBAAmB,MAAqB;AACnD,EAAA,OAAO;AAAA,IACL,YAAY,MAAuB;AACjC,MAAA,OAAO,mBAAmB,UAAA,EAAW;AAAA,IACvC,CAAA;AAAA,IACA,OAAA,EAAS,CAAC,IAAA,KAAoC;AAC5C,MAAA,OAAO,kBAAA,CAAmB,QAAQ,IAAI,CAAA;AAAA,IACxC,CAAA;AAAA,IACA,iBAAiB,MAAuB;AACtC,MAAA,OAAO,mBAAmB,eAAA,EAAgB;AAAA,IAC5C;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import { ipcRenderer } from 'electron';\nimport type { PathName, PathHelperApi } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathRendererHelper {\n  /** Get the app installation path */\n  async getAppPath(): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_APP_PATH);\n  }\n\n  /** Get a special directory or file path by name */\n  async getPath(name: PathName): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_PATH, name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  async getUserDataPath(): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_USER_DATA_PATH);\n  }\n}\n\nexport const pathRendererHelper = new PathRendererHelper();\n\n/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n * Usage: contextBridge.exposeInMainWorld('pathHelper', exposePathHelper())\n */\nexport const exposePathHelper = (): PathHelperApi => {\n  return {\n    getAppPath: (): Promise<string> => {\n      return pathRendererHelper.getAppPath();\n    },\n    getPath: (name: PathName): Promise<string> => {\n      return pathRendererHelper.getPath(name);\n    },\n    getUserDataPath: (): Promise<string> => {\n      return pathRendererHelper.getUserDataPath();\n    },\n  };\n};\n"]}

package/dist/pathHelper/renderer/index.mjs

@@ -0,0 +1,38 @@
+import { ipcRenderer } from 'electron';
+
+// src/pathHelper/renderer/pathRenderer.helper.ts
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathRendererHelper = class {
+  /** Get the app installation path */
+  async getAppPath() {
+    return await ipcRenderer.invoke(IPC_GET_APP_PATH);
+  }
+  /** Get a special directory or file path by name */
+  async getPath(name) {
+    return await ipcRenderer.invoke(IPC_GET_PATH, name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  async getUserDataPath() {
+    return await ipcRenderer.invoke(IPC_GET_USER_DATA_PATH);
+  }
+};
+var pathRendererHelper = new PathRendererHelper();
+var exposePathHelper = () => {
+  return {
+    getAppPath: () => {
+      return pathRendererHelper.getAppPath();
+    },
+    getPath: (name) => {
+      return pathRendererHelper.getPath(name);
+    },
+    getUserDataPath: () => {
+      return pathRendererHelper.getUserDataPath();
+    }
+  };
+};
+
+export { exposePathHelper, pathRendererHelper };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/pathHelper/renderer/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/pathHelper/renderer/pathRenderer.helper.ts"],"names":[],"mappings":";;;AAGA,IAAM,gBAAA,GAAmB,0BAAA;AACzB,IAAM,YAAA,GAAe,uBAAA;AACrB,IAAM,sBAAA,GAAyB,+BAAA;AAE/B,IAAM,qBAAN,MAAyB;AAAA;AAAA,EAEvB,MAAM,UAAA,GAA8B;AAClC,IAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,gBAAgB,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,MAAM,QAAQ,IAAA,EAAiC;AAC7C,IAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,YAAA,EAAc,IAAI,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,MAAM,eAAA,GAAmC;AACvC,IAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,sBAAsB,CAAA;AAAA,EACxD;AACF,CAAA;AAEO,IAAM,kBAAA,GAAqB,IAAI,kBAAA;AAM/B,IAAM,mBAAmB,MAAqB;AACnD,EAAA,OAAO;AAAA,IACL,YAAY,MAAuB;AACjC,MAAA,OAAO,mBAAmB,UAAA,EAAW;AAAA,IACvC,CAAA;AAAA,IACA,OAAA,EAAS,CAAC,IAAA,KAAoC;AAC5C,MAAA,OAAO,kBAAA,CAAmB,QAAQ,IAAI,CAAA;AAAA,IACxC,CAAA;AAAA,IACA,iBAAiB,MAAuB;AACtC,MAAA,OAAO,mBAAmB,eAAA,EAAgB;AAAA,IAC5C;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import { ipcRenderer } from 'electron';\nimport type { PathName, PathHelperApi } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathRendererHelper {\n  /** Get the app installation path */\n  async getAppPath(): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_APP_PATH);\n  }\n\n  /** Get a special directory or file path by name */\n  async getPath(name: PathName): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_PATH, name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  async getUserDataPath(): Promise<string> {\n    return await ipcRenderer.invoke(IPC_GET_USER_DATA_PATH);\n  }\n}\n\nexport const pathRendererHelper = new PathRendererHelper();\n\n/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n * Usage: contextBridge.exposeInMainWorld('pathHelper', exposePathHelper())\n */\nexport const exposePathHelper = (): PathHelperApi => {\n  return {\n    getAppPath: (): Promise<string> => {\n      return pathRendererHelper.getAppPath();\n    },\n    getPath: (name: PathName): Promise<string> => {\n      return pathRendererHelper.getPath(name);\n    },\n    getUserDataPath: (): Promise<string> => {\n      return pathRendererHelper.getUserDataPath();\n    },\n  };\n};\n"]}

package/dist/xpc/main/index.d.mts

@@ -0,0 +1,80 @@
+/**
+ * XpcCenter: runs in the main process.
+ * - Listens for __xpc_register__: renderer registers a handleName, center stores {handleName → webContentsId}
+ * - Listens for __xpc_exec__ (ipcMain.handle): renderer invokes exec, center forwards to target renderer,
+ *   blocks via semaphore until __xpc_finish__ is received, then returns result.
+ * - Listens for __xpc_finish__: target renderer finished execution, unblocks the pending task.
+ */
+declare class XpcCenter {
+    /** handleName → webContentsId */
+    private registry;
+    /** task.id → XpcTask (with semaphore block/unblock) */
+    private pendingTasks;
+    init(): void;
+    /**
+     * Register a main-process handleName in the registry with webContentsId = 0.
+     */
+    registerMainHandler(handleName: string): void;
+    /**
+     * Execute a handleName: if main-process handler, call directly;
+     * otherwise forward to target renderer, block until __xpc_finish__.
+     * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().
+     */
+    exec(handleName: string, params?: any): Promise<any>;
+    private setupListeners;
+}
+declare const xpcCenter: XpcCenter;
+
+type XpcPayload = {
+    /** Unique task ID, guaranteed unique within process lifetime */
+    id: string;
+    /** Event handle name */
+    handleName: string;
+    /** Parameters, nullable */
+    params?: any;
+    /** Return data from target process, nullable, defaults to null */
+    ret?: any;
+};
+
+type XpcHandler = (payload: XpcPayload) => Promise<any>;
+/**
+ * XpcMain: runs in the main process.
+ * - handle(): register a handler callable by renderers or other main-process code.
+ * - send(): invoke a registered handleName (main-process or renderer), delegating to xpcCenter.
+ */
+declare class XpcMain {
+    private handlers;
+    /**
+     * Register a handler in the main process.
+     * When another renderer calls send() with this handleName, xpcCenter will
+     * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.
+     */
+    handle(handleName: string, handler: XpcHandler): void;
+    /**
+     * Get the registered handler for a given handleName.
+     */
+    getHandler(handleName: string): XpcHandler | undefined;
+    /**
+     * Send a message to a registered handler by handleName.
+     * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.
+     */
+    send(handleName: string, params?: any): Promise<any>;
+}
+declare const xpcMain: XpcMain;
+
+declare class XpcTask implements XpcPayload {
+    id: string;
+    handleName: string;
+    params?: any;
+    ret?: any;
+    private semaphore;
+    constructor(payload: XpcPayload);
+    /** Block until unblock() is called */
+    block(): Promise<void>;
+    /** Release the semaphore, unblocking the waiting block() call */
+    unblock(): void;
+    /** Convert to a plain XpcPayload (serializable for IPC) */
+    toPayload(): XpcPayload;
+}
+
+export { type XpcPayload, XpcTask, xpcCenter, xpcMain };

package/dist/xpc/main/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * XpcCenter: runs in the main process.
+ * - Listens for __xpc_register__: renderer registers a handleName, center stores {handleName → webContentsId}
+ * - Listens for __xpc_exec__ (ipcMain.handle): renderer invokes exec, center forwards to target renderer,
+ *   blocks via semaphore until __xpc_finish__ is received, then returns result.
+ * - Listens for __xpc_finish__: target renderer finished execution, unblocks the pending task.
+ */
+declare class XpcCenter {
+    /** handleName → webContentsId */
+    private registry;
+    /** task.id → XpcTask (with semaphore block/unblock) */
+    private pendingTasks;
+    init(): void;
+    /**
+     * Register a main-process handleName in the registry with webContentsId = 0.
+     */
+    registerMainHandler(handleName: string): void;
+    /**
+     * Execute a handleName: if main-process handler, call directly;
+     * otherwise forward to target renderer, block until __xpc_finish__.
+     * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().
+     */
+    exec(handleName: string, params?: any): Promise<any>;
+    private setupListeners;
+}
+declare const xpcCenter: XpcCenter;
+
+type XpcPayload = {
+    /** Unique task ID, guaranteed unique within process lifetime */
+    id: string;
+    /** Event handle name */
+    handleName: string;
+    /** Parameters, nullable */
+    params?: any;
+    /** Return data from target process, nullable, defaults to null */
+    ret?: any;
+};
+
+type XpcHandler = (payload: XpcPayload) => Promise<any>;
+/**
+ * XpcMain: runs in the main process.
+ * - handle(): register a handler callable by renderers or other main-process code.
+ * - send(): invoke a registered handleName (main-process or renderer), delegating to xpcCenter.
+ */
+declare class XpcMain {
+    private handlers;
+    /**
+     * Register a handler in the main process.
+     * When another renderer calls send() with this handleName, xpcCenter will
+     * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.
+     */
+    handle(handleName: string, handler: XpcHandler): void;
+    /**
+     * Get the registered handler for a given handleName.
+     */
+    getHandler(handleName: string): XpcHandler | undefined;
+    /**
+     * Send a message to a registered handler by handleName.
+     * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.
+     */
+    send(handleName: string, params?: any): Promise<any>;
+}
+declare const xpcMain: XpcMain;
+
+declare class XpcTask implements XpcPayload {
+    id: string;
+    handleName: string;
+    params?: any;
+    ret?: any;
+    private semaphore;
+    constructor(payload: XpcPayload);
+    /** Block until unblock() is called */
+    block(): Promise<void>;
+    /** Release the semaphore, unblocking the waiting block() call */
+    unblock(): void;
+    /** Convert to a plain XpcPayload (serializable for IPC) */
+    toPayload(): XpcPayload;
+}
+
+export { type XpcPayload, XpcTask, xpcCenter, xpcMain };

package/dist/xpc/main/index.js

@@ -0,0 +1,185 @@
+'use strict';
+
+var electron = require('electron');
+var rigFoundation = require('rig-foundation');
+
+// src/xpc/main/xpc-center.helper.ts
+var XpcTask = class {
+  constructor(payload) {
+    this.id = payload.id;
+    this.handleName = payload.handleName;
+    this.params = payload.params;
+    this.ret = payload.ret ?? null;
+    this.semaphore = new rigFoundation.Semaphore(1);
+    this.semaphore.take(() => {
+    });
+  }
+  /** Block until unblock() is called */
+  block() {
+    return this.semaphore.takeAsync();
+  }
+  /** Release the semaphore, unblocking the waiting block() call */
+  unblock() {
+    this.semaphore.leave();
+  }
+  /** Convert to a plain XpcPayload (serializable for IPC) */
+  toPayload() {
+    return {
+      id: this.id,
+      handleName: this.handleName,
+      params: this.params,
+      ret: this.ret
+    };
+  }
+};
+
+// src/xpc/main/xpc-id.helper.ts
+var prefix = Math.random().toString(36).slice(2, 8);
+var counter = 0;
+var generateXpcId = () => {
+  return `${prefix}-${(++counter).toString(36)}`;
+};
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathMainHelper = class {
+  init() {
+    this.setupListeners();
+  }
+  setupListeners() {
+    electron.ipcMain.handle(IPC_GET_APP_PATH, () => {
+      return electron.app.getAppPath();
+    });
+    electron.ipcMain.handle(IPC_GET_PATH, (_event, name) => {
+      return electron.app.getPath(name);
+    });
+    electron.ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {
+      return this.getUserDataPath();
+    });
+  }
+  /** Get the app installation path */
+  getAppPath() {
+    return electron.app.getAppPath();
+  }
+  /** Get a special directory or file path by name */
+  getPath(name) {
+    return electron.app.getPath(name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  getUserDataPath() {
+    return electron.app.getPath("userData");
+  }
+};
+var pathMainHelper = new PathMainHelper();
+
+// src/xpc/main/xpc-main.helper.ts
+var XpcMain = class {
+  constructor() {
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a handler in the main process.
+   * When another renderer calls send() with this handleName, xpcCenter will
+   * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.
+   */
+  handle(handleName, handler) {
+    this.handlers.set(handleName, handler);
+    xpcCenter.registerMainHandler(handleName);
+  }
+  /**
+   * Get the registered handler for a given handleName.
+   */
+  getHandler(handleName) {
+    return this.handlers.get(handleName);
+  }
+  /**
+   * Send a message to a registered handler by handleName.
+   * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.
+   */
+  async send(handleName, params) {
+    return xpcCenter.exec(handleName, params);
+  }
+};
+var xpcMain = new XpcMain();
+
+// src/xpc/main/xpc-center.helper.ts
+var XPC_REGISTER = "__xpc_register__";
+var XPC_EXEC = "__xpc_exec__";
+var XPC_FINISH = "__xpc_finish__";
+var XpcCenter = class {
+  constructor() {
+    /** handleName → webContentsId */
+    this.registry = /* @__PURE__ */ new Map();
+    /** task.id → XpcTask (with semaphore block/unblock) */
+    this.pendingTasks = /* @__PURE__ */ new Map();
+  }
+  init() {
+    pathMainHelper.init();
+    this.setupListeners();
+  }
+  /**
+   * Register a main-process handleName in the registry with webContentsId = 0.
+   */
+  registerMainHandler(handleName) {
+    this.registry.set(handleName, 0);
+  }
+  /**
+   * Execute a handleName: if main-process handler, call directly;
+   * otherwise forward to target renderer, block until __xpc_finish__.
+   * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().
+   */
+  async exec(handleName, params) {
+    const targetId = this.registry.get(handleName);
+    if (targetId == null) {
+      return null;
+    }
+    const payload = {
+      id: generateXpcId(),
+      handleName,
+      params
+    };
+    if (targetId === 0) {
+      const handler = xpcMain.getHandler(handleName);
+      if (!handler) {
+        return null;
+      }
+      try {
+        return await handler(payload);
+      } catch (_e) {
+        return null;
+      }
+    }
+    const target = electron.webContents.fromId(targetId);
+    if (!target || target.isDestroyed() || target.isCrashed()) {
+      return null;
+    }
+    const task = new XpcTask(payload);
+    this.pendingTasks.set(task.id, task);
+    target.send(handleName, payload);
+    await task.block();
+    this.pendingTasks.delete(task.id);
+    return task.toPayload().ret ?? null;
+  }
+  setupListeners() {
+    electron.ipcMain.on(XPC_REGISTER, (event, payload) => {
+      this.registry.set(payload.handleName, event.sender.id);
+    });
+    electron.ipcMain.handle(XPC_EXEC, async (_event, payload) => {
+      return this.exec(payload.handleName, payload.params);
+    });
+    electron.ipcMain.on(XPC_FINISH, (_event, payload) => {
+      const task = this.pendingTasks.get(payload.id);
+      if (task) {
+        task.ret = payload.ret ?? null;
+        task.unblock();
+      }
+    });
+  }
+};
+var xpcCenter = new XpcCenter();
+
+exports.XpcTask = XpcTask;
+exports.xpcCenter = xpcCenter;
+exports.xpcMain = xpcMain;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/xpc/main/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/xpc/main/xpc-task.helper.ts","../../../src/xpc/main/xpc-id.helper.ts","../../../src/pathHelper/main/pathMain.helper.ts","../../../src/xpc/main/xpc-main.helper.ts","../../../src/xpc/main/xpc-center.helper.ts"],"names":["Semaphore","ipcMain","app","webContents"],"mappings":"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","file":"index.js","sourcesContent":["import { Semaphore } from 'rig-foundation';\nimport { XpcPayload } from '../shared/xpc.type';\n\nexport class XpcTask implements XpcPayload {\n  id: string;\n  handleName: string;\n  params?: any;\n  ret?: any;\n\n  private semaphore: Semaphore;\n\n  constructor(payload: XpcPayload) {\n    this.id = payload.id;\n    this.handleName = payload.handleName;\n    this.params = payload.params;\n    this.ret = payload.ret ?? null;\n    this.semaphore = new Semaphore(1);\n    this.semaphore.take(() => {});\n  }\n\n  /** Block until unblock() is called */\n  block(): Promise<void> {\n    return this.semaphore.takeAsync();\n  }\n\n  /** Release the semaphore, unblocking the waiting block() call */\n  unblock(): void {\n    this.semaphore.leave();\n  }\n\n  /** Convert to a plain XpcPayload (serializable for IPC) */\n  toPayload(): XpcPayload {\n    return {\n      id: this.id,\n      handleName: this.handleName,\n      params: this.params,\n      ret: this.ret,\n    };\n  }\n}\n","/**\n * High-performance process-unique ID generator.\n * Combines a random prefix (per process) with an incrementing counter.\n * Guaranteed unique within a single process lifetime.\n */\nconst prefix = Math.random().toString(36).slice(2, 8);\nlet counter = 0;\n\nexport const generateXpcId = (): string => {\n  return `${prefix}-${(++counter).toString(36)}`;\n};\n","import { app, ipcMain } from 'electron';\nimport type { PathName } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathMainHelper {\n  init(): void {\n    this.setupListeners();\n  }\n\n  private setupListeners(): void {\n    ipcMain.handle(IPC_GET_APP_PATH, () => {\n      return app.getAppPath();\n    });\n\n    ipcMain.handle(IPC_GET_PATH, (_event, name: PathName) => {\n      return app.getPath(name);\n    });\n\n    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {\n      return this.getUserDataPath();\n    });\n  }\n\n  /** Get the app installation path */\n  getAppPath(): string {\n    return app.getAppPath();\n  }\n\n  /** Get a special directory or file path by name */\n  getPath(name: PathName): string {\n    return app.getPath(name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  getUserDataPath(): string {\n    return app.getPath('userData');\n  }\n\n}\n\nexport const pathMainHelper = new PathMainHelper();\n","import { XpcPayload } from '../shared/xpc.type';\nimport { xpcCenter } from './xpc-center.helper';\n\ntype XpcHandler = (payload: XpcPayload) => Promise<any>;\n\n/**\n * XpcMain: runs in the main process.\n * - handle(): register a handler callable by renderers or other main-process code.\n * - send(): invoke a registered handleName (main-process or renderer), delegating to xpcCenter.\n */\nclass XpcMain {\n  private handlers = new Map<string, XpcHandler>();\n\n  /**\n   * Register a handler in the main process.\n   * When another renderer calls send() with this handleName, xpcCenter will\n   * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.\n   */\n  handle(handleName: string, handler: XpcHandler): void {\n    this.handlers.set(handleName, handler);\n    xpcCenter.registerMainHandler(handleName);\n  }\n\n  /**\n   * Get the registered handler for a given handleName.\n   */\n  getHandler(handleName: string): XpcHandler | undefined {\n    return this.handlers.get(handleName);\n  }\n\n  /**\n   * Send a message to a registered handler by handleName.\n   * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.\n   */\n  async send(handleName: string, params?: any): Promise<any> {\n    return xpcCenter.exec(handleName, params);\n  }\n}\n\nexport const xpcMain = new XpcMain();\n","import { ipcMain, webContents } from 'electron';\nimport { XpcPayload } from '../shared/xpc.type';\nimport { XpcTask } from './xpc-task.helper';\nimport { generateXpcId } from './xpc-id.helper';\nimport { pathMainHelper } from '../../pathHelper/main/pathMain.helper';\nimport { xpcMain } from './xpc-main.helper';\n\nconst XPC_REGISTER = '__xpc_register__';\nconst XPC_EXEC = '__xpc_exec__';\nconst XPC_FINISH = '__xpc_finish__';\n\n/**\n * XpcCenter: runs in the main process.\n * - Listens for __xpc_register__: renderer registers a handleName, center stores {handleName → webContentsId}\n * - Listens for __xpc_exec__ (ipcMain.handle): renderer invokes exec, center forwards to target renderer,\n *   blocks via semaphore until __xpc_finish__ is received, then returns result.\n * - Listens for __xpc_finish__: target renderer finished execution, unblocks the pending task.\n */\nclass XpcCenter {\n  /** handleName → webContentsId */\n  private registry = new Map<string, number>();\n  /** task.id → XpcTask (with semaphore block/unblock) */\n  private pendingTasks = new Map<string, XpcTask>();\n\n  init(): void {\n    pathMainHelper.init();\n    this.setupListeners();\n  }\n\n  /**\n   * Register a main-process handleName in the registry with webContentsId = 0.\n   */\n  registerMainHandler(handleName: string): void {\n    this.registry.set(handleName, 0);\n  }\n\n  /**\n   * Execute a handleName: if main-process handler, call directly;\n   * otherwise forward to target renderer, block until __xpc_finish__.\n   * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().\n   */\n  async exec(handleName: string, params?: any): Promise<any> {\n    const targetId = this.registry.get(handleName);\n    if (targetId == null) {\n      return null;\n    }\n\n    const payload: XpcPayload = {\n      id: generateXpcId(),\n      handleName,\n      params,\n    };\n\n    // targetId === 0 means the handler is registered in the main process\n    if (targetId === 0) {\n      const handler = xpcMain.getHandler(handleName);\n      if (!handler) {\n        return null;\n      }\n      try {\n        return await handler(payload);\n      } catch (_e) {\n        return null;\n      }\n    }\n\n    const target = webContents.fromId(targetId);\n    if (!target || target.isDestroyed() || target.isCrashed()) {\n      return null;\n    }\n\n    // Create semaphore-blocked task\n    const task = new XpcTask(payload);\n\n    this.pendingTasks.set(task.id, task);\n\n    // Forward handleName event + payload to target renderer\n    target.send(handleName, payload);\n\n    // Block until __xpc_finish__ unblocks\n    await task.block();\n    this.pendingTasks.delete(task.id);\n\n    return task.toPayload().ret ?? null;\n  }\n\n  private setupListeners(): void {\n    // Renderer registers a handleName\n    ipcMain.on(XPC_REGISTER, (event, payload: { handleName: string }) => {\n      this.registry.set(payload.handleName, event.sender.id);\n    });\n\n    // Renderer invokes exec via IPC\n    ipcMain.handle(XPC_EXEC, async (_event, payload: XpcPayload): Promise<any> => {\n      return this.exec(payload.handleName, payload.params);\n    });\n\n    // Target renderer finished execution, unblock pending task\n    ipcMain.on(XPC_FINISH, (_event, payload: XpcPayload) => {\n      const task = this.pendingTasks.get(payload.id);\n      if (task) {\n        task.ret = payload.ret ?? null;\n        task.unblock();\n      }\n    });\n  }\n}\n\nexport const xpcCenter = new XpcCenter();\n"]}

package/dist/xpc/main/index.mjs

@@ -0,0 +1,181 @@
+import { webContents, ipcMain, app } from 'electron';
+import { Semaphore } from 'rig-foundation';
+
+// src/xpc/main/xpc-center.helper.ts
+var XpcTask = class {
+  constructor(payload) {
+    this.id = payload.id;
+    this.handleName = payload.handleName;
+    this.params = payload.params;
+    this.ret = payload.ret ?? null;
+    this.semaphore = new Semaphore(1);
+    this.semaphore.take(() => {
+    });
+  }
+  /** Block until unblock() is called */
+  block() {
+    return this.semaphore.takeAsync();
+  }
+  /** Release the semaphore, unblocking the waiting block() call */
+  unblock() {
+    this.semaphore.leave();
+  }
+  /** Convert to a plain XpcPayload (serializable for IPC) */
+  toPayload() {
+    return {
+      id: this.id,
+      handleName: this.handleName,
+      params: this.params,
+      ret: this.ret
+    };
+  }
+};
+
+// src/xpc/main/xpc-id.helper.ts
+var prefix = Math.random().toString(36).slice(2, 8);
+var counter = 0;
+var generateXpcId = () => {
+  return `${prefix}-${(++counter).toString(36)}`;
+};
+var IPC_GET_APP_PATH = "__buff_path_getAppPath__";
+var IPC_GET_PATH = "__buff_path_getPath__";
+var IPC_GET_USER_DATA_PATH = "__buff_path_getUserDataPath__";
+var PathMainHelper = class {
+  init() {
+    this.setupListeners();
+  }
+  setupListeners() {
+    ipcMain.handle(IPC_GET_APP_PATH, () => {
+      return app.getAppPath();
+    });
+    ipcMain.handle(IPC_GET_PATH, (_event, name) => {
+      return app.getPath(name);
+    });
+    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {
+      return this.getUserDataPath();
+    });
+  }
+  /** Get the app installation path */
+  getAppPath() {
+    return app.getAppPath();
+  }
+  /** Get a special directory or file path by name */
+  getPath(name) {
+    return app.getPath(name);
+  }
+  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */
+  getUserDataPath() {
+    return app.getPath("userData");
+  }
+};
+var pathMainHelper = new PathMainHelper();
+
+// src/xpc/main/xpc-main.helper.ts
+var XpcMain = class {
+  constructor() {
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a handler in the main process.
+   * When another renderer calls send() with this handleName, xpcCenter will
+   * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.
+   */
+  handle(handleName, handler) {
+    this.handlers.set(handleName, handler);
+    xpcCenter.registerMainHandler(handleName);
+  }
+  /**
+   * Get the registered handler for a given handleName.
+   */
+  getHandler(handleName) {
+    return this.handlers.get(handleName);
+  }
+  /**
+   * Send a message to a registered handler by handleName.
+   * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.
+   */
+  async send(handleName, params) {
+    return xpcCenter.exec(handleName, params);
+  }
+};
+var xpcMain = new XpcMain();
+
+// src/xpc/main/xpc-center.helper.ts
+var XPC_REGISTER = "__xpc_register__";
+var XPC_EXEC = "__xpc_exec__";
+var XPC_FINISH = "__xpc_finish__";
+var XpcCenter = class {
+  constructor() {
+    /** handleName → webContentsId */
+    this.registry = /* @__PURE__ */ new Map();
+    /** task.id → XpcTask (with semaphore block/unblock) */
+    this.pendingTasks = /* @__PURE__ */ new Map();
+  }
+  init() {
+    pathMainHelper.init();
+    this.setupListeners();
+  }
+  /**
+   * Register a main-process handleName in the registry with webContentsId = 0.
+   */
+  registerMainHandler(handleName) {
+    this.registry.set(handleName, 0);
+  }
+  /**
+   * Execute a handleName: if main-process handler, call directly;
+   * otherwise forward to target renderer, block until __xpc_finish__.
+   * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().
+   */
+  async exec(handleName, params) {
+    const targetId = this.registry.get(handleName);
+    if (targetId == null) {
+      return null;
+    }
+    const payload = {
+      id: generateXpcId(),
+      handleName,
+      params
+    };
+    if (targetId === 0) {
+      const handler = xpcMain.getHandler(handleName);
+      if (!handler) {
+        return null;
+      }
+      try {
+        return await handler(payload);
+      } catch (_e) {
+        return null;
+      }
+    }
+    const target = webContents.fromId(targetId);
+    if (!target || target.isDestroyed() || target.isCrashed()) {
+      return null;
+    }
+    const task = new XpcTask(payload);
+    this.pendingTasks.set(task.id, task);
+    target.send(handleName, payload);
+    await task.block();
+    this.pendingTasks.delete(task.id);
+    return task.toPayload().ret ?? null;
+  }
+  setupListeners() {
+    ipcMain.on(XPC_REGISTER, (event, payload) => {
+      this.registry.set(payload.handleName, event.sender.id);
+    });
+    ipcMain.handle(XPC_EXEC, async (_event, payload) => {
+      return this.exec(payload.handleName, payload.params);
+    });
+    ipcMain.on(XPC_FINISH, (_event, payload) => {
+      const task = this.pendingTasks.get(payload.id);
+      if (task) {
+        task.ret = payload.ret ?? null;
+        task.unblock();
+      }
+    });
+  }
+};
+var xpcCenter = new XpcCenter();
+
+export { XpcTask, xpcCenter, xpcMain };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/xpc/main/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/xpc/main/xpc-task.helper.ts","../../../src/xpc/main/xpc-id.helper.ts","../../../src/pathHelper/main/pathMain.helper.ts","../../../src/xpc/main/xpc-main.helper.ts","../../../src/xpc/main/xpc-center.helper.ts"],"names":["ipcMain"],"mappings":"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","file":"index.mjs","sourcesContent":["import { Semaphore } from 'rig-foundation';\nimport { XpcPayload } from '../shared/xpc.type';\n\nexport class XpcTask implements XpcPayload {\n  id: string;\n  handleName: string;\n  params?: any;\n  ret?: any;\n\n  private semaphore: Semaphore;\n\n  constructor(payload: XpcPayload) {\n    this.id = payload.id;\n    this.handleName = payload.handleName;\n    this.params = payload.params;\n    this.ret = payload.ret ?? null;\n    this.semaphore = new Semaphore(1);\n    this.semaphore.take(() => {});\n  }\n\n  /** Block until unblock() is called */\n  block(): Promise<void> {\n    return this.semaphore.takeAsync();\n  }\n\n  /** Release the semaphore, unblocking the waiting block() call */\n  unblock(): void {\n    this.semaphore.leave();\n  }\n\n  /** Convert to a plain XpcPayload (serializable for IPC) */\n  toPayload(): XpcPayload {\n    return {\n      id: this.id,\n      handleName: this.handleName,\n      params: this.params,\n      ret: this.ret,\n    };\n  }\n}\n","/**\n * High-performance process-unique ID generator.\n * Combines a random prefix (per process) with an incrementing counter.\n * Guaranteed unique within a single process lifetime.\n */\nconst prefix = Math.random().toString(36).slice(2, 8);\nlet counter = 0;\n\nexport const generateXpcId = (): string => {\n  return `${prefix}-${(++counter).toString(36)}`;\n};\n","import { app, ipcMain } from 'electron';\nimport type { PathName } from '../shared/pathHelper.type';\n\nconst IPC_GET_APP_PATH = '__buff_path_getAppPath__';\nconst IPC_GET_PATH = '__buff_path_getPath__';\nconst IPC_GET_USER_DATA_PATH = '__buff_path_getUserDataPath__';\n\nclass PathMainHelper {\n  init(): void {\n    this.setupListeners();\n  }\n\n  private setupListeners(): void {\n    ipcMain.handle(IPC_GET_APP_PATH, () => {\n      return app.getAppPath();\n    });\n\n    ipcMain.handle(IPC_GET_PATH, (_event, name: PathName) => {\n      return app.getPath(name);\n    });\n\n    ipcMain.handle(IPC_GET_USER_DATA_PATH, () => {\n      return this.getUserDataPath();\n    });\n  }\n\n  /** Get the app installation path */\n  getAppPath(): string {\n    return app.getAppPath();\n  }\n\n  /** Get a special directory or file path by name */\n  getPath(name: PathName): string {\n    return app.getPath(name);\n  }\n\n  /** Get the user data path (e.g. Application Support on macOS, Roaming on Windows) */\n  getUserDataPath(): string {\n    return app.getPath('userData');\n  }\n\n}\n\nexport const pathMainHelper = new PathMainHelper();\n","import { XpcPayload } from '../shared/xpc.type';\nimport { xpcCenter } from './xpc-center.helper';\n\ntype XpcHandler = (payload: XpcPayload) => Promise<any>;\n\n/**\n * XpcMain: runs in the main process.\n * - handle(): register a handler callable by renderers or other main-process code.\n * - send(): invoke a registered handleName (main-process or renderer), delegating to xpcCenter.\n */\nclass XpcMain {\n  private handlers = new Map<string, XpcHandler>();\n\n  /**\n   * Register a handler in the main process.\n   * When another renderer calls send() with this handleName, xpcCenter will\n   * invoke this handler directly (webContentsId = 0) without forwarding to a renderer.\n   */\n  handle(handleName: string, handler: XpcHandler): void {\n    this.handlers.set(handleName, handler);\n    xpcCenter.registerMainHandler(handleName);\n  }\n\n  /**\n   * Get the registered handler for a given handleName.\n   */\n  getHandler(handleName: string): XpcHandler | undefined {\n    return this.handlers.get(handleName);\n  }\n\n  /**\n   * Send a message to a registered handler by handleName.\n   * Delegates to xpcCenter.exec() which handles both main-process and renderer targets.\n   */\n  async send(handleName: string, params?: any): Promise<any> {\n    return xpcCenter.exec(handleName, params);\n  }\n}\n\nexport const xpcMain = new XpcMain();\n","import { ipcMain, webContents } from 'electron';\nimport { XpcPayload } from '../shared/xpc.type';\nimport { XpcTask } from './xpc-task.helper';\nimport { generateXpcId } from './xpc-id.helper';\nimport { pathMainHelper } from '../../pathHelper/main/pathMain.helper';\nimport { xpcMain } from './xpc-main.helper';\n\nconst XPC_REGISTER = '__xpc_register__';\nconst XPC_EXEC = '__xpc_exec__';\nconst XPC_FINISH = '__xpc_finish__';\n\n/**\n * XpcCenter: runs in the main process.\n * - Listens for __xpc_register__: renderer registers a handleName, center stores {handleName → webContentsId}\n * - Listens for __xpc_exec__ (ipcMain.handle): renderer invokes exec, center forwards to target renderer,\n *   blocks via semaphore until __xpc_finish__ is received, then returns result.\n * - Listens for __xpc_finish__: target renderer finished execution, unblocks the pending task.\n */\nclass XpcCenter {\n  /** handleName → webContentsId */\n  private registry = new Map<string, number>();\n  /** task.id → XpcTask (with semaphore block/unblock) */\n  private pendingTasks = new Map<string, XpcTask>();\n\n  init(): void {\n    pathMainHelper.init();\n    this.setupListeners();\n  }\n\n  /**\n   * Register a main-process handleName in the registry with webContentsId = 0.\n   */\n  registerMainHandler(handleName: string): void {\n    this.registry.set(handleName, 0);\n  }\n\n  /**\n   * Execute a handleName: if main-process handler, call directly;\n   * otherwise forward to target renderer, block until __xpc_finish__.\n   * Used by both ipcMain.handle(XPC_EXEC) and xpcMain.send().\n   */\n  async exec(handleName: string, params?: any): Promise<any> {\n    const targetId = this.registry.get(handleName);\n    if (targetId == null) {\n      return null;\n    }\n\n    const payload: XpcPayload = {\n      id: generateXpcId(),\n      handleName,\n      params,\n    };\n\n    // targetId === 0 means the handler is registered in the main process\n    if (targetId === 0) {\n      const handler = xpcMain.getHandler(handleName);\n      if (!handler) {\n        return null;\n      }\n      try {\n        return await handler(payload);\n      } catch (_e) {\n        return null;\n      }\n    }\n\n    const target = webContents.fromId(targetId);\n    if (!target || target.isDestroyed() || target.isCrashed()) {\n      return null;\n    }\n\n    // Create semaphore-blocked task\n    const task = new XpcTask(payload);\n\n    this.pendingTasks.set(task.id, task);\n\n    // Forward handleName event + payload to target renderer\n    target.send(handleName, payload);\n\n    // Block until __xpc_finish__ unblocks\n    await task.block();\n    this.pendingTasks.delete(task.id);\n\n    return task.toPayload().ret ?? null;\n  }\n\n  private setupListeners(): void {\n    // Renderer registers a handleName\n    ipcMain.on(XPC_REGISTER, (event, payload: { handleName: string }) => {\n      this.registry.set(payload.handleName, event.sender.id);\n    });\n\n    // Renderer invokes exec via IPC\n    ipcMain.handle(XPC_EXEC, async (_event, payload: XpcPayload): Promise<any> => {\n      return this.exec(payload.handleName, payload.params);\n    });\n\n    // Target renderer finished execution, unblock pending task\n    ipcMain.on(XPC_FINISH, (_event, payload: XpcPayload) => {\n      const task = this.pendingTasks.get(payload.id);\n      if (task) {\n        task.ret = payload.ret ?? null;\n        task.unblock();\n      }\n    });\n  }\n}\n\nexport const xpcCenter = new XpcCenter();\n"]}

package/dist/xpc/preload/index.d.mts

@@ -0,0 +1,50 @@
+type XpcPayload = {
+    /** Unique task ID, guaranteed unique within process lifetime */
+    id: string;
+    /** Event handle name */
+    handleName: string;
+    /** Parameters, nullable */
+    params?: any;
+    /** Return data from target process, nullable, defaults to null */
+    ret?: any;
+};
+
+type XpcHandler = (payload: XpcPayload) => Promise<any>;
+/**
+ * XpcRenderer: runs in the renderer process (via preload).
+ * - register({handleName}): registers a handleName with main process, also sets up local listener
+ * - handle(handleName, handler): registers handler locally + sends __xpc_register__ to main
+ * - send(handleName, params): invokes __xpc_exec__ on main, awaits result via ipcRenderer.invoke
+ */
+declare class XpcRenderer {
+    private handlers;
+    /**
+     * Register a handleName with the main process and bind a local async handler.
+     * When another renderer calls send() with this handleName, xpcCenter will forward
+     * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.
+     */
+    handle(handleName: string, handler: XpcHandler): void;
+    /**
+     * Remove a registered handler.
+     */
+    removeHandle(handleName: string): void;
+    /**
+     * Send a message to another renderer (or any registered handler) via main process.
+     * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.
+     * Returns the ret value from the target handler, or null.
+     */
+    send(handleName: string, params?: any): Promise<any>;
+}
+declare const xpcRenderer: XpcRenderer;
+type XpcRendererApi = {
+    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;
+    removeHandle: (handleName: string) => void;
+    send: (handleName: string, params?: any) => Promise<any>;
+};
+/**
+ * Returns a contextBridge-safe object for exposeInMainWorld.
+ * Usage: contextBridge.exposeInMainWorld('xpcRenderer', exposeXpcRenderer())
+ */
+declare const exposeXpcRenderer: () => XpcRendererApi;
+
+export { type XpcPayload, type XpcRendererApi, exposeXpcRenderer, xpcRenderer };

package/dist/xpc/preload/index.d.ts

@@ -0,0 +1,50 @@
+type XpcPayload = {
+    /** Unique task ID, guaranteed unique within process lifetime */
+    id: string;
+    /** Event handle name */
+    handleName: string;
+    /** Parameters, nullable */
+    params?: any;
+    /** Return data from target process, nullable, defaults to null */
+    ret?: any;
+};
+
+type XpcHandler = (payload: XpcPayload) => Promise<any>;
+/**
+ * XpcRenderer: runs in the renderer process (via preload).
+ * - register({handleName}): registers a handleName with main process, also sets up local listener
+ * - handle(handleName, handler): registers handler locally + sends __xpc_register__ to main
+ * - send(handleName, params): invokes __xpc_exec__ on main, awaits result via ipcRenderer.invoke
+ */
+declare class XpcRenderer {
+    private handlers;
+    /**
+     * Register a handleName with the main process and bind a local async handler.
+     * When another renderer calls send() with this handleName, xpcCenter will forward
+     * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.
+     */
+    handle(handleName: string, handler: XpcHandler): void;
+    /**
+     * Remove a registered handler.
+     */
+    removeHandle(handleName: string): void;
+    /**
+     * Send a message to another renderer (or any registered handler) via main process.
+     * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.
+     * Returns the ret value from the target handler, or null.
+     */
+    send(handleName: string, params?: any): Promise<any>;
+}
+declare const xpcRenderer: XpcRenderer;
+type XpcRendererApi = {
+    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;
+    removeHandle: (handleName: string) => void;
+    send: (handleName: string, params?: any) => Promise<any>;
+};
+/**
+ * Returns a contextBridge-safe object for exposeInMainWorld.
+ * Usage: contextBridge.exposeInMainWorld('xpcRenderer', exposeXpcRenderer())
+ */
+declare const exposeXpcRenderer: () => XpcRendererApi;
+
+export { type XpcPayload, type XpcRendererApi, exposeXpcRenderer, xpcRenderer };

package/dist/xpc/preload/index.js

@@ -0,0 +1,88 @@
+'use strict';
+
+var electron = require('electron');
+
+// src/xpc/preload/xpc-renderer.helper.ts
+
+// src/xpc/preload/xpc-id.helper.ts
+var prefix = Math.random().toString(36).slice(2, 8);
+var counter = 0;
+var generateXpcId = () => {
+  return `r-${prefix}-${(++counter).toString(36)}`;
+};
+
+// src/xpc/preload/xpc-renderer.helper.ts
+var XPC_REGISTER = "__xpc_register__";
+var XPC_EXEC = "__xpc_exec__";
+var XPC_FINISH = "__xpc_finish__";
+var XpcRenderer = class {
+  constructor() {
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a handleName with the main process and bind a local async handler.
+   * When another renderer calls send() with this handleName, xpcCenter will forward
+   * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.
+   */
+  handle(handleName, handler) {
+    this.handlers.set(handleName, handler);
+    electron.ipcRenderer.send(XPC_REGISTER, { handleName });
+    electron.ipcRenderer.on(handleName, async (_event, payload) => {
+      let ret = null;
+      const localHandler = this.handlers.get(handleName);
+      if (localHandler) {
+        try {
+          ret = await localHandler(payload);
+        } catch (_e) {
+          ret = null;
+        }
+      }
+      electron.ipcRenderer.send(XPC_FINISH, {
+        id: payload.id,
+        handleName: payload.handleName,
+        params: payload.params,
+        ret
+      });
+    });
+  }
+  /**
+   * Remove a registered handler.
+   */
+  removeHandle(handleName) {
+    this.handlers.delete(handleName);
+    electron.ipcRenderer.removeAllListeners(handleName);
+  }
+  /**
+   * Send a message to another renderer (or any registered handler) via main process.
+   * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.
+   * Returns the ret value from the target handler, or null.
+   */
+  async send(handleName, params) {
+    const payload = {
+      id: generateXpcId(),
+      handleName,
+      params,
+      ret: null
+    };
+    return await electron.ipcRenderer.invoke(XPC_EXEC, payload);
+  }
+};
+var xpcRenderer = new XpcRenderer();
+var exposeXpcRenderer = () => {
+  return {
+    handle: (handleName, handler) => {
+      xpcRenderer.handle(handleName, handler);
+    },
+    removeHandle: (handleName) => {
+      xpcRenderer.removeHandle(handleName);
+    },
+    send: (handleName, params) => {
+      return xpcRenderer.send(handleName, params);
+    }
+  };
+};
+
+exports.exposeXpcRenderer = exposeXpcRenderer;
+exports.xpcRenderer = xpcRenderer;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/xpc/preload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/xpc/preload/xpc-id.helper.ts","../../../src/xpc/preload/xpc-renderer.helper.ts"],"names":["ipcRenderer"],"mappings":";;;;;;;AAKA,IAAM,MAAA,GAAS,KAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACpD,IAAI,OAAA,GAAU,CAAA;AAEP,IAAM,gBAAgB,MAAc;AACzC,EAAA,OAAO,KAAK,MAAM,CAAA,CAAA,EAAA,CAAK,EAAE,OAAA,EAAS,QAAA,CAAS,EAAE,CAAC,CAAA,CAAA;AAChD,CAAA;;;ACNA,IAAM,YAAA,GAAe,kBAAA;AACrB,IAAM,QAAA,GAAW,cAAA;AACjB,IAAM,UAAA,GAAa,gBAAA;AAUnB,IAAM,cAAN,MAAkB;AAAA,EAAlB,WAAA,GAAA;AACE,IAAA,IAAA,CAAQ,QAAA,uBAAe,GAAA,EAAwB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/C,MAAA,CAAO,YAAoB,OAAA,EAA2B;AACpD,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,UAAA,EAAY,OAAO,CAAA;AAGrC,IAAAA,oBAAA,CAAY,IAAA,CAAK,YAAA,EAAc,EAAE,UAAA,EAAY,CAAA;AAG7C,IAAAA,oBAAA,CAAY,EAAA,CAAG,UAAA,EAAY,OAAO,MAAA,EAAQ,OAAA,KAAwB;AAChE,MAAA,IAAI,GAAA,GAAW,IAAA;AACf,MAAA,MAAM,YAAA,GAAe,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,UAAU,CAAA;AACjD,MAAA,IAAI,YAAA,EAAc;AAChB,QAAA,IAAI;AACF,UAAA,GAAA,GAAM,MAAM,aAAa,OAAO,CAAA;AAAA,QAClC,SAAS,EAAA,EAAI;AACX,UAAA,GAAA,GAAM,IAAA;AAAA,QACR;AAAA,MACF;AAEA,MAAAA,oBAAA,CAAY,KAAK,UAAA,EAAY;AAAA,QAC3B,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,YAAY,OAAA,CAAQ,UAAA;AAAA,QACpB,QAAQ,OAAA,CAAQ,MAAA;AAAA,QAChB;AAAA,OACa,CAAA;AAAA,IACjB,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,UAAA,EAA0B;AACrC,IAAA,IAAA,CAAK,QAAA,CAAS,OAAO,UAAU,CAAA;AAC/B,IAAAA,oBAAA,CAAY,mBAAmB,UAAU,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAA,CAAK,UAAA,EAAoB,MAAA,EAA4B;AACzD,IAAA,MAAM,OAAA,GAAsB;AAAA,MAC1B,IAAI,aAAA,EAAc;AAAA,MAClB,UAAA;AAAA,MACA,MAAA;AAAA,MACA,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,OAAO,MAAMA,oBAAA,CAAY,MAAA,CAAO,QAAA,EAAU,OAAO,CAAA;AAAA,EACnD;AACF,CAAA;AAEO,IAAM,WAAA,GAAc,IAAI,WAAA;AAYxB,IAAM,oBAAoB,MAAsB;AACrD,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,CAAC,UAAA,EAAoB,OAAA,KAAyD;AACpF,MAAA,WAAA,CAAY,MAAA,CAAO,YAAY,OAAO,CAAA;AAAA,IACxC,CAAA;AAAA,IACA,YAAA,EAAc,CAAC,UAAA,KAA6B;AAC1C,MAAA,WAAA,CAAY,aAAa,UAAU,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,IAAA,EAAM,CAAC,UAAA,EAAoB,MAAA,KAA+B;AACxD,MAAA,OAAO,WAAA,CAAY,IAAA,CAAK,UAAA,EAAY,MAAM,CAAA;AAAA,IAC5C;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * High-performance process-unique ID generator for renderer process.\n * Combines a random prefix (per process) with an incrementing counter.\n * Guaranteed unique within a single process lifetime.\n */\nconst prefix = Math.random().toString(36).slice(2, 8);\nlet counter = 0;\n\nexport const generateXpcId = (): string => {\n  return `r-${prefix}-${(++counter).toString(36)}`;\n};\n","import { ipcRenderer } from 'electron';\nimport { XpcPayload } from '../shared/xpc.type';\nimport { generateXpcId } from './xpc-id.helper';\n\nconst XPC_REGISTER = '__xpc_register__';\nconst XPC_EXEC = '__xpc_exec__';\nconst XPC_FINISH = '__xpc_finish__';\n\ntype XpcHandler = (payload: XpcPayload) => Promise<any>;\n\n/**\n * XpcRenderer: runs in the renderer process (via preload).\n * - register({handleName}): registers a handleName with main process, also sets up local listener\n * - handle(handleName, handler): registers handler locally + sends __xpc_register__ to main\n * - send(handleName, params): invokes __xpc_exec__ on main, awaits result via ipcRenderer.invoke\n */\nclass XpcRenderer {\n  private handlers = new Map<string, XpcHandler>();\n\n  /**\n   * Register a handleName with the main process and bind a local async handler.\n   * When another renderer calls send() with this handleName, xpcCenter will forward\n   * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.\n   */\n  handle(handleName: string, handler: XpcHandler): void {\n    this.handlers.set(handleName, handler);\n\n    // Notify main process about this registration\n    ipcRenderer.send(XPC_REGISTER, { handleName });\n\n    // Listen for incoming handleName events forwarded by xpcCenter\n    ipcRenderer.on(handleName, async (_event, payload: XpcPayload) => {\n      let ret: any = null;\n      const localHandler = this.handlers.get(handleName);\n      if (localHandler) {\n        try {\n          ret = await localHandler(payload);\n        } catch (_e) {\n          ret = null;\n        }\n      }\n      // Send __xpc_finish__ back to main with result\n      ipcRenderer.send(XPC_FINISH, {\n        id: payload.id,\n        handleName: payload.handleName,\n        params: payload.params,\n        ret,\n      } as XpcPayload);\n    });\n  }\n\n  /**\n   * Remove a registered handler.\n   */\n  removeHandle(handleName: string): void {\n    this.handlers.delete(handleName);\n    ipcRenderer.removeAllListeners(handleName);\n  }\n\n  /**\n   * Send a message to another renderer (or any registered handler) via main process.\n   * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.\n   * Returns the ret value from the target handler, or null.\n   */\n  async send(handleName: string, params?: any): Promise<any> {\n    const payload: XpcPayload = {\n      id: generateXpcId(),\n      handleName,\n      params,\n      ret: null,\n    };\n\n    return await ipcRenderer.invoke(XPC_EXEC, payload);\n  }\n}\n\nexport const xpcRenderer = new XpcRenderer();\n\nexport type XpcRendererApi = {\n  handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;\n  removeHandle: (handleName: string) => void;\n  send: (handleName: string, params?: any) => Promise<any>;\n};\n\n/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n * Usage: contextBridge.exposeInMainWorld('xpcRenderer', exposeXpcRenderer())\n */\nexport const exposeXpcRenderer = (): XpcRendererApi => {\n  return {\n    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>): void => {\n      xpcRenderer.handle(handleName, handler);\n    },\n    removeHandle: (handleName: string): void => {\n      xpcRenderer.removeHandle(handleName);\n    },\n    send: (handleName: string, params?: any): Promise<any> => {\n      return xpcRenderer.send(handleName, params);\n    },\n  };\n};\n"]}

package/dist/xpc/preload/index.mjs

@@ -0,0 +1,85 @@
+import { ipcRenderer } from 'electron';
+
+// src/xpc/preload/xpc-renderer.helper.ts
+
+// src/xpc/preload/xpc-id.helper.ts
+var prefix = Math.random().toString(36).slice(2, 8);
+var counter = 0;
+var generateXpcId = () => {
+  return `r-${prefix}-${(++counter).toString(36)}`;
+};
+
+// src/xpc/preload/xpc-renderer.helper.ts
+var XPC_REGISTER = "__xpc_register__";
+var XPC_EXEC = "__xpc_exec__";
+var XPC_FINISH = "__xpc_finish__";
+var XpcRenderer = class {
+  constructor() {
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a handleName with the main process and bind a local async handler.
+   * When another renderer calls send() with this handleName, xpcCenter will forward
+   * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.
+   */
+  handle(handleName, handler) {
+    this.handlers.set(handleName, handler);
+    ipcRenderer.send(XPC_REGISTER, { handleName });
+    ipcRenderer.on(handleName, async (_event, payload) => {
+      let ret = null;
+      const localHandler = this.handlers.get(handleName);
+      if (localHandler) {
+        try {
+          ret = await localHandler(payload);
+        } catch (_e) {
+          ret = null;
+        }
+      }
+      ipcRenderer.send(XPC_FINISH, {
+        id: payload.id,
+        handleName: payload.handleName,
+        params: payload.params,
+        ret
+      });
+    });
+  }
+  /**
+   * Remove a registered handler.
+   */
+  removeHandle(handleName) {
+    this.handlers.delete(handleName);
+    ipcRenderer.removeAllListeners(handleName);
+  }
+  /**
+   * Send a message to another renderer (or any registered handler) via main process.
+   * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.
+   * Returns the ret value from the target handler, or null.
+   */
+  async send(handleName, params) {
+    const payload = {
+      id: generateXpcId(),
+      handleName,
+      params,
+      ret: null
+    };
+    return await ipcRenderer.invoke(XPC_EXEC, payload);
+  }
+};
+var xpcRenderer = new XpcRenderer();
+var exposeXpcRenderer = () => {
+  return {
+    handle: (handleName, handler) => {
+      xpcRenderer.handle(handleName, handler);
+    },
+    removeHandle: (handleName) => {
+      xpcRenderer.removeHandle(handleName);
+    },
+    send: (handleName, params) => {
+      return xpcRenderer.send(handleName, params);
+    }
+  };
+};
+
+export { exposeXpcRenderer, xpcRenderer };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/xpc/preload/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/xpc/preload/xpc-id.helper.ts","../../../src/xpc/preload/xpc-renderer.helper.ts"],"names":[],"mappings":";;;;;AAKA,IAAM,MAAA,GAAS,KAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AACpD,IAAI,OAAA,GAAU,CAAA;AAEP,IAAM,gBAAgB,MAAc;AACzC,EAAA,OAAO,KAAK,MAAM,CAAA,CAAA,EAAA,CAAK,EAAE,OAAA,EAAS,QAAA,CAAS,EAAE,CAAC,CAAA,CAAA;AAChD,CAAA;;;ACNA,IAAM,YAAA,GAAe,kBAAA;AACrB,IAAM,QAAA,GAAW,cAAA;AACjB,IAAM,UAAA,GAAa,gBAAA;AAUnB,IAAM,cAAN,MAAkB;AAAA,EAAlB,WAAA,GAAA;AACE,IAAA,IAAA,CAAQ,QAAA,uBAAe,GAAA,EAAwB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/C,MAAA,CAAO,YAAoB,OAAA,EAA2B;AACpD,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,UAAA,EAAY,OAAO,CAAA;AAGrC,IAAA,WAAA,CAAY,IAAA,CAAK,YAAA,EAAc,EAAE,UAAA,EAAY,CAAA;AAG7C,IAAA,WAAA,CAAY,EAAA,CAAG,UAAA,EAAY,OAAO,MAAA,EAAQ,OAAA,KAAwB;AAChE,MAAA,IAAI,GAAA,GAAW,IAAA;AACf,MAAA,MAAM,YAAA,GAAe,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,UAAU,CAAA;AACjD,MAAA,IAAI,YAAA,EAAc;AAChB,QAAA,IAAI;AACF,UAAA,GAAA,GAAM,MAAM,aAAa,OAAO,CAAA;AAAA,QAClC,SAAS,EAAA,EAAI;AACX,UAAA,GAAA,GAAM,IAAA;AAAA,QACR;AAAA,MACF;AAEA,MAAA,WAAA,CAAY,KAAK,UAAA,EAAY;AAAA,QAC3B,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,YAAY,OAAA,CAAQ,UAAA;AAAA,QACpB,QAAQ,OAAA,CAAQ,MAAA;AAAA,QAChB;AAAA,OACa,CAAA;AAAA,IACjB,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,UAAA,EAA0B;AACrC,IAAA,IAAA,CAAK,QAAA,CAAS,OAAO,UAAU,CAAA;AAC/B,IAAA,WAAA,CAAY,mBAAmB,UAAU,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAA,CAAK,UAAA,EAAoB,MAAA,EAA4B;AACzD,IAAA,MAAM,OAAA,GAAsB;AAAA,MAC1B,IAAI,aAAA,EAAc;AAAA,MAClB,UAAA;AAAA,MACA,MAAA;AAAA,MACA,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,QAAA,EAAU,OAAO,CAAA;AAAA,EACnD;AACF,CAAA;AAEO,IAAM,WAAA,GAAc,IAAI,WAAA;AAYxB,IAAM,oBAAoB,MAAsB;AACrD,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,CAAC,UAAA,EAAoB,OAAA,KAAyD;AACpF,MAAA,WAAA,CAAY,MAAA,CAAO,YAAY,OAAO,CAAA;AAAA,IACxC,CAAA;AAAA,IACA,YAAA,EAAc,CAAC,UAAA,KAA6B;AAC1C,MAAA,WAAA,CAAY,aAAa,UAAU,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,IAAA,EAAM,CAAC,UAAA,EAAoB,MAAA,KAA+B;AACxD,MAAA,OAAO,WAAA,CAAY,IAAA,CAAK,UAAA,EAAY,MAAM,CAAA;AAAA,IAC5C;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["/**\n * High-performance process-unique ID generator for renderer process.\n * Combines a random prefix (per process) with an incrementing counter.\n * Guaranteed unique within a single process lifetime.\n */\nconst prefix = Math.random().toString(36).slice(2, 8);\nlet counter = 0;\n\nexport const generateXpcId = (): string => {\n  return `r-${prefix}-${(++counter).toString(36)}`;\n};\n","import { ipcRenderer } from 'electron';\nimport { XpcPayload } from '../shared/xpc.type';\nimport { generateXpcId } from './xpc-id.helper';\n\nconst XPC_REGISTER = '__xpc_register__';\nconst XPC_EXEC = '__xpc_exec__';\nconst XPC_FINISH = '__xpc_finish__';\n\ntype XpcHandler = (payload: XpcPayload) => Promise<any>;\n\n/**\n * XpcRenderer: runs in the renderer process (via preload).\n * - register({handleName}): registers a handleName with main process, also sets up local listener\n * - handle(handleName, handler): registers handler locally + sends __xpc_register__ to main\n * - send(handleName, params): invokes __xpc_exec__ on main, awaits result via ipcRenderer.invoke\n */\nclass XpcRenderer {\n  private handlers = new Map<string, XpcHandler>();\n\n  /**\n   * Register a handleName with the main process and bind a local async handler.\n   * When another renderer calls send() with this handleName, xpcCenter will forward\n   * the payload to this renderer, the handler executes, and result is sent back via __xpc_finish__.\n   */\n  handle(handleName: string, handler: XpcHandler): void {\n    this.handlers.set(handleName, handler);\n\n    // Notify main process about this registration\n    ipcRenderer.send(XPC_REGISTER, { handleName });\n\n    // Listen for incoming handleName events forwarded by xpcCenter\n    ipcRenderer.on(handleName, async (_event, payload: XpcPayload) => {\n      let ret: any = null;\n      const localHandler = this.handlers.get(handleName);\n      if (localHandler) {\n        try {\n          ret = await localHandler(payload);\n        } catch (_e) {\n          ret = null;\n        }\n      }\n      // Send __xpc_finish__ back to main with result\n      ipcRenderer.send(XPC_FINISH, {\n        id: payload.id,\n        handleName: payload.handleName,\n        params: payload.params,\n        ret,\n      } as XpcPayload);\n    });\n  }\n\n  /**\n   * Remove a registered handler.\n   */\n  removeHandle(handleName: string): void {\n    this.handlers.delete(handleName);\n    ipcRenderer.removeAllListeners(handleName);\n  }\n\n  /**\n   * Send a message to another renderer (or any registered handler) via main process.\n   * Uses ipcRenderer.invoke(__xpc_exec__) which blocks until the target finishes.\n   * Returns the ret value from the target handler, or null.\n   */\n  async send(handleName: string, params?: any): Promise<any> {\n    const payload: XpcPayload = {\n      id: generateXpcId(),\n      handleName,\n      params,\n      ret: null,\n    };\n\n    return await ipcRenderer.invoke(XPC_EXEC, payload);\n  }\n}\n\nexport const xpcRenderer = new XpcRenderer();\n\nexport type XpcRendererApi = {\n  handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;\n  removeHandle: (handleName: string) => void;\n  send: (handleName: string, params?: any) => Promise<any>;\n};\n\n/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n * Usage: contextBridge.exposeInMainWorld('xpcRenderer', exposeXpcRenderer())\n */\nexport const exposeXpcRenderer = (): XpcRendererApi => {\n  return {\n    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>): void => {\n      xpcRenderer.handle(handleName, handler);\n    },\n    removeHandle: (handleName: string): void => {\n      xpcRenderer.removeHandle(handleName);\n    },\n    send: (handleName: string, params?: any): Promise<any> => {\n      return xpcRenderer.send(handleName, params);\n    },\n  };\n};\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "electron-buff",
+  "version": "1.0.3",
+  "description": "Electron enhancement utilities for electron-vite projects",
+  "exports": {
+    "./xpc/main": {
+      "require": {
+        "types": "./dist/xpc/main/index.d.ts",
+        "default": "./dist/xpc/main/index.js"
+      },
+      "import": {
+        "types": "./dist/xpc/main/index.d.mts",
+        "default": "./dist/xpc/main/index.mjs"
+      }
+    },
+    "./xpc/preload": {
+      "require": {
+        "types": "./dist/xpc/preload/index.d.ts",
+        "default": "./dist/xpc/preload/index.js"
+      },
+      "import": {
+        "types": "./dist/xpc/preload/index.d.mts",
+        "default": "./dist/xpc/preload/index.mjs"
+      }
+    },
+    "./pathHelper/main": {
+      "require": {
+        "types": "./dist/pathHelper/main/index.d.ts",
+        "default": "./dist/pathHelper/main/index.js"
+      },
+      "import": {
+        "types": "./dist/pathHelper/main/index.d.mts",
+        "default": "./dist/pathHelper/main/index.mjs"
+      }
+    },
+    "./pathHelper/renderer": {
+      "require": {
+        "types": "./dist/pathHelper/renderer/index.d.ts",
+        "default": "./dist/pathHelper/renderer/index.js"
+      },
+      "import": {
+        "types": "./dist/pathHelper/renderer/index.d.mts",
+        "default": "./dist/pathHelper/renderer/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "yarn build",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "electron": ">=20.0.0",
+    "rig-foundation": ">=1.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "repository": "git@github.com:FlashHand/electron-buff.git",
+  "author": "WangBo <ralwayne@163.com>",
+  "license": "MIT"
+}