@itwin/core-mobile 3.0.0-dev.100

package/lib/cjs/backend/MobileRpcServer.js

@@ -0,0 +1,136 @@
+"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.setupMobileRpc = exports.MobileRpcServer = void 0;
+const ws = require("ws");
+const core_common_1 = require("@itwin/core-common");
+const MobileRpcProtocol_1 = require("../common/MobileRpcProtocol");
+const MobileRpcManager_1 = require("../common/MobileRpcManager");
+const MobileHost_1 = require("./MobileHost");
+const core_bentley_1 = require("@itwin/core-bentley");
+let addon;
+class MobileRpcServer {
+    constructor() {
+        /* _pingTime is a fix for ios/mobile case where when app move into foreground from
+         * background backend restart ws.Server and then notify frontend to reconnect. But ws.Server
+         * listening event is not fired as node yield to kevent and wait for some io event to happen.
+         * This causes a delay in reconnection which may be as long a 40 secs. To solve the issue we
+         * create _pingTimer which causes kevent to yield back to uv poll so timer event can be fired.
+         * This allow listening event to go through quickly (max 5ms). Once the listening event occur we
+         * clear the timer. Here we use setInterval() just to make sure otherwise setTimeout() could equally
+         * be effective
+         */
+        this._pingTimer = setInterval(() => { }, 5);
+        this._port = MobileRpcManager_1.MobileRpcConfiguration.setup.obtainPort();
+        this._server = new ws.Server({ port: this._port });
+        this._connectionId = ++MobileRpcServer._nextId;
+        MobileRpcServer.interop.connectionId = this._connectionId;
+        this._onListening();
+        this._onConnection();
+    }
+    _onListening() {
+        this._server.on("listening", () => {
+            const address = this._server.address();
+            this._port = address.port;
+            clearInterval(this._pingTimer);
+            this._notifyListening();
+        });
+    }
+    _notifyListening() {
+        MobileRpcServer.interop.port = this._port;
+        if (addon) {
+            addon.notifyListening(this._port);
+        }
+        if (this._connectionId !== 0) {
+            MobileHost_1.MobileHost.reconnect(this._port);
+        }
+    }
+    _onConnection() {
+        this._server.on("connection", (connection) => {
+            this._connection = connection;
+            this._connection.on("message", (data) => this._onConnectionMessage(data));
+            this._createSender();
+            global.__iTwinJsRpcReady = true;
+        });
+    }
+    _createSender() {
+        const sender = (message, connectionId) => {
+            if (connectionId !== this._connectionId) {
+                return;
+            }
+            this._connection.send(message, (err) => {
+                if (err) {
+                    throw err;
+                }
+            });
+        };
+        MobileRpcServer.interop.sendString = sender;
+        MobileRpcServer.interop.sendBinary = sender;
+    }
+    _onConnectionMessage(data) {
+        let message = data;
+        if (Array.isArray(message)) {
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Unsupported data type");
+        }
+        if (Buffer.isBuffer(message)) {
+            if (message.byteOffset !== 0 || message.byteLength !== message.buffer.byteLength) {
+                message = new Uint8Array(message.buffer, message.byteOffset, message.byteLength);
+            }
+            else {
+                message = message.buffer;
+            }
+        }
+        MobileRpcServer.interop.handler(message, this._connectionId);
+    }
+    dispose() {
+        clearInterval(this._pingTimer);
+        if (this._connection) {
+            MobileRpcServer.interop.sendString = () => { };
+            MobileRpcServer.interop.sendBinary = () => { };
+            this._connection.close();
+        }
+        this._server.close();
+    }
+}
+exports.MobileRpcServer = MobileRpcServer;
+MobileRpcServer._nextId = -1;
+MobileRpcServer.interop = {
+    handler: (_payload) => { throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Not implemented."); },
+    sendString: (_message, _connectionId) => { throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "No connection."); },
+    sendBinary: (_message, _connectionId) => { throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "No connection."); },
+    port: 0,
+    connectionId: 0,
+};
+let mobileReady = false;
+let hasSuspended = false;
+function setupMobileRpc() {
+    if (mobileReady) {
+        return;
+    }
+    if (core_bentley_1.ProcessDetector.isMobileAppBackend) {
+        addon = process._linkedBinding("iModelJsMobile");
+        addon === null || addon === void 0 ? void 0 : addon.registerDeviceImpl();
+    }
+    let server = new MobileRpcServer();
+    MobileHost_1.MobileHost.onEnterBackground.addListener(() => {
+        hasSuspended = true;
+        if (server === null) {
+            return;
+        }
+        server.dispose();
+        server = null;
+    });
+    MobileHost_1.MobileHost.onEnterForeground.addListener(() => {
+        if (!hasSuspended) {
+            return;
+        }
+        server = new MobileRpcServer();
+    });
+    MobileRpcProtocol_1.MobileRpcProtocol.obtainInterop = () => MobileRpcServer.interop;
+    mobileReady = true;
+}
+exports.setupMobileRpc = setupMobileRpc;
+//# sourceMappingURL=MobileRpcServer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MobileRpcServer.js","sourceRoot":"","sources":["../../../src/backend/MobileRpcServer.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 * as ws from \"ws\";\r\nimport { BentleyStatus, IModelError } from \"@itwin/core-common\";\r\nimport { MobileRpcGateway, MobileRpcProtocol } from \"../common/MobileRpcProtocol\";\r\nimport { MobileRpcConfiguration } from \"../common/MobileRpcManager\";\r\nimport { MobileHost } from \"./MobileHost\";\r\nimport { ProcessDetector } from \"@itwin/core-bentley\";\r\n\r\ninterface MobileAddon {\r\n  notifyListening: (port: number) => void;\r\n  registerDeviceImpl: () => void;\r\n}\r\n\r\nlet addon: MobileAddon | undefined;\r\n\r\nexport class MobileRpcServer {\r\n  private static _nextId = -1;\r\n\r\n  public static interop: MobileRpcGateway = {\r\n    handler: (_payload: ArrayBuffer | string) => { throw new IModelError(BentleyStatus.ERROR, \"Not implemented.\"); },\r\n    sendString: (_message: string, _connectionId: number) => { throw new IModelError(BentleyStatus.ERROR, \"No connection.\"); },\r\n    sendBinary: (_message: Uint8Array, _connectionId: number) => { throw new IModelError(BentleyStatus.ERROR, \"No connection.\"); },\r\n    port: 0,\r\n    connectionId: 0,\r\n  };\r\n\r\n  private _server: ws.Server;\r\n  private _connection: ws | undefined;\r\n  private _port: number;\r\n  private _connectionId: number;\r\n  private _pingTimer: NodeJS.Timeout;\r\n  public constructor() {\r\n    /* _pingTime is a fix for ios/mobile case where when app move into foreground from\r\n     * background backend restart ws.Server and then notify frontend to reconnect. But ws.Server\r\n     * listening event is not fired as node yield to kevent and wait for some io event to happen.\r\n     * This causes a delay in reconnection which may be as long a 40 secs. To solve the issue we\r\n     * create _pingTimer which causes kevent to yield back to uv poll so timer event can be fired.\r\n     * This allow listening event to go through quickly (max 5ms). Once the listening event occur we\r\n     * clear the timer. Here we use setInterval() just to make sure otherwise setTimeout() could equally\r\n     * be effective\r\n     */\r\n    this._pingTimer = setInterval(() => { }, 5);\r\n    this._port = MobileRpcConfiguration.setup.obtainPort();\r\n    this._server = new ws.Server({ port: this._port });\r\n    this._connectionId = ++MobileRpcServer._nextId;\r\n    MobileRpcServer.interop.connectionId = this._connectionId;\r\n    this._onListening();\r\n    this._onConnection();\r\n  }\r\n\r\n  private _onListening() {\r\n    this._server.on(\"listening\", () => {\r\n      const address = this._server.address() as ws.AddressInfo;\r\n      this._port = address.port;\r\n      clearInterval(this._pingTimer);\r\n      this._notifyListening();\r\n    });\r\n  }\r\n\r\n  private _notifyListening() {\r\n    MobileRpcServer.interop.port = this._port;\r\n\r\n    if (addon) {\r\n      addon.notifyListening(this._port);\r\n    }\r\n\r\n    if (this._connectionId !== 0) {\r\n      MobileHost.reconnect(this._port);\r\n    }\r\n  }\r\n\r\n  private _onConnection() {\r\n    this._server.on(\"connection\", (connection) => {\r\n      this._connection = connection;\r\n      this._connection.on(\"message\", (data) => this._onConnectionMessage(data));\r\n      this._createSender();\r\n      (global as any).__iTwinJsRpcReady = true;\r\n    });\r\n  }\r\n\r\n  private _createSender() {\r\n    const sender = (message: string | Uint8Array, connectionId: number) => {\r\n      if (connectionId !== this._connectionId) {\r\n        return;\r\n      }\r\n\r\n      this._connection!.send(message, (err) => {\r\n        if (err) {\r\n          throw err;\r\n        }\r\n      });\r\n    };\r\n\r\n    MobileRpcServer.interop.sendString = sender;\r\n    MobileRpcServer.interop.sendBinary = sender;\r\n  }\r\n\r\n  private _onConnectionMessage(data: ws.Data) {\r\n    let message = data;\r\n    if (Array.isArray(message)) {\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unsupported data type\");\r\n    }\r\n\r\n    if (Buffer.isBuffer(message)) {\r\n      if (message.byteOffset !== 0 || message.byteLength !== message.buffer.byteLength) {\r\n        message = new Uint8Array(message.buffer, message.byteOffset, message.byteLength);\r\n      } else {\r\n        message = message.buffer;\r\n      }\r\n    }\r\n\r\n    MobileRpcServer.interop.handler(message, this._connectionId);\r\n  }\r\n\r\n  public dispose() {\r\n    clearInterval(this._pingTimer);\r\n    if (this._connection) {\r\n      MobileRpcServer.interop.sendString = () => { };\r\n      MobileRpcServer.interop.sendBinary = () => { };\r\n      this._connection.close();\r\n    }\r\n\r\n    this._server.close();\r\n  }\r\n}\r\n\r\nlet mobileReady = false;\r\nlet hasSuspended = false;\r\n\r\nexport function setupMobileRpc() {\r\n  if (mobileReady) {\r\n    return;\r\n  }\r\n\r\n  if (ProcessDetector.isMobileAppBackend) {\r\n    addon = (process as any)._linkedBinding(\"iModelJsMobile\");\r\n    addon?.registerDeviceImpl();\r\n  }\r\n\r\n  let server: MobileRpcServer | null = new MobileRpcServer();\r\n\r\n  MobileHost.onEnterBackground.addListener(() => {\r\n    hasSuspended = true;\r\n\r\n    if (server === null) {\r\n      return;\r\n    }\r\n\r\n    server.dispose();\r\n    server = null;\r\n  });\r\n\r\n  MobileHost.onEnterForeground.addListener(() => {\r\n    if (!hasSuspended) {\r\n      return;\r\n    }\r\n\r\n    server = new MobileRpcServer();\r\n  });\r\n\r\n  MobileRpcProtocol.obtainInterop = () => MobileRpcServer.interop;\r\n  mobileReady = true;\r\n}\r\n"]}

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

