@itwin/core-backend 5.10.0-dev.9 → 5.11.0-dev.2

package/lib/esm/internal/ServerBasedLocks.js

@@ -16,6 +16,10 @@ export class ServerBasedLocks {
     lockDb = new 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;
@@ -26,17 +30,30 @@ export class ServerBasedLocks {
         catch {
             this.lockDb.createDb(dbName);
         }
+        this.lockDb[_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.
-        this.lockDb.executeSQL(`
-      CREATE TABLE IF NOT EXISTS txn_locks(
-        txnId INTEGER NOT NULL,
-        elementId INTEGER NOT NULL,
-        state INTEGER NOT NULL,
-        origin INTEGER NOT NULL,
-        abandoned BOOLEAN NOT NULL,
+        this.lockDb.executeSQL(`
+      CREATE TABLE IF NOT EXISTS txn_locks(
+        txnId INTEGER NOT NULL,
+        elementId INTEGER NOT NULL,
+        state INTEGER NOT NULL,
+        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) => (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());
@@ -53,9 +70,14 @@ export class ServerBasedLocks {
             });
             this.lockDb.saveChanges();
         });
+        this._removeOnPushedListener = this.briefcase.txns.onChangesPushed.addListener(() => {
+            this.updateHighWaterMark();
+            this.lockDb.saveChanges();
+        });
     }
     [_close]() {
         this._removeOnCommitListener();
+        this._removeOnPushedListener();
         if (this.lockDb.isOpen)
             this.lockDb.closeDb();
     }
