@itwin/core-electron 5.13.1 → 5.14.0-dev.10

package/lib/cjs/core-electron.d.ts

@@ -1,6 +1,6 @@
-export * from "./backend/ElectronHost";
-export * from "./common/ElectronIpcInterface";
-export * from "./frontend/ElectronApp";
+export * from "./backend/ElectronHost.js";
+export * from "./common/ElectronIpcInterface.js";
+export * from "./frontend/ElectronApp.js";
 /** @docs-package-description
  *
  * The core-electron package contains the electron utilities to write an iTwin.js application based on Electron.

package/lib/cjs/core-electron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-electron.d.ts","sourceRoot":"","sources":["../../src/core-electron.ts"],"names":[],"mappings":"AASA,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG"}
+{"version":3,"file":"core-electron.d.ts","sourceRoot":"","sources":["../../src/core-electron.ts"],"names":[],"mappings":"AASA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAE1C;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG"}

package/lib/cjs/core-electron.js

@@ -21,9 +21,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.
 // It imports both frontend and backend code, which is not legal anywhere.
 // Do not import it in real code!
-__exportStar(require("./backend/ElectronHost"), exports);
-__exportStar(require("./common/ElectronIpcInterface"), exports);
-__exportStar(require("./frontend/ElectronApp"), exports);
+__exportStar(require("./backend/ElectronHost.js"), exports);
+__exportStar(require("./common/ElectronIpcInterface.js"), exports);
+__exportStar(require("./frontend/ElectronApp.js"), exports);
 /** @docs-package-description
  *
  * The core-electron package contains the electron utilities to write an iTwin.js application based on Electron.

package/lib/cjs/core-electron.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-electron.js","sourceRoot":"","sources":["../../src/core-electron.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;;;;;AAE/F,sDAAsD;AACtD,0EAA0E;AAC1E,iCAAiC;AAEjC,yDAAuC;AACvC,gEAA8C;AAC9C,yDAAuC;AAEvC;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n// THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.\r\n// It imports both frontend and backend code, which is not legal anywhere.\r\n// Do not import it in real code!\r\n\r\nexport * from \"./backend/ElectronHost\";\r\nexport * from \"./common/ElectronIpcInterface\";\r\nexport * from \"./frontend/ElectronApp\";\r\n\r\n/** @docs-package-description\r\n *\r\n * The core-electron package contains the electron utilities to write an iTwin.js application based on Electron.\r\n */\r\n\r\n/**\r\n * @docs-group-description Renderer\r\n * For use in the Electron renderer process\r\n */\r\n\r\n/**\r\n * @docs-group-description Main\r\n * For use in the Electron main process\r\n */\r\n\r\n/**\r\n * @docs-group-description RpcInterface\r\n  * Functionality facilitate electron RPC\r\n */\r\n"]}
+{"version":3,"file":"core-electron.js","sourceRoot":"","sources":["../../src/core-electron.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;;;;;;;;;;;;;;AAE/F,sDAAsD;AACtD,0EAA0E;AAC1E,iCAAiC;AAEjC,4DAA0C;AAC1C,mEAAiD;AACjD,4DAA0C;AAE1C;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n// THIS FILE EXISTS ONLY FOR DOCUMENTATION GENERATION.\r\n// It imports both frontend and backend code, which is not legal anywhere.\r\n// Do not import it in real code!\r\n\r\nexport * from \"./backend/ElectronHost.js\";\r\nexport * from \"./common/ElectronIpcInterface.js\";\r\nexport * from \"./frontend/ElectronApp.js\";\r\n\r\n/** @docs-package-description\r\n *\r\n * The core-electron package contains the electron utilities to write an iTwin.js application based on Electron.\r\n */\r\n\r\n/**\r\n * @docs-group-description Renderer\r\n * For use in the Electron renderer process\r\n */\r\n\r\n/**\r\n * @docs-group-description Main\r\n * For use in the Electron main process\r\n */\r\n\r\n/**\r\n * @docs-group-description RpcInterface\r\n  * Functionality facilitate electron RPC\r\n */\r\n"]}

package/lib/cjs/frontend/ElectronApp.d.ts

@@ -1,5 +1,5 @@
 import { NativeAppOpts } from "@itwin/core-frontend";
