@itwin/core-backend 5.9.0-dev.1 → 5.9.0-dev.10

package/lib/esm/SheetIndex.js

@@ -7,8 +7,10 @@
  */
 import { BisCodeSpec, Code, IModelError } from "@itwin/core-common";
 import { InformationReferenceElement } from "./Element";
+import { EditTxn } from "./EditTxn";
 import { IModelStatus } from "@itwin/core-bentley";
 import { SheetIndexFolderOwnsEntries, SheetIndexOwnsEntries, SheetIndexReferenceRefersToSheetIndex, SheetReferenceRefersToSheet } from "./NavigationRelationship";
+import { _implicitTxn } from "./internal/Symbols";
 /** A [structured collection]($docs/bis/domains/drawings-sheets#sheet-index) of [[SheetIndexEntry]]s.
  * The sheet index is a tree whose leaf nodes refer to [[Sheet]]s, optionally grouped by [[SheetIndexFolder]]s and/or incorporating
  * sub-trees via [[SheetIndexReference]]s.
@@ -40,17 +42,10 @@ export class SheetIndex extends InformationReferenceElement {
         };
         return new this(props, iModelDb);
     }
-    /** Insert a SheetIndex
-     * @param iModelDb The IModelDb
-     * @param modelId The Id of the Model that contains the SheetIndex and provides the scope for its name.
-     * @param name The name (codeValue) of the SheetIndex
-     * @returns The Id of the newly inserted SheetIndex
-     * @throws [[IModelError]] if there is a problem inserting the SheetIndex
-     */
-    static insert(iModelDb, modelId, name) {
-        const instance = this.create(iModelDb, modelId, name);
-        const elements = iModelDb.elements;
-        instance.id = elements.insertElement(instance.toJSON());
+    static insert(txnOrDb, modelId, name) {
+        const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];
+        const instance = this.create(txn.iModel, modelId, name);
+        instance.id = instance.insert(txn);
         return instance.id;
     }
 }
@@ -108,14 +103,16 @@ export class SheetIndexFolder extends SheetIndexEntry {
         const props = this.createProps(arg);
         return new this(props, arg.iModelDb);
     }
-    /** Create a new SheetIndexFolder
-     * @returns The Id of the newly inserted SheetIndexFolder element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static insert(arg) {
-        const instance = this.create(arg);
-        const elements = arg.iModelDb.elements;
-        instance.id = elements.insertElement(instance.toJSON());
+    static insert(txnOrArg, arg) {
+        const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];
+        const createArg = txnOrArg instanceof EditTxn ? arg : {
+            sheetIndexModelId: txnOrArg.sheetIndexModelId,
+            parentId: txnOrArg.parentId,
+            name: txnOrArg.name,
+            priority: txnOrArg.priority,
+        };
+        const instance = this.create({ ...createArg, iModelDb: txn.iModel });
+        instance.id = instance.insert(txn);
         return instance.id;
     }
 }
@@ -155,14 +152,17 @@ export class SheetIndexReference extends SheetIndexEntry {
         };
         return new this(props, arg.iModelDb);
     }
-    /** Create a new SheetIndexReference
-     * @returns The Id of the newly inserted SheetIndexReference element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static insert(arg) {
-        const instance = this.create(arg);
-        const elements = arg.iModelDb.elements;
-        instance.id = elements.insertElement(instance.toJSON());
+    static insert(txnOrArg, arg) {
+        const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];
+        const createArg = txnOrArg instanceof EditTxn ? arg : {
+            sheetIndexModelId: txnOrArg.sheetIndexModelId,
+            parentId: txnOrArg.parentId,
+            name: txnOrArg.name,
+            priority: txnOrArg.priority,
+            sheetIndexId: txnOrArg.sheetIndexId,
+        };
+        const instance = this.create({ ...createArg, iModelDb: txn.iModel });
+        instance.id = instance.insert(txn);
         return instance.id;
     }
     /** @alpha */
@@ -208,14 +208,17 @@ export class SheetReference extends SheetIndexEntry {
         };
         return new this(props, arg.iModelDb);
     }
-    /** Insert a new SheetReference
-     * @returns The Id of the newly inserted SheetReference element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static insert(arg) {
-        const instance = this.create(arg);
-        const elements = arg.iModelDb.elements;
-        instance.id = elements.insertElement(instance.toJSON());
+    static insert(txnOrArg, arg) {
+        const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];
+        const createArg = txnOrArg instanceof EditTxn ? arg : {
+            sheetIndexModelId: txnOrArg.sheetIndexModelId,
+            parentId: txnOrArg.parentId,
+            name: txnOrArg.name,
+            priority: txnOrArg.priority,
+            sheetId: txnOrArg.sheetId,
+        };
+        const instance = this.create({ ...createArg, iModelDb: txn.iModel });
+        instance.id = instance.insert(txn);
         return instance.id;
     }
     /** @alpha */

