@itwin/core-backend 3.0.0-dev.100

package/lib/cjs/NativeAppStorage.js

@@ -0,0 +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;
+//# sourceMappingURL=NativeAppStorage.js.map

package/lib/cjs/NativeAppStorage.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,71 @@
+/** @packageDocumentation
+ * @module NativeApp
+ */
+import { AccessToken, BeEvent } from "@itwin/core-bentley";
+import { AuthorizationClient, InternetConnectivityStatus, NativeAppAuthorizationConfiguration, NativeAppNotifications, OverriddenBy } from "@itwin/core-common";
+import { ImsAuthorizationClient } from "@bentley/itwin-client";
+import { IpcHostOpts } from "./IpcHost";
+import { NativeAppStorage } from "./NativeAppStorage";
+/** @internal */
+export declare abstract class NativeAppAuthorizationBackend extends ImsAuthorizationClient implements AuthorizationClient {
+    protected _accessToken: AccessToken;
+    abstract signIn(): Promise<void>;
+    abstract signOut(): Promise<void>;
+    protected abstract refreshToken(): Promise<AccessToken>;
+    config?: NativeAppAuthorizationConfiguration;
+    expireSafety: number;
+    issuerUrl?: string;
+    protected constructor(config?: NativeAppAuthorizationConfiguration);
+    setAccessToken(token: AccessToken): void;
+    getAccessToken(): Promise<AccessToken>;
+    initialize(config?: NativeAppAuthorizationConfiguration): Promise<void>;
+}
+/** 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();
+    /** @internal */
+    static get authorization(): NativeAppAuthorizationBackend;
+    /** Event called when the user's sign-in state changes - this may be due to calls to signIn(), signOut() or because the token was refreshed */
+    static readonly onAccessTokenChanged: BeEvent<(token: AccessToken) => void>;
+    /** 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

package/lib/cjs/NativeHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHost.d.ts","sourceRoot":"","sources":["../../src/NativeHost.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAc,OAAO,EAAc,MAAM,qBAAqB,CAAC;AACnF,OAAO,EACL,mBAAmB,EAA+B,0BAA0B,EAAuB,mCAAmC,EAClH,sBAAsB,EAAmB,YAAY,EAC1E,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAwB,MAAM,uBAAuB,CAAC;AAIrF,OAAO,EAAuB,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gBAAgB;AAChB,8BAAsB,6BAA8B,SAAQ,sBAAuB,YAAW,mBAAmB;IAC/G,SAAS,CAAC,YAAY,EAAE,WAAW,CAAM;aACzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;aACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACxC,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAChD,MAAM,CAAC,EAAE,mCAAmC,CAAC;IAC7C,YAAY,SAAW;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IAE1B,SAAS,aAAa,MAAM,CAAC,EAAE,mCAAmC;IAK3D,cAAc,CAAC,KAAK,EAAE,WAAW;IAO3B,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAMtC,UAAU,CAAC,MAAM,CAAC,EAAE,mCAAmC;CAQrE;AAuHD;aACa;AACb,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,UAAU,CAAC,EAAE;QACX,+GAA+G;QAC/G,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAA6B;IAC1D,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAS;IACxC,OAAO;IAEP,gBAAgB;IAChB,WAAkB,aAAa,kCAA8E;IAE7G,8IAA8I;IAC9I,gBAAuB,oBAAoB,kBAAuB,WAAW,KAAK,IAAI,EAAI;IAE1F,qEAAqE;IACrE,gBAAuB,6BAA6B,mBAAwB,0BAA0B,KAAK,IAAI,EAAI;IAEnH,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAS;IAE7C,0DAA0D;IAC1D,WAAkB,mBAAmB,IAAI,MAAM,CAI9C;IAED,yEAAyE;WAC3D,oBAAoB,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAIxI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,WAAkB,OAAO,IAAI,OAAO,CAA0B;IAC9D,WAAkB,eAAe,WAAoC;IACrE,kDAAkD;IAClD,WAAkB,aAAa,qBAE9B;IAED;;;OAGG;WACiB,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAehE,mEAAmE;WAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7C,iDAAiD;WACnC,yBAAyB,IAAI,0BAA0B;IAIrE;;;;OAIG;WACW,4BAA4B,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,0BAA0B,GAAG,IAAI;CAOjH"}

package/lib/cjs/NativeHost.js

@@ -0,0 +1,221 @@
+"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 = exports.NativeAppAuthorizationBackend = void 0;
+const path_1 = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const itwin_client_1 = require("@bentley/itwin-client");
+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");
+/** @internal */
+class NativeAppAuthorizationBackend extends itwin_client_1.ImsAuthorizationClient {
+    constructor(config) {
+        super();
+        this._accessToken = "";
+        this.expireSafety = 60 * 10; // refresh token 10 minutes before real expiration time
+        this.config = config;
+    }
+    setAccessToken(token) {
+        if (token === this._accessToken)
+            return;
+        this._accessToken = token;
+        NativeHost.onAccessTokenChanged.raiseEvent(token);
+    }
+    async getAccessToken() {
+        if (!this._accessToken) // TODO: This should happen from a timer, not here
+            this.setAccessToken(await this.refreshToken());
+        return this._accessToken;
+    }
+    async initialize(config) {
+        var _c;
+        this.config = config !== null && config !== void 0 ? config : this.config;
+        if (!this.config)
+            throw new core_common_1.IModelError(core_bentley_1.AuthStatus.Error, "Must specify a valid configuration when initializing authorization");
+        if (this.config.expiryBuffer)
+            this.expireSafety = this.config.expiryBuffer;
+        this.issuerUrl = (_c = this.config.issuerUrl) !== null && _c !== void 0 ? _c : await this.getUrl();
+    }
+}
+exports.NativeAppAuthorizationBackend = NativeAppAuthorizationBackend;
+/**
+ * Implementation of NativeAppFunctions
+ */
+class NativeAppHandler extends IpcHost_1.IpcHandler {
+    get channelName() { return core_common_1.nativeAppChannel; }
+    async setAccessToken(token) {
+        NativeHost.authorization.setAccessToken(token);
+    }
+    async getAccessToken() {
+        return NativeHost.authorization.getAccessToken();
+    }
+    async initializeAuth(props, config) {
+        IModelHost_1.IModelHost.session.applicationId = props.applicationId;
+        IModelHost_1.IModelHost.applicationVersion = props.applicationVersion;
+        IModelHost_1.IModelHost.sessionId = props.sessionId;
+        await NativeHost.authorization.initialize(config);
+        return NativeHost.authorization.expireSafety;
+    }
+    async signIn() {
+        return NativeHost.authorization.signIn();
+    }
+    async signOut() {
+        return NativeHost.authorization.signOut();
+    }
+    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,
+            onProgress: (_a, _b) => checkAbort(),
+        };
+        if (reportProgress) {
+            const interval = progressInterval !== null && progressInterval !== void 0 ? progressInterval : 250; // by default, only send progress events every 250 milliseconds
+            let nextTime = Date.now() + interval;
+            args.onProgress = (loaded, total) => {
+                const now = Date.now();
+                if (loaded >= total || now >= nextTime) {
+                    nextTime = now + interval;
+                    IpcHost_1.IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });
+                }
+                return checkAbort();
+            };
+        }
+        const downloadPromise = BriefcaseManager_1.BriefcaseManager.downloadBriefcase(args);
+        const checkAbort = () => {
+            const job = CheckpointManager_1.Downloads.isInProgress(args.fileName);
+            return (job && job.request.abort === 1) ? 1 : 0;
+        };
+        return downloadPromise;
+    }
+    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
+    /** @internal */
+    static get authorization() { return IModelHost_1.IModelHost.authorizationClient; }
+    /** 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) {
+        var _c, _d;
+        if (!this.isValid) {
+            this._isValid = true;
+            this.onInternetConnectivityChanged.addListener((status) => NativeHost.notifyNativeFrontend("notifyInternetConnectivityChanged", status));
+            this.onAccessTokenChanged.addListener((token) => NativeHost.notifyNativeFrontend("notifyAccessTokenChanged", token));
+            this._applicationName = (_d = (_c = opt === null || opt === void 0 ? void 0 : opt.nativeHost) === null || _c === void 0 ? void 0 : _c.applicationName) !== null && _d !== void 0 ? _d : "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();
+        this.onAccessTokenChanged.clear();
+        await IpcHost_1.IpcHost.shutdown();
+    }
+    /** get current value of internet connectivity */
+    static checkInternetConnectivity() {
+        var _c;
+        return (_c = this._reachability) !== null && _c !== void 0 ? _c : 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;
+            itwin_client_1.RequestGlobalOptions.online = this._reachability === core_common_1.InternetConnectivityStatus.Online;
+            this.onInternetConnectivityChanged.raiseEvent(status);
+        }
+    }
+}
+exports.NativeHost = NativeHost;
+/** Event called when the user's sign-in state changes - this may be due to calls to signIn(), signOut() or because the token was refreshed */
+NativeHost.onAccessTokenChanged = new core_bentley_1.BeEvent();
+/** 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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHost.js","sourceRoot":"","sources":["../../src/NativeHost.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 { AccessToken, AuthStatus, BeEvent, GuidString } from \"@itwin/core-bentley\";\r\nimport {\r\n  AuthorizationClient, BriefcaseProps, IModelError, InternetConnectivityStatus, LocalBriefcaseProps, NativeAppAuthorizationConfiguration, nativeAppChannel,\r\n  NativeAppFunctions, NativeAppNotifications, nativeAppNotify, OverriddenBy, RequestNewBriefcaseProps, SessionProps, StorageValue,\r\n} from \"@itwin/core-common\";\r\nimport { ImsAuthorizationClient, RequestGlobalOptions } from \"@bentley/itwin-client\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { Downloads } from \"./CheckpointManager\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { IpcHandler, IpcHost, IpcHostOpts } from \"./IpcHost\";\r\nimport { NativeAppStorage } from \"./NativeAppStorage\";\r\n\r\n/** @internal */\r\nexport abstract class NativeAppAuthorizationBackend extends ImsAuthorizationClient implements AuthorizationClient {\r\n  protected _accessToken: AccessToken = \"\";\r\n  public abstract signIn(): Promise<void>;\r\n  public abstract signOut(): Promise<void>;\r\n  protected abstract refreshToken(): Promise<AccessToken>;\r\n  public config?: NativeAppAuthorizationConfiguration;\r\n  public expireSafety = 60 * 10; // refresh token 10 minutes before real expiration time\r\n  public issuerUrl?: string;\r\n\r\n  protected constructor(config?: NativeAppAuthorizationConfiguration) {\r\n    super();\r\n    this.config = config;\r\n  }\r\n\r\n  public setAccessToken(token: AccessToken) {\r\n    if (token === this._accessToken)\r\n      return;\r\n    this._accessToken = token;\r\n    NativeHost.onAccessTokenChanged.raiseEvent(token);\r\n  }\r\n\r\n  public async getAccessToken(): Promise<AccessToken> {\r\n    if (!this._accessToken) // TODO: This should happen from a timer, not here\r\n      this.setAccessToken(await this.refreshToken());\r\n    return this._accessToken;\r\n  }\r\n\r\n  public async initialize(config?: NativeAppAuthorizationConfiguration) {\r\n    this.config = config ?? this.config;\r\n    if (!this.config)\r\n      throw new IModelError(AuthStatus.Error, \"Must specify a valid configuration when initializing authorization\");\r\n    if (this.config.expiryBuffer)\r\n      this.expireSafety = this.config.expiryBuffer;\r\n    this.issuerUrl = this.config.issuerUrl ?? await this.getUrl();\r\n  }\r\n}\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 setAccessToken(token: AccessToken) {\r\n    NativeHost.authorization.setAccessToken(token);\r\n  }\r\n  public async getAccessToken(): Promise<AccessToken> {\r\n    return NativeHost.authorization.getAccessToken();\r\n  }\r\n  public async initializeAuth(props: SessionProps, config?: NativeAppAuthorizationConfiguration): Promise<number> {\r\n    IModelHost.session.applicationId = props.applicationId;\r\n    IModelHost.applicationVersion = props.applicationVersion;\r\n    IModelHost.sessionId = props.sessionId;\r\n\r\n    await NativeHost.authorization.initialize(config);\r\n    return NativeHost.authorization.expireSafety;\r\n  }\r\n  public async signIn(): Promise<void> {\r\n    return NativeHost.authorization.signIn();\r\n  }\r\n  public async signOut(): Promise<void> {\r\n    return NativeHost.authorization.signOut();\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 = {\r\n      ...request,\r\n      onProgress: (_a: number, _b: number) => checkAbort(),\r\n    };\r\n\r\n    if (reportProgress) {\r\n      const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\r\n      let nextTime = Date.now() + interval;\r\n      args.onProgress = (loaded, total) => {\r\n        const now = Date.now();\r\n        if (loaded >= total || now >= nextTime) {\r\n          nextTime = now + interval;\r\n          IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });\r\n        }\r\n        return checkAbort();\r\n      };\r\n    }\r\n\r\n    const downloadPromise = BriefcaseManager.downloadBriefcase(args);\r\n    const checkAbort = () => {\r\n      const job = Downloads.isInProgress(args.fileName!);\r\n      return (job && (job.request as any).abort === 1) ? 1 : 0;\r\n    };\r\n    return downloadPromise;\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\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  /** @internal */\r\n  public static get authorization() { return IModelHost.authorizationClient as NativeAppAuthorizationBackend; }\r\n\r\n  /** Event called when the user's sign-in state changes - this may be due to calls to signIn(), signOut() or because the token was refreshed */\r\n  public static readonly onAccessTokenChanged = new BeEvent<(token: AccessToken) => void>();\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.onAccessTokenChanged.addListener((token: AccessToken) =>\r\n        NativeHost.notifyNativeFrontend(\"notifyAccessTokenChanged\", token));\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    this.onAccessTokenChanged.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      RequestGlobalOptions.online = this._reachability === InternetConnectivityStatus.Online;\r\n      this.onInternetConnectivityChanged.raiseEvent(status);\r\n    }\r\n  }\r\n}\r\n"]}