@@ -0,0 +1,11 @@
+import { MobileHost, MobileHostOpts } from "./MobileHost";
+/** @beta */
+export declare type IOSHostOpts = MobileHostOpts;
+/** @beta */
+export declare class IOSHost extends MobileHost {
+    /**
+     * Start the backend of an IOS app.
+     */
+    static startup(opt?: IOSHostOpts): Promise<void>;
+}
+//# sourceMappingURL=iOSHost.d.ts.map

package/lib/cjs/backend/iOSHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iOSHost.d.ts","sourceRoot":"","sources":["../../../src/backend/iOSHost.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAExE,YAAY;AACZ,oBAAY,WAAW,GAAG,cAAc,CAAC;AAEzC,YAAY;AACZ,qBAAa,OAAQ,SAAQ,UAAU;IACrC;;OAEG;WAC0B,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAKvE"}

package/lib/cjs/backend/iOSHost.js

@@ -0,0 +1,23 @@
+"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.IOSHost = void 0;
+const core_common_1 = require("@itwin/core-common");
+const MobileHost_1 = require("./MobileHost");
+/** @beta */
+class IOSHost extends MobileHost_1.MobileHost {
+    /**
+     * Start the backend of an IOS app.
+     */
+    static async startup(opt) {
+        var _a, _b, _c, _d;
+        const device = (_b = (_a = opt === null || opt === void 0 ? void 0 : opt.mobileHost) === null || _a === void 0 ? void 0 : _a.device) !== null && _b !== void 0 ? _b : new MobileHost_1.MobileDevice();
+        const socket = (_d = (_c = opt === null || opt === void 0 ? void 0 : opt.ipcHost) === null || _c === void 0 ? void 0 : _c.socket) !== null && _d !== void 0 ? _d : new core_common_1.IpcWebSocketBackend();
+        return MobileHost_1.MobileHost.startup({ ...opt, mobileHost: { ...opt === null || opt === void 0 ? void 0 : opt.mobileHost, device }, ipcHost: { ...opt === null || opt === void 0 ? void 0 : opt.ipcHost, socket } });
+    }
+}
+exports.IOSHost = IOSHost;
+//# sourceMappingURL=iOSHost.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iOSHost.js","sourceRoot":"","sources":["../../../src/backend/iOSHost.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,oDAAyD;AACzD,6CAAwE;AAKxE,YAAY;AACZ,MAAa,OAAQ,SAAQ,uBAAU;IACrC;;OAEG;IACI,MAAM,CAAU,KAAK,CAAC,OAAO,CAAC,GAAiB;;QACpD,MAAM,MAAM,GAAG,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,UAAU,0CAAE,MAAM,mCAAI,IAAK,yBAAoB,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,0CAAE,MAAM,mCAAI,IAAI,iCAAmB,EAAE,CAAC;QACjE,OAAO,uBAAU,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,GAAG,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1H,CAAC;CACF;AATD,0BASC","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 { IpcWebSocketBackend } from \"@itwin/core-common\";\r\nimport { MobileDevice, MobileHost, MobileHostOpts } from \"./MobileHost\";\r\n\r\n/** @beta */\r\nexport type IOSHostOpts = MobileHostOpts;\r\n\r\n/** @beta */\r\nexport class IOSHost extends MobileHost {\r\n  /**\r\n   * Start the backend of an IOS app.\r\n   */\r\n  public static override async startup(opt?: IOSHostOpts): Promise<void> {\r\n    const device = opt?.mobileHost?.device ?? new (MobileDevice as any)();\r\n    const socket = opt?.ipcHost?.socket ?? new IpcWebSocketBackend();\r\n    return MobileHost.startup({ ...opt, mobileHost: { ...opt?.mobileHost, device }, ipcHost: { ...opt?.ipcHost, socket } });\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/MobileAppProps.d.ts