package/lib/esm/SheetIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"SheetIndex.js","sourceRoot":"","sources":["../../src/SheetIndex.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { BisCodeSpec, Code, CodeScopeProps, CodeSpec, ElementProps, EntityReferenceSet, IModelError, RelatedElementProps, SheetIndexEntryProps, SheetIndexFolderProps, SheetIndexReferenceProps, SheetReferenceProps } from \"@itwin/core-common\";\nimport { InformationReferenceElement, Sheet } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { Id64String, IModelStatus } from \"@itwin/core-bentley\";\nimport { SheetIndexFolderOwnsEntries, SheetIndexOwnsEntries, SheetIndexReferenceRefersToSheetIndex, SheetReferenceRefersToSheet } from \"./NavigationRelationship\";\n\n/** Arguments used to create a [[SheetIndexEntry]].\n * @beta\n */\nexport interface SheetIndexEntryCreateArgs {\n  /** The iModel that will contain the sheet index entry. */\n  iModelDb: IModelDb;\n  /** The Id of the [[SheetIndexModel]] that will contain the sheet index entry. */\n  sheetIndexModelId: Id64String;\n  /** The [[SheetIndex]] or [[SheetIndexFolder]] that is parent to this SheetIndexEntry */\n  parentId: Id64String;\n  /** The name of the SheetIndexEntry */\n  name: string;\n  /** The priority of the SheetIndexEntry */\n  priority: number;\n}\n\n/** Arguments supplied when creating a [[SheetIndexReference]].\n * @beta\n */\nexport interface SheetIndexReferenceCreateArgs extends SheetIndexEntryCreateArgs {\n  /** The [[SheetIndex]] to which the reference refers. */\n  sheetIndexId?: Id64String;\n}\n\n/** Arguments supplied when creating a [[SheetReference]].\n * @beta\n */\nexport interface SheetReferenceCreateArgs extends SheetIndexEntryCreateArgs {\n  /** The [[Sheet]] to which the reference refers. */\n  sheetId?: Id64String;\n}\n\n/** A [structured collection]($docs/bis/domains/drawings-sheets#sheet-index) of [[SheetIndexEntry]]s.\n * The sheet index is a tree whose leaf nodes refer to [[Sheet]]s, optionally grouped by [[SheetIndexFolder]]s and/or incorporating\n * sub-trees via [[SheetIndexReference]]s.\n * @beta\n */\nexport class SheetIndex extends InformationReferenceElement {\n  public static override get className(): string { return \"SheetIndex\"; }\n\n  /** Create a Code for a SheetIndex given a name that is meant to be unique within the scope of the specified SheetIndexModel.\n   * @param iModel  The IModelDb\n   * @param scopeSheetIndexModelId The Id of the Model that contains the LinkElement and provides the scope for its name.\n   * @param codeValue The SheetIndex name\n   */\n  public static createCode(iModel: IModelDb, scopeSheetIndexModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.sheetIndex);\n    return new Code({ spec: codeSpec.id, scope: scopeSheetIndexModelId, value: codeValue });\n  }\n\n  /** Create a SheetIndex\n   * @param iModelDb The IModelDb\n   * @param modelId The Id of the Model that contains the SheetIndex and provides the scope for its name.\n   * @param name The name (codeValue) of the SheetIndex\n   * @returns The newly constructed SheetIndex\n   * @throws [[IModelError]] if there is a problem creating the SheetIndex\n   */\n  public static create(iModelDb: IModelDb, modelId: Id64String, name: string): SheetIndex {\n    const props: ElementProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, modelId, name).toJSON(),\n      model: modelId,\n    };\n    return new this(props, iModelDb);\n  }\n\n  /** Insert a SheetIndex\n   * @param iModelDb The IModelDb\n   * @param modelId The Id of the Model that contains the SheetIndex and provides the scope for its name.\n   * @param name The name (codeValue) of the SheetIndex\n   * @returns The Id of the newly inserted SheetIndex\n   * @throws [[IModelError]] if there is a problem inserting the SheetIndex\n   */\n  public static insert(iModelDb: IModelDb, modelId: Id64String, name: string): Id64String {\n    const instance = this.create(iModelDb, modelId, name);\n    const elements = iModelDb.elements;\n    instance.id = elements.insertElement(instance.toJSON());\n    return instance.id;\n  }\n}\n\n/** The base class for all elements that can participate in a [[SheetIndex]] hierarchy.\n * @beta\n*/\nexport abstract class SheetIndexEntry extends InformationReferenceElement {\n  public static override get className(): string { return \"SheetIndexEntry\"; }\n  /** Can be used to prioritize or order members within a SheetIndex or SheetIndexFolder. */\n  public entryPriority: number;\n\n  protected constructor(props: SheetIndexEntryProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.entryPriority = props.entryPriority;\n  }\n\n  public override toJSON(): SheetIndexEntryProps {\n    return { ...super.toJSON(), entryPriority: this.entryPriority };\n  }\n\n  /** Create a Code for a Sheet Index Entry given a name that is meant to be unique within the scope of the specified SheetIndexModel.\n   * @param iModel  The IModel\n   * @param scopeModelId The Id of the [[SheetIndexModel]] that contains the [[SheetIndexEntry]] and provides the scope for its name.\n   * @param codeValue The name of the entry\n   */\n  public static createCode(iModelDb: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModelDb.codeSpecs.getByName(BisCodeSpec.sheetIndexEntry);\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\n  }\n\n  protected static createParentRelationshipProps(iModelDb: IModelDb, id: Id64String): RelatedElementProps {\n    const parentElementProps = iModelDb.elements.getElementProps(id);\n    const isFolder = parentElementProps.classFullName === SheetIndexFolder.classFullName;\n    const relClass = isFolder ? SheetIndexFolderOwnsEntries : SheetIndexOwnsEntries;\n    return { id, relClassName: relClass.classFullName };\n  }\n\n  protected static createProps(arg: SheetIndexEntryCreateArgs) {\n    const parent = this.createParentRelationshipProps(arg.iModelDb, arg.parentId);\n    const props: SheetIndexEntryProps = {\n      classFullName: this.classFullName,\n      model: arg.sheetIndexModelId,\n      code: this.createCode(arg.iModelDb, arg.sheetIndexModelId, arg.name),\n      entryPriority: arg.priority,\n      parent,\n    };\n    return props;\n  }\n}\n\n/** A container used to group [[SheetIndexEntry]]s within a [[SheetIndex]].\n * @beta\n */\nexport class SheetIndexFolder extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetIndexFolder\"; }\n\n  /** Create a new SheetIndexFolder\n   * @returns The newly constructed SheetIndexFolder element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetIndexEntryCreateArgs) {\n    const props: SheetIndexFolderProps = this.createProps(arg);\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Create a new SheetIndexFolder\n   * @returns The Id of the newly inserted SheetIndexFolder element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(arg: SheetIndexEntryCreateArgs): Id64String {\n    const instance = this.create(arg);\n    const elements = arg.iModelDb.elements;\n    instance.id = elements.insertElement(instance.toJSON());\n    return instance.id;\n  }\n}\n\n/** A node within one [[SheetIndex]] that incorporates another [[SheetIndex]] as a sub-tree.\n * @beta\n*/\nexport class SheetIndexReference extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetIndexReference\"; }\n\n  /** The bis:SheetIndex that this bis:SheetIndexReference is pointing to. */\n  public sheetIndex?: SheetIndexReferenceRefersToSheetIndex;\n\n  protected constructor(props: SheetIndexReferenceProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.sheetIndex) {\n      const sheetIndex = iModel.elements.tryGetElement<SheetIndex>(props.sheetIndex.id);\n      if (!sheetIndex)\n        throw new IModelError(IModelStatus.NotFound, \"SheetIndex not found\");\n\n      this.sheetIndex = new SheetIndexReferenceRefersToSheetIndex(props.sheetIndex.id);\n    }\n  }\n\n  protected static createReferenceRelationshipProps(id: Id64String): RelatedElementProps {\n    return { id, relClassName: SheetIndexReferenceRefersToSheetIndex.classFullName };\n  }\n\n  public override toJSON(): SheetIndexReferenceProps { // This override only specializes the return type\n    return {\n      ...super.toJSON(),\n      sheetIndex: this.sheetIndex ? this.sheetIndex.toJSON() : undefined,\n    } as SheetIndexReferenceProps;\n  }\n\n  /** Create a new SheetIndexReference\n   * @returns The newly constructed SheetIndexReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetIndexReferenceCreateArgs) {\n    const props: SheetIndexReferenceProps = {\n      ...this.createProps(arg),\n      sheetIndex: arg.sheetIndexId ? this.createReferenceRelationshipProps(arg.sheetIndexId) : undefined,\n    };\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Create a new SheetIndexReference\n   * @returns The Id of the newly inserted SheetIndexReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(arg: SheetIndexReferenceCreateArgs): Id64String {\n    const instance = this.create(arg);\n    const elements = arg.iModelDb.elements;\n    instance.id = elements.insertElement(instance.toJSON());\n    return instance.id;\n  }\n\n  /** @alpha */\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\n    super.collectReferenceIds(referenceIds);\n    if (this.sheetIndex)\n      referenceIds.addElement(this.sheetIndex.id);\n  }\n}\n\n/** A leaf node in a [[SheetIndex]] that refers to a specific [[Sheet]].\n * @beta\n*/\nexport class SheetReference extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetReference\"; }\n\n  /** The bis:Sheet that this bis:SheetReference is pointing to. */\n  public sheet: SheetReferenceRefersToSheet | undefined;\n\n  protected constructor(props: SheetReferenceProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.sheet) {\n      const sheet = iModel.elements.tryGetElement<Sheet>(props.sheet.id);\n      if (!sheet)\n        throw new IModelError(IModelStatus.NotFound, \"Sheet not found\");\n\n      this.sheet = new SheetReferenceRefersToSheet(sheet.id);\n    }\n  }\n\n  protected static createReferenceRelationshipProps(id: Id64String): RelatedElementProps {\n    return { id, relClassName: SheetIndexReferenceRefersToSheetIndex.classFullName };\n  }\n\n  public override toJSON(): SheetReferenceProps { // This override only specializes the return type\n    return {\n      ...super.toJSON(),\n      sheet: this.sheet ? this.sheet.toJSON() : undefined,\n    } as SheetReferenceProps;\n  }\n\n  /** Create a new SheetReference\n   * @returns The newly constructed SheetReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetReferenceCreateArgs) {\n    const props: SheetReferenceProps = {\n      ...this.createProps(arg),\n      sheet: arg.sheetId ? this.createReferenceRelationshipProps(arg.sheetId) : undefined,\n    };\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Insert a new SheetReference\n   * @returns The Id of the newly inserted SheetReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(arg: SheetReferenceCreateArgs): Id64String {\n    const instance = this.create(arg);\n    const elements = arg.iModelDb.elements;\n    instance.id = elements.insertElement(instance.toJSON());\n    return instance.id;\n  }\n\n  /** @alpha */\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\n    super.collectReferenceIds(referenceIds);\n    if (this.sheet)\n      referenceIds.addModel(this.sheet.id);\n  }\n}\n"]}
+{"version":3,"file":"SheetIndex.js","sourceRoot":"","sources":["../../src/SheetIndex.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { BisCodeSpec, Code, CodeScopeProps, CodeSpec, ElementProps, EntityReferenceSet, IModelError, RelatedElementProps, SheetIndexEntryProps, SheetIndexFolderProps, SheetIndexReferenceProps, SheetReferenceProps } from \"@itwin/core-common\";\nimport { InformationReferenceElement, Sheet } from \"./Element\";\nimport { EditTxn } from \"./EditTxn\";\nimport { IModelDb } from \"./IModelDb\";\nimport { Id64String, IModelStatus } from \"@itwin/core-bentley\";\nimport { SheetIndexFolderOwnsEntries, SheetIndexOwnsEntries, SheetIndexReferenceRefersToSheetIndex, SheetReferenceRefersToSheet } from \"./NavigationRelationship\";\nimport { _implicitTxn } from \"./internal/Symbols\";\n\n/** Arguments used to create a [[SheetIndexEntry]].\n * @beta\n */\nexport interface SheetIndexEntryCreateArgs {\n  /** The iModel that will contain the sheet index entry. */\n  iModelDb: IModelDb;\n  /** The Id of the [[SheetIndexModel]] that will contain the sheet index entry. */\n  sheetIndexModelId: Id64String;\n  /** The [[SheetIndex]] or [[SheetIndexFolder]] that is parent to this SheetIndexEntry */\n  parentId: Id64String;\n  /** The name of the SheetIndexEntry */\n  name: string;\n  /** The priority of the SheetIndexEntry */\n  priority: number;\n}\n\n/** Arguments supplied when creating a [[SheetIndexReference]].\n * @beta\n */\nexport interface SheetIndexReferenceCreateArgs extends SheetIndexEntryCreateArgs {\n  /** The [[SheetIndex]] to which the reference refers. */\n  sheetIndexId?: Id64String;\n}\n\n/** Arguments supplied when creating a [[SheetReference]].\n * @beta\n */\nexport interface SheetReferenceCreateArgs extends SheetIndexEntryCreateArgs {\n  /** The [[Sheet]] to which the reference refers. */\n  sheetId?: Id64String;\n}\n\n/** A [structured collection]($docs/bis/domains/drawings-sheets#sheet-index) of [[SheetIndexEntry]]s.\n * The sheet index is a tree whose leaf nodes refer to [[Sheet]]s, optionally grouped by [[SheetIndexFolder]]s and/or incorporating\n * sub-trees via [[SheetIndexReference]]s.\n * @beta\n */\nexport class SheetIndex extends InformationReferenceElement {\n  public static override get className(): string { return \"SheetIndex\"; }\n\n  /** Create a Code for a SheetIndex given a name that is meant to be unique within the scope of the specified SheetIndexModel.\n   * @param iModel  The IModelDb\n   * @param scopeSheetIndexModelId The Id of the Model that contains the LinkElement and provides the scope for its name.\n   * @param codeValue The SheetIndex name\n   */\n  public static createCode(iModel: IModelDb, scopeSheetIndexModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.sheetIndex);\n    return new Code({ spec: codeSpec.id, scope: scopeSheetIndexModelId, value: codeValue });\n  }\n\n  /** Create a SheetIndex\n   * @param iModelDb The IModelDb\n   * @param modelId The Id of the Model that contains the SheetIndex and provides the scope for its name.\n   * @param name The name (codeValue) of the SheetIndex\n   * @returns The newly constructed SheetIndex\n   * @throws [[IModelError]] if there is a problem creating the SheetIndex\n   */\n  public static create(iModelDb: IModelDb, modelId: Id64String, name: string): SheetIndex {\n    const props: ElementProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, modelId, name).toJSON(),\n      model: modelId,\n    };\n    return new this(props, iModelDb);\n  }\n\n  /** Insert a SheetIndex\n   * @param iModelDb The IModelDb\n   * @param modelId The Id of the Model that contains the SheetIndex and provides the scope for its name.\n   * @param name The name (codeValue) of the SheetIndex\n   * @returns The Id of the newly inserted SheetIndex\n   * @throws [[IModelError]] if there is a problem inserting the SheetIndex\n   */\n  public static insert(txn: EditTxn, modelId: Id64String, name: string): Id64String;\n  /** @deprecated Use SheetIndex.insert(txn, ...) instead. */\n  public static insert(iModelDb: IModelDb, modelId: Id64String, name: string): Id64String;\n  public static insert(txnOrDb: EditTxn | IModelDb, modelId: Id64String, name: string): Id64String {\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\n    const instance = this.create(txn.iModel, modelId, name);\n    instance.id = instance.insert(txn);\n    return instance.id;\n  }\n}\n\n/** The base class for all elements that can participate in a [[SheetIndex]] hierarchy.\n * @beta\n*/\nexport abstract class SheetIndexEntry extends InformationReferenceElement {\n  public static override get className(): string { return \"SheetIndexEntry\"; }\n  /** Can be used to prioritize or order members within a SheetIndex or SheetIndexFolder. */\n  public entryPriority: number;\n\n  protected constructor(props: SheetIndexEntryProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.entryPriority = props.entryPriority;\n  }\n\n  public override toJSON(): SheetIndexEntryProps {\n    return { ...super.toJSON(), entryPriority: this.entryPriority };\n  }\n\n  /** Create a Code for a Sheet Index Entry given a name that is meant to be unique within the scope of the specified SheetIndexModel.\n   * @param iModel  The IModel\n   * @param scopeModelId The Id of the [[SheetIndexModel]] that contains the [[SheetIndexEntry]] and provides the scope for its name.\n   * @param codeValue The name of the entry\n   */\n  public static createCode(iModelDb: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModelDb.codeSpecs.getByName(BisCodeSpec.sheetIndexEntry);\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\n  }\n\n  protected static createParentRelationshipProps(iModelDb: IModelDb, id: Id64String): RelatedElementProps {\n    const parentElementProps = iModelDb.elements.getElementProps(id);\n    const isFolder = parentElementProps.classFullName === SheetIndexFolder.classFullName;\n    const relClass = isFolder ? SheetIndexFolderOwnsEntries : SheetIndexOwnsEntries;\n    return { id, relClassName: relClass.classFullName };\n  }\n\n  protected static createProps(arg: SheetIndexEntryCreateArgs) {\n    const parent = this.createParentRelationshipProps(arg.iModelDb, arg.parentId);\n    const props: SheetIndexEntryProps = {\n      classFullName: this.classFullName,\n      model: arg.sheetIndexModelId,\n      code: this.createCode(arg.iModelDb, arg.sheetIndexModelId, arg.name),\n      entryPriority: arg.priority,\n      parent,\n    };\n    return props;\n  }\n}\n\n/** A container used to group [[SheetIndexEntry]]s within a [[SheetIndex]].\n * @beta\n */\nexport class SheetIndexFolder extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetIndexFolder\"; }\n\n  /** Create a new SheetIndexFolder\n   * @returns The newly constructed SheetIndexFolder element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetIndexEntryCreateArgs) {\n    const props: SheetIndexFolderProps = this.createProps(arg);\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Create a new SheetIndexFolder\n   * @returns The Id of the newly inserted SheetIndexFolder element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(txn: EditTxn, arg: Omit<SheetIndexEntryCreateArgs, \"iModelDb\">): Id64String;\n  /** @deprecated Use SheetIndexFolder.insert(txn, ...) instead. */\n  public static insert(arg: SheetIndexEntryCreateArgs): Id64String;\n  public static insert(txnOrArg: EditTxn | SheetIndexEntryCreateArgs, arg?: Omit<SheetIndexEntryCreateArgs, \"iModelDb\">): Id64String {\n    const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];\n    const createArg = txnOrArg instanceof EditTxn ? arg! : {\n      sheetIndexModelId: txnOrArg.sheetIndexModelId,\n      parentId: txnOrArg.parentId,\n      name: txnOrArg.name,\n      priority: txnOrArg.priority,\n    };\n    const instance = this.create({ ...createArg, iModelDb: txn.iModel });\n    instance.id = instance.insert(txn);\n    return instance.id;\n  }\n}\n\n/** A node within one [[SheetIndex]] that incorporates another [[SheetIndex]] as a sub-tree.\n * @beta\n*/\nexport class SheetIndexReference extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetIndexReference\"; }\n\n  /** The bis:SheetIndex that this bis:SheetIndexReference is pointing to. */\n  public sheetIndex?: SheetIndexReferenceRefersToSheetIndex;\n\n  protected constructor(props: SheetIndexReferenceProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.sheetIndex) {\n      const sheetIndex = iModel.elements.tryGetElement<SheetIndex>(props.sheetIndex.id);\n      if (!sheetIndex)\n        throw new IModelError(IModelStatus.NotFound, \"SheetIndex not found\");\n\n      this.sheetIndex = new SheetIndexReferenceRefersToSheetIndex(props.sheetIndex.id);\n    }\n  }\n\n  protected static createReferenceRelationshipProps(id: Id64String): RelatedElementProps {\n    return { id, relClassName: SheetIndexReferenceRefersToSheetIndex.classFullName };\n  }\n\n  public override toJSON(): SheetIndexReferenceProps { // This override only specializes the return type\n    return {\n      ...super.toJSON(),\n      sheetIndex: this.sheetIndex ? this.sheetIndex.toJSON() : undefined,\n    } as SheetIndexReferenceProps;\n  }\n\n  /** Create a new SheetIndexReference\n   * @returns The newly constructed SheetIndexReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetIndexReferenceCreateArgs) {\n    const props: SheetIndexReferenceProps = {\n      ...this.createProps(arg),\n      sheetIndex: arg.sheetIndexId ? this.createReferenceRelationshipProps(arg.sheetIndexId) : undefined,\n    };\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Create a new SheetIndexReference\n   * @returns The Id of the newly inserted SheetIndexReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(txn: EditTxn, arg: Omit<SheetIndexReferenceCreateArgs, \"iModelDb\">): Id64String;\n  /** @deprecated Use SheetIndexReference.insert(txn, ...) instead. */\n  public static insert(arg: SheetIndexReferenceCreateArgs): Id64String;\n  public static insert(txnOrArg: EditTxn | SheetIndexReferenceCreateArgs, arg?: Omit<SheetIndexReferenceCreateArgs, \"iModelDb\">): Id64String {\n    const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];\n    const createArg = txnOrArg instanceof EditTxn ? arg! : {\n      sheetIndexModelId: txnOrArg.sheetIndexModelId,\n      parentId: txnOrArg.parentId,\n      name: txnOrArg.name,\n      priority: txnOrArg.priority,\n      sheetIndexId: txnOrArg.sheetIndexId,\n    };\n    const instance = this.create({ ...createArg, iModelDb: txn.iModel });\n    instance.id = instance.insert(txn);\n    return instance.id;\n  }\n\n  /** @alpha */\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\n    super.collectReferenceIds(referenceIds);\n    if (this.sheetIndex)\n      referenceIds.addElement(this.sheetIndex.id);\n  }\n}\n\n/** A leaf node in a [[SheetIndex]] that refers to a specific [[Sheet]].\n * @beta\n*/\nexport class SheetReference extends SheetIndexEntry {\n  public static override get className(): string { return \"SheetReference\"; }\n\n  /** The bis:Sheet that this bis:SheetReference is pointing to. */\n  public sheet: SheetReferenceRefersToSheet | undefined;\n\n  protected constructor(props: SheetReferenceProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.sheet) {\n      const sheet = iModel.elements.tryGetElement<Sheet>(props.sheet.id);\n      if (!sheet)\n        throw new IModelError(IModelStatus.NotFound, \"Sheet not found\");\n\n      this.sheet = new SheetReferenceRefersToSheet(sheet.id);\n    }\n  }\n\n  protected static createReferenceRelationshipProps(id: Id64String): RelatedElementProps {\n    return { id, relClassName: SheetIndexReferenceRefersToSheetIndex.classFullName };\n  }\n\n  public override toJSON(): SheetReferenceProps { // This override only specializes the return type\n    return {\n      ...super.toJSON(),\n      sheet: this.sheet ? this.sheet.toJSON() : undefined,\n    } as SheetReferenceProps;\n  }\n\n  /** Create a new SheetReference\n   * @returns The newly constructed SheetReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(arg: SheetReferenceCreateArgs) {\n    const props: SheetReferenceProps = {\n      ...this.createProps(arg),\n      sheet: arg.sheetId ? this.createReferenceRelationshipProps(arg.sheetId) : undefined,\n    };\n    return new this(props, arg.iModelDb);\n  }\n\n  /** Insert a new SheetReference\n   * @returns The Id of the newly inserted SheetReference element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static insert(txn: EditTxn, arg: Omit<SheetReferenceCreateArgs, \"iModelDb\">): Id64String;\n  /** @deprecated Use SheetReference.insert(txn, ...) instead. */\n  public static insert(arg: SheetReferenceCreateArgs): Id64String;\n  public static insert(txnOrArg: EditTxn | SheetReferenceCreateArgs, arg?: Omit<SheetReferenceCreateArgs, \"iModelDb\">): Id64String {\n    const txn = txnOrArg instanceof EditTxn ? txnOrArg : txnOrArg.iModelDb[_implicitTxn];\n    const createArg = txnOrArg instanceof EditTxn ? arg! : {\n      sheetIndexModelId: txnOrArg.sheetIndexModelId,\n      parentId: txnOrArg.parentId,\n      name: txnOrArg.name,\n      priority: txnOrArg.priority,\n      sheetId: txnOrArg.sheetId,\n    };\n    const instance = this.create({ ...createArg, iModelDb: txn.iModel });\n    instance.id = instance.insert(txn);\n    return instance.id;\n  }\n\n  /** @alpha */\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\n    super.collectReferenceIds(referenceIds);\n    if (this.sheet)\n      referenceIds.addModel(this.sheet.id);\n  }\n}\n"]}