-import type { ITwinElectronApi } from "../common/ITwinElectronApi";
+import type { ITwinElectronApi } from "../common/ITwinElectronApi.js";
 declare global {
     interface Window {
         itwinjs: ITwinElectronApi;

package/lib/cjs/frontend/ElectronApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElectronApp.d.ts","sourceRoot":"","sources":["../../../src/frontend/ElectronApp.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsC,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE,gBAAgB,CAAC;KAC3B;CACF;AA4BD,YAAY;AACZ,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAc;IAClC,WAAkB,OAAO,IAAI,OAAO,CAAoC;IAExE;;;;OAIG;WACiB,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe;WAW9B,QAAQ;IAM5B,4DAA4D;IAC5D,OAAc,SAAS,kEAAgG;CACxH"}
+{"version":3,"file":"ElectronApp.d.ts","sourceRoot":"","sources":["../../../src/frontend/ElectronApp.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsC,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE,gBAAgB,CAAC;KAC3B;CACF;AA4BD,YAAY;AACZ,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAc;IAClC,WAAkB,OAAO,IAAI,OAAO,CAAoC;IAExE;;;;OAIG;WACiB,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe;WAW9B,QAAQ;IAM5B,4DAA4D;IAC5D,OAAc,SAAS,kEAAgG;CACxH"}

package/lib/cjs/frontend/ElectronApp.js

@@ -10,8 +10,8 @@ exports.ElectronApp = void 0;
  */
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_frontend_1 = require("@itwin/core-frontend");
-const ElectronIpcInterface_1 = require("../common/ElectronIpcInterface");
-const ElectronRpcManager_1 = require("../common/ElectronRpcManager");
+const ElectronIpcInterface_js_1 = require("../common/ElectronIpcInterface.js");
+const ElectronRpcManager_js_1 = require("../common/ElectronRpcManager.js");
 /**
  * Frontend Ipc support for Electron apps.
  */
@@ -54,7 +54,7 @@ class ElectronApp {
             throw new Error("Not running under Electron");
         if (!this.isValid) {
             this._ipc = new ElectronIpc();
-            ElectronRpcManager_1.ElectronRpcManager.initializeFrontend(this._ipc, opts?.iModelApp?.rpcInterfaces); // eslint-disable-line @typescript-eslint/no-deprecated
+            ElectronRpcManager_js_1.ElectronRpcManager.initializeFrontend(this._ipc, opts?.iModelApp?.rpcInterfaces); // eslint-disable-line @typescript-eslint/no-deprecated
         }
         const ipc = (0, core_bentley_1.expectDefined)(this._ipc, "Electron IPC channel was not initialized.");
         await core_frontend_1.NativeApp.startup(ipc, opts);
@@ -62,10 +62,10 @@ class ElectronApp {
     static async shutdown() {
         this._ipc = undefined;
         await core_frontend_1.NativeApp.shutdown();
-        ElectronRpcManager_1.ElectronRpcManager.terminateFrontend();
+        ElectronRpcManager_js_1.ElectronRpcManager.terminateFrontend();
     }
     /** Proxy object for calling methods of `Electron.Dialog` */
-    static dialogIpc = core_frontend_1.IpcApp.makeIpcFunctionProxy(ElectronIpcInterface_1.electronIpcStrings.dialogChannel, "callDialog");
+    static dialogIpc = core_frontend_1.IpcApp.makeIpcFunctionProxy(ElectronIpcInterface_js_1.electronIpcStrings.dialogChannel, "callDialog");
 }
 exports.ElectronApp = ElectronApp;
 //# sourceMappingURL=ElectronApp.js.map

package/lib/cjs/frontend/ElectronApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElectronApp.js","sourceRoot":"","sources":["../../../src/frontend/ElectronApp.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F;;GAEG;AAEH,sDAAqE;AAErE,wDAAyF;AAEzF,yEAAoE;AACpE,qEAAkE;AASlE;;GAEG;AACH,MAAM,WAAW;IACP,IAAI,CAAiC;IACtC,WAAW,CAAC,WAAmB,EAAE,QAAqB;QAC3D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACM,cAAc,CAAC,WAAmB,EAAE,QAAqB;QAC9D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACM,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;IACM,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,GAAG,IAAW;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD;QACE,sJAAsJ;QACtJ,iGAAiG;QACjG,iEAAiE;QACjE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC;IAChE,CAAC;CACF;AAKD;;;GAGG;AACH,MAAa,WAAW;IACd,MAAM,CAAC,IAAI,CAAe;IAC3B,MAAM,KAAK,OAAO,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAsB;QAChD,IAAI,CAAC,8BAAe,CAAC,qBAAqB;YACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,uCAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,uDAAuD;QAC3I,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,4BAAa,EAAC,IAAI,CAAC,IAAI,EAAE,2CAA2C,CAAC,CAAC;QAClF,MAAM,yBAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,MAAM,yBAAS,CAAC,QAAQ,EAAE,CAAC;QAC3B,uCAAkB,CAAC,iBAAiB,EAAE,CAAC;IACzC,CAAC;IAED,4DAA4D;IACrD,MAAM,CAAC,SAAS,GAAG,sBAAM,CAAC,oBAAoB,CAAkB,yCAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;;AA3BzH,kCA4BC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Renderer\r\n */\r\n\r\nimport { expectDefined, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { IpcListener, IpcSocketFrontend } from \"@itwin/core-common\";\r\nimport { _callIpcChannel, IpcApp, NativeApp, NativeAppOpts } from \"@itwin/core-frontend\";\r\nimport type { IpcRenderer } from \"electron\";\r\nimport { electronIpcStrings } from \"../common/ElectronIpcInterface\";\r\nimport { ElectronRpcManager } from \"../common/ElectronRpcManager\";\r\nimport type { ITwinElectronApi } from \"../common/ITwinElectronApi\";\r\n\r\ndeclare global {\r\n  interface Window {\r\n    itwinjs: ITwinElectronApi;\r\n  }\r\n}\r\n\r\n/**\r\n * Frontend Ipc support for Electron apps.\r\n */\r\nclass ElectronIpc implements IpcSocketFrontend {\r\n  private _api: ITwinElectronApi | IpcRenderer;\r\n  public addListener(channelName: string, listener: IpcListener) {\r\n    this._api.addListener(channelName, listener);\r\n    return () => this._api.removeListener(channelName, listener);\r\n  }\r\n  public removeListener(channelName: string, listener: IpcListener) {\r\n    this._api.removeListener(channelName, listener);\r\n  }\r\n  public send(channel: string, ...data: any[]) {\r\n    this._api.send(channel, ...data);\r\n  }\r\n  public async invoke(channel: string, ...args: any[]) {\r\n    return this._api.invoke(channel, ...args);\r\n  }\r\n  constructor() {\r\n    // use the methods on window.itwinjs exposed by ElectronPreload.ts, or ipcRenderer directly if running with nodeIntegration=true (**only** for tests).\r\n    // Note that `require(\"electron\")` doesn't work with nodeIntegration=false - that's what it stops\r\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\r\n    this._api = window.itwinjs ?? require(\"electron\").ipcRenderer;\r\n  }\r\n}\r\n\r\n/** @beta */\r\nexport type ElectronAppOpts = NativeAppOpts;\r\n\r\n/**\r\n * Frontend of an Electron App.\r\n * @beta\r\n */\r\nexport class ElectronApp {\r\n  private static _ipc?: ElectronIpc;\r\n  public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n  /**\r\n   * Start the frontend of an Electron application.\r\n   * @param opts Options for your ElectronApp\r\n   * @note This method must only be called from the frontend of an Electron app (i.e. when [ProcessDetector.isElectronAppFrontend]($bentley) is `true`).\r\n   */\r\n  public static async startup(opts?: ElectronAppOpts) {\r\n    if (!ProcessDetector.isElectronAppFrontend)\r\n      throw new Error(\"Not running under Electron\");\r\n    if (!this.isValid) {\r\n      this._ipc = new ElectronIpc();\r\n      ElectronRpcManager.initializeFrontend(this._ipc, opts?.iModelApp?.rpcInterfaces); // eslint-disable-line @typescript-eslint/no-deprecated\r\n    }\r\n    const ipc = expectDefined(this._ipc, \"Electron IPC channel was not initialized.\");\r\n    await NativeApp.startup(ipc, opts);\r\n  }\r\n\r\n  public static async shutdown() {\r\n    this._ipc = undefined;\r\n    await NativeApp.shutdown();\r\n    ElectronRpcManager.terminateFrontend();\r\n  }\r\n\r\n  /** Proxy object for calling methods of `Electron.Dialog` */\r\n  public static dialogIpc = IpcApp.makeIpcFunctionProxy<Electron.Dialog>(electronIpcStrings.dialogChannel, \"callDialog\");\r\n}\r\n"]}
+{"version":3,"file":"ElectronApp.js","sourceRoot":"","sources":["../../../src/frontend/ElectronApp.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F;;GAEG;AAEH,sDAAqE;AAErE,wDAAyF;AAEzF,+EAAuE;AACvE,2EAAqE;AASrE;;GAEG;AACH,MAAM,WAAW;IACP,IAAI,CAAiC;IACtC,WAAW,CAAC,WAAmB,EAAE,QAAqB;QAC3D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACM,cAAc,CAAC,WAAmB,EAAE,QAAqB;QAC9D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IACM,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;IACM,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,GAAG,IAAW;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD;QACE,sJAAsJ;QACtJ,iGAAiG;QACjG,iEAAiE;QACjE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC;IAChE,CAAC;CACF;AAKD;;;GAGG;AACH,MAAa,WAAW;IACd,MAAM,CAAC,IAAI,CAAe;IAC3B,MAAM,KAAK,OAAO,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAsB;QAChD,IAAI,CAAC,8BAAe,CAAC,qBAAqB;YACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,0CAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,uDAAuD;QAC3I,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,4BAAa,EAAC,IAAI,CAAC,IAAI,EAAE,2CAA2C,CAAC,CAAC;QAClF,MAAM,yBAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,MAAM,yBAAS,CAAC,QAAQ,EAAE,CAAC;QAC3B,0CAAkB,CAAC,iBAAiB,EAAE,CAAC;IACzC,CAAC;IAED,4DAA4D;IACrD,MAAM,CAAC,SAAS,GAAG,sBAAM,CAAC,oBAAoB,CAAkB,4CAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;;AA3BzH,kCA4BC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Renderer\r\n */\r\n\r\nimport { expectDefined, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { IpcListener, IpcSocketFrontend } from \"@itwin/core-common\";\r\nimport { _callIpcChannel, IpcApp, NativeApp, NativeAppOpts } from \"@itwin/core-frontend\";\r\nimport type { IpcRenderer } from \"electron\";\r\nimport { electronIpcStrings } from \"../common/ElectronIpcInterface.js\";\r\nimport { ElectronRpcManager } from \"../common/ElectronRpcManager.js\";\r\nimport type { ITwinElectronApi } from \"../common/ITwinElectronApi.js\";\r\n\r\ndeclare global {\r\n  interface Window {\r\n    itwinjs: ITwinElectronApi;\r\n  }\r\n}\r\n\r\n/**\r\n * Frontend Ipc support for Electron apps.\r\n */\r\nclass ElectronIpc implements IpcSocketFrontend {\r\n  private _api: ITwinElectronApi | IpcRenderer;\r\n  public addListener(channelName: string, listener: IpcListener) {\r\n    this._api.addListener(channelName, listener);\r\n    return () => this._api.removeListener(channelName, listener);\r\n  }\r\n  public removeListener(channelName: string, listener: IpcListener) {\r\n    this._api.removeListener(channelName, listener);\r\n  }\r\n  public send(channel: string, ...data: any[]) {\r\n    this._api.send(channel, ...data);\r\n  }\r\n  public async invoke(channel: string, ...args: any[]) {\r\n    return this._api.invoke(channel, ...args);\r\n  }\r\n  constructor() {\r\n    // use the methods on window.itwinjs exposed by ElectronPreload.ts, or ipcRenderer directly if running with nodeIntegration=true (**only** for tests).\r\n    // Note that `require(\"electron\")` doesn't work with nodeIntegration=false - that's what it stops\r\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\r\n    this._api = window.itwinjs ?? require(\"electron\").ipcRenderer;\r\n  }\r\n}\r\n\r\n/** @beta */\r\nexport type ElectronAppOpts = NativeAppOpts;\r\n\r\n/**\r\n * Frontend of an Electron App.\r\n * @beta\r\n */\r\nexport class ElectronApp {\r\n  private static _ipc?: ElectronIpc;\r\n  public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n  /**\r\n   * Start the frontend of an Electron application.\r\n   * @param opts Options for your ElectronApp\r\n   * @note This method must only be called from the frontend of an Electron app (i.e. when [ProcessDetector.isElectronAppFrontend]($bentley) is `true`).\r\n   */\r\n  public static async startup(opts?: ElectronAppOpts) {\r\n    if (!ProcessDetector.isElectronAppFrontend)\r\n      throw new Error(\"Not running under Electron\");\r\n    if (!this.isValid) {\r\n      this._ipc = new ElectronIpc();\r\n      ElectronRpcManager.initializeFrontend(this._ipc, opts?.iModelApp?.rpcInterfaces); // eslint-disable-line @typescript-eslint/no-deprecated\r\n    }\r\n    const ipc = expectDefined(this._ipc, \"Electron IPC channel was not initialized.\");\r\n    await NativeApp.startup(ipc, opts);\r\n  }\r\n\r\n  public static async shutdown() {\r\n    this._ipc = undefined;\r\n    await NativeApp.shutdown();\r\n    ElectronRpcManager.terminateFrontend();\r\n  }\r\n\r\n  /** Proxy object for calling methods of `Electron.Dialog` */\r\n  public static dialogIpc = IpcApp.makeIpcFunctionProxy<Electron.Dialog>(electronIpcStrings.dialogChannel, \"callDialog\");\r\n}\r\n"]}

package/lib/esm/ElectronFrontend.d.ts

@@ -0,0 +1,2 @@
+export * from "./frontend/ElectronApp.js";
+//# sourceMappingURL=ElectronFrontend.d.ts.map

package/lib/esm/ElectronFrontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronFrontend.d.ts","sourceRoot":"","sources":["../../src/ElectronFrontend.ts"],"names":[],"mappings":"AAKA,cAAc,2BAA2B,CAAC"}

package/lib/esm/ElectronFrontend.js

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+export * from "./frontend/ElectronApp.js";
+//# sourceMappingURL=ElectronFrontend.js.map

package/lib/esm/ElectronFrontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronFrontend.js","sourceRoot":"","sources":["../../src/ElectronFrontend.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,cAAc,2BAA2B,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nexport * from \"./frontend/ElectronApp.js\";\r\n"]}

package/lib/esm/common/ElectronIpcInterface.d.ts

@@ -0,0 +1,14 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { AsyncMethodsOf } from "@itwin/core-bentley";
+/** @internal */
+export declare const electronIpcStrings: {
+    readonly dialogChannel: "itwinjs-electron/dialog";
+};
+/** Asynchronous methods of dialog module in an Electron app.
+ * @beta
+ * @deprecated in 5.0 - might be removed in next major version. Use `Electron.Dialog` from `electron` instead.
+ */
+export type DialogModuleMethod = AsyncMethodsOf<Electron.Dialog>;
+//# sourceMappingURL=ElectronIpcInterface.d.ts.map

package/lib/esm/common/ElectronIpcInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronIpcInterface.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronIpcInterface.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,gBAAgB;AAChB,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/lib/esm/common/ElectronIpcInterface.js

@@ -0,0 +1,12 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+/** @internal */
+export const electronIpcStrings = {
+    dialogChannel: "itwinjs-electron/dialog",
+};
+//# sourceMappingURL=ElectronIpcInterface.js.map

package/lib/esm/common/ElectronIpcInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronIpcInterface.js","sourceRoot":"","sources":["../../../src/common/ElectronIpcInterface.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH,gBAAgB;AAChB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,yBAAyB;CAChC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\nimport { AsyncMethodsOf } from \"@itwin/core-bentley\";\r\n\r\n/** @internal */\r\nexport const electronIpcStrings = {\r\n  dialogChannel: \"itwinjs-electron/dialog\",\r\n} as const;\r\n\r\n/** Asynchronous methods of dialog module in an Electron app.\r\n * @beta\r\n * @deprecated in 5.0 - might be removed in next major version. Use `Electron.Dialog` from `electron` instead.\r\n */\r\nexport type DialogModuleMethod = AsyncMethodsOf<Electron.Dialog>;\r\n"]}

