electron-buff 1.0.3 → 1.0.6

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

@@ -8,43 +8,66 @@ type XpcPayload = {
     /** Return data from target process, nullable, defaults to null */
     ret?: any;
 };
+type XpcRendererApi = {
+    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;
+    removeHandle: (handleName: string) => void;
+    send: (handleName: string, params?: any) => Promise<any>;
+};
 
 type XpcHandler = (payload: XpcPayload) => Promise<any>;
+/** Global handlers map, extracted from XpcRenderer class */
+declare const xpcHandlers: Map<string, XpcHandler>;
+
+/** The xpcRenderer API instance */
+declare const xpcRenderer: XpcRendererApi;
+
 /**
- * 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
+ * Base class for preload-process xpc handlers.
+ * Subclass this and define async methods — they will be auto-registered
+ * as xpc handlers with channel `xpc:ClassName/methodName`.
+ *
+ * Example:
+ * ```ts
+ * class UserTable extends XpcPreloadHandler {
+ *   async getUserList(params?: any): Promise<any> { ... }
+ * }
+ * const userTable = new UserTable();
+ * // auto-registers handler for 'xpc:UserTable/getUserList'
+ * ```
  */
-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 class XpcPreloadHandler {
+    constructor();
 }
-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>;
+
+/**
+ * Helper: checks if a function type has at most 1 parameter.
+ * Returns the function type itself if valid, `never` otherwise.
+ */
+type AssertSingleParam<F> = F extends () => any ? F : F extends (p: any) => any ? F extends (p: any, q: any, ...rest: any[]) => any ? never : F : never;
+/**
+ * Utility type: extracts the method signatures from a handler class,
+ * turning each method into an emitter-compatible signature.
+ * Methods with 2+ parameters are mapped to `never`, causing a compile error on use.
+ */
+type XpcEmitterOf<T> = {
+    [K in keyof T as T[K] extends (...args: any[]) => any ? K : never]: AssertSingleParam<T[K]> extends never ? never : T[K] extends (params: infer P) => any ? (params: P) => Promise<any> : () => Promise<any>;
 };
+
 /**
- * Returns a contextBridge-safe object for exposeInMainWorld.
- * Usage: contextBridge.exposeInMainWorld('xpcRenderer', exposeXpcRenderer())
+ * Create a type-safe emitter proxy for a preload-process xpc handler.
+ * The emitter mirrors the handler's method signatures, but each call
+ * sends a message via xpcRenderer.send() to `xpc:ClassName/methodName`.
+ *
+ * Example:
+ * ```ts
+ * class UserTable extends XpcPreloadHandler {
+ *   async getUserList(params?: any): Promise<any> { ... }
+ * }
+ * const userTableEmitter = createXpcPreloadEmitter<UserTable>('UserTable');
+ * const list = await userTableEmitter.getUserList({ page: 1 });
+ * // sends to 'xpc:UserTable/getUserList'
+ * ```
  */
-declare const exposeXpcRenderer: () => XpcRendererApi;
+declare const createXpcPreloadEmitter: <T>(className: string) => XpcEmitterOf<T>;
 
-export { type XpcPayload, type XpcRendererApi, exposeXpcRenderer, xpcRenderer };
+export { type XpcEmitterOf, type XpcPayload, XpcPreloadHandler, type XpcRendererApi, createXpcPreloadEmitter, xpcHandlers, xpcRenderer };

package/dist/xpc/preload/index.js

@@ -2,87 +2,124 @@
 
 var electron = require('electron');
 
-// src/xpc/preload/xpc-renderer.helper.ts
+// src/xpc/preload/xpcPreload.helper.ts
 