@@ -0,0 +1,35 @@
+/** @internal */
+export declare const mobileAppChannel = "mobileApp";
+/** @internal */
+export declare const mobileAppNotify = "mobileApp-notify";
+export declare enum Orientation {
+    Unknown = 0,
+    Portrait = 1,
+    PortraitUpsideDown = 2,
+    LandscapeLeft = 4,
+    LandscapeRight = 8,
+    FaceUp = 16,
+    FaceDown = 32
+}
+export declare enum BatteryState {
+    Unknown = 0,
+    Unplugged = 1,
+    Charging = 2,
+    Full = 3
+}
+export interface MobileNotifications {
+    notifyMemoryWarning: () => void;
+    notifyOrientationChanged: () => void;
+    notifyEnterForeground: () => void;
+    notifyEnterBackground: () => void;
+    notifyWillTerminate: () => void;
+}
+export declare type DeviceEvents = "memoryWarning" | "orientationChanged" | "enterForeground" | "enterBackground" | "willTerminate";
+/**
+* The methods that may be invoked via Ipc from the frontend of a Mobile App that are implemented on its backend.
+* @internal
+*/
+export interface MobileAppFunctions {
+    reconnect: (connection: number) => Promise<void>;
+}
+//# sourceMappingURL=MobileAppProps.d.ts.map