package/lib/esm/common/ElectronIpcTransport.d.ts

@@ -0,0 +1,45 @@
+import { RpcRequestFulfillment, RpcSerializedValue, SerializedRpcRequest } from "@itwin/core-common";
+import { ElectronRpcProtocol } from "./ElectronRpcProtocol.js";
+/** @internal */
+export interface IpcTransportMessage {
+    id: string;
+    parameters?: RpcSerializedValue;
+    result?: RpcSerializedValue;
+}
+/** @internal */
+export declare abstract class ElectronIpcTransport<TIn extends IpcTransportMessage = IpcTransportMessage, TOut extends IpcTransportMessage = IpcTransportMessage> {
+    private _partials;
+    private _removeListeners;
+    protected _protocol: ElectronRpcProtocol;
+    get protocol(): ElectronRpcProtocol;
+    sendRequest(request: SerializedRpcRequest): void;
+    constructor(protocol: ElectronRpcProtocol);
+    protected setupPush(): void;
+    private _setupDataChannel;
+    private _setupObjectsChannel;
+    private _extractValue;
+    private _send;
+    protected performSend(channel: string, message: any, evt: any): void;
+    protected abstract handleComplete(id: string, evt: any): void;
+    /** @internal */
+    sendResponse(message: TOut, evt: any): void;
+    protected loadMessage(id: string): TIn;
+    cleanup(): void;
+}
+/** @internal */
+export declare class FrontendIpcTransport extends ElectronIpcTransport<RpcRequestFulfillment> {
+    private _pushTransport?;
+    protected setupPush(): void;
+    protected handleComplete(id: string): Promise<void>;
+}
+/** @internal */
+export declare class BackendIpcTransport extends ElectronIpcTransport<SerializedRpcRequest, RpcRequestFulfillment> {
+    private _browserWindow;
+    protected setupPush(): void;
+    protected handleComplete(id: string, evt: any): Promise<void>;
+    protected performSend(channel: string, message: any, evt: any): void;
+    private _requireBrowserWindow;
+}
+/** @internal */
+export declare function initializeIpc(protocol: ElectronRpcProtocol): ElectronIpcTransport<IpcTransportMessage, IpcTransportMessage>;
+//# sourceMappingURL=ElectronIpcTransport.d.ts.map

