@itwin/core-backend 5.12.0-dev.2 → 5.12.0-dev.5

package/lib/cjs/IModelElementCloneContext.d.ts

@@ -30,7 +30,7 @@ export declare class IModelElementCloneContext {
     get isBetweenIModels(): boolean;
     /** Dispose any native resources associated with this IModelElementCloneContext. */
     [Symbol.dispose](): void;
-    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */
     dispose(): void;
     /** Debugging aid that dumps the Id remapping details and other information to the specified output file.
      * @internal

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

@@ -1 +1 @@
-{"version":3,"file":"IModelElementCloneContext.d.ts","sourceRoot":"","sources":["../../src/IModelElementCloneContext.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAQ,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAiC,YAAY,EAA4C,MAAM,oBAAoB,CAAC;AAC3H,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;GAEG;AACH,qBAAa,yBAAyB;IACpC,2BAA2B;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,2BAA2B;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,gCAAgC;IAChC,OAAO,CAAC,cAAc,CAA+B;IAErD;;;OAGG;gBACgB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAM1D,0HAA0H;IAC7G,UAAU;IAGvB,iHAAiH;WAC7F,MAAM,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,yBAAyB,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMhI,sIAAsI;IACtI,IAAW,gBAAgB,IAAI,OAAO,CAA4C;IAElF,mFAAmF;IAC5E,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAE/B,qGAAqG;IAC9F,OAAO;IAId;;OAEG;IACI,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAEzC;;;;OAIG;IACI,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAMlF,uFAAuF;IAChF,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAIxF,2FAA2F;IACpF,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI;IAIrE,8DAA8D;IACvD,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAIhD;;OAEG;IACI,oBAAoB,CAAC,QAAQ,EAAE,UAAU,GAAG,UAAU;IAO7D;;OAEG;IACI,mBAAmB,CAAC,eAAe,EAAE,UAAU,GAAG,UAAU;IAOnE;;;OAGG;IACI,iBAAiB,CAAC,mBAAmB,EAAE,UAAU,GAAG,IAAI;IAO/D,oEAAoE;IACpE,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED,4DAA4D;IACrD,qBAAqB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO;IAIhE;;OAEG;IACI,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAKjD;;OAEG;IACI,cAAc,CAAC,gBAAgB,EAAE,UAAU,GAAG,IAAI;IAIzD;;OAEG;IACU,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,cAAc,CAAC,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0B3H;;;;OAIG;IACI,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAIxC;;;OAGG;IACI,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;CAG3C"}
+{"version":3,"file":"IModelElementCloneContext.d.ts","sourceRoot":"","sources":["../../src/IModelElementCloneContext.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAQ,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAiC,YAAY,EAA4C,MAAM,oBAAoB,CAAC;AAC3H,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;GAEG;AACH,qBAAa,yBAAyB;IACpC,2BAA2B;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,2BAA2B;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,gCAAgC;IAChC,OAAO,CAAC,cAAc,CAA+B;IAErD;;;OAGG;gBACgB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAM1D,0HAA0H;IAC7G,UAAU;IAGvB,iHAAiH;WAC7F,MAAM,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,yBAAyB,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMhI,sIAAsI;IACtI,IAAW,gBAAgB,IAAI,OAAO,CAA4C;IAElF,mFAAmF;IAC5E,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAE/B,iGAAiG;IAC1F,OAAO;IAId;;OAEG;IACI,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAEzC;;;;OAIG;IACI,aAAa,CAAC,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAMlF,uFAAuF;IAChF,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAIxF,2FAA2F;IACpF,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI;IAIrE,8DAA8D;IACvD,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAIhD;;OAEG;IACI,oBAAoB,CAAC,QAAQ,EAAE,UAAU,GAAG,UAAU;IAO7D;;OAEG;IACI,mBAAmB,CAAC,eAAe,EAAE,UAAU,GAAG,UAAU;IAOnE;;;OAGG;IACI,iBAAiB,CAAC,mBAAmB,EAAE,UAAU,GAAG,IAAI;IAO/D,oEAAoE;IACpE,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED,4DAA4D;IACrD,qBAAqB,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO;IAIhE;;OAEG;IACI,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAKjD;;OAEG;IACI,cAAc,CAAC,gBAAgB,EAAE,UAAU,GAAG,IAAI;IAIzD;;OAEG;IACU,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,cAAc,CAAC,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0B3H;;;;OAIG;IACI,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAIxC;;;OAGG;IACI,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;CAG3C"}

package/lib/cjs/IModelElementCloneContext.js

@@ -45,7 +45,7 @@ class IModelElementCloneContext {
     get isBetweenIModels() { return this.sourceDb !== this.targetDb; }
     /** Dispose any native resources associated with this IModelElementCloneContext. */
     [Symbol.dispose]() { this._nativeContext.dispose(); }
-    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */
     dispose() {
         this[Symbol.dispose]();
     }

package/lib/cjs/IModelElementCloneContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelElementCloneContext.js","sourceRoot":"","sources":["../../src/IModelElementCloneContext.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 iModels\n */\nimport { Id64, Id64String } from \"@itwin/core-bentley\";\nimport { Code, CodeScopeSpec, CodeSpec, ElementProps, IModel, PropertyMetaData, RelatedElement } from \"@itwin/core-common\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { SubCategory } from \"./Category\";\nimport { Element } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { SQLiteDb } from \"./SQLiteDb\";\nimport { _nativeDb } from \"./internal/Symbols\";\n\n/** The context for transforming a *source* Element to a *target* Element and remapping internal identifiers to the target iModel.\n * @beta\n */\nexport class IModelElementCloneContext {\n  /** The source IModelDb. */\n  public readonly sourceDb: IModelDb;\n  /** The target IModelDb. */\n  public readonly targetDb: IModelDb;\n  /** The native import context */\n  private _nativeContext: IModelJsNative.ImportContext;\n\n  /** Construct a new IModelElementCloneContext. It must be initialized with `initialize`, consider using [[IModelElementCloneContext.create]] instead\n   * @param sourceDb The source IModelDb.\n   * @param targetDb If provided the target IModelDb. If not provided, the source and target are the same IModelDb.\n   */\n  public constructor(sourceDb: IModelDb, targetDb?: IModelDb) {\n    this.sourceDb = sourceDb;\n    this.targetDb = (undefined !== targetDb) ? targetDb : sourceDb;\n    this._nativeContext = new IModelNative.platform.ImportContext(this.sourceDb[_nativeDb], this.targetDb[_nativeDb]);\n  }\n\n  /** perform necessary initialization to use a clone context, namely caching the reference types in the source's schemas */\n  public async initialize() {\n  }\n\n  /** construct and initialize an IModelElementCloneContext at once, for where you construct in an async context */\n  public static async create(...args: ConstructorParameters<typeof IModelElementCloneContext>): Promise<IModelElementCloneContext> {\n    const instance = new this(...args);\n    await instance.initialize();\n    return instance;\n  }\n\n  /** Returns `true` if this context is for transforming between 2 iModels and `false` if it for transforming within the same iModel. */\n  public get isBetweenIModels(): boolean { return this.sourceDb !== this.targetDb; }\n\n  /** Dispose any native resources associated with this IModelElementCloneContext. */\n  public [Symbol.dispose](): void { this._nativeContext.dispose(); }\n\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */\n  public dispose() {\n    this[Symbol.dispose]();\n  }\n\n  /** Debugging aid that dumps the Id remapping details and other information to the specified output file.\n   * @internal\n   */\n  public dump(outputFileName: string): void { this._nativeContext.dump(outputFileName); }\n\n  /** Add a rule that remaps the specified source [CodeSpec]($common) to the specified target [CodeSpec]($common).\n   * @param sourceCodeSpecName The name of the CodeSpec from the source iModel.\n   * @param targetCodeSpecName The name of the CodeSpec from the target iModel.\n   * @throws [[IModelError]] if either CodeSpec could not be found.\n   */\n  public remapCodeSpec(sourceCodeSpecName: string, targetCodeSpecName: string): void {\n    const sourceCodeSpec: CodeSpec = this.sourceDb.codeSpecs.getByName(sourceCodeSpecName);\n    const targetCodeSpec: CodeSpec = this.targetDb.codeSpecs.getByName(targetCodeSpecName);\n    this._nativeContext.addCodeSpecId(sourceCodeSpec.id, targetCodeSpec.id);\n  }\n\n  /** Add a rule that remaps the specified source class to the specified target class. */\n  public remapElementClass(sourceClassFullName: string, targetClassFullName: string): void {\n    this._nativeContext.addClass(sourceClassFullName, targetClassFullName);\n  }\n\n  /** Add a rule that remaps the specified source Element to the specified target Element. */\n  public remapElement(sourceId: Id64String, targetId: Id64String): void {\n    this._nativeContext.addElementId(sourceId, targetId);\n  }\n\n  /** Remove a rule that remaps the specified source Element. */\n  public removeElement(sourceId: Id64String): void {\n    this._nativeContext.removeElementId(sourceId);\n  }\n\n  /** Look up a target CodeSpecId from the source CodeSpecId.\n   * @returns the target CodeSpecId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetCodeSpecId(sourceId: Id64String): Id64String {\n    if (Id64.invalid === sourceId) {\n      return Id64.invalid;\n    }\n    return this._nativeContext.findCodeSpecId(sourceId);\n  }\n\n  /** Look up a target ElementId from the source ElementId.\n   * @returns the target ElementId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetElementId(sourceElementId: Id64String): Id64String {\n    if (Id64.invalid === sourceElementId) {\n      return Id64.invalid;\n    }\n    return this._nativeContext.findElementId(sourceElementId);\n  }\n\n  /** Filter out geometry entries in the specified SubCategory from GeometryStreams in the target iModel.\n   * @note It is not possible to filter out a *default* SubCategory. A request to do so will be ignored.\n   * @see [SubCategory.isDefaultSubCategory]($backend)\n   */\n  public filterSubCategory(sourceSubCategoryId: Id64String): void {\n    const sourceSubCategory = this.sourceDb.elements.tryGetElement<SubCategory>(sourceSubCategoryId, SubCategory);\n    if (sourceSubCategory && !sourceSubCategory.isDefaultSubCategory) {\n      this._nativeContext.filterSubCategoryId(sourceSubCategoryId);\n    }\n  }\n\n  /** Returns `true` if there are any SubCategories being filtered. */\n  public get hasSubCategoryFilter(): boolean {\n    return this._nativeContext.hasSubCategoryFilter();\n  }\n\n  /** Returns `true` if this SubCategory is being filtered. */\n  public isSubCategoryFiltered(subCategoryId: Id64String): boolean {\n    return this._nativeContext.isSubCategoryFiltered(subCategoryId);\n  }\n\n  /** Import the specified font from the source iModel into the target iModel.\n   * @internal\n   */\n  public importFont(sourceFontNumber: number): void {\n    this.targetDb.clearFontMap(); // so it will be reloaded with new font info\n    this._nativeContext.importFont(sourceFontNumber);\n  }\n\n  /** Import a single CodeSpec from the source iModel into the target iModel.\n   * @internal\n   */\n  public importCodeSpec(sourceCodeSpecId: Id64String): void {\n    this._nativeContext.importCodeSpec(sourceCodeSpecId);\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public async cloneElement(sourceElement: Element, cloneOptions?: IModelJsNative.CloneElementOptions): Promise<ElementProps> {\n    const targetElementProps: ElementProps = this._nativeContext.cloneElement(sourceElement.id, cloneOptions);\n    // Ensure that all NavigationProperties in targetElementProps have a defined value so \"clearing\" changes will be part of the JSON used for update\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    sourceElement.forEachProperty((propertyName: string, meta: PropertyMetaData) => {\n      if ((meta.isNavigation) && (undefined === (sourceElement as any)[propertyName])) {\n        (targetElementProps as any)[propertyName] = RelatedElement.none;\n      }\n    }, false); // exclude custom because C++ has already handled them\n    if (this.isBetweenIModels) {\n      // The native C++ cloneElement strips off federationGuid, want to put it back if transformation is between iModels\n      targetElementProps.federationGuid = sourceElement.federationGuid;\n      if (CodeScopeSpec.Type.Repository === this.targetDb.codeSpecs.getById(targetElementProps.code.spec).scopeType) {\n        targetElementProps.code.scope = IModel.rootSubjectId;\n      }\n    }\n    // unlike other references, code cannot be null. If it is null, use an empty code instead\n    if (targetElementProps.code.scope === Id64.invalid || targetElementProps.code.spec === Id64.invalid) {\n      targetElementProps.code = Code.createEmpty();\n    }\n    const jsClass = this.sourceDb.getJsClass<typeof Element>(sourceElement.classFullName);\n    // eslint-disable-next-line @typescript-eslint/dot-notation\n    await jsClass[\"onCloned\"](this, sourceElement.toJSON(), targetElementProps);\n    return targetElementProps;\n  }\n\n  /**\n   * serialize state to a sqlite database at a given path\n   * assumes the database has not already had any context state serialized to it\n   * @internal\n   */\n  public saveStateToDb(db: SQLiteDb): void {\n    this._nativeContext.saveStateToDb(db[_nativeDb]);\n  }\n\n  /**\n   * load state from a sqlite database at a given path\n   * @internal\n   */\n  public loadStateFromDb(db: SQLiteDb): void {\n    this._nativeContext.loadStateFromDb(db[_nativeDb]);\n  }\n}\n"]}
+{"version":3,"file":"IModelElementCloneContext.js","sourceRoot":"","sources":["../../src/IModelElementCloneContext.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 iModels\n */\nimport { Id64, Id64String } from \"@itwin/core-bentley\";\nimport { Code, CodeScopeSpec, CodeSpec, ElementProps, IModel, PropertyMetaData, RelatedElement } from \"@itwin/core-common\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { SubCategory } from \"./Category\";\nimport { Element } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { SQLiteDb } from \"./SQLiteDb\";\nimport { _nativeDb } from \"./internal/Symbols\";\n\n/** The context for transforming a *source* Element to a *target* Element and remapping internal identifiers to the target iModel.\n * @beta\n */\nexport class IModelElementCloneContext {\n  /** The source IModelDb. */\n  public readonly sourceDb: IModelDb;\n  /** The target IModelDb. */\n  public readonly targetDb: IModelDb;\n  /** The native import context */\n  private _nativeContext: IModelJsNative.ImportContext;\n\n  /** Construct a new IModelElementCloneContext. It must be initialized with `initialize`, consider using [[IModelElementCloneContext.create]] instead\n   * @param sourceDb The source IModelDb.\n   * @param targetDb If provided the target IModelDb. If not provided, the source and target are the same IModelDb.\n   */\n  public constructor(sourceDb: IModelDb, targetDb?: IModelDb) {\n    this.sourceDb = sourceDb;\n    this.targetDb = (undefined !== targetDb) ? targetDb : sourceDb;\n    this._nativeContext = new IModelNative.platform.ImportContext(this.sourceDb[_nativeDb], this.targetDb[_nativeDb]);\n  }\n\n  /** perform necessary initialization to use a clone context, namely caching the reference types in the source's schemas */\n  public async initialize() {\n  }\n\n  /** construct and initialize an IModelElementCloneContext at once, for where you construct in an async context */\n  public static async create(...args: ConstructorParameters<typeof IModelElementCloneContext>): Promise<IModelElementCloneContext> {\n    const instance = new this(...args);\n    await instance.initialize();\n    return instance;\n  }\n\n  /** Returns `true` if this context is for transforming between 2 iModels and `false` if it for transforming within the same iModel. */\n  public get isBetweenIModels(): boolean { return this.sourceDb !== this.targetDb; }\n\n  /** Dispose any native resources associated with this IModelElementCloneContext. */\n  public [Symbol.dispose](): void { this._nativeContext.dispose(); }\n\n  /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */\n  public dispose() {\n    this[Symbol.dispose]();\n  }\n\n  /** Debugging aid that dumps the Id remapping details and other information to the specified output file.\n   * @internal\n   */\n  public dump(outputFileName: string): void { this._nativeContext.dump(outputFileName); }\n\n  /** Add a rule that remaps the specified source [CodeSpec]($common) to the specified target [CodeSpec]($common).\n   * @param sourceCodeSpecName The name of the CodeSpec from the source iModel.\n   * @param targetCodeSpecName The name of the CodeSpec from the target iModel.\n   * @throws [[IModelError]] if either CodeSpec could not be found.\n   */\n  public remapCodeSpec(sourceCodeSpecName: string, targetCodeSpecName: string): void {\n    const sourceCodeSpec: CodeSpec = this.sourceDb.codeSpecs.getByName(sourceCodeSpecName);\n    const targetCodeSpec: CodeSpec = this.targetDb.codeSpecs.getByName(targetCodeSpecName);\n    this._nativeContext.addCodeSpecId(sourceCodeSpec.id, targetCodeSpec.id);\n  }\n\n  /** Add a rule that remaps the specified source class to the specified target class. */\n  public remapElementClass(sourceClassFullName: string, targetClassFullName: string): void {\n    this._nativeContext.addClass(sourceClassFullName, targetClassFullName);\n  }\n\n  /** Add a rule that remaps the specified source Element to the specified target Element. */\n  public remapElement(sourceId: Id64String, targetId: Id64String): void {\n    this._nativeContext.addElementId(sourceId, targetId);\n  }\n\n  /** Remove a rule that remaps the specified source Element. */\n  public removeElement(sourceId: Id64String): void {\n    this._nativeContext.removeElementId(sourceId);\n  }\n\n  /** Look up a target CodeSpecId from the source CodeSpecId.\n   * @returns the target CodeSpecId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetCodeSpecId(sourceId: Id64String): Id64String {\n    if (Id64.invalid === sourceId) {\n      return Id64.invalid;\n    }\n    return this._nativeContext.findCodeSpecId(sourceId);\n  }\n\n  /** Look up a target ElementId from the source ElementId.\n   * @returns the target ElementId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetElementId(sourceElementId: Id64String): Id64String {\n    if (Id64.invalid === sourceElementId) {\n      return Id64.invalid;\n    }\n    return this._nativeContext.findElementId(sourceElementId);\n  }\n\n  /** Filter out geometry entries in the specified SubCategory from GeometryStreams in the target iModel.\n   * @note It is not possible to filter out a *default* SubCategory. A request to do so will be ignored.\n   * @see [SubCategory.isDefaultSubCategory]($backend)\n   */\n  public filterSubCategory(sourceSubCategoryId: Id64String): void {\n    const sourceSubCategory = this.sourceDb.elements.tryGetElement<SubCategory>(sourceSubCategoryId, SubCategory);\n    if (sourceSubCategory && !sourceSubCategory.isDefaultSubCategory) {\n      this._nativeContext.filterSubCategoryId(sourceSubCategoryId);\n    }\n  }\n\n  /** Returns `true` if there are any SubCategories being filtered. */\n  public get hasSubCategoryFilter(): boolean {\n    return this._nativeContext.hasSubCategoryFilter();\n  }\n\n  /** Returns `true` if this SubCategory is being filtered. */\n  public isSubCategoryFiltered(subCategoryId: Id64String): boolean {\n    return this._nativeContext.isSubCategoryFiltered(subCategoryId);\n  }\n\n  /** Import the specified font from the source iModel into the target iModel.\n   * @internal\n   */\n  public importFont(sourceFontNumber: number): void {\n    this.targetDb.clearFontMap(); // so it will be reloaded with new font info\n    this._nativeContext.importFont(sourceFontNumber);\n  }\n\n  /** Import a single CodeSpec from the source iModel into the target iModel.\n   * @internal\n   */\n  public importCodeSpec(sourceCodeSpecId: Id64String): void {\n    this._nativeContext.importCodeSpec(sourceCodeSpecId);\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public async cloneElement(sourceElement: Element, cloneOptions?: IModelJsNative.CloneElementOptions): Promise<ElementProps> {\n    const targetElementProps: ElementProps = this._nativeContext.cloneElement(sourceElement.id, cloneOptions);\n    // Ensure that all NavigationProperties in targetElementProps have a defined value so \"clearing\" changes will be part of the JSON used for update\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    sourceElement.forEachProperty((propertyName: string, meta: PropertyMetaData) => {\n      if ((meta.isNavigation) && (undefined === (sourceElement as any)[propertyName])) {\n        (targetElementProps as any)[propertyName] = RelatedElement.none;\n      }\n    }, false); // exclude custom because C++ has already handled them\n    if (this.isBetweenIModels) {\n      // The native C++ cloneElement strips off federationGuid, want to put it back if transformation is between iModels\n      targetElementProps.federationGuid = sourceElement.federationGuid;\n      if (CodeScopeSpec.Type.Repository === this.targetDb.codeSpecs.getById(targetElementProps.code.spec).scopeType) {\n        targetElementProps.code.scope = IModel.rootSubjectId;\n      }\n    }\n    // unlike other references, code cannot be null. If it is null, use an empty code instead\n    if (targetElementProps.code.scope === Id64.invalid || targetElementProps.code.spec === Id64.invalid) {\n      targetElementProps.code = Code.createEmpty();\n    }\n    const jsClass = this.sourceDb.getJsClass<typeof Element>(sourceElement.classFullName);\n    // eslint-disable-next-line @typescript-eslint/dot-notation\n    await jsClass[\"onCloned\"](this, sourceElement.toJSON(), targetElementProps);\n    return targetElementProps;\n  }\n\n  /**\n   * serialize state to a sqlite database at a given path\n   * assumes the database has not already had any context state serialized to it\n   * @internal\n   */\n  public saveStateToDb(db: SQLiteDb): void {\n    this._nativeContext.saveStateToDb(db[_nativeDb]);\n  }\n\n  /**\n   * load state from a sqlite database at a given path\n   * @internal\n   */\n  public loadStateFromDb(db: SQLiteDb): void {\n    this._nativeContext.loadStateFromDb(db[_nativeDb]);\n  }\n}\n"]}