package/lib/cjs/common/MobileAppProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileAppProps.d.ts","sourceRoot":"","sources":["../../../src/common/MobileAppProps.ts"],"names":[],"mappings":"AAKA,gBAAgB;AAChB,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,gBAAgB;AAChB,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD,oBAAY,WAAW;IACrB,OAAO,IAAI;IACX,QAAQ,IAAM;IACd,kBAAkB,IAAM;IACxB,aAAa,IAAM;IACnB,cAAc,IAAM;IACpB,MAAM,KAAO;IACb,QAAQ,KAAO;CAChB;AAED,oBAAY,YAAY;IACtB,OAAO,IAAI;IACX,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,IAAI,IAAI;CACT;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,wBAAwB,EAAE,MAAM,IAAI,CAAC;IACrC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED,oBAAY,YAAY,GAAG,eAAe,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE5H;;;EAGE;AACF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD"}

package/lib/cjs/common/MobileAppProps.js

@@ -0,0 +1,29 @@
+"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.BatteryState = exports.Orientation = exports.mobileAppNotify = exports.mobileAppChannel = void 0;
+/** @internal */
+exports.mobileAppChannel = "mobileApp";
+/** @internal */
+exports.mobileAppNotify = "mobileApp-notify";
+var Orientation;
+(function (Orientation) {
+    Orientation[Orientation["Unknown"] = 0] = "Unknown";
+    Orientation[Orientation["Portrait"] = 1] = "Portrait";
+    Orientation[Orientation["PortraitUpsideDown"] = 2] = "PortraitUpsideDown";
+    Orientation[Orientation["LandscapeLeft"] = 4] = "LandscapeLeft";
+    Orientation[Orientation["LandscapeRight"] = 8] = "LandscapeRight";
+    Orientation[Orientation["FaceUp"] = 16] = "FaceUp";
+    Orientation[Orientation["FaceDown"] = 32] = "FaceDown";
+})(Orientation = exports.Orientation || (exports.Orientation = {}));
+var BatteryState;
+(function (BatteryState) {
+    BatteryState[BatteryState["Unknown"] = 0] = "Unknown";
+    BatteryState[BatteryState["Unplugged"] = 1] = "Unplugged";
+    BatteryState[BatteryState["Charging"] = 2] = "Charging";
+    BatteryState[BatteryState["Full"] = 3] = "Full";
+})(BatteryState = exports.BatteryState || (exports.BatteryState = {}));
+//# sourceMappingURL=MobileAppProps.js.map

package/lib/cjs/common/MobileAppProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileAppProps.js","sourceRoot":"","sources":["../../../src/common/MobileAppProps.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,gBAAgB;AACH,QAAA,gBAAgB,GAAG,WAAW,CAAC;AAC5C,gBAAgB;AACH,QAAA,eAAe,GAAG,kBAAkB,CAAC;AAElD,IAAY,WAQX;AARD,WAAY,WAAW;IACrB,mDAAW,CAAA;IACX,qDAAc,CAAA;IACd,yEAAwB,CAAA;IACxB,+DAAmB,CAAA;IACnB,iEAAoB,CAAA;IACpB,kDAAa,CAAA;IACb,sDAAe,CAAA;AACjB,CAAC,EARW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAQtB;AAED,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,qDAAW,CAAA;IACX,yDAAa,CAAA;IACb,uDAAY,CAAA;IACZ,+CAAQ,CAAA;AACV,CAAC,EALW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAKvB","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/** @internal */\r\nexport const mobileAppChannel = \"mobileApp\";\r\n/** @internal */\r\nexport const mobileAppNotify = \"mobileApp-notify\";\r\n\r\nexport enum Orientation {\r\n  Unknown = 0,\r\n  Portrait = 0x1,\r\n  PortraitUpsideDown = 0x2,\r\n  LandscapeLeft = 0x4,\r\n  LandscapeRight = 0x8,\r\n  FaceUp = 0x10,\r\n  FaceDown = 0x20,\r\n}\r\n\r\nexport enum BatteryState {\r\n  Unknown = 0,\r\n  Unplugged = 1,\r\n  Charging = 2,\r\n  Full = 3,\r\n}\r\n\r\nexport interface MobileNotifications {\r\n  notifyMemoryWarning: () => void;\r\n  notifyOrientationChanged: () => void;\r\n  notifyEnterForeground: () => void;\r\n  notifyEnterBackground: () => void;\r\n  notifyWillTerminate: () => void;\r\n}\r\n\r\nexport type DeviceEvents = \"memoryWarning\" | \"orientationChanged\" | \"enterForeground\" | \"enterBackground\" | \"willTerminate\";\r\n\r\n/**\r\n* The methods that may be invoked via Ipc from the frontend of a Mobile App that are implemented on its backend.\r\n* @internal\r\n*/\r\nexport interface MobileAppFunctions {\r\n  reconnect: (connection: number) => Promise<void>;\r\n}\r\n"]}

package/lib/cjs/common/MobileEventLoop.d.ts

@@ -0,0 +1,12 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+/** @internal */
+export declare class MobileEventLoop {
+    private static _activeTasks;
+    private static _idleCallback;
+    static addTask(): void;
+    static removeTask(): void;
+    private static _idleHandler;
+}
+//# sourceMappingURL=MobileEventLoop.d.ts.map

package/lib/cjs/common/MobileEventLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileEventLoop.d.ts","sourceRoot":"","sources":["../../../src/common/MobileEventLoop.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,gBAAgB;AAChB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAK;IAChC,OAAO,CAAC,MAAM,CAAC,aAAa,CAA6B;WAE3C,OAAO;WAQP,UAAU;IASxB,OAAO,CAAC,MAAM,CAAC,YAAY;CAC5B"}

package/lib/cjs/common/MobileEventLoop.js