package/lib/esm/common/ElectronIpcTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronIpcTransport.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronIpcTransport.ts"],"names":[],"mappings":"AAMA,OAAO,EACyD,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAC9H,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO/D,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE;AAEjH,gBAAgB;AAChB,8BAAsB,oBAAoB,CAAC,GAAG,SAAS,mBAAmB,GAAG,mBAAmB,EAAE,IAAI,SAAS,mBAAmB,GAAG,mBAAmB;IACtJ,OAAO,CAAC,SAAS,CAAqE;IACtF,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC;IAEzC,IAAW,QAAQ,wBAA6B;IAEzC,WAAW,CAAC,OAAO,EAAE,oBAAoB;gBAK7B,QAAQ,EAAE,mBAAmB;IAQhD,SAAS,CAAC,SAAS;IAEnB,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,KAAK;IAeb,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAI7D,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAE7D,gBAAgB;IACT,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG;IAK3C,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM;IAUzB,OAAO;CAGf;AAED,gBAAgB;AAChB,qBAAa,oBAAqB,SAAQ,oBAAoB,CAAC,qBAAqB,CAAC;IACnF,OAAO,CAAC,cAAc,CAAC,CAAwB;cAE5B,SAAS;cAMZ,cAAc,CAAC,EAAE,EAAE,MAAM;CAe1C;AAED,gBAAgB;AAChB,qBAAa,mBAAoB,SAAQ,oBAAoB,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IACxG,OAAO,CAAC,cAAc,CAAM;cAET,SAAS;cAKZ,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG;cAiBhC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAWtE,OAAO,CAAC,qBAAqB;CAW9B;AAID,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,kEAU1D"}

package/lib/esm/common/ElectronIpcTransport.js

