@itwin/core-electron 5.14.0-dev.7 → 5.14.0-dev.9

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

@@ -0,0 +1,35 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { IpcSocket, RpcInterface, RpcInterfaceDefinition, RpcProtocol } from "@itwin/core-common";
+import { ElectronIpcTransport, IpcTransportMessage } from "./ElectronIpcTransport.js";
+import { ElectronRpcConfiguration } from "./ElectronRpcManager.js";
+import { ElectronRpcRequest } from "./ElectronRpcRequest.js";
+/** RPC interface protocol for an Electron-based application.
+ * @internal
+ */
+export declare class ElectronRpcProtocol extends RpcProtocol {
+    static instances: Map<string, ElectronRpcProtocol>;
+    ipcSocket: IpcSocket;
+    /** The RPC request class for this protocol. */
+    readonly requestType: typeof ElectronRpcRequest;
+    /** Specifies where to break large binary request payloads. */
+    transferChunkThreshold: number;
+    /** @internal */
+    requests: Map<string, ElectronRpcRequest>;
+    /** @internal */
+    readonly transport: ElectronIpcTransport<IpcTransportMessage, IpcTransportMessage>;
+    /** Constructs an Electron protocol. */
+    constructor(configuration: ElectronRpcConfiguration, ipcSocket: IpcSocket);
+    /** @internal */
+    onRpcClientInitialized(definition: RpcInterfaceDefinition, _client: RpcInterface): void;
+    /** @internal */
+    onRpcImplInitialized(definition: RpcInterfaceDefinition, _impl: RpcInterface): void;
+    /** @internal */
+    onRpcClientTerminated(definition: RpcInterfaceDefinition, _client: RpcInterface): void;
+    /** @internal */
+    onRpcImplTerminated(definition: RpcInterfaceDefinition, _impl: RpcInterface): void;
+    private registerInterface;
+    private purgeInterface;
+}
+//# sourceMappingURL=ElectronRpcProtocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcProtocol.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronRpcProtocol.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAe,SAAS,EAAE,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,oBAAoB,EAAiB,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrG,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,OAAc,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IAC/D,SAAS,EAAE,SAAS,CAAC;IAE5B,+CAA+C;IAC/C,SAAgB,WAAW,4BAAsB;IAEjD,8DAA8D;IAC9C,sBAAsB,SAAoB;IAE1D,gBAAgB;IACT,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAa;IAE7D,gBAAgB;IAChB,SAAgB,SAAS,EAAE,oBAAoB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IAE1F,uCAAuC;gBACpB,aAAa,EAAE,wBAAwB,EAAE,SAAS,EAAE,SAAS;IAMhF,gBAAgB;IACA,sBAAsB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIvG,gBAAgB;IACA,oBAAoB,CAAC,UAAU,EAAE,sBAAsB,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAInG,gBAAgB;IACA,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAItG,gBAAgB;IACA,mBAAmB,CAAC,UAAU,EAAE,sBAAsB,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAIlG,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,cAAc;CAGvB"}

package/lib/esm/common/ElectronRpcProtocol.js

