@itwin/core-electron 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/cjs/backend/ElectronHost.js

@@ -1,241 +1,241 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ElectronHost = void 0;
-const fs = require("fs");
-const path = require("path");
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_backend_1 = require("@itwin/core-backend");
-const core_common_1 = require("@itwin/core-common");
-const ElectronRpcManager_1 = require("../common/ElectronRpcManager");
-const ElectronIpcInterface_1 = require("../common/ElectronIpcInterface");
-// cSpell:ignore signin devserver webcontents copyfile unmaximize eopt
-class ElectronIpc {
-    addListener(channel, listener) {
-        ElectronHost.ipcMain.addListener(channel, listener);
-        return () => ElectronHost.ipcMain.removeListener(channel, listener);
-    }
-    removeListener(channel, listener) {
-        ElectronHost.ipcMain.removeListener(channel, listener);
-    }
-    send(channel, ...args) {
-        const window = ElectronHost.mainWindow ?? ElectronHost.electron.BrowserWindow.getAllWindows()[0];
-        window?.webContents.send(channel, ...args);
-    }
-    handle(channel, listener) {
-        ElectronHost.ipcMain.removeHandler(channel); // make sure there's not already a handler registered
-        ElectronHost.ipcMain.handle(channel, listener);
-        return () => ElectronHost.ipcMain.removeHandler(channel);
-    }
-}
-/**
- * The backend for Electron-based desktop applications
- * @beta
- */
-class ElectronHost {
-    constructor() { }
-    static get ipcMain() { return this._electron?.ipcMain; }
-    static get app() { return this._electron?.app; }
-    static get electron() { return this._electron; }
-    /**
-     * Converts an "electron://frontend/" URL to an absolute file path.
-     *
-     * We use this protocol in production builds because our frontend must be built with absolute URLs,
-     * however, since we're loading everything directly from the install directory, we cannot know the
-     * absolute path at build time.
-     */
-    static parseElectronUrl(requestedUrl) {
-        // Note that the "frontend/" path is arbitrary - this is just so we can handle *some* relative URLs...
-        let assetPath = requestedUrl.substring(this._electronFrontend.length);
-        if (assetPath.length === 0)
-            assetPath = "index.html";
-        assetPath = path.normalize(`${this.webResourcesPath}/${assetPath}`);
-        // File protocols don't follow symlinks, so we need to resolve this to a real path.
-        // However, if the file doesn't exist, it's fine to return an invalid path here - the request will just fail with net::ERR_FILE_NOT_FOUND
-        try {
-            assetPath = fs.realpathSync(assetPath);
-        }
-        catch (error) {
-            // eslint-disable-next-line no-console
-            // console.warn(`WARNING: Frontend requested "${requestedUrl}", but ${assetPath} does not exist`);
-        }
-        if (!assetPath.startsWith(this.webResourcesPath))
-            throw new Error(`Access to files outside installation directory (${this.webResourcesPath}) is prohibited`);
-        return assetPath;
-    }
-    static _openWindow(options) {
-        const webPreferences = {
-            ...options?.webPreferences,
-            // These web preference variables should not be overriden by the ElectronHostWindowOptions
-            preload: require.resolve(/* webpack: copyfile */ "./ElectronPreload.js"),
-            experimentalFeatures: false,
-            nodeIntegration: false,
-            contextIsolation: true,
-            sandbox: true,
-            nodeIntegrationInWorker: false,
-            nodeIntegrationInSubFrames: false,
-        };
-        const opts = {
-            ...options,
-            autoHideMenuBar: true,
-            icon: this.appIconPath,
-            webPreferences,
-        };
-        this._mainWindow = new (this.electron.BrowserWindow)(opts);
-        ElectronRpcManager_1.ElectronRpcConfiguration.targetWindowId = this._mainWindow.id;
-        this._mainWindow.on("closed", () => this._mainWindow = undefined);
-        this._mainWindow.loadURL(this.frontendURL); // eslint-disable-line @typescript-eslint/no-floating-promises
-        /** Monitors and saves main window size, position and maximized state */
-        if (options?.storeWindowName) {
-            const mainWindow = this._mainWindow;
-            const name = options.storeWindowName;
-            const saveWindowPosition = (key) => {
-                const bounds = mainWindow.getBounds();
-                core_backend_1.NativeHost.settingsStore.setData(`${key}-${name}`, JSON.stringify(bounds));
-            };
-            const saveMaximized = (maximized) => {
-                if (!maximized)
-                    saveWindowPosition(this._deprecatedSizeAndPosStoreKey);
-                core_backend_1.NativeHost.settingsStore.setData(`windowMaximized-${name}`, maximized);
-            };
-            mainWindow.on("maximize", () => saveMaximized(true));
-            mainWindow.on("unmaximize", () => saveMaximized(false));
-            saveMaximized(mainWindow.isMaximized());
-            mainWindow.on("resized", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));
-            mainWindow.on("moved", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));
-            const debouncedSaveWindowSizeAndPos = debounce(() => saveWindowPosition(this._sizeAndPosStoreKey));
-            mainWindow.on("resize", () => debouncedSaveWindowSizeAndPos());
-            mainWindow.on("move", () => debouncedSaveWindowSizeAndPos());
-            saveWindowPosition(this._sizeAndPosStoreKey);
-        }
-    }
-    /** The "main" BrowserWindow for this application. */
-    static get mainWindow() { return this._mainWindow; }
-    /**
-     * Gets window size and position for a window, by name, from settings file, if present.
-     * @note Size and position values in the settings file will be updated differently depending on platform.
-     *       On Linux values are only updated on window "unmaximize".
-     *       On Windows and MacOS values are also updated on window manual resize or move.
-     *       To get consistent behavior across different platforms, use [[ElectronHost.getWindowSizeAndPositionSetting]].
-     * @deprecated in 3.6. Use [[ElectronHost.getWindowSizeAndPositionSetting]].
-     */
-    static getWindowSizeSetting(windowName) {
-        const saved = core_backend_1.NativeHost.settingsStore.getString(`${this._deprecatedSizeAndPosStoreKey}-${windowName}`);
-        return saved ? JSON.parse(saved) : undefined;
-    }
-    /**
-     * Gets window size and position for a window, by name, from settings file, if present.
-     */
-    static getWindowSizeAndPositionSetting(windowName) {
-        const saved = core_backend_1.NativeHost.settingsStore.getString(`${this._sizeAndPosStoreKey}-${windowName}`);
-        return saved ? JSON.parse(saved) : undefined;
-    }
-    /** Gets "window maximized" flag for a window, by name, from settings file if present */
-    static getWindowMaximizedSetting(windowName) {
-        return core_backend_1.NativeHost.settingsStore.getBoolean(`windowMaximized-${windowName}`);
-    }
-    /**
-     * Open the main Window when the app is ready.
-     * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions
-     */
-    static async openMainWindow(windowOptions) {
-        const app = this.app;
-        // quit the application when all windows are closed (unless we're running on MacOS)
-        app.on("window-all-closed", () => {
-            if (process.platform !== "darwin")
-                app.quit();
-        });
-        // re-open the main window if it was closed and the app is re-activated (this is the normal MacOS behavior)
-        app.on("activate", () => {
-            if (!this._mainWindow)
-                this._openWindow(windowOptions);
-        });
-        if (this._developmentServer) {
-            // Occasionally, the electron backend may start before the webpack devserver has even started.
-            // If this happens, we'll just retry and keep reloading the page.
-            app.on("web-contents-created", (_e, webcontents) => {
-                webcontents.on("did-fail-load", async (_event, errorCode, _errorDescription, _validatedURL, isMainFrame) => {
-                    // errorCode -102 is CONNECTION_REFUSED - see https://cs.chromium.org/chromium/src/net/base/net_error_list.h
-                    if (isMainFrame && errorCode === -102) {
-                        await core_bentley_1.BeDuration.wait(100);
-                        webcontents.reload();
-                    }
-                });
-            });
-        }
-        await app.whenReady();
-        if (!this._developmentServer) {
-            // handle any "electron://" requests and redirect them to "file://" URLs
-            this.electron.protocol.registerFileProtocol("electron", (request, callback) => callback(this.parseElectronUrl(request.url))); // eslint-disable-line @typescript-eslint/no-var-requires
-        }
-        this._openWindow(windowOptions);
-    }
-    static get isValid() { return this._ipc !== undefined; }
-    /**
-     * Initialize the backend of an Electron app.
-     * This method configures the backend for all of the inter-process communication (RPC and IPC) for an
-     * Electron app. It should be called from your Electron main function.
-     * @param opts Options that control aspects of your backend.
-     * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).
-     */
-    static async startup(opts) {
-        if (!core_bentley_1.ProcessDetector.isElectronAppBackend)
-            throw new Error("Not running under Electron");
-        if (!this.isValid) {
-            this._electron = require("electron");
-            this._ipc = new ElectronIpc();
-            const app = this.app;
-            if (!app.isReady())
-                this.electron.protocol.registerSchemesAsPrivileged([{
-                        scheme: "electron",
-                        privileges: {
-                            standard: true,
-                            secure: true,
-                            supportFetchAPI: true,
-                        },
-                    }]);
-            const eopt = opts?.electronHost;
-            this._developmentServer = eopt?.developmentServer ?? false;
-            const frontendPort = eopt?.frontendPort ?? 3000;
-            this.webResourcesPath = eopt?.webResourcesPath ?? "";
-            this.frontendURL = eopt?.frontendURL ?? (this._developmentServer ? `http://localhost:${frontendPort}` : `${this._electronFrontend}index.html`);
-            this.appIconPath = path.join(this.webResourcesPath, eopt?.iconName ?? "appicon.ico");
-            this.rpcConfig = ElectronRpcManager_1.ElectronRpcManager.initializeBackend(this._ipc, eopt?.rpcInterfaces);
-        }
-        opts = opts ?? {};
-        opts.ipcHost = opts.ipcHost ?? {};
-        opts.ipcHost.socket = this._ipc;
-        await core_backend_1.NativeHost.startup(opts);
-        if (core_backend_1.IpcHost.isValid) {
-            ElectronDialogHandler.register();
-            opts.electronHost?.ipcHandlers?.forEach((ipc) => ipc.register());
-        }
-    }
-}
-exports.ElectronHost = ElectronHost;
-ElectronHost._deprecatedSizeAndPosStoreKey = "windowPos";
-ElectronHost._sizeAndPosStoreKey = "windowSizeAndPos";
-ElectronHost._electronFrontend = "electron://frontend/";
-class ElectronDialogHandler extends core_backend_1.IpcHandler {
-    get channelName() { return ElectronIpcInterface_1.dialogChannel; }
-    async callDialog(method, ...args) {
-        const dialog = ElectronHost.electron.dialog;
-        const dialogMethod = dialog[method];
-        if (typeof dialogMethod !== "function")
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `illegal electron dialog method`);
-        return dialogMethod.call(dialog, ...args);
-    }
-}
-function debounce(func, ms = 200) {
-    let timeout;
-    return function (...args) {
-        clearTimeout(timeout);
-        timeout = setTimeout(() => {
-            func.apply(this, args);
-        }, ms);
-    };
-}
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElectronHost = void 0;
+const fs = require("fs");
+const path = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_backend_1 = require("@itwin/core-backend");
+const core_common_1 = require("@itwin/core-common");
+const ElectronRpcManager_1 = require("../common/ElectronRpcManager");
+const ElectronIpcInterface_1 = require("../common/ElectronIpcInterface");
+// cSpell:ignore signin devserver webcontents copyfile unmaximize eopt
+class ElectronIpc {
+    addListener(channel, listener) {
+        ElectronHost.ipcMain.addListener(channel, listener);
+        return () => ElectronHost.ipcMain.removeListener(channel, listener);
+    }
+    removeListener(channel, listener) {
+        ElectronHost.ipcMain.removeListener(channel, listener);
+    }
+    send(channel, ...args) {
+        const window = ElectronHost.mainWindow ?? ElectronHost.electron.BrowserWindow.getAllWindows()[0];
+        window?.webContents.send(channel, ...args);
+    }
+    handle(channel, listener) {
+        ElectronHost.ipcMain.removeHandler(channel); // make sure there's not already a handler registered
+        ElectronHost.ipcMain.handle(channel, listener);
+        return () => ElectronHost.ipcMain.removeHandler(channel);
+    }
+}
+/**
+ * The backend for Electron-based desktop applications
+ * @beta
+ */
+class ElectronHost {
+    static get ipcMain() { return this._electron?.ipcMain; }
+    static get app() { return this._electron?.app; }
+    static get electron() { return this._electron; }
+    constructor() { }
+    /**
+     * Converts an "electron://frontend/" URL to an absolute file path.
+     *
+     * We use this protocol in production builds because our frontend must be built with absolute URLs,
+     * however, since we're loading everything directly from the install directory, we cannot know the
+     * absolute path at build time.
+     */
+    static parseElectronUrl(requestedUrl) {
+        // Note that the "frontend/" path is arbitrary - this is just so we can handle *some* relative URLs...
+        let assetPath = requestedUrl.substring(this._electronFrontend.length);
+        if (assetPath.length === 0)
+            assetPath = "index.html";
+        assetPath = path.normalize(`${this.webResourcesPath}/${assetPath}`);
+        // File protocols don't follow symlinks, so we need to resolve this to a real path.
+        // However, if the file doesn't exist, it's fine to return an invalid path here - the request will just fail with net::ERR_FILE_NOT_FOUND
+        try {
+            assetPath = fs.realpathSync(assetPath);
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            // console.warn(`WARNING: Frontend requested "${requestedUrl}", but ${assetPath} does not exist`);
+        }
+        if (!assetPath.startsWith(this.webResourcesPath))
+            throw new Error(`Access to files outside installation directory (${this.webResourcesPath}) is prohibited`);
+        return assetPath;
+    }
+    static _openWindow(options) {
+        const webPreferences = {
+            ...options?.webPreferences,
+            // These web preference variables should not be overriden by the ElectronHostWindowOptions
+            preload: require.resolve(/* webpack: copyfile */ "./ElectronPreload.js"),
+            experimentalFeatures: false,
+            nodeIntegration: false,
+            contextIsolation: true,
+            sandbox: true,
+            nodeIntegrationInWorker: false,
+            nodeIntegrationInSubFrames: false,
+        };
+        const opts = {
+            ...options,
+            autoHideMenuBar: true,
+            icon: this.appIconPath,
+            webPreferences,
+        };
+        this._mainWindow = new (this.electron.BrowserWindow)(opts);
+        ElectronRpcManager_1.ElectronRpcConfiguration.targetWindowId = this._mainWindow.id;
+        this._mainWindow.on("closed", () => this._mainWindow = undefined);
+        this._mainWindow.loadURL(this.frontendURL); // eslint-disable-line @typescript-eslint/no-floating-promises
+        /** Monitors and saves main window size, position and maximized state */
+        if (options?.storeWindowName) {
+            const mainWindow = this._mainWindow;
+            const name = options.storeWindowName;
+            const saveWindowPosition = (key) => {
+                const bounds = mainWindow.getBounds();
+                core_backend_1.NativeHost.settingsStore.setData(`${key}-${name}`, JSON.stringify(bounds));
+            };
+            const saveMaximized = (maximized) => {
+                if (!maximized)
+                    saveWindowPosition(this._deprecatedSizeAndPosStoreKey);
+                core_backend_1.NativeHost.settingsStore.setData(`windowMaximized-${name}`, maximized);
+            };
+            mainWindow.on("maximize", () => saveMaximized(true));
+            mainWindow.on("unmaximize", () => saveMaximized(false));
+            saveMaximized(mainWindow.isMaximized());
+            mainWindow.on("resized", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));
+            mainWindow.on("moved", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));
+            const debouncedSaveWindowSizeAndPos = debounce(() => saveWindowPosition(this._sizeAndPosStoreKey));
+            mainWindow.on("resize", () => debouncedSaveWindowSizeAndPos());
+            mainWindow.on("move", () => debouncedSaveWindowSizeAndPos());
+            saveWindowPosition(this._sizeAndPosStoreKey);
+        }
+    }
+    /** The "main" BrowserWindow for this application. */
+    static get mainWindow() { return this._mainWindow; }
+    /**
+     * Gets window size and position for a window, by name, from settings file, if present.
+     * @note Size and position values in the settings file will be updated differently depending on platform.
+     *       On Linux values are only updated on window "unmaximize".
+     *       On Windows and MacOS values are also updated on window manual resize or move.
+     *       To get consistent behavior across different platforms, use [[ElectronHost.getWindowSizeAndPositionSetting]].
+     * @deprecated in 3.6. Use [[ElectronHost.getWindowSizeAndPositionSetting]].
+     */
+    static getWindowSizeSetting(windowName) {
+        const saved = core_backend_1.NativeHost.settingsStore.getString(`${this._deprecatedSizeAndPosStoreKey}-${windowName}`);
+        return saved ? JSON.parse(saved) : undefined;
+    }
+    /**
+     * Gets window size and position for a window, by name, from settings file, if present.
+     */
+    static getWindowSizeAndPositionSetting(windowName) {
+        const saved = core_backend_1.NativeHost.settingsStore.getString(`${this._sizeAndPosStoreKey}-${windowName}`);
+        return saved ? JSON.parse(saved) : undefined;
+    }
+    /** Gets "window maximized" flag for a window, by name, from settings file if present */
+    static getWindowMaximizedSetting(windowName) {
+        return core_backend_1.NativeHost.settingsStore.getBoolean(`windowMaximized-${windowName}`);
+    }
+    /**
+     * Open the main Window when the app is ready.
+     * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions
+     */
+    static async openMainWindow(windowOptions) {
+        const app = this.app;
+        // quit the application when all windows are closed (unless we're running on MacOS)
+        app.on("window-all-closed", () => {
+            if (process.platform !== "darwin")
+                app.quit();
+        });
+        // re-open the main window if it was closed and the app is re-activated (this is the normal MacOS behavior)
+        app.on("activate", () => {
+            if (!this._mainWindow)
+                this._openWindow(windowOptions);
+        });
+        if (this._developmentServer) {
+            // Occasionally, the electron backend may start before the webpack devserver has even started.
+            // If this happens, we'll just retry and keep reloading the page.
+            app.on("web-contents-created", (_e, webcontents) => {
+                webcontents.on("did-fail-load", async (_event, errorCode, _errorDescription, _validatedURL, isMainFrame) => {
+                    // errorCode -102 is CONNECTION_REFUSED - see https://cs.chromium.org/chromium/src/net/base/net_error_list.h
+                    if (isMainFrame && errorCode === -102) {
+                        await core_bentley_1.BeDuration.wait(100);
+                        webcontents.reload();
+                    }
+                });
+            });
+        }
+        await app.whenReady();
+        if (!this._developmentServer) {
+            // handle any "electron://" requests and redirect them to "file://" URLs
+            this.electron.protocol.registerFileProtocol("electron", (request, callback) => callback(this.parseElectronUrl(request.url))); // eslint-disable-line @typescript-eslint/no-var-requires
+        }
+        this._openWindow(windowOptions);
+    }
+    static get isValid() { return this._ipc !== undefined; }
+    /**
+     * Initialize the backend of an Electron app.
+     * This method configures the backend for all of the inter-process communication (RPC and IPC) for an
+     * Electron app. It should be called from your Electron main function.
+     * @param opts Options that control aspects of your backend.
+     * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).
+     */
+    static async startup(opts) {
+        if (!core_bentley_1.ProcessDetector.isElectronAppBackend)
+            throw new Error("Not running under Electron");
+        if (!this.isValid) {
+            this._electron = require("electron");
+            this._ipc = new ElectronIpc();
+            const app = this.app;
+            if (!app.isReady())
+                this.electron.protocol.registerSchemesAsPrivileged([{
+                        scheme: "electron",
+                        privileges: {
+                            standard: true,
+                            secure: true,
+                            supportFetchAPI: true,
+                        },
+                    }]);
+            const eopt = opts?.electronHost;
+            this._developmentServer = eopt?.developmentServer ?? false;
+            const frontendPort = eopt?.frontendPort ?? 3000;
+            this.webResourcesPath = eopt?.webResourcesPath ?? "";
+            this.frontendURL = eopt?.frontendURL ?? (this._developmentServer ? `http://localhost:${frontendPort}` : `${this._electronFrontend}index.html`);
+            this.appIconPath = path.join(this.webResourcesPath, eopt?.iconName ?? "appicon.ico");
+            this.rpcConfig = ElectronRpcManager_1.ElectronRpcManager.initializeBackend(this._ipc, eopt?.rpcInterfaces);
+        }
+        opts = opts ?? {};
+        opts.ipcHost = opts.ipcHost ?? {};
+        opts.ipcHost.socket = this._ipc;
+        await core_backend_1.NativeHost.startup(opts);
+        if (core_backend_1.IpcHost.isValid) {
+            ElectronDialogHandler.register();
+            opts.electronHost?.ipcHandlers?.forEach((ipc) => ipc.register());
+        }
+    }
+}
+ElectronHost._deprecatedSizeAndPosStoreKey = "windowPos";
+ElectronHost._sizeAndPosStoreKey = "windowSizeAndPos";
+ElectronHost._electronFrontend = "electron://frontend/";
+exports.ElectronHost = ElectronHost;
+class ElectronDialogHandler extends core_backend_1.IpcHandler {
+    get channelName() { return ElectronIpcInterface_1.dialogChannel; }
+    async callDialog(method, ...args) {
+        const dialog = ElectronHost.electron.dialog;
+        const dialogMethod = dialog[method];
+        if (typeof dialogMethod !== "function")
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `illegal electron dialog method`);
+        return dialogMethod.call(dialog, ...args);
+    }
+}
+function debounce(func, ms = 200) {
+    let timeout;
+    return function (...args) {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => {
+            func.apply(this, args);
+        }, ms);
+    };
+}
 //# sourceMappingURL=ElectronHost.js.map

package/lib/cjs/backend/ElectronHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElectronHost.js","sourceRoot":"","sources":["../../../src/backend/ElectronHost.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\n// Note: only import *types* from electron so this file can be imported by apps that sometimes use Electron and sometimes not.\r\nimport type { BrowserWindow, BrowserWindowConstructorOptions, WebPreferences } from \"electron\";\r\nimport type * as ElectronModule from \"electron\";\r\n\r\nimport * as fs from \"fs\";\r\nimport * as path from \"path\";\r\nimport { BeDuration, IModelStatus, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { IpcHandler, IpcHost, NativeHost, NativeHostOpts } from \"@itwin/core-backend\";\r\nimport { IModelError, IpcListener, IpcSocketBackend, RemoveFunction, RpcConfiguration, RpcInterfaceDefinition } from \"@itwin/core-common\";\r\nimport { ElectronRpcConfiguration, ElectronRpcManager } from \"../common/ElectronRpcManager\";\r\nimport { dialogChannel, DialogModuleMethod } from \"../common/ElectronIpcInterface\";\r\n\r\n// cSpell:ignore signin devserver webcontents copyfile unmaximize eopt\r\n\r\nclass ElectronIpc implements IpcSocketBackend {\r\n  public addListener(channel: string, listener: IpcListener): RemoveFunction {\r\n    ElectronHost.ipcMain.addListener(channel, listener);\r\n    return () => ElectronHost.ipcMain.removeListener(channel, listener);\r\n  }\r\n  public removeListener(channel: string, listener: IpcListener) {\r\n    ElectronHost.ipcMain.removeListener(channel, listener);\r\n  }\r\n  public send(channel: string, ...args: any[]): void {\r\n    const window = ElectronHost.mainWindow ?? ElectronHost.electron.BrowserWindow.getAllWindows()[0];\r\n    window?.webContents.send(channel, ...args);\r\n  }\r\n  public handle(channel: string, listener: (evt: any, ...args: any[]) => Promise<any>): RemoveFunction {\r\n    ElectronHost.ipcMain.removeHandler(channel); // make sure there's not already a handler registered\r\n    ElectronHost.ipcMain.handle(channel, listener);\r\n    return () => ElectronHost.ipcMain.removeHandler(channel);\r\n  }\r\n}\r\n\r\n/**\r\n * Options for  [[ElectronHost.startup]]\r\n * @beta\r\n */\r\nexport interface ElectronHostOptions {\r\n  /** the path to find web resources  */\r\n  webResourcesPath?: string;\r\n  /** filename for the app's icon, relative to [[webResourcesPath]] */\r\n  iconName?: string;\r\n  /** name of frontend url to open.  */\r\n  frontendURL?: string;\r\n  /** use a development server rather than the \"electron\" protocol for loading frontend (see https://www.electronjs.org/docs/api/protocol) */\r\n  developmentServer?: boolean;\r\n  /** port number for development server. Default is 3000 */\r\n  frontendPort?: number;\r\n  /** list of RPC interface definitions to register */\r\n  rpcInterfaces?: RpcInterfaceDefinition[];\r\n  /** list of [IpcHandler]($common) classes to register */\r\n  ipcHandlers?: (typeof IpcHandler)[];\r\n}\r\n\r\n/** @beta */\r\nexport interface ElectronHostOpts extends NativeHostOpts {\r\n  electronHost?: ElectronHostOptions;\r\n}\r\n\r\n/** @beta */\r\nexport interface ElectronHostWindowOptions extends BrowserWindowConstructorOptions {\r\n  storeWindowName?: string;\r\n  /** The style of window title bar. Default is `default`. */\r\n  titleBarStyle?: (\"default\" | \"hidden\" | \"hiddenInset\" | \"customButtonsOnHover\");\r\n}\r\n\r\n/** the size and position of a window as stored in the settings file.\r\n * @beta\r\n */\r\nexport interface WindowSizeAndPositionProps {\r\n  width: number;\r\n  height: number;\r\n  x: number;\r\n  y: number;\r\n}\r\n\r\n/**\r\n * The backend for Electron-based desktop applications\r\n * @beta\r\n */\r\nexport class ElectronHost {\r\n  private static readonly _deprecatedSizeAndPosStoreKey = \"windowPos\";\r\n  private static readonly _sizeAndPosStoreKey = \"windowSizeAndPos\";\r\n\r\n  private static _ipc: ElectronIpc;\r\n  private static _developmentServer: boolean;\r\n  private static _electron: typeof ElectronModule;\r\n  private static _electronFrontend = \"electron://frontend/\";\r\n  private static _mainWindow?: BrowserWindow;\r\n  public static webResourcesPath: string;\r\n  public static appIconPath: string;\r\n  public static frontendURL: string;\r\n  public static rpcConfig: RpcConfiguration;\r\n  public static get ipcMain() { return this._electron?.ipcMain; }\r\n  public static get app() { return this._electron?.app; }\r\n  public static get electron() { return this._electron; }\r\n\r\n  private constructor() { }\r\n\r\n  /**\r\n   * Converts an \"electron://frontend/\" URL to an absolute file path.\r\n   *\r\n   * We use this protocol in production builds because our frontend must be built with absolute URLs,\r\n   * however, since we're loading everything directly from the install directory, we cannot know the\r\n   * absolute path at build time.\r\n   */\r\n  private static parseElectronUrl(requestedUrl: string): string {\r\n    // Note that the \"frontend/\" path is arbitrary - this is just so we can handle *some* relative URLs...\r\n    let assetPath = requestedUrl.substring(this._electronFrontend.length);\r\n    if (assetPath.length === 0)\r\n      assetPath = \"index.html\";\r\n    assetPath = path.normalize(`${this.webResourcesPath}/${assetPath}`);\r\n    // File protocols don't follow symlinks, so we need to resolve this to a real path.\r\n    // However, if the file doesn't exist, it's fine to return an invalid path here - the request will just fail with net::ERR_FILE_NOT_FOUND\r\n    try {\r\n      assetPath = fs.realpathSync(assetPath);\r\n    } catch (error) {\r\n      // eslint-disable-next-line no-console\r\n      // console.warn(`WARNING: Frontend requested \"${requestedUrl}\", but ${assetPath} does not exist`);\r\n    }\r\n    if (!assetPath.startsWith(this.webResourcesPath))\r\n      throw new Error(`Access to files outside installation directory (${this.webResourcesPath}) is prohibited`);\r\n    return assetPath;\r\n  }\r\n\r\n  private static _openWindow(options?: ElectronHostWindowOptions) {\r\n    const webPreferences: WebPreferences = {\r\n      ...options?.webPreferences,\r\n\r\n      // These web preference variables should not be overriden by the ElectronHostWindowOptions\r\n      preload: require.resolve(/* webpack: copyfile */\"./ElectronPreload.js\"),\r\n      experimentalFeatures: false,\r\n      nodeIntegration: false,\r\n      contextIsolation: true,\r\n      sandbox: true,\r\n      nodeIntegrationInWorker: false,\r\n      nodeIntegrationInSubFrames: false,\r\n    };\r\n\r\n    const opts: BrowserWindowConstructorOptions = {\r\n      ...options,\r\n      autoHideMenuBar: true,\r\n      icon: this.appIconPath,\r\n      webPreferences,\r\n    };\r\n\r\n    this._mainWindow = new (this.electron.BrowserWindow)(opts);\r\n    ElectronRpcConfiguration.targetWindowId = this._mainWindow.id;\r\n    this._mainWindow.on(\"closed\", () => this._mainWindow = undefined);\r\n    this._mainWindow.loadURL(this.frontendURL); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n\r\n    /** Monitors and saves main window size, position and maximized state */\r\n    if (options?.storeWindowName) {\r\n      const mainWindow = this._mainWindow;\r\n      const name = options.storeWindowName;\r\n      const saveWindowPosition = (key: string) => {\r\n        const bounds: WindowSizeAndPositionProps = mainWindow.getBounds();\r\n        NativeHost.settingsStore.setData(`${key}-${name}`, JSON.stringify(bounds));\r\n      };\r\n      const saveMaximized = (maximized: boolean) => {\r\n        if (!maximized)\r\n          saveWindowPosition(this._deprecatedSizeAndPosStoreKey);\r\n        NativeHost.settingsStore.setData(`windowMaximized-${name}`, maximized);\r\n      };\r\n\r\n      mainWindow.on(\"maximize\", () => saveMaximized(true));\r\n      mainWindow.on(\"unmaximize\", () => saveMaximized(false));\r\n      saveMaximized(mainWindow.isMaximized());\r\n\r\n      mainWindow.on(\"resized\", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));\r\n      mainWindow.on(\"moved\", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));\r\n\r\n      const debouncedSaveWindowSizeAndPos = debounce(() => saveWindowPosition(this._sizeAndPosStoreKey));\r\n      mainWindow.on(\"resize\", () => debouncedSaveWindowSizeAndPos());\r\n      mainWindow.on(\"move\", () => debouncedSaveWindowSizeAndPos());\r\n      saveWindowPosition(this._sizeAndPosStoreKey);\r\n    }\r\n  }\r\n\r\n  /** The \"main\" BrowserWindow for this application. */\r\n  public static get mainWindow() { return this._mainWindow; }\r\n\r\n  /**\r\n   * Gets window size and position for a window, by name, from settings file, if present.\r\n   * @note Size and position values in the settings file will be updated differently depending on platform.\r\n   *       On Linux values are only updated on window \"unmaximize\".\r\n   *       On Windows and MacOS values are also updated on window manual resize or move.\r\n   *       To get consistent behavior across different platforms, use [[ElectronHost.getWindowSizeAndPositionSetting]].\r\n   * @deprecated in 3.6. Use [[ElectronHost.getWindowSizeAndPositionSetting]].\r\n   */\r\n  public static getWindowSizeSetting(windowName: string): WindowSizeAndPositionProps | undefined {\r\n    const saved = NativeHost.settingsStore.getString(`${this._deprecatedSizeAndPosStoreKey}-${windowName}`);\r\n    return saved ? JSON.parse(saved) as WindowSizeAndPositionProps : undefined;\r\n  }\r\n\r\n  /**\r\n   * Gets window size and position for a window, by name, from settings file, if present.\r\n   */\r\n  public static getWindowSizeAndPositionSetting(windowName: string): WindowSizeAndPositionProps | undefined {\r\n    const saved = NativeHost.settingsStore.getString(`${this._sizeAndPosStoreKey}-${windowName}`);\r\n    return saved ? JSON.parse(saved) as WindowSizeAndPositionProps : undefined;\r\n  }\r\n\r\n  /** Gets \"window maximized\" flag for a window, by name, from settings file if present */\r\n  public static getWindowMaximizedSetting(windowName: string): boolean | undefined {\r\n    return NativeHost.settingsStore.getBoolean(`windowMaximized-${windowName}`);\r\n  }\r\n\r\n  /**\r\n   * Open the main Window when the app is ready.\r\n   * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions\r\n   */\r\n  public static async openMainWindow(windowOptions?: ElectronHostWindowOptions): Promise<void> {\r\n    const app = this.app;\r\n    // quit the application when all windows are closed (unless we're running on MacOS)\r\n    app.on(\"window-all-closed\", () => {\r\n      if (process.platform !== \"darwin\")\r\n        app.quit();\r\n    });\r\n\r\n    // re-open the main window if it was closed and the app is re-activated (this is the normal MacOS behavior)\r\n    app.on(\"activate\", () => {\r\n      if (!this._mainWindow)\r\n        this._openWindow(windowOptions);\r\n    });\r\n\r\n    if (this._developmentServer) {\r\n      // Occasionally, the electron backend may start before the webpack devserver has even started.\r\n      // If this happens, we'll just retry and keep reloading the page.\r\n      app.on(\"web-contents-created\", (_e, webcontents) => {\r\n        webcontents.on(\"did-fail-load\", async (_event, errorCode, _errorDescription, _validatedURL, isMainFrame) => {\r\n          // errorCode -102 is CONNECTION_REFUSED - see https://cs.chromium.org/chromium/src/net/base/net_error_list.h\r\n          if (isMainFrame && errorCode === -102) {\r\n            await BeDuration.wait(100);\r\n            webcontents.reload();\r\n          }\r\n        });\r\n      });\r\n    }\r\n\r\n    await app.whenReady();\r\n\r\n    if (!this._developmentServer) {\r\n      // handle any \"electron://\" requests and redirect them to \"file://\" URLs\r\n      this.electron.protocol.registerFileProtocol(\"electron\", (request, callback) => callback(this.parseElectronUrl(request.url))); // eslint-disable-line @typescript-eslint/no-var-requires\r\n    }\r\n\r\n    this._openWindow(windowOptions);\r\n  }\r\n\r\n  public static get isValid() { return this._ipc !== undefined; }\r\n\r\n  /**\r\n   * Initialize the backend of an Electron app.\r\n   * This method configures the backend for all of the inter-process communication (RPC and IPC) for an\r\n   * Electron app. It should be called from your Electron main function.\r\n   * @param opts Options that control aspects of your backend.\r\n   * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).\r\n   */\r\n  public static async startup(opts?: ElectronHostOpts) {\r\n    if (!ProcessDetector.isElectronAppBackend)\r\n      throw new Error(\"Not running under Electron\");\r\n\r\n    if (!this.isValid) {\r\n      this._electron = require(\"electron\");\r\n      this._ipc = new ElectronIpc();\r\n      const app = this.app;\r\n      if (!app.isReady())\r\n        this.electron.protocol.registerSchemesAsPrivileged([{\r\n          scheme: \"electron\",\r\n          privileges: {\r\n            standard: true,\r\n            secure: true,\r\n            supportFetchAPI: true,\r\n          },\r\n        }]);\r\n      const eopt = opts?.electronHost;\r\n      this._developmentServer = eopt?.developmentServer ?? false;\r\n      const frontendPort = eopt?.frontendPort ?? 3000;\r\n      this.webResourcesPath = eopt?.webResourcesPath ?? \"\";\r\n      this.frontendURL = eopt?.frontendURL ?? (this._developmentServer ? `http://localhost:${frontendPort}` : `${this._electronFrontend}index.html`);\r\n      this.appIconPath = path.join(this.webResourcesPath, eopt?.iconName ?? \"appicon.ico\");\r\n      this.rpcConfig = ElectronRpcManager.initializeBackend(this._ipc, eopt?.rpcInterfaces);\r\n    }\r\n\r\n    opts = opts ?? {};\r\n    opts.ipcHost = opts.ipcHost ?? {};\r\n    opts.ipcHost.socket = this._ipc;\r\n    await NativeHost.startup(opts);\r\n    if (IpcHost.isValid) {\r\n      ElectronDialogHandler.register();\r\n      opts.electronHost?.ipcHandlers?.forEach((ipc) => ipc.register());\r\n    }\r\n  }\r\n}\r\n\r\nclass ElectronDialogHandler extends IpcHandler {\r\n  public get channelName() { return dialogChannel; }\r\n  public async callDialog(method: DialogModuleMethod, ...args: any) {\r\n    const dialog = ElectronHost.electron.dialog;\r\n    const dialogMethod = dialog[method] as Function;\r\n    if (typeof dialogMethod !== \"function\")\r\n      throw new IModelError(IModelStatus.FunctionNotFound, `illegal electron dialog method`);\r\n\r\n    return dialogMethod.call(dialog, ...args);\r\n  }\r\n}\r\n\r\nfunction debounce(func: Function, ms: number = 200) {\r\n  let timeout: NodeJS.Timeout;\r\n  return function (this: any, ...args: any[]) {\r\n    clearTimeout(timeout);\r\n    timeout = setTimeout(() => {\r\n      func.apply(this, args);\r\n    }, ms);\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"ElectronHost.js","sourceRoot":"","sources":["../../../src/backend/ElectronHost.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\n// Note: only import *types* from electron so this file can be imported by apps that sometimes use Electron and sometimes not.\r\nimport type { BrowserWindow, BrowserWindowConstructorOptions, WebPreferences } from \"electron\";\r\nimport type * as ElectronModule from \"electron\";\r\n\r\nimport * as fs from \"fs\";\r\nimport * as path from \"path\";\r\nimport { BeDuration, IModelStatus, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { IpcHandler, IpcHost, NativeHost, NativeHostOpts } from \"@itwin/core-backend\";\r\nimport { IModelError, IpcListener, IpcSocketBackend, RemoveFunction, RpcConfiguration, RpcInterfaceDefinition } from \"@itwin/core-common\";\r\nimport { ElectronRpcConfiguration, ElectronRpcManager } from \"../common/ElectronRpcManager\";\r\nimport { dialogChannel, DialogModuleMethod } from \"../common/ElectronIpcInterface\";\r\n\r\n// cSpell:ignore signin devserver webcontents copyfile unmaximize eopt\r\n\r\nclass ElectronIpc implements IpcSocketBackend {\r\n  public addListener(channel: string, listener: IpcListener): RemoveFunction {\r\n    ElectronHost.ipcMain.addListener(channel, listener);\r\n    return () => ElectronHost.ipcMain.removeListener(channel, listener);\r\n  }\r\n  public removeListener(channel: string, listener: IpcListener) {\r\n    ElectronHost.ipcMain.removeListener(channel, listener);\r\n  }\r\n  public send(channel: string, ...args: any[]): void {\r\n    const window = ElectronHost.mainWindow ?? ElectronHost.electron.BrowserWindow.getAllWindows()[0];\r\n    window?.webContents.send(channel, ...args);\r\n  }\r\n  public handle(channel: string, listener: (evt: any, ...args: any[]) => Promise<any>): RemoveFunction {\r\n    ElectronHost.ipcMain.removeHandler(channel); // make sure there's not already a handler registered\r\n    ElectronHost.ipcMain.handle(channel, listener);\r\n    return () => ElectronHost.ipcMain.removeHandler(channel);\r\n  }\r\n}\r\n\r\n/**\r\n * Options for  [[ElectronHost.startup]]\r\n * @beta\r\n */\r\nexport interface ElectronHostOptions {\r\n  /** the path to find web resources  */\r\n  webResourcesPath?: string;\r\n  /** filename for the app's icon, relative to [[webResourcesPath]] */\r\n  iconName?: string;\r\n  /** name of frontend url to open.  */\r\n  frontendURL?: string;\r\n  /** use a development server rather than the \"electron\" protocol for loading frontend (see https://www.electronjs.org/docs/api/protocol) */\r\n  developmentServer?: boolean;\r\n  /** port number for development server. Default is 3000 */\r\n  frontendPort?: number;\r\n  /** list of RPC interface definitions to register */\r\n  rpcInterfaces?: RpcInterfaceDefinition[];\r\n  /** list of [IpcHandler]($common) classes to register */\r\n  ipcHandlers?: (typeof IpcHandler)[];\r\n}\r\n\r\n/** @beta */\r\nexport interface ElectronHostOpts extends NativeHostOpts {\r\n  electronHost?: ElectronHostOptions;\r\n}\r\n\r\n/** @beta */\r\nexport interface ElectronHostWindowOptions extends BrowserWindowConstructorOptions {\r\n  storeWindowName?: string;\r\n  /** The style of window title bar. Default is `default`. */\r\n  titleBarStyle?: (\"default\" | \"hidden\" | \"hiddenInset\" | \"customButtonsOnHover\");\r\n}\r\n\r\n/** the size and position of a window as stored in the settings file.\r\n * @beta\r\n */\r\nexport interface WindowSizeAndPositionProps {\r\n  width: number;\r\n  height: number;\r\n  x: number;\r\n  y: number;\r\n}\r\n\r\n/**\r\n * The backend for Electron-based desktop applications\r\n * @beta\r\n */\r\nexport class ElectronHost {\r\n  private static readonly _deprecatedSizeAndPosStoreKey = \"windowPos\";\r\n  private static readonly _sizeAndPosStoreKey = \"windowSizeAndPos\";\r\n\r\n  private static _ipc: ElectronIpc;\r\n  private static _developmentServer: boolean;\r\n  private static _electron: typeof ElectronModule;\r\n  private static _electronFrontend = \"electron://frontend/\";\r\n  private static _mainWindow?: BrowserWindow;\r\n  public static webResourcesPath: string;\r\n  public static appIconPath: string;\r\n  public static frontendURL: string;\r\n  public static rpcConfig: RpcConfiguration;\r\n  public static get ipcMain() { return this._electron?.ipcMain; }\r\n  public static get app() { return this._electron?.app; }\r\n  public static get electron() { return this._electron; }\r\n\r\n  private constructor() { }\r\n\r\n  /**\r\n   * Converts an \"electron://frontend/\" URL to an absolute file path.\r\n   *\r\n   * We use this protocol in production builds because our frontend must be built with absolute URLs,\r\n   * however, since we're loading everything directly from the install directory, we cannot know the\r\n   * absolute path at build time.\r\n   */\r\n  private static parseElectronUrl(requestedUrl: string): string {\r\n    // Note that the \"frontend/\" path is arbitrary - this is just so we can handle *some* relative URLs...\r\n    let assetPath = requestedUrl.substring(this._electronFrontend.length);\r\n    if (assetPath.length === 0)\r\n      assetPath = \"index.html\";\r\n    assetPath = path.normalize(`${this.webResourcesPath}/${assetPath}`);\r\n    // File protocols don't follow symlinks, so we need to resolve this to a real path.\r\n    // However, if the file doesn't exist, it's fine to return an invalid path here - the request will just fail with net::ERR_FILE_NOT_FOUND\r\n    try {\r\n      assetPath = fs.realpathSync(assetPath);\r\n    } catch (error) {\r\n      // eslint-disable-next-line no-console\r\n      // console.warn(`WARNING: Frontend requested \"${requestedUrl}\", but ${assetPath} does not exist`);\r\n    }\r\n    if (!assetPath.startsWith(this.webResourcesPath))\r\n      throw new Error(`Access to files outside installation directory (${this.webResourcesPath}) is prohibited`);\r\n    return assetPath;\r\n  }\r\n\r\n  private static _openWindow(options?: ElectronHostWindowOptions) {\r\n    const webPreferences: WebPreferences = {\r\n      ...options?.webPreferences,\r\n\r\n      // These web preference variables should not be overriden by the ElectronHostWindowOptions\r\n      preload: require.resolve(/* webpack: copyfile */\"./ElectronPreload.js\"),\r\n      experimentalFeatures: false,\r\n      nodeIntegration: false,\r\n      contextIsolation: true,\r\n      sandbox: true,\r\n      nodeIntegrationInWorker: false,\r\n      nodeIntegrationInSubFrames: false,\r\n    };\r\n\r\n    const opts: BrowserWindowConstructorOptions = {\r\n      ...options,\r\n      autoHideMenuBar: true,\r\n      icon: this.appIconPath,\r\n      webPreferences,\r\n    };\r\n\r\n    this._mainWindow = new (this.electron.BrowserWindow)(opts);\r\n    ElectronRpcConfiguration.targetWindowId = this._mainWindow.id;\r\n    this._mainWindow.on(\"closed\", () => this._mainWindow = undefined);\r\n    this._mainWindow.loadURL(this.frontendURL); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n\r\n    /** Monitors and saves main window size, position and maximized state */\r\n    if (options?.storeWindowName) {\r\n      const mainWindow = this._mainWindow;\r\n      const name = options.storeWindowName;\r\n      const saveWindowPosition = (key: string) => {\r\n        const bounds: WindowSizeAndPositionProps = mainWindow.getBounds();\r\n        NativeHost.settingsStore.setData(`${key}-${name}`, JSON.stringify(bounds));\r\n      };\r\n      const saveMaximized = (maximized: boolean) => {\r\n        if (!maximized)\r\n          saveWindowPosition(this._deprecatedSizeAndPosStoreKey);\r\n        NativeHost.settingsStore.setData(`windowMaximized-${name}`, maximized);\r\n      };\r\n\r\n      mainWindow.on(\"maximize\", () => saveMaximized(true));\r\n      mainWindow.on(\"unmaximize\", () => saveMaximized(false));\r\n      saveMaximized(mainWindow.isMaximized());\r\n\r\n      mainWindow.on(\"resized\", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));\r\n      mainWindow.on(\"moved\", () => saveWindowPosition(this._deprecatedSizeAndPosStoreKey));\r\n\r\n      const debouncedSaveWindowSizeAndPos = debounce(() => saveWindowPosition(this._sizeAndPosStoreKey));\r\n      mainWindow.on(\"resize\", () => debouncedSaveWindowSizeAndPos());\r\n      mainWindow.on(\"move\", () => debouncedSaveWindowSizeAndPos());\r\n      saveWindowPosition(this._sizeAndPosStoreKey);\r\n    }\r\n  }\r\n\r\n  /** The \"main\" BrowserWindow for this application. */\r\n  public static get mainWindow() { return this._mainWindow; }\r\n\r\n  /**\r\n   * Gets window size and position for a window, by name, from settings file, if present.\r\n   * @note Size and position values in the settings file will be updated differently depending on platform.\r\n   *       On Linux values are only updated on window \"unmaximize\".\r\n   *       On Windows and MacOS values are also updated on window manual resize or move.\r\n   *       To get consistent behavior across different platforms, use [[ElectronHost.getWindowSizeAndPositionSetting]].\r\n   * @deprecated in 3.6. Use [[ElectronHost.getWindowSizeAndPositionSetting]].\r\n   */\r\n  public static getWindowSizeSetting(windowName: string): WindowSizeAndPositionProps | undefined {\r\n    const saved = NativeHost.settingsStore.getString(`${this._deprecatedSizeAndPosStoreKey}-${windowName}`);\r\n    return saved ? JSON.parse(saved) as WindowSizeAndPositionProps : undefined;\r\n  }\r\n\r\n  /**\r\n   * Gets window size and position for a window, by name, from settings file, if present.\r\n   */\r\n  public static getWindowSizeAndPositionSetting(windowName: string): WindowSizeAndPositionProps | undefined {\r\n    const saved = NativeHost.settingsStore.getString(`${this._sizeAndPosStoreKey}-${windowName}`);\r\n    return saved ? JSON.parse(saved) as WindowSizeAndPositionProps : undefined;\r\n  }\r\n\r\n  /** Gets \"window maximized\" flag for a window, by name, from settings file if present */\r\n  public static getWindowMaximizedSetting(windowName: string): boolean | undefined {\r\n    return NativeHost.settingsStore.getBoolean(`windowMaximized-${windowName}`);\r\n  }\r\n\r\n  /**\r\n   * Open the main Window when the app is ready.\r\n   * @param windowOptions Options for constructing the main BrowserWindow. See: https://electronjs.org/docs/api/browser-window#new-browserwindowoptions\r\n   */\r\n  public static async openMainWindow(windowOptions?: ElectronHostWindowOptions): Promise<void> {\r\n    const app = this.app;\r\n    // quit the application when all windows are closed (unless we're running on MacOS)\r\n    app.on(\"window-all-closed\", () => {\r\n      if (process.platform !== \"darwin\")\r\n        app.quit();\r\n    });\r\n\r\n    // re-open the main window if it was closed and the app is re-activated (this is the normal MacOS behavior)\r\n    app.on(\"activate\", () => {\r\n      if (!this._mainWindow)\r\n        this._openWindow(windowOptions);\r\n    });\r\n\r\n    if (this._developmentServer) {\r\n      // Occasionally, the electron backend may start before the webpack devserver has even started.\r\n      // If this happens, we'll just retry and keep reloading the page.\r\n      app.on(\"web-contents-created\", (_e, webcontents) => {\r\n        webcontents.on(\"did-fail-load\", async (_event, errorCode, _errorDescription, _validatedURL, isMainFrame) => {\r\n          // errorCode -102 is CONNECTION_REFUSED - see https://cs.chromium.org/chromium/src/net/base/net_error_list.h\r\n          if (isMainFrame && errorCode === -102) {\r\n            await BeDuration.wait(100);\r\n            webcontents.reload();\r\n          }\r\n        });\r\n      });\r\n    }\r\n\r\n    await app.whenReady();\r\n\r\n    if (!this._developmentServer) {\r\n      // handle any \"electron://\" requests and redirect them to \"file://\" URLs\r\n      this.electron.protocol.registerFileProtocol(\"electron\", (request, callback) => callback(this.parseElectronUrl(request.url))); // eslint-disable-line @typescript-eslint/no-var-requires\r\n    }\r\n\r\n    this._openWindow(windowOptions);\r\n  }\r\n\r\n  public static get isValid() { return this._ipc !== undefined; }\r\n\r\n  /**\r\n   * Initialize the backend of an Electron app.\r\n   * This method configures the backend for all of the inter-process communication (RPC and IPC) for an\r\n   * Electron app. It should be called from your Electron main function.\r\n   * @param opts Options that control aspects of your backend.\r\n   * @note This method must only be called from the backend of an Electron app (i.e. when [ProcessDetector.isElectronAppBackend]($bentley) is `true`).\r\n   */\r\n  public static async startup(opts?: ElectronHostOpts) {\r\n    if (!ProcessDetector.isElectronAppBackend)\r\n      throw new Error(\"Not running under Electron\");\r\n\r\n    if (!this.isValid) {\r\n      this._electron = require(\"electron\");\r\n      this._ipc = new ElectronIpc();\r\n      const app = this.app;\r\n      if (!app.isReady())\r\n        this.electron.protocol.registerSchemesAsPrivileged([{\r\n          scheme: \"electron\",\r\n          privileges: {\r\n            standard: true,\r\n            secure: true,\r\n            supportFetchAPI: true,\r\n          },\r\n        }]);\r\n      const eopt = opts?.electronHost;\r\n      this._developmentServer = eopt?.developmentServer ?? false;\r\n      const frontendPort = eopt?.frontendPort ?? 3000;\r\n      this.webResourcesPath = eopt?.webResourcesPath ?? \"\";\r\n      this.frontendURL = eopt?.frontendURL ?? (this._developmentServer ? `http://localhost:${frontendPort}` : `${this._electronFrontend}index.html`);\r\n      this.appIconPath = path.join(this.webResourcesPath, eopt?.iconName ?? \"appicon.ico\");\r\n      this.rpcConfig = ElectronRpcManager.initializeBackend(this._ipc, eopt?.rpcInterfaces);\r\n    }\r\n\r\n    opts = opts ?? {};\r\n    opts.ipcHost = opts.ipcHost ?? {};\r\n    opts.ipcHost.socket = this._ipc;\r\n    await NativeHost.startup(opts);\r\n    if (IpcHost.isValid) {\r\n      ElectronDialogHandler.register();\r\n      opts.electronHost?.ipcHandlers?.forEach((ipc) => ipc.register());\r\n    }\r\n  }\r\n}\r\n\r\nclass ElectronDialogHandler extends IpcHandler {\r\n  public get channelName() { return dialogChannel; }\r\n  public async callDialog(method: DialogModuleMethod, ...args: any) {\r\n    const dialog = ElectronHost.electron.dialog;\r\n    const dialogMethod = dialog[method] as Function;\r\n    if (typeof dialogMethod !== \"function\")\r\n      throw new IModelError(IModelStatus.FunctionNotFound, `illegal electron dialog method`);\r\n\r\n    return dialogMethod.call(dialog, ...args);\r\n  }\r\n}\r\n\r\nfunction debounce(func: Function, ms: number = 200) {\r\n  let timeout: NodeJS.Timeout;\r\n  return function (this: any, ...args: any[]) {\r\n    clearTimeout(timeout);\r\n    timeout = setTimeout(() => {\r\n      func.apply(this, args);\r\n    }, ms);\r\n  };\r\n}\r\n"]}

package/lib/cjs/backend/ElectronPreload.d.ts

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=ElectronPreload.d.ts.map