@itwin/core-backend 3.7.0 → 3.7.2

package/lib/cjs/NativeAppStorage.js

@@ -1,203 +1,203 @@
-"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.NativeAppStorage = void 0;
-const path_1 = require("path");
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const ECDb_1 = require("./ECDb");
-const IModelHost_1 = require("./IModelHost");
-const IModelJsFs_1 = require("./IModelJsFs");
-const NativeHost_1 = require("./NativeHost");
-// cspell:ignore ecdb
-/**
- * A local file stored in the [[NativeHost.appSettingsCacheDir]] for storing key/value pairs.
- * @public
- */
-class NativeAppStorage {
-    constructor(_ecdb, id) {
-        this._ecdb = _ecdb;
-        this.id = id;
-    }
-    /** Set the value for a key */
-    setData(key, value) {
-        const rc = this._ecdb.withPreparedSqliteStatement("INSERT INTO app_setting(key,type,val)VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET type=excluded.type,val=excluded.val", (stmt) => {
-            let valType = (value === undefined || value === null) ? "null" : typeof value;
-            if (valType === "object" && (value instanceof Uint8Array))
-                valType = "Uint8Array";
-            switch (valType) {
-                case "null":
-                case "number":
-                case "string":
-                case "boolean":
-                case "Uint8Array":
-                    break;
-                default:
-                    throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, `Unsupported type ${valType} for value for key='${key}`);
-            }
-            stmt.bindValue(1, key);
-            stmt.bindValue(2, valType);
-            stmt.bindValue(3, value);
-            return stmt.step();
-        });
-        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
-            throw new core_common_1.IModelError(rc, "SQLite error");
-        this._ecdb.saveChanges();
-    }
-    /** Get the value for a key from this Storage. If key is not present or is null, return undefined. */
-    getData(key) {
-        return this._ecdb.withPreparedSqliteStatement("SELECT type,val FROM app_setting WHERE key=?", (stmt) => {
-            stmt.bindValue(1, key);
-            if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
-                return undefined;
-            const valType = stmt.getValueString(0);
-            switch (valType) {
-                case "number":
-                    return stmt.getValueDouble(1);
-                case "string":
-                    return stmt.getValueString(1);
-                case "boolean":
-                    return Boolean(stmt.getValueInteger(1));
-                case "Uint8Array":
-                    return stmt.getValueBlob(1);
-                case "null":
-                    return undefined;
-            }
-            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, `Unsupported type in cache ${valType}`);
-        });
-    }
-    /** return the type of the value for a key, or undefined if not present. */
-    getValueType(key) {
-        return this._ecdb.withSqliteStatement("SELECT type FROM app_setting WHERE key=?", (stmt) => {
-            stmt.bindValue(1, key);
-            return stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW ? stmt.getValueString(0) : undefined;
-        });
-    }
-    /** return `true` if the key is present, but has a null value. */
-    hasNullValue(key) {
-        return this.getValueType(key) === "null";
-    }
-    /** Get the value for a key as a string. If it is not present, or not of type string, return undefined */
-    getString(key) {
-        const val = this.getData(key);
-        return typeof val === "string" ? val : undefined;
-    }
-    /** Get the value for a key as a number. If it is not present, or not of type number, return undefined */
-    getNumber(key) {
-        const val = this.getData(key);
-        return typeof val === "number" ? val : undefined;
-    }
-    /** Get the value for a key as a boolean. If it is not present, or not of type boolean, return undefined */
-    getBoolean(key) {
-        const val = this.getData(key);
-        return typeof val === "boolean" ? val : undefined;
-    }
-    /** Get the value for a key as a Uint8Array. If it is not present, or not of type Uint8Array, return undefined */
-    getUint8Array(key) {
-        const val = this.getData(key);
-        return val instanceof Uint8Array ? val : undefined;
-    }
-    /** Get all key names in this Storage */
-    getKeys() {
-        const keys = new Array();
-        this._ecdb.withPreparedSqliteStatement("SELECT key FROM app_setting", (stmt) => {
-            while (core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step()) {
-                keys.push(stmt.getValueString(0));
-            }
-        });
-        return keys;
-    }
-    /** Remove a key/value pair from this Storage */
-    removeData(key) {
-        const rc = this._ecdb.withPreparedSqliteStatement("DELETE FROM app_setting WHERE key=?", (stmt) => {
-            stmt.bindValue(1, key);
-            return stmt.step();
-        });
-        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE) {
-            throw new core_common_1.IModelError(rc, "SQLite error");
-        }
-    }
-    /** Remove all key/value pairs */
-    removeAll() {
-        const rc = this._ecdb.withPreparedSqliteStatement("DELETE FROM app_setting", (stmt) => {
-            return stmt.step();
-        });
-        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE) {
-            throw new core_common_1.IModelError(rc, "SQLite error");
-        }
-    }
-    /** Close this Storage. */
-    close(deleteFile = false) {
-        const storageFile = (0, path_1.join)(NativeHost_1.NativeHost.appSettingsCacheDir, this.id);
-        this._ecdb.saveChanges();
-        this._ecdb.closeDb();
-        this._ecdb = undefined;
-        if (deleteFile)
-            IModelJsFs_1.IModelJsFs.removeSync(storageFile);
-        NativeAppStorage._storages.delete(this.id);
-    }
-    static init(ecdb) {
-        return ecdb.withPreparedSqliteStatement("CREATE TABLE app_setting(key PRIMARY KEY,type,val);", (stmt) => {
-            return stmt.step();
-        });
-    }
-    /** find and open storage by its name. */
-    static find(name) {
-        const storage = this._storages.get(name);
-        if (undefined === storage)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FileNotFound, `Storage ${name} not open`);
-        return storage;
-    }
-    /** Close all opened Storages.
-     * @internal
-     */
-    static closeAll() {
-        this._storages.forEach((value) => value.close());
-        this._storages.clear();
-    }
-    /** @internal */
-    static getStorageNames() {
-        return IModelJsFs_1.IModelJsFs.readdirSync(NativeHost_1.NativeHost.appSettingsCacheDir).filter((name) => name.endsWith(this._ext));
-    }
-    /** Open or find a Storage by name. */
-    static open(name) {
-        if (!this._init) {
-            IModelHost_1.IModelHost.onBeforeShutdown.addOnce(() => this.closeAll());
-            this._init = true;
-        }
-        const fileName = name + this._ext;
-        if (!IModelJsFs_1.IModelJsFs.existsSync(NativeHost_1.NativeHost.appSettingsCacheDir))
-            IModelJsFs_1.IModelJsFs.recursiveMkDirSync(NativeHost_1.NativeHost.appSettingsCacheDir);
-        const storageFile = (0, path_1.join)(NativeHost_1.NativeHost.appSettingsCacheDir, fileName);
-        try {
-            return this.find(fileName); // see if it's already open
-        }
-        catch (err) {
-            const ecdb = new ECDb_1.ECDb();
-            if (IModelJsFs_1.IModelJsFs.existsSync(storageFile)) {
-                ecdb.openDb(storageFile, ECDb_1.ECDbOpenMode.ReadWrite);
-            }
-            else {
-                ecdb.createDb(storageFile);
-                const rc = this.init(ecdb);
-                if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
-                    throw new core_common_1.IModelError(rc, "SQLite error");
-                ecdb.saveChanges();
-            }
-            const storage = new NativeAppStorage(ecdb, fileName);
-            this._storages.set(fileName, storage);
-            return storage;
-        }
-    }
-}
-exports.NativeAppStorage = NativeAppStorage;
-NativeAppStorage._ext = ".settings-db";
-NativeAppStorage._storages = new Map();
-NativeAppStorage._init = 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.NativeAppStorage = void 0;
+const path_1 = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const ECDb_1 = require("./ECDb");
+const IModelHost_1 = require("./IModelHost");
+const IModelJsFs_1 = require("./IModelJsFs");
+const NativeHost_1 = require("./NativeHost");
+// cspell:ignore ecdb
+/**
+ * A local file stored in the [[NativeHost.appSettingsCacheDir]] for storing key/value pairs.
+ * @public
+ */
+class NativeAppStorage {
+    constructor(_ecdb, id) {
+        this._ecdb = _ecdb;
+        this.id = id;
+    }
+    /** Set the value for a key */
+    setData(key, value) {
+        const rc = this._ecdb.withPreparedSqliteStatement("INSERT INTO app_setting(key,type,val)VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET type=excluded.type,val=excluded.val", (stmt) => {
+            let valType = (value === undefined || value === null) ? "null" : typeof value;
+            if (valType === "object" && (value instanceof Uint8Array))
+                valType = "Uint8Array";
+            switch (valType) {
+                case "null":
+                case "number":
+                case "string":
+                case "boolean":
+                case "Uint8Array":
+                    break;
+                default:
+                    throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, `Unsupported type ${valType} for value for key='${key}`);
+            }
+            stmt.bindValue(1, key);
+            stmt.bindValue(2, valType);
+            stmt.bindValue(3, value);
+            return stmt.step();
+        });
+        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
+            throw new core_common_1.IModelError(rc, "SQLite error");
+        this._ecdb.saveChanges();
+    }
+    /** Get the value for a key from this Storage. If key is not present or is null, return undefined. */
+    getData(key) {
+        return this._ecdb.withPreparedSqliteStatement("SELECT type,val FROM app_setting WHERE key=?", (stmt) => {
+            stmt.bindValue(1, key);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+                return undefined;
+            const valType = stmt.getValueString(0);
+            switch (valType) {
+                case "number":
+                    return stmt.getValueDouble(1);
+                case "string":
+                    return stmt.getValueString(1);
+                case "boolean":
+                    return Boolean(stmt.getValueInteger(1));
+                case "Uint8Array":
+                    return stmt.getValueBlob(1);
+                case "null":
+                    return undefined;
+            }
+            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, `Unsupported type in cache ${valType}`);
+        });
+    }
+    /** return the type of the value for a key, or undefined if not present. */
+    getValueType(key) {
+        return this._ecdb.withSqliteStatement("SELECT type FROM app_setting WHERE key=?", (stmt) => {
+            stmt.bindValue(1, key);
+            return stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW ? stmt.getValueString(0) : undefined;
+        });
+    }
+    /** return `true` if the key is present, but has a null value. */
+    hasNullValue(key) {
+        return this.getValueType(key) === "null";
+    }
+    /** Get the value for a key as a string. If it is not present, or not of type string, return undefined */
+    getString(key) {
+        const val = this.getData(key);
+        return typeof val === "string" ? val : undefined;
+    }
+    /** Get the value for a key as a number. If it is not present, or not of type number, return undefined */
+    getNumber(key) {
+        const val = this.getData(key);
+        return typeof val === "number" ? val : undefined;
+    }
+    /** Get the value for a key as a boolean. If it is not present, or not of type boolean, return undefined */
+    getBoolean(key) {
+        const val = this.getData(key);
+        return typeof val === "boolean" ? val : undefined;
+    }
+    /** Get the value for a key as a Uint8Array. If it is not present, or not of type Uint8Array, return undefined */
+    getUint8Array(key) {
+        const val = this.getData(key);
+        return val instanceof Uint8Array ? val : undefined;
+    }
+    /** Get all key names in this Storage */
+    getKeys() {
+        const keys = new Array();
+        this._ecdb.withPreparedSqliteStatement("SELECT key FROM app_setting", (stmt) => {
+            while (core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step()) {
+                keys.push(stmt.getValueString(0));
+            }
+        });
+        return keys;
+    }
+    /** Remove a key/value pair from this Storage */
+    removeData(key) {
+        const rc = this._ecdb.withPreparedSqliteStatement("DELETE FROM app_setting WHERE key=?", (stmt) => {
+            stmt.bindValue(1, key);
+            return stmt.step();
+        });
+        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE) {
+            throw new core_common_1.IModelError(rc, "SQLite error");
+        }
+    }
+    /** Remove all key/value pairs */
+    removeAll() {
+        const rc = this._ecdb.withPreparedSqliteStatement("DELETE FROM app_setting", (stmt) => {
+            return stmt.step();
+        });
+        if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE) {
+            throw new core_common_1.IModelError(rc, "SQLite error");
+        }
+    }
+    /** Close this Storage. */
+    close(deleteFile = false) {
+        const storageFile = (0, path_1.join)(NativeHost_1.NativeHost.appSettingsCacheDir, this.id);
+        this._ecdb.saveChanges();
+        this._ecdb.closeDb();
+        this._ecdb = undefined;
+        if (deleteFile)
+            IModelJsFs_1.IModelJsFs.removeSync(storageFile);
+        NativeAppStorage._storages.delete(this.id);
+    }
+    static init(ecdb) {
+        return ecdb.withPreparedSqliteStatement("CREATE TABLE app_setting(key PRIMARY KEY,type,val);", (stmt) => {
+            return stmt.step();
+        });
+    }
+    /** find and open storage by its name. */
+    static find(name) {
+        const storage = this._storages.get(name);
+        if (undefined === storage)
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FileNotFound, `Storage ${name} not open`);
+        return storage;
+    }
+    /** Close all opened Storages.
+     * @internal
+     */
+    static closeAll() {
+        this._storages.forEach((value) => value.close());
+        this._storages.clear();
+    }
+    /** @internal */
+    static getStorageNames() {
+        return IModelJsFs_1.IModelJsFs.readdirSync(NativeHost_1.NativeHost.appSettingsCacheDir).filter((name) => name.endsWith(this._ext));
+    }
+    /** Open or find a Storage by name. */
+    static open(name) {
+        if (!this._init) {
+            IModelHost_1.IModelHost.onBeforeShutdown.addOnce(() => this.closeAll());
+            this._init = true;
+        }
+        const fileName = name + this._ext;
+        if (!IModelJsFs_1.IModelJsFs.existsSync(NativeHost_1.NativeHost.appSettingsCacheDir))
+            IModelJsFs_1.IModelJsFs.recursiveMkDirSync(NativeHost_1.NativeHost.appSettingsCacheDir);
+        const storageFile = (0, path_1.join)(NativeHost_1.NativeHost.appSettingsCacheDir, fileName);
+        try {
+            return this.find(fileName); // see if it's already open
+        }
+        catch (err) {
+            const ecdb = new ECDb_1.ECDb();
+            if (IModelJsFs_1.IModelJsFs.existsSync(storageFile)) {
+                ecdb.openDb(storageFile, ECDb_1.ECDbOpenMode.ReadWrite);
+            }
+            else {
+                ecdb.createDb(storageFile);
+                const rc = this.init(ecdb);
+                if (rc !== core_bentley_1.DbResult.BE_SQLITE_DONE)
+                    throw new core_common_1.IModelError(rc, "SQLite error");
+                ecdb.saveChanges();
+            }
+            const storage = new NativeAppStorage(ecdb, fileName);
+            this._storages.set(fileName, storage);
+            return storage;
+        }
+    }
+}
+exports.NativeAppStorage = NativeAppStorage;
+NativeAppStorage._ext = ".settings-db";
+NativeAppStorage._storages = new Map();
+NativeAppStorage._init = false;
 //# sourceMappingURL=NativeAppStorage.js.map