@@ -0,0 +1,187 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { BentleyError, BentleyStatus, ProcessDetector } from "@itwin/core-bentley";
+import { IModelError, iTwinChannel, RpcPushChannel, RpcPushConnection, RpcRequestFulfillment, } from "@itwin/core-common";
+import { ElectronPushConnection, ElectronPushTransport } from "./ElectronPush.js";
+import { ElectronRpcConfiguration } from "./ElectronRpcManager.js";
+const OBJECTS_CHANNEL = iTwinChannel("rpc.objects");
+const DATA_CHANNEL = iTwinChannel("rpc.data");
+/** @internal */
+export class ElectronIpcTransport {
+    _partials;
+    _removeListeners = [];
+    _protocol;
+    get protocol() { return this._protocol; }
+    sendRequest(request) {
+        const value = this._extractValue(request);
+        this._send(request, value);
+    }
+    constructor(protocol) {
+        this._protocol = protocol;
+        this._partials = new Map();
+        this._setupDataChannel();
+        this._setupObjectsChannel();
+        this.setupPush();
+    }
+    setupPush() { }
+    _setupDataChannel() {
+        const removeListener = this.protocol.ipcSocket.addListener(DATA_CHANNEL, async (evt, chunk) => {
+            let pending = this._partials.get(chunk.id);
+            if (!pending) {
+                pending = [];
+                this._partials.set(chunk.id, pending);
+            }
+            if (Array.isArray(pending)) {
+                pending.push(chunk);
+            }
+            else {
+                ++pending.received;
+                const value = this._extractValue(pending.message);
+                value.data[chunk.index] = chunk.data;
+                if (pending.received === (value.chunks || 0)) {
+                    this.handleComplete(pending.message.id, evt);
+                }
+            }
+        });
+        this._removeListeners.push(removeListener);
+    }
+    _setupObjectsChannel() {
+        const removeListener = this.protocol.ipcSocket.addListener(OBJECTS_CHANNEL, async (evt, message) => {
+            const pending = this._partials.get(message.id);
+            if (pending && !Array.isArray(pending)) {
+                throw new IModelError(BentleyStatus.ERROR, `Message already received for id "${message.id}".`);
+            }
+            const partial = { message, received: 0 };
+            this._partials.set(message.id, partial);
+            const value = this._extractValue(partial.message);
+            if (pending && Array.isArray(pending)) {
+                for (const chunk of pending) {
+                    ++partial.received;
+                    value.data[chunk.index] = chunk.data;
+                }
+            }
+            if (partial.received === (value.chunks || 0)) {
+                this.handleComplete(message.id, evt);
+            }
+        });
+        this._removeListeners.push(removeListener);
+    }
+    _extractValue(t) {
+        if (t.parameters) {
+            return t.parameters;
+        }
+        if (t.result) {
+            return t.result;
+        }
+        throw new IModelError(BentleyStatus.ERROR, "Unknown value type.");
+    }
+    _send(message, value, evt) {
+        const chunks = value.data;
+        if (chunks.length) {
+            value.chunks = chunks.length;
+            value.data = [];
+        }
+        this.performSend(OBJECTS_CHANNEL, message, evt);
+        for (let index = 0; index !== chunks.length; ++index) {
+            const chunk = { id: message.id, index, data: chunks[index] };
+            this.performSend(DATA_CHANNEL, chunk, evt);
+        }
+    }
+    performSend(channel, message, evt) {
+        (evt ? evt.sender : this.protocol.ipcSocket).send(channel, message);
+    }
+    /** @internal */
+    sendResponse(message, evt) {
+        const value = this._extractValue(message);
+        this._send(message, value, evt);
+    }
+    loadMessage(id) {
+        const partial = this._partials.get(id);
+        if (!partial || Array.isArray(partial)) {
+            throw new IModelError(BentleyStatus.ERROR, `Incomplete transmission for id "${id}".`);
+        }
+        this._partials.delete(id);
+        return partial.message;
+    }
+    cleanup() {
+        this._removeListeners.forEach((removeListener) => removeListener());
+    }
+}
+/** @internal */
+export class FrontendIpcTransport extends ElectronIpcTransport {
+    _pushTransport;
+    setupPush() {
+        const pushTransport = new ElectronPushTransport(this);
+        this._pushTransport = pushTransport;
+        RpcPushChannel.setup(pushTransport);
+    }
+    async handleComplete(id) {
+        const message = this.loadMessage(id);
+        if (this._pushTransport && this._pushTransport.consume(message)) {
+            return;
+        }
+        const protocol = this._protocol;
+        const request = protocol.requests.get(message.id);
+        // A response may arrive after shutdown has removed the request.
+        if (!request)
+            return;
+        request.notifyResponse(message);
+    }
+}
+/** @internal */
+export class BackendIpcTransport extends ElectronIpcTransport {
+    _browserWindow;
+    setupPush() {
+        RpcPushConnection.for = (channel, client) => new ElectronPushConnection(channel, client, this);
+        RpcPushChannel.enabled = true;
+    }
+    async handleComplete(id, evt) {
+        const message = this.loadMessage(id);
+        let response;
+        try {
+            const protocol = this._protocol;
+            response = await protocol.fulfill(message);
+        }
+        catch (err) {
+            response = await RpcRequestFulfillment.forUnknownError(message, err);
+        }
+        const raw = response.rawResult;
+        response.rawResult = undefined; // Otherwise, it will be serialized in IPC layer and large responses will then crash the app
+        this.sendResponse(response, evt);
+        response.rawResult = raw;
+    }
+    performSend(channel, message, evt) {
+        if (evt) {
+            return super.performSend(channel, message, evt);
+        }
+        this._requireBrowserWindow();
+        const target = ElectronRpcConfiguration.targetWindowId;
+        const windows = target ? [this._browserWindow.fromId(target)] : this._browserWindow.getAllWindows();
+        windows.forEach((window) => window.webContents.send(channel, message));
+    }
+    _requireBrowserWindow() {
+        if (this._browserWindow) {
+            return;
+        }
+        try { // Wrapping require in a try/catch signals to webpack that this is only an optional dependency
+            this._browserWindow = require("electron").BrowserWindow; // eslint-disable-line @typescript-eslint/no-require-imports
+        }
+        catch (err) {
+            throw new IModelError(BentleyStatus.ERROR, `Error requiring electron`, () => BentleyError.getErrorProps(err));
+        }
+    }
+}
+let transport;
+/** @internal */
+export function initializeIpc(protocol) {
+    if (transport && transport.protocol !== protocol) {
+        transport.cleanup();
+        transport = undefined;
+    }
+    if (undefined === transport)
+        transport = ProcessDetector.isElectronAppFrontend ? new FrontendIpcTransport(protocol) : new BackendIpcTransport(protocol);
+    return transport;
+}
+//# sourceMappingURL=ElectronIpcTransport.js.map