@@ -0,0 +1,31 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobileEventLoop = void 0;
+/** @internal */
+class MobileEventLoop {
+    static addTask() {
+        ++this._activeTasks;
+        if (this._idleCallback === null) {
+            this._idleCallback = setInterval(() => this._idleHandler());
+        }
+    }
+    static removeTask() {
+        --this._activeTasks;
+        if (this._activeTasks === 0 && this._idleCallback !== null) {
+            clearInterval(this._idleCallback);
+            this._idleCallback = null;
+        }
+    }
+    static _idleHandler() { }
+}
+exports.MobileEventLoop = MobileEventLoop;
+MobileEventLoop._activeTasks = 0;
+MobileEventLoop._idleCallback = null;
+//# sourceMappingURL=MobileEventLoop.js.map

package/lib/cjs/common/MobileEventLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileEventLoop.js","sourceRoot":"","sources":["../../../src/common/MobileEventLoop.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,gBAAgB;AAChB,MAAa,eAAe;IAInB,MAAM,CAAC,OAAO;QACnB,EAAE,IAAI,CAAC,YAAY,CAAC;QAEpB,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;SAC7D;IACH,CAAC;IAEM,MAAM,CAAC,UAAU;QACtB,EAAE,IAAI,CAAC,YAAY,CAAC;QAEpB,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE;YAC1D,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;SAC3B;IACH,CAAC;IAEO,MAAM,CAAC,YAAY,KAAK,CAAC;;AArBnC,0CAsBC;AArBgB,4BAAY,GAAG,CAAC,CAAC;AACjB,6BAAa,GAAwB,IAAI,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\n/** @internal */\r\nexport class MobileEventLoop {\r\n  private static _activeTasks = 0;\r\n  private static _idleCallback: NodeJS.Timer | null = null;\r\n\r\n  public static addTask() {\r\n    ++this._activeTasks;\r\n\r\n    if (this._idleCallback === null) {\r\n      this._idleCallback = setInterval(() => this._idleHandler());\r\n    }\r\n  }\r\n\r\n  public static removeTask() {\r\n    --this._activeTasks;\r\n\r\n    if (this._activeTasks === 0 && this._idleCallback !== null) {\r\n      clearInterval(this._idleCallback);\r\n      this._idleCallback = null;\r\n    }\r\n  }\r\n\r\n  private static _idleHandler() { }\r\n}\r\n"]}

package/lib/cjs/common/MobileIpc.d.ts

@@ -0,0 +1,18 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { IpcWebSocketMessage, IpcWebSocketTransport, RpcRequestFulfillment, SerializedRpcRequest } from "@itwin/core-common";
+import { MobileRpcProtocol } from "./MobileRpcProtocol";
+/** @internal */
+export declare class MobileIpcTransport extends IpcWebSocketTransport {
+    private _protocol;
+    private _client;
+    constructor(protocol: MobileRpcProtocol);
+    send(message: IpcWebSocketMessage): void;
+    consumeRequest(request: SerializedRpcRequest): boolean;
+    consumeResponse(response: RpcRequestFulfillment): boolean;
+    private sendToBackend;
+    private sendToFrontend;
+    private broadcast;
+}
+//# sourceMappingURL=MobileIpc.d.ts.map

package/lib/cjs/common/MobileIpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileIpc.d.ts","sourceRoot":"","sources":["../../../src/common/MobileIpc.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EACS,mBAAmB,EAA2B,qBAAqB,EAA2C,qBAAqB,EACjJ,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWxD,gBAAgB;AAChB,qBAAa,kBAAmB,SAAQ,qBAAqB;IAC3D,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,OAAO,CAAe;gBAEX,QAAQ,EAAE,iBAAiB;IAQvC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAQxC,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO;IAStD,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;YASlD,aAAa;YAOb,cAAc;IAU5B,OAAO,CAAC,SAAS;CAIlB"}

package/lib/cjs/common/MobileIpc.js

@@ -0,0 +1,71 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobileIpcTransport = void 0;
+const core_common_1 = require("@itwin/core-common");
+const MobileEventLoop_1 = require("./MobileEventLoop");
+const MobileRpcProtocol_1 = require("./MobileRpcProtocol");
+const MobileRpcRequest_1 = require("./MobileRpcRequest");
+const IPC = "__ipc__";
+class IpcInterface extends core_common_1.RpcInterface {
+    async send() { }
+}
+IpcInterface.interfaceName = IPC;
+IpcInterface.interfaceVersion = "0.0.0";
+/** @internal */
+class MobileIpcTransport extends core_common_1.IpcWebSocketTransport {
+    constructor(protocol) {
+        super();
+        this._protocol = protocol;
+        core_common_1.RpcManager.initializeInterface(IpcInterface);
+        this._client = core_common_1.RpcManager.getClientForInterface(IpcInterface);
+    }
+    send(message) {
+        if (message.type === core_common_1.IpcWebSocketMessageType.Send || message.type === core_common_1.IpcWebSocketMessageType.Invoke) {
+            this.sendToBackend(message); // eslint-disable-line @typescript-eslint/no-floating-promises
+        }
+        else if (message.type === core_common_1.IpcWebSocketMessageType.Push || message.type === core_common_1.IpcWebSocketMessageType.Response) {
+            this.sendToFrontend(message); // eslint-disable-line @typescript-eslint/no-floating-promises
+        }
+    }
+    consumeRequest(request) {
+        if (request.operation.interfaceDefinition !== IPC)
+            return false;
+        const message = core_common_1.RpcMarshaling.deserialize(this._protocol, request.parameters)[0];
+        this.broadcast({}, message);
+        return true;
+    }
+    consumeResponse(response) {
+        if (response.interfaceName !== IPC)
+            return false;
+        const message = core_common_1.RpcMarshaling.deserialize(this._protocol, response.result);
+        this.broadcast({}, message);
+        return true;
+    }
+    async sendToBackend(message) {
+        const request = new MobileRpcRequest_1.MobileRpcRequest(this._client, "send", [message]);
+        const encoded = await MobileRpcProtocol_1.MobileRpcProtocol.encodeRequest(request);
+        this._protocol.sendToBackend(encoded);
+        request.dispose();
+    }
+    async sendToFrontend(message) {
+        MobileEventLoop_1.MobileEventLoop.addTask();
+        const result = await core_common_1.RpcMarshaling.serialize(this._protocol, message);
+        MobileEventLoop_1.MobileEventLoop.removeTask();
+        const fulfillment = { result, rawResult: message, interfaceName: IPC, id: message.channel, status: 0 };
+        const encoded = MobileRpcProtocol_1.MobileRpcProtocol.encodeResponse(fulfillment);
+        this._protocol.sendToFrontend(encoded);
+    }
+    broadcast(evt, message) {
+        for (const listener of core_common_1.IpcWebSocket.receivers)
+            listener(evt, message);
+    }
+}
+exports.MobileIpcTransport = MobileIpcTransport;
+//# sourceMappingURL=MobileIpc.js.map