@@ -74,6 +96,26 @@ export class ServerBasedLocks {
             return (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[_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 Id64.getBriefcaseId(id) === this.briefcase.briefcaseId && Id64.getLocalId(id) > this._highWaterLocalId;
+    }
     /** Clear the cache of locally held locks.
      * Note: does *not* release locks from server.
      */
@@ -134,13 +176,13 @@ export class ServerBasedLocks {
         // So use a placeholder txn id for now, and we'll update to the real txn id on commit.
         // This is important to distinguish new locks acquired in the current txn from locks acquired in previous reversed txns, which will only
         // be cleared (no longer reinstateable) on commit.
-        this.lockDb.withPreparedSqliteStatement(`
-      INSERT INTO txn_locks(txnId,elementId,state,origin,abandoned)
-      VALUES (?,?,?,?,FALSE)
-      ON CONFLICT(txnId,elementId)
-        DO UPDATE SET
-          state=excluded.state,
-          origin=excluded.origin,
+        this.lockDb.withPreparedSqliteStatement(`
+      INSERT INTO txn_locks(txnId,elementId,state,origin,abandoned)
+      VALUES (?,?,?,?,FALSE)
+      ON CONFLICT(txnId,elementId)
+        DO UPDATE SET
+          state=excluded.state,
+          origin=excluded.origin,
           abandoned=excluded.abandoned`, (stmt) => {
             stmt.bindId(1, this._unsavedChangesTxnId);
             stmt.bindId(2, id);
@@ -165,10 +207,16 @@ export 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) === 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 === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);
@@ -273,25 +321,25 @@ export class ServerBasedLocks {
         // Exclusive lock, we should restore the Shared lock.
         const allTxnLocks = new Map();
         const locksToRelease = new Map();
-        this.lockDb.withPreparedSqliteStatement(`
-        SELECT
-          current.elementId,
-          current.origin,
-          IFNULL(
-            (SELECT previous.state
-              FROM txn_locks previous
-              WHERE previous.elementId = current.elementId
-                AND previous.txnId < ?2
-                AND previous.abandoned=FALSE
-              ORDER BY previous.txnId DESC
-              LIMIT 1
-            ),
-            ?1
-          ) AS previousState
-        FROM txn_locks current
-        WHERE current.txnId>=?2
-          AND current.abandoned=FALSE
-        ORDER BY current.txnId DESC
+        this.lockDb.withPreparedSqliteStatement(`
+        SELECT
+          current.elementId,
+          current.origin,
+          IFNULL(
+            (SELECT previous.state
+              FROM txn_locks previous
+              WHERE previous.elementId = current.elementId
+                AND previous.txnId < ?2
+                AND previous.abandoned=FALSE
+              ORDER BY previous.txnId DESC
+              LIMIT 1
+            ),
+            ?1
+          ) AS previousState
+        FROM txn_locks current
+        WHERE current.txnId>=?2
+          AND current.abandoned=FALSE
+        ORDER BY current.txnId DESC
       `, (stmt) => {
             stmt.bindInteger(1, LockState.None);
             stmt.bindId(2, txnId);
@@ -423,8 +471,14 @@ export 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). */
     [_elementWasCreated](id) {
+        if (this.isNewElement(id))
+            return; // already covered implicitly; no database write needed
         this.insertLock(id, LockState.Exclusive, 1 /* LockOrigin.NewElement */);
         this.insertTxnLockRecord(id, LockState.Exclusive, 1 /* LockOrigin.NewElement */);
         this.lockDb.saveChanges();

package/lib/esm/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":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { DbResult, Id64, Id64Arg, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\r\nimport { IModel, IModelError, LockState, ServerBasedLocksError } from \"@itwin/core-common\";\r\nimport { LockMap } from \"../BackendHubAccess\";\r\nimport { BriefcaseDb } from \"../IModelDb\";\r\nimport { LockControl } from \"../LockControl\";\r\nimport { IModelHost } from \"../IModelHost\";\r\nimport { SQLiteDb } from \"../SQLiteDb\";\r\nimport { _close, _elementWasCreated, _hubAccess, _implementationProhibited, _nativeDb, _releaseAllLocks } from \"./Symbols\";\r\n\r\n/**\r\n * Both the Model and Parent of an element are considered \"owners\" of their member elements. That means:\r\n * 1) they must hold at least a shared lock before an exclusive lock can be acquired for their members\r\n * 2) if they hold an exclusive lock, then all of their members are exclusively locked implicitly.\r\n */\r\ninterface ElementOwners {\r\n  readonly modelId: Id64String;\r\n  readonly parentId: Id64String | undefined;\r\n}\r\n\r\n// eslint-disable-next-line no-restricted-syntax\r\nconst enum LockOrigin {\r\n  Acquired = 0,\r\n  NewElement = 1,\r\n  Discovered = 2,\r\n}\r\n\r\nexport class ServerBasedLocks implements LockControl {\r\n  public readonly [_implementationProhibited] = undefined;\r\n\r\n  public get isServerBased() { return true; }\r\n  protected readonly lockDb = new SQLiteDb();\r\n  protected readonly briefcase: BriefcaseDb;\r\n  private _removeOnCommitListener: () => void;\r\n  private _removeOnPushedListener: () => void;\r\n  /** The local ID portion of the highest element ID pushed to the server. Elements with this briefcase's ID\r\n   * and a local ID greater than this value are implicitly exclusively locked by us (no server lock required). */\r\n  private _highWaterLocalId: number = 0;\r\n  private readonly _unsavedChangesTxnId = \"0x7FFFFFFFFFFFFFFF\"; // a placeholder txn id for locks acquired in the current unsaved Txn\r\n\r\n  public constructor(iModel: BriefcaseDb) {\r\n    this.briefcase = iModel;\r\n    const dbName = `${iModel[_nativeDb].getTempFileBaseName()}-locks`;\r\n\r\n    try {\r\n      this.lockDb.openDb(dbName, OpenMode.ReadWrite);\r\n    } catch {\r\n      this.lockDb.createDb(dbName);\r\n    }\r\n\r\n    this.lockDb[_nativeDb].enableWalMode(true);\r\n\r\n    // Tracks the locks that are actively held.\r\n    this.lockDb.executeSQL(\"CREATE TABLE IF NOT EXISTS locks(id INTEGER PRIMARY KEY NOT NULL,state INTEGER NOT NULL,origin INTEGER)\");\r\n    // Tracks the locks that are required by each Txn. They may or may not currently be held.\r\n    this.lockDb.executeSQL(`\r\n      CREATE TABLE IF NOT EXISTS txn_locks(\r\n        txnId INTEGER NOT NULL,\r\n        elementId INTEGER NOT NULL,\r\n        state INTEGER NOT NULL,\r\n        origin INTEGER NOT NULL,\r\n        abandoned BOOLEAN NOT NULL,\r\n        PRIMARY KEY (txnId, elementId))`);\r\n\r\n    // Stores persistent metadata, including the high-water mark for new-element lock tracking.\r\n    this.lockDb.executeSQL(\"CREATE TABLE IF NOT EXISTS metadata(key TEXT PRIMARY KEY NOT NULL,value INTEGER NOT NULL)\");\r\n\r\n    // Initialize the high-water mark. If an existing value is stored, use it. Otherwise derive it from\r\n    // the iModel's current element ID sequence — any element with this briefcase's ID and a local ID at\r\n    // or below the sequence was either already pushed or was created-then-abandoned in a previous session.\r\n    const storedHwm = this.lockDb.withSqliteStatement(\r\n      \"SELECT value FROM metadata WHERE key='highWaterLocalId'\",\r\n      (stmt) => (DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueInteger(0) : undefined)\r\n    );\r\n    if (storedHwm !== undefined) {\r\n      this._highWaterLocalId = storedHwm;\r\n    } else {\r\n      this.updateHighWaterMark();\r\n    }\r\n\r\n    this.lockDb.saveChanges();\r\n\r\n    this._removeOnCommitListener = this.briefcase.txns.onCommit.addListener(() => {\r\n      const committedTxnId = this.briefcase.txns.queryPreviousTxnId(this.briefcase.txns.getCurrentTxnId())\r\n\r\n      // With this commit, any reversed txns with the committed txn's ID or greater are no longer reinstatable,\r\n      // so clear out the record of their locks. If the locks are still held, sorry, it's too late!\r\n      this.clearTxnLockRecords(committedTxnId);\r\n\r\n      // All of the \"current\" changes are now part of a real txn, so update the txn id accordingly.\r\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET txnId=? WHERE txnId=?\", (stmt) => {\r\n        stmt.bindId(1, committedTxnId);\r\n        stmt.bindId(2, this._unsavedChangesTxnId);\r\n        const rc = stmt.step();\r\n        if (DbResult.BE_SQLITE_DONE !== rc)\r\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update locks database with txn ID of unsaved changes txn upon saving (error code ${rc})`);\r\n      });\r\n\r\n      this.lockDb.saveChanges();\r\n    });\r\n\r\n    this._removeOnPushedListener = this.briefcase.txns.onChangesPushed.addListener(() => {\r\n      this.updateHighWaterMark();\r\n      this.lockDb.saveChanges();\r\n    });\r\n  }\r\n\r\n  public [_close]() {\r\n    this._removeOnCommitListener();\r\n    this._removeOnPushedListener();\r\n\r\n    if (this.lockDb.isOpen)\r\n      this.lockDb.closeDb();\r\n  }\r\n\r\n  private getOwners(id: Id64String): ElementOwners {\r\n    return this.briefcase.withPreparedSqliteStatement(\"SELECT ModelId,ParentId FROM bis_Element WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_ROW !== rc)\r\n        throw new IModelError(rc, `element ${id} not found`);\r\n\r\n      return { modelId: stmt.getValueId(0), parentId: stmt.getValueId(1) };\r\n    });\r\n  }\r\n\r\n  private getLockState(id?: Id64String): LockState | undefined {\r\n    return (id === undefined || !Id64.isValid(id)) ? undefined : this.lockDb.withPreparedSqliteStatement(\"SELECT state FROM locks WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      return (DbResult.BE_SQLITE_ROW === stmt.step()) ? stmt.getValueInteger(0) : undefined;\r\n    });\r\n  }\r\n\r\n  /** Read the local ID portion of the iModel's current element ID sequence counter.\r\n   * The native layer writes this value with BeInt64Id::ToString() (decimal by default) but\r\n   * BeInt64Id::FromString() accepts both decimal and \"0x\"-prefixed hex. BigInt() has the same\r\n   * dual-format behavior, so it is the canonical JS equivalent. Mask to the lower 40 bits. */\r\n  private readCurrentLocalIdSequence(): number {\r\n    const seqStr = this.briefcase[_nativeDb].queryLocalValue(\"bis_elementidsequence\");\r\n    if (!seqStr)\r\n      return 0;\r\n    return Number(BigInt(seqStr) & 0xFFFFFFFFFFn);\r\n  }\r\n\r\n  /** Persist the current element ID sequence as the new high-water mark. Called after a successful push. */\r\n  private updateHighWaterMark(): void {\r\n    this._highWaterLocalId = this.readCurrentLocalIdSequence();\r\n    this.lockDb.withPreparedSqliteStatement(\r\n      \"INSERT INTO metadata(key,value) VALUES('highWaterLocalId',?) ON CONFLICT(key) DO UPDATE SET value=excluded.value\",\r\n      (stmt) => { stmt.bindInteger(1, this._highWaterLocalId); stmt.step(); }\r\n    );\r\n  }\r\n\r\n  /** Returns true if this element was created by this briefcase after the last push and therefore does not\r\n   * require a server lock. */\r\n  private isNewElement(id: Id64String): boolean {\r\n    return Id64.getBriefcaseId(id) === this.briefcase.briefcaseId && Id64.getLocalId(id) > this._highWaterLocalId;\r\n  }\r\n\r\n  /** Clear the cache of locally held locks.\r\n   * Note: does *not* release locks from server.\r\n   */\r\n  private clearAllLocks() {\r\n    this.lockDb.executeSQL(\"DELETE FROM locks\");\r\n    this.lockDb.executeSQL(\"DELETE FROM txn_locks\");\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** only for tests */\r\n  public getLockCount(state: LockState): number {\r\n    return this.lockDb.withSqliteStatement(\"SELECT count(*) FROM locks WHERE state=?\", (stmt) => {\r\n      stmt.bindInteger(1, state);\r\n      stmt.step();\r\n      return stmt.getValueInteger(0);\r\n    });\r\n  }\r\n\r\n  public async [_releaseAllLocks](): Promise<void> {\r\n    await IModelHost[_hubAccess].releaseAllLocks(this.briefcase); // throws if unsuccessful\r\n    this.clearAllLocks();\r\n  }\r\n\r\n  public async releaseAllLocks(): Promise<void> {\r\n    if (this.briefcase.txns.hasLocalChanges) {\r\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be released while the briefcase contains local changes\");\r\n    }\r\n\r\n    return this[_releaseAllLocks]();\r\n  }\r\n\r\n  public async abandonAllLocks(): Promise<void> {\r\n    if (this.briefcase.txns.hasLocalChanges) {\r\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", \"Locks cannot be abandoned while the briefcase contains local changes\");\r\n    }\r\n\r\n    if (IModelHost[_hubAccess].abandonAllLocks === undefined) {\r\n      // If the IModelHub doesn't support an explicit abandon, call release with a blank changeset to indicate\r\n      // that locks should be released without updating the changeset associated with the locks.\r\n      await IModelHost[_hubAccess].releaseAllLocks({\r\n        iModelId: this.briefcase.iModelId,\r\n        briefcaseId: this.briefcase.briefcaseId,\r\n        changeset: { id: \"\", index: 0 }\r\n      });\r\n    } else {\r\n      await IModelHost[_hubAccess].abandonAllLocks(this.briefcase);\r\n    }\r\n\r\n    this.clearAllLocks();\r\n  }\r\n\r\n  private insertLock(id: Id64String, state: LockState, origin: LockOrigin): true {\r\n    this.lockDb.withPreparedSqliteStatement(\"INSERT INTO locks(id,state,origin) VALUES (?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,origin=excluded.origin\", (stmt) => {\r\n      stmt.bindId(1, id);\r\n      stmt.bindInteger(2, state);\r\n      stmt.bindInteger(3, origin);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        throw new IModelError(rc, \"can't insert lock into database\");\r\n    });\r\n\r\n    return true;\r\n  }\r\n\r\n  private insertTxnLockRecord(id: Id64String, state: LockState, origin: LockOrigin): void {\r\n    // Locks are always acquired in the current txn, which isn't a real txn until it's committed.\r\n    // So use a placeholder txn id for now, and we'll update to the real txn id on commit.\r\n    // This is important to distinguish new locks acquired in the current txn from locks acquired in previous reversed txns, which will only\r\n    // be cleared (no longer reinstateable) on commit.\r\n    this.lockDb.withPreparedSqliteStatement(`\r\n      INSERT INTO txn_locks(txnId,elementId,state,origin,abandoned)\r\n      VALUES (?,?,?,?,FALSE)\r\n      ON CONFLICT(txnId,elementId)\r\n        DO UPDATE SET\r\n          state=excluded.state,\r\n          origin=excluded.origin,\r\n          abandoned=excluded.abandoned`, (stmt) => {\r\n      stmt.bindId(1, this._unsavedChangesTxnId);\r\n      stmt.bindId(2, id);\r\n      stmt.bindInteger(3, state);\r\n      stmt.bindInteger(4, origin);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't insert txn lock record into database (error code ${rc})`);\r\n    });\r\n  }\r\n\r\n  private ownerHoldsExclusiveLock(id: Id64String | undefined): boolean {\r\n    if (id === undefined || id === IModel.rootSubjectId)\r\n      return false; // has no owners\r\n\r\n    const { modelId, parentId } = this.getOwners(id);\r\n    if (this.getLockState(modelId) === LockState.Exclusive || this.getLockState(parentId) === LockState.Exclusive)\r\n      return true;\r\n\r\n    // see if this model is exclusively locked by one of its owners. If so, save that fact on modelId so future tests won't have to descend.\r\n    if (this.ownerHoldsExclusiveLock(modelId))\r\n      return this.insertLock(modelId, LockState.Exclusive, LockOrigin.Discovered);\r\n\r\n    // see if the parent is exclusively locked by one of its owners. If so, save that fact on parentId so future tests won't have to descend.\r\n    return this.ownerHoldsExclusiveLock(parentId) ? this.insertLock(parentId!, LockState.Exclusive, LockOrigin.Discovered) : false; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n  }\r\n\r\n  /** Determine whether an the exclusive lock is already held by an element (or one of its owners) */\r\n  public holdsExclusiveLock(id: Id64String): boolean {\r\n    // New elements (created by this briefcase since the last push) are implicitly exclusively locked.\r\n    if (this.isNewElement(id))\r\n      return true;\r\n    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\r\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  public holdsSharedLock(id: Id64String): boolean {\r\n    // New elements are implicitly exclusively locked, which implies shared lock too.\r\n    if (this.isNewElement(id))\r\n      return true;\r\n    const state = this.getLockState(id);\r\n    // see if we hold shared or exclusive lock, or if an owner has exclusive lock. If so we implicitly have shared lock, but owner holding shared lock doesn't help.\r\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  /** if the shared lock on the element supplied is not already held, add it to the set of shared locks required. Then, check owners. */\r\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\r\n    // if the id is not valid, or of the lock is already in the set, or if we already hold a shared lock, we're done\r\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\r\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\r\n      return;\r\n\r\n    locks.add(id); // add to set of needed shared locks\r\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\r\n  }\r\n\r\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\r\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\r\n    const el = this.getOwners(id);\r\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\r\n    this.addSharedLock(el.modelId, locks); // check its model\r\n  }\r\n\r\n  /** attempt to acquire all necessary locks for a set of elements */\r\n  private async acquireAllLocks(locks: LockMap) {\r\n    if (locks.size === 0) // no locks are required.\r\n      return;\r\n\r\n    const sharedLocks = new Set<Id64String>();\r\n    for (const lock of locks)\r\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\r\n\r\n    for (const shared of sharedLocks) {\r\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\r\n        locks.set(shared, LockState.Shared);\r\n    }\r\n\r\n    await IModelHost[_hubAccess].acquireLocks(this.briefcase, locks); // throws if unsuccessful\r\n    for (const lock of locks) {\r\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\r\n      this.insertTxnLockRecord(lock[0], lock[1], LockOrigin.Acquired);\r\n    }\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  public async acquireLocks(arg: { shared?: Id64Arg, exclusive?: Id64Arg }): Promise<void> {\r\n    const locks = new Map<Id64String, LockState>();\r\n    if (arg.shared) {\r\n      for (const id of Id64.iterable(arg.shared)) {\r\n        if (!this.holdsSharedLock(id))\r\n          locks.set(id, LockState.Shared);\r\n      }\r\n    }\r\n    if (arg.exclusive) {\r\n      for (const id of Id64.iterable(arg.exclusive)) {\r\n        if (!this.holdsExclusiveLock(id))\r\n          locks.set(id, LockState.Exclusive);\r\n      }\r\n    }\r\n    return this.acquireAllLocks(locks);\r\n  }\r\n\r\n  private async abandonLocks(locks: LockMap): Promise<void> {\r\n    if (IModelHost[_hubAccess].abandonLocks === undefined) {\r\n      // If the IModelHub doesn't support an explicit abandon, call acquireLocks with a blank changeset to indicate\r\n      // that locks should be released without updating the changeset associated with the locks.\r\n      await IModelHost[_hubAccess].acquireLocks({\r\n        iModelId: this.briefcase.iModelId,\r\n        briefcaseId: this.briefcase.briefcaseId,\r\n        changeset: { id: \"\", index: 0 }\r\n      }, locks);\r\n    } else {\r\n      await IModelHost[_hubAccess].abandonLocks(this.briefcase, locks);\r\n    }\r\n  }\r\n\r\n  public async abandonLocksForCurrentUnsavedTxn(): Promise<boolean> {\r\n    return this.abandonLocksForReversedTxn(this._unsavedChangesTxnId);\r\n  }\r\n\r\n  public async abandonLocksForReversedTxn(txnId: Id64String): Promise<boolean> {\r\n    if (this.briefcase.txns.hasUnsavedChanges)\r\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot abandon locks for txn ${txnId} because the current txn has unsaved changes`);\r\n\r\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\r\n    if (txnProps === undefined) {\r\n      // The current txn commonly won't exist on the TxnManager yet. It's often just a placeholder for not-yet-saved changes.\r\n      // (Sometimes it will exist and refer to a reversed Txn).\r\n      // The unsavedChangesTxnId won't exist on the TxnManager either, of course.\r\n      // But all other txn ids must be known to the TxnManager or it is an error.\r\n      if (txnId !== this.briefcase.txns.getCurrentTxnId() && txnId !== this._unsavedChangesTxnId)\r\n        ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot abandon locks for txn ${txnId} because it does not exist`);\r\n    } else {\r\n      // If the txn id is known to the TxnManager, then we require that it has already been reversed.\r\n      if (!txnProps.reversed)\r\n        ServerBasedLocksError.throwError(\"txn-not-reversed\", `cannot abandon locks for txn ${txnId} because it has not been reversed`);\r\n    }\r\n\r\n    let locksReleased = false;\r\n\r\n    // Abandon locks for unsaved (and now abandoned) changes.\r\n    if (txnId !== this._unsavedChangesTxnId) {\r\n      locksReleased = await this.abandonLocksForCurrentUnsavedTxn();\r\n    }\r\n\r\n    // At this point, we know:\r\n    // 1. There are no unsaved changes, and the associated locks have been abandoned.\r\n    // 2. The given txn ID has been reversed, which means any later txns are sure to have been reversed, too.\r\n\r\n    // So we simply have to find all non-abandoned locks associated with the given txn or later, abandon them (or restore\r\n    // them to their previous state), and mark them as abandoned in txn_locks.\r\n\r\n    // Find all locks associated with the given txnId or later.\r\n    // For each elementId, find the previous state of the lock before this Txn (if any), or None otherwise.\r\n    // This is the state that we will restore the element's lock to. The reason we do this is to account for\r\n    // lock upgrades. If an earlier Txn acquired a Shared lock on this element, and this Txn acquired an\r\n    // Exclusive lock, we should restore the Shared lock.\r\n    const allTxnLocks = new Map<Id64String, LockState>();\r\n    const locksToRelease = new Map<Id64String, LockState>();\r\n    this.lockDb.withPreparedSqliteStatement(\r\n      `\r\n        SELECT\r\n          current.elementId,\r\n          current.origin,\r\n          IFNULL(\r\n            (SELECT previous.state\r\n              FROM txn_locks previous\r\n              WHERE previous.elementId = current.elementId\r\n                AND previous.txnId < ?2\r\n                AND previous.abandoned=FALSE\r\n              ORDER BY previous.txnId DESC\r\n              LIMIT 1\r\n            ),\r\n            ?1\r\n          ) AS previousState\r\n        FROM txn_locks current\r\n        WHERE current.txnId>=?2\r\n          AND current.abandoned=FALSE\r\n        ORDER BY current.txnId DESC\r\n      `,\r\n      (stmt) => {\r\n        stmt.bindInteger(1, LockState.None);\r\n        stmt.bindId(2, txnId);\r\n\r\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\r\n          const elementId = stmt.getValueId(0);\r\n          const origin = stmt.getValueInteger(1);\r\n          const previousState = stmt.getValueInteger(2);\r\n          allTxnLocks.set(elementId, previousState);\r\n          if (origin !== LockOrigin.NewElement)\r\n            locksToRelease.set(elementId, previousState);\r\n        }\r\n      });\r\n\r\n    // Release the locks on the server.\r\n    if (locksToRelease.size > 0)\r\n      await this.abandonLocks(locksToRelease);\r\n\r\n    // Mark the txn locks as abandoned.\r\n    if (txnId === this._unsavedChangesTxnId) {\r\n      // After abandoning locks held for the \"unsaved\" txn, we clear them completely because they are not reinstateable.\r\n      this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId=?\", (stmt) => {\r\n        stmt.bindId(1, this._unsavedChangesTxnId);\r\n        const rc = stmt.step();\r\n        if (DbResult.BE_SQLITE_DONE !== rc)\r\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn locks for unsaved changes in database (error code ${rc})`);\r\n      });\r\n    } else {\r\n      this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=TRUE WHERE txnId>=?\", (stmt) => {\r\n        stmt.bindId(1, txnId);\r\n        const rc = stmt.step();\r\n        if (DbResult.BE_SQLITE_DONE !== rc)\r\n          ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as abandoned in database (error code ${rc})`);\r\n      });\r\n    }\r\n\r\n    // Restore each lock to its previous state (if any) in the local cache. Usually this means deleting it.\r\n    for (const [elementId, previousState] of allTxnLocks) {\r\n      if (previousState === LockState.None) {\r\n        this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE id=?\", (stmt) => {\r\n          stmt.bindId(1, elementId);\r\n          const rc = stmt.step();\r\n          if (DbResult.BE_SQLITE_DONE !== rc)\r\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete lock from database (error code ${rc})`);\r\n        });\r\n      } else {\r\n        this.lockDb.withPreparedSqliteStatement(\"UPDATE locks SET state=? WHERE id=?\", (stmt) => {\r\n          stmt.bindInteger(1, previousState);\r\n          stmt.bindId(2, elementId);\r\n          const rc = stmt.step();\r\n          if (DbResult.BE_SQLITE_DONE !== rc)\r\n            ServerBasedLocksError.throwError(\"lock-database-problem\", `can't update lock in database (error code ${rc})`);\r\n        });\r\n      }\r\n    }\r\n\r\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\r\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\r\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\r\n    this.clearDiscoveredLocks();\r\n\r\n    this.lockDb.saveChanges();\r\n\r\n    return locksReleased || allTxnLocks.size > 0;\r\n  }\r\n\r\n  private getAbandonedLocksForTxn(txnId: Id64String): {\r\n    newElementLocks: Map<Id64String, LockState>,\r\n    locksToAcquire: Map<Id64String, LockState>\r\n  } {\r\n    const newElementLocks = new Map<Id64String, LockState>();\r\n    const locksToAcquire = new Map<Id64String, LockState>();\r\n    this.lockDb.withPreparedSqliteStatement(\r\n      \"SELECT elementId, state, origin FROM txn_locks WHERE txnId<=? AND abandoned=TRUE\",\r\n      (stmt) => {\r\n        stmt.bindId(1, txnId);\r\n\r\n        while (DbResult.BE_SQLITE_ROW === stmt.step()) {\r\n          const elementId = stmt.getValueId(0);\r\n          const state = stmt.getValueInteger(1);\r\n          const origin = stmt.getValueInteger(2);\r\n          if (origin === LockOrigin.NewElement)\r\n            newElementLocks.set(elementId, state);\r\n          else\r\n            locksToAcquire.set(elementId, state);\r\n        }\r\n      });\r\n\r\n    return { newElementLocks, locksToAcquire };\r\n  }\r\n\r\n  public async acquireLocksForReinstatingTxn(txnId: Id64String): Promise<boolean> {\r\n    if (this.briefcase.txns.hasUnsavedChanges)\r\n      ServerBasedLocksError.throwError(\"has-unsaved-changes\", `cannot acquire locks for reinstating txn ${txnId} because the current txn has unsaved changes`);\r\n\r\n    // If the Txn is known to the TxnManager, we can proceed. We don't need to check if it is currently\r\n    // reversed, because if it isn't, then abandonLocksForReversedTxn couldn't have been called, and so the\r\n    // locks are still held. Proceeding with this method will be a no-op, but it will be harmless.\r\n    // However, if the Txn Id is unknown, it may have been canceled or refer to the current Txn\r\n    // whose unsaved changes were just abandoned. Or it's just plain-old invalid. In any case, we can't\r\n    // re-acquire the associated locks.\r\n    const txnProps = this.briefcase.txns.getTxnProps(txnId);\r\n    if (txnProps === undefined) {\r\n      ServerBasedLocksError.throwError(\"txn-id-not-found\", `cannot acquire locks for txn ${txnId} because it does not exist or has not been saved`);\r\n    }\r\n\r\n    // Find all locks associated with the given txnId.\r\n    const { newElementLocks, locksToAcquire } = this.getAbandonedLocksForTxn(txnId);\r\n\r\n    // Attempt to acquire the locks on the server. This may fail if the locks are no longer available!\r\n    if (locksToAcquire.size > 0)\r\n      await IModelHost[_hubAccess].acquireLocks(this.briefcase, locksToAcquire); // throws if unsuccessful\r\n\r\n    // Mark the txn locks as no longer abandoned.\r\n    this.lockDb.withPreparedSqliteStatement(\"UPDATE txn_locks SET abandoned=FALSE WHERE txnId<=?\", (stmt) => {\r\n      stmt.bindId(1, txnId);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't mark txn locks as no longer abandoned in database (error code ${rc})`);\r\n    });\r\n\r\n    // Insert the newly-acquired locks in the local cache. Note that we don't need to insert entries in the txn_locks table,\r\n    // because these locks are already associated with the Txn.\r\n    for (const [elementId, state] of locksToAcquire) {\r\n      this.insertLock(elementId, state, LockOrigin.Acquired);\r\n    }\r\n    for (const [elementId, state] of newElementLocks) {\r\n      this.insertLock(elementId, state, LockOrigin.NewElement);\r\n    }\r\n\r\n    // Ideally we'd only invalidate \"Discovered\" locks that are related to this Txn's Shared and\r\n    // Exclusive locks. But that is a lot of added complexity for little benefit.\r\n    // Clearing them all will have no impact on correctness and a minimal impact on performance.\r\n    this.clearDiscoveredLocks();\r\n\r\n    this.lockDb.saveChanges();\r\n\r\n    return locksToAcquire.size > 0 || newElementLocks.size > 0;\r\n  }\r\n\r\n  public holdsNecessaryLocksForReinstatingTxn(txnId: Id64String): boolean {\r\n    const locks = this.getAbandonedLocksForTxn(txnId);\r\n    return locks.locksToAcquire.size === 0 && locks.newElementLocks.size === 0;\r\n  }\r\n\r\n  public clearTxnLockRecords(txnId: Id64String) {\r\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM txn_locks WHERE txnId!=? AND txnId>=?\", (stmt) => {\r\n      stmt.bindId(1, this._unsavedChangesTxnId);\r\n      stmt.bindId(2, txnId);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete txn lock records from database (error code ${rc})`);\r\n    });\r\n\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  /** When an element is newly created in a session, we hold the lock on it implicitly.\r\n   * For elements whose local ID is above the high-water mark this is already handled by [[isNewElement]],\r\n   * so no database write is needed. The only case that does require a write is when the element's ID is\r\n   * at or below the high-water mark (e.g. when re-applying a stash whose elements were created before\r\n   * the last push). */\r\n  public [_elementWasCreated](id: Id64String) {\r\n    if (this.isNewElement(id))\r\n      return; // already covered implicitly; no database write needed\r\n    this.insertLock(id, LockState.Exclusive, LockOrigin.NewElement);\r\n    this.insertTxnLockRecord(id, LockState.Exclusive, LockOrigin.NewElement);\r\n    this.lockDb.saveChanges();\r\n  }\r\n\r\n  private clearDiscoveredLocks() {\r\n    this.lockDb.withPreparedSqliteStatement(\"DELETE FROM locks WHERE origin=?\", (stmt) => {\r\n      stmt.bindInteger(1, LockOrigin.Discovered);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        ServerBasedLocksError.throwError(\"lock-database-problem\", `can't delete discovered locks from database (error code ${rc})`);\r\n    });\r\n  }\r\n\r\n  /** locks are not necessary during change propagation. */\r\n  private get _locksAreRequired() { return !this.briefcase.txns.isIndirectChanges; }\r\n\r\n  /** throw if locks are currently required and the exclusive lock is not held on the supplied element */\r\n  public checkExclusiveLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsExclusiveLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `exclusive lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n  /** throw if locks are currently required and a shared lock is not held on the supplied element */\r\n  public checkSharedLock(id: Id64String, type: string, operation: string) {\r\n    if (this._locksAreRequired && !this.holdsSharedLock(id))\r\n      throw new IModelError(IModelStatus.LockNotHeld, `shared lock not held on ${type} for ${operation} (id=${id})`);\r\n  }\r\n\r\n}\r\n\r\nexport function createServerBasedLocks(iModel: BriefcaseDb): LockControl {\r\n  return new ServerBasedLocks(iModel);\r\n}\r\n"]}

package/lib/esm/internal/Symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"Symbols.js","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;AAE1I,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,GAAG,IAAI,wCAAwC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AAC3D,gBAAgB;AAChB,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/D,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AACrE,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,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/** @packageDocumentation\n * @module Workspace\n */\n\nexport const _implementationProhibited = Symbol.for(\"Implementations of this interface can only be obtained from the containing package\");\n\nfunction sym(name: string): string {\n  return `${name}_core-backend_INTERNAL_ONLY_DO_NOT_USE`;\n}\n\nexport const _close = Symbol.for(sym(\"close\"));\nexport const _elementWasCreated = Symbol.for(sym(\"elementWasCreated\"));\nexport const _faceProps = Symbol.for(sym(\"faceProps\"));\nexport const _getData = Symbol.for(sym(\"getData\"));\nexport const _key = Symbol.for(sym(\"key\"));\n/** @internal */\nexport const _implicitTxn = Symbol.for(sym(\"implicitTxn\"));\n/** @internal */\nexport const _nativeDb = Symbol.for(sym(\"nativeDb\"));\nexport const _releaseAllLocks = Symbol.for(sym(\"releaseAllLocks\"));\nexport const _verifyChannel = Symbol.for(sym(\"verifyChannel\"));\n/** @internal */\nexport const _hubAccess = Symbol.for(sym(\"hubAccess\"));\nexport const _setHubAccess = Symbol.for(sym(\"setHubAccess\"));\nexport const _getHubAccess = Symbol.for(sym(\"getHubAccess\"));\nexport const _mockCheckpoint = Symbol.for(sym(\"mockCheckpoint\"));\nexport const _cache = Symbol.for(sym(\"cache\"));\nexport const _instanceKeyCache = Symbol.for(sym(\"instanceKeyCache\"));\n/** @internal */\nexport const _activeTxn = Symbol.for(sym(\"activeTxn\"));\nexport const _resetIModelDb = Symbol.for(sym(\"resetIModelDb\"));\n"]}
+{"version":3,"file":"Symbols.js","sourceRoot":"","sources":["../../../src/internal/Symbols.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;AAE1I,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,GAAG,IAAI,wCAAwC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AAC3D,gBAAgB;AAChB,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/D,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AACrE,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nexport const _implementationProhibited = Symbol.for(\"Implementations of this interface can only be obtained from the containing package\");\r\n\r\nfunction sym(name: string): string {\r\n  return `${name}_core-backend_INTERNAL_ONLY_DO_NOT_USE`;\r\n}\r\n\r\nexport const _close = Symbol.for(sym(\"close\"));\r\nexport const _elementWasCreated = Symbol.for(sym(\"elementWasCreated\"));\r\nexport const _faceProps = Symbol.for(sym(\"faceProps\"));\r\nexport const _getData = Symbol.for(sym(\"getData\"));\r\nexport const _key = Symbol.for(sym(\"key\"));\r\n/** @internal */\r\nexport const _implicitTxn = Symbol.for(sym(\"implicitTxn\"));\r\n/** @internal */\r\nexport const _nativeDb = Symbol.for(sym(\"nativeDb\"));\r\nexport const _releaseAllLocks = Symbol.for(sym(\"releaseAllLocks\"));\r\nexport const _verifyChannel = Symbol.for(sym(\"verifyChannel\"));\r\n/** @internal */\r\nexport const _hubAccess = Symbol.for(sym(\"hubAccess\"));\r\nexport const _setHubAccess = Symbol.for(sym(\"setHubAccess\"));\r\nexport const _getHubAccess = Symbol.for(sym(\"getHubAccess\"));\r\nexport const _mockCheckpoint = Symbol.for(sym(\"mockCheckpoint\"));\r\nexport const _cache = Symbol.for(sym(\"cache\"));\r\nexport const _instanceKeyCache = Symbol.for(sym(\"instanceKeyCache\"));\r\n/** @internal */\r\nexport const _activeTxn = Symbol.for(sym(\"activeTxn\"));\r\nexport const _resetIModelDb = Symbol.for(sym(\"resetIModelDb\"));\r\n"]}

package/lib/esm/internal/annotations/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/internal/annotations/fields.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\nimport { ECSqlValueType, FieldPrimitiveValue, FieldPropertyType, FieldRun, FieldValue, formatFieldValue, RelationshipProps, TextBlock, traverseTextBlockComponent } from \"@itwin/core-common\";\nimport { IModelDb } from \"../../IModelDb\";\nimport { assert, DbResult, expectDefined, Id64String, Logger } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../../BackendLoggerCategory\";\nimport { isITextAnnotation } from \"../../annotations/ElementDrivesTextAnnotation\";\nimport { AnyClass, EntityClass, PrimitiveType, Property, PropertyType, StructArrayProperty } from \"@itwin/ecschema-metadata\";\nimport type { EditTxn } from \"../../EditTxn\";\ninterface FieldStructValue { [key: string]: any }\n\n// An intermediate value obtained while evaluating a FieldPropertyPath.\ntype FieldValueType = {\n  primitive: FieldPrimitiveValue;\n  struct?: never;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct: FieldStructValue;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray: FieldPrimitiveValue[];\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray?: never;\n  structArray: FieldStructValue[];\n}\n\nexport interface UpdateFieldsContext {\n  readonly hostElementId: Id64String | undefined;\n\n  getProperty(field: FieldRun): FieldValue | undefined\n}\n\n// Resolve the raw primitive value of the property that a field points to.\nfunction getFieldPropertyValue(field: FieldRun, iModel: IModelDb): FieldValue | undefined {\n  const host = field.propertyHost;\n  const schemaItem = iModel.schemaContext.getSchemaItemSync(host.schemaName, host.className);\n  if (!EntityClass.isEntityClass(schemaItem)) {\n    return undefined;\n  }\n\n  let ecClass: AnyClass = schemaItem;\n  const { propertyName, accessors } = field.propertyPath;\n  let ecProp = ecClass.getPropertySync(propertyName);\n  if (!ecProp) {\n    return undefined;\n  }\n\n  const isAspect = ecClass.isSync(\"ElementAspect\", \"BisCore\");\n  const where = ` WHERE ${isAspect ? \"Element.Id\" : \"ECInstanceId\"}=${host.elementId}`;\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  let curValue: FieldValueType | undefined = iModel.withPreparedStatement(`SELECT ${propertyName} FROM ${host.schemaName}.${host.className} ${where}`, (stmt) => {\n    if (stmt.step() !== DbResult.BE_SQLITE_ROW) {\n      return undefined;\n    }\n\n    const rootValue = stmt.getValue(0);\n    if (undefined === rootValue || rootValue.isNull) {\n      return undefined;\n    }\n\n    switch (rootValue.columnInfo.getType()) {\n      case ECSqlValueType.Blob:\n        return { primitive: rootValue.getBlob() };\n      case ECSqlValueType.Boolean:\n        return { primitive: rootValue.getBoolean() };\n      case ECSqlValueType.DateTime:\n        return { primitive: new Date(rootValue.getDateTime()) };\n      case ECSqlValueType.Double:\n        return { primitive: rootValue.getDouble() };\n      case ECSqlValueType.Guid:\n        return { primitive: rootValue.getGuid() };\n      case ECSqlValueType.Int:\n      case ECSqlValueType.Int64:\n        return { primitive: rootValue.getInteger() };\n      case ECSqlValueType.Point2d:\n        return { primitive: rootValue.getXAndY() };\n      case ECSqlValueType.Point3d:\n        return { primitive: rootValue.getXYAndZ() };\n      case ECSqlValueType.String:\n        return { primitive: rootValue.getString() };\n      case ECSqlValueType.Struct: {\n        ecProp = expectDefined(ecProp);\n        assert(ecProp.isStruct());\n        ecClass = ecProp.structClass;\n        return { struct: rootValue.getStruct() };\n      }\n      case ECSqlValueType.PrimitiveArray: {\n        return { primitiveArray: rootValue.getArray() };\n      }\n      case ECSqlValueType.StructArray: {\n        return { structArray: rootValue.getArray() };\n      }\n      // Unsupported:\n      // case ECSqlValueType.Geometry:\n      // case ECSqlValueType.Navigation:\n      // case ECSqlValueType.Id:\n    }\n\n    return undefined;\n  });\n\n  if (undefined === curValue) {\n    return undefined;\n  }\n\n  if (accessors) {\n    for (const accessor of accessors) {\n      if (undefined !== curValue.primitive) {\n        // Can't index into a primitive.\n        return undefined;\n      }\n\n      if (typeof accessor === \"number\") {\n        const array: FieldPrimitiveValue[] | FieldStructValue[] | undefined = curValue.primitiveArray ?? curValue.structArray;\n        if (!array) {\n          return undefined;\n        }\n\n        const index: number = accessor < 0 ? (array.length + accessor) : accessor;\n        const item: FieldPrimitiveValue | FieldStructValue = array[index];\n        if (undefined === item) {\n          return undefined;\n        } else if (curValue.primitiveArray) {\n          curValue = { primitive: curValue.primitiveArray[index] };\n        } else {\n          assert(undefined !== curValue.structArray);\n          assert(ecProp instanceof StructArrayProperty);\n\n          ecClass = ecProp.structClass;\n          curValue = { struct: curValue.structArray[index] };\n        }\n      } else {\n        if (undefined === curValue.struct) {\n          return undefined;\n        }\n\n        const item: any = curValue.struct[accessor];\n        if (undefined === item) {\n          return undefined;\n        }\n\n        ecProp = ecClass.getPropertySync(accessor);\n        if (!ecProp) {\n          return undefined;\n        }\n\n        if (ecProp.isArray()) {\n          curValue = ecProp.isStruct() ? { structArray: item } : { primitiveArray: item };\n        } else if (ecProp.isStruct()) {\n          ecClass = ecProp.structClass;\n          curValue = { struct: item };\n        } else if (ecProp.isPrimitive()) {\n          curValue = { primitive: item };\n        } else {\n          return undefined;\n        }\n      }\n    }\n  }\n\n  const propertyType = determineFieldPropertyType(ecProp);\n  if (!propertyType) {\n    return undefined;\n  }\n\n  // The ultimate result must be a primitive value.\n  if (undefined === curValue.primitive) {\n    return undefined;\n  }\n\n  return { value: curValue.primitive, type: propertyType };\n}\n\nfunction determineFieldPropertyType(prop: Property): FieldPropertyType | undefined {\n  if (prop.isEnumeration()) {\n    switch (prop.propertyType) {\n      case PropertyType.Integer_Enumeration:\n        return \"int-enum\";\n      case PropertyType.String_Enumeration:\n        return \"string-enum\";\n      default:\n        return undefined;\n    }\n  }\n\n  if (prop.isPrimitive()) {\n    switch (prop.primitiveType) {\n      case PrimitiveType.Boolean:\n        return \"boolean\";\n      case PrimitiveType.String:\n        return prop.extendedTypeName === \"DateTime\" ? \"datetime\" : \"string\";\n      case PrimitiveType.DateTime:\n        return \"datetime\";\n      case PrimitiveType.Double:\n      case PrimitiveType.Long:\n        return \"quantity\";\n      case PrimitiveType.Point2d:\n      case PrimitiveType.Point3d:\n        return \"coordinate\";\n      case PrimitiveType.Binary:\n        return prop.extendedTypeName === \"BeGuid\" ? \"string\" : undefined;\n      case PrimitiveType.Integer:\n      case PrimitiveType.Long:\n        return \"string\";\n      default:\n        return undefined;\n    }\n  }\n\n  return undefined;\n}\n\nexport function createUpdateContext(hostElementId: string | undefined, iModel: IModelDb, deleted: boolean): UpdateFieldsContext {\n  return {\n    hostElementId,\n    getProperty: deleted ? () => undefined : (field) => getFieldPropertyValue(field, iModel),\n  };\n}\n\n// Recompute the display value of a single field, return false if it couldn't be evaluated.\nexport function updateField(field: FieldRun, context: UpdateFieldsContext): boolean {\n  if (context.hostElementId && context.hostElementId !== field.propertyHost.elementId) {\n    return false;\n  }\n\n  let newContent: string | undefined;\n  try {\n    const propValue = context.getProperty(field);\n    if (undefined !== propValue) {\n      newContent = formatFieldValue(propValue, field.formatOptions);\n    }\n  } catch (err) {\n    Logger.logError(BackendLoggerCategory.IModelDb, err);\n  }\n\n  newContent = newContent ?? FieldRun.invalidContentIndicator;\n  if (newContent === field.cachedContent) {\n    return false;\n  }\n\n  field.setCachedContent(newContent);\n  return true;\n}\n\n// Re-evaluates the display strings for all fields that target the element specified by `context` and returns the number\n// of fields whose display strings changed as a result.\nexport function updateFields(textBlock: TextBlock, context: UpdateFieldsContext): number {\n  let numUpdated = 0;\n  for (const { child } of traverseTextBlockComponent(textBlock)) {\n    if (child.type === \"field\" && updateField(child, context)) {\n      ++numUpdated;\n    }\n  }\n\n  return numUpdated;\n}\n\nfunction doUpdateFields(txn: EditTxn, annotationId: Id64String, sourceId: Id64String | undefined, deleted: boolean): void {\n  const iModel = txn.iModel;\n  try {\n    const target = iModel.elements.getElement(annotationId);\n    if (isITextAnnotation(target)) {\n      const context = createUpdateContext(sourceId, iModel, deleted);\n      const updatedBlocks = [];\n      for (const block of target.getTextBlocks()) {\n        if (updateFields(block.textBlock, context)) {\n          updatedBlocks.push(block);\n        }\n      }\n\n      if (updatedBlocks.length > 0) {\n        target.updateTextBlocks(updatedBlocks);\n        target.update(txn);\n      }\n    }\n  } catch (err) {\n    Logger.logError(BackendLoggerCategory.IModelDb, err);\n  }\n}\n\n// Invoked by ElementDrivesTextAnnotation to update fields in target element when source element changes or is deleted.\nexport function updateElementFields(props: RelationshipProps, txn: EditTxn, deleted: boolean): void {\n  doUpdateFields(txn, props.targetId, props.sourceId, deleted);\n}\n\nexport function updateAllFields(annotationElementId: Id64String, txn: EditTxn): void {\n  doUpdateFields(txn, annotationElementId, undefined, false);\n}\n\n"]}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/internal/annotations/fields.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { ECSqlValueType, FieldPrimitiveValue, FieldPropertyType, FieldRun, FieldValue, formatFieldValue, RelationshipProps, TextBlock, traverseTextBlockComponent } from \"@itwin/core-common\";\r\nimport { IModelDb } from \"../../IModelDb\";\r\nimport { assert, DbResult, expectDefined, Id64String, Logger } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"../../BackendLoggerCategory\";\r\nimport { isITextAnnotation } from \"../../annotations/ElementDrivesTextAnnotation\";\r\nimport { AnyClass, EntityClass, PrimitiveType, Property, PropertyType, StructArrayProperty } from \"@itwin/ecschema-metadata\";\r\nimport type { EditTxn } from \"../../EditTxn\";\r\ninterface FieldStructValue { [key: string]: any }\r\n\r\n// An intermediate value obtained while evaluating a FieldPropertyPath.\r\ntype FieldValueType = {\r\n  primitive: FieldPrimitiveValue;\r\n  struct?: never;\r\n  primitiveArray?: never;\r\n  structArray?: never;\r\n} | {\r\n  primitive?: never;\r\n  struct: FieldStructValue;\r\n  primitiveArray?: never;\r\n  structArray?: never;\r\n} | {\r\n  primitive?: never;\r\n  struct?: never;\r\n  primitiveArray: FieldPrimitiveValue[];\r\n  structArray?: never;\r\n} | {\r\n  primitive?: never;\r\n  struct?: never;\r\n  primitiveArray?: never;\r\n  structArray: FieldStructValue[];\r\n}\r\n\r\nexport interface UpdateFieldsContext {\r\n  readonly hostElementId: Id64String | undefined;\r\n\r\n  getProperty(field: FieldRun): FieldValue | undefined\r\n}\r\n\r\n// Resolve the raw primitive value of the property that a field points to.\r\nfunction getFieldPropertyValue(field: FieldRun, iModel: IModelDb): FieldValue | undefined {\r\n  const host = field.propertyHost;\r\n  const schemaItem = iModel.schemaContext.getSchemaItemSync(host.schemaName, host.className);\r\n  if (!EntityClass.isEntityClass(schemaItem)) {\r\n    return undefined;\r\n  }\r\n\r\n  let ecClass: AnyClass = schemaItem;\r\n  const { propertyName, accessors } = field.propertyPath;\r\n  let ecProp = ecClass.getPropertySync(propertyName);\r\n  if (!ecProp) {\r\n    return undefined;\r\n  }\r\n\r\n  const isAspect = ecClass.isSync(\"ElementAspect\", \"BisCore\");\r\n  const where = ` WHERE ${isAspect ? \"Element.Id\" : \"ECInstanceId\"}=${host.elementId}`;\r\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n  let curValue: FieldValueType | undefined = iModel.withPreparedStatement(`SELECT ${propertyName} FROM ${host.schemaName}.${host.className} ${where}`, (stmt) => {\r\n    if (stmt.step() !== DbResult.BE_SQLITE_ROW) {\r\n      return undefined;\r\n    }\r\n\r\n    const rootValue = stmt.getValue(0);\r\n    if (undefined === rootValue || rootValue.isNull) {\r\n      return undefined;\r\n    }\r\n\r\n    switch (rootValue.columnInfo.getType()) {\r\n      case ECSqlValueType.Blob:\r\n        return { primitive: rootValue.getBlob() };\r\n      case ECSqlValueType.Boolean:\r\n        return { primitive: rootValue.getBoolean() };\r\n      case ECSqlValueType.DateTime:\r\n        return { primitive: new Date(rootValue.getDateTime()) };\r\n      case ECSqlValueType.Double:\r\n        return { primitive: rootValue.getDouble() };\r\n      case ECSqlValueType.Guid:\r\n        return { primitive: rootValue.getGuid() };\r\n      case ECSqlValueType.Int:\r\n      case ECSqlValueType.Int64:\r\n        return { primitive: rootValue.getInteger() };\r\n      case ECSqlValueType.Point2d:\r\n        return { primitive: rootValue.getXAndY() };\r\n      case ECSqlValueType.Point3d:\r\n        return { primitive: rootValue.getXYAndZ() };\r\n      case ECSqlValueType.String:\r\n        return { primitive: rootValue.getString() };\r\n      case ECSqlValueType.Struct: {\r\n        ecProp = expectDefined(ecProp);\r\n        assert(ecProp.isStruct());\r\n        ecClass = ecProp.structClass;\r\n        return { struct: rootValue.getStruct() };\r\n      }\r\n      case ECSqlValueType.PrimitiveArray: {\r\n        return { primitiveArray: rootValue.getArray() };\r\n      }\r\n      case ECSqlValueType.StructArray: {\r\n        return { structArray: rootValue.getArray() };\r\n      }\r\n      // Unsupported:\r\n      // case ECSqlValueType.Geometry:\r\n      // case ECSqlValueType.Navigation:\r\n      // case ECSqlValueType.Id:\r\n    }\r\n\r\n    return undefined;\r\n  });\r\n\r\n  if (undefined === curValue) {\r\n    return undefined;\r\n  }\r\n\r\n  if (accessors) {\r\n    for (const accessor of accessors) {\r\n      if (undefined !== curValue.primitive) {\r\n        // Can't index into a primitive.\r\n        return undefined;\r\n      }\r\n\r\n      if (typeof accessor === \"number\") {\r\n        const array: FieldPrimitiveValue[] | FieldStructValue[] | undefined = curValue.primitiveArray ?? curValue.structArray;\r\n        if (!array) {\r\n          return undefined;\r\n        }\r\n\r\n        const index: number = accessor < 0 ? (array.length + accessor) : accessor;\r\n        const item: FieldPrimitiveValue | FieldStructValue = array[index];\r\n        if (undefined === item) {\r\n          return undefined;\r\n        } else if (curValue.primitiveArray) {\r\n          curValue = { primitive: curValue.primitiveArray[index] };\r\n        } else {\r\n          assert(undefined !== curValue.structArray);\r\n          assert(ecProp instanceof StructArrayProperty);\r\n\r\n          ecClass = ecProp.structClass;\r\n          curValue = { struct: curValue.structArray[index] };\r\n        }\r\n      } else {\r\n        if (undefined === curValue.struct) {\r\n          return undefined;\r\n        }\r\n\r\n        const item: any = curValue.struct[accessor];\r\n        if (undefined === item) {\r\n          return undefined;\r\n        }\r\n\r\n        ecProp = ecClass.getPropertySync(accessor);\r\n        if (!ecProp) {\r\n          return undefined;\r\n        }\r\n\r\n        if (ecProp.isArray()) {\r\n          curValue = ecProp.isStruct() ? { structArray: item } : { primitiveArray: item };\r\n        } else if (ecProp.isStruct()) {\r\n          ecClass = ecProp.structClass;\r\n          curValue = { struct: item };\r\n        } else if (ecProp.isPrimitive()) {\r\n          curValue = { primitive: item };\r\n        } else {\r\n          return undefined;\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  const propertyType = determineFieldPropertyType(ecProp);\r\n  if (!propertyType) {\r\n    return undefined;\r\n  }\r\n\r\n  // The ultimate result must be a primitive value.\r\n  if (undefined === curValue.primitive) {\r\n    return undefined;\r\n  }\r\n\r\n  return { value: curValue.primitive, type: propertyType };\r\n}\r\n\r\nfunction determineFieldPropertyType(prop: Property): FieldPropertyType | undefined {\r\n  if (prop.isEnumeration()) {\r\n    switch (prop.propertyType) {\r\n      case PropertyType.Integer_Enumeration:\r\n        return \"int-enum\";\r\n      case PropertyType.String_Enumeration:\r\n        return \"string-enum\";\r\n      default:\r\n        return undefined;\r\n    }\r\n  }\r\n\r\n  if (prop.isPrimitive()) {\r\n    switch (prop.primitiveType) {\r\n      case PrimitiveType.Boolean:\r\n        return \"boolean\";\r\n      case PrimitiveType.String:\r\n        return prop.extendedTypeName === \"DateTime\" ? \"datetime\" : \"string\";\r\n      case PrimitiveType.DateTime:\r\n        return \"datetime\";\r\n      case PrimitiveType.Double:\r\n      case PrimitiveType.Long:\r\n        return \"quantity\";\r\n      case PrimitiveType.Point2d:\r\n      case PrimitiveType.Point3d:\r\n        return \"coordinate\";\r\n      case PrimitiveType.Binary:\r\n        return prop.extendedTypeName === \"BeGuid\" ? \"string\" : undefined;\r\n      case PrimitiveType.Integer:\r\n      case PrimitiveType.Long:\r\n        return \"string\";\r\n      default:\r\n        return undefined;\r\n    }\r\n  }\r\n\r\n  return undefined;\r\n}\r\n\r\nexport function createUpdateContext(hostElementId: string | undefined, iModel: IModelDb, deleted: boolean): UpdateFieldsContext {\r\n  return {\r\n    hostElementId,\r\n    getProperty: deleted ? () => undefined : (field) => getFieldPropertyValue(field, iModel),\r\n  };\r\n}\r\n\r\n// Recompute the display value of a single field, return false if it couldn't be evaluated.\r\nexport function updateField(field: FieldRun, context: UpdateFieldsContext): boolean {\r\n  if (context.hostElementId && context.hostElementId !== field.propertyHost.elementId) {\r\n    return false;\r\n  }\r\n\r\n  let newContent: string | undefined;\r\n  try {\r\n    const propValue = context.getProperty(field);\r\n    if (undefined !== propValue) {\r\n      newContent = formatFieldValue(propValue, field.formatOptions);\r\n    }\r\n  } catch (err) {\r\n    Logger.logError(BackendLoggerCategory.IModelDb, err);\r\n  }\r\n\r\n  newContent = newContent ?? FieldRun.invalidContentIndicator;\r\n  if (newContent === field.cachedContent) {\r\n    return false;\r\n  }\r\n\r\n  field.setCachedContent(newContent);\r\n  return true;\r\n}\r\n\r\n// Re-evaluates the display strings for all fields that target the element specified by `context` and returns the number\r\n// of fields whose display strings changed as a result.\r\nexport function updateFields(textBlock: TextBlock, context: UpdateFieldsContext): number {\r\n  let numUpdated = 0;\r\n  for (const { child } of traverseTextBlockComponent(textBlock)) {\r\n    if (child.type === \"field\" && updateField(child, context)) {\r\n      ++numUpdated;\r\n    }\r\n  }\r\n\r\n  return numUpdated;\r\n}\r\n\r\nfunction doUpdateFields(txn: EditTxn, annotationId: Id64String, sourceId: Id64String | undefined, deleted: boolean): void {\r\n  const iModel = txn.iModel;\r\n  try {\r\n    const target = iModel.elements.getElement(annotationId);\r\n    if (isITextAnnotation(target)) {\r\n      const context = createUpdateContext(sourceId, iModel, deleted);\r\n      const updatedBlocks = [];\r\n      for (const block of target.getTextBlocks()) {\r\n        if (updateFields(block.textBlock, context)) {\r\n          updatedBlocks.push(block);\r\n        }\r\n      }\r\n\r\n      if (updatedBlocks.length > 0) {\r\n        target.updateTextBlocks(updatedBlocks);\r\n        target.update(txn);\r\n      }\r\n    }\r\n  } catch (err) {\r\n    Logger.logError(BackendLoggerCategory.IModelDb, err);\r\n  }\r\n}\r\n\r\n// Invoked by ElementDrivesTextAnnotation to update fields in target element when source element changes or is deleted.\r\nexport function updateElementFields(props: RelationshipProps, txn: EditTxn, deleted: boolean): void {\r\n  doUpdateFields(txn, props.targetId, props.sourceId, deleted);\r\n}\r\n\r\nexport function updateAllFields(annotationElementId: Id64String, txn: EditTxn): void {\r\n  doUpdateFields(txn, annotationElementId, undefined, false);\r\n}\r\n\r\n"]}