package/lib/esm/common/ElectronIpcTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronIpcTransport.js","sourceRoot":"","sources":["../../../src/common/ElectronIpcTransport.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { BentleyError, BentleyStatus, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport {\r\n  IModelError, iTwinChannel, RpcPushChannel, RpcPushConnection, RpcRequestFulfillment, RpcSerializedValue, SerializedRpcRequest,\r\n} from \"@itwin/core-common\";\r\nimport { ElectronPushConnection, ElectronPushTransport } from \"./ElectronPush.js\";\r\nimport { ElectronRpcConfiguration } from \"./ElectronRpcManager.js\";\r\nimport { ElectronRpcProtocol } from \"./ElectronRpcProtocol.js\";\r\n\r\nconst OBJECTS_CHANNEL = iTwinChannel(\"rpc.objects\");\r\nconst DATA_CHANNEL = iTwinChannel(\"rpc.data\");\r\n\r\ninterface PartialPayload { id: string, index: number, data: Uint8Array }\r\n\r\n/** @internal */\r\nexport interface IpcTransportMessage { id: string, parameters?: RpcSerializedValue, result?: RpcSerializedValue }\r\n\r\n/** @internal */\r\nexport abstract class ElectronIpcTransport<TIn extends IpcTransportMessage = IpcTransportMessage, TOut extends IpcTransportMessage = IpcTransportMessage> {\r\n  private _partials: Map<string, { message: TIn, received: number } | PartialPayload[]>;\r\n  private _removeListeners: VoidFunction[] = [];\r\n  protected _protocol: ElectronRpcProtocol;\r\n\r\n  public get protocol() { return this._protocol; }\r\n\r\n  public sendRequest(request: SerializedRpcRequest) {\r\n    const value = this._extractValue(request);\r\n    this._send(request, value);\r\n  }\r\n\r\n  public constructor(protocol: ElectronRpcProtocol) {\r\n    this._protocol = protocol;\r\n    this._partials = new Map();\r\n    this._setupDataChannel();\r\n    this._setupObjectsChannel();\r\n    this.setupPush();\r\n  }\r\n\r\n  protected setupPush() { }\r\n\r\n  private _setupDataChannel() {\r\n    const removeListener = this.protocol.ipcSocket.addListener(DATA_CHANNEL, async (evt: any, chunk: PartialPayload) => {\r\n      let pending = this._partials.get(chunk.id);\r\n      if (!pending) {\r\n        pending = [];\r\n        this._partials.set(chunk.id, pending);\r\n      }\r\n\r\n      if (Array.isArray(pending)) {\r\n        pending.push(chunk);\r\n      } else {\r\n        ++pending.received;\r\n\r\n        const value = this._extractValue(pending.message);\r\n        value.data[chunk.index] = chunk.data;\r\n\r\n        if (pending.received === (value.chunks || 0)) {\r\n          this.handleComplete(pending.message.id, evt);\r\n        }\r\n      }\r\n    });\r\n    this._removeListeners.push(removeListener);\r\n  }\r\n\r\n  private _setupObjectsChannel() {\r\n    const removeListener = this.protocol.ipcSocket.addListener(OBJECTS_CHANNEL, async (evt: any, message: TIn) => {\r\n      const pending = this._partials.get(message.id);\r\n      if (pending && !Array.isArray(pending)) {\r\n        throw new IModelError(BentleyStatus.ERROR, `Message already received for id \"${message.id}\".`);\r\n      }\r\n\r\n      const partial = { message, received: 0 };\r\n      this._partials.set(message.id, partial);\r\n      const value = this._extractValue(partial.message);\r\n\r\n      if (pending && Array.isArray(pending)) {\r\n        for (const chunk of pending) {\r\n          ++partial.received;\r\n          value.data[chunk.index] = chunk.data;\r\n        }\r\n      }\r\n\r\n      if (partial.received === (value.chunks || 0)) {\r\n        this.handleComplete(message.id, evt);\r\n      }\r\n    });\r\n    this._removeListeners.push(removeListener);\r\n  }\r\n\r\n  private _extractValue(t: IpcTransportMessage): RpcSerializedValue {\r\n    if (t.parameters) {\r\n      return t.parameters;\r\n    }\r\n\r\n    if (t.result) {\r\n      return t.result;\r\n    }\r\n\r\n    throw new IModelError(BentleyStatus.ERROR, \"Unknown value type.\");\r\n  }\r\n\r\n  private _send(message: IpcTransportMessage, value: RpcSerializedValue, evt?: any) {\r\n    const chunks = value.data;\r\n    if (chunks.length) {\r\n      value.chunks = chunks.length;\r\n      value.data = [];\r\n    }\r\n\r\n    this.performSend(OBJECTS_CHANNEL, message, evt);\r\n\r\n    for (let index = 0; index !== chunks.length; ++index) {\r\n      const chunk: PartialPayload = { id: message.id, index, data: chunks[index] };\r\n      this.performSend(DATA_CHANNEL, chunk, evt);\r\n    }\r\n  }\r\n\r\n  protected performSend(channel: string, message: any, evt: any) {\r\n    (evt ? evt.sender : this.protocol.ipcSocket).send(channel, message);\r\n  }\r\n\r\n  protected abstract handleComplete(id: string, evt: any): void;\r\n\r\n  /** @internal */\r\n  public sendResponse(message: TOut, evt: any) {\r\n    const value = this._extractValue(message);\r\n    this._send(message, value, evt);\r\n  }\r\n\r\n  protected loadMessage(id: string) {\r\n    const partial = this._partials.get(id);\r\n    if (!partial || Array.isArray(partial)) {\r\n      throw new IModelError(BentleyStatus.ERROR, `Incomplete transmission for id \"${id}\".`);\r\n    }\r\n\r\n    this._partials.delete(id);\r\n    return partial.message;\r\n  }\r\n\r\n  public cleanup() {\r\n    this._removeListeners.forEach((removeListener) => removeListener());\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class FrontendIpcTransport extends ElectronIpcTransport<RpcRequestFulfillment> {\r\n  private _pushTransport?: ElectronPushTransport;\r\n\r\n  protected override setupPush() {\r\n    const pushTransport = new ElectronPushTransport(this);\r\n    this._pushTransport = pushTransport;\r\n    RpcPushChannel.setup(pushTransport);\r\n  }\r\n\r\n  protected async handleComplete(id: string) {\r\n    const message = this.loadMessage(id);\r\n\r\n    if (this._pushTransport && this._pushTransport.consume(message)) {\r\n      return;\r\n    }\r\n\r\n    const protocol = this._protocol;\r\n    const request = protocol.requests.get(message.id);\r\n    // A response may arrive after shutdown has removed the request.\r\n    if (!request)\r\n      return;\r\n\r\n    request.notifyResponse(message);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class BackendIpcTransport extends ElectronIpcTransport<SerializedRpcRequest, RpcRequestFulfillment> {\r\n  private _browserWindow: any;\r\n\r\n  protected override setupPush() {\r\n    RpcPushConnection.for = (channel, client) => new ElectronPushConnection(channel, client, this);\r\n    RpcPushChannel.enabled = true;\r\n  }\r\n\r\n  protected async handleComplete(id: string, evt: any) {\r\n    const message = this.loadMessage(id);\r\n\r\n    let response: RpcRequestFulfillment;\r\n    try {\r\n      const protocol = this._protocol;\r\n      response = await protocol.fulfill(message);\r\n    } catch (err) {\r\n      response = await RpcRequestFulfillment.forUnknownError(message, err);\r\n    }\r\n\r\n    const raw = response.rawResult;\r\n    response.rawResult = undefined; // Otherwise, it will be serialized in IPC layer and large responses will then crash the app\r\n    this.sendResponse(response, evt);\r\n    response.rawResult = raw;\r\n  }\r\n\r\n  protected override performSend(channel: string, message: any, evt: any) {\r\n    if (evt) {\r\n      return super.performSend(channel, message, evt);\r\n    }\r\n\r\n    this._requireBrowserWindow();\r\n    const target = ElectronRpcConfiguration.targetWindowId;\r\n    const windows = target ? [this._browserWindow.fromId(target)] : this._browserWindow.getAllWindows();\r\n    windows.forEach((window: any) => window.webContents.send(channel, message));\r\n  }\r\n\r\n  private _requireBrowserWindow() {\r\n    if (this._browserWindow) {\r\n      return;\r\n    }\r\n\r\n    try { // Wrapping require in a try/catch signals to webpack that this is only an optional dependency\r\n      this._browserWindow = require(\"electron\").BrowserWindow; // eslint-disable-line @typescript-eslint/no-require-imports\r\n    } catch (err) {\r\n      throw new IModelError(BentleyStatus.ERROR, `Error requiring electron`, () => BentleyError.getErrorProps(err));\r\n    }\r\n  }\r\n}\r\n\r\nlet transport: ElectronIpcTransport | undefined;\r\n\r\n/** @internal */\r\nexport function initializeIpc(protocol: ElectronRpcProtocol) {\r\n  if (transport && transport.protocol !== protocol) {\r\n    transport.cleanup();\r\n    transport = undefined;\r\n  }\r\n\r\n  if (undefined === transport)\r\n    transport = ProcessDetector.isElectronAppFrontend ? new FrontendIpcTransport(protocol) : new BackendIpcTransport(protocol);\r\n\r\n  return transport;\r\n}\r\n"]}

package/lib/esm/common/ElectronPush.d.ts