package/lib/cjs/common/MobileIpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileIpc.js","sourceRoot":"","sources":["../../../src/common/MobileIpc.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAG4B;AAC5B,uDAAoD;AACpD,2DAAwD;AACxD,yDAAsD;AAEtD,MAAM,GAAG,GAAG,SAAS,CAAC;AAEtB,MAAM,YAAa,SAAQ,0BAAY;IAG9B,KAAK,CAAC,IAAI,KAAK,CAAC;;AAFT,0BAAa,GAAG,GAAG,CAAC;AACpB,6BAAgB,GAAG,OAAO,CAAC;AAI3C,gBAAgB;AAChB,MAAa,kBAAmB,SAAQ,mCAAqB;IAI3D,YAAmB,QAA2B;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAE1B,wBAAU,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,wBAAU,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;IAEM,IAAI,CAAC,OAA4B;QACtC,IAAI,OAAO,CAAC,IAAI,KAAK,qCAAuB,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,qCAAuB,CAAC,MAAM,EAAE;YACpG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,8DAA8D;SAC5F;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,qCAAuB,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,qCAAuB,CAAC,QAAQ,EAAE;YAC7G,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,8DAA8D;SAC7F;IACH,CAAC;IAEM,cAAc,CAAC,OAA6B;QACjD,IAAI,OAAO,CAAC,SAAS,CAAC,mBAAmB,KAAK,GAAG;YAC/C,OAAO,KAAK,CAAC;QAEf,MAAM,OAAO,GAAG,2BAAa,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAwB,CAAC;QACxG,IAAI,CAAC,SAAS,CAAC,EAAW,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,eAAe,CAAC,QAA+B;QACpD,IAAI,QAAQ,CAAC,aAAa,KAAK,GAAG;YAChC,OAAO,KAAK,CAAC;QAEf,MAAM,OAAO,GAAG,2BAAa,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAwB,CAAC;QAClG,IAAI,CAAC,SAAS,CAAC,EAAW,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAA4B;QACtD,MAAM,OAAO,GAAG,IAAI,mCAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,qCAAiB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAA4B;QACvD,iCAAe,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,2BAAa,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtE,iCAAe,CAAC,UAAU,EAAE,CAAC;QAE7B,MAAM,WAAW,GAA0B,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC9H,MAAM,OAAO,GAAG,qCAAiB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAEO,SAAS,CAAC,GAAU,EAAE,OAA4B;QACxD,KAAK,MAAM,QAAQ,IAAI,0BAAY,CAAC,SAAS;YAC3C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF;AA3DD,gDA2DC","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 {\r\n  IpcWebSocket, IpcWebSocketMessage, IpcWebSocketMessageType, IpcWebSocketTransport, RpcInterface, RpcManager, RpcMarshaling, RpcRequestFulfillment,\r\n  SerializedRpcRequest,\r\n} from \"@itwin/core-common\";\r\nimport { MobileEventLoop } from \"./MobileEventLoop\";\r\nimport { MobileRpcProtocol } from \"./MobileRpcProtocol\";\r\nimport { MobileRpcRequest } from \"./MobileRpcRequest\";\r\n\r\nconst IPC = \"__ipc__\";\r\n\r\nclass IpcInterface extends RpcInterface {\r\n  public static interfaceName = IPC;\r\n  public static interfaceVersion = \"0.0.0\";\r\n  public async send() { }\r\n}\r\n\r\n/** @internal */\r\nexport class MobileIpcTransport extends IpcWebSocketTransport {\r\n  private _protocol: MobileRpcProtocol;\r\n  private _client: IpcInterface;\r\n\r\n  public constructor(protocol: MobileRpcProtocol) {\r\n    super();\r\n    this._protocol = protocol;\r\n\r\n    RpcManager.initializeInterface(IpcInterface);\r\n    this._client = RpcManager.getClientForInterface(IpcInterface);\r\n  }\r\n\r\n  public send(message: IpcWebSocketMessage): void {\r\n    if (message.type === IpcWebSocketMessageType.Send || message.type === IpcWebSocketMessageType.Invoke) {\r\n      this.sendToBackend(message); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    } else if (message.type === IpcWebSocketMessageType.Push || message.type === IpcWebSocketMessageType.Response) {\r\n      this.sendToFrontend(message); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n    }\r\n  }\r\n\r\n  public consumeRequest(request: SerializedRpcRequest): boolean {\r\n    if (request.operation.interfaceDefinition !== IPC)\r\n      return false;\r\n\r\n    const message = RpcMarshaling.deserialize(this._protocol, request.parameters)[0] as IpcWebSocketMessage;\r\n    this.broadcast({} as Event, message);\r\n    return true;\r\n  }\r\n\r\n  public consumeResponse(response: RpcRequestFulfillment): boolean {\r\n    if (response.interfaceName !== IPC)\r\n      return false;\r\n\r\n    const message = RpcMarshaling.deserialize(this._protocol, response.result) as IpcWebSocketMessage;\r\n    this.broadcast({} as Event, message);\r\n    return true;\r\n  }\r\n\r\n  private async sendToBackend(message: IpcWebSocketMessage) {\r\n    const request = new MobileRpcRequest(this._client, \"send\", [message]);\r\n    const encoded = await MobileRpcProtocol.encodeRequest(request);\r\n    this._protocol.sendToBackend(encoded);\r\n    request.dispose();\r\n  }\r\n\r\n  private async sendToFrontend(message: IpcWebSocketMessage) {\r\n    MobileEventLoop.addTask();\r\n    const result = await RpcMarshaling.serialize(this._protocol, message);\r\n    MobileEventLoop.removeTask();\r\n\r\n    const fulfillment: RpcRequestFulfillment = { result, rawResult: message, interfaceName: IPC, id: message.channel, status: 0 };\r\n    const encoded = MobileRpcProtocol.encodeResponse(fulfillment);\r\n    this._protocol.sendToFrontend(encoded);\r\n  }\r\n\r\n  private broadcast(evt: Event, message: IpcWebSocketMessage) {\r\n    for (const listener of IpcWebSocket.receivers)\r\n      listener(evt, message);\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/MobilePush.d.ts

