@itwin/core-backend 5.10.0-dev.11 → 5.10.0-dev.13

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

@@ -1 +1 @@
-{"version":3,"file":"ServerBasedLocks.js","sourceRoot":"","sources":["../../../src/internal/ServerBasedLocks.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\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 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    // 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    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\r\n  public [_close]() {\r\n    this._removeOnCommitListener();\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  /** 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    // see if we hold the exclusive lock. or if one of the element's owners is exclusively locked (recursively)\r\n    return this.getLockState(id) === LockState.Exclusive || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  public holdsSharedLock(id: Id64String): boolean {\r\n    const state = this.getLockState(id);\r\n    // see if we hold shared or exclusive lock, or if an owner has exclusive lock. If so we implicitly have shared lock, but owner holding shared lock doesn't help.\r\n    return (state === LockState.Shared || state === LockState.Exclusive) || this.ownerHoldsExclusiveLock(id);\r\n  }\r\n\r\n  /** if the shared lock on the element supplied is not already held, add it to the set of shared locks required. Then, check owners. */\r\n  private addSharedLock(id: Id64String | undefined, locks: Set<Id64String>) {\r\n    // if the id is not valid, or of the lock is already in the set, or if we already hold a shared lock, we're done\r\n    // Note: if we hold a shared lock, it is guaranteed that we also hold all required shared locks on owners.\r\n    if (id === undefined || !Id64.isValid(id) || locks.has(id) || this.holdsSharedLock(id))\r\n      return;\r\n\r\n    locks.add(id); // add to set of needed shared locks\r\n    this.addOwnerSharedLocks(id, locks); // check parent models and groups\r\n  }\r\n\r\n  /** add owners (recursively) of an element to a list of required shared locks, if not already held. */\r\n  private addOwnerSharedLocks(id: Id64String, locks: Set<Id64String>) {\r\n    const el = this.getOwners(id);\r\n    this.addSharedLock(el.parentId, locks); // if this element is in a group\r\n    this.addSharedLock(el.modelId, locks); // check its model\r\n  }\r\n\r\n  /** attempt to acquire all necessary locks for a set of elements */\r\n  private async acquireAllLocks(locks: LockMap) {\r\n    if (locks.size === 0) // no locks are required.\r\n      return;\r\n\r\n    const sharedLocks = new Set<Id64String>();\r\n    for (const lock of locks)\r\n      this.addOwnerSharedLocks(lock[0], sharedLocks);\r\n\r\n    for (const shared of sharedLocks) {\r\n      if (!locks.has(shared)) // we may already be asking for exclusive lock\r\n        locks.set(shared, LockState.Shared);\r\n    }\r\n\r\n    await IModelHost[_hubAccess].acquireLocks(this.briefcase, locks); // throws if unsuccessful\r\n    for (const lock of locks) {\r\n      this.insertLock(lock[0], lock[1], LockOrigin.Acquired);\r\n      this.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. Save that fact. */\r\n  public [_elementWasCreated](id: Id64String) {\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"]}
+{"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/Category.d.ts

@@ -72,7 +72,7 @@ export declare class SubCategory extends DefinitionElement {
     static insert(txn: EditTxn, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
     /**
      * Insert a new SubCategory
-     * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use SubCategory.insert(txn, ...) instead.
+     * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use SubCategory.insert(txn, ...) instead.
      */
     static insert(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
 }
@@ -112,7 +112,7 @@ export declare class Category extends DefinitionElement {
     setDefaultAppearance(txn: EditTxn, props: SubCategoryAppearance.Props | SubCategoryAppearance): void;
     /**
      * Set the appearance of the default SubCategory for this Category
-     * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use Category.setDefaultAppearance(txn, ...) instead.
+     * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use Category.setDefaultAppearance(txn, ...) instead.
      */
     setDefaultAppearance(props: SubCategoryAppearance.Props | SubCategoryAppearance): void;
 }
@@ -154,7 +154,7 @@ export declare class DrawingCategory extends Category {
     static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
     /**
      * Insert a new DrawingCategory
-     * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use DrawingCategory.insert(txn, ...) instead.
+     * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use DrawingCategory.insert(txn, ...) instead.
      */
     static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
 }
@@ -196,7 +196,7 @@ export declare class SpatialCategory extends Category {
     static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
     /**
      * Insert a new SpatialCategory
-     * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use SpatialCategory.insert(txn, ...) instead.
+     * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use SpatialCategory.insert(txn, ...) instead.
      */
     static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;
 }

package/lib/esm/Category.js.map

@@ -1 +1 @@
-{"version":3,"file":"Category.js","sourceRoot":"","sources":["../../src/Category.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  BisCodeSpec, CategoryProps, Code, CodeScopeProps, CodeSpec, ElementProps, Rank, SubCategoryAppearance, SubCategoryProps,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement } from \"./Element\";\r\nimport { EditTxn } from \"./EditTxn\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { CategoryOwnsSubCategories } from \"./NavigationRelationship\";\r\nimport { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from \"./Entity\";\r\nimport { _implicitTxn } from \"./internal/Symbols\";\r\n\r\n/** Defines the appearance for graphics in Geometric elements\r\n * @public @preview\r\n */\r\nexport class SubCategory extends DefinitionElement {\r\n  public static override get className(): string { return \"SubCategory\"; }\r\n  /** The Appearance parameters for this SubCategory */\r\n  public appearance: SubCategoryAppearance;\r\n  /** Optional description of this SubCategory. */\r\n  public description?: string;\r\n\r\n  protected constructor(props: SubCategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.appearance = new SubCategoryAppearance(props.appearance);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /**\r\n   * SubCategory custom HandledProps include 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\r\n    { propertyName: \"description\", source: \"Class\" },\r\n    { propertyName: \"properties\", source: \"Class\" },\r\n  ];\r\n\r\n  /**\r\n   * SubCategory deserializes 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override deserialize(props: DeserializeEntityArgs): SubCategoryProps {\r\n    const elProps = super.deserialize(props) as SubCategoryProps;\r\n    elProps.description = JsonUtils.asString(props.row.description);\r\n    if (props.row.properties !== '') {\r\n      elProps.appearance = JSON.parse(props.row.properties) as SubCategoryAppearance.Props;\r\n    } else {\r\n      elProps.appearance = undefined;\r\n    }\r\n    return elProps;\r\n  }\r\n\r\n  /**\r\n   * SubCategory serialize 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override serialize(props: SubCategoryProps, iModel: IModelDb): ECSqlRow {\r\n    const inst = super.serialize(props, iModel);\r\n    if (props.description !== undefined) {\r\n      inst.description = props.description;\r\n    }\r\n    if (props.appearance !== undefined) {\r\n      inst.properties = JSON.stringify(props.appearance);\r\n    }\r\n    return inst;\r\n  }\r\n\r\n  public override toJSON(): SubCategoryProps {\r\n    const val = super.toJSON() as SubCategoryProps;\r\n    val.appearance = this.appearance.toJSON();\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the SubCategory's name (its Code value). */\r\n  public getSubCategoryName(): string { return this.code.value; }\r\n  /** Get the Id of the SubCategory. */\r\n  public getSubCategoryId(): Id64String { return this.id; }\r\n  /** Get the Id of this SubCategory's parent Category. */\r\n  public getCategoryId(): Id64String { return this.parent ? this.parent.id : Id64.invalid; }\r\n  /** Check if this is the default SubCategory of its parent Category. */\r\n  public get isDefaultSubCategory(): boolean { return IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }\r\n\r\n  /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.\r\n   * @param iModel  The IModel\r\n   * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.\r\n   * @param codeValue The name of the SubCategory\r\n   */\r\n  public static createCode(iModel: IModelDb, parentCategoryId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.subCategory);\r\n    return new Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SubCategory\r\n   * @param iModelDb The iModel\r\n   * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The newly constructed SubCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): SubCategory {\r\n    if (appearance instanceof SubCategoryAppearance)\r\n      appearance = appearance.toJSON();\r\n\r\n    const parentCategory = iModelDb.elements.getElement<Category>(parentCategoryId);\r\n    const subCategoryProps: SubCategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: parentCategory.model,\r\n      parent: new CategoryOwnsSubCategories(parentCategoryId),\r\n      code: this.createCode(iModelDb, parentCategoryId, name),\r\n      appearance,\r\n    };\r\n    return new SubCategory(subCategoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new SubCategory\r\n   * @param txn The EditTxn to use\r\n   * @param parentCategoryId Insert the new SubCategory as a child of this Category\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The Id of the newly inserted SubCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new SubCategory\r\n   * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use SubCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const subCategory = this.create(txn.iModel, parentCategoryId, name, appearance);\r\n    return subCategory.insert(txn);\r\n  }\r\n}\r\n\r\n/** A Category element is the target of the `category` member of [[GeometricElement]].\r\n * @public @preview\r\n */\r\nexport class Category extends DefinitionElement {\r\n  public static override get className(): string { return \"Category\"; }\r\n  public rank: Rank = Rank.User;\r\n  public description?: string;\r\n\r\n  protected constructor(props: CategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.rank = JsonUtils.asInt(props.rank);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /**\r\n   * Category custom HandledProps include 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\r\n    { propertyName: \"rank\", source: \"Class\" },\r\n    { propertyName: \"description\", source: \"Class\" },\r\n  ];\r\n\r\n  /**\r\n   * Category deserializes 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override deserialize(props: DeserializeEntityArgs): CategoryProps {\r\n    const elProps = super.deserialize(props) as CategoryProps;\r\n    elProps.description = JsonUtils.asString(props.row.description);\r\n    elProps.rank = JsonUtils.asInt(props.row.rank);\r\n    return elProps;\r\n  }\r\n\r\n  /**\r\n   * Category serialize 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override serialize(props: CategoryProps, iModel: IModelDb): ECSqlRow {\r\n    const inst = super.serialize(props, iModel);\r\n    if (undefined !== props.description) {\r\n      inst.description = props.description;\r\n    }\r\n    inst.rank = props.rank;\r\n    return inst;\r\n  }\r\n  public override toJSON(): CategoryProps {\r\n    const val = super.toJSON() as CategoryProps;\r\n    val.rank = this.rank;\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the Id of the default SubCategory for this Category. */\r\n  public myDefaultSubCategoryId(): Id64String { return IModelDb.getDefaultSubCategoryId(this.id); }\r\n\r\n  /**\r\n   * Set the appearance of the default SubCategory for this Category\r\n   * @beta\r\n   */\r\n  public setDefaultAppearance(txn: EditTxn, props: SubCategoryAppearance.Props | SubCategoryAppearance): void;\r\n  /**\r\n   * Set the appearance of the default SubCategory for this Category\r\n   * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use Category.setDefaultAppearance(txn, ...) instead.\r\n   */\r\n  public setDefaultAppearance(props: SubCategoryAppearance.Props | SubCategoryAppearance): void;\r\n  public setDefaultAppearance(txnOrProps: EditTxn | SubCategoryAppearance.Props | SubCategoryAppearance, props?: SubCategoryAppearance.Props | SubCategoryAppearance): void {\r\n    let txn: EditTxn;\r\n    let appearance: SubCategoryAppearance.Props | SubCategoryAppearance;\r\n    if (txnOrProps instanceof EditTxn) {\r\n      txn = txnOrProps;\r\n      if (props === undefined)\r\n        throw new Error(\"Invalid argument\");\r\n      appearance = props;\r\n    } else {\r\n      txn = this.iModel[_implicitTxn];\r\n      appearance = txnOrProps;\r\n    }\r\n    if (appearance instanceof SubCategoryAppearance)\r\n      appearance = appearance.toJSON();\r\n\r\n    const subCat = this.iModel.elements.getElement<SubCategory>(this.myDefaultSubCategoryId());\r\n    subCat.appearance = new SubCategoryAppearance(appearance);\r\n    subCat.update(txn);\r\n  }\r\n}\r\n\r\n/** Categorizes 2d GeometricElements.\r\n * @public @preview\r\n */\r\nexport class DrawingCategory extends Category {\r\n  public static override get className(): string { return \"DrawingCategory\"; }\r\n\r\n  protected constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by DrawingCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.drawingCategory; }\r\n\r\n  /** Looks up the CategoryId of a DrawingCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A drawing category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new DrawingCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @returns The newly constructed DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DrawingCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new DrawingCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new DrawingCategory\r\n   * @param txn The EditTxn to use\r\n   * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory\r\n   * @returns The Id of the newly inserted DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new DrawingCategory\r\n   * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use DrawingCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const category = this.create(txn.iModel, definitionModelId, name);\r\n    category.id = category.insert(txn);\r\n    category.setDefaultAppearance(txn, defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n\r\n/** Categorizes SpatialElements. See [how to create a SpatialCategory]($docs/learning/backend/CreateElements.md#SpatialCategory).\r\n * @public @preview\r\n */\r\nexport class SpatialCategory extends Category {\r\n  public static override get className(): string { return \"SpatialCategory\"; }\r\n  protected constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by SpatialCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.spatialCategory; }\r\n\r\n  /** Looks up the CategoryId of a SpatialCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A spatial category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SpatialCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the SpatialCategory\r\n   * @returns The newly constructed SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): SpatialCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new SpatialCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new SpatialCategory\r\n   * @param txn The EditTxn to use\r\n   * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel\r\n   * @param name The name of the SpatialCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory\r\n   * @returns The Id of the newly inserted SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new SpatialCategory\r\n   * @deprecated in 5.1.9 - will not be removed until after 2026-08-04. Use SpatialCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const category = this.create(txn.iModel, definitionModelId, name);\r\n    category.id = category.insert(txn);\r\n    category.setDefaultAppearance(txn, defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Category.js","sourceRoot":"","sources":["../../src/Category.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  BisCodeSpec, CategoryProps, Code, CodeScopeProps, CodeSpec, ElementProps, Rank, SubCategoryAppearance, SubCategoryProps,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement } from \"./Element\";\r\nimport { EditTxn } from \"./EditTxn\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { CategoryOwnsSubCategories } from \"./NavigationRelationship\";\r\nimport { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from \"./Entity\";\r\nimport { _implicitTxn } from \"./internal/Symbols\";\r\n\r\n/** Defines the appearance for graphics in Geometric elements\r\n * @public @preview\r\n */\r\nexport class SubCategory extends DefinitionElement {\r\n  public static override get className(): string { return \"SubCategory\"; }\r\n  /** The Appearance parameters for this SubCategory */\r\n  public appearance: SubCategoryAppearance;\r\n  /** Optional description of this SubCategory. */\r\n  public description?: string;\r\n\r\n  protected constructor(props: SubCategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.appearance = new SubCategoryAppearance(props.appearance);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /**\r\n   * SubCategory custom HandledProps include 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\r\n    { propertyName: \"description\", source: \"Class\" },\r\n    { propertyName: \"properties\", source: \"Class\" },\r\n  ];\r\n\r\n  /**\r\n   * SubCategory deserializes 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override deserialize(props: DeserializeEntityArgs): SubCategoryProps {\r\n    const elProps = super.deserialize(props) as SubCategoryProps;\r\n    elProps.description = JsonUtils.asString(props.row.description);\r\n    if (props.row.properties !== '') {\r\n      elProps.appearance = JSON.parse(props.row.properties) as SubCategoryAppearance.Props;\r\n    } else {\r\n      elProps.appearance = undefined;\r\n    }\r\n    return elProps;\r\n  }\r\n\r\n  /**\r\n   * SubCategory serialize 'description' and 'properties'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override serialize(props: SubCategoryProps, iModel: IModelDb): ECSqlRow {\r\n    const inst = super.serialize(props, iModel);\r\n    if (props.description !== undefined) {\r\n      inst.description = props.description;\r\n    }\r\n    if (props.appearance !== undefined) {\r\n      inst.properties = JSON.stringify(props.appearance);\r\n    }\r\n    return inst;\r\n  }\r\n\r\n  public override toJSON(): SubCategoryProps {\r\n    const val = super.toJSON() as SubCategoryProps;\r\n    val.appearance = this.appearance.toJSON();\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the SubCategory's name (its Code value). */\r\n  public getSubCategoryName(): string { return this.code.value; }\r\n  /** Get the Id of the SubCategory. */\r\n  public getSubCategoryId(): Id64String { return this.id; }\r\n  /** Get the Id of this SubCategory's parent Category. */\r\n  public getCategoryId(): Id64String { return this.parent ? this.parent.id : Id64.invalid; }\r\n  /** Check if this is the default SubCategory of its parent Category. */\r\n  public get isDefaultSubCategory(): boolean { return IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }\r\n\r\n  /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.\r\n   * @param iModel  The IModel\r\n   * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.\r\n   * @param codeValue The name of the SubCategory\r\n   */\r\n  public static createCode(iModel: IModelDb, parentCategoryId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.subCategory);\r\n    return new Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SubCategory\r\n   * @param iModelDb The iModel\r\n   * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The newly constructed SubCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): SubCategory {\r\n    if (appearance instanceof SubCategoryAppearance)\r\n      appearance = appearance.toJSON();\r\n\r\n    const parentCategory = iModelDb.elements.getElement<Category>(parentCategoryId);\r\n    const subCategoryProps: SubCategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: parentCategory.model,\r\n      parent: new CategoryOwnsSubCategories(parentCategoryId),\r\n      code: this.createCode(iModelDb, parentCategoryId, name),\r\n      appearance,\r\n    };\r\n    return new SubCategory(subCategoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new SubCategory\r\n   * @param txn The EditTxn to use\r\n   * @param parentCategoryId Insert the new SubCategory as a child of this Category\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The Id of the newly inserted SubCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new SubCategory\r\n   * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use SubCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const subCategory = this.create(txn.iModel, parentCategoryId, name, appearance);\r\n    return subCategory.insert(txn);\r\n  }\r\n}\r\n\r\n/** A Category element is the target of the `category` member of [[GeometricElement]].\r\n * @public @preview\r\n */\r\nexport class Category extends DefinitionElement {\r\n  public static override get className(): string { return \"Category\"; }\r\n  public rank: Rank = Rank.User;\r\n  public description?: string;\r\n\r\n  protected constructor(props: CategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.rank = JsonUtils.asInt(props.rank);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /**\r\n   * Category custom HandledProps include 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\r\n    { propertyName: \"rank\", source: \"Class\" },\r\n    { propertyName: \"description\", source: \"Class\" },\r\n  ];\r\n\r\n  /**\r\n   * Category deserializes 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override deserialize(props: DeserializeEntityArgs): CategoryProps {\r\n    const elProps = super.deserialize(props) as CategoryProps;\r\n    elProps.description = JsonUtils.asString(props.row.description);\r\n    elProps.rank = JsonUtils.asInt(props.row.rank);\r\n    return elProps;\r\n  }\r\n\r\n  /**\r\n   * Category serialize 'rank' and 'description'.\r\n   * @inheritdoc\r\n   * @beta\r\n   */\r\n  public static override serialize(props: CategoryProps, iModel: IModelDb): ECSqlRow {\r\n    const inst = super.serialize(props, iModel);\r\n    if (undefined !== props.description) {\r\n      inst.description = props.description;\r\n    }\r\n    inst.rank = props.rank;\r\n    return inst;\r\n  }\r\n  public override toJSON(): CategoryProps {\r\n    const val = super.toJSON() as CategoryProps;\r\n    val.rank = this.rank;\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the Id of the default SubCategory for this Category. */\r\n  public myDefaultSubCategoryId(): Id64String { return IModelDb.getDefaultSubCategoryId(this.id); }\r\n\r\n  /**\r\n   * Set the appearance of the default SubCategory for this Category\r\n   * @beta\r\n   */\r\n  public setDefaultAppearance(txn: EditTxn, props: SubCategoryAppearance.Props | SubCategoryAppearance): void;\r\n  /**\r\n   * Set the appearance of the default SubCategory for this Category\r\n   * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use Category.setDefaultAppearance(txn, ...) instead.\r\n   */\r\n  public setDefaultAppearance(props: SubCategoryAppearance.Props | SubCategoryAppearance): void;\r\n  public setDefaultAppearance(txnOrProps: EditTxn | SubCategoryAppearance.Props | SubCategoryAppearance, props?: SubCategoryAppearance.Props | SubCategoryAppearance): void {\r\n    let txn: EditTxn;\r\n    let appearance: SubCategoryAppearance.Props | SubCategoryAppearance;\r\n    if (txnOrProps instanceof EditTxn) {\r\n      txn = txnOrProps;\r\n      if (props === undefined)\r\n        throw new Error(\"Invalid argument\");\r\n      appearance = props;\r\n    } else {\r\n      txn = this.iModel[_implicitTxn];\r\n      appearance = txnOrProps;\r\n    }\r\n    if (appearance instanceof SubCategoryAppearance)\r\n      appearance = appearance.toJSON();\r\n\r\n    const subCat = this.iModel.elements.getElement<SubCategory>(this.myDefaultSubCategoryId());\r\n    subCat.appearance = new SubCategoryAppearance(appearance);\r\n    subCat.update(txn);\r\n  }\r\n}\r\n\r\n/** Categorizes 2d GeometricElements.\r\n * @public @preview\r\n */\r\nexport class DrawingCategory extends Category {\r\n  public static override get className(): string { return \"DrawingCategory\"; }\r\n\r\n  protected constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by DrawingCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.drawingCategory; }\r\n\r\n  /** Looks up the CategoryId of a DrawingCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A drawing category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new DrawingCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @returns The newly constructed DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DrawingCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new DrawingCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new DrawingCategory\r\n   * @param txn The EditTxn to use\r\n   * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory\r\n   * @returns The Id of the newly inserted DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new DrawingCategory\r\n   * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use DrawingCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const category = this.create(txn.iModel, definitionModelId, name);\r\n    category.id = category.insert(txn);\r\n    category.setDefaultAppearance(txn, defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n\r\n/** Categorizes SpatialElements. See [how to create a SpatialCategory]($docs/learning/backend/CreateElements.md#SpatialCategory).\r\n * @public @preview\r\n */\r\nexport class SpatialCategory extends Category {\r\n  public static override get className(): string { return \"SpatialCategory\"; }\r\n  protected constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by SpatialCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.spatialCategory; }\r\n\r\n  /** Looks up the CategoryId of a SpatialCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A spatial category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SpatialCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the SpatialCategory\r\n   * @returns The newly constructed SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): SpatialCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new SpatialCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a new SpatialCategory\r\n   * @param txn The EditTxn to use\r\n   * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel\r\n   * @param name The name of the SpatialCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory\r\n   * @returns The Id of the newly inserted SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   * @beta\r\n   */\r\n  public static insert(txn: EditTxn, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  /**\r\n   * Insert a new SpatialCategory\r\n   * @deprecated in 5.9.0 - will not be removed until after 2026-08-04. Use SpatialCategory.insert(txn, ...) instead.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String;\r\n  public static insert(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\r\n    const category = this.create(txn.iModel, definitionModelId, name);\r\n    category.id = category.insert(txn);\r\n    category.setDefaultAppearance(txn, defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n"]}

package/lib/esm/ChangesetECAdaptor.d.ts

@@ -6,7 +6,7 @@ import { AnyDb, SqliteChangeOp, SqliteChangesetReader, SqliteValueStage } from "
 /**
  * Record meta data for the change.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangeMeta]($backend) with [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangeMeta]($backend) with [ChangesetReader]($backend) instead.
  * */
 export interface ChangeMetaData {
     /** list of tables making up this EC change */
@@ -25,7 +25,7 @@ export interface ChangeMetaData {
 /**
  * Represent EC change derived from low level sqlite change
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangeInstance]($backend) with [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangeInstance]($backend) with [ChangesetReader]($backend) instead.
  */
 export interface ChangedECInstance {
     ECInstanceId: Id64String;
@@ -36,7 +36,7 @@ export interface ChangedECInstance {
 /**
  * Represents a cache for unifying EC changes.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangeCache]($backend) with [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangeCache]($backend) with [ChangesetReader]($backend) instead.
  */
 export interface ECChangeUnifierCache extends Disposable {
     /**
@@ -64,7 +64,7 @@ export interface ECChangeUnifierCache extends Disposable {
 }
 /**
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangeUnifierCache.createInMemoryCache]($backend) / [ChangeUnifierCache.createSqliteBackedCache]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangeUnifierCache.createInMemoryCache]($backend) / [ChangeUnifierCache.createSqliteBackedCache]($backend) instead.
 */
 export declare namespace ECChangeUnifierCache {
     /**
@@ -87,7 +87,7 @@ export declare namespace ECChangeUnifierCache {
  * Partial changes is per table and a single instance can
  * span multiple tables.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [PartialChangeUnifier]($backend) with [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [PartialChangeUnifier]($backend) with [ChangesetReader]($backend) instead.
  */
 export declare class PartialECChangeUnifier implements Disposable {
     private _db;
@@ -147,7 +147,7 @@ export declare class PartialECChangeUnifier implements Disposable {
  * it is per table while a single instance can span multiple table.
  * @note PrimitiveArray and StructArray are not supported types.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangesetReader]($backend) instead.
  *
 */
 export declare class ChangesetECAdaptor implements Disposable {

package/lib/esm/ChangesetECAdaptor.js

@@ -295,7 +295,7 @@ class ECDbMap {
 /**
  * Helper function to convert between JS DateTime & SQLite JulianDay values.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. The DateTime namespace is deprecated and will be removed in a future release.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. The DateTime namespace is deprecated and will be removed in a future release.
  * */
 var DateTime;
 (function (DateTime) {
@@ -324,7 +324,7 @@ var DateTime;
 })(DateTime || (DateTime = {}));
 /**
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangeUnifierCache.createInMemoryCache]($backend) / [ChangeUnifierCache.createSqliteBackedCache]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangeUnifierCache.createInMemoryCache]($backend) / [ChangeUnifierCache.createSqliteBackedCache]($backend) instead.
 */
 export var ECChangeUnifierCache;
 (function (ECChangeUnifierCache) {
@@ -524,7 +524,7 @@ class SqliteBackedInstanceCache {
  * Partial changes is per table and a single instance can
  * span multiple tables.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [PartialChangeUnifier]($backend) with [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [PartialChangeUnifier]($backend) with [ChangesetReader]($backend) instead.
  */
 export class PartialECChangeUnifier {
     _db;
@@ -687,7 +687,7 @@ export class PartialECChangeUnifier {
  * it is per table while a single instance can span multiple table.
  * @note PrimitiveArray and StructArray are not supported types.
  * @beta
- * @deprecated in 5.1.9 - will not be removed until after 2027-05-04. Use [ChangesetReader]($backend) instead.
+ * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use [ChangesetReader]($backend) instead.
  *
 */
 export class ChangesetECAdaptor {