@itwin/core-backend 4.0.0-dev.44 → 4.0.0-dev.48

package/lib/cjs/NativeHost.js

@@ -1,161 +1,161 @@
-"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 NativeApp
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NativeHost = void 0;
-const path_1 = require("path");
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const BriefcaseManager_1 = require("./BriefcaseManager");
-const CheckpointManager_1 = require("./CheckpointManager");
-const IModelHost_1 = require("./IModelHost");
-const IpcHost_1 = require("./IpcHost");
-const NativeAppStorage_1 = require("./NativeAppStorage");
-/**
- * Implementation of NativeAppFunctions
- */
-class NativeAppHandler extends IpcHost_1.IpcHandler {
-    get channelName() { return core_common_1.nativeAppChannel; }
-    async getAccessToken() {
-        return IModelHost_1.IModelHost.authorizationClient?.getAccessToken();
-    }
-    async checkInternetConnectivity() {
-        return NativeHost.checkInternetConnectivity();
-    }
-    async overrideInternetConnectivity(by, status) {
-        NativeHost.overrideInternetConnectivity(by, status);
-    }
-    async acquireNewBriefcaseId(iModelId) {
-        return BriefcaseManager_1.BriefcaseManager.acquireNewBriefcaseId({ iModelId });
-    }
-    async getBriefcaseFileName(props) {
-        return BriefcaseManager_1.BriefcaseManager.getFileName(props);
-    }
-    async downloadBriefcase(request, reportProgress, progressInterval) {
-        const args = {
-            ...request,
-            accessToken: await this.getAccessToken(),
-            onProgress: (_a, _b) => checkAbort(),
-        };
-        const checkAbort = () => {
-            (0, core_bentley_1.assert)(undefined !== args.fileName);
-            const job = CheckpointManager_1.Downloads.isInProgress(args.fileName);
-            return (job && job.request.abort === 1) ? CheckpointManager_1.ProgressStatus.Abort : CheckpointManager_1.ProgressStatus.Continue;
-        };
-        if (reportProgress) {
-            const progressCallback = (loaded, total) => {
-                IpcHost_1.IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });
-                return checkAbort();
-            };
-            args.onProgress = (0, IpcHost_1.throttleProgressCallback)(progressCallback, checkAbort, progressInterval);
-        }
-        return BriefcaseManager_1.BriefcaseManager.downloadBriefcase(args);
-    }
-    async requestCancelDownloadBriefcase(fileName) {
-        const job = CheckpointManager_1.Downloads.isInProgress(fileName);
-        if (job)
-            job.request.abort = 1;
-        return job !== undefined;
-    }
-    async deleteBriefcaseFiles(fileName) {
-        await BriefcaseManager_1.BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost_1.IModelHost.getAccessToken());
-    }
-    async getCachedBriefcases(iModelId) {
-        return BriefcaseManager_1.BriefcaseManager.getCachedBriefcases(iModelId);
-    }
-    async storageMgrOpen(storageId) {
-        return NativeAppStorage_1.NativeAppStorage.open(storageId).id;
-    }
-    async storageMgrClose(storageId, deleteIt) {
-        NativeAppStorage_1.NativeAppStorage.find(storageId).close(deleteIt);
-    }
-    async storageMgrNames() {
-        return NativeAppStorage_1.NativeAppStorage.getStorageNames();
-    }
-    async storageGetValueType(storageId, key) {
-        return NativeAppStorage_1.NativeAppStorage.find(storageId).getValueType(key);
-    }
-    async storageGet(storageId, key) {
-        return NativeAppStorage_1.NativeAppStorage.find(storageId).getData(key);
-    }
-    async storageSet(storageId, key, value) {
-        NativeAppStorage_1.NativeAppStorage.find(storageId).setData(key, value);
-    }
-    async storageRemove(storageId, key) {
-        NativeAppStorage_1.NativeAppStorage.find(storageId).removeData(key);
-    }
-    async storageKeys(storageId) {
-        return NativeAppStorage_1.NativeAppStorage.find(storageId).getKeys();
-    }
-    async storageRemoveAll(storageId) {
-        NativeAppStorage_1.NativeAppStorage.find(storageId).removeAll();
-    }
-}
-/**
- * Backend for desktop/mobile native applications
- * @public
- */
-class NativeHost {
-    constructor() { } // no instances - static methods only
-    /** Get the local cache folder for application settings */
-    static get appSettingsCacheDir() {
-        if (this._appSettingsCacheDir === undefined)
-            this._appSettingsCacheDir = (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, "appSettings");
-        return this._appSettingsCacheDir;
-    }
-    /** Send a notification to the NativeApp connected to this NativeHost. */
-    static notifyNativeFrontend(methodName, ...args) {
-        return IpcHost_1.IpcHost.send(core_common_1.nativeAppNotify, methodName, ...args);
-    }
-    static get isValid() { return this._isValid; }
-    static get applicationName() { return this._applicationName; }
-    /** Get the settings store for this NativeHost. */
-    static get settingsStore() {
-        return NativeAppStorage_1.NativeAppStorage.open(this.applicationName);
-    }
-    /**
-     * Start the backend of a native app.
-     * @note this method calls [[IpcHost.startup]] internally.
-     */
-    static async startup(opt) {
-        if (!this.isValid) {
-            this._isValid = true;
-            this.onInternetConnectivityChanged.addListener((status) => NativeHost.notifyNativeFrontend("notifyInternetConnectivityChanged", status));
-            this._applicationName = opt?.nativeHost?.applicationName ?? "iTwinApp";
-        }
-        await IpcHost_1.IpcHost.startup(opt);
-        if (IpcHost_1.IpcHost.isValid) // for tests, we use NativeHost but don't have a frontend
-            NativeAppHandler.register();
-    }
-    /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */
-    static async shutdown() {
-        this._isValid = false;
-        this.onInternetConnectivityChanged.clear();
-        await IpcHost_1.IpcHost.shutdown();
-    }
-    /** get current value of internet connectivity */
-    static checkInternetConnectivity() {
-        return this._reachability ?? core_common_1.InternetConnectivityStatus.Online;
-    }
-    /**
-     * Override internet connectivity state
-     * @param _overridenBy who overrode the value.
-     * @internal
-     */
-    static overrideInternetConnectivity(_overridenBy, status) {
-        if (this._reachability !== status) {
-            this._reachability = status;
-            this.onInternetConnectivityChanged.raiseEvent(status);
-        }
-    }
-}
-exports.NativeHost = NativeHost;
-/** Event called when the internet connectivity changes, if known. */
-NativeHost.onInternetConnectivityChanged = new core_bentley_1.BeEvent();
-NativeHost._isValid = false;
+"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 NativeApp
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeHost = void 0;
+const path_1 = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const BriefcaseManager_1 = require("./BriefcaseManager");
+const CheckpointManager_1 = require("./CheckpointManager");
+const IModelHost_1 = require("./IModelHost");
+const IpcHost_1 = require("./IpcHost");
+const NativeAppStorage_1 = require("./NativeAppStorage");
+/**
+ * Implementation of NativeAppFunctions
+ */
+class NativeAppHandler extends IpcHost_1.IpcHandler {
+    get channelName() { return core_common_1.nativeAppChannel; }
+    async getAccessToken() {
+        return IModelHost_1.IModelHost.authorizationClient?.getAccessToken();
+    }
+    async checkInternetConnectivity() {
+        return NativeHost.checkInternetConnectivity();
+    }
+    async overrideInternetConnectivity(by, status) {
+        NativeHost.overrideInternetConnectivity(by, status);
+    }
+    async acquireNewBriefcaseId(iModelId) {
+        return BriefcaseManager_1.BriefcaseManager.acquireNewBriefcaseId({ iModelId });
+    }
+    async getBriefcaseFileName(props) {
+        return BriefcaseManager_1.BriefcaseManager.getFileName(props);
+    }
+    async downloadBriefcase(request, reportProgress, progressInterval) {
+        const args = {
+            ...request,
+            accessToken: await this.getAccessToken(),
+            onProgress: (_a, _b) => checkAbort(),
+        };
+        const checkAbort = () => {
+            (0, core_bentley_1.assert)(undefined !== args.fileName);
+            const job = CheckpointManager_1.Downloads.isInProgress(args.fileName);
+            return (job && job.request.abort === 1) ? CheckpointManager_1.ProgressStatus.Abort : CheckpointManager_1.ProgressStatus.Continue;
+        };
+        if (reportProgress) {
+            const progressCallback = (loaded, total) => {
+                IpcHost_1.IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });
+                return checkAbort();
+            };
+            args.onProgress = (0, IpcHost_1.throttleProgressCallback)(progressCallback, checkAbort, progressInterval);
+        }
+        return BriefcaseManager_1.BriefcaseManager.downloadBriefcase(args);
+    }
+    async requestCancelDownloadBriefcase(fileName) {
+        const job = CheckpointManager_1.Downloads.isInProgress(fileName);
+        if (job)
+            job.request.abort = 1;
+        return job !== undefined;
+    }
+    async deleteBriefcaseFiles(fileName) {
+        await BriefcaseManager_1.BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost_1.IModelHost.getAccessToken());
+    }
+    async getCachedBriefcases(iModelId) {
+        return BriefcaseManager_1.BriefcaseManager.getCachedBriefcases(iModelId);
+    }
+    async storageMgrOpen(storageId) {
+        return NativeAppStorage_1.NativeAppStorage.open(storageId).id;
+    }
+    async storageMgrClose(storageId, deleteIt) {
+        NativeAppStorage_1.NativeAppStorage.find(storageId).close(deleteIt);
+    }
+    async storageMgrNames() {
+        return NativeAppStorage_1.NativeAppStorage.getStorageNames();
+    }
+    async storageGetValueType(storageId, key) {
+        return NativeAppStorage_1.NativeAppStorage.find(storageId).getValueType(key);
+    }
+    async storageGet(storageId, key) {
+        return NativeAppStorage_1.NativeAppStorage.find(storageId).getData(key);
+    }
+    async storageSet(storageId, key, value) {
+        NativeAppStorage_1.NativeAppStorage.find(storageId).setData(key, value);
+    }
+    async storageRemove(storageId, key) {
+        NativeAppStorage_1.NativeAppStorage.find(storageId).removeData(key);
+    }
+    async storageKeys(storageId) {
+        return NativeAppStorage_1.NativeAppStorage.find(storageId).getKeys();
+    }
+    async storageRemoveAll(storageId) {
+        NativeAppStorage_1.NativeAppStorage.find(storageId).removeAll();
+    }
+}
+/**
+ * Backend for desktop/mobile native applications
+ * @public
+ */
+class NativeHost {
+    constructor() { } // no instances - static methods only
+    /** Get the local cache folder for application settings */
+    static get appSettingsCacheDir() {
+        if (this._appSettingsCacheDir === undefined)
+            this._appSettingsCacheDir = (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, "appSettings");
+        return this._appSettingsCacheDir;
+    }
+    /** Send a notification to the NativeApp connected to this NativeHost. */
+    static notifyNativeFrontend(methodName, ...args) {
+        return IpcHost_1.IpcHost.send(core_common_1.nativeAppNotify, methodName, ...args);
+    }
+    static get isValid() { return this._isValid; }
+    static get applicationName() { return this._applicationName; }
+    /** Get the settings store for this NativeHost. */
+    static get settingsStore() {
+        return NativeAppStorage_1.NativeAppStorage.open(this.applicationName);
+    }
+    /**
+     * Start the backend of a native app.
+     * @note this method calls [[IpcHost.startup]] internally.
+     */
+    static async startup(opt) {
+        if (!this.isValid) {
+            this._isValid = true;
+            this.onInternetConnectivityChanged.addListener((status) => NativeHost.notifyNativeFrontend("notifyInternetConnectivityChanged", status));
+            this._applicationName = opt?.nativeHost?.applicationName ?? "iTwinApp";
+        }
+        await IpcHost_1.IpcHost.startup(opt);
+        if (IpcHost_1.IpcHost.isValid) // for tests, we use NativeHost but don't have a frontend
+            NativeAppHandler.register();
+    }
+    /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */
+    static async shutdown() {
+        this._isValid = false;
+        this.onInternetConnectivityChanged.clear();
+        await IpcHost_1.IpcHost.shutdown();
+    }
+    /** get current value of internet connectivity */
+    static checkInternetConnectivity() {
+        return this._reachability ?? core_common_1.InternetConnectivityStatus.Online;
+    }
+    /**
+     * Override internet connectivity state
+     * @param _overridenBy who overrode the value.
+     * @internal
+     */
+    static overrideInternetConnectivity(_overridenBy, status) {
+        if (this._reachability !== status) {
+            this._reachability = status;
+            this.onInternetConnectivityChanged.raiseEvent(status);
+        }
+    }
+}
+exports.NativeHost = NativeHost;
+/** Event called when the internet connectivity changes, if known. */
+NativeHost.onInternetConnectivityChanged = new core_bentley_1.BeEvent();
+NativeHost._isValid = false;
 //# sourceMappingURL=NativeHost.js.map

package/lib/cjs/NativeHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeHost.js","sourceRoot":"","sources":["../../src/NativeHost.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,+BAA4B;AAC5B,sDAA+E;AAC/E,oDAG4B;AAC5B,yDAA8E;AAC9E,2DAAkF;AAClF,6CAA0C;AAC1C,uCAAuF;AACvF,yDAAsD;AAEtD;;GAEG;AACH,MAAM,gBAAiB,SAAQ,oBAAU;IACvC,IAAW,WAAW,KAAK,OAAO,8BAAgB,CAAC,CAAC,CAAC;IAE9C,KAAK,CAAC,cAAc;QACzB,OAAO,uBAAU,CAAC,mBAAmB,EAAE,cAAc,EAAE,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,yBAAyB;QACpC,OAAO,UAAU,CAAC,yBAAyB,EAAE,CAAC;IAChD,CAAC;IACM,KAAK,CAAC,4BAA4B,CAAC,EAAgB,EAAE,MAAkC;QAC5F,UAAU,CAAC,4BAA4B,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IACM,KAAK,CAAC,qBAAqB,CAAC,QAAoB;QACrD,OAAO,mCAAgB,CAAC,qBAAqB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IACM,KAAK,CAAC,oBAAoB,CAAC,KAAqB;QACrD,OAAO,mCAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACM,KAAK,CAAC,iBAAiB,CAAC,OAAiC,EAAE,cAAuB,EAAE,gBAAyB;QAClH,MAAM,IAAI,GAA2B;YACnC,GAAG,OAAO;YACV,WAAW,EAAE,MAAM,IAAI,CAAC,cAAc,EAAE;YACxC,UAAU,EAAE,CAAC,EAAU,EAAE,EAAU,EAAE,EAAE,CAAC,UAAU,EAAE;SACrD,CAAC;QAEF,MAAM,UAAU,GAAG,GAAG,EAAE;YACtB,IAAA,qBAAM,EAAC,SAAS,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,6BAAS,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,IAAK,GAAG,CAAC,OAAe,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kCAAc,CAAC,KAAK,CAAC,CAAC,CAAC,kCAAc,CAAC,QAAQ,CAAC;QACpG,CAAC,CAAC;QAEF,IAAI,cAAc,EAAE;YAClB,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC3D,iBAAO,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1E,OAAO,UAAU,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,IAAI,CAAC,UAAU,GAAG,IAAA,kCAAwB,EAAC,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;SAC5F;QAED,OAAO,mCAAgB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,8BAA8B,CAAC,QAAgB;QAC1D,MAAM,GAAG,GAAG,6BAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,GAAG;YACJ,GAAG,CAAC,OAAe,CAAC,KAAK,GAAG,CAAC,CAAC;QACjC,OAAO,GAAG,KAAK,SAAS,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QAChD,MAAM,mCAAgB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,uBAAU,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3F,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,QAAqB;QACpD,OAAO,mCAAgB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,SAAiB;QAC3C,OAAO,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,QAAiB;QAC/D,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,OAAO,mCAAgB,CAAC,eAAe,EAAE,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,SAAiB,EAAE,GAAW;QAC7D,OAAO,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,GAAW;QACpD,OAAO,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAmB;QACzE,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,GAAW;QACvD,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,SAAiB;QACxC,OAAO,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QAC7C,mCAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;CACF;AAYD;;;GAGG;AACH,MAAa,UAAU;IAGrB,gBAAwB,CAAC,CAAC,qCAAqC;IAO/D,0DAA0D;IACnD,MAAM,KAAK,mBAAmB;QACnC,IAAI,IAAI,CAAC,oBAAoB,KAAK,SAAS;YACzC,IAAI,CAAC,oBAAoB,GAAG,IAAA,WAAI,EAAC,uBAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED,yEAAyE;IAClE,MAAM,CAAC,oBAAoB,CAAyC,UAAa,EAAE,GAAG,IAA2C;QACtI,OAAO,iBAAO,CAAC,IAAI,CAAC,6BAAe,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,CAAC;IAGM,MAAM,KAAK,OAAO,KAAc,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,eAAe,KAAK,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrE,kDAAkD;IAC3C,MAAM,KAAK,aAAa;QAC7B,OAAO,mCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAoB;QAC9C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAC,MAAkC,EAAE,EAAE,CACpF,UAAU,CAAC,oBAAoB,CAAC,mCAAmC,EAAE,MAAM,CAAC,CAAC,CAAC;YAChF,IAAI,CAAC,gBAAgB,GAAG,GAAG,EAAE,UAAU,EAAE,eAAe,IAAI,UAAU,CAAC;SACxE;QAED,MAAM,iBAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,iBAAO,CAAC,OAAO,EAAG,yDAAyD;YAC7E,gBAAgB,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,mEAAmE;IAC5D,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,6BAA6B,CAAC,KAAK,EAAE,CAAC;QAC3C,MAAM,iBAAO,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,iDAAiD;IAC1C,MAAM,CAAC,yBAAyB;QACrC,OAAO,IAAI,CAAC,aAAa,IAAI,wCAA0B,CAAC,MAAM,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,4BAA4B,CAAC,YAA0B,EAAE,MAAkC;QACvG,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,EAAE;YACjC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;YAC5B,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACvD;IACH,CAAC;;AArEH,gCAsEC;AAjEC,qEAAqE;AAC9C,wCAA6B,GAAG,IAAI,sBAAO,EAAgD,CAAC;AAgBpG,mBAAQ,GAAG,KAAK,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 NativeApp\r\n */\r\n\r\nimport { join } from \"path\";\r\nimport { AccessToken, assert, BeEvent, GuidString } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseProps, InternetConnectivityStatus, LocalBriefcaseProps, nativeAppChannel, NativeAppFunctions, NativeAppNotifications, nativeAppNotify,\r\n  OverriddenBy, RequestNewBriefcaseProps, StorageValue,\r\n} from \"@itwin/core-common\";\r\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"./BriefcaseManager\";\r\nimport { Downloads, ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { IpcHandler, IpcHost, IpcHostOpts, throttleProgressCallback } from \"./IpcHost\";\r\nimport { NativeAppStorage } from \"./NativeAppStorage\";\r\n\r\n/**\r\n * Implementation of NativeAppFunctions\r\n */\r\nclass NativeAppHandler extends IpcHandler implements NativeAppFunctions {\r\n  public get channelName() { return nativeAppChannel; }\r\n\r\n  public async getAccessToken(): Promise<AccessToken | undefined> {\r\n    return IModelHost.authorizationClient?.getAccessToken();\r\n  }\r\n\r\n  public async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\r\n    return NativeHost.checkInternetConnectivity();\r\n  }\r\n  public async overrideInternetConnectivity(by: OverriddenBy, status: InternetConnectivityStatus): Promise<void> {\r\n    NativeHost.overrideInternetConnectivity(by, status);\r\n  }\r\n  public async acquireNewBriefcaseId(iModelId: GuidString): Promise<number> {\r\n    return BriefcaseManager.acquireNewBriefcaseId({ iModelId });\r\n  }\r\n  public async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\r\n    return BriefcaseManager.getFileName(props);\r\n  }\r\n  public async downloadBriefcase(request: RequestNewBriefcaseProps, reportProgress: boolean, progressInterval?: number): Promise<LocalBriefcaseProps> {\r\n    const args: RequestNewBriefcaseArg = {\r\n      ...request,\r\n      accessToken: await this.getAccessToken(),\r\n      onProgress: (_a: number, _b: number) => checkAbort(),\r\n    };\r\n\r\n    const checkAbort = () => {\r\n      assert(undefined !== args.fileName);\r\n      const job = Downloads.isInProgress(args.fileName);\r\n      return (job && (job.request as any).abort === 1) ? ProgressStatus.Abort : ProgressStatus.Continue;\r\n    };\r\n\r\n    if (reportProgress) {\r\n      const progressCallback: ProgressFunction = (loaded, total) => {\r\n        IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });\r\n        return checkAbort();\r\n      };\r\n      args.onProgress = throttleProgressCallback(progressCallback, checkAbort, progressInterval);\r\n    }\r\n\r\n    return BriefcaseManager.downloadBriefcase(args);\r\n  }\r\n\r\n  public async requestCancelDownloadBriefcase(fileName: string): Promise<boolean> {\r\n    const job = Downloads.isInProgress(fileName);\r\n    if (job)\r\n      (job.request as any).abort = 1;\r\n    return job !== undefined;\r\n  }\r\n\r\n  public async deleteBriefcaseFiles(fileName: string): Promise<void> {\r\n    await BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost.getAccessToken());\r\n  }\r\n\r\n  public async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\r\n    return BriefcaseManager.getCachedBriefcases(iModelId);\r\n  }\r\n\r\n  public async storageMgrOpen(storageId: string): Promise<string> {\r\n    return NativeAppStorage.open(storageId).id;\r\n  }\r\n\r\n  public async storageMgrClose(storageId: string, deleteIt: boolean): Promise<void> {\r\n    NativeAppStorage.find(storageId).close(deleteIt);\r\n  }\r\n\r\n  public async storageMgrNames(): Promise<string[]> {\r\n    return NativeAppStorage.getStorageNames();\r\n  }\r\n\r\n  public async storageGetValueType(storageId: string, key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\r\n    return NativeAppStorage.find(storageId).getValueType(key);\r\n  }\r\n\r\n  public async storageGet(storageId: string, key: string): Promise<StorageValue | undefined> {\r\n    return NativeAppStorage.find(storageId).getData(key);\r\n  }\r\n\r\n  public async storageSet(storageId: string, key: string, value: StorageValue): Promise<void> {\r\n    NativeAppStorage.find(storageId).setData(key, value);\r\n  }\r\n\r\n  public async storageRemove(storageId: string, key: string): Promise<void> {\r\n    NativeAppStorage.find(storageId).removeData(key);\r\n  }\r\n\r\n  public async storageKeys(storageId: string): Promise<string[]> {\r\n    return NativeAppStorage.find(storageId).getKeys();\r\n  }\r\n\r\n  public async storageRemoveAll(storageId: string): Promise<void> {\r\n    NativeAppStorage.find(storageId).removeAll();\r\n  }\r\n}\r\n\r\n/** Options for [[NativeHost.startup]]\r\n * @public\r\n */\r\nexport interface NativeHostOpts extends IpcHostOpts {\r\n  nativeHost?: {\r\n    /** Application name. Used, for example, to name the settings file. If not supplied, defaults to \"iTwinApp\". */\r\n    applicationName?: string;\r\n  };\r\n}\r\n\r\n/**\r\n * Backend for desktop/mobile native applications\r\n * @public\r\n */\r\nexport class NativeHost {\r\n  private static _reachability?: InternetConnectivityStatus;\r\n  private static _applicationName: string;\r\n  private constructor() { } // no instances - static methods only\r\n\r\n  /** Event called when the internet connectivity changes, if known. */\r\n  public static readonly onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\r\n\r\n  private static _appSettingsCacheDir?: string;\r\n\r\n  /** Get the local cache folder for application settings */\r\n  public static get appSettingsCacheDir(): string {\r\n    if (this._appSettingsCacheDir === undefined)\r\n      this._appSettingsCacheDir = join(IModelHost.cacheDir, \"appSettings\");\r\n    return this._appSettingsCacheDir;\r\n  }\r\n\r\n  /** Send a notification to the NativeApp connected to this NativeHost. */\r\n  public static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>) {\r\n    return IpcHost.send(nativeAppNotify, methodName, ...args);\r\n  }\r\n\r\n  private static _isValid = false;\r\n  public static get isValid(): boolean { return this._isValid; }\r\n  public static get applicationName() { return this._applicationName; }\r\n  /** Get the settings store for this NativeHost. */\r\n  public static get settingsStore() {\r\n    return NativeAppStorage.open(this.applicationName);\r\n  }\r\n\r\n  /**\r\n   * Start the backend of a native app.\r\n   * @note this method calls [[IpcHost.startup]] internally.\r\n   */\r\n  public static async startup(opt?: NativeHostOpts): Promise<void> {\r\n    if (!this.isValid) {\r\n      this._isValid = true;\r\n      this.onInternetConnectivityChanged.addListener((status: InternetConnectivityStatus) =>\r\n        NativeHost.notifyNativeFrontend(\"notifyInternetConnectivityChanged\", status));\r\n      this._applicationName = opt?.nativeHost?.applicationName ?? \"iTwinApp\";\r\n    }\r\n\r\n    await IpcHost.startup(opt);\r\n    if (IpcHost.isValid)  // for tests, we use NativeHost but don't have a frontend\r\n      NativeAppHandler.register();\r\n  }\r\n\r\n  /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    this._isValid = false;\r\n    this.onInternetConnectivityChanged.clear();\r\n    await IpcHost.shutdown();\r\n  }\r\n\r\n  /** get current value of internet connectivity */\r\n  public static checkInternetConnectivity(): InternetConnectivityStatus {\r\n    return this._reachability ?? InternetConnectivityStatus.Online;\r\n  }\r\n\r\n  /**\r\n   * Override internet connectivity state\r\n   * @param _overridenBy who overrode the value.\r\n   * @internal\r\n   */\r\n  public static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void {\r\n    if (this._reachability !== status) {\r\n      this._reachability = status;\r\n      this.onInternetConnectivityChanged.raiseEvent(status);\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NativeHost.js","sourceRoot":"","sources":["../../src/NativeHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module NativeApp\n */\n\nimport { join } from \"path\";\nimport { AccessToken, assert, BeEvent, GuidString } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, InternetConnectivityStatus, LocalBriefcaseProps, nativeAppChannel, NativeAppFunctions, NativeAppNotifications, nativeAppNotify,\n  OverriddenBy, RequestNewBriefcaseProps, StorageValue,\n} from \"@itwin/core-common\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"./BriefcaseManager\";\nimport { Downloads, ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\nimport { IModelHost } from \"./IModelHost\";\nimport { IpcHandler, IpcHost, IpcHostOpts, throttleProgressCallback } from \"./IpcHost\";\nimport { NativeAppStorage } from \"./NativeAppStorage\";\n\n/**\n * Implementation of NativeAppFunctions\n */\nclass NativeAppHandler extends IpcHandler implements NativeAppFunctions {\n  public get channelName() { return nativeAppChannel; }\n\n  public async getAccessToken(): Promise<AccessToken | undefined> {\n    return IModelHost.authorizationClient?.getAccessToken();\n  }\n\n  public async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\n    return NativeHost.checkInternetConnectivity();\n  }\n  public async overrideInternetConnectivity(by: OverriddenBy, status: InternetConnectivityStatus): Promise<void> {\n    NativeHost.overrideInternetConnectivity(by, status);\n  }\n  public async acquireNewBriefcaseId(iModelId: GuidString): Promise<number> {\n    return BriefcaseManager.acquireNewBriefcaseId({ iModelId });\n  }\n  public async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\n    return BriefcaseManager.getFileName(props);\n  }\n  public async downloadBriefcase(request: RequestNewBriefcaseProps, reportProgress: boolean, progressInterval?: number): Promise<LocalBriefcaseProps> {\n    const args: RequestNewBriefcaseArg = {\n      ...request,\n      accessToken: await this.getAccessToken(),\n      onProgress: (_a: number, _b: number) => checkAbort(),\n    };\n\n    const checkAbort = () => {\n      assert(undefined !== args.fileName);\n      const job = Downloads.isInProgress(args.fileName);\n      return (job && (job.request as any).abort === 1) ? ProgressStatus.Abort : ProgressStatus.Continue;\n    };\n\n    if (reportProgress) {\n      const progressCallback: ProgressFunction = (loaded, total) => {\n        IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });\n        return checkAbort();\n      };\n      args.onProgress = throttleProgressCallback(progressCallback, checkAbort, progressInterval);\n    }\n\n    return BriefcaseManager.downloadBriefcase(args);\n  }\n\n  public async requestCancelDownloadBriefcase(fileName: string): Promise<boolean> {\n    const job = Downloads.isInProgress(fileName);\n    if (job)\n      (job.request as any).abort = 1;\n    return job !== undefined;\n  }\n\n  public async deleteBriefcaseFiles(fileName: string): Promise<void> {\n    await BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost.getAccessToken());\n  }\n\n  public async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\n    return BriefcaseManager.getCachedBriefcases(iModelId);\n  }\n\n  public async storageMgrOpen(storageId: string): Promise<string> {\n    return NativeAppStorage.open(storageId).id;\n  }\n\n  public async storageMgrClose(storageId: string, deleteIt: boolean): Promise<void> {\n    NativeAppStorage.find(storageId).close(deleteIt);\n  }\n\n  public async storageMgrNames(): Promise<string[]> {\n    return NativeAppStorage.getStorageNames();\n  }\n\n  public async storageGetValueType(storageId: string, key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\n    return NativeAppStorage.find(storageId).getValueType(key);\n  }\n\n  public async storageGet(storageId: string, key: string): Promise<StorageValue | undefined> {\n    return NativeAppStorage.find(storageId).getData(key);\n  }\n\n  public async storageSet(storageId: string, key: string, value: StorageValue): Promise<void> {\n    NativeAppStorage.find(storageId).setData(key, value);\n  }\n\n  public async storageRemove(storageId: string, key: string): Promise<void> {\n    NativeAppStorage.find(storageId).removeData(key);\n  }\n\n  public async storageKeys(storageId: string): Promise<string[]> {\n    return NativeAppStorage.find(storageId).getKeys();\n  }\n\n  public async storageRemoveAll(storageId: string): Promise<void> {\n    NativeAppStorage.find(storageId).removeAll();\n  }\n}\n\n/** Options for [[NativeHost.startup]]\n * @public\n */\nexport interface NativeHostOpts extends IpcHostOpts {\n  nativeHost?: {\n    /** Application name. Used, for example, to name the settings file. If not supplied, defaults to \"iTwinApp\". */\n    applicationName?: string;\n  };\n}\n\n/**\n * Backend for desktop/mobile native applications\n * @public\n */\nexport class NativeHost {\n  private static _reachability?: InternetConnectivityStatus;\n  private static _applicationName: string;\n  private constructor() { } // no instances - static methods only\n\n  /** Event called when the internet connectivity changes, if known. */\n  public static readonly onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\n\n  private static _appSettingsCacheDir?: string;\n\n  /** Get the local cache folder for application settings */\n  public static get appSettingsCacheDir(): string {\n    if (this._appSettingsCacheDir === undefined)\n      this._appSettingsCacheDir = join(IModelHost.cacheDir, \"appSettings\");\n    return this._appSettingsCacheDir;\n  }\n\n  /** Send a notification to the NativeApp connected to this NativeHost. */\n  public static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>) {\n    return IpcHost.send(nativeAppNotify, methodName, ...args);\n  }\n\n  private static _isValid = false;\n  public static get isValid(): boolean { return this._isValid; }\n  public static get applicationName() { return this._applicationName; }\n  /** Get the settings store for this NativeHost. */\n  public static get settingsStore() {\n    return NativeAppStorage.open(this.applicationName);\n  }\n\n  /**\n   * Start the backend of a native app.\n   * @note this method calls [[IpcHost.startup]] internally.\n   */\n  public static async startup(opt?: NativeHostOpts): Promise<void> {\n    if (!this.isValid) {\n      this._isValid = true;\n      this.onInternetConnectivityChanged.addListener((status: InternetConnectivityStatus) =>\n        NativeHost.notifyNativeFrontend(\"notifyInternetConnectivityChanged\", status));\n      this._applicationName = opt?.nativeHost?.applicationName ?? \"iTwinApp\";\n    }\n\n    await IpcHost.startup(opt);\n    if (IpcHost.isValid)  // for tests, we use NativeHost but don't have a frontend\n      NativeAppHandler.register();\n  }\n\n  /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */\n  public static async shutdown(): Promise<void> {\n    this._isValid = false;\n    this.onInternetConnectivityChanged.clear();\n    await IpcHost.shutdown();\n  }\n\n  /** get current value of internet connectivity */\n  public static checkInternetConnectivity(): InternetConnectivityStatus {\n    return this._reachability ?? InternetConnectivityStatus.Online;\n  }\n\n  /**\n   * Override internet connectivity state\n   * @param _overridenBy who overrode the value.\n   * @internal\n   */\n  public static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void {\n    if (this._reachability !== status) {\n      this._reachability = status;\n      this.onInternetConnectivityChanged.raiseEvent(status);\n    }\n  }\n}\n"]}