@itwin/core-backend 4.8.0-dev.3 → 4.8.0-dev.32

package/lib/cjs/Model.js

@@ -15,13 +15,13 @@ const core_common_1 = require("@itwin/core-common");
 const Element_1 = require("./Element");
 const Entity_1 = require("./Entity");
 const NavigationRelationship_1 = require("./NavigationRelationship");
+const Symbols_1 = require("./internal/Symbols");
 /** A Model is a container for persisting a collection of related elements within an iModel.
  * See [[IModelDb.Models]] for how to query and manage the Models in an IModelDb.
  * See [Creating models]($docs/learning/backend/CreateModels.md)
  * @public
  */
 class Model extends Entity_1.Entity {
-    /** @internal */
     static get className() { return "Model"; }
     /** @internal */
     static get protectedOperations() { return ["onInsert", "onUpdate", "onDelete"]; }
@@ -45,7 +45,7 @@ class Model extends Entity_1.Entity {
      */
     static onInsert(arg) {
         const { props, iModel } = arg;
-        iModel.channels.verifyChannel(props.modeledElement.id);
+        iModel.channels[Symbols_1._verifyChannel](props.modeledElement.id);
         if (props.parentModel) // inserting requires shared lock on parent, if present
             iModel.locks.checkSharedLock(props.parentModel, "parent model", "insert");
     }
@@ -65,7 +65,7 @@ class Model extends Entity_1.Entity {
      */
     static onUpdate(arg) {
         const id = arg.props.id; // eslint-disable-line @typescript-eslint/no-non-null-assertion
-        arg.iModel.channels.verifyChannel(id);
+        arg.iModel.channels[Symbols_1._verifyChannel](id);
         arg.iModel.locks.checkExclusiveLock(id, "model", "update");
     }
     /** Called after a Model is updated.
@@ -82,7 +82,7 @@ class Model extends Entity_1.Entity {
      * @beta
      */
     static onDelete(arg) {
-        arg.iModel.channels.verifyChannel(arg.id);
+        arg.iModel.channels[Symbols_1._verifyChannel](arg.id);
         arg.iModel.locks.checkExclusiveLock(arg.id, "model", "delete");
     }
     /** Called after a Model was deleted.
@@ -161,14 +161,13 @@ exports.Model = Model;
  * @public
  */
 class GeometricModel extends Model {
-    /** @internal */
     static get className() { return "GeometricModel"; }
     constructor(props, iModel) { super(props, iModel); }
     /** Query for the union of the extents of the elements contained by this model.
      * @note This function blocks the JavaScript event loop. Consider using [[queryRange]] instead.
      */
     queryExtents() {
-        const extents = this.iModel.nativeDb.queryModelExtents({ id: this.id }).modelExtents;
+        const extents = this.iModel[Symbols_1._nativeDb].queryModelExtents({ id: this.id }).modelExtents;
         return core_geometry_1.Range3d.fromJSON(extents);
     }
     /** Query for the union of the extents of all elements contained within this model. */
@@ -183,7 +182,6 @@ exports.GeometricModel = GeometricModel;
 class GeometricModel3d extends GeometricModel {
     /** If true, then the elements in this GeometricModel3d are in real-world coordinates and will be in the spatial index. */
     get isSpatiallyLocated() { return !this.isNotSpatiallyLocated; }
-    /** @internal */
     static get className() { return "GeometricModel3d"; }
     constructor(props, iModel) {
         super(props, iModel);
@@ -204,7 +202,6 @@ exports.GeometricModel3d = GeometricModel3d;
  * @public
  */
 class GeometricModel2d extends GeometricModel {
-    /** @internal */
     static get className() { return "GeometricModel2d"; }
     constructor(props, iModel) { super(props, iModel); }
     toJSON() {
@@ -219,7 +216,6 @@ exports.GeometricModel2d = GeometricModel2d;
  * @public
  */
 class GraphicalModel2d extends GeometricModel2d {
-    /** @internal */
     static get className() { return "GraphicalModel2d"; }
 }
 exports.GraphicalModel2d = GraphicalModel2d;
@@ -229,7 +225,6 @@ exports.GraphicalModel2d = GraphicalModel2d;
  * @public
  */
 class GraphicalModel3d extends GeometricModel3d {
-    /** @internal */
     static get className() { return "GraphicalModel3d"; }
 }
 exports.GraphicalModel3d = GraphicalModel3d;
@@ -237,7 +232,6 @@ exports.GraphicalModel3d = GraphicalModel3d;
  * @public
  */
 class SpatialModel extends GeometricModel3d {
-    /** @internal */
     static get className() { return "SpatialModel"; }
 }
 exports.SpatialModel = SpatialModel;
@@ -246,7 +240,6 @@ exports.SpatialModel = SpatialModel;
  * @public
  */
 class PhysicalModel extends SpatialModel {
-    /** @internal */
     static get className() { return "PhysicalModel"; }
     /** Insert a PhysicalPartition and a PhysicalModel that sub-models it.
      * @param iModelDb Insert into this iModel
@@ -278,7 +271,6 @@ exports.PhysicalModel = PhysicalModel;
  * @public
  */
 class SpatialLocationModel extends SpatialModel {
-    /** @internal */
     static get className() { return "SpatialLocationModel"; }
     /** Insert a SpatialLocationPartition and a SpatialLocationModel that sub-models it.
      * @param iModelDb Insert into this iModel
@@ -309,7 +301,6 @@ exports.SpatialLocationModel = SpatialLocationModel;
  * @public
  */
 class DrawingModel extends GraphicalModel2d {
-    /** @internal */
     static get className() { return "DrawingModel"; }
 }
 exports.DrawingModel = DrawingModel;
@@ -317,7 +308,6 @@ exports.DrawingModel = DrawingModel;
  * @public
  */
 class SectionDrawingModel extends DrawingModel {
-    /** @internal */
     static get className() { return "SectionDrawingModel"; }
 }
 exports.SectionDrawingModel = SectionDrawingModel;
@@ -327,7 +317,6 @@ exports.SectionDrawingModel = SectionDrawingModel;
  * @public
  */
 class SheetModel extends GraphicalModel2d {
-    /** @internal */
     static get className() { return "SheetModel"; }
 }
 exports.SheetModel = SheetModel;
@@ -335,7 +324,6 @@ exports.SheetModel = SheetModel;
  * @public
  */
 class RoleModel extends Model {
-    /** @internal */
     static get className() { return "RoleModel"; }
 }
 exports.RoleModel = RoleModel;
@@ -343,7 +331,6 @@ exports.RoleModel = RoleModel;
  * @public
  */
 class InformationModel extends Model {
-    /** @internal */
     static get className() { return "InformationModel"; }
 }
 exports.InformationModel = InformationModel;
@@ -352,7 +339,6 @@ exports.InformationModel = InformationModel;
  * @public
  */
 class GroupInformationModel extends InformationModel {
-    /** @internal */
     static get className() { return "GroupInformationModel"; }
 }
 exports.GroupInformationModel = GroupInformationModel;
@@ -361,7 +347,6 @@ exports.GroupInformationModel = GroupInformationModel;
  * @public
  */
 class InformationRecordModel extends InformationModel {
-    /** @internal */
     static get className() { return "InformationRecordModel"; }
     /** Insert a InformationRecordPartition and a InformationRecordModel that sub-models it.
      * @param iModelDb Insert into this iModel
@@ -390,7 +375,6 @@ exports.InformationRecordModel = InformationRecordModel;
  * @public
  */
 class DefinitionModel extends InformationModel {
-    /** @internal */
     static get className() { return "DefinitionModel"; }
     /** Insert a DefinitionPartition and a DefinitionModel that sub-models it.
      * @param iModelDb Insert into this iModel
@@ -418,7 +402,6 @@ exports.DefinitionModel = DefinitionModel;
  * @public
  */
 class RepositoryModel extends DefinitionModel {
-    /** @internal */
     static get className() { return "RepositoryModel"; }
 }
 exports.RepositoryModel = RepositoryModel;
@@ -427,7 +410,6 @@ exports.RepositoryModel = RepositoryModel;
  * @public
  */
 class DocumentListModel extends InformationModel {
-    /** @internal */
     static get className() { return "DocumentListModel"; }
     /** Insert a DocumentPartition and a DocumentListModel that sub-models it.
      * @param iModelDb Insert into this iModel
@@ -456,7 +438,6 @@ exports.DocumentListModel = DocumentListModel;
  * @public
  */
 class LinkModel extends InformationModel {
-    /** @internal */
     static get className() { return "LinkModel"; }
 }
 exports.LinkModel = LinkModel;
@@ -464,7 +445,6 @@ exports.LinkModel = LinkModel;
  * @public
  */
 class DictionaryModel extends DefinitionModel {
-    /** @internal */
     static get className() { return "DictionaryModel"; }
 }
 exports.DictionaryModel = DictionaryModel;
@@ -472,7 +452,6 @@ exports.DictionaryModel = DictionaryModel;
  * @public
  */
 class WebMercatorModel extends SpatialModel {
-    /** @internal */
     static get className() { return "WebMercatorModel"; }
 }
 exports.WebMercatorModel = WebMercatorModel;

package/lib/cjs/Model.js.map

@@ -1 +1 @@
-{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../src/Model.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Models\r\n */\r\n\r\n// cspell:ignore elid\r\n\r\nimport { GuidString, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Point2d, Range3d } from \"@itwin/core-geometry\";\r\nimport {\r\n  AxisAlignedBox3d, ElementProps, EntityReferenceSet, GeometricModel2dProps, GeometricModel3dProps, GeometricModelProps, IModel,\r\n  InformationPartitionElementProps, ModelProps, RelatedElement,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionPartition, DocumentPartition, InformationRecordPartition, PhysicalPartition, SpatialLocationPartition } from \"./Element\";\r\nimport { Entity } from \"./Entity\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { SubjectOwnsPartitionElements } from \"./NavigationRelationship\";\r\n\r\n/** Argument for the `Model.onXxx` static methods\r\n * @beta\r\n */\r\nexport interface OnModelArg {\r\n  /** The iModel for the Model affected. */\r\n  iModel: IModelDb;\r\n}\r\n\r\n/** Argument for the `Model.onXxx` static methods that supply the properties of a Model to be inserted or updated.\r\n * @beta\r\n */\r\nexport interface OnModelPropsArg extends OnModelArg {\r\n  /** The new properties of the Model affected. */\r\n  props: Readonly<ModelProps>;\r\n}\r\n\r\n/** Argument for the `Model.onXxx` static methods that only supply the Id of the affected Model.\r\n * @beta\r\n */\r\nexport interface OnModelIdArg extends OnModelArg {\r\n  /** The Id of the Model affected */\r\n  id: Id64String;\r\n}\r\n\r\n/** Argument for the `Model.onXxxElement` static methods that supply the properties of an Element for a Model.\r\n * @beta\r\n */\r\nexport interface OnElementInModelPropsArg extends OnModelIdArg {\r\n  /** The new properties of an Element for the affected Model */\r\n  elementProps: Readonly<ElementProps>;\r\n}\r\n\r\n/** Argument for the `Model.onXxxElement` static methods that supply the Id of an Element for a Model.\r\n * @beta\r\n */\r\nexport interface OnElementInModelIdArg extends OnModelIdArg {\r\n  /** The Id of the Element for the affected Model */\r\n  elementId: Id64String;\r\n}\r\n\r\n/** A Model is a container for persisting a collection of related elements within an iModel.\r\n * See [[IModelDb.Models]] for how to query and manage the Models in an IModelDb.\r\n * See [Creating models]($docs/learning/backend/CreateModels.md)\r\n * @public\r\n */\r\nexport class Model extends Entity {\r\n  /** @internal */\r\n  public static override get className(): string { return \"Model\"; }\r\n  /** @internal */\r\n  public static override get protectedOperations() { return [\"onInsert\", \"onUpdate\", \"onDelete\"]; }\r\n  public readonly modeledElement!: RelatedElement;\r\n  public readonly name: string;\r\n  public readonly parentModel!: Id64String;\r\n  public readonly jsonProperties: { [key: string]: any };\r\n  public isPrivate: boolean;\r\n  public isTemplate: boolean;\r\n\r\n  protected constructor(props: ModelProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.name = props.name ? props.name : \"\"; // NB this isn't really a property of Model (it's the code.value of the modeled element), but it comes in ModelProps because it's often needed\r\n    this.isPrivate = JsonUtils.asBool(props.isPrivate);\r\n    this.isTemplate = JsonUtils.asBool(props.isTemplate);\r\n    this.jsonProperties = { ...props.jsonProperties }; // make sure we have our own copy\r\n  }\r\n\r\n  public override toJSON(): ModelProps {\r\n    const val = super.toJSON() as ModelProps;\r\n    val.name = this.name; // for cloning\r\n    return val;\r\n  }\r\n\r\n  /** Called before a new Model is inserted.\r\n   * @note throw an exception to disallow the insert\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be inserted\r\n   * @beta\r\n   */\r\n  protected static onInsert(arg: OnModelPropsArg): void {\r\n    const { props, iModel } = arg;\r\n    iModel.channels.verifyChannel(props.modeledElement.id);\r\n    if (props.parentModel)   // inserting requires shared lock on parent, if present\r\n      iModel.locks.checkSharedLock(props.parentModel, \"parent model\", \"insert\");\r\n  }\r\n\r\n  /** Called after a new Model is inserted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was inserted\r\n   * @beta\r\n   */\r\n  protected static onInserted(_arg: OnModelIdArg): void {\r\n    // we don't need to tell LockControl about models being created - their ModeledElement does that\r\n  }\r\n\r\n  /** Called before a Model is updated.\r\n   * @note throw an exception to disallow the update\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be updated\r\n   * @beta\r\n   */\r\n  protected static onUpdate(arg: OnModelPropsArg): void {\r\n    const id = arg.props.id!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n    arg.iModel.channels.verifyChannel(id);\r\n    arg.iModel.locks.checkExclusiveLock(id, \"model\", \"update\");\r\n  }\r\n\r\n  /** Called after a Model is updated.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was updated.\r\n   * @beta\r\n   */\r\n  protected static onUpdated(_arg: OnModelIdArg): void {\r\n  }\r\n\r\n  /** Called before a Model is deleted.\r\n   * @note throw an exception to disallow the delete\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be deleted\r\n   * @beta\r\n   */\r\n  protected static onDelete(arg: OnModelIdArg): void {\r\n    arg.iModel.channels.verifyChannel(arg.id);\r\n    arg.iModel.locks.checkExclusiveLock(arg.id, \"model\", \"delete\");\r\n  }\r\n\r\n  /** Called after a Model was deleted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was deleted\r\n   * @beta\r\n   */\r\n  protected static onDeleted(_arg: OnModelIdArg): void { }\r\n\r\n  /** Called before a prospective Element is to be inserted into an instance of a Model of this class.\r\n   * @note throw an exception to disallow the insert\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to hold the element\r\n   * @beta\r\n   */\r\n  protected static onInsertElement(_arg: OnElementInModelPropsArg): void { }\r\n\r\n  /** Called after an Element has been inserted into an instance of a Model of this class.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onInsertedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called when an Element in an instance of a Model of this class is about to be updated.\r\n   * @note throw an exception to disallow the update\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onUpdateElement(_arg: OnElementInModelPropsArg): void { }\r\n\r\n  /** Called after an Element in an instance of a Model of this class has been updated.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onUpdatedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called when an Element in an instance of a Model of this class is about to be deleted.\r\n   * @note throw an exception to disallow the delete\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onDeleteElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called after an Element in an instance of a Model of this class has been deleted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that held the element\r\n   * @beta\r\n   */\r\n  protected static onDeletedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  private getAllUserProperties(): any {\r\n    if (!this.jsonProperties.UserProps)\r\n      this.jsonProperties.UserProps = new Object();\r\n\r\n    return this.jsonProperties.UserProps;\r\n  }\r\n\r\n  /** Get a set of JSON user properties by namespace */\r\n  public getUserProperties(namespace: string) { return this.getAllUserProperties()[namespace]; }\r\n\r\n  /** Change a set of user JSON properties of this Element by namespace. */\r\n  public setUserProperties(nameSpace: string, value: any) { this.getAllUserProperties()[nameSpace] = value; }\r\n\r\n  /** Remove a set of JSON user properties, specified by namespace, from this Element */\r\n  public removeUserProperties(nameSpace: string) { delete this.getAllUserProperties()[nameSpace]; }\r\n\r\n  public getJsonProperty(name: string): any { return this.jsonProperties[name]; }\r\n  public setJsonProperty(name: string, value: any) { this.jsonProperties[name] = value; }\r\n\r\n  /** Insert this Model in the iModel */\r\n  public insert() { return this.id = this.iModel.models.insertModel(this.toJSON()); }\r\n  /** Update this Model in the iModel. */\r\n  public update() { this.iModel.models.updateModel(this.toJSON()); }\r\n  /** Delete this Model from the iModel. */\r\n  public delete() { this.iModel.models.deleteModel(this.id); }\r\n\r\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceIds(referenceIds);\r\n    if (this.parentModel)\r\n      referenceIds.addModel(this.parentModel);\r\n    referenceIds.addElement(this.modeledElement.id);\r\n  }\r\n}\r\n\r\n/** A container for persisting geometric elements.\r\n * @public\r\n */\r\nexport class GeometricModel extends Model {\r\n  public geometryGuid?: GuidString; // Initialized by the Entity constructor\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"GeometricModel\"; }\r\n\r\n  protected constructor(props: GeometricModelProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Query for the union of the extents of the elements contained by this model.\r\n   * @note This function blocks the JavaScript event loop. Consider using [[queryRange]] instead.\r\n   */\r\n  public queryExtents(): AxisAlignedBox3d {\r\n    const extents = this.iModel.nativeDb.queryModelExtents({ id: this.id }).modelExtents;\r\n    return Range3d.fromJSON(extents);\r\n  }\r\n\r\n  /** Query for the union of the extents of all elements contained within this model. */\r\n  public async queryRange(): Promise<AxisAlignedBox3d> {\r\n    return this.iModel.models.queryRange(this.id);\r\n  }\r\n}\r\n\r\n/** A container for persisting 3d geometric elements.\r\n * @public\r\n */\r\nexport abstract class GeometricModel3d extends GeometricModel {\r\n  /** If true, then the elements in this GeometricModel3d are expected to be in an XY plane.\r\n   * @note The associated ECProperty was added to the BisCore schema in version 1.0.8\r\n   */\r\n  public readonly isPlanProjection: boolean;\r\n  /** If true, then the elements in this GeometricModel3d are not in real-world coordinates and will not be in the spatial index.\r\n   * @note The associated ECProperty was added to the BisCore schema in version 1.0.8\r\n   */\r\n  public readonly isNotSpatiallyLocated: boolean;\r\n  /** If true, then the elements in this GeometricModel3d are in real-world coordinates and will be in the spatial index. */\r\n  public get isSpatiallyLocated(): boolean { return !this.isNotSpatiallyLocated; }\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"GeometricModel3d\"; }\r\n\r\n  protected constructor(props: GeometricModel3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.isNotSpatiallyLocated = JsonUtils.asBool(props.isNotSpatiallyLocated);\r\n    this.isPlanProjection = JsonUtils.asBool(props.isPlanProjection);\r\n  }\r\n\r\n  public override toJSON(): GeometricModel3dProps {\r\n    const val = super.toJSON() as GeometricModel3dProps;\r\n    if (this.isNotSpatiallyLocated)\r\n      val.isNotSpatiallyLocated = true;\r\n\r\n    if (this.isPlanProjection)\r\n      val.isPlanProjection = true;\r\n\r\n    return val;\r\n  }\r\n}\r\n\r\n/** A container for persisting 2d geometric elements.\r\n * @public\r\n */\r\nexport abstract class GeometricModel2d extends GeometricModel {\r\n  /** The actual coordinates of (0,0) in modeling coordinates. An offset applied to all modeling coordinates. */\r\n  public globalOrigin?: Point2d; // Initialized by the Entity constructor\r\n  /** @internal */\r\n  public static override get className(): string { return \"GeometricModel2d\"; }\r\n\r\n  protected constructor(props: GeometricModel2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  public override toJSON(): GeometricModel2dProps {\r\n    const val = super.toJSON() as GeometricModel2dProps;\r\n    if (undefined !== this.globalOrigin)\r\n      val.globalOrigin = Point2d.fromJSON(this.globalOrigin);\r\n\r\n    return val;\r\n  }\r\n}\r\n\r\n/** A container for persisting 2d graphical elements.\r\n * @public\r\n */\r\nexport abstract class GraphicalModel2d extends GeometricModel2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"GraphicalModel2d\"; }\r\n}\r\n\r\n/** A container for persisting GraphicalElement3d instances.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.8\r\n * @see [[GraphicalPartition3d]]\r\n * @public\r\n */\r\nexport abstract class GraphicalModel3d extends GeometricModel3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"GraphicalModel3d\"; }\r\n}\r\n\r\n/** A container for persisting 3d geometric elements that are spatially located.\r\n * @public\r\n */\r\nexport abstract class SpatialModel extends GeometricModel3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialModel\"; }\r\n}\r\n\r\n/** A container for persisting physical elements that model physical space.\r\n * @see [[PhysicalPartition]]\r\n * @public\r\n */\r\nexport class PhysicalModel extends SpatialModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"PhysicalModel\"; }\r\n  /** Insert a PhysicalPartition and a PhysicalModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The PhysicalPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the PhysicalPartition that the new PhysicalModel will sub-model.\r\n   * @param isPlanProjection Optional value (default is false) that indicates if the contents of this model are expected to be in an XY plane.\r\n   * @returns The Id of the newly inserted PhysicalPartition and PhysicalModel (same value).\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string, isPlanProjection?: boolean): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: PhysicalPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: PhysicalPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    const modelProps: GeometricModel3dProps = {\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n      isPlanProjection,\r\n    };\r\n    return iModelDb.models.insertModel(modelProps);\r\n  }\r\n}\r\n\r\n/** A container for persisting spatial location elements.\r\n * @see [[SpatialLocationPartition]]\r\n * @public\r\n */\r\nexport class SpatialLocationModel extends SpatialModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialLocationModel\"; }\r\n  /** Insert a SpatialLocationPartition and a SpatialLocationModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The SpatialLocationPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the SpatialLocationPartition that the new SpatialLocationModel will sub-model.\r\n   * @param isPlanProjection Optional value (default is false) that indicates if the contents of this model are expected to be in an XY plane.\r\n   * @returns The Id of the newly inserted SpatialLocationPartition and SpatialLocationModel (same value).\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string, isPlanProjection?: boolean): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: SpatialLocationPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: SpatialLocationPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    const modelProps: GeometricModel3dProps = {\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n      isPlanProjection,\r\n    };\r\n    return iModelDb.models.insertModel(modelProps);\r\n  }\r\n}\r\n\r\n/** A 2d model that holds [[DrawingGraphic]]s. DrawingModels may be dimensional or non-dimensional.\r\n * @public\r\n */\r\nexport class DrawingModel extends GraphicalModel2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingModel\"; }\r\n}\r\n\r\n/** A container for persisting section [[DrawingGraphic]]s.\r\n * @public\r\n */\r\nexport class SectionDrawingModel extends DrawingModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SectionDrawingModel\"; }\r\n}\r\n\r\n/** A container for persisting [[ViewAttachment]]s and [[DrawingGraphic]]s.\r\n * A SheetModel is a digital representation of a *sheet of paper*. SheetModels are 2d models in bounded paper coordinates.\r\n * SheetModels may contain annotation Elements as well as references to 2d or 3d Views.\r\n * @public\r\n */\r\nexport class SheetModel extends GraphicalModel2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SheetModel\"; }\r\n}\r\n\r\n/** A container for persisting role elements.\r\n * @public\r\n */\r\nexport class RoleModel extends Model {\r\n  /** @internal */\r\n  public static override get className(): string { return \"RoleModel\"; }\r\n}\r\n\r\n/** A container for persisting information elements.\r\n * @public\r\n */\r\nexport abstract class InformationModel extends Model {\r\n  /** @internal */\r\n  public static override get className(): string { return \"InformationModel\"; }\r\n}\r\n\r\n/** A container for persisting group information elements.\r\n * @see [[GroupInformationPartition]]\r\n * @public\r\n */\r\nexport abstract class GroupInformationModel extends InformationModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"GroupInformationModel\"; }\r\n}\r\n\r\n/** A container for persisting Information Record Elements\r\n * @see [[InformationRecordPartition]]\r\n * @public\r\n */\r\nexport class InformationRecordModel extends InformationModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"InformationRecordModel\"; }\r\n\r\n  /** Insert a InformationRecordPartition and a InformationRecordModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The InformationRecordPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the InformationRecordPartition that the new InformationRecordModel will sub-model.\r\n   * @returns The Id of the newly inserted InformationRecordModel.\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: InformationRecordPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: InformationRecordPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** A container for persisting definition elements.\r\n * @see [[DefinitionPartition]]\r\n * @public\r\n */\r\nexport class DefinitionModel extends InformationModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DefinitionModel\"; }\r\n\r\n  /** Insert a DefinitionPartition and a DefinitionModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The DefinitionPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the DefinitionPartition that the new DefinitionModel will sub-model.\r\n   * @returns The Id of the newly inserted DefinitionModel.\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: DefinitionPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: DefinitionPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** The singleton container of repository-related information elements.\r\n * @public\r\n */\r\nexport class RepositoryModel extends DefinitionModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"RepositoryModel\"; }\r\n}\r\n\r\n/** Contains a list of document elements.\r\n * @see [[DocumentPartition]]\r\n * @public\r\n */\r\nexport class DocumentListModel extends InformationModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DocumentListModel\"; }\r\n  /** Insert a DocumentPartition and a DocumentListModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The DocumentPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the DocumentPartition that the new DocumentListModel will sub-model.\r\n   * @returns The Id of the newly inserted DocumentPartition and DocumentListModel (same value)\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: DocumentPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: DocumentPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId: Id64String = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** A container for persisting link elements.\r\n * @see [[LinkPartition]]\r\n * @public\r\n */\r\nexport class LinkModel extends InformationModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"LinkModel\"; }\r\n}\r\n\r\n/** The singleton container for repository-specific definition elements.\r\n * @public\r\n */\r\nexport class DictionaryModel extends DefinitionModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DictionaryModel\"; }\r\n}\r\n\r\n/** Obtains and displays multi-resolution tiled raster organized according to the WebMercator tiling system.\r\n * @public\r\n */\r\nexport class WebMercatorModel extends SpatialModel {\r\n  /** @internal */\r\n  public static override get className(): string { return \"WebMercatorModel\"; }\r\n}\r\n"]}
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../src/Model.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Models\r\n */\r\n\r\n// cspell:ignore elid\r\n\r\nimport { GuidString, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Point2d, Range3d } from \"@itwin/core-geometry\";\r\nimport {\r\n  AxisAlignedBox3d, ElementProps, EntityReferenceSet, GeometricModel2dProps, GeometricModel3dProps, GeometricModelProps, IModel,\r\n  InformationPartitionElementProps, ModelProps, RelatedElement,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionPartition, DocumentPartition, InformationRecordPartition, PhysicalPartition, SpatialLocationPartition } from \"./Element\";\r\nimport { Entity } from \"./Entity\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { SubjectOwnsPartitionElements } from \"./NavigationRelationship\";\r\nimport { _nativeDb, _verifyChannel } from \"./internal/Symbols\";\r\n\r\n/** Argument for the `Model.onXxx` static methods\r\n * @beta\r\n */\r\nexport interface OnModelArg {\r\n  /** The iModel for the Model affected. */\r\n  iModel: IModelDb;\r\n}\r\n\r\n/** Argument for the `Model.onXxx` static methods that supply the properties of a Model to be inserted or updated.\r\n * @beta\r\n */\r\nexport interface OnModelPropsArg extends OnModelArg {\r\n  /** The new properties of the Model affected. */\r\n  props: Readonly<ModelProps>;\r\n}\r\n\r\n/** Argument for the `Model.onXxx` static methods that only supply the Id of the affected Model.\r\n * @beta\r\n */\r\nexport interface OnModelIdArg extends OnModelArg {\r\n  /** The Id of the Model affected */\r\n  id: Id64String;\r\n}\r\n\r\n/** Argument for the `Model.onXxxElement` static methods that supply the properties of an Element for a Model.\r\n * @beta\r\n */\r\nexport interface OnElementInModelPropsArg extends OnModelIdArg {\r\n  /** The new properties of an Element for the affected Model */\r\n  elementProps: Readonly<ElementProps>;\r\n}\r\n\r\n/** Argument for the `Model.onXxxElement` static methods that supply the Id of an Element for a Model.\r\n * @beta\r\n */\r\nexport interface OnElementInModelIdArg extends OnModelIdArg {\r\n  /** The Id of the Element for the affected Model */\r\n  elementId: Id64String;\r\n}\r\n\r\n/** A Model is a container for persisting a collection of related elements within an iModel.\r\n * See [[IModelDb.Models]] for how to query and manage the Models in an IModelDb.\r\n * See [Creating models]($docs/learning/backend/CreateModels.md)\r\n * @public\r\n */\r\nexport class Model extends Entity {\r\n  public static override get className(): string { return \"Model\"; }\r\n  /** @internal */\r\n  public static override get protectedOperations() { return [\"onInsert\", \"onUpdate\", \"onDelete\"]; }\r\n  public readonly modeledElement!: RelatedElement;\r\n  public readonly name: string;\r\n  public readonly parentModel!: Id64String;\r\n  public readonly jsonProperties: { [key: string]: any };\r\n  public isPrivate: boolean;\r\n  public isTemplate: boolean;\r\n\r\n  protected constructor(props: ModelProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.name = props.name ? props.name : \"\"; // NB this isn't really a property of Model (it's the code.value of the modeled element), but it comes in ModelProps because it's often needed\r\n    this.isPrivate = JsonUtils.asBool(props.isPrivate);\r\n    this.isTemplate = JsonUtils.asBool(props.isTemplate);\r\n    this.jsonProperties = { ...props.jsonProperties }; // make sure we have our own copy\r\n  }\r\n\r\n  public override toJSON(): ModelProps {\r\n    const val = super.toJSON() as ModelProps;\r\n    val.name = this.name; // for cloning\r\n    return val;\r\n  }\r\n\r\n  /** Called before a new Model is inserted.\r\n   * @note throw an exception to disallow the insert\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be inserted\r\n   * @beta\r\n   */\r\n  protected static onInsert(arg: OnModelPropsArg): void {\r\n    const { props, iModel } = arg;\r\n    iModel.channels[_verifyChannel](props.modeledElement.id);\r\n    if (props.parentModel)   // inserting requires shared lock on parent, if present\r\n      iModel.locks.checkSharedLock(props.parentModel, \"parent model\", \"insert\");\r\n  }\r\n\r\n  /** Called after a new Model is inserted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was inserted\r\n   * @beta\r\n   */\r\n  protected static onInserted(_arg: OnModelIdArg): void {\r\n    // we don't need to tell LockControl about models being created - their ModeledElement does that\r\n  }\r\n\r\n  /** Called before a Model is updated.\r\n   * @note throw an exception to disallow the update\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be updated\r\n   * @beta\r\n   */\r\n  protected static onUpdate(arg: OnModelPropsArg): void {\r\n    const id = arg.props.id!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n    arg.iModel.channels[_verifyChannel](id);\r\n    arg.iModel.locks.checkExclusiveLock(id, \"model\", \"update\");\r\n  }\r\n\r\n  /** Called after a Model is updated.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was updated.\r\n   * @beta\r\n   */\r\n  protected static onUpdated(_arg: OnModelIdArg): void {\r\n  }\r\n\r\n  /** Called before a Model is deleted.\r\n   * @note throw an exception to disallow the delete\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to be deleted\r\n   * @beta\r\n   */\r\n  protected static onDelete(arg: OnModelIdArg): void {\r\n    arg.iModel.channels[_verifyChannel](arg.id);\r\n    arg.iModel.locks.checkExclusiveLock(arg.id, \"model\", \"delete\");\r\n  }\r\n\r\n  /** Called after a Model was deleted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that was deleted\r\n   * @beta\r\n   */\r\n  protected static onDeleted(_arg: OnModelIdArg): void { }\r\n\r\n  /** Called before a prospective Element is to be inserted into an instance of a Model of this class.\r\n   * @note throw an exception to disallow the insert\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model to hold the element\r\n   * @beta\r\n   */\r\n  protected static onInsertElement(_arg: OnElementInModelPropsArg): void { }\r\n\r\n  /** Called after an Element has been inserted into an instance of a Model of this class.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onInsertedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called when an Element in an instance of a Model of this class is about to be updated.\r\n   * @note throw an exception to disallow the update\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onUpdateElement(_arg: OnElementInModelPropsArg): void { }\r\n\r\n  /** Called after an Element in an instance of a Model of this class has been updated.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onUpdatedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called when an Element in an instance of a Model of this class is about to be deleted.\r\n   * @note throw an exception to disallow the delete\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model holding the element\r\n   * @beta\r\n   */\r\n  protected static onDeleteElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  /** Called after an Element in an instance of a Model of this class has been deleted.\r\n   * @note If you override this method, you must call super.\r\n   * @note `this` is the class of the Model that held the element\r\n   * @beta\r\n   */\r\n  protected static onDeletedElement(_arg: OnElementInModelIdArg): void { }\r\n\r\n  private getAllUserProperties(): any {\r\n    if (!this.jsonProperties.UserProps)\r\n      this.jsonProperties.UserProps = new Object();\r\n\r\n    return this.jsonProperties.UserProps;\r\n  }\r\n\r\n  /** Get a set of JSON user properties by namespace */\r\n  public getUserProperties(namespace: string) { return this.getAllUserProperties()[namespace]; }\r\n\r\n  /** Change a set of user JSON properties of this Element by namespace. */\r\n  public setUserProperties(nameSpace: string, value: any) { this.getAllUserProperties()[nameSpace] = value; }\r\n\r\n  /** Remove a set of JSON user properties, specified by namespace, from this Element */\r\n  public removeUserProperties(nameSpace: string) { delete this.getAllUserProperties()[nameSpace]; }\r\n\r\n  public getJsonProperty(name: string): any { return this.jsonProperties[name]; }\r\n  public setJsonProperty(name: string, value: any) { this.jsonProperties[name] = value; }\r\n\r\n  /** Insert this Model in the iModel */\r\n  public insert() { return this.id = this.iModel.models.insertModel(this.toJSON()); }\r\n  /** Update this Model in the iModel. */\r\n  public update() { this.iModel.models.updateModel(this.toJSON()); }\r\n  /** Delete this Model from the iModel. */\r\n  public delete() { this.iModel.models.deleteModel(this.id); }\r\n\r\n  protected override collectReferenceIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceIds(referenceIds);\r\n    if (this.parentModel)\r\n      referenceIds.addModel(this.parentModel);\r\n    referenceIds.addElement(this.modeledElement.id);\r\n  }\r\n}\r\n\r\n/** A container for persisting geometric elements.\r\n * @public\r\n */\r\nexport class GeometricModel extends Model {\r\n  public geometryGuid?: GuidString; // Initialized by the Entity constructor\r\n\r\n  public static override get className(): string { return \"GeometricModel\"; }\r\n\r\n  protected constructor(props: GeometricModelProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Query for the union of the extents of the elements contained by this model.\r\n   * @note This function blocks the JavaScript event loop. Consider using [[queryRange]] instead.\r\n   */\r\n  public queryExtents(): AxisAlignedBox3d {\r\n    const extents = this.iModel[_nativeDb].queryModelExtents({ id: this.id }).modelExtents;\r\n    return Range3d.fromJSON(extents);\r\n  }\r\n\r\n  /** Query for the union of the extents of all elements contained within this model. */\r\n  public async queryRange(): Promise<AxisAlignedBox3d> {\r\n    return this.iModel.models.queryRange(this.id);\r\n  }\r\n}\r\n\r\n/** A container for persisting 3d geometric elements.\r\n * @public\r\n */\r\nexport abstract class GeometricModel3d extends GeometricModel {\r\n  /** If true, then the elements in this GeometricModel3d are expected to be in an XY plane.\r\n   * @note The associated ECProperty was added to the BisCore schema in version 1.0.8\r\n   */\r\n  public readonly isPlanProjection: boolean;\r\n  /** If true, then the elements in this GeometricModel3d are not in real-world coordinates and will not be in the spatial index.\r\n   * @note The associated ECProperty was added to the BisCore schema in version 1.0.8\r\n   */\r\n  public readonly isNotSpatiallyLocated: boolean;\r\n  /** If true, then the elements in this GeometricModel3d are in real-world coordinates and will be in the spatial index. */\r\n  public get isSpatiallyLocated(): boolean { return !this.isNotSpatiallyLocated; }\r\n\r\n  public static override get className(): string { return \"GeometricModel3d\"; }\r\n\r\n  protected constructor(props: GeometricModel3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.isNotSpatiallyLocated = JsonUtils.asBool(props.isNotSpatiallyLocated);\r\n    this.isPlanProjection = JsonUtils.asBool(props.isPlanProjection);\r\n  }\r\n\r\n  public override toJSON(): GeometricModel3dProps {\r\n    const val = super.toJSON() as GeometricModel3dProps;\r\n    if (this.isNotSpatiallyLocated)\r\n      val.isNotSpatiallyLocated = true;\r\n\r\n    if (this.isPlanProjection)\r\n      val.isPlanProjection = true;\r\n\r\n    return val;\r\n  }\r\n}\r\n\r\n/** A container for persisting 2d geometric elements.\r\n * @public\r\n */\r\nexport abstract class GeometricModel2d extends GeometricModel {\r\n  /** The actual coordinates of (0,0) in modeling coordinates. An offset applied to all modeling coordinates. */\r\n  public globalOrigin?: Point2d; // Initialized by the Entity constructor\r\n  public static override get className(): string { return \"GeometricModel2d\"; }\r\n\r\n  protected constructor(props: GeometricModel2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  public override toJSON(): GeometricModel2dProps {\r\n    const val = super.toJSON() as GeometricModel2dProps;\r\n    if (undefined !== this.globalOrigin)\r\n      val.globalOrigin = Point2d.fromJSON(this.globalOrigin);\r\n\r\n    return val;\r\n  }\r\n}\r\n\r\n/** A container for persisting 2d graphical elements.\r\n * @public\r\n */\r\nexport abstract class GraphicalModel2d extends GeometricModel2d {\r\n  public static override get className(): string { return \"GraphicalModel2d\"; }\r\n}\r\n\r\n/** A container for persisting GraphicalElement3d instances.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.8\r\n * @see [[GraphicalPartition3d]]\r\n * @public\r\n */\r\nexport abstract class GraphicalModel3d extends GeometricModel3d {\r\n  public static override get className(): string { return \"GraphicalModel3d\"; }\r\n}\r\n\r\n/** A container for persisting 3d geometric elements that are spatially located.\r\n * @public\r\n */\r\nexport abstract class SpatialModel extends GeometricModel3d {\r\n  public static override get className(): string { return \"SpatialModel\"; }\r\n}\r\n\r\n/** A container for persisting physical elements that model physical space.\r\n * @see [[PhysicalPartition]]\r\n * @public\r\n */\r\nexport class PhysicalModel extends SpatialModel {\r\n  public static override get className(): string { return \"PhysicalModel\"; }\r\n  /** Insert a PhysicalPartition and a PhysicalModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The PhysicalPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the PhysicalPartition that the new PhysicalModel will sub-model.\r\n   * @param isPlanProjection Optional value (default is false) that indicates if the contents of this model are expected to be in an XY plane.\r\n   * @returns The Id of the newly inserted PhysicalPartition and PhysicalModel (same value).\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string, isPlanProjection?: boolean): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: PhysicalPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: PhysicalPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    const modelProps: GeometricModel3dProps = {\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n      isPlanProjection,\r\n    };\r\n    return iModelDb.models.insertModel(modelProps);\r\n  }\r\n}\r\n\r\n/** A container for persisting spatial location elements.\r\n * @see [[SpatialLocationPartition]]\r\n * @public\r\n */\r\nexport class SpatialLocationModel extends SpatialModel {\r\n  public static override get className(): string { return \"SpatialLocationModel\"; }\r\n  /** Insert a SpatialLocationPartition and a SpatialLocationModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The SpatialLocationPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the SpatialLocationPartition that the new SpatialLocationModel will sub-model.\r\n   * @param isPlanProjection Optional value (default is false) that indicates if the contents of this model are expected to be in an XY plane.\r\n   * @returns The Id of the newly inserted SpatialLocationPartition and SpatialLocationModel (same value).\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string, isPlanProjection?: boolean): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: SpatialLocationPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: SpatialLocationPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    const modelProps: GeometricModel3dProps = {\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n      isPlanProjection,\r\n    };\r\n    return iModelDb.models.insertModel(modelProps);\r\n  }\r\n}\r\n\r\n/** A 2d model that holds [[DrawingGraphic]]s. DrawingModels may be dimensional or non-dimensional.\r\n * @public\r\n */\r\nexport class DrawingModel extends GraphicalModel2d {\r\n  public static override get className(): string { return \"DrawingModel\"; }\r\n}\r\n\r\n/** A container for persisting section [[DrawingGraphic]]s.\r\n * @public\r\n */\r\nexport class SectionDrawingModel extends DrawingModel {\r\n  public static override get className(): string { return \"SectionDrawingModel\"; }\r\n}\r\n\r\n/** A container for persisting [[ViewAttachment]]s and [[DrawingGraphic]]s.\r\n * A SheetModel is a digital representation of a *sheet of paper*. SheetModels are 2d models in bounded paper coordinates.\r\n * SheetModels may contain annotation Elements as well as references to 2d or 3d Views.\r\n * @public\r\n */\r\nexport class SheetModel extends GraphicalModel2d {\r\n  public static override get className(): string { return \"SheetModel\"; }\r\n}\r\n\r\n/** A container for persisting role elements.\r\n * @public\r\n */\r\nexport class RoleModel extends Model {\r\n  public static override get className(): string { return \"RoleModel\"; }\r\n}\r\n\r\n/** A container for persisting information elements.\r\n * @public\r\n */\r\nexport abstract class InformationModel extends Model {\r\n  public static override get className(): string { return \"InformationModel\"; }\r\n}\r\n\r\n/** A container for persisting group information elements.\r\n * @see [[GroupInformationPartition]]\r\n * @public\r\n */\r\nexport abstract class GroupInformationModel extends InformationModel {\r\n  public static override get className(): string { return \"GroupInformationModel\"; }\r\n}\r\n\r\n/** A container for persisting Information Record Elements\r\n * @see [[InformationRecordPartition]]\r\n * @public\r\n */\r\nexport class InformationRecordModel extends InformationModel {\r\n  public static override get className(): string { return \"InformationRecordModel\"; }\r\n\r\n  /** Insert a InformationRecordPartition and a InformationRecordModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The InformationRecordPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the InformationRecordPartition that the new InformationRecordModel will sub-model.\r\n   * @returns The Id of the newly inserted InformationRecordModel.\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: InformationRecordPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: InformationRecordPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** A container for persisting definition elements.\r\n * @see [[DefinitionPartition]]\r\n * @public\r\n */\r\nexport class DefinitionModel extends InformationModel {\r\n  public static override get className(): string { return \"DefinitionModel\"; }\r\n\r\n  /** Insert a DefinitionPartition and a DefinitionModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The DefinitionPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the DefinitionPartition that the new DefinitionModel will sub-model.\r\n   * @returns The Id of the newly inserted DefinitionModel.\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: DefinitionPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: DefinitionPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** The singleton container of repository-related information elements.\r\n * @public\r\n */\r\nexport class RepositoryModel extends DefinitionModel {\r\n  public static override get className(): string { return \"RepositoryModel\"; }\r\n}\r\n\r\n/** Contains a list of document elements.\r\n * @see [[DocumentPartition]]\r\n * @public\r\n */\r\nexport class DocumentListModel extends InformationModel {\r\n  public static override get className(): string { return \"DocumentListModel\"; }\r\n  /** Insert a DocumentPartition and a DocumentListModel that sub-models it.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentSubjectId The DocumentPartition will be inserted as a child of this Subject element.\r\n   * @param name The name of the DocumentPartition that the new DocumentListModel will sub-model.\r\n   * @returns The Id of the newly inserted DocumentPartition and DocumentListModel (same value)\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentSubjectId: Id64String, name: string): Id64String {\r\n    const partitionProps: InformationPartitionElementProps = {\r\n      classFullName: DocumentPartition.classFullName,\r\n      model: IModel.repositoryModelId,\r\n      parent: new SubjectOwnsPartitionElements(parentSubjectId),\r\n      code: DocumentPartition.createCode(iModelDb, parentSubjectId, name),\r\n    };\r\n    const partitionId: Id64String = iModelDb.elements.insertElement(partitionProps);\r\n    return iModelDb.models.insertModel({\r\n      classFullName: this.classFullName,\r\n      modeledElement: { id: partitionId },\r\n    });\r\n  }\r\n}\r\n\r\n/** A container for persisting link elements.\r\n * @see [[LinkPartition]]\r\n * @public\r\n */\r\nexport class LinkModel extends InformationModel {\r\n  public static override get className(): string { return \"LinkModel\"; }\r\n}\r\n\r\n/** The singleton container for repository-specific definition elements.\r\n * @public\r\n */\r\nexport class DictionaryModel extends DefinitionModel {\r\n  public static override get className(): string { return \"DictionaryModel\"; }\r\n}\r\n\r\n/** Obtains and displays multi-resolution tiled raster organized according to the WebMercator tiling system.\r\n * @public\r\n */\r\nexport class WebMercatorModel extends SpatialModel {\r\n  public static override get className(): string { return \"WebMercatorModel\"; }\r\n}\r\n"]}

package/lib/cjs/PropertyStore.d.ts

@@ -1,13 +1,14 @@
 /** @packageDocumentation
  * @module SQLiteDb
  */
+import { BlobContainer } from "./BlobContainerService";
 import { CloudSqlite } from "./CloudSqlite";
 import { VersionedSqliteDb } from "./SQLiteDb";
-import { SettingObject } from "./workspace/Settings";
+import { SettingsContainer } from "./workspace/Settings";
 /** @beta */
 export declare namespace PropertyStore {
     /** The set of valid types for properties in a PropertyStore. */
-    type PropertyType = string | number | boolean | Uint8Array | SettingObject;
+    type PropertyType = string | number | boolean | Uint8Array | SettingsContainer;
     /** The case-sensitive name of a Property. May not have leading or trailing spaces, and must be between 3 and 2048 characters long. */
     type PropertyName = string;
     /** An array of PropertyName/PropertyType pairs to be stored in a PropertyStore. */
@@ -75,11 +76,11 @@ export declare namespace PropertyStore {
         /** Get the value of an object property by name.
         * @returns the property's value if it exists and is an object, `undefined` otherwise.
         */
-        getObject(name: PropertyName): SettingObject | undefined;
+        getObject(name: PropertyName): SettingsContainer | undefined;
         /** Get the value of an object property by name.
         * @returns the property's value if it exists and is an object, otherwise the supplied default value.
         */
-        getObject(name: PropertyName, defaultValue: SettingObject): SettingObject;
+        getObject(name: PropertyName, defaultValue: SettingsContainer): SettingsContainer;
         /** call an iteration function for each property, optionally applying a filter */
         forAllProperties(iter: PropertyIteration, filter?: PropertyFilter): void;
         /** Delete a single property from this PropertyDb. If the value does not exist, this method does nothing.
@@ -100,6 +101,10 @@ export declare namespace PropertyStore {
          */
         saveProperties(props: PropertyArray): Promise<void>;
     }
+    interface CreateNewContainerProps {
+        scope: BlobContainer.Scope;
+        metadata: Omit<BlobContainer.Metadata, "containerType">;
+    }
     /**
      * Provides access to a cloud-based `PropertyDb` to hold a set of values of type `PropertyType`, each with a unique `PropertyName`.
      * `PropertyStore.PropertyDb`s that are stored in cloud containers require an access token that grants permission to read and/or write them.
@@ -112,13 +117,18 @@ export declare namespace PropertyStore {
     class CloudAccess extends CloudSqlite.DbAccess<PropertyDb> {
         constructor(props: CloudSqlite.ContainerAccessProps);
         /**
-         * Initialize a cloud container for use as a PropertyStore. The container must first be created via its storage supplier api (e.g. Azure, or AWS).
-         * A valid sasToken that grants write access must be supplied. This function creates and uploads an empty PropertyDb into the container.
+         * Initialize a cloud container for use as a PropertyStore. This method is called by [[createNewContainer]].
+         * It is only necessary to convert an existing container to a PropertyStore container.
          * @note this deletes any existing content in the container.
+         * @internal
          */
         static initializeDb(args: {
-            props: CloudSqlite.ContainerAccessProps;
+            props: CloudSqlite.ContainerProps;
         }): Promise<void>;
+        /** Create and initialize a new BlobContainer to hold a PropertyStore
+         * @note the current user must have administrator rights to create containers.
+         */
+        static createNewContainer(args: CreateNewContainerProps): Promise<CloudSqlite.ContainerProps>;
     }
 }
 //# sourceMappingURL=PropertyStore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PropertyStore.d.ts","sourceRoot":"","sources":["../../src/PropertyStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PropertyStore.d.ts","sourceRoot":"","sources":["../../src/PropertyStore.ts"],"names":[],"mappings":"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"}

package/lib/cjs/PropertyStore.js

@@ -5,9 +5,6 @@
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PropertyStore = void 0;
-/** @packageDocumentation
- * @module SQLiteDb
- */
 const CloudSqlite_1 = require("./CloudSqlite");
 const SQLiteDb_1 = require("./SQLiteDb");
 /** @beta */
@@ -164,13 +161,22 @@ var PropertyStore;
             super({ dbType: PropertyDb, props, dbName: defaultDbName });
         }
         /**
-         * Initialize a cloud container for use as a PropertyStore. The container must first be created via its storage supplier api (e.g. Azure, or AWS).
-         * A valid sasToken that grants write access must be supplied. This function creates and uploads an empty PropertyDb into the container.
+         * Initialize a cloud container for use as a PropertyStore. This method is called by [[createNewContainer]].
+         * It is only necessary to convert an existing container to a PropertyStore container.
          * @note this deletes any existing content in the container.
+         * @internal
          */
         static async initializeDb(args) {
             return super._initializeDb({ ...args, dbType: PropertyDb, dbName: defaultDbName });
         }
+        /** Create and initialize a new BlobContainer to hold a PropertyStore
+         * @note the current user must have administrator rights to create containers.
+         */
+        static async createNewContainer(args) {
+            const props = await this.createBlobContainer({ scope: args.scope, metadata: { ...args.metadata, containerType: "property-store" } });
+            await this.initializeDb({ props });
+            return props;
+        }
     }
     PropertyStore.CloudAccess = CloudAccess;
 })(PropertyStore || (exports.PropertyStore = PropertyStore = {}));

package/lib/cjs/PropertyStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyStore.js","sourceRoot":"","sources":["../../src/PropertyStore.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module SQLiteDb\r\n */\r\n\r\nimport { CloudSqlite } from \"./CloudSqlite\";\r\nimport { VersionedSqliteDb } from \"./SQLiteDb\";\r\nimport { SettingObject } from \"./workspace/Settings\";\r\n\r\n/** @beta */\r\nexport namespace PropertyStore {\r\n\r\n  /** The set of valid types for properties in a PropertyStore. */\r\n  export type PropertyType = string | number | boolean | Uint8Array | SettingObject;\r\n  /** The case-sensitive name of a Property. May not have leading or trailing spaces, and must be between 3 and 2048 characters long. */\r\n  export type PropertyName = string;\r\n  /** An array of PropertyName/PropertyType pairs to be stored in a PropertyStore. */\r\n  export type PropertyArray = { name: PropertyName, value: PropertyType }[];\r\n  /** The return status of an iteration function. The value \"stop\" causes the iteration to terminate. */\r\n  export type IterationReturn = void | \"stop\";\r\n  /** An iteration function over Properties in a PropertyStore. It is called with the name of a each Property. */\r\n  export type PropertyIteration = (name: string) => IterationReturn;\r\n\r\n  /** A filter used to limit and/or sort the values returned by an iteration. */\r\n  export interface PropertyFilter {\r\n    /** A value filter. May include wild cards when used with `GLOB` or `LIKE` */\r\n    readonly value?: string;\r\n    /** The comparison operator for `value`. Default is `=` */\r\n    readonly valueCompare?: \"GLOB\" | \"LIKE\" | \"NOT GLOB\" | \"NOT LIKE\" | \"=\" | \"!=\" | \"<\" | \">\";\r\n    /** Order results ascending or descending. If not supplied, the results are unordered (random). */\r\n    readonly orderBy?: \"ASC\" | \"DESC\";\r\n    /** An SQL expression to further filter results. This string is appended to the `WHERE` clause with an `AND` (that should not be part of the sqlExpression) */\r\n    readonly sqlExpression?: string;\r\n  }\r\n\r\n  /**\r\n   * A SQLite database for storing PropertyName/PropertyValue pairs.\r\n   */\r\n  export class PropertyDb extends VersionedSqliteDb {\r\n    public override readonly myVersion = \"3.0.0\";\r\n\r\n    protected override createDDL() {\r\n      this.createTable({ tableName: \"properties\", columns: \"name TEXT NOT NULL PRIMARY KEY,type,value\", addTimestamp: true });\r\n    }\r\n\r\n    /** get the value of a Property by name.\r\n     * @returns the property's value if it exists, `undefined` otherwise.\r\n     */\r\n    public getProperty(name: PropertyName): PropertyType | undefined {\r\n      return this.withPreparedSqliteStatement(\"SELECT type,value from properties WHERE name=?\", (stmt) => {\r\n        stmt.bindString(1, name);\r\n        if (!stmt.nextRow())\r\n          return undefined;\r\n        switch (stmt.getValueString(0)) {\r\n          case \"string\":\r\n            return stmt.getValueString(1);\r\n          case \"boolean\":\r\n            return stmt.getValueInteger(1) !== 0;\r\n          case \"blob\":\r\n            return stmt.getValueBlob(1);\r\n          case \"number\":\r\n            return stmt.getValueDouble(1);\r\n          case \"object\":\r\n            return JSON.parse(stmt.getValueString(1)) as SettingObject;\r\n        }\r\n        return undefined;\r\n      });\r\n    }\r\n    /** Get the value of a string property by name.\r\n    * @returns the property's value if it exists and is a string, `undefined` otherwise.\r\n    */\r\n    public getString(name: PropertyName, defaultValue: string): string;\r\n    /** Get the value of a string property by name.\r\n    * @returns the property's value if it exists and is a string, otherwise the supplied default value.\r\n    */\r\n    public getString(name: PropertyName): string | undefined;\r\n    public getString(name: PropertyName, defaultValue?: string): string | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"string\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a boolean property by name.\r\n    * @returns the property's value if it exists and is a boolean, `undefined` otherwise.\r\n    */\r\n    public getBoolean(name: PropertyName): boolean | undefined;\r\n    /** Get the value of a boolean property by name.\r\n    * @returns the property's value if it exists and is a boolean, otherwise the supplied default value.\r\n    */\r\n    public getBoolean(name: PropertyName, defaultValue: boolean): boolean;\r\n    public getBoolean(name: PropertyName, defaultValue?: boolean): boolean | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"boolean\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a number property by name.\r\n    * @returns the property's value if it exists and is a number, `undefined` otherwise.\r\n    */\r\n    public getNumber(name: PropertyName): number | undefined;\r\n    /** Get the value of a number property by name.\r\n    * @returns the property's value if it exists and is a number, otherwise the supplied default value.\r\n    */\r\n    public getNumber(name: PropertyName, defaultValue: number): number;\r\n    public getNumber(name: PropertyName, defaultValue?: number): number | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"number\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a blob property by name.\r\n    * @returns the property's value if it exists and is a blob, `undefined` otherwise.\r\n    */\r\n    public getBlob(name: PropertyName): Uint8Array | undefined;\r\n    /** Get the value of a blob property by name.\r\n    * @returns the property's value if it exists and is a blob, otherwise the supplied default value.\r\n    */\r\n    public getBlob(name: PropertyName, defaultValue: Uint8Array): Uint8Array;\r\n    public getBlob(name: PropertyName, defaultValue?: Uint8Array): Uint8Array | undefined {\r\n      const out = this.getProperty(name);\r\n      return out instanceof Uint8Array ? out : defaultValue;\r\n    }\r\n    /** Get the value of an object property by name.\r\n    * @returns the property's value if it exists and is an object, `undefined` otherwise.\r\n    */\r\n    public getObject(name: PropertyName): SettingObject | undefined;\r\n    /** Get the value of an object property by name.\r\n    * @returns the property's value if it exists and is an object, otherwise the supplied default value.\r\n    */\r\n    public getObject(name: PropertyName, defaultValue: SettingObject): SettingObject;\r\n    public getObject(name: PropertyName, defaultValue?: SettingObject): SettingObject | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"object\" ? out as SettingObject : defaultValue;\r\n    }\r\n\r\n    /** call an iteration function for each property, optionally applying a filter */\r\n    public forAllProperties(iter: PropertyIteration, filter?: PropertyFilter) {\r\n      let sql = \"SELECT name FROM properties WHERE name IS NOT NULL\";\r\n      if (filter?.sqlExpression)\r\n        sql += ` AND ${filter.sqlExpression} `;\r\n      if (filter?.value)\r\n        sql += ` AND name ${filter.valueCompare ?? \"=\"} @val`;\r\n      if (filter?.orderBy)\r\n        sql += ` ORDER BY name ${filter.orderBy} `;\r\n\r\n      this.withSqliteStatement(sql, (stmt) => {\r\n        if (filter?.value)\r\n          stmt.bindString(\"@val\", filter.value);\r\n\r\n        while (stmt.nextRow()) {\r\n          if (iter(stmt.getValueString(0)) === \"stop\")\r\n            return;\r\n        }\r\n      });\r\n    }\r\n\r\n    /** Delete a single property from this PropertyDb. If the value does not exist, this method does nothing.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async deleteProperty(propName: PropertyName) {\r\n      this.withSqliteStatement(\"DELETE from properties WHERE name=?\", (stmt) => {\r\n        stmt.bindString(1, propName);\r\n        stmt.stepForWrite();\r\n      });\r\n    }\r\n    /** Delete an array of properties from this PropertyDb. Any value that does not exist is ignored.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async deleteProperties(propNames: PropertyName[]) {\r\n      propNames.forEach(async (name) => this.deleteProperty(name));\r\n    }\r\n\r\n    private validateName(name: PropertyName) {\r\n      if (typeof name !== \"string\" || name.trim() !== name || name.length > 2 * 1024 || name.length < 2)\r\n        throw new Error(`illegal property name[${name}]`);\r\n    }\r\n\r\n    /** Save a single property in this PropertyDb. If the property already exists, its value is overwritten.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async saveProperty(name: PropertyName, value: PropertyType) {\r\n      this.validateName(name);\r\n      this.withSqliteStatement(\"INSERT OR REPLACE INTO properties(name,type,value) VALUES (?,?,?)\", (stmt) => {\r\n        stmt.bindString(1, name);\r\n        switch (typeof value) {\r\n          case \"string\":\r\n            stmt.bindString(2, \"string\");\r\n            stmt.bindString(3, value);\r\n            break;\r\n          case \"boolean\":\r\n            stmt.bindString(2, \"boolean\");\r\n            stmt.bindInteger(3, value ? 1 : 0);\r\n            break;\r\n          case \"number\":\r\n            stmt.bindString(2, \"number\");\r\n            stmt.bindDouble(3, value);\r\n            break;\r\n          case \"object\":\r\n            if (value instanceof Uint8Array) {\r\n              stmt.bindString(2, \"blob\");\r\n              stmt.bindBlob(3, value);\r\n            } else {\r\n              stmt.bindString(2, \"object\");\r\n              stmt.bindString(3, JSON.stringify(value));\r\n            }\r\n            break;\r\n          default:\r\n            throw new Error(\"illegal property value type\");\r\n        }\r\n\r\n        stmt.stepForWrite();\r\n      });\r\n    }\r\n\r\n    /** Save an array of properties in this PropertyDb. If a property already exists, its value is overwritten.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async saveProperties(props: PropertyArray) {\r\n      for (const prop of props)\r\n        await this.saveProperty(prop.name, prop.value);\r\n    }\r\n  }\r\n\r\n  const defaultDbName = \"PropertyDb\" as const;\r\n\r\n  /**\r\n   * Provides access to a cloud-based `PropertyDb` to hold a set of values of type `PropertyType`, each with a unique `PropertyName`.\r\n   * `PropertyStore.PropertyDb`s that are stored in cloud containers require an access token that grants permission to read and/or write them.\r\n   * All write operations will fail without an access token that grants write permission.\r\n   *\r\n   * The database is cached on a local drive so reads are fast and inexpensive, and may even be done offline after a prefetch.\r\n   * However, that means that callers are responsible for synchronizing the local cache to ensure it includes changes\r\n   * made by others, as appropriate (see [[synchronizeWithCloud]]).\r\n   */\r\n  export class CloudAccess extends CloudSqlite.DbAccess<PropertyDb> {\r\n    public constructor(props: CloudSqlite.ContainerAccessProps) {\r\n      super({ dbType: PropertyDb, props, dbName: defaultDbName });\r\n    }\r\n\r\n    /**\r\n     * Initialize a cloud container for use as a PropertyStore. The container must first be created via its storage supplier api (e.g. Azure, or AWS).\r\n     * A valid sasToken that grants write access must be supplied. This function creates and uploads an empty PropertyDb into the container.\r\n     * @note this deletes any existing content in the container.\r\n     */\r\n    public static async initializeDb(args: { props: CloudSqlite.ContainerAccessProps }) {\r\n      return super._initializeDb({ ...args, dbType: PropertyDb, dbName: defaultDbName });\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PropertyStore.js","sourceRoot":"","sources":["../../src/PropertyStore.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module SQLiteDb\r\n */\r\n\r\nimport { BlobContainer } from \"./BlobContainerService\";\r\nimport { CloudSqlite } from \"./CloudSqlite\";\r\nimport { VersionedSqliteDb } from \"./SQLiteDb\";\r\nimport { SettingsContainer } from \"./workspace/Settings\";\r\n\r\n/** @beta */\r\nexport namespace PropertyStore {\r\n\r\n  /** The set of valid types for properties in a PropertyStore. */\r\n  export type PropertyType = string | number | boolean | Uint8Array | SettingsContainer;\r\n  /** The case-sensitive name of a Property. May not have leading or trailing spaces, and must be between 3 and 2048 characters long. */\r\n  export type PropertyName = string;\r\n  /** An array of PropertyName/PropertyType pairs to be stored in a PropertyStore. */\r\n  export type PropertyArray = { name: PropertyName, value: PropertyType }[];\r\n  /** The return status of an iteration function. The value \"stop\" causes the iteration to terminate. */\r\n  export type IterationReturn = void | \"stop\";\r\n  /** An iteration function over Properties in a PropertyStore. It is called with the name of a each Property. */\r\n  export type PropertyIteration = (name: string) => IterationReturn;\r\n\r\n  /** A filter used to limit and/or sort the values returned by an iteration. */\r\n  export interface PropertyFilter {\r\n    /** A value filter. May include wild cards when used with `GLOB` or `LIKE` */\r\n    readonly value?: string;\r\n    /** The comparison operator for `value`. Default is `=` */\r\n    readonly valueCompare?: \"GLOB\" | \"LIKE\" | \"NOT GLOB\" | \"NOT LIKE\" | \"=\" | \"!=\" | \"<\" | \">\";\r\n    /** Order results ascending or descending. If not supplied, the results are unordered (random). */\r\n    readonly orderBy?: \"ASC\" | \"DESC\";\r\n    /** An SQL expression to further filter results. This string is appended to the `WHERE` clause with an `AND` (that should not be part of the sqlExpression) */\r\n    readonly sqlExpression?: string;\r\n  }\r\n\r\n  /**\r\n   * A SQLite database for storing PropertyName/PropertyValue pairs.\r\n   */\r\n  export class PropertyDb extends VersionedSqliteDb {\r\n    public override readonly myVersion = \"3.0.0\";\r\n\r\n    protected override createDDL() {\r\n      this.createTable({ tableName: \"properties\", columns: \"name TEXT NOT NULL PRIMARY KEY,type,value\", addTimestamp: true });\r\n    }\r\n\r\n    /** get the value of a Property by name.\r\n     * @returns the property's value if it exists, `undefined` otherwise.\r\n     */\r\n    public getProperty(name: PropertyName): PropertyType | undefined {\r\n      return this.withPreparedSqliteStatement(\"SELECT type,value from properties WHERE name=?\", (stmt) => {\r\n        stmt.bindString(1, name);\r\n        if (!stmt.nextRow())\r\n          return undefined;\r\n        switch (stmt.getValueString(0)) {\r\n          case \"string\":\r\n            return stmt.getValueString(1);\r\n          case \"boolean\":\r\n            return stmt.getValueInteger(1) !== 0;\r\n          case \"blob\":\r\n            return stmt.getValueBlob(1);\r\n          case \"number\":\r\n            return stmt.getValueDouble(1);\r\n          case \"object\":\r\n            return JSON.parse(stmt.getValueString(1)) as SettingsContainer;\r\n        }\r\n        return undefined;\r\n      });\r\n    }\r\n    /** Get the value of a string property by name.\r\n    * @returns the property's value if it exists and is a string, `undefined` otherwise.\r\n    */\r\n    public getString(name: PropertyName, defaultValue: string): string;\r\n    /** Get the value of a string property by name.\r\n    * @returns the property's value if it exists and is a string, otherwise the supplied default value.\r\n    */\r\n    public getString(name: PropertyName): string | undefined;\r\n    public getString(name: PropertyName, defaultValue?: string): string | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"string\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a boolean property by name.\r\n    * @returns the property's value if it exists and is a boolean, `undefined` otherwise.\r\n    */\r\n    public getBoolean(name: PropertyName): boolean | undefined;\r\n    /** Get the value of a boolean property by name.\r\n    * @returns the property's value if it exists and is a boolean, otherwise the supplied default value.\r\n    */\r\n    public getBoolean(name: PropertyName, defaultValue: boolean): boolean;\r\n    public getBoolean(name: PropertyName, defaultValue?: boolean): boolean | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"boolean\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a number property by name.\r\n    * @returns the property's value if it exists and is a number, `undefined` otherwise.\r\n    */\r\n    public getNumber(name: PropertyName): number | undefined;\r\n    /** Get the value of a number property by name.\r\n    * @returns the property's value if it exists and is a number, otherwise the supplied default value.\r\n    */\r\n    public getNumber(name: PropertyName, defaultValue: number): number;\r\n    public getNumber(name: PropertyName, defaultValue?: number): number | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"number\" ? out : defaultValue;\r\n    }\r\n    /** Get the value of a blob property by name.\r\n    * @returns the property's value if it exists and is a blob, `undefined` otherwise.\r\n    */\r\n    public getBlob(name: PropertyName): Uint8Array | undefined;\r\n    /** Get the value of a blob property by name.\r\n    * @returns the property's value if it exists and is a blob, otherwise the supplied default value.\r\n    */\r\n    public getBlob(name: PropertyName, defaultValue: Uint8Array): Uint8Array;\r\n    public getBlob(name: PropertyName, defaultValue?: Uint8Array): Uint8Array | undefined {\r\n      const out = this.getProperty(name);\r\n      return out instanceof Uint8Array ? out : defaultValue;\r\n    }\r\n    /** Get the value of an object property by name.\r\n    * @returns the property's value if it exists and is an object, `undefined` otherwise.\r\n    */\r\n    public getObject(name: PropertyName): SettingsContainer | undefined;\r\n    /** Get the value of an object property by name.\r\n    * @returns the property's value if it exists and is an object, otherwise the supplied default value.\r\n    */\r\n    public getObject(name: PropertyName, defaultValue: SettingsContainer): SettingsContainer;\r\n    public getObject(name: PropertyName, defaultValue?: SettingsContainer): SettingsContainer | undefined {\r\n      const out = this.getProperty(name);\r\n      return typeof out === \"object\" ? out as SettingsContainer : defaultValue;\r\n    }\r\n\r\n    /** call an iteration function for each property, optionally applying a filter */\r\n    public forAllProperties(iter: PropertyIteration, filter?: PropertyFilter) {\r\n      let sql = \"SELECT name FROM properties WHERE name IS NOT NULL\";\r\n      if (filter?.sqlExpression)\r\n        sql += ` AND ${filter.sqlExpression} `;\r\n      if (filter?.value)\r\n        sql += ` AND name ${filter.valueCompare ?? \"=\"} @val`;\r\n      if (filter?.orderBy)\r\n        sql += ` ORDER BY name ${filter.orderBy} `;\r\n\r\n      this.withSqliteStatement(sql, (stmt) => {\r\n        if (filter?.value)\r\n          stmt.bindString(\"@val\", filter.value);\r\n\r\n        while (stmt.nextRow()) {\r\n          if (iter(stmt.getValueString(0)) === \"stop\")\r\n            return;\r\n        }\r\n      });\r\n    }\r\n\r\n    /** Delete a single property from this PropertyDb. If the value does not exist, this method does nothing.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async deleteProperty(propName: PropertyName) {\r\n      this.withSqliteStatement(\"DELETE from properties WHERE name=?\", (stmt) => {\r\n        stmt.bindString(1, propName);\r\n        stmt.stepForWrite();\r\n      });\r\n    }\r\n    /** Delete an array of properties from this PropertyDb. Any value that does not exist is ignored.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async deleteProperties(propNames: PropertyName[]) {\r\n      propNames.forEach(async (name) => this.deleteProperty(name));\r\n    }\r\n\r\n    private validateName(name: PropertyName) {\r\n      if (typeof name !== \"string\" || name.trim() !== name || name.length > 2 * 1024 || name.length < 2)\r\n        throw new Error(`illegal property name[${name}]`);\r\n    }\r\n\r\n    /** Save a single property in this PropertyDb. If the property already exists, its value is overwritten.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async saveProperty(name: PropertyName, value: PropertyType) {\r\n      this.validateName(name);\r\n      this.withSqliteStatement(\"INSERT OR REPLACE INTO properties(name,type,value) VALUES (?,?,?)\", (stmt) => {\r\n        stmt.bindString(1, name);\r\n        switch (typeof value) {\r\n          case \"string\":\r\n            stmt.bindString(2, \"string\");\r\n            stmt.bindString(3, value);\r\n            break;\r\n          case \"boolean\":\r\n            stmt.bindString(2, \"boolean\");\r\n            stmt.bindInteger(3, value ? 1 : 0);\r\n            break;\r\n          case \"number\":\r\n            stmt.bindString(2, \"number\");\r\n            stmt.bindDouble(3, value);\r\n            break;\r\n          case \"object\":\r\n            if (value instanceof Uint8Array) {\r\n              stmt.bindString(2, \"blob\");\r\n              stmt.bindBlob(3, value);\r\n            } else {\r\n              stmt.bindString(2, \"object\");\r\n              stmt.bindString(3, JSON.stringify(value));\r\n            }\r\n            break;\r\n          default:\r\n            throw new Error(\"illegal property value type\");\r\n        }\r\n\r\n        stmt.stepForWrite();\r\n      });\r\n    }\r\n\r\n    /** Save an array of properties in this PropertyDb. If a property already exists, its value is overwritten.\r\n     * @note the database must be opened for write\r\n     */\r\n    public async saveProperties(props: PropertyArray) {\r\n      for (const prop of props)\r\n        await this.saveProperty(prop.name, prop.value);\r\n    }\r\n  }\r\n\r\n  const defaultDbName = \"PropertyDb\" as const;\r\n\r\n  export interface CreateNewContainerProps {\r\n    scope: BlobContainer.Scope;\r\n    metadata: Omit<BlobContainer.Metadata, \"containerType\">;\r\n  }\r\n\r\n  /**\r\n   * Provides access to a cloud-based `PropertyDb` to hold a set of values of type `PropertyType`, each with a unique `PropertyName`.\r\n   * `PropertyStore.PropertyDb`s that are stored in cloud containers require an access token that grants permission to read and/or write them.\r\n   * All write operations will fail without an access token that grants write permission.\r\n   *\r\n   * The database is cached on a local drive so reads are fast and inexpensive, and may even be done offline after a prefetch.\r\n   * However, that means that callers are responsible for synchronizing the local cache to ensure it includes changes\r\n   * made by others, as appropriate (see [[synchronizeWithCloud]]).\r\n   */\r\n  export class CloudAccess extends CloudSqlite.DbAccess<PropertyDb> {\r\n    public constructor(props: CloudSqlite.ContainerAccessProps) {\r\n      super({ dbType: PropertyDb, props, dbName: defaultDbName });\r\n    }\r\n\r\n    /**\r\n     * Initialize a cloud container for use as a PropertyStore. This method is called by [[createNewContainer]].\r\n     * It is only necessary to convert an existing container to a PropertyStore container.\r\n     * @note this deletes any existing content in the container.\r\n     * @internal\r\n     */\r\n    public static async initializeDb(args: { props: CloudSqlite.ContainerProps }) {\r\n      return super._initializeDb({ ...args, dbType: PropertyDb, dbName: defaultDbName });\r\n    }\r\n\r\n    /** Create and initialize a new BlobContainer to hold a PropertyStore\r\n     * @note the current user must have administrator rights to create containers.\r\n     */\r\n    public static async createNewContainer(args: CreateNewContainerProps): Promise<CloudSqlite.ContainerProps> {\r\n      const props = await this.createBlobContainer({ scope: args.scope, metadata: { ...args.metadata, containerType: \"property-store\" } });\r\n      await this.initializeDb({ props });\r\n      return props;\r\n    }\r\n  }\r\n}\r\n"]}