package/lib/esm/StashManager.js

@@ -301,7 +301,7 @@ export class StashManager {
         }
         db[_nativeDb].stashRestore(stashFile);
         db[_resetIModelDb]();
-        db.saveChanges();
+        db[_nativeDb].saveChanges();
         Logger.logInfo(loggerCategory, `Restored stash: ${this.getStashId(args)}`);
     }
 }

package/lib/esm/StashManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"StashManager.js","sourceRoot":"","sources":["../../src/StashManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAsC,SAAS,EAAY,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAiB,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC;AAiE1D,IAAK,UAIJ;AAJD,WAAK,UAAU;IACb,mDAAY,CAAA;IACZ,uDAAc,CAAA;IACd,uDAAc,CAAA;AAChB,CAAC,EAJI,UAAU,KAAV,UAAU,QAId;AAAA,CAAC;AAEF;;;GAGG;AACH,MAAM,KAAW,UAAU,CAoB1B;AApBD,WAAiB,UAAU;IACZ,gBAAK,GAAG,oBAAoB,CAAC;IAW1C,yCAAyC;IACzC,SAAgB,UAAU,CAAC,GAAQ,EAAE,OAAe;QAClD,UAAU,CAAC,UAAU,CAAa,EAAE,YAAY,EAAE,EAAE,KAAK,EAAL,WAAA,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAFe,qBAAU,aAEzB,CAAA;IACD,wDAAwD;IACxD,SAAgB,OAAO,CAAC,KAAc,EAAE,GAAS;QAC/C,OAAO,UAAU,CAAC,OAAO,CAAa,KAAK,EAAE,WAAA,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;IAFe,kBAAO,UAEtB,CAAA;AACH,CAAC,EApBgB,UAAU,KAAV,UAAU,QAoB1B;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IAEf,MAAM,CAAU,qBAAqB,GAAW,UAAU,CAAC;IACnE;;;;;;OAMG;IACK,MAAM,CAAC,kBAAkB,CAAC,EAAe,EAAE,YAAqB;QACtE,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,UAAU;YAC7B,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,qCAAqC,CAAC,CAAC;QAE3E,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC7C,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACvH,IAAI,YAAY,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CAAC,UAAU,CAAC,IAAe;QACvC,OAAO,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrF,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,gBAAgB,CAAC,IAAe;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,UAAU,CAAC,YAAY,EAAE,qCAAqC,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,UAAU,CAAC,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,UAAU,CAAC,IAAe,EAAE,KAAgB,EAAE,MAAkB;QAC7E,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,0EAA0E,KAAK,iBAAiB,MAAM,EAAE,CAAC;YACvH,OAAO,OAAO,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,aAAa,EAAE,CAAC;oBAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAc,CAAC;gBACzD,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAe;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAEhD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACnF,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAsB;QAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACjC,UAAU,CAAC,UAAU,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACnC,UAAU,CAAC,UAAU,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACzC,UAAU,CAAC,UAAU,CAAC,wBAAwB,EAAE,kFAAkF,CAAC,CAAC;QACtI,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAe,CAAC;QACvH,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,IAAe;QACvC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,4BAA4B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,CAAC,IAAe;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,UAAU,GAAG,OAAO,CAAC,2BAA2B,CAAC,yDAAyD,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzH,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,aAAa;oBACxC,UAAU,CAAC,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;gBAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAe,CAAC;YAC1D,CAAC,CAAC,CAAC;YACH,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,SAAS,CAAI,IAAe,EAAE,QAAkC;QAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,EAAe;QACtC,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnF,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;gBACpD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAClD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,SAAS,CAAC,IAAe;QACrC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC9C,UAAU,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,yBAAyB,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,EAAe;QAC1C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAuC;QACzE,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC;YAC3C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC7B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe;YACrC,WAAW,EAAE,MAAM,UAAU,CAAC,cAAc,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAe;QACzC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,oBAAoB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE5E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,UAAU,CAAC,UAAU,CAAC,iBAAiB,EAAE,mBAAmB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9B,UAAU,CAAC,UAAU,CAAC,iBAAiB,EAAE,8BAA8B,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,EAAE,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,UAAU,CAAC,UAAU,CAAC,eAAe,EAAE,sCAAsC,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,EAAE,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;YACzC,UAAU,CAAC,UAAU,CAAC,eAAe,EAAE,yCAAyC,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,+EAA+E;QAC/E,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;YACjD,wBAAwB;YACxB,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;YAC3D,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,EAAE,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;QACrB,EAAE,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC","sourcesContent":["import { DbResult, GuidString, Id64Array, Id64String, ITwinError, Logger, OpenMode } from \"@itwin/core-bentley\";\nimport { ChangesetIdWithIndex, LocalDirName, LockState, TxnProps } from \"@itwin/core-common\";\nimport { existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport * as path from \"node:path\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { BriefcaseDb } from \"./IModelDb\";\nimport { _elementWasCreated, _getHubAccess, _hubAccess, _nativeDb, _resetIModelDb } from \"./internal/Symbols\";\nimport { SQLiteDb } from \"./SQLiteDb\";\nimport { IModelHost } from \"./IModelHost\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\n\nconst loggerCategory = BackendLoggerCategory.StashManager;\n\n/**\n * Properties of a stash\n * @internal\n */\nexport interface StashProps {\n  /** Unique identifier for the stash */\n  readonly id: GuidString;\n\n  /** ID of the iModel being stashed */\n  readonly iModelId: GuidString;\n\n  /** ID of the briefcase being stashed */\n  readonly briefcaseId: number;\n\n  /** ISO local Timestamp of the stash */\n  readonly timestamp: string;\n\n  /** Description of the stash */\n  readonly description: string;\n\n  /** Hash of the stash */\n  readonly hash: string;\n\n  /** Parent changeset of the stash */\n  readonly parentChangeset: ChangesetIdWithIndex;\n\n  /** ID sequences for the stash */\n  readonly idSequences: {\n    element: Id64String;\n    instance: Id64String;\n  };\n\n  /** Transaction properties for the stash */\n  readonly txns: TxnProps[];\n\n  /** Number of locks acquired by the stash */\n  readonly acquiredLocks: number;\n}\n\n/**\n * Properties for creating a stash\n * @internal\n */\nexport interface CreateStashProps {\n  /** Briefcase database instance */\n  readonly db: BriefcaseDb;\n  /** description of the stash */\n  readonly description: string;\n  /** discard all local changes and unless retainLocks flag is set, all locks will be released */\n  readonly discardLocalChanges?: true;\n  /** retains all locks after discarding local changes */\n  readonly retainLocks?: true;\n}\n\n/**\n * Arguments for stash operations\n * @internal\n */\nexport interface StashArgs {\n  readonly db: BriefcaseDb;\n  readonly stash: Id64String | StashProps;\n}\n\nenum LockOrigin {\n  Acquired = 0,\n  NewElement = 1,\n  Discovered = 2,\n};\n\n/**\n * An error originating from the StashManager API.\n * @internal\n */\nexport namespace StashError {\n  export const scope = \"itwin-StashManager\";\n  export type Key =\n    \"readonly\" |\n    \"no-file\" |\n    \"no-stashes\" |\n    \"invalid-stash\" |\n    \"nothing-to-stash\" |\n    \"unsaved-changes\" |\n    \"pending-schema-changes\" |\n    \"stash-not-found\";\n\n  /** Instantiate and throw a StashError */\n  export function throwError(key: Key, message: string): never {\n    ITwinError.throwError<ITwinError>({ iTwinErrorId: { scope, key }, message });\n  }\n  /** Determine whether an error object is a StashError */\n  export function isError(error: unknown, key?: Key): error is ITwinError {\n    return ITwinError.isError<ITwinError>(error, scope, key);\n  }\n}\n\n/**\n * Stash manager allow stash, drop, apply and merge stashes\n * @internal\n */\nexport class StashManager {\n\n  private static readonly STASHES_ROOT_DIR_NAME: string = \".stashes\";\n  /**\n   * Retrieves the root folder path for stash files associated with the specified BriefcaseDb.\n   *\n   * @param db - The BriefcaseDb instance for which to determine the stash root folder.\n   * @param ensureExists - If true, the stash root directory will be created if it does not already exist.\n   * @returns The absolute path to the stash root directory.\n   */\n  private static getStashRootFolder(db: BriefcaseDb, ensureExists: boolean): LocalDirName {\n    if (!db.isOpen || db.isReadonly)\n      StashError.throwError(\"readonly\", \"Database is not open or is readonly\");\n\n    if (!existsSync(db[_nativeDb].getFilePath())) {\n      StashError.throwError(\"no-file\", \"Database file does not exist\");\n    }\n\n    const stashDir = path.join(path.dirname(db[_nativeDb].getFilePath()), this.STASHES_ROOT_DIR_NAME, `${db.briefcaseId}`);\n    if (ensureExists && !existsSync(stashDir)) {\n      mkdirSync(stashDir, { recursive: true });\n    }\n    return stashDir;\n  }\n\n  /**\n   * Retrieves the stash ID from the provided arguments.\n   *\n   * If the `stash` property of `args` is a string, it returns the string in lowercase.\n   * If the `stash` property is an object, it returns the `id` property of the object in lowercase.\n   *\n   * @param args - The arguments containing the stash information, which can be either a string or an object with an `id` property.\n   * @returns The stash ID as a lowercase string.\n   */\n  private static getStashId(args: StashArgs) {\n    return (typeof args.stash === \"string\" ? args.stash : args.stash.id).toLowerCase();\n  }\n\n  /**\n   * Retrieves the file path to the stash file associated with the provided arguments.\n   *\n   * @param args - The arguments required to identify the stash, including the database reference.\n   * @returns The absolute path to the stash file.\n   */\n  private static getStashFilePath(args: StashArgs) {\n    const stashRoot = this.getStashRootFolder(args.db, false);\n    if (!existsSync(stashRoot)) {\n      StashError.throwError(\"no-stashes\", \"No stashes exist for this briefcase\");\n    }\n\n    const stashFilePath = path.join(stashRoot, `${this.getStashId(args)}.stash`);\n    if (!existsSync(stashFilePath)) {\n      StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n    }\n    return stashFilePath;\n  }\n\n  /**\n   * Queries the stash database for lock IDs matching the specified state and origin.\n   *\n   * @param args - The arguments required to access the stash database.\n   * @param state - The lock state to filter by.\n   * @param origin - The lock origin to filter by.\n   * @returns An array of lock IDs (`Id64Array`) that match the given state and origin.\n   */\n  private static queryLocks(args: StashArgs, state: LockState, origin: LockOrigin): Id64Array {\n    return this.withStash(args, (stashDb) => {\n      const query = `SELECT JSON_GROUP_ARRAY(FORMAT('0x%x', Id)) FROM [locks] WHERE State = ${state} AND origin = ${origin}`;\n      return stashDb.withPreparedSqliteStatement(query, (stmt) => {\n        if (stmt.step() === DbResult.BE_SQLITE_ROW) {\n          return JSON.parse(stmt.getValueString(0)) as Id64Array;\n        }\n        return [];\n      });\n    });\n  }\n\n  /**\n   * Acquire locks for the specified stash. If this fail then stash should not be applied.\n   * @param args The stash arguments.\n   */\n  private static async acquireLocks(args: StashArgs) {\n    const shared = this.queryLocks(args, LockState.Shared, LockOrigin.Acquired);\n    await args.db.locks.acquireLocks({ shared });\n\n    const exclusive = this.queryLocks(args, LockState.Exclusive, LockOrigin.Acquired);\n    await args.db.locks.acquireLocks({ exclusive });\n\n    const newElements = this.queryLocks(args, LockState.Shared, LockOrigin.NewElement);\n    for (const id of newElements) {\n      if (!args.db.locks.holdsExclusiveLock(id)) {\n        args.db.locks[_elementWasCreated](id);\n      }\n    }\n  }\n  /**\n   * Creates a stash of changes for the specified briefcase.\n   *\n   * This method generates a stash in the stash root directory for the given briefcase, using the provided description and iModelId.\n   * Optionally, it can reset the briefcase by releasing all locks after stashing.\n   *\n   * @param args - The properties required to create a stash, including the briefcase, description, iModelId, and an optional resetBriefcase flag.\n   * @returns A promise that resolves to the properties of the created stash.\n   */\n  public static async stash(args: CreateStashProps): Promise<StashProps> {\n    if (!args.db.txns.hasPendingTxns) {\n      StashError.throwError(\"nothing-to-stash\", \"Nothing to stash\");\n    }\n\n    if (args.db.txns.hasUnsavedChanges) {\n      StashError.throwError(\"unsaved-changes\", \"Unsaved changes exist\");\n    }\n\n    if (args.db.txns.hasPendingSchemaChanges) {\n      StashError.throwError(\"pending-schema-changes\", \"Pending schema changeset. Stashing is not currently supported for schema changes\");\n    }\n\n    const stashRootDir = this.getStashRootFolder(args.db, true);\n    const iModelId = args.db.iModelId;\n    const stash = args.db[_nativeDb].stashChanges({ stashRootDir, description: args.description, iModelId }) as StashProps;\n    if (args.discardLocalChanges) {\n      await args.db.discardChanges({ retainLocks: args.retainLocks });\n    }\n\n    Logger.logInfo(loggerCategory, `Stashed changes`, () => stash);\n    return stash;\n  }\n\n  /**\n   * Retrieves the stash properties from the database for the given arguments.\n   *\n   * @param args - The arguments required to locate and access the stash.\n   * @returns The stash file properties if found; otherwise, `undefined`.\n   */\n  public static tryGetStash(args: StashArgs): StashProps | undefined {\n    try {\n      return this.getStash(args);\n    } catch (error: any) {\n      Logger.logError(loggerCategory, `Error getting stash with ${this.getStashId(args)}: ${error.message}`);\n    }\n    return undefined;\n  }\n\n  /**\n   * Retrieves the stash properties from the database using the provided arguments.\n   *\n   * @param args - The arguments required to access the stash.\n   * @returns The stash properties parsed from the database.\n   */\n  public static getStash(args: StashArgs): StashProps {\n    return this.withStash(args, (stashDb) => {\n      const stashProps = stashDb.withPreparedSqliteStatement(\"SELECT [val] FROM [be_Local] WHERE [name]='$stash_info'\", (stmt) => {\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\n          StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n        return JSON.parse(stmt.getValueString(0)) as StashProps;\n      });\n      return stashProps;\n    });\n  }\n\n  /**\n   * Executes a callback function with a read-only SQLite database connection to a stash file.\n   *\n   * @typeParam T - The return type of the callback function.\n   * @param args - Arguments required to determine the stash file path.\n   * @param callback - A function that receives an open {@link SQLiteDb} instance connected to the stash file.\n   * @returns The value returned by the callback function.\n   */\n  private static withStash<T>(args: StashArgs, callback: (stashDb: SQLiteDb) => T): T {\n    const stashFile = this.getStashFilePath(args);\n    if (!existsSync(stashFile)) {\n      StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n    }\n\n    const stashDb = new SQLiteDb();\n    stashDb.openDb(stashFile, OpenMode.Readonly);\n    try {\n      return callback(stashDb);\n    } finally {\n      stashDb.closeDb();\n    }\n  }\n\n  /**\n   * Retrieves all stash files associated with the specified {@link BriefcaseDb}.\n   * @param db - The {@link BriefcaseDb} instance for which to retrieve stash files.\n   * @returns An array of `StashProps` representing the found stash files, sorted by timestamp.\n   */\n  public static getStashes(db: BriefcaseDb): StashProps[] {\n    const stashes: StashProps[] = [];\n    const stashDir = this.getStashRootFolder(db, false);\n    if (!existsSync(stashDir)) {\n      return stashes;\n    }\n    readdirSync(stashDir).filter((file) => {\n      const filePath = path.join(stashDir, file);\n      if (existsSync(filePath) && statSync(filePath).isFile() && file.endsWith(\".stash\")) {\n        const id = file.slice(0, -path.extname(file).length)\n        const stash = this.tryGetStash({ db, stash: id });\n        if (stash) {\n          stashes.push(stash);\n        }\n      }\n    });\n    stashes.sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));\n    return stashes;\n  }\n\n  /**\n   * Deletes the stash file associated with the specified stash ID or properties from the given {@link BriefcaseDb}.\n   *\n   * @param db - The {@link BriefcaseDb} instance from which the stash should be dropped.\n   * @param stashId - The unique identifier (GuidString) or properties (StashProps) of the stash to be deleted.\n   * @returns Returns `true` if the stash file was successfully deleted, otherwise returns `false`.\n   */\n  public static dropStash(args: StashArgs): boolean {\n    try {\n      const stashFile = this.getStashFilePath(args);\n      unlinkSync(stashFile);\n      return true;\n    } catch (error: any) {\n      Logger.logError(loggerCategory, `Error dropping stash: ${error}`);\n    }\n    return false;\n  }\n\n  /**\n   * Removes all stashes associated with the specified {@link BriefcaseDb}.\n   *\n   * @param db - The {@link BriefcaseDb} instance from which all stashes will be removed.\n   */\n  public static dropAllStashes(db: BriefcaseDb): void {\n    this.getStashes(db).forEach((stash) => {\n      this.dropStash({ db, stash });\n    });\n  }\n\n  /**\n   * Queries the hub for the changeset information associated with the given stash.\n   *\n   * @param args - The arguments including the stash properties.\n   * @returns A promise resolving to the changeset ID and index.\n   */\n  private static async queryChangeset(args: StashArgs & { stash: StashProps }): Promise<ChangesetIdWithIndex> {\n    return IModelHost[_hubAccess].queryChangeset({\n      iModelId: args.stash.iModelId,\n      changeset: args.stash.parentChangeset,\n      accessToken: await IModelHost.getAccessToken()\n    });\n  }\n  /**\n   * Restores the specified stash to the given {@link BriefcaseDb}. This operation will discard any local changes made to db and reverse the tip to the state of the stash and then apply stash. This will restore the undo stack.\n   *\n   * @param args - The arguments including the target database and stash properties.\n   */\n  public static async restore(args: StashArgs): Promise<void> {\n    const { db } = args;\n    Logger.logInfo(loggerCategory, `Restoring stash: ${this.getStashId(args)}`);\n\n    const stash = this.tryGetStash(args);\n    if (!stash) {\n      StashError.throwError(\"stash-not-found\", `Stash not found ${this.getStashId(args)}`);\n    }\n\n    if (db.txns.hasUnsavedChanges) {\n      StashError.throwError(\"unsaved-changes\", `Unsaved changes are present.`);\n    }\n\n    if (db.iModelId !== stash.iModelId) {\n      StashError.throwError(\"invalid-stash\", `Stash does not belong to this iModel`);\n    }\n\n    if (db.briefcaseId !== stash.briefcaseId) {\n      StashError.throwError(\"invalid-stash\", `Stash does not belong to this briefcase`);\n    }\n\n    const stashFile = this.getStashFilePath({ db, stash });\n    // we need to retain lock that overlapped with stash locks instead of all locks\n    await db.discardChanges({ retainLocks: true });\n    await this.acquireLocks(args);\n    if (db.changeset.id !== stash.parentChangeset.id) {\n      // Changeset ID mismatch\n      Logger.logWarning(loggerCategory, \"Changeset ID mismatch\");\n      const stashChangeset = await this.queryChangeset({ db, stash });\n      await BriefcaseManager.pullAndApplyChangesets(db, { toIndex: stashChangeset.index });\n    }\n\n    db[_nativeDb].stashRestore(stashFile);\n    db[_resetIModelDb]();\n    db.saveChanges();\n    Logger.logInfo(loggerCategory, `Restored stash: ${this.getStashId(args)}`);\n  }\n}\n"]}
+{"version":3,"file":"StashManager.js","sourceRoot":"","sources":["../../src/StashManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { DbResult, GuidString, Id64Array, Id64String, ITwinError, Logger, OpenMode } from \"@itwin/core-bentley\";\nimport { ChangesetIdWithIndex, LocalDirName, LockState, TxnProps } from \"@itwin/core-common\";\nimport { existsSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport * as path from \"node:path\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { BriefcaseDb } from \"./IModelDb\";\nimport { _elementWasCreated, _getHubAccess, _hubAccess, _nativeDb, _resetIModelDb } from \"./internal/Symbols\";\nimport { SQLiteDb } from \"./SQLiteDb\";\nimport { IModelHost } from \"./IModelHost\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\n\nconst loggerCategory = BackendLoggerCategory.StashManager;\n\n/**\n * Properties of a stash\n * @internal\n */\nexport interface StashProps {\n  /** Unique identifier for the stash */\n  readonly id: GuidString;\n\n  /** ID of the iModel being stashed */\n  readonly iModelId: GuidString;\n\n  /** ID of the briefcase being stashed */\n  readonly briefcaseId: number;\n\n  /** ISO local Timestamp of the stash */\n  readonly timestamp: string;\n\n  /** Description of the stash */\n  readonly description: string;\n\n  /** Hash of the stash */\n  readonly hash: string;\n\n  /** Parent changeset of the stash */\n  readonly parentChangeset: ChangesetIdWithIndex;\n\n  /** ID sequences for the stash */\n  readonly idSequences: {\n    element: Id64String;\n    instance: Id64String;\n  };\n\n  /** Transaction properties for the stash */\n  readonly txns: TxnProps[];\n\n  /** Number of locks acquired by the stash */\n  readonly acquiredLocks: number;\n}\n\n/**\n * Properties for creating a stash\n * @internal\n */\nexport interface CreateStashProps {\n  /** Briefcase database instance */\n  readonly db: BriefcaseDb;\n  /** description of the stash */\n  readonly description: string;\n  /** discard all local changes and unless retainLocks flag is set, all locks will be released */\n  readonly discardLocalChanges?: true;\n  /** retains all locks after discarding local changes */\n  readonly retainLocks?: true;\n}\n\n/**\n * Arguments for stash operations\n * @internal\n */\nexport interface StashArgs {\n  readonly db: BriefcaseDb;\n  readonly stash: Id64String | StashProps;\n}\n\nenum LockOrigin {\n  Acquired = 0,\n  NewElement = 1,\n  Discovered = 2,\n};\n\n/**\n * An error originating from the StashManager API.\n * @internal\n */\nexport namespace StashError {\n  export const scope = \"itwin-StashManager\";\n  export type Key =\n    \"readonly\" |\n    \"no-file\" |\n    \"no-stashes\" |\n    \"invalid-stash\" |\n    \"nothing-to-stash\" |\n    \"unsaved-changes\" |\n    \"pending-schema-changes\" |\n    \"stash-not-found\";\n\n  /** Instantiate and throw a StashError */\n  export function throwError(key: Key, message: string): never {\n    ITwinError.throwError<ITwinError>({ iTwinErrorId: { scope, key }, message });\n  }\n  /** Determine whether an error object is a StashError */\n  export function isError(error: unknown, key?: Key): error is ITwinError {\n    return ITwinError.isError<ITwinError>(error, scope, key);\n  }\n}\n\n/**\n * Stash manager allow stash, drop, apply and merge stashes\n * @internal\n */\nexport class StashManager {\n\n  private static readonly STASHES_ROOT_DIR_NAME: string = \".stashes\";\n  /**\n   * Retrieves the root folder path for stash files associated with the specified BriefcaseDb.\n   *\n   * @param db - The BriefcaseDb instance for which to determine the stash root folder.\n   * @param ensureExists - If true, the stash root directory will be created if it does not already exist.\n   * @returns The absolute path to the stash root directory.\n   */\n  private static getStashRootFolder(db: BriefcaseDb, ensureExists: boolean): LocalDirName {\n    if (!db.isOpen || db.isReadonly)\n      StashError.throwError(\"readonly\", \"Database is not open or is readonly\");\n\n    if (!existsSync(db[_nativeDb].getFilePath())) {\n      StashError.throwError(\"no-file\", \"Database file does not exist\");\n    }\n\n    const stashDir = path.join(path.dirname(db[_nativeDb].getFilePath()), this.STASHES_ROOT_DIR_NAME, `${db.briefcaseId}`);\n    if (ensureExists && !existsSync(stashDir)) {\n      mkdirSync(stashDir, { recursive: true });\n    }\n    return stashDir;\n  }\n\n  /**\n   * Retrieves the stash ID from the provided arguments.\n   *\n   * If the `stash` property of `args` is a string, it returns the string in lowercase.\n   * If the `stash` property is an object, it returns the `id` property of the object in lowercase.\n   *\n   * @param args - The arguments containing the stash information, which can be either a string or an object with an `id` property.\n   * @returns The stash ID as a lowercase string.\n   */\n  private static getStashId(args: StashArgs) {\n    return (typeof args.stash === \"string\" ? args.stash : args.stash.id).toLowerCase();\n  }\n\n  /**\n   * Retrieves the file path to the stash file associated with the provided arguments.\n   *\n   * @param args - The arguments required to identify the stash, including the database reference.\n   * @returns The absolute path to the stash file.\n   */\n  private static getStashFilePath(args: StashArgs) {\n    const stashRoot = this.getStashRootFolder(args.db, false);\n    if (!existsSync(stashRoot)) {\n      StashError.throwError(\"no-stashes\", \"No stashes exist for this briefcase\");\n    }\n\n    const stashFilePath = path.join(stashRoot, `${this.getStashId(args)}.stash`);\n    if (!existsSync(stashFilePath)) {\n      StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n    }\n    return stashFilePath;\n  }\n\n  /**\n   * Queries the stash database for lock IDs matching the specified state and origin.\n   *\n   * @param args - The arguments required to access the stash database.\n   * @param state - The lock state to filter by.\n   * @param origin - The lock origin to filter by.\n   * @returns An array of lock IDs (`Id64Array`) that match the given state and origin.\n   */\n  private static queryLocks(args: StashArgs, state: LockState, origin: LockOrigin): Id64Array {\n    return this.withStash(args, (stashDb) => {\n      const query = `SELECT JSON_GROUP_ARRAY(FORMAT('0x%x', Id)) FROM [locks] WHERE State = ${state} AND origin = ${origin}`;\n      return stashDb.withPreparedSqliteStatement(query, (stmt) => {\n        if (stmt.step() === DbResult.BE_SQLITE_ROW) {\n          return JSON.parse(stmt.getValueString(0)) as Id64Array;\n        }\n        return [];\n      });\n    });\n  }\n\n  /**\n   * Acquire locks for the specified stash. If this fail then stash should not be applied.\n   * @param args The stash arguments.\n   */\n  private static async acquireLocks(args: StashArgs) {\n    const shared = this.queryLocks(args, LockState.Shared, LockOrigin.Acquired);\n    await args.db.locks.acquireLocks({ shared });\n\n    const exclusive = this.queryLocks(args, LockState.Exclusive, LockOrigin.Acquired);\n    await args.db.locks.acquireLocks({ exclusive });\n\n    const newElements = this.queryLocks(args, LockState.Shared, LockOrigin.NewElement);\n    for (const id of newElements) {\n      if (!args.db.locks.holdsExclusiveLock(id)) {\n        args.db.locks[_elementWasCreated](id);\n      }\n    }\n  }\n  /**\n   * Creates a stash of changes for the specified briefcase.\n   *\n   * This method generates a stash in the stash root directory for the given briefcase, using the provided description and iModelId.\n   * Optionally, it can reset the briefcase by releasing all locks after stashing.\n   *\n   * @param args - The properties required to create a stash, including the briefcase, description, iModelId, and an optional resetBriefcase flag.\n   * @returns A promise that resolves to the properties of the created stash.\n   */\n  public static async stash(args: CreateStashProps): Promise<StashProps> {\n    if (!args.db.txns.hasPendingTxns) {\n      StashError.throwError(\"nothing-to-stash\", \"Nothing to stash\");\n    }\n\n    if (args.db.txns.hasUnsavedChanges) {\n      StashError.throwError(\"unsaved-changes\", \"Unsaved changes exist\");\n    }\n\n    if (args.db.txns.hasPendingSchemaChanges) {\n      StashError.throwError(\"pending-schema-changes\", \"Pending schema changeset. Stashing is not currently supported for schema changes\");\n    }\n\n    const stashRootDir = this.getStashRootFolder(args.db, true);\n    const iModelId = args.db.iModelId;\n    const stash = args.db[_nativeDb].stashChanges({ stashRootDir, description: args.description, iModelId }) as StashProps;\n    if (args.discardLocalChanges) {\n      await args.db.discardChanges({ retainLocks: args.retainLocks });\n    }\n\n    Logger.logInfo(loggerCategory, `Stashed changes`, () => stash);\n    return stash;\n  }\n\n  /**\n   * Retrieves the stash properties from the database for the given arguments.\n   *\n   * @param args - The arguments required to locate and access the stash.\n   * @returns The stash file properties if found; otherwise, `undefined`.\n   */\n  public static tryGetStash(args: StashArgs): StashProps | undefined {\n    try {\n      return this.getStash(args);\n    } catch (error: any) {\n      Logger.logError(loggerCategory, `Error getting stash with ${this.getStashId(args)}: ${error.message}`);\n    }\n    return undefined;\n  }\n\n  /**\n   * Retrieves the stash properties from the database using the provided arguments.\n   *\n   * @param args - The arguments required to access the stash.\n   * @returns The stash properties parsed from the database.\n   */\n  public static getStash(args: StashArgs): StashProps {\n    return this.withStash(args, (stashDb) => {\n      const stashProps = stashDb.withPreparedSqliteStatement(\"SELECT [val] FROM [be_Local] WHERE [name]='$stash_info'\", (stmt) => {\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\n          StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n        return JSON.parse(stmt.getValueString(0)) as StashProps;\n      });\n      return stashProps;\n    });\n  }\n\n  /**\n   * Executes a callback function with a read-only SQLite database connection to a stash file.\n   *\n   * @typeParam T - The return type of the callback function.\n   * @param args - Arguments required to determine the stash file path.\n   * @param callback - A function that receives an open {@link SQLiteDb} instance connected to the stash file.\n   * @returns The value returned by the callback function.\n   */\n  private static withStash<T>(args: StashArgs, callback: (stashDb: SQLiteDb) => T): T {\n    const stashFile = this.getStashFilePath(args);\n    if (!existsSync(stashFile)) {\n      StashError.throwError(\"invalid-stash\", \"Invalid stash\");\n    }\n\n    const stashDb = new SQLiteDb();\n    stashDb.openDb(stashFile, OpenMode.Readonly);\n    try {\n      return callback(stashDb);\n    } finally {\n      stashDb.closeDb();\n    }\n  }\n\n  /**\n   * Retrieves all stash files associated with the specified {@link BriefcaseDb}.\n   * @param db - The {@link BriefcaseDb} instance for which to retrieve stash files.\n   * @returns An array of `StashProps` representing the found stash files, sorted by timestamp.\n   */\n  public static getStashes(db: BriefcaseDb): StashProps[] {\n    const stashes: StashProps[] = [];\n    const stashDir = this.getStashRootFolder(db, false);\n    if (!existsSync(stashDir)) {\n      return stashes;\n    }\n    readdirSync(stashDir).filter((file) => {\n      const filePath = path.join(stashDir, file);\n      if (existsSync(filePath) && statSync(filePath).isFile() && file.endsWith(\".stash\")) {\n        const id = file.slice(0, -path.extname(file).length)\n        const stash = this.tryGetStash({ db, stash: id });\n        if (stash) {\n          stashes.push(stash);\n        }\n      }\n    });\n    stashes.sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));\n    return stashes;\n  }\n\n  /**\n   * Deletes the stash file associated with the specified stash ID or properties from the given {@link BriefcaseDb}.\n   *\n   * @param db - The {@link BriefcaseDb} instance from which the stash should be dropped.\n   * @param stashId - The unique identifier (GuidString) or properties (StashProps) of the stash to be deleted.\n   * @returns Returns `true` if the stash file was successfully deleted, otherwise returns `false`.\n   */\n  public static dropStash(args: StashArgs): boolean {\n    try {\n      const stashFile = this.getStashFilePath(args);\n      unlinkSync(stashFile);\n      return true;\n    } catch (error: any) {\n      Logger.logError(loggerCategory, `Error dropping stash: ${error}`);\n    }\n    return false;\n  }\n\n  /**\n   * Removes all stashes associated with the specified {@link BriefcaseDb}.\n   *\n   * @param db - The {@link BriefcaseDb} instance from which all stashes will be removed.\n   */\n  public static dropAllStashes(db: BriefcaseDb): void {\n    this.getStashes(db).forEach((stash) => {\n      this.dropStash({ db, stash });\n    });\n  }\n\n  /**\n   * Queries the hub for the changeset information associated with the given stash.\n   *\n   * @param args - The arguments including the stash properties.\n   * @returns A promise resolving to the changeset ID and index.\n   */\n  private static async queryChangeset(args: StashArgs & { stash: StashProps }): Promise<ChangesetIdWithIndex> {\n    return IModelHost[_hubAccess].queryChangeset({\n      iModelId: args.stash.iModelId,\n      changeset: args.stash.parentChangeset,\n      accessToken: await IModelHost.getAccessToken()\n    });\n  }\n  /**\n   * Restores the specified stash to the given {@link BriefcaseDb}. This operation will discard any local changes made to db and reverse the tip to the state of the stash and then apply stash. This will restore the undo stack.\n   *\n   * @param args - The arguments including the target database and stash properties.\n   */\n  public static async restore(args: StashArgs): Promise<void> {\n    const { db } = args;\n    Logger.logInfo(loggerCategory, `Restoring stash: ${this.getStashId(args)}`);\n\n    const stash = this.tryGetStash(args);\n    if (!stash) {\n      StashError.throwError(\"stash-not-found\", `Stash not found ${this.getStashId(args)}`);\n    }\n\n    if (db.txns.hasUnsavedChanges) {\n      StashError.throwError(\"unsaved-changes\", `Unsaved changes are present.`);\n    }\n\n    if (db.iModelId !== stash.iModelId) {\n      StashError.throwError(\"invalid-stash\", `Stash does not belong to this iModel`);\n    }\n\n    if (db.briefcaseId !== stash.briefcaseId) {\n      StashError.throwError(\"invalid-stash\", `Stash does not belong to this briefcase`);\n    }\n\n    const stashFile = this.getStashFilePath({ db, stash });\n    // we need to retain lock that overlapped with stash locks instead of all locks\n    await db.discardChanges({ retainLocks: true });\n    await this.acquireLocks(args);\n    if (db.changeset.id !== stash.parentChangeset.id) {\n      // Changeset ID mismatch\n      Logger.logWarning(loggerCategory, \"Changeset ID mismatch\");\n      const stashChangeset = await this.queryChangeset({ db, stash });\n      await BriefcaseManager.pullAndApplyChangesets(db, { toIndex: stashChangeset.index });\n    }\n\n    db[_nativeDb].stashRestore(stashFile);\n    db[_resetIModelDb]();\n    db[_nativeDb].saveChanges();\n    Logger.logInfo(loggerCategory, `Restored stash: ${this.getStashId(args)}`);\n  }\n}\n"]}