@@ -0,0 +1,57 @@
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+import { BentleyStatus } from "@itwin/core-bentley";
+import { IModelError, RpcProtocol } from "@itwin/core-common";
+import { initializeIpc } from "./ElectronIpcTransport.js";
+import { ElectronRpcRequest } from "./ElectronRpcRequest.js";
+/** RPC interface protocol for an Electron-based application.
+ * @internal
+ */
+export class ElectronRpcProtocol extends RpcProtocol {
+    static instances = new Map();
+    ipcSocket;
+    /** The RPC request class for this protocol. */
+    requestType = ElectronRpcRequest;
+    /** Specifies where to break large binary request payloads. */
+    transferChunkThreshold = 48 * 1024 * 1024;
+    /** @internal */
+    requests = new Map();
+    /** @internal */
+    transport;
+    /** Constructs an Electron protocol. */
+    constructor(configuration, ipcSocket) {
+        super(configuration);
+        this.ipcSocket = ipcSocket;
+        this.transport = initializeIpc(this);
+    }
+    /** @internal */
+    onRpcClientInitialized(definition, _client) {
+        this.registerInterface(definition);
+    }
+    /** @internal */
+    onRpcImplInitialized(definition, _impl) {
+        this.registerInterface(definition);
+    }
+    /** @internal */
+    onRpcClientTerminated(definition, _client) {
+        this.purgeInterface(definition);
+    }
+    /** @internal */
+    onRpcImplTerminated(definition, _impl) {
+        this.purgeInterface(definition);
+    }
+    registerInterface(definition) {
+        if (ElectronRpcProtocol.instances.has(definition.interfaceName))
+            throw new IModelError(BentleyStatus.ERROR, `RPC interface "${definition.interfaceName}"" is already associated with a protocol.`);
+        ElectronRpcProtocol.instances.set(definition.interfaceName, this);
+    }
+    purgeInterface(definition) {
+        ElectronRpcProtocol.instances.delete(definition.interfaceName);
+    }
+}
+//# sourceMappingURL=ElectronRpcProtocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcProtocol.js","sourceRoot":"","sources":["../../../src/common/ElectronRpcProtocol.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAmD,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAwB,aAAa,EAAuB,MAAM,2BAA2B,CAAC;AAErG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAC3C,MAAM,CAAC,SAAS,GAAqC,IAAI,GAAG,EAAE,CAAC;IAC/D,SAAS,CAAY;IAE5B,+CAA+C;IAC/B,WAAW,GAAG,kBAAkB,CAAC;IAEjD,8DAA8D;IAC9C,sBAAsB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1D,gBAAgB;IACT,QAAQ,GAAoC,IAAI,GAAG,EAAE,CAAC;IAE7D,gBAAgB;IACA,SAAS,CAAiE;IAE1F,uCAAuC;IACvC,YAAmB,aAAuC,EAAE,SAAoB;QAC9E,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,gBAAgB;IACA,sBAAsB,CAAC,UAAkC,EAAE,OAAqB;QAC9F,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,gBAAgB;IACA,oBAAoB,CAAC,UAAkC,EAAE,KAAmB;QAC1F,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,gBAAgB;IACA,qBAAqB,CAAC,UAAkC,EAAE,OAAqB;QAC7F,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,gBAAgB;IACA,mBAAmB,CAAC,UAAkC,EAAE,KAAmB;QACzF,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAEO,iBAAiB,CAAC,UAAkC;QAC1D,IAAI,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;YAC7D,MAAM,IAAI,WAAW,CAAC,aAAa,CAAC,KAAK,EAAE,kBAAkB,UAAU,CAAC,aAAa,2CAA2C,CAAC,CAAC;QAEpI,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAEO,cAAc,CAAC,UAAkC;QACvD,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,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 { BentleyStatus } from \"@itwin/core-bentley\";\r\nimport { IModelError, IpcSocket, RpcInterface, RpcInterfaceDefinition, RpcProtocol } from \"@itwin/core-common\";\r\nimport { ElectronIpcTransport, initializeIpc, IpcTransportMessage } from \"./ElectronIpcTransport.js\";\r\nimport { ElectronRpcConfiguration } from \"./ElectronRpcManager.js\";\r\nimport { ElectronRpcRequest } from \"./ElectronRpcRequest.js\";\r\n\r\n/** RPC interface protocol for an Electron-based application.\r\n * @internal\r\n */\r\nexport class ElectronRpcProtocol extends RpcProtocol {\r\n  public static instances: Map<string, ElectronRpcProtocol> = new Map();\r\n  public ipcSocket: IpcSocket;\r\n\r\n  /** The RPC request class for this protocol. */\r\n  public readonly requestType = ElectronRpcRequest;\r\n\r\n  /** Specifies where to break large binary request payloads. */\r\n  public override transferChunkThreshold = 48 * 1024 * 1024;\r\n\r\n  /** @internal */\r\n  public requests: Map<string, ElectronRpcRequest> = new Map();\r\n\r\n  /** @internal */\r\n  public readonly transport: ElectronIpcTransport<IpcTransportMessage, IpcTransportMessage>;\r\n\r\n  /** Constructs an Electron protocol. */\r\n  public constructor(configuration: ElectronRpcConfiguration, ipcSocket: IpcSocket) {\r\n    super(configuration);\r\n    this.ipcSocket = ipcSocket;\r\n    this.transport = initializeIpc(this);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onRpcClientInitialized(definition: RpcInterfaceDefinition, _client: RpcInterface): void {\r\n    this.registerInterface(definition);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onRpcImplInitialized(definition: RpcInterfaceDefinition, _impl: RpcInterface): void {\r\n    this.registerInterface(definition);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onRpcClientTerminated(definition: RpcInterfaceDefinition, _client: RpcInterface): void {\r\n    this.purgeInterface(definition);\r\n  }\r\n\r\n  /** @internal */\r\n  public override onRpcImplTerminated(definition: RpcInterfaceDefinition, _impl: RpcInterface): void {\r\n    this.purgeInterface(definition);\r\n  }\r\n\r\n  private registerInterface(definition: RpcInterfaceDefinition) {\r\n    if (ElectronRpcProtocol.instances.has(definition.interfaceName))\r\n      throw new IModelError(BentleyStatus.ERROR, `RPC interface \"${definition.interfaceName}\"\" is already associated with a protocol.`);\r\n\r\n    ElectronRpcProtocol.instances.set(definition.interfaceName, this);\r\n  }\r\n\r\n  private purgeInterface(definition: RpcInterfaceDefinition) {\r\n    ElectronRpcProtocol.instances.delete(definition.interfaceName);\r\n  }\r\n}\r\n"]}

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

