@itwin/core-backend 5.10.0-dev.8 → 5.10.0

package/lib/cjs/internal/ServerBasedLocks.js

@@ -20,6 +20,10 @@ class ServerBasedLocks {
     lockDb = new SQLiteDb_1.SQLiteDb();
     briefcase;
     _removeOnCommitListener;
+    _removeOnPushedListener;
+    /** The local ID portion of the highest element ID pushed to the server. Elements with this briefcase's ID
+     * and a local ID greater than this value are implicitly exclusively locked by us (no server lock required). */
+    _highWaterLocalId = 0;
     _unsavedChangesTxnId = "0x7FFFFFFFFFFFFFFF"; // a placeholder txn id for locks acquired in the current unsaved Txn
     constructor(iModel) {
         this.briefcase = iModel;
@@ -30,6 +34,7 @@ class ServerBasedLocks {
         catch {
             this.lockDb.createDb(dbName);
         }
+        this.lockDb[Symbols_1._nativeDb].enableWalMode(true);
         // Tracks the locks that are actively held.
         this.lockDb.executeSQL("CREATE TABLE IF NOT EXISTS locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)");
         // Tracks the locks that are required by each Txn. They may or may not currently be held.
@@ -41,6 +46,18 @@ class ServerBasedLocks {
         origin INTEGER NOT NULL,
         abandoned BOOLEAN NOT NULL,
         PRIMARY KEY (txnId, elementId))`);
+        // Stores persistent metadata, including the high-water mark for new-element lock tracking.
+        this.lockDb.executeSQL("CREATE TABLE IF NOT EXISTS metadata(key TEXT PRIMARY KEY NOT NULL,value INTEGER NOT NULL)");
+        // Initialize the high-water mark. If an existing value is stored, use it. Otherwise derive it from
+        // the iModel's current element ID sequence — any element with this briefcase's ID and a local ID at
+        // or below the sequence was either already pushed or was created-then-abandoned in a previous session.
+        const storedHwm = this.lockDb.withSqliteStatement("SELECT value FROM metadata WHERE key='highWaterLocalId'", (stmt) => (core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueInteger(0) : undefined));
+        if (storedHwm !== undefined) {
+            this._highWaterLocalId = storedHwm;
+        }
+        else {
+            this.updateHighWaterMark();
+        }
         this.lockDb.saveChanges();
         this._removeOnCommitListener = this.briefcase.txns.onCommit.addListener(() => {
             const committedTxnId = this.briefcase.txns.queryPreviousTxnId(this.briefcase.txns.getCurrentTxnId());
@@ -57,9 +74,14 @@ class ServerBasedLocks {
             });
             this.lockDb.saveChanges();
         });
+        this._removeOnPushedListener = this.briefcase.txns.onChangesPushed.addListener(() => {
+            this.updateHighWaterMark();
+            this.lockDb.saveChanges();
+        });
     }
     [Symbols_1._close]() {
         this._removeOnCommitListener();
+        this._removeOnPushedListener();
         if (this.lockDb.isOpen)
             this.lockDb.closeDb();
     }
@@ -78,6 +100,26 @@ class ServerBasedLocks {
             return (core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;
         });
     }
+    /** Read the local ID portion of the iModel's current element ID sequence counter.
+     * The native layer writes this value with BeInt64Id::ToString() (decimal by default) but
+     * BeInt64Id::FromString() accepts both decimal and "0x"-prefixed hex. BigInt() has the same
+     * dual-format behavior, so it is the canonical JS equivalent. Mask to the lower 40 bits. */
+    readCurrentLocalIdSequence() {
+        const seqStr = this.briefcase[Symbols_1._nativeDb].queryLocalValue("bis_elementidsequence");
+        if (!seqStr)
+            return 0;
+        return Number(BigInt(seqStr) & 0xffffffffffn);
+    }
+    /** Persist the current element ID sequence as the new high-water mark. Called after a successful push. */
+    updateHighWaterMark() {
+        this._highWaterLocalId = this.readCurrentLocalIdSequence();
+        this.lockDb.withPreparedSqliteStatement("INSERT INTO metadata(key,value) VALUES('highWaterLocalId',?) ON CONFLICT(key) DO UPDATE SET value=excluded.value", (stmt) => { stmt.bindInteger(1, this._highWaterLocalId); stmt.step(); });
+    }
+    /** Returns true if this element was created by this briefcase after the last push and therefore does not
+     * require a server lock. */
+    isNewElement(id) {
+        return core_bentley_1.Id64.getBriefcaseId(id) === this.briefcase.briefcaseId && core_bentley_1.Id64.getLocalId(id) > this._highWaterLocalId;
+    }
     /** Clear the cache of locally held locks.
      * Note: does *not* release locks from server.
      */
@@ -169,10 +211,16 @@ class ServerBasedLocks {
     }
     /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */
     holdsExclusiveLock(id) {
+        // New elements (created by this briefcase since the last push) are implicitly exclusively locked.
+        if (this.isNewElement(id))
+            return true;
         // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)
         return this.getLockState(id) === core_common_1.LockState.Exclusive || this.ownerHoldsExclusiveLock(id);
     }
     holdsSharedLock(id) {
+        // New elements are implicitly exclusively locked, which implies shared lock too.
+        if (this.isNewElement(id))
+            return true;
         const state = this.getLockState(id);
         // 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.
         return (state === core_common_1.LockState.Shared || state === core_common_1.LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);
@@ -427,8 +475,14 @@ class ServerBasedLocks {
         });
         this.lockDb.saveChanges();
     }
-    /** When an element is newly created in a session, we hold the lock on it implicitly. Save that fact. */
+    /** When an element is newly created in a session, we hold the lock on it implicitly.
+     * For elements whose local ID is above the high-water mark this is already handled by [[isNewElement]],
+     * so no database write is needed. The only case that does require a write is when the element's ID is
+     * at or below the high-water mark (e.g. when re-applying a stash whose elements were created before
+     * the last push). */
     [Symbols_1._elementWasCreated](id) {
+        if (this.isNewElement(id))
+            return; // already covered implicitly; no database write needed
         this.insertLock(id, core_common_1.LockState.Exclusive, 1 /* LockOrigin.NewElement */);
         this.insertTxnLockRecord(id, core_common_1.LockState.Exclusive, 1 /* LockOrigin.NewElement */);
         this.lockDb.saveChanges();

package/lib/cjs/internal/ServerBasedLocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerBasedLocks.js","sourceRoot":"","sources":["../../../src/internal/ServerBasedLocks.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { DbResult, Id64, Id64Arg, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport { IModel, IModelError, LockState, ServerBasedLocksError } from \"@itwin/core-common\";\nimport { LockMap } from \"../BackendHubAccess\";\nimport { BriefcaseDb } from \"../IModelDb\";\nimport { LockControl } from \"../LockControl\";\nimport { IModelHost } from \"../IModelHost\";\nimport { SQLiteDb } from \"../SQLiteDb\";\nimport { _close, _elementWasCreated, _hubAccess, _implementationProhibited, _nativeDb, _releaseAllLocks } from \"./Symbols\";\n\n/**\n * Both the Model and Parent of an element are considered \"owners\" of their member elements. That means:\n * 1) they must hold at least a shared lock before an exclusive lock can be acquired for their members\n * 2) if they hold an exclusive lock, then all of their members are exclusively locked implicitly.\n */\ninterface ElementOwners {\n  readonly modelId: Id64String;\n  readonly parentId: Id64String | undefined;\n}\n\n// eslint-disable-next-line no-restricted-syntax\nconst enum LockOrigin {\n  Acquired = 0,\n  NewElement = 1,\n  Discovered = 2,\n}\n\nexport class ServerBasedLocks implements LockControl {\n  public readonly [_implementationProhibited] = undefined;\n\n  public get isServerBased() { return true; }\n  protected readonly lockDb = new SQLiteDb();\n  protected readonly briefcase: BriefcaseDb;\n  private _removeOnCommitListener: () => void;\n  private readonly _unsavedChangesTxnId = \"0x7FFFFFFFFFFFFFFF\"; // a placeholder txn id for locks acquired in the current unsaved Txn\n\n  public constructor(iModel: BriefcaseDb) {\n    this.briefcase = iModel;\n    const dbName = `${iModel[_nativeDb].getTempFileBaseName()}-locks`;\n\n    try {\n      this.lockDb.openDb(dbName, OpenMode.ReadWrite);\n    } catch {\n      this.lockDb.createDb(dbName);\n    }\n\n    // Tracks the locks that are actively held.\n    this.lockDb.executeSQL(\"CREATE TABLE IF NOT EXISTS locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)\");\n    // Tracks the locks that are required by each Txn. They may or may not currently be held.\n    this.lockDb.executeSQL(`\n      CREATE TABLE IF NOT EXISTS txn_locks(\n        txnId INTEGER NOT NULL,\n        elementId INTEGER NOT NULL,\n        state INTEGER NOT NULL,\n        origin INTEGER NOT NULL,\n        abandoned BOOLEAN NOT NULL,\n        PRIMARY KEY (txnId, elementId))`);\n    this.lockDb.saveChanges();\n\n    this._removeOnCommitListener = this.briefcase.txns.onCommit.addListener(() => {\n      const committedTxnId = this.briefcase.txns.queryPreviousTxnId(this.briefcase.txns.getCurrentTxnId())\n\n      // With this commit, any reversed txns with the committed txn's ID or greater are no longer reinstatable,\n      // so clear out the record of their locks. If the locks are still held, sorry, it's too late!\n      this.clearTxnLockRecords(committedTxnId);\n\n      // All of the \"current\" changes are now part of a real txn, so update the txn id accordingly.\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET txnId=? WHERE txnId=?\", (stmt) => {\n        stmt.bindId(1, committedTxnId);\n        stmt.bindId(2, this._unsavedChangesTxnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update locks database with txn ID of unsaved changes txn upon saving (error code ${rc})`);\n      });\n\n      this.lockDb.saveChanges();\n    });\n  }\n\n  public [_close]() {\n    this._removeOnCommitListener();\n\n    if (this.lockDb.isOpen)\n      this.lockDb.closeDb();\n  }\n\n  private getOwners(id: Id64String): ElementOwners {\n    return this.briefcase.withPreparedSqliteStatement(\"SELECT ModelId,ParentId FROM bis_Element WHERE id=?\", (stmt) => {\n      stmt.bindId(1, id);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_ROW !== rc)\n        throw new IModelError(rc, `element ${id} not found`);\n\n      return { modelId: stmt.getValueId(0), parentId: stmt.getValueId(1) };\n    });\n  }\n\n  private getLockState(id?: Id64String): LockState | undefined {\n    return (id === undefined || !Id64.isValid(id)) ? undefined : this.lockDb.withPreparedSqliteStatement(\"SELECT state FROM locks WHERE id=?\", (stmt) => {\n      stmt.bindId(1, id);\n      return (DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;\n    });\n  }\n\n  /** Clear the cache of locally held locks.\n   * Note: does *not* release locks from server.\n   */\n  private clearAllLocks() {\n    this.lockDb.executeSQL(\"DELETE FROM locks\");\n    this.lockDb.executeSQL(\"DELETE FROM txn_locks\");\n    this.lockDb.saveChanges();\n  }\n\n  /** only for tests */\n  public getLockCount(state: LockState): number {\n    return this.lockDb.withSqliteStatement(\"SELECT count(*) FROM locks WHERE state=?\", (stmt) => {\n      stmt.bindInteger(1, state);\n      stmt.step();\n      return stmt.getValueInteger(0);\n    });\n  }\n\n  public async [_releaseAllLocks](): Promise<void> {\n    await IModelHost[_hubAccess].releaseAllLocks(this.briefcase); // throws if unsuccessful\n    this.clearAllLocks();\n  }\n\n  public async releaseAllLocks(): Promise<void> {\n    if (this.briefcase.txns.hasLocalChanges) {\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be released while the briefcase contains local changes\");\n    }\n\n    return this[_releaseAllLocks]();\n  }\n\n  public async abandonAllLocks(): Promise<void> {\n    if (this.briefcase.txns.hasLocalChanges) {\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be abandoned while the briefcase contains local changes\");\n    }\n\n    if (IModelHost[_hubAccess].abandonAllLocks === undefined) {\n      // If the IModelHub doesn't support an explicit abandon, call release with a blank changeset to indicate\n      // that locks should be released without updating the changeset associated with the locks.\n      await IModelHost[_hubAccess].releaseAllLocks({\n        iModelId: this.briefcase.iModelId,\n        briefcaseId: this.briefcase.briefcaseId,\n        changeset: { id: \"\", index: 0 }\n      });\n    } else {\n      await IModelHost[_hubAccess].abandonAllLocks(this.briefcase);\n    }\n\n    this.clearAllLocks();\n  }\n\n  private insertLock(id: Id64String, state: LockState, origin: LockOrigin): true {\n    this.lockDb.withPreparedSqliteStatement(\"INSERT INTO locks(id,state,origin) VALUES (?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,origin=excluded.origin\", (stmt) => {\n      stmt.bindId(1, id);\n      stmt.bindInteger(2, state);\n      stmt.bindInteger(3, origin);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        throw new IModelError(rc, \"can't insert lock into database\");\n    });\n\n    return true;\n  }\n\n  private insertTxnLockRecord(id: Id64String, state: LockState, origin: LockOrigin): void {\n    // Locks are always acquired in the current txn, which isn't a real txn until it's committed.\n    // So use a placeholder txn id for now, and we'll update to the real txn id on commit.\n    // This is important to distinguish new locks acquired in the current txn from locks acquired in previous reversed txns, which will only\n    // be cleared (no longer reinstateable) on commit.\n    this.lockDb.withPreparedSqliteStatement(`\n      INSERT INTO txn_locks(txnId,elementId,state,origin,abandoned)\n      VALUES (?,?,?,?,FALSE)\n      ON CONFLICT(txnId,elementId)\n        DO UPDATE SET\n          state=excluded.state,\n          origin=excluded.origin,\n          abandoned=excluded.abandoned`, (stmt) => {\n      stmt.bindId(1, this._unsavedChangesTxnId);\n      stmt.bindId(2, id);\n      stmt.bindInteger(3, state);\n      stmt.bindInteger(4, origin);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't insert txn lock record into database (error code ${rc})`);\n    });\n  }\n\n  private ownerHoldsExclusiveLock(id: Id64String | undefined): boolean {\n    if (id === undefined || id === IModel.rootSubjectId)\n      return false; // has no owners\n\n    const { modelId, parentId } = this.getOwners(id);\n    if (this.getLockState(modelId) === LockState.Exclusive || this.getLockState(parentId) === LockState.Exclusive)\n      return true;\n\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.\n    if (this.ownerHoldsExclusiveLock(modelId))\n      return this.insertLock(modelId, LockState.Exclusive, LockOrigin.Discovered);\n\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.\n    return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId!, LockState.Exclusive, LockOrigin.Discovered) : false; // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  }\n\n  /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */\n  public holdsExclusiveLock(id: Id64String): boolean {\n    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\n  }\n\n  public holdsSharedLock(id: Id64String): boolean {\n    const state = this.getLockState(id);\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.\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\n  }\n\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. */\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\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\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\n      return;\n\n    locks.add(id); // add to set of needed shared locks\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\n  }\n\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\n    const el = this.getOwners(id);\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\n    this.addSharedLock(el.modelId, locks); // check its model\n  }\n\n  /** attempt to acquire all necessary locks for a set of elements */\n  private async acquireAllLocks(locks: LockMap) {\n    if (locks.size === 0) // no locks are required.\n      return;\n\n    const sharedLocks = new Set<Id64String>();\n    for (const lock of locks)\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\n\n    for (const shared of sharedLocks) {\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\n        locks.set(shared, LockState.Shared);\n    }\n\n    await IModelHost[_hubAccess].acquireLocks(this.briefcase, locks); // throws if unsuccessful\n    for (const lock of locks) {\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\n      this.insertTxnLockRecord(lock[0], lock[1], LockOrigin.Acquired);\n    }\n    this.lockDb.saveChanges();\n  }\n\n  public async acquireLocks(arg: { shared?: Id64Arg, exclusive?: Id64Arg }): Promise<void> {\n    const locks = new Map<Id64String, LockState>();\n    if (arg.shared) {\n      for (const id of Id64.iterable(arg.shared)) {\n        if (!this.holdsSharedLock(id))\n          locks.set(id, LockState.Shared);\n      }\n    }\n    if (arg.exclusive) {\n      for (const id of Id64.iterable(arg.exclusive)) {\n        if (!this.holdsExclusiveLock(id))\n          locks.set(id, LockState.Exclusive);\n      }\n    }\n    return this.acquireAllLocks(locks);\n  }\n\n  private async abandonLocks(locks: LockMap): Promise<void> {\n    if (IModelHost[_hubAccess].abandonLocks === undefined) {\n      // If the IModelHub doesn't support an explicit abandon, call acquireLocks with a blank changeset to indicate\n      // that locks should be released without updating the changeset associated with the locks.\n      await IModelHost[_hubAccess].acquireLocks({\n        iModelId: this.briefcase.iModelId,\n        briefcaseId: this.briefcase.briefcaseId,\n        changeset: { id: \"\", index: 0 }\n      }, locks);\n    } else {\n      await IModelHost[_hubAccess].abandonLocks(this.briefcase, locks);\n    }\n  }\n\n  public async abandonLocksForCurrentUnsavedTxn(): Promise<boolean> {\n    return this.abandonLocksForReversedTxn(this._unsavedChangesTxnId);\n  }\n\n  public async abandonLocksForReversedTxn(txnId: Id64String): Promise<boolean> {\n    if (this.briefcase.txns.hasUnsavedChanges)\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot abandon locks for txn ${txnId} because the current txn has unsaved changes`);\n\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\n    if (txnProps === undefined) {\n      // The current txn commonly won't exist on the TxnManager yet. It's often just a placeholder for not-yet-saved changes.\n      // (Sometimes it will exist and refer to a reversed Txn).\n      // The unsavedChangesTxnId won't exist on the TxnManager either, of course.\n      // But all other txn ids must be known to the TxnManager or it is an error.\n      if (txnId !== this.briefcase.txns.getCurrentTxnId() && txnId !== this._unsavedChangesTxnId)\n        ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot abandon locks for txn ${txnId} because it does not exist`);\n    } else {\n      // If the txn id is known to the TxnManager, then we require that it has already been reversed.\n      if (!txnProps.reversed)\n        ServerBasedLocksError.throwError(\"txn-not-reversed\", `cannot abandon locks for txn ${txnId} because it has not been reversed`);\n    }\n\n    let locksReleased = false;\n\n    // Abandon locks for unsaved (and now abandoned) changes.\n    if (txnId !== this._unsavedChangesTxnId) {\n      locksReleased = await this.abandonLocksForCurrentUnsavedTxn();\n    }\n\n    // At this point, we know:\n    // 1. There are no unsaved changes, and the associated locks have been abandoned.\n    // 2. The given txn ID has been reversed, which means any later txns are sure to have been reversed, too.\n\n    // So we simply have to find all non-abandoned locks associated with the given txn or later, abandon them (or restore\n    // them to their previous state), and mark them as abandoned in txn_locks.\n\n    // Find all locks associated with the given txnId or later.\n    // For each elementId, find the previous state of the lock before this Txn (if any), or None otherwise.\n    // This is the state that we will restore the element's lock to. The reason we do this is to account for\n    // lock upgrades. If an earlier Txn acquired a Shared lock on this element, and this Txn acquired an\n    // Exclusive lock, we should restore the Shared lock.\n    const allTxnLocks = new Map<Id64String, LockState>();\n    const locksToRelease = new Map<Id64String, LockState>();\n    this.lockDb.withPreparedSqliteStatement(\n      `\n        SELECT\n          current.elementId,\n          current.origin,\n          IFNULL(\n            (SELECT previous.state\n              FROM txn_locks previous\n              WHERE previous.elementId = current.elementId\n                AND previous.txnId < ?2\n                AND previous.abandoned=FALSE\n              ORDER BY previous.txnId DESC\n              LIMIT 1\n            ),\n            ?1\n          ) AS previousState\n        FROM txn_locks current\n        WHERE current.txnId>=?2\n          AND current.abandoned=FALSE\n        ORDER BY current.txnId DESC\n      `,\n      (stmt) => {\n        stmt.bindInteger(1, LockState.None);\n        stmt.bindId(2, txnId);\n\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\n          const elementId = stmt.getValueId(0);\n          const origin = stmt.getValueInteger(1);\n          const previousState = stmt.getValueInteger(2);\n          allTxnLocks.set(elementId, previousState);\n          if (origin !== LockOrigin.NewElement)\n            locksToRelease.set(elementId, previousState);\n        }\n      });\n\n    // Release the locks on the server.\n    if (locksToRelease.size > 0)\n      await this.abandonLocks(locksToRelease);\n\n    // Mark the txn locks as abandoned.\n    if (txnId === this._unsavedChangesTxnId) {\n      // After abandoning locks held for the \"unsaved\" txn, we clear them completely because they are not reinstateable.\n      this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId=?\", (stmt) => {\n        stmt.bindId(1, this._unsavedChangesTxnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn locks for unsaved changes in database (error code ${rc})`);\n      });\n    } else {\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=TRUE WHERE txnId>=?\", (stmt) => {\n        stmt.bindId(1, txnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as abandoned in database (error code ${rc})`);\n      });\n    }\n\n    // Restore each lock to its previous state (if any) in the local cache. Usually this means deleting it.\n    for (const [elementId, previousState] of allTxnLocks) {\n      if (previousState === LockState.None) {\n        this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE id=?\", (stmt) => {\n          stmt.bindId(1, elementId);\n          const rc = stmt.step();\n          if (DbResult.BE_SQLITE_DONE !== rc)\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete lock from database (error code ${rc})`);\n        });\n      } else {\n        this.lockDb.withPreparedSqliteStatement(\"UPDATE locks SET state=? WHERE id=?\", (stmt) => {\n          stmt.bindInteger(1, previousState);\n          stmt.bindId(2, elementId);\n          const rc = stmt.step();\n          if (DbResult.BE_SQLITE_DONE !== rc)\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update lock in database (error code ${rc})`);\n        });\n      }\n    }\n\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\n    this.clearDiscoveredLocks();\n\n    this.lockDb.saveChanges();\n\n    return locksReleased || allTxnLocks.size > 0;\n  }\n\n  private getAbandonedLocksForTxn(txnId: Id64String): {\n    newElementLocks: Map<Id64String, LockState>,\n    locksToAcquire: Map<Id64String, LockState>\n  } {\n    const newElementLocks = new Map<Id64String, LockState>();\n    const locksToAcquire = new Map<Id64String, LockState>();\n    this.lockDb.withPreparedSqliteStatement(\n      \"SELECT elementId, state, origin FROM txn_locks WHERE txnId<=? AND abandoned=TRUE\",\n      (stmt) => {\n        stmt.bindId(1, txnId);\n\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\n          const elementId = stmt.getValueId(0);\n          const state = stmt.getValueInteger(1);\n          const origin = stmt.getValueInteger(2);\n          if (origin === LockOrigin.NewElement)\n            newElementLocks.set(elementId, state);\n          else\n            locksToAcquire.set(elementId, state);\n        }\n      });\n\n    return { newElementLocks, locksToAcquire };\n  }\n\n  public async acquireLocksForReinstatingTxn(txnId: Id64String): Promise<boolean> {\n    if (this.briefcase.txns.hasUnsavedChanges)\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot acquire locks for reinstating txn ${txnId} because the current txn has unsaved changes`);\n\n    // If the Txn is known to the TxnManager, we can proceed. We don't need to check if it is currently\n    // reversed, because if it isn't, then abandonLocksForReversedTxn couldn't have been called, and so the\n    // locks are still held. Proceeding with this method will be a no-op, but it will be harmless.\n    // However, if the Txn Id is unknown, it may have been canceled or refer to the current Txn\n    // whose unsaved changes were just abandoned. Or it's just plain-old invalid. In any case, we can't\n    // re-acquire the associated locks.\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\n    if (txnProps === undefined) {\n      ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot acquire locks for txn ${txnId} because it does not exist or has not been saved`);\n    }\n\n    // Find all locks associated with the given txnId.\n    const { newElementLocks, locksToAcquire } = this.getAbandonedLocksForTxn(txnId);\n\n    // Attempt to acquire the locks on the server. This may fail if the locks are no longer available!\n    if (locksToAcquire.size > 0)\n      await IModelHost[_hubAccess].acquireLocks(this.briefcase, locksToAcquire); // throws if unsuccessful\n\n    // Mark the txn locks as no longer abandoned.\n    this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=FALSE WHERE txnId<=?\", (stmt) => {\n      stmt.bindId(1, txnId);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as no longer abandoned in database (error code ${rc})`);\n    });\n\n    // Insert the newly-acquired locks in the local cache. Note that we don't need to insert entries in the txn_locks table,\n    // because these locks are already associated with the Txn.\n    for (const [elementId, state] of locksToAcquire) {\n      this.insertLock(elementId, state, LockOrigin.Acquired);\n    }\n    for (const [elementId, state] of newElementLocks) {\n      this.insertLock(elementId, state, LockOrigin.NewElement);\n    }\n\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\n    this.clearDiscoveredLocks();\n\n    this.lockDb.saveChanges();\n\n    return locksToAcquire.size > 0 || newElementLocks.size > 0;\n  }\n\n  public holdsNecessaryLocksForReinstatingTxn(txnId: Id64String): boolean {\n    const locks = this.getAbandonedLocksForTxn(txnId);\n    return locks.locksToAcquire.size === 0 && locks.newElementLocks.size === 0;\n  }\n\n  public clearTxnLockRecords(txnId: Id64String) {\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId!=? AND txnId>=?\", (stmt) => {\n      stmt.bindId(1, this._unsavedChangesTxnId);\n      stmt.bindId(2, txnId);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn lock records from database (error code ${rc})`);\n    });\n\n    this.lockDb.saveChanges();\n  }\n\n  /** When an element is newly created in a session, we hold the lock on it implicitly. Save that fact. */\n  public [_elementWasCreated](id: Id64String) {\n    this.insertLock(id, LockState.Exclusive, LockOrigin.NewElement);\n    this.insertTxnLockRecord(id, LockState.Exclusive, LockOrigin.NewElement);\n    this.lockDb.saveChanges();\n  }\n\n  private clearDiscoveredLocks() {\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE origin=?\", (stmt) => {\n      stmt.bindInteger(1, LockOrigin.Discovered);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete discovered locks from database (error code ${rc})`);\n    });\n  }\n\n  /** locks are not necessary during change propagation. */\n  private get _locksAreRequired() { return !this.briefcase.txns.isIndirectChanges; }\n\n  /** throw if locks are currently required and the exclusive lock is not held on the supplied element */\n  public checkExclusiveLock(id: Id64String, type: string, operation: string) {\n    if (this._locksAreRequired && !this.holdsExclusiveLock(id))\n      throw new IModelError(IModelStatus.LockNotHeld, `exclusive lock not held on ${type} for ${operation} (id=${id})`);\n  }\n\n  /** throw if locks are currently required and a shared lock is not held on the supplied element */\n  public checkSharedLock(id: Id64String, type: string, operation: string) {\n    if (this._locksAreRequired && !this.holdsSharedLock(id))\n      throw new IModelError(IModelStatus.LockNotHeld, `shared lock not held on ${type} for ${operation} (id=${id})`);\n  }\n\n}\n\nexport function createServerBasedLocks(iModel: BriefcaseDb): LockControl {\n  return new ServerBasedLocks(iModel);\n}\n"]}
+{"version":3,"file":"ServerBasedLocks.js","sourceRoot":"","sources":["../../../src/internal/ServerBasedLocks.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAwmB/F,wDAEC;AAxmBD;;GAEG;AAEH,sDAAkG;AAClG,oDAA2F;AAI3F,8CAA2C;AAC3C,0CAAuC;AACvC,uCAA2H;AAmB3H,MAAa,gBAAgB;IACX,CAAC,mCAAyB,CAAC,GAAG,SAAS,CAAC;IAExD,IAAW,aAAa,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;IACxB,MAAM,GAAG,IAAI,mBAAQ,EAAE,CAAC;IACxB,SAAS,CAAc;IAClC,uBAAuB,CAAa;IACpC,uBAAuB,CAAa;IAC5C;mHAC+G;IACvG,iBAAiB,GAAW,CAAC,CAAC;IACrB,oBAAoB,GAAG,oBAAoB,CAAC,CAAC,qEAAqE;IAEnI,YAAmB,MAAmB;QACpC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAS,CAAC,CAAC,mBAAmB,EAAE,QAAQ,CAAC;QAElE,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,mBAAS,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE3C,2CAA2C;QAC3C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,yGAAyG,CAAC,CAAC;QAClI,yFAAyF;QACzF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;;;;;;;wCAOa,CAAC,CAAC;QAEtC,2FAA2F;QAC3F,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,2FAA2F,CAAC,CAAC;QAEpH,mGAAmG;QACnG,oGAAoG;QACpG,uGAAuG;QACvG,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAC/C,yDAAyD,EACzD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CACzF,CAAC;QACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAE1B,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE;YAC3E,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAA;YAEpG,yGAAyG;YACzG,6FAA6F;YAC7F,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAEzC,6FAA6F;YAC7F,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,4CAA4C,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC7F,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;oBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,0FAA0F,EAAE,GAAG,CAAC,CAAC;YAC/J,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,EAAE;YAClF,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,CAAC,gBAAM,CAAC;QACb,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YACpB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEO,SAAS,CAAC,EAAc;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,qDAAqD,EAAE,CAAC,IAAI,EAAE,EAAE;YAChH,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,aAAa,KAAK,EAAE;gBAC/B,MAAM,IAAI,yBAAW,CAAC,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;YAEvD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,EAAe;QAClC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,oCAAoC,EAAE,CAAC,IAAI,EAAE,EAAE;YAClJ,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnB,OAAO,CAAC,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;gGAG4F;IACpF,0BAA0B;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAS,CAAC,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,CAAC;QACX,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,0GAA0G;IAClG,mBAAmB;QACzB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,2BAA2B,CACrC,kHAAkH,EAClH,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC;IAED;gCAC4B;IACpB,YAAY,CAAC,EAAc;QACjC,OAAO,mBAAI,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,IAAI,mBAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;IAChH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,qBAAqB;IACd,YAAY,CAAC,KAAgB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,0CAA0C,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1F,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,CAAC,0BAAgB,CAAC;QAC7B,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB;QACvF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,mCAAqB,CAAC,UAAU,CAAC,qBAAqB,EAAE,qEAAqE,CAAC,CAAC;QACjI,CAAC;QAED,OAAO,IAAI,CAAC,0BAAgB,CAAC,EAAE,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,mCAAqB,CAAC,UAAU,CAAC,qBAAqB,EAAE,sEAAsE,CAAC,CAAC;QAClI,CAAC;QAED,IAAI,uBAAU,CAAC,oBAAU,CAAC,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACzD,wGAAwG;YACxG,0FAA0F;YAC1F,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,eAAe,CAAC;gBAC3C,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ;gBACjC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW;gBACvC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;aAChC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,UAAU,CAAC,EAAc,EAAE,KAAgB,EAAE,MAAkB;QACrE,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,6HAA6H,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9K,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnB,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;gBAChC,MAAM,IAAI,yBAAW,CAAC,EAAE,EAAE,iCAAiC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,mBAAmB,CAAC,EAAc,EAAE,KAAgB,EAAE,MAAkB;QAC9E,6FAA6F;QAC7F,sFAAsF;QACtF,wIAAwI;QACxI,kDAAkD;QAClD,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC;;;;;;;uCAOL,EAAE,CAAC,IAAI,EAAE,EAAE;YAC5C,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnB,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;gBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,0DAA0D,EAAE,GAAG,CAAC,CAAC;QAC/H,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,uBAAuB,CAAC,EAA0B;QACxD,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,oBAAM,CAAC,aAAa;YACjD,OAAO,KAAK,CAAC,CAAC,gBAAgB;QAEhC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,uBAAS,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,uBAAS,CAAC,SAAS;YAC3G,OAAO,IAAI,CAAC;QAEd,wIAAwI;QACxI,IAAI,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC;YACvC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,uBAAS,CAAC,SAAS,gCAAwB,CAAC;QAE9E,yIAAyI;QACzI,OAAO,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAS,EAAE,uBAAS,CAAC,SAAS,gCAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,+DAA+D;IACjM,CAAC;IAED,mGAAmG;IAC5F,kBAAkB,CAAC,EAAc;QACtC,kGAAkG;QAClG,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,2GAA2G;QAC3G,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,uBAAS,CAAC,SAAS,IAAI,IAAI,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAEM,eAAe,CAAC,EAAc;QACnC,iFAAiF;QACjF,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpC,gKAAgK;QAChK,OAAO,CAAC,KAAK,KAAK,uBAAS,CAAC,MAAM,IAAI,KAAK,KAAK,uBAAS,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,sIAAsI;IAC9H,aAAa,CAAC,EAA0B,EAAE,KAAsB;QACtE,gHAAgH;QAChH,0GAA0G;QAC1G,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACpF,OAAO;QAET,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,oCAAoC;QACnD,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,iCAAiC;IACxE,CAAC;IAED,sGAAsG;IAC9F,mBAAmB,CAAC,EAAc,EAAE,KAAsB;QAChE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,gCAAgC;QACxE,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,kBAAkB;IAC3D,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,eAAe,CAAC,KAAc;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,yBAAyB;YAC7C,OAAO;QAET,MAAM,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK;YACtB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAEjD,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,8CAA8C;gBACpE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAS,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,yBAAyB;QAC3F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,8BAAsB,CAAC;YACvD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,8BAAsB,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,GAA8C;QACtE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC/C,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,KAAK,MAAM,EAAE,IAAI,mBAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;oBAC3B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,uBAAS,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAClB,KAAK,MAAM,EAAE,IAAI,mBAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC9B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,uBAAS,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAc;QACvC,IAAI,uBAAU,CAAC,oBAAU,CAAC,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtD,6GAA6G;YAC7G,0FAA0F;YAC1F,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,YAAY,CAAC;gBACxC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ;gBACjC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW;gBACvC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;aAChC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,gCAAgC;QAC3C,OAAO,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,0BAA0B,CAAC,KAAiB;QACvD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB;YACvC,mCAAqB,CAAC,UAAU,CAAC,qBAAqB,EAAE,gCAAgC,KAAK,8CAA8C,CAAC,CAAC;QAE/I,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,uHAAuH;YACvH,yDAAyD;YACzD,2EAA2E;YAC3E,2EAA2E;YAC3E,IAAI,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,KAAK,KAAK,IAAI,CAAC,oBAAoB;gBACxF,mCAAqB,CAAC,UAAU,CAAC,kBAAkB,EAAE,gCAAgC,KAAK,4BAA4B,CAAC,CAAC;QAC5H,CAAC;aAAM,CAAC;YACN,+FAA+F;YAC/F,IAAI,CAAC,QAAQ,CAAC,QAAQ;gBACpB,mCAAqB,CAAC,UAAU,CAAC,kBAAkB,EAAE,gCAAgC,KAAK,mCAAmC,CAAC,CAAC;QACnI,CAAC;QAED,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,yDAAyD;QACzD,IAAI,KAAK,KAAK,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACxC,aAAa,GAAG,MAAM,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAChE,CAAC;QAED,0BAA0B;QAC1B,iFAAiF;QACjF,yGAAyG;QAEzG,qHAAqH;QACrH,0EAA0E;QAE1E,2DAA2D;QAC3D,uGAAuG;QACvG,wGAAwG;QACxG,oGAAoG;QACpG,qDAAqD;QACrD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;QACrD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,2BAA2B,CACrC;;;;;;;;;;;;;;;;;;;OAmBC,EACD,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,uBAAS,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAEtB,OAAO,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBACvC,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAC9C,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAC1C,IAAI,MAAM,kCAA0B;oBAClC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,mCAAmC;QACnC,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC;YACzB,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAE1C,mCAAmC;QACnC,IAAI,KAAK,KAAK,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACxC,kHAAkH;YAClH,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,qCAAqC,EAAE,CAAC,IAAI,EAAE,EAAE;gBACtF,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;oBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,sEAAsE,EAAE,GAAG,CAAC,CAAC;YAC3I,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,oDAAoD,EAAE,CAAC,IAAI,EAAE,EAAE;gBACrG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACtB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;oBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,6DAA6D,EAAE,GAAG,CAAC,CAAC;YAClI,CAAC,CAAC,CAAC;QACL,CAAC;QAED,uGAAuG;QACvG,KAAK,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,WAAW,EAAE,CAAC;YACrD,IAAI,aAAa,KAAK,uBAAS,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,8BAA8B,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC/E,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;wBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,+CAA+C,EAAE,GAAG,CAAC,CAAC;gBACpH,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,qCAAqC,EAAE,CAAC,IAAI,EAAE,EAAE;oBACtF,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;oBACnC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;wBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,6CAA6C,EAAE,GAAG,CAAC,CAAC;gBAClH,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,4FAA4F;QAC5F,6EAA6E;QAC7E,4FAA4F;QAC5F,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAE1B,OAAO,aAAa,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/C,CAAC;IAEO,uBAAuB,CAAC,KAAiB;QAI/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyB,CAAC;QACzD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,2BAA2B,CACrC,kFAAkF,EAClF,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAEtB,OAAO,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBACvC,IAAI,MAAM,kCAA0B;oBAClC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;;oBAEtC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,6BAA6B,CAAC,KAAiB;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB;YACvC,mCAAqB,CAAC,UAAU,CAAC,qBAAqB,EAAE,4CAA4C,KAAK,8CAA8C,CAAC,CAAC;QAE3J,mGAAmG;QACnG,uGAAuG;QACvG,8FAA8F;QAC9F,2FAA2F;QAC3F,mGAAmG;QACnG,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,mCAAqB,CAAC,UAAU,CAAC,kBAAkB,EAAE,gCAAgC,KAAK,kDAAkD,CAAC,CAAC;QAChJ,CAAC;QAED,kDAAkD;QAClD,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAEhF,kGAAkG;QAClG,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC;YACzB,MAAM,uBAAU,CAAC,oBAAU,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,yBAAyB;QAEtG,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,qDAAqD,EAAE,CAAC,IAAI,EAAE,EAAE;YACtG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACtB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;gBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,uEAAuE,EAAE,GAAG,CAAC,CAAC;QAC5I,CAAC,CAAC,CAAC;QAEH,wHAAwH;QACxH,2DAA2D;QAC3D,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;YAChD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,8BAAsB,CAAC;QACzD,CAAC;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,gCAAwB,CAAC;QAC3D,CAAC;QAED,4FAA4F;QAC5F,6EAA6E;QAC7E,4FAA4F;QAC5F,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAE1B,OAAO,cAAc,CAAC,IAAI,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7D,CAAC;IAEM,oCAAoC,CAAC,KAAiB;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,CAAC;IAC7E,CAAC;IAEM,mBAAmB,CAAC,KAAiB;QAC1C,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,mDAAmD,EAAE,CAAC,IAAI,EAAE,EAAE;YACpG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACtB,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;gBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,2DAA2D,EAAE,GAAG,CAAC,CAAC;QAChI,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED;;;;yBAIqB;IACd,CAAC,4BAAkB,CAAC,CAAC,EAAc;QACxC,IAAI,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,uDAAuD;QACjE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,uBAAS,CAAC,SAAS,gCAAwB,CAAC;QAChE,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,uBAAS,CAAC,SAAS,gCAAwB,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,kCAAkC,EAAE,CAAC,IAAI,EAAE,EAAE;YACnF,IAAI,CAAC,WAAW,CAAC,CAAC,gCAAwB,CAAC;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,uBAAQ,CAAC,cAAc,KAAK,EAAE;gBAChC,mCAAqB,CAAC,UAAU,CAAC,uBAAuB,EAAE,2DAA2D,EAAE,GAAG,CAAC,CAAC;QAChI,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,IAAY,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAElF,uGAAuG;IAChG,kBAAkB,CAAC,EAAc,EAAE,IAAY,EAAE,SAAiB;QACvE,IAAI,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,WAAW,EAAE,8BAA8B,IAAI,QAAQ,SAAS,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtH,CAAC;IAED,kGAAkG;IAC3F,eAAe,CAAC,EAAc,EAAE,IAAY,EAAE,SAAiB;QACpE,IAAI,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,WAAW,EAAE,2BAA2B,IAAI,QAAQ,SAAS,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnH,CAAC;CAEF;AAtkBD,4CAskBC;AAED,SAAgB,sBAAsB,CAAC,MAAmB;IACxD,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { DbResult, Id64, Id64Arg, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport { IModel, IModelError, LockState, ServerBasedLocksError } from \"@itwin/core-common\";\nimport { LockMap } from \"../BackendHubAccess\";\nimport { BriefcaseDb } from \"../IModelDb\";\nimport { LockControl } from \"../LockControl\";\nimport { IModelHost } from \"../IModelHost\";\nimport { SQLiteDb } from \"../SQLiteDb\";\nimport { _close, _elementWasCreated, _hubAccess, _implementationProhibited, _nativeDb, _releaseAllLocks } from \"./Symbols\";\n\n/**\n * Both the Model and Parent of an element are considered \"owners\" of their member elements. That means:\n * 1) they must hold at least a shared lock before an exclusive lock can be acquired for their members\n * 2) if they hold an exclusive lock, then all of their members are exclusively locked implicitly.\n */\ninterface ElementOwners {\n  readonly modelId: Id64String;\n  readonly parentId: Id64String | undefined;\n}\n\n// eslint-disable-next-line no-restricted-syntax\nconst enum LockOrigin {\n  Acquired = 0,\n  NewElement = 1,\n  Discovered = 2,\n}\n\nexport class ServerBasedLocks implements LockControl {\n  public readonly [_implementationProhibited] = undefined;\n\n  public get isServerBased() { return true; }\n  protected readonly lockDb = new SQLiteDb();\n  protected readonly briefcase: BriefcaseDb;\n  private _removeOnCommitListener: () => void;\n  private _removeOnPushedListener: () => void;\n  /** The local ID portion of the highest element ID pushed to the server. Elements with this briefcase's ID\n   * and a local ID greater than this value are implicitly exclusively locked by us (no server lock required). */\n  private _highWaterLocalId: number = 0;\n  private readonly _unsavedChangesTxnId = \"0x7FFFFFFFFFFFFFFF\"; // a placeholder txn id for locks acquired in the current unsaved Txn\n\n  public constructor(iModel: BriefcaseDb) {\n    this.briefcase = iModel;\n    const dbName = `${iModel[_nativeDb].getTempFileBaseName()}-locks`;\n\n    try {\n      this.lockDb.openDb(dbName, OpenMode.ReadWrite);\n    } catch {\n      this.lockDb.createDb(dbName);\n    }\n\n    this.lockDb[_nativeDb].enableWalMode(true);\n\n    // Tracks the locks that are actively held.\n    this.lockDb.executeSQL(\"CREATE TABLE IF NOT EXISTS locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)\");\n    // Tracks the locks that are required by each Txn. They may or may not currently be held.\n    this.lockDb.executeSQL(`\n      CREATE TABLE IF NOT EXISTS txn_locks(\n        txnId INTEGER NOT NULL,\n        elementId INTEGER NOT NULL,\n        state INTEGER NOT NULL,\n        origin INTEGER NOT NULL,\n        abandoned BOOLEAN NOT NULL,\n        PRIMARY KEY (txnId, elementId))`);\n\n    // Stores persistent metadata, including the high-water mark for new-element lock tracking.\n    this.lockDb.executeSQL(\"CREATE TABLE IF NOT EXISTS metadata(key TEXT PRIMARY KEY NOT NULL,value INTEGER NOT NULL)\");\n\n    // Initialize the high-water mark. If an existing value is stored, use it. Otherwise derive it from\n    // the iModel's current element ID sequence — any element with this briefcase's ID and a local ID at\n    // or below the sequence was either already pushed or was created-then-abandoned in a previous session.\n    const storedHwm = this.lockDb.withSqliteStatement(\n      \"SELECT value FROM metadata WHERE key='highWaterLocalId'\",\n      (stmt) => (DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueInteger(0) : undefined)\n    );\n    if (storedHwm !== undefined) {\n      this._highWaterLocalId = storedHwm;\n    } else {\n      this.updateHighWaterMark();\n    }\n\n    this.lockDb.saveChanges();\n\n    this._removeOnCommitListener = this.briefcase.txns.onCommit.addListener(() => {\n      const committedTxnId = this.briefcase.txns.queryPreviousTxnId(this.briefcase.txns.getCurrentTxnId())\n\n      // With this commit, any reversed txns with the committed txn's ID or greater are no longer reinstatable,\n      // so clear out the record of their locks. If the locks are still held, sorry, it's too late!\n      this.clearTxnLockRecords(committedTxnId);\n\n      // All of the \"current\" changes are now part of a real txn, so update the txn id accordingly.\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET txnId=? WHERE txnId=?\", (stmt) => {\n        stmt.bindId(1, committedTxnId);\n        stmt.bindId(2, this._unsavedChangesTxnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update locks database with txn ID of unsaved changes txn upon saving (error code ${rc})`);\n      });\n\n      this.lockDb.saveChanges();\n    });\n\n    this._removeOnPushedListener = this.briefcase.txns.onChangesPushed.addListener(() => {\n      this.updateHighWaterMark();\n      this.lockDb.saveChanges();\n    });\n  }\n\n  public [_close]() {\n    this._removeOnCommitListener();\n    this._removeOnPushedListener();\n\n    if (this.lockDb.isOpen)\n      this.lockDb.closeDb();\n  }\n\n  private getOwners(id: Id64String): ElementOwners {\n    return this.briefcase.withPreparedSqliteStatement(\"SELECT ModelId,ParentId FROM bis_Element WHERE id=?\", (stmt) => {\n      stmt.bindId(1, id);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_ROW !== rc)\n        throw new IModelError(rc, `element ${id} not found`);\n\n      return { modelId: stmt.getValueId(0), parentId: stmt.getValueId(1) };\n    });\n  }\n\n  private getLockState(id?: Id64String): LockState | undefined {\n    return (id === undefined || !Id64.isValid(id)) ? undefined : this.lockDb.withPreparedSqliteStatement(\"SELECT state FROM locks WHERE id=?\", (stmt) => {\n      stmt.bindId(1, id);\n      return (DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;\n    });\n  }\n\n  /** Read the local ID portion of the iModel's current element ID sequence counter.\n   * The native layer writes this value with BeInt64Id::ToString() (decimal by default) but\n   * BeInt64Id::FromString() accepts both decimal and \"0x\"-prefixed hex. BigInt() has the same\n   * dual-format behavior, so it is the canonical JS equivalent. Mask to the lower 40 bits. */\n  private readCurrentLocalIdSequence(): number {\n    const seqStr = this.briefcase[_nativeDb].queryLocalValue(\"bis_elementidsequence\");\n    if (!seqStr)\n      return 0;\n    return Number(BigInt(seqStr) & 0xFFFFFFFFFFn);\n  }\n\n  /** Persist the current element ID sequence as the new high-water mark. Called after a successful push. */\n  private updateHighWaterMark(): void {\n    this._highWaterLocalId = this.readCurrentLocalIdSequence();\n    this.lockDb.withPreparedSqliteStatement(\n      \"INSERT INTO metadata(key,value) VALUES('highWaterLocalId',?) ON CONFLICT(key) DO UPDATE SET value=excluded.value\",\n      (stmt) => { stmt.bindInteger(1, this._highWaterLocalId); stmt.step(); }\n    );\n  }\n\n  /** Returns true if this element was created by this briefcase after the last push and therefore does not\n   * require a server lock. */\n  private isNewElement(id: Id64String): boolean {\n    return Id64.getBriefcaseId(id) === this.briefcase.briefcaseId && Id64.getLocalId(id) > this._highWaterLocalId;\n  }\n\n  /** Clear the cache of locally held locks.\n   * Note: does *not* release locks from server.\n   */\n  private clearAllLocks() {\n    this.lockDb.executeSQL(\"DELETE FROM locks\");\n    this.lockDb.executeSQL(\"DELETE FROM txn_locks\");\n    this.lockDb.saveChanges();\n  }\n\n  /** only for tests */\n  public getLockCount(state: LockState): number {\n    return this.lockDb.withSqliteStatement(\"SELECT count(*) FROM locks WHERE state=?\", (stmt) => {\n      stmt.bindInteger(1, state);\n      stmt.step();\n      return stmt.getValueInteger(0);\n    });\n  }\n\n  public async [_releaseAllLocks](): Promise<void> {\n    await IModelHost[_hubAccess].releaseAllLocks(this.briefcase); // throws if unsuccessful\n    this.clearAllLocks();\n  }\n\n  public async releaseAllLocks(): Promise<void> {\n    if (this.briefcase.txns.hasLocalChanges) {\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be released while the briefcase contains local changes\");\n    }\n\n    return this[_releaseAllLocks]();\n  }\n\n  public async abandonAllLocks(): Promise<void> {\n    if (this.briefcase.txns.hasLocalChanges) {\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be abandoned while the briefcase contains local changes\");\n    }\n\n    if (IModelHost[_hubAccess].abandonAllLocks === undefined) {\n      // If the IModelHub doesn't support an explicit abandon, call release with a blank changeset to indicate\n      // that locks should be released without updating the changeset associated with the locks.\n      await IModelHost[_hubAccess].releaseAllLocks({\n        iModelId: this.briefcase.iModelId,\n        briefcaseId: this.briefcase.briefcaseId,\n        changeset: { id: \"\", index: 0 }\n      });\n    } else {\n      await IModelHost[_hubAccess].abandonAllLocks(this.briefcase);\n    }\n\n    this.clearAllLocks();\n  }\n\n  private insertLock(id: Id64String, state: LockState, origin: LockOrigin): true {\n    this.lockDb.withPreparedSqliteStatement(\"INSERT INTO locks(id,state,origin) VALUES (?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,origin=excluded.origin\", (stmt) => {\n      stmt.bindId(1, id);\n      stmt.bindInteger(2, state);\n      stmt.bindInteger(3, origin);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        throw new IModelError(rc, \"can't insert lock into database\");\n    });\n\n    return true;\n  }\n\n  private insertTxnLockRecord(id: Id64String, state: LockState, origin: LockOrigin): void {\n    // Locks are always acquired in the current txn, which isn't a real txn until it's committed.\n    // So use a placeholder txn id for now, and we'll update to the real txn id on commit.\n    // This is important to distinguish new locks acquired in the current txn from locks acquired in previous reversed txns, which will only\n    // be cleared (no longer reinstateable) on commit.\n    this.lockDb.withPreparedSqliteStatement(`\n      INSERT INTO txn_locks(txnId,elementId,state,origin,abandoned)\n      VALUES (?,?,?,?,FALSE)\n      ON CONFLICT(txnId,elementId)\n        DO UPDATE SET\n          state=excluded.state,\n          origin=excluded.origin,\n          abandoned=excluded.abandoned`, (stmt) => {\n      stmt.bindId(1, this._unsavedChangesTxnId);\n      stmt.bindId(2, id);\n      stmt.bindInteger(3, state);\n      stmt.bindInteger(4, origin);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't insert txn lock record into database (error code ${rc})`);\n    });\n  }\n\n  private ownerHoldsExclusiveLock(id: Id64String | undefined): boolean {\n    if (id === undefined || id === IModel.rootSubjectId)\n      return false; // has no owners\n\n    const { modelId, parentId } = this.getOwners(id);\n    if (this.getLockState(modelId) === LockState.Exclusive || this.getLockState(parentId) === LockState.Exclusive)\n      return true;\n\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.\n    if (this.ownerHoldsExclusiveLock(modelId))\n      return this.insertLock(modelId, LockState.Exclusive, LockOrigin.Discovered);\n\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.\n    return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId!, LockState.Exclusive, LockOrigin.Discovered) : false; // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  }\n\n  /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */\n  public holdsExclusiveLock(id: Id64String): boolean {\n    // New elements (created by this briefcase since the last push) are implicitly exclusively locked.\n    if (this.isNewElement(id))\n      return true;\n    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\n  }\n\n  public holdsSharedLock(id: Id64String): boolean {\n    // New elements are implicitly exclusively locked, which implies shared lock too.\n    if (this.isNewElement(id))\n      return true;\n    const state = this.getLockState(id);\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.\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\n  }\n\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. */\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\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\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\n      return;\n\n    locks.add(id); // add to set of needed shared locks\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\n  }\n\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\n    const el = this.getOwners(id);\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\n    this.addSharedLock(el.modelId, locks); // check its model\n  }\n\n  /** attempt to acquire all necessary locks for a set of elements */\n  private async acquireAllLocks(locks: LockMap) {\n    if (locks.size === 0) // no locks are required.\n      return;\n\n    const sharedLocks = new Set<Id64String>();\n    for (const lock of locks)\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\n\n    for (const shared of sharedLocks) {\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\n        locks.set(shared, LockState.Shared);\n    }\n\n    await IModelHost[_hubAccess].acquireLocks(this.briefcase, locks); // throws if unsuccessful\n    for (const lock of locks) {\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\n      this.insertTxnLockRecord(lock[0], lock[1], LockOrigin.Acquired);\n    }\n    this.lockDb.saveChanges();\n  }\n\n  public async acquireLocks(arg: { shared?: Id64Arg, exclusive?: Id64Arg }): Promise<void> {\n    const locks = new Map<Id64String, LockState>();\n    if (arg.shared) {\n      for (const id of Id64.iterable(arg.shared)) {\n        if (!this.holdsSharedLock(id))\n          locks.set(id, LockState.Shared);\n      }\n    }\n    if (arg.exclusive) {\n      for (const id of Id64.iterable(arg.exclusive)) {\n        if (!this.holdsExclusiveLock(id))\n          locks.set(id, LockState.Exclusive);\n      }\n    }\n    return this.acquireAllLocks(locks);\n  }\n\n  private async abandonLocks(locks: LockMap): Promise<void> {\n    if (IModelHost[_hubAccess].abandonLocks === undefined) {\n      // If the IModelHub doesn't support an explicit abandon, call acquireLocks with a blank changeset to indicate\n      // that locks should be released without updating the changeset associated with the locks.\n      await IModelHost[_hubAccess].acquireLocks({\n        iModelId: this.briefcase.iModelId,\n        briefcaseId: this.briefcase.briefcaseId,\n        changeset: { id: \"\", index: 0 }\n      }, locks);\n    } else {\n      await IModelHost[_hubAccess].abandonLocks(this.briefcase, locks);\n    }\n  }\n\n  public async abandonLocksForCurrentUnsavedTxn(): Promise<boolean> {\n    return this.abandonLocksForReversedTxn(this._unsavedChangesTxnId);\n  }\n\n  public async abandonLocksForReversedTxn(txnId: Id64String): Promise<boolean> {\n    if (this.briefcase.txns.hasUnsavedChanges)\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot abandon locks for txn ${txnId} because the current txn has unsaved changes`);\n\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\n    if (txnProps === undefined) {\n      // The current txn commonly won't exist on the TxnManager yet. It's often just a placeholder for not-yet-saved changes.\n      // (Sometimes it will exist and refer to a reversed Txn).\n      // The unsavedChangesTxnId won't exist on the TxnManager either, of course.\n      // But all other txn ids must be known to the TxnManager or it is an error.\n      if (txnId !== this.briefcase.txns.getCurrentTxnId() && txnId !== this._unsavedChangesTxnId)\n        ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot abandon locks for txn ${txnId} because it does not exist`);\n    } else {\n      // If the txn id is known to the TxnManager, then we require that it has already been reversed.\n      if (!txnProps.reversed)\n        ServerBasedLocksError.throwError(\"txn-not-reversed\", `cannot abandon locks for txn ${txnId} because it has not been reversed`);\n    }\n\n    let locksReleased = false;\n\n    // Abandon locks for unsaved (and now abandoned) changes.\n    if (txnId !== this._unsavedChangesTxnId) {\n      locksReleased = await this.abandonLocksForCurrentUnsavedTxn();\n    }\n\n    // At this point, we know:\n    // 1. There are no unsaved changes, and the associated locks have been abandoned.\n    // 2. The given txn ID has been reversed, which means any later txns are sure to have been reversed, too.\n\n    // So we simply have to find all non-abandoned locks associated with the given txn or later, abandon them (or restore\n    // them to their previous state), and mark them as abandoned in txn_locks.\n\n    // Find all locks associated with the given txnId or later.\n    // For each elementId, find the previous state of the lock before this Txn (if any), or None otherwise.\n    // This is the state that we will restore the element's lock to. The reason we do this is to account for\n    // lock upgrades. If an earlier Txn acquired a Shared lock on this element, and this Txn acquired an\n    // Exclusive lock, we should restore the Shared lock.\n    const allTxnLocks = new Map<Id64String, LockState>();\n    const locksToRelease = new Map<Id64String, LockState>();\n    this.lockDb.withPreparedSqliteStatement(\n      `\n        SELECT\n          current.elementId,\n          current.origin,\n          IFNULL(\n            (SELECT previous.state\n              FROM txn_locks previous\n              WHERE previous.elementId = current.elementId\n                AND previous.txnId < ?2\n                AND previous.abandoned=FALSE\n              ORDER BY previous.txnId DESC\n              LIMIT 1\n            ),\n            ?1\n          ) AS previousState\n        FROM txn_locks current\n        WHERE current.txnId>=?2\n          AND current.abandoned=FALSE\n        ORDER BY current.txnId DESC\n      `,\n      (stmt) => {\n        stmt.bindInteger(1, LockState.None);\n        stmt.bindId(2, txnId);\n\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\n          const elementId = stmt.getValueId(0);\n          const origin = stmt.getValueInteger(1);\n          const previousState = stmt.getValueInteger(2);\n          allTxnLocks.set(elementId, previousState);\n          if (origin !== LockOrigin.NewElement)\n            locksToRelease.set(elementId, previousState);\n        }\n      });\n\n    // Release the locks on the server.\n    if (locksToRelease.size > 0)\n      await this.abandonLocks(locksToRelease);\n\n    // Mark the txn locks as abandoned.\n    if (txnId === this._unsavedChangesTxnId) {\n      // After abandoning locks held for the \"unsaved\" txn, we clear them completely because they are not reinstateable.\n      this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId=?\", (stmt) => {\n        stmt.bindId(1, this._unsavedChangesTxnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn locks for unsaved changes in database (error code ${rc})`);\n      });\n    } else {\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=TRUE WHERE txnId>=?\", (stmt) => {\n        stmt.bindId(1, txnId);\n        const rc = stmt.step();\n        if (DbResult.BE_SQLITE_DONE !== rc)\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as abandoned in database (error code ${rc})`);\n      });\n    }\n\n    // Restore each lock to its previous state (if any) in the local cache. Usually this means deleting it.\n    for (const [elementId, previousState] of allTxnLocks) {\n      if (previousState === LockState.None) {\n        this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE id=?\", (stmt) => {\n          stmt.bindId(1, elementId);\n          const rc = stmt.step();\n          if (DbResult.BE_SQLITE_DONE !== rc)\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete lock from database (error code ${rc})`);\n        });\n      } else {\n        this.lockDb.withPreparedSqliteStatement(\"UPDATE locks SET state=? WHERE id=?\", (stmt) => {\n          stmt.bindInteger(1, previousState);\n          stmt.bindId(2, elementId);\n          const rc = stmt.step();\n          if (DbResult.BE_SQLITE_DONE !== rc)\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update lock in database (error code ${rc})`);\n        });\n      }\n    }\n\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\n    this.clearDiscoveredLocks();\n\n    this.lockDb.saveChanges();\n\n    return locksReleased || allTxnLocks.size > 0;\n  }\n\n  private getAbandonedLocksForTxn(txnId: Id64String): {\n    newElementLocks: Map<Id64String, LockState>,\n    locksToAcquire: Map<Id64String, LockState>\n  } {\n    const newElementLocks = new Map<Id64String, LockState>();\n    const locksToAcquire = new Map<Id64String, LockState>();\n    this.lockDb.withPreparedSqliteStatement(\n      \"SELECT elementId, state, origin FROM txn_locks WHERE txnId<=? AND abandoned=TRUE\",\n      (stmt) => {\n        stmt.bindId(1, txnId);\n\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\n          const elementId = stmt.getValueId(0);\n          const state = stmt.getValueInteger(1);\n          const origin = stmt.getValueInteger(2);\n          if (origin === LockOrigin.NewElement)\n            newElementLocks.set(elementId, state);\n          else\n            locksToAcquire.set(elementId, state);\n        }\n      });\n\n    return { newElementLocks, locksToAcquire };\n  }\n\n  public async acquireLocksForReinstatingTxn(txnId: Id64String): Promise<boolean> {\n    if (this.briefcase.txns.hasUnsavedChanges)\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot acquire locks for reinstating txn ${txnId} because the current txn has unsaved changes`);\n\n    // If the Txn is known to the TxnManager, we can proceed. We don't need to check if it is currently\n    // reversed, because if it isn't, then abandonLocksForReversedTxn couldn't have been called, and so the\n    // locks are still held. Proceeding with this method will be a no-op, but it will be harmless.\n    // However, if the Txn Id is unknown, it may have been canceled or refer to the current Txn\n    // whose unsaved changes were just abandoned. Or it's just plain-old invalid. In any case, we can't\n    // re-acquire the associated locks.\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\n    if (txnProps === undefined) {\n      ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot acquire locks for txn ${txnId} because it does not exist or has not been saved`);\n    }\n\n    // Find all locks associated with the given txnId.\n    const { newElementLocks, locksToAcquire } = this.getAbandonedLocksForTxn(txnId);\n\n    // Attempt to acquire the locks on the server. This may fail if the locks are no longer available!\n    if (locksToAcquire.size > 0)\n      await IModelHost[_hubAccess].acquireLocks(this.briefcase, locksToAcquire); // throws if unsuccessful\n\n    // Mark the txn locks as no longer abandoned.\n    this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=FALSE WHERE txnId<=?\", (stmt) => {\n      stmt.bindId(1, txnId);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as no longer abandoned in database (error code ${rc})`);\n    });\n\n    // Insert the newly-acquired locks in the local cache. Note that we don't need to insert entries in the txn_locks table,\n    // because these locks are already associated with the Txn.\n    for (const [elementId, state] of locksToAcquire) {\n      this.insertLock(elementId, state, LockOrigin.Acquired);\n    }\n    for (const [elementId, state] of newElementLocks) {\n      this.insertLock(elementId, state, LockOrigin.NewElement);\n    }\n\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\n    this.clearDiscoveredLocks();\n\n    this.lockDb.saveChanges();\n\n    return locksToAcquire.size > 0 || newElementLocks.size > 0;\n  }\n\n  public holdsNecessaryLocksForReinstatingTxn(txnId: Id64String): boolean {\n    const locks = this.getAbandonedLocksForTxn(txnId);\n    return locks.locksToAcquire.size === 0 && locks.newElementLocks.size === 0;\n  }\n\n  public clearTxnLockRecords(txnId: Id64String) {\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId!=? AND txnId>=?\", (stmt) => {\n      stmt.bindId(1, this._unsavedChangesTxnId);\n      stmt.bindId(2, txnId);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn lock records from database (error code ${rc})`);\n    });\n\n    this.lockDb.saveChanges();\n  }\n\n  /** When an element is newly created in a session, we hold the lock on it implicitly.\n   * For elements whose local ID is above the high-water mark this is already handled by [[isNewElement]],\n   * so no database write is needed. The only case that does require a write is when the element's ID is\n   * at or below the high-water mark (e.g. when re-applying a stash whose elements were created before\n   * the last push). */\n  public [_elementWasCreated](id: Id64String) {\n    if (this.isNewElement(id))\n      return; // already covered implicitly; no database write needed\n    this.insertLock(id, LockState.Exclusive, LockOrigin.NewElement);\n    this.insertTxnLockRecord(id, LockState.Exclusive, LockOrigin.NewElement);\n    this.lockDb.saveChanges();\n  }\n\n  private clearDiscoveredLocks() {\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE origin=?\", (stmt) => {\n      stmt.bindInteger(1, LockOrigin.Discovered);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc)\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete discovered locks from database (error code ${rc})`);\n    });\n  }\n\n  /** locks are not necessary during change propagation. */\n  private get _locksAreRequired() { return !this.briefcase.txns.isIndirectChanges; }\n\n  /** throw if locks are currently required and the exclusive lock is not held on the supplied element */\n  public checkExclusiveLock(id: Id64String, type: string, operation: string) {\n    if (this._locksAreRequired && !this.holdsExclusiveLock(id))\n      throw new IModelError(IModelStatus.LockNotHeld, `exclusive lock not held on ${type} for ${operation} (id=${id})`);\n  }\n\n  /** throw if locks are currently required and a shared lock is not held on the supplied element */\n  public checkSharedLock(id: Id64String, type: string, operation: string) {\n    if (this._locksAreRequired && !this.holdsSharedLock(id))\n      throw new IModelError(IModelStatus.LockNotHeld, `shared lock not held on ${type} for ${operation} (id=${id})`);\n  }\n\n}\n\nexport function createServerBasedLocks(iModel: BriefcaseDb): LockControl {\n  return new ServerBasedLocks(iModel);\n}\n"]}