package/lib/esm/Texture.d.ts

@@ -4,6 +4,7 @@
 import { Id64String } from "@itwin/core-bentley";
 import { Base64EncodedString, Code, CodeScopeProps, ImageSourceFormat, TextureProps } from "@itwin/core-common";
 import { DefinitionElement } from "./Element";
+import { EditTxn } from "./EditTxn";
 import { IModelDb } from "./IModelDb";
 /** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.
  * @see [[Texture]] constructor.
@@ -52,6 +53,11 @@ export declare class Texture extends DefinitionElement {
      * @returns The Id of the newly-inserted texture element.
      * @throws [[IModelError]] if unable to insert the element.
      * @see [[insertTexture]] to insert a new texture into the iModel.
+     * @beta
+     */
+    static insertTexture(txn: EditTxn, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String;
+    /** Insert a new texture into a [[DefinitionModel]].
+     * @deprecated Use Texture.insertTexture(txn, ...) instead.
      */
     static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String;
 }

package/lib/esm/Texture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Texture.d.ts","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,mBAAmB,EAAe,IAAI,EAAE,cAAc,EAAY,iBAAiB,EAAE,YAAY,EAClG,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACpE,IAAI,EAAE,mBAAmB,GAAG,UAAU,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,iBAAiB;IAC5C,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAAsB;IAC7D,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAE5B,YAAY;IACZ,SAAS,aAAa,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ;IAOjD,MAAM,IAAI,YAAY;IAQtC;;;;OAIG;WACW,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5F;;;;;;;;;;OAUG;WACW,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;IAc9L;;;;;;;;;;OAUG;WACW,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;CAIlM"}
+{"version":3,"file":"Texture.d.ts","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,mBAAmB,EAAe,IAAI,EAAE,cAAc,EAAY,iBAAiB,EAAE,YAAY,EAClG,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACpE,IAAI,EAAE,mBAAmB,GAAG,UAAU,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,iBAAiB;IAC5C,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAAsB;IAC7D,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAE5B,YAAY;IACZ,SAAS,aAAa,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ;IAOjD,MAAM,IAAI,YAAY;IAQtC;;;;OAIG;WACW,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5F;;;;;;;;;;OAUG;WACW,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;IAc9L;;;;;;;;;;;OAWG;WACW,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAC3L;;OAEG;WACW,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;CAMlM"}