@@ -0,0 +1,18 @@
+import { RpcPushChannel, RpcPushConnection, RpcPushTransport, RpcRequestFulfillment } from "@itwin/core-common";
+import { BackendIpcTransport, FrontendIpcTransport } from "./ElectronIpcTransport.js";
+/** @internal */
+export declare class ElectronPushTransport extends RpcPushTransport {
+    private _ipc;
+    private _last;
+    get last(): number;
+    constructor(ipc: FrontendIpcTransport);
+    consume(response: RpcRequestFulfillment): boolean;
+}
+/** @internal */
+export declare class ElectronPushConnection<T> extends RpcPushConnection<T> {
+    private _ipc;
+    private _next;
+    constructor(channel: RpcPushChannel<T>, client: unknown, ipc: BackendIpcTransport);
+    send(messageData: any): Promise<void>;
+}
+//# sourceMappingURL=ElectronPush.d.ts.map

package/lib/esm/common/ElectronPush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronPush.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronPush.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC/H,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItF,gBAAgB;AAChB,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,KAAK,CAAc;IAE3B,IAAW,IAAI,WAAyB;gBAErB,GAAG,EAAE,oBAAoB;IAKrC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;CAczD;AAED,gBAAgB;AAChB,qBAAa,sBAAsB,CAAC,CAAC,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,KAAK,CAAc;gBAER,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,mBAAmB;IAK3E,IAAI,CAAC,WAAW,EAAE,GAAG;CAKnC"}

package/lib/esm/common/ElectronPush.js

@@ -0,0 +1,42 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { RpcMarshaling, RpcPushConnection, RpcPushTransport } from "@itwin/core-common";
+const PUSH = "__push__";
+/** @internal */
+export class ElectronPushTransport extends RpcPushTransport {
+    _ipc;
+    _last = -1;
+    get last() { return this._last; }
+    constructor(ipc) {
+        super();
+        this._ipc = ipc;
+    }
+    consume(response) {
+        if (response.interfaceName !== PUSH) {
+            return false;
+        }
+        this._last = response.status;
+        if (this.onMessage) {
+            const messageData = RpcMarshaling.deserialize(this._ipc.protocol, response.result);
+            this.onMessage(response.id, messageData);
+        }
+        return true;
+    }
+}
+/** @internal */
+export class ElectronPushConnection extends RpcPushConnection {
+    _ipc;
+    _next = -1;
+    constructor(channel, client, ipc) {
+        super(channel, client);
+        this._ipc = ipc;
+    }
+    async send(messageData) {
+        const result = RpcMarshaling.serialize(this._ipc.protocol, messageData);
+        const fulfillment = { result, rawResult: messageData, interfaceName: PUSH, id: this.channel.id, status: ++this._next };
+        this._ipc.sendResponse(fulfillment, undefined);
+    }
+}
+//# sourceMappingURL=ElectronPush.js.map

package/lib/esm/common/ElectronPush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronPush.js","sourceRoot":"","sources":["../../../src/common/ElectronPush.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,aAAa,EAAkB,iBAAiB,EAAE,gBAAgB,EAAyB,MAAM,oBAAoB,CAAC;AAG/H,MAAM,IAAI,GAAG,UAAU,CAAC;AAExB,gBAAgB;AAChB,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IACjD,IAAI,CAAuB;IAC3B,KAAK,GAAW,CAAC,CAAC,CAAC;IAE3B,IAAW,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAExC,YAAmB,GAAyB;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAEM,OAAO,CAAC,QAA+B;QAC5C,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,gBAAgB;AAChB,MAAM,OAAO,sBAA0B,SAAQ,iBAAoB;IACzD,IAAI,CAAsB;IAC1B,KAAK,GAAW,CAAC,CAAC,CAAC;IAE3B,YAAmB,OAA0B,EAAE,MAAe,EAAE,GAAwB;QACtF,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,WAAgB;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACxE,MAAM,WAAW,GAA0B,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9I,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { RpcMarshaling, RpcPushChannel, RpcPushConnection, RpcPushTransport, RpcRequestFulfillment } from \"@itwin/core-common\";\r\nimport { BackendIpcTransport, FrontendIpcTransport } from \"./ElectronIpcTransport.js\";\r\n\r\nconst PUSH = \"__push__\";\r\n\r\n/** @internal */\r\nexport class ElectronPushTransport extends RpcPushTransport {\r\n  private _ipc: FrontendIpcTransport;\r\n  private _last: number = -1;\r\n\r\n  public get last() { return this._last; }\r\n\r\n  public constructor(ipc: FrontendIpcTransport) {\r\n    super();\r\n    this._ipc = ipc;\r\n  }\r\n\r\n  public consume(response: RpcRequestFulfillment): boolean {\r\n    if (response.interfaceName !== PUSH) {\r\n      return false;\r\n    }\r\n\r\n    this._last = response.status;\r\n\r\n    if (this.onMessage) {\r\n      const messageData = RpcMarshaling.deserialize(this._ipc.protocol, response.result);\r\n      this.onMessage(response.id, messageData);\r\n    }\r\n\r\n    return true;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class ElectronPushConnection<T> extends RpcPushConnection<T> {\r\n  private _ipc: BackendIpcTransport;\r\n  private _next: number = -1;\r\n\r\n  public constructor(channel: RpcPushChannel<T>, client: unknown, ipc: BackendIpcTransport) {\r\n    super(channel, client);\r\n    this._ipc = ipc;\r\n  }\r\n\r\n  public async send(messageData: any) {\r\n    const result = RpcMarshaling.serialize(this._ipc.protocol, messageData);\r\n    const fulfillment: RpcRequestFulfillment = { result, rawResult: messageData, interfaceName: PUSH, id: this.channel.id, status: ++this._next };\r\n    this._ipc.sendResponse(fulfillment, undefined);\r\n  }\r\n}\r\n"]}

package/lib/esm/common/ElectronRpcManager.d.ts

@@ -0,0 +1,24 @@
+import { IpcSocketBackend, IpcSocketFrontend, RpcConfiguration, RpcInterfaceDefinition, RpcManager } from "@itwin/core-common";
+import { ElectronRpcProtocol } from "./ElectronRpcProtocol.js";
+/** RPC interface configuration for an Electron-based application.
+ * @internal
+ */
+export declare abstract class ElectronRpcConfiguration extends RpcConfiguration {
+    static targetWindowId?: number;
+    /** The protocol of the configuration. */
+    abstract protocol: ElectronRpcProtocol;
+}
+/** Coordinates usage of RPC interfaces for an Electron-based application.
+ * @internal
+ */
+export declare class ElectronRpcManager extends RpcManager {
+    /** Initializes ElectronRpcManager for the frontend of an application. */
+    static initializeFrontend(ipcFrontend: IpcSocketFrontend, interfaces?: RpcInterfaceDefinition[]): ElectronRpcConfiguration;
+    /** Initializes ElectronRpcManager for the backend of an application. */
+    static initializeBackend(ipcBackend: IpcSocketBackend, interfaces?: RpcInterfaceDefinition[]): ElectronRpcConfiguration;
+    private static performInitialization;
+    /** Terminates ElectronRpcManager for the frontend of an application. */
+    static terminateFrontend(): void;
+    private static performTermination;
+}
+//# sourceMappingURL=ElectronRpcManager.d.ts.map