package/lib/esm/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/esm/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/esm/internal/cross-package.js

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

package/lib/esm/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,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","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,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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nexport { IModelJsNative, NativeCloudSqlite, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\r\nexport { IModelNative } from \"./NativePlatform\";\r\nexport {\r\n  _nativeDb,\r\n} from \"./Symbols\";\r\n"]}

package/lib/esm/internal/workspace/SettingsEditorImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsEditorImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsEditorImpl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAmB;IACjE,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,SAAS,KAAK,WAAW;QAC3B,OAAO,SAAS,CAAC;IAEnB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/G,IAAI,CAAC,UAAU;YACb,kBAAkB,CAAC,UAAU,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,+DAA+D,WAAW,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1K,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;YACpC,WAAW,EAAE,UAAU,CAAC,KAAK;YAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,WAAW;YACX,WAAW,EAAE,UAAU,CAAC,QAAQ;YAChC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAAmB;IACvE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ;QACV,OAAO,QAAQ,CAAC;IAElB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC;YACrD,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,QAAQ,EAAE;gBACR,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,wCAAwC,OAAO,EAAE;aAC/D;YACD,aAAa,EAAE,UAAU;YACzB,MAAM,EAAE,uBAAuB;YAC/B,QAAQ,EAAE,EAAE,aAAa,EAAE,SAAS,OAAO,WAAW,EAAE;SACzD,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,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/** @packageDocumentation\n * @module Workspace\n */\n\nimport { ITwinSettingsError } from \"@itwin/core-common\";\nimport { GuidString } from \"@itwin/core-bentley\";\nimport { IModelHost } from \"../../IModelHost\";\nimport { settingsWorkspaceDbName } from \"../../workspace/SettingsDb\";\nimport { SettingsContainers } from \"../../workspace/SettingsEditor\";\nimport { BlobContainer } from \"../../BlobContainerService\";\nimport { constructWorkspaceEditor } from \"./WorkspaceImpl\";\nimport { EditableWorkspaceContainer, WorkspaceEditor } from \"../../workspace/WorkspaceEditor\";\n\n/** Obtain a [[WorkspaceEditor]] targeting the single existing settings container for a given iTwin.\n * Returns `undefined` if no container exists. Throws if multiple containers are found.\n * @internal\n */\nexport async function getSettingsEditorForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer } | undefined> {\n  const containerId = await SettingsContainers.getITwinContainerId(iTwinId);\n  if (undefined === containerId)\n    return undefined;\n\n  const editor = constructWorkspaceEditor();\n  try {\n    const userToken = await IModelHost.getAccessToken();\n    const tokenProps = await BlobContainer.service?.requestToken({ accessLevel: \"write\", containerId, userToken });\n    if (!tokenProps)\n      ITwinSettingsError.throwError(\"failed-to-obtain-container-token\", { message: `Failed to obtain access token for iTwin settings container '${containerId}'.`, iTwinId });\n\n    const container = editor.getContainer({\n      accessToken: tokenProps.token,\n      baseUri: tokenProps.baseUri,\n      containerId,\n      storageType: tokenProps.provider,\n      writeable: true,\n    });\n\n    return { editor, container };\n  } catch (error) {\n    editor.close();\n    throw error;\n  }\n}\n\n/** Construct a [[WorkspaceEditor]] targeting the single settings container for a given iTwin.\n * If no container exists, one is created with default metadata. Throws if multiple containers are found.\n * @internal\n */\nexport async function constructSettingsEditorForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer }> {\n  const existing = await getSettingsEditorForITwin(iTwinId);\n  if (existing)\n    return existing;\n\n  const editor = constructWorkspaceEditor();\n  try {\n    const container = await editor.createNewCloudContainer({\n      scope: { iTwinId },\n      metadata: {\n        label: \"iTwin settings\",\n        description: `Default settings container for iTwin ${iTwinId}`,\n      },\n      containerType: \"settings\",\n      dbName: settingsWorkspaceDbName,\n      manifest: { workspaceName: `iTwin ${iTwinId} settings` },\n    });\n\n    return { editor, container };\n  } catch (error) {\n    editor.close();\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"SettingsEditorImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsEditorImpl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAmB;IACjE,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,SAAS,KAAK,WAAW;QAC3B,OAAO,SAAS,CAAC;IAEnB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/G,IAAI,CAAC,UAAU;YACb,kBAAkB,CAAC,UAAU,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,+DAA+D,WAAW,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1K,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;YACpC,WAAW,EAAE,UAAU,CAAC,KAAK;YAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,WAAW;YACX,WAAW,EAAE,UAAU,CAAC,QAAQ;YAChC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAAmB;IACvE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ;QACV,OAAO,QAAQ,CAAC;IAElB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC;YACrD,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,QAAQ,EAAE;gBACR,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,wCAAwC,OAAO,EAAE;aAC/D;YACD,aAAa,EAAE,UAAU;YACzB,MAAM,EAAE,uBAAuB;YAC/B,QAAQ,EAAE,EAAE,aAAa,EAAE,SAAS,OAAO,WAAW,EAAE;SACzD,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport { ITwinSettingsError } from \"@itwin/core-common\";\r\nimport { GuidString } from \"@itwin/core-bentley\";\r\nimport { IModelHost } from \"../../IModelHost\";\r\nimport { settingsWorkspaceDbName } from \"../../workspace/SettingsDb\";\r\nimport { SettingsContainers } from \"../../workspace/SettingsEditor\";\r\nimport { BlobContainer } from \"../../BlobContainerService\";\r\nimport { constructWorkspaceEditor } from \"./WorkspaceImpl\";\r\nimport { EditableWorkspaceContainer, WorkspaceEditor } from \"../../workspace/WorkspaceEditor\";\r\n\r\n/** Obtain a [[WorkspaceEditor]] targeting the single existing settings container for a given iTwin.\r\n * Returns `undefined` if no container exists. Throws if multiple containers are found.\r\n * @internal\r\n */\r\nexport async function getSettingsEditorForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer } | undefined> {\r\n  const containerId = await SettingsContainers.getITwinContainerId(iTwinId);\r\n  if (undefined === containerId)\r\n    return undefined;\r\n\r\n  const editor = constructWorkspaceEditor();\r\n  try {\r\n    const userToken = await IModelHost.getAccessToken();\r\n    const tokenProps = await BlobContainer.service?.requestToken({ accessLevel: \"write\", containerId, userToken });\r\n    if (!tokenProps)\r\n      ITwinSettingsError.throwError(\"failed-to-obtain-container-token\", { message: `Failed to obtain access token for iTwin settings container '${containerId}'.`, iTwinId });\r\n\r\n    const container = editor.getContainer({\r\n      accessToken: tokenProps.token,\r\n      baseUri: tokenProps.baseUri,\r\n      containerId,\r\n      storageType: tokenProps.provider,\r\n      writeable: true,\r\n    });\r\n\r\n    return { editor, container };\r\n  } catch (error) {\r\n    editor.close();\r\n    throw error;\r\n  }\r\n}\r\n\r\n/** Construct a [[WorkspaceEditor]] targeting the single settings container for a given iTwin.\r\n * If no container exists, one is created with default metadata. Throws if multiple containers are found.\r\n * @internal\r\n */\r\nexport async function constructSettingsEditorForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer }> {\r\n  const existing = await getSettingsEditorForITwin(iTwinId);\r\n  if (existing)\r\n    return existing;\r\n\r\n  const editor = constructWorkspaceEditor();\r\n  try {\r\n    const container = await editor.createNewCloudContainer({\r\n      scope: { iTwinId },\r\n      metadata: {\r\n        label: \"iTwin settings\",\r\n        description: `Default settings container for iTwin ${iTwinId}`,\r\n      },\r\n      containerType: \"settings\",\r\n      dbName: settingsWorkspaceDbName,\r\n      manifest: { workspaceName: `iTwin ${iTwinId} settings` },\r\n    });\r\n\r\n    return { editor, container };\r\n  } catch (error) {\r\n    editor.close();\r\n    throw error;\r\n  }\r\n}\r\n"]}