package/lib/esm/Texture.js

@@ -7,6 +7,8 @@
  */
 import { Base64EncodedString, BisCodeSpec, Code, } from "@itwin/core-common";
 import { DefinitionElement } from "./Element";
+import { EditTxn } from "./EditTxn";
+import { _implicitTxn } from "./internal/Symbols";
 /** Defines a rendering texture that is associated with a Material and applied to surface geometry.
  * @public @preview
  */
@@ -62,20 +64,10 @@ export class Texture extends DefinitionElement {
         };
         return new Texture(textureProps, iModelDb);
     }
-    /** Insert a new texture into a [[DefinitionModel]].
-     * @param iModelDb The iModel to contain the texture.
-     * @param definitionModelId The [[DefinitionModel]] to contain the texture.
-     * @param name The name to serve as the texture's [Code]($common) value.
-     * @param format The format of the image data.
-     * @param data The image data in the format specified by `format`.
-     * @param description An optional description of the texture
-     * @returns The Id of the newly-inserted texture element.
-     * @throws [[IModelError]] if unable to insert the element.
-     * @see [[insertTexture]] to insert a new texture into the iModel.
-     */
-    static insertTexture(iModelDb, definitionModelId, name, format, data, description) {
-        const texture = this.createTexture(iModelDb, definitionModelId, name, format, data, description);
-        return iModelDb.elements.insertElement(texture.toJSON());
+    static insertTexture(txnOrDb, definitionModelId, name, format, data, description) {
+        const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];
+        const texture = this.createTexture(txn.iModel, definitionModelId, name, format, data, description);
+        return texture.insert(txn);
     }
 }
 //# sourceMappingURL=Texture.js.map