-// src/xpc/preload/xpc-id.helper.ts
+// src/xpc/preload/xpcId.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
+// src/xpc/preload/xpcPreload.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;
-        }
+var xpcHandlers = /* @__PURE__ */ new Map();
+var handle = (handleName, handler) => {
+  xpcHandlers.set(handleName, handler);
+  electron.ipcRenderer.send(XPC_REGISTER, { handleName });
+  electron.ipcRenderer.on(handleName, async (_event, payload) => {
+    let ret = null;
+    const localHandler = xpcHandlers.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
-      });
+    }
+    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 = () => {
+var removeHandle = (handleName) => {
+  xpcHandlers.delete(handleName);
+  electron.ipcRenderer.removeAllListeners(handleName);
+};
+var send = async (handleName, params) => {
+  const payload = {
+    id: generateXpcId(),
+    handleName,
+    params,
+    ret: null
+  };
+  return await electron.ipcRenderer.invoke(XPC_EXEC, payload);
+};
+var createXpcRendererApi = () => {
   return {
     handle: (handleName, handler) => {
-      xpcRenderer.handle(handleName, handler);
+      handle(handleName, handler);
     },
     removeHandle: (handleName) => {
-      xpcRenderer.removeHandle(handleName);
+      removeHandle(handleName);
     },
     send: (handleName, params) => {
-      return xpcRenderer.send(handleName, params);
+      return send(handleName, params);
     }
   };
 };
+var xpcRenderer = createXpcRendererApi();
+if (process.contextIsolated) {
+  try {
+    electron.contextBridge.exposeInMainWorld("xpcRenderer", xpcRenderer);
+  } catch (error) {
+    console.error("[xpcPreload] exposeInMainWorld failed:", error);
+  }
+} else {
+  globalThis.xpcRenderer = xpcRenderer;
+}
+
+// src/xpc/shared/xpcHandler.type.ts
+var XPC_HANDLER_PREFIX = "xpc:";
+var buildXpcChannel = (className, methodName) => {
+  return `${XPC_HANDLER_PREFIX}${className}/${methodName}`;
+};
+var getHandlerMethodNames = (prototype) => {
+  const names = [];
+  const keys = Object.getOwnPropertyNames(prototype);
+  for (const key of keys) {
+    if (key === "constructor") continue;
+    const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+    if (descriptor && typeof descriptor.value === "function") {
+      names.push(key);
+    }
+  }
+  return names;
+};
+
+// src/xpc/preload/xpcPreload.handler.ts
+var XpcPreloadHandler = class {
+  constructor() {
+    const className = this.constructor.name;
+    const methodNames = getHandlerMethodNames(Object.getPrototypeOf(this));
+    for (const methodName of methodNames) {
+      const channel = buildXpcChannel(className, methodName);
+      const method = this[methodName].bind(this);
+      xpcRenderer.handle(channel, async (payload) => {
+        return await method(payload.params);
+      });
+    }
+  }
+};
+
+// src/xpc/preload/xpcPreload.emitter.ts
+var createXpcPreloadEmitter = (className) => {
+  return new Proxy({}, {
+    get(_target, prop) {
+      const channel = buildXpcChannel(className, prop);
+      return (params) => xpcRenderer.send(channel, params);
+    }
+  });
+};
 
-exports.exposeXpcRenderer = exposeXpcRenderer;
+exports.XpcPreloadHandler = XpcPreloadHandler;
+exports.createXpcPreloadEmitter = createXpcPreloadEmitter;
+exports.xpcHandlers = xpcHandlers;
 exports.xpcRenderer = xpcRenderer;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"]}
+{"version":3,"sources":["../../../src/xpc/preload/xpcId.helper.ts","../../../src/xpc/preload/xpcPreload.helper.ts","../../../src/xpc/shared/xpcHandler.type.ts","../../../src/xpc/preload/xpcPreload.handler.ts","../../../src/xpc/preload/xpcPreload.emitter.ts"],"names":["ipcRenderer","contextBridge"],"mappings":"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","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 { contextBridge, ipcRenderer } from 'electron';\nimport { XpcPayload, XpcRendererApi } from '../shared/xpc.type';\nimport { generateXpcId } from './xpcId.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/** Global handlers map, extracted from XpcRenderer class */\nexport const xpcHandlers = new Map<string, XpcHandler>();\n\nexport type { XpcRendererApi } from '../shared/xpc.type';\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 */\nconst handle = (handleName: string, handler: XpcHandler): void => {\n  xpcHandlers.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 = xpcHandlers.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 */\nconst removeHandle = (handleName: string): void => {\n  xpcHandlers.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 */\nconst send = async (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/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n */\nconst createXpcRendererApi = (): XpcRendererApi => {\n  return {\n    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>): void => {\n      handle(handleName, handler);\n    },\n    removeHandle: (handleName: string): void => {\n      removeHandle(handleName);\n    },\n    send: (handleName: string, params?: any): Promise<any> => {\n      return send(handleName, params);\n    },\n  };\n};\n\n/** The xpcRenderer API instance */\nexport const xpcRenderer: XpcRendererApi = createXpcRendererApi();\n\n// Auto-expose xpcRenderer to window on import\nif (process.contextIsolated) {\n  try {\n    contextBridge.exposeInMainWorld('xpcRenderer', xpcRenderer);\n  } catch (error) {\n    console.error('[xpcPreload] exposeInMainWorld failed:', error);\n  }\n} else {\n  (globalThis as any).xpcRenderer = xpcRenderer;\n}\n","/**\n * Prefix for all auto-registered xpc handler channels.\n * Channel format: `xpc:ClassName/methodName`\n */\nexport const XPC_HANDLER_PREFIX = 'xpc:';\n\n/**\n * Build the xpc channel name from class name and method name.\n * e.g. buildChannel('UserTable', 'getUserList') => 'xpc:UserTable/getUserList'\n */\nexport const buildXpcChannel = (className: string, methodName: string): string => {\n  return `${XPC_HANDLER_PREFIX}${className}/${methodName}`;\n};\n\n/**\n * Extract own method names from a class prototype, excluding constructor.\n */\nexport const getHandlerMethodNames = (prototype: object): string[] => {\n  const names: string[] = [];\n  const keys = Object.getOwnPropertyNames(prototype);\n  for (const key of keys) {\n    if (key === 'constructor') continue;\n    const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n    if (descriptor && typeof descriptor.value === 'function') {\n      names.push(key);\n    }\n  }\n  return names;\n};\n\n/**\n * Constraint: handler methods must accept 0 or 1 parameter.\n * Methods with 2+ parameters will fail type checking.\n */\nexport type XpcHandlerMethod = (() => Promise<any>) | ((params: any) => Promise<any>);\n\n/**\n * Helper: checks if a function type has at most 1 parameter.\n * Returns the function type itself if valid, `never` otherwise.\n */\ntype AssertSingleParam<F> =\n  F extends () => any ? F :\n  F extends (p: any) => any ?\n    F extends (p: any, q: any, ...rest: any[]) => any ? never : F\n  : never;\n\n/**\n * Utility type: extracts the method signatures from a handler class,\n * turning each method into an emitter-compatible signature.\n * Methods with 2+ parameters are mapped to `never`, causing a compile error on use.\n */\nexport type XpcEmitterOf<T> = {\n  [K in keyof T as T[K] extends (...args: any[]) => any ? K : never]:\n    AssertSingleParam<T[K]> extends never\n      ? never\n      : T[K] extends (params: infer P) => any\n        ? (params: P) => Promise<any>\n        : () => Promise<any>;\n};\n","import { XpcPayload } from '../shared/xpc.type';\nimport { buildXpcChannel, getHandlerMethodNames } from '../shared/xpcHandler.type';\nimport { xpcRenderer } from './xpcPreload.helper';\n\n/**\n * Base class for preload-process xpc handlers.\n * Subclass this and define async methods — they will be auto-registered\n * as xpc handlers with channel `xpc:ClassName/methodName`.\n *\n * Example:\n * ```ts\n * class UserTable extends XpcPreloadHandler {\n *   async getUserList(params?: any): Promise<any> { ... }\n * }\n * const userTable = new UserTable();\n * // auto-registers handler for 'xpc:UserTable/getUserList'\n * ```\n */\nexport class XpcPreloadHandler {\n  constructor() {\n    const className = this.constructor.name;\n    const methodNames = getHandlerMethodNames(Object.getPrototypeOf(this));\n    for (const methodName of methodNames) {\n      const channel = buildXpcChannel(className, methodName);\n      const method = (this as any)[methodName].bind(this);\n      xpcRenderer.handle(channel, async (payload: XpcPayload) => {\n        return await method(payload.params);\n      });\n    }\n  }\n}\n","import { buildXpcChannel, XpcEmitterOf } from '../shared/xpcHandler.type';\nimport { xpcRenderer } from './xpcPreload.helper';\n\n/**\n * Create a type-safe emitter proxy for a preload-process xpc handler.\n * The emitter mirrors the handler's method signatures, but each call\n * sends a message via xpcRenderer.send() to `xpc:ClassName/methodName`.\n *\n * Example:\n * ```ts\n * class UserTable extends XpcPreloadHandler {\n *   async getUserList(params?: any): Promise<any> { ... }\n * }\n * const userTableEmitter = createXpcPreloadEmitter<UserTable>('UserTable');\n * const list = await userTableEmitter.getUserList({ page: 1 });\n * // sends to 'xpc:UserTable/getUserList'\n * ```\n */\nexport const createXpcPreloadEmitter = <T>(className: string): XpcEmitterOf<T> => {\n  return new Proxy({} as XpcEmitterOf<T>, {\n    get(_target, prop: string) {\n      const channel = buildXpcChannel(className, prop);\n      return (params?: any) => xpcRenderer.send(channel, params);\n    },\n  });\n};\n"]}