package/lib/esm/common/ElectronRpcManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcManager.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronRpcManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAe,MAAM,oBAAoB,CAAC;AACvJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,8BAAsB,wBAAyB,SAAQ,gBAAgB;IAErE,OAAc,cAAc,CAAC,EAAE,MAAM,CAAC;IAEtC,yCAAyC;IACzC,SAAyB,QAAQ,EAAE,mBAAmB,CAAC;CACxD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,yEAAyE;WAC3D,kBAAkB,CAAC,WAAW,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,sBAAsB,EAAE,GAAG,wBAAwB;IAIjI,wEAAwE;WAC1D,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,sBAAsB,EAAE,GAAG,wBAAwB;IAI9H,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAiBpC,wEAAwE;WAC1D,iBAAiB;IAI/B,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAOlC"}

package/lib/esm/common/ElectronRpcManager.js

@@ -0,0 +1,49 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { RpcConfiguration, RpcManager, RpcRegistry } from "@itwin/core-common";
+import { ElectronRpcProtocol } from "./ElectronRpcProtocol.js";
+/** RPC interface configuration for an Electron-based application.
+ * @internal
+ */
+export class ElectronRpcConfiguration extends RpcConfiguration {
+    static targetWindowId;
+}
+/** Coordinates usage of RPC interfaces for an Electron-based application.
+ * @internal
+ */
+export class ElectronRpcManager extends RpcManager {
+    /** Initializes ElectronRpcManager for the frontend of an application. */
+    static initializeFrontend(ipcFrontend, interfaces) {
+        return ElectronRpcManager.performInitialization(ipcFrontend, interfaces);
+    }
+    /** Initializes ElectronRpcManager for the backend of an application. */
+    static initializeBackend(ipcBackend, interfaces) {
+        return ElectronRpcManager.performInitialization(ipcBackend, interfaces);
+    }
+    static performInitialization(ipcSocket, rpcs) {
+        const interfaces = rpcs ?? [];
+        const config = class extends ElectronRpcConfiguration {
+            interfaces = () => interfaces;
+            protocol = new ElectronRpcProtocol(this, ipcSocket);
+        };
+        for (const def of interfaces) {
+            RpcConfiguration.assign(def, () => config);
+        }
+        const instance = RpcConfiguration.obtain(config);
+        RpcConfiguration.initializeInterfaces(instance);
+        return instance;
+    }
+    /** Terminates ElectronRpcManager for the frontend of an application. */
+    static terminateFrontend() {
+        return ElectronRpcManager.performTermination();
+    }
+    static performTermination() {
+        const definitions = RpcRegistry.instance.definitionClasses;
+        for (const [, interfaceDef] of definitions) {
+            RpcManager.terminateInterface(interfaceDef);
+        }
+    }
+}
+//# sourceMappingURL=ElectronRpcManager.js.map

package/lib/esm/common/ElectronRpcManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcManager.js","sourceRoot":"","sources":["../../../src/common/ElectronRpcManager.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAkD,gBAAgB,EAA0B,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAgB,wBAAyB,SAAQ,gBAAgB;IAE9D,MAAM,CAAC,cAAc,CAAU;CAIvC;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,yEAAyE;IAClE,MAAM,CAAC,kBAAkB,CAAC,WAA8B,EAAE,UAAqC;QACpG,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,wEAAwE;IACjE,MAAM,CAAC,iBAAiB,CAAC,UAA4B,EAAE,UAAqC;QACjG,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,SAAoB,EAAE,IAA+B;QACxF,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAM,SAAQ,wBAAwB;YAC5C,UAAU,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC;YAC9B,QAAQ,GAAwB,IAAI,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;SACjF,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,gBAAgB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAEhD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wEAAwE;IACjE,MAAM,CAAC,iBAAiB;QAC7B,OAAO,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;IACjD,CAAC;IAEO,MAAM,CAAC,kBAAkB;QAC/B,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAE3D,KAAK,MAAM,CAAC,EAAE,YAAY,CAAC,IAAI,WAAW,EAAE,CAAC;YAC3C,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { IpcSocket, IpcSocketBackend, IpcSocketFrontend, RpcConfiguration, RpcInterfaceDefinition, RpcManager, RpcRegistry } from \"@itwin/core-common\";\r\nimport { ElectronRpcProtocol } from \"./ElectronRpcProtocol.js\";\r\n\r\n/** RPC interface configuration for an Electron-based application.\r\n * @internal\r\n */\r\nexport abstract class ElectronRpcConfiguration extends RpcConfiguration {\r\n\r\n  public static targetWindowId?: number;\r\n\r\n  /** The protocol of the configuration. */\r\n  public abstract override protocol: ElectronRpcProtocol;\r\n}\r\n\r\n/** Coordinates usage of RPC interfaces for an Electron-based application.\r\n * @internal\r\n */\r\nexport class ElectronRpcManager extends RpcManager {\r\n  /** Initializes ElectronRpcManager for the frontend of an application. */\r\n  public static initializeFrontend(ipcFrontend: IpcSocketFrontend, interfaces?: RpcInterfaceDefinition[]): ElectronRpcConfiguration {\r\n    return ElectronRpcManager.performInitialization(ipcFrontend, interfaces);\r\n  }\r\n\r\n  /** Initializes ElectronRpcManager for the backend of an application. */\r\n  public static initializeBackend(ipcBackend: IpcSocketBackend, interfaces?: RpcInterfaceDefinition[]): ElectronRpcConfiguration {\r\n    return ElectronRpcManager.performInitialization(ipcBackend, interfaces);\r\n  }\r\n\r\n  private static performInitialization(ipcSocket: IpcSocket, rpcs?: RpcInterfaceDefinition[]): ElectronRpcConfiguration {\r\n    const interfaces = rpcs ?? [];\r\n    const config = class extends ElectronRpcConfiguration {\r\n      public interfaces = () => interfaces;\r\n      public protocol: ElectronRpcProtocol = new ElectronRpcProtocol(this, ipcSocket);\r\n    };\r\n\r\n    for (const def of interfaces) {\r\n      RpcConfiguration.assign(def, () => config);\r\n    }\r\n\r\n    const instance = RpcConfiguration.obtain(config);\r\n    RpcConfiguration.initializeInterfaces(instance);\r\n\r\n    return instance;\r\n  }\r\n\r\n  /** Terminates ElectronRpcManager for the frontend of an application. */\r\n  public static terminateFrontend() {\r\n    return ElectronRpcManager.performTermination();\r\n  }\r\n\r\n  private static performTermination() {\r\n    const definitions = RpcRegistry.instance.definitionClasses;\r\n\r\n    for (const [, interfaceDef] of definitions) {\r\n      RpcManager.terminateInterface(interfaceDef);\r\n    }\r\n  }\r\n}\r\n"]}