package/lib/esm/Texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EACL,mBAAmB,EAAE,WAAW,EAAE,IAAI,GACvC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAW9C;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,iBAAiB;IAC5C,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,SAAS,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAoB;IAC1B,IAAI,CAAa;IACjB,WAAW,CAAU;IAE5B,YAAY;IACZ,YAAsB,KAAyB,EAAE,MAAgB;QAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACvG,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IAEe,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAkB,CAAC;QAC3C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,IAAI,GAAG,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,IAAY;QACnF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,YAAY,GAAuB;YACvC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;YACxD,MAAM;YACN,IAAI;YACJ,WAAW;YACX,KAAK,EAAE,iBAAiB;YACxB,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,aAAa,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,MAAyB,EAAE,IAAsC,EAAE,WAAoB;QAClL,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACjG,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport {\n  Base64EncodedString, BisCodeSpec, Code, CodeScopeProps, CodeSpec, ImageSourceFormat, TextureProps,\n} from \"@itwin/core-common\";\nimport { DefinitionElement } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\n\n/** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.\n * @see [[Texture]] constructor.\n * @beta\n */\nexport interface TextureCreateProps extends Omit<TextureProps, \"data\"> {\n  data: Base64EncodedString | Uint8Array;\n}\n\n/** Defines a rendering texture that is associated with a Material and applied to surface geometry.\n * @public @preview\n */\nexport class Texture extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"Texture\"; }\n  public format: ImageSourceFormat;\n  public data: Uint8Array;\n  public description?: string;\n\n  /** @beta */\n  protected constructor(props: TextureCreateProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.format = props.format;\n    this.data = typeof props.data === \"string\" ? Base64EncodedString.toUint8Array(props.data) : props.data;\n    this.description = props.description;\n  }\n\n  public override toJSON(): TextureProps {\n    const val = super.toJSON() as TextureProps;\n    val.format = this.format;\n    val.data = Base64EncodedString.fromUint8Array(this.data);\n    val.description = this.description;\n    return val;\n  }\n\n  /** Create a Code for a Texture given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param scopeModelId The Id of the DefinitionModel that contains the Texture and provides the scope for its name.\n   * @param name The Texture name\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.texture);\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\n  }\n\n  /** Create a texture with the given parameters.\n   * @param iModelDb The iModel to contain the texture.\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\n   * @param name The name to serve as the texture's [Code]($common) value.\n   * @param format The format of the image data.\n   * @param data The image data in the format specified by `format`.\n   * @param description An optional description of the texture\n   * @returns The newly constructed Texture element.\n   * @throws [[IModelError]] if unable to create the element.\n   * @see [[insertTexture]] to insert a new texture into the iModel.\n   */\n  public static createTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Texture {\n    const textureProps: TextureCreateProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, definitionModelId, name),\n      format,\n      data,\n      description,\n      model: definitionModelId,\n      isPrivate: false,\n    };\n\n    return new Texture(textureProps, iModelDb);\n  }\n\n  /** Insert a new texture into a [[DefinitionModel]].\n   * @param iModelDb The iModel to contain the texture.\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\n   * @param name The name to serve as the texture's [Code]($common) value.\n   * @param format The format of the image data.\n   * @param data The image data in the format specified by `format`.\n   * @param description An optional description of the texture\n   * @returns The Id of the newly-inserted texture element.\n   * @throws [[IModelError]] if unable to insert the element.\n   * @see [[insertTexture]] to insert a new texture into the iModel.\n   */\n  public static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String {\n    const texture = this.createTexture(iModelDb, definitionModelId, name, format, data, description);\n    return iModelDb.elements.insertElement(texture.toJSON());\n  }\n}\n"]}
+{"version":3,"file":"Texture.js","sourceRoot":"","sources":["../../src/Texture.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport {\n  Base64EncodedString, BisCodeSpec, Code, CodeScopeProps, CodeSpec, ImageSourceFormat, TextureProps,\n} from \"@itwin/core-common\";\nimport { DefinitionElement } from \"./Element\";\nimport { EditTxn } from \"./EditTxn\";\nimport { IModelDb } from \"./IModelDb\";\nimport { _implicitTxn } from \"./internal/Symbols\";\n\n/** A [TextureProps]($common) in which the image data can be specified either as a base-64-encoded string or a Uint8Array.\n * @see [[Texture]] constructor.\n * @beta\n */\nexport interface TextureCreateProps extends Omit<TextureProps, \"data\"> {\n  data: Base64EncodedString | Uint8Array;\n}\n\n/** Defines a rendering texture that is associated with a Material and applied to surface geometry.\n * @public @preview\n */\nexport class Texture extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"Texture\"; }\n  public format: ImageSourceFormat;\n  public data: Uint8Array;\n  public description?: string;\n\n  /** @beta */\n  protected constructor(props: TextureCreateProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.format = props.format;\n    this.data = typeof props.data === \"string\" ? Base64EncodedString.toUint8Array(props.data) : props.data;\n    this.description = props.description;\n  }\n\n  public override toJSON(): TextureProps {\n    const val = super.toJSON() as TextureProps;\n    val.format = this.format;\n    val.data = Base64EncodedString.fromUint8Array(this.data);\n    val.description = this.description;\n    return val;\n  }\n\n  /** Create a Code for a Texture given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param scopeModelId The Id of the DefinitionModel that contains the Texture and provides the scope for its name.\n   * @param name The Texture name\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.texture);\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\n  }\n\n  /** Create a texture with the given parameters.\n   * @param iModelDb The iModel to contain the texture.\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\n   * @param name The name to serve as the texture's [Code]($common) value.\n   * @param format The format of the image data.\n   * @param data The image data in the format specified by `format`.\n   * @param description An optional description of the texture\n   * @returns The newly constructed Texture element.\n   * @throws [[IModelError]] if unable to create the element.\n   * @see [[insertTexture]] to insert a new texture into the iModel.\n   */\n  public static createTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Texture {\n    const textureProps: TextureCreateProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, definitionModelId, name),\n      format,\n      data,\n      description,\n      model: definitionModelId,\n      isPrivate: false,\n    };\n\n    return new Texture(textureProps, iModelDb);\n  }\n\n  /** Insert a new texture into a [[DefinitionModel]].\n   * @param iModelDb The iModel to contain the texture.\n   * @param definitionModelId The [[DefinitionModel]] to contain the texture.\n   * @param name The name to serve as the texture's [Code]($common) value.\n   * @param format The format of the image data.\n   * @param data The image data in the format specified by `format`.\n   * @param description An optional description of the texture\n   * @returns The Id of the newly-inserted texture element.\n   * @throws [[IModelError]] if unable to insert the element.\n   * @see [[insertTexture]] to insert a new texture into the iModel.\n   * @beta\n   */\n  public static insertTexture(txn: EditTxn, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String;\n  /** Insert a new texture into a [[DefinitionModel]].\n   * @deprecated Use Texture.insertTexture(txn, ...) instead.\n   */\n  public static insertTexture(iModelDb: IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String;\n  public static insertTexture(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, name: string, format: ImageSourceFormat, data: Uint8Array | Base64EncodedString, description?: string): Id64String {\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\n    const texture = this.createTexture(txn.iModel, definitionModelId, name, format, data, description);\n    return texture.insert(txn);\n  }\n}\n"]}