@@ -0,0 +1,21 @@
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcPushChannel, RpcPushConnection, RpcPushTransport, RpcRequestFulfillment } from "@itwin/core-common";
+import { MobileRpcProtocol } from "./MobileRpcProtocol";
+/** @internal */
+export declare class MobilePushTransport extends RpcPushTransport {
+    private _protocol;
+    private _last;
+    get last(): number;
+    constructor(protocol: MobileRpcProtocol);
+    consume(response: RpcRequestFulfillment): boolean;
+}
+/** @internal */
+export declare class MobilePushConnection<T> extends RpcPushConnection<T> {
+    private _protocol;
+    private _next;
+    constructor(channel: RpcPushChannel<T>, client: unknown, protocol: MobileRpcProtocol);
+    send(messageData: any): Promise<void>;
+}
+//# sourceMappingURL=MobilePush.d.ts.map

package/lib/cjs/common/MobilePush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobilePush.d.ts","sourceRoot":"","sources":["../../../src/common/MobilePush.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAiB,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE/H,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,gBAAgB;AAChB,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,KAAK,CAAc;IAE3B,IAAW,IAAI,WAAyB;gBAErB,QAAQ,EAAE,iBAAiB;IAKvC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO;CAczD;AAED,gBAAgB;AAChB,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,KAAK,CAAc;gBAER,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB;IAK9E,IAAI,CAAC,WAAW,EAAE,GAAG;CASnC"}

package/lib/cjs/common/MobilePush.js

@@ -0,0 +1,53 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MobilePushConnection = exports.MobilePushTransport = void 0;
+const core_common_1 = require("@itwin/core-common");
+const MobileEventLoop_1 = require("./MobileEventLoop");
+const MobileRpcProtocol_1 = require("./MobileRpcProtocol");
+const PUSH = "__push__";
+/** @internal */
+class MobilePushTransport extends core_common_1.RpcPushTransport {
+    constructor(protocol) {
+        super();
+        this._last = -1;
+        this._protocol = protocol;
+    }
+    get last() { return this._last; }
+    consume(response) {
+        if (response.interfaceName !== PUSH) {
+            return false;
+        }
+        this._last = response.status;
+        if (this.onMessage) {
+            const messageData = core_common_1.RpcMarshaling.deserialize(this._protocol, response.result);
+            this.onMessage(response.id, messageData);
+        }
+        return true;
+    }
+}
+exports.MobilePushTransport = MobilePushTransport;
+/** @internal */
+class MobilePushConnection extends core_common_1.RpcPushConnection {
+    constructor(channel, client, protocol) {
+        super(channel, client);
+        this._next = -1;
+        this._protocol = protocol;
+    }
+    async send(messageData) {
+        MobileEventLoop_1.MobileEventLoop.addTask();
+        const result = await core_common_1.RpcMarshaling.serialize(this._protocol, messageData);
+        MobileEventLoop_1.MobileEventLoop.removeTask();
+        const fulfillment = { result, rawResult: messageData, interfaceName: PUSH, id: this.channel.id, status: ++this._next };
+        const encoded = MobileRpcProtocol_1.MobileRpcProtocol.encodeResponse(fulfillment);
+        this._protocol.sendToFrontend(encoded);
+    }
+}
+exports.MobilePushConnection = MobilePushConnection;
+//# sourceMappingURL=MobilePush.js.map