package/dist/xpc/preload/index.mjs

@@ -1,85 +1,120 @@
-import { ipcRenderer } from 'electron';
+import { contextBridge, ipcRenderer } from 'electron';
 
-// src/xpc/preload/xpc-renderer.helper.ts
+// src/xpc/preload/xpcPreload.helper.ts
 
-// src/xpc/preload/xpc-id.helper.ts
+// src/xpc/preload/xpcId.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
+// src/xpc/preload/xpcPreload.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;
-        }
+var xpcHandlers = /* @__PURE__ */ new Map();
+var handle = (handleName, handler) => {
+  xpcHandlers.set(handleName, handler);
+  ipcRenderer.send(XPC_REGISTER, { handleName });
+  ipcRenderer.on(handleName, async (_event, payload) => {
+    let ret = null;
+    const localHandler = xpcHandlers.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
-      });
+    }
+    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 = () => {
+var removeHandle = (handleName) => {
+  xpcHandlers.delete(handleName);
+  ipcRenderer.removeAllListeners(handleName);
+};
+var send = async (handleName, params) => {
+  const payload = {
+    id: generateXpcId(),
+    handleName,
+    params,
+    ret: null
+  };
+  return await ipcRenderer.invoke(XPC_EXEC, payload);
+};
+var createXpcRendererApi = () => {
   return {
     handle: (handleName, handler) => {
-      xpcRenderer.handle(handleName, handler);
+      handle(handleName, handler);
     },
     removeHandle: (handleName) => {
-      xpcRenderer.removeHandle(handleName);
+      removeHandle(handleName);
     },
     send: (handleName, params) => {
-      return xpcRenderer.send(handleName, params);
+      return send(handleName, params);
     }
   };
 };
+var xpcRenderer = createXpcRendererApi();
+if (process.contextIsolated) {
+  try {
+    contextBridge.exposeInMainWorld("xpcRenderer", xpcRenderer);
+  } catch (error) {
+    console.error("[xpcPreload] exposeInMainWorld failed:", error);
+  }
+} else {
+  globalThis.xpcRenderer = xpcRenderer;
+}
+
+// src/xpc/shared/xpcHandler.type.ts
+var XPC_HANDLER_PREFIX = "xpc:";
+var buildXpcChannel = (className, methodName) => {
+  return `${XPC_HANDLER_PREFIX}${className}/${methodName}`;
+};
+var getHandlerMethodNames = (prototype) => {
+  const names = [];
+  const keys = Object.getOwnPropertyNames(prototype);
+  for (const key of keys) {
+    if (key === "constructor") continue;
+    const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+    if (descriptor && typeof descriptor.value === "function") {
+      names.push(key);
+    }
+  }
+  return names;
+};
+
+// src/xpc/preload/xpcPreload.handler.ts
+var XpcPreloadHandler = class {
+  constructor() {
+    const className = this.constructor.name;
+    const methodNames = getHandlerMethodNames(Object.getPrototypeOf(this));
+    for (const methodName of methodNames) {
+      const channel = buildXpcChannel(className, methodName);
+      const method = this[methodName].bind(this);
+      xpcRenderer.handle(channel, async (payload) => {
+        return await method(payload.params);
+      });
+    }
+  }
+};
+
+// src/xpc/preload/xpcPreload.emitter.ts
+var createXpcPreloadEmitter = (className) => {
+  return new Proxy({}, {
+    get(_target, prop) {
+      const channel = buildXpcChannel(className, prop);
+      return (params) => xpcRenderer.send(channel, params);
+    }
+  });
+};
 
-export { exposeXpcRenderer, xpcRenderer };
+export { XpcPreloadHandler, createXpcPreloadEmitter, xpcHandlers, xpcRenderer };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +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"]}
+{"version":3,"sources":["../../../src/xpc/preload/xpcId.helper.ts","../../../src/xpc/preload/xpcPreload.helper.ts","../../../src/xpc/shared/xpcHandler.type.ts","../../../src/xpc/preload/xpcPreload.handler.ts","../../../src/xpc/preload/xpcPreload.emitter.ts"],"names":[],"mappings":"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","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 { contextBridge, ipcRenderer } from 'electron';\nimport { XpcPayload, XpcRendererApi } from '../shared/xpc.type';\nimport { generateXpcId } from './xpcId.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/** Global handlers map, extracted from XpcRenderer class */\nexport const xpcHandlers = new Map<string, XpcHandler>();\n\nexport type { XpcRendererApi } from '../shared/xpc.type';\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 */\nconst handle = (handleName: string, handler: XpcHandler): void => {\n  xpcHandlers.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 = xpcHandlers.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 */\nconst removeHandle = (handleName: string): void => {\n  xpcHandlers.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 */\nconst send = async (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/**\n * Returns a contextBridge-safe object for exposeInMainWorld.\n */\nconst createXpcRendererApi = (): XpcRendererApi => {\n  return {\n    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>): void => {\n      handle(handleName, handler);\n    },\n    removeHandle: (handleName: string): void => {\n      removeHandle(handleName);\n    },\n    send: (handleName: string, params?: any): Promise<any> => {\n      return send(handleName, params);\n    },\n  };\n};\n\n/** The xpcRenderer API instance */\nexport const xpcRenderer: XpcRendererApi = createXpcRendererApi();\n\n// Auto-expose xpcRenderer to window on import\nif (process.contextIsolated) {\n  try {\n    contextBridge.exposeInMainWorld('xpcRenderer', xpcRenderer);\n  } catch (error) {\n    console.error('[xpcPreload] exposeInMainWorld failed:', error);\n  }\n} else {\n  (globalThis as any).xpcRenderer = xpcRenderer;\n}\n","/**\n * Prefix for all auto-registered xpc handler channels.\n * Channel format: `xpc:ClassName/methodName`\n */\nexport const XPC_HANDLER_PREFIX = 'xpc:';\n\n/**\n * Build the xpc channel name from class name and method name.\n * e.g. buildChannel('UserTable', 'getUserList') => 'xpc:UserTable/getUserList'\n */\nexport const buildXpcChannel = (className: string, methodName: string): string => {\n  return `${XPC_HANDLER_PREFIX}${className}/${methodName}`;\n};\n\n/**\n * Extract own method names from a class prototype, excluding constructor.\n */\nexport const getHandlerMethodNames = (prototype: object): string[] => {\n  const names: string[] = [];\n  const keys = Object.getOwnPropertyNames(prototype);\n  for (const key of keys) {\n    if (key === 'constructor') continue;\n    const descriptor = Object.getOwnPropertyDescriptor(prototype, key);\n    if (descriptor && typeof descriptor.value === 'function') {\n      names.push(key);\n    }\n  }\n  return names;\n};\n\n/**\n * Constraint: handler methods must accept 0 or 1 parameter.\n * Methods with 2+ parameters will fail type checking.\n */\nexport type XpcHandlerMethod = (() => Promise<any>) | ((params: any) => Promise<any>);\n\n/**\n * Helper: checks if a function type has at most 1 parameter.\n * Returns the function type itself if valid, `never` otherwise.\n */\ntype AssertSingleParam<F> =\n  F extends () => any ? F :\n  F extends (p: any) => any ?\n    F extends (p: any, q: any, ...rest: any[]) => any ? never : F\n  : never;\n\n/**\n * Utility type: extracts the method signatures from a handler class,\n * turning each method into an emitter-compatible signature.\n * Methods with 2+ parameters are mapped to `never`, causing a compile error on use.\n */\nexport type XpcEmitterOf<T> = {\n  [K in keyof T as T[K] extends (...args: any[]) => any ? K : never]:\n    AssertSingleParam<T[K]> extends never\n      ? never\n      : T[K] extends (params: infer P) => any\n        ? (params: P) => Promise<any>\n        : () => Promise<any>;\n};\n","import { XpcPayload } from '../shared/xpc.type';\nimport { buildXpcChannel, getHandlerMethodNames } from '../shared/xpcHandler.type';\nimport { xpcRenderer } from './xpcPreload.helper';\n\n/**\n * Base class for preload-process xpc handlers.\n * Subclass this and define async methods — they will be auto-registered\n * as xpc handlers with channel `xpc:ClassName/methodName`.\n *\n * Example:\n * ```ts\n * class UserTable extends XpcPreloadHandler {\n *   async getUserList(params?: any): Promise<any> { ... }\n * }\n * const userTable = new UserTable();\n * // auto-registers handler for 'xpc:UserTable/getUserList'\n * ```\n */\nexport class XpcPreloadHandler {\n  constructor() {\n    const className = this.constructor.name;\n    const methodNames = getHandlerMethodNames(Object.getPrototypeOf(this));\n    for (const methodName of methodNames) {\n      const channel = buildXpcChannel(className, methodName);\n      const method = (this as any)[methodName].bind(this);\n      xpcRenderer.handle(channel, async (payload: XpcPayload) => {\n        return await method(payload.params);\n      });\n    }\n  }\n}\n","import { buildXpcChannel, XpcEmitterOf } from '../shared/xpcHandler.type';\nimport { xpcRenderer } from './xpcPreload.helper';\n\n/**\n * Create a type-safe emitter proxy for a preload-process xpc handler.\n * The emitter mirrors the handler's method signatures, but each call\n * sends a message via xpcRenderer.send() to `xpc:ClassName/methodName`.\n *\n * Example:\n * ```ts\n * class UserTable extends XpcPreloadHandler {\n *   async getUserList(params?: any): Promise<any> { ... }\n * }\n * const userTableEmitter = createXpcPreloadEmitter<UserTable>('UserTable');\n * const list = await userTableEmitter.getUserList({ page: 1 });\n * // sends to 'xpc:UserTable/getUserList'\n * ```\n */\nexport const createXpcPreloadEmitter = <T>(className: string): XpcEmitterOf<T> => {\n  return new Proxy({} as XpcEmitterOf<T>, {\n    get(_target, prop: string) {\n      const channel = buildXpcChannel(className, prop);\n      return (params?: any) => xpcRenderer.send(channel, params);\n    },\n  });\n};\n"]}

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

@@ -0,0 +1,72 @@
+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 XpcRendererApi = {
+    handle: (handleName: string, handler: (payload: XpcPayload) => Promise<any>) => void;
+    removeHandle: (handleName: string) => void;
+    send: (handleName: string, params?: any) => Promise<any>;
+};
+
+/**
+ * Direct reference to window.xpcRenderer exposed by the preload script.
+ * Import this in renderer (browser) code to use xpcRenderer without manual window casting.
+ */
+declare const xpcRenderer: XpcRendererApi;
+
+/**
+ * Base class for renderer-process xpc handlers.
+ * Subclass this and define async methods — they will be auto-registered
+ * as xpc handlers with channel `xpc:ClassName/methodName`.
+ *
+ * Example:
+ * ```ts
+ * class UserTable extends XpcRendererHandler {
+ *   async getUserList(params?: any): Promise<any> { ... }
+ * }
+ * const userTable = new UserTable();
+ * // auto-registers handler for 'xpc:UserTable/getUserList'
+ * ```
+ */
+declare class XpcRendererHandler {
+    constructor();
+}
+
+/**
+ * Helper: checks if a function type has at most 1 parameter.
+ * Returns the function type itself if valid, `never` otherwise.
+ */
+type AssertSingleParam<F> = F extends () => any ? F : F extends (p: any) => any ? F extends (p: any, q: any, ...rest: any[]) => any ? never : F : never;
+/**
+ * Utility type: extracts the method signatures from a handler class,
+ * turning each method into an emitter-compatible signature.
+ * Methods with 2+ parameters are mapped to `never`, causing a compile error on use.
+ */
+type XpcEmitterOf<T> = {
+    [K in keyof T as T[K] extends (...args: any[]) => any ? K : never]: AssertSingleParam<T[K]> extends never ? never : T[K] extends (params: infer P) => any ? (params: P) => Promise<any> : () => Promise<any>;
+};
+
+/**
+ * Create a type-safe emitter proxy for a renderer-process xpc handler.
+ * The emitter mirrors the handler's method signatures, but each call
+ * sends a message via xpcRenderer.send() to `xpc:ClassName/methodName`.
+ *
+ * Example:
+ * ```ts
+ * class UserTable extends XpcRendererHandler {
+ *   async getUserList(params?: any): Promise<any> { ... }
+ * }
+ * const userTableEmitter = createXpcRendererEmitter<UserTable>('UserTable');
+ * const list = await userTableEmitter.getUserList({ page: 1 });
+ * // sends to 'xpc:UserTable/getUserList'
+ * ```
+ */
+declare const createXpcRendererEmitter: <T>(className: string) => XpcEmitterOf<T>;
+
+export { type XpcEmitterOf, type XpcPayload, type XpcRendererApi, XpcRendererHandler, createXpcRendererEmitter, xpcRenderer };