package/lib/cjs/IModelHost.d.ts

@@ -339,7 +339,7 @@ export declare class IModelHost {
      */
     static get settingsSchemas(): SettingsSchemas;
     /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.
-     * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
+     * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
      */
     static snapshotFileNameResolver?: FileNameResolver;
     /** Get the current access token for this IModelHost, or a blank string if none is available.
@@ -464,7 +464,7 @@ export declare class KnownLocations {
  * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.
  * @see [[IModelHost.snapshotFileNameResolver]]
  * @public
- * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
+ * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
  */
 export declare abstract class FileNameResolver {
     /** Resolve a file name from the specified key.

package/lib/cjs/IModelHost.js

@@ -285,7 +285,7 @@ class IModelHost {
      */
     static get settingsSchemas() { return definedInStartup(this._settingsSchemas); }
     /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.
-     * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
+     * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
      */
     static snapshotFileNameResolver; // eslint-disable-line @typescript-eslint/no-deprecated
     /** Get the current access token for this IModelHost, or a blank string if none is available.
@@ -577,7 +577,7 @@ exports.KnownLocations = KnownLocations;
  * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.
  * @see [[IModelHost.snapshotFileNameResolver]]
  * @public
- * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
+ * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.
  */
 class FileNameResolver {
     /** Resolve a file name from the specified key.

package/lib/cjs/IModelHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.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 IModelHost\n */\n\n// To avoid circular load errors, the \"Element\" classes must be loaded before IModelHost.\nimport \"./IModelDb\"; // DO NOT REMOVE OR MOVE THIS LINE!\n\nimport { IModelNative, loadNativePlatform } from \"./internal/NativePlatform\";\nimport * as os from \"node:os\";\nimport { NativeLibrary } from \"@bentley/imodeljs-native\";\nimport { AccessToken, assert, BeEvent, BentleyStatus, DbResult, Guid, GuidString, IModelStatus, Logger, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\nimport { AuthorizationClient, IModelError, ITwinSettingsError, LocalDirName, SessionProps } from \"@itwin/core-common\";\nimport { AzureServerStorage, AzureServerStorageConfig, BlobServiceClientWrapper } from \"@itwin/object-storage-azure\";\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure/storage-blob\";\nimport type { ServerStorage } from \"@itwin/object-storage-core\";\nimport { BackendHubAccess, CreateNewIModelProps } from \"./BackendHubAccess\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\nimport { BisCoreSchema } from \"./BisCoreSchema\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\nimport { GenericSchema } from \"./domains/GenericSchema\";\nimport { EditTxn } from \"./EditTxn\";\nimport { GeoCoordConfig } from \"./GeoCoordConfig\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\nimport { initializeRpcBackend } from \"./RpcBackend\";\nimport { TileStorage } from \"./TileStorage\";\nimport { type Setting, SettingsContainer, SettingsDictionary, SettingsPriority } from \"./workspace/Settings\";\nimport { settingsWorkspaceDbName } from \"./workspace/SettingsDb\";\nimport { SettingsContainers, SettingsEditor } from \"./workspace/SettingsEditor\";\nimport { SettingsSchemas } from \"./workspace/SettingsSchemas\";\nimport { Workspace, WorkspaceDbLoadError, WorkspaceDbSettingsProps, WorkspaceOpts } from \"./workspace/Workspace\";\nimport { join, normalize as normalizeDir } from \"path\";\nimport { constructWorkspace, OwnedWorkspace, throwWorkspaceDbLoadErrors } from \"./internal/workspace/WorkspaceImpl\";\nimport { SettingsImpl } from \"./internal/workspace/SettingsImpl\";\nimport { constructSettingsSchemas } from \"./internal/workspace/SettingsSchemasImpl\";\nimport { _getHubAccess, _hubAccess, _setHubAccess } from \"./internal/Symbols\";\n\nconst loggerCategory = BackendLoggerCategory.IModelHost;\n\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\n\n/** @internal */\nexport interface CrashReportingConfigNameValuePair {\n  name: string;\n  value: string;\n}\n\n/** Configuration of the crash-reporting system.\n * @internal\n */\nexport interface CrashReportingConfig {\n  /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */\n  crashDir: string;\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\n  maxDumpsInDir?: number;\n  /** Enable crash-dumps? If so, .dmp and .properties.txt files will be generated and written to crashDir in the event of an unhandled native-code exception. If not, only .properties.txt files will be written. The default is false. */\n  enableCrashDumps?: boolean;\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\n  wantFullMemoryDumps?: boolean;\n  /** Enable Node.js crash reporting? If so, report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\n  enableNodeReport?: boolean;\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\n  params?: CrashReportingConfigNameValuePair[];\n  /** Run this .js file to process .dmp and Node.js crash reporting .json files in the event of a crash.\n   * This script will be executed with a single command-line parameter: the name of the dump or Node.js report file.\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\n   * Since it runs in a separate process, this script will have no access to the Javascript\n   * context of the exiting backend. No default.\n   */\n  dumpProcessorScriptFileName?: string;\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\n  uploadToBentley?: boolean;\n}\n\n/** @beta */\nexport interface AzureBlobStorageCredentials {\n  account: string;\n  accessKey: string;\n  baseUrl?: string;\n}\n\n/** Controls how iModel writes through the implicit transaction are enforced.\n *\n * Allowed values:\n * - \"allow\": preserve pre-version 5.8.0 behavior for backwards compatibility.\n * - \"log\": allow the operation but log each implicit write as an error case.\n * - \"throw\": reject writes through the implicit transaction and require explicit EditTxns.\n * @beta\n */\nexport type ImplicitWriteEnforcement = \"allow\" | \"log\" | \"throw\";\n\n/**\n * Options for [[IModelHost.startup]]\n * @public\n */\nexport interface IModelHostOptions {\n  /**\n   * The name of the *Profile* subdirectory of [[cacheDir]] for this process. If not present, \"default\" is used.\n   * @see [[IModelHost.profileName]]\n   * @beta\n   */\n  profileName?: string;\n\n  /**\n   * Root of the directory holding all the files that iTwin.js caches\n   * - If not specified at startup a platform specific default is used -\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\n   * - if specified, ensure it is set to a folder with read/write access.\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\n   */\n  cacheDir?: LocalDirName;\n\n  /** The directory where application assets are found. */\n  appAssetsDir?: LocalDirName;\n\n  /**\n   * Options for creating the [[IModelHost.appWorkspace]]\n   * @beta\n   */\n  workspace?: WorkspaceOpts;\n\n  /**\n   * The kind of iModel hub server to use.\n   */\n  hubAccess?: BackendHubAccess;\n\n  /** The Azure blob storage credentials to use for the tile cache service. If omitted and no external service implementation is provided, a local cache will be used.\n   * @beta\n   */\n  tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n\n  /**\n   * @beta\n   * @note A reference implementation is set for AzureServerStorage from @itwin/object-storage-azure if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),\n   *       set this property with a custom ServerStorage.\n   */\n  tileCacheStorage?: ServerStorage;\n\n  /** The maximum size in bytes to which a local sqlite database used for caching tiles can grow before it is purged of least-recently-used tiles.\n   * The local cache is used only if an external cache has not been configured via [[tileCacheStorage]], and [[tileCacheAzureCredentials]].\n   * Defaults to 1 GB. Must be an unsigned integer. A value of zero disables the local cache entirely.\n   * @beta\n   */\n  maxTileCacheDbSize?: number;\n\n  /** Whether to restrict tile cache URLs by client IP address (if available).\n   * @beta\n   */\n  restrictTileUrlsByClientIp?: boolean;\n\n  /** Whether to enable OpenTelemetry tracing.\n   * Defaults to `false`.\n   */\n  enableOpenTelemetry?: boolean;\n\n  /** Whether to compress cached tiles.\n   * Defaults to `true`.\n   */\n  compressCachedTiles?: boolean;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileTreeRequestTimeout?: number;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileContentRequestTimeout?: number;\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\n   * @internal\n   */\n  logTileLoadTimeThreshold?: number;\n\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\n   * @internal\n   */\n  logTileSizeThreshold?: number;\n\n  /** Crash-reporting configuration\n   * @internal\n   */\n  crashReportingConfig?: CrashReportingConfig;\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  authorizationClient?: AuthorizationClient;\n\n  /**\n   * Automatically enable shared channel when opening iModels for read/write (see [Working With Channels]($docs/learning/backend/Channel.md)).\n   * If not present, defaults to `true` for backwards compatibility. This means that the shared channel may be edited by default. Generally\n   * that is undesirable because it allows applications to \"accidentally\" modify data it shouldn't be allowed to modify. Unfortunately the\n   * previous versions of iTwin.js allowed it so this is necessary so they won't break.\n   * Will be changed to default to `false` in 5.0.\n   */\n  allowSharedChannel?: boolean;\n\n  /**\n   * Setting this to true will revert to the previous behavior of using the native side for all CRUD operations.\n   * While set to false, the getElement(), getModel() and getAspect() functions will use a thinned down native workflow to read the entities from the database.\n   * This workflow performs work previously done on the native side in the TS side, resulting in performance improvements, if errors are detected,\n   * this option can be set to true to revert to old workflow.\n   */\n  disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is enabled or disabled.\n   * @beta\n   */\n  incrementalSchemaLoading?: \"enabled\" | \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not.\n   * @beta\n   */\n  useSemanticRebase?: boolean;\n\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[ImplicitWriteEnforcement]] for the allowed values.\n    * Defaults to \"allow\" for backwards compatibility.\n   * @beta\n   */\n  implicitWriteEnforcement?: ImplicitWriteEnforcement;\n}\n\n/** Configuration of core-backend.\n * @public\n */\nexport class IModelHostConfiguration implements IModelHostOptions {\n  public static defaultTileRequestTimeout = 20 * 1000;\n  public static defaultLogTileLoadTimeThreshold = 40;\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\n  /** @internal */\n  public static defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;\n  public appAssetsDir?: LocalDirName;\n  public cacheDir?: LocalDirName;\n\n  /** @beta */\n  public workspace?: WorkspaceOpts;\n  public hubAccess?: BackendHubAccess;\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public authorizationClient?: AuthorizationClient;\n  /** @beta */\n  public restrictTileUrlsByClientIp?: boolean;\n  public compressCachedTiles?: boolean;\n  /** @beta */\n  public tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n  /** @internal */\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  /** @internal */\n  public logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;\n  /** @internal */\n  public crashReportingConfig?: CrashReportingConfig;\n  /**\n   * Configuration controlling whether to use the thinned down native instance functions for element, model, and aspect CRUD operations\n   * or use the previous behavior of using the native side for all CRUD operations. Set to true to revert to the previous behavior.\n   * @beta\n  */\n  public disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  public disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is disabled.\n   * Default is \"disabled\" at the moment to preserve existing behavior.\n   * @beta\n   */\n  public incrementalSchemaLoading: \"enabled\" | \"disabled\" = \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not. By default it is undefined meaning semantic rebase is not used.\n   * @beta\n   */\n  public useSemanticRebase?: boolean;\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[IModelHostOptions.implicitWriteEnforcement]] for the meaning of each allowed value.\n   * @beta\n   */\n  public implicitWriteEnforcement: ImplicitWriteEnforcement = \"allow\";\n}\n\n/**\n * Settings for `IModelHost.appWorkspace`.\n * @note this includes the default dictionary from the SettingsSpecRegistry\n */\nclass ApplicationSettings extends SettingsImpl {\n  private _remove?: VoidFunction;\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority > SettingsPriority.application) // only application or lower may appear in ApplicationSettings\n      throw new Error(\"Use IModelSettings\");\n  }\n  private updateDefaults() {\n    const defaults: SettingsContainer = {};\n    for (const [schemaName, val] of IModelHost.settingsSchemas.settingDefs) {\n      if (val.default)\n        defaults[schemaName] = val.default;\n    }\n    this.addDictionary({ name: \"_default_\", priority: 0 }, defaults);\n  }\n\n  public constructor() {\n    super();\n    this._remove = IModelHost.settingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());\n    this.updateDefaults();\n  }\n\n  public override close() {\n    if (this._remove) {\n      this._remove();\n      this._remove = undefined;\n    }\n  }\n}\n\n/**\n * Settings for an iTwin. May only include settings priority for iTwin and organization.\n */\nclass ITwinWorkspaceSettings extends SettingsImpl {\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority <= SettingsPriority.application)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n    if (priority > SettingsPriority.iTwin)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n  }\n\n  public override * getSettingEntries<T extends Setting>(name: string): Iterable<{ value: T, dictionary: SettingsDictionary }> {\n    yield* super.getSettingEntries(name);\n    yield* IModelHost.appWorkspace.settings.getSettingEntries(name);\n  }\n}\n\nconst definedInStartup = <T>(obj: T | undefined): T => {\n  if (obj === undefined)\n    throw new Error(\"IModelHost.startup must be called first\");\n  return obj;\n};\n\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\n * See [the learning article]($docs/learning/backend/IModelHost.md)\n * @public\n */\nexport class IModelHost {\n  private constructor() { }\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public static authorizationClient?: AuthorizationClient;\n\n  public static backendVersion = \"\";\n  private static _profileName: string;\n  private static _cacheDir = \"\";\n  private static _settingsSchemas?: SettingsSchemas;\n  private static _appWorkspace?: OwnedWorkspace;\n\n  // Omit the hubAccess field from configuration so it stays internal.\n  public static configuration?: Omit<IModelHostOptions, \"hubAccess\">;\n\n  /**\n   * The name of the *Profile* directory (a subdirectory of \"[[cacheDir]]/profiles/\") for this process.\n   *\n   * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.\n   * It is important that information in the profile cache be consistent but isolated across sessions (i.e.\n   * data for a profile is maintained between runs, but each profile is completely independent and\n   * unaffected by the presence or use of others.)\n   * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]\n   * if a second process attempts to use the same profile.\n   * @beta\n   */\n  public static get profileName(): string {\n    return this._profileName;\n  }\n\n  /** The full path of the Profile directory.\n   * @see [[profileName]]\n   * @beta\n   */\n  public static get profileDir(): LocalDirName {\n    return join(this._cacheDir, \"profiles\", this._profileName);\n  }\n\n  /** Event raised during startup to allow loading settings data */\n  public static readonly onWorkspaceStartup = new BeEvent<() => void>();\n\n  /** Event raised just after the backend IModelHost was started */\n  public static readonly onAfterStartup = new BeEvent<() => void>();\n\n  /** Event raised just before the backend IModelHost is to be shut down */\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\n\n  /** @internal */\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\n\n  /** A uniqueId for this session */\n  public static get sessionId() { return this.session.sessionId; }\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\n\n  /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */\n  public static get applicationId() { return this.session.applicationId; }\n  public static set applicationId(id: string) { this.session.applicationId = id; }\n\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\n  public static get applicationVersion() { return this.session.applicationVersion; }\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\n\n  /** A string that can identify the current user to other users when collaborating. */\n  public static userMoniker = \"unknown\";\n\n  /** Root directory holding files that iTwin.js caches */\n  public static get cacheDir(): LocalDirName { return this._cacheDir; }\n\n  /** The application [[Workspace]] for this `IModelHost`\n   * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).\n   * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and\n   * attempting to add them to this Workspace will fail.\n   * @beta\n   */\n  public static get appWorkspace(): Workspace { return definedInStartup(this._appWorkspace); }\n\n  /** Obtain the [[Workspace]] for an iTwin by discovering its settings containers.\n   * Named dictionary resources from the account iTwin container are loaded at [[SettingsPriority.organization]];\n   * resources from the requested iTwin's container (when different from the account iTwin) are loaded at\n   * [[SettingsPriority.iTwin]].\n   * @note This method requires an internet connection to discover the containers.\n   * To use an iTwin workspace offline, use the overload that accepts [[WorkspaceDbSettingsProps]].\n   * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(iTwinId: GuidString): Promise<OwnedWorkspace>;\n  /** Obtain the [[Workspace]] for an iTwin.\n   * The supplied [[WorkspaceDbSettingsProps]] are passed directly to [[Workspace.loadSettingsDictionary]].\n    * @note You can derive these from the `settingsSources` property on a previously returned workspace.\n    * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(props: WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace>;\n  /** @internal */\n  public static async getITwinWorkspace(args: GuidString | WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace> {\n    const isITwinId = typeof args === \"string\";\n    const workspace = constructWorkspace(new ITwinWorkspaceSettings());\n\n    try {\n      const settingsSources = isITwinId ? await SettingsContainers.getITwinSettingsSources(args) : args;\n      if (undefined === settingsSources)\n        return workspace;\n\n      workspace.settingsSources = settingsSources;\n\n      const problems: WorkspaceDbLoadError[] = [];\n      await workspace.loadSettingsDictionary(settingsSources, problems);\n\n      if (problems.length > 0) {\n        const label = isITwinId ? `iTwin '${args}'` : \"the supplied settings workspace db properties\";\n        throwWorkspaceDbLoadErrors(`attempting to load workspace settings for ${label}`, problems);\n      }\n\n      return workspace;\n    } catch (error) {\n      workspace.close();\n      throw error;\n    }\n  }\n\n  /** Save a named [[SettingsDictionary]] to the iTwin's settings container.\n   * If no iTwin settings container exists for `iTwinId`, one is created.\n   * The dictionary is stored as a named resource in the container's default [[WorkspaceDb]], where `name` is used as the resource name.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary, used as the resource name in the [[WorkspaceDb]].\n   * @param settings The settings key-value pairs to store.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async saveSettingDictionary(iTwinId: GuidString, name: string, settings: SettingsContainer): Promise<void> {\n    const { editor, container } = await SettingsEditor.constructForITwin(iTwinId);\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.updateSettingsResource(settings, name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** Delete a named [[SettingsDictionary]] from the iTwin's settings container.\n   * If no iTwin settings container exists, this method does nothing.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary (resource name) to delete.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async deleteSettingDictionary(iTwinId: GuidString, name: string): Promise<void> {\n    const settingsEditor = await SettingsEditor.getForITwin(iTwinId);\n    if (undefined === settingsEditor)\n      return;\n\n    const { editor, container } = settingsEditor;\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.removeString(name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** The registry of schemas describing the [[Setting]]s for the application session.\n   * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].\n   * @beta\n   */\n  public static get settingsSchemas(): SettingsSchemas { return definedInStartup(this._settingsSchemas); }\n\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.\n   * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n   */\n  public static snapshotFileNameResolver?: FileNameResolver; // eslint-disable-line @typescript-eslint/no-deprecated\n\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\n   * obtains the token and forwards it to the frontend.\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\n   * returned by this method may change over time throughout the course of a session.\n   */\n  public static async getAccessToken(): Promise<AccessToken> {\n    try {\n      return (await IModelHost.authorizationClient?.getAccessToken()) ?? \"\";\n    } catch {\n      return \"\";\n    }\n  }\n\n  private static loadNative(options: IModelHostOptions) {\n    loadNativePlatform();\n\n    if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\n      IModelNative.platform.setCrashReporting(options.crashReportingConfig);\n\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", {\n        enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,\n        wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,\n        enableNodeReport: options.crashReportingConfig?.enableNodeReport,\n        uploadToBentley: options.crashReportingConfig?.uploadToBentley,\n      });\n\n      if (options.crashReportingConfig.enableNodeReport) {\n        if (process.report !== undefined) {\n          process.report.reportOnFatalError = true;\n          process.report.reportOnUncaughtException = true;\n          process.report.directory = options.crashReportingConfig.crashDir;\n          Logger.logTrace(loggerCategory, \"Configured Node.js crash reporting\");\n        } else {\n          Logger.logWarning(loggerCategory, \"Unable to configure Node.js crash reporting\");\n        }\n      }\n    }\n  }\n\n  /** @internal */\n  public static tileStorage?: TileStorage;\n\n  private static _hubAccess?: BackendHubAccess;\n  /** @internal */\n  public static [_setHubAccess](hubAccess: BackendHubAccess | undefined) { this._hubAccess = hubAccess; }\n\n  /** get the current hubAccess, if present.\n   * @internal\n   */\n  public static [_getHubAccess](): BackendHubAccess | undefined { return this._hubAccess; }\n\n  /** Provides access to the IModelHub for this IModelHost\n   * @internal\n   * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\n   * To determine whether one is present, use [[_getHubAccess]].\n   */\n  public static get [_hubAccess](): BackendHubAccess {\n    if (IModelHost._hubAccess === undefined)\n      throw new IModelError(IModelStatus.BadRequest, \"No BackendHubAccess supplied in IModelHostOptions\");\n    return IModelHost._hubAccess;\n  }\n\n  private static initializeWorkspace(configuration: IModelHostOptions) {\n    const settingAssets = join(KnownLocations.packageAssetsDir, \"Settings\");\n    this._settingsSchemas = constructSettingsSchemas();\n    this._settingsSchemas.addDirectory(join(settingAssets, \"Schemas\"));\n    this._appWorkspace = constructWorkspace(new ApplicationSettings(), configuration.workspace);\n\n    // Create the CloudCache for Workspaces. This will fail if another process is already using the same profile.\n    try {\n      this.appWorkspace.getCloudCache();\n    } catch (e: any) {\n      throw (e.errorNumber === DbResult.BE_SQLITE_BUSY) ? new IModelError(DbResult.BE_SQLITE_BUSY, `Profile [${this.profileDir}] is already in use by another process`) : e;\n    }\n\n    this.appWorkspace.settings.addDirectory(settingAssets, SettingsPriority.defaults);\n\n    GeoCoordConfig.onStartup();\n    // allow applications to load their default settings\n    this.onWorkspaceStartup.raiseEvent();\n  }\n\n  private static _isValid = false;\n\n  /** true between a successful call to [[startup]] and before [[shutdown]] */\n  public static get isValid() {\n    return IModelHost._isValid;\n  }\n\n  /** This method must be called before any iTwin.js services are used.\n   * @param options Host configuration data.\n   * Raises [[onAfterStartup]].\n   * @see [[shutdown]].\n   */\n  public static async startup(options?: IModelHostOptions): Promise<void> {\n    if (this._isValid)\n      return; // we're already initialized\n    this._isValid = true;\n\n    options = options ?? {};\n    if (this.sessionId === \"\")\n      this.sessionId = Guid.createValue();\n\n    this.authorizationClient = options.authorizationClient;\n\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-require-imports\n    initializeRpcBackend(options.enableOpenTelemetry);\n\n    this.loadNative(options);\n    this.setupCacheDir(options);\n    this.initializeWorkspace(options);\n    EditTxn.implicitWriteEnforcement = options.implicitWriteEnforcement ?? \"allow\";\n    BriefcaseManager.initialize(join(this._cacheDir, \"imodels\"));\n\n    [\n      IModelReadRpcImpl,\n      IModelTileRpcImpl,\n      SnapshotIModelRpcImpl, // eslint-disable-line @typescript-eslint/no-deprecated\n      DevToolsRpcImpl,\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\n\n    [\n      BisCoreSchema,\n      GenericSchema,\n      FunctionalSchema,\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\n\n    const { hubAccess, ...otherOptions } = options;\n    if (undefined !== hubAccess)\n      this._hubAccess = hubAccess;\n\n    this.configuration = otherOptions;\n    this.setupTileCache();\n\n    process.once(\"beforeExit\", IModelHost.shutdown);\n    this.onAfterStartup.raiseEvent();\n  }\n\n  private static setupCacheDir(configuration: IModelHostOptions) {\n    this._cacheDir = normalizeDir(configuration.cacheDir ?? NativeLibrary.defaultCacheDir);\n    IModelJsFs.recursiveMkDirSync(this._cacheDir);\n\n    this._profileName = configuration.profileName ?? \"default\";\n    Logger.logInfo(loggerCategory, `cacheDir: [${this.cacheDir}], profileDir: [${this.profileDir}]`);\n  }\n\n  /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */\n  public static async shutdown(this: void): Promise<void> {\n    // Note: This method is set as a node listener where `this` is unbound. Call private method to\n    // ensure `this` is correct. Don't combine these methods.\n    return IModelHost.doShutdown();\n  }\n\n  /**\n   * Create a new iModel.\n   * @returns the Guid of the newly created iModel.\n   * @throws [IModelError]($common) in case of errors.\n   * @note If [[IModelHostOptions.hubAccess]] was undefined in the call to [[startup]], this function will throw an error.\n   */\n  public static async createNewIModel(arg: CreateNewIModelProps): Promise<GuidString> {\n    return this[_hubAccess].createNewIModel(arg);\n  }\n\n  private static async doShutdown() {\n    if (!this._isValid)\n      return;\n\n    this._isValid = false;\n    this.onBeforeShutdown.raiseEvent();\n\n    this.configuration = undefined;\n    EditTxn.implicitWriteEnforcement = \"allow\";\n    this.tileStorage = undefined;\n\n    this._appWorkspace?.close();\n    this._appWorkspace = undefined;\n    this._settingsSchemas = undefined;\n\n    CloudSqlite.CloudCaches.destroy();\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\n  }\n\n  /**\n   * Add or update a property that should be included in a crash report.\n   * @internal\n   */\n  public static setCrashReportProperty(name: string, value: string): void {\n    IModelNative.platform.setCrashReportProperty(name, value);\n  }\n\n  /**\n   * Remove a previously defined property so that will not be included in a crash report.\n   * @internal\n   */\n  public static removeCrashReportProperty(name: string): void {\n    IModelNative.platform.setCrashReportProperty(name, undefined);\n  }\n\n  /**\n   * Get all properties that will be included in a crash report.\n   * @internal\n   */\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\n    return IModelNative.platform.getCrashReportProperties();\n  }\n\n  /** The directory where application assets may be found */\n  public static get appAssetsDir(): string | undefined {\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined;\n  }\n\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileTreeRequestTimeout(): number {\n    return IModelHost.configuration?.tileTreeRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileContentRequestTimeout(): number {\n    return IModelHost.configuration?.tileContentRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\n  public static get logTileLoadTimeThreshold(): number {\n    return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  }\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\n  public static get logTileSizeThreshold(): number {\n    return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold;\n  }\n\n  /** Whether external tile caching is active.\n   * @internal\n   */\n  public static get usingExternalTileCache(): boolean {\n    return undefined !== IModelHost.tileStorage;\n  }\n\n  /** Whether to restrict tile cache URLs by client IP address.\n   * @internal\n   */\n  public static get restrictTileUrlsByClientIp(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false);\n  }\n\n  /** Whether to compress cached tiles.\n   * @internal\n   */\n  public static get compressCachedTiles(): boolean {\n    return false !== IModelHost.configuration?.compressCachedTiles;\n  }\n\n  /**\n   * Whether to use semantic rebase or not.\n   * @internal\n   */\n  public static get useSemanticRebase(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.useSemanticRebase ? true : false);\n  }\n\n  private static setupTileCache() {\n    assert(undefined !== IModelHost.configuration);\n    const config = IModelHost.configuration;\n    const storage = config.tileCacheStorage;\n    const credentials = config.tileCacheAzureCredentials;\n\n    if (!storage && !credentials) {\n      IModelNative.platform.setMaxTileCacheSize(config.maxTileCacheDbSize ?? IModelHostConfiguration.defaultMaxTileCacheDbSize);\n      return;\n    }\n\n    IModelNative.platform.setMaxTileCacheSize(0);\n    if (credentials) {\n      if (storage)\n        throw new IModelError(BentleyStatus.ERROR, \"Cannot use both Azure and custom cloud storage providers for tile cache.\");\n      this.setupAzureTileCache(credentials);\n    }\n    if (storage)\n      IModelHost.tileStorage = new TileStorage(storage);\n  }\n\n  private static setupAzureTileCache(credentials: AzureBlobStorageCredentials) {\n    const storageConfig: AzureServerStorageConfig = {\n      accountName: credentials.account,\n      accountKey: credentials.accessKey,\n      baseUrl: credentials.baseUrl ?? `https://${credentials.account}.blob.core.windows.net`,\n    }\n    const blobServiceClient = new BlobServiceClient(\n      storageConfig.baseUrl,\n      new StorageSharedKeyCredential(storageConfig.accountName, storageConfig.accountKey),\n    );\n    const azureStorage: ServerStorage = new AzureServerStorage(storageConfig, new BlobServiceClientWrapper(blobServiceClient))\n    IModelHost.tileStorage = new TileStorage(azureStorage);\n  }\n\n  /** @internal */\n  public static computeSchemaChecksum(arg: { schemaXmlPath: string, referencePaths: string[], exactMatch?: boolean }): string {\n    return IModelNative.platform.computeSchemaChecksum(arg);\n  }\n}\n\n/** Information about the platform on which the app is running.\n * @public\n */\nexport class Platform {\n  /** Get the name of the platform. */\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\n    return process.platform as any;\n  }\n}\n\n/** Well known directories that may be used by the application.\n * @public\n */\nexport class KnownLocations {\n\n  /** The directory where the imodeljs-native assets are stored. */\n  public static get nativeAssetsDir(): LocalDirName {\n    return IModelNative.platform.DgnDb.getAssetsDir();\n  }\n\n  /** The directory where the core-backend assets are stored. */\n  public static get packageAssetsDir(): LocalDirName {\n    return join(__dirname, \"assets\");\n  }\n\n  /** The temporary directory. */\n  public static get tmpdir(): LocalDirName {\n    return os.tmpdir();\n  }\n}\n\n/** Extend this class to provide custom file name resolution behavior.\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\n * @see [[IModelHost.snapshotFileNameResolver]]\n * @public\n * @deprecated in 4.10 - will not be removed until after 2026-06-13. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n */\nexport abstract class FileNameResolver {\n  /** Resolve a file name from the specified key.\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name or `undefined` if not found.\n   */\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\n  /** Resolve a file name from the specified key.\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveKey(fileKey: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\n    }\n    return resolvedFileName;\n  }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name or `undefined` if not found.\n   */\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveFileName(inFileName: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\n    }\n    return resolvedFileName;\n  }\n}\n"]}
+{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.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 IModelHost\n */\n\n// To avoid circular load errors, the \"Element\" classes must be loaded before IModelHost.\nimport \"./IModelDb\"; // DO NOT REMOVE OR MOVE THIS LINE!\n\nimport { IModelNative, loadNativePlatform } from \"./internal/NativePlatform\";\nimport * as os from \"node:os\";\nimport { NativeLibrary } from \"@bentley/imodeljs-native\";\nimport { AccessToken, assert, BeEvent, BentleyStatus, DbResult, Guid, GuidString, IModelStatus, Logger, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\nimport { AuthorizationClient, IModelError, ITwinSettingsError, LocalDirName, SessionProps } from \"@itwin/core-common\";\nimport { AzureServerStorage, AzureServerStorageConfig, BlobServiceClientWrapper } from \"@itwin/object-storage-azure\";\nimport { BlobServiceClient, StorageSharedKeyCredential } from \"@azure/storage-blob\";\nimport type { ServerStorage } from \"@itwin/object-storage-core\";\nimport { BackendHubAccess, CreateNewIModelProps } from \"./BackendHubAccess\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\nimport { BisCoreSchema } from \"./BisCoreSchema\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\nimport { GenericSchema } from \"./domains/GenericSchema\";\nimport { EditTxn } from \"./EditTxn\";\nimport { GeoCoordConfig } from \"./GeoCoordConfig\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\nimport { initializeRpcBackend } from \"./RpcBackend\";\nimport { TileStorage } from \"./TileStorage\";\nimport { type Setting, SettingsContainer, SettingsDictionary, SettingsPriority } from \"./workspace/Settings\";\nimport { settingsWorkspaceDbName } from \"./workspace/SettingsDb\";\nimport { SettingsContainers, SettingsEditor } from \"./workspace/SettingsEditor\";\nimport { SettingsSchemas } from \"./workspace/SettingsSchemas\";\nimport { Workspace, WorkspaceDbLoadError, WorkspaceDbSettingsProps, WorkspaceOpts } from \"./workspace/Workspace\";\nimport { join, normalize as normalizeDir } from \"path\";\nimport { constructWorkspace, OwnedWorkspace, throwWorkspaceDbLoadErrors } from \"./internal/workspace/WorkspaceImpl\";\nimport { SettingsImpl } from \"./internal/workspace/SettingsImpl\";\nimport { constructSettingsSchemas } from \"./internal/workspace/SettingsSchemasImpl\";\nimport { _getHubAccess, _hubAccess, _setHubAccess } from \"./internal/Symbols\";\n\nconst loggerCategory = BackendLoggerCategory.IModelHost;\n\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\n\n/** @internal */\nexport interface CrashReportingConfigNameValuePair {\n  name: string;\n  value: string;\n}\n\n/** Configuration of the crash-reporting system.\n * @internal\n */\nexport interface CrashReportingConfig {\n  /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */\n  crashDir: string;\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\n  maxDumpsInDir?: number;\n  /** Enable crash-dumps? If so, .dmp and .properties.txt files will be generated and written to crashDir in the event of an unhandled native-code exception. If not, only .properties.txt files will be written. The default is false. */\n  enableCrashDumps?: boolean;\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\n  wantFullMemoryDumps?: boolean;\n  /** Enable Node.js crash reporting? If so, report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\n  enableNodeReport?: boolean;\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\n  params?: CrashReportingConfigNameValuePair[];\n  /** Run this .js file to process .dmp and Node.js crash reporting .json files in the event of a crash.\n   * This script will be executed with a single command-line parameter: the name of the dump or Node.js report file.\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\n   * Since it runs in a separate process, this script will have no access to the Javascript\n   * context of the exiting backend. No default.\n   */\n  dumpProcessorScriptFileName?: string;\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\n  uploadToBentley?: boolean;\n}\n\n/** @beta */\nexport interface AzureBlobStorageCredentials {\n  account: string;\n  accessKey: string;\n  baseUrl?: string;\n}\n\n/** Controls how iModel writes through the implicit transaction are enforced.\n *\n * Allowed values:\n * - \"allow\": preserve pre-version 5.8.0 behavior for backwards compatibility.\n * - \"log\": allow the operation but log each implicit write as an error case.\n * - \"throw\": reject writes through the implicit transaction and require explicit EditTxns.\n * @beta\n */\nexport type ImplicitWriteEnforcement = \"allow\" | \"log\" | \"throw\";\n\n/**\n * Options for [[IModelHost.startup]]\n * @public\n */\nexport interface IModelHostOptions {\n  /**\n   * The name of the *Profile* subdirectory of [[cacheDir]] for this process. If not present, \"default\" is used.\n   * @see [[IModelHost.profileName]]\n   * @beta\n   */\n  profileName?: string;\n\n  /**\n   * Root of the directory holding all the files that iTwin.js caches\n   * - If not specified at startup a platform specific default is used -\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\n   * - if specified, ensure it is set to a folder with read/write access.\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\n   */\n  cacheDir?: LocalDirName;\n\n  /** The directory where application assets are found. */\n  appAssetsDir?: LocalDirName;\n\n  /**\n   * Options for creating the [[IModelHost.appWorkspace]]\n   * @beta\n   */\n  workspace?: WorkspaceOpts;\n\n  /**\n   * The kind of iModel hub server to use.\n   */\n  hubAccess?: BackendHubAccess;\n\n  /** The Azure blob storage credentials to use for the tile cache service. If omitted and no external service implementation is provided, a local cache will be used.\n   * @beta\n   */\n  tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n\n  /**\n   * @beta\n   * @note A reference implementation is set for AzureServerStorage from @itwin/object-storage-azure if [[tileCacheAzureCredentials]] property is set. To supply a different implementation for any service provider (such as AWS),\n   *       set this property with a custom ServerStorage.\n   */\n  tileCacheStorage?: ServerStorage;\n\n  /** The maximum size in bytes to which a local sqlite database used for caching tiles can grow before it is purged of least-recently-used tiles.\n   * The local cache is used only if an external cache has not been configured via [[tileCacheStorage]], and [[tileCacheAzureCredentials]].\n   * Defaults to 1 GB. Must be an unsigned integer. A value of zero disables the local cache entirely.\n   * @beta\n   */\n  maxTileCacheDbSize?: number;\n\n  /** Whether to restrict tile cache URLs by client IP address (if available).\n   * @beta\n   */\n  restrictTileUrlsByClientIp?: boolean;\n\n  /** Whether to enable OpenTelemetry tracing.\n   * Defaults to `false`.\n   */\n  enableOpenTelemetry?: boolean;\n\n  /** Whether to compress cached tiles.\n   * Defaults to `true`.\n   */\n  compressCachedTiles?: boolean;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileTreeRequestTimeout?: number;\n\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\n   * @internal\n   */\n  tileContentRequestTimeout?: number;\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\n   * @internal\n   */\n  logTileLoadTimeThreshold?: number;\n\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\n   * @internal\n   */\n  logTileSizeThreshold?: number;\n\n  /** Crash-reporting configuration\n   * @internal\n   */\n  crashReportingConfig?: CrashReportingConfig;\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  authorizationClient?: AuthorizationClient;\n\n  /**\n   * Automatically enable shared channel when opening iModels for read/write (see [Working With Channels]($docs/learning/backend/Channel.md)).\n   * If not present, defaults to `true` for backwards compatibility. This means that the shared channel may be edited by default. Generally\n   * that is undesirable because it allows applications to \"accidentally\" modify data it shouldn't be allowed to modify. Unfortunately the\n   * previous versions of iTwin.js allowed it so this is necessary so they won't break.\n   * Will be changed to default to `false` in 5.0.\n   */\n  allowSharedChannel?: boolean;\n\n  /**\n   * Setting this to true will revert to the previous behavior of using the native side for all CRUD operations.\n   * While set to false, the getElement(), getModel() and getAspect() functions will use a thinned down native workflow to read the entities from the database.\n   * This workflow performs work previously done on the native side in the TS side, resulting in performance improvements, if errors are detected,\n   * this option can be set to true to revert to old workflow.\n   */\n  disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is enabled or disabled.\n   * @beta\n   */\n  incrementalSchemaLoading?: \"enabled\" | \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not.\n   * @beta\n   */\n  useSemanticRebase?: boolean;\n\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[ImplicitWriteEnforcement]] for the allowed values.\n    * Defaults to \"allow\" for backwards compatibility.\n   * @beta\n   */\n  implicitWriteEnforcement?: ImplicitWriteEnforcement;\n}\n\n/** Configuration of core-backend.\n * @public\n */\nexport class IModelHostConfiguration implements IModelHostOptions {\n  public static defaultTileRequestTimeout = 20 * 1000;\n  public static defaultLogTileLoadTimeThreshold = 40;\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\n  /** @internal */\n  public static defaultMaxTileCacheDbSize = 1024 * 1024 * 1024;\n  public appAssetsDir?: LocalDirName;\n  public cacheDir?: LocalDirName;\n\n  /** @beta */\n  public workspace?: WorkspaceOpts;\n  public hubAccess?: BackendHubAccess;\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public authorizationClient?: AuthorizationClient;\n  /** @beta */\n  public restrictTileUrlsByClientIp?: boolean;\n  public compressCachedTiles?: boolean;\n  /** @beta */\n  public tileCacheAzureCredentials?: AzureBlobStorageCredentials;\n  /** @internal */\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\n  /** @internal */\n  public logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  /** @internal */\n  public logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;\n  /** @internal */\n  public crashReportingConfig?: CrashReportingConfig;\n  /**\n   * Configuration controlling whether to use the thinned down native instance functions for element, model, and aspect CRUD operations\n   * or use the previous behavior of using the native side for all CRUD operations. Set to true to revert to the previous behavior.\n   * @beta\n  */\n  public disableThinnedNativeInstanceWorkflow?: boolean;\n\n  /**\n   * Configuration controlling whether to disable the creation of restore points during pull/merge operations.\n   * @beta\n   */\n  public disableRestorePointOnPullMerge?: true;\n  /**\n   * Configuration controlling whether incremental schema loading is disabled.\n   * Default is \"disabled\" at the moment to preserve existing behavior.\n   * @beta\n   */\n  public incrementalSchemaLoading: \"enabled\" | \"disabled\" = \"disabled\";\n  /**\n   * Configuration controlling whether to use semantic rebase or not. By default it is undefined meaning semantic rebase is not used.\n   * @beta\n   */\n  public useSemanticRebase?: boolean;\n  /**\n    * Controls how writes through the implicit transaction are enforced.\n    * See [[IModelHostOptions.implicitWriteEnforcement]] for the meaning of each allowed value.\n   * @beta\n   */\n  public implicitWriteEnforcement: ImplicitWriteEnforcement = \"allow\";\n}\n\n/**\n * Settings for `IModelHost.appWorkspace`.\n * @note this includes the default dictionary from the SettingsSpecRegistry\n */\nclass ApplicationSettings extends SettingsImpl {\n  private _remove?: VoidFunction;\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority > SettingsPriority.application) // only application or lower may appear in ApplicationSettings\n      throw new Error(\"Use IModelSettings\");\n  }\n  private updateDefaults() {\n    const defaults: SettingsContainer = {};\n    for (const [schemaName, val] of IModelHost.settingsSchemas.settingDefs) {\n      if (val.default)\n        defaults[schemaName] = val.default;\n    }\n    this.addDictionary({ name: \"_default_\", priority: 0 }, defaults);\n  }\n\n  public constructor() {\n    super();\n    this._remove = IModelHost.settingsSchemas.onSchemaChanged.addListener(() => this.updateDefaults());\n    this.updateDefaults();\n  }\n\n  public override close() {\n    if (this._remove) {\n      this._remove();\n      this._remove = undefined;\n    }\n  }\n}\n\n/**\n * Settings for an iTwin. May only include settings priority for iTwin and organization.\n */\nclass ITwinWorkspaceSettings extends SettingsImpl {\n  protected override verifyPriority(priority: SettingsPriority) {\n    if (priority <= SettingsPriority.application)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n    if (priority > SettingsPriority.iTwin)\n      ITwinSettingsError.throwError(\"invalid-priority\", { message: `Settings with priority ${priority} cannot be added to an iTwin workspace.` });\n  }\n\n  public override * getSettingEntries<T extends Setting>(name: string): Iterable<{ value: T, dictionary: SettingsDictionary }> {\n    yield* super.getSettingEntries(name);\n    yield* IModelHost.appWorkspace.settings.getSettingEntries(name);\n  }\n}\n\nconst definedInStartup = <T>(obj: T | undefined): T => {\n  if (obj === undefined)\n    throw new Error(\"IModelHost.startup must be called first\");\n  return obj;\n};\n\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\n * See [the learning article]($docs/learning/backend/IModelHost.md)\n * @public\n */\nexport class IModelHost {\n  private constructor() { }\n\n  /** The AuthorizationClient used to obtain [AccessToken]($bentley)s. */\n  public static authorizationClient?: AuthorizationClient;\n\n  public static backendVersion = \"\";\n  private static _profileName: string;\n  private static _cacheDir = \"\";\n  private static _settingsSchemas?: SettingsSchemas;\n  private static _appWorkspace?: OwnedWorkspace;\n\n  // Omit the hubAccess field from configuration so it stays internal.\n  public static configuration?: Omit<IModelHostOptions, \"hubAccess\">;\n\n  /**\n   * The name of the *Profile* directory (a subdirectory of \"[[cacheDir]]/profiles/\") for this process.\n   *\n   * The *Profile* directory is used to cache data that is specific to a type-of-usage of the iTwin.js library.\n   * It is important that information in the profile cache be consistent but isolated across sessions (i.e.\n   * data for a profile is maintained between runs, but each profile is completely independent and\n   * unaffected by the presence or use of others.)\n   * @note **Only one process at a time may be using a given profile**, and an exception will be thrown by [[startup]]\n   * if a second process attempts to use the same profile.\n   * @beta\n   */\n  public static get profileName(): string {\n    return this._profileName;\n  }\n\n  /** The full path of the Profile directory.\n   * @see [[profileName]]\n   * @beta\n   */\n  public static get profileDir(): LocalDirName {\n    return join(this._cacheDir, \"profiles\", this._profileName);\n  }\n\n  /** Event raised during startup to allow loading settings data */\n  public static readonly onWorkspaceStartup = new BeEvent<() => void>();\n\n  /** Event raised just after the backend IModelHost was started */\n  public static readonly onAfterStartup = new BeEvent<() => void>();\n\n  /** Event raised just before the backend IModelHost is to be shut down */\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\n\n  /** @internal */\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\n\n  /** A uniqueId for this session */\n  public static get sessionId() { return this.session.sessionId; }\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\n\n  /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */\n  public static get applicationId() { return this.session.applicationId; }\n  public static set applicationId(id: string) { this.session.applicationId = id; }\n\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\n  public static get applicationVersion() { return this.session.applicationVersion; }\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\n\n  /** A string that can identify the current user to other users when collaborating. */\n  public static userMoniker = \"unknown\";\n\n  /** Root directory holding files that iTwin.js caches */\n  public static get cacheDir(): LocalDirName { return this._cacheDir; }\n\n  /** The application [[Workspace]] for this `IModelHost`\n   * @note this `Workspace` only holds [[WorkspaceContainer]]s and [[Settings]] scoped to the currently loaded application(s).\n   * All organization, iTwin, and iModel based containers or settings must be accessed through [[IModelDb.workspace]] and\n   * attempting to add them to this Workspace will fail.\n   * @beta\n   */\n  public static get appWorkspace(): Workspace { return definedInStartup(this._appWorkspace); }\n\n  /** Obtain the [[Workspace]] for an iTwin by discovering its settings containers.\n   * Named dictionary resources from the account iTwin container are loaded at [[SettingsPriority.organization]];\n   * resources from the requested iTwin's container (when different from the account iTwin) are loaded at\n   * [[SettingsPriority.iTwin]].\n   * @note This method requires an internet connection to discover the containers.\n   * To use an iTwin workspace offline, use the overload that accepts [[WorkspaceDbSettingsProps]].\n   * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(iTwinId: GuidString): Promise<OwnedWorkspace>;\n  /** Obtain the [[Workspace]] for an iTwin.\n   * The supplied [[WorkspaceDbSettingsProps]] are passed directly to [[Workspace.loadSettingsDictionary]].\n    * @note You can derive these from the `settingsSources` property on a previously returned workspace.\n    * @note The returned workspace is caller-owned. Call `close` when finished.\n   * @beta\n   */\n  public static async getITwinWorkspace(props: WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace>;\n  /** @internal */\n  public static async getITwinWorkspace(args: GuidString | WorkspaceDbSettingsProps | WorkspaceDbSettingsProps[]): Promise<OwnedWorkspace> {\n    const isITwinId = typeof args === \"string\";\n    const workspace = constructWorkspace(new ITwinWorkspaceSettings());\n\n    try {\n      const settingsSources = isITwinId ? await SettingsContainers.getITwinSettingsSources(args) : args;\n      if (undefined === settingsSources)\n        return workspace;\n\n      workspace.settingsSources = settingsSources;\n\n      const problems: WorkspaceDbLoadError[] = [];\n      await workspace.loadSettingsDictionary(settingsSources, problems);\n\n      if (problems.length > 0) {\n        const label = isITwinId ? `iTwin '${args}'` : \"the supplied settings workspace db properties\";\n        throwWorkspaceDbLoadErrors(`attempting to load workspace settings for ${label}`, problems);\n      }\n\n      return workspace;\n    } catch (error) {\n      workspace.close();\n      throw error;\n    }\n  }\n\n  /** Save a named [[SettingsDictionary]] to the iTwin's settings container.\n   * If no iTwin settings container exists for `iTwinId`, one is created.\n   * The dictionary is stored as a named resource in the container's default [[WorkspaceDb]], where `name` is used as the resource name.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary, used as the resource name in the [[WorkspaceDb]].\n   * @param settings The settings key-value pairs to store.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async saveSettingDictionary(iTwinId: GuidString, name: string, settings: SettingsContainer): Promise<void> {\n    const { editor, container } = await SettingsEditor.constructForITwin(iTwinId);\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.updateSettingsResource(settings, name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** Delete a named [[SettingsDictionary]] from the iTwin's settings container.\n   * If no iTwin settings container exists, this method does nothing.\n   * @param iTwinId The iTwin whose settings container should be updated.\n   * @param name The name of the dictionary (resource name) to delete.\n   * @note uses [[IModelHost.userMoniker]] as the user name for acquiring the write lock on the settings container.\n   * @beta\n   */\n  public static async deleteSettingDictionary(iTwinId: GuidString, name: string): Promise<void> {\n    const settingsEditor = await SettingsEditor.getForITwin(iTwinId);\n    if (undefined === settingsEditor)\n      return;\n\n    const { editor, container } = settingsEditor;\n    try {\n      await container.withEditableDb(this.userMoniker, (db) => {\n        db.removeString(name);\n      }, { dbName: settingsWorkspaceDbName });\n    } finally {\n      editor.close();\n    }\n  }\n\n  /** The registry of schemas describing the [[Setting]]s for the application session.\n   * Applications should register their schemas via methods like [[SettingsSchemas.addGroup]].\n   * @beta\n   */\n  public static get settingsSchemas(): SettingsSchemas { return definedInStartup(this._settingsSchemas); }\n\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels.\n   * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n   */\n  public static snapshotFileNameResolver?: FileNameResolver; // eslint-disable-line @typescript-eslint/no-deprecated\n\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\n   * obtains the token and forwards it to the frontend.\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\n   * returned by this method may change over time throughout the course of a session.\n   */\n  public static async getAccessToken(): Promise<AccessToken> {\n    try {\n      return (await IModelHost.authorizationClient?.getAccessToken()) ?? \"\";\n    } catch {\n      return \"\";\n    }\n  }\n\n  private static loadNative(options: IModelHostOptions) {\n    loadNativePlatform();\n\n    if (options.crashReportingConfig && options.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\n      IModelNative.platform.setCrashReporting(options.crashReportingConfig);\n\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", {\n        enableCrashDumps: options.crashReportingConfig?.enableCrashDumps,\n        wantFullMemoryDumps: options.crashReportingConfig?.wantFullMemoryDumps,\n        enableNodeReport: options.crashReportingConfig?.enableNodeReport,\n        uploadToBentley: options.crashReportingConfig?.uploadToBentley,\n      });\n\n      if (options.crashReportingConfig.enableNodeReport) {\n        if (process.report !== undefined) {\n          process.report.reportOnFatalError = true;\n          process.report.reportOnUncaughtException = true;\n          process.report.directory = options.crashReportingConfig.crashDir;\n          Logger.logTrace(loggerCategory, \"Configured Node.js crash reporting\");\n        } else {\n          Logger.logWarning(loggerCategory, \"Unable to configure Node.js crash reporting\");\n        }\n      }\n    }\n  }\n\n  /** @internal */\n  public static tileStorage?: TileStorage;\n\n  private static _hubAccess?: BackendHubAccess;\n  /** @internal */\n  public static [_setHubAccess](hubAccess: BackendHubAccess | undefined) { this._hubAccess = hubAccess; }\n\n  /** get the current hubAccess, if present.\n   * @internal\n   */\n  public static [_getHubAccess](): BackendHubAccess | undefined { return this._hubAccess; }\n\n  /** Provides access to the IModelHub for this IModelHost\n   * @internal\n   * @note If [[IModelHostOptions.hubAccess]] was undefined when initializing this class, accessing this property will throw an error.\n   * To determine whether one is present, use [[_getHubAccess]].\n   */\n  public static get [_hubAccess](): BackendHubAccess {\n    if (IModelHost._hubAccess === undefined)\n      throw new IModelError(IModelStatus.BadRequest, \"No BackendHubAccess supplied in IModelHostOptions\");\n    return IModelHost._hubAccess;\n  }\n\n  private static initializeWorkspace(configuration: IModelHostOptions) {\n    const settingAssets = join(KnownLocations.packageAssetsDir, \"Settings\");\n    this._settingsSchemas = constructSettingsSchemas();\n    this._settingsSchemas.addDirectory(join(settingAssets, \"Schemas\"));\n    this._appWorkspace = constructWorkspace(new ApplicationSettings(), configuration.workspace);\n\n    // Create the CloudCache for Workspaces. This will fail if another process is already using the same profile.\n    try {\n      this.appWorkspace.getCloudCache();\n    } catch (e: any) {\n      throw (e.errorNumber === DbResult.BE_SQLITE_BUSY) ? new IModelError(DbResult.BE_SQLITE_BUSY, `Profile [${this.profileDir}] is already in use by another process`) : e;\n    }\n\n    this.appWorkspace.settings.addDirectory(settingAssets, SettingsPriority.defaults);\n\n    GeoCoordConfig.onStartup();\n    // allow applications to load their default settings\n    this.onWorkspaceStartup.raiseEvent();\n  }\n\n  private static _isValid = false;\n\n  /** true between a successful call to [[startup]] and before [[shutdown]] */\n  public static get isValid() {\n    return IModelHost._isValid;\n  }\n\n  /** This method must be called before any iTwin.js services are used.\n   * @param options Host configuration data.\n   * Raises [[onAfterStartup]].\n   * @see [[shutdown]].\n   */\n  public static async startup(options?: IModelHostOptions): Promise<void> {\n    if (this._isValid)\n      return; // we're already initialized\n    this._isValid = true;\n\n    options = options ?? {};\n    if (this.sessionId === \"\")\n      this.sessionId = Guid.createValue();\n\n    this.authorizationClient = options.authorizationClient;\n\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-require-imports\n    initializeRpcBackend(options.enableOpenTelemetry);\n\n    this.loadNative(options);\n    this.setupCacheDir(options);\n    this.initializeWorkspace(options);\n    EditTxn.implicitWriteEnforcement = options.implicitWriteEnforcement ?? \"allow\";\n    BriefcaseManager.initialize(join(this._cacheDir, \"imodels\"));\n\n    [\n      IModelReadRpcImpl,\n      IModelTileRpcImpl,\n      SnapshotIModelRpcImpl, // eslint-disable-line @typescript-eslint/no-deprecated\n      DevToolsRpcImpl,\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\n\n    [\n      BisCoreSchema,\n      GenericSchema,\n      FunctionalSchema,\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\n\n    const { hubAccess, ...otherOptions } = options;\n    if (undefined !== hubAccess)\n      this._hubAccess = hubAccess;\n\n    this.configuration = otherOptions;\n    this.setupTileCache();\n\n    process.once(\"beforeExit\", IModelHost.shutdown);\n    this.onAfterStartup.raiseEvent();\n  }\n\n  private static setupCacheDir(configuration: IModelHostOptions) {\n    this._cacheDir = normalizeDir(configuration.cacheDir ?? NativeLibrary.defaultCacheDir);\n    IModelJsFs.recursiveMkDirSync(this._cacheDir);\n\n    this._profileName = configuration.profileName ?? \"default\";\n    Logger.logInfo(loggerCategory, `cacheDir: [${this.cacheDir}], profileDir: [${this.profileDir}]`);\n  }\n\n  /** This method must be called when an iTwin.js host is shut down. Raises [[onBeforeShutdown]] */\n  public static async shutdown(this: void): Promise<void> {\n    // Note: This method is set as a node listener where `this` is unbound. Call private method to\n    // ensure `this` is correct. Don't combine these methods.\n    return IModelHost.doShutdown();\n  }\n\n  /**\n   * Create a new iModel.\n   * @returns the Guid of the newly created iModel.\n   * @throws [IModelError]($common) in case of errors.\n   * @note If [[IModelHostOptions.hubAccess]] was undefined in the call to [[startup]], this function will throw an error.\n   */\n  public static async createNewIModel(arg: CreateNewIModelProps): Promise<GuidString> {\n    return this[_hubAccess].createNewIModel(arg);\n  }\n\n  private static async doShutdown() {\n    if (!this._isValid)\n      return;\n\n    this._isValid = false;\n    this.onBeforeShutdown.raiseEvent();\n\n    this.configuration = undefined;\n    EditTxn.implicitWriteEnforcement = \"allow\";\n    this.tileStorage = undefined;\n\n    this._appWorkspace?.close();\n    this._appWorkspace = undefined;\n    this._settingsSchemas = undefined;\n\n    CloudSqlite.CloudCaches.destroy();\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\n  }\n\n  /**\n   * Add or update a property that should be included in a crash report.\n   * @internal\n   */\n  public static setCrashReportProperty(name: string, value: string): void {\n    IModelNative.platform.setCrashReportProperty(name, value);\n  }\n\n  /**\n   * Remove a previously defined property so that will not be included in a crash report.\n   * @internal\n   */\n  public static removeCrashReportProperty(name: string): void {\n    IModelNative.platform.setCrashReportProperty(name, undefined);\n  }\n\n  /**\n   * Get all properties that will be included in a crash report.\n   * @internal\n   */\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\n    return IModelNative.platform.getCrashReportProperties();\n  }\n\n  /** The directory where application assets may be found */\n  public static get appAssetsDir(): string | undefined {\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined;\n  }\n\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileTreeProps should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileTreeRequestTimeout(): number {\n    return IModelHost.configuration?.tileTreeRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n  /** The time, in milliseconds, for which IModelTileRpcInterface.requestTileContent should wait before returning a \"pending\" status.\n   * @internal\n   */\n  public static get tileContentRequestTimeout(): number {\n    return IModelHost.configuration?.tileContentRequestTimeout ?? IModelHostConfiguration.defaultTileRequestTimeout;\n  }\n\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\n  public static get logTileLoadTimeThreshold(): number {\n    return IModelHost.configuration?.logTileLoadTimeThreshold ?? IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\n  }\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\n  public static get logTileSizeThreshold(): number {\n    return IModelHost.configuration?.logTileSizeThreshold ?? IModelHostConfiguration.defaultLogTileSizeThreshold;\n  }\n\n  /** Whether external tile caching is active.\n   * @internal\n   */\n  public static get usingExternalTileCache(): boolean {\n    return undefined !== IModelHost.tileStorage;\n  }\n\n  /** Whether to restrict tile cache URLs by client IP address.\n   * @internal\n   */\n  public static get restrictTileUrlsByClientIp(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false);\n  }\n\n  /** Whether to compress cached tiles.\n   * @internal\n   */\n  public static get compressCachedTiles(): boolean {\n    return false !== IModelHost.configuration?.compressCachedTiles;\n  }\n\n  /**\n   * Whether to use semantic rebase or not.\n   * @internal\n   */\n  public static get useSemanticRebase(): boolean {\n    return undefined !== IModelHost.configuration && (IModelHost.configuration.useSemanticRebase ? true : false);\n  }\n\n  private static setupTileCache() {\n    assert(undefined !== IModelHost.configuration);\n    const config = IModelHost.configuration;\n    const storage = config.tileCacheStorage;\n    const credentials = config.tileCacheAzureCredentials;\n\n    if (!storage && !credentials) {\n      IModelNative.platform.setMaxTileCacheSize(config.maxTileCacheDbSize ?? IModelHostConfiguration.defaultMaxTileCacheDbSize);\n      return;\n    }\n\n    IModelNative.platform.setMaxTileCacheSize(0);\n    if (credentials) {\n      if (storage)\n        throw new IModelError(BentleyStatus.ERROR, \"Cannot use both Azure and custom cloud storage providers for tile cache.\");\n      this.setupAzureTileCache(credentials);\n    }\n    if (storage)\n      IModelHost.tileStorage = new TileStorage(storage);\n  }\n\n  private static setupAzureTileCache(credentials: AzureBlobStorageCredentials) {\n    const storageConfig: AzureServerStorageConfig = {\n      accountName: credentials.account,\n      accountKey: credentials.accessKey,\n      baseUrl: credentials.baseUrl ?? `https://${credentials.account}.blob.core.windows.net`,\n    }\n    const blobServiceClient = new BlobServiceClient(\n      storageConfig.baseUrl,\n      new StorageSharedKeyCredential(storageConfig.accountName, storageConfig.accountKey),\n    );\n    const azureStorage: ServerStorage = new AzureServerStorage(storageConfig, new BlobServiceClientWrapper(blobServiceClient))\n    IModelHost.tileStorage = new TileStorage(azureStorage);\n  }\n\n  /** @internal */\n  public static computeSchemaChecksum(arg: { schemaXmlPath: string, referencePaths: string[], exactMatch?: boolean }): string {\n    return IModelNative.platform.computeSchemaChecksum(arg);\n  }\n}\n\n/** Information about the platform on which the app is running.\n * @public\n */\nexport class Platform {\n  /** Get the name of the platform. */\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\n    return process.platform as any;\n  }\n}\n\n/** Well known directories that may be used by the application.\n * @public\n */\nexport class KnownLocations {\n\n  /** The directory where the imodeljs-native assets are stored. */\n  public static get nativeAssetsDir(): LocalDirName {\n    return IModelNative.platform.DgnDb.getAssetsDir();\n  }\n\n  /** The directory where the core-backend assets are stored. */\n  public static get packageAssetsDir(): LocalDirName {\n    return join(__dirname, \"assets\");\n  }\n\n  /** The temporary directory. */\n  public static get tmpdir(): LocalDirName {\n    return os.tmpdir();\n  }\n}\n\n/** Extend this class to provide custom file name resolution behavior.\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\n * @see [[IModelHost.snapshotFileNameResolver]]\n * @public\n * @deprecated in 4.10 - might be removed in next major version. When opening a snapshot by file name, ensure to pass already resolved path. Using a key to open a snapshot is now deprecated.\n */\nexport abstract class FileNameResolver {\n  /** Resolve a file name from the specified key.\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name or `undefined` if not found.\n   */\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\n  /** Resolve a file name from the specified key.\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\n   * @returns The resolved file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveKey(fileKey: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\n    }\n    return resolvedFileName;\n  }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name or `undefined` if not found.\n   */\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\n   * @param inFileName The partial file name.\n   * @returns The resolved full path file name.\n   * @throws [[IModelError]] if not found.\n   */\n  public resolveFileName(inFileName: string): string {\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\n    if (undefined === resolvedFileName) {\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\n    }\n    return resolvedFileName;\n  }\n}\n"]}

package/lib/cjs/SQLiteDb.d.ts

@@ -18,7 +18,7 @@ export declare class SQLiteDb {
     /** @internal */
     static createBlobIO(): SQLiteDb.BlobIO;
     /** alias for closeDb.
-     * @deprecated in 4.0 - will not be removed until after 2026-06-13. Use [[closeDb]]
+     * @deprecated in 4.0 - might be removed in next major version. Use [[closeDb]]
      */
     dispose(): void;
     /** Create a SQLiteDb

package/lib/cjs/SQLiteDb.js

@@ -84,7 +84,7 @@ class SQLiteDb {
         return new NativePlatform_1.IModelNative.platform.BlobIO();
     }
     /** alias for closeDb.
-     * @deprecated in 4.0 - will not be removed until after 2026-06-13. Use [[closeDb]]
+     * @deprecated in 4.0 - might be removed in next major version. Use [[closeDb]]
      */
     dispose() {
         this.closeDb();

package/lib/cjs/SQLiteDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\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 SQLiteDb\n */\n\nimport * as fs from \"fs\";\nimport { dirname } from \"path\";\nimport * as semver from \"semver\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { DbResult, OpenMode } from \"@itwin/core-bentley\";\nimport { LocalFileName, SqliteError } from \"@itwin/core-common\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\nimport { _nativeDb } from \"./internal/Symbols\";\n\n// cspell:ignore savepoint julianday rowid\n\n/**\n * A \"generic\" SQLiteDb. This class may be used to access local files or databases in a cloud container.\n * @public\n */\nexport class SQLiteDb {\n  /** @internal */\n  public readonly [_nativeDb] = new IModelNative.platform.SQLiteDb();\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\n\n  /** @internal */\n  public static createBlobIO(): SQLiteDb.BlobIO {\n    return new IModelNative.platform.BlobIO();\n  }\n\n  /** alias for closeDb.\n   * @deprecated in 4.0 - will not be removed until after 2026-06-13. Use [[closeDb]]\n   */\n  public dispose(): void {\n    this.closeDb();\n  }\n\n  /** Create a SQLiteDb\n   * @param dbName The path to the SQLiteDb file to create.\n   */\n  public createDb(dbName: string): void;\n  /** @beta */\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void;\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void {\n    this[_nativeDb].createDb(dbName, container, params);\n  }\n\n  /** Open a SQLiteDb.\n   * @param dbName The path to the SQLiteDb file to open\n   */\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\n  /**\n   * @param container optional CloudContainer holding database\n   * @beta\n   */\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void;\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void {\n    this[_nativeDb].openDb(dbName, openMode, container);\n  }\n\n  /** Close SQLiteDb.\n   * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.\n   */\n  public closeDb(saveChanges?: boolean): void {\n    if (saveChanges && this.isOpen)\n      this.saveChanges();\n    this._sqliteStatementCache.clear();\n    this[_nativeDb].closeDb();\n  }\n\n  /** Returns true if this SQLiteDb is open */\n  public get isOpen(): boolean { return this[_nativeDb].isOpen(); }\n\n  /** Returns true if this SQLiteDb is open readonly */\n  public get isReadonly(): boolean { return this[_nativeDb].isReadonly(); }\n\n  /** Create a new table in this database. */\n  protected createTable(args: {\n    /** The name of the table to create. */\n    tableName: string;\n    /** all of the columns in the table. */\n    columns: string;\n    /** any unique or foreign key constraints */\n    constraints?: string;\n    /** if true, add a \"lastMod\" timestamp column and triggers to automatically update it. */\n    addTimestamp?: boolean;\n  }) {\n    const timestampCol = args.addTimestamp ? \",lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\" : \"\";\n    const constraints = args.constraints ? `,${args.constraints}` : \"\";\n    this.executeSQL(`CREATE TABLE ${args.tableName}(${args.columns}${timestampCol}${constraints})`);\n    if (args.addTimestamp)\n      this.executeSQL(`CREATE TRIGGER ${args.tableName}_timestamp AFTER UPDATE ON ${args.tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${args.tableName} SET lastMod=julianday('now') WHERE rowid=new.rowid; END`);\n  }\n\n  /**\n   * Get the last modified date for a row in a table of this database.\n   * @note the table must have been created with `addTimestamp: true`\n  */\n  public readLastModTime(tableName: string, rowId: number): Date {\n    return this.withSqliteStatement(`SELECT lastMod from ${tableName} WHERE rowid=?`, (stmt) => {\n      stmt.bindInteger(1, rowId);\n      return stmt.getValueDate(0);\n    });\n  }\n\n  /**\n   * Open a database, perform an operation, then close the database.\n   *\n   * Details:\n   * - if database is open, throw an error\n   * - open a database\n   * - call a function with the database opened. If it is async, await its return.\n   * - if function throws, abandon all changes, close database, and rethrow\n   * - save all changes\n   * - close the database\n   * @return value from operation\n   */\n  public withOpenDb<T>(args: SQLiteDb.WithOpenDbArgs, operation: () => T): T {\n    if (this.isOpen)\n      SqliteError.throwError(\"already-open\", \"database is already open\", args.dbName);\n\n    const save = () => this.closeDb(true), abandon = () => this.closeDb(false);\n    this.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\n    try {\n      const result = operation();\n      result instanceof Promise ? result.then(save, abandon) : save();\n      return result;\n    } catch (e) {\n      abandon();\n      throw e;\n    }\n  }\n\n  /** The cloud container backing this SQLite database, if any.\n   * @beta\n   */\n  public get cloudContainer(): CloudSqlite.CloudContainer | undefined {\n    return this[_nativeDb].cloudContainer;\n  }\n\n  /** Returns the Id of the most-recently-inserted row in this database, per [sqlite3_last_insert_rowid](https://www.sqlite.org/c3ref/last_insert_rowid.html). */\n  public getLastInsertRowId(): number {\n    return this[_nativeDb].getLastInsertRowId();\n  }\n\n  /**\n   * Perform an operation on a database in a CloudContainer with the write lock held.\n   *\n   * Details:\n   * - acquire the write lock on a CloudContainer\n   * - call `withOpenDb` with openMode `ReadWrite`\n   * - upload changes\n   * - release the write lock\n   * @param args arguments to lock the container and open the database\n   * @param operation an operation performed on the database with the write lock held.\n   * @return value from operation\n   * @internal\n   */\n  public async withLockedContainer<T>(args: CloudSqlite.LockAndOpenArgs, operation: () => Promise<T>) {\n    return CloudSqlite.withWriteLock(args, async () => this.withOpenDb({ ...args, openMode: args.openMode ?? OpenMode.ReadWrite }, operation));\n  }\n\n  /** vacuum this database\n   * @see https://www.sqlite.org/lang_vacuum.html\n   */\n  public vacuum(args?: SQLiteDb.VacuumDbArgs) {\n    this[_nativeDb].vacuum(args);\n  }\n\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the default transaction. */\n  public saveChanges(): void {\n    this[_nativeDb].saveChanges();\n  }\n\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the default transaction. */\n  public abandonChanges(): void {\n    this[_nativeDb].abandonChanges();\n  }\n\n  /**\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\n   * @param sql The SQLite SQL statement to execute\n   * @param callback the callback to invoke on the prepared statement\n   * @returns the value returned by `callback`.\n   */\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\n    try {\n      const val = callback(stmt);\n      val instanceof Promise ? val.then(release, release) : release();\n      return val;\n    } catch (err) {\n      release();\n      throw err;\n    }\n  }\n\n  /**\n   * Prepare and execute a callback on a SQL statement. After the callback completes the statement is disposed.\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\n   * @param sql The SQLite SQL statement to execute\n   * @param callback the callback to invoke on the prepared statement\n   * @returns the value returned by `callback`.\n   */\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\n    const stmt = this.prepareSqliteStatement(sql);\n    const release = () => stmt[Symbol.dispose]();\n    try {\n      const val = callback(stmt);\n      val instanceof Promise ? val.then(release, release) : release();\n      return val;\n    } catch (err) {\n      release();\n      throw err;\n    }\n  }\n\n  /**\n   * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the\n   * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back\n   * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.\n   */\n  public withSavePoint(savePointName: string, operation: () => void) {\n    if (this.isReadonly)\n      SqliteError.throwError(\"readonly\", \"database is readonly\", this[_nativeDb].getFilePath());\n\n    this.executeSQL(`SAVEPOINT ${savePointName}`);\n    try {\n      operation();\n      this.executeSQL(`RELEASE ${savePointName}`);\n    } catch (e) {\n      this.executeSQL(`ROLLBACK TO ${savePointName}`);\n      throw e;\n    }\n  }\n\n  /** Prepare an SQL statement.\n     * @param sql The SQLite SQL statement to prepare\n     * @param logErrors Determine if errors are logged or not\n     * @internal\n     */\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\n    const stmt = new SqliteStatement(sql);\n    stmt.prepare(this[_nativeDb], logErrors);\n    return stmt;\n  }\n\n  /** execute an SQL statement */\n  public executeSQL(sql: string): DbResult {\n    using stmt = this.prepareSqliteStatement(sql);\n    return stmt.step();\n  }\n}\n\n/**\n * Abstract base class for a SQLite database that has [[SQLiteDb.RequiredVersionRanges]] stored in it.\n * This class provides version checking when the database is opened, to guarantee that a valid version of software is\n * always used for access.\n *\n * Notes:\n *  - This class may be used either to access a local file, or one stored in a cloud container.\n *  - Subclasses must provide a `myVersion` member indicating the version of its software, and implement the `createDDL` member to create its\n * tables.\n * @beta\n */\nexport abstract class VersionedSqliteDb extends SQLiteDb {\n  protected static _versionProps = { namespace: \"SQLiteDb\", name: \"versions\" } as const;\n\n  /** The current semver \"persistence version\" of this class.\n   * @note This value should only be changed when logic in its code is modified in a way that affects the operation of extant copies.\n   * If this value is outside of the range of accepted versions of a to-be-opened VersionedSqliteDb, the operation will fail. In this manner, if\n   * changes are made to the format of a VersionedSqliteDb, or if bug fixes are necessary, the `requiredVersions` property in a VersionedSqliteDb may be updated\n   * and immediately old versions of the package will refuse to open the VersionedSqliteDb, with a message to the user that they need to upgrade their\n   * software. Likewise, if a new version of the package is asked to open an older VersionedSqliteDb that has not been upgraded to the lowest version\n   * supported by it, the user will be informed that they need to upgrade their software.\n   * @note this identifier is independent of versions in `package.json` files.\n  */\n  public abstract myVersion: string;\n\n  /**\n   * Change the \"versions required to open this database\" property stored in this database. After this call,\n   * versions of software that don't meet the supplied ranges will fail.\n   * @param versions the new versions required for reading and writing this database.\n   * @note the database must be opened for write access.\n   */\n  public setRequiredVersions(versions: SQLiteDb.RequiredVersionRanges) {\n    // NOTE: It might look tempting to just stringify the supplied `versions` object, but we only include required members - there may be others.\n    this[_nativeDb].saveFileProperty(VersionedSqliteDb._versionProps, JSON.stringify({ readVersion: versions.readVersion, writeVersion: versions.writeVersion }));\n  }\n\n  /** Get the required version ranges necessary to open this VersionedSqliteDb. */\n  public getRequiredVersions() {\n    const checkIsString = (value: any) => {\n      if (typeof value !== \"string\")\n        SqliteError.throwError(\"invalid-versions-property\", `CloudDb has invalid \"versions\" property`, this[_nativeDb].getFilePath());\n      return value;\n    };\n    const versionJson = checkIsString(this[_nativeDb].queryFileProperty(VersionedSqliteDb._versionProps, true));\n    const versionRanges = JSON.parse(versionJson) as SQLiteDb.RequiredVersionRanges;\n    checkIsString(versionRanges.readVersion);\n    checkIsString(versionRanges.writeVersion);\n    return versionRanges;\n  }\n\n  /**\n   * Implement this method to create all tables for this subclass of `VersionedSqliteDb` when a new database file is created. Called from [[createNewDb]].\n   */\n  protected abstract createDDL(args: any): void;\n\n  /**\n   * Create a new database file for the subclass of VersionedSqliteDb.\n   * @note The required versions are saved as [[myVersion]] or newer for both read and write.\n   */\n  public static createNewDb(fileName: LocalFileName, setupArgs?: any) {\n    const db = new (this as any)() as VersionedSqliteDb; // \"as any\" necessary because VersionedSqliteDb is abstract\n    IModelJsFs.recursiveMkDirSync(dirname(fileName));\n    if (fs.existsSync(fileName))\n      fs.unlinkSync(fileName);\n\n    db.createDb(fileName);\n    db.createDDL(setupArgs);\n    const minVer = `^${db.myVersion}`;\n    db.setRequiredVersions({ readVersion: minVer, writeVersion: minVer });\n    db.closeDb(true);\n  }\n\n  /**\n   * Verify that this version of the software meets the required version range (as appropriate, read or write) stored in the database.\n   * Throws otherwise.\n   */\n  protected verifyVersions() {\n    const versions = this.getRequiredVersions();\n    const isReadonly = this.isReadonly; // so we can tell read/write after the file is closed.\n    const range = isReadonly ? versions.readVersion : versions.writeVersion;\n    if (semver.satisfies(this.myVersion, range))\n      return;\n\n    this.closeDb();\n    const tooNew = semver.gtr(this.myVersion, range);\n    SqliteError.throwError(\"incompatible-version\", `requires ${tooNew ? \"older\" : \"newer\"} version of ${this.constructor.name} for ${isReadonly ? \"read\" : \"write\"}`, this[_nativeDb].getFilePath());\n\n  }\n\n  /**\n   * Open this database and verify that this version of the software meets the required version range (as appropriate, read or write) stored in the database.\n   * Throws otherwise.\n   * @see [[SqliteDb.openDb]] for argument types\n   */\n  public override openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer) {\n    super.openDb(dbName, openMode, container);\n    this.verifyVersions();\n  }\n\n  public async upgradeSchema(arg: { dbName: string, lockContainer?: { container: CloudSqlite.CloudContainer, user: string }, upgradeFn: () => void }) {\n    // can't use \"this\" because it checks for version, which we don't want here\n    return (arg.lockContainer) ?\n      super.withLockedContainer({ dbName: arg.dbName, ...arg.lockContainer }, async () => arg.upgradeFn) :\n      super.withOpenDb({ ...arg, openMode: OpenMode.ReadWrite }, arg.upgradeFn);\n  }\n}\n\n/** @public */\nexport namespace SQLiteDb {\n  /** A semver version range.\n   * @see https://docs.npmjs.com/cli/v6/using-npm/semver\n   */\n  export type VersionRange = string;\n\n  /**\n   * A pair of semver [[SQLiteDb.VersionRange]]s, one for read and one for write, required to access a [[VersionedSqliteDb]].\n   * If the version of the software attempting to read or write the database does not satisfy the range, access is denied.\n   */\n  export interface RequiredVersionRanges {\n    /** a range of acceptable persistence versions for reading from a VersionedSqliteDb. */\n    readonly readVersion: VersionRange;\n    /** a range of acceptable persistence versions for writing to a VersionedSqliteDb. */\n    readonly writeVersion: VersionRange;\n  }\n\n  /** interface for reading and writing to a blob in a SQLiteDb\n   * @internal\n   */\n  export interface BlobIO {\n    /** Close this BlobIO if it is opened.\n       * @note this BlobIO *may* be reused after this call by calling `open` again.\n      */\n    close(): void;\n    /** get the total number of bytes in the blob */\n    getNumBytes(): number;\n    /** @return true if this BlobIO was successfully opened and may be use to read or write the blob */\n    isValid(): boolean;\n    /** Open this BlobIO against a table/row/column in a Db */\n    open(\n      /** The database for the blob */\n      db: IModelJsNative.AnyDb,\n      args: {\n        /** the name of the table for the blob*/\n        tableName: string;\n        /** the name of the column for the blob */\n        columnName: string;\n        /** The rowId of the blob */\n        row: number;\n        /** If true, open this BlobIO for write access */\n        writeable?: boolean;\n      }): void;\n    /** Read from a blob\n       * @returns the contents of the requested byte range\n       */\n    read(args: {\n      /** The number of bytes to read */\n      numBytes: number;\n      /** starting offset within the blob to read */\n      offset: number;\n      /** If present and of sufficient size, use this ArrayBuffer for the value. */\n      blob?: ArrayBuffer;\n    }): Uint8Array;\n    /** Reposition this BlobIO to a new rowId\n       * @note this BlobIO must be valid when this methods is called.\n       */\n    changeRow(row: number): void;\n    /** Write to a blob */\n    write(args: {\n      /** The number of bytes to write  */\n      numBytes: number;\n      /** starting offset within the blob to write */\n      offset: number;\n      /** the value to write */\n      blob: ArrayBuffer;\n    }): void;\n  }\n\n  /** Default transaction mode for SQLiteDbs.\n   * @see https://www.sqlite.org/lang_transaction.html\n   */\n  export enum DefaultTxnMode {\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\n    None = 0,\n    /** A deferred transaction is started when the file is first opened. This is the default. */\n    Deferred = 1,\n    /** An immediate transaction is started when the file is first opened. */\n    Immediate = 2,\n    /** An exclusive transaction is started when the file is first opened. */\n    Exclusive = 3\n  }\n\n  /** parameters common to opening or creating a new SQLiteDb */\n  export interface OpenOrCreateParams {\n    /** If true, do not require that the `be_Prop` table exist */\n    rawSQLite?: boolean;\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\n    immutable?: boolean;\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\n    skipFileCheck?: boolean;\n    /** the default transaction mode\n   * @see [[SQLiteDb.DefaultTxnMode]]\n  */\n    defaultTxn?: 0 | 1 | 2 | 3;\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\n    queryParam?: string;\n  }\n\n  /** Parameters for opening an existing SQLiteDb */\n  export interface OpenParams extends OpenOrCreateParams {\n    /** use OpenMode.ReadWrite to open the file with write access */\n    openMode: OpenMode;\n  }\n\n  /** Size of a SQLiteDb page in bytes */\n  export interface PageSize {\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\n    pageSize?: number;\n  }\n\n  /** Parameters for creating a new SQLiteDb */\n  export type CreateParams = OpenOrCreateParams & PageSize;\n\n  /** Arguments for `SqliteDb.withOpenDb` */\n  export interface WithOpenDbArgs {\n    /** The name of the database to open */\n    dbName: string;\n    /** either an object with the open parameters or just OpenMode value. */\n    openMode?: OpenMode | SQLiteDb.OpenParams;\n    /** @internal */\n    container?: CloudSqlite.CloudContainer;\n  }\n\n  /** Arguments for `SQLiteDb.vacuum` */\n  export interface VacuumDbArgs extends PageSize {\n    /** if present, name of new file to [vacuum into](https://www.sqlite.org/lang_vacuum.html) */\n    into?: LocalFileName;\n  }\n}\n"]}
+{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\n */\n\nimport * as fs from \"fs\";\nimport { dirname } from \"path\";\nimport * as semver from \"semver\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { DbResult, OpenMode } from \"@itwin/core-bentley\";\nimport { LocalFileName, SqliteError } from \"@itwin/core-common\";\nimport { CloudSqlite } from \"./CloudSqlite\";\nimport { IModelNative } from \"./internal/NativePlatform\";\nimport { IModelJsFs } from \"./IModelJsFs\";\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\nimport { _nativeDb } from \"./internal/Symbols\";\n\n// cspell:ignore savepoint julianday rowid\n\n/**\n * A \"generic\" SQLiteDb. This class may be used to access local files or databases in a cloud container.\n * @public\n */\nexport class SQLiteDb {\n  /** @internal */\n  public readonly [_nativeDb] = new IModelNative.platform.SQLiteDb();\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\n\n  /** @internal */\n  public static createBlobIO(): SQLiteDb.BlobIO {\n    return new IModelNative.platform.BlobIO();\n  }\n\n  /** alias for closeDb.\n   * @deprecated in 4.0 - might be removed in next major version. Use [[closeDb]]\n   */\n  public dispose(): void {\n    this.closeDb();\n  }\n\n  /** Create a SQLiteDb\n   * @param dbName The path to the SQLiteDb file to create.\n   */\n  public createDb(dbName: string): void;\n  /** @beta */\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void;\n  public createDb(dbName: string, container?: CloudSqlite.CloudContainer, params?: SQLiteDb.CreateParams): void {\n    this[_nativeDb].createDb(dbName, container, params);\n  }\n\n  /** Open a SQLiteDb.\n   * @param dbName The path to the SQLiteDb file to open\n   */\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\n  /**\n   * @param container optional CloudContainer holding database\n   * @beta\n   */\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void;\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer): void {\n    this[_nativeDb].openDb(dbName, openMode, container);\n  }\n\n  /** Close SQLiteDb.\n   * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.\n   */\n  public closeDb(saveChanges?: boolean): void {\n    if (saveChanges && this.isOpen)\n      this.saveChanges();\n    this._sqliteStatementCache.clear();\n    this[_nativeDb].closeDb();\n  }\n\n  /** Returns true if this SQLiteDb is open */\n  public get isOpen(): boolean { return this[_nativeDb].isOpen(); }\n\n  /** Returns true if this SQLiteDb is open readonly */\n  public get isReadonly(): boolean { return this[_nativeDb].isReadonly(); }\n\n  /** Create a new table in this database. */\n  protected createTable(args: {\n    /** The name of the table to create. */\n    tableName: string;\n    /** all of the columns in the table. */\n    columns: string;\n    /** any unique or foreign key constraints */\n    constraints?: string;\n    /** if true, add a \"lastMod\" timestamp column and triggers to automatically update it. */\n    addTimestamp?: boolean;\n  }) {\n    const timestampCol = args.addTimestamp ? \",lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\" : \"\";\n    const constraints = args.constraints ? `,${args.constraints}` : \"\";\n    this.executeSQL(`CREATE TABLE ${args.tableName}(${args.columns}${timestampCol}${constraints})`);\n    if (args.addTimestamp)\n      this.executeSQL(`CREATE TRIGGER ${args.tableName}_timestamp AFTER UPDATE ON ${args.tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${args.tableName} SET lastMod=julianday('now') WHERE rowid=new.rowid; END`);\n  }\n\n  /**\n   * Get the last modified date for a row in a table of this database.\n   * @note the table must have been created with `addTimestamp: true`\n  */\n  public readLastModTime(tableName: string, rowId: number): Date {\n    return this.withSqliteStatement(`SELECT lastMod from ${tableName} WHERE rowid=?`, (stmt) => {\n      stmt.bindInteger(1, rowId);\n      return stmt.getValueDate(0);\n    });\n  }\n\n  /**\n   * Open a database, perform an operation, then close the database.\n   *\n   * Details:\n   * - if database is open, throw an error\n   * - open a database\n   * - call a function with the database opened. If it is async, await its return.\n   * - if function throws, abandon all changes, close database, and rethrow\n   * - save all changes\n   * - close the database\n   * @return value from operation\n   */\n  public withOpenDb<T>(args: SQLiteDb.WithOpenDbArgs, operation: () => T): T {\n    if (this.isOpen)\n      SqliteError.throwError(\"already-open\", \"database is already open\", args.dbName);\n\n    const save = () => this.closeDb(true), abandon = () => this.closeDb(false);\n    this.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\n    try {\n      const result = operation();\n      result instanceof Promise ? result.then(save, abandon) : save();\n      return result;\n    } catch (e) {\n      abandon();\n      throw e;\n    }\n  }\n\n  /** The cloud container backing this SQLite database, if any.\n   * @beta\n   */\n  public get cloudContainer(): CloudSqlite.CloudContainer | undefined {\n    return this[_nativeDb].cloudContainer;\n  }\n\n  /** Returns the Id of the most-recently-inserted row in this database, per [sqlite3_last_insert_rowid](https://www.sqlite.org/c3ref/last_insert_rowid.html). */\n  public getLastInsertRowId(): number {\n    return this[_nativeDb].getLastInsertRowId();\n  }\n\n  /**\n   * Perform an operation on a database in a CloudContainer with the write lock held.\n   *\n   * Details:\n   * - acquire the write lock on a CloudContainer\n   * - call `withOpenDb` with openMode `ReadWrite`\n   * - upload changes\n   * - release the write lock\n   * @param args arguments to lock the container and open the database\n   * @param operation an operation performed on the database with the write lock held.\n   * @return value from operation\n   * @internal\n   */\n  public async withLockedContainer<T>(args: CloudSqlite.LockAndOpenArgs, operation: () => Promise<T>) {\n    return CloudSqlite.withWriteLock(args, async () => this.withOpenDb({ ...args, openMode: args.openMode ?? OpenMode.ReadWrite }, operation));\n  }\n\n  /** vacuum this database\n   * @see https://www.sqlite.org/lang_vacuum.html\n   */\n  public vacuum(args?: SQLiteDb.VacuumDbArgs) {\n    this[_nativeDb].vacuum(args);\n  }\n\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the default transaction. */\n  public saveChanges(): void {\n    this[_nativeDb].saveChanges();\n  }\n\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the default transaction. */\n  public abandonChanges(): void {\n    this[_nativeDb].abandonChanges();\n  }\n\n  /**\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\n   * @param sql The SQLite SQL statement to execute\n   * @param callback the callback to invoke on the prepared statement\n   * @returns the value returned by `callback`.\n   */\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\n    try {\n      const val = callback(stmt);\n      val instanceof Promise ? val.then(release, release) : release();\n      return val;\n    } catch (err) {\n      release();\n      throw err;\n    }\n  }\n\n  /**\n   * Prepare and execute a callback on a SQL statement. After the callback completes the statement is disposed.\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\n   * @param sql The SQLite SQL statement to execute\n   * @param callback the callback to invoke on the prepared statement\n   * @returns the value returned by `callback`.\n   */\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\n    const stmt = this.prepareSqliteStatement(sql);\n    const release = () => stmt[Symbol.dispose]();\n    try {\n      const val = callback(stmt);\n      val instanceof Promise ? val.then(release, release) : release();\n      return val;\n    } catch (err) {\n      release();\n      throw err;\n    }\n  }\n\n  /**\n   * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the\n   * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back\n   * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.\n   */\n  public withSavePoint(savePointName: string, operation: () => void) {\n    if (this.isReadonly)\n      SqliteError.throwError(\"readonly\", \"database is readonly\", this[_nativeDb].getFilePath());\n\n    this.executeSQL(`SAVEPOINT ${savePointName}`);\n    try {\n      operation();\n      this.executeSQL(`RELEASE ${savePointName}`);\n    } catch (e) {\n      this.executeSQL(`ROLLBACK TO ${savePointName}`);\n      throw e;\n    }\n  }\n\n  /** Prepare an SQL statement.\n     * @param sql The SQLite SQL statement to prepare\n     * @param logErrors Determine if errors are logged or not\n     * @internal\n     */\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\n    const stmt = new SqliteStatement(sql);\n    stmt.prepare(this[_nativeDb], logErrors);\n    return stmt;\n  }\n\n  /** execute an SQL statement */\n  public executeSQL(sql: string): DbResult {\n    using stmt = this.prepareSqliteStatement(sql);\n    return stmt.step();\n  }\n}\n\n/**\n * Abstract base class for a SQLite database that has [[SQLiteDb.RequiredVersionRanges]] stored in it.\n * This class provides version checking when the database is opened, to guarantee that a valid version of software is\n * always used for access.\n *\n * Notes:\n *  - This class may be used either to access a local file, or one stored in a cloud container.\n *  - Subclasses must provide a `myVersion` member indicating the version of its software, and implement the `createDDL` member to create its\n * tables.\n * @beta\n */\nexport abstract class VersionedSqliteDb extends SQLiteDb {\n  protected static _versionProps = { namespace: \"SQLiteDb\", name: \"versions\" } as const;\n\n  /** The current semver \"persistence version\" of this class.\n   * @note This value should only be changed when logic in its code is modified in a way that affects the operation of extant copies.\n   * If this value is outside of the range of accepted versions of a to-be-opened VersionedSqliteDb, the operation will fail. In this manner, if\n   * changes are made to the format of a VersionedSqliteDb, or if bug fixes are necessary, the `requiredVersions` property in a VersionedSqliteDb may be updated\n   * and immediately old versions of the package will refuse to open the VersionedSqliteDb, with a message to the user that they need to upgrade their\n   * software. Likewise, if a new version of the package is asked to open an older VersionedSqliteDb that has not been upgraded to the lowest version\n   * supported by it, the user will be informed that they need to upgrade their software.\n   * @note this identifier is independent of versions in `package.json` files.\n  */\n  public abstract myVersion: string;\n\n  /**\n   * Change the \"versions required to open this database\" property stored in this database. After this call,\n   * versions of software that don't meet the supplied ranges will fail.\n   * @param versions the new versions required for reading and writing this database.\n   * @note the database must be opened for write access.\n   */\n  public setRequiredVersions(versions: SQLiteDb.RequiredVersionRanges) {\n    // NOTE: It might look tempting to just stringify the supplied `versions` object, but we only include required members - there may be others.\n    this[_nativeDb].saveFileProperty(VersionedSqliteDb._versionProps, JSON.stringify({ readVersion: versions.readVersion, writeVersion: versions.writeVersion }));\n  }\n\n  /** Get the required version ranges necessary to open this VersionedSqliteDb. */\n  public getRequiredVersions() {\n    const checkIsString = (value: any) => {\n      if (typeof value !== \"string\")\n        SqliteError.throwError(\"invalid-versions-property\", `CloudDb has invalid \"versions\" property`, this[_nativeDb].getFilePath());\n      return value;\n    };\n    const versionJson = checkIsString(this[_nativeDb].queryFileProperty(VersionedSqliteDb._versionProps, true));\n    const versionRanges = JSON.parse(versionJson) as SQLiteDb.RequiredVersionRanges;\n    checkIsString(versionRanges.readVersion);\n    checkIsString(versionRanges.writeVersion);\n    return versionRanges;\n  }\n\n  /**\n   * Implement this method to create all tables for this subclass of `VersionedSqliteDb` when a new database file is created. Called from [[createNewDb]].\n   */\n  protected abstract createDDL(args: any): void;\n\n  /**\n   * Create a new database file for the subclass of VersionedSqliteDb.\n   * @note The required versions are saved as [[myVersion]] or newer for both read and write.\n   */\n  public static createNewDb(fileName: LocalFileName, setupArgs?: any) {\n    const db = new (this as any)() as VersionedSqliteDb; // \"as any\" necessary because VersionedSqliteDb is abstract\n    IModelJsFs.recursiveMkDirSync(dirname(fileName));\n    if (fs.existsSync(fileName))\n      fs.unlinkSync(fileName);\n\n    db.createDb(fileName);\n    db.createDDL(setupArgs);\n    const minVer = `^${db.myVersion}`;\n    db.setRequiredVersions({ readVersion: minVer, writeVersion: minVer });\n    db.closeDb(true);\n  }\n\n  /**\n   * Verify that this version of the software meets the required version range (as appropriate, read or write) stored in the database.\n   * Throws otherwise.\n   */\n  protected verifyVersions() {\n    const versions = this.getRequiredVersions();\n    const isReadonly = this.isReadonly; // so we can tell read/write after the file is closed.\n    const range = isReadonly ? versions.readVersion : versions.writeVersion;\n    if (semver.satisfies(this.myVersion, range))\n      return;\n\n    this.closeDb();\n    const tooNew = semver.gtr(this.myVersion, range);\n    SqliteError.throwError(\"incompatible-version\", `requires ${tooNew ? \"older\" : \"newer\"} version of ${this.constructor.name} for ${isReadonly ? \"read\" : \"write\"}`, this[_nativeDb].getFilePath());\n\n  }\n\n  /**\n   * Open this database and verify that this version of the software meets the required version range (as appropriate, read or write) stored in the database.\n   * Throws otherwise.\n   * @see [[SqliteDb.openDb]] for argument types\n   */\n  public override openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: CloudSqlite.CloudContainer) {\n    super.openDb(dbName, openMode, container);\n    this.verifyVersions();\n  }\n\n  public async upgradeSchema(arg: { dbName: string, lockContainer?: { container: CloudSqlite.CloudContainer, user: string }, upgradeFn: () => void }) {\n    // can't use \"this\" because it checks for version, which we don't want here\n    return (arg.lockContainer) ?\n      super.withLockedContainer({ dbName: arg.dbName, ...arg.lockContainer }, async () => arg.upgradeFn) :\n      super.withOpenDb({ ...arg, openMode: OpenMode.ReadWrite }, arg.upgradeFn);\n  }\n}\n\n/** @public */\nexport namespace SQLiteDb {\n  /** A semver version range.\n   * @see https://docs.npmjs.com/cli/v6/using-npm/semver\n   */\n  export type VersionRange = string;\n\n  /**\n   * A pair of semver [[SQLiteDb.VersionRange]]s, one for read and one for write, required to access a [[VersionedSqliteDb]].\n   * If the version of the software attempting to read or write the database does not satisfy the range, access is denied.\n   */\n  export interface RequiredVersionRanges {\n    /** a range of acceptable persistence versions for reading from a VersionedSqliteDb. */\n    readonly readVersion: VersionRange;\n    /** a range of acceptable persistence versions for writing to a VersionedSqliteDb. */\n    readonly writeVersion: VersionRange;\n  }\n\n  /** interface for reading and writing to a blob in a SQLiteDb\n   * @internal\n   */\n  export interface BlobIO {\n    /** Close this BlobIO if it is opened.\n       * @note this BlobIO *may* be reused after this call by calling `open` again.\n      */\n    close(): void;\n    /** get the total number of bytes in the blob */\n    getNumBytes(): number;\n    /** @return true if this BlobIO was successfully opened and may be use to read or write the blob */\n    isValid(): boolean;\n    /** Open this BlobIO against a table/row/column in a Db */\n    open(\n      /** The database for the blob */\n      db: IModelJsNative.AnyDb,\n      args: {\n        /** the name of the table for the blob*/\n        tableName: string;\n        /** the name of the column for the blob */\n        columnName: string;\n        /** The rowId of the blob */\n        row: number;\n        /** If true, open this BlobIO for write access */\n        writeable?: boolean;\n      }): void;\n    /** Read from a blob\n       * @returns the contents of the requested byte range\n       */\n    read(args: {\n      /** The number of bytes to read */\n      numBytes: number;\n      /** starting offset within the blob to read */\n      offset: number;\n      /** If present and of sufficient size, use this ArrayBuffer for the value. */\n      blob?: ArrayBuffer;\n    }): Uint8Array;\n    /** Reposition this BlobIO to a new rowId\n       * @note this BlobIO must be valid when this methods is called.\n       */\n    changeRow(row: number): void;\n    /** Write to a blob */\n    write(args: {\n      /** The number of bytes to write  */\n      numBytes: number;\n      /** starting offset within the blob to write */\n      offset: number;\n      /** the value to write */\n      blob: ArrayBuffer;\n    }): void;\n  }\n\n  /** Default transaction mode for SQLiteDbs.\n   * @see https://www.sqlite.org/lang_transaction.html\n   */\n  export enum DefaultTxnMode {\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\n    None = 0,\n    /** A deferred transaction is started when the file is first opened. This is the default. */\n    Deferred = 1,\n    /** An immediate transaction is started when the file is first opened. */\n    Immediate = 2,\n    /** An exclusive transaction is started when the file is first opened. */\n    Exclusive = 3\n  }\n\n  /** parameters common to opening or creating a new SQLiteDb */\n  export interface OpenOrCreateParams {\n    /** If true, do not require that the `be_Prop` table exist */\n    rawSQLite?: boolean;\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\n    immutable?: boolean;\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\n    skipFileCheck?: boolean;\n    /** the default transaction mode\n   * @see [[SQLiteDb.DefaultTxnMode]]\n  */\n    defaultTxn?: 0 | 1 | 2 | 3;\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\n    queryParam?: string;\n  }\n\n  /** Parameters for opening an existing SQLiteDb */\n  export interface OpenParams extends OpenOrCreateParams {\n    /** use OpenMode.ReadWrite to open the file with write access */\n    openMode: OpenMode;\n  }\n\n  /** Size of a SQLiteDb page in bytes */\n  export interface PageSize {\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\n    pageSize?: number;\n  }\n\n  /** Parameters for creating a new SQLiteDb */\n  export type CreateParams = OpenOrCreateParams & PageSize;\n\n  /** Arguments for `SqliteDb.withOpenDb` */\n  export interface WithOpenDbArgs {\n    /** The name of the database to open */\n    dbName: string;\n    /** either an object with the open parameters or just OpenMode value. */\n    openMode?: OpenMode | SQLiteDb.OpenParams;\n    /** @internal */\n    container?: CloudSqlite.CloudContainer;\n  }\n\n  /** Arguments for `SQLiteDb.vacuum` */\n  export interface VacuumDbArgs extends PageSize {\n    /** if present, name of new file to [vacuum into](https://www.sqlite.org/lang_vacuum.html) */\n    into?: LocalFileName;\n  }\n}\n"]}

package/lib/cjs/SqliteStatement.d.ts

@@ -63,7 +63,7 @@ export declare class SqliteStatement implements IterableIterator<any>, Disposabl
     reset(): void;
     /** Call this function when finished with this statement. This releases the native resources held by the statement. */
     [Symbol.dispose](): void;
-    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */
     dispose(): void;
     /**
      * Call `step` on this statement and determine whether a new row is available.