package/lib/cjs/common/MobilePush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobilePush.js","sourceRoot":"","sources":["../../../src/common/MobilePush.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAA+H;AAC/H,uDAAoD;AACpD,2DAAwD;AAExD,MAAM,IAAI,GAAG,UAAU,CAAC;AAExB,gBAAgB;AAChB,MAAa,mBAAoB,SAAQ,8BAAgB;IAMvD,YAAmB,QAA2B;QAC5C,KAAK,EAAE,CAAC;QALF,UAAK,GAAW,CAAC,CAAC,CAAC;QAMzB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IALD,IAAW,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAOjC,OAAO,CAAC,QAA+B;QAC5C,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SACd;QAED,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE7B,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,MAAM,WAAW,GAAG,2BAAa,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;SAC1C;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAzBD,kDAyBC;AAED,gBAAgB;AAChB,MAAa,oBAAwB,SAAQ,+BAAoB;IAI/D,YAAmB,OAA0B,EAAE,MAAe,EAAE,QAA2B;QACzF,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAHjB,UAAK,GAAW,CAAC,CAAC,CAAC;QAIzB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,WAAgB;QAChC,iCAAe,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,2BAAa,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC1E,iCAAe,CAAC,UAAU,EAAE,CAAC;QAE7B,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,MAAM,OAAO,GAAG,qCAAiB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAlBD,oDAkBC","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 { RpcMarshaling, RpcPushChannel, RpcPushConnection, RpcPushTransport, RpcRequestFulfillment } from \"@itwin/core-common\";\r\nimport { MobileEventLoop } from \"./MobileEventLoop\";\r\nimport { MobileRpcProtocol } from \"./MobileRpcProtocol\";\r\n\r\nconst PUSH = \"__push__\";\r\n\r\n/** @internal */\r\nexport class MobilePushTransport extends RpcPushTransport {\r\n  private _protocol: MobileRpcProtocol;\r\n  private _last: number = -1;\r\n\r\n  public get last() { return this._last; }\r\n\r\n  public constructor(protocol: MobileRpcProtocol) {\r\n    super();\r\n    this._protocol = protocol;\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._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 MobilePushConnection<T> extends RpcPushConnection<T> {\r\n  private _protocol: MobileRpcProtocol;\r\n  private _next: number = -1;\r\n\r\n  public constructor(channel: RpcPushChannel<T>, client: unknown, protocol: MobileRpcProtocol) {\r\n    super(channel, client);\r\n    this._protocol = protocol;\r\n  }\r\n\r\n  public async send(messageData: any) {\r\n    MobileEventLoop.addTask();\r\n    const result = await RpcMarshaling.serialize(this._protocol, messageData);\r\n    MobileEventLoop.removeTask();\r\n\r\n    const fulfillment: RpcRequestFulfillment = { result, rawResult: messageData, interfaceName: PUSH, id: this.channel.id, status: ++this._next };\r\n    const encoded = MobileRpcProtocol.encodeResponse(fulfillment);\r\n    this._protocol.sendToFrontend(encoded);\r\n  }\r\n}\r\n"]}

package/lib/cjs/common/MobileRpcManager.d.ts

@@ -0,0 +1,41 @@
+import { RpcConfiguration, RpcInterfaceDefinition } from "@itwin/core-common";
+import { MobileRpcProtocol } from "./MobileRpcProtocol";
+/** RPC supported mobile platforms.
+ * @beta
+ */
+export declare enum RpcMobilePlatform {
+    Unknown = 0,
+    Android = 1,
+    iOS = 2
+}
+/** Holds configuration for the RpcInterfaces used by the application.
+ * @beta
+ */
+export declare abstract class MobileRpcConfiguration extends RpcConfiguration {
+    /** @internal */
+    static setup: {
+        obtainPort: () => number;
+        checkPlatform: () => boolean;
+    };
+    abstract protocol: MobileRpcProtocol;
+    private static _args;
+    private static getArgs;
+    private static getMobilePlatform;
+    /** Read the mobile rpc args */
+    static get args(): any;
+    /** Return type of mobile platform using browser userAgent */
+    static get platform(): RpcMobilePlatform;
+}
+/** Coordinates usage of RPC interfaces for an Mobile-based application.
+ * @beta
+ */
+export declare class MobileRpcManager {
+    /** @internal */
+    static ready(): Promise<void>;
+    private static performInitialization;
+    /** Initializes MobileRpcManager for the frontend of an application. */
+    static initializeClient(interfaces: RpcInterfaceDefinition[]): MobileRpcConfiguration;
+    /** Initializes MobileRpcManager for the backend of an application. */
+    static initializeImpl(interfaces: RpcInterfaceDefinition[]): MobileRpcConfiguration;
+}
+//# sourceMappingURL=MobileRpcManager.d.ts.map

package/lib/cjs/common/MobileRpcManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileRpcManager.d.ts","sourceRoot":"","sources":["../../../src/common/MobileRpcManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAe,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,OAAO,IAAA;IACP,OAAO,IAAA;IACP,GAAG,IAAA;CACJ;AAED;;GAEG;AACH,8BAAsB,sBAAuB,SAAQ,gBAAgB;IACnE,gBAAgB;IAChB,OAAc,KAAK;;;MAGjB;IAEF,SAAyB,QAAQ,EAAE,iBAAiB,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAM;IAC1B,OAAO,CAAC,MAAM,CAAC,OAAO;IAoBtB,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAehC,+BAA+B;IAC/B,WAAkB,IAAI,IAAI,GAAG,CAK5B;IAED,6DAA6D;IAC7D,WAAkB,QAAQ,IAAI,iBAAiB,CAAuD;CACvG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,gBAAgB;WACI,KAAK;IAUzB,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAgBpC,uEAAuE;WACzD,gBAAgB,CAAC,UAAU,EAAE,sBAAsB,EAAE,GAAG,sBAAsB;IAG5F,sEAAsE;WACxD,cAAc,CAAC,UAAU,EAAE,sBAAsB,EAAE,GAAG,sBAAsB;CAG3F"}