package/lib/cjs/internal/cross-package.d.ts

@@ -1,4 +1,4 @@
 export { IModelJsNative, NativeCloudSqlite, NativeLoggerCategory } from "@bentley/imodeljs-native";
 export { IModelNative } from "./NativePlatform";
-export { _implicitTxn, _nativeDb, } from "./Symbols";
+export { _nativeDb, } from "./Symbols";
 //# sourceMappingURL=cross-package.d.ts.map

package/lib/cjs/internal/cross-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-package.d.ts","sourceRoot":"","sources":["../../../src/internal/cross-package.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,SAAS,GACV,MAAM,WAAW,CAAC"}
+{"version":3,"file":"cross-package.d.ts","sourceRoot":"","sources":["../../../src/internal/cross-package.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,SAAS,GACV,MAAM,WAAW,CAAC"}

package/lib/cjs/internal/cross-package.js

@@ -4,7 +4,7 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._nativeDb = exports._implicitTxn = exports.IModelNative = exports.NativeLoggerCategory = exports.NativeCloudSqlite = exports.IModelJsNative = void 0;
+exports._nativeDb = exports.IModelNative = exports.NativeLoggerCategory = exports.NativeCloudSqlite = exports.IModelJsNative = void 0;
 var imodeljs_native_1 = require("@bentley/imodeljs-native");
 Object.defineProperty(exports, "IModelJsNative", { enumerable: true, get: function () { return imodeljs_native_1.IModelJsNative; } });
 Object.defineProperty(exports, "NativeCloudSqlite", { enumerable: true, get: function () { return imodeljs_native_1.NativeCloudSqlite; } });
@@ -12,6 +12,5 @@ Object.defineProperty(exports, "NativeLoggerCategory", { enumerable: true, get:
 var NativePlatform_1 = require("./NativePlatform");
 Object.defineProperty(exports, "IModelNative", { enumerable: true, get: function () { return NativePlatform_1.IModelNative; } });
 var Symbols_1 = require("./Symbols");
-Object.defineProperty(exports, "_implicitTxn", { enumerable: true, get: function () { return Symbols_1._implicitTxn; } });
 Object.defineProperty(exports, "_nativeDb", { enumerable: true, get: function () { return Symbols_1._nativeDb; } });
 //# sourceMappingURL=cross-package.js.map

package/lib/cjs/internal/cross-package.js.map

@@ -1 +1 @@
-{"version":3,"file":"cross-package.js","sourceRoot":"","sources":["../../../src/internal/cross-package.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,4DAAmG;AAA1F,iHAAA,cAAc,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAChE,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,qCAGmB;AAFjB,uGAAA,YAAY,OAAA;AACZ,oGAAA,SAAS,OAAA","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport { IModelJsNative, NativeCloudSqlite, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nexport { IModelNative } from \"./NativePlatform\";\nexport {\n  _implicitTxn,\n  _nativeDb,\n} from \"./Symbols\";\n"]}
+{"version":3,"file":"cross-package.js","sourceRoot":"","sources":["../../../src/internal/cross-package.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAE/F,4DAAmG;AAA1F,iHAAA,cAAc,OAAA;AAAE,oHAAA,iBAAiB,OAAA;AAAE,uHAAA,oBAAoB,OAAA;AAChE,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,qCAEmB;AADjB,oGAAA,SAAS,OAAA","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport { IModelJsNative, NativeCloudSqlite, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nexport { IModelNative } from \"./NativePlatform\";\nexport {\n  _nativeDb,\n} from \"./Symbols\";\n"]}

package/lib/cjs/internal/workspace/SettingsSchemasImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemasImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSchemasImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAQH,OAAO,EAAqC,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAyRrG,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D"}
+{"version":3,"file":"SettingsSchemasImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSchemasImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAQH,OAAO,EAAqC,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAqVrG,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D"}

package/lib/cjs/internal/workspace/SettingsSchemasImpl.js

@@ -18,6 +18,7 @@ const makeSettingKey = (prefix, key) => `${prefix}/${key}`;
 class SettingsSchemasImpl {
     [Symbols_1._implementationProhibited] = undefined;
     _allGroups = new Map();
+    get groups() { return this._allGroups; }
     /** a map of all registered Setting Definitions  */
     settingDefs = new Map();
     /** a map of all registered TypeDefs  */
@@ -43,33 +44,43 @@ class SettingsSchemasImpl {
             this.validateProperty(value, settingDef, settingName);
         return value;
     }
+    getResolvedSettingDef(settingName) {
+        const schema = this.settingDefs.get(settingName);
+        return schema ? this.resolveSchema(schema, settingName) : undefined;
+    }
     /** @internal */
-    getObjectProperties(propDef, scope) {
+    getObjectProperties(propDef, scope, visited = []) {
         let required = propDef.required;
         let properties = propDef.properties;
+        let nextVisited = visited;
         // if this object extends a typeDef, add typeDef's properties and required values, recursively
         if (propDef.extends !== undefined) {
+            if (visited.includes(propDef.extends))
+                throw new Error(`circular typeDef reference detected: ${[...visited, propDef.extends].join(" -> ")}`);
             const typeDef = this.typeDefs.get(propDef.extends);
             if (undefined === typeDef)
-                throw new Error(`typeDef ${propDef.extends} does not exist for ${scope}`);
-            const expanded = this.getObjectProperties(typeDef, `${scope}.${propDef.extends}`);
+                throw new Error(`typeDef ${propDef.extends} does not exist${scope ? ` for ${scope}` : ""}`);
+            const expanded = this.getObjectProperties(typeDef, scope ? `${scope}.${propDef.extends}` : propDef.extends, [...visited, propDef.extends]);
+            nextVisited = expanded.visited;
             if (expanded.required)
-                required = required ? [...required, ...expanded.required] : expanded.required;
+                required = required ? [...new Set([...required, ...expanded.required])] : expanded.required;
             if (expanded.properties) {
                 properties = properties ? { ...expanded.properties, ...properties } : expanded.properties;
             }
         }
         properties = properties ?? {};
-        return { required, properties };
+        return { required, properties, visited: nextVisited };
     }
     /** @internal */
-    getArrayItems(propDef, scope) {
+    getArrayItems(propDef, scope, visited = []) {
         let items = propDef.items;
         if (undefined === items && propDef.extends) {
+            if (visited.includes(propDef.extends))
+                throw new Error(`circular typeDef reference detected: ${[...visited, propDef.extends].join(" -> ")}`);
             const typeDef = this.typeDefs.get(propDef.extends);
             if (undefined === typeDef)
-                throw new Error(`typeDef ${propDef.extends} does not exist for ${scope}`);
-            items = typeDef.items;
+                throw new Error(`typeDef ${propDef.extends} does not exist${scope ? ` for ${scope}` : ""}`);
+            items = this.getArrayItems(typeDef, scope ? `${scope}.${propDef.extends}` : propDef.extends, [...visited, propDef.extends]);
         }
         if (undefined === items)
             throw new Error(`array ${scope} has no items definition`);
@@ -153,6 +164,41 @@ class SettingsSchemasImpl {
         this.doRemove(schemaPrefix);
         this.onSchemaChanged.raiseEvent();
     }
+    resolveSchema(schema, scope = "", visited = []) {
+        const { extends: _extends, ...resolved } = schema;
+        switch (schema.type) {
+            case "object": {
+                const { required, properties, visited: resolvedVisited } = this.getObjectProperties(schema, scope, visited);
+                return {
+                    ...resolved,
+                    required,
+                    properties: Object.fromEntries(Object.entries(properties).map(([key, value]) => [
+                        key,
+                        this.resolveSchema(value, scope ? `${scope}.${key}` : key, resolvedVisited),
+                    ])),
+                };
+            }
+            case "array": {
+                const items = this.getArrayItems(schema, scope, visited);
+                let resolvedSchema = resolved;
+                if (schema.extends) {
+                    if (visited.includes(schema.extends))
+                        throw new Error(`circular typeDef reference detected: ${[...visited, schema.extends].join(" -> ")}`);
+                    const typeDef = this.typeDefs.get(schema.extends);
+                    if (undefined === typeDef)
+                        throw new Error(`typeDef ${schema.extends} does not exist${scope ? ` for ${scope}` : ""}`);
+                    const inheritedProps = this.resolveSchema(typeDef, scope ? `${scope}.${schema.extends}` : schema.extends, [...visited, schema.extends]);
+                    resolvedSchema = { ...inheritedProps, ...resolvedSchema };
+                }
+                return {
+                    ...resolvedSchema,
+                    items: this.resolveSchema(items, scope ? `${scope}.items` : "items", visited),
+                };
+            }
+            default:
+                return resolved;
+        }
+    }
     doAdd(settingsGroup) {
         settingsGroup.forEach((group) => {
             if (undefined === group.schemaPrefix)
@@ -170,7 +216,7 @@ class SettingsSchemasImpl {
         }
         if (undefined !== group?.typeDefs) {
             for (const key of Object.keys(group.typeDefs))
-                this.settingDefs.delete(makeSettingKey(schemaPrefix, key));
+                this.typeDefs.delete(makeSettingKey(schemaPrefix, key));
         }
         this._allGroups.delete(schemaPrefix);
     }

package/lib/cjs/internal/workspace/SettingsSchemasImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemasImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSchemasImpl.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { assert, BeEvent, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../../IModelJsFs\";\nimport { SettingGroupSchema, SettingSchema, SettingsSchemas } from \"../../workspace/SettingsSchemas\";\nimport { _implementationProhibited } from \"../Symbols\";\n\nconst makeSettingKey = (prefix: string, key: string) => `${prefix}/${key}`;\n\nclass SettingsSchemasImpl implements SettingsSchemas {\n  public readonly [_implementationProhibited] = undefined;\n  private readonly _allGroups = new Map<string, SettingGroupSchema>();\n  /** a map of all registered Setting Definitions  */\n  public readonly settingDefs = new Map<string, SettingSchema>();\n  /** a map of all registered TypeDefs  */\n  public readonly typeDefs = new Map<string, SettingSchema>();\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\n  public readonly onSchemaChanged = new BeEvent<() => void>();\n\n  private verifyType<T>(val: T, expectedType: JSONSchemaTypeName, path: string) {\n    if (expectedType === \"integer\") {\n      if (Number.isInteger(val))\n        return;\n    } else if (expectedType === \"null\") {\n      if (val === null || val === undefined)\n        return;\n    } else if (typeof val === expectedType)\n      return;\n\n    throw new Error(`value for ${path}: \"${String(val)}\" is wrong type, expected ${expectedType}`);\n  }\n\n  public validateSetting<T>(value: T, settingName: string): T {\n    const settingDef = this.settingDefs.get(settingName);\n    if (undefined !== settingDef) // if there's no setting definition, there's no rules so just return ok\n      this.validateProperty(value, settingDef, settingName);\n    return value;\n  }\n\n  /** @internal */\n  public getObjectProperties(propDef: Readonly<SettingSchema>, scope: string): { required?: string[], properties: { [name: string]: SettingSchema } } {\n    let required = propDef.required;\n    let properties = propDef.properties;\n\n    // if this object extends a typeDef, add typeDef's properties and required values, recursively\n    if (propDef.extends !== undefined) {\n      const typeDef = this.typeDefs.get(propDef.extends);\n      if (undefined === typeDef)\n        throw new Error(`typeDef ${propDef.extends} does not exist for ${scope}`);\n      const expanded = this.getObjectProperties(typeDef, `${scope}.${propDef.extends}`);\n      if (expanded.required)\n        required = required ? [...required, ...expanded.required] : expanded.required;\n      if (expanded.properties) {\n        properties = properties ? { ...expanded.properties, ...properties } : expanded.properties;\n      }\n    }\n    properties = properties ?? {};\n    return { required, properties };\n  }\n\n  /** @internal */\n  public getArrayItems(propDef: Readonly<SettingSchema>, scope: string): SettingSchema {\n    let items = propDef.items;\n    if (undefined === items && propDef.extends) {\n      const typeDef = this.typeDefs.get(propDef.extends);\n      if (undefined === typeDef)\n        throw new Error(`typeDef ${propDef.extends} does not exist for ${scope}`);\n      items = typeDef.items;\n    }\n    if (undefined === items)\n      throw new Error(`array ${scope} has no items definition`);\n    return items;\n  }\n\n  private validateProperty<T>(val: T, propDef: Readonly<SettingSchema>, path: string) {\n    switch (propDef.type) {\n      case \"boolean\":\n      case \"number\":\n      case \"string\":\n      case \"integer\":\n      case \"null\":\n        return this.verifyType(val, propDef.type, path);\n\n      case \"array\":\n        if (!Array.isArray(val))\n          throw new Error(`Property ${path} must be an array`);\n        const items = this.getArrayItems(propDef, path);\n        for (let i = 0; i < val.length; ++i)\n          this.validateProperty(val[i], items, `${path}[${i}]`);\n        return;\n    }\n    if (!val || typeof val !== \"object\")\n      throw new Error(`${path} must be an object`);\n\n    const { required, properties } = this.getObjectProperties(propDef, path);\n\n    // first ensure all required properties are present\n    if (undefined !== required) {\n      for (const entry of required) {\n        const value = (val as any)[entry];\n        if (undefined === value)\n          throw new Error(`required value for \"${entry}\" is missing in \"${path}\"`);\n      }\n    }\n\n    // you can supply default values in typeDefs. See if any members are undefined that have a default.\n    if (undefined !== properties) {\n      for (const [key, prop] of Object.entries(properties)) {\n        if ((val as any)[key] === undefined && prop.default)\n          (val as any)[key] = prop.default;\n      }\n    }\n\n    // then validate all values in the supplied object are valid\n    for (const key of Object.keys(val)) {\n      const prop = properties[key];\n      if (prop !== undefined) { // note: extra values are ignored.\n        this.validateProperty((val as any)[key], prop, `${path}.${key}`);\n      }\n    }\n  }\n\n  /**\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`s must include a `schemaPrefix` member that is used\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\n   */\n  public addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void {\n    if (!Array.isArray(settingsGroup))\n      settingsGroup = [settingsGroup];\n\n    this.doAdd(settingsGroup);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\n  public addJson(settingSchema: string): void {\n    this.addGroup(parse(settingSchema));\n  }\n\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\n  public addFile(fileName: LocalFileName): void {\n    try {\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\n    } catch (e: any) {\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\n    }\n  }\n\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\n  public addDirectory(dirName: LocalDirName) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName));\n    }\n  }\n\n  /** Remove a previously added [[SettingSchemaGroup]] by schemaPrefix */\n  public removeGroup(schemaPrefix: string): void {\n    this.doRemove(schemaPrefix);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  private doAdd(settingsGroup: SettingGroupSchema[]) {\n    settingsGroup.forEach((group) => {\n      if (undefined === group.schemaPrefix)\n        throw new Error(`settings group has no \"schemaPrefix\" member`);\n\n      this.doRemove(group.schemaPrefix);\n      this.validateAndAdd(group);\n      this._allGroups.set(group.schemaPrefix, group);\n    });\n  }\n\n  private doRemove(schemaPrefix: string) {\n    const group = this._allGroups.get(schemaPrefix);\n    if (undefined !== group?.settingDefs) {\n      for (const key of Object.keys(group.settingDefs))\n        this.settingDefs.delete(makeSettingKey(schemaPrefix, key));\n    }\n    if (undefined !== group?.typeDefs) {\n      for (const key of Object.keys(group.typeDefs))\n        this.settingDefs.delete(makeSettingKey(schemaPrefix, key));\n    }\n    this._allGroups.delete(schemaPrefix);\n  }\n\n  private validateName(name: string) {\n    if (!name.trim())\n      throw new Error(`empty property name`);\n  }\n\n  private verifyPropertyDef(name: string, property: SettingSchema | undefined) {\n    if (!property)\n      throw new Error(`missing required property ${name}`);\n\n    if (!property.type)\n      throw new Error(`property ${name} has no type`);\n\n    switch (property.type) {\n      case \"boolean\":\n      case \"integer\":\n      case \"null\":\n      case \"number\":\n      case \"string\":\n        return;\n\n      case \"object\":\n        const required = property.required;\n        const props = property.properties;\n        if (required && props) {\n          for (const entry of required) {\n            if (undefined === props[entry])\n              throw new Error(`missing required property of ${name}: \"${entry}\"`);\n          }\n        }\n        if (props) {\n          for (const key of Object.keys(props))\n            try {\n              this.verifyPropertyDef(key, props[key]);\n            } catch (e: any) {\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\n            }\n        }\n        return;\n\n      case \"array\":\n        if (typeof property.extends === \"string\")\n          return;\n        if (typeof property.items !== \"object\")\n          throw new Error(`array property ${name} has no items member`);\n        try {\n          this.verifyPropertyDef(\"items\", property.items);\n        } catch (e: any) {\n          throw new Error(`array property ${name}: ${e.message}`);\n        }\n        return;\n\n      default:\n        throw new Error(`property ${name} has illegal type \"${String(property.type)}\"`);\n    }\n  }\n\n  private validateAndAdd(group: SettingGroupSchema) {\n    const settingDefs = group.settingDefs;\n    if (undefined !== settingDefs) {\n      for (const key of Object.keys(settingDefs)) {\n        this.validateName(key);\n        this.verifyPropertyDef(key, settingDefs[key]);\n        const property: Mutable<SettingSchema> | undefined = settingDefs[key];\n        assert(undefined !== property);\n        property.default = property.default ?? this.getDefaultValue(property.type);\n        this.settingDefs.set(makeSettingKey(group.schemaPrefix, key), property);\n      }\n    }\n    const typeDefs = group.typeDefs ?? {};\n    for (const key of Object.keys(typeDefs)) {\n      this.validateName(key);\n      this.verifyPropertyDef(key, typeDefs[key]);\n      const typeDef = typeDefs[key];\n      assert(undefined !== typeDef);\n      this.typeDefs.set(makeSettingKey(group.schemaPrefix, key), typeDef);\n    }\n  }\n\n  private getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\n    type = Array.isArray(type) ? type[0] : type;\n    switch (type) {\n      case \"boolean\":\n        return false;\n      case \"integer\":\n      case \"number\":\n        return 0;\n      case \"string\":\n        return \"\";\n      case \"array\":\n        return [];\n      case \"object\":\n        return {};\n      default:\n        return undefined;\n    }\n  }\n}\n\nexport function constructSettingsSchemas(): SettingsSchemas {\n  return new SettingsSchemasImpl();\n}\n"]}
+{"version":3,"file":"SettingsSchemasImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSchemasImpl.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { assert, BeEvent, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../../IModelJsFs\";\nimport { SettingGroupSchema, SettingSchema, SettingsSchemas } from \"../../workspace/SettingsSchemas\";\nimport { _implementationProhibited } from \"../Symbols\";\n\nconst makeSettingKey = (prefix: string, key: string) => `${prefix}/${key}`;\n\nclass SettingsSchemasImpl implements SettingsSchemas {\n  public readonly [_implementationProhibited] = undefined;\n  private readonly _allGroups = new Map<string, SettingGroupSchema>();\n  public get groups(): ReadonlyMap<string, SettingGroupSchema> { return this._allGroups; }\n  /** a map of all registered Setting Definitions  */\n  public readonly settingDefs = new Map<string, SettingSchema>();\n  /** a map of all registered TypeDefs  */\n  public readonly typeDefs = new Map<string, SettingSchema>();\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\n  public readonly onSchemaChanged = new BeEvent<() => void>();\n\n  private verifyType<T>(val: T, expectedType: JSONSchemaTypeName, path: string) {\n    if (expectedType === \"integer\") {\n      if (Number.isInteger(val))\n        return;\n    } else if (expectedType === \"null\") {\n      if (val === null || val === undefined)\n        return;\n    } else if (typeof val === expectedType)\n      return;\n\n    throw new Error(`value for ${path}: \"${String(val)}\" is wrong type, expected ${expectedType}`);\n  }\n\n  public validateSetting<T>(value: T, settingName: string): T {\n    const settingDef = this.settingDefs.get(settingName);\n    if (undefined !== settingDef) // if there's no setting definition, there's no rules so just return ok\n      this.validateProperty(value, settingDef, settingName);\n    return value;\n  }\n\n  public getResolvedSettingDef(settingName: string): SettingSchema | undefined {\n    const schema = this.settingDefs.get(settingName);\n    return schema ? this.resolveSchema(schema, settingName) : undefined;\n  }\n\n  /** @internal */\n  public getObjectProperties(propDef: Readonly<SettingSchema>, scope: string, visited: string[] = []): { required?: string[], properties: { [name: string]: SettingSchema }, visited: string[] } {\n    let required = propDef.required;\n    let properties = propDef.properties;\n    let nextVisited = visited;\n\n    // if this object extends a typeDef, add typeDef's properties and required values, recursively\n    if (propDef.extends !== undefined) {\n      if (visited.includes(propDef.extends))\n        throw new Error(`circular typeDef reference detected: ${[...visited, propDef.extends].join(\" -> \")}`);\n\n      const typeDef = this.typeDefs.get(propDef.extends);\n      if (undefined === typeDef)\n        throw new Error(`typeDef ${propDef.extends} does not exist${scope ? ` for ${scope}` : \"\"}`);\n      const expanded = this.getObjectProperties(typeDef, scope ? `${scope}.${propDef.extends}` : propDef.extends, [...visited, propDef.extends]);\n      nextVisited = expanded.visited;\n      if (expanded.required)\n        required = required ? [...new Set([...required, ...expanded.required])] : expanded.required;\n      if (expanded.properties) {\n        properties = properties ? { ...expanded.properties, ...properties } : expanded.properties;\n      }\n    }\n    properties = properties ?? {};\n    return { required, properties, visited: nextVisited };\n  }\n\n  /** @internal */\n  public getArrayItems(propDef: Readonly<SettingSchema>, scope: string, visited: string[] = []): SettingSchema {\n    let items = propDef.items;\n    if (undefined === items && propDef.extends) {\n      if (visited.includes(propDef.extends))\n        throw new Error(`circular typeDef reference detected: ${[...visited, propDef.extends].join(\" -> \")}`);\n\n      const typeDef = this.typeDefs.get(propDef.extends);\n      if (undefined === typeDef)\n        throw new Error(`typeDef ${propDef.extends} does not exist${scope ? ` for ${scope}` : \"\"}`);\n      items = this.getArrayItems(typeDef, scope ? `${scope}.${propDef.extends}` : propDef.extends, [...visited, propDef.extends]);\n    }\n    if (undefined === items)\n      throw new Error(`array ${scope} has no items definition`);\n    return items;\n  }\n\n  private validateProperty<T>(val: T, propDef: Readonly<SettingSchema>, path: string) {\n    switch (propDef.type) {\n      case \"boolean\":\n      case \"number\":\n      case \"string\":\n      case \"integer\":\n      case \"null\":\n        return this.verifyType(val, propDef.type, path);\n\n      case \"array\":\n        if (!Array.isArray(val))\n          throw new Error(`Property ${path} must be an array`);\n        const items = this.getArrayItems(propDef, path);\n        for (let i = 0; i < val.length; ++i)\n          this.validateProperty(val[i], items, `${path}[${i}]`);\n        return;\n    }\n    if (!val || typeof val !== \"object\")\n      throw new Error(`${path} must be an object`);\n\n    const { required, properties } = this.getObjectProperties(propDef, path);\n\n    // first ensure all required properties are present\n    if (undefined !== required) {\n      for (const entry of required) {\n        const value = (val as any)[entry];\n        if (undefined === value)\n          throw new Error(`required value for \"${entry}\" is missing in \"${path}\"`);\n      }\n    }\n\n    // you can supply default values in typeDefs. See if any members are undefined that have a default.\n    if (undefined !== properties) {\n      for (const [key, prop] of Object.entries(properties)) {\n        if ((val as any)[key] === undefined && prop.default)\n          (val as any)[key] = prop.default;\n      }\n    }\n\n    // then validate all values in the supplied object are valid\n    for (const key of Object.keys(val)) {\n      const prop = properties[key];\n      if (prop !== undefined) { // note: extra values are ignored.\n        this.validateProperty((val as any)[key], prop, `${path}.${key}`);\n      }\n    }\n  }\n\n  /**\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`s must include a `schemaPrefix` member that is used\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\n   */\n  public addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void {\n    if (!Array.isArray(settingsGroup))\n      settingsGroup = [settingsGroup];\n\n    this.doAdd(settingsGroup);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\n  public addJson(settingSchema: string): void {\n    this.addGroup(parse(settingSchema));\n  }\n\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\n  public addFile(fileName: LocalFileName): void {\n    try {\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\n    } catch (e: any) {\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\n    }\n  }\n\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\n  public addDirectory(dirName: LocalDirName) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName));\n    }\n  }\n\n  /** Remove a previously added [[SettingSchemaGroup]] by schemaPrefix */\n  public removeGroup(schemaPrefix: string): void {\n    this.doRemove(schemaPrefix);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  private resolveSchema(schema: Readonly<SettingSchema>, scope = \"\", visited: string[] = []): SettingSchema {\n    const { extends: _extends, ...resolved } = schema;\n\n    switch (schema.type) {\n      case \"object\": {\n        const { required, properties, visited: resolvedVisited } = this.getObjectProperties(schema, scope, visited);\n\n        return {\n          ...resolved,\n          required,\n          properties: Object.fromEntries(\n            Object.entries(properties).map(([key, value]) => [\n              key,\n              this.resolveSchema(value, scope ? `${scope}.${key}` : key, resolvedVisited),\n            ])\n          ),\n        };\n      }\n\n      case \"array\": {\n        const items = this.getArrayItems(schema, scope, visited);\n        let resolvedSchema = resolved;\n\n        if (schema.extends) {\n          if (visited.includes(schema.extends))\n            throw new Error(`circular typeDef reference detected: ${[...visited, schema.extends].join(\" -> \")}`);\n\n          const typeDef = this.typeDefs.get(schema.extends);\n          if (undefined === typeDef)\n            throw new Error(`typeDef ${schema.extends} does not exist${scope ? ` for ${scope}` : \"\"}`);\n\n          const inheritedProps = this.resolveSchema(typeDef, scope ? `${scope}.${schema.extends}` : schema.extends, [...visited, schema.extends]);\n          resolvedSchema = { ...inheritedProps, ...resolvedSchema };\n        }\n\n        return {\n          ...resolvedSchema,\n          items: this.resolveSchema(items, scope ? `${scope}.items` : \"items\", visited),\n        };\n      }\n\n      default:\n        return resolved;\n    }\n  }\n\n  private doAdd(settingsGroup: SettingGroupSchema[]) {\n    settingsGroup.forEach((group) => {\n      if (undefined === group.schemaPrefix)\n        throw new Error(`settings group has no \"schemaPrefix\" member`);\n\n      this.doRemove(group.schemaPrefix);\n      this.validateAndAdd(group);\n      this._allGroups.set(group.schemaPrefix, group);\n    });\n  }\n\n  private doRemove(schemaPrefix: string) {\n    const group = this._allGroups.get(schemaPrefix);\n    if (undefined !== group?.settingDefs) {\n      for (const key of Object.keys(group.settingDefs))\n        this.settingDefs.delete(makeSettingKey(schemaPrefix, key));\n    }\n    if (undefined !== group?.typeDefs) {\n      for (const key of Object.keys(group.typeDefs))\n        this.typeDefs.delete(makeSettingKey(schemaPrefix, key));\n    }\n    this._allGroups.delete(schemaPrefix);\n  }\n\n  private validateName(name: string) {\n    if (!name.trim())\n      throw new Error(`empty property name`);\n  }\n\n  private verifyPropertyDef(name: string, property: SettingSchema | undefined) {\n    if (!property)\n      throw new Error(`missing required property ${name}`);\n\n    if (!property.type)\n      throw new Error(`property ${name} has no type`);\n\n    switch (property.type) {\n      case \"boolean\":\n      case \"integer\":\n      case \"null\":\n      case \"number\":\n      case \"string\":\n        return;\n\n      case \"object\":\n        const required = property.required;\n        const props = property.properties;\n        if (required && props) {\n          for (const entry of required) {\n            if (undefined === props[entry])\n              throw new Error(`missing required property of ${name}: \"${entry}\"`);\n          }\n        }\n        if (props) {\n          for (const key of Object.keys(props))\n            try {\n              this.verifyPropertyDef(key, props[key]);\n            } catch (e: any) {\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\n            }\n        }\n        return;\n\n      case \"array\":\n        if (typeof property.extends === \"string\")\n          return;\n        if (typeof property.items !== \"object\")\n          throw new Error(`array property ${name} has no items member`);\n        try {\n          this.verifyPropertyDef(\"items\", property.items);\n        } catch (e: any) {\n          throw new Error(`array property ${name}: ${e.message}`);\n        }\n        return;\n\n      default:\n        throw new Error(`property ${name} has illegal type \"${String(property.type)}\"`);\n    }\n  }\n\n  private validateAndAdd(group: SettingGroupSchema) {\n    const settingDefs = group.settingDefs;\n    if (undefined !== settingDefs) {\n      for (const key of Object.keys(settingDefs)) {\n        this.validateName(key);\n        this.verifyPropertyDef(key, settingDefs[key]);\n        const property: Mutable<SettingSchema> | undefined = settingDefs[key];\n        assert(undefined !== property);\n        property.default = property.default ?? this.getDefaultValue(property.type);\n        this.settingDefs.set(makeSettingKey(group.schemaPrefix, key), property);\n      }\n    }\n    const typeDefs = group.typeDefs ?? {};\n    for (const key of Object.keys(typeDefs)) {\n      this.validateName(key);\n      this.verifyPropertyDef(key, typeDefs[key]);\n      const typeDef = typeDefs[key];\n      assert(undefined !== typeDef);\n      this.typeDefs.set(makeSettingKey(group.schemaPrefix, key), typeDef);\n    }\n  }\n\n  private getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\n    type = Array.isArray(type) ? type[0] : type;\n    switch (type) {\n      case \"boolean\":\n        return false;\n      case \"integer\":\n      case \"number\":\n        return 0;\n      case \"string\":\n        return \"\";\n      case \"array\":\n        return [];\n      case \"object\":\n        return {};\n      default:\n        return undefined;\n    }\n  }\n}\n\nexport function constructSettingsSchemas(): SettingsSchemas {\n  return new SettingsSchemasImpl();\n}\n"]}

package/lib/cjs/internal/workspace/WorkspaceImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/WorkspaceImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAMH,OAAO,EAAoB,iBAAiB,EAA+C,MAAM,oBAAoB,CAAC;AAMtH,OAAO,EAAe,QAAQ,EAAgE,MAAM,0BAA0B,CAAC;AAI/H,OAAO,EACsB,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAA2B,WAAW,EAC/F,oBAAoB,EAA0F,gBAAgB,EACtE,aAAa,EAC3F,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAqH,eAAe,EAAwC,MAAM,iCAAiC,CAAC;AAY3N,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AA2vBpD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,WAAW,CAExG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,oBAAoB,QAGpE;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAAgE,CAAC;AAOzG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAEvG;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"WorkspaceImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/WorkspaceImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAMH,OAAO,EAAoB,iBAAiB,EAA+C,MAAM,oBAAoB,CAAC;AAMtH,OAAO,EAAe,QAAQ,EAAgE,MAAM,0BAA0B,CAAC;AAI/H,OAAO,EACsB,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAA2B,WAAW,EAC/F,oBAAoB,EAA0F,gBAAgB,EACtE,aAAa,EAC3F,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAqH,eAAe,EAAwC,MAAM,iCAAiC,CAAC;AAY3N,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAkvBpD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,WAAW,CAExG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,oBAAoB,QAGpE;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAAgE,CAAC;AAOzG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAEvG;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf"}