@itwin/core-backend 3.0.0-dev.98 → 3.0.0

package/lib/cjs/SQLiteDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  private _nativeDb?: IModelJsNative.SQLiteDb;\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public get nativeDb(): IModelJsNative.SQLiteDb {\r\n    return this._nativeDb!;\r\n  }\r\n\r\n  constructor() {\r\n    this._nativeDb = new IModelHost.platform.SQLiteDb();\r\n  }\r\n  /** Call this function when finished with this SQLiteDb. This releases the native resources */\r\n  public dispose(): void {\r\n    if (!this._nativeDb)\r\n      return;\r\n\r\n    this.closeDb();\r\n    this._nativeDb.dispose();\r\n    this._nativeDb = undefined;\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param pathName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(pathName: string): void {\r\n    this.nativeDb.createDb(pathName);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param pathName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(pathName: string, openMode: OpenMode): void {\r\n    this.nativeDb.openDb(pathName, openMode);\r\n  }\r\n\r\n  /** Returns true if the SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Close SQLiteDb. */\r\n  public closeDb(): void {\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n     * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n     * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n     * @param sql The SQLite SQL statement to execute\r\n     * @param callback the callback to invoke on the prepared statement\r\n     * @returns the value returned by `callback`.\r\n     * @see [[withPreparedStatement]]\r\n     * @public\r\n     */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n     * @param sql The SQLite SQL statement to execute\r\n     * @param callback the callback to invoke on the prepared statement\r\n     * @returns the value returned by `callback`.\r\n     * @public\r\n     */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  private _nativeDb?: IModelJsNative.SQLiteDb;\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public get nativeDb(): IModelJsNative.SQLiteDb {\r\n    return this._nativeDb!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n  }\r\n\r\n  constructor() {\r\n    this._nativeDb = new IModelHost.platform.SQLiteDb();\r\n  }\r\n  /** Call this function when finished with this SQLiteDb. This releases the native resources */\r\n  public dispose(): void {\r\n    if (!this._nativeDb)\r\n      return;\r\n\r\n    this.closeDb();\r\n    this._nativeDb.dispose();\r\n    this._nativeDb = undefined;\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param pathName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(pathName: string): void {\r\n    this.nativeDb.createDb(pathName);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param pathName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(pathName: string, openMode: OpenMode): void {\r\n    this.nativeDb.openDb(pathName, openMode);\r\n  }\r\n\r\n  /** Returns true if the SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Close SQLiteDb. */\r\n  public closeDb(): void {\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n     * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n     * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n     * @param sql The SQLite SQL statement to execute\r\n     * @param callback the callback to invoke on the prepared statement\r\n     * @returns the value returned by `callback`.\r\n     * @see [[withPreparedStatement]]\r\n     * @public\r\n     */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n     * @param sql The SQLite SQL statement to execute\r\n     * @param callback the callback to invoke on the prepared statement\r\n     * @returns the value returned by `callback`.\r\n     * @public\r\n     */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/ServerBasedLocks.d.ts

@@ -42,16 +42,10 @@ export declare class ServerBasedLocks implements LockControl {
     private addOwnerSharedLocks;
     /** attempt to acquire all necessary locks for a set of elements */
     private acquireAllLocks;
-    /**
-     * Acquire the exclusive lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.
-     * If *any* lock cannot be obtained, no locks are acquired.
-     */
-    acquireExclusiveLock(ids: Id64Arg): Promise<void>;
-    /**
-     * Acquire a shared lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.
-     * If *any* lock cannot be obtained, no locks are acquired.
-     */
-    acquireSharedLock(ids: Id64Arg): Promise<void>;
+    acquireLocks(arg: {
+        shared?: Id64Arg;
+        exclusive?: Id64Arg;
+    }): Promise<void>;
     /** When an element is newly created in a session, we hold the lock on it implicitly. Save that fact. */
     elementWasCreated(id: Id64String): void;
     /** locks are not necessary during change propagation. */

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

@@ -1 +1 @@
-{"version":3,"file":"ServerBasedLocks.d.ts","sourceRoot":"","sources":["../../src/ServerBasedLocks.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAkB,OAAO,EAAE,UAAU,EAA0B,MAAM,qBAAqB,CAAC;AAElG,OAAO,EAAW,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;CAC3C;AASD,gBAAgB;AAChB,qBAAa,gBAAiB,YAAW,WAAW;IAClD,IAAW,aAAa,YAAmB;IAC3C,SAAS,CAAC,QAAQ,CAAC,MAAM,WAAkB;IAC3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;gBAEvB,MAAM,EAAE,WAAW;IAY/B,KAAK;IAKZ,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB,qBAAqB;IACd,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAQhC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7C,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,uBAAuB;IAgB/B,mGAAmG;IAC5F,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAK3C,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAM/C,sIAAsI;IACtI,OAAO,CAAC,aAAa;IAUrB,sGAAsG;IACtG,OAAO,CAAC,mBAAmB;IAM3B,mEAAmE;YACrD,eAAe;IAmB7B;;;OAGG;IACU,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D;;;OAGG;IACU,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,wGAAwG;IACjG,iBAAiB,CAAC,EAAE,EAAE,UAAU;IAKvC,yDAAyD;IACzD,OAAO,KAAK,iBAAiB,GAAqD;IAElF,uGAAuG;IAChG,kBAAkB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKzE,kGAAkG;IAC3F,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAKvE"}
+{"version":3,"file":"ServerBasedLocks.d.ts","sourceRoot":"","sources":["../../src/ServerBasedLocks.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAkB,OAAO,EAAE,UAAU,EAA0B,MAAM,qBAAqB,CAAC;AAElG,OAAO,EAAW,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;CAC3C;AASD,gBAAgB;AAChB,qBAAa,gBAAiB,YAAW,WAAW;IAClD,IAAW,aAAa,YAAmB;IAC3C,SAAS,CAAC,QAAQ,CAAC,MAAM,WAAkB;IAC3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;gBAEvB,MAAM,EAAE,WAAW;IAY/B,KAAK;IAKZ,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB,qBAAqB;IACd,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAQhC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7C,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,uBAAuB;IAgB/B,mGAAmG;IAC5F,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAK3C,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAM/C,sIAAsI;IACtI,OAAO,CAAC,aAAa;IAUrB,sGAAsG;IACtG,OAAO,CAAC,mBAAmB;IAM3B,mEAAmE;YACrD,eAAe;IAmBhB,YAAY,CAAC,GAAG,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxF,wGAAwG;IACjG,iBAAiB,CAAC,EAAE,EAAE,UAAU;IAKvC,yDAAyD;IACzD,OAAO,KAAK,iBAAiB,GAAqD;IAElF,uGAAuG;IAChG,kBAAkB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKzE,kGAAkG;IAC3F,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAKvE"}

package/lib/cjs/ServerBasedLocks.js

@@ -88,7 +88,7 @@ class ServerBasedLocks {
         if (this.ownerHoldsExclusiveLock(modelId))
             return this.insertLock(modelId, BackendHubAccess_1.LockState.Exclusive, 2 /* Discovered */);
         // see if the parent is exclusively locked by one of its owners. If so, save that fact on parentId so future tests won't have to descend.
-        return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId, BackendHubAccess_1.LockState.Exclusive, 2 /* Discovered */) : false;
+        return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId, BackendHubAccess_1.LockState.Exclusive, 2 /* Discovered */) : false; // eslint-disable-line @typescript-eslint/no-non-null-assertion
     }
     /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */
     holdsExclusiveLock(id) {
@@ -131,27 +131,19 @@ class ServerBasedLocks {
             this.insertLock(lock[0], lock[1], 0 /* Acquired */);
         this.lockDb.saveChanges();
     }
-    /**
-     * Acquire the exclusive lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.
-     * If *any* lock cannot be obtained, no locks are acquired.
-     */
-    async acquireExclusiveLock(ids) {
+    async acquireLocks(arg) {
         const locks = new Map();
-        for (const id of core_bentley_1.Id64.iterable(ids)) {
-            if (!this.holdsExclusiveLock(id))
-                locks.set(id, BackendHubAccess_1.LockState.Exclusive);
+        if (arg.shared) {
+            for (const id of core_bentley_1.Id64.iterable(arg.shared)) {
+                if (!this.holdsSharedLock(id))
+                    locks.set(id, BackendHubAccess_1.LockState.Shared);
+            }
         }
-        return this.acquireAllLocks(locks);
-    }
-    /**
-     * Acquire a shared lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.
-     * If *any* lock cannot be obtained, no locks are acquired.
-     */
-    async acquireSharedLock(ids) {
-        const locks = new Map();
-        for (const id of core_bentley_1.Id64.iterable(ids)) {
-            if (!this.holdsSharedLock(id))
-                locks.set(id, BackendHubAccess_1.LockState.Shared);
+        if (arg.exclusive) {
+            for (const id of core_bentley_1.Id64.iterable(arg.exclusive)) {
+                if (!this.holdsExclusiveLock(id))
+                    locks.set(id, BackendHubAccess_1.LockState.Exclusive);
+            }
         }
         return this.acquireAllLocks(locks);
     }

package/lib/cjs/ServerBasedLocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerBasedLocks.js","sourceRoot":"","sources":["../../src/ServerBasedLocks.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { DbResult, Id64, Id64Arg, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\r\nimport { IModel, IModelError } from \"@itwin/core-common\";\r\nimport { LockMap, LockState } from \"./BackendHubAccess\";\r\nimport { BriefcaseDb, LockControl } from \"./IModelDb\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SQLiteDb } from \"./SQLiteDb\";\r\n\r\n/**\r\n * Both the Model and Parent of an element are considered \"owners\" of their member elements. That means:\r\n * 1) they must hold at least a shared lock before an exclusive lock can be acquired for their members\r\n * 2) if they hold an exclusive lock, then all of their members are exclusively locked implicitly.\r\n * @internal\r\n */\r\nexport interface ElementOwners {\r\n  readonly modelId: Id64String;\r\n  readonly parentId: Id64String | undefined;\r\n}\r\n\r\n// eslint-disable-next-line no-restricted-syntax\r\nconst enum LockOrigin {\r\n  Acquired = 0,\r\n  NewElement = 1,\r\n  Discovered = 2,\r\n}\r\n\r\n/** @internal */\r\nexport class ServerBasedLocks implements LockControl {\r\n  public get isServerBased() { return true; }\r\n  protected readonly lockDb = new SQLiteDb();\r\n  protected readonly briefcase: BriefcaseDb;\r\n\r\n  public constructor(iModel: BriefcaseDb) {\r\n    this.briefcase = iModel;\r\n    const dbName = `${iModel.nativeDb.getTempFileBaseName()}-locks`;\r\n    try {\r\n      this.lockDb.openDb(dbName, OpenMode.ReadWrite);\r\n    } catch (_e) {\r\n      this.lockDb.createDb(dbName);\r\n      this.lockDb.executeSQL(\"CREATE TABLE locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)\");\r\n      this.lockDb.saveChanges();\r\n    }\r\n  }\r\n\r\n  public close() {\r\n    if (this.lockDb.isOpen)\r\n      this.lockDb.closeDb();\r\n  }\r\n\r\n  private getOwners(id: Id64String): ElementOwners {\r\n    return this.briefcase.withPreparedSqliteStatement(\"SELECT ModelId,ParentId FROM bis_Element WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_ROW !== rc)\r\n        throw new IModelError(rc, `element ${id} not found`);\r\n\r\n      return { modelId: stmt.getValueId(0), parentId: stmt.getValueId(1) };\r\n    });\r\n  }\r\n\r\n  private getLockState(id?: Id64String): LockState | undefined {\r\n    return (id === undefined || !Id64.isValid(id)) ? undefined : this.lockDb.withPreparedSqliteStatement(\"SELECT state FROM locks WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      return (DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;\r\n    });\r\n  }\r\n\r\n  /** Clear the cache of locally held locks.\r\n   * Note: does *not* release locks from server.\r\n   */\r\n  private clearAllLocks() {\r\n    this.lockDb.executeSQL(\"DELETE FROM locks\");\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** only for tests */\r\n  public getLockCount(state: LockState): number {\r\n    return this.lockDb.withSqliteStatement(\"SELECT count(*) FROM locks WHERE state=?\", (stmt) => {\r\n      stmt.bindInteger(1, state);\r\n      stmt.step();\r\n      return stmt.getValueInteger(0);\r\n    });\r\n  }\r\n\r\n  public async releaseAllLocks(): Promise<void> {\r\n    await IModelHost.hubAccess.releaseAllLocks(this.briefcase); // throws if unsuccessful\r\n    this.clearAllLocks();\r\n  }\r\n\r\n  private insertLock(id: Id64String, state: LockState, origin: LockOrigin): true {\r\n    this.lockDb.withPreparedSqliteStatement(\"INSERT INTO locks(id,state,origin) VALUES (?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,origin=excluded.origin\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      stmt.bindInteger(2, state);\r\n      stmt.bindInteger(3, origin);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        throw new IModelError(rc, \"can't insert lock into database\");\r\n    });\r\n    return true;\r\n  }\r\n\r\n  private ownerHoldsExclusiveLock(id: Id64String | undefined): boolean {\r\n    if (id === undefined || id === IModel.rootSubjectId)\r\n      return false; // has no owners\r\n\r\n    const { modelId, parentId } = this.getOwners(id);\r\n    if (this.getLockState(modelId) === LockState.Exclusive || this.getLockState(parentId) === LockState.Exclusive)\r\n      return true;\r\n\r\n    // see if this model is exclusively locked by one of its owners. If so, save that fact on modelId so future tests won't have to descend.\r\n    if (this.ownerHoldsExclusiveLock(modelId))\r\n      return this.insertLock(modelId, LockState.Exclusive, LockOrigin.Discovered);\r\n\r\n    // see if the parent is exclusively locked by one of its owners. If so, save that fact on parentId so future tests won't have to descend.\r\n    return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId!, LockState.Exclusive, LockOrigin.Discovered) : false;\r\n  }\r\n\r\n  /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */\r\n  public holdsExclusiveLock(id: Id64String): boolean {\r\n    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\r\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  public holdsSharedLock(id: Id64String): boolean {\r\n    const state = this.getLockState(id);\r\n    // see if we hold shared or exclusive lock, or if an owner has exclusive lock. If so we implicitly have shared lock, but owner holding shared lock doesn't help.\r\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  /** if the shared lock on the element supplied is not already held, add it to the set of shared locks required. Then, check owners. */\r\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\r\n    // if the id is not valid, or of the lock is already in the set, or if we already hold a shared lock, we're done\r\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\r\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\r\n      return;\r\n\r\n    locks.add(id); // add to set of needed shared locks\r\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\r\n  }\r\n\r\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\r\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\r\n    const el = this.getOwners(id);\r\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\r\n    this.addSharedLock(el.modelId, locks); // check its model\r\n  }\r\n\r\n  /** attempt to acquire all necessary locks for a set of elements */\r\n  private async acquireAllLocks(locks: LockMap) {\r\n    if (locks.size === 0) // no locks are required.\r\n      return;\r\n\r\n    const sharedLocks = new Set<Id64String>();\r\n    for (const lock of locks)\r\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\r\n\r\n    for (const shared of sharedLocks) {\r\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\r\n        locks.set(shared, LockState.Shared);\r\n    }\r\n\r\n    await IModelHost.hubAccess.acquireLocks(this.briefcase, locks); // throws if unsuccessful\r\n    for (const lock of locks)\r\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /**\r\n   * Acquire the exclusive lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.\r\n   * If *any* lock cannot be obtained, no locks are acquired.\r\n   */\r\n  public async acquireExclusiveLock(ids: Id64Arg): Promise<void> {\r\n    const locks = new Map<Id64String, LockState>();\r\n    for (const id of Id64.iterable(ids)) {\r\n      if (!this.holdsExclusiveLock(id))\r\n        locks.set(id, LockState.Exclusive);\r\n    }\r\n    return this.acquireAllLocks(locks);\r\n  }\r\n\r\n  /**\r\n   * Acquire a shared lock on one or more elements. This also attempts to acquire a shared lock on all of the element's owners, recursively.\r\n   * If *any* lock cannot be obtained, no locks are acquired.\r\n   */\r\n  public async acquireSharedLock(ids: Id64Arg): Promise<void> {\r\n    const locks = new Map<Id64String, LockState>();\r\n    for (const id of Id64.iterable(ids)) {\r\n      if (!this.holdsSharedLock(id))\r\n        locks.set(id, LockState.Shared);\r\n    }\r\n    return this.acquireAllLocks(locks);\r\n  }\r\n\r\n  /** When an element is newly created in a session, we hold the lock on it implicitly. Save that fact. */\r\n  public elementWasCreated(id: Id64String) {\r\n    this.insertLock(id, LockState.Exclusive, LockOrigin.NewElement);\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** locks are not necessary during change propagation. */\r\n  private get _locksAreRequired() { return !this.briefcase.txns.isIndirectChanges; }\r\n\r\n  /** throw if locks are currently required and the exclusive lock is not held on the supplied element */\r\n  public checkExclusiveLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsExclusiveLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `exclusive lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n  /** throw if locks are currently required and a shared lock is not held on the supplied element */\r\n  public checkSharedLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsSharedLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `shared lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n}\r\n\r\n"]}
+{"version":3,"file":"ServerBasedLocks.js","sourceRoot":"","sources":["../../src/ServerBasedLocks.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { DbResult, Id64, Id64Arg, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\r\nimport { IModel, IModelError } from \"@itwin/core-common\";\r\nimport { LockMap, LockState } from \"./BackendHubAccess\";\r\nimport { BriefcaseDb, LockControl } from \"./IModelDb\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SQLiteDb } from \"./SQLiteDb\";\r\n\r\n/**\r\n * Both the Model and Parent of an element are considered \"owners\" of their member elements. That means:\r\n * 1) they must hold at least a shared lock before an exclusive lock can be acquired for their members\r\n * 2) if they hold an exclusive lock, then all of their members are exclusively locked implicitly.\r\n * @internal\r\n */\r\nexport interface ElementOwners {\r\n  readonly modelId: Id64String;\r\n  readonly parentId: Id64String | undefined;\r\n}\r\n\r\n// eslint-disable-next-line no-restricted-syntax\r\nconst enum LockOrigin {\r\n  Acquired = 0,\r\n  NewElement = 1,\r\n  Discovered = 2,\r\n}\r\n\r\n/** @internal */\r\nexport class ServerBasedLocks implements LockControl {\r\n  public get isServerBased() { return true; }\r\n  protected readonly lockDb = new SQLiteDb();\r\n  protected readonly briefcase: BriefcaseDb;\r\n\r\n  public constructor(iModel: BriefcaseDb) {\r\n    this.briefcase = iModel;\r\n    const dbName = `${iModel.nativeDb.getTempFileBaseName()}-locks`;\r\n    try {\r\n      this.lockDb.openDb(dbName, OpenMode.ReadWrite);\r\n    } catch (_e) {\r\n      this.lockDb.createDb(dbName);\r\n      this.lockDb.executeSQL(\"CREATE TABLE locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)\");\r\n      this.lockDb.saveChanges();\r\n    }\r\n  }\r\n\r\n  public close() {\r\n    if (this.lockDb.isOpen)\r\n      this.lockDb.closeDb();\r\n  }\r\n\r\n  private getOwners(id: Id64String): ElementOwners {\r\n    return this.briefcase.withPreparedSqliteStatement(\"SELECT ModelId,ParentId FROM bis_Element WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_ROW !== rc)\r\n        throw new IModelError(rc, `element ${id} not found`);\r\n\r\n      return { modelId: stmt.getValueId(0), parentId: stmt.getValueId(1) };\r\n    });\r\n  }\r\n\r\n  private getLockState(id?: Id64String): LockState | undefined {\r\n    return (id === undefined || !Id64.isValid(id)) ? undefined : this.lockDb.withPreparedSqliteStatement(\"SELECT state FROM locks WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      return (DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;\r\n    });\r\n  }\r\n\r\n  /** Clear the cache of locally held locks.\r\n   * Note: does *not* release locks from server.\r\n   */\r\n  private clearAllLocks() {\r\n    this.lockDb.executeSQL(\"DELETE FROM locks\");\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** only for tests */\r\n  public getLockCount(state: LockState): number {\r\n    return this.lockDb.withSqliteStatement(\"SELECT count(*) FROM locks WHERE state=?\", (stmt) => {\r\n      stmt.bindInteger(1, state);\r\n      stmt.step();\r\n      return stmt.getValueInteger(0);\r\n    });\r\n  }\r\n\r\n  public async releaseAllLocks(): Promise<void> {\r\n    await IModelHost.hubAccess.releaseAllLocks(this.briefcase); // throws if unsuccessful\r\n    this.clearAllLocks();\r\n  }\r\n\r\n  private insertLock(id: Id64String, state: LockState, origin: LockOrigin): true {\r\n    this.lockDb.withPreparedSqliteStatement(\"INSERT INTO locks(id,state,origin) VALUES (?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,origin=excluded.origin\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      stmt.bindInteger(2, state);\r\n      stmt.bindInteger(3, origin);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        throw new IModelError(rc, \"can't insert lock into database\");\r\n    });\r\n    return true;\r\n  }\r\n\r\n  private ownerHoldsExclusiveLock(id: Id64String | undefined): boolean {\r\n    if (id === undefined || id === IModel.rootSubjectId)\r\n      return false; // has no owners\r\n\r\n    const { modelId, parentId } = this.getOwners(id);\r\n    if (this.getLockState(modelId) === LockState.Exclusive || this.getLockState(parentId) === LockState.Exclusive)\r\n      return true;\r\n\r\n    // see if this model is exclusively locked by one of its owners. If so, save that fact on modelId so future tests won't have to descend.\r\n    if (this.ownerHoldsExclusiveLock(modelId))\r\n      return this.insertLock(modelId, LockState.Exclusive, LockOrigin.Discovered);\r\n\r\n    // see if the parent is exclusively locked by one of its owners. If so, save that fact on parentId so future tests won't have to descend.\r\n    return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId!, LockState.Exclusive, LockOrigin.Discovered) : false; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n  }\r\n\r\n  /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */\r\n  public holdsExclusiveLock(id: Id64String): boolean {\r\n    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\r\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  public holdsSharedLock(id: Id64String): boolean {\r\n    const state = this.getLockState(id);\r\n    // see if we hold shared or exclusive lock, or if an owner has exclusive lock. If so we implicitly have shared lock, but owner holding shared lock doesn't help.\r\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  /** if the shared lock on the element supplied is not already held, add it to the set of shared locks required. Then, check owners. */\r\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\r\n    // if the id is not valid, or of the lock is already in the set, or if we already hold a shared lock, we're done\r\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\r\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\r\n      return;\r\n\r\n    locks.add(id); // add to set of needed shared locks\r\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\r\n  }\r\n\r\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\r\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\r\n    const el = this.getOwners(id);\r\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\r\n    this.addSharedLock(el.modelId, locks); // check its model\r\n  }\r\n\r\n  /** attempt to acquire all necessary locks for a set of elements */\r\n  private async acquireAllLocks(locks: LockMap) {\r\n    if (locks.size === 0) // no locks are required.\r\n      return;\r\n\r\n    const sharedLocks = new Set<Id64String>();\r\n    for (const lock of locks)\r\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\r\n\r\n    for (const shared of sharedLocks) {\r\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\r\n        locks.set(shared, LockState.Shared);\r\n    }\r\n\r\n    await IModelHost.hubAccess.acquireLocks(this.briefcase, locks); // throws if unsuccessful\r\n    for (const lock of locks)\r\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  public async acquireLocks(arg: { shared?: Id64Arg, exclusive?: Id64Arg }): Promise<void> {\r\n    const locks = new Map<Id64String, LockState>();\r\n    if (arg.shared) {\r\n      for (const id of Id64.iterable(arg.shared)) {\r\n        if (!this.holdsSharedLock(id))\r\n          locks.set(id, LockState.Shared);\r\n      }\r\n    }\r\n    if (arg.exclusive) {\r\n      for (const id of Id64.iterable(arg.exclusive)) {\r\n        if (!this.holdsExclusiveLock(id))\r\n          locks.set(id, LockState.Exclusive);\r\n      }\r\n    }\r\n    return this.acquireAllLocks(locks);\r\n  }\r\n\r\n  /** When an element is newly created in a session, we hold the lock on it implicitly. Save that fact. */\r\n  public elementWasCreated(id: Id64String) {\r\n    this.insertLock(id, LockState.Exclusive, LockOrigin.NewElement);\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** locks are not necessary during change propagation. */\r\n  private get _locksAreRequired() { return !this.briefcase.txns.isIndirectChanges; }\r\n\r\n  /** throw if locks are currently required and the exclusive lock is not held on the supplied element */\r\n  public checkExclusiveLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsExclusiveLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `exclusive lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n  /** throw if locks are currently required and a shared lock is not held on the supplied element */\r\n  public checkSharedLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsSharedLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `shared lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n}\r\n\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"SqliteStatement.d.ts","sourceRoot":"","sources":["../../src/SqliteStatement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SqliteStatement.d.ts","sourceRoot":"","sources":["../../src/SqliteStatement.ts"],"names":[],"mappings":"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"}

package/lib/cjs/SqliteStatement.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteStatement.js","sourceRoot":"","sources":["../../src/SqliteStatement.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 SQLite\r\n */\r\n\r\nimport { assert, DbResult, GuidString, Id64String, IDisposable, LRUMap } from \"@itwin/core-bentley\";\r\nimport { ECJsNames, IModelError } from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/** Marks a string as either an [Id64String]($core-bentley) or [GuidString]($core-bentley), so\r\n * that it can be passed to the [bindValue]($backend.SqliteStatement) or [bindValues]($backend.SqliteStatement)\r\n * methods of [SqliteStatement]($backend).\r\n * @internal\r\n */\r\nexport interface StringParam {\r\n  id?: Id64String;\r\n  guid?: GuidString;\r\n}\r\n\r\n/** parameter Index (1-based), or name of the parameter (including the initial ':', '@' or '$')\r\n * @public\r\n */\r\nexport type BindParameter = number | string;\r\n\r\n/** Executes SQLite SQL statements.\r\n *\r\n * A statement must be prepared before it can be executed, and it must be released when no longer needed.\r\n * See [IModelDb.withPreparedSqliteStatement]($backend) or\r\n * [ECDb.withPreparedSqliteStatement]($backend) for a convenient and\r\n * reliable way to prepare, execute, and then release a statement.\r\n *\r\n * A statement may contain parameters that must be filled in before use by calling [SqliteStatement.bindValue]($backend)\r\n * or [SqliteStatement.bindValues]($backend).\r\n *\r\n * Once prepared (and parameters are bound, if any), the statement is executed by calling [SqliteStatement.step]($backend).\r\n * In case of an **SQL SELECT** statement, the current row can be retrieved with [SqliteStatement.getRow]($backend) as\r\n * a whole, or with [SqliteStatement.getValue]($backend) when individual values are needed.\r\n * Alternatively, query results of an **SQL SELECT** statement can be stepped through by using\r\n * standard iteration syntax, such as `for of`.\r\n *\r\n * > Preparing a statement can be time-consuming. The best way to reduce the effect of this overhead is to cache and reuse prepared\r\n * > statements. A cached prepared statement may be used in different places in an app, as long as the statement is general enough.\r\n * > The key to making this strategy work is to phrase a statement in a general way and use placeholders to represent parameters that will vary on each use.\r\n * @public\r\n */\r\nexport class SqliteStatement implements IterableIterator<any>, IDisposable {\r\n  private _stmt: IModelJsNative.SqliteStatement | undefined;\r\n\r\n  public constructor(private _sql: string) { }\r\n  public get stmt() { return this._stmt; }\r\n  public get sql() { return this._sql; }\r\n\r\n  /** Check if this statement has been prepared successfully or not */\r\n  public get isPrepared(): boolean { return undefined !== this._stmt; }\r\n\r\n  /** Prepare this statement prior to first use.\r\n   * @param db The DgnDb or ECDb to prepare the statement against\r\n   * @param sql The SQL statement string to prepare\r\n   * @param logErrors Determine if errors are logged or not\r\n   * @throws if the SQL statement cannot be prepared. Normally, prepare fails due to SQL syntax errors or references to tables or properties that do not exist.\r\n   * The error.message property will provide details.\r\n   */\r\n  public prepare(db: IModelJsNative.DgnDb | IModelJsNative.ECDb | IModelJsNative.SQLiteDb, logErrors = true): void {\r\n    if (this.isPrepared)\r\n      throw new Error(\"SqliteStatement is already prepared\");\r\n    this._stmt = new IModelHost.platform.SqliteStatement();\r\n    this._stmt.prepare(db, this._sql, logErrors);\r\n  }\r\n\r\n  /** Indicates whether the prepared statement makes no **direct* changes to the content of the file\r\n   * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.\r\n   */\r\n  public get isReadonly(): boolean {\r\n    return this._stmt!.isReadonly();\r\n  }\r\n\r\n  /** Reset this statement so that the next call to step will return the first row, if any.\r\n   */\r\n  public reset(): void {\r\n    this._stmt!.reset();\r\n  }\r\n\r\n  /** Call this function when finished with this statement. This releases the native resources held by the statement. */\r\n  public dispose(): void {\r\n    if (this._stmt) {\r\n      this._stmt.dispose(); // free native statement\r\n      this._stmt = undefined;\r\n    }\r\n  }\r\n\r\n  /** Binds a value to the specified SQL parameter.\r\n   *  The value must be of one of these types:\r\n   *  JavaScript Type | SQLite Type\r\n   *  --- | ---\r\n   *  undefined | NULL\r\n   *  boolean | INTEGER with true being bound as 1 and false as 0\r\n   *  number | INTEGER if number is integral or REAL if number is not integral\r\n   *  string | TEXT\r\n   *  Uint8Array or ArrayBuffer | BLOB\r\n   *  [StringParam]($backend) where member **id** is set | INTEGER\r\n   *  [StringParam]($backend) where member **guid** is set | BLOB\r\n   *\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param value Value to bind.\r\n   *  @throws [IModelError]($common) if the value is of an unsupported type or in\r\n   *  case of other binding errors.\r\n   */\r\n  public bindValue(parameter: BindParameter, value: any): void {\r\n    let stat: DbResult;\r\n    if (value === undefined || value === null) {\r\n      stat = this._stmt!.bindNull(parameter);\r\n    } else if (typeof (value) === \"number\") {\r\n      if (Number.isInteger(value))\r\n        stat = this._stmt!.bindInteger(parameter, value);\r\n      else\r\n        stat = this._stmt!.bindDouble(parameter, value);\r\n    } else if (typeof (value) === \"boolean\") {\r\n      stat = this._stmt!.bindInteger(parameter, value ? 1 : 0);\r\n    } else if (typeof (value) === \"string\") {\r\n      stat = this._stmt!.bindString(parameter, value);\r\n    } else if (!!value.id) {\r\n      stat = this._stmt!.bindId(parameter, value.id);\r\n    } else if (!!value.guid) {\r\n      stat = this._stmt!.bindGuid(parameter, value.guid);\r\n    } else if (value instanceof Uint8Array) {\r\n      stat = this._stmt!.bindBlob(parameter, value);\r\n    } else\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Parameter value ${value} is of an unsupported data type.`);\r\n\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in bindValue\");\r\n  }\r\n\r\n  private checkBind(stat: DbResult) {\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"SQLite Bind error\");\r\n  }\r\n  /** Bind an integer parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val integer to bind.\r\n   */\r\n  public bindInteger(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindInteger(parameter, val));\r\n  }\r\n  /** Bind a double parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val double to bind.\r\n   */\r\n  public bindDouble(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindDouble(parameter, val));\r\n  }\r\n  /** Bind a string parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val string to bind.\r\n   */\r\n  public bindString(parameter: BindParameter, val: string) {\r\n    this.checkBind(this._stmt!.bindString(parameter, val));\r\n  }\r\n  /** Bind an Id64String parameter as a 64-bit integer\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Id to bind.\r\n   */\r\n  public bindId(parameter: BindParameter, id: Id64String) {\r\n    this.checkBind(this._stmt!.bindId(parameter, id));\r\n  }\r\n  /** Bind a Guid parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Guid to bind.\r\n   */\r\n  public bindGuid(parameter: BindParameter, guid: GuidString) {\r\n    this.checkBind(this._stmt!.bindGuid(parameter, guid));\r\n  }\r\n  /** Bind a blob parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val blob to bind.\r\n   */\r\n  public bindBlob(parameter: BindParameter, blob: Uint8Array) {\r\n    this.checkBind(this._stmt!.bindBlob(parameter, blob));\r\n  }\r\n\r\n  /** Bind values to all parameters in the statement.\r\n   * @param values The values to bind to the parameters.\r\n   * Pass an *array* of values if the parameters are *positional*.\r\n   * Pass an *object of the values keyed on the parameter name* for *named parameters*.\r\n   * The values in either the array or object must match the respective types of the parameter.\r\n   * See [[SqliteStatement.bindValue]] for details on the supported types.\r\n   */\r\n  public bindValues(values: any[] | object): void {\r\n    if (Array.isArray(values)) {\r\n      for (let i = 0; i < values.length; i++) {\r\n        const paramIndex: number = i + 1;\r\n        const paramValue: any = values[i];\r\n        if (paramValue === undefined || paramValue === null)\r\n          continue;\r\n\r\n        this.bindValue(paramIndex, paramValue);\r\n      }\r\n      return;\r\n    }\r\n\r\n    for (const entry of Object.entries(values)) {\r\n      const paramName: string = entry[0];\r\n      const paramValue: any = entry[1];\r\n      if (paramValue === undefined || paramValue === null)\r\n        continue;\r\n\r\n      this.bindValue(paramName, paramValue);\r\n    }\r\n  }\r\n\r\n  /** Clear any bindings that were previously set on this statement.\r\n   * @throws [IModelError]($common) in case of errors\r\n   */\r\n  public clearBindings(): void {\r\n    const stat = this._stmt!.clearBindings();\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in clearBindings\");\r\n  }\r\n\r\n  /** Step this statement to the next row.\r\n   *\r\n   *  For **SQL SELECT** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_ROW]($core-bentley) if the statement now points successfully to the next row.\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has no more rows.\r\n   *  - Error status in case of errors.\r\n   *\r\n   *  For **SQL INSERT, UPDATE, DELETE** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.\r\n   *  - Error status in case of errors.\r\n   */\r\n  public step(): DbResult { return this._stmt!.step(); }\r\n\r\n  /** Get the query result's column count (only for SQL SELECT statements). */\r\n  public getColumnCount(): number { return this._stmt!.getColumnCount(); }\r\n\r\n  /** Get the value for the column at the given index in the query result.\r\n   * @param columnIx Index of SQL column in query result (0-based)\r\n   */\r\n  public getValue(columnIx: number): SqliteValue { return new SqliteValue(this._stmt!, columnIx); }\r\n\r\n  /** Get a value as a blob\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getValueBlob(colIndex: number): Uint8Array { return this._stmt!.getValueBlob(colIndex); }\r\n  /** Get a value as a double\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueDouble(colIndex: number): number { return this._stmt!.getValueDouble(colIndex); }\r\n  /** Get a value as a integer\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueInteger(colIndex: number): number { return this._stmt!.getValueInteger(colIndex); }\r\n  /** Get a value as a string\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueString(colIndex: number): string { return this._stmt!.getValueString(colIndex); }\r\n  /** Get a value as an Id\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueId(colIndex: number): Id64String { return this._stmt!.getValueId(colIndex); }\r\n  /** Get a value as a Guid\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueGuid(colIndex: number): GuidString { return this._stmt!.getValueGuid(colIndex); }\r\n\r\n  /** Get the current row.\r\n   * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.\r\n   *\r\n   * The SQL select clause item's name becomes the member name of the JavaScript object, **with the first character lowered**.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public getRow(): any {\r\n    const colCount = this.getColumnCount();\r\n    const row: object = {};\r\n    const duplicatePropNames = new Map<string, number>();\r\n    for (let i = 0; i < colCount; i++) {\r\n      const sqliteValue = this.getValue(i);\r\n      if (!sqliteValue.isNull) {\r\n        const propName: string = SqliteStatement.determineResultRowPropertyName(duplicatePropNames, sqliteValue);\r\n        let val: any;\r\n        switch (sqliteValue.type) {\r\n          case SqliteValueType.Blob:\r\n            val = sqliteValue.getBlob();\r\n            break;\r\n          case SqliteValueType.Double:\r\n            val = sqliteValue.getDouble();\r\n            break;\r\n          case SqliteValueType.Integer:\r\n            val = sqliteValue.getInteger();\r\n            break;\r\n          case SqliteValueType.String:\r\n            val = sqliteValue.getString();\r\n            break;\r\n\r\n          default:\r\n            throw new Error(\"Unsupported SqliteValueType\");\r\n        }\r\n\r\n        Object.defineProperty(row, propName, { enumerable: true, configurable: true, writable: true, value: val });\r\n      }\r\n    }\r\n    return row;\r\n  }\r\n\r\n  private static determineResultRowPropertyName(duplicatePropNames: Map<string, number>, sqliteValue: SqliteValue): string {\r\n    let jsName = ECJsNames.toJsName(sqliteValue.columnName);\r\n\r\n    // now check duplicates. If there are, append a numeric suffix to the duplicates\r\n    let suffix = duplicatePropNames.get(jsName);\r\n    if (suffix === undefined)\r\n      duplicatePropNames.set(jsName, 0);\r\n    else {\r\n      suffix++;\r\n      duplicatePropNames.set(jsName, suffix);\r\n      jsName += `_${suffix}`;\r\n    }\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Calls step when called as an iterator.\r\n   */\r\n  public next(): IteratorResult<any> {\r\n    return DbResult.BE_SQLITE_ROW === this.step() ? { done: false, value: this.getRow() } : { done: true, value: undefined };\r\n  }\r\n\r\n  /** The iterator that will step through the results of this statement. */\r\n  public [Symbol.iterator](): IterableIterator<any> { return this; }\r\n}\r\n\r\n/** Data type of a value in in an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteValue]($backend)\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport enum SqliteValueType {\r\n  // do not change the values of that enum. It must correspond to the respective\r\n  // enum DbValueType in the native BeSQLite API.\r\n  Integer = 1,\r\n  Double = 2,\r\n  String = 3,\r\n  Blob = 4,\r\n  Null = 5,\r\n}\r\n\r\n/** Value of a column in a row of an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport class SqliteValue {\r\n  private readonly _stmt: IModelJsNative.SqliteStatement;\r\n  private readonly _colIndex: number;\r\n\r\n  public constructor(stmt: IModelJsNative.SqliteStatement, colIndex: number) {\r\n    this._stmt = stmt;\r\n    this._colIndex = colIndex;\r\n  }\r\n\r\n  /** Indicates whether the value is NULL or not. */\r\n  public get isNull(): boolean { return this._stmt.isValueNull(this._colIndex); }\r\n\r\n  /** Gets the data type of the value. */\r\n  public get type(): SqliteValueType { return this._stmt.getColumnType(this._colIndex); }\r\n\r\n  /** Gets the name of the column of the value. */\r\n  public get columnName(): string { return this._stmt.getColumnName(this._colIndex); }\r\n\r\n  /** Gets the SqlValue as JavaScript value.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public get value(): any {\r\n    switch (this.type) {\r\n      case SqliteValueType.Null:\r\n        return undefined;\r\n      case SqliteValueType.Blob:\r\n        return this.getBlob();\r\n      case SqliteValueType.Double:\r\n        return this.getDouble();\r\n      case SqliteValueType.Integer:\r\n        return this.getInteger();\r\n      case SqliteValueType.String:\r\n        return this.getString();\r\n      default:\r\n        throw new Error(\"Unhandled SqliteValueType\");\r\n    }\r\n  }\r\n\r\n  /** Get the value as BLOB */\r\n  public getBlob(): Uint8Array { return this._stmt.getValueBlob(this._colIndex); }\r\n  /** Get the value as a double value */\r\n  public getDouble(): number { return this._stmt.getValueDouble(this._colIndex); }\r\n  /** Get the value as a integer value */\r\n  public getInteger(): number { return this._stmt.getValueInteger(this._colIndex); }\r\n  /** Get the value as a string value */\r\n  public getString(): string { return this._stmt.getValueString(this._colIndex); }\r\n  /** Get the value as an Id value */\r\n  public getId(): Id64String { return this._stmt.getValueId(this._colIndex); }\r\n  /** Get the value as a Guid value */\r\n  public getGuid(): GuidString { return this._stmt.getValueGuid(this._colIndex); }\r\n}\r\n\r\ninterface Statement {\r\n  isPrepared: boolean;\r\n  sql: string;\r\n  dispose(): void;\r\n  reset(): void;\r\n  clearBindings(): void;\r\n}\r\n\r\n/** A cache for previously prepared SqliteStatements.\r\n * It only holds Statements after they are no longer in use, resetting and clearing their bindings before saving them.\r\n * When a request to use a statement from the cache is made, it is first removed from the cache.\r\n * @internal\r\n */\r\nexport class StatementCache<Stmt extends Statement> {\r\n  private _cache: LRUMap<string, Stmt>;\r\n\r\n  public constructor(maxCount = 40) {\r\n    this._cache = new LRUMap<string, Stmt>(maxCount);\r\n  }\r\n\r\n  public get size() { return this._cache.size; }\r\n  public addOrDispose(stmt: Stmt): void {\r\n    assert(stmt.isPrepared);\r\n\r\n    const existing = this._cache.get(stmt.sql);\r\n    if (existing !== undefined) {\r\n      stmt.dispose(); // we already have a statement with this sql cached, we can't save another one so just dispose it\r\n      return;\r\n    }\r\n    if (this._cache.size >= this._cache.limit) {\r\n      const oldest = this._cache.shift()!;\r\n      oldest[1].dispose();\r\n    }\r\n    stmt.reset();\r\n    stmt.clearBindings();\r\n    this._cache.set(stmt.sql, stmt);\r\n  }\r\n\r\n  public findAndRemove(sql: string): Stmt | undefined {\r\n    return this._cache.delete(sql);\r\n  }\r\n\r\n  public clear() {\r\n    this._cache.forEach((stmt) => stmt.dispose());\r\n    this._cache.clear();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SqliteStatement.js","sourceRoot":"","sources":["../../src/SqliteStatement.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 SQLite\r\n */\r\n\r\nimport { assert, DbResult, GuidString, Id64String, IDisposable, LRUMap } from \"@itwin/core-bentley\";\r\nimport { ECJsNames, IModelError } from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/* eslint-disable @typescript-eslint/no-non-null-assertion */\r\n\r\n/** Marks a string as either an [Id64String]($core-bentley) or [GuidString]($core-bentley), so\r\n * that it can be passed to the [bindValue]($backend.SqliteStatement) or [bindValues]($backend.SqliteStatement)\r\n * methods of [SqliteStatement]($backend).\r\n * @internal\r\n */\r\nexport interface StringParam {\r\n  id?: Id64String;\r\n  guid?: GuidString;\r\n}\r\n\r\n/** parameter Index (1-based), or name of the parameter (including the initial ':', '@' or '$')\r\n * @public\r\n */\r\nexport type BindParameter = number | string;\r\n\r\n/** Executes SQLite SQL statements.\r\n *\r\n * A statement must be prepared before it can be executed, and it must be released when no longer needed.\r\n * See [IModelDb.withPreparedSqliteStatement]($backend) or\r\n * [ECDb.withPreparedSqliteStatement]($backend) for a convenient and\r\n * reliable way to prepare, execute, and then release a statement.\r\n *\r\n * A statement may contain parameters that must be filled in before use by calling [SqliteStatement.bindValue]($backend)\r\n * or [SqliteStatement.bindValues]($backend).\r\n *\r\n * Once prepared (and parameters are bound, if any), the statement is executed by calling [SqliteStatement.step]($backend).\r\n * In case of an **SQL SELECT** statement, the current row can be retrieved with [SqliteStatement.getRow]($backend) as\r\n * a whole, or with [SqliteStatement.getValue]($backend) when individual values are needed.\r\n * Alternatively, query results of an **SQL SELECT** statement can be stepped through by using\r\n * standard iteration syntax, such as `for of`.\r\n *\r\n * > Preparing a statement can be time-consuming. The best way to reduce the effect of this overhead is to cache and reuse prepared\r\n * > statements. A cached prepared statement may be used in different places in an app, as long as the statement is general enough.\r\n * > The key to making this strategy work is to phrase a statement in a general way and use placeholders to represent parameters that will vary on each use.\r\n * @public\r\n */\r\nexport class SqliteStatement implements IterableIterator<any>, IDisposable {\r\n  private _stmt: IModelJsNative.SqliteStatement | undefined;\r\n\r\n  public constructor(private _sql: string) { }\r\n  public get stmt() { return this._stmt; }\r\n  public get sql() { return this._sql; }\r\n\r\n  /** Check if this statement has been prepared successfully or not */\r\n  public get isPrepared(): boolean { return undefined !== this._stmt; }\r\n\r\n  /** Prepare this statement prior to first use.\r\n   * @param db The DgnDb or ECDb to prepare the statement against\r\n   * @param sql The SQL statement string to prepare\r\n   * @param logErrors Determine if errors are logged or not\r\n   * @throws if the SQL statement cannot be prepared. Normally, prepare fails due to SQL syntax errors or references to tables or properties that do not exist.\r\n   * The error.message property will provide details.\r\n   */\r\n  public prepare(db: IModelJsNative.DgnDb | IModelJsNative.ECDb | IModelJsNative.SQLiteDb, logErrors = true): void {\r\n    if (this.isPrepared)\r\n      throw new Error(\"SqliteStatement is already prepared\");\r\n    this._stmt = new IModelHost.platform.SqliteStatement();\r\n    this._stmt.prepare(db, this._sql, logErrors);\r\n  }\r\n\r\n  /** Indicates whether the prepared statement makes no **direct* changes to the content of the file\r\n   * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.\r\n   */\r\n  public get isReadonly(): boolean {\r\n    return this._stmt!.isReadonly();\r\n  }\r\n\r\n  /** Reset this statement so that the next call to step will return the first row, if any.\r\n   */\r\n  public reset(): void {\r\n    this._stmt!.reset();\r\n  }\r\n\r\n  /** Call this function when finished with this statement. This releases the native resources held by the statement. */\r\n  public dispose(): void {\r\n    if (this._stmt) {\r\n      this._stmt.dispose(); // free native statement\r\n      this._stmt = undefined;\r\n    }\r\n  }\r\n\r\n  /** Binds a value to the specified SQL parameter.\r\n   *  The value must be of one of these types:\r\n   *  JavaScript Type | SQLite Type\r\n   *  --- | ---\r\n   *  undefined | NULL\r\n   *  boolean | INTEGER with true being bound as 1 and false as 0\r\n   *  number | INTEGER if number is integral or REAL if number is not integral\r\n   *  string | TEXT\r\n   *  Uint8Array or ArrayBuffer | BLOB\r\n   *  [StringParam]($backend) where member **id** is set | INTEGER\r\n   *  [StringParam]($backend) where member **guid** is set | BLOB\r\n   *\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param value Value to bind.\r\n   *  @throws [IModelError]($common) if the value is of an unsupported type or in\r\n   *  case of other binding errors.\r\n   */\r\n  public bindValue(parameter: BindParameter, value: any): void {\r\n    let stat: DbResult;\r\n    if (value === undefined || value === null) {\r\n      stat = this._stmt!.bindNull(parameter);\r\n    } else if (typeof (value) === \"number\") {\r\n      if (Number.isInteger(value))\r\n        stat = this._stmt!.bindInteger(parameter, value);\r\n      else\r\n        stat = this._stmt!.bindDouble(parameter, value);\r\n    } else if (typeof (value) === \"boolean\") {\r\n      stat = this._stmt!.bindInteger(parameter, value ? 1 : 0);\r\n    } else if (typeof (value) === \"string\") {\r\n      stat = this._stmt!.bindString(parameter, value);\r\n    } else if (!!value.id) {\r\n      stat = this._stmt!.bindId(parameter, value.id);\r\n    } else if (!!value.guid) {\r\n      stat = this._stmt!.bindGuid(parameter, value.guid);\r\n    } else if (value instanceof Uint8Array) {\r\n      stat = this._stmt!.bindBlob(parameter, value);\r\n    } else\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Parameter value ${value} is of an unsupported data type.`);\r\n\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in bindValue\");\r\n  }\r\n\r\n  private checkBind(stat: DbResult) {\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"SQLite Bind error\");\r\n  }\r\n  /** Bind an integer parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val integer to bind.\r\n   */\r\n  public bindInteger(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindInteger(parameter, val));\r\n  }\r\n  /** Bind a double parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val double to bind.\r\n   */\r\n  public bindDouble(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindDouble(parameter, val));\r\n  }\r\n  /** Bind a string parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val string to bind.\r\n   */\r\n  public bindString(parameter: BindParameter, val: string) {\r\n    this.checkBind(this._stmt!.bindString(parameter, val));\r\n  }\r\n  /** Bind an Id64String parameter as a 64-bit integer\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Id to bind.\r\n   */\r\n  public bindId(parameter: BindParameter, id: Id64String) {\r\n    this.checkBind(this._stmt!.bindId(parameter, id));\r\n  }\r\n  /** Bind a Guid parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Guid to bind.\r\n   */\r\n  public bindGuid(parameter: BindParameter, guid: GuidString) {\r\n    this.checkBind(this._stmt!.bindGuid(parameter, guid));\r\n  }\r\n  /** Bind a blob parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val blob to bind.\r\n   */\r\n  public bindBlob(parameter: BindParameter, blob: Uint8Array) {\r\n    this.checkBind(this._stmt!.bindBlob(parameter, blob));\r\n  }\r\n\r\n  /** Bind values to all parameters in the statement.\r\n   * @param values The values to bind to the parameters.\r\n   * Pass an *array* of values if the parameters are *positional*.\r\n   * Pass an *object of the values keyed on the parameter name* for *named parameters*.\r\n   * The values in either the array or object must match the respective types of the parameter.\r\n   * See [[SqliteStatement.bindValue]] for details on the supported types.\r\n   */\r\n  public bindValues(values: any[] | object): void {\r\n    if (Array.isArray(values)) {\r\n      for (let i = 0; i < values.length; i++) {\r\n        const paramIndex: number = i + 1;\r\n        const paramValue: any = values[i];\r\n        if (paramValue === undefined || paramValue === null)\r\n          continue;\r\n\r\n        this.bindValue(paramIndex, paramValue);\r\n      }\r\n      return;\r\n    }\r\n\r\n    for (const entry of Object.entries(values)) {\r\n      const paramName: string = entry[0];\r\n      const paramValue: any = entry[1];\r\n      if (paramValue === undefined || paramValue === null)\r\n        continue;\r\n\r\n      this.bindValue(paramName, paramValue);\r\n    }\r\n  }\r\n\r\n  /** Clear any bindings that were previously set on this statement.\r\n   * @throws [IModelError]($common) in case of errors\r\n   */\r\n  public clearBindings(): void {\r\n    const stat = this._stmt!.clearBindings();\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in clearBindings\");\r\n  }\r\n\r\n  /** Step this statement to the next row.\r\n   *\r\n   *  For **SQL SELECT** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_ROW]($core-bentley) if the statement now points successfully to the next row.\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has no more rows.\r\n   *  - Error status in case of errors.\r\n   *\r\n   *  For **SQL INSERT, UPDATE, DELETE** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.\r\n   *  - Error status in case of errors.\r\n   */\r\n  public step(): DbResult { return this._stmt!.step(); }\r\n\r\n  /** Get the query result's column count (only for SQL SELECT statements). */\r\n  public getColumnCount(): number { return this._stmt!.getColumnCount(); }\r\n\r\n  /** Get the value for the column at the given index in the query result.\r\n   * @param columnIx Index of SQL column in query result (0-based)\r\n   */\r\n  public getValue(columnIx: number): SqliteValue { return new SqliteValue(this._stmt!, columnIx); }\r\n\r\n  /** Get a value as a blob\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getValueBlob(colIndex: number): Uint8Array { return this._stmt!.getValueBlob(colIndex); }\r\n  /** Get a value as a double\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueDouble(colIndex: number): number { return this._stmt!.getValueDouble(colIndex); }\r\n  /** Get a value as a integer\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueInteger(colIndex: number): number { return this._stmt!.getValueInteger(colIndex); }\r\n  /** Get a value as a string\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueString(colIndex: number): string { return this._stmt!.getValueString(colIndex); }\r\n  /** Get a value as an Id\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueId(colIndex: number): Id64String { return this._stmt!.getValueId(colIndex); }\r\n  /** Get a value as a Guid\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueGuid(colIndex: number): GuidString { return this._stmt!.getValueGuid(colIndex); }\r\n\r\n  /** Get the current row.\r\n   * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.\r\n   *\r\n   * The SQL select clause item's name becomes the member name of the JavaScript object, **with the first character lowered**.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public getRow(): any {\r\n    const colCount = this.getColumnCount();\r\n    const row: object = {};\r\n    const duplicatePropNames = new Map<string, number>();\r\n    for (let i = 0; i < colCount; i++) {\r\n      const sqliteValue = this.getValue(i);\r\n      if (!sqliteValue.isNull) {\r\n        const propName: string = SqliteStatement.determineResultRowPropertyName(duplicatePropNames, sqliteValue);\r\n        let val: any;\r\n        switch (sqliteValue.type) {\r\n          case SqliteValueType.Blob:\r\n            val = sqliteValue.getBlob();\r\n            break;\r\n          case SqliteValueType.Double:\r\n            val = sqliteValue.getDouble();\r\n            break;\r\n          case SqliteValueType.Integer:\r\n            val = sqliteValue.getInteger();\r\n            break;\r\n          case SqliteValueType.String:\r\n            val = sqliteValue.getString();\r\n            break;\r\n\r\n          default:\r\n            throw new Error(\"Unsupported SqliteValueType\");\r\n        }\r\n\r\n        Object.defineProperty(row, propName, { enumerable: true, configurable: true, writable: true, value: val });\r\n      }\r\n    }\r\n    return row;\r\n  }\r\n\r\n  private static determineResultRowPropertyName(duplicatePropNames: Map<string, number>, sqliteValue: SqliteValue): string {\r\n    let jsName = ECJsNames.toJsName(sqliteValue.columnName);\r\n\r\n    // now check duplicates. If there are, append a numeric suffix to the duplicates\r\n    let suffix = duplicatePropNames.get(jsName);\r\n    if (suffix === undefined)\r\n      duplicatePropNames.set(jsName, 0);\r\n    else {\r\n      suffix++;\r\n      duplicatePropNames.set(jsName, suffix);\r\n      jsName += `_${suffix}`;\r\n    }\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Calls step when called as an iterator.\r\n   */\r\n  public next(): IteratorResult<any> {\r\n    return DbResult.BE_SQLITE_ROW === this.step() ? { done: false, value: this.getRow() } : { done: true, value: undefined };\r\n  }\r\n\r\n  /** The iterator that will step through the results of this statement. */\r\n  public [Symbol.iterator](): IterableIterator<any> { return this; }\r\n}\r\n\r\n/** Data type of a value in in an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteValue]($backend)\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport enum SqliteValueType {\r\n  // do not change the values of that enum. It must correspond to the respective\r\n  // enum DbValueType in the native BeSQLite API.\r\n  Integer = 1,\r\n  Double = 2,\r\n  String = 3,\r\n  Blob = 4,\r\n  Null = 5,\r\n}\r\n\r\n/** Value of a column in a row of an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport class SqliteValue {\r\n  private readonly _stmt: IModelJsNative.SqliteStatement;\r\n  private readonly _colIndex: number;\r\n\r\n  public constructor(stmt: IModelJsNative.SqliteStatement, colIndex: number) {\r\n    this._stmt = stmt;\r\n    this._colIndex = colIndex;\r\n  }\r\n\r\n  /** Indicates whether the value is NULL or not. */\r\n  public get isNull(): boolean { return this._stmt.isValueNull(this._colIndex); }\r\n\r\n  /** Gets the data type of the value. */\r\n  public get type(): SqliteValueType { return this._stmt.getColumnType(this._colIndex); }\r\n\r\n  /** Gets the name of the column of the value. */\r\n  public get columnName(): string { return this._stmt.getColumnName(this._colIndex); }\r\n\r\n  /** Gets the SqlValue as JavaScript value.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public get value(): any {\r\n    switch (this.type) {\r\n      case SqliteValueType.Null:\r\n        return undefined;\r\n      case SqliteValueType.Blob:\r\n        return this.getBlob();\r\n      case SqliteValueType.Double:\r\n        return this.getDouble();\r\n      case SqliteValueType.Integer:\r\n        return this.getInteger();\r\n      case SqliteValueType.String:\r\n        return this.getString();\r\n      default:\r\n        throw new Error(\"Unhandled SqliteValueType\");\r\n    }\r\n  }\r\n\r\n  /** Get the value as BLOB */\r\n  public getBlob(): Uint8Array { return this._stmt.getValueBlob(this._colIndex); }\r\n  /** Get the value as a double value */\r\n  public getDouble(): number { return this._stmt.getValueDouble(this._colIndex); }\r\n  /** Get the value as a integer value */\r\n  public getInteger(): number { return this._stmt.getValueInteger(this._colIndex); }\r\n  /** Get the value as a string value */\r\n  public getString(): string { return this._stmt.getValueString(this._colIndex); }\r\n  /** Get the value as an Id value */\r\n  public getId(): Id64String { return this._stmt.getValueId(this._colIndex); }\r\n  /** Get the value as a Guid value */\r\n  public getGuid(): GuidString { return this._stmt.getValueGuid(this._colIndex); }\r\n}\r\n\r\ninterface Statement {\r\n  isPrepared: boolean;\r\n  sql: string;\r\n  dispose(): void;\r\n  reset(): void;\r\n  clearBindings(): void;\r\n}\r\n\r\n/** A cache for previously prepared SqliteStatements.\r\n * It only holds Statements after they are no longer in use, resetting and clearing their bindings before saving them.\r\n * When a request to use a statement from the cache is made, it is first removed from the cache.\r\n * @internal\r\n */\r\nexport class StatementCache<Stmt extends Statement> {\r\n  private _cache: LRUMap<string, Stmt>;\r\n\r\n  public constructor(maxCount = 40) {\r\n    this._cache = new LRUMap<string, Stmt>(maxCount);\r\n  }\r\n\r\n  public get size() { return this._cache.size; }\r\n  public addOrDispose(stmt: Stmt): void {\r\n    assert(stmt.isPrepared);\r\n\r\n    const existing = this._cache.get(stmt.sql);\r\n    if (existing !== undefined) {\r\n      stmt.dispose(); // we already have a statement with this sql cached, we can't save another one so just dispose it\r\n      return;\r\n    }\r\n    if (this._cache.size >= this._cache.limit) {\r\n      const oldest = this._cache.shift()!;\r\n      oldest[1].dispose();\r\n    }\r\n    stmt.reset();\r\n    stmt.clearBindings();\r\n    this._cache.set(stmt.sql, stmt);\r\n  }\r\n\r\n  public findAndRemove(sql: string): Stmt | undefined {\r\n    return this._cache.delete(sql);\r\n  }\r\n\r\n  public clear() {\r\n    this._cache.forEach((stmt) => stmt.dispose());\r\n    this._cache.clear();\r\n  }\r\n}\r\n"]}

package/lib/cjs/Texture.js

@@ -76,7 +76,7 @@ class Texture extends Element_1.DefinitionElement {
      */
     static insertTexture(iModelDb, definitionModelId, name, format, data, description) {
         const texture = this.createTexture(iModelDb, definitionModelId, name, format, data, description);
-        return iModelDb.elements.insertElement(texture);
+        return iModelDb.elements.insertElement(texture.toJSON());
     }
 }
 exports.Texture = Texture;

package/lib/cjs/Texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,oDAE4B;AAC5B,uCAA8C;AAW9C;;GAEG;AACH,MAAa,OAAQ,SAAQ,2BAAiB;IAO5C,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB;QACrD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,iCAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACvG,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IAZD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,SAAS,CAAC,CAAC,CAAC;IAapE,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAkB,CAAC;QAC3C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,IAAI,GAAG,iCAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,IAAY;QACnF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,YAAY,GAAuB;YACvC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,MAAM;YACN,IAAI;YACJ,WAAW;YACX,KAAK,EAAE,iBAAiB;YACxB,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACjG,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;CACF;AA1ED,0BA0EC","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 Elements\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  Base64EncodedString, BisCodeSpec, Code, CodeScopeProps, CodeSpec, ImageSourceFormat, TextureProps,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.\r\n * @see [[Texture]] constructor.\r\n * @internal\r\n */\r\nexport interface TextureCreateProps extends Omit<TextureProps, \"data\"> {\r\n  data: Base64EncodedString | Uint8Array;\r\n}\r\n\r\n/** Defines a rendering texture that is associated with a Material and applied to surface geometry.\r\n * @public\r\n */\r\nexport class Texture extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"Texture\"; }\r\n  public format: ImageSourceFormat;\r\n  public data: Uint8Array;\r\n  public description?: string;\r\n\r\n  /** @internal */\r\n  constructor(props: TextureCreateProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.format = props.format;\r\n    this.data = typeof props.data === \"string\" ? Base64EncodedString.toUint8Array(props.data) : props.data;\r\n    this.description = props.description;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): TextureProps {\r\n    const val = super.toJSON() as TextureProps;\r\n    val.format = this.format;\r\n    val.data = Base64EncodedString.fromUint8Array(this.data);\r\n    val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Create a Code for a Texture given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the Texture and provides the scope for its name.\r\n   * @param name The Texture name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.texture);\r\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\r\n  }\r\n\r\n  /** Create a texture with the given parameters.\r\n   * @param iModelDb The iModel to contain the texture.\r\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\r\n   * @param name The name to serve as the texture's [Code]($common) value.\r\n   * @param format The format of the image data.\r\n   * @param data The image data in the format specified by `format`.\r\n   * @param description An optional description of the texture\r\n   * @returns The newly constructed Texture element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   * @see [[insertTexture]] to insert a new texture into the iModel.\r\n   */\r\n  public static createTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Texture {\r\n    const textureProps: TextureCreateProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      format,\r\n      data,\r\n      description,\r\n      model: definitionModelId,\r\n      isPrivate: false,\r\n    };\r\n\r\n    return new Texture(textureProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a new texture into a [[DefinitionModel]].\r\n   * @param iModelDb The iModel to contain the texture.\r\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\r\n   * @param name The name to serve as the texture's [Code]($common) value.\r\n   * @param format The format of the image data.\r\n   * @param data The image data in the format specified by `format`.\r\n   * @param description An optional description of the texture\r\n   * @returns The Id of the newly-inserted texture element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @see [[insertTexture]] to insert a new texture into the iModel.\r\n   */\r\n  public static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String {\r\n    const texture = this.createTexture(iModelDb, definitionModelId, name, format, data, description);\r\n    return iModelDb.elements.insertElement(texture);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,oDAE4B;AAC5B,uCAA8C;AAW9C;;GAEG;AACH,MAAa,OAAQ,SAAQ,2BAAiB;IAO5C,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB;QACrD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,iCAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACvG,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IAZD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,SAAS,CAAC,CAAC,CAAC;IAapE,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAkB,CAAC;QAC3C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,IAAI,GAAG,iCAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,IAAY;QACnF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,YAAY,GAAuB;YACvC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,MAAM;YACN,IAAI;YACJ,WAAW;YACX,KAAK,EAAE,iBAAiB;YACxB,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACjG,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF;AA1ED,0BA0EC","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 Elements\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  Base64EncodedString, BisCodeSpec, Code, CodeScopeProps, CodeSpec, ImageSourceFormat, TextureProps,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.\r\n * @see [[Texture]] constructor.\r\n * @internal\r\n */\r\nexport interface TextureCreateProps extends Omit<TextureProps, \"data\"> {\r\n  data: Base64EncodedString | Uint8Array;\r\n}\r\n\r\n/** Defines a rendering texture that is associated with a Material and applied to surface geometry.\r\n * @public\r\n */\r\nexport class Texture extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"Texture\"; }\r\n  public format: ImageSourceFormat;\r\n  public data: Uint8Array;\r\n  public description?: string;\r\n\r\n  /** @internal */\r\n  constructor(props: TextureCreateProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.format = props.format;\r\n    this.data = typeof props.data === \"string\" ? Base64EncodedString.toUint8Array(props.data) : props.data;\r\n    this.description = props.description;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): TextureProps {\r\n    const val = super.toJSON() as TextureProps;\r\n    val.format = this.format;\r\n    val.data = Base64EncodedString.fromUint8Array(this.data);\r\n    val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Create a Code for a Texture given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the Texture and provides the scope for its name.\r\n   * @param name The Texture name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.texture);\r\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\r\n  }\r\n\r\n  /** Create a texture with the given parameters.\r\n   * @param iModelDb The iModel to contain the texture.\r\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\r\n   * @param name The name to serve as the texture's [Code]($common) value.\r\n   * @param format The format of the image data.\r\n   * @param data The image data in the format specified by `format`.\r\n   * @param description An optional description of the texture\r\n   * @returns The newly constructed Texture element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   * @see [[insertTexture]] to insert a new texture into the iModel.\r\n   */\r\n  public static createTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Texture {\r\n    const textureProps: TextureCreateProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      format,\r\n      data,\r\n      description,\r\n      model: definitionModelId,\r\n      isPrivate: false,\r\n    };\r\n\r\n    return new Texture(textureProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a new texture into a [[DefinitionModel]].\r\n   * @param iModelDb The iModel to contain the texture.\r\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\r\n   * @param name The name to serve as the texture's [Code]($common) value.\r\n   * @param format The format of the image data.\r\n   * @param data The image data in the format specified by `format`.\r\n   * @param description An optional description of the texture\r\n   * @returns The Id of the newly-inserted texture element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @see [[insertTexture]] to insert a new texture into the iModel.\r\n   */\r\n  public static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String {\r\n    const texture = this.createTexture(iModelDb, definitionModelId, name, format, data, description);\r\n    return iModelDb.elements.insertElement(texture.toJSON());\r\n  }\r\n}\r\n"]}

package/lib/cjs/TxnManager.js

@@ -110,7 +110,7 @@ class ChangedEntitiesProc {
                 ? "SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements"
                 : "SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models";
             iModel.withPreparedSqliteStatement(select, (sql) => {
-                const stmt = sql.stmt;
+                const stmt = sql.stmt; // eslint-disable-line @typescript-eslint/no-non-null-assertion
                 while (sql.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
                     const id = stmt.getValueId(0);
                     const classId = stmt.getValueId(2);

package/lib/cjs/TxnManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxnManager.js","sourceRoot":"","sources":["../../src/TxnManager.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 iModels\r\n */\r\n\r\nimport {\r\n  assert, BeEvent, BentleyError, compareStrings, CompressedId64Set, DbResult, Id64Array, Id64String, IModelStatus, IndexMap, Logger, OrderedId64Array,\r\n} from \"@itwin/core-bentley\";\r\nimport { ChangedEntities, EntityIdAndClassIdIterable, ModelGeometryChangesProps, ModelIdAndGeometryGuid } from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BriefcaseDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IpcHost } from \"./IpcHost\";\r\nimport { Relationship, RelationshipProps } from \"./Relationship\";\r\nimport { SqliteStatement } from \"./SqliteStatement\";\r\n\r\n/** A string that identifies a Txn.\r\n * @public\r\n */\r\nexport type TxnIdString = string;\r\n\r\n/** An error generated during dependency validation.\r\n * @see [[TxnManager.validationErrors]].\r\n * @public\r\n */\r\nexport interface ValidationError {\r\n  /** If true, txn is aborted. */\r\n  fatal: boolean;\r\n  /** The type of error. */\r\n  errorType: string;\r\n  /** Optional description of what went wrong. */\r\n  message?: string;\r\n}\r\n\r\n/** Describes a set of [[Element]]s or [[Model]]s that changed as part of a transaction.\r\n * @see [[TxnManager.onElementsChanged]] and [[TxnManager.onModelsChanged]].\r\n * @public\r\n */\r\nexport interface TxnChangedEntities {\r\n  /** The entities that were inserted by the transaction. */\r\n  readonly inserts: EntityIdAndClassIdIterable;\r\n  /** The entities that were deleted by the transaction. */\r\n  readonly deletes: EntityIdAndClassIdIterable;\r\n  /** The entities that were modified by the transaction, including any [[Element]]s for which one of their [[ElementAspect]]s was changed. */\r\n  readonly updates: EntityIdAndClassIdIterable;\r\n}\r\n\r\ntype EntitiesChangedEvent = BeEvent<(changes: TxnChangedEntities) => void>;\r\n\r\n/** Strictly for tests. @internal */\r\nexport function setMaxEntitiesPerEvent(max: number): number {\r\n  const prevMax = ChangedEntitiesProc.maxPerEvent;\r\n  ChangedEntitiesProc.maxPerEvent = max;\r\n  return prevMax;\r\n}\r\n\r\n/** Maintains an ordered array of entity Ids and a parallel array containing the index of the corresponding entity's class Id. */\r\nclass ChangedEntitiesArray {\r\n  public readonly entityIds = new OrderedId64Array();\r\n  private readonly _classIndices: number[] = [];\r\n  private readonly _classIds: IndexMap<Id64String>;\r\n\r\n  public constructor(classIds: IndexMap<Id64String>) {\r\n    this._classIds = classIds;\r\n  }\r\n\r\n  public insert(entityId: Id64String, classId: Id64String): void {\r\n    const entityIndex = this.entityIds.insert(entityId);\r\n    const classIndex = this._classIds.insert(classId);\r\n    assert(classIndex >= 0);\r\n    if (this.entityIds.length !== this._classIndices.length) {\r\n      // New entity - insert corresponding class index entry.\r\n      this._classIndices.splice(entityIndex, 0, classIndex);\r\n    } else {\r\n      // Existing entity - update corresponding class index.\r\n      // (We do this because apparently connectors can (very rarely) change the class Id of an existing element).\r\n      this._classIndices[entityIndex] = classIndex;\r\n    }\r\n\r\n    assert(this.entityIds.length === this._classIndices.length);\r\n  }\r\n\r\n  public clear(): void {\r\n    this.entityIds.clear();\r\n    this._classIndices.length = 0;\r\n  }\r\n\r\n  public addToChangedEntities(entities: ChangedEntities, type: \"deleted\" | \"inserted\" | \"updated\"): void {\r\n    if (this.entityIds.length > 0)\r\n      entities[type] = CompressedId64Set.compressIds(this.entityIds);\r\n  }\r\n\r\n  public iterable(classIds: Id64Array): EntityIdAndClassIdIterable {\r\n    function* iterator(entityIds: ReadonlyArray<Id64String>, classIndices: number[]) {\r\n      const entity = { id: \"\", classId: \"\" };\r\n      for (let i = 0; i < entityIds.length; i++) {\r\n        entity.id = entityIds[i];\r\n        entity.classId = classIds[classIndices[i]];\r\n        yield entity;\r\n      }\r\n    }\r\n\r\n    return {\r\n      [Symbol.iterator]: () => iterator(this.entityIds.array, this._classIndices),\r\n    };\r\n  }\r\n}\r\n\r\nclass ChangedEntitiesProc {\r\n  private readonly _classIds = new IndexMap<Id64String>((lhs, rhs) => compareStrings(lhs, rhs));\r\n  private readonly _inserted = new ChangedEntitiesArray(this._classIds);\r\n  private readonly _deleted = new ChangedEntitiesArray(this._classIds);\r\n  private readonly _updated = new ChangedEntitiesArray(this._classIds);\r\n  private _currSize = 0;\r\n\r\n  public static maxPerEvent = 1000;\r\n\r\n  public static process(iModel: BriefcaseDb | StandaloneDb, mgr: TxnManager): void {\r\n    if (mgr.isDisposed) {\r\n      // The iModel is being closed. Do not prepare new sqlite statements.\r\n      return;\r\n    }\r\n\r\n    this.processChanges(iModel, mgr.onElementsChanged, \"notifyElementsChanged\");\r\n    this.processChanges(iModel, mgr.onModelsChanged, \"notifyModelsChanged\");\r\n  }\r\n\r\n  private sendEvent(iModel: BriefcaseDb | StandaloneDb, evt: EntitiesChangedEvent, evtName: \"notifyElementsChanged\" | \"notifyModelsChanged\") {\r\n    if (this._currSize === 0)\r\n      return;\r\n\r\n    const classIds = this._classIds.toArray();\r\n\r\n    // Notify backend listeners.\r\n    const txnEntities: TxnChangedEntities = {\r\n      inserts: this._inserted.iterable(classIds),\r\n      deletes: this._deleted.iterable(classIds),\r\n      updates: this._updated.iterable(classIds),\r\n    };\r\n    evt.raiseEvent(txnEntities);\r\n\r\n    // Notify frontend listeners.\r\n    const entities: ChangedEntities = {};\r\n    this._inserted.addToChangedEntities(entities, \"inserted\");\r\n    this._deleted.addToChangedEntities(entities, \"deleted\");\r\n    this._updated.addToChangedEntities(entities, \"updated\");\r\n    IpcHost.notifyTxns(iModel, evtName, entities);\r\n\r\n    // Reset state.\r\n    this._inserted.clear();\r\n    this._deleted.clear();\r\n    this._updated.clear();\r\n    this._classIds.clear();\r\n    this._currSize = 0;\r\n  }\r\n\r\n  private static processChanges(iModel: BriefcaseDb | StandaloneDb, changedEvent: EntitiesChangedEvent, evtName: \"notifyElementsChanged\" | \"notifyModelsChanged\") {\r\n    try {\r\n      const maxSize = this.maxPerEvent;\r\n      const changes = new ChangedEntitiesProc();\r\n      const select = \"notifyElementsChanged\" === evtName\r\n        ? \"SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements\"\r\n        : \"SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models\";\r\n      iModel.withPreparedSqliteStatement(select, (sql: SqliteStatement) => {\r\n        const stmt = sql.stmt!;\r\n        while (sql.step() === DbResult.BE_SQLITE_ROW) {\r\n          const id = stmt.getValueId(0);\r\n          const classId = stmt.getValueId(2);\r\n          switch (stmt.getValueInteger(1)) {\r\n            case 0:\r\n              changes._inserted.insert(id, classId);\r\n              break;\r\n            case 1:\r\n              changes._updated.insert(id, classId);\r\n              break;\r\n            case 2:\r\n              changes._deleted.insert(id, classId);\r\n              break;\r\n          }\r\n\r\n          if (++changes._currSize >= maxSize)\r\n            changes.sendEvent(iModel, changedEvent, evtName);\r\n        }\r\n      });\r\n\r\n      changes.sendEvent(iModel, changedEvent, evtName);\r\n    } catch (err) {\r\n      Logger.logError(BackendLoggerCategory.IModelDb, BentleyError.getErrorMessage(err));\r\n    }\r\n  }\r\n}\r\n\r\n/** Manages local changes to a [[BriefcaseDb]] or [[StandaloneDb]] via [Txns]($docs/learning/InteractiveEditing.md)\r\n * @public\r\n */\r\nexport class TxnManager {\r\n  /** @internal */\r\n  private _isDisposed = false;\r\n\r\n  /** @internal */\r\n  public get isDisposed(): boolean {\r\n    return this._isDisposed;\r\n  }\r\n\r\n  /** @internal */\r\n  constructor(private _iModel: BriefcaseDb | StandaloneDb) {\r\n    _iModel.onBeforeClose.addOnce(() => {\r\n      this._isDisposed = true;\r\n    });\r\n  }\r\n\r\n  /** Array of errors from dependency propagation */\r\n  public readonly validationErrors: ValidationError[] = [];\r\n\r\n  private get _nativeDb() { return this._iModel.nativeDb; }\r\n  private _getElementClass(elClassName: string): typeof Element {\r\n    return this._iModel.getJsClass(elClassName) as unknown as typeof Element;\r\n  }\r\n  private _getRelationshipClass(relClassName: string): typeof Relationship {\r\n    return this._iModel.getJsClass<typeof Relationship>(relClassName);\r\n  }\r\n  /** @internal */\r\n  protected _onBeforeOutputsHandled(elClassName: string, elId: Id64String): void {\r\n    (this._getElementClass(elClassName) as any).onBeforeOutputsHandled(elId, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onAllInputsHandled(elClassName: string, elId: Id64String): void {\r\n    (this._getElementClass(elClassName) as any).onAllInputsHandled(elId, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onRootChanged(props: RelationshipProps): void {\r\n    this._getRelationshipClass(props.classFullName).onRootChanged(props, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onDeletedDependency(props: RelationshipProps): void {\r\n    this._getRelationshipClass(props.classFullName).onDeletedDependency(props, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onBeginValidate() { this.validationErrors.length = 0; }\r\n\r\n  /** called from native code after validation of a Txn, either from saveChanges or apply changeset.\r\n   * @internal\r\n   */\r\n  protected _onEndValidate() {\r\n    ChangedEntitiesProc.process(this._iModel, this);\r\n    this.onEndValidation.raiseEvent();\r\n    // TODO: if (this.validationErrors.length !== 0) throw new IModelError(validation ...)\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onGeometryChanged(modelProps: ModelGeometryChangesProps[]) {\r\n    this.onGeometryChanged.raiseEvent(modelProps);\r\n    IpcHost.notifyEditingScope(this._iModel, \"notifyGeometryChanged\", modelProps); // send to frontend\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\r\n    this.onModelGeometryChanged.raiseEvent(changes);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyGeometryGuidsChanged\", changes);\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onCommit() {\r\n    this.onCommit.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyCommit\");\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onCommitted() {\r\n    this.onCommitted.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyCommitted\", this.hasPendingTxns, Date.now());\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onChangesApplied() {\r\n    ChangedEntitiesProc.process(this._iModel, this);\r\n    this.onChangesApplied.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyChangesApplied\");\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onBeforeUndoRedo(isUndo: boolean) {\r\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyBeforeUndoRedo\", isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onAfterUndoRedo(isUndo: boolean) {\r\n    this.onAfterUndoRedo.raiseEvent(isUndo);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyAfterUndoRedo\", isUndo);\r\n  }\r\n\r\n  /** Dependency handlers may call method this to report a validation error.\r\n   * @param error The error. If error.fatal === true, the transaction will cancel rather than commit.\r\n   */\r\n  public reportError(error: ValidationError) { this.validationErrors.push(error); this._nativeDb.logTxnError(error.fatal); }\r\n\r\n  /** Determine whether any fatal validation errors have occurred during dependency propagation.  */\r\n  public get hasFatalError(): boolean { return this._nativeDb.hasFatalTxnError(); }\r\n\r\n  /** @internal */\r\n  public readonly onEndValidation = new BeEvent<() => void>();\r\n\r\n  /** Called after validation completes from [[IModelDb.saveChanges]].\r\n   * The argument to the event holds the list of elements that were inserted, updated, and deleted.\r\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onElementsChanged = new BeEvent<(changes: TxnChangedEntities) => void>();\r\n\r\n  /** Called after validation completes from [[IModelDb.saveChanges]].\r\n   * The argument to the event holds the list of models that were inserted, updated, and deleted.\r\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onModelsChanged = new BeEvent<(changes: TxnChangedEntities) => void>();\r\n\r\n  /** Event raised after the geometry within one or more [[GeometricModel]]s is modified by applying a changeset or validation of a transaction.\r\n   * A model's geometry can change as a result of:\r\n   *  - Insertion or deletion of a geometric element within the model; or\r\n   *  - Modification of an existing element's geometric properties; or\r\n   *  - An explicit request to flag it as changed via [[IModelDb.Models.updateModel]].\r\n   */\r\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\r\n\r\n  public readonly onGeometryChanged = new BeEvent<(models: ModelGeometryChangesProps[]) => void>();\r\n  /** Event raised before a commit operation is performed. Initiated by a call to [[IModelDb.saveChanges]], unless there are no changes to save. */\r\n  public readonly onCommit = new BeEvent<() => void>();\r\n  /** Event raised after a commit operation has been performed. Initiated by a call to [[IModelDb.saveChanges]], even if there were no changes to save. */\r\n  public readonly onCommitted = new BeEvent<() => void>();\r\n  /** Event raised after a ChangeSet has been applied to this briefcase */\r\n  public readonly onChangesApplied = new BeEvent<() => void>();\r\n  /** Event raised before an undo/redo operation is performed. */\r\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n  /** Event raised after an undo/redo operation has been performed.\r\n   * @param _action The action that was performed.\r\n   */\r\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /**\r\n   * Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\r\n   * and reopened.)\r\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\r\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\r\n   * Probably a good idea to alert the user it happened.\r\n   */\r\n  public restartSession() {\r\n    this._nativeDb.restartTxnSession();\r\n  }\r\n\r\n  /** Determine whether current txn is propagating indirect changes or not. */\r\n  public get isIndirectChanges(): boolean { return this._nativeDb.isIndirectChanges(); }\r\n\r\n  /** Determine if there are currently any reversible (undoable) changes from this editing session. */\r\n  public get isUndoPossible(): boolean { return this._nativeDb.isUndoPossible(); }\r\n\r\n  /** Determine if there are currently any reinstatable (redoable) changes */\r\n  public get isRedoPossible(): boolean { return this._nativeDb.isRedoPossible(); }\r\n\r\n  /** Get the description of the operation that would be reversed by calling reverseTxns(1).\r\n   * This is useful for showing the operation that would be undone, for example in a menu.\r\n   */\r\n  public getUndoString(): string { return this._nativeDb.getUndoString(); }\r\n\r\n  /** Get a description of the operation that would be reinstated by calling reinstateTxn.\r\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\r\n   */\r\n  public getRedoString(): string { return this._nativeDb.getRedoString(); }\r\n\r\n  /** Begin a new multi-Txn operation. This can be used to cause a series of Txns that would normally\r\n   * be considered separate actions for undo to be grouped into a single undoable operation. This means that when reverseTxns(1) is called,\r\n   * the entire group of changes are undone together. Multi-Txn operations can be nested and until the outermost operation is closed\r\n   * all changes constitute a single operation.\r\n   * @note This method must always be paired with a call to endMultiTxnAction.\r\n   */\r\n  public beginMultiTxnOperation(): DbResult { return this._nativeDb.beginMultiTxnOperation(); }\r\n\r\n  /** End a multi-Txn operation */\r\n  public endMultiTxnOperation(): DbResult { return this._nativeDb.endMultiTxnOperation(); }\r\n\r\n  /** Return the depth of the multi-Txn stack. Generally for diagnostic use only. */\r\n  public getMultiTxnOperationDepth(): number { return this._nativeDb.getMultiTxnOperationDepth(); }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to this IModelDb.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if ReinstateTxn is called.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the operations are reversible are reversed.\r\n   */\r\n  public reverseTxns(numOperations: number): IModelStatus {\r\n    return this._iModel.reverseTxns(numOperations);\r\n  }\r\n\r\n  /** Reverse the most recent operation. */\r\n  public reverseSingleTxn(): IModelStatus { return this.reverseTxns(1); }\r\n\r\n  /** Reverse all changes back to the beginning of the session. */\r\n  public reverseAll(): IModelStatus { return this._nativeDb.reverseAll(); }\r\n\r\n  /** Reverse all changes back to a previously saved TxnId.\r\n   * @param txnId a TxnId obtained from a previous call to GetCurrentTxnId.\r\n   * @returns Success if the transactions were reversed, error status otherwise.\r\n   * @see  [[getCurrentTxnId]] [[cancelTo]]\r\n   */\r\n  public reverseTo(txnId: TxnIdString): IModelStatus { return this._nativeDb.reverseTo(txnId); }\r\n\r\n  /** Reverse and then cancel (make non-reinstatable) all changes back to a previous TxnId.\r\n   * @param txnId a TxnId obtained from a previous call to [[getCurrentTxnId]]\r\n   * @returns Success if the transactions were reversed and cleared, error status otherwise.\r\n   */\r\n  public cancelTo(txnId: TxnIdString): IModelStatus { return this._nativeDb.cancelTo(txnId); }\r\n\r\n  /** Reinstate the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   */\r\n  public reinstateTxn(): IModelStatus { return this._iModel.reinstateTxn(); }\r\n\r\n  /** Get the Id of the first transaction, if any.\r\n   */\r\n  public queryFirstTxnId(): TxnIdString { return this._nativeDb.queryFirstTxnId(); }\r\n\r\n  /** Get the successor of the specified TxnId */\r\n  public queryNextTxnId(txnId: TxnIdString): TxnIdString { return this._nativeDb.queryNextTxnId(txnId); }\r\n\r\n  /** Get the predecessor of the specified TxnId */\r\n  public queryPreviousTxnId(txnId: TxnIdString): TxnIdString { return this._nativeDb.queryPreviousTxnId(txnId); }\r\n\r\n  /** Get the Id of the current (tip) transaction.  */\r\n  public getCurrentTxnId(): TxnIdString { return this._nativeDb.getCurrentTxnId(); }\r\n\r\n  /** Get the description that was supplied when the specified transaction was saved. */\r\n  public getTxnDescription(txnId: TxnIdString): string { return this._nativeDb.getTxnDescription(txnId); }\r\n\r\n  /** Test if a TxnId is valid */\r\n  public isTxnIdValid(txnId: TxnIdString): boolean { return this._nativeDb.isTxnIdValid(txnId); }\r\n\r\n  /** Query if there are any pending Txns in this IModelDb that are waiting to be pushed.  */\r\n  public get hasPendingTxns(): boolean { return this._nativeDb.hasPendingTxns(); }\r\n\r\n  /** Query if there are any changes in memory that have yet to be saved to the IModelDb. */\r\n  public get hasUnsavedChanges(): boolean { return this._nativeDb.hasUnsavedChanges(); }\r\n\r\n  /** Query if there are un-saved or un-pushed local changes. */\r\n  public get hasLocalChanges(): boolean { return this.hasUnsavedChanges || this.hasPendingTxns; }\r\n\r\n}\r\n"]}
+{"version":3,"file":"TxnManager.js","sourceRoot":"","sources":["../../src/TxnManager.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 iModels\r\n */\r\n\r\nimport {\r\n  assert, BeEvent, BentleyError, compareStrings, CompressedId64Set, DbResult, Id64Array, Id64String, IModelStatus, IndexMap, Logger, OrderedId64Array,\r\n} from \"@itwin/core-bentley\";\r\nimport { ChangedEntities, EntityIdAndClassIdIterable, ModelGeometryChangesProps, ModelIdAndGeometryGuid } from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BriefcaseDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IpcHost } from \"./IpcHost\";\r\nimport { Relationship, RelationshipProps } from \"./Relationship\";\r\nimport { SqliteStatement } from \"./SqliteStatement\";\r\n\r\n/** A string that identifies a Txn.\r\n * @public\r\n */\r\nexport type TxnIdString = string;\r\n\r\n/** An error generated during dependency validation.\r\n * @see [[TxnManager.validationErrors]].\r\n * @public\r\n */\r\nexport interface ValidationError {\r\n  /** If true, txn is aborted. */\r\n  fatal: boolean;\r\n  /** The type of error. */\r\n  errorType: string;\r\n  /** Optional description of what went wrong. */\r\n  message?: string;\r\n}\r\n\r\n/** Describes a set of [[Element]]s or [[Model]]s that changed as part of a transaction.\r\n * @see [[TxnManager.onElementsChanged]] and [[TxnManager.onModelsChanged]].\r\n * @public\r\n */\r\nexport interface TxnChangedEntities {\r\n  /** The entities that were inserted by the transaction. */\r\n  readonly inserts: EntityIdAndClassIdIterable;\r\n  /** The entities that were deleted by the transaction. */\r\n  readonly deletes: EntityIdAndClassIdIterable;\r\n  /** The entities that were modified by the transaction, including any [[Element]]s for which one of their [[ElementAspect]]s was changed. */\r\n  readonly updates: EntityIdAndClassIdIterable;\r\n}\r\n\r\ntype EntitiesChangedEvent = BeEvent<(changes: TxnChangedEntities) => void>;\r\n\r\n/** Strictly for tests. @internal */\r\nexport function setMaxEntitiesPerEvent(max: number): number {\r\n  const prevMax = ChangedEntitiesProc.maxPerEvent;\r\n  ChangedEntitiesProc.maxPerEvent = max;\r\n  return prevMax;\r\n}\r\n\r\n/** Maintains an ordered array of entity Ids and a parallel array containing the index of the corresponding entity's class Id. */\r\nclass ChangedEntitiesArray {\r\n  public readonly entityIds = new OrderedId64Array();\r\n  private readonly _classIndices: number[] = [];\r\n  private readonly _classIds: IndexMap<Id64String>;\r\n\r\n  public constructor(classIds: IndexMap<Id64String>) {\r\n    this._classIds = classIds;\r\n  }\r\n\r\n  public insert(entityId: Id64String, classId: Id64String): void {\r\n    const entityIndex = this.entityIds.insert(entityId);\r\n    const classIndex = this._classIds.insert(classId);\r\n    assert(classIndex >= 0);\r\n    if (this.entityIds.length !== this._classIndices.length) {\r\n      // New entity - insert corresponding class index entry.\r\n      this._classIndices.splice(entityIndex, 0, classIndex);\r\n    } else {\r\n      // Existing entity - update corresponding class index.\r\n      // (We do this because apparently connectors can (very rarely) change the class Id of an existing element).\r\n      this._classIndices[entityIndex] = classIndex;\r\n    }\r\n\r\n    assert(this.entityIds.length === this._classIndices.length);\r\n  }\r\n\r\n  public clear(): void {\r\n    this.entityIds.clear();\r\n    this._classIndices.length = 0;\r\n  }\r\n\r\n  public addToChangedEntities(entities: ChangedEntities, type: \"deleted\" | \"inserted\" | \"updated\"): void {\r\n    if (this.entityIds.length > 0)\r\n      entities[type] = CompressedId64Set.compressIds(this.entityIds);\r\n  }\r\n\r\n  public iterable(classIds: Id64Array): EntityIdAndClassIdIterable {\r\n    function* iterator(entityIds: ReadonlyArray<Id64String>, classIndices: number[]) {\r\n      const entity = { id: \"\", classId: \"\" };\r\n      for (let i = 0; i < entityIds.length; i++) {\r\n        entity.id = entityIds[i];\r\n        entity.classId = classIds[classIndices[i]];\r\n        yield entity;\r\n      }\r\n    }\r\n\r\n    return {\r\n      [Symbol.iterator]: () => iterator(this.entityIds.array, this._classIndices),\r\n    };\r\n  }\r\n}\r\n\r\nclass ChangedEntitiesProc {\r\n  private readonly _classIds = new IndexMap<Id64String>((lhs, rhs) => compareStrings(lhs, rhs));\r\n  private readonly _inserted = new ChangedEntitiesArray(this._classIds);\r\n  private readonly _deleted = new ChangedEntitiesArray(this._classIds);\r\n  private readonly _updated = new ChangedEntitiesArray(this._classIds);\r\n  private _currSize = 0;\r\n\r\n  public static maxPerEvent = 1000;\r\n\r\n  public static process(iModel: BriefcaseDb | StandaloneDb, mgr: TxnManager): void {\r\n    if (mgr.isDisposed) {\r\n      // The iModel is being closed. Do not prepare new sqlite statements.\r\n      return;\r\n    }\r\n\r\n    this.processChanges(iModel, mgr.onElementsChanged, \"notifyElementsChanged\");\r\n    this.processChanges(iModel, mgr.onModelsChanged, \"notifyModelsChanged\");\r\n  }\r\n\r\n  private sendEvent(iModel: BriefcaseDb | StandaloneDb, evt: EntitiesChangedEvent, evtName: \"notifyElementsChanged\" | \"notifyModelsChanged\") {\r\n    if (this._currSize === 0)\r\n      return;\r\n\r\n    const classIds = this._classIds.toArray();\r\n\r\n    // Notify backend listeners.\r\n    const txnEntities: TxnChangedEntities = {\r\n      inserts: this._inserted.iterable(classIds),\r\n      deletes: this._deleted.iterable(classIds),\r\n      updates: this._updated.iterable(classIds),\r\n    };\r\n    evt.raiseEvent(txnEntities);\r\n\r\n    // Notify frontend listeners.\r\n    const entities: ChangedEntities = {};\r\n    this._inserted.addToChangedEntities(entities, \"inserted\");\r\n    this._deleted.addToChangedEntities(entities, \"deleted\");\r\n    this._updated.addToChangedEntities(entities, \"updated\");\r\n    IpcHost.notifyTxns(iModel, evtName, entities);\r\n\r\n    // Reset state.\r\n    this._inserted.clear();\r\n    this._deleted.clear();\r\n    this._updated.clear();\r\n    this._classIds.clear();\r\n    this._currSize = 0;\r\n  }\r\n\r\n  private static processChanges(iModel: BriefcaseDb | StandaloneDb, changedEvent: EntitiesChangedEvent, evtName: \"notifyElementsChanged\" | \"notifyModelsChanged\") {\r\n    try {\r\n      const maxSize = this.maxPerEvent;\r\n      const changes = new ChangedEntitiesProc();\r\n      const select = \"notifyElementsChanged\" === evtName\r\n        ? \"SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements\"\r\n        : \"SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models\";\r\n      iModel.withPreparedSqliteStatement(select, (sql: SqliteStatement) => {\r\n        const stmt = sql.stmt!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n        while (sql.step() === DbResult.BE_SQLITE_ROW) {\r\n          const id = stmt.getValueId(0);\r\n          const classId = stmt.getValueId(2);\r\n          switch (stmt.getValueInteger(1)) {\r\n            case 0:\r\n              changes._inserted.insert(id, classId);\r\n              break;\r\n            case 1:\r\n              changes._updated.insert(id, classId);\r\n              break;\r\n            case 2:\r\n              changes._deleted.insert(id, classId);\r\n              break;\r\n          }\r\n\r\n          if (++changes._currSize >= maxSize)\r\n            changes.sendEvent(iModel, changedEvent, evtName);\r\n        }\r\n      });\r\n\r\n      changes.sendEvent(iModel, changedEvent, evtName);\r\n    } catch (err) {\r\n      Logger.logError(BackendLoggerCategory.IModelDb, BentleyError.getErrorMessage(err));\r\n    }\r\n  }\r\n}\r\n\r\n/** Manages local changes to a [[BriefcaseDb]] or [[StandaloneDb]] via [Txns]($docs/learning/InteractiveEditing.md)\r\n * @public\r\n */\r\nexport class TxnManager {\r\n  /** @internal */\r\n  private _isDisposed = false;\r\n\r\n  /** @internal */\r\n  public get isDisposed(): boolean {\r\n    return this._isDisposed;\r\n  }\r\n\r\n  /** @internal */\r\n  constructor(private _iModel: BriefcaseDb | StandaloneDb) {\r\n    _iModel.onBeforeClose.addOnce(() => {\r\n      this._isDisposed = true;\r\n    });\r\n  }\r\n\r\n  /** Array of errors from dependency propagation */\r\n  public readonly validationErrors: ValidationError[] = [];\r\n\r\n  private get _nativeDb() { return this._iModel.nativeDb; }\r\n  private _getElementClass(elClassName: string): typeof Element {\r\n    return this._iModel.getJsClass(elClassName) as unknown as typeof Element;\r\n  }\r\n  private _getRelationshipClass(relClassName: string): typeof Relationship {\r\n    return this._iModel.getJsClass<typeof Relationship>(relClassName);\r\n  }\r\n  /** @internal */\r\n  protected _onBeforeOutputsHandled(elClassName: string, elId: Id64String): void {\r\n    (this._getElementClass(elClassName) as any).onBeforeOutputsHandled(elId, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onAllInputsHandled(elClassName: string, elId: Id64String): void {\r\n    (this._getElementClass(elClassName) as any).onAllInputsHandled(elId, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onRootChanged(props: RelationshipProps): void {\r\n    this._getRelationshipClass(props.classFullName).onRootChanged(props, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onDeletedDependency(props: RelationshipProps): void {\r\n    this._getRelationshipClass(props.classFullName).onDeletedDependency(props, this._iModel);\r\n  }\r\n  /** @internal */\r\n  protected _onBeginValidate() { this.validationErrors.length = 0; }\r\n\r\n  /** called from native code after validation of a Txn, either from saveChanges or apply changeset.\r\n   * @internal\r\n   */\r\n  protected _onEndValidate() {\r\n    ChangedEntitiesProc.process(this._iModel, this);\r\n    this.onEndValidation.raiseEvent();\r\n    // TODO: if (this.validationErrors.length !== 0) throw new IModelError(validation ...)\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onGeometryChanged(modelProps: ModelGeometryChangesProps[]) {\r\n    this.onGeometryChanged.raiseEvent(modelProps);\r\n    IpcHost.notifyEditingScope(this._iModel, \"notifyGeometryChanged\", modelProps); // send to frontend\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\r\n    this.onModelGeometryChanged.raiseEvent(changes);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyGeometryGuidsChanged\", changes);\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onCommit() {\r\n    this.onCommit.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyCommit\");\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onCommitted() {\r\n    this.onCommitted.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyCommitted\", this.hasPendingTxns, Date.now());\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onChangesApplied() {\r\n    ChangedEntitiesProc.process(this._iModel, this);\r\n    this.onChangesApplied.raiseEvent();\r\n    IpcHost.notifyTxns(this._iModel, \"notifyChangesApplied\");\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onBeforeUndoRedo(isUndo: boolean) {\r\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyBeforeUndoRedo\", isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  protected _onAfterUndoRedo(isUndo: boolean) {\r\n    this.onAfterUndoRedo.raiseEvent(isUndo);\r\n    IpcHost.notifyTxns(this._iModel, \"notifyAfterUndoRedo\", isUndo);\r\n  }\r\n\r\n  /** Dependency handlers may call method this to report a validation error.\r\n   * @param error The error. If error.fatal === true, the transaction will cancel rather than commit.\r\n   */\r\n  public reportError(error: ValidationError) { this.validationErrors.push(error); this._nativeDb.logTxnError(error.fatal); }\r\n\r\n  /** Determine whether any fatal validation errors have occurred during dependency propagation.  */\r\n  public get hasFatalError(): boolean { return this._nativeDb.hasFatalTxnError(); }\r\n\r\n  /** @internal */\r\n  public readonly onEndValidation = new BeEvent<() => void>();\r\n\r\n  /** Called after validation completes from [[IModelDb.saveChanges]].\r\n   * The argument to the event holds the list of elements that were inserted, updated, and deleted.\r\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onElementsChanged = new BeEvent<(changes: TxnChangedEntities) => void>();\r\n\r\n  /** Called after validation completes from [[IModelDb.saveChanges]].\r\n   * The argument to the event holds the list of models that were inserted, updated, and deleted.\r\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onModelsChanged = new BeEvent<(changes: TxnChangedEntities) => void>();\r\n\r\n  /** Event raised after the geometry within one or more [[GeometricModel]]s is modified by applying a changeset or validation of a transaction.\r\n   * A model's geometry can change as a result of:\r\n   *  - Insertion or deletion of a geometric element within the model; or\r\n   *  - Modification of an existing element's geometric properties; or\r\n   *  - An explicit request to flag it as changed via [[IModelDb.Models.updateModel]].\r\n   */\r\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\r\n\r\n  public readonly onGeometryChanged = new BeEvent<(models: ModelGeometryChangesProps[]) => void>();\r\n  /** Event raised before a commit operation is performed. Initiated by a call to [[IModelDb.saveChanges]], unless there are no changes to save. */\r\n  public readonly onCommit = new BeEvent<() => void>();\r\n  /** Event raised after a commit operation has been performed. Initiated by a call to [[IModelDb.saveChanges]], even if there were no changes to save. */\r\n  public readonly onCommitted = new BeEvent<() => void>();\r\n  /** Event raised after a ChangeSet has been applied to this briefcase */\r\n  public readonly onChangesApplied = new BeEvent<() => void>();\r\n  /** Event raised before an undo/redo operation is performed. */\r\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n  /** Event raised after an undo/redo operation has been performed.\r\n   * @param _action The action that was performed.\r\n   */\r\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /**\r\n   * Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\r\n   * and reopened.)\r\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\r\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\r\n   * Probably a good idea to alert the user it happened.\r\n   */\r\n  public restartSession() {\r\n    this._nativeDb.restartTxnSession();\r\n  }\r\n\r\n  /** Determine whether current txn is propagating indirect changes or not. */\r\n  public get isIndirectChanges(): boolean { return this._nativeDb.isIndirectChanges(); }\r\n\r\n  /** Determine if there are currently any reversible (undoable) changes from this editing session. */\r\n  public get isUndoPossible(): boolean { return this._nativeDb.isUndoPossible(); }\r\n\r\n  /** Determine if there are currently any reinstatable (redoable) changes */\r\n  public get isRedoPossible(): boolean { return this._nativeDb.isRedoPossible(); }\r\n\r\n  /** Get the description of the operation that would be reversed by calling reverseTxns(1).\r\n   * This is useful for showing the operation that would be undone, for example in a menu.\r\n   */\r\n  public getUndoString(): string { return this._nativeDb.getUndoString(); }\r\n\r\n  /** Get a description of the operation that would be reinstated by calling reinstateTxn.\r\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\r\n   */\r\n  public getRedoString(): string { return this._nativeDb.getRedoString(); }\r\n\r\n  /** Begin a new multi-Txn operation. This can be used to cause a series of Txns that would normally\r\n   * be considered separate actions for undo to be grouped into a single undoable operation. This means that when reverseTxns(1) is called,\r\n   * the entire group of changes are undone together. Multi-Txn operations can be nested and until the outermost operation is closed\r\n   * all changes constitute a single operation.\r\n   * @note This method must always be paired with a call to endMultiTxnAction.\r\n   */\r\n  public beginMultiTxnOperation(): DbResult { return this._nativeDb.beginMultiTxnOperation(); }\r\n\r\n  /** End a multi-Txn operation */\r\n  public endMultiTxnOperation(): DbResult { return this._nativeDb.endMultiTxnOperation(); }\r\n\r\n  /** Return the depth of the multi-Txn stack. Generally for diagnostic use only. */\r\n  public getMultiTxnOperationDepth(): number { return this._nativeDb.getMultiTxnOperationDepth(); }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to this IModelDb.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if ReinstateTxn is called.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the operations are reversible are reversed.\r\n   */\r\n  public reverseTxns(numOperations: number): IModelStatus {\r\n    return this._iModel.reverseTxns(numOperations);\r\n  }\r\n\r\n  /** Reverse the most recent operation. */\r\n  public reverseSingleTxn(): IModelStatus { return this.reverseTxns(1); }\r\n\r\n  /** Reverse all changes back to the beginning of the session. */\r\n  public reverseAll(): IModelStatus { return this._nativeDb.reverseAll(); }\r\n\r\n  /** Reverse all changes back to a previously saved TxnId.\r\n   * @param txnId a TxnId obtained from a previous call to GetCurrentTxnId.\r\n   * @returns Success if the transactions were reversed, error status otherwise.\r\n   * @see  [[getCurrentTxnId]] [[cancelTo]]\r\n   */\r\n  public reverseTo(txnId: TxnIdString): IModelStatus { return this._nativeDb.reverseTo(txnId); }\r\n\r\n  /** Reverse and then cancel (make non-reinstatable) all changes back to a previous TxnId.\r\n   * @param txnId a TxnId obtained from a previous call to [[getCurrentTxnId]]\r\n   * @returns Success if the transactions were reversed and cleared, error status otherwise.\r\n   */\r\n  public cancelTo(txnId: TxnIdString): IModelStatus { return this._nativeDb.cancelTo(txnId); }\r\n\r\n  /** Reinstate the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   */\r\n  public reinstateTxn(): IModelStatus { return this._iModel.reinstateTxn(); }\r\n\r\n  /** Get the Id of the first transaction, if any.\r\n   */\r\n  public queryFirstTxnId(): TxnIdString { return this._nativeDb.queryFirstTxnId(); }\r\n\r\n  /** Get the successor of the specified TxnId */\r\n  public queryNextTxnId(txnId: TxnIdString): TxnIdString { return this._nativeDb.queryNextTxnId(txnId); }\r\n\r\n  /** Get the predecessor of the specified TxnId */\r\n  public queryPreviousTxnId(txnId: TxnIdString): TxnIdString { return this._nativeDb.queryPreviousTxnId(txnId); }\r\n\r\n  /** Get the Id of the current (tip) transaction.  */\r\n  public getCurrentTxnId(): TxnIdString { return this._nativeDb.getCurrentTxnId(); }\r\n\r\n  /** Get the description that was supplied when the specified transaction was saved. */\r\n  public getTxnDescription(txnId: TxnIdString): string { return this._nativeDb.getTxnDescription(txnId); }\r\n\r\n  /** Test if a TxnId is valid */\r\n  public isTxnIdValid(txnId: TxnIdString): boolean { return this._nativeDb.isTxnIdValid(txnId); }\r\n\r\n  /** Query if there are any pending Txns in this IModelDb that are waiting to be pushed.  */\r\n  public get hasPendingTxns(): boolean { return this._nativeDb.hasPendingTxns(); }\r\n\r\n  /** Query if there are any changes in memory that have yet to be saved to the IModelDb. */\r\n  public get hasUnsavedChanges(): boolean { return this._nativeDb.hasUnsavedChanges(); }\r\n\r\n  /** Query if there are un-saved or un-pushed local changes. */\r\n  public get hasLocalChanges(): boolean { return this.hasUnsavedChanges || this.hasPendingTxns; }\r\n\r\n}\r\n"]}