package/lib/cjs/NativeAppStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAppStorage.js","sourceRoot":"","sources":["../../src/NativeAppStorage.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 { DbResult, IModelStatus } from \"@itwin/core-bentley\";\nimport { IModelError, StorageValue } from \"@itwin/core-common\";\nimport { ECDb, ECDbOpenMode } from \"./ECDb\";\nimport { IModelHost } from \"./IModelHost\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { NativeHost } from \"./NativeHost\";\n\n// cspell:ignore ecdb\n\n/**\n * A local file stored in the [[NativeHost.appSettingsCacheDir]] for storing key/value pairs.\n * @public\n */\nexport class NativeAppStorage {\n  private static readonly _ext = \".settings-db\";\n  private static _storages = new Map<string, NativeAppStorage>();\n  private static _init: boolean = false;\n  private constructor(private _ecdb: ECDb, public readonly id: string) { }\n\n  /** Set the value for a key */\n  public setData(key: string, value: StorageValue): void {\n    const rc = this._ecdb.withPreparedSqliteStatement(\"INSERT INTO app_setting(key,type,val)VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET type=excluded.type,val=excluded.val\", (stmt) => {\n      let valType = (value === undefined || value === null) ? \"null\" : typeof value;\n      if (valType === \"object\" && (value instanceof Uint8Array))\n        valType = \"Uint8Array\";\n\n      switch (valType) {\n        case \"null\":\n        case \"number\":\n        case \"string\":\n        case \"boolean\":\n        case \"Uint8Array\":\n          break;\n        default:\n          throw new IModelError(DbResult.BE_SQLITE_ERROR, `Unsupported type ${valType} for value for key='${key}`);\n      }\n\n      stmt.bindValue(1, key);\n      stmt.bindValue(2, valType);\n      stmt.bindValue(3, value);\n      return stmt.step();\n    });\n    if (rc !== DbResult.BE_SQLITE_DONE)\n      throw new IModelError(rc, \"SQLite error\");\n\n    this._ecdb.saveChanges();\n  }\n\n  /** Get the value for a key from this Storage. If key is not present or is null, return undefined. */\n  public getData(key: string): StorageValue {\n    return this._ecdb.withPreparedSqliteStatement(\"SELECT type,val FROM app_setting WHERE key=?\", (stmt) => {\n      stmt.bindValue(1, key);\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\n        return undefined;\n      const valType = stmt.getValueString(0);\n      switch (valType) {\n        case \"number\":\n          return stmt.getValueDouble(1);\n        case \"string\":\n          return stmt.getValueString(1);\n        case \"boolean\":\n          return Boolean(stmt.getValueInteger(1));\n        case \"Uint8Array\":\n          return stmt.getValueBlob(1);\n        case \"null\":\n          return undefined;\n      }\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Unsupported type in cache ${valType}`);\n    });\n  }\n\n  /** return the type of the value for a key, or undefined if not present. */\n  public getValueType(key: string): \"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined {\n    return this._ecdb.withSqliteStatement(\"SELECT type FROM app_setting WHERE key=?\", (stmt) => {\n      stmt.bindValue(1, key);\n      return stmt.step() === DbResult.BE_SQLITE_ROW ? stmt.getValueString(0) as any : undefined;\n    });\n  }\n\n  /** return `true` if the key is present, but has a null value. */\n  public hasNullValue(key: string): boolean {\n    return this.getValueType(key) === \"null\";\n  }\n\n  /** Get the value for a key as a string. If it is not present, or not of type string, return undefined */\n  public getString(key: string): string | undefined {\n    const val = this.getData(key);\n    return typeof val === \"string\" ? val : undefined;\n  }\n\n  /** Get the value for a key as a number. If it is not present, or not of type number, return undefined */\n  public getNumber(key: string): number | undefined {\n    const val = this.getData(key);\n    return typeof val === \"number\" ? val : undefined;\n  }\n\n  /** Get the value for a key as a boolean. If it is not present, or not of type boolean, return undefined */\n  public getBoolean(key: string): boolean | undefined {\n    const val = this.getData(key);\n    return typeof val === \"boolean\" ? val : undefined;\n  }\n\n  /** Get the value for a key as a Uint8Array. If it is not present, or not of type Uint8Array, return undefined */\n  public getUint8Array(key: string): Uint8Array | undefined {\n    const val = this.getData(key);\n    return val instanceof Uint8Array ? val : undefined;\n  }\n\n  /** Get all key names in this Storage */\n  public getKeys(): string[] {\n    const keys = new Array<string>();\n    this._ecdb.withPreparedSqliteStatement(\"SELECT key FROM app_setting\", (stmt) => {\n      while (DbResult.BE_SQLITE_ROW === stmt.step()) {\n        keys.push(stmt.getValueString(0));\n      }\n    });\n    return keys;\n  }\n\n  /** Remove a key/value pair from this Storage */\n  public removeData(key: string) {\n    const rc = this._ecdb.withPreparedSqliteStatement(\"DELETE FROM app_setting WHERE key=?\", (stmt) => {\n      stmt.bindValue(1, key);\n      return stmt.step();\n    });\n    if (rc !== DbResult.BE_SQLITE_DONE) {\n      throw new IModelError(rc, \"SQLite error\");\n    }\n  }\n\n  /** Remove all key/value pairs */\n  public removeAll() {\n    const rc = this._ecdb.withPreparedSqliteStatement(\"DELETE FROM app_setting\", (stmt) => {\n      return stmt.step();\n    });\n    if (rc !== DbResult.BE_SQLITE_DONE) {\n      throw new IModelError(rc, \"SQLite error\");\n    }\n  }\n\n  /** Close this Storage. */\n  public close(deleteFile: boolean = false) {\n    const storageFile = join(NativeHost.appSettingsCacheDir, this.id);\n    this._ecdb.saveChanges();\n    this._ecdb.closeDb();\n    (this._ecdb as any) = undefined;\n    if (deleteFile)\n      IModelJsFs.removeSync(storageFile);\n    NativeAppStorage._storages.delete(this.id);\n  }\n\n  private static init(ecdb: ECDb): DbResult {\n    return ecdb.withPreparedSqliteStatement(\"CREATE TABLE app_setting(key PRIMARY KEY,type,val);\", (stmt) => {\n      return stmt.step();\n    });\n  }\n\n  /** find and open storage by its name. */\n  public static find(name: string): NativeAppStorage {\n    const storage = this._storages.get(name);\n    if (undefined === storage)\n      throw new IModelError(IModelStatus.FileNotFound, `Storage ${name} not open`);\n    return storage;\n  }\n\n  /** Close all opened Storages.\n   * @internal\n   */\n  public static closeAll() {\n    this._storages.forEach((value) => value.close());\n    this._storages.clear();\n  }\n\n  /** @internal */\n  public static getStorageNames(): string[] {\n    return IModelJsFs.readdirSync(NativeHost.appSettingsCacheDir).filter((name) => name.endsWith(this._ext));\n  }\n\n  /** Open or find a Storage by name. */\n  public static open(name: string): NativeAppStorage {\n    if (!this._init) {\n      IModelHost.onBeforeShutdown.addOnce(() => this.closeAll());\n      this._init = true;\n    }\n    const fileName = name + this._ext;\n    if (!IModelJsFs.existsSync(NativeHost.appSettingsCacheDir))\n      IModelJsFs.recursiveMkDirSync(NativeHost.appSettingsCacheDir);\n\n    const storageFile = join(NativeHost.appSettingsCacheDir, fileName);\n    try {\n      return this.find(fileName); // see if it's already open\n    } catch (err) {\n      const ecdb = new ECDb();\n      if (IModelJsFs.existsSync(storageFile)) {\n        ecdb.openDb(storageFile, ECDbOpenMode.ReadWrite);\n      } else {\n        ecdb.createDb(storageFile);\n        const rc = this.init(ecdb);\n        if (rc !== DbResult.BE_SQLITE_DONE)\n          throw new IModelError(rc, \"SQLite error\");\n        ecdb.saveChanges();\n      }\n      const storage = new NativeAppStorage(ecdb, fileName);\n      this._storages.set(fileName, storage);\n      return storage;\n    }\n  }\n}\n"]}
+{"version":3,"file":"NativeAppStorage.js","sourceRoot":"","sources":["../../src/NativeAppStorage.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/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { join } from \"path\";\r\nimport { DbResult, IModelStatus } from \"@itwin/core-bentley\";\r\nimport { IModelError, StorageValue } from \"@itwin/core-common\";\r\nimport { ECDb, ECDbOpenMode } from \"./ECDb\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\nimport { NativeHost } from \"./NativeHost\";\r\n\r\n// cspell:ignore ecdb\r\n\r\n/**\r\n * A local file stored in the [[NativeHost.appSettingsCacheDir]] for storing key/value pairs.\r\n * @public\r\n */\r\nexport class NativeAppStorage {\r\n  private static readonly _ext = \".settings-db\";\r\n  private static _storages = new Map<string, NativeAppStorage>();\r\n  private static _init: boolean = false;\r\n  private constructor(private _ecdb: ECDb, public readonly id: string) { }\r\n\r\n  /** Set the value for a key */\r\n  public setData(key: string, value: StorageValue): void {\r\n    const rc = this._ecdb.withPreparedSqliteStatement(\"INSERT INTO app_setting(key,type,val)VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET type=excluded.type,val=excluded.val\", (stmt) => {\r\n      let valType = (value === undefined || value === null) ? \"null\" : typeof value;\r\n      if (valType === \"object\" && (value instanceof Uint8Array))\r\n        valType = \"Uint8Array\";\r\n\r\n      switch (valType) {\r\n        case \"null\":\r\n        case \"number\":\r\n        case \"string\":\r\n        case \"boolean\":\r\n        case \"Uint8Array\":\r\n          break;\r\n        default:\r\n          throw new IModelError(DbResult.BE_SQLITE_ERROR, `Unsupported type ${valType} for value for key='${key}`);\r\n      }\r\n\r\n      stmt.bindValue(1, key);\r\n      stmt.bindValue(2, valType);\r\n      stmt.bindValue(3, value);\r\n      return stmt.step();\r\n    });\r\n    if (rc !== DbResult.BE_SQLITE_DONE)\r\n      throw new IModelError(rc, \"SQLite error\");\r\n\r\n    this._ecdb.saveChanges();\r\n  }\r\n\r\n  /** Get the value for a key from this Storage. If key is not present or is null, return undefined. */\r\n  public getData(key: string): StorageValue {\r\n    return this._ecdb.withPreparedSqliteStatement(\"SELECT type,val FROM app_setting WHERE key=?\", (stmt) => {\r\n      stmt.bindValue(1, key);\r\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\r\n        return undefined;\r\n      const valType = stmt.getValueString(0);\r\n      switch (valType) {\r\n        case \"number\":\r\n          return stmt.getValueDouble(1);\r\n        case \"string\":\r\n          return stmt.getValueString(1);\r\n        case \"boolean\":\r\n          return Boolean(stmt.getValueInteger(1));\r\n        case \"Uint8Array\":\r\n          return stmt.getValueBlob(1);\r\n        case \"null\":\r\n          return undefined;\r\n      }\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Unsupported type in cache ${valType}`);\r\n    });\r\n  }\r\n\r\n  /** return the type of the value for a key, or undefined if not present. */\r\n  public getValueType(key: string): \"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined {\r\n    return this._ecdb.withSqliteStatement(\"SELECT type FROM app_setting WHERE key=?\", (stmt) => {\r\n      stmt.bindValue(1, key);\r\n      return stmt.step() === DbResult.BE_SQLITE_ROW ? stmt.getValueString(0) as any : undefined;\r\n    });\r\n  }\r\n\r\n  /** return `true` if the key is present, but has a null value. */\r\n  public hasNullValue(key: string): boolean {\r\n    return this.getValueType(key) === \"null\";\r\n  }\r\n\r\n  /** Get the value for a key as a string. If it is not present, or not of type string, return undefined */\r\n  public getString(key: string): string | undefined {\r\n    const val = this.getData(key);\r\n    return typeof val === \"string\" ? val : undefined;\r\n  }\r\n\r\n  /** Get the value for a key as a number. If it is not present, or not of type number, return undefined */\r\n  public getNumber(key: string): number | undefined {\r\n    const val = this.getData(key);\r\n    return typeof val === \"number\" ? val : undefined;\r\n  }\r\n\r\n  /** Get the value for a key as a boolean. If it is not present, or not of type boolean, return undefined */\r\n  public getBoolean(key: string): boolean | undefined {\r\n    const val = this.getData(key);\r\n    return typeof val === \"boolean\" ? val : undefined;\r\n  }\r\n\r\n  /** Get the value for a key as a Uint8Array. If it is not present, or not of type Uint8Array, return undefined */\r\n  public getUint8Array(key: string): Uint8Array | undefined {\r\n    const val = this.getData(key);\r\n    return val instanceof Uint8Array ? val : undefined;\r\n  }\r\n\r\n  /** Get all key names in this Storage */\r\n  public getKeys(): string[] {\r\n    const keys = new Array<string>();\r\n    this._ecdb.withPreparedSqliteStatement(\"SELECT key FROM app_setting\", (stmt) => {\r\n      while (DbResult.BE_SQLITE_ROW === stmt.step()) {\r\n        keys.push(stmt.getValueString(0));\r\n      }\r\n    });\r\n    return keys;\r\n  }\r\n\r\n  /** Remove a key/value pair from this Storage */\r\n  public removeData(key: string) {\r\n    const rc = this._ecdb.withPreparedSqliteStatement(\"DELETE FROM app_setting WHERE key=?\", (stmt) => {\r\n      stmt.bindValue(1, key);\r\n      return stmt.step();\r\n    });\r\n    if (rc !== DbResult.BE_SQLITE_DONE) {\r\n      throw new IModelError(rc, \"SQLite error\");\r\n    }\r\n  }\r\n\r\n  /** Remove all key/value pairs */\r\n  public removeAll() {\r\n    const rc = this._ecdb.withPreparedSqliteStatement(\"DELETE FROM app_setting\", (stmt) => {\r\n      return stmt.step();\r\n    });\r\n    if (rc !== DbResult.BE_SQLITE_DONE) {\r\n      throw new IModelError(rc, \"SQLite error\");\r\n    }\r\n  }\r\n\r\n  /** Close this Storage. */\r\n  public close(deleteFile: boolean = false) {\r\n    const storageFile = join(NativeHost.appSettingsCacheDir, this.id);\r\n    this._ecdb.saveChanges();\r\n    this._ecdb.closeDb();\r\n    (this._ecdb as any) = undefined;\r\n    if (deleteFile)\r\n      IModelJsFs.removeSync(storageFile);\r\n    NativeAppStorage._storages.delete(this.id);\r\n  }\r\n\r\n  private static init(ecdb: ECDb): DbResult {\r\n    return ecdb.withPreparedSqliteStatement(\"CREATE TABLE app_setting(key PRIMARY KEY,type,val);\", (stmt) => {\r\n      return stmt.step();\r\n    });\r\n  }\r\n\r\n  /** find and open storage by its name. */\r\n  public static find(name: string): NativeAppStorage {\r\n    const storage = this._storages.get(name);\r\n    if (undefined === storage)\r\n      throw new IModelError(IModelStatus.FileNotFound, `Storage ${name} not open`);\r\n    return storage;\r\n  }\r\n\r\n  /** Close all opened Storages.\r\n   * @internal\r\n   */\r\n  public static closeAll() {\r\n    this._storages.forEach((value) => value.close());\r\n    this._storages.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  public static getStorageNames(): string[] {\r\n    return IModelJsFs.readdirSync(NativeHost.appSettingsCacheDir).filter((name) => name.endsWith(this._ext));\r\n  }\r\n\r\n  /** Open or find a Storage by name. */\r\n  public static open(name: string): NativeAppStorage {\r\n    if (!this._init) {\r\n      IModelHost.onBeforeShutdown.addOnce(() => this.closeAll());\r\n      this._init = true;\r\n    }\r\n    const fileName = name + this._ext;\r\n    if (!IModelJsFs.existsSync(NativeHost.appSettingsCacheDir))\r\n      IModelJsFs.recursiveMkDirSync(NativeHost.appSettingsCacheDir);\r\n\r\n    const storageFile = join(NativeHost.appSettingsCacheDir, fileName);\r\n    try {\r\n      return this.find(fileName); // see if it's already open\r\n    } catch (err) {\r\n      const ecdb = new ECDb();\r\n      if (IModelJsFs.existsSync(storageFile)) {\r\n        ecdb.openDb(storageFile, ECDbOpenMode.ReadWrite);\r\n      } else {\r\n        ecdb.createDb(storageFile);\r\n        const rc = this.init(ecdb);\r\n        if (rc !== DbResult.BE_SQLITE_DONE)\r\n          throw new IModelError(rc, \"SQLite error\");\r\n        ecdb.saveChanges();\r\n      }\r\n      const storage = new NativeAppStorage(ecdb, fileName);\r\n      this._storages.set(fileName, storage);\r\n      return storage;\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/NativeHost.d.ts

@@ -1,53 +1,53 @@
-/** @packageDocumentation
- * @module NativeApp
- */
-import { BeEvent } from "@itwin/core-bentley";
-import { InternetConnectivityStatus, NativeAppNotifications, OverriddenBy } from "@itwin/core-common";
-import { IpcHostOpts } from "./IpcHost";
-import { NativeAppStorage } from "./NativeAppStorage";
-/** Options for [[NativeHost.startup]]
- * @public
- */
-export interface NativeHostOpts extends IpcHostOpts {
-    nativeHost?: {
-        /** Application name. Used, for example, to name the settings file. If not supplied, defaults to "iTwinApp". */
-        applicationName?: string;
-    };
-}
-/**
- * Backend for desktop/mobile native applications
- * @public
- */
-export declare class NativeHost {
-    private static _reachability?;
-    private static _applicationName;
-    private constructor();
-    /** Event called when the internet connectivity changes, if known. */
-    static readonly onInternetConnectivityChanged: BeEvent<(status: InternetConnectivityStatus) => void>;
-    private static _appSettingsCacheDir?;
-    /** Get the local cache folder for application settings */
-    static get appSettingsCacheDir(): string;
-    /** Send a notification to the NativeApp connected to this NativeHost. */
-    static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>): void;
-    private static _isValid;
-    static get isValid(): boolean;
-    static get applicationName(): string;
-    /** Get the settings store for this NativeHost. */
-    static get settingsStore(): NativeAppStorage;
-    /**
-     * Start the backend of a native app.
-     * @note this method calls [[IpcHost.startup]] internally.
-     */
-    static startup(opt?: NativeHostOpts): Promise<void>;
-    /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */
-    static shutdown(): Promise<void>;
-    /** get current value of internet connectivity */
-    static checkInternetConnectivity(): InternetConnectivityStatus;
-    /**
-     * Override internet connectivity state
-     * @param _overridenBy who overrode the value.
-     * @internal
-     */
-    static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void;
-}
+/** @packageDocumentation
+ * @module NativeApp
+ */
+import { BeEvent } from "@itwin/core-bentley";
+import { InternetConnectivityStatus, NativeAppNotifications, OverriddenBy } from "@itwin/core-common";
+import { IpcHostOpts } from "./IpcHost";
+import { NativeAppStorage } from "./NativeAppStorage";
+/** Options for [[NativeHost.startup]]
+ * @public
+ */
+export interface NativeHostOpts extends IpcHostOpts {
+    nativeHost?: {
+        /** Application name. Used, for example, to name the settings file. If not supplied, defaults to "iTwinApp". */
+        applicationName?: string;
+    };
+}
+/**
+ * Backend for desktop/mobile native applications
+ * @public
+ */
+export declare class NativeHost {
+    private static _reachability?;
+    private static _applicationName;
+    private constructor();
+    /** Event called when the internet connectivity changes, if known. */
+    static readonly onInternetConnectivityChanged: BeEvent<(status: InternetConnectivityStatus) => void>;
+    private static _appSettingsCacheDir?;
+    /** Get the local cache folder for application settings */
+    static get appSettingsCacheDir(): string;
+    /** Send a notification to the NativeApp connected to this NativeHost. */
+    static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>): void;
+    private static _isValid;
+    static get isValid(): boolean;
+    static get applicationName(): string;
+    /** Get the settings store for this NativeHost. */
+    static get settingsStore(): NativeAppStorage;
+    /**
+     * Start the backend of a native app.
+     * @note this method calls [[IpcHost.startup]] internally.
+     */
+    static startup(opt?: NativeHostOpts): Promise<void>;
+    /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */
+    static shutdown(): Promise<void>;
+    /** get current value of internet connectivity */
+    static checkInternetConnectivity(): InternetConnectivityStatus;
+    /**
+     * Override internet connectivity state
+     * @param _overridenBy who overrode the value.
+     * @internal
+     */
+    static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void;
+}
 //# sourceMappingURL=NativeHost.d.ts.map