@@ -0,0 +1,20 @@
+import { RpcRequest, RpcRequestFulfillment } from "@itwin/core-common";
+import { ElectronRpcProtocol } from "./ElectronRpcProtocol.js";
+/** @internal */
+export declare class ElectronRpcRequest extends RpcRequest {
+    private _res;
+    private _fulfillment;
+    /** Convenience access to the protocol of this request. */
+    readonly protocol: ElectronRpcProtocol;
+    /** Sends the request. */
+    protected send(): Promise<number>;
+    /** Loads the request. */
+    protected load(): Promise<import("@itwin/core-common").RpcSerializedValue>;
+    /** Sets request header values. */
+    protected setHeader(_name: string, _value: string): void;
+    /** @internal */
+    notifyResponse(fulfillment: RpcRequestFulfillment): void;
+    /** @internal */
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=ElectronRpcRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcRequest.d.ts","sourceRoot":"","sources":["../../../src/common/ElectronRpcRequest.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,UAAU,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gBAAgB;AAChB,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,OAAO,CAAC,IAAI,CAA4C;IACxD,OAAO,CAAC,YAAY,CAAgD;IAEpE,0DAA0D;IAC1D,SAAyB,QAAQ,EAAE,mBAAmB,CAA6C;IAEnG,yBAAyB;cACT,IAAI;IAcpB,yBAAyB;cACT,IAAI;IASpB,kCAAkC;IAClC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxD,gBAAgB;IACT,cAAc,CAAC,WAAW,EAAE,qBAAqB;IAKxD,gBAAgB;IACD,CAAC,MAAM,CAAC,OAAO,CAAC;CAIhC"}

package/lib/esm/common/ElectronRpcRequest.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 { RpcProtocolEvent, RpcRequest } from "@itwin/core-common";
+/** @internal */
+export class ElectronRpcRequest extends RpcRequest {
+    _res = () => undefined;
+    _fulfillment = undefined;
+    /** Convenience access to the protocol of this request. */
+    protocol = this.client.configuration.protocol;
+    /** Sends the request. */
+    async send() {
+        try {
+            this.protocol.requests.set(this.id, this);
+            const request = await this.protocol.serialize(this);
+            this.protocol.transport.sendRequest(request);
+        }
+        catch {
+            this.protocol.events.raiseEvent(RpcProtocolEvent.ConnectionErrorReceived, this); // eslint-disable-line @typescript-eslint/no-deprecated
+        }
+        return new Promise((resolve) => {
+            this._res = resolve;
+        });
+    }
+    /** Loads the request. */
+    async load() {
+        const fulfillment = this._fulfillment;
+        if (!fulfillment) {
+            throw new Error("No request fulfillment available.");
+        }
+        return fulfillment.result;
+    }
+    /** Sets request header values. */
+    setHeader(_name, _value) {
+        // No implementation
+    }
+    /** @internal */
+    notifyResponse(fulfillment) {
+        this._fulfillment = fulfillment;
+        this._res(fulfillment.status);
+    }
+    /** @internal */
+    [Symbol.dispose]() {
+        this.protocol.requests.delete(this.id);
+        super[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=ElectronRpcRequest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronRpcRequest.js","sourceRoot":"","sources":["../../../src/common/ElectronRpcRequest.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAyB,MAAM,oBAAoB,CAAC;AAGzF,gBAAgB;AAChB,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IACxC,IAAI,GAA4B,GAAG,EAAE,CAAC,SAAS,CAAC;IAChD,YAAY,GAAsC,SAAS,CAAC;IAEpE,0DAA0D;IACjC,QAAQ,GAAwB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAe,CAAC;IAEnG,yBAAyB;IACf,KAAK,CAAC,IAAI;QAClB,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC,CAAC,uDAAuD;QAC1I,CAAC;QAED,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACf,KAAK,CAAC,IAAI;QAClB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,WAAW,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,kCAAkC;IACxB,SAAS,CAAC,KAAa,EAAE,MAAc;QAC/C,oBAAoB;IACtB,CAAC;IAED,gBAAgB;IACT,cAAc,CAAC,WAAkC;QACtD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,gBAAgB;IACD,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,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 { RpcProtocolEvent, RpcRequest, RpcRequestFulfillment } from \"@itwin/core-common\";\r\nimport { ElectronRpcProtocol } from \"./ElectronRpcProtocol.js\";\r\n\r\n/** @internal */\r\nexport class ElectronRpcRequest extends RpcRequest {\r\n  private _res: (value: number) => void = () => undefined;\r\n  private _fulfillment: RpcRequestFulfillment | undefined = undefined;\r\n\r\n  /** Convenience access to the protocol of this request. */\r\n  public override readonly protocol: ElectronRpcProtocol = this.client.configuration.protocol as any;\r\n\r\n  /** Sends the request. */\r\n  protected async send() {\r\n    try {\r\n      this.protocol.requests.set(this.id, this);\r\n      const request = await this.protocol.serialize(this);\r\n      this.protocol.transport.sendRequest(request);\r\n    } catch {\r\n      this.protocol.events.raiseEvent(RpcProtocolEvent.ConnectionErrorReceived, this); // eslint-disable-line @typescript-eslint/no-deprecated\r\n    }\r\n\r\n    return new Promise<number>((resolve) => {\r\n      this._res = resolve;\r\n    });\r\n  }\r\n\r\n  /** Loads the request. */\r\n  protected async load() {\r\n    const fulfillment = this._fulfillment;\r\n    if (!fulfillment) {\r\n      throw new Error(\"No request fulfillment available.\");\r\n    }\r\n\r\n    return fulfillment.result;\r\n  }\r\n\r\n  /** Sets request header values. */\r\n  protected setHeader(_name: string, _value: string): void {\r\n    // No implementation\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyResponse(fulfillment: RpcRequestFulfillment) {\r\n    this._fulfillment = fulfillment;\r\n    this._res(fulfillment.status);\r\n  }\r\n\r\n  /** @internal */\r\n  public override[Symbol.dispose]() {\r\n    this.protocol.requests.delete(this.id);\r\n    super[Symbol.dispose]();\r\n  }\r\n}\r\n"]}

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

@@ -0,0 +1,13 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+/** These methods are stored on `window.itwinjs` */
+export interface ITwinElectronApi {
+    addListener: (channel: string, listener: ElectronListener) => void;
+    removeListener: (channel: string, listener: ElectronListener) => void;
+    invoke: (channel: string, ...data: any[]) => Promise<any>;
+    once: (channel: string, listener: ElectronListener) => void;
+    send: (channel: string, ...data: any[]) => void;
+}
+export type ElectronListener = (event: any, ...args: any[]) => void;
+//# sourceMappingURL=ITwinElectronApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ITwinElectronApi.d.ts","sourceRoot":"","sources":["../../../src/common/ITwinElectronApi.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnE,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC"}

package/lib/esm/common/ITwinElectronApi.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 {};
+//# sourceMappingURL=ITwinElectronApi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ITwinElectronApi.js","sourceRoot":"","sources":["../../../src/common/ITwinElectronApi.ts"],"names":[],"mappings":"AAAA;;;+FAG+F","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 RpcInterface\r\n */\r\n\r\n/** These methods are stored on `window.itwinjs` */\r\nexport interface ITwinElectronApi {\r\n  addListener: (channel: string, listener: ElectronListener) => void;\r\n  removeListener: (channel: string, listener: ElectronListener) => void;\r\n  invoke: (channel: string, ...data: any[]) => Promise<any>;\r\n  once: (channel: string, listener: ElectronListener) => void;\r\n  send: (channel: string, ...data: any[]) => void; // only valid for render -> main\r\n}\r\n\r\nexport type ElectronListener = (event: any, ...args: any[]) => void;\r\n"]}

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

@@ -0,0 +1,27 @@
+import { NativeAppOpts } from "@itwin/core-frontend";
+import type { ITwinElectronApi } from "../common/ITwinElectronApi.js";
+declare global {
+    interface Window {
+        itwinjs: ITwinElectronApi;
+    }
+}
+/** @beta */
+export type ElectronAppOpts = NativeAppOpts;
+/**
+ * Frontend of an Electron App.
+ * @beta
+ */
+export declare class ElectronApp {
+    private static _ipc?;
+    static get isValid(): boolean;
+    /**
+     * Start the frontend of an Electron application.
+     * @param opts Options for your ElectronApp
+     * @note This method must only be called from the frontend of an Electron app (i.e. when [ProcessDetector.isElectronAppFrontend]($bentley) is `true`).
+     */
+    static startup(opts?: ElectronAppOpts): Promise<void>;
+    static shutdown(): Promise<void>;
+    /** Proxy object for calling methods of `Electron.Dialog` */
+    static dialogIpc: import("@itwin/core-bentley").PickAsyncMethods<Electron.Dialog>;
+}
+//# sourceMappingURL=ElectronApp.d.ts.map

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

@@ -0,0 +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,+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/esm/frontend/ElectronApp.js

@@ -0,0 +1,67 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Renderer
+ */
+import { expectDefined, ProcessDetector } from "@itwin/core-bentley";
+import { IpcApp, NativeApp } from "@itwin/core-frontend";
+import { electronIpcStrings } from "../common/ElectronIpcInterface.js";
+import { ElectronRpcManager } from "../common/ElectronRpcManager.js";
+/**
+ * Frontend Ipc support for Electron apps.
+ */
+class ElectronIpc {
+    _api;
+    addListener(channelName, listener) {
+        this._api.addListener(channelName, listener);
+        return () => this._api.removeListener(channelName, listener);
+    }
+    removeListener(channelName, listener) {
+        this._api.removeListener(channelName, listener);
+    }
+    send(channel, ...data) {
+        this._api.send(channel, ...data);
+    }
+    async invoke(channel, ...args) {
+        return this._api.invoke(channel, ...args);
+    }
+    constructor() {
+        // use the methods on window.itwinjs exposed by ElectronPreload.ts, or ipcRenderer directly if running with nodeIntegration=true (**only** for tests).
+        // Note that `require("electron")` doesn't work with nodeIntegration=false - that's what it stops
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        this._api = window.itwinjs ?? require("electron").ipcRenderer;
+    }
+}
+/**
+ * Frontend of an Electron App.
+ * @beta
+ */
+export class ElectronApp {
+    static _ipc;
+    static get isValid() { return undefined !== this._ipc; }
+    /**
+     * Start the frontend of an Electron application.
+     * @param opts Options for your ElectronApp
+     * @note This method must only be called from the frontend of an Electron app (i.e. when [ProcessDetector.isElectronAppFrontend]($bentley) is `true`).
+     */
+    static async startup(opts) {
+        if (!ProcessDetector.isElectronAppFrontend)
+            throw new Error("Not running under Electron");
+        if (!this.isValid) {
+            this._ipc = new ElectronIpc();
+            ElectronRpcManager.initializeFrontend(this._ipc, opts?.iModelApp?.rpcInterfaces); // eslint-disable-line @typescript-eslint/no-deprecated
+        }
+        const ipc = expectDefined(this._ipc, "Electron IPC channel was not initialized.");
+        await NativeApp.startup(ipc, opts);
+    }
+    static async shutdown() {
+        this._ipc = undefined;
+        await NativeApp.shutdown();
+        ElectronRpcManager.terminateFrontend();
+    }
+    /** Proxy object for calling methods of `Electron.Dialog` */
+    static dialogIpc = IpcApp.makeIpcFunctionProxy(electronIpcStrings.dialogChannel, "callDialog");
+}
+//# sourceMappingURL=ElectronApp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronApp.js","sourceRoot":"","sources":["../../../src/frontend/ElectronApp.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAmB,MAAM,EAAE,SAAS,EAAiB,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;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,MAAM,OAAO,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,eAAe,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,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,uDAAuD;QAC3I,CAAC;QACD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,2CAA2C,CAAC,CAAC;QAClF,MAAM,SAAS,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,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC3B,kBAAkB,CAAC,iBAAiB,EAAE,CAAC;IACzC,CAAC;IAED,4DAA4D;IACrD,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,oBAAoB,CAAkB,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,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\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/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/package.json

@@ -1,7 +1,40 @@
 {
   "name": "@itwin/core-electron",
-  "version": "5.14.0-dev.7",
+  "version": "5.14.0-dev.9",
   "description": "iTwin.js ElectronHost and ElectronApp",
+  "exports": {
+    "./renderer": {
+      "import": {
+        "types": "./lib/esm/ElectronFrontend.d.ts",
+        "default": "./lib/esm/ElectronFrontend.js"
+      },
+      "require": {
+        "types": "./lib/cjs/ElectronFrontend.d.ts",
+        "default": "./lib/cjs/ElectronFrontend.js"
+      }
+    },
+    "./main": {
+      "types": "./lib/cjs/ElectronBackend.d.ts",
+      "import": "./lib/cjs/ElectronBackend.js",
+      "require": "./lib/cjs/ElectronBackend.js"
+    },
+    "./lib/cjs/*.js": "./lib/cjs/*.js",
+    "./lib/cjs/*": {
+      "types": "./lib/cjs/*.d.ts",
+      "default": "./lib/cjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "renderer": [
+        "lib/cjs/ElectronFrontend.d.ts"
+      ],
+      "main": [
+        "lib/cjs/ElectronBackend.d.ts"
+      ]
+    }
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -19,10 +52,10 @@
   },
   "peerDependencies": {
     "electron": ">=35.0.0 <45.0.0",
-    "@itwin/core-backend": "5.14.0-dev.7",
-    "@itwin/core-bentley": "5.14.0-dev.7",
-    "@itwin/core-common": "5.14.0-dev.7",
-    "@itwin/core-frontend": "5.14.0-dev.7"
+    "@itwin/core-backend": "5.14.0-dev.9",
+    "@itwin/core-bentley": "5.14.0-dev.9",
+    "@itwin/core-frontend": "5.14.0-dev.9",
+    "@itwin/core-common": "5.14.0-dev.9"
   },
   "devDependencies": {
     "@itwin/eslint-plugin": "^6.0.0",
@@ -40,16 +73,17 @@
     "typescript": "~5.6.2",
     "webpack": "^5.97.1",
     "webpack-cli": "^5.0.1",
-    "@itwin/build-tools": "5.14.0-dev.7",
-    "@itwin/certa": "5.14.0-dev.7",
-    "@itwin/core-common": "5.14.0-dev.7",
-    "@itwin/core-backend": "5.14.0-dev.7",
-    "@itwin/core-bentley": "5.14.0-dev.7",
-    "@itwin/core-frontend": "5.14.0-dev.7"
+    "@itwin/core-bentley": "5.14.0-dev.9",
+    "@itwin/core-common": "5.14.0-dev.9",
+    "@itwin/core-backend": "5.14.0-dev.9",
+    "@itwin/certa": "5.14.0-dev.9",
+    "@itwin/core-frontend": "5.14.0-dev.9",
+    "@itwin/build-tools": "5.14.0-dev.9"
   },
   "scripts": {
-    "build": "npm run -s build:cjs && npm run -s webpack:test && npm run -s copy:test-assets",
+    "build": "npm run -s build:cjs && npm run -s build:esm && npm run -s webpack:test && npm run -s copy:test-assets",
     "build:cjs": "tsc 1>&2 --outDir lib/cjs",
+    "build:esm": "rimraf -g lib/esm && tsc 1>&2 -p tsconfig.esm.json && node -e \"require('node:fs').writeFileSync('lib/esm/package.json', JSON.stringify({ type: 'module' }) + '\\n')\"",
     "copy:test-assets": "cpx \"./src/test/assets/**/*\" ./lib/cjs/test/assets",
     "clean": "rimraf -g lib .rush/temp/package-deps*.json",
     "docs": "betools docs --json=../../generated-docs/core/core-electron/file.json --tsIndexFile=./core-electron